Analysis Visualization Overview

Analysis Solution	Analysis Visualization	Analysis Visualization Overview Some general concepts about Images definition
Technical Article

Abstract

The aim of this document is to explain the principles of analysis visualization. It is based on the "images definition files" that configure the images managing the display.

This article is intended to help you make your first steps in creating a new "Images definition file" using the Analysis visualization framework.

The analysis images concept
Images definition files

Principles
Images definition file structure
Attributes
Examples
ImageDefinition dtd
Image names
Provided interfaces

The analysis process concept
Standard processes
In Short
References

An Image : What is it ?

An Image is a 3D visualization of analysis data. It defines how the physical characteristic values are displayed on their finite element support. It contains all the information needed to display these values. It is a dress-up mode. This data may be pre-processing or post-processing results.

[Top]

Images definition files

The Images definition file defines all available images. It also defines how data (characteristics values) must be displayed. For each image, it contains all the information needed to display these values :

visualization type (HOW) : defines the type of display (symbol, text, contours, ...)
criterion (WHAT) : defines the values to be displayed (vector component, Von Mises criterion,...)
information to select the right characteristic. (value control : positions, mathematical type, ...)
process (elementary calculation allowing new data to be generated for display (example: normalize) )
filters (on components, layers, lamina, ...)
dress-up mode (color fixed or variable, arrow size, ...)

When you create a new image with the "Generate Image" command, the displayed image list is a sub list of all defined images. This subset list depends on the physical types the selected set or entity are able to produce.

When you choose an image the program searches for the best characteristic to be acquired according to the definition that was given for (Physical type, Visualization type, Criterion, Filters, ...) in the ImagesDefinition files.

Input characteristic	(Processes)	Intermediate characteristic	(Processes)	Output characteristic
<-- code	search -->	<-- depending on	images definition	files -->
It may be every characteristic having the physical type defined in the current image.	The previous list of characteristics is filtered to take into account the "position" and the "version" of the intermediate characteristic asked in the image definition. Processes may be added in order to change position, filters (on layer, lamina, ...) or mathematical types.	This characteristic is defined in the image description in terms of position, and version (value type, mathematical type, dimension, reference frame, category, combined or not combined characteristic)	All processes defined in the image description are added.	The output characteristic is created and computed according to the input one and to the image definition.

In fact, all images belonging to the same physical type are grouped so that the edition of an existing image enables you to pass from one to another. By edition you can choose an other visualization type, or criterion in the "Visu tab page", or change the dress-up (Options button), or finally control values or filters in the "Filter tab page".

Available and automatic mathematical type changes are :

from VECTOR, SYMMETRICAL-TENSOR, TENSOR or EIGEN_VALUES to SCALAR
from SYMMETRICAL-TENSOR or TENSOR to EIGEN_VALUES

[Top]

Principles

The images definition files defining all available images must be written in XML language (extensible markup language). For general rules and recommandation about XML consideration inside CAAV5, refer to [2].

An xml file named for example MyXMLfile is created in a directory : /.../CNext/reffiles/FEM/MyXMLfile .xml
After the Runtime View generation (mkrtv); this file is written in (depending on system) : /.../intel_a/reffiles/FEM/MyXMLfile .xml
When Interactive application is launched, the program searches first in the current directory (or in the /.../intel_a/reffiles/FEM/ directory) the requested xml files.
These files are interpreted the first time you need them.
The dtd file name is : \...\CNext\reffiles\FEM\ImageDefinition.dtd
A xsl (extensible stylesheet language) file is supplied by DS. It is useful to format the images definition files and to browse them in a pretty way.
The xsl file name is : \...\CNext\reffiles\FEM\ImageDefinition.xsl
A special header must introduced the xml file: It describes the xml version, the style sheet and the document type definition :

<?xml version="1.0" encoding="UTF-8"?>
<!-- COPYRIGHT DASSAULT SYSTEMES 2002 -->
<!DOCTYPE ImagesList SYSTEM "ImageDefinition.dtd">
<?xml-stylesheet type="text/xsl" href="ImageDefinition.xsl"?>
...

The ImagesDefinition files are loaded in the following order :

Standard ImagesDefinition files are delivered (depending on the installed product).
A special interface, named CATISamImageFactory, is provided in order to add and remove your own "ImagesDefinition" files and to retrieve the list of all loaded "ImagesDefinition" files.
The SPMAdminImagesDefinition file may be created or modified by the administrator. The path of this file is defined through an environment variable called SPMAdminXmlDir
The SPMUserTemplateImagesDefinition file may be created using the "SaveAsNewTemplate" command. (depending on the installed product). The Tools + Options + Analysis&Simulation + Post Processing menu enables the user to manage this file ( to define the path, to rename or delete image definitions). The behaviour of this file is a little bit different from the others : On the first hand, by edition, you can't switch from one image to another; on the other hand, you may add ImageExtension, but only on images belonging to the same file.
The SPMUserImagesDefinition file may be created or modified by user (depending on the installed product), it is recommended not to deliver applications with such a file name, because if multiple installations occur there will be some conflicts.

[Top]

Images definition file structure

...
ImagesList [ ] (Name)
|__Image [*] (Name, Physical, SubType, Visu, Hidden)
|     |__Criterion [ ] (Name)
|     |    |__Values [ ] (RefType, Combined)
|     |    |     |__ DefaultPosition [?] (Name)
|     |    |     |__ Position [+] (Name)
|     |    |     |__ MathType [+] (Name)
|     |    |     |__ MathDim [*] (Name)
|     |    |     |__ ValueType [*] (Name)
|     |    |     |__ Filters [?] 
|     |    |           |__ Smi [?] (Name)
|     |    |           |__ Lamina [?] (Name)
|     |    |           |__ Component [*] (Name, ApplyOn)
|     |    |           |__ ComplexPart [?] (Name)
|     |    |           |__ AxisSystem [*] (CoordinateSystem, ApplyOn)
|     |    |                 |__ Origin [?] (X, Y, Z)
|     |    |                 |__ X-Axis [ ] (X, Y, Z)
|     |    |                 |__ Y-Axis [ ] (X, Y, Z)
|     |    |                 |__ Z-Axis [ ] (X, Y, Z)
|     |    |__ ProcessList [?]
|     |          |__ Process [+] (Name)
|     |                |__ IParam [*]
|     |                |__ Fparam [*]
|     |                |__ CParam [*]
|     |__ Attributes [?]
|           |__ Text [?]
|           |      |__ FixedColor [?] (Red, Green, Blue, Alpha)
|           |__ Symbol [?] (Type, ZoomSensitive, Fixed)
|           |      |__ FixedColor [?] (Red, Green, Blue, Alpha)
|           |__Display [?] (Deformed, WithoutValues, Mode, Shrink)
|           |__ColorMap [?] (MinMaxMode, ComputeMode, Smooth)
|__ImageExtension [*] (Name)
|     |__AddValues [?]
|     |     |__DefaultPosition [?] (Name)
|     |     |__AddPosition [*] (Name)
|     |__RemoveValues [?]
|           |__RemovePosition [*] (Name)
|__ImageByReference [*] (Reference, Name, SubType, Hidden)

