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_stiffnessuses the average of C from Voigt and Reuss,arithmetic_complianceuses the inverse of the average of S,geometric_logandgeometric_affineuse the corresponding geometric mean of the Voigt and Reuss stiffness estimates, andsuper_hilluses the iterative superHill approximation. The orientation-wise geometric mean is available asC_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
- 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_stiffnessuses the inverse of the average of C,arithmetic_complianceuses the average of S,geometric_logandgeometric_affineuse the corresponding geometric mean of the Voigt and Reuss compliance estimates, andsuper_hilluses the inverse of the iterative superHill estimate. The orientation-wise geometric mean is available asS_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
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:
triclinicLaue class \(\bar{1}\); 21 independent constants.
monoclinicLaue class \(2/m\); 13 independent constants. The twofold axis is parallel to \(x_2\) (Nye’s standard orientation).
orthorhombicLaue class \(mmm\); 9 independent constants.
tetragonalLaue 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.
trigonalLaue 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.
hexagonalLaue classes \(6/m\) and \(6/mmm\); 5 independent constants with \(C_{66}=(C_{11}-C_{12})/2\).
cubicLaue classes \(m\bar{3}\) and \(m\bar{3}m\); 3 independent constants.
isotropicNot 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
xto unit length before evaluation. Defaults to False, in which case non-unit vectors raiseValueError.
- 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
handuto unit length before evaluation. Defaults to False, in which case non-unit vectors raiseValueError. 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
xandyto unit length before evaluation. Defaults to False, in which case non-unit vectors raiseValueError. Orthogonality is always checked.
- Returns:
nu – Poisson ratio for loading along
xand transverse directiony.- 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:
Trueif the matrix satisfies the Born stability criteria.- Return type:
bool
- Raises:
TypeError – If neither or both of
CandSare given.ValueError – If
crystal_systemis 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
Sis given, it is inverted to obtainCfor 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.
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.
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.
The components are
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)