Archive File Formats - Revision history

Nairnj: /* Record Size */

2023-01-26T21:53:17Z

Record Size

← Older revision		Revision as of 21:53, 26 January 2023
Line 109:		Line 109:
	<li>Byte 23: 8 for 'Y', but 0, 8, 16, 24, 32, or 40 (for other settings)</li></li>		<li>Byte 23: 8 for 'Y', but 0, 8, 16, 24, 32, or 40 (for other settings)</li></li>
	<li>Byte 24: 8 for 'Y', but 0, 8, 16, 24, 32, or 40 (for other settings)</li></li>		<li>Byte 24: 8 for 'Y', but 0, 8, 16, 24, 32, or 40 (for other settings)</li></li>
			<li>Byte 25: 16 for 2D, 24 for 3D</li>
	</ul>		</ul>

Nairnj: /* Rotational Strains and Deformation Gradient */

2022-02-19T18:51:05Z

Rotational Strains and Deformation Gradient

← Older revision		Revision as of 18:51, 19 February 2022
Line 368:		Line 368:
	* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).		* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).
	* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]]. 2D simulations have only <tt>anglez</tt>. They are archived in degrees.		* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]]. 2D simulations have only <tt>anglez</tt>. They are archived in degrees.
	* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are define a rotation matrix, <tt>R<sub>0</sub> = R<sub>z</sub>(~~anglez~~)R<sub>y</sub>(~~angley~~)R<sub>x</sub>(~~anglex~~)</tt>, to rotate initial material axes into the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.		* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are define a rotation matrix, <tt>R<sub>0</sub> = R<sub>z</sub>(anglez0)R<sub>y</sub>(angley0)R<sub>x</sub>(anglex0)</tt>, to rotate initial material axes into the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.

	To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = π(anglez0-anglez)/90</tt>, <tt>ω<sub>xz</sub> = -π(angley0-angley)/90</tt>, and <tt>ω<sub>yz</sub> = π*(anglex0-anglex)/90</tt>. The deformation gradient is then:		To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = π(anglez0-anglez)/90</tt>, <tt>ω<sub>xz</sub> = -π(angley0-angley)/90</tt>, and <tt>ω<sub>yz</sub> = π*(anglex0-anglex)/90</tt>. The deformation gradient is then:

Nairnj: /* Material Points Archive Format */

2022-02-19T18:44:29Z

Material Points Archive Format

← Older revision		Revision as of 18:44, 19 February 2022
Line 231:		Line 231:
	<dd>Setting <tt>Y</tt> stores total work energy or cumulative σ.dε:		<dd>Setting <tt>Y</tt> stores total work energy or cumulative σ.dε:
	<pre>		<pre>
	double workEnergy - cumulative work energy (energy ~~units, but J in Legacy~~ units)		double workEnergy - cumulative work energy (alt energy units)
	</pre>		</pre>

Line 243:		Line 243:
	<dd>Setting <tt>Y</tt> stores particle plastic energy:		<dd>Setting <tt>Y</tt> stores particle plastic energy:
	<pre>		<pre>
	double plastEnergy - cumulative plastic energy (energy ~~units, but J in Legacy~~ units)		double plastEnergy - cumulative plastic energy (alt energy units)
	</pre>		</pre>

Line 259:		Line 259:
	<dd>Setting <tt>Y</tt> stores particle strain energy:		<dd>Setting <tt>Y</tt> stores particle strain energy:
	<pre>		<pre>
	double strainEnergy - cumulative strain energy (energy ~~units, but J in Legacy~~ units)		double strainEnergy - cumulative strain energy (alt energy units)
	</pre>		</pre>

Line 283:		Line 283:
	<dd>Setting <tt>Y</tt> stores cumulative heat energy:		<dd>Setting <tt>Y</tt> stores cumulative heat energy:
	<pre>		<pre>
	double heatEnergy - cumulative heat energy (energy ~~units, but J in Legacy~~ units)		double heatEnergy - cumulative heat energy (alt energy units)
	</pre>		</pre>

Nairnj: /* Rotational Strains and Deformation Gradient */

2022-02-19T18:42:00Z

Rotational Strains and Deformation Gradient

