ExtractMPM - Revision history

Nairnj: /* Using Extract MPM */

2023-02-02T21:44:55Z

Using Extract MPM

← Older revision		Revision as of 21:44, 2 February 2023
Line 32:		Line 32:
	ExtractMPM [-hdDfFTXVsHPC] [-m num] [-M num] [-q data] [-n text] [-o path] archive0 archive1 ...		ExtractMPM [-hdDfFTXVsHPC] [-m num] [-M num] [-q data] [-n text] [-o path] archive0 archive1 ...

	ExtractMPM reads the [[NairnMPM]] binary archive files in <tt>archive0</tt>, <tt>archive1</tt>, <i>etc.</i>, extracts the data selected by the options, and outputs it all to standard output or to file(s) specified in the options.The flags and their descriptions, ~~group~~ by subject, are:		ExtractMPM reads the [[NairnMPM]] binary archive files in <tt>archive0</tt>, <tt>archive1</tt>, <i>etc.</i>, extracts the data selected by the options, and outputs it all to standard output or to file(s) specified in the options. The flags and their descriptions, grouped by subject, are:

	=== Exported Data ===		=== Exported Data ===

Nairnj: /* Using Extract MPM */

2023-02-02T21:44:12Z

Using Extract MPM

← Older revision		Revision as of 21:44, 2 February 2023
Line 28:		Line 28:
	== Using Extract MPM ==		== Using Extract MPM ==

	ExtractMPM is most conveniently run by using the "Export Particle VTKs" options in [[NairnFEAMPM]] or in [[NairnFEAMPMViz]]. ~~Alternative~~, you can run the ExtractMPM directly on a command line with		ExtractMPM is most conveniently run by using the "Export Particle VTKs" options in [[NairnFEAMPM]] or in [[NairnFEAMPMViz]]. The help information in those applications gives more details. Alternatively, you can run the ExtractMPM directly on a command line with

	ExtractMPM [-hdDfFTXVsHPC] [-m num] [-M num] [-q data] [-n text] [-o path] archive0 archive1 ...		ExtractMPM [-hdDfFTXVsHPC] [-m num] [-M num] [-q data] [-n text] [-o path] archive0 archive1 ...

Nairnj: /* Exported File Format */

2023-01-26T21:26:08Z

Exported File Format

← Older revision		Revision as of 21:26, 26 January 2023
Line 137:		Line 137:
	<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are:		<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are:
	<ol>		<ol>
	<li>You cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle (see )</li>		<li>You cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle (see [[MPM Archiving Options]])</li>
	<li>The files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster.</li>		<li>The files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster.</li>
	</ol>		</ol>

Nairnj: /* Exported File Format */

2023-01-26T21:24:40Z

Exported File Format

← Older revision		Revision as of 21:24, 26 January 2023
Line 135:		Line 135:

	<dt><b>-U</b></dt>		<dt><b>-U</b></dt>
	<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are ~~1. you~~ cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle~~; 2. the~~ files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster. This option can be used for crack data, but is equivalent to a crack export using <b>-V</b> (extension <tt>.vtk</tt>). (Since version 2).</dd>		<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are:
			<ol>
			<li>You cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle (see )</li>
			<li>The files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster.</li>
			</ol>
			This option can be used for crack data too, but is equivalent to a crack export using <b>-V</b> (extension <tt>.vtk</tt>). (Since version 2).</dd>

	<dt><b>-X</b></dt>		<dt><b>-X</b></dt>

Nairnj: /* Exported Data */

2022-02-19T18:59:24Z

Exported Data

← Older revision		Revision as of 18:59, 19 February 2022
Line 56:		Line 56:
	<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>		<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>
	<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.		<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.
	<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. <tt>u.σ.v</tt>, where <tt>u</tt> and <tt>v</tt> is two of these unit vectors gives normal stress (when <tt>u=v</tt> or shear stress when <tt>u≠v</tt>) in a material coordinates (since version 2).		<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. <tt>u.σ.v</tt>, where <tt>u</tt> and <tt>v</tt> is two of these unit vectors gives normal stress (when <tt>u=v</tt> or shear stress when <tt>u≠v</tt>) in material coordinates (since version 2).
	<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).		<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).
	<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>		<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>

Nairnj: /* Exported Data */

2022-02-19T18:58:55Z

Exported Data

← Older revision		Revision as of 18:58, 19 February 2022
Line 56:		Line 56:
	<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>		<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>
	<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.		<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.
	<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. <tt>u.σ.u</tt>, where <tt>u</tt> is ~~one~~ of ~~therse~~ unit vectors ~~give~~ normal stress in a material ~~direction~~ (since version 2).		<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. <tt>u.σ.v</tt>, where <tt>u</tt> and <tt>v</tt> is two of these unit vectors gives normal stress (when <tt>u=v</tt> or shear stress when <tt>u≠v</tt>) in a material coordinates (since version 2).
	<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).		<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).
	<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>		<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>

Nairnj: /* Exported Data */

2022-02-19T18:55:59Z

Exported Data

