<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns:mml = "http://www.w3.org/1998/Math/MathML" lang = "en"><head><meta charset = "UTF-8"/><meta name = "copyright" content = "(C) Copyright 2020"/><meta name = "DC.rights.owner" content = "(C) Copyright 2020"/><meta name = "DC.type" content = "concept"/><meta name = "abstract" content = "After the definition of the optimization task, all definitions should be checked for completeness and correctness. This can be done using a TEST_SHAPE run, which performs a &#34;virtual optimization&#34; with fictitious displacements."/><meta name = "description" content = "After the definition of the optimization task, all definitions should be checked for completeness and correctness. This can be done using a TEST_SHAPE run, which performs a &#34;virtual optimization&#34; with fictitious displacements."/><meta name = "DC.relation" scheme = "URI" content = "../TsoCmdMap/tso-r-cmd-meshSmooth.htm#tso-r-cmd-meshSmooth"/><meta name = "DC.relation" scheme = "URI" content = "../TsoCmdMap/tso-r-cmd-testShape.htm#tso-r-cmd-testShape"/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-c-usr-shape-testShape"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Check run (TEST_SHAPE)</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-c-usr-shape-testShape">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Check run (TEST_SHAPE)</h1></td></tr><tr><td class = "DocHeader4" colspan = "2"/></tr><tr><td class = "DocHeader3"><table class = "DocHeaderIntro" id = "table12"><tr><td class = "Intro1Only"><p class = "header"><p class = "abstract">
<span class = "shortdesc">After the definition of the optimization task, all definitions should be checked for
      completeness and correctness. This can be done using a <code class = "ph codeph">TEST_SHAPE</code> run, which
      performs a "virtual optimization" with fictitious displacements.</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-general" id = "toc_rg" title = "">General</a></li><li><a href = "#tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-gui" id = "toc_rg" title = ""> Test Run in <span class = "ph">Tosca Structure.gui</span></a></li><li><a href = "#tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-cmd" id = "toc_rg" title = ""> Command Syntax</a></li><li><a href = "#tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-spec" id = "toc_rg" title = "">Specifications</a></li><li><a href = "#tso-c-usr-shape-testShape__" id = "toc_rg" title = "">Example</a></li></ul>
</p></td></tr></table></td><td class = "DocHeader2"><table class = "DocTopicsSeeAlso" id = "table13"><tr><td class = "TopicsTitle">See Also</td></tr></table><table class = "DocTopicsInOtherGuides" id = "table14"><tr><td height = "8px"/></tr><tr><td class = "TopicsTitleNormal">In Other Guides</td></tr><tr><td><a title = "Definition of parameters for the mesh smoothing algorithm for shape optimization." href = "../TsoCmdMap/tso-r-cmd-meshSmooth.htm#tso-r-cmd-meshSmooth">MESH_SMOOTH</a></td></tr><tr><td><a title = "Defines a test displacement for shape optimization." href = "../TsoCmdMap/tso-r-cmd-testShape.htm#tso-r-cmd-testShape">TEST_SHAPE</a></td></tr></table></td></tr></table>




<div class = "body conbody">
<div class = "section" id = "tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-general"><h2 class = "title sectiontitle">General</h2>

<p>Before beginning an optimization, it is advisable to check the output file
          (<code class = "ph codeph">TOSCA.OUT</code>) of the optimization preprocessors for any possible warnings
        or errors. If the optimization preprocessing has been performed without error, the user has
        the option of carrying out a test run for the shape optimization without a prior FE
        analysis. This is done by applying pseudo "optimization displacements." This option enables
        you to quickly and easily check if the mesh smoothing and the restrictions are fully defined
        and will deliver the desired results. The above procedure is especially recommended for link
        conditions. The following are typical questions that such a test run can answer: </p>
<ul class = "ul" id = "tso-c-usr-shape-testShape__ul_C76C1FC339A84907A0718F507637D81B">
<li class = "li">Is the design area (i.e., the design nodes) selected
          correctly?</li>