← Older revision		Revision as of 18:42, 19 February 2022
Line 370:		Line 370:
	* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are define a rotation matrix, <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt>, to rotate initial material axes into the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.		* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are define a rotation matrix, <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt>, to rotate initial material axes into the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.

	To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = -π(anglez~~-anglez0~~)/90</tt>, <tt>ω<sub>xz</sub> = π(angley~~-angley0~~)/90</tt>, and <tt>ω<sub>yz</sub> = -π*(anglex~~-anglex0~~)/90</tt>. The deformation gradient is then:		To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = π(anglez0-anglez)/90</tt>, <tt>ω<sub>xz</sub> = -π(angley0-angley)/90</tt>, and <tt>ω<sub>yz</sub> = π*(anglex0-anglex)/90</tt>. The deformation gradient is then:
	<pre>		<pre>
	\| 1 + εxx 0.5(γxy-ωxy) 0.5(γxz-ωxz) \|		\| 1 + εxx 0.5(γxy-ωxy) 0.5(γxz-ωxz) \|

Nairnj: /* Rotational Strains and Deformation Gradient */

2022-02-19T18:38:43Z

Rotational Strains and Deformation Gradient

← Older revision		Revision as of 18:38, 19 February 2022
Line 368:		Line 368:
	* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).		* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).
	* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]]. 2D simulations have only <tt>anglez</tt>. They are archived in degrees.		* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]]. 2D simulations have only <tt>anglez</tt>. They are archived in degrees.
	* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are ~~always~~ <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt> to ~~define the~~ initial ~~orientation of~~ material axes ~~relative to~~ the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.		* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are define a rotation matrix, <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt>, to rotate initial material axes into the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.

	To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = -π(anglez-anglez0)/90</tt>, <tt>ω<sub>xz</sub> = π(angley-angley0)/90</tt>, and <tt>ω<sub>yz</sub> = -π*(anglex-anglex0)/90</tt>. The deformation gradient is then:		To get the deformation gradient, first calculate engineering rotation strains using <tt>ω<sub>xy</sub> = -π(anglez-anglez0)/90</tt>, <tt>ω<sub>xz</sub> = π(angley-angley0)/90</tt>, and <tt>ω<sub>yz</sub> = -π*(anglex-anglex0)/90</tt>. The deformation gradient is then:

Nairnj: /* Rotational Strains and Deformation Gradient */

2022-02-19T18:36:59Z

Rotational Strains and Deformation Gradient

