VTKArchive Custom Task - Revision history

Nairnj: /* Archivable Quantities */

2026-02-09T04:21:17Z

Archivable Quantities

← Older revision		Revision as of 04:21, 9 February 2026
Line 68:		Line 68:
	* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.		* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.
	* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).		* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).
	* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM#Multimaterial Mode Input Commands\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.		* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM#Multimaterial Mode Input Commands\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, <tt>maxvol</tt>,or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.
	* <tt>contactnormal</tt> - The unit normal used in contact calculations done by any [[Multimaterial MPM#Multimaterial Mode Input Commands\|normals method]]. The normal vectors can be [[#Visualizing Vector Quantities\|visualized in software]].		* <tt>contactnormal</tt> - The unit normal used in contact calculations done by any [[Multimaterial MPM#Multimaterial Mode Input Commands\|normals method]]. The normal vectors can be [[#Visualizing Vector Quantities\|visualized in software]].
	* <tt>numpoints</tt> - The number of material points that extrapolate to a node.		* <tt>numpoints</tt> - The number of material points that extrapolate to a node.

Nairnj: /* Archivable Quantities */

2026-02-09T04:20:04Z

Archivable Quantities

← Older revision		Revision as of 04:20, 9 February 2026
Line 68:		Line 68:
	* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.		* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.
	* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).		* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).
	* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.		* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM#Multimaterial Mode Input Commands\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.
	* <tt>contactnormal</tt> - The unit normal used in contact calculations done by an [[Multimaterial MPM\|normals method]]. The normal vectors can be [[#Visualizing Vector Quantities\|visualized in software]].		* <tt>contactnormal</tt> - The unit normal used in contact calculations done by any [[Multimaterial MPM#Multimaterial Mode Input Commands\|normals method]]. The normal vectors can be [[#Visualizing Vector Quantities\|visualized in software]].
	* <tt>numpoints</tt> - The number of material points that extrapolate to a node.		* <tt>numpoints</tt> - The number of material points that extrapolate to a node.

Nairnj: /* Archivable Quantities */

2026-02-09T03:59:49Z

Archivable Quantities

← Older revision		Revision as of 03:59, 9 February 2026
Line 69:		Line 69:
	* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).		* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).
	* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.		* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.
			* <tt>contactnormal</tt> - The unit normal used in contact calculations done by an [[Multimaterial MPM\|normals method]]. The normal vectors can be [[#Visualizing Vector Quantities\|visualized in software]].
	* <tt>numpoints</tt> - The number of material points that extrapolate to a node.		* <tt>numpoints</tt> - The number of material points that extrapolate to a node.

Nairnj: /* Archivable Quantities */

2026-02-09T03:53:28Z

Archivable Quantities

← Older revision		Revision as of 03:53, 9 February 2026
Line 68:		Line 68:
	* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.		* <tt>history,(num)</tt> - Archive history number <tt>(num)</tt> enter as the Parameter's <tt>(extra)</tt> value.
	* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).		* <tt>contactforce</tt> - Archive nodal force on the grid for [[Multimaterial MPM\|multimaterial mode]] simulations when they include [[Rigid Material\|rigid materials]] that have <tt>direction=8</tt>. It is vector of force for the rigid material on the object (in [[ConsistentUnits Command#Legacy and Consistent Units\|force units]]).
	* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in contact calculations. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.		* <tt>volumegradient,(mat)</tt> - The volume gradient for material <tt>(mat)</tt> on the nodes entered as the Parameter's <tt>(extra)</tt> value. This gradient is the one used in [[Multimaterial MPM\|contact calculations]] done by <tt>avggrad</tt>, <tt>maxgrad</tt>, or <tt>owngrad</tt>. The gradient vectors can be [[#Visualizing Vector Quantities\|visualized in software]]. The <tt>(mat)</tt> is required and specified by [[Material Command Block\|material ID]] in scripted input files, but must be by [[Material Command Block#Referencing Materials in XML Files\|material number]] in <tt>XML</tt> input files. When cracks are present, the archives gradient is for material field on same side of the crack as the node.
	* <tt>numpoints</tt> - The number of material points that extrapolate to a node.		* <tt>numpoints</tt> - The number of material points that extrapolate to a node.

Nairnj: /* Visualizing Vector Quantities */

2026-02-08T21:04:59Z

Visualizing Vector Quantities

← Older revision		Revision as of 21:04, 8 February 2026
Line 82:		Line 82:
	# Click "Glyph" icon to add Glyph option to the pipe line, set its properties (clicking apply after each property change). The key properties are:		# Click "Glyph" icon to add Glyph option to the pipe line, set its properties (clicking apply after each property change). The key properties are:
	#* Vectors: select the vector quantity you want to plot from "Orientation"		#* Vectors: select the vector quantity you want to plot from "Orientation"
	#* Scaling: set to scale by the vector magnitude and pick scaling factor (~~1 appears~~ good).		#* Scaling: set to scale by the vector magnitude and pick scaling factor (a good number is to keep longest vector on order of the cell size).
	#* Masking: select "All Points" (otherwise only selected arrows will get plotted)		#* Masking: select "All Points" (otherwise only selected arrows will get plotted)
	#* Coloring: decide how to color the arrows (and edit coloring scheme if needed)		#* Coloring: decide how to color the arrows (and edit coloring scheme if needed)
	For contact normals or volume gradients (if used) to work well with contact calculations, they should be vectors normal to the expected contact surfaces. If plotting volume gradients, they should point out of the material.		For contact normals or volume gradients (if used) to work well with contact calculations, they should be vectors normal to the expected contact surfaces. If plotting volume gradients, they should point out of the material.

Nairnj: /* Visualizing Vector Quantities */

2026-02-08T20:51:41Z

Visualizing Vector Quantities

← Older revision		Revision as of 20:51, 8 February 2026
Line 77:		Line 77:
	==== Visualizing Vector Quantities ====		==== Visualizing Vector Quantities ====

	If you save vector results, such as volume gradient for some materials, you can visualize them as vectors in [[ParaView]] by using arrow glyphs. The basic process is:		If you save vector results, such as volume gradient for some materials or contact normals, you can visualize them as vectors in [[ParaView]] by using arrow glyphs. The basic process is:
	# Open the stack of <tt>vtk</tt> files saved by this custom tasks in ParaView and click apply.		# Open the stack of <tt>vtk</tt> files saved by this custom tasks in ParaView and click apply.
	# To see the grid, "Solid Color" and "Wireframe" (being sure to click apply when needed).		# To see the grid, "Solid Color" and "Wireframe" (being sure to click apply when needed).
Line 85:		Line 85:
	#* Masking: select "All Points" (otherwise only selected arrows will get plotted)		#* Masking: select "All Points" (otherwise only selected arrows will get plotted)
	#* Coloring: decide how to color the arrows (and edit coloring scheme if needed)		#* Coloring: decide how to color the arrows (and edit coloring scheme if needed)
	For volume gradients to work well with contact calculations, they should be vectors normal to the ~~surface of any materials and pointing~~ out of the material.		For contact normals or volume gradients (if used) to work well with contact calculations, they should be vectors normal to the expected contact surfaces. If plotting volume gradients, they should point out of the material.

Nairnj: /* Visualizing Vector Quantities */

2026-02-08T20:49:41Z

Visualizing Vector Quantities

← Older revision		Revision as of 20:49, 8 February 2026
Line 81:		Line 81:
	# To see the grid, "Solid Color" and "Wireframe" (being sure to click apply when needed).		# To see the grid, "Solid Color" and "Wireframe" (being sure to click apply when needed).
	# Click "Glyph" icon to add Glyph option to the pipe line, set its properties (clicking apply after each property change). The key properties are:		# Click "Glyph" icon to add Glyph option to the pipe line, set its properties (clicking apply after each property change). The key properties are:
	#* Vectors: select the ~~volume gradient~~ to plot ~~(by material number)~~		#* Vectors: select the vector quantity you want to plot from "Orientation"
	#* Scaling: set scale ~~mode to "~~vector" and ~~adjust "scale~~ factor~~" for good size arrows~~ (1 appears good).		#* Scaling: set to scale by the vector magnitude and pick scaling factor (1 appears good).
	~~#* Coloring: decide how to color the arrows~~
	#* Masking: select "All Points" (otherwise only selected arrows will get plotted)		#* Masking: select "All Points" (otherwise only selected arrows will get plotted)
			#* Coloring: decide how to color the arrows (and edit coloring scheme if needed)
	For volume gradients to work well with contact calculations, they should be vectors normal to the surface of any materials and pointing out of the material.		For volume gradients to work well with contact calculations, they should be vectors normal to the surface of any materials and pointing out of the material.

Nairnj: /* Archivable Quantities */

2023-11-14T22:49:51Z

Archivable Quantities

← Older revision		Revision as of 22:49, 14 November 2023
Line 44:		Line 44:
	<Parameter name="history:Equivalent Plastic Strain">1</Parameter>		<Parameter name="history:Equivalent Plastic Strain">1</Parameter>

	Third party software will display using ~~that~~ name instead of the [[NairnMPM]] quantity name (~~this~~ option is most useful when archiving history data). Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.		Third party software will display using the provided name (such as "Equivalent Plastic Strain") instead of the [[NairnMPM]] quantity name (such as "history 1"). This option is most useful when archiving history data. Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.

	The currently available <tt>(quantity)</tt> options for VTK archiving are:		The currently available <tt>(quantity)</tt> options for VTK archiving are:

Nairnj: /* Archivable Quantities */

2023-11-14T22:47:54Z

Archivable Quantities

← Older revision		Revision as of 22:47, 14 November 2023
Line 36:		Line 36:
	=== Archivable Quantities ===		=== Archivable Quantities ===

	All remaining parameters define a calculation value (by name in <tt>(quantity)</tt>) to be archived. A few quantities need an <tt>(extra)</tt> value to be complete. You can specify any number of quantities to include as many results as you want in the output VTK files. Each one can be entered with just the quantity name or can be enter in the format "quantity:Name in VTK File" where "quantity" before the colon is an item listed below and "Name in the VTK File" after the colon is the name written to the VTK file. For example, if history ~~one~~ is tracking equivalent plastic strains, one could ~~add~~		All remaining parameters define a calculation value (by name in <tt>(quantity)</tt>) to be archived. A few quantities need an <tt>(extra)</tt> value to be complete. You can specify any number of quantities to include as many results as you want in the output VTK files. Each one can be entered with just the quantity name or can be enter in the format "quantity:Name in VTK File" where "quantity" before the colon is an item listed below and "Name in the VTK File" after the colon is the name written to the VTK file. For example, if history number 1 is tracking equivalent plastic strains, one could use script command:

	Parameter "history:Equivalent Plastic Strain",1		Parameter "history:Equivalent Plastic Strain",1

			or XML command

			<Parameter name="history:Equivalent Plastic Strain">1</Parameter>

	Third party software will display using that name instead of the [[NairnMPM]] quantity name (this option is most useful when archiving history data). Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.		Third party software will display using that name instead of the [[NairnMPM]] quantity name (this option is most useful when archiving history data). Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.

Nairnj: /* Archivable Quantities */

2023-11-14T22:46:19Z

Archivable Quantities

← Older revision		Revision as of 22:46, 14 November 2023
Line 36:		Line 36:
	=== Archivable Quantities ===		=== Archivable Quantities ===

	All remaining parameters define a calculation value (by name in <tt>(quantity)</tt>) to be archived. A few quantities need an <tt>(extra)</tt> value to be complete. You can specify any number of quantities to include as many results as you want in the output VTK files. Each one can be entered with just the quantity name or can be enter in the format "quantity:Name in VTK File" where "quantity" before the colon is an item listed below and "Name in the VTK File" after the colon is the name written to the VTK file. Third party software will display using that name instead of the [[NairnMPM]] quantity name (this option is most useful when archiving history data). Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.		All remaining parameters define a calculation value (by name in <tt>(quantity)</tt>) to be archived. A few quantities need an <tt>(extra)</tt> value to be complete. You can specify any number of quantities to include as many results as you want in the output VTK files. Each one can be entered with just the quantity name or can be enter in the format "quantity:Name in VTK File" where "quantity" before the colon is an item listed below and "Name in the VTK File" after the colon is the name written to the VTK file. For example, if history one is tracking equivalent plastic strains, one could add

			Parameter "history:Equivalent Plastic Strain",1

			Third party software will display using that name instead of the [[NairnMPM]] quantity name (this option is most useful when archiving history data). Note the such names in VTK files cannot have spaces. If you use spaces in a name, the spaces will be replaced by underscores.

	The currently available <tt>(quantity)</tt> options for VTK archiving are:		The currently available <tt>(quantity)</tt> options for VTK archiving are: