This is an old revision of the document!


3.5.16. OUTPUT-IMAGE function

optional

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:

  • the attachment: a field can be attached on the nodes or on the elements.
  • the nature: a field can be a scalar field, a vector field or a tensor field.

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.
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.

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:

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

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:

  • a node field.
  • a vector field.
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:

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

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:

  • a node field.
  • a vector field.
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:

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

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.

TRANSLATION branch

optional

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

  • a node field.
  • a vector field.
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:

  • a node field.
  • a vector field.
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:

  • an element field.
  • a tensor field.
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:

  • an element field.
  • a tensor field.
Keywords
Name Data Type Data number Optional Default value Physical quantity
FIELD-NAME STRING 1 NO
Name of the field in the output file.
OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  CHARACTERISTIC
    LOCAL-AXIS
      FIELD-NAME: LOCAL_AXIS_FIELD
OUTPUT-IMAGE   
  PATH: ".\images.h5"
  MODEL: MY_MODEL
 
  LOAD
    NAME: LOAD_CASE
    FORCE
      FIELD-NAME: FORCE_FIELD
    MOMENT
      FIELD-NAME: MOMENT_FIELD
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
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

-

-

  • /home/sesamxiobb/www/doc/data/pages/user_manual/sesamx/functions_description/output_image.txt
  • Last modified: 2023/05/30 21:54
  • by Ali Baba