# Spin-orbit compatibility (crystod-group --correlate-double-group); testsuite section 02-17
# For every single-valued (spinless) small irrep Gamma at a k point, the double-valued
# (spinor) small irreps of Gamma x D(1/2): what a level of a scalar-relativistic band
# structure becomes when spin-orbit coupling is switched on.
# - Single-valued labels: the ISO-IR labels of every other crystod-group mode.
#   Double-valued names: those of crystod --spinor (overbar written as a leading '-',
#   index after the single-valued irreps, parity suffix; Bradley & Cracknell (1972)
#   Table 6.5 numbering, with NOTE lines where CrystOD differs: 32, 3m, -3m and the
#   cyclic co-groups with complex-conjugate pairs).
# - The number in parentheses after every label is its dimension: the double-valued
#   irreps on the right add up to twice the dimension on the left ("2 -GM2(1)" is a
#   multiplicity).
# - --kpoint: a special-point name or three coordinates (any arm, any k + G); off the
#   special points, the relations on that line or plane. Without --kpoint: every
#   special point of the space group, one block each.
# - Complex-conjugate irreps are listed one by one (time reversal is not applied).
# No input file is needed; nothing is written.

$ crystod-group --correlate-double-group --sg Pm-3m --kpoint R

* Space group *
Pm-3m (No. 221)

* Compatibility relations *
k point R (1/2, 1/2, 1/2) (primitive basis): irrep x D(1/2) -> double-valued irreps
  R1+(1) -> -R6+(2)
  R2+(1) -> -R7+(2)
  R3+(2) -> -R8+(4)
  R4+(3) -> -R6+(2) + -R8+(4)
  R5+(3) -> -R7+(2) + -R8+(4)
  R1-(1) -> -R6-(2)
  R2-(1) -> -R7-(2)
  R3-(2) -> -R8-(4)
  R4-(3) -> -R6-(2) + -R8-(4)
  R5-(3) -> -R7-(2) + -R8-(4)

$ crystod-group --correlate-double-group --sg Pm-3m

* Space group *
Pm-3m (No. 221)

