Difference between revisions of "PointList Block"
Jump to navigation
Jump to search
| Line 7: | Line 7: | ||
<PointList> | <PointList> | ||
<mp elem='(elemNum)' mat='(natNum)' angle='(angle)' thick='(thick)' conc='(conc)' temp='(temp)'> | <mp elem='(elemNum)' mat='(natNum)' angle='(angle)' thick='(thick)' conc='(conc)' temp='(temp)'> | ||
<pt | <pt x='1.25' y='-11.25'/> | ||
<vel | <vel x='0' y='0'/> | ||
<mass | <mass m='1e-3'/> | ||
</mp> | </mp> | ||
. . . | . . . | ||
| Line 19: | Line 19: | ||
* <tt>(matNum)</tt> - the material nuimber (a number can be replaced by a material name using a <tt>matname</tt> attribute as explained [[Material Command Block#Referencing Materials in XML Files|here]]. | * <tt>(matNum)</tt> - the material nuimber (a number can be replaced by a material name using a <tt>matname</tt> attribute as explained [[Material Command Block#Referencing Materials in XML Files|here]]. | ||
* <tt>(angle)</tt> - the material angle (in degrees) which is used for some [[Material Models|anisotropic materials]] (default = 0). | * <tt>(angle)</tt> - the material angle (in degrees) which is used for some [[Material Models|anisotropic materials]] (default = 0). | ||
* <tt>(thick)</tt> - the thickness (in | * <tt>(thick)</tt> - the thickness (in [[ConsistentUnits Command#Legacy and Consistent Units|length units]]), for planar 2D only (default is equal to the [[MPM Grid Generation|grid thickness]]). | ||
* <tt>(conc)</tt> - the initial concentration (set as potential from 0 to 1 where 1 is the saturation concentration for the particle's material type) when doing [[Diffusion Calculations|diffusion calculations]]. Alternatively you can set initial concentration as weight fraction by using a <tt>wtconc</tt> attribute instead. The weight fraction concentration must be between 0 and the saturation concentration for the particle's material type. If both <tt>conc</tt> and <tt>conc</tt> are used, the one that appears last will determine the concentration (default 0). | * <tt>(conc)</tt> - the initial concentration (set as potential from 0 to 1 where 1 is the saturation concentration for the particle's material type) when doing [[Diffusion Calculations|diffusion calculations]]. Alternatively you can set initial concentration as weight fraction by using a <tt>wtconc</tt> attribute instead. The weight fraction concentration must be between 0 and the saturation concentration for the particle's material type. If both <tt>conc</tt> and <tt>conc</tt> are used, the one that appears last will determine the concentration (default 0). | ||
* <tt>(temp)</tt> - the initial temperature (temp) when doing [[Thermal Calculations|thermal loading or conduction calculations]] (default is the [[Thermal Calculations@Stress Free Temperature|stress free temperature]]). | * <tt>(temp)</tt> - the initial temperature (temp) when doing [[Thermal Calculations|thermal loading or conduction calculations]] (default is the [[Thermal Calculations@Stress Free Temperature|stress free temperature]]). | ||
| Line 25: | Line 25: | ||
Subordinate to each <tt><mp></tt> element, you define the material point properties using <tt><pt></tt> (required), <tt><vel></tt>, and <tt><mass></tt> commands: | Subordinate to each <tt><mp></tt> element, you define the material point properties using <tt><pt></tt> (required), <tt><vel></tt>, and <tt><mass></tt> commands: | ||
* <tt><pt></tt>- gives the x, y, and z (if 3D)) coordinates in attributes in | * <tt><pt></tt>- gives the x, y, and z (if 3D)) coordinates in attributes in [[ConsistentUnits Command#Legacy and Consistent Units|length units]], but an optional [[Units Attribute|units attribute]] can specify other length units (required). | ||
* <tt><vel></tt> - give the material point's initial velocity in the x, y, and z (if 3D) directions in | * <tt><vel></tt> - give the material point's initial velocity in the x, y, and z (if 3D) directions in [[ConsistentUnits Command#Legacy and Consistent Units|velocity units]]. An optional [[Units Attribute|units attribute]] can specify other velocity units) (default is zero velocity) | ||
* <tt><mass></tt> - normally the particle mass is determined from the size of the elements and the number of particles per element and this command is not used. When running a simulation based on material points from a previous simulation, this command can be used to set the particle mass (in g, but an optional [[Units Attribute|units attribute]] can specify the mass units). | * <tt><mass></tt> - normally the particle mass is determined from the size of the elements and the number of particles per element and this command is not used. When running a simulation based on material points from a previous simulation, this command can be used to set the particle mass (in g, but an optional [[Units Attribute|units attribute]] can specify the mass units). | ||
Revision as of 13:38, 2 June 2015
A <PointList> block can explicitly list individual material points. This block is almost never used because it is much better to use Region and Hole commands. The one exception is when running a calculation based on material point locations from a previous simulation.
PointList Block
An XML file can include one <PointList> block and it must be within the single<MaterialPoints>.
<PointList>
<mp elem='(elemNum)' mat='(natNum)' angle='(angle)' thick='(thick)' conc='(conc)' temp='(temp)'>
<pt x='1.25' y='-11.25'/>
<vel x='0' y='0'/>
<mass m='1e-3'/>
</mp>
. . .
</PointList>
Within the <PointList> block,the material points are defined by a series of subordinate <mp> elements. Its attributes are:
- (elemNum) - the element number that contains the material point (this attribute is optional; if not provided the element will be looked up)
- (matNum) - the material nuimber (a number can be replaced by a material name using a matname attribute as explained here.
- (angle) - the material angle (in degrees) which is used for some anisotropic materials (default = 0).
- (thick) - the thickness (in length units), for planar 2D only (default is equal to the grid thickness).
- (conc) - the initial concentration (set as potential from 0 to 1 where 1 is the saturation concentration for the particle's material type) when doing diffusion calculations. Alternatively you can set initial concentration as weight fraction by using a wtconc attribute instead. The weight fraction concentration must be between 0 and the saturation concentration for the particle's material type. If both conc and conc are used, the one that appears last will determine the concentration (default 0).
- (temp) - the initial temperature (temp) when doing thermal loading or conduction calculations (default is the stress free temperature).
Subordinate to each <mp> element, you define the material point properties using <pt> (required), <vel>, and <mass> commands:
- <pt>- gives the x, y, and z (if 3D)) coordinates in attributes in length units, but an optional units attribute can specify other length units (required).
- <vel> - give the material point's initial velocity in the x, y, and z (if 3D) directions in velocity units. An optional units attribute can specify other velocity units) (default is zero velocity)
- <mass> - normally the particle mass is determined from the size of the elements and the number of particles per element and this command is not used. When running a simulation based on material points from a previous simulation, this command can be used to set the particle mass (in g, but an optional units attribute can specify the mass units).