← Older revision		Revision as of 18:36, 19 February 2022
Line 367:		Line 367:

	* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).		* Particle strains - these strain are archived as absolute strains, but shear strains are engineering shear strains (''i.e.'', twice the tensorial shear strains).
	* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]] 2D simulations have only <tt>anglez</tt>. They are archived in degrees.		* <tt>anglex</tt>, <tt>angley</tt>, and <tt>anglez</tt> - these angles are always saved in the [[#Material Points Archive Format\|default properties]]. 2D simulations have only <tt>anglez</tt>. They are archived in degrees.
	* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are always <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt> to define the initial orientation of material axes relative to the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.		* <tt>anglex0</tt>, <tt>angley0</tt>, and <tt>anglez0</tt> - these angles stored as "Rotational Strains" and they are always <tt>R<sub>0</sub> = R<sub>z</sub>(anglez)R<sub>y</sub>(angley)R<sub>x</sub>(anglex)</tt> to define the initial orientation of material axes relative to the global x-y-z axis system. These are only non-zero when you set material point angles and are only needed for anisotropic materials. 2D simulations have only <tt>anglez0</tt>. They are archived in degrees.

Nairnj: /* Material Points Archive Format */

2022-02-19T18:36:02Z

Material Points Archive Format

← Older revision		Revision as of 18:36, 19 February 2022
Line 299:		Line 299:
	double anglex0 - initial material angle x (degrees) (3D Only)		double anglex0 - initial material angle x (degrees) (3D Only)
	</pre>		</pre>
	~~The engineering rotational strains are <tt>ω<sub>xy</sub> =~~ -~~π(anglez-anglez0)/90</tt>, <tt>ω<sub>xz</sub> = π(angley-angley0)/90</tt>,~~ and ~~<tt>ω<sub>yz</sub> = -π*(anglex-anglex0)/90</tt>, which are twice the tensorial rotational strains. Combining with~~ strains ~~give the~~ [[deformation gradient]].		These can be combined with small-strain material angle and strains to find [[#Rotational Strains and Deformation Gradient\|rotational strains and deformation gradient]]. These strains are now automatically archived whenever you archive strains..

	<dt>Byte 19: Normal vector for damage mechanics		<dt>Byte 19: Normal vector for damage mechanics

Nairnj: /* Material Points Archive Format */

2022-02-19T18:33:19Z

Material Points Archive Format

← Older revision		Revision as of 18:33, 19 February 2022
Line 209:		Line 209:
	double strainyy - y direction normal strain (dimensionless)		double strainyy - y direction normal strain (dimensionless)
	double strainzz - z direction normal strain (dimensionless)		double strainzz - z direction normal strain (dimensionless)
	double strainxy - x-y plane shear strain (dimensionless)		double strainxy - x-y engineering plane shear strain (dimensionless)
	double strainxz - x-z plane shear strain (dimensionless) (3D only)		double strainxz - x-z engineering plane shear strain (dimensionless) (3D only)
	double strainyz - y-z plane shear strain (dimensionless) (3D only)		double strainyz - y-z engineering plane shear strain (dimensionless) (3D only)
	</pre>		</pre>

Line 220:		Line 220:
	double plstrainyy - y direction plastic normal strain (dimensionless)		double plstrainyy - y direction plastic normal strain (dimensionless)
	double plstrainzz - z direction plastic normal strain (dimensionless)		double plstrainzz - z direction plastic normal strain (dimensionless)
	double plstrainxy - x-y plane plastic shear strain (dimensionless)		double plstrainxy - x-y engineering plane plastic shear strain (dimensionless)
	double plstrainxz - x-z plane plastic shear strain (dimensionless) (3D only)		double plstrainxz - x-z engineering plane plastic shear strain (dimensionless) (3D only)
	double plstrainyz - y-z plane plastic shear strain (dimensionless) (3D only)		double plstrainyz - y-z engineering plane plastic shear strain (dimensionless) (3D only)
	</pre>		</pre>

Line 231:		Line 231:
	<dd>Setting <tt>Y</tt> stores total work energy or cumulative σ.dε:		<dd>Setting <tt>Y</tt> stores total work energy or cumulative σ.dε:
	<pre>		<pre>
	double workEnergy - cumulative work energy (J)		double workEnergy - cumulative work energy (energy units, but J in Legacy units)
	</pre>		</pre>

Line 243:		Line 243:
	<dd>Setting <tt>Y</tt> stores particle plastic energy:		<dd>Setting <tt>Y</tt> stores particle plastic energy:
	<pre>		<pre>
	double plastEnergy - cumulative plastic energy (J)		double plastEnergy - cumulative plastic energy (energy units, but J in Legacy units)
	</pre>		</pre>

Line 259:		Line 259:
	<dd>Setting <tt>Y</tt> stores particle strain energy:		<dd>Setting <tt>Y</tt> stores particle strain energy:
	<pre>		<pre>
	double strainEnergy - cumulative strain energy (J)		double strainEnergy - cumulative strain energy (energy units, but J in Legacy units)
	</pre>		</pre>

Line 283:		Line 283:
	<dd>Setting <tt>Y</tt> stores cumulative heat energy:		<dd>Setting <tt>Y</tt> stores cumulative heat energy:
	<pre>		<pre>
	double heatEnergy - cumulative heat energy (J)		double heatEnergy - cumulative heat energy (energy units, but J in Legacy units)
	</pre>		</pre>

Line 293:		Line 293:

	<dt>Byte 18: Rotational strain		<dt>Byte 18: Rotational strain
	<dd>Setting <tt>Y</tt> stores <i>initial</i> material angle(s)~~. The evolving angles are always stored in the material angle properties~~:		<dd>Setting <tt>Y</tt> stores <i>initial</i> material angle(s):
	<pre>		<pre>
	double anglez0 - initial material angle z (degrees)		double anglez0 - initial material angle z (degrees)
Line 299:		Line 299:
	double anglex0 - initial material angle x (degrees) (3D Only)		double anglex0 - initial material angle x (degrees) (3D Only)
	</pre>		</pre>
	The rotational ~~engineering~~ strains are <tt>ω<sub>xy</sub> = -π(anglez-anglez0)/90</tt>, <tt>ω<sub>xz</sub> = π(angley-angley0)/90</tt>, and <tt>ω<sub>yz</sub> = -π*(anglex-anglex0)/90</tt>, which are twice the tensorial rotational strains.		The engineering rotational strains are <tt>ω<sub>xy</sub> = -π(anglez-anglez0)/90</tt>, <tt>ω<sub>xz</sub> = π(angley-angley0)/90</tt>, and <tt>ω<sub>yz</sub> = -π*(anglex-anglex0)/90</tt>, which are twice the tensorial rotational strains. Combining with strains give the [[deformation gradient]].

	<dt>Byte 19: Normal vector for damage mechanics		<dt>Byte 19: Normal vector for damage mechanics

Nairnj: /* Material Points Archive Format */

2022-02-19T18:21:16Z

Material Points Archive Format

← Older revision		Revision as of 18:21, 19 February 2022
Line 170:		Line 170:
	short matnum - material number		short matnum - material number
	short unused - not used		short unused - not used
	double anglez - small-strain material angle (degrees) (for rotational strain and deformation gradient~~</a>~~)		double anglez - small-strain material angle (degrees) (for rotational strain and deformation gradient)
	2D any version or 3D in ver5 or older has:		2D any version or 3D in ver5 or older has:
	double thickness - thickness (length units) (or 0 in 3D)		double thickness - thickness (length units) (or 0 in 3D)

Nairnj: /* Material Points Archive Format */

2022-02-19T18:20:58Z

Material Points Archive Format

← Older revision		Revision as of 18:20, 19 February 2022
Line 158:		Line 158:

	<p>		<p>
	The following items may be archived for each material point. This section lists the quantity that is archived and its units in the archive file. The data appear in each record in the following order, but each item only appears if the archive setting for that byte is <tt>Y</tt>.		The following items may be archived for each material point. This section lists the quantity that is archived and its units in the archive file. The data appear in each record in the following order, but each item only appears if the archive setting for that byte is <tt>Y</tt>. Refer to [[ConsistentUnits Command#Legacy and Consistent Units\|units table]] for details an any units.
	</p>		</p>

Line 170:		Line 170:
	short matnum - material number		short matnum - material number
	short unused - not used		short unused - not used
	double anglez - small-strain material angle (degrees) (for ~~<a href="#Rotational Strains and Deformation Gradient">~~rotational strain and deformation gradient</a>)		double anglez - small-strain material angle (degrees) (for rotational strain and deformation gradient</a>)
	2D any version or 3D in ver5 or older has:		2D any version or 3D in ver5 or older has:
	double thickness - thickness (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]]) (or 0 in 3D)		double thickness - thickness (length units) (or 0 in 3D)
	3D in ver6 or newer replaces thickness with two more angles:		3D in ver6 or newer replaces thickness with two more angles:
	double angley - small-strain material angle (degrees) (for ~~[[#Rotational Strains and Deformation Gradient\|~~rotational strain and deformation gradient]])		double angley - small-strain material angle (degrees) (for rotational strain and deformation gradient)
	double anglex - small-strain material angle (degrees) (for ~~[[#Rotational Strains and Deformation Gradient\|~~rotational strain and deformation gradient]])		double anglex - small-strain material angle (degrees) (for rotational strain and deformation gradient)
	double x - current x position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]])		double x - current x position (length units)
	double y - current y position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]])		double y - current y position (length units)
	double z - current z position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]]) (3D only)		double z - current z position (length units) (3D only)
	double origx - original x position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]])		double origx - original x position (length units)
	double origy - original y position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]])		double origy - original y position (length units)
	double origy - original z position (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~length units]]) (3D only)		double origy - original z position (length units) (3D only)
	</pre>		</pre>

