Tensors and named properties¶
tensorForm (Python tensor_form) gives the form of a property tensor under a point group: which
components are allowed and how they are related. tensorFormOf does the same for any list of
operations, for instance the site symmetry of a surface normal.
The kind of tensor¶
A tensor is given by its specification:
Field |
Values |
Meaning |
|---|---|---|
|
0 to 4 |
number of indices |
|
|
an axial tensor changes sign under improper operations (factor det R) |
|
|
a |
|
|
the index symmetry |
Second-harmonic generation, for example, is { rank: 3, parity: 'polar', intrinsic: 'jk' }:
χijk = χikj. The index symmetries are explained in the reference
(IntrinsicSymmetry) and in Conventions, “Tensors”.
The result¶
A form has
basis: the allowed tensors as rows of length 3rank, in reduced row echelon form, components by flat index with the first index slowest (xyz of rank 3 is 5). Every allowed tensor is Σk pk · basis[k];parameters: the free components as index lists, one per row ofbasis, each the lowest component independent of those before it;relations: rows r with r · t = 0 for every allowed tensor t.
import symcrys
form = symcrys.tensor_form("3m", {"rank": 3, "parity": "polar", "intrinsic": "jk"})
form["parameters"]
array([[0, 0, 1],
[0, 0, 2],
[2, 0, 0],
[2, 2, 2]])
The components depend on the frame, so on the setting and on the convention: the default
setting of 3m is 3m1 in the ITC convention and setting 1 in the Birss convention, which Birss
writes 3m and ITC 31m. The free components differ:
SHG = {"rank": 3, "parity": "polar", "intrinsic": "jk"}
[symcrys.tensor_form("3m", SHG, convention=c)["parameters"][0] for c in ("itc", "birss")]
[array([0, 0, 1]), array([0, 0, 0])]
The same setting index gives the same form in both conventions; only the default differs. Settings and frames: Conventions, “Settings” and Conventions, “Cartesian frame”.
Named properties¶
A property that is the question whether a tensor is allowed has a name, an entry of
TENSOR_PROPERTIES. The name stands in for the specification in tensorForm, tensorFormOf and
rotateTensor, and allowsProperty, allowedProperties (and their …Of forms for a list of
operations) answer whether symmetry allows it. Symmetry only allows a property; whether a crystal
shows it is a question of the material.
The table is made from TENSOR_PROPERTIES of this version:
Name |
Tensor |
In |
Description |
Source |
|---|---|---|---|---|
|
rank 1, polar, time-even (i), intrinsic none |
yes |
Spontaneous electric polarization, which changes with temperature: a polar vector p_i. |
ITC Vol. D (2013), § 1.1.4.4.2, p. 12; classes: ITA (2016) Table 3.2.2.1, p. 738 |
|
rank 1, axial, time-even (i), intrinsic none |
yes |
Ferroaxial (ferro-rotational) order, e.g. a net rotation of structural units about an axis: an axial vector A_i. |
Hlinka, Privratska, Ondrejkovic & Janovec, Phys. Rev. Lett. 116, 177602 (2016); classes: Birss (1966), Tables 4a and 4c, pp. 56–58 |
|
rank 3, polar, time-even (i), intrinsic jk |
yes |
Electric polarization linear in stress, P_i = d_ijk T_jk: a polar tensor of rank 3, symmetric in j, k. |
ITC Vol. D (2013), § 1.1.4.4.3, p. 12; classes: ITA (2016) Table 3.2.2.1, p. 738 |
|
rank 2, axial, time-even (i), intrinsic ij |
yes |
Optical activity (optical rotation), G = g_ij α_i α_j: the symmetric part of the axial gyration tensor of rank 2. |
ITC Vol. D (2013), § 1.1.4.10.7.2, p. 30; classes: ITA (2016) Table 3.2.2.1, p. 738 |
|
rank 1, axial, time-odd (c), intrinsic none |
no (magnetic API only) |
Spontaneous magnetization M_s (ferromagnets, ferrimagnets, weak ferromagnets): an axial vector that changes sign under time reversal. |
ITC Vol. D (2013), § 1.5.2.1 with Table 1.5.2.4, p. 113 |
|
rank 2, axial, time-odd (c), intrinsic none |
no (magnetic API only) |
Linear magnetoelectric effect, P_i = α_ij H_j: an axial tensor of rank 2 that changes sign under time reversal. |
ITC Vol. D (2013), § 1.5.8.1 with eqs. (1.5.8.2), (1.5.8.3) and Table 1.5.8.1, pp. 139–140 |
|
rank 3, axial, time-odd (c), intrinsic jk |
no (magnetic API only) |
Magnetization linear in stress, M_i = Λ_ijk T_jk: an axial tensor of rank 3, symmetric in j, k, that changes sign under time reversal. |
ITC Vol. D (2013), § 1.5.7.1 with eq. (1.5.7.2) and Table 1.5.7.1, pp. 134–135 |
Second-harmonic generation has the tensor of 'piezoelectric' and so no name of its own.
symcrys.allows_property("432", "piezoelectric"), symcrys.tensor_form("-3", "ferroaxial")["parameters"]
(False, array([[2]]))