← Older revision		Revision as of 18:55, 19 February 2022
Line 56:		Line 56:
	<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>		<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>
	<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.		<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.
	<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. (since version 2).		<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. <tt>u.σ.u</tt>, where <tt>u</tt> is one of therse unit vectors give normal stress in a material direction (since version 2).
	<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).		<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).
	<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>		<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>

Nairnj: /* Exported Data */

2022-02-19T18:53:20Z

Exported Data

← Older revision		Revision as of 18:53, 19 February 2022
Line 55:		Line 55:
	<li><tt>pexx</tt>, <tt>peyy</tt>, <tt>pezz</tt>, <tt>pexy</tt>, <tt>pexz</tt>, and <tt>peyz</tt> for a component of the plastic strain tensor (absolute)</li>		<li><tt>pexx</tt>, <tt>peyy</tt>, <tt>pezz</tt>, <tt>pexy</tt>, <tt>pexz</tt>, and <tt>peyz</tt> for a component of the plastic strain tensor (absolute)</li>
	<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>		<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>
	<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are are mostly ~~useful~~ to confirm you set orientation of anisotropic materials correctly.		<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are thereore are mostly used to confirm you set orientation of anisotropic materials correctly.
	<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. (since version 2).		<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. (since version 2).
	<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).		<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).

Nairnj: /* Exported Data */

2022-02-19T01:39:06Z

Exported Data

← Older revision		Revision as of 01:39, 19 February 2022
Line 55:		Line 55:
	<li><tt>pexx</tt>, <tt>peyy</tt>, <tt>pezz</tt>, <tt>pexy</tt>, <tt>pexz</tt>, and <tt>peyz</tt> for a component of the plastic strain tensor (absolute)</li>		<li><tt>pexx</tt>, <tt>peyy</tt>, <tt>pezz</tt>, <tt>pexy</tt>, <tt>pexz</tt>, and <tt>peyz</tt> for a component of the plastic strain tensor (absolute)</li>
	<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>		<li><tt>plasticstrain</tt> for all 6 components of the plastic strain tensor. For VTK files, they will be output as a tensor quantity with 9 elements of the plastic strain tensor (absolute). But note that not all materials store plastic strain the archive files. For example, [[Material_Models#Hyperelastic-Plastic_Materials\|Hyperelastic-Plastic_Materials]] store the elastic, left-Cauchy green strain. This quantity will extract the values stored in the archive.</li>
	<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for rotation angles (in degrees) ~~from~~ material axes ~~to current~~ configuration (R = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub> ~~or use transpose to rotate from current configuration to material axes~~; only R<~~sub~~>z</~~sub~~> available for 2D results).		<li><tt>angz</tt>, <tt>angy</tt>, <tt>angx</tt> for initial rotation angles (in degrees) between material axes and initial configuration (R<sub>0</sub> = R<sub>z</sub>R<sub>y</sub>R<sub>x</sub>); only <tt>angz</tt> is available for 2D results. These values never change are are mostly useful to confirm you set orientation of anisotropic materials correctly.
	<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the material x, y, or z axes, which may rotate during a simulations (material axes ~~for isotropic materials~~ start aligned with the grid). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too) (since version 2).		<li><tt>xmat</tt>, <tt>ymat</tt>, <tt>zmat</tt> for unit vectors in the current material x, y, or z axes, which may rotate during a simulations (material axes start aligned with the grid unless rotated when creating the material points). Plotting glyphs oriented by these vectors can be used to visualization material directions in [[ParaView]] (and sometimes helps other visualizations too). Dot products of these vectors with global axes gives current material angle to that direction. (since version 2).
	<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).		<li><tt>meansize</tt> to output mean size of particles. Scaling plot features by this size (such as glyphs in [[ParaView]]) can better represent the size of material points in the graphics (since version 2).
	<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>		<li><tt>equivstrain</tt> for equivalent strain (= sqrt(2/3)\|'''s'''\| where '''s''' is deviatoric strain tensor from elastic strain only) (absolute)</li>

Nairnj: /* Exported File Format */

2022-02-18T18:03:50Z

Exported File Format

← Older revision		Revision as of 18:03, 18 February 2022
Line 135:		Line 135:

	<dt><b>-U</b></dt>		<dt><b>-U</b></dt>
	<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are 1. you cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle; 2. the files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster. This option can be used for crack data, but is equivalent to a crack export using <b>-V</b> (extension <tt>.vtk</tt>) (~~since~~ version 2).</dd>		<dd>This option is identical to <tt>-V</tt> except will export particle data as an UNSTRUCTURED_GRID style VTK file. Each material point will be a cell in the VTK data and the cell will be deformed to match the current deformation of that particle. This type of file improves quality of the visualization. The two drawbacks are 1. you cannot use this option unless the simulation archived both strain and size, which are needed to deform the particle; 2. the files are much larger, but it appears visualization features in [[ParaView]] and [[VisIt]] are somewhat faster. This option can be used for crack data, but is equivalent to a crack export using <b>-V</b> (extension <tt>.vtk</tt>). (Since version 2).</dd>

	<dt><b>-X</b></dt>		<dt><b>-X</b></dt>