223031012
/
DAMASK_EICMD
mirror of https://github.com/achalhp/DAMASK_EICMD.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

new convention

This commit is contained in:
Martin Diehl 2021-12-06 07:38:40 +01:00
parent cef8b06dc0
commit 7b187eb370
2 changed files with 38 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
python/damask/mechanics.py
View File

@ -19,12 +19,12 @@ def deformation_Cauchy_Green_left(F: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
F : numpy.ndarray of shape (...,3,3) F : numpy.ndarray, shape (...,3,3)
Deformation gradient. Deformation gradient.
Returns Returns
------- -------
B : numpy.ndarray of shape (...,3,3) B : numpy.ndarray, shape (...,3,3)
Left Cauchy-Green deformation tensor. Left Cauchy-Green deformation tensor.
""" """
@ -37,12 +37,12 @@ def deformation_Cauchy_Green_right(F: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
F : numpy.ndarray of shape (...,3,3) F : numpy.ndarray, shape (...,3,3)
Deformation gradient. Deformation gradient.
Returns Returns
------- -------
C : numpy.ndarray of shape (...,3,3) C : numpy.ndarray, shape (...,3,3)
Right Cauchy-Green deformation tensor. Right Cauchy-Green deformation tensor.
""" """
@ -55,12 +55,12 @@ def equivalent_strain_Mises(epsilon: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
epsilon : numpy.ndarray of shape (...,3,3) epsilon : numpy.ndarray, shape (...,3,3)
Symmetric strain tensor of which the von Mises equivalent is computed. Symmetric strain tensor of which the von Mises equivalent is computed.
Returns Returns
------- -------
epsilon_vM : numpy.ndarray of shape (...) epsilon_vM : numpy.ndarray, shape (...)
Von Mises equivalent strain of epsilon. Von Mises equivalent strain of epsilon.
""" """
@ -73,12 +73,12 @@ def equivalent_stress_Mises(sigma: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
sigma : numpy.ndarray of shape (...,3,3) sigma : numpy.ndarray, shape (...,3,3)
Symmetric stress tensor of which the von Mises equivalent is computed. Symmetric stress tensor of which the von Mises equivalent is computed.
Returns Returns
------- -------
sigma_vM : numpy.ndarray of shape (...) sigma_vM : numpy.ndarray, shape (...)
Von Mises equivalent stress of sigma. Von Mises equivalent stress of sigma.
""" """
@ -91,12 +91,12 @@ def maximum_shear(T_sym: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T_sym : numpy.ndarray of shape (...,3,3) T_sym : numpy.ndarray, shape (...,3,3)
Symmetric tensor of which the maximum shear is computed. Symmetric tensor of which the maximum shear is computed.
Returns Returns
------- -------
gamma_max : numpy.ndarray of shape (...) gamma_max : numpy.ndarray, shape (...)
Maximum shear of T_sym. Maximum shear of T_sym.
""" """
@ -110,12 +110,12 @@ def rotation(T: _np.ndarray) -> _rotation.Rotation:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the rotational part is computed. Tensor of which the rotational part is computed.
Returns Returns
------- -------
R : damask.Rotation of shape (...) R : damask.Rotation, shape (...)
Rotational part of the vector. Rotational part of the vector.
""" """
@ -128,7 +128,7 @@ def strain(F: _np.ndarray, t: str, m: float) -> _np.ndarray:
Parameters Parameters
---------- ----------
F : numpy.ndarray of shape (...,3,3) F : numpy.ndarray, shape (...,3,3)
Deformation gradient. Deformation gradient.
t : {‘V’, ‘U’} t : {‘V’, ‘U’}
Type of the polar decomposition, ‘V’ for left stretch tensor Type of the polar decomposition, ‘V’ for left stretch tensor
@ -138,7 +138,7 @@ def strain(F: _np.ndarray, t: str, m: float) -> _np.ndarray:
Returns Returns
------- -------
epsilon : numpy.ndarray of shape (...,3,3) epsilon : numpy.ndarray, shape (...,3,3)
Strain of F. Strain of F.
References References
@ -170,14 +170,14 @@ def stress_Cauchy(P: _np.ndarray, F: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
P : numpy.ndarray of shape (...,3,3) P : numpy.ndarray, shape (...,3,3)
First Piola-Kirchhoff stress. First Piola-Kirchhoff stress.
F : numpy.ndarray of shape (...,3,3) F : numpy.ndarray, shape (...,3,3)
Deformation gradient. Deformation gradient.
Returns Returns
------- -------
sigma : numpy.ndarray of shape (...,3,3) sigma : numpy.ndarray, shape (...,3,3)
Cauchy stress. Cauchy stress.
""" """
@ -193,14 +193,14 @@ def stress_second_Piola_Kirchhoff(P: _np.ndarray, F: _np.ndarray) -> _np.ndarray
Parameters Parameters
---------- ----------
P : numpy.ndarray of shape (...,3,3) P : numpy.ndarray, shape (...,3,3)
First Piola-Kirchhoff stress. First Piola-Kirchhoff stress.
F : numpy.ndarray of shape (...,3,3) F : numpy.ndarray, shape (...,3,3)
Deformation gradient. Deformation gradient.
Returns Returns
------- -------
S : numpy.ndarray of shape (...,3,3) S : numpy.ndarray, shape (...,3,3)
Second Piola-Kirchhoff stress. Second Piola-Kirchhoff stress.
""" """
@ -213,12 +213,12 @@ def stretch_left(T: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the left stretch is computed. Tensor of which the left stretch is computed.
Returns Returns
------- -------
V : numpy.ndarray of shape (...,3,3) V : numpy.ndarray, shape (...,3,3)
Left stretch tensor from Polar decomposition of T. Left stretch tensor from Polar decomposition of T.
""" """
@ -231,12 +231,12 @@ def stretch_right(T: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the right stretch is computed. Tensor of which the right stretch is computed.
Returns Returns
------- -------
U : numpy.ndarray of shape (...,3,3) U : numpy.ndarray, shape (...,3,3)
Left stretch tensor from Polar decomposition of T. Left stretch tensor from Polar decomposition of T.
""" """
@ -249,7 +249,7 @@ def _polar_decomposition(T: _np.ndarray, requested: Sequence[str]) -> tuple:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the singular values are computed. Tensor of which the singular values are computed.
requested : iterable of str requested : iterable of str
Requested outputs: ‘R’ for the rotation tensor, Requested outputs: ‘R’ for the rotation tensor,
@ -279,7 +279,7 @@ def _equivalent_Mises(T_sym: _np.ndarray, s: float) -> _np.ndarray:
Parameters Parameters
---------- ----------
T_sym : numpy.ndarray of shape (...,3,3) T_sym : numpy.ndarray, shape (...,3,3)
Symmetric tensor of which the von Mises equivalent is computed. Symmetric tensor of which the von Mises equivalent is computed.
s : float s : float
Scaling factor (2/3 for strain, 3/2 for stress). Scaling factor (2/3 for strain, 3/2 for stress).

24
python/damask/tensor.py
View File

@ -14,12 +14,12 @@ def deviatoric(T: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the deviatoric part is computed. Tensor of which the deviatoric part is computed.
Returns Returns
------- -------
T' : numpy.ndarray of shape (...,3,3) T' : numpy.ndarray, shape (...,3,3)
Deviatoric part of T. Deviatoric part of T.
""" """
@ -32,12 +32,12 @@ def eigenvalues(T_sym: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T_sym : numpy.ndarray of shape (...,3,3) T_sym : numpy.ndarray, shape (...,3,3)
Symmetric tensor of which the eigenvalues are computed. Symmetric tensor of which the eigenvalues are computed.
Returns Returns
------- -------
lambda : numpy.ndarray of shape (...,3) lambda : numpy.ndarray, shape (...,3)
Eigenvalues of T_sym sorted in ascending order, each repeated Eigenvalues of T_sym sorted in ascending order, each repeated
according to its multiplicity. according to its multiplicity.
@ -51,14 +51,14 @@ def eigenvectors(T_sym: _np.ndarray, RHS: bool = False) -> _np.ndarray:
Parameters Parameters
---------- ----------
T_sym : numpy.ndarray of shape (...,3,3) T_sym : numpy.ndarray, shape (...,3,3)
Symmetric tensor of which the eigenvectors are computed. Symmetric tensor of which the eigenvectors are computed.
RHS: bool, optional RHS: bool, optional
Enforce right-handed coordinate system. Defaults to False. Enforce right-handed coordinate system. Defaults to False.
Returns Returns
------- -------
x : numpy.ndarray of shape (...,3,3) x : numpy.ndarray, shape (...,3,3)
Eigenvectors of T_sym sorted in ascending order of their Eigenvectors of T_sym sorted in ascending order of their
associated eigenvalues. associated eigenvalues.
@ -76,14 +76,14 @@ def spherical(T: _np.ndarray, tensor: bool = True) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the spherical part is computed. Tensor of which the spherical part is computed.
tensor : bool, optional tensor : bool, optional
Map spherical part onto identity tensor. Defaults to True. Map spherical part onto identity tensor. Defaults to True.
Returns Returns
------- -------
p : numpy.ndarray of shape (...,3,3) p : numpy.ndarray, shape (...,3,3)
unless tensor == False: shape (...,) unless tensor == False: shape (...,)
Spherical part of tensor T. p is an isotropic tensor. Spherical part of tensor T. p is an isotropic tensor.
@ -98,12 +98,12 @@ def symmetric(T: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the symmetrized values are computed. Tensor of which the symmetrized values are computed.
Returns Returns
------- -------
T_sym : numpy.ndarray of shape (...,3,3) T_sym : numpy.ndarray, shape (...,3,3)
Symmetrized tensor T. Symmetrized tensor T.
""" """
@ -116,12 +116,12 @@ def transpose(T: _np.ndarray) -> _np.ndarray:
Parameters Parameters
---------- ----------
T : numpy.ndarray of shape (...,3,3) T : numpy.ndarray, shape (...,3,3)
Tensor of which the transpose is computed. Tensor of which the transpose is computed.
Returns Returns
------- -------
T.T : numpy.ndarray of shape (...,3,3) T.T : numpy.ndarray, shape (...,3,3)
Transpose of tensor T. Transpose of tensor T.
""" """