Two readings of a key¶
The 32 crystal classes are not simply the 32 white magnetic point groups. A key such as '32' has
two readings, and the entry point you import says which one you mean:
Import |
Groups |
|
|---|---|---|
|
the 32 crystal classes, no time reversal |
the crystal class of quartz |
|
the 122 magnetic point groups |
a white group: a magnetically ordered crystal whose symmetry contains no time reversal at all |
In a purely crystallographic application you work with crystal classes, and '32' is the class of
quartz. Where magnetism plays a part, a crystal without magnetic order has the grey group of its
class, the class combined with time reversal: quartz has "321'". The white group '32' there
describes a magnetically ordered crystal, which allows time-odd properties that quartz does not
have.
Quartz¶
// Quartz in the two readings of the key '32'.
import * as crystal from 'symcrys';
import * as magnetic from 'symcrys/magnetic';
console.log('crystal class 32:', crystal.allowedProperties('32'));
console.log("grey group 321':", magnetic.allowedProperties("321'"));
console.log('white group 32:', magnetic.allowedProperties('32'));
// A question that involves time reversal is an error in the crystallographic API.
try {
crystal.allowedProperties("321'" as crystal.PointGroupKey);
} catch (e) {
console.log((e as Error).message);
}
Output:
crystal class 32: [ 'piezoelectric', 'gyrotropic' ]
grey group 321': [ 'piezoelectric', 'gyrotropic' ]
white group 32: [ 'piezoelectric', 'gyrotropic', 'magnetoelectric', 'piezomagnetic' ]
"321'" is a magnetic point group, not a crystal class: the crystallographic API has no time reversal; use the magnetic API ('symcrys/magnetic', in Python symcrys.magnetic)
The same in Python:
import symcrys
from symcrys import magnetic
print("crystal class 32:", symcrys.allowed_properties("32"))
print("grey group 321':", magnetic.allowed_properties("321'"))
print("white group 32:", magnetic.allowed_properties("32"))
crystal class 32: ['piezoelectric', 'gyrotropic']
grey group 321': ['piezoelectric', 'gyrotropic']
white group 32: ['piezoelectric', 'gyrotropic', 'magnetoelectric', 'piezomagnetic']
The crystal class and the grey group allow the same properties: time reversal is a symmetry of the
grey group, so every time-odd tensor vanishes. The white group '32' in addition allows the
magnetoelectric and the piezomagnetic effect, which need magnetic order.
Which one to use¶
Crystallography without magnetism (morphology, stereographic projection, piezoelectricity, optical activity, second-harmonic generation of a non-magnetic crystal):
symcrys, the crystal classes.Magnetism (magnetic order, magnetoelectric or piezomagnetic effect, time-odd tensors):
symcrys/magnetic. A non-magnetic crystal is then its grey group ("321'"), a magnetically ordered one its white or black-and-white group ('32',"3'2'"…).
A question that involves time reversal (a magnetic key, a time-odd tensor or property, an operation with time reversal) is an error in the crystallographic API, because a wrong reading should fail rather than answer. The rules, with their print sources (Birss p. 84; ITC Vol. D, Ch. 1.5), are in Conventions, “Two entry points”.