Standard Reports

Within this section, the generation of standard reports is discussed.

This page discusses:

At the end of each optimization run, Tosca Structure generates standard post-processing reports based on templates in the installation and OPTIONS specified in your parameter file. The results are available as vtfx file <jobname>_report.vtfx in the directory <jobname>\TOSCA_POST. Tosca Structure generates automatically parameter files for each standard report like in the examples below. SIMULIA Tosca Structure Control will automatically add a DATABASE parameter to any of the REPORT commands, specifying the data source for the results. The corresponding Tosca Structure command is described in detail in the REPORT command specification.

Tosca Structure.topology Results

Per default, post-processing reports for topology optimization show only one case: the material distribution during the optimization. Further, the values of objective function and constraint and eventually defined variables are shown in result plots.


CONTOURPLOT
  ID_NAME       = TOPO_MAT
  TYPE_PROPERTY = ELEMENT_FILL_FILTER
  TITLE         = "Relative Material Distribution, soft elements filtered"
  DESCRIPTION   = "Tosca Structure.topology Optimization Result"
  FRINGE_RESULT = MAT_PROP_NORMALIZED
  FILTER        = 0.05, 1
  ITERATION     = ALL
END_

REPORT
  ID_NAME     = __JOBNAME___report
  OUTPUT_FILE = __JOBNAME___report
  CONTOURPLOT = TOPO_MAT
END_

A smoothed model can be added to the report automatically. The isovalue or target volume can be set in the OPTIONS command in the parameter file.

Tosca Structure.shape Results

Standard post-processing reports for shape optimization show two different cases: the controller input on the deformed model during the optimization as well as the absolute displacement values. Further, the values of objective function and constraint (if available) as well as the history of design response values is shown in result plots.


CONTOURPLOT
  ID_NAME        = SHAPE_DISP
  TYPE_PROPERTY  = NODAL_DISPLACEMENT
  TITLE          = "Nodal Displacement from  Shape Optimization"
  DESCRIPTION    = "Tosca Structure.shape  Optimization Result"
  FRINGE_RESULT  = DISP_OPT_VAL
  DISP_RESULT    = DISP_OPT
  ITERATION      = ALL
END_

CONTOURPLOT
  ID_NAME       = SHAPE_CTRL
  TYPE_PROPERTY = NODAL_CONTINUOUS
  TITLE         = "Controller Input on deformed model"
  DESCRIPTION   = "Tosca Structure.shape  Optimization Result"
  FRINGE_RESULT = CTRL_INPUT(OPT.)eqv.
  DISP_RESULT   = DISP_OPT
  ITERATION     = ALL
END_

REPORT
  ID_NAME     = __JOBNAME___report
  OUTPUT_FILE = __JOBNAME___report
  CONTOURPLOT = SHAPE_CTRL
  CONTOURPLOT = SHAPE_DISP
END_

Nodal Displacement Plots in Normal Direction

To request nodal displacement plots that show the node displacement in the normal direction only, a special USER_FILE commando is required in the parameter file.


USER_FILE
  ID_NAME     = UF_SHAPE_NORM_DISP
  FORMAT      = ONF
  EL_GROUP    = ALL_ELEMENTS
  TYPE        = SHAPE_NORM_DISP
  FILE_NAME   = SHAPE_NORMAL_DISP
  WRITE       = EVER
  FILE_OPTION = VAR2
END_

For generating the plots within a TEST_SHAPE run, the displacements of the next iteration must be requested and the test_shape FORMAT must be set to user-defined post-processing output.


USER_FILE
  ID_NAME = UF_SHAPE_NORM_DISP
  ! [...]
  TYPE    = SHAPE_NORM_DISP_N
END_

TEST_SHAPE
  OPTIMIZE     = OPTIMIZE_SHAPE_CONTROLLER
  DIRECTION    = GROW
  DISPLACEMENT = 10
  INCREMENT    = 5
  USER_FILE    = UF_SHAPE_NORM_DISP
  FORMAT       = USER_FILE
END_

Both commands create onf files in the SAVE.onf directory. Now, TOSCA_GUI can be used to generate vtfx plots.

Tosca Structure.bead Results

Standard post-processing reports for bead optimization show one case: the optimization displacement value on the deformed model during the optimization. Further, the values of objective function and constraint (if available) as well as the history of design response values is shown in result plots.


CONTOURPLOT
  ID_NAME       = BEAD_DISP
  TYPE_PROPERTY = NODAL_DISPLACEMENT
  TITLE         = "Nodal Displacement from Bead Optimization"
  DESCRIPTION   = "Tosca Structure.bead  Optimization Result"
  FRINGE_RESULT = DISP_OPT_VAL
  DISP_RESULT   = DISP_OPT
  ITERATION     = ALL
