Difference between revisions of "Path Command"

From OSUPDOCS
Jump to navigation Jump to search
(Created page with "==== Paths ==== Following the <tt><Keypoints></tt>, there are a series of <tt><Path></tt> commands that link the key points into lines or arcs and define mesh inf...")
 
Line 1: Line 1:
<p>The <code>Path</code> command is used in FEA analysis to define paths that are connected to mesh <a href="area.html">areas</a>. It has two forms. The first form is to define a new path:</p>
<pre>Path #1,#2,&lt;#3&gt;
  Keypoint "start",0,5
  Keypoint "middle",5,10
  Keypoint "end"
EndPath
</pre>
<p>where</p>
<ul>
<li>#1 is the name or <code>id</code> to give to the new path. The <code>id</code> must be unique among all other paths.</li>
<li>#2 is the number of intervals along the path. When the path is used to mesh an <a href="area.html">area</a>, it is the number of elements along that path.</li>
<li>#3 defines the ratio of the first element size to the last element size and can be used to define unequal element sizes. Alternatively, #3 can be negative to specify the absolute size of the first element (in mm) to be |#3|. If not specified, the default value is 1 which gives equally sized elements.
</li>
</ul>
<p>Within the <code>Path</code> block, there are a series of <a href="keypoint.html">Keypoint commands</a> that define new keypoints (<i>e.g.</i> key point &quot;start&quot;) or refer to previously define key points (<i>e.g.</i> key point &quot;end&quot; without specified coordinates). The keypoints are connected to define the path. Consecutive defined keypoints can be selected with multiple <a href="keypoint.html">Keypoint</a> commands or with single <a href="keypoints.html">Keypoints</a>  commands. </p>
<p>A path can be used in more than one <a href="area.html">area</a>. The first time it is used it is defined as above. For all subsequent uses, however, it is reused by giving just the <code>id</code>. Thus, the second form of the <code>Path</code> command is to refer to a previous path:</p>
<pre>Path #1
</pre>
<p>where there is no matching <a href="endpath.html">EndPath</a> command and </p>
<ul>
<li>#1 is the name or <code>id</code> of a previously defined path.</li>
</ul>
<p>To include consecutive defined paths in an <a href="area.html">area</a>, you can use multiple <code>Path</code> commands or a single <a href="paths.html">Paths</a> command.</p>
<h2>Notes</h2>
<ol>
<li>A <code>Path</code> command to define a path can appear by itself or within an <a href="area.html">Area command</a> block. A <code>Path</code> command that refers to an existing path is only allowed within a <a href="area.html">Area command</a> block.</li>
<li>Currently the path definition can only have two or three key points. Two key points define a line and three key points can define an arc.
</li>
<li>To programmatically access path properties, you can use <a href="expression.html#atexpr">an &quot;at&quot; expression</a> <code>@path.ID.prop</code> where &quot;ID&quot; is the defined path name or <code>id</code> and the possible properties for <code>prop</code> are:
<ul>
<li><code>intervals</code> - number of intervals along the path</li>
<li><code>ratio</code> - ratio of first to last element size</li>
<li><code>first</code> - name or <code>id</code> of the first <a href="keypoint.html">keypoint</a></li>
<li><code>middle</code> - name or <code>id</code> of the middle <a href="keypoint.html">keypoint</a> (or empty string is the path does not have a middle keypoint).</li>
<li><code>last</code> - name or <code>id</code> of the last <a href="keypoint.html">keypoint</a></li>
</ul>
<li>The <code>Path</code> command is only allowed for <a href="analysis.html">FEA analyses.</a></li>
==== Paths ====
==== Paths ====



Revision as of 11:51, 30 August 2013

The Path command is used in FEA analysis to define paths that are connected to mesh <a href="area.html">areas</a>. It has two forms. The first form is to define a new path:

Path #1,#2,<#3>
  Keypoint "start",0,5
  Keypoint "middle",5,10
  Keypoint "end"
EndPath

where

  • #1 is the name or id to give to the new path. The id must be unique among all other paths.
  • #2 is the number of intervals along the path. When the path is used to mesh an <a href="area.html">area</a>, it is the number of elements along that path.
  • #3 defines the ratio of the first element size to the last element size and can be used to define unequal element sizes. Alternatively, #3 can be negative to specify the absolute size of the first element (in mm) to be |#3|. If not specified, the default value is 1 which gives equally sized elements.

Within the Path block, there are a series of <a href="keypoint.html">Keypoint commands</a> that define new keypoints (e.g. key point "start") or refer to previously define key points (e.g. key point "end" without specified coordinates). The keypoints are connected to define the path. Consecutive defined keypoints can be selected with multiple <a href="keypoint.html">Keypoint</a> commands or with single <a href="keypoints.html">Keypoints</a> commands.

A path can be used in more than one <a href="area.html">area</a>. The first time it is used it is defined as above. For all subsequent uses, however, it is reused by giving just the id. Thus, the second form of the Path command is to refer to a previous path:


Path #1

where there is no matching <a href="endpath.html">EndPath</a> command and

  • #1 is the name or id of a previously defined path.

To include consecutive defined paths in an <a href="area.html">area</a>, you can use multiple Path commands or a single <a href="paths.html">Paths</a> command.

Notes

  1. A Path command to define a path can appear by itself or within an <a href="area.html">Area command</a> block. A Path command that refers to an existing path is only allowed within a <a href="area.html">Area command</a> block.
  2. Currently the path definition can only have two or three key points. Two key points define a line and three key points can define an arc.
  3. To programmatically access path properties, you can use <a href="expression.html#atexpr">an "at" expression</a> @path.ID.prop where "ID" is the defined path name or id and the possible properties for prop are:
    • intervals - number of intervals along the path
    • ratio - ratio of first to last element size
    • first - name or id of the first <a href="keypoint.html">keypoint</a>
    • middle - name or id of the middle <a href="keypoint.html">keypoint</a> (or empty string is the path does not have a middle keypoint).
    • last - name or id of the last <a href="keypoint.html">keypoint</a>
  4. The Path command is only allowed for <a href="analysis.html">FEA analyses.</a>
  5. Paths

    Following the <Keypoints>, there are a series of <Path> commands that link the key points into lines or arcs and define mesh information along those paths. Subordinate to each <Path> command are a series of <keypt> commands that list the key points that define the path. Use two key points to define a line or three key points to define an arc. Currently the path can only have two or three key points. The key points are selected by their id. The attributes for a <Path> command are:

    • id: An id for the path. The id's can be text or numbers and must be unique among all paths.
    • intervals: Number of elements along this path when it is meshed into an area.
    • ratio: Ratio of the size of the first element along the path to the last one. If ratio<0, then the absolute size of the first element on the path with be |ratio|. The default is 1.0 which gives equally sized elements.