...

Conventions:

Words in bold characters are defined in the dtd (document type definition) as ELEMENT Words in (italic and parenthesis) are defined in the dtd as ATTLIST (Explanations on these attributes will be given in the next paragraph) The sign defined in red color between two brackets gives the number of expected fields:

[?] means (0 or 1 time)

[+] means (1 or several times)

[*] means (0 or several times)

[ ] sign means (1 time)

[Top]

Attributes

ELEMENT	ATTRIBUTE	EXPLANATION
ImagesList	Name	The name of the images list.
Image	Name	The image name. It must be unique. Associated NLS names may be provided (see CATISamImageFactory interface)
Image	Physical	The physical type of the characteristic to be visualized. Images with the same physical type and subtype are pooled.
Image	SubType	The subtype of the characteristic to be visualized. Images with the same physical type and subtype are pooled. For physical types like Stress, Strain or Energy, this parameter is optional. If you choose to define it , available values are : NOMINAL , LOGARITHMIC , ELASTIC , INELASTIC , THERMAL , PLASTIC. If the physical type is GENERIC_CHARACTERISTIQUE this parameter is requested, in this case any string is available. Default: no subtype is defined
Image	Visu	The visualization type. It may be AVERAGE-ISO, DISCONTINUOUS-ISO, SYMBOL, FRINGE, MESH or TEXT
Image	Hidden	An hidden image is not in the proposed list of images given by the generic command and can't be created directly. But, editing an existing image with the same physical type enables to create it .The value of hidden parameter may be YES or NO (default is NO)
Criterion	Name	The criterion name. It's used to choose between several images with the same visualization type. By edition, the change of the visualization type may induce the change of criterion. By default, if exists, the last criterion will be taken.
Values	RefType	To impose input-characteristic in a specific axis system. It may be GLOBAL, LOCAL or NONE. By default, no axis system type is imposed.
Values	Combined	To impose the input-characteristic to be combined or uncombined. By default, no choice is made .So, this attribute must not be given when no choice has to be done .The parameter value is either YES or NO.
DefaultPosition	Name	The default position name of the ouput-characteristic to be visualized. It may be NODE, EDGE, FACE, ELEMENT, GAUSS, CENTER, or NODE_OF_ELEMENT or a "user position".
Position	Name	The position name of the ouput-characteristic to be visualized. It may be NODE, EDGE, FACE, ELEMENT, GAUSS, CENTER, or NODE_OF_ELEMENT or a "user position". This position may be imposed by the visualization type : AVERAGE-ISO needs NODE position, DISCONTINUOUS-ISO needs NODE_OF_ELEMENT position and FRINGE needs ELEMENT, CENTER or FACE position.
MathType	Name	The mathematical type of the intermediate-characteristic before processes defined in the image were applied. It may be SCALAR, VECTOR, TENSOR, EIGEN_VALUES, SYMMETRICAL_TENSOR or BIT_ARRAY.
MathDim	Name	If this parameter is given, the input-characteristic must have the specified dimension. It may be 1D, 2D or 3D. By default, no specific dimension is imposed.
ValueType	Name	If this parameter is given, the input-characteristic must have the specified type. It may be CHARACTER, SHORT, INTEGER, REAL, DOUBLE, COMPLEX or COMPLEX_DOUBLE. By default, no specific type is imposed.
Filters		This element starts the filters definition. Filters may be on layer (Smi), on lamina (Lamina), on component (Component) or on complex part (ComplexPart). Filters on component may be elements dependent. If it's the case, the attribute ValueOn is used.
Smi	Name	During computation we will had a filter on layers for surfacic elements, if this attribute is specified . Parameter value may be UPPER, MID, LOWER or UPPER_LOWER (default is UPPER).
Lamina	Name	During computation we will had a filter on lamina, if this attribute is specified . Parameter value is an integer. It's the number of the chosen lamina.
Component	Name	During computation we will filter components of output-characteristic if this attribute is specified. The parameter value may be C1, C2, C3, C12, C13, C21, C23, C31, C32 (default is C1). It depends on the mathematical type of the output-characteristic. Filter for a vector may be C1, C2, C3. Filter for a tensor 2D may be C1, C2, (C12 if tensor is symmetrical), (C21 for full tensor).Filter for a tensor 3D may be C1, C2,C3, (C12, C13, C23 if tensor is symmetrical), (C21,C31,C32 for full tensor) .The output-characteristic may be different on 1D, 2D or 3D elements. (See attribute ApplyOn)
Component	ApplyOn	The filter component may be element dependent. This attribute, if defined specifies where it has to be applied. Authorized values are: ALL, 1D, 2D, 3D (default is ALL).
ComplexPart	Name	If output-characteristic is complex, during computation we will filter a part of this complex, if this attribute is specified. The parameter value may be REAL, IMAGINARY, MODULUS or PHASE (default is REAL).
AxisSystem	CoordinateSystem	The axis coordinate system to apply may be CARTESIAN, CYLINDRICAL or SPHERICAL (default is CARTESIAN)
AxisSystem	ApplyOn	The filter axis system may be element dependent. This attribute, if defined specifies where it has to be applied. Authorized values are: ALL, 1D, 2D, 3D (default is ALL).
Origin	X Y or Z	These attributes if defined specify the axis origin (default values are: (x=0.)(y=0.)(z= 0.))
X-Axis	X Y or Z	These attributes if defined specify the X-axis (default values are: (x=1.)(y=0.)(z= 0.))
Y-Axis	X Y or Z	These attributes if defined specify the Y-axis (default values are: (x=0.)(y=1.)(z= 0.))
Z-Axis	X Y or Z	These attributes if defined specify the Z-axis (default values are: (x=0.)(y=0.)(z= 1.))
ProcessList		This element starts the processes definition.
Process	Name	A process is an elementary calculation permitting new data to be generated for display from the intermediate-characteristics. (vector normalization, tensor eigen-values values,...). This attribute defines the name of the process to add. The input parameters of the process are specified with the Iparam, Fparam and Cparam values.
IParam		This element is used to give each integer parameter of the previous defined process
FParam		This element is used to give each float parameter of the previous defined process
CParam		This element is used to give each character parameter of the previous defined process
Attributes		This element starts the dress-up definition.
Text		This element starts the text dress-up.
FixedColor	Red	By default color is variable. You may imposed a fixed color for TEXT visualization , using the fixedColor element. The color is defined by this four integers lying between 0 and 255. (default color is BLUE : Red=Green=0 Blue=213 Alpha=255). This four arguments are the red, green blue and alpha attributes. Here is the definition of the Red attribute.
FixedColor	Green	(See definition of Red attribute). Here is the definition of the Green parameter.
FixedColor	Blue	(See definition of Red attribute). Here is the definition of the Blue parameter.
FixedColor	Alpha	(See definition of Red attribute). Here is the definition of the Alpha parameter.
Symbol	Type	If the image visualization type is SYMBOL, you may choose the symbol type. Authorized values are CUBE, TETRA, ARROW, DOUBLE-ARROW, TENSOR, PRESSURE, RESTRAINT, AXIS, POINT or BALL . Authorized values are mathematical type dependent : BIT_ARRAY needs RESTRAINT type. SCALAR needs CUBE, TETRA, BALL or PRESSURE type (default is CUBE). VECTOR needs ARROW or DOUBLE-ARROW type (default is ARROW), and EIGEN_VALUES needs AXIS or TENSOR type (default is TENSOR ). The POINT type may always be used.
Symbol	ZoomSensitive	This attribute enables to define if symbol is sensitive with zoom. It may be YES or NO (default is YES).
Symbol	Fixed	This attribute enables to define if the length of symbol is fixed or variable. It may be YES or NO (default is NO). (this option is ignored if POINT type)
FixedColor	Red	By default color is variable. You may imposed a fixed color for SYMBOL visualization, using the fixedColor element. Here is the definition of the Red attribute. (See definition of Red attribute for TEXT visualization)
FixedColor	Green	(See definition of Red attribute). Here is the definition of the Green parameter.
FixedColor	Blue	(See definition of Red attribute). Here is the definition of the Blue parameter.
FixedColor	Alpha	(See definition of Red attribute). Here is the definition of the Alpha parameter.
Display	Deformed	To define if the deformation is on or off. It may be YES or NO (default is NO).
Display	WithoutValues	This parameter is available for AVERAGE-ISO, DISCONTINUOUS-ISO or FRINGE visualization. If the value is YES, elements without values are drawn in white color. The value of the attribute may be YES or NO (default is NO).
Display	Mode	This parameter defines where the display has to be done. It may be FREE-FACES or ALL (default is FREE-FACES)
Display	Shrink	This parameter defines the value of shrink coefficient for elements. (default is 1.0 : there is no shrink). The correct values are between 0.5 and 1.0.
ColorMap	MinMaxMode	This parameter defines the way of computation for the color map. It may be FREE-FACES or ALL (default is FREE-FACES).
ColorMap	ComputeMode	This parameter defines the type of color map. It may be LINEAR, HISTOGRAM or LOG (default is LINEAR). In a LINEAR color map values are linearly distributed. In an HISTOGRAM color map there is an iso-distribution of values by colors (in this case, you cannot imposed a minimum or a maximum value by color map edition). In an LOG color map there is a logarithmic distribution of values by colors (in this case, values must be strictly positive).
ColorMap	Smooth	This parameter is used for AVERAGE-ISO, DISCONTINUOUS-ISO visualization, to define if the patterns are smoothed or not. It may be YES or NO (default is NO)
ImageExtension	Name	The name of the image to extend. An image with the same name must have been defined previously in a xml file. (Be careful with the loading order of the files !)
DefaultPosition	Name	The default position name of the ouput-characteristic to be visualized. It may be NODE, EDGE, FACE, ELEMENT, GAUSS, CENTER, or NODE_OF_ELEMENT or a "user position". To reset a default position set this parameter to "".
AddPosition	Name	The position name of the ouput-characteristic to be visualized. It may be NODE, EDGE, FACE, ELEMENT, GAUSS, CENTER, or NODE_OF_ELEMENT or a "user position". (See "position" to have more information ). This attribute is used to add a new Position to an image previously defined.
RemovePosition	Name	The position name of the ouput-characteristic to be visualized. It may be NODE, EDGE, FACE, ELEMENT, GAUSS, CENTER, or NODE_OF_ELEMENT or a "user position". (See "position" to have more information). This attribute is used to remove a Position to an image previously defined. After the remove, it must remain at least one position in the image
ImageByReference	Reference	The name of the referenced image. The referenced image must have been defined previously in a xml file. (Be careful with the loading order of the files !)
ImageByReference	Name	The name of the image to define by reference
ImageByReference	SubType	The subtype of the characteristic to be visualized. Images with the same physical type and subtype are pooled. For physical types like Stress, Strain or Energy, this parameter is optional. If you choose to define it , available values are : NOMINAL , LOGARITHMIC , ELASTIC , INELASTIC , THERMAL , PLASTIC. If the physical type is GENERIC_CHARACTERISTIQUE this parameter is requested, in this case any string is available. Default: no subtype is defined
ImageByReference	Hidden	An hidden image is not in the proposed list of images given by the generic command and can't be created directly. But, editing an existing image with the same physical type enables to create it .The value of hidden parameter may be YES or NO (default is NO)

