Particle BC Shape Commands - Revision history

Nairnj: /* Box or Cylinder (3D) */

2017-04-08T18:56:03Z

Box or Cylinder (3D)

← Older revision		Revision as of 18:56, 8 April 2017
Line 108:		Line 108:
	zmin='(z1)' zmax='(z2)' axis='(axis)'>		zmin='(z1)' zmax='(z2)' axis='(axis)'>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	</BCBox>		</BCBox>

Nairnj: /* Rectangle (2D or Axisymmetric) */

2017-04-08T18:55:51Z

Rectangle (2D or Axisymmetric)

← Older revision		Revision as of 18:55, 8 April 2017
Line 79:		Line 79:
	<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>		<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	</LdRect>		</LdRect>

Nairnj: /* Rectangle (2D or Axisymmetric) */

2017-04-08T18:55:41Z

Rectangle (2D or Axisymmetric)

← Older revision		Revision as of 18:55, 8 April 2017
Line 66:		Line 66:
	LoadRect (xmin),(xmax),(ymin),(ymax)		LoadRect (xmin),(xmax),(ymin),(ymax)
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	EndLoadRect		EndLoadRect

Nairnj at 18:55, 8 April 2017

2017-04-08T18:55:22Z

← Older revision		Revision as of 18:55, 8 April 2017
Line 1:		Line 1:
	The method to create particle-based boundary conditions was changed in [[NairnMPM]] (April 2017) and [[OSParticulas]] (revision 1170) to the method using [[Particle-Based Boundary Conditions\|<tt>ParticleBC</tt> and <tt><BCShape></tt> blocks]]. As a result, all boundary ~~conditions~~ commands listed below are deprecated. They still work, but should be replaced by new methods as described below.		The method to create particle-based boundary conditions was changed in [[NairnMPM]] (April 2017) and [[OSParticulas]] (revision 1170) to the method using [[Particle-Based Boundary Conditions\|<tt>ParticleBC</tt> and <tt><BCShape></tt> blocks]]. As a result, all boundary condition commands listed below are deprecated. They still work, but should be replaced by new methods as described below.

	== Line (2D or Axisymmetric) ==		== Line (2D or Axisymmetric) ==

	The command to select a line through a 2D mesh in scripted files is:		The command to select a line through a 2D mesh in scripted files:

	LoadLine (x1),(y1),(x2),(y2),<(tolerance)>		LoadLine (x1),(y1),(x2),(y2),<(tolerance)>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	EndLoadLine		EndLoadLine

			should be replaced with (and note changed order of parameters):

			ParticleBC
			Line (x1),(x2),(y1)),(y2),<(tolerance)>
			(one or more load, traction, heat flux, or concentration flux condition)
			EndParticleBC

	In <tt>XML</tt> files, a line is selected with:		In <tt>XML</tt> files, a line is selected with:
Line 16:		Line 22:
	...		...
	</BCLine>		</BCLine>

			should be replaced with

			<BCShape>
			<Line x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)' tolerance='(tolerance)'>
			(one or more load, traction, heat flux, or concentration flux condition)
			</BCShape >

	== Arc (2D or Axisymmetric) ==		== Arc (2D or Axisymmetric) ==

	The command to select an arc through a 2D mesh in scripted files is:		The command to select an arc through a 2D mesh in scripted files:

	LoadArc (x1),(y1),(x2),(y2),(startAng),(endAng),<(tolerance)>		LoadArc (x1),(y1),(x2),(y2),(startAng),(endAng),<(tolerance)>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	EndLoadArc		EndLoadArc

	In <tt>XML</tt> files, a line is selected with:		should be replaced with (and note changed order of parameters):

			ParticleBC
			Arc (x1),(x2,(y1)),(y2),(startAng),(endAng),<(tolerance)>
			(one or more load, traction, heat flux, or concentration flux condition)
			EndParticleBC

			In <tt>XML</tt> files, an line selected with:

	<BCArc units='(units)' x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)'		<BCArc units='(units)' x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)'
	start='(startAng)' end='(endAng)' tolerance='(tolerance)'>		start='(startAng)' end='(endAng)' tolerance='(tolerance)'>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	</BCLine>		</BCLine>

			should be replaced with

			<BCShape>
			<Arc units='(units)' x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)'
			start='(startAng)' end='(endAng)' tolerance='(tolerance)'>
			(one or more load, traction, heat flux, or concentration flux condition)
			</BCShape >

	== Rectangle (2D or Axisymmetric) ==		== Rectangle (2D or Axisymmetric) ==

	The command to select rectangle in a 2D mesh in scripted files is:		The command to select rectangle in a 2D mesh in scripted files:

	LoadRect (xmin),(xmax),(ymin),(ymax)		LoadRect (xmin),(xmax),(ymin),(ymax)
