scikit-elasticity#

A library for working with anisotropic elasticity in Python.

Homogenization#

Calculation of elastic constants from either elastic stiffness or compliance and a list of orientations. Inputs and outputs are plain NumPy arrays in Mandel notation. The orientation input must be a one-dimensional damask.Rotation. Hill-type estimates are available through C_Hill and S_Hill; select the scheme with method= (super_hill by default, also arithmetic_stiffness, arithmetic_compliance, geometric_log, or geometric_affine). The orientation-wise geometric mean is available separately as C_geo and S_geo.

>>> import skel
>>> import damask
>>> import numpy as np

>>> N = 1000
>>> C_Al = skel.Hooke.C('cubic',C_11=106.9e9,C_12=60.5e9,C_44=28.4e9)
>>> C_Al = skel.Mandel.to_6x6_stiffness(skel.Voigt.to_3x3x3x3_stiffness(C_Al))
>>> O = damask.Rotation.from_random(N)
>>> with np.printoptions(precision=2,suppress=True):
>>>    print(skel.homogenization.C_Reuss(O,C=C_Al)/1e9)
>>>    print(skel.homogenization.C_Voigt(O,C=C_Al)/1e9)
>>>    print(skel.homogenization.C_Hill(O,C=C_Al,method='arithmetic_stiffness')/1e9)
>>>    print(skel.homogenization.C_Hill(O,C=C_Al,method='arithmetic_compliance')/1e9)

Homogenization of elastic stiffness for ensembles of orientations.

The functions in this module take a set of orientations representing the texture together with either stiffness \(C\) or compliance \(S\) of a single crystal and calculate the effective stiffness or compliance in Mandel notation.

The orientations r must be a one-dimensional damask.Rotation.

The following schemes are available:

  • Voigt (isostrain) and Reuss (isostress) bounds

  • Hill averages, including arithmetic and bound-based geometric averages

  • superHill approximation

  • Orientation-wise geometric mean

  • Self-consistent scheme

skel.homogenization.C_Hill(r, *, C=None, S=None, method='super_hill', tol=1e-10, maxiter=100)[source]#

Homogenized stiffness according to a Hill-type scheme.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

  • method ({'arithmetic_stiffness', 'arithmetic_compliance',) – ‘geometric_log’, ‘geometric_affine’, ‘super_hill’}, optional Hill-type estimate to return. Defaults to super_hill.

  • tol (float, optional) – Relative convergence tolerance for super_hill. Defaults to 1e-10.

  • maxiter (int, optional) – Maximum number of iterations for super_hill. Defaults to 100.

Returns:

C_Hill – Homogenized stiffness in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

Notes

arithmetic_stiffness uses the average of C from Voigt and Reuss, arithmetic_compliance uses the inverse of the average of S, geometric_log and geometric_affine use the corresponding geometric mean of the Voigt and Reuss stiffness estimates, and super_hill uses the iterative superHill approximation. The orientation-wise geometric mean is available as C_geo().

References

R. Hill, Proceedings of the Physical Society. Section A 65(5):349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

K. S. Aleksandrov and L. A. Aizenberg, Doklady Akademii Nauk SSSR 167(5):1028-1031, 1966 (in Russian) https://geodesic.mathdoc.fr/item/DAN_1966_167_5_a17/

S. Matthies and M. Humbert, Journal of Applied Crystallography 28(3):254-266, 1995 https://doi.org/10.1107/S0021889894009623

W. Pusz and S. L. Woronowicz, Reports on Mathematical Physics 8(2):159-170, 1975 https://doi.org/10.1016/0034-4877(75)90061-0

F. Kubo and T. Ando, Mathematische Annalen 246(3):205-224, 1980 https://doi.org/10.1007/BF01371042

V. Arsigny et al., SIAM Journal on Matrix Analysis and Applications 29:328-347, 2007 https://doi.org/10.1137/050637996

skel.homogenization.C_Reuss(r, *, C=None, S=None)[source]#

Homogenized stiffness according to Reuss (isostress).

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

C_Reuss – Homogenized stiffness in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

A. Reuss, Zeitschrift für Angewandte Mathematik und Mechanik 9(1):49-58 https://doi.org/10.1002/zamm.19290090104

skel.homogenization.C_Voigt(r, *, C=None, S=None)[source]#

Homogenized stiffness according to Voigt (isostrain).

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

C_Voigt – Homogenized stiffness in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

W. Voigt, Annalen der Physik und Chemie 274(12):573-587 https://doi.org/10.1002/andp.18892741201

skel.homogenization.C_geo(r, *, C=None, S=None)[source]#

Homogenized stiffness according to the geometric mean.

This is the orientation-wise geometric mean, also referred to as GEO.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

C_geo – Homogenized stiffness in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

Notes

The geometric mean is calculated over all rotated stiffnesses,

\[C_\mathrm{geo} = \exp\left(\langle \ln C\rangle\right),\]

which satisfies \(C_\mathrm{geo}S_\mathrm{geo}=I\).

References

K. S. Aleksandrov and L. A. Aizenberg, Doklady Akademii Nauk SSSR 167(5):1028-1031, 1966 (in Russian) https://geodesic.mathdoc.fr/item/DAN_1966_167_5_a17/