[Top]

Examples

The aim of this image named "Disp_Iso" is to normalize the displacement vector (physical name : TRANSLATION) and to display the result as contours. Deformation as to be taken into account.

...
<Image Name="Disp_Iso" Physical="TRANSLATION" Visu="AVERAGE-ISO" >
  <Criterion Name="NORMALIZE" >
     <Values>
        <Position    Name="NODE"/>
        <MathType Name="VECTOR"/>
     </Values>
     <ProcessList>
        <Process Name="SPMProcessNormalize"/>
     </ProcessList>
  </Criterion>
  <Attributes>
     <Display Deformed="YES"/>
  </Attributes>
</Image>
...

The aim of this image named "Stress_Iso_PpalValue_Disc" is to search the eigen values of the stress tensor (physical name : STRESS) and to display the first component as discontinuous iso. Upper layer must be chosen for 2D elements. Deformation as to be taken into account. This image does not appear in the generic command. It will be accessed by edition only.

...
<Image Name="Stress_Iso_PpalValue_Disc" Physical="STRESS" Visu="DISCONTINUOUS-ISO" Hidden="Yes">
  <Criterion Name="PRINCIPAL-VALUE" >
     <Values>
        <Position Name="NODE_OF_ELEMENT"/>
         <MathType Name="EIGEN_VALUES"/>
         <Filters>
           <Smi Name="UPPER"/>
           <Component Name="C1"/>
         </Filters>
     </Values>
  </Criterion>
  <Attributes>
      <Display Deformed="YES"/>
  </Attributes>