Line 187:		Line 187:
	<dd>Setting <tt>Y</tt> stores components of particle velocity:		<dd>Setting <tt>Y</tt> stores components of particle velocity:
	<pre>		<pre>
	double velx - x direction velocity (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~velocity units]])		double velx - x direction velocity (velocity units)
	double vely - y direction velocity (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~velocity units]])		double vely - y direction velocity (velocity units)
	double vely - z direction velocity (~~[[ConsistentUnits Command#Legacy and Consistent Units\|~~velocity units]]) (3D only)		double vely - z direction velocity (velocity units) (3D only)
	</pre>		</pre>

Line 195:		Line 195:
	<dd>Setting <tt>Y</tt> stores components of particle stress:		<dd>Setting <tt>Y</tt> stores components of particle stress:
	<pre>		<pre>
	double stressxx - x direction normal stress (Pa)		double stressxx - x direction normal stress (pressure units)
	double stressyy - y direction normal stress (Pa)		double stressyy - y direction normal stress (pressure units)
	double stresszz - z direction normal stress (Pa)		double stresszz - z direction normal stress (pressure units)
	double stressxy - x-y plane shear stress (Pa)		double stressxy - x-y plane shear stress (pressure units)
	double stressxz - x-z plane shear stress (Pa) (3D only)		double stressxz - x-z plane shear stress (pressure units) (3D only)
	double stressyz - y-z plane shear stress (Pa) (3D only)		double stressyz - y-z plane shear stress (pressure units) (3D only)
	</pre>		</pre>