Line 43:		Line 69:
	EndLoadRect		EndLoadRect

	In <tt>XML</tt> files, a rectangle is selected with:		should be replaced with:

			ParticleBC
			Rect (xmin),(xmax),(ymin),(ymax)
			(one or more load, traction, heat flux, or concentration flux condition)
			EndParticleBC

			In <tt>XML</tt> files, a rectangle selected with:

	<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>		<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>
Line 49:		Line 82:
	...		...
	</LdRect>		</LdRect>

			should be replaced with

			<BCShape>
			<Rect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>
			(one or more load, traction, heat flux, or concentration flux condition)
			</BCShape>

	== Box or Cylinder (3D) ==		== Box or Cylinder (3D) ==

	The command to select a 3D box or cylinder in scripted files is:		The command to select a 3D box or cylinder in scripted files:

	LoadBox (x1),(y1),(z1),(x2),(y2),(z2),<(axis)>		LoadBox (x1),(y1),(z1),(x2),(y2),(z2),<(axis)>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	~~...~~
	EndLoadBox		EndLoadBox

	In <tt>XML</tt> files, a box is selected with:		should be replaced with (and note changed order of parameters):

			ParticleBC
			Box (x1),(x2),(y1)),(y2),(z1)),(z2),<(tolerance)>
			(one or more load, traction, heat flux, or concentration flux condition)
			EndParticleBC

			In <tt>XML</tt> files, a box selected with:

	<BCBox units='(units)' xmin='(x1)' xmax='(x2)' ymin='(y1)' ymax='(y2)'		<BCBox units='(units)' xmin='(x1)' xmax='(x2)' ymin='(y1)' ymax='(y2)'
Line 65:		Line 111:
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	...		...
			</BCBox>

			should be replaced with

			<BCShape>
			<Box units='(units)' xmin='(x1)' xmax='(x2)' ymin='(y1)' ymax='(y2)'
			zmin='(z1)' zmax='(z2)' axis='(axis)'>
			(one or more load, traction, heat flux, or concentration flux condition)
	</BCBox>		</BCBox>

Nairnj at 18:10, 8 April 2017

2017-04-08T18:10:30Z

← Older revision		Revision as of 18:10, 8 April 2017
Line 1:		Line 1:
	~~These commands define shapes. All particles contained within~~ the ~~shape will be assigned~~ [[Particle-Based Boundary Conditions\|~~boundary conditions~~]] ~~for [[Setting Forces and Fluxes\|load~~, ~~traction~~, ~~heat flux, and concentration flux]] that are specified within the shape command~~.		The method to create particle-based boundary conditions was changed in [[NairnMPM]] (April 2017) and [[OSParticulas]] (revision 1170) to the method using [[Particle-Based Boundary Conditions\|<tt>ParticleBC</tt> and <tt><BCShape></tt> blocks]]. As a result, all boundary conditions commands listed below are deprecated. They still work, but should be replaced by new methods as described below.

	== Line (2D or Axisymmetric) ==		== Line (2D or Axisymmetric) ==
Line 16:		Line 16:
	...		...
	</BCLine>		</BCLine>

	~~where~~

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(tolerance)</tt> is an optional tolerance. 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, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the line from <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt>.

	== Arc (2D or Axisymmetric) ==		== Arc (2D or Axisymmetric) ==
Line 40:		Line 33:
	...		...
	</BCLine>		</BCLine>

	~~where~~

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.
	* <tt>(tolerance)</tt> is an optional tolerance. 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, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the arc. The arc is traced in a counter-clockwise direction from <tt>(startAng)</tt> to <tt>(endAng)</tt> with angle = 0 corresponding to the position along the positive x axis.

	== Rectangle (2D or Axisymmetric) ==		== Rectangle (2D or Axisymmetric) ==
Line 64:		Line 49:
	...		...
	</LdRect>		</LdRect>

	* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by an optional [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].

	~~This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.~~

	== Box or Cylinder (3D) ==		== Box or Cylinder (3D) ==
