<?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 = "Automatic definition of node groups."/><meta name = "description" content = "Automatic definition of node groups."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "tso-r-cmd-groupAutoDef"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>GROUP_AUTO_DEF</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "tso-r-cmd-groupAutoDef">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>GROUP_AUTO_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">Automatic definition of node groups.</span>

</p>
<p>This page discusses: </p><ul><li><a href = "#tso-r-cmd-groupAutoDef__tso-r-cmd-groupAutoDef-rmk" id = "toc_rg" title = "">Remarks</a></li><li><a href = "#tso-r-cmd-groupAutoDef__tso-r-cmd-groupAutoDef-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-groupAutoDef__aa1395752"><caption/><colgroup><col/><col/><col/></colgroup><tbody class = "tbody">
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">ND_GROUP</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;name_of_node_group&gt;</code></p></td>
<td class = "entry"><p>Name of the parent node group.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">CS</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;name_of_coord_system&gt;</code></p></td>
<td class = "entry"><p>Name of the coordinate system.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">TOL</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;tol_1&gt;</code>, <code class = "ph codeph">&lt;tol_2&gt;</code>, <code class = "ph codeph">&lt;tol_3&gt;</code></p></td>
<td class = "entry"><p>Tolerance values in the coordinate directions of the referenced coordinate system.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">SEARCH _TYPE</span></p></td>
<td class = "entry"/>
<td class = "entry"><p>Search criterion.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= <code class = "ph codeph">CONTINUOUS</code></p></td>
<td class = "entry"><p>Continuous search.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= <code class = "ph codeph">DISCRETE</code></p></td>
<td class = "entry"><p>Discrete search.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= <code class = "ph codeph">CS_MULTI</code></p></td>
<td class = "entry"><p>Search for nodes with the same coordinate values in the specified coordinate systems.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">SEARCH_DIR</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;cs_dir&gt;</code></p></td>
<td class = "entry"><p>Search direction.</p></td>
</tr>
<tr class = "row">
<td class = "entry"/>
<td class = "entry"><p>= +1</p><p>= -1</p><p>= +2</p><p>= -2</p><p>= +3</p><p>= -3</p></td>
<td class = "entry"><p>positive (+) or negative (-) direction of 1st, 2nd or 3rd axis of coordinate system <code class = "ph codeph">CS</code>.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">SEARCH_LEN</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;value&gt;</code></p></td>
<td class = "entry"><p>Search length.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">DISCRETE_LEN</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;value&gt;</code></p></td>
<td class = "entry"><p>Discrete length.</p></td>
</tr>
<tr class = "row">
<td class = "entry"><p><span class = "ph uicontrol">SEARCH_CS</span></p></td>
<td class = "entry"><p>= <code class = "ph codeph">&lt;name_of_search_cs&gt;</code></p></td>
<td class = "entry"><p>Name of the search coordinate system.</p></td>
</tr>
</tbody></table>

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

