XHIST

Bulk Data Entry 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 etc.            
  ENTRY ID1 ID2 ID3 ID4 ID5 ID6 ID7  
    ID8 etc.            

Example

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

Definitions

Field Contents SI Unit Example
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 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 Information Entry.
  2. Table 1 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:
    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. 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. 8
    CONTCT FNX, FNY, FNZ, FTX, FTY, FTZ Normal and tangential force components.
    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