H3DOutput

Model Element

Class Name

H3DOutput

Description

The H3DOutput element allows you specify various options for generating an H3DOutput file.

Attribute Summary

Name	Property	Modifiable by command?
save	Bool ()
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)

Attribute Description

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_ = "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 = "TENSOR": The strain results are written in tensor format to the H3D file.

This attribute is optional. When not specified, it defaults to “NONE”.

Comments

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

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")