</Image>
...

The aim of this image named "Stress_Symbol_PpalTensor" is to search the eigen values of the stress tensor (physical name : STRESS) and to display the eigen tensor as symbol. Upper layer must be chosen for 2D elements. Deformation as to be taken into account. The results symbols may be displayed at nodes , at centers of elements , at gauss points of elements or at nodes of elements.

...
<Image Name="Stress_Symbol_PpalTensor" Physical="STRESS" Visu="SYMBOL" >
   <Criterion Name="PRINCIPAL-VALUE" >
     <Values>
        <DefaultPosition Name="NODE"/>
        <Position Name="CENTER"/>
        <Position Name="NODE_OF_ELEMENT"/>
        <Position Name="GAUSS"/>
        <MathType Name="EIGEN_VALUES"/>
         <Filters>
           <Smi Name="UPPER"/>
         </Filters>
     </Values>
  </Criterion>
  <Attributes>
     <Display Deformed="YES"/>
  </Attributes>
</Image>
...

The aim of this image named "EstimatedError_Symbol" is to display symbols of the estimated error (physical name : ESTIMATED_ERROR) . The symbols will be displayed at the centers of the elements, as blue cubes. The color map as to be computed on all model. This image does not appear in the generic command. It will be accessed by edition only.

...
<Image Name="EstimatedError_Symbol" Physical="ESTIMATED_ERROR" Visu="SYMBOL" Hidden="YES" >
  <Criterion Name="SCALAR" >
    <Values>
      <Position Name="CENTER"/>
      <MathType Name="SCALAR"/>
    </Values>
  </Criterion>
  <Attributes>
    <Symbol Type="CUBE">
      <FixedColor Red="0" Green="0" Blue="213" Alpha="255"/>
    </Symbol>
    <ColorMap MinMaxMode="ALL"/>
  </Attributes>
</Image>
...

The aim of this extension is to add a new position "NODE_OF_ELEMENT" to the image named "Elements_Text". The image named "Elements_Text" is supposed to be already defined in the same or in another xml file.

...
<ImageExtension Name="Elements_Text"  >
    <AddValues>
      <AddPosition Name="NODE_OF_ELEMENT"/>
    </AddValues>
</ImageExtension>
...

The aim of this extension is to set the position "NODE_OF_ELEMENT" as default position in the image named "Elements_Text". The image named "Elements_Text" is supposed to be already defined in the same or in another xml file.

...
<ImageExtension Name="Elements_Text"  >
    <AddValues>
      <DefaultPosition Name="NODE_OF_ELEMENT"/>
    </AddValues>
</ImageExtension>
...

The aim of this extension is to reset the default position "NODE_OF_ELEMENT" in the image named "Elements_Text". The image named "Elements_Text" is supposed to be already defined in the same or in another xml file.

...
<ImageExtension Name="Elements_Text"  >
    <AddValues>
      <DefaultPosition Name=""/>
    </AddValues>
</ImageExtension>
...

The aim of this extension is to remove a position "NODE_OF_ELEMENT" to the image named "Elements_Text". The image named "Elements_Text" is supposed to be already defined in the same or in another xml file.

...
<ImageExtension Name="Elements_Text"  >
    <RemoveValues>
      <RemovePosition Name="NODE_OF_ELEMENT"/>
    </RemoveValues>
</ImageExtension>
...

The aim of this example is to add a new image named "Relative_Disp_Symbol" using by reference the image named "Disp_Symbol". The image named "Disp_Symbol" is supposed to be already defined in the same or in another xml file. The new image will be the same as the reference. Only the subtype will be changed.

...
<ImageByReference Name="Relative_Disp_Symbol" Reference="Disp_Symbol" SubType="RELATIVE" />
...

[Top]

ImageDefinition.dtd

...
<!ELEMENT ImagesList ( (Image) | (ImageExtension)  | (ImageByReference) )* >
<!ATTLIST ImagesList Name CDATA #REQUIRED >

<!-- START Image creation -->

<!ELEMENT Image ( Criterion , Attributes? ) >
<!ATTLIST Image Name  CDATA #REQUIRED
          Physical    CDATA #REQUIRED
          SubType     CDATA #IMPLIED
          Visu        ( AVERAGE-ISO | DISCONTINUOUS-ISO | SYMBOL | FRINGE | MESH | TEXT ) #REQUIRED
          Hidden      ( YES | NO ) "NO" >
    	  GroupID     CDATA #IMPLIED >	

<!ELEMENT Criterion ( Values , ProcessList? )>
<!ATTLIST Criterion Name CDATA #REQUIRED >