<li class = "li">Is the <code class = "ph codeph">MESH_SMOOTH</code> area too small or too large?</li>
<li class = "li">Is the selected transition area between the design area and the border
of the <code class = "ph codeph">MESH_SMOOTH</code> area in order?</li>
<li class = "li">Will all restrictions be fulfilled (displacement directions,
amount of displacement, contact against solids or elements, link conditions)?
</li>
<li class = "li">Will any nodes be moved by <code class = "ph codeph">MESH_SMOOTH</code> although
they should not be modified, so that additional restriction of these
nodes is needed? </li>
</ul>
<p>The results of the test run are sent to user-defined files that can be
subsequently loaded into a suitable post-processor for evaluation. This
allows the test results to be easily displayed and checked. If the results
of the test run are not satisfying, the optimization model might need to
be modified. The effort required to perform a test run in the optimization
preprocessor is much less than the effort required for a complete optimization.
Unwanted side effects can make a ‘costly’ and time-consuming optimization
useless although the side effects might have been recognized without
much effort in a test run.</p>
</div>


<div class = "section" id = "tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-gui"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle"> Test Run in <span class = "ph">Tosca Structure.gui</span></h2>
<ol class = "ol"><li class = "li">To define your test displacements in <span class = "ph">Tosca Structure.gui</span>, choose <span class = "ph menucascade"><span class = "ph uicontrol">Command</span><abbr title = "and then"> &gt; </abbr><span class = "ph uicontrol">TEST_SHAPE</span></span> the command mask.</li><li class = "li">To start the test run, start <span class = "ph">Tosca Structure</span>
with <span class = "ph uicontrol">Type = test1</span>.</li><li class = "li">Create your visualization sequence
using <span class = "ph">Tosca Structure.report</span>.</li></ol>

<table class = "table" id = "tso-c-usr-shape-testShape__ae253670"><caption/><colgroup><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry"><br/><img class = "image" id = "tso-c-usr-shape-testShape__image_B03916A3C72E456ABC360DAAC35571CC" src = "../TsoUserImages/shape_TEST_SHAPE_gui.png" width = "450"/><br/></td>
</tr>
</tbody></table>

</div>

<div class = "section" id = "tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-cmd"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle"> Command Syntax</h2>

<p>The test run in the shape optimization is controlled by the <code class = "ph codeph">TEST_SHAPE</code>
command. A test run is always based on a previously defined optimization
job that is referenced in the <code class = "ph codeph">OPTIMIZE</code> command. The
format information for the post-processing is specified with the <code class = "ph codeph">FORMAT</code>
parameter. The name of the file into which the post-processing data is
written is specified with the <code class = "ph codeph">FILE_NAME</code> parameter. The
test displacement in a specified direction (<code class = "ph codeph">DIRECTION</code>)
is applied in a specified number of increments (<code class = "ph codeph">INCREMENT</code>
parameter) until reaching a maximum displacement (<code class = "ph codeph">DISPLACEMENT</code>
parameter).</p><p>A typical <code class = "ph codeph">TEST_SHAPE</code> command appears as
follows:</p>
<pre class = "codeblock">
<code class = "ph codeph">
TEST_SHAPE
 OPTIMIZE     = &lt;name_of_optimize&gt;
 FORMAT       = ONF 
 FILE_NAME    = &lt;name_of_output_file&gt;
 DIRECTION    = [ GROW | SHRINK | RANDOM ] 
 DISPLACEMENT = &lt;value_of_max_displacement&gt;
 INCREMENT    = &lt;number_of_increments&gt;
END_
</code>
</pre>

<ul class = "ul" id = "tso-c-usr-shape-testShape__ul_E35ADA96078C4385A6A4B833E852B318">
<li class = "li">If all the information entered by the user is correct, the <code class = "ph codeph">TEST_SHAPE</code>
command is executed immediately after it is entered. The command does
not have its own name with which it can be referenced and all command
data are only temporarily active during the execution of the command.</li>
<li class = "li">The referencing of a previously defined optimization task (<code class = "ph codeph">OPTIMIZE</code>
command) is mandatory. The test displacements are applied to the design
nodes of the optimization job.</li>

</ul>


</div>

