<?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 = "In order to restrict the isocut and/or the surface calculation to certain areas of the model, the user might specify the groups of elements that should be used."/><meta name = "description" content = "In order to restrict the isocut and/or the surface calculation to certain areas of the model, the user might specify the groups of elements that should be used."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-c-usr-validation-smooth-groups"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Processing of Groups</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-c-usr-validation-smooth-groups">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Processing of Groups</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">
In order to restrict the isocut and/or the surface calculation to certain
areas of the model, the user might specify the groups of elements that should be used.
</span>

</p>
<ul><li><a href = "#tso-c-usr-validation-smooth-groups__" id = "toc_rg" title = "">Example</a></li></ul>
</p></td></tr></table></td></tr></table>




<div class = "body conbody">
<p>
The groups can be read from the result database (specified by the parameter <code class = "ph codeph">DATABASE</code>) or the onf group file
(specified by the parameter <code class = "ph codeph">GROUP_FILE</code>, deprecated). Then, the available group names and in addition the group <code class = "ph codeph">ALL_ELEMENTS</code> containing
all elements, can be used as values of the following parameters:
</p>
<ul class = "ul">
<li class = "li"><code class = "ph codeph">GROUP_EXCLUDE</code>: the elements of the group are ignored for all operations;</li>
<li class = "li"><code class = "ph codeph">GROUP_INCLUDE</code>: the elements of the group are marked as normal and are used for the (iso)surface calculation;</li>
<li class = "li"><code class = "ph codeph">GROUP_SURFACE</code>: the surface of the elements will be calculated even if they would be deleted or cut otherwise.</li>
</ul>
<p>
Any number of these commands can be specified. If an element belongs to
several groups mentioned in the commands, the last command applies. For
example, in order to restrict the isocut to a single group <code class = "ph codeph">MY_GROUP</code>,
the following parameters should be specified, in the following order:
</p>
<pre class = "codeblock">
<code class = "ph codeph">  GROUP_EXCLUDE = ALL_ELEMENTS</code>
<code class = "ph codeph">  GROUP_INCLUDE = MY_GROUP</code>
</pre>
<p>Group names are case insensitive.</p>
<table class = "Remark" id = "table132"><tr><td class = "Remark"><span class = "run-in.important">Important:
				</span><span class = "notecontent"><p>If used, the <code class = "ph codeph">ONF</code> group file must be compatible with
the model file. In case of adaptive calculations, the <code class = "ph codeph">ONF</code>
group file should be updated using <code class = "ph codeph">fem2onf</code> applied to the <code class = "ph codeph">FEM</code>
file for the required iteration.</p></span></td></tr></table>

<p>
Support of group operations in <span class = "ph">Tosca Structure.gui</span>
is limited. It is only possible to restrict the results to a single target group. All further
group operations must be input manually.
</p>

<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 example shown in the figure below contains two design regions <code class = "ph codeph">DESIGN_ELEM1</code>
and <code class = "ph codeph">DESIGN_ELEM2</code>, the first being the lower part of the model
and the other one the upper part. Using group commands, various results
can be obtained, as shown in the figure.
</p>
<table class = "table" id = "tso-c-usr-validation-smooth-groups__ah703759"><caption/><colgroup><col/><col/><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry"><br/><img class = "image" src = "../TsoUserImages/smooth_group_commands1.png" width = "350"/><br/></td>
<td class = "entry"><p>No group operations, the result contains the complete model.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><br/><img class = "image" src = "../TsoUserImages/smooth_group_commands2.png" width = "350"/><br/></td>
<td class = "entry"><p><code class = "ph codeph">GROUP_EXCLUDE</code> = <code class = "ph codeph">ALL_ELEMENTS</code></p>
                      <p><code class = "ph codeph">GROUP_INCLUDE</code> = <code class = "ph codeph">DESIGN_ELEM2</code></p>
                      <p>The result only contains the upper part of the model.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><br/><img class = "image" src = "../TsoUserImages/smooth_group_commands3.png" width = "350"/><br/></td>
<td class = "entry"><p><code class = "ph codeph">GROUP_EXCLUDE</code> = <code class = "ph codeph">ALL_ELEMENTS</code></p>
                      <p><code class = "ph codeph">GROUP_INCLUDE</code> = <code class = "ph codeph">DESIGN_ELEM1</code></p>
                      <p><code class = "ph codeph">GROUP_SURFACE</code> = <code class = "ph codeph">DESIGN_ELEM2</code></p>
                      <p>The result contains the smoothed lower part and the original surface of the upper part.</p></td>
</tr>
</tbody></table>

<p>
  Groups are also used at another place: Restricting the output to certain nodes.
</p>
  <pre class = "codeblock">
    <code class = "ph codeph">  ND_GROUP = node_group</code>
  </pre>
<p>
  This command removes elements from the smooth output that contain nodes not present in the specified node group.
  This is especially handy for shape optimizations if you would like to get the output only for the design area or the mesh smooth area.
</p></div></div>

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