2D MPM Shape Commands - Revision history

Nairnj: /* Arc Command */

2020-03-13T19:42:17Z

Arc Command

← Older revision		Revision as of 19:42, 13 March 2020
Line 94:		Line 94:

	* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of an oval (or R and Z extents if axisymmetric) that encloses the oval. If xmax<xmin or ymax<ymin, they will be automatically switched to define the oval. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of an oval (or R and Z extents if axisymmetric) that encloses the oval. If xmax<xmin or ymax<ymin, they will be automatically switched to define the oval. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>: The arc will be path traced along border of the oval in the counterclockwise direction from angles specified in <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>, where 0 degrees is the positive x axis direction. These must be entered as 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>.		* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>: The arc will be path traced along border of the oval in the counterclockwise direction from angles specified in <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>, where 0 degrees is the positive x axis direction. These must be entered as 0≤<tt>(arcStart)</tt><360 and <tt>(arcStart)</tt><<tt>(arcEnd)</tt><<tt>(arcStart)</tt>+360.
	* <tt>(tolerance)</tt>: The arc region will be distance <code>(tolerance)</code> on either side of the arc path.		* <tt>(tolerance)</tt>: The arc region will be distance <code>(tolerance)</code> on either side of the arc path.

Nairnj at 16:48, 8 April 2017

2017-04-08T16:48:39Z

← Older revision		Revision as of 16:48, 8 April 2017
Line 76:		Line 76:
	<Line x1='(x1)' x2='(x2)' y1='(y1)' y2='(y2)' tolerance='(tol)'/>		<Line x1='(x1)' x2='(x2)' y1='(y1)' y2='(y2)' tolerance='(tol)'/>

	where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(~~tol~~)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.		where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tolerance)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.

	Note that <tt>xmin</tt>, <tt>xmax</tt>, <tt>ymin</tt>, and <tt>ymax</tt> can be used in place of <tt>x1</tt>, <tt>x2</tt>, <tt>y1</tt>, and <tt>y2</tt>.		Note that <tt>xmin</tt>, <tt>xmax</tt>, <tt>ymin</tt>, and <tt>ymax</tt> can be used in place of <tt>x1</tt>, <tt>x2</tt>, <tt>y1</tt>, and <tt>y2</tt>.
Line 82:		Line 82:
	== Arc Command ==		== Arc Command ==

	~~Coming soon~~		A scripted <tt>Arc</tt> command defines a region to be filled with material points or to be defined as a hole:

			Arc (xmin),(xmax),(ymin),(ymax),(arcStart)>,(arcEnd),<(tolerance)>

			In <tt>XML</tt> files, the command is:

			<Arc xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'
			start='(arcStart)' end='(arcEnd)' tolerance='(tolerance)'/>

			where

			* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of an oval (or R and Z extents if axisymmetric) that encloses the oval. If xmax<xmin or ymax<ymin, they will be automatically switched to define the oval. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].
			* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>: The arc will be path traced along border of the oval in the counterclockwise direction from angles specified in <tt>(arcStart)</tt> and <tt>(arcEnd)</tt>, where 0 degrees is the positive x axis direction. These must be entered as 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>.
			* <tt>(tolerance)</tt>: The arc region will be distance <code>(tolerance)</code> on either side of the arc path.

	== Relative Grid Locations ==		== Relative Grid Locations ==

Nairnj: /* Line Command */

2017-04-08T16:39:53Z

Line Command

← Older revision		Revision as of 16:39, 8 April 2017
Line 74:		Line 74:
	In <tt>XML</tt> files, the command is:		In <tt>XML</tt> files, the command is:

	<Line x1='(x1)' x2='(x2)' t1='(y1)' y2='(y2)' tolerance='(tol)'/>		<Line x1='(x1)' x2='(x2)' y1='(y1)' y2='(y2)' tolerance='(tol)'/>

	where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.		where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.

Nairnj: /* Line Command */

2017-04-08T16:36:38Z

Line Command

← Older revision		Revision as of 16:36, 8 April 2017
Line 78:		Line 78:
	where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.		where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.

	Note that <tt>xmin, <tt>xmax</tt>, <tt>ymin</tt>, and <tt>ymax</tt> can be used in place of <tt>x1</tt>, <tt>x2</tt>, <tt>y1</tt>, and <tt>y2</tt>.		Note that <tt>xmin</tt>, <tt>xmax</tt>, <tt>ymin</tt>, and <tt>ymax</tt> can be used in place of <tt>x1</tt>, <tt>x2</tt>, <tt>y1</tt>, and <tt>y2</tt>.

	== Arc Command ==		== Arc Command ==

Nairnj: /* Line Command */

2017-04-08T16:36:09Z

Line Command

← Older revision		Revision as of 16:36, 8 April 2017
Line 74:		Line 74:
	In <tt>XML</tt> files, the command is:		In <tt>XML</tt> files, the command is:

	<Line x1='(x1)' x2='(x2)' t1='(y1)' y2='(y2)' tolerance='(tol~~)'>~~		<Line x1='(x1)' x2='(x2)' t1='(y1)' y2='(y2)' tolerance='(tol)'/>
	~~<arc start='(arcStart)' end='(arcEnd~~)'/>
	~~</Oval~~>

	where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.		where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.

Nairnj at 16:35, 8 April 2017

2017-04-08T16:35:44Z

