I/O Options Entry
PFMODE – Output Request for Modal Participation
Description
The PFMODE command can be used in the I/O Options section to request output of modal participation factors for all modal frequency response subcases.
Format
PFMODE (type, FLUIDMP=fmp, STRUCTMP=smp, PANELMP=setp, FREQUENCY=setf, FILTER=fratio, NULL=ipower, RPCUTOFF=rval, RPDBACUT=rpdba, MTYPE=otype, CMSSET=seset, RTYPE=rtype, outfile, PEAKOUT) = setdof/PEAKOUT
Examples
PFMODE(FLUID,STRUCTMP=30,FREQUENCY=391,PANELMP=ALL)=393
PFMODE(STRUCTURE,H3D)=23
PFMODE(FLUID,H3D,PEAKOUT)=11
PFMODE(STRUCTURE,H3D,PEAKOUT)=PEAKOUT
PFMODE(FLUID,PUNCH)=31
Argument |
Options |
Description |
|
---|---|---|---|
type |
<STRUCTURE or FLUID> Default = STRUCTURE |
STRUCTURE: |
Requests output of structural modal participation factors. |
FLUID: |
Requests output of acoustic modal participation factors. |
||
|
|||
fmp |
<ALL, N, NONE> Default = NONE |
ALL: |
Participation factors will be computed for all calculated fluid modes. |
N: |
Number of fluid modes for which modal participation factors will be computed, based on the largest magnitude of modal contribution. |
||
NONE: |
Participation factors are not calculated for fluid modes. |
||
|
|||
smp |
<ALL, N, NONE> Default = NONE (if type =FLUID) |
ALL: |
Participation factors will be computed for all calculated structural modes. |
N: |
Number of structural modes for which modal participation factors will be computed based on the largest magnitude of modal contribution. |
||
NONE: |
Participation factors are not calculated for structural modes (Comment 12). |
||
|
|||
setp |
<ALL, NONE> Default = NONE |
ALL: |
Output structural modal participation for each panel specified in the PANEL data. |
NONE: |
Do not output panel modal participation. |
||
|
|||
setf |
<ALL, SID> Default = ALL |
ALL: |
Participation factors are processed for all excitation frequencies. |
SID: |
Participation factors are only processed for a set of excitation frequencies. SID refers to the ID of a SET of type FREQ. |
||
|
|||
fratio |
<REAL> Default = 0.001 |
Specifies the value of a filter to be applied to the output. Values of modal participation below fratio times the displacement or pressure are not output. |
|
|
|||
ipower |
<INTEGER> Default = 30 |
When the magnitude of a modal participation is below 10 to the minus ipower, the modal participation will not be output. In other words, if the modal participation is less than 10-ipower, the result output for this mode will be skipped. |
|
|
|||
rval |
<REAL> Default = 0.0 |
The modal participation will be calculated at the excited frequencies when the magnitude of the response is above rval. The excitation frequency will be a subset of setf. |
|
|
|||
rpdba |
<Non-Negative REAL> Default = 0.0 |
RPDBACUT is the decibel pressure cutoff value for fluid responses, and is similar to RPCUTOFF. It will take precedence over RPCUTOFF for fluid responses. A weighting is applied to RPDBACUT values at the excitation frequency. The modal participation will be calculated when the magnitude of the response is about the cutoff value. See comment 9 for decibel calculations and reference pressure settings. |
|
|
|||
otype |
<ALL, SYSTEM, CMS> Default = SYSTEM |
For SYSTEM, the output related to PFMODE will correspond to the whole model. Component modal participation will not be output by default. However, when using ALL or CMS, the component modal participation will be output. For the CMS option, there will not be system modal participation. Component modal participation can also be calculated for internal grids in the superelement. |
|
|
|||
seset |
<ALL, SID> Default = ALL |
Component modal participation of all the H3D superelements will be output by default. However, a specific set of superelement names for output can be specified. |
|
|
|||
rtype |
<DISP, VELO, ACCE> Default = DISP |
The Structural modal participation will be output for Displacement, Velocity or Acceleration, respectively based on the specified option (DISP, VELO, or ACCE). |
|
|
|||
outfile |
<PUNCH, H3D> Default = H3D |
Modal participation can be exported either into the H3D file or PUNCH file. Because of the large volume of data, it is recommended to export the modal participation data into a H3D file. |
|
|
|||
PEAKOUT |
If PEAKOUT is present inside the bracket of the PFMODE option, the filtered frequencies from the PEAKOUT card will be considered for the output of modal participation. |
||
|
|||
setdof/ |
<SID/PEAKOUT> |
Degrees-of-freedom for which the participation factors are to be processed. SID refers to the ID of a SET of type GRIDC for structure participation and GRID for fluid participation. If PEAKOUT is specified instead of SID, the output will be considered at the filtered frequencies corresponding to the degree of freedom on the PEAKOUT card in the bulk section. |
1. | The output of both the PFMODE and PFPANEL must be either to an H3D file or to a PUNCH file. Both PFPANEL and PFMODE must have the same output option. |
2. | The modal participation output is sorted in descending order by magnitude of the modal participation in the PUNCH file output. |
3. | PFMODE(FLUID,..) and PFMODE(STRUCTURE,…) can coexist in the input data, but only one PFMODE(FLUID) and one PFMODE(STRUCTURE) are allowed in a single SUBCASE. |
4. | Keywords FLUIDMP and PANELMP are only valid if FLUID is specified. |
5. | If STRUCTURE is specified, setdof must reference a set of structural degrees-of-freedom. If FLUID is specified, setdof must reference a set of acoustic degrees-of-freedom. |
6. | The FREQUENCY keyword can be used to select a subset of excitation frequencies available. |
7. | The filter is applied to the magnitude of the modal participation factors. Only modal participation factors that pass the filter are output. |
8. | If the magnitude of the total response at a selected response degree-of-freedom is less than 10-ipower, then no modal participation factors are processed. If ipower is not in the range of 1 to 31, the default of 30 is used. |
9. | The dB value is calculated using , where p0 is the reference pressure. The reference pressure is dependent on the units specified on the UNITS input data. If the units are SI, the value is set as 2.0E-5 Pa. If they are CGS, it is set as 2.0E-4 barye. If they are MPa, it is set as 2.0E-11 MPa. If they are BG or EE, then it is set as 4.17E-7 lbf/ft2. If no UNITS data is present, the default value is 2.0E-11 MPa. |
10. | Legacy format for the export of modal participation to H3D or PUNCH files: PFMODE (type, OUTPUT=outfile)=setdof/PEAKOUT is also supported. |
11. | If you want to output modal participation factors for interior points of a superelement (in a CMS model), the SEINTPNT entry can be used in the subcase information section to convert the interior points of interest to exterior points. After conversion, these points can now be referenced by the <SID/PEAKOUT> option for the sedof/PEAKOUT argument. |
12. | smp=NONE is only effective for Fluid Modal Participation factor output (type=FLUID). Otherwise, it is interpreted as ALL for Structural Modal Participation output (type=STRUCTURE). For type=FLUID, smp and fmp can be set to NONE. |
See Also:
Coupled Frequency Response Analysis of Fluid-Structure Models