THIST

Bulk Data Entry Defines the time history output request for Nonlinear Explicit Analysis.

Format

(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
THIST SID DTTH FILE
LABEL TH_group_name
Continuation lines for ENTRY = GRID or SHELL:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
ENTRY ID CID VAR1 VAR2 VAR3 VAR4 VAR5
VAR6 VAR7 etc.
Continuation lines for ENTRY = SOLID or CONTACT:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
ENTRY ID VAR1 VAR2 VAR3 VAR4 VAR5 VAR6
VAR7 VAR8 etc.

Example

(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
THIST 10 100
LABEL groupA
GRID 101 0 DEF REACX REACY REACZ
SOLID 102 DEF
CONTACT 501 FNX FTX FNY

Definitions

Field Contents SI Unit Example
SID Identification number of a THIST entry. This does not need to be unique.

No default (Integer > 0)

 
DTTH Frequency of the time history output.
Integer value (N)
Output is available for every Nth loading cycle.
Real value (T)
Output is available for every Tth time.

Default = 100 (Integer > 0 or Real > 0.0)

 
FILE Suffix for the file name. A maximum of 4 characters are allowed.

This is beneficial with multiple THIST definitions, when specific results are desired in each file. By default, only one _TH.h5 file is generated.

For example,
  • FILE = ‘acc’ creates a time history file given by _THacc.h5.
  • FILE = ‘disp’ a creates a time history file given by _THdisp.h5.

Default = blank (Character)

 
LABEL Label for the time history file.

No default (Character)

 
ENTRY Flag indicating that a list of identifiers is following. Any number of entries can be specified under the same THIST entry.
GRID
Outputs the requested time histories for a set of grids.
SHELL
Outputs the requested time histories for a set of shell elements.
SOLID
Outputs the requested time histories for a set of solid elements.
CONTACT
Outputs the requested time histories for the specified contact pair. 4
No default (Character)
 
ID Identifier for each ENTRY. 4

(Integer > 0)

 
CID Output coordinate system.

This is only applicable for ENTRY = GRID and SHELL.

Default = 0 (Global coordinate system)

(Integer)

 
VARi Output data label. 4

No default (Character)

 

Comments

  1. The THIST Bulk Data Entry must be referenced using the THIST Subcase Information Entry. It is only applicable for Explicit Dynamic Analysis (ANALYSIS = NLEXPL).
  2. The time history output is available in a _TH.h5 file HDF5 format file.
  3. If a THIST entry has been referenced in the subcase, the global energy results are always output by default. Even if FILE is defined, the global energies are written only to the _TH.h5 file and not to the other _TH<FILE>.h5 files. The global energies are listed as follows:
    Output Data Label
    Description and Remarks
    IE
    Global internal energy.
    Includes all material internal energy and global spring internal energy, but not spring rotational internal energy.
    KE
    Global kinetic energy.
    CE_ELAST
    Elastic contact energy.
    Recoverable energy stored in the contact penalty springs.
    CE_FRIC
    Frictional contact energy.
    HE
    Global hourglass energy.
    EFW
    Global external forces work.
    TE
    Energy sum = IE + KE.
  4. The following table summarizes the ENTRY, ID and VARi values for different output requests.
    Note: If VARi = ‘character prior to the parenthesis’, then all the results inside the parenthesis are output. For example, with ENTRY = SHELL.
    • VARi = STRESS outputs time histories of F1, F2, F12, Q1, Q2, M1, M2 and M12.
    • VARi = F1 only outputs time histories of F1.
    Entry ID Output Data Label (VARi) Description and Remarks
    GRID Grid SET ID DEF (DX, DY, DZ, VX, VY, VZ). All six components of displacement are output
    D (DX, DY, DZ) Translational displacement components
    V (VX, VY, VZ) Translational velocity components
    A (AX, AY, AY) Translational acceleration components
    DR (DRX, DRY, DRZ) Rotational displacement components
    VR (VRX, VRY, VRZ) Angular velocity components
    ARX (ARX, ARY, ARZ) Angular acceleration components
    REACX, REACY, REACZ Reaction force components
    REACXX, REACYY, REACZZ Reaction moment components
    SHELL Element SET ID DEF (F1, F2, F12, M1, M2, M12) Components 1, 2 and 12 of stresses and moments per unit length per thickness square are output
    STRESS (F1, F2, F12, Q1, Q2, M1, M2, M12) F1, F2, F12: Stress in direction 1, 2, 12

    Q1, Q2: Mean stress in direction 13, 23

    M1, M2, M12: Moments per unit length per thickness square in direction 1, 2, 12

    STRAIN (E1, E2, E12, SH1, SH2, K1, K2, K12) E1, E2, E12: Stress in direction 1, 2, 12

    SH1, SH2: Shear strain in direction 1, 2

    K1, K2, K12: Curvature in direction 1, 2, 12

    SOLID Element SET ID DEF (SX, SY, SZ, SXY, SYZ, SXZ) All stress tensor components are output
    STRESS (SX , SY, SZ, SXY, SYZ, SXZ). SX , SY, SZ, SXY, SYZ, SXZ: Stress tensor components
    EPSXX, EPSYY, EPSZZ, EPSXY, EPSYZ, EPSXZ Strain tensor components.
    CONTACT Contact ID DEF (FNX, FNY, FNZ, FTX, FTY, FTZ) All contact force components are output
    FN (FNX, FNY, FNZ) Normal contact force components
    FT (FTX, FTY, FTZ) Tangential contact force components