S. Matthies and M. Humbert, Journal of Applied Crystallography 28(3):254-266, 1995 https://doi.org/10.1107/S0021889894009623

skel.homogenization.C_sc(r, *, C=None, S=None)[source]#

Homogenized stiffness according to the self-consistent scheme.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

C_sc – Homogenized stiffness in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

https://doi.org/10.1002/zamm.201100135

skel.homogenization.S_Hill(r, *, C=None, S=None, method='super_hill', tol=1e-10, maxiter=100)[source]#

Homogenized compliance according to a Hill-type scheme.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

  • method ({'arithmetic_stiffness', 'arithmetic_compliance',) – ‘geometric_log’, ‘geometric_affine’, ‘super_hill’}, optional Hill-type estimate to return. Defaults to super_hill.

  • tol (float, optional) – Relative convergence tolerance for super_hill. Defaults to 1e-10.

  • maxiter (int, optional) – Maximum number of iterations for super_hill. Defaults to 100.

Returns:

S_Hill – Homogenized compliance in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

Notes

arithmetic_stiffness uses the inverse of the average of C, arithmetic_compliance uses the average of S, geometric_log and geometric_affine use the corresponding geometric mean of the Voigt and Reuss compliance estimates, and super_hill uses the inverse of the iterative superHill estimate. The orientation-wise geometric mean is available as S_geo().

This function returns the inverse of C_Hill() for the selected method.

References

R. Hill, Proceedings of the Physical Society. Section A 65(5):349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

K. S. Aleksandrov and L. A. Aizenberg, Doklady Akademii Nauk SSSR 167(5):1028-1031, 1966 (in Russian) https://geodesic.mathdoc.fr/item/DAN_1966_167_5_a17/

S. Matthies and M. Humbert, Journal of Applied Crystallography 28(3):254-266, 1995 https://doi.org/10.1107/S0021889894009623

W. Pusz and S. L. Woronowicz, Reports on Mathematical Physics 8(2):159-170, 1975 https://doi.org/10.1016/0034-4877(75)90061-0

F. Kubo and T. Ando, Mathematische Annalen 246(3):205-224, 1980 https://doi.org/10.1007/BF01371042

V. Arsigny et al., SIAM Journal on Matrix Analysis and Applications 29:328-347, 2007 https://doi.org/10.1137/050637996

skel.homogenization.S_Reuss(r, *, C=None, S=None)[source]#

Homogenized compliance according to Reuss (isostress).

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

S_Reuss – Homogenized compliance in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

A. Reuss, Zeitschrift für Angewandte Mathematik und Mechanik 9(1):49-58 https://doi.org/10.1002/zamm.19290090104

skel.homogenization.S_Voigt(r, *, C=None, S=None)[source]#

Homogenized compliance according to Voigt (isostrain).

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

S_Voigt – Homogenized compliance in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

W. Voigt, Annalen der Physik und Chemie 274(12):573-587 https://doi.org/10.1002/andp.18892741201

skel.homogenization.S_geo(r, *, C=None, S=None)[source]#

Homogenized compliance according to the geometric mean.

This is the inverse of the orientation-wise geometric mean, also referred to as GEO.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

S_geo – Homogenized compliance in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

Notes

This is the inverse of C_geo().

References

K. S. Aleksandrov and L. A. Aizenberg, Doklady Akademii Nauk SSSR 167(5):1028-1031, 1966 (in Russian) https://geodesic.mathdoc.fr/item/DAN_1966_167_5_a17/

S. Matthies and M. Humbert, Journal of Applied Crystallography 28(3):254-266, 1995 https://doi.org/10.1107/S0021889894009623

skel.homogenization.S_sc(r, *, C=None, S=None)[source]#

Homogenized compliance according to the self-consistent scheme.

Parameters:
  • r (damask.Rotation of shape (n,)) – One-dimensional array of orientations.

  • S|C (numpy.ndarray of shape (6,6)) – Stiffness or compliance matrix in Mandel notation.

Returns:

S_sc – Homogenized compliance in Mandel notation.

Return type:

numpy.ndarray of shape (6,6)

References

https://doi.org/10.1002/zamm.201100135

Hooke#

Linear elasticity according to the generalized Hooke’s law.

This module assembles stiffness and compliance matrices in Voigt notation and provides directional and isotropic elastic properties.

Symmetry#

The form of the elastic tensor is determined by the point group of the crystal. Elasticity is a centrosymmetric fourth-rank tensor, so the relevant symmetry is the Laue class, i.e. the point group including inversion.

The crystal_system argument is a user-facing shorthand for the most general Laue-class form of a crystal system. The higher-symmetry class is obtained by omitting the optional constants or setting them to zero.

The relation between crystal systems, Laue classes, and the independent constants used here is:

triclinic

Laue class \(\bar{1}\); 21 independent constants.

monoclinic

Laue class \(2/m\); 13 independent constants. The twofold axis is parallel to \(x_2\) (Nye’s standard orientation).

orthorhombic

Laue class \(mmm\); 9 independent constants.

tetragonal

