Common Material Properties - Revision history

Nairnj: /* Crack Propagation Properties */

2021-01-04T21:56:22Z

Crack Propagation Properties

← Older revision		Revision as of 21:56, 4 January 2021
Line 73:		Line 73:
	\| criterion \|\| To set a custom crack propagation criterion. You can use any [[Crack Propagation Commands#Crack Propagation Criterion\|propagation option]]. Setting this property in a material overrides the [[Crack Propagation Commands#Propagate Command\|default propagation criterion setting]]. This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>criterion</tt> in <tt>XML</tt> files. \|\| none \|\| none		\| criterion \|\| To set a custom crack propagation criterion. You can use any [[Crack Propagation Commands#Crack Propagation Criterion\|propagation option]]. Setting this property in a material overrides the [[Crack Propagation Commands#Propagate Command\|default propagation criterion setting]]. This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>criterion</tt> in <tt>XML</tt> files. \|\| none \|\| none
	\|-		\|-
	\| direction \|\| To set a custom crack propagation direction. You can use any [[Crack Propagation Commands#Crack Propagation Direction\|direction option]]. Setting this property in a material overrides the [[Crack Propagation Commands#Propagate Command\|default propagation direction setting]]. This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>~~traction~~</tt> in <tt>XML</tt> files.\|\| none \|\| none		\| direction \|\| To set a custom crack propagation direction. You can use any [[Crack Propagation Commands#Crack Propagation Direction\|direction option]]. Setting this property in a material overrides the [[Crack Propagation Commands#Propagate Command\|default propagation direction setting]]. This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>direction</tt> in <tt>XML</tt> files.\|\| none \|\| none
	\|-		\|-
	\| traction \|\| To set a custom [[Crack Propagation Commands#Traction Law in Wake of Propagation\|traction law to create for crack propagation]] in this material. A traction law set in a material overrides the [[Crack Propagation Commands#Propagate Command\|default traction law]]. The traction law can be set by material ID (if the traction law has already been defined) or by number (if it is not defined yet). This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>~~criterion~~</tt> in <tt>XML</tt> files. \|\| none \|\| none		\| traction \|\| To set a custom [[Crack Propagation Commands#Traction Law in Wake of Propagation\|traction law to create for crack propagation]] in this material. A traction law set in a material overrides the [[Crack Propagation Commands#Propagate Command\|default traction law]]. The traction law can be set by material ID (if the traction law has already been defined) or by number (if it is not defined yet). This command is for scripted files only; see [[#Propagation Properties in XML Files\|below]] to set <tt>traction</tt> in <tt>XML</tt> files. \|\| none \|\| none
	\|-		\|-
	\| altcriterion \|\| Same as "criterion" property above except that it applies to the [[Crack Propagation Commands#Alternate Propagation Criterion\|alternate propagation criterion]] for the material \|\| none \|\| none		\| altcriterion \|\| Same as "criterion" property above except that it applies to the [[Crack Propagation Commands#Alternate Propagation Criterion\|alternate propagation criterion]] for the material \|\| none \|\| none

Nairnj: /* Fracture Toughness Properties */

2021-01-04T02:55:07Z

Fracture Toughness Properties

← Older revision		Revision as of 02:55, 4 January 2021
Line 59:		Line 59:
	\|-		\|-
	\| nmix \|\| An exponent used in mixed-modes failure of some traction laws. \|\| none \|\| 1		\| nmix \|\| An exponent used in mixed-modes failure of some traction laws. \|\| none \|\| 1
			\|-
			\| allowsCracks \|\| Set to 1 to allow the material to have cracks or 0 to not allow cracks. The default is 1 for non-rigid materials and 0 for rigid materials. Setting a non-rigid material to 0 lets that material enter a crack in another material such as to simulate cutting, to wedge open a crack, or model hydraulic fracturing. The non-cracking material can open the crack in the other material by contact on its crack surfaces. \|\| none \|\| varies
	\|}		\|}

Nairnj: /* Crack Propagation Properties */

2021-01-04T02:53:54Z

Crack Propagation Properties

← Older revision		Revision as of 02:53, 4 January 2021
Line 92:		Line 92:
	</ol>		</ol>
	\|\| none \|\| 0		\|\| none \|\| 0
	\|-
	\| allowsCracks \|\| Set to 1 to allow the material to have cracks or 0 to not allow cracks. The default is 1 for non-rigid materials and 0 for rigid materials. Setting a non-rigid material to 0 lets that material enter a crack in another material such as to simulate cutting, to wedge open a crack, or model fracking with a liquid causes crack propagation. The non-crack material can open the crack in the other material by contact mechanics.
	\|}		\|}

Nairnj: /* Crack Propagation Properties */

2021-01-04T02:44:47Z

Crack Propagation Properties

← Older revision		Revision as of 02:44, 4 January 2021
Line 92:		Line 92:
	</ol>		</ol>
	\|\| none \|\| 0		\|\| none \|\| 0
			\|-
			\| allowsCracks \|\| Set to 1 to allow the material to have cracks or 0 to not allow cracks. The default is 1 for non-rigid materials and 0 for rigid materials. Setting a non-rigid material to 0 lets that material enter a crack in another material such as to simulate cutting, to wedge open a crack, or model fracking with a liquid causes crack propagation. The non-crack material can open the crack in the other material by contact mechanics.
	\|}		\|}

Nairnj: /* Artificial Viscosity */

2021-01-04T02:17:09Z

Artificial Viscosity

← Older revision		Revision as of 02:17, 4 January 2021
Line 166:		Line 166:
	* [[JWLPlusPlus Material\|JWLPlusPlus]]		* [[JWLPlusPlus Material\|JWLPlusPlus]]
	* [[Viscoelastic Material\|Viscoelastic]]		* [[Viscoelastic Material\|Viscoelastic]]
			* [[Isotropic, Elastic-Plastic Material\|IsoPlasticity]]

	== Poroelasticity Properties ==		== Poroelasticity Properties ==

Nairnj: /* Contact Properties */

2020-09-15T01:03:49Z

Contact Properties

← Older revision		Revision as of 01:03, 15 September 2020
Line 113:		Line 113:
	! Property !! Description !! Units !! Default		! Property !! Description !! Units !! Default
	\|-		\|-
	\| Contact<br><Friction> \|\| In scripted files, use the Contact property with two arguments — <tt>(lawID)</tt> and <tt>(matID)</tt>. It sets a custom [[Contact Laws\|contact law]] (by its material ID in <tt>(lawID)</tt>) to use for contact between this material and the material defined by <tt>(matID)</tt>. You only need to enter a Contact property for one of the two materials in each pair. Since you have to provide the other material's ID, you should use the Contact command in the second material after the first one has already been defined (and after the [[Contact Laws\|contact law]] has been defined as well).<br>In XML files use the command:<br>    <tt><Friction law='(lawnum)' lawname='(lawID)' mat='(matnum)' matname='(matID)'/></tt><br>to set the custom [[Contact Laws\|contact law]] by number or ID for both the law and the other material. If both number and ID are used, the ID will take precedence. \|\| none \|\| none		\| Contact<br><Friction> \|\| In scripted files, use the Contact property with two arguments — <tt>(lawID)</tt> and <tt>(matID)</tt>. It sets a custom [[Contact Laws\|contact law]] (by its material ID in <tt>(lawID)</tt>) to use for contact between this material and the material defined by <tt>(matID)</tt>. You only need to enter a Contact property for one of the two materials in each pair. Since you have to provide the other material's ID, you should use the Contact command in the second material after the first one has already been defined (and after the [[Contact Laws\|contact law]] has been defined as well).<br>
			In XML files use the command:<br>    <tt><Friction law='(lawnum)' lawname='(lawID)' mat='(matnum)' matname='(matID)'/></tt><br>to set the custom [[Contact Laws\|contact law]] by number or ID for both the law and the other material. If both number and ID are used, the ID will take precedence. \|\| none \|\| none
	\|-		\|-
	\| shareMatField \|\| ~~Set to~~ another material to share ~~material~~ velocity field ~~with~~ that ~~material. Two~~ (or more) materials ~~sharing~~ the same velocity field ~~will move with~~ perfect contact ~~(''i.e.'', in a single velocity field) among themselves~~, ~~but~~ can interact with ~~other~~ materials in different velocity fields by [[Multimaterial MPM\|multimaterial mode]] contact or interface laws. ~~Materials~~ sharing velocity fields must ~~be compatible and the shared material must not be sharing it's field. The meaning of~~ "compatible" fields (''e.g.'', all rigid or all nonrigid) ~~may evolve~~; an error will occur (with an explanation) if you try to share velocity fields of incompatible materials. \|\| none \|\| none		\| shareMatField \|\| The value selects another material to share the same velocity field such that the two materials move together and interact by perfect contact (see below for how to have more than two materials share one field). Although materials in the same velocity field interact by perfect contact, they can interact with materials in different velocity fields by [[Multimaterial MPM\|multimaterial mode]] contact or interface laws. Finally, materials sharing velocity fields must use "compatible" fields (''e.g.'', all rigid or all nonrigid); an error will occur (with an explanation) if you try to share velocity fields of incompatible materials. \|\| none \|\| none
	\|}		\|}

