ldread¶
- Mapdl.ldread(lab='', lstep='', sbstep='', time='', kimg='', fname='', ext='', **kwargs)¶
Reads results from the results file and applies them as loads.
APDL Command: LDREAD
- Parameters
- lab
Valid load label:
- TEMP - Temperatures from a thermal analysis are applied as body force nodal loads (BF)
in a structural analysis, an explicit dynamic analysis, or other type of analysis.
- If the thermal analysis uses SHELL131 or SHELL132, temperatures are applied as body force element loads (BFE). In most cases, only the top and bottom temperatures from SHELL131 and SHELL132 are used by the structural shell elements; any interior temperatures are ignored. - All temperatures are used for SHELL181 using section input, and SHELL281 using
section input; for these elements, therefore, the number of temperature points at a node generated in the thermal model must match the number of temperature points at a node needed by the structural model.
- When using SHELL131 or SHELL132 information for the LDREAD operation, all element types should specify the same set of thermal degrees of freedom. - When used in conjunction with KIMG=1 and KIMG=2, temperatures can be applied to
a subsequent thermal analysis as nodal loads (D) or initial conditions (IC), respectively.
- FORC - Forces from an electromagnetic analysis are applied as force loads (F) in a
structural analysis. LDREAD,FORC reads coupling forces. See the discussion on force computation in the Low-Frequency Electromagnetic Analysis Guide.
For a full harmonic magnetic analysis, FORC represents the time-averaged force (use in conjunction with KIMG = 2). Values are in the nodal coordinate system for the force loads (F). - HGEN
Heat generations from an electromagnetic analysis are applied as body force loads (BFE) in a thermal analysis. For a full harmonic analysis, HGEN represents the time-averaged heat generation load (use in conjunction with KIMG = 2). - JS
Source current density from a current-conduction analysis are applied as body force loads (BFE). Values are in the global Cartesian coordinate system. - EF
Electric field element centroid values from an electrostatic analysis are applied as body force loads (BFE) in a magnetic analysis. Values are in the global Cartesian coordinate system. - REAC
Reaction loads from any analysis are applied as force loads (F) in any analysis. Values are in the nodal coordinate system. - CONC
- lstep
Load step number of the data set to be read. Defaults to 1. If LAST, ignore SBSTEP and TIME and read the last data set.
- sbstep
Substep number (within LSTEP). If zero (or blank), LSTEP represents the last substep of the load step.
- time
Time-point identifying the data set to be read. Used only if both LSTEP and SBSTEP are zero (or blank). If TIME is between two solution time points on the results file, a linear interpolation is done between the two data sets. If TIME is beyond the last time point on the file, use the last time point.
- kimg
When used with results from harmonic analyses (ANTYPE,HARMIC) KIMG establishes which set of data to read:
- 0 - Read the real part of the solution. Valid also for Lab = EHFLU to read in
time-average heat flux.
1 - Read the imaginary part of the solution.
2 - Calculate and read the time-average part. Meaningful for Lab = HGEN or FORC.
- fname
File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name.
- ext
Filename extension (eight-character maximum).
Notes
The LDREAD command reads results data from the results file and applies them as loads.
The command can also apply results from an analysis defined with one physics environment as loads on a second analysis using a different physics environment. Results values are applied as loads for field- coupling effects (for example, output temperatures from a thermal analysis as input to a structural analysis).
The command works based on the assumption that the meshes have not changed.
Nodal loads are applied only to selected nodes. Element loads are applied only to selected elements. Element surface loads are applied only to selected elements where all face nodes for that surface are selected.
To assure proper distribution of the surface loads, select only the nodes on the element face where the surface load is to be applied.
Scaling and accumulation specifications are applied as the loads are read via the following commands:
BFCUM for body force loads. (Heat-generation loads are not accumulated.)