Line 85:		Line 66:
	...		...
	</BCBox>		</BCBox>

	~~where~~

	* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).

	~~This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.~~

Nairnj at 21:44, 2 June 2015

2015-06-02T21:44:35Z

Nairnj: /* Line (2D or Axisymmetric) */

2014-02-08T03:21:38Z

Line (2D or Axisymmetric)

← Older revision		Revision as of 03:21, 8 February 2014
Line 5:		Line 5:
	The command to select a line through a 2D mesh in scripted files is:		The command to select a line through a 2D mesh in scripted files is:

	LoadLine (x1),(y1),(x2),(y2),(tolerance)		LoadLine (x1),(y1),(x2),(y2),<(tolerance)>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	...		...

Nairnj: /* Rectangle (2D or Axisymmetric) */

2013-12-26T23:28:10Z

Rectangle (2D or Axisymmetric)

← Older revision		Revision as of 23:28, 26 December 2013
Line 65:		Line 65:
	</LdRect>		</LdRect>

	* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm or determined by an optional [[Units Attribute\|units attribute]] . In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm (or determined by an optional [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.

Nairnj at 23:26, 26 December 2013

2013-12-26T23:26:40Z

← Older revision		Revision as of 23:26, 26 December 2013
Line 19:		Line 19:
	where		where

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid~~-Based Boundary Conditions~~#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.		* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

Line 43:		Line 43:
	where		where

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid~~-Based Boundary Conditions~~#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.		* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.
	* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.		* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.
Line 65:		Line 65:
	</LdRect>		</LdRect>

	* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm or determined by an optional [[Units Attribute\|units attribute]] . In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid~~-Based Boundary Conditions~~#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm or determined by an optional [[Units Attribute\|units attribute]] . In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.
Line 88:		Line 88:
	where		where

	* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid~~-Based Boundary conditions~~#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).		* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.

Nairnj: Created page with "These commands define shapes. All particles contained within the shape will be assigned boundary conditions for [[Setting Forces and Flu..."

2013-12-26T23:23:02Z

Created page with "These commands define shapes. All particles contained within the shape will be assigned boundary conditions for [[Setting Forces and Flu..."

New page

These commands define shapes. All particles contained within the shape will be assigned [[Particle-Based Boundary Conditions|boundary conditions]] for [[Setting Forces and Fluxes|load, traction, heat flux, and concentration flux]] that are specified within the shape command.

== Line (2D or Axisymmetric) ==

The command to select a line through a 2D mesh in scripted files is:

LoadLine (x1),(y1),(x2),(y2),(tolerance)
(one or more load, traction, heat flux, or concentration flux condition)
...
EndLoadLine

In <tt>XML</tt> files, a line is selected with:

<BCLine units='(units)' x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)' tolerance='(tolerance)'>
(one or more load, traction, heat flux, or concentration flux condition)
...
</BCLine>

where

* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid-Based Boundary Conditions#Relative Grid Locations|relative to the mesh edges]].
* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

This command will apply [[Setting Forces and Fluxes|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the line from <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt>.

== Arc (2D or Axisymmetric) ==

The command to select an arc through a 2D mesh in scripted files is:

LoadArc (x1),(y1),(x2),(y2),(startAng),(endAng),<(tolerance)>
(one or more load, traction, heat flux, or concentration flux condition)
...
EndLoadArc

In <tt>XML</tt> files, a line is selected with:

<BCArc units='(units)' x1='(x1)' y1='(y1)' x2='(x2)' y2='(y2)'
start='(startAng)' end='(endAng)' tolerance='(tolerance)'>
(one or more load, traction, heat flux, or concentration flux condition)
...
</BCLine>

where

* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid-Based Boundary Conditions#Relative Grid Locations|relative to the mesh edges]].
* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.
* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

This command will apply [[Setting Forces and Fluxes|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the arc. The arc is traced in a counter-clockwise direction from <tt>(startAng)</tt> to <tt>(endAng)</tt> with angle = 0 corresponding to the position along the positive x axis.

== Rectangle (2D or Axisymmetric) ==

The command to select rectangle in a 2D mesh in scripted files is:

LoadRect (xmin),(xmax),(ymin),(ymax)
(one or more load, traction, heat flux, or concentration flux condition)
...
EndLoadRect

In <tt>XML</tt> files, a rectangle is selected with:

<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)' units='mm'>
(one or more load, traction, heat flux, or concentration flux condition)
...
</LdRect>

* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm or determined by an optional [[Units Attribute|units attribute]] . In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid-Based Boundary Conditions#Relative Grid Locations|relative to the mesh edges]].

This command will apply [[Setting Forces and Fluxes|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.

== Box or Cylinder (3D) ==

The command to select a 3D box or cylinder in scripted files is:

LoadBox (x1),(y1),(z1),(x2),(y2),(z2),<(axis)>
(one or more load, traction, heat flux, or concentration flux condition)
...
EndLoadBox

In <tt>XML</tt> files, a box is selected with:

<BCBox units='(units)' xmin='(x1)' xmax='(x2)' ymin='(y1)' ymax='(y2)'
zmin='(z1)' zmax='(z2)' axis='(axis)'>
(one or more load, traction, heat flux, or concentration flux condition)
...
</BCBox>

where

* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. The units are mm (or determined by a [[Units Attribute|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid-Based Boundary conditions#Relative Grid Locations|relative to the mesh edges]].
* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).

This command will apply [[Setting Forces and Fluxes|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.

← Older revision		Revision as of 21:44, 2 June 2015
Line 19:		Line 19:
	where		where

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the points at the beginning and end of the line (or <tt>(R, Z)</tt> coordinates if axisymmetric). 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.		* <tt>(tolerance)</tt> is an optional tolerance. 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, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the line from <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt>.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the line from <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt>.
Line 43:		Line 43:
	where		where

	* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1)</tt> to <tt>(x2, y2)</tt> define <tt>(x, y)</tt> coordinates for the corners of a rectangular area enclosing the arc (or <tt>(R, Z)</tt> coordinates if axisymmetric). 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.		* <tt>(startAng)</tt> and <tt>(endAng)</tt> give the start and end angle (in degrees) to specify the arc.
	* <tt>(tolerance)</tt> is an optional tolerance. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.		* <tt>(tolerance)</tt> is an optional tolerance. 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, you can optionally use the format <tt>'*0.5'</tt> to set the tolerance to any factor times the minimum cell dimension in the current mesh. If it is omitted, the tolerance will be set to a small number appropriate for the current background grid cell dimensions.

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the arc. The arc is traced in a counter-clockwise direction from <tt>(startAng)</tt> to <tt>(endAng)</tt> with angle = 0 corresponding to the position along the positive x axis.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within <tt>(tolerance)</tt> of the arc. The arc is traced in a counter-clockwise direction from <tt>(startAng)</tt> to <tt>(endAng)</tt> with angle = 0 corresponding to the position along the positive x axis.
Line 60:		Line 60:
	In <tt>XML</tt> files, a rectangle is selected with:		In <tt>XML</tt> files, a rectangle is selected with:

	<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)~~' units='mm~~'>		<LdRect xmin='(xmin)' xmax='(xmax)' ymin='(ymin)' ymax='(ymax)'>
	(one or more load, traction, heat flux, or concentration flux condition)		(one or more load, traction, heat flux, or concentration flux condition)
	...		...
	</LdRect>		</LdRect>

	* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are mm (or determined by an optional [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(xmin)</tt>, <tt>(xmax)</tt>, <tt>(ymin)</tt>, and <tt>(xmax)</tt>define the <tt>x</tt> and <tt>y</tt> ranges for the rectangular area (or <tt>R</tt> and <tt>Z</tt> ranges if axisymmetric). The units are [[ConsistentUnits Command#Legacy and Consistent Units\|length units]] (or determined by an optional [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the rectangle.
Line 88:		Line 88:
	where		where

	* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. The units are mm (or determined by a [[Units Attribute\|units attribute]] in <tt>XML</tt> files). In <tt>XML</tt> files, the coordinates can alternatively be specified [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].		* <tt>(x1, y1, z1)</tt> and <tt>(x2, y2, z2)</tt> define <tt>(x, y, z)</tt> coordinates for opposite corners of the box. 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 [[Grid BC Shape Commands#Relative Grid Locations\|relative to the mesh edges]].
	* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).		* <tt>(axis)</tt> is an optional parameter that will convert the shape from a box to the cylinder enclosed within the box with its axis along the specified direction (entered as x, 1, y, 2, z, or 3).

	This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.		This command will apply [[Setting Forces and Fluxes\|load, traction, heat flux, and/or concentration flux boundary conditions]] to all particles within the specified box or cylinder.