XHIST

Bulk Data Entry

XHIST – Time History Output Request for Geometric Nonlinear Analysis

Description

Defines the time history output request for geometric nonlinear analysis.

Format

(1)	(2)	(3)	(4)	(5)	(6)	(7)	(8)	(9)	(10)
XHIST	SID	LABEL
	FILE	TYPE	CID	DTTHM
	DATA	VAR1	VAR2	VAR3	VAR4	VAR5	VAR6	VAR7
		VAR8	...
	ENTRY	ID1	ID2	ID3	ID4	ID5	ID6	ID7
		ID8	...

(1)	(2)	(3)	(4)	(5)	(6)	(7)	(8)	(9)	(10)
XHIST	100
		GRID
	DATA	DEF	AX	AY
	ENTRY	345	6687

Field	Contents
SID	Set identification number. (Integer > 0)
LABEL	(Character or blank)
FILE	Creation of different time history files runnameTnnx(n:0-1,x:blank or a-i). (Characters – A, B, C…, and I, or blank)
TYPE	Entity type. See table 1. (Character according to table)
CID	Frame coordinate system identification. (Integer > 0)
DTTHM	Output time step for time history files. Once it is specified, it will overwrite DTTH on NLPARMX, TSTEPNX and XSTEP to control the output time step of history file specified by FILE in this card.
DATA	Indicates that data labels follow. If DATA is not specified, the default is VAR1 = DEF.
VARi	Output data label. See table 1. (Character)
ENTRY	Indicates that a list of identifiers is following.
IDi	Entry identifier for TYPE. See table 1. (Integer > 0)

Comments

1.	XHIST sets must be selected with the Subcase Information command XHIST = SID or by XHISADD. It can only be selected in geometric nonlinear analysis subcases which are defined by an ANALYSIS = EXPDYN subcase entry.

Table 1 below gives the definitions of TYPE, VARi, and IDi. The notation DEF (DX, DY, DZ, VX, VY, VZ) means that if DEF is selected, all six values following in parenthesis are written at once. However, instead of requesting DEF each value can be requested individually. Details on the output requests can be found in Table 2.

3.	A property cannot be in several time history groups. In this case, the only variables output in time history are the variables declared in the last option which refers to the property.

4.	It is not possible to have the same grid point several times in the same GRID group. OptiStruct provides an error message in such cases.

5.	If an output coordinate system GRID, CD is specified: coordinates, displacement, linear and angular velocities, linear and angular accelerations of the grid are projected to that system.

6.	If a reference frame is specified: local coordinates, relative displacement, relative linear and angular velocities, relative linear and angular accelerations of the node with respect to the frame are output.

7.	Global results are always written.

8.	The OFF element status information works as follows:

•	OFF = 0 – Element deleted

•	OFF = 1 – Element active

•	OFF = 2 – Element active using small strain

•	OFF = -1 – Element is sleeping (turned rigid)

Table 1: Output Requests

TYPE	VARi	IDi
GRID	DEF (DX, DY, DZ, VX, VY, VZ), D (DX, DY, DZ), V (VX, VY, VZ), A (AX, AY, AZ), VR (VRX, VRY, VRZ) AR (ARX, ARY, ARZ), XYZ (X, Y, Z), REACX, REACY, REACZ, REACXX, REACYY, REACZZ	Grid ID
PROP	DEF (IE, KE, XMOM, YMOM, ZMOM, MASS, HE), XCG, YCG, ZCG, XXMOM, YYMOM, ZZMOM, IXX, IYY, IZZ, IXY, IYZ, IZX, RIE, KERB, RKERB, RKE	Property ID
SHELL	DEF (F1, F2, F12, M1, M2, M12, IEM, IEB, EMIN, EMAX, OFF), STRESS (F1, F2, F12, Q1, Q2, M1, M2, M12), STRAIN (E1, E2, E12, SH1, SH2, K1, K2, K12), PLAS (EMIN, EMAX)	Element ID
SOLID	DEF (SX , SY, SZ, SXY, SYZ, SXZ, IE, DENS, PLAS, TEMP, OFF), STRESS (SX, SY, SZ, SXY, SYZ, SXZ), LOCSTRS (LSX, LSY, LSZ, LSXY, LSYZ, LSXZ), BULK, VOL, DAM1, DAM2, DAM3, DAM4, DAM5, DAMA, EPSXX, EPSYY, EPSZZ, EPSXY, EPSXZ, EPSYZ	Element ID
RWALL	DEF (FNX, FNY, FNZ, FTX, FTY, FTZ), FN (FNX, FNY, FNZ), FT (FTX, FTY, FTZ)	Load set ID of RWALL
CONTCT	DEF (FNX, FNY, FNZ, FTX, FTY, FTZ), FN (FNX, FNY, FNZ), FT (FTX, FTY, FTZ), M (MX, MY, MZ)	Contact ID
SECT	DEF (FNX, FNY, FNZ, FTX, FTY, FTZ, M1, M2, M3), FN (FNX, FNY, FNZ), FT (FTX, FTY, FTZ), M (MX, MY, MZ), GLOBAL (FNX, FNY, FNZ, FTX, FTY, FTZ, MX, MY, MZ), LOCAL (F1, F2, F3, M1, M2, M3), CENTER (CX, CY, CZ)	Load set ID of XSECT
SPRING, BUSH	DEF (FX, FY, FZ, MX, MY, MZ, LX, LY, LZ, RX, RY, RZ, IE, OFF)	Element ID
BEAM, BAR	DEF (F1, F2, M2, M3, IE, OFF), F3, M1	Element ID
ROD	DEF(F, M, IE)	Element ID

