H3dOutput

Model ElementThe H3dOutput element allows you specify various options for generating an H3dOutput file.

Class Name

H3dOutput

Attribute Summary

Name Property Modifiable by command? Designable?
save Bool () No No
linear_anim Bool ()
increment Int ()
start Double ()
end Double ()
format Enum ("AUTO MODAL NODAL NODALG", default="AUTO")
stress_format Enum ("NONE TENSOR", default="NONE")
strain_format Enum ("NONE TENSOR", default="NONE")

Usage

H3dOutput (optional parameters)

Attributes

save
Bool
"True" creates the H3D file.
"False" turns off generation of the H3D file.
This attribute is optional. Initially it is set to "True".
increment
Integer
Controls how often data is written to the H3D file. For example, "2" means data is written at every second step.
This attribute is optional. When not specified, and type="ON", output is written every step.
start
Double
Specifies the start time for writing the H3D file.
This attribute is optional. When not specified, and type="ON", start defaults to 0.0.
end
Double
Specifies the end time for writing the H3D file.
This attribute is optional. When not specified, and type="ON", end defaults to the simulation end time.
format
String
Select one from "MODAL", "NODAL", "NODALG", and "AUTO"
  • "MODAL": For flexible bodies, 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 HyperView Player.
  • "NODAL": For flexible bodies, node data are stored for each time frame. This usually produces larger H3D files than the MODAL option. However visualization is much faster since the modal to nodal conversion is not required during post-processing. Furthermore, "nodal" H3D files can be viewed using HyperView Player.
  • "NODALG": The global displacement of the nodes are written in one dataset to the H3D file. This is done by combining the rigid body transformation + local deformation and to obtain the global displacement of the node. It is primarily used for animation.
  • "AUTO": This method will select the method that yields the smallest H3D file.
Default = "AUTO".
stress or stress_format
String
Select one option from "NONE" and "TENSOR" (Default = TENSOR).
  • stress = "NONE": The stress results are not output to the H3D file. This option will help reduce the H3D file size for large model. It should always be used if stress results are of no interest.
  • stress_format = "TENSOR": The stress results are written in tensor format to the H3D file. HyperView will calculate the von Mises and other parameters from the stress tensor.
This attribute is optional. When not specified, it defaults to "NONE".
strain or strain_format
String
Select one option from "NONE" and "TENSOR" (Default = TENSOR).
  • strain = "NONE": The strain results are not output to the H3D file. This option will help reduce the H3D file size for large model. It should always be used if strain results are of no interest.
  • strain_format = "TENSOR": The strain results are written in tensor format to the H3D file.
This attribute is optional. When not specified, it defaults to "NONE".

Example

The example below demonstrates how H3dOutput options may be defined.
h3d = H3dOutput (save=True, inc=1, start=0.2, end=1.3, format="AUTO", stress="TENSOR", strain="TENSOR")

Comments

  1. See Properties for an explanation about what properties are, why they are used, and how you can extend these.