<?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 = "Manual definition of groups by lists of elements or nodes, materials, or properties or by assigning a previously defined selection."/><meta name = "description" content = "Manual definition of groups by lists of elements or nodes, materials, or properties or by assigning a previously defined selection."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-r-cmd-groupDef"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>GROUP_DEF</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-r-cmd-groupDef">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>GROUP_DEF</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">Manual definition of groups by lists of elements or nodes, materials, or properties or by
      assigning a previously defined selection.</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-r-cmd-groupDef__tso-r-cmd-groupDef-rmk" id = "toc_rg" title = "">Remarks</a></li><li><a href = "#tso-r-cmd-groupDef__tso-r-cmd-groupDef-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-groupDef__aa1570899"><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>= <code class = "ph codeph">&lt;id_name_of_group&gt;</code></p></td>
<td class = "entry"><p>Name of the group.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TYPE</span></p></td>
<td class = "entry">
  <p>= <code class = "ph codeph">ELEM</code></p>
  <p>= <code class = "ph codeph">NODE</code></p>
  
</td>
<td class = "entry">
    <p>Type of the group.
    The entries of the group are element or node identifiers.
    
    </p>
</td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">FORMAT</span></p></td>
<td class = "entry">
  <p>= <code class = "ph codeph">SELECTED</code></p>
  <p>= <code class = "ph codeph">LIST</code></p>
  <p>= <code class = "ph codeph">LIST_MAT</code></p>
  <p>= <code class = "ph codeph">LIST_PROP</code></p>
  <p>= <code class = "ph codeph">LIST_NODE_ALL</code></p>  
  
  <p>= <code class = "ph codeph">LIST_NODE_ANY</code></p>  
  
  <p>= <code class = "ph codeph">LIST_NDGR_ALL</code></p>
  <p>= <code class = "ph codeph">LIST_NDGR_ANY</code></p>
  <p>= <code class = "ph codeph">LIST_GROUP</code></p>
  <p>= <code class = "ph codeph">LIST_SUBTRACT_GROUP</code></p>
  <p>= <code class = "ph codeph">LIST_ELEM</code></p>
  <p>= <code class = "ph codeph">LIST_ELGR</code></p>
  <p>= <code class = "ph codeph">LIST_POINTS</code></p>
  
  
</td>
<td class = "entry">
    <p>Format, through selection or by explicit specification of a list of elements or nodes
    (= <code class = "ph codeph">LIST</code>), a list of materials (= <code class = "ph codeph">LIST_MAT</code>) or a
    list of properties (=<code class = "ph codeph">LIST_PROP</code>) or a list of nodes or node groups
    where all elements that contain all listed nodes (<code class = "ph codeph">*_ALL</code>) or one of
    the listed nodes (<code class = "ph codeph">*_ANY</code>) are added.</p>
    
</td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">LIST_BEGIN</span></p></td>
<td class = "entry"><p>for <code class = "ph codeph">FORMAT = LIST*</code></p></td>
<td class = "entry"><p>Beginning of list entries.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry">
  <p><code class = "ph codeph">&lt;entries of group list&gt; </code></p>
  <p>...</p>
</td>
<td class = "entry"><p>List entries.</p></td>
</tr>
</tbody></table>

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

<ol class = "ol">
<li class = "li"><code class = "ph codeph">FORMAT = SELECTED</code>: This group contains all elements (in <code class = "ph codeph">TYPE=ELEM</code>) and nodes (in <code class = "ph codeph">TYPE=NODE</code>) that are selected with the command <code class = "ph codeph">SELECT</code>.</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST</code>:
    This group contains all elements (in <code class = "ph codeph">TYPE=ELEM</code>)
    or nodes (in <code class = "ph codeph">TYPE=NODE</code>)
    which are listed following the parameter <code class = "ph codeph">LIST_BEGIN</code>.
    
</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_MAT</code>: This list contains materials for the selection of elements. </li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_PROP</code>: This list contains properties for the selection of elements. </li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_NODE_ALL</code>: This list contains nodes for the selection of elements.
          All elements that contain only nodes from this list are added to the group. </li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_NODE_ANY</code>: This list contains nodes for the selection of elements.
          All elements that contain at least one node from this list are added to the group.</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_GROUP</code>: This list contains multiple existing groups (nodes or elements) and creates a new group containing the content of all the previous groups.</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_SUBTRACT_GROUP</code>: This list contains the nodes or elements of the first group minus the content of the later groups.</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_NDGR_ALL</code>
  : This list contains node groups for the selection of
        elements. All elements that contain all nodes from the listed node groups are added to the group. </li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_NDGR_ANY</code>
  : This list contains node groups for the selection of
        elements. All elements that contain at least one of the nodes from the listed
        node groups are added to the group. </li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_ELEM</code>: This list contains elements for the selection of nodes.
        All nodes contained by these elements are added to the node group.</li>
<li class = "li"><code class = "ph codeph">FORMAT = LIST_ELGR</code>: This list contains element groups for the selection of nodes.
        All nodes contained by these any elements in these groups are added to the node group.</li>
<li class = "li"><code class = "ph codeph">FORMAT = POINTS</code>: The list contains one point in the global Cartesian coordinate
          system, one each line. For each point, the nearest node to this point will be added to the
          node group.</li>
<li class = "li">Entering <code class = "ph codeph">LIST_BEGIN</code> is required with <code class = "ph codeph">FORMAT = LIST*</code> and must be placed at the end of the command. The list with the numbered areas follows this entry. The standard conventions for commentary lines are applicable. The list is closed with <code class = "ph codeph">END_</code>. The default separate characters for numbered areas are as follows: Thru-Character='-', Increment-Character=':', Separator-Character=','. </li>



</ol>
</div>

<div class = "section" id = "tso-r-cmd-groupDef__tso-r-cmd-groupDef-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">
GROUP_DEF
 ID_NAME = my_elem_group
 TYPE    = ELEM
 FORMAT  = LIST
 LIST_BEGIN
 1,5,10-25, 45-60:5
END_

GROUP_DEF
 ID_NAME = "My Group"
 TYPE    = ELEM
 FORMAT  = LIST_MAT
 LIST_BEGIN
 7
END_
</code>
</pre>
<p>Useful for shape optimization: </p>
<p>Selecting all elements for surface identification:</p>
<pre class = "codeblock">
<code class = "ph codeph">
select,elgr,s,elgr,ALL_ELEMENTS
select,elem,s,elgr
SF_IDENT
</code>
</pre>
<p>Select surface nodes:</p>
<pre class = "codeblock">
<code class = "ph codeph">
select,node,s,ND_SF

GROUP_DEF
 ID_NAME = my_surface_node_group
 TYPE    = NODE
 FORMAT  = SELECTED
END_
</code>
</pre>
<p>For combining groups (GroupD = GroupA + GroupB + GroupC):</p>
<pre class = "codeblock">
<code class = "ph codeph">
GROUP_DEF
 ID_NAME = GroupD
 TYPE    = ELEM
 FORMAT  = LIST_GROUP
 LIST_BEGIN
GroupA, GroupB, GroupC
END_
</code>
</pre>
<p>For subtracting groups (GroupD = GroupA - GroupB - GroupC):</p>
<pre class = "codeblock">
<code class = "ph codeph">
GROUP_DEF
 ID_NAME = GroupD
 TYPE    = ELEM
 FORMAT  = LIST_SUBTRACT_GROUP
  LIST_BEGIN
GroupA, GroupB, GroupC
END_
</code>
</pre>
</div>

</div>

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