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, CONTACT, JOINTG, or MONVOL:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
ENTRY ID VAR1 VAR2 VAR3 VAR4 VAR5 VAR6
VAR7 VAR8 etc.
Continuation lines for contact surface-based data:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
CONTACT CSURF SRFID VAR1 VAR2 VAR3 VAR4 VAR5
    VAR6 VAR7 etc.          
Continuation lines for ENTRY = COMP, or PROP:
(1) (2) (3) (4) (5) (6) (7) (8) (9) (10)
ENTRY   VAR1 VAR2 VAR3 VAR4 VAR5 VAR6
    VAR7 VAR8 etc.          
Continuation lines for ENTRY = ESET:
(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 SPCFX SPCFY SPCFZ
SOLID 102 DEF
CONTACT 501 FNX FTX FNY

Definitions

Field Contents SI Unit Example
SID THIST entry identifier number. 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.

No default (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’ 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
JOINTG
Outputs the requested time histories for the specified set of JOINTG elements.
MONVOL
Outputs the requested time histories for the specified MONVOL ID.
COMP
Outputs the requested time histories for all components.
PROP
Outputs the requested time histories for all properties.
ESET
Outputs the requested time histories for the specified Element SET ID. The ID is of a SET which contains a list of element SETs with boolean OR.
No default (Character)		  
ID Identifier for each ENTRY. 4

(Integer > 0)

  
CSURF Flag to indicate output of surface-based data.  
SRFID Surface identifier.

This is valid only for surface-based data format.

No default (Integer > 0)

  
CID Output coordinate system.

This is only applicable for ENTRY = GRID and SHELL.

Default = 0 (Basic 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:
    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
    PE
    Global plastic dissipation 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:
    1. In the below table, if VARi = {character prior to the parentheses}, then all the results inside the parenthesis are output. For example, with ENTRY = SHELL
      • VARi = STRESS outputs time histories of SX1, SY1, SXY1, SX2, SY2, and SXY2.
      • VARi = SX1 only outputs time histories of SX1.
    2. VARi = ALL or blank are supported for all entries and this outputs the result for all the components of an output data label.
    Entry ID Output Data Label (VARi) Description and Remarks
    CONTACT Contact ID or SRFID (when CSURF flag is added) 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
    COMP Output for all Components in the model ENERGY (IE, KE, HE) IE = Internal Energy

    KE = Kinetic Energy

    HE = Hourglass Energy

    ENERGY = All energies are output (IE, KE, and HE)
    ESET SET ID of a boolean element SET ID. Corresponds to ID of a SET of element SETs with boolean OR.* ENERGY (IE, KE, HE) IE = Internal Energy

    KE = Kinetic Energy

    HE = Hourglass Energy

    ENERGY = All energies are output (IE, KE, and HE)
    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
    SPCF (SPCFX, SPCFY, SPCFZ) SPC force components
    SPCM (SPCMX, SPCMY, SPCMZ) SPC moment components
    JOINTG Element Set ID or ALL DEF (FX, FY, FZ, MX, MY, MZ) All components of JOINTG element force are output
    ALL (FX, FY, FZ, MX, MY, MZ, RFX, RFY, RFZ, RMX, RMY, RMZ, VFX, VFY, VFZ, VMX, VMY, VMZ, SLST1, SLST2, SLST3, SLST4, SLST5, SLST6) All supported variables are output
    F (FX, FY, FZ)

    JOINTG Force FX

    JOINTG Force FY

    JOINTG Force FZ

    M (MX, MY, MZ)

    JOINTG Force MX

    JOINTG Force MY

    JOINTG Force MZ
    RF (RFX, RFY, RFZ)

    JOINTG Reaction Force FX

    JOINTG Reaction Force FY

    JOINTG Reaction Force FZ
    RM (RMX, RMY, RMZ)

    JOINTG Reaction Force MX

    JOINTG Reaction Force MY

    JOINTG Reaction Force MZ
    VF (VFX, VFY, VFZ)

    JOINTG Viscous Force FX

    JOINTG Viscous Force FY

    JOINTG Viscous Force FZ
    VM (VMX, VMY, VMZ)

    JOINTG Viscous Force MX

    JOINTG Viscous Force MY

    JOINTG Viscous Force MZ
    STATUS (SLST1, SLST2, SLST3, SLST4, SLST5, SLST6) JOINTG Stop and Lock Status at all components
    MONVOL MONVOL ID or ALL DEF (PRES, TEMP, VOL, AREA, MASS, IE, MFR, VENTA, LEAKM) All variables are output
    ALL (PRES, TEMP, VOL, AREA, MASS, IE, MFR, VENTA, LEAKM) All variables are output
    PRES Pressure
    TEMP Temperature
    VOL Volume
    AREA Area
    MASS Mass
    IE Internal Energy
    MFR Mass Flow Rate
    VENTA Vent Area
    LEAKM Leaked Mass
    PROP Output for all Properties in the model ENERGY (IE, KE, HE) IE = Internal Energy

    KE = Kinetic Energy

    HE = Hourglass Energy

    ENERGY = All energies are output (IE, KE, and HE)
    SHELL Element SET ID DEF (SX1, SY1, SXY1, SX2, SY2, SXY2) Shell element stress at location Z1 and Z2 are output
    STRESS (SX1, SY1, SXY1, SX2, SY2, SXY2) SX1, SY1, SXY1: shell element stress at location Z1.

    SX2, SY2, SXY2: shell element stress at location Z2.
    STRAIN (EPSX1, EPSY1, EPSXY1, EPSX2, EPSY2, EPSXY2) EPSX1, EPSY1, EPSXY1: shell element strain at location Z1. EPSX2, EPSY2, EPSXY2: shell element strain at location Z2.
    SOLID Element SET ID DEF (SX, SY, SZ, SXY, SYZ, SZX) All six stress tensor components are output
    STRESS (SX , SY, SZ, SXY, SYZ, SZX). Stress tensor components
    STRAIN (EPSX, EPSY, EPSZ, EPSXY, EPSYZ, EPSZX) Strain tensor components
    *Example ID for ESET: 
    SET, 10, ELEM, OR,
+, 1, 2, 5, 23