<?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 = "reference"/><meta name = "abstract" content = "Definition of morphing tasks for creation of model variants. In this commands different predefined morphing areas are connected to an experiment plan defining the changes for the morphing areas."/><meta name = "description" content = "Definition of morphing tasks for creation of model variants. In this commands different predefined morphing areas are connected to an experiment plan defining the changes for the morphing areas."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-r-cmd-morph"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>MORPH</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-r-cmd-morph">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>MORPH</h1></td></tr><tr><td class = "DocHeader4" colspan = "2"/></tr><tr><td class = "DocHeader3" colspan = "2"><table class = "DocThemeIntro" id = "table12"><tr><td class = "Intro1Only"><p class = "header"><p class = "abstract">
<span class = "shortdesc">Definition of morphing tasks for creation of model variants. In this commands different predefined morphing areas are connected to an experiment plan defining the changes for the morphing areas. </span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-r-cmd-morph__tso-r-cmd-morph-rmk" id = "toc_rg" title = "">Remarks</a></li><li><a href = "#tso-r-cmd-morph__tso-r-cmd-morph-expl" id = "toc_rg" title = "">Examples</a></li></ul>
</p></td></tr></table></td></tr></table>




<div class = "body refbody">
<table class = "table" id = "tso-r-cmd-morph__aa1870922"><caption/><colgroup><col/><col/><col/></colgroup><tbody class = "tbody">
  <tr class = "row">
  <td class = "entry"><p><span class = "ph uicontrol">ID_NAME</span></p></td>
  <td class = "entry"><p>= &lt;<code class = "ph codeph">id_name_of_morph</code>&gt;</p></td>
  <td class = "entry"><p>Name of the morphing definition.</p></td>
  </tr>
  <tr class = "row">
  <td class = "entry"><p><span class = "ph uicontrol">OPTIMIZE</span></p></td>
  <td class = "entry"><p>= &lt;<code class = "ph codeph">optimization_name</code>&gt;</p></td>
  <td class = "entry"><p>Corresponding optimization task.</p></td>
  </tr>
  <tr class = "row">
  <td class = "entry"><p>MORPH_AREA</p></td>
  <td class = "entry"><p>= &lt;<var class = "keyword varname varname">name_of_morph_area</var>&gt;</p></td>
  <td class = "entry"><p>Morphing area.</p></td>
  </tr>
  <tr class = "row">
  <td class = "entry"><p>MORPH_PARAM_FILE</p></td>
  <td class = "entry"><p>= &lt;<var class = "keyword varname varname">morph_csv_file_name</var>&gt;</p></td>
  <td class = "entry"><p>Morphing parameter file containing the model changes for each variant.</p></td>
  </tr>
  <tr class = "row">
  <td class = "entry"><p>NUMBER_OF_PARALLEL_JOBS</p></td>
  <td class = "entry"><p>= &lt;<code class = "ph codeph">number_of_parallel_jobs</code>&gt;</p><p><span class = "ph uicontrol">= 1</span></p></td>
  <td class = "entry"><p>Optional parameter for parallelization (number of jobs run in parallel); If omitted or =1 a sequential run will be executed.</p></td>
  </tr>
  <tr class = "row">
  <td class = "entry"><p>SMOOTHING</p></td>
  <td class = "entry"><p>= YES </p><p><span class = "ph uicontrol">= NO</span></p></td>
  <td class = "entry"><p>Optional parameter to switch on/off surface smoothing of the nodes in the moved morphing areas.</p></td>
  </tr>
  
  <tr class = "row">
    <td class = "entry"><p>MAIN</p></td>
    <td class = "entry">
      <p>
        = <span class = "ph uicontrol">AUTO</span> | MIN | MAX | MINABS | MAXABS | SUM | CSV
      </p>      
    </td>
    <td class = "entry">
      <p>
        The main criteria is a great help to gain control about the order in which the morph areas are processed. 
        This is especially import if you work with overlapping morph areas.
        <ul class = "ul" id = "tso-r-cmd-morph__ul_B6D6572A0C904D13BB62B7002B41D70F">
          <li class = "li">
            <span class = "ph uicontrol">AUTO</span>:
            (Default, same behavior as in previous versions) Order as specified as in the csv file, but morph areas with zero displacement are processed last and thus being most important.
          </li>
          <li class = "li">
            MIN: Morph areas with the smallest displacement specified in the csv file are processed last.
          </li>
          <li class = "li">
			  MINABS: Morph areas with the smallest absolute displacement (for example, 0) are processed last.
		  </li>
          <li class = "li">
            MAX: Morph areas with the greatest displacement are processed last.
          </li>
          <li class = "li">
            MAXABS: Morph areas with the greatest absolute displacement are processed last.
          </li>
          <li class = "li">
            SUM: If nodes are referenced in multiple morph areas, the displacements are summed up.
          </li>
          <li class = "li">
            CSV: Order exactly as specified as in the csv file.
          </li>
        </ul>
      </p>
    </td>
  </tr>
</tbody></table>

<div class = "section" id = "tso-r-cmd-morph__tso-r-cmd-morph-rmk"><h2 class = "title sectiontitle">Remarks</h2>

<ol class = "ol" id = "tso-r-cmd-morph__ol_1E3650F79A9F4F83A3D6A1B20F6BFFFC">
<li class = "li">Morph is not running in parallel on <span class = "ph">Windows</span>. Thus, the <code class = "ph codeph">NUMBER_OF_PARALLEL_JOBS</code> must be set to 1.</li>
<li class = "li">The morphing parameter file is an external file in the same directory as he parameter file. The first line contains the referenced <code class = "ph codeph">MORPH_AREA</code> commands. Each further line refers to one experiment (one model design variant). 
For more details and an example of a morphing parameter file, see <a class = "xref" href = "../TsoUserMap/tso-c-usr-shape-morphing-general.htm#tso-c-usr-shape-morphing-general__tso-c-usr-shape-morphing-displ">Morphing Displacement</a>.</li>
</ol>
</div>

<div class = "section" id = "tso-r-cmd-morph__tso-r-cmd-morph-expl"><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">Examples</h2>

<pre class = "codeblock">
<code class = "ph codeph">MORPH
 ID_NAME = my_morph_job
 OPTIMIZE = my_optimization_job
 MORPH_AREA =<var class = "keyword varname varname"> morph1
</var> MORPH_AREA =<var class = "keyword varname varname"> morph2
</var> MORPH_AREA =<var class = "keyword varname varname"> ...
</var> MORPH_PARAM_FILE =<var class = "keyword varname varname"> morphing_experiment_plan.csv
</var> NUMBER_OF_PARALLEL_JOBS = 6
 SMOOTHING = NO
END_
</code></pre>
</div>

</div>

</td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
