Skip to content

16. Etc.

*Environment

Defines the environment settings that control the entire input file.

*Environment, Type=type
  ...
Keyword line

  • Type=type: Type of environment

    • UnitSystem: Set unit system
    • Info: Input string information
    • Control: Set internal control variable settings

*Environment, Type=UnitSystem

Set unit system

*Environment, TYPE=UnitSystem
 force-length-time-temperature
First data line and subsequent data lines
  • force: force unit (required). One of N, kN, kgf, tonf, lbf, kip
  • length: length unit (required). One of m, cm, mm, km, in, ft, yd, mi
  • time: time unit (required). One of s, min, hr, day
  • temperature: temperature unit(required), K, C, F

The global unit system can be defined at most once within a DB. If it is not specified, the DB has no unit system. A local unit system is an object-specific unit system used to interpret that object. It is used when materials or sections are imported from an external database, or when uniaxial material models are referenced, such as in *ShearTorsionMaterial, *Section, TYPE=MCK, *Section, TYPE=MovingSpring and *Section, TYPE=Interface. If a local unit system exists, the global unit system must also be defined.

Example
*Environment, Type=UnitSystem
 kN-mm-s-K

*Material, TYPE=IsoElasticity, Name=steelA
 ASTM_A992_Gr50@USSteel

*Material, TYPE=IsoElasticity, Name=steelB
 200, 0.2

*Section, TYPE=MCK, Name=Sp1
 Spring, X, steelA
 Spring, Y, steelB
 UnitSystem, kN-mm

*Section, TYPE=MCK, Name=Sp2
 Damper, X, steelA
 UnitSystem, kN-mm

*Section, TYPE=MCK, Name=Sp3
 Mass, X, 100.

*Section, TYPE=MCK, Name=Sp
 rail
 UnitSystem, kN-mm-s
 Spring, Y, 1595E3
 Damper, Y, 1000E3

*Section, Type=Interface Name=name
 steelA, steelB, steelA, 0.1, kN-mm

*Environment, Type=Info

Input string information

*Environment, Type=Info
 information ...
 ...
First data line and subsequent data lines
  • information: multilines are allowed

The content provided in an Info block is not used in the analysis; it is intended solely for conveying information to the user.

Example
*Environment, TYPE=Info
 The year of completion is 2000, and it received a Grade B condition rating during the 2005 inspection.
 The rating remained the same in 2009.

*Environment, Type=Control

Set internal control variable settings

*Environment, TYPE=Control
 Compact=On|Off
 EquationPrint=On|Off
 Shell5DOF=coincidentDirector, penaltyDrilling
 OutputPrecision=single|double
 ConstraintHandler=Gauss|QR
 NonsmoothIntegrationLevel=level
 BoundaryTolerance=btol
First data line and subsequent data lines
  • CompactForm=On|Off: Specifies whether to output nsets, elsets, and surfaces in compact form (default On).
  • EquationPrint=On|Off: Specifies whether to output equation numbers and constraints to a file (default Off). The output file name format is input-step.eqn and is generated for each step.

  • Shell5DOF=coincidentDirector, penaltyDrilling: Defines characteristic values at the nodes where 5-DOF shells meet.

    • coincidentDirector: The minimum angle to distinguish between the 5-DOF and 6-DOF at the node where the 5-DOF shells meet. The unit is degrees and must be a value between 0 and 90, and less than penaltyDrilling (default 0.1).
    • penaltyDrilling: The angle of the bending difference of shells at the node where the 5-DOF shells meet, for which the penalty drilling rotational stiffness is applied when assembled in 6-DOF. The unit is degrees and must be a value between 0 and 90 (default 5).

  • OutputPrecision=single|double: The precision of real numbers recorded in the result (*Result block) when writing to the .hdb file in binary or HDF5 format (default=single).

  • ConstraintHandler=Gauss|QR: The algorithm used for processing constraint equations. QR is faster, while Gauss is slower but more robust (default=QR).
  • NonsmoothIntegrationLevel=level: The level of numerical integration order applied when integrating nonsmooth or discontinuous functions. Values can be 0, 1, 2, or 3, with the default being 3. A value of 0 applies low-order integration corresponding to the shape function, 1 applies precision 5, 2 applies precision 7, and 3 applies precision 9.
  • BoundaryTolerance=btol: The allowable boundary tolerance when finding the position of sensors or connection points at the boundaries of continuum or shell elements in commands like *Sensor and *Constraint, TYPE=Embedded. If within this tolerance, it is assumed to be at the boundary. The default: 1E-4.
Example
*Environment, TYPE=Control
 Compact=Off

*Environment, TYPE=Control
 OutputPrecision=double

*Stop

Stop Input File Parsing

*Stop

*TestMaterial

Test material model for given strain history

*TestMaterial Mat=mat FILE=file
 TYPE=cond, FIELD=field1, field2, ...
 e1,e2,...,N=n
 ...
Keyword line
  • Mat=mat: material
  • FILE=file: output file name
First data line
  • TYPE=cond: Stress state. Options include U (1-axis stress), PS (plane stress), PE (plane strain), AX (axisymmetric), S (shell condition), G (3D).
  • FIELD=field1, field2, ...: Results to be outputted. S indicates stress, E indicates strain, DSDE indicates Jacobian (for results other than DSDE, refer to *Output).
Second data line
  • e1,e2,...: Strain. The number is determined according to the stress state.
  • N=n: Subpoint (Default 1).

*TestMaterial tests the material model using the given strain history and outputs the results to a file (material.csv). This command is executed immediately, and the results are not stored in the database. Below is the order of output for stress, strain, and plastic strain based on the stress state.

Example
*MATERIAL, TYPE=vonMises, Name=mat
 2000000.        # E, nu, alpha, density
 3000., 300.,    # yield, H, theta, Kinf, K0, delta

# strain history = 0.004, 0.005, 0.006, 0.0054, .... -0.006
*TestMaterial, Mat=mat, FILE=J2-U.csv
  TYPE=U Field=DSDE,E,S,PE,PEEQ
  0.004,
  0.006 N=2
 -0.006 N=10

*TestMaterial, Mat=mat, FILE=J2-3D.csv
  TYPE=G Field=DSDE,E,S,PE,PEEQ
  0.004,0.,0. 0. 0. 0.
  0.006,0.,0. 0. 0. 0. N=3
 -0.006,0.,0. 0. 0. 0. N=10