Laue classes \(4/m\) and \(4/mmm\). The general form has 7 constants with \(C_{16}=-C_{26}\). For \(4/mmm\), set \(C_{16}=C_{26}=0\), giving 6 constants.

trigonal

Laue classes \(\bar{3}\) and \(\bar{3}m\). The general form has 7 constants with \(C_{14}=-C_{24}=C_{56}\) and \(C_{15}=-C_{25}=-C_{46}\). For \(\bar{3}m\), set \(C_{15}=C_{25}=C_{46}=0\), giving 6 constants.

hexagonal

Laue classes \(6/m\) and \(6/mmm\); 5 independent constants with \(C_{66}=(C_{11}-C_{12})/2\).

cubic

Laue classes \(m\bar{3}\) and \(m\bar{3}m\); 3 independent constants.

isotropic

Not a crystal system; 2 independent constants with \(C_{44}=(C_{11}-C_{12})/2\).

All entries not listed as independent are either zero or related by the corresponding symmetry.

skel.Hooke.A_u(*, C=None, S=None)[source]#

Universal anisotropy index.

Parameters:
  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

Returns:

A_u – Universal anisotropy index.

Return type:

numpy.ndarray

Notes

\[A^U = 5\frac{G_V}{G_R} + \frac{K_V}{K_R} - 6\]

The index is zero for isotropic elasticity and positive otherwise. It is defined for any elastic tensor and therefore requires no crystal-system argument.

References

S. I. Ranganathan and M. Ostoja-Starzewski, Physical Review Letters 101:055504, 2008 https://doi.org/10.1103/PhysRevLett.101.055504

skel.Hooke.C(crystal_system, *, C_11=None, C_12=None, C_13=None, C_14=None, C_15=None, C_16=None, C_22=None, C_23=None, C_24=None, C_25=None, C_26=None, C_33=None, C_34=None, C_35=None, C_36=None, C_44=None, C_45=None, C_46=None, C_55=None, C_56=None, C_66=None)[source]#

Assemble a stiffness matrix.