<div class = "section" id = "tso-c-usr-shape-testShape__tso-c-usr-shape-testShape-spec"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Specifications</h2><ul class = "ul">


<li class = "li">Specification of a file name (<code class = "ph codeph">FILE_NAME</code> parameter)
is optional. By default, the file name <code class = "ph codeph">TEST_SHAPE</code> is
used. An increment number is always attached to the file names (for example,
000, 001, 002 etc.) to enable identification of the results from the
various increments. <div class = "note"><span class = "run-in.note">Note:
			</span><span class = "notecontent">The automatic creation of the <code class = "ph codeph">vtfx</code>
report requires the use of the default file name <code class = "ph codeph">TEST_SHAPE</code>.</span></div>
</li>
<li class = "li">Specification of a displacement direction (<code class = "ph codeph">DIRECTION</code> parameter) is optional.
          The default setting is <code class = "ph codeph">GROW</code>. Three possibilities can be selected in
          specifying the displacement direction: uniform growth of all design nodes in the
          optimization group outwards (<code class = "ph codeph">DIRECTION=GROW</code>), uniform shrinkage of all
          design nodes in the optimization group inwards (<code class = "ph codeph">DIRECTION=SHRINK</code>) or
          nonuniform "randomly controlled" displacement of the design nodes in the optimization
          group (<code class = "ph codeph">DIRECTION=RANDOM</code>).</li>
<li class = "li">Because uniform displacements are applied with <code class = "ph codeph">DIRECTION=GROW</code> or SHRINK,
            <code class = "ph codeph">LINK_SHAPE</code> conditions might be insufficiently tested because
            <code class = "ph codeph">LINK_SHAPE</code> conditions (conditional on the uniform displacements) might be
          fulfilled a priori. If the optimization job contains <code class = "ph codeph">LINK_SHAPE</code>
          conditions, it is recommended that you apply nonuniform displacements using
            <code class = "ph codeph">DIRECTION=RANDOM</code>. This will allow the correct operation of the
            <code class = "ph codeph">LINK_SHAPE</code> conditions to be tested.</li>
<li class = "li">Specification of the maximum amount of displacement (<code class = "ph codeph">DISPLACEMENT</code> parameter) is
          optional. If no maximum amount of displacement is specified by the user, then a maximum
          amount of displacement dependent on the measurements of the FE mesh will be automatically
          determined.</li>
<li class = "li">Specification of a number of increments (<code class = "ph codeph">INCREMENT</code> parameter) is optional. The
          default value is <code class = "ph codeph">INCREMENT=1</code>. If you specify five increments, for
          example, six results files are generated, where the first result file with the file
          extension "000" represents the initial state.</li>
<li class = "li">If <code class = "ph codeph">DIRECTION=RANDOM</code> is selected, it is possible that the design node with the
          maximum displacement will have a smaller amount of displacement than is specified in the
            <code class = "ph codeph">DISPLACEMENT</code> parameter. Here, the maximum specified displacement only
          represents an upper limit that does not need to be achieved due to the "randomly
          controlled" distribution of the displacements.</li>
</ul></div>
<div class = "example"><p><map name = "FPMap1"><area href = "#hj-top" title = "Back to Top" shape = "rect" coords = "416, 0, 435, 10"/></map><span class = "itemsprite"/></p><h2 class = "title sectiontitle">Example</h2><p>The optimization task named <code class = "ph codeph">shape_optimization</code> should be subjected to a test
        run. The file names are to have the name <code class = "ph codeph">test_grow</code>. In the growth direction,
        five displacement increments should be applied with a maximum displacement of 1.5 length
        units (i.e., the displacements are applied in increments of 0.0, 0.3, 0.6, 0.9, 1.2, and
        1.5).</p>
<pre class = "codeblock">
<code class = "ph codeph">
TEST_SHAPE
 OPTIMIZE     = shape_optimization
 FILE_NAME    = test_grow
 DIRECTION    = GROW 
 DISPLACEMENT = 1.5
 INCREMENT    = 5
END_
</code>
</pre>
</div>
</div>

<div class = "related-links"/></td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