<!ELEMENT Values ( DefaultPosition? , Position+ , MathType+ , MathDim* , ValueType* , Filters? ) >
<!ATTLIST Values RefType    ( GLOBAL | LOCAL | NONE  ) #IMPLIED
                 Combined   ( YES | NO ) #IMPLIED >

<!ELEMENT DefaultPosition EMPTY >
<!-- predefined positions are ( NODE | EDGE | FACE | ELEMENT | GAUSS | CENTER | NODE_OF_ELEMENT  ) -->
<!ATTLIST DefaultPosition Name CDATA #REQUIRED >

<!ELEMENT Position EMPTY >
<!-- predefined positions are ( NODE | EDGE | FACE | ELEMENT | GAUSS | CENTER | NODE_OF_ELEMENT  ) -->
<!ATTLIST Position Name CDATA #REQUIRED >

<!ELEMENT MathType EMPTY >
<!ATTLIST MathType Name ( SCALAR | VECTOR | TENSOR | EIGEN_VALUES | SYMMETRICAL_TENSOR | BIT_ARRAY) #REQUIRED >

<!ELEMENT MathDim EMPTY >
<!ATTLIST MathDim Name ( 1D | 2D | 3D ) #REQUIRED >

<!ELEMENT ValueType EMPTY >
<!ATTLIST ValueType Name ( CHARACTER | SHORT | INTEGER | REAL | DOUBLE | COMPLEX | COMPLEX_DOUBLE ) #REQUIRED >

<!ELEMENT Filters   (Smi ?, Lamina ?, Component *, ComplexPart ?, AxisSystem * ) >

<!ELEMENT Smi EMPTY >
<!ATTLIST Smi Name ( UPPER | MID | LOWER | UPPER_LOWER ) “UPPER” >

<!ELEMENT Lamina EMPTY >
<!ATTLIST Lamina Name CDATA #REQUIRED >

<!ELEMENT Component EMPTY >
<!ATTLIST Component Name ( C1 | C2 | C3 | C12 | C13 | C21 | C23 | C31 | C32) “C1” >
<!ATTLIST Component ApplyOn (ALL | 1D | 2D | 3D ) “ALL” >

<!ELEMENT ComplexPart EMPTY >
<!ATTLIST ComplexPart Name ( REAL | IMAGINARY | MODULUS | PHASE) “REAL” >

<!ELEMENT AxisSystem ( Origin ?, X-Axis , Y-Axis , Z-Axis ) >
<!ATTLIST AxisSystem CoordinateSystem ( CARTESIAN | CYLINDRICAL | SPHERICAL) “CARTESIAN ” >
<!ATTLIST AxisSystem ApplyOn (ALL | 1D | 2D | 3D ) “ALL” >

<!ELEMENT Origin EMPTY >
<!ATTLIST Origin X CDATA “0.” >
<!ATTLIST Origin Y CDATA “0.” >
<!ATTLIST Origin Z CDATA “0.” >

<!ELEMENT X-Axis EMPTY >
<!ATTLIST X-Axis X CDATA “1.” >
<!ATTLIST X-Axis Y CDATA “0.” >
<!ATTLIST X-Axis Z CDATA “0.” >

<!ELEMENT Y-Axis EMPTY >
<!ATTLIST Y-Axis X CDATA “0.” >
<!ATTLIST Y-Axis Y CDATA “1.” >
<!ATTLIST Y-Axis Z CDATA “0.” >

<!ELEMENT Z-Axis EMPTY >
<!ATTLIST Z-Axis X CDATA “0.” >
<!ATTLIST Z-Axis Y CDATA “0.” >
<!ATTLIST Z-Axis Z CDATA “1.” >

<!ELEMENT ProcessList ( Process+ ) >

<!ELEMENT Process ( IParam* , FParam* , CParam* ) >
<!ATTLIST Process Name CDATA #REQUIRED >