END_

REPORT
  ID_NAME     = __JOBNAME___report
  OUTPUT_FILE = __JOBNAME___report
  CONTOURPLOT = BEAD_DISP
END_

Tosca Structure.sizing Results

Standard post-processing reports for sizing optimization show two different cases: the shell thickness change on the model during the optimization as well as the shell thickness distribution. Further, the values of objective function and constraint (if available) as well as the history of design response values is shown in result plots.


REPORT
  ID_NAME      = GENERATE_REPORT_FILE
  OUTPUT_FILE  = "TOSCA_POST\GENERATE_REPORT_FILE"
  CONTOURPLOT  = SIZING_THICKNESS
  CONTOURPLOT  = SIZING_DELTA_THICKNESS
  CONTOURPLOT  = MODEL
END_

CONTOURPLOT
  ID_NAME        = SIZING_THICKNESS
  TYPE_PROPERTY  = ELEMENT_THICKNESS
  TITLE          = Thickness from Sizing Optimization
  DESCRIPTION    = "Tosca Structure.sizing Optimization Result"
  FRINGE_RESULT  = THICKNESS
  ITERATION      = ALL
END_

CONTOURPLOT
  ID_NAME        = SIZING_DELTA_THICKNESS
  TYPE_PROPERTY  = ELEMENT_DELTA_THICKNESS
  TITLE          = Thickness Change from Sizing Optimization
  DESCRIPTION    = "Tosca Structure.sizing Optimization Result"
  FRINGE_RESULT  = DELTA_THICKNESS
  ITERATION      = ALL
END_

Morphing Results

Standard post-processing reports for morphing results contain a contour plot of the OBJ_FUNC value referenced by the assigned shape optimization and the nodal displacement plots.


CONTOURPLOT
  ID_NAME       = SHAPE_DISP_XXX
  TYPE_PROPERTY = NODAL_DISPLACEMENT
  TITLE         = "Nodal Displacement from Shape Morphing"
  DESCRIPTION   = "Tosca Structure.shape Optimization Result...."
  FRINGE_RESULT = DISP_OPT_VAL
  DISP_RESULT   = DISP_OPT
  ITERATION     = ALL
  GROUP         = __GROUP_NAME__
END_

CONTOURPLOT
  ID_NAME       = SHAPE_CTRL_XXX
  TYPE_PROPERTY = NODAL_CONTINUOUS
  TITLE         = "Controller Input on  deformed model"
  DESCRIPTION   = "Tosca Structure.shape Morphing Result.  ..."
  FRINGE_RESULT = CTRL_INPUT(OPT.)eqv.
  DISP_RESULT   = DISP_OPT
  ITERATION     = ALL
  GROUP         = __GROUP_NAME__
END_

REPORT
  ID_NAME     =  JOBNAME_report_XXX
  CONTOURPLOT = SHAPE_CTRL_XXX
  CONTOURPLOT = SHAPE_DISP_XXX
END_

Sensitivity Plots

To access sensitivity information, you can write them to an ONF file that is then evaluated in a sensitivity plot. Using the following command it is possible to create all sensitivity plots and add them to your report file:


REPORT
  ID_NAME          = sens_plots
  SENSITIVITY_PLOT = YES
END_

The USER_FILE command writing the sensitivity data to ONF format must be in the original parameter file, because SIMULIA Tosca Structure Control must know all OBJ_FUNCs and CONSTRAINTs. For generating the ONF Data with the sensitivities inside, the following statement must be placed in the parameter file:

Sensitivity Plots for Bead Optimization

The sensitivities are written to an ONF file with the following command:


USER_FILE
  ID_NAME     = UF_BEAD_ONF_SENS
  FORMAT      = ONF
  EL_GROUP    = ALL_ELEMENTS
  TYPE        = BEAD_DATA_SENS
  FILE_NAME   = BEAD_SENS
  WRITE       = EVER
  FILE_OPTION = VAR2
END_

Instead of writing the command the corresponding macro can be included:


INCLUDE, uf_bead_sens_onf.mac

Sensitivity Plots for Topology Optimization

The sensitivities can be written in original form:


USER_FILE
  ID_NAME     = UF_TOPO_ONF_SENS
  FORMAT      = ONF
  EL_GROUP    = ALL_ELEMENTS
  TYPE        = TOPO_WITH_SENS
  FILE_NAME   = TP_SENS
  WRITE       = EVER
  FILE_OPTION = VAR2
END_

Instead of writing the command the corresponding macro can be included:

INCLUDE, uf_topo_sens_onf.mac