* Compatibility relations *
k point GM (0, 0, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  GM1+(1) -> -GM6+(2)
  GM2+(1) -> -GM7+(2)
  GM3+(2) -> -GM8+(4)
  GM4+(3) -> -GM6+(2) + -GM8+(4)
  GM5+(3) -> -GM7+(2) + -GM8+(4)
  GM1-(1) -> -GM6-(2)
  GM2-(1) -> -GM7-(2)
  GM3-(2) -> -GM8-(4)
  GM4-(3) -> -GM6-(2) + -GM8-(4)
  GM5-(3) -> -GM7-(2) + -GM8-(4)

* Compatibility relations *
k point R (1/2, 1/2, 1/2) (primitive basis): irrep x D(1/2) -> double-valued irreps
  R1+(1) -> -R6+(2)
  R2+(1) -> -R7+(2)
  R3+(2) -> -R8+(4)
  R4+(3) -> -R6+(2) + -R8+(4)
  R5+(3) -> -R7+(2) + -R8+(4)
  R1-(1) -> -R6-(2)
  R2-(1) -> -R7-(2)
  R3-(2) -> -R8-(4)
  R4-(3) -> -R6-(2) + -R8-(4)
  R5-(3) -> -R7-(2) + -R8-(4)

* Compatibility relations *
k point X (0, 1/2, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  X1+(1) -> -X6+(2)
  X2+(1) -> -X7+(2)
  X3+(1) -> -X6+(2)
  X4+(1) -> -X7+(2)
  X5+(2) -> -X6+(2) + -X7+(2)
  X1-(1) -> -X6-(2)
  X2-(1) -> -X7-(2)
  X3-(1) -> -X6-(2)
  X4-(1) -> -X7-(2)
  X5-(2) -> -X6-(2) + -X7-(2)

* Compatibility relations *
k point M (1/2, 1/2, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  M1+(1) -> -M6+(2)
  M2+(1) -> -M7+(2)
  M3+(1) -> -M6+(2)
  M4+(1) -> -M7+(2)
  M5+(2) -> -M6+(2) + -M7+(2)
  M1-(1) -> -M6-(2)
  M2-(1) -> -M7-(2)
  M3-(1) -> -M6-(2)
  M4-(1) -> -M7-(2)
  M5-(2) -> -M6-(2) + -M7-(2)

$ crystod-group --correlate-double-group --sg R-3m --kpoint GM

* Space group *
R-3m (No. 166)

* Compatibility relations *
k point GM (0, 0, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  GM1+(1) -> -GM6+(2)
  GM2+(1) -> -GM6+(2)
  GM3+(2) -> -GM4+(1) + -GM5+(1) + -GM6+(2)
  GM1-(1) -> -GM6-(2)
  GM2-(1) -> -GM6-(2)
  GM3-(2) -> -GM4-(1) + -GM5-(1) + -GM6-(2)
NOTE: Bradley & Cracknell (1972) number the two-dimensional irrep GM4+- and
      the pair GM5+-, GM6+- (Table 6.5); here the pair is -GM4+-, -GM5+- and
      the two-dimensional irrep -GM6+-

$ crystod-group --correlate-double-group --sg P4/m --kpoint GM

* Space group *
P4/m (No. 83)

* Compatibility relations *
k point GM (0, 0, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  GM1+(1) -> -GM5+(1) + -GM6+(1)
  GM2+(1) -> -GM7+(1) + -GM8+(1)
  GM3+(1) -> -GM5+(1) + -GM7+(1)
  GM4+(1) -> -GM6+(1) + -GM8+(1)
  GM1-(1) -> -GM5-(1) + -GM6-(1)
  GM2-(1) -> -GM7-(1) + -GM8-(1)
  GM3-(1) -> -GM5-(1) + -GM7-(1)
  GM4-(1) -> -GM6-(1) + -GM8-(1)
NOTE: the complex-conjugate pairs are ordered after the single-valued ISO-IR
      labels; Bradley & Cracknell (1972) Tables 6.5 and 6.14 number them
      inconsistently

$ crystod-group --correlate-double-group --sg Fd-3m --kpoint X

* Space group *
Fd-3m (No. 227)

* Compatibility relations *
k point X (1/2, 0, 1/2) (primitive basis): irrep x D(1/2) -> double-valued irreps
  X1(2) -> -X5(4)
  X2(2) -> -X5(4)
  X3(2) -> -X5(4)
  X4(2) -> -X5(4)

$ crystod-group --correlate-double-group --sg P6/mmm --kpoint GM

* Space group *
P6/mmm (No. 191)

* Compatibility relations *
k point GM (0, 0, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  GM1+(1) -> -GM7+(2)
  GM2+(1) -> -GM7+(2)
  GM3+(1) -> -GM8+(2)
  GM4+(1) -> -GM8+(2)
  GM5+(2) -> -GM8+(2) + -GM9+(2)
  GM6+(2) -> -GM7+(2) + -GM9+(2)
  GM1-(1) -> -GM7-(2)
  GM2-(1) -> -GM7-(2)
  GM3-(1) -> -GM8-(2)
  GM4-(1) -> -GM8-(2)
  GM5-(2) -> -GM8-(2) + -GM9-(2)
  GM6-(2) -> -GM7-(2) + -GM9-(2)

$ crystod-group --correlate-double-group --sg Pm-3m --kpoint 0 1/4 0

* Space group *
Pm-3m (No. 221)

* Compatibility relations *
line DT (0, 1/4, 0) (primitive basis): irrep x D(1/2) -> double-valued irreps
  DT1(1) -> -DT6(2)
  DT2(1) -> -DT7(2)
  DT3(1) -> -DT7(2)
  DT4(1) -> -DT6(2)
  DT5(2) -> -DT6(2) + -DT7(2)
