Table of Contents

3.5.16. OUTPUT-IMAGE function

optional

Description

This function is used to output images for various objects on a model: element characteristics, load cases, constraint cases and solutions. For each object, you can choose which fields you want to output as images. For instance, a load case allows you to output the force field or the moment field.

A field is characterized by 2 significant attributes:

For each field, this page provides all the information needed to analyze correctly the image generated.

Finally, SesamX stores the images in an output file (using the hdf5 format) that you can open with the SesamX viewer, or directly read and process with your own scripts. In this file, each field is identified with the name that you have provided in the OUTPUT-IMAGE data cards.

It is important to note that the image file generated is self-sustaining. This file contains the model plus all the data selected with the OUTPUT-IMAGE function.

Keywords

Name Data Type Data number Optional Default value Physical quantity
MODEL STRING 1 NO
Name of the model on which to compute the images.
PATH PATH 1 NO
Path to the image file containing the results.

CHARACTERISTIC branch

optional

This branch is used to create images of element characteristics. Currently, you can create images for the element local axis field.

LOCAL-AXIS branch

optional

This field describes the element local axis used to express the vector and tensor data on the elements. The local axis field is:

Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

LOAD branch

optional

This branch is used to create images of load cases. Currently, you can create images for the force and moment fields.

Keywords

Name Data Type Data number Optional Default value Physical quantity
NAME STRING 1 NO
Name of the load case used to compute the fields.

FORCE branch

optional

This field describes the force field on the model. This field is:

Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

MOMENT branch

optional

This field describes the moment field on the model. This field is:

Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

CONSTRAINT branch

optional

This branch is used to create images of constraint cases. Currently, you can create images for the translational SPC and the rotational SPC.

Keywords

Name Data Type Data number Optional Default value Physical quantity
NAME STRING 1 NO
Name of the constraint case used to compute the fields.

TRANS-SPC branch

optional

This field describes the translational SPC field on the model. This field is:

Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

ROT-SPC branch

optional

This field describes the rotational SPC field on the model. This field is:

Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

SOLUTION branch

optional

This branch is used to create images of solutions. Currently, you can create images for the translations, rotations, stresses and strains.

Keywords

Name Data Type Data number Optional Default value Physical quantity
NAME STRING 1 NO
Name of the solution used to compute the fields.

STEP branch

This branch is used to select the solution's step on which you seek to create images.

Keywords
Name Data Type Data number Optional Default value Physical quantity
NAME STRING 1 NO
Name of the step used.
TRANSLATION branch

optional

This field describes the translation field on the model. This field is:

Keywords

Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.
ROTATION branch

optional

This field describes the rotation field on the model. This field is:

Keywords

Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.
STRESS branch

optional

This field describes the stress field on the model. More precisely, it is the infinitesimal Cauchy stress tensor. This field is:

Keywords

Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.
STRAIN branch

optional

This field describes the strain field on the model. More precisely, it is the infinitesimal engineering strain tensor. This field is:

Keywords

Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.

Examples

Element characteristics image

OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  CHARACTERISTIC
    LOCAL-AXIS
      FIELD-NAME: LOCAL_AXIS_FIELD

Load case image

OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  LOAD
    NAME: LOAD_CASE
    FORCE
      FIELD-NAME: FORCE_FIELD
    MOMENT
      FIELD-NAME: MOMENT_FIELD

Constraint case image

OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  CONSTRAINT
    NAME: CONSTRAINT_CASE
    TRANS-SPC
      FIELD-NAME: TRANS_SPC_FIELD
    ROT-SPC
      FIELD-NAME: ROT_SPC_FIELD

Solution image

OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  SOLUTION
    NAME: ANA_LIN
    TRANSLATION
      FIELD-NAME: TRANS_FIELD
    ROTATION
      FIELD-NAME: ROT_FIELD
    STRAIN
      FIELD-NAME: STRAIN_FIELD
    STRESS
      FIELD-NAME: STRESS_FIELD

See also

-

References

-