Table 2: Output Request Descriptions

Type	Output Data Label	Description and Remarks
Global	IE	Internal energy. Global internal energy includes all material internal energy and global spring internal energy, but not spring rotational internal energy.
	KE	Kinetic energy.
	RKE	Rotational kinetic energy.
	CE	Contact energy.
	HE	Hourglass energy.
	SIE	Spring internal energy.
	EFW	External forces work.
	TE	Energy sum IE + KE.
	RTE	Total rotational energy IE + KE + RKE.
	TTE	Total energy sum IE + KE + RKE + CE + HE.
	DTE	Delta energy TTE - EFW.
	XMOM, YMOM, ZMOM	Momentum.
	DT	Time step.
	TER
	DTE_REL
	VX, VY, VZ	Velocities.
GRID	X, Y, Z	Coordinates.
	DX, DY, DZ	Displacement components.
	VX, VY, VZ	Velocity components.
	AX, AY, AY	Acceleration components.
	VRX, VRY, VRZ	Angular velocity components.
	ARX, ARY, ARZ	Angular acceleration components.
	REACX, REACY, REACZ	Reaction force components
	REACXX, REACYY, REACZZ	Reaction moment components
PROP	IE	Internal energy.
	KE	Kinetic energy.
	XMOM, YMOM, ZMOM	Momentum components.
	HE	Hourglass energy.
	XCG, YCG, ZCG	Center of gravity.
	XXMOM, YYMOM, ZZMOM	Rotational momentum components.
	IXX, IYY, IZZ, IXY, IYZ, IZX	Inertia matrix components.
	RIE	Shear internal energy.
	KERB, RKERB	Translational and rotational rigid body energy.
	RKE	Rotational kinetic energy.
SHELL	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.
	IEM, IEB	Internal membrane and bending energy.
	EMIN, EMAX	Minimum, maximum equivalent plastic strain.
	OFF	Element status. See comment 8.
	THIC	Thickness.
	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	SX , SY, SZ, SXY, SYZ, SXZ	Stress tensor components.
	LSX, LSY, LSZ, LSXY, LSYZ, LSXZ	Local stress tensor components. Only ISOLID = 1, 2, 12
	IE	Internal energy.
	DENS	Density.
	BULK	Bulk viscosity.
	VOL	Volume.
	PLAS	Plastic strain. Only MATX02.
	TEMP	Temperature.
	OFF	Element status. See comment 8.
CONTCT	FNX, FNY, FNZ, FTX, FTY, FTZ	Normal and tangential force components.
CONTCT	MX, MY, MZ	Moment components.
RWALL	FNX, FNY, FNZ, FTX, FTY, FTZ	Normal and tangential force components.
SECT	FNX, FNY, FNZ, FTX, FTY, FTZ	Normal and tangential force components.
	MX, MY, MZ	Moment components.
	F1, F2, F3, M1, M2, M3	Forces and moments in section coordinates.
	CX, CY, CZ	Center of the section.
SPRING, BUSH	FX, FY, FZ, MX, MY, MZ	Forces and moment components.
	LX, LY, LZ	Elongation.
	RX, RY, RZ	Rotation.
	IE	Internal energy.
	OFF	Element status.
BEAM, BAR	F1, F2, F3, M1, M2, M3	Forces and moments in element coordinates
	IE	Internal energy
	OFF	Element status
ROD	F	Axial force
	M	Torsional moment
	IE	Internal energy