← Older revision		Revision as of 16:35, 8 April 2017
Line 68:		Line 68:
	== Line Command ==		== Line Command ==

	~~Coming soon~~		A scripted <tt>Line</tt> command defines a region to be filled with material points or to be defined as a hole:

			Line (x1),(x2),(y1),(y2),<(tolerance)>

			In <tt>XML</tt> files, the command is:

			<Line x1='(x1)' x2='(x2)' t1='(y1)' y2='(y2)' tolerance='(tol)'>
			<arc start='(arcStart)' end='(arcEnd)'/>
			</Oval>

			where the line is from <code>(x1,y1)</code> to <code>(x2,y2)</code>. The region will include points within <code>(tol)</code> of the line. The region will be rectangle with edges normal to the line and width of <code>2*(tolerance)</code>.

			Note that <tt>xmin, <tt>xmax</tt>, <tt>ymin</tt>, and <tt>ymax</tt> can be used in place of <tt>x1</tt>, <tt>x2</tt>, <tt>y1</tt>, and <tt>y2</tt>.

	== Arc Command ==		== Arc Command ==

Nairnj: /* Relative Grid Locations */

2017-03-08T05:04:43Z

Relative Grid Locations

← Older revision		Revision as of 05:04, 8 March 2017
Line 65:		Line 65:

	If the defined polygon overlaps areas that already have material points or previously was defined as a hole, those areas will be ignored.		If the defined polygon overlaps areas that already have material points or previously was defined as a hole, those areas will be ignored.

			== Line Command ==

			Coming soon

			== Arc Command ==

			Coming soon

	== Relative Grid Locations ==		== Relative Grid Locations ==

Nairnj: /* PolyPt Command */

2017-03-08T05:03:56Z

PolyPt Command

← Older revision		Revision as of 05:03, 8 March 2017
Line 60:		Line 60:
	where		where

	* <tt>(xi),(yi)</tt> (for i = 1 to n) are the <tt>x</tt> and <tt>y</tt> coordinates of the each point in the polygon (or <tt>R</tt> and <tt>Z</tt> if axisymmetric) with the last point <tt>(xn),(yn)</tt>) being connected to the first (<tt>(x1),(y1)</tt>). If the <tt>PolyPt</tt> arguments are omitted, the polygon is closed. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files).		* <tt>(xi),(yi)</tt> (for i = 1 to n) are the <tt>x</tt> and <tt>y</tt> coordinates of the each point in the polygon (or <tt>R</tt> and <tt>Z</tt> if axisymmetric) with the last point <tt>(xn),(yn)</tt>) being connected to the first (<tt>(x1),(y1)</tt>). If the <tt>PolyPt</tt> arguments are omitted, the polygon is closed. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].

	A blank <tt>PolyPt</tt> command in scripted files is only needed if you need to define more than one polygon in the same region. The blank command will finish the current one and the next one will start with the next <tt>PolyPt</tt> command. Intervening [[#Rect Command\|<tt>Rect</tt>]] and [[#Oval Command\|<tt>Oval</tt>]] commands or the end of a block will also stop the current polygon; in these cases the blank <tt>PolyPt</tt> is not needed.		A blank <tt>PolyPt</tt> command in scripted files is only needed if you need to define more than one polygon in the same region. The blank command will finish the current one and the next one will start with the next <tt>PolyPt</tt> command. Intervening [[#Rect Command\|<tt>Rect</tt>]] and [[#Oval Command\|<tt>Oval</tt>]] commands or the end of a block will also stop the current polygon; in these cases the blank <tt>PolyPt</tt> is not needed.

Nairnj: /* Oval Command */

2017-03-08T05:03:38Z

Oval Command

← Older revision		Revision as of 05:03, 8 March 2017
Line 34:		Line 34:
	where		where

	* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of the rectangle (or R and Z extents if axisymmetric) that encloses the oval. If xmax<xmin or ymax<ymin, they will be automatically switched to define the oval. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files).		* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of the rectangle (or R and Z extents if axisymmetric) that encloses the oval. If xmax<xmin or ymax<ymin, they will be automatically switched to define the oval. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt> are optional parameters that limit the shape to an to arc of the oval (ccw from start to end in degrees with 0 degrees along the x axis, 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>).		* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt> are optional parameters that limit the shape to an to arc of the oval (ccw from start to end in degrees with 0 degrees along the x axis, 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>).

Nairnj: /* Rect Command */

2017-03-08T05:03:26Z

Rect Command

← Older revision		Revision as of 05:03, 8 March 2017
Line 15:		Line 15:
	where		where

	* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of the rectangle (or R and Z extents if axisymmetric). If xmax<xmin or ymax<ymin, they will be automatically switched to define the rectangle. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files).		* <tt>(xmin),(xmax),(ymin)</tt>, and <tt>(ymax)</tt> are the x and y extents of the rectangle (or R and Z extents if axisymmetric). If xmax<xmin or ymax<ymin, they will be automatically switched to define the rectangle. The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt> are optional parameters that limit the shape to an to arc of the rectangle (ccw from start to end in degrees with 0 degrees along the x axis, 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>).		* <tt>(arcStart)</tt> and <tt>(arcEnd)</tt> are optional parameters that limit the shape to an to arc of the rectangle (ccw from start to end in degrees with 0 degrees along the x axis, 0≤<tt>(arcStart)</tt><360, and <tt>(arcEnd)</tt>><tt>(arcStart)</tt>).