H3D Output

Command ElementDefines an H3D output command.


     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"


"TRUE" creates H3D file, "FALSE" does not.
Controls how often data is written to the H3D file. For example, "2" means data is written at every second step.
Select from "MODAL", "NODAL" and "AUTO" (Default = AUTO).
Select from "NONE" and "TENSOR" (Default = "TENSOR").
Select from "NONE" and "TENSOR" (Default = "TENSOR").
Specifies the start time for writing the H3D.
start_time >= 0.0
start_time < simulation end time.
start_time <= end_time
Specifies the end time for writing the H3D.
end_time <= simulation end time.
start_time <= end_time
Select "TRUE" or "FALSE" to enable or disable 1D element force export to the H3D file.
Select "TRUE" or "FALSE" to enable or disable nodal velocity output to the H3D file.
Select "TRUE" or "FALSE" to enable or disable nodal acceleration output to the H3D file.
Select "TRUE" or "FALSE" to enable or disable linear analysis mode shapes to be output to the H3D file.


  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 Output: Results 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.