Difference between revisions of "Transversely Isotropic Viscoelastic Material"

From OSUPDOCS
Jump to navigation Jump to search
 
(48 intermediate revisions by the same user not shown)
Line 1: Line 1:
__TOC__
__TOC__
== Constitutive Law ==
== Constitutive Law ==
(This material is available only in [[OSParticulas]] because it is still in development)


This anisotropic [[Material Models|MPM material]] is a [[Material Models#Viscoelastic Materials|small strain, linear viscoelastic material]] that extends the [[Viscoelastic Material]] to model anisotropic viscoelasticity. The stress (σ) and strain (ε) are related by:
This anisotropic [[Material Models|MPM material]] is a [[Material Models#Viscoelastic Materials|small strain, linear viscoelastic material]] that extends the [[Viscoelastic Material]] to model anisotropic viscoelasticity. The stress (σ) and strain (ε) are related by:
Line 14: Line 12:
<math>\mathbf{C}(t) = \left[\begin{array}{cccccc}
<math>\mathbf{C}(t) = \left[\begin{array}{cccccc}
         K_T(t)+G_T(t) & K_T(t)-G_T(t) & \ell(t) & 0 & 0 & 0 \\
         K_T(t)+G_T(t) & K_T(t)-G_T(t) & \ell(t) & 0 & 0 & 0 \\
         K_T(t)-G_T(t) & K_T+G_T & \ell(t) & 0 & 0 & 0 \\
         K_T(t)-G_T(t) & K_T(t)+G_T(t) & \ell(t) & 0 & 0 & 0 \\
         \ell(t) & \ell(t)  & n(t) & 0 & 0 & 0 \\
         \ell(t) & \ell(t)  & n(t) & 0 & 0 & 0 \\
           0 & 0 & 0 & G_A(t) & 0 & 0 \\
           0 & 0 & 0 & G_A(t) & 0 & 0 \\
Line 21: Line 19:
         \end{array}\right]</math>
         \end{array}\right]</math>


Here <math>K_T(t)</math> is the plane strain, bulk modulus, <math>G_T(t)</math> is the transverse shear modulus, <math>G_A(t)</math> is the axial shear modulus, and <math>n(t)</math> and <math>\ell(t)</math> give time-dependence of the ''C<sub>33</sub>'' and ''C<sub>13</sub>=C<sub>23</sub>'' elements of the stiffness tensor (as [[Transversely Isotropic Material#Transverse 1|defined here]]). The time dependence of each property is modeled with a sum of exponentials:
Here <math>K_T(t)</math> is the plane strain, bulk modulus, <math>G_T(t)</math> is the transverse shear modulus, <math>G_A(t)</math> is the axial shear modulus, and <math>n(t)</math> and <math>\ell(t)</math> give time-dependence of the ''C<sub>33</sub>'' and ''C<sub>13</sub>=C<sub>23</sub>'' elements of the stiffness tensor (as [[Transversely Isotropic Material|defined here]]). The time dependence of each property is modeled with a sum of exponentials:


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>K_T(t) = K_{T0} + \sum_{k=1}^{N_{KT}} K_{Tk} e^{-t/\tau_{KT,k}}</math>
<math>K_T(t) = K_{T0} + \sum_{k=1}^{N_{KT}} K_{Tk} e^{-t/\tau_{KT,k}}
\qquad
G_T(t) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk} e^{-t/\tau_{GT,k}}
\qquad
G_A(t) = G_{A0} + \sum_{k=1}^{N_{GA}} G_{Ak} e^{-t/\tau_{GA,k}}</math>


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>G_T(t) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk} e^{-t/\tau_{GT,k}}</math>
<math>n(t) = n_0 + \sum_{k=1}^{N_n} n_k e^{-t/\tau_{n,k}}
\qquad\qquad
\ell(t) = \ell_0 + \sum_{k=1}^{N_\ell} \ell_k e^{-t/\tau_{\ell,k}}</math>


In terms of axial modulus <math>E_A</math>, and Poisson's ratio, <math>\nu_A</math>, we can write:
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>G_A(t) = G_{A0} + \sum_{k=1}^{N_{GA}} G_{Ak} e^{-t/\tau_{GA,k}}</math>


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>n(t) = n_0 + \sum_{k=1}^{N_n} n_k e^{-t/\tau_{n,k}}</math>
<math>n(t) = E_A(t) + 4K_T(t)\nu_A(t)^2
\qquad\qquad
\ell(t) = 4K_T(t)\nu_A(t)</math>
 
This material lumps all these time dependencies into <math>n(t)</math> and <math>\ell(t)</math>, but note that selection of those properties will determine time dependencies of <math>E_A(t)</math> and <math>\nu_A(t)</math>


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>\ell(t) = \ell_0 + \sum_{k=1}^{N_\ell} \ell_k e^{-t/\tau_{\ell,k}}</math>
<math>\nu_A(t) = {\ell(t)\over 2K_T(t)}
\qquad {\rm and} \qquad
E_A(t) = n(t) - \frac{\ell(t)^2}{K_T(t)}
</math>


=== TIViscoelastic 1 and 2 ===
=== Rotated Material Axes ===


TIViscoelastic 1 and TIViscoelastic 2 give identical materials but with different initial orientations. TIViscoelastic 1 has the unrotated axial direction along the z (or &theta; if axisymmetric) axis (see above tensors) while TIViscoelastic 2 has unrotated axial direction along the y (or Z if axisymmetric) axis (exchange y and z directions in above tensors). You can change the unrotated direction to any other orientation when defining material points by selecting rotation angles. For 2D analyses, the two options are needed to allo for axial direction in the x-y (or R-Z if axisymmetric) analysis plane (TIViscoelastic 2) or normal to that plane (TIViscoelastic 1). For 3D analyses, only TIViscoelastic 1 is allowed (and it in the only one needed).
The initial axial direction is along the ''z'' axis (or &theta; axis for axisymmetric calculations). The axial direction can be changed to any other direction using the same method used to orient [[Transversely Isotropic Material#Rotated Material Axes|transversely isotropic elastic material]] with the <tt>swapz</tt> material property.


=== Elastic Fiber Direction ===
=== Isotropic with Time-Dependent Bulk Modulus ===


Some materials, such as unidirectional composite materials or wood, can be modeled with the fiber direction as the axial direction. Because this direction is typically much stiffer than the isotropic plane direction, it might be expected to have little or no viscoelasticity compared to other directions. If one assumes that axial modulus (<math>E_A</math>) and Poisson's ratio (<math>\nu_A</math>) are independent of time, then <math>n(t)</math> and <math>\ell(t)</math> are determined by <math>K_T(t)</math> by setting:
The available [[Viscoelastic Material|isotropic viscoelastic]] material is limited to materials with time-independent bulk modulus because that is a good approximation for most isotropic, viscoelastic materials. These transversely-isotropic materials, however, do not place any restrictions on which properties are time dependent. As result, it can model an isotropic material with a time-dependent bulk modulus as a special case. Imagine an isotropic material with ''K(t)'' and ''G(t)'' as time-dependent bulk and shear moduli, respectively. To model using a transversely isotropic material, choose ''G<sub>A</sub>(t) = G<sub>T</sub>(t) = G(t)'' along with:


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>N_n=N_\ell=N_{KT}, \quad \tau_{n,k}=\tau_{\ell,k}=\tau_{KT,k}, \quad
<math>K_T(t) = K(t) + \frac{G_T(t)}{3},\quad n(t)= K(t) + \frac{4G_T(t)}{3},\quad {\rm and}\quad
n_0 = E_A + 4K_{T0}\nu_A^2, \quad n_k = 4K_{Tk}\nu_A^2, \quad \ell_0 = 2K_{T0}\nu_A, \quad \ell_k = 2K_{Tk}\nu_A
    \ell(t) = K(t) - \frac{2G_T(t)}{3}</math>
</math>
 
Finally, any other material properties (such as thermal expansion coefficients) should be set to the special cases for an isotropic material.
 
== Effective Time Implementation ==
 
This material handles effect of temperature and solvent concentration on relaxation times by the same methods used for [[Viscoelastic Material#Effective Time Implementation|isotropic viscoelastic materials]].
 
== Elastic Mechanical Properties ==
 
This material handles effect of temperature and solvent concentration on elastic properties by the same methods used for [[Viscoelastic Material#Elastic Mechanical Properties|isotropic viscoelastic materials]].


== Material Properties ==
== Material Properties ==
Line 59: Line 79:
! Property !! Description !! Units !! Default
! Property !! Description !! Units !! Default
|-
|-
| GT0 || The long term (or fully-relaxed) transverse shear modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || 0
| GT0 || The long term (or fully-relaxed) transverse shear modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || none
|-
|-
| GA0 || The long term (or fully-relaxed) axial shear modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || 0
| GA0 || The long term (or fully-relaxed) axial shear modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || none
|-
|-
| KT0 || The long term (or fully-relaxed) plane-strain bulk modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || 0
| KT0 || The long term (or fully-relaxed) plane-strain bulk modulus || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || none
|-
|-
| en0 || The long term (or fully-relaxed) ''C<sub>33</sub>'' element of the stiffness tensor || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || 0
| en0 || The long term (or fully-relaxed) ''C<sub>33</sub>'' element of the stiffness tensor || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || none
|-
|-
| ell0 || The long term (or fully-relaxed) ''C<sub>13</sub>=C<sub>23</sub>'' elements of the stiffness tensor || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || 0
| ell0 || The long term (or fully-relaxed) ''C<sub>13</sub>=C<sub>23</sub>'' elements of the stiffness tensor || [[ConsistentUnits Command#Legacy and Consistent Units|pressure units]] || none
|-
|-
| ntaus || The number of relaxation times of the previous long-term property that was entered. This property is only needed in <tt>XML</tt> files and must come before any subsequent Pk or tauk properties. In scripted files, the number is automatically determined from the number of relaxation times you provide. || none || none
| ntaus || The number of relaxation times of the previous long-term property that was entered. This property is only needed in <tt>XML</tt> files and must come before any subsequent Pk or tauk properties. In scripted files, the number is automatically determined from the number of relaxation times you provide. || none || none
Line 75: Line 95:
| tauk || The next relaxation time in the series for the previous long-term property that was entered. Enter multiple tauk values for each term on the series. || [[ConsistentUnits Command#Legacy and Consistent Units|time units]] || none
| tauk || The next relaxation time in the series for the previous long-term property that was entered. Enter multiple tauk values for each term on the series. || [[ConsistentUnits Command#Legacy and Consistent Units|time units]] || none
|-
|-
| fibrous || Enter 1 to indicate fiber direction is independent of time (or <math>E_A</math> and <math>\nu_A</math> are independent of time). Enter 0 to allow separate time dependence series for <math>n(t)</math> and <math>\ell(t)</math>. || dimensionless || 1
| Tref || Reference temperature to shift relaxation times using the WLF equation. If <tt>Tref</tt>&lt;0, then no shifting is done and relaxation times will be independent of temperature. || K || -1
|-
| C1 || Coefficient in WLF equation used when <tt>Tref</tt>&ge;0 to shift relaxation times. If the entered value is negative, the thermal shift switches to Arrhenious activation energy with ''&Delta;H<sub>a</sub> = -RC<sub>1</sub>'', || none || 17.44
|-
| C2 || Coefficient in WLF equation used when <tt>Tref</tt>&ge;0 to shift relaxation times (not used if ''C<sub>1</sub>'' is negative). || none || 51.6
|-
| mref || Reference concentration to shift relaxation times using the WLF-style equation. If <tt>mref</tt>&lt;0, then no shifting is done and relaxation times will be independent of concentration. || K || -1
|-
| Cm1 || Coefficient in WLF-style equation used when <tt>mref</tt>&ge;0 to shift relaxation times || none || 10
|-
| Cm2 || Coefficient in WLF-style equation used when <tt>mref</tt>&ge;0 to shift relaxation times (must be positive) || none || 0.0625
|-
| bTemp<br>bTValue || Enter <tt>(bTemp,bTValue)</tt> pairs for piecewise interpolation of vertical temperature [[Viscoelastic Material#Elastic Mechanical Properties|shift of elastic properties]]. Enter any number of pairs with <tt>bTemp</tt> values monotonically increasing || (degrees,none) || none
|-
| bConc<br>bCValue || Enter <tt>(bConc,bCValue)</tt> pairs for piecewise interpolation of vertical concentration (or moisture) [[Viscoelastic Material#Elastic Mechanical Properties|shift of elastic properties]]. Enter any number of pairs with <tt>bConc</tt> values monotonically increasing. Enter with actual concentration and not concentration potential. || none || none
|-
| [[Transversely Isotropic Material#Material Properties|TI Properties]] || Enter thermal expansion, solvent expansion, and poroelasticity properties as usual for transversely isotropic materials. || varies || varies
|-
|-
| [[Transversely Isotropic Material#Material Properties|TI Properties]] || Enter thermal expansion, solvent expansion, and poroelasticity properties as usual for transversely isotropic materials. When fibrous is 1, also enter EA (required) and nuA (default 0.33). || varies || varies
| swapz || Set to &gt;0 to move axial direction from ''z'' axis to the ''y'' axis (or from &theta; axis to ''Z'' axis in axisymmetric calculations). This property is only needed for 2D simulations that want axial direction in the analysis plane (it is not allowed in 3D MPM simulations). || none || 0
|-
|-
| ([[Common Material Properties|other]]) || Properties common to all materials || varies || varies
| ([[Common Material Properties|other]]) || Properties common to all materials || varies || varies
|}
|}


The material properties need to define the time dependence of 3 properties (when fibrous is 1) or 5 properties (when fibrous is 0). The process for each one is to enter the long-term value first (GT0, GA0, KT0, en0, ell0) and then to follow each one by ntaus (only needed in <tt>XML</tt> files) and by one Pk and tauk value for each term in the series.
The material properties need to define the time dependence 5 properties. The process for each one is to enter the long-term value first (GT0, GA0, KT0, en0, ell0) and then to follow each one by ntaus (only needed in <tt>XML</tt> files) and by one Pk and tauk value for each term in the series. Elastic value, or the property values at time zero, are sums of all Pk terms for that property. For example:
 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>G_T(0) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk}
</math>


When fibrous is 1, you instead enter time-independent values for EA and nuA. When fibrous is 0, their initial values calculated from:
Other elastic properties are given by


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Line 91: Line 131:
E_A(0) = n(0) - 4K_T(0)\nu_A^2 = n(0) - \frac{\ell(0)^2}{K_T(0)}
E_A(0) = n(0) - 4K_T(0)\nu_A^2 = n(0) - \frac{\ell(0)^2}{K_T(0)}
</math>
</math>
The remaining, initial transverse properties are:


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Line 98: Line 136:
\qquad {\rm and} \qquad
\qquad {\rm and} \qquad
\nu_T(0) = \frac{E_T(0)}{2G_T(0)}-1
\nu_T(0) = \frac{E_T(0)}{2G_T(0)}-1
</math>
The initial values, or the property at time zero, is sum of all long term and all Pk terms for that property. For example
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
<math>G_T(0) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk}
</math>
</math>


Line 113: Line 145:


These relations must apply for all time, but only the initial values are validated before starting a simulation.
These relations must apply for all time, but only the initial values are validated before starting a simulation.
=== Deprecated Material Properties ===
Prior to the <tt>swapz</tt> material property, there were two types on transversely isotropic viscoelastic materials named "TIViscoelastic 1" and "TIViscoelastic 2". Although these can still be used as the material type, they are deprecated. The prior "TIViscoelastic 1" is identical to this material with <tt>swapz=0</tt>. The prior "TIViscoelastic 2" material is identical to this material with <tt>swapz=1</tt>.


== History Variables ==
== History Variables ==

Latest revision as of 14:22, 1 May 2024

Constitutive Law

This anisotropic MPM material is a small strain, linear viscoelastic material that extends the Viscoelastic Material to model anisotropic viscoelasticity. The stress (σ) and strain (ε) are related by:

      [math]\displaystyle{ \sigma(t) = \mathbf{C}(t) * \varepsilon(t) }[/math]

Here [math]\displaystyle{ * }[/math] indicates convolution (or Boltzman's superposition) between time-dependent stiffness tensor ([math]\displaystyle{ \mathbf{C}(t) }[/math]) and strain tensor. In Voight-notation with unique axis in the z direction, the time-dependent stiffness tensor is

      [math]\displaystyle{ \mathbf{C}(t) = \left[\begin{array}{cccccc} K_T(t)+G_T(t) & K_T(t)-G_T(t) & \ell(t) & 0 & 0 & 0 \\ K_T(t)-G_T(t) & K_T(t)+G_T(t) & \ell(t) & 0 & 0 & 0 \\ \ell(t) & \ell(t) & n(t) & 0 & 0 & 0 \\ 0 & 0 & 0 & G_A(t) & 0 & 0 \\ 0 & 0 & 0 & 0 & G_A(t) & 0 \\ 0 & 0 & 0 & 0 & 0 & G_T(t) \end{array}\right] }[/math]

Here [math]\displaystyle{ K_T(t) }[/math] is the plane strain, bulk modulus, [math]\displaystyle{ G_T(t) }[/math] is the transverse shear modulus, [math]\displaystyle{ G_A(t) }[/math] is the axial shear modulus, and [math]\displaystyle{ n(t) }[/math] and [math]\displaystyle{ \ell(t) }[/math] give time-dependence of the C33 and C13=C23 elements of the stiffness tensor (as defined here). The time dependence of each property is modeled with a sum of exponentials:

      [math]\displaystyle{ K_T(t) = K_{T0} + \sum_{k=1}^{N_{KT}} K_{Tk} e^{-t/\tau_{KT,k}} \qquad G_T(t) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk} e^{-t/\tau_{GT,k}} \qquad G_A(t) = G_{A0} + \sum_{k=1}^{N_{GA}} G_{Ak} e^{-t/\tau_{GA,k}} }[/math]

      [math]\displaystyle{ n(t) = n_0 + \sum_{k=1}^{N_n} n_k e^{-t/\tau_{n,k}} \qquad\qquad \ell(t) = \ell_0 + \sum_{k=1}^{N_\ell} \ell_k e^{-t/\tau_{\ell,k}} }[/math]

In terms of axial modulus [math]\displaystyle{ E_A }[/math], and Poisson's ratio, [math]\displaystyle{ \nu_A }[/math], we can write:      

      [math]\displaystyle{ n(t) = E_A(t) + 4K_T(t)\nu_A(t)^2 \qquad\qquad \ell(t) = 4K_T(t)\nu_A(t) }[/math]

This material lumps all these time dependencies into [math]\displaystyle{ n(t) }[/math] and [math]\displaystyle{ \ell(t) }[/math], but note that selection of those properties will determine time dependencies of [math]\displaystyle{ E_A(t) }[/math] and [math]\displaystyle{ \nu_A(t) }[/math]

      [math]\displaystyle{ \nu_A(t) = {\ell(t)\over 2K_T(t)} \qquad {\rm and} \qquad E_A(t) = n(t) - \frac{\ell(t)^2}{K_T(t)} }[/math]

Rotated Material Axes

The initial axial direction is along the z axis (or θ axis for axisymmetric calculations). The axial direction can be changed to any other direction using the same method used to orient transversely isotropic elastic material with the swapz material property.

Isotropic with Time-Dependent Bulk Modulus

The available isotropic viscoelastic material is limited to materials with time-independent bulk modulus because that is a good approximation for most isotropic, viscoelastic materials. These transversely-isotropic materials, however, do not place any restrictions on which properties are time dependent. As result, it can model an isotropic material with a time-dependent bulk modulus as a special case. Imagine an isotropic material with K(t) and G(t) as time-dependent bulk and shear moduli, respectively. To model using a transversely isotropic material, choose GA(t) = GT(t) = G(t) along with:

      [math]\displaystyle{ K_T(t) = K(t) + \frac{G_T(t)}{3},\quad n(t)= K(t) + \frac{4G_T(t)}{3},\quad {\rm and}\quad \ell(t) = K(t) - \frac{2G_T(t)}{3} }[/math]

Finally, any other material properties (such as thermal expansion coefficients) should be set to the special cases for an isotropic material.

Effective Time Implementation

This material handles effect of temperature and solvent concentration on relaxation times by the same methods used for isotropic viscoelastic materials.

Elastic Mechanical Properties

This material handles effect of temperature and solvent concentration on elastic properties by the same methods used for isotropic viscoelastic materials.

Material Properties

The unusual task for this material is to use multiple terms to define the exponential series used for up to five material properties.

Property Description Units Default
GT0 The long term (or fully-relaxed) transverse shear modulus pressure units none
GA0 The long term (or fully-relaxed) axial shear modulus pressure units none
KT0 The long term (or fully-relaxed) plane-strain bulk modulus pressure units none
en0 The long term (or fully-relaxed) C33 element of the stiffness tensor pressure units none
ell0 The long term (or fully-relaxed) C13=C23 elements of the stiffness tensor pressure units none
ntaus The number of relaxation times of the previous long-term property that was entered. This property is only needed in XML files and must come before any subsequent Pk or tauk properties. In scripted files, the number is automatically determined from the number of relaxation times you provide. none none
Pk The next property in the series for the previous long-term property that was entered. Use multiple Pk values for each term on the series. pressure units none
tauk The next relaxation time in the series for the previous long-term property that was entered. Enter multiple tauk values for each term on the series. time units none
Tref Reference temperature to shift relaxation times using the WLF equation. If Tref<0, then no shifting is done and relaxation times will be independent of temperature. K -1
C1 Coefficient in WLF equation used when Tref≥0 to shift relaxation times. If the entered value is negative, the thermal shift switches to Arrhenious activation energy with ΔHa = -RC1, none 17.44
C2 Coefficient in WLF equation used when Tref≥0 to shift relaxation times (not used if C1 is negative). none 51.6
mref Reference concentration to shift relaxation times using the WLF-style equation. If mref<0, then no shifting is done and relaxation times will be independent of concentration. K -1
Cm1 Coefficient in WLF-style equation used when mref≥0 to shift relaxation times none 10
Cm2 Coefficient in WLF-style equation used when mref≥0 to shift relaxation times (must be positive) none 0.0625
bTemp
bTValue
Enter (bTemp,bTValue) pairs for piecewise interpolation of vertical temperature shift of elastic properties. Enter any number of pairs with bTemp values monotonically increasing (degrees,none) none
bConc
bCValue
Enter (bConc,bCValue) pairs for piecewise interpolation of vertical concentration (or moisture) shift of elastic properties. Enter any number of pairs with bConc values monotonically increasing. Enter with actual concentration and not concentration potential. none none
TI Properties Enter thermal expansion, solvent expansion, and poroelasticity properties as usual for transversely isotropic materials. varies varies
swapz Set to >0 to move axial direction from z axis to the y axis (or from θ axis to Z axis in axisymmetric calculations). This property is only needed for 2D simulations that want axial direction in the analysis plane (it is not allowed in 3D MPM simulations). none 0
(other) Properties common to all materials varies varies

The material properties need to define the time dependence 5 properties. The process for each one is to enter the long-term value first (GT0, GA0, KT0, en0, ell0) and then to follow each one by ntaus (only needed in XML files) and by one Pk and tauk value for each term in the series. Elastic value, or the property values at time zero, are sums of all Pk terms for that property. For example:

      [math]\displaystyle{ G_T(0) = G_{T0} + \sum_{k=1}^{N_{GT}} G_{Tk} }[/math]

Other elastic properties are given by

      [math]\displaystyle{ \nu_A(0) = {\ell(0)\over 2K_T(0)} \qquad {\rm and} \qquad E_A(0) = n(0) - 4K_T(0)\nu_A^2 = n(0) - \frac{\ell(0)^2}{K_T(0)} }[/math]

      [math]\displaystyle{ \frac{1}{E_T(0)} = \frac{1}{4K_T(0)} +\frac{1}{4G_T(0)} + {\nu_A(0)^2\over E_A(0)} \qquad {\rm and} \qquad \nu_T(0) = \frac{E_T(0)}{2G_T(0)}-1 }[/math]

For valid modeling, the initial Poisson's ratios must satisfy

      [math]\displaystyle{ -1\lt \nu_T(0)\lt 1 \qquad -\sqrt{E_A(0)\over E_T(0)} \lt \nu_A(0) \lt \sqrt{E_A(0)\over E_T(0)} \qquad {E_T(0)\nu_A(0)^2\over E_A(0)} \lt {1-\nu_T(0)\over 2} }[/math]

These relations must apply for all time, but only the initial values are validated before starting a simulation.

Deprecated Material Properties

Prior to the swapz material property, there were two types on transversely isotropic viscoelastic materials named "TIViscoelastic 1" and "TIViscoelastic 2". Although these can still be used as the material type, they are deprecated. The prior "TIViscoelastic 1" is identical to this material with swapz=0. The prior "TIViscoelastic 2" material is identical to this material with swapz=1.

History Variables

This material tracks internal history variables (one for each relaxation time and each component of stress) for implementation of linear viscoelastic properties, but currently none of these internal variables are available for archiving.

Example