<ol class = "ol" id = "tso-r-cmd-groupAutoDef__ol_0964EEA997324782BC5754DEF4A434F8">
<li class = "li">The command is applied only to nodes that have been selected. The child node group only contains the necessary parent nodes for the case the parent nodes are also selected.</li>
<li class = "li">The command <code class = "ph codeph">GROUP_AUTO_DEF</code> does not have its own <code class = "ph codeph">ID_NAME</code>.</li>
<li class = "li"><code class = "ph codeph">ND_GROUP</code> is compulsory. The name of the parent node group with an attached  '_' plus a numbered index is used for all child node groups. Should the name end with the symbol '_', no other symbol '_' is attached.</li>
<li class = "li"><code class = "ph codeph">CS</code> is compulsory.</li>
<li class = "li"><code class = "ph codeph">TOL</code> is compulsory. The tolerance values must be positive. At least one of the three tolerance values must be accepted. For tolerance values not accepted, the smallest of the given tolerance values is acceptable. The three tolerance values are coordinate values that refer to the three coordinate directions of the <code class = "ph codeph">CS</code>. In a Cartesian coordinate system all three values have the longitudes <code class = "ph codeph">&lt;tol_*&gt;</code>. In a cylindrical coordinate system <code class = "ph codeph">&lt;tol_1&gt;</code> and <code class = "ph codeph">&lt;tol_3&gt;</code> are longitudes and <code class = "ph codeph">&lt;tol_2&gt;</code> is an angle measured in degrees. In a spherical coordinate system <code class = "ph codeph">&lt;tol_1&gt;</code> is a longitude and <code class = "ph codeph">&lt;tol_2&gt;</code> and <code class = "ph codeph">&lt;tol_3&gt;</code> are angles measured in degrees. Tolerance values should be big enough to include the individual nodes and small enough not to include the neighboring nodes not wanted.</li>
<li class = "li"><code class = "ph codeph">SEARCH_TYPE</code> is compulsory. The relevant criteria is that of Version 3.0.</li>
<li class = "li"><code class = "ph codeph">SEARCH_DIR</code> is compulsory for the command <code class = "ph codeph">SEARCH_TYPE=CONTINUOUS</code> and <code class = "ph codeph">SEARCH_TYPE=DISCRETE</code>. For <code class = "ph codeph">SEARCH_TYPE=CS_MULTI</code>, the command <code class = "ph codeph">SEARCH_DIR</code> is not necessary. The direction of search refers to the relevant coordinate direction of the <code class = "ph codeph">CS</code>. A positive (negative) symbol means a search in a positive (negative) coordinate direction.</li>
<li class = "li"><code class = "ph codeph">SEARCH_LEN</code> is compulsory for the command <code class = "ph codeph">SEARCH_TYPE=CONTINUOUS</code> and <code class = "ph codeph">SEARCH_TYPE=DISCRETE</code>. For <code class = "ph codeph">SEARCH_TYPE=CS_MULTI</code>, the command <code class = "ph codeph">SEARCH_LEN</code> is not necessary. The length of the search is a general length and can also be an angle measured in degrees in the case of a cylindrical or spherical coordinate system. The length of the search must also be positive. It is recommended to choose a larger search length as the relevant tolerance.</li>
<li class = "li"><code class = "ph codeph">DISCRETE_LEN</code> is compulsory for the command <code class = "ph codeph">SEARCH_TYPE=DISCRETE</code>. For <code class = "ph codeph">SEARCH_TYPE=CONTINUOUS</code> and <code class = "ph codeph">SEARCH_TYPE=CS_MULTI</code>, the command <code class = "ph codeph">DISCRETE_LEN</code> is not necessary. The discrete length is a general length and can also be an angle measured in degrees in the case of a cylindrical or spherical coordinate system. The discrete length must be positive. It is recommended that the discrete length is smaller than the search length and larger than the relevant tolerance.</li>
<li class = "li"><code class = "ph codeph">SEARCH_CS</code> is compulsory for the command <code class = "ph codeph">SEARCH_TYPE=CS_MULTI</code>. For<code class = "ph codeph"> SEARCH_TYPE=CONTINUOUS</code> and <code class = "ph codeph">SEARCH_TYPE=DISCRETE</code>, the command <code class = "ph codeph">SEARCH_CS</code> is not necessary. A total of up to 32 separate <code class = "ph codeph">SEARCH_CS</code> entries can be accepted. The second to the 32th entry is optional. It is recommended that all coordinate systems <code class = "ph codeph">CS</code> and <code class = "ph codeph">SEARCH_CS</code> are the same type, that is either Cartesian, cylindrical, or spherical.</li>
<li class = "li"><span class = "ph uicontrol">Note:</span> Using the command <code class = "ph codeph">DVCON_AUTO_SHAPE</code>, <code class = "ph codeph">DVCON_SHAPE</code> entries for node groups with the same name log can be generated automatically.</li>
</ol>
</div>

<div class = "section" id = "tso-r-cmd-groupAutoDef__tso-r-cmd-groupAutoDef-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_AUTO_DEF
 ND_GROUP     = my_nodes_01
 CS           = cs_1
 TOL          = 0.1, 1.0, 0.1
 SEARCH_TYPE  = CONTINUOUS
 SEARCH_DIR   = +2
 SEARCH_LEN   = 360
 DISCRETE_LEN = 45
END_
</code></pre>
</div>

</div>

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