3. Operands#
3.1. Operand RESULTAT#
♦ RESULTAT = resu
The name of the results-type concept that the extraction is about.
For operands for extracting the field, refer to [§3.7].
For operands to locate the field, refer to [§3.8].
3.2. Operand CHAM_GD#
♦ CHAM_GD = ch_gd
The name of the concept of a field to which the extraction relates. For operands to locate the field, refer to [§3.7].
The field provided for the CHAM_GD keyword is:
either a field with magnitude nodes: DEPL_R, TEMP_R or PRES_R;
or a field by elements (at nodes or at Gauss points) of magnitude:
VARI_R, EPSI_R, FLUX_R, or PRES_R.
3.3. Operand RESU_GENE#
3.3.1. Temporal evolution of a physical or generalized component, tran_gene type#
♦ RESU_GENE = person
Name of the resu_gene type concept produced by DYNA_VIBRA [U4.53.03] that the extraction is about.
The recovered function is expressed
according to physical variables: GROUP_NO = grno was specified.
according to generalized variables: NUME_CMP_GENE = n_val was specified.
NOM_CHAM gives the name of the field you want to retrieve (“DEPL”, “”, “”, “VITE”, “ACCE”, or “PTEM”). The “PTEM” option allows you to extract, for each moment (or order number) of recovery, the values of the calculation time step.
Note:
Making this feedback on a physical basis is the role of the command REST_GENE_PHYS. In later versions, this feature will be removed from RECU_FONCTION, you will have to do the rendering and then extract the function.
3.3.1.1. Operands MULT_APPUI and ACCE_MONO_APPUI#
◊ MULT_APPUI
If this keyword is” OUI “, we restore the evolution of the variables in physical space by treating the problem in absolute motion in the case of multi-support excitation. Otherwise, the reproduction in physical space is done under the assumption that the problem is treated in relative motion. This keyword cannot be used if the CORR_STAT keyword is used.
◊ ACCE_MONO_APPUI
In the case of single-support acceleration, the acceleration imposed on all the supports in the direction in question must be indicated here in order to calculate the absolute acceleration of the point.
If the keyword is not entered, the relative acceleration is obtained as a result of the command.
Note:
The concept name must be the same as the name entered under FONC_MULT of DYNA_VIBRA.
3.3.1.2. Operands CORR_STAT#
◊ CORR_STAT
If this keyword is” OUI “, the evolution of the variables in the physical space is obtained by taking into account the correction due to the consideration of static modes (Cf. [R4.05.03]). This keyword cannot be used if the MULT_APPUI keyword is used.
3.3.1.3. Information about shock knots#
Tran_gene concept containing for the various shock nodes: local displacements, normal and tangential velocities and normal and tangential shock forces.
A shock group of nodes (containing only one node) where the function is retrieved.
This shock node is defined in command DYNA_VIBRA [U4.53.03].
Name of the parameter defining the abscissa (argument taken from the list: “INST”, “FN”, “”, “FN”, “FT1,” FT2 “,” VN “,” VT1 “,” DXLOC “,” “,”, “”, “,” DYLOC “,” “,” DZLOC “,” VT2 VINT1 VINT2 VINT3 VINT4 “,” VINT5 “,” VINT6 “,” VINT7 “,” “,” “,”, “”, “”, “”, “”, “”, “”, “VINT8 VINT9 VINT10 VINT11 VINT12 VINT13 VINT14 VINT15 VINT16 VINT17 “,” VINT18 “,” VINT19 “,” “,” VINT20 “,” VINT21 “).
Name of the parameter defining the ordinates (argument taken from the list: “INST”, “FN”, “”, “FN”, “FT1,” FT2 “,” VN “,” VT1 “,” VT2 “,” DXLOC “,” “,” DYLOC “,” “,” “,” DZLOC VINT1 VINT2 VINT3 VINT4 “,” VINT5 “,” VINT6 “,” VINT7 “,” “,” “,”, “”, “”, “”, “”, “”, “”, “VINT8 VINT9 VINT10 VINT11 VINT12 VINT13 VINT14 VINT15 VINT16 VINT17 “,” VINT18 “,” VINT19 “,” “,” VINT20 “,” VINT21 “).
List of values for the x-axis parameter defining the function.
Warning: It is possible to have problems interpolating the result on this list of parameters (because with machine precision, the values may be slightly outside the limits of the functions produced). In that case, just do not use this keyword here. The function will then be created at all times of calculation. You can then interpolate this function with CALC_FONC_INTERP [U4.32.01] on the list of parameters of your choice by controlling left and right extensions.
This name defines the shock link (this name, if used, is defined in the DYNA_VIBRA [U4.53.03] command).
During a dynamic substructure calculation, name of the substructure that contains the shock node (cf. command DEFI_MODELE_GENE [U4.65.02]). In this case the keyword INTITULE must also be filled in.
3.3.2. Frequency evolution of a generalized or physical component, type harm_gene#
♦ RESU_GENE = person
Name of the harm_gene type concept produced by DYNA_VIBRA [U4.53.03].
The recovered function is expressed
according to physical variables: GROUP_NO = grno was specified.
according to generalized variables: NUME_CMP_GENE = n_val was specified.
NOM_CHAM gives the name of the field you want to retrieve (“DEPL”, “”, “VITE” or “ACCE”).
Note:
Making this feedback on a physical basis is the role of the command REST_GENE_PHYS. In later versions, this feature will be removed from RECU_FONCTION, you will have to do the rendering and then extract the function.
3.3.3. Frequency evolution of a generalized or physical component, mode_gene type#
♦ RESU_GENE = person
The name of the mode_gene concept produced by CALC_MODES [U4.53.02].
The recovered function is expressed with the physical variables if NOM_CMP is present, with the generalized variables if NUME_CMP_GENE is present.
3.4. Operand TABLE#
We can recover:
or a function defined from two columns in the table,
or a function whose name is indicated in a cell in the table.
♦ TABLE = tableName of the result table from which an extraction is performed.
3.4.1. Function defined from two columns in the table#
3.4.1.1. Operands PARA_X/PARA_Y#
♦ PARA_X = Nparax
Name of the column in the table that defines the abscissa.
♦ PARA_Y = Nparay
The name of the column in the table that defines the ordinates.
3.4.2. Function whose name is specified in a cell in the table#
3.4.2.1. Operand NOM_PARA_TABL#
♦ NOM_PARA_TABL = 'FONCTION' or 'FONCTION_C'
The presence of this keyword indicates that we are retrieving a function whose name is stored in a cell in the table. Real functions are stored in column “FONCTION”, complex functions in column “FONCTION_C”.
3.4.2.2. Keyword FILTRE#
◊ FILTRE
The extraction operands are different from those used for the previous cases. To perform the extraction, you must use the FILTRE keyword and the operands NOM_PARA, CRIT_COMP, VALE_X, CRITERE, PRECISION.
This factor keyword is used to filter the information stored in the table. For the use of this keyword see command IMPR_TABLE [U4.91.03].
To retrieve a function whose name is indicated in a cell in the table, you must use the keyword factor FILTRE at least twice to select only the useful cell.
3.5. Operand BASE_ELAS_FLUI#
In a melasflu-type data structure produced by the operator CALC_FLUI_STRU [U4.66.02], the changes in frequency or damping, for a given mode, as a function of the various excitation speeds of the fluid are recovered.
♦ BASE_ELAS_FLUI = crazy
Melasflu-like concept produced by order CALC_FLUI_STRU.
3.5.1. Operand NUME_MODE#
Number of the mode for which the extraction of the frequency or of the damping according to the speed of the fluid is performed.
3.5.2. Operands PARA_X/PARA_Y/NUME_ORDRE/TOUT_ORDRE#
On the x-axis, the parameter is the excitation speed of the fluid, called “VITE_FLU” or the Connors number, called “NB_CONNORS”.
If the excitation speed of the fluid “VITE_FLU” has been chosen as the x-axis, then:
/”AMOR”.
On the y-axis, we have the choice between frequency (name of the parameter “FREQ”) or the damping (name of the parameter “AMOR”).
/TOUT_ORDRE = “OUI”,
The evolution of the frequency or that of the damping is given for all the speeds of the fluid (TOUT_ORDRE) or for some order numbers of the speeds of the fluid (NUME_ORDRE).
If we chose the Connors number “NB_CONNORS” as an x-axis, then there are three possibilities for the ordinate:
/” INSTAB_EDF “, /” INSTAB_TOUT_CMP “,
VITE_CRIT allows you to plot the critical speed as a function of the Connors number. To access instability ratios (effective speed divided by critical speed), the choices of PARA_Y between INSTAB_EDF and INSTAB_TOUT_CMP make it possible to plot the ratio calculated with the Gevibus method (EDF method) and the conservative method (called all components) respectively [R4.07.04].
3.6. Operand INTE_SPEC#
In an interspectrum data structure, the frequency evolution of the interspectrum associated with line \(i\) and column \(j\) of the intespec interspectral matrix are extracted. You can also extract the time evolution of one of the functions generated by GENE_FONC_ALEA [U4.36.05] by specifying its order number.
♦ INTE_SPEC = intense
3.6.1. Operand NOM_CHAM#
Symbolic name of the field to which the extraction relates.
3.6.2. Operands NUME_ORDRE_I, NUME_ORDRE_J#
◊ NUME_ORDRE_J = number
Indication of the pair of indices (line \(i\), column \(j\)) to be extracted from the intespec interspectral matrix.
These operands are exclusive with operands NUME_ORDRE NOEUD_I NOM_CMP_I NOEUD_J NOM_CMP_J.
Note:
It is not mandatory to fill in NUME_ORDRE_Jsi we want to extract a term from the diagonal of the matrix.
3.6.3. Operands NUME_ORDRE#
Indication of the serial number of the time function generated by the operator GENE_FONC_ALEA [U4.36.05].
These operands are exclusive with operands NUME_ORDRE_I NUME_ORDRE_J NOEUD_I NOM_CMP_I NOEUD_J NOM_CMP_J.
3.6.4. Operands NOEUD_I, NOM_CMP_I, NOEUD_J, NOM_CMP_J#
♦ NOM_CMP_I = CMPI ◊ NOEUD_J = node ◊ NOM_CMP_J = CMPJ
These operands correspond to the names of the nodes and components (row i, column j) of the intespec interspectral matrix matrix.
These operands are exclusive with operands NUME_ORDRE_I NUME_ORDRE_J NUME_ORDRE.
Note:
It is not mandatory to fill in NOEUD_J and NOM_CMP_Jsi we want to extract a term from the diagonal of the matrix.
3.7. Operand NAPPE#
In a data structure of the sheet type, the function corresponding to a given value of the parameter of the sheet is retrieved.
\(\mathit{np}\) is the value of the parameter of the table for which we want to extract the function.
There is no interpolation on the tablecloth parameter. CRITERE and PRECISION make it possible to provide \(\mathit{np}\) with a given precision.
3.8. Operands for extracting the field or parameter#
3.8.1. Operand NOM_CHAM#
Symbolic name of the field to which the extraction relates.
3.8.2. Operand NOM_PARA_RESU#
Symbolic name of the data structure parameter that you want to extract (for example: ETA_PILOTAGE, MASSE_EFFE_DX, MASSE_GENE…).
The extracted function will then have as its abscissa the access variable (INST, FREQ…) and as ordinate the parameter value.
3.8.3. Operands TOUT_ORDRE/NUME_ORDRE/TOUT_INST/LIST_ORDRE#
This keyword indicates that we want to extract for all the order numbers already calculated.
Example: all the times for an evol_* result.
/NUME_ORDRE = l_numme
The extraction will be done for the values with the order number l_nume provided.
/TOUT_INST = “OUI”
This keyword indicates that you want to extract at all times.
/LIST_ORDRE = l_ord
This keyword indicates that we want to extract to the order numbers described in the listis l_ord concept.
3.8.4. Operands INST/LIST_INST/FREQ/LIST_FREQ#
◊/INST = l_inst
This keyword indicates that we want to extract l_inst at the times.
/LIST_INST = li_inst
This keyword indicates that we want to extract at the times described in the li_inst concept of the listr8 type.
/FREQ = l_freq
This keyword indicates that we want to extract at the l_freq frequencies.
/LIST_FREQ = li_freq
This keyword indicates that we want to extract at the frequencies described in the li_freq concept of the listr8 type.
3.8.5. Operands PRECISION/CRITERE#
This operand makes it possible to indicate that we are looking for the value of the field whose time or frequency is in an interval defined by the absolute or relative position: « inst \(\mathrm{\pm }\) prec » (Cf. CRITERE).
By default prec = 1.0D-3
“RELATIF” the search interval is
“ABSOLU” the search interval is
3.8.6. Operand INTERP_NUME#
◊ INTER_NUME
This keyword defines the type of interpolation between two order numbers. It is only valid if the user has defined a list of times or frequencies. It is possible to forbid “NON” interpolation or to allow for linear “LIN” interpolation.
Interpolation cannot be used when extracting the value of a parameter (keyword NOM_PARA_RESU).
3.9. Field location operands#
3.9.1. Operand GROUP_NO#
Name of the group of nodes, containing 1 single node, to which the extraction relates.
3.9.2. Operands GROUP_MA/GROUP_NO/POINT#
Name of a group of elements (grma), containing a single cell, to which the extraction relates. These keywords only concern cham_elem.
Refers to the name of the group of nodes, containing a single node name, on which the extraction relates (case of cham_elem at nodes).
/POINT = nupoint
The nupoint integer specifies the local number to the element of the point of GAUSS from which we want to obtain the value (case of cham_elem at the points of GAUSS).
The integer nusp specifies the number of the sub-point from which we want to obtain the value (case of cham_elem with sub-points, used by structural elements: beam, pipes, shells).
In the case of multi-layer plates and shells, the sub-point number corresponds to the level within the set of layers. Each layer is described by a lower, middle, and upper skin. By convention, for \(N\) diapers, this number varies between \(1\) and \(3N\) where the first point is located at the level of the lower skin of the first layer and the \(3N\) th point at the level of the upper skin of the last layer (see [R3.07.03] and [R3.07.04] for the number of layers).
In the case of multifibre beams, this integer is the number of the fibre whose numbering is described in the documentation [U4.26.01] and [R3.08.08].
In the case of pipes, refer to the description in the document [R3.08.06].
3.9.3. Operands NOM_CMP/NOM_VARI#
◊ NOM_CMP = nocmp, [Kn]
The name of the component that is being extracted.
◊ NOM_VARI = novari, [Kn]
For the internal variable fields (VARI_ *), you can give the name of the internal variable to which the extraction relates (see [U4.51.11] for the rules for naming internal variables).
3.10. Function concept attributes created by RECU_FONCTION#
3.10.1. Values by defaults#
By default the attributes of the function concept created by the RECU_FONCTION command are:
Left extension: “EXCLU”
Right extension: “EXCLU”
NOM_PARA: given as input
NOM_RESU: given as input
3.10.2. Overloading attributes#
The user can override the attributes given by default using the following keywords:
3.10.2.1. Operand NOM_PARA#
It refers to the name of the parameter (variable or abscissa) of the function. The currently allowed values for lpara are:
/”TEMP”/”INST”/”EPSI” /”X”/”Y”/”Z” /”FREQ”/”PULS”/”AMOR” /”DX”/” DY “/” DZ “ /”DRX”/”DRY”/”DRZ”
plus those specific to shock nodes (cf. [§3.3.2.2]).
3.10.2.2. Operand NOM_RESU#
It designates the name of the result, the function thus created is a function whose value has the name lresu (8 characters).
3.10.2.3. Operand INTERPOL#
The type of interpolation of the function between the values of the parameter in the domain of definition. Behind this keyword we expect a list of parameters (two at most) among “LIN”, “LOG”. If only one value is given the interpolation will be the same for the abscissa and the ordinates. If two values are given, the first corresponds to the interpolation of the abscissa and the second to the interpolation of the ordinates.
3.10.2.4. Operands PROL_DROITE/PROL_GAUCHE#
They define the type of extension to the right (left) of the variable’s domain of definition:
“CONSTANT” for an extension with the last (or first) value of the function,
“LINEAIRE” for an extension along the first defined segment (PROL_GAUCHE) or the last defined segment (PROL_DROITE),
“EXCLU” if extrapolation of values outside the domain of definition of the parameter is prohibited.
3.11. Operand TITRE#
◊ TITRE
Title attached to the concept produced by this operator [U4.03.01].
3.12. Operand INFO#
◊ INFO
Specify the print options on file MESSAGE.
1 |
no printing (by default) |
2 |
printing the function descriptor and the list of the first 10 values of the function in ascending order of the first 10 parameters |