<?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 = "Testing the optimization setup without using simulation results is described."/><meta name = "description" content = "Testing the optimization setup without using simulation results is described."/><meta name = "DC.relation" scheme = "URI" content = "../TsoCmdMap/tso-r-cmd-testBead.htm#tso-r-cmd-testBead"/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-c-usr-beadOpt-beadTestBead"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Testing the Optimization Setup (TEST_BEAD)</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-c-usr-beadOpt-beadTestBead">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Testing the Optimization Setup (TEST_BEAD)</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">Testing the optimization setup without using simulation results
is described.</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-Spec" id = "toc_rg" title = "">Specifications</a></li><li><a href = "#tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-example" id = "toc_rg" title = "">Example</a></li><li><a href = "#tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-gui" id = "toc_rg" title = "">Realization in <span class = "ph">Tosca Structure.gui</span></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 = "Defines a test displacement for bead optimization." href = "../TsoCmdMap/tso-r-cmd-testBead.htm#tso-r-cmd-testBead">TEST_BEAD</a></td></tr></table></td></tr></table>




<div class = "body conbody">
<p>The test run in bead optimization is controlled by the <code class = "ph codeph">TEST_BEAD</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 post-processing is specified with
the parameter <code class = "ph codeph">FORMAT</code>. The name of the file, which the
post-processing data is written into, is specified with the parameter
<code class = "ph codeph">FILE_NAME</code>. The test displacement in a specified direction
(<code class = "ph codeph">DIRECTION</code>) is applied in a number of increments (<code class = "ph codeph">INCREMENT</code>
parameter) defined by the user until reaching a specified maximum displacement
(<code class = "ph codeph">DISPLACEMENT</code> parameter).</p><p>A typical <code class = "ph codeph">TEST_BEAD</code>
command appears as follows:</p>
<pre class = "codeblock">
<code class = "ph codeph">
TEST_BEAD
 OPTIMIZE     = &lt;<span class = "ph">name_of_optimize</span>&gt;
 FORMAT       = ONF
 FILE_NAME    = &lt;name_of_output_file&gt;
 DIRECTION    = GROW 
 DISPLACEMENT = &lt;value_of_max_displacement&gt;
 INCREMENT    = &lt;number_of_increments&gt;
END_
</code></pre>
<p><ul class = "ul"><li class = "li">If all information entered by the user is correct, the
            <code class = "ph codeph">TEST_BEAD</code> command is executed immediately after it is entered. The
          command does not have its own name with which it can be referenced (that is, all command data
          are only temporarily active during the execution of the command).</li>
<li class = "li">Referencing 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></p>
	
<div class = "section" id = "tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-Spec"><h2 class = "title sectiontitle">Specifications</h2>

<ul class = "ul"><li class = "li">Specification of a format (<code class = "ph codeph">FORMAT</code> parameter) is
mandatory. This can either be <code class = "ph codeph">FORMAT=ONF</code> for the <span class = "ph">Tosca Structure</span>
specific optimization neutral format to generate a vtfx sequence.</li>
<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_BEAD</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.</li>
<li class = "li">Specification of a displacement direction
            (<code class = "ph codeph">DIRECTION</code> parameter) is optional. The default setting is
            <span class = "ph uicontrol">GROW</span>. Two possibilities can be selected to specify the
          displacement direction: uniform growth of all design nodes in the optimization group
          outwards (<code class = "ph codeph">DIRECTION=GROW</code>) or nonuniform ‘randomly controlled’
          displacement of the design nodes in the optimization group
            (<code class = "ph codeph">DIRECTION=RANDOM</code>). For the sensitivity-based algorithm,
            <code class = "ph codeph">DIRECTION=SHRINK</code> does also make sense.</li>
<li class = "li">Specification of the maximum absolute displacement
            (<code class = "ph codeph">DISPLACEMENT</code> parameter) is optional. If no maximum absolute
          displacement is specified by the user, a maximum absolute displacement depending on
          the FE mesh will automatically be 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=</code><span class = "ph uicontrol">1</span>.
If the user specifies 5 increments, for example, 6 results files are
generated, where the first result file has the file extension ‘000’
and 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
absolute displacement than 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 = "section" id = "tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-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">bead_optimization</code> should be subjected to a test run.
        Optimization neutral file format is the selected output format. The file names 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 (that is, 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_BEAD
 OPTIMIZE =<span class = "ph"> bead_optimization </span>
  
 FORMAT       = ONF
 FILE_NAME    = test_grow
 DIRECTION    = GROW 
 DISPLACEMENT = 1.5
 INCREMENT    = 5
END_
</code>
</pre>
</div>


<div class = "section" id = "tso-c-usr-beadOpt-beadTestBead__tso-c-usr-beadTestBead-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">Realization in <span class = "ph">Tosca Structure.gui</span></h2>

<ol class = "ol"><li class = "li">As <span class = "ph uicontrol">Module</span>, select Start <span class = "ph">Tosca Structure</span>.
</li><li class = "li">As <span class = "ph uicontrol">Type</span>, choose <span class = "ph uicontrol">test1</span> and click <span class = "ph uicontrol">Start Tosca</span>.</li></ol>
<table class = "table" id = "tso-c-usr-beadOpt-beadTestBead__aa212495"><caption/><colgroup><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry"><br/><img class = "image" id = "tso-c-usr-beadOpt-beadTestBead__image_F3C4D75156064E528A4D4F958F18243D" src = "../TsoUserImages/bead_gui_test_bead.png" width = "350"/><br/></td>
</tr>
</tbody></table>

</div>

</div>

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