HyperWorks Solvers

H3D Output

H3D Output

 Previous topic Next topic Expand/collapse all hidden text  

H3D Output

 Previous topic Next topic JavaScript is required for expanding text JavaScript is required for the print function  
hmtoggle_plus1greyXML Format

Command Element

Description

Defines an H3D output command.

Example

<H3DOutput

    switch_on          = "TRUE | FALSE"

    increment          = "integer "

    format_option      = "MODAL | NODAL | AUTO"

    stress_option      = "NONE | TENSOR"

    strain_option      = "NONE | TENSOR"

    start_time         = "real"

    end_time           = "real"

    elemforce_1d       = "TRUE | FALSE"

    nodal_velocity     = "TRUE | FALSE"

    nodal_acceleration = "TRUE | FALSE"

    linear_animation   = "TRUE | FALSE"

/>

Attributes

switch_on

TRUE creates H3D file, FALSE does not.

increment

Controls how often data is written to the H3D file. For example, "2" means data is written at every second step.

format_option

Select from MODAL, NODAL and AUTO (Default = AUTO).

stress_option

Select from NONE and TENSOR (Default = TENSOR).

strain_option

Select from NONE and TENSOR (Default = TENSOR).

start_time

Specifies the start time for writing the H3D.

start_time >= 0.0

start_time < simulation end time

start_time <= end_time

end_time

Specifies the end time for writing the H3D.

end_time <= simulation end time

start_time <= end_time

elemforce_1d

Select TRUE or FALSE to enable or disable 1D element force export to the H3D file.

nodal_velocity

Select TRUE or FALSE to enable or disable nodal velocity output to the H3D file.

nodal_acceleration

Select TRUE or FALSE to enable or disable nodal acceleration output to the H3D file.

linear_animation

Select TRUE or FALSE to enable or disable linear analysis mode shapes to be output to the H3D file.

Comments
1.The H3DOutput command produces an H3D file for animation.
2.When the model includes flexible bodies, the format_options MODAL, NODAL and AUTO provide control over file size.
3.If format_option = "MODAL", the mode shape data and time history of the modal participation factors will be stored in the H3D file.  This approach incurs a computational cost at load time as nodal results must be computed from modal results.  Also, this H3D file cannot be viewed with HyperViewPlayer.
4.If format_option = "NODAL", nodal data are stored for each time frame instead.  This usually produces larger H3D files than the MODAL option.  This is an advantage because these files load faster and they can be viewed using HyperViewPlayer.
5.If format_option = "AUTO", the most efficient option in reducing the H3D size will be automatically determined.
6.If stress_option = "NONE", then stress results are not output to the H3D file.  This option will help reduce the H3D file size for large models if stress results are of no interest.
7.If stress_option = "TENSOR", the stress results are written in tensor format to the H3D file.  HyperView will calculate the vonMises and other parameters from the stress tensor.
8.If the FlexH3D file does not have stress mode shapes, then the stress_option will be ignored.
9.The strain_option works in exactly the same way as the stress_option.
10.For the attributes nodal_velocity and nodal_acceleration to work properly, flex_vel_acc_output = TRUE must be set in the ResOutput command.  If it is not, nodal_velocity and nodal_acceleration will not be written to the H3D file.
11.When linear_animation is set to TRUE, there has to be a linear analysis in the simulation.  The linear analysis will generate <results_name>_linz.mrf, which is a requirement for the linear animation output to the H3D file.
12.The start_time and end_time can be used to reduce the size of the H3D in cases where the H3D generated is very large in size.  You can specify a window of interest where you would like to view the animation and skip the H3D generation for the remaining time in the simulation.
hmtoggle_plus1greyPython Format

Command Element

Description

Defines an H3D output command.

Declaration

def H3DOUTPUT(TYPE="", INC=0, START=0.0, END=0.0, FORMAT="", STRESS="", STRAIN=""):

Attributes

TYPE

ON creates the H3D file, OFF does not.

INC

Controls how often data is written to the H3D file.  For example, "2" means data is written at every second step.

START

Specifies the start time for writing the H3D file.

END

Specifies the end time for writing the H3D file.

FORMAT

Select from MODAL, NODAL, and AUTO (Default = AUTO).

STRESS

Select from NONE and TENSOR (Default = TENSOR).

STRAIN

Select from NONE and TENSOR (Default = TENSOR).

Comments

See H3DOutput

Example

The example below demonstrates how an H3DOUTPUT command may be defined.

H3DOUTPUT(TYPE="ON", INC=1, START=.2, END=1.3, FORMAT="AUTO", STRESS="TENSOR", STRAIN="TENSOR")

See Also:

Command Statements

Model Statements

Functions

Notation and Syntax