Parameters:
  • crystal_system ({'isotropic', 'cubic', 'hexagonal', 'trigonal', 'tetragonal', 'orthorhombic', 'monoclinic', 'triclinic'}) – Crystal system. The assembled matrix uses the most general Laue-class form of this system; see the module documentation for the corresponding symmetry relations.

  • C_11 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • C_12 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • ... (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • C_66 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

Returns:

C – Stiffness matrix in Voigt notation.

Return type:

numpy.ndarray of shape (6,6)

Raises:

ValueError – If the supplied entries violate the symmetry relations or the resulting matrix is not stable.

Notes

Only the upper triangle is given; the lower triangle is filled by symmetry. The following optional relations are used when entries are omitted:

  • tetragonal: \(C_{16}=-C_{26}\). If both are omitted, both are set to zero (\(4/mmm\)).

  • trigonal: \(C_{14}=-C_{24}=C_{56}\) and \(C_{15}=-C_{25}=-C_{46}\). At least one of \(C_{14},C_{24},C_{56}\) must be given. If \(C_{15},C_{25},C_{46}\) are all omitted, they are set to zero (\(\bar{3}m\)).

  • hexagonal: \(C_{66}=(C_{11}-C_{12})/2\).

  • isotropic: \(C_{44}=(C_{11}-C_{12})/2\).

The resulting matrix is checked with stable().

Examples

>>> import skel
>>> C_Fe = skel.Hooke.C('cubic',C_11=232.2e9,C_12=136.4e9,C_44=117.0e9)
>>> C_Mg = skel.Hooke.C('hexagonal',C_11=59.5e9,C_12=25.6e9,
...                     C_44=16.5e9,C_33=61.7e9,C_13=21.5e9)
skel.Hooke.E(x, *, C=None, S=None, normalize=False)[source]#

Directional Young’s modulus.

Parameters:
  • x (numpy.ndarray of shape (...,3)) – Unit vector(s) along the loading direction.

  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

  • normalize (bool, optional) – Normalize x to unit length before evaluation. Defaults to False, in which case non-unit vectors raise ValueError.

Returns:

E – Young’s modulus along x.

Return type:

numpy.ndarray

Notes

\[E(\mathbf{x}) = \frac{1}{S_{ijkl} x_i x_j x_k x_l}\]

References

https://mtex-toolbox.github.io/stiffnessTensor.YoungsModulus.html

skel.Hooke.G(h, u, *, C=None, S=None, normalize=False)[source]#

Directional shear modulus.

Parameters:
  • h (numpy.ndarray of shape (...,3)) – Unit vector(s) normal to the shear plane.

  • u (numpy.ndarray of shape (...,3)) – Unit vector(s) in the shear direction. Must be orthogonal to h.

  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

  • normalize (bool, optional) – Normalize h and u to unit length before evaluation. Defaults to False, in which case non-unit vectors raise ValueError. Orthogonality is always checked.

Returns:

G – Shear modulus for the plane/direction pair (h, u).

Return type:

numpy.ndarray

Notes

\[G(\mathbf{h},\mathbf{u}) = \frac{1}{4 S_{ijkl} h_i u_j h_k u_l}\]

References

https://mtex-toolbox.github.io/stiffnessTensor.shearModulus.html

skel.Hooke.G_R(*, C=None, S=None)[source]#

Equivalent isotropic shear modulus (isostress/Reuss assumption).

Parameters:
  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

Returns:

G_R – Reuss shear modulus.

Return type:

numpy.ndarray

Notes

\[G_R = \frac{15}{4(S_{11}+S_{22}+S_{33}) -4(S_{12}+S_{13}+S_{23}) +3(S_{44}+S_{55}+S_{66})}\]

References

A. Reuss, Zeitschrift für Angewandte Mathematik und Mechanik 9(1):49-53, 1929 https://doi.org/10.1002/zamm.19290090104

R. Hill, Proceedings of the Physical Society. Section A 66:349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

skel.Hooke.G_V(*, C=None, S=None)[source]#

Equivalent isotropic shear modulus (isostrain/Voigt assumption).

Parameters:
  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

Returns:

G_V – Voigt shear modulus.

Return type:

numpy.ndarray

Notes

\[G_V = \frac{C_{11}+C_{22}+C_{33} -(C_{12}+C_{13}+C_{23}) +3(C_{44}+C_{55}+C_{66})}{15}\]

References

W. Voigt, Abhandlungen der Königlichen Gesellschaft der Wissenschaften in Göttingen: Mathematische Classe 34:3-52, 1887 https://gdz.sub.uni-goettingen.de/id/PPN250442582_0034

R. Hill, Proceedings of the Physical Society. Section A 66:349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

skel.Hooke.K_R(*, C=None, S=None)[source]#

Equivalent isotropic bulk modulus (isostress/Reuss assumption).

Parameters:
  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

Returns:

K_R – Reuss bulk modulus.

Return type:

numpy.ndarray

Notes

\[K_R = \frac{1}{S_{11}+S_{22}+S_{33} +2(S_{12}+S_{13}+S_{23})}\]

References

A. Reuss, Zeitschrift für Angewandte Mathematik und Mechanik 9(1):49-53, 1929 https://doi.org/10.1002/zamm.19290090104

R. Hill, Proceedings of the Physical Society. Section A 66:349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

skel.Hooke.K_V(*, C=None, S=None)[source]#

Equivalent isotropic bulk modulus (isostrain/Voigt assumption).

Parameters:
  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

Returns:

K_V – Voigt bulk modulus.

Return type:

numpy.ndarray

Notes

\[K_V = \frac{C_{11}+C_{22}+C_{33} +2(C_{12}+C_{13}+C_{23})}{9}\]

References

W. Voigt, Abhandlungen der Königlichen Gesellschaft der Wissenschaften in Göttingen: Mathematische Classe 34:3-52, 1887 https://gdz.sub.uni-goettingen.de/id/PPN250442582_0034

R. Hill, Proceedings of the Physical Society. Section A 66:349-354, 1952 https://doi.org/10.1088/0370-1298/65/5/307

skel.Hooke.S(crystal_system, *, S_11=None, S_12=None, S_13=None, S_14=None, S_15=None, S_16=None, S_22=None, S_23=None, S_24=None, S_25=None, S_26=None, S_33=None, S_34=None, S_35=None, S_36=None, S_44=None, S_45=None, S_46=None, S_55=None, S_56=None, S_66=None)[source]#

Assemble a compliance matrix.

Parameters:
  • crystal_system ({'isotropic', 'cubic', 'hexagonal', 'trigonal', 'tetragonal', 'orthorhombic', 'monoclinic', 'triclinic'}) – Crystal system. The assembled matrix uses the most general Laue-class form of this system; see the module documentation for the corresponding symmetry relations.

  • S_11 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • S_12 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • ... (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

  • S_66 (float, optional) – Upper-triangle entries in Voigt notation. Only the independent entries for the selected crystal system need to be given. Dependent entries are inferred from the symmetry relations. If a dependent entry is supplied, it must be consistent with the inferred value.

Returns:

S – Compliance matrix in Voigt notation.

Return type:

numpy.ndarray of shape (6,6)

Raises:

ValueError – If the supplied entries violate the symmetry relations or the resulting matrix is not stable.

Notes

Only the upper triangle is given; the lower triangle is filled by symmetry. The compliance relations differ from the stiffness relations because of the Voigt weights:

  • tetragonal: \(S_{16}=-S_{26}\). If both are omitted, both are set to zero (\(4/mmm\)).

  • trigonal: \(S_{14}=-S_{24}=S_{56}/2\) and \(S_{15}=-S_{25}=-S_{46}/2\). At least one of \(S_{14},S_{24},S_{56}\) must be given. If \(S_{15},S_{25},S_{46}\) are all omitted, they are set to zero (\(\bar{3}m\)).

  • hexagonal: \(S_{66}=2(S_{11}-S_{12})\).

  • isotropic: \(S_{44}=2(S_{11}-S_{12})\).

The resulting matrix is checked with stable().

Examples

>>> import numpy as np
>>> import skel
>>> C_Fe = skel.Hooke.C('cubic',C_11=232.2e9,C_12=136.4e9,C_44=117.0e9)
>>> S_Fe = np.linalg.inv(C_Fe)
skel.Hooke.nu(x, y, *, C=None, S=None, normalize=False)[source]#

Directional Poisson ratio.

Parameters:
  • x (numpy.ndarray of shape (...,3)) – Unit vector(s) along the loading direction.

  • y (numpy.ndarray of shape (...,3)) – Unit vector(s) along the transverse direction. Must be orthogonal to x.

  • C (numpy.ndarray of shape (...,6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (...,6,6), optional) – Compliance matrix in Voigt notation.

  • normalize (bool, optional) – Normalize x and y to unit length before evaluation. Defaults to False, in which case non-unit vectors raise ValueError. Orthogonality is always checked.

Returns:

nu – Poisson ratio for loading along x and transverse direction y.

Return type:

numpy.ndarray

Notes

\[\nu(\mathbf{x},\mathbf{y}) = -\frac{S_{ijkl} x_i x_j y_k y_l} {S_{mnop} x_m x_n x_o x_p}\]

References

https://mtex-toolbox.github.io/stiffnessTensor.PoissonRatio.html

skel.Hooke.stable(crystal_system, *, C=None, S=None)[source]#

Determine whether a stiffness or compliance matrix is stable.

Parameters:
  • crystal_system ({'isotropic', 'cubic', 'hexagonal', 'trigonal', 'tetragonal', 'orthorhombic', 'monoclinic', 'triclinic'}) – Crystal system of the matrix. The stability criteria depend on the corresponding Laue class.

  • C (numpy.ndarray of shape (6,6), optional) – Stiffness matrix in Voigt notation.

  • S (numpy.ndarray of shape (6,6), optional) – Compliance matrix in Voigt notation.

Returns:

True if the matrix satisfies the Born stability criteria.

Return type:

bool

Raises:
  • TypeError – If neither or both of C and S are given.

  • ValueError – If crystal_system is not a valid crystal system.

Notes

The criteria are necessary and sufficient for elastic stability in the harmonic approximation and in the absence of external stress. They are taken from Mouhat and Coudert, who give them per Laue class.

For tetragonal and trigonal systems, the implementation uses the more general \(4/m\) and \(\bar{3}\) conditions. The higher-symmetry \(4/mmm\) and \(\bar{3}m\) cases are obtained by setting \(C_{16}=C_{26}=0\) and \(C_{15}=C_{25}=C_{46}=0\), respectively.

The matrix must have the symmetry of the selected crystal system. These criteria are not a general positive-definiteness test for an arbitrary 6x6 matrix.

If S is given, it is inverted to obtain C for the stability check.

References

F. Mouhat and F.-X. Coudert, Physical Review B 90:224104, 2014. https://doi.org/10.1103/PhysRevB.90.224104

Conversions and Representations#

Voigt#

Compressed notation of symmetric tensors using convention attributed to W. Voigt.

Notes

The following convention is used to store the unique elements of a 2nd order tensor t (3x3 matrix) as a vector t’ of length 6.

\[\vb{t}'_\text{Voigt} = (t_{xx}, t_{yy}, t_{zz}, w t_{yz}, w t_{xz}, w t_{xy})\]

Different weights are used for the representation of stress (\(w = 1\)) and strain (\(w = 2\)).

References

P. Helnwein, Computer methods in applied mechanics and engineering 190:2753-2770, 2001 https://doi.org/10.1016/s0045-7825(00)00263-2

T. Mánik, European Journal of Mechanics - A/Solids 90:104357, 2021 https://doi.org/10.1016/j.euromechsol.2021.104357

W. Voigt, Nachrichten von der Gesellschaft der Wissenschaften zu Göttingen. Mathematisch-Physikalische Klasse (2):117–176, 1900 https://gdz.sub.uni-goettingen.de/id/PPN252457811_1900

skel.Voigt.rotate_compliance(r, S_Voigt)[source]#

Rotate symmetric 4th order compliance tensor in Voigt notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • S_Voigt (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order compliance tensor in Voigt notation.

Returns:

S_Voigt – Rotated 4th order compliance tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Voigt.rotate_stiffness(r, C_Voigt)[source]#

Rotate symmetric 4th order stiffness tensor in Voigt notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • C_Voigt (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in Voigt notation.

Returns:

C_Voigt – Rotated 4th order stiffness tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Voigt.rotate_strain(r, epsilon_Voigt)[source]#

Rotate symmetric 2nd order strain tensor in Voigt notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • epsilon_Voigt (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in Voigt notation.

Returns:

epsilon_Voigt – Rotated 2nd order strain tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Voigt.rotate_stress(r, sigma_Voigt)[source]#

Rotate symmetric 2nd order stress tensor in Voigt notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • sigma_Voigt (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in Voigt notation.

Returns:

sigma_Voigt – Rotated 2nd order stress tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Voigt.to_3x3_strain(epsilon_Voigt)[source]#

Convert symmetric 2nd order strain tensor in Voigt notation to matrix notation.

Parameters:

epsilon_Voigt (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in Voigt notation.

Returns:

epsilon – Symmetric 2nd order strain tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.Voigt.to_3x3_stress(sigma_Voigt)[source]#

Convert symmetric 2nd order stress tensor in Voigt notation to matrix notation.

Parameters:

sigma_Voigt (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in Voigt notation.

Returns:

sigma – Symmetric 2nd order stress tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.Voigt.to_3x3x3x3_compliance(S_Voigt)[source]#

Convert symmetric 4th order compliance tensor in Voigt notation to matrix notation.

Parameters:

S_Voigt (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in Voigt notation.

Returns:

S – Symmetric 4th order compliance tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.Voigt.to_3x3x3x3_stiffness(C_Voigt)[source]#

Convert symmetric 4th order stiffness tensor in Voigt notation to matrix notation.

Parameters:

C_Voigt (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in Voigt notation.

Returns:

C – Symmetric 4th order stiffness tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.Voigt.to_6_strain(epsilon)[source]#

Convert symmetric 2nd order strain tensor in matrix notation to Voigt notation.

Parameters:

epsilon (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order strain tensor in matrix notation.

Returns:

epsilon_Voigt – Symmetric 2nd order strain tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Voigt.to_6_stress(sigma)[source]#

Convert symmetric 2nd order stress tensor in matrix notation to Voigt notation.

Parameters:

sigma (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order stress tensor in matrix notation.

Returns:

sigma_Voigt – Symmetric 2nd order stress tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Voigt.to_6x6_compliance(S)[source]#

Convert symmetric 4th order compliance tensor in matrix notation to Voigt notation.

Parameters:

S (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order compliance tensor in matrix notation.

Returns:

S_Voigt – Symmetric 4th order compliance tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Voigt.to_6x6_stiffness(C)[source]#

Convert symmetric 4th order stiffness tensor in matrix notation to Voigt notation.

Parameters:

C (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order stiffness tensor in matrix notation.

Returns:

C_Voigt – Symmetric 4th order stiffness tensor in Voigt notation.

Return type:

numpy.ndarray of shape (…,6,6)


Mandel#

Compressed notation of symmetric tensors using convention attributed to J. Mandel.

Notes

The following convention is used to store the unique elements of a 2nd order tensor t (3x3 matrix) as a vector t’ of length 6.

\[\vb{t}'_\text{Mandel} = (t_{xx}, t_{yy}, t_{zz}, w t_{yz}, w t_{xz}, w t_{xy})\]

The same weight (\(w = \sqrt{2}\)) is used for the representation of stress and strain.

References

P. Helnwein, Computer methods in applied mechanics and engineering 190:2753-2770, 2001 https://doi.org/10.1016/s0045-7825(00)00263-2

T. Mánik, European Journal of Mechanics - A/Solids 90:104357, 2021 https://doi.org/10.1016/j.euromechsol.2021.104357

J. Mandel, International Journal of Solids and Structures 1(3):273-295, 1965 https://doi.org/10.1016/0020-7683(65)90034-X

W. Voigt, Nachrichten von der Gesellschaft der Wissenschaften zu Göttingen. Mathematisch-Physikalische Klasse (2):117–176, 1900 https://gdz.sub.uni-goettingen.de/id/PPN252457811_1900

skel.Mandel.rotate_2nd(r, t_Mandel)[source]#

Rotate symmetric 2nd order tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • t_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order tensor in Mandel notation.

Returns:

t_Mandel – Rotated 2nd order tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

Notes

Due to the definition of the Mandel notation, this function can be used to rotate strain and stress tensors.

skel.Mandel.rotate_4th(r, T_Mandel)[source]#

Rotate symmetric 4th order tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • T_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in Mandel notation.

Returns:

T_Mandel – Rotated 4th order tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)

Notes

Due to the definition of the Mandel notation, this function can be used to rotate compliance and stiffness tensors.

skel.Mandel.rotate_compliance(r, S_Mandel)[source]#

Rotate symmetric 4th order compliance tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • S_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order compliance tensor in Mandel notation.

Returns:

S_Mandel – Rotated 4th order compliance tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Mandel.rotate_stiffness(r, C_Mandel)[source]#

Rotate symmetric 4th order stiffness tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • C_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in Mandel notation.

Returns:

C_Mandel – Rotated 4th order stiffness tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Mandel.rotate_strain(r, epsilon_Mandel)[source]#

Rotate symmetric 2nd order strain tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • epsilon_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in Mandel notation.

Returns:

epsilon_Mandel – Rotated 2nd order strain tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Mandel.rotate_stress(r, sigma_Mandel)[source]#

Rotate symmetric 2nd order stress tensor in Mandel notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • sigma_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in Mandel notation.

Returns:

sigma_Mandel – Rotated 2nd order stress tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Mandel.to_3x3(t_Mandel)[source]#

Convert symmetric 2nd order tensor in Mandel notation to matrix notation.

Parameters:

t_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order tensor in Mandel notation.

Returns:

t – Symmetric 2nd order tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

Notes

Due to the definition of the Mandel notation, this function can be used to convert strain and stress tensors.

skel.Mandel.to_3x3_strain(epsilon_Mandel)[source]#

Convert symmetric 2nd order strain tensor in Mandel notation to matrix notation.

Parameters:

epsilon_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in Mandel notation.

Returns:

epsilon – Symmetric 2nd order strain tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.Mandel.to_3x3_stress(sigma_Mandel)[source]#

Convert symmetric 2nd order stress tensor in Mandel notation to matrix notation.

Parameters:

sigma_Mandel (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in Mandel notation.

Returns:

sigma – Symmetric 2nd order stress tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.Mandel.to_3x3x3x3(T_Mandel)[source]#

Convert symmetric 4th order tensor in Mandel notation to matrix notation.

Parameters:

T_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in Mandel notation.

Returns:

T – Symmetric 4th order tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

Notes

Due to the definition of the Mandel notation, this function can be used to convert compliance and stiffness tensors.

skel.Mandel.to_3x3x3x3_compliance(S_Mandel)[source]#

Convert symmetric 4th order compliance tensor in Mandel notation to matrix notation.

Parameters:

S_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in Mandel notation.

Returns:

S – Symmetric 4th order compliance tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.Mandel.to_3x3x3x3_stiffness(C_Mandel)[source]#

Convert symmetric 4th order stiffness tensor in Mandel notation to matrix notation.

Parameters:

C_Mandel (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in Mandel notation.

Returns:

C – Symmetric 4th order stiffness tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.Mandel.to_6(t)[source]#

Convert symmetric 2nd order tensor in matrix notation to Mandel notation.

Parameters:

t (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order tensor in matrix notation.

Returns:

t_Mandel – Symmetric 2nd order tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

Notes

Due to the definition of the Mandel notation, this function can be used to convert strain and stress tensors.

skel.Mandel.to_6_strain(epsilon)[source]#

Convert symmetric 2nd order strain tensor in matrix notation to Mandel notation.

Parameters:

epsilon (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order strain tensor in matrix notation.

Returns:

epsilon_Mandel – Symmetric 2nd order strain tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Mandel.to_6_stress(sigma)[source]#

Convert symmetric 2nd order stress tensor in matrix notation to Mandel notation.

Parameters:

sigma (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order stress tensor in matrix notation.

Returns:

sigma_Mandel – Symmetric 2nd order stress tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6)

skel.Mandel.to_6x6(T)[source]#

Convert symmetric 4th order tensor in matrix notation to Mandel notation.

Parameters:

T (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order tensor in matrix notation.

Returns:

T_Mandel – Symmetric 4th order tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)

Notes

Due to the definition of the Mandel notation, this function can be used to convert compliance and stiffness tensors.

skel.Mandel.to_6x6_compliance(S)[source]#

Convert symmetric 4th order compliance tensor in matrix notation to Mandel notation.

Parameters:

S (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order compliance tensor in matrix notation.

Returns:

S_Mandel – Symmetric 4th order compliance tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.Mandel.to_6x6_stiffness(C)[source]#

Convert symmetric 4th order stiffness tensor in matrix notation to Mandel notation.

Parameters:

C (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order stiffness tensor in matrix notation.

Returns:

C_Mandel – Symmetric 4th order stiffness tensor in Mandel notation.

Return type:

numpy.ndarray of shape (…,6,6)


natural#

Compressed notation of symmetric tensors using a natural basis.

Notes

The following convention is used to store the unique elements of a 2nd order tensor t (3x3 matrix) as a vector t’ of length 6.

\[\vb{t}'_\text{natural} = (t'_1, t'_2, t'_3, t'_4, t'_5, t'_6)\]

The components are

\[\begin{split}t'_1 &= \frac{t_{xx}+t_{yy}+t_{zz}}{\sqrt{3}} \\ t'_2 &= \frac{2t_{zz}-t_{xx}-t_{yy}}{\sqrt{6}}\cos\theta + \frac{t_{xx}-t_{yy}}{\sqrt{2}}\sin\theta \\ t'_3 &= \frac{2t_{zz}-t_{xx}-t_{yy}}{\sqrt{6}}\sin\theta - \frac{t_{xx}-t_{yy}}{\sqrt{2}}\cos\theta \\ t'_4 &= \sqrt{2}t_{yz} \\ t'_5 &= \sqrt{2}t_{xz} \\ t'_6 &= \sqrt{2}t_{xy}\end{split}\]

The first component is the hydrostatic part, the next two components span the deviatoric plane, and the last three are the shear components. The optional parameter \(\theta\) rotates the deviatoric plane, i.e. it mixes \(t'_2\) and \(t'_3\).

Because the underlying basis is orthonormal, the Euclidean norm of the vector equals the Frobenius norm of the tensor.

References

T. Mánik, European Journal of Mechanics - A/Solids 90:104357, 2021 https://doi.org/10.1016/j.euromechsol.2021.104357

U.F. Kocks et al., Texture and Anisotropy: Preferred Orientations in Polycrystals and their Effect on Materials Properties. Cambridge University Press 1998, page 287

P. Lequeu, Comparison of crystallographic and continuum yield surfaces for textured polycrystals. PhD thesis, McGill University, Montreal, Canada, 1986 https://escholarship.mcgill.ca/concern/theses/nk322f063

P. Van Houtte, Texture, Stress, and Microstructure 8(1):313-350, 1988 https://doi.org/10.1155/TSM.8-9.313

skel.natural.rotate_2nd(r, t_natural, theta=0.0)[source]#

Rotate symmetric 2nd order tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • t_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

t_natural – Rotated 2nd order tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

Notes

Due to the definition of the natural notation, this function can be used to rotate strain and stress tensors.

skel.natural.rotate_4th(r, T_natural, theta=0.0)[source]#

Rotate symmetric 4th order tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • T_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

T_natural – Rotated 4th order tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)

Notes

Due to the definition of the natural notation, this function can be used to rotate compliance and stiffness tensors.

skel.natural.rotate_compliance(r, S_natural, theta=0.0)[source]#

Rotate symmetric 4th order compliance tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • S_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order compliance tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

S_natural – Rotated 4th order compliance tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.natural.rotate_stiffness(r, C_natural, theta=0.0)[source]#

Rotate symmetric 4th order stiffness tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • C_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

C_natural – Rotated 4th order stiffness tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.natural.rotate_strain(r, epsilon_natural, theta=0.0)[source]#

Rotate symmetric 2nd order strain tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • epsilon_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

epsilon_natural – Rotated 2nd order strain tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

skel.natural.rotate_stress(r, sigma_natural, theta=0.0)[source]#

Rotate symmetric 2nd order stress tensor in natural notation.

Parameters:
  • r (damask.Rotation of shape (...)) – Rotations to apply. Must be broadcastable.

  • sigma_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

sigma_natural – Rotated 2nd order stress tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

skel.natural.to_3x3(t_natural, theta=0.0)[source]#

Convert symmetric 2nd order tensor in natural notation to matrix notation.

Parameters:
  • t_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

t – Symmetric 2nd order tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

Notes

Due to the definition of the natural notation, this function can be used to convert strain and stress tensors.

skel.natural.to_3x3_strain(epsilon_natural, theta=0.0)[source]#

Convert symmetric 2nd order strain tensor in natural notation to matrix notation.

Parameters:
  • epsilon_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order strain tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

epsilon – Symmetric 2nd order strain tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.natural.to_3x3_stress(sigma_natural, theta=0.0)[source]#

Convert symmetric 2nd order stress tensor in natural notation to matrix notation.

Parameters:
  • sigma_natural (numpy.ndarray of shape (...,6)) – Symmetric 2nd order stress tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

sigma – Symmetric 2nd order stress tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3)

skel.natural.to_3x3x3x3(T_natural, theta=0.0)[source]#

Convert symmetric 4th order tensor in natural notation to matrix notation.

Parameters:
  • T_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

T – Symmetric 4th order tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

Notes

Due to the definition of the natural notation, this function can be used to convert compliance and stiffness tensors.

skel.natural.to_3x3x3x3_compliance(S_natural, theta=0.0)[source]#

Convert symmetric 4th order compliance tensor in natural notation to matrix notation.

Parameters:
  • S_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order compliance tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

S – Symmetric 4th order compliance tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.natural.to_3x3x3x3_stiffness(C_natural, theta=0.0)[source]#

Convert symmetric 4th order stiffness tensor in natural notation to matrix notation.

Parameters:
  • C_natural (numpy.ndarray of shape (...,6,6)) – Symmetric 4th order stiffness tensor in natural notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

C – Symmetric 4th order stiffness tensor in matrix notation.

Return type:

numpy.ndarray of shape (…,3,3,3,3)

skel.natural.to_6(t, theta=0.0)[source]#

Convert symmetric 2nd order tensor in matrix notation to natural notation.

Parameters:
  • t (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

t_natural – Symmetric 2nd order tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

Notes

Due to the definition of the natural notation, this function can be used to convert strain and stress tensors.

skel.natural.to_6_strain(epsilon, theta=0.0)[source]#

Convert symmetric 2nd order strain tensor in matrix notation to natural notation.

Parameters:
  • epsilon (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order strain tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

epsilon_natural – Symmetric 2nd order strain tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

skel.natural.to_6_stress(sigma, theta=0.0)[source]#

Convert symmetric 2nd order stress tensor in matrix notation to natural notation.

Parameters:
  • sigma (numpy.ndarray of shape (...,3,3)) – Symmetric 2nd order stress tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

sigma_natural – Symmetric 2nd order stress tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6)

skel.natural.to_6x6(T, theta=0.0)[source]#

Convert symmetric 4th order tensor in matrix notation to natural notation.

Parameters:
  • T (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

T_natural – Symmetric 4th order tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)

Notes

Due to the definition of the natural notation, this function can be used to convert compliance and stiffness tensors.

skel.natural.to_6x6_compliance(S, theta=0.0)[source]#

Convert symmetric 4th order compliance tensor in matrix notation to natural notation.

Parameters:
  • S (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order compliance tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

S_natural – Symmetric 4th order compliance tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)

skel.natural.to_6x6_stiffness(C, theta=0.0)[source]#

Convert symmetric 4th order stiffness tensor in matrix notation to natural notation.

Parameters:
  • C (numpy.ndarray of shape (...,3,3,3,3)) – Symmetric 4th order stiffness tensor in matrix notation.

  • theta (float, optional) – Rotation angle (in radians) of the deviatoric plane. Defaults to 0.

Returns:

C_natural – Symmetric 4th order stiffness tensor in natural notation.

Return type:

numpy.ndarray of shape (…,6,6)