<!ELEMENT IParam (#PCDATA) >
<!ELEMENT FParam (#PCDATA) >
<!ELEMENT CParam (#PCDATA) >

<!ELEMENT Attributes ( Text? , Symbol? , Display? , ColorMap? ) >

<!ELEMENT Text ( FixedColor? ) >

<!ELEMENT Symbol ( FixedColor? ) >
<!ATTLIST Symbol Type          ( CUBE | TETRA | ARROW | DOUBLE-ARROW | TENSOR | PRESSURE | RESTRAINT | AXIS | POINT | BALL ) "ARROW" >
<!ATTLIST Symbol ZoomSensitive ( YES | NO ) "YES" >
<!ATTLIST Symbol Fixed         ( YES | NO ) "NO" >

<!ELEMENT FixedColor EMPTY >
<!ATTLIST FixedColor Red   CDATA #REQUIRED >
<!ATTLIST FixedColor Green CDATA #REQUIRED >
<!ATTLIST FixedColor Blue  CDATA #REQUIRED >
<!ATTLIST FixedColor Alpha CDATA #REQUIRED >

<!ELEMENT Display EMPTY >
<!ATTLIST Display Deformed      ( YES | NO )         "NO" >
<!ATTLIST Display WithoutValues ( YES | NO )         "NO" >
<!ATTLIST Display Mode   ( FREE-FACES | ALL ) "FREE-FACES" >
<!ATTLIST Display Shrink   CDATA  #IMPLIED >

<!ELEMENT ColorMap EMPTY >
<!ATTLIST ColorMap MinMaxMode  ( FREE-FACES | ALL )   "FREE-FACES" >
<!ATTLIST ColorMap ComputeMode ( LINEAR | HISTOGRAM | LOG ) "LINEAR" >
<!ATTLIST ColorMap Smooth      ( YES | NO )         "NO" >
<!-- END Image creation -->

<!-- START Image extension -->

<!ELEMENT ImageExtension ( AddValues?, RemoveValues? ) >
<!ATTLIST ImageExtension Name CDATA #REQUIRED >

<!ELEMENT AddValues  ( DefaultPosition? , AddPosition* ) >

<!ELEMENT AddPosition EMPTY >
<!ATTLIST AddPosition Name CDATA #REQUIRED >

<!ELEMENT RemoveValues  ( RemovePosition* ) >

<!ELEMENT RemovePosition EMPTY >
<!ATTLIST RemovePosition Name CDATA #REQUIRED >

<!-- END Image extension -->

<!-- START Image by reference -->

<!ELEMENT ImageByReference EMPTY >
<!ATTLIST ImageByReference Reference CDATA #REQUIRED 
			   Name      CDATA #REQUIRED
                           SubType   CDATA #IMPLIED
                           Hidden    ( YES | NO ) "NO" >
			   GroupID   CDATA #IMPLIED >	
<!-- END Image by reference -->

...

[Top]

Image names

The available products may be :

Generative Part Structural Analysis : GPS (G in this table)
ELFINI Structural Analysis : EST (E in this table)

The images spotted with an asterisk may be generated with the Generate image command or by selecting an icon

Physical type	Internal name (name in xml file)	English NLS name	Product
3D_COORDINATES	Coordinates_Symbol	Nodal coordinates symbol	E *
3D_COORDINATES	Coordinates_Text	Nodal coordinates text	E
ANGLE	Composite_Angle	Composite angle symbol	E *
ANGULAR_ACCELERATION	AngularAcc_Symbol	Angular acceleration vector	E *
	AngularAcc_Text	Angular acceleration text	E
	AngularAcc_Fringe	Angular acceleration fringe	E
ANGULAR_VELOCITY	AngularVelocity_Symbol	Angular velocity vector	E *
	AngularVelocity_Text	Angular velocity text	E
	AngularVelocity_Fringe	Angular velocity fringe	E
AREA_MOMENT_OF_INERTIA	AreaMomentOfInertia_Text	Area moment of inertia (text)	E *
AREA_SHEAR_RATIO_XY	AreaShearRatioInXYPlane_Text	Area shear ratio in XY plane (text)	E *
AREA_SHEAR_RATIO_XZ	AreaShearRatioInXZPlane_Text	Area shear ratio in XZ plane (text)	E *
CLEARANCE	Display_clearance_symbol	Clearance symbol	E
	Display_clearance_text	Clearance text	E
	Display_clearance_iso	Clearance iso	E *
CROSS_SECTIONAL_AREA	CrossSectionalArea_Text	Cross sectional area text	E
	CrossSectionalArea_Fringe	Cross sectional area fringe	E
	CrossSectionalArea_Symbol	Cross sectional area symbol	E *
CURVATURE	Curvature_Text	Curvature text	E *
DEGREES_OF_FREEDOM	Restraint	Degrees of freedom symbol	E *
ELASTIC_ENERGY	ElasticEnergy_Text	Local strain energy text	E
	ElasticEnergy_Fringe	Local strain energy	E *
	ElasticEnergy_Symbol	Local strain energy symbol	E *
ELASTIC_ENERGY_DENSITY	ElasticEnergyDensity_Text	Local strain energy density text	E
	ElasticEnergyDensity_Fringe	Local strain energy density	E *
	ElasticEnergyDensity_Symbol	Local strain energy density symbol	E
ELEMENTS	Mesh	Mesh	G / E *
	Mesh_Deformed	Deformed Mesh	G / E *
	Elements_Text	Elements text	E *
ESTIMATED_ERROR	EstimatedError_Fringe	Estimated local error	G / E *
	EstimatedError_Text	Estimated local error text	E
	EstimatedError_Symbol	Estimated local error symbol	E
FORCE_FLOW	Force_Flow_Text	Force flow text	E *
FRICTION_RATIO	Display_FrictionRatio_Symbol	Friction force ratio symbol	E
	Display_FrictionRatio_Text	Friction force ratio text	E
	Display_FrictionRatio_Iso	Friction force ratio iso	E *
LINEIC_FORCE	Lineic_Force_Symbol	Line force vector	E *
LINEIC_FORCE	Lineic_Force_Text	Line force text	E
LINEIC_MASS	Lineic_Mass_Symbol	Line mass symbol	E *
LINEIC_MASS	Lineic_Mass_Text	Line mass text	E *
LOCAL_AXIS	LocalAxis	Local axis symbol	E *
MASS_INERTIA	MassInertia_Text	Mass inertia (text)	E *
MASS_MOMENT_OF_INERTIA	MassMomentOfInertia_Text	Mass moment of inertia (text)	E *
MATERIAL	Material_Text	Material text	E
MATERIAL	Material_Fringe	Material fringe	E *
MOMENT_FLOW	Moment_Flow_Text	Moment flow text	E *
NB_LAMINATES	Nb_laminates	Laminate number text	E *
NB_LAMINATES	Nb_laminates_Fringe	Laminate number fringe	E
NODES	Nodes_Text	Nodes text	E *
OFFSET	Offset_Symbol	offset (symbol)	E *
OFFSET	Offset_Text	offset (text)	E
ORIENTATION_VECTOR	Orientation_Vector_Symbol	Orientation vector (symbol)	E *
ORIENTATION_VECTOR	Orientation_Vector_Text	Orientation vector (text)	E
PHYSICAL_TYPE	PhysicalType_Text	Physical type text	E
PHYSICAL_TYPE	PhysicalType_Fringe	Physical type fringe	E *
PLY_ID	Ply_id	Ply id text	E *
PLY_ID	Ply_id_Fringe	Ply id fringe	E
POINT_FORCE	Force_Iso	Point force magnitude	E
	Force_Iso_Component	Point force component	E
	Force_Symbol	Point force vector	E *
	Force_Text	Point force text	E
	Freebody_Force_Iso	Free body force magnitude	E
	Freebody_Force_Iso_Component	Free body force component	E
	Freebody_Force_Symbo	Free body force vector	E
	Freebody_Force_Text	Free body force text	E
POINT_MASS	Point_Mass_Symbol	Point mass symbol	E *
	Point_Mass_Text	Point mass text	E *
	Point_Mass_Iso	Point mass	E
POINT_MOMENT	Moment_Symbol	Point moment vector	E *
	Moment_Text	Point moment text	E
	Moment_Iso	Point moment magnitude	E
	Moment_Iso_Component	Point moment component	E
	Freebody_Moment_Symbol	Free body moment vector	E
	Freebody_Moment_Text	Free body moment text	E
	Freebody_Moment_Iso	Free body moment magnitude	E
	Freebody_Moment_Iso_Component	Free body moment component	E
POST PROCESSING CHARAC (ENVELOP_VALUES)	Values_Symbol	Values symbol	E *
	Values_Text	Values text	E
	Values_Average_Iso	Values average iso	E
	Values_Discontinuous_Iso	Values discontinuous iso	E
	Values_Fringe	Values fringe	E
POST PROCESSING CHARAC (ENVELOP_CRITICALS)	Criticals_Symbol	Critical sets symbol	E *
	Criticals_Text	Critical sets text	E
	Criticals_Average_Iso	Critical sets average iso	E
	Criticals_Discontinuous_Iso	Critical sets discontinuous iso	E
	Criticals_Fringe	Critical sets fringe	E
PRESSURE	Pressure_Symbol	Pressure vector	E *
	Pressure_Text	Pressure text	E
	Pressure_Fringe	Pressure fringe	E *
	Pressure_Iso	Pressure (nodal values)	E *
ROTATION	Rotation_Iso	Rotational displacement magnitude	E *
	Rotation_Iso_Component	Rotational displacement component	E
	Rotation_Symbol	Rotational displacement vector	E *
	Rotation_text	Rotational displacement text	E
ROTATIONAL_ACCELERATION	Rotational_Acceleration_Symbol	Rotational acceleration vector	E *
	Rotational_Acceleration_Text	Rotational acceleration text	E
	Rotational_Acceleration_Iso	Rotational acceleration iso	E
ROTATIONAL_STIFFNESS	Rotational_Stiffness_Symbol	Rotational stiffness (symbol)	E *
ROTATIONAL_STIFFNESS	Rotational_Stiffness_Text	Rotational stiffness (text)	E
ROTATIONAL_VELOCITY	Rotational_Velocity_Symbol	Rotational velocity vector	E *
	Rotational_Velocity_Text	Rotational velocity text	E
	Rotational_Velocity_Iso	Rotational velocity iso	E
SHEAR_CENTER	ShearCenter_Text	Shear center (text)	E *
STRAIN	Strain_Iso_PpalValue	Strain principal tensor component (nodal values)	E *
	Strain_Symbol_PpalTensor	Strain principal tensor symbol	E *
	Strain_Text_PpalTensor	Strain principal tensor text	E
	Strain_Iso_Tensor_Component	Strain full tensor component (nodal values)	E *
	Strain_Text_SymTensor	Strain full tensor text	E
STRESS	Stress_Iso_PpalShearing_Disc	Stress principal shearing (element's nodes values)	G / E
	Stress_Iso_PpalValue_Disc	Stress principal tensor component (element's nodes values)	G / E *
	Stress_Symbol_PpalTensor	Stress principal tensor symbol	G / E *
	Stress_Iso_VonMises	Stress Von Mises criterion (nodal values)	E
	Stress_Iso_VonMises_Disc	Stress Von Mises criterion (element's nodes values)	E
	Stress_Text_VonMises	Stress Von Mises criterion text	E
	Stress_Iso_PpalValue	Stress principal tensor component (nodal values)	E
	Stress_Iso_PpalValue_Abs	Stress principal tensor component (nodal absolute values)	E
	Stress_Iso_PpalValue_Disc_Abs	Stress principal tensor component (element's nodes absolute values)	E
	Stress_Text_PpalTensor	Stress principal tensor text	E
	Stress_Text_PpalTensor_Abs	Stress principal tensor text (absolute)	E
	Stress_Iso_Tensor_Component	Stress full tensor component (nodal values)	E *
	Stress_Iso_Tensor_Component_Disc	Stress full tensor component (element's nodes values)	E *
	Stress_Text_SymTensor	Stress full tensor text	E *
	Stress_Iso_PpalShearing	Tensor for maximum shearing (nodal values)	E
	Stress_Text_PpalShearing	Tensor for maximum shearing text	E
	StressVonMises_Fringe	Stress Von Mises criterion (center of element's values)	E
STRESS (SHEAR)	ShearStress_Disc	Shear panel stress (element's nodes values)	E *
STRESS (SHEAR)	ShearStress_Text	Shear panel stress text	E *
STRESS (SURFACE)	Surface_Stress_Symbol_PpalTensor	Surface stress principal tensor symbol	E *
	Surface_Stress_Iso_PpalValue_Disc	Surface stress principal tensor component (element's nodes values)	E
	Surface_Stress_Iso_PpalValue	Surface stress principal tensor component (nodal values)	E
	Surface_Stress_Text_PpalTensor	Surface stress principal tensor text	E
	Surface_Stress_Iso_Tensor_Component	Surface stress full tensor component (nodal values)	E
	Surface_Stress_Iso_Tensor_Component_Disc	Surface stress full tensor component (element's nodes values)	E
	Surface_Stress_Text_SymTensor	Surface stress full tensor text	E
STRESS_VON_MISES	StressVonMises_Iso_Smooth	Von Mises Stress (nodal values)	G / E *
	StressVonMises_Iso_Disc	Von Mises Stress (element's nodes values)	E *
	StressVonMises_Text	Von Mises Stress text	E
	StressVonMises_Symbol	Von Mises stress (symbol)	E
SURFACIC_FORCE	Surfacic_Force_Symbol	Surface force vector	E *
	Surfacic_Force_Text	Surface force text	E
	Surfacic_Force_Fringe	Surface force fringe	E
SURFACIC_MASS	Surfacic_Mass_Symbol	Surface mass symbol	E *
	Surfacic_Mass_Text	Surface mass text	E *
	Surfacic_Mass_Fringe	Surface mass fringe	E
TEMPERATURE	Temperature_Field_Fringe	Temperature field fringe	G / E *
	Temperature_Field_Text	Temperature field text	G / E
	Temperature_Field_Iso	Temperature field iso	G / E
	Temperature_Field_Symbol	Temperature field symbol	E *
THICKNESS	Lamina_Thickness_Text	Thickness text (Lamina)
	Lamina_Thickness_Fringe	Thickness fringe (Lamina)
	Thickness_Text	Thickness text	E
	Thickness_Fringe	Thickness fringe	E *
TRANSLATION	Disp_Iso	Translational displacement magnitude	G / E *
	Disp_Iso_Component	Translational displacement component	G / E *
	Disp_Symbol	Translational displacement vector	G / E *
	Disp_Text	Translational displacement text	E
TRANSLATION (RELATIVE)	Relative_Disp_Symbol	Relative translational displacement vector	G / E *
TRANSLATION (SNG)	Local_Singularity_In_Rotation	Local singularity in rotation	E *
TRANSLATIONAL_ACCELERATION	Acceleration_Symbol	Acceleration vector	E *
	Acceleration_Text	Acceleration text	E
	Acceleration_Iso	Acceleration	E
	Acceleration_Fringe	Acceleration fringe	E
TRANSLATIONAL_ACCELERATION (RELATIVE)	Relative_Acceleration_Symbol	Relative acceleration vector	E *
TRANSLATIONAL_STIFFNESS	Translational_Stiffness_Symbol	Translational stiffness (symbol)	E *
TRANSLATIONAL_STIFFNESS	Translational_Stiffness_Text	Translational stiffness (text)	E
TRANSLATIONAL_VELOCITY	Velocity_Symbol	Velocity vector	E *
	Velocity_Text	Velocity text	E
	Velocity_Iso	Velocity	E
TRANSLATIONAL_VELOCITY (RELATIVE)	Relative_Velocity_Symbol	Relative velocity vector	E *
TRANSVERSE_SHEAR_STRAIN	Transverse_Shear_Strain_Text	Transverse shear strain text	E *
TRANSVERSE_SHEAR_STRAIN	Transverse_Shear_Strain_Iso	Transverse shear strain iso	E
TRANSVERSE_SHEAR_STRESS	Transverse_Shear_Stress_Text	Transverse shear stress text	E *
TRANSVERSE_SHEAR_STRESS	Transverse_Shear_Stress_Iso	Transverse shear stress iso	E
USER_NUMBER	UserNodesNumber_Text	User nodes text	E *
USER_NUMBER	UserElementsNumber_Text	User elements text	E *
VOLUMIC_FORCE	Volumic_Force_Symbol	Volume force vector	E *
	Volumic_Force_Text	Volume force text	E
	Volumic_Force_Iso	Volume force	E
	Volumic_Force_Fringe	Volume force fringe	E
VOLUMIC_MASS	Volumic_Mass_Symbol	Volume mass symbol	E *
	Volumic_Mass_Text	Volume mass text	E *
	Volumic_Mass_Iso	Volume mass	E
	Volumic_Mass_Fringe	Volume mass fringe	E

[Top]

Provided interfaces

The provided interfaces are to be used according to following schema:

The CATISamImageFactory interface provides the methods to manage the "ImageDefinition" files and to create images. Query this interface on the post-processor container.

AddImageFile method : is used to add an image description file. The file path as to be specified. If the file path specified is MyFile, the NLS names of images will be searched in the file MyFile.CATNls.

RemoveImageFile method : is used to remove an image description file. The file path as to be specified.
GetImageFiles method : is used to retrieve the list of loaded image files and their paths.
CreateImage method : is used to create a new image, giving its name. The name parameter has to be found in one of the loaded image description files . You have to specify under which object (the owner) this new image has to be plugged (AnalysisSet or AnalysisEntity). You may specify the list of objects from which the values will be retrieved with the CATICharacCollector interface. If not specified (default), values will be retrieved from the owner parameter.
You may also specify the list of objects from which the displacements will be retrieved with the CATICharacCollector interface.
If not specified (default), displacements will be retrieved from the owner parameter.

The CATISamImage interface provides the methods :

to retrieve information (current parameters) on an existing image (for example : the ActivationStatus, the DeformMode, the DeformCoefficient, the SelectionGroup associated, the VisuTypeName, the CriteriaName, the CurrentOccurrence, the ColorMap).

to modify current parameters of an existing image.
to update the display of an existing image.

The CATISamImageColorMap interface provides the methods :

to retrieve information (current parameters) on an existing color map (for example : the number of colors, the minimum and maximum values of the color map, to know if the min (max) Value is imposed).
to modify current parameters of an existing color map.
to update the display of an existing color map.

The CATISamImageDisplayManager interface provides the methods to manage display of images. Query this interface on the post-processor container. This interface is used:

to retrieve information (current parameters) on the post-processor container (for example : the current display mode, the current deformation mode, the current pre-highlight mode ).
to modify these parameters.
to restore the previous modes for both pre-highlight and deformation modes.
to activate/deactivate all deactivated/activated images, starting from a root object.

[Top]

A Process : What is this ?

A process can be defined by:

A mathematical operation applied on the values stored in a CATAnalysisCharacCollector (or several) in order to create a new one (or several).
An elementary calculation enabling new data to be generated from the characteristics initially chosen (vector normalization, tensor Eigen values, ...).
A unique name.
A computation method that produces the Output characteristic(s).

A process may have input parameters. These parameters can be of types : INTEGER , FLOAT or CHAR parameters.

The process availability is defined through it's input characteristic(s). it will accept as version and position types:

Value Type (CHARACTER, SHORT, INTEGER, REAL, DOUBLE, COMPLEX or COMPLEX_DOUBLE ).
Mathematical Type (SCALAR, VECTOR, TENSOR, EIGEN_VALUES, SYMMETRICAL_TENSOR or BIT_ARRAY).
Mathematical Dimension (1D, 2D or 3D).
RefFrame (GLOBAL, LOCAL or NONE).
Category (NODE or ELEMENT).
ValuesAreCombined (TRUE or FALSE).
Position ( NODE | EDGE | FACE | ELEMENT | GAUSS | CENTER | NODE_OF_ELEMENT ).

The process gives the change it will operate on these version and position.

The appropriate interfaces to run a process is CATISPMProcess. For Process argument management, use CATISPMProcessAccess.

[Top]

Standard Processes

The analysis modeler provides some standard processes. They are described in the quick reference article.

[Top]

In Short

This document presented some principles of analysis visualization.

[Top]

References

[1]	Analysis Modeler Overview
[2]	CAA V5 XMLProgramming Rules
[3]	Analysis process reference
[Top]

History

Version: 1 [Jun 2002]	Document created
[Top]

Analysis Solution