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)
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 N^th loading cycle. Real value (T) Output is available for every T^th 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

The THIST Bulk Data Entry must be referenced using the THIST Subcase Information Entry. It is only applicable for Explicit Dynamic Analysis (ANALYSIS = NLEXPL).
The time history output is available in a _TH.h5 file HDF5 format file.
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

The following table summarizes the ENTRY, ID and VARi values for different output requests.

Note:

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.
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
		STRAIN (EPSX, EPSY, EPSZ, EPSXY, EPSYZ, EPSZX)	Strain Tensor Components
		STRESS (SX, SY, SZ, SXY, SYZ, SZX)	Stress Tensor Components

*Example ID for ESET:

SET, 10, ELEM, OR,
+, 1, 2, 5, 23