Nairnj: /* Artificial Viscosity */

2020-05-12T23:08:08Z

Artificial Viscosity

← Older revision		Revision as of 23:08, 12 May 2020
Line 163:		Line 163:
	* [[Tait Liquid Material\|Tait Liquid]]		* [[Tait Liquid Material\|Tait Liquid]]
	* [[Ideal Gas Material\|Ideal Gas]]		* [[Ideal Gas Material\|Ideal Gas]]
			* [[JWLPlusPlus Material\|JWLPlusPlus]]
	* [[Viscoelastic Material\|Viscoelastic]]		* [[Viscoelastic Material\|Viscoelastic]]

Nairnj: /* Basic Properties */

2019-05-31T22:26:13Z

Basic Properties

← Older revision		Revision as of 22:26, 31 May 2019
Line 27:		Line 27:
	\| color \|\| Sets the color of the material. The color is used in material point method plots material type in [[NairnFEAMPM]] and in [[NairnFEAMPMViz]]. If no color is provided, a color will be picked from the current spectrum using the material number. In scripted files, this property takes four arguments being red, green, blue, and alpha values between 0.0 and 1.0. A single argument means to set gray level between 0.0 and 1.0 (with alpha=1.0). Three arguments means set red, green, and blue with alpha=1.0. In <tt>XML</tt> files, the color is set with "red", "green", "blue" and "alpha" attributes (and the element's content is ignored). \|\| none \|\| none		\| color \|\| Sets the color of the material. The color is used in material point method plots material type in [[NairnFEAMPM]] and in [[NairnFEAMPMViz]]. If no color is provided, a color will be picked from the current spectrum using the material number. In scripted files, this property takes four arguments being red, green, blue, and alpha values between 0.0 and 1.0. A single argument means to set gray level between 0.0 and 1.0 (with alpha=1.0). Three arguments means set red, green, and blue with alpha=1.0. In <tt>XML</tt> files, the color is set with "red", "green", "blue" and "alpha" attributes (and the element's content is ignored). \|\| none \|\| none
	\|}		\|}

	Note that when customizing the [[Damping Options#PIC Damping\|PIC damping]] properties for material points of one material types, the options have some limitations, depending on the simulation's [[Damping Options#PIC Damping\|global PIC damping setting]]. The following table summarizes the options.

	~~{\| class="wikitable"~~
	\|-
	~~! Global Setting !! Material Options~~
	\|-
	~~\| FLIP/PIC (f≥0) \|\| A material can change f to switch to pure FLIP (f=0) or to any new amount of PIC (f>0). XPIC cannot be selected by a material.~~
	\|-
	~~\| FLIP/XPIC(m) (f>0) \|\| A material can change to pure FLIP (f=0) or to any new amount of XPIC(m) (f>0). The XPIC order cannot be selected by a material.~~
	\|}

	The only limitations are when using [[Damping Options#XPIC Damping\|XPIC damping]]. Such simulations must select XPIC order and set f>0 as the global options. Individual materials can change the amount of XPIC (''i.e.'', change f), but cannot change the XPIC order.

	== Fracture Toughness Properties ==		== Fracture Toughness Properties ==

Nairnj: /* Basic Properties */

2019-05-31T22:25:39Z

Basic Properties

← Older revision		Revision as of 22:25, 31 May 2019
Line 24:		Line 24:
	\|-		\|-
	\| matDamping \|\| Sets custom particle damping to apply only to particles of this material. Its value replaces global [[Damping Options#Grid and Particle Damping\|particle damping setting]] and must be a constant (function of time not allowed). In XML files, set matDamping using <tt><PDamping>matDamping</PDamping></tt> \|\| 1/[[ConsistentUnits Command#Legacy and Consistent Units\|time units]] \|\| none		\| matDamping \|\| Sets custom particle damping to apply only to particles of this material. Its value replaces global [[Damping Options#Grid and Particle Damping\|particle damping setting]] and must be a constant (function of time not allowed). In XML files, set matDamping using <tt><PDamping>matDamping</PDamping></tt> \|\| 1/[[ConsistentUnits Command#Legacy and Consistent Units\|time units]] \|\| none
	\|-
	\| matPIC \|\| Sets custom PIC damping (0 to 1) to apply only to particles of this material. Its value replaces the [[Damping Options#PIC Damping\|global PIC damping setting]]. In XML files, set matPIC using <tt><PDamping PIC="matPIC"/></tt>. To set both matDamping and matPIC in XML files, use one command <tt><PDamping PIC="matPIC">matDamping</PDamping></tt>. Note that to use custom [[Damping Options#XPIC Damping\|XPIC damping]] in materials and FLIP in others requires careful settings (as explained below this table). \|\| none \|\| none
	\|-		\|-
	\| color \|\| Sets the color of the material. The color is used in material point method plots material type in [[NairnFEAMPM]] and in [[NairnFEAMPMViz]]. If no color is provided, a color will be picked from the current spectrum using the material number. In scripted files, this property takes four arguments being red, green, blue, and alpha values between 0.0 and 1.0. A single argument means to set gray level between 0.0 and 1.0 (with alpha=1.0). Three arguments means set red, green, and blue with alpha=1.0. In <tt>XML</tt> files, the color is set with "red", "green", "blue" and "alpha" attributes (and the element's content is ignored). \|\| none \|\| none		\| color \|\| Sets the color of the material. The color is used in material point method plots material type in [[NairnFEAMPM]] and in [[NairnFEAMPMViz]]. If no color is provided, a color will be picked from the current spectrum using the material number. In scripted files, this property takes four arguments being red, green, blue, and alpha values between 0.0 and 1.0. A single argument means to set gray level between 0.0 and 1.0 (with alpha=1.0). Three arguments means set red, green, and blue with alpha=1.0. In <tt>XML</tt> files, the color is set with "red", "green", "blue" and "alpha" attributes (and the element's content is ignored). \|\| none \|\| none

Nairnj: /* Artificial Viscosity */

2018-11-07T22:38:39Z

Artificial Viscosity

← Older revision		Revision as of 22:38, 7 November 2018
Line 176:		Line 176:
	* [[Mooney Material\|Mooney]]		* [[Mooney Material\|Mooney]]
	* [[Neo-Hookean Material\|Neohookean]]		* [[Neo-Hookean Material\|Neohookean]]
			* [[Tait Liquid Material\|Tait Liquid]]
			* [[Ideal Gas Material\|Ideal Gas]]
	* [[Viscoelastic Material\|Viscoelastic]]		* [[Viscoelastic Material\|Viscoelastic]]
	* [[Ideal Gas Material\|Ideal Gas]]

	== Poroelasticity Properties ==		== Poroelasticity Properties ==

← Older revision		Revision as of 23:08, 12 May 2020
Line 163:		Line 163:
	* [[Tait Liquid Material\|Tait Liquid]]		* [[Tait Liquid Material\|Tait Liquid]]
	* [[Ideal Gas Material\|Ideal Gas]]		* [[Ideal Gas Material\|Ideal Gas]]
			* [[JWLPlusPlus Material\|JWLPlusPlus]]
	* [[Viscoelastic Material\|Viscoelastic]]		* [[Viscoelastic Material\|Viscoelastic]]

← Older revision		Revision as of 22:38, 7 November 2018
Line 176:		Line 176:
	* [[Mooney Material\|Mooney]]		* [[Mooney Material\|Mooney]]
	* [[Neo-Hookean Material\|Neohookean]]		* [[Neo-Hookean Material\|Neohookean]]
			* [[Tait Liquid Material\|Tait Liquid]]
			* [[Ideal Gas Material\|Ideal Gas]]
	* [[Viscoelastic Material\|Viscoelastic]]		* [[Viscoelastic Material\|Viscoelastic]]
	* [[Ideal Gas Material\|Ideal Gas]]

	== Poroelasticity Properties ==		== Poroelasticity Properties ==