wulfric.crystal.hpkot_get_extended_bl_symbol#

wulfric.crystal.hpkot_get_extended_bl_symbol(cell, atoms, spglib_data=None)[source]#

Returns extended bravais lattice symbol as defined in the paper by Hinuma, Pizzi, Kumagai, Oba, and Tanaka [1].

Added in version 0.6.3.

Parameters:
cell(3, 3) array-like

Matrix of a cell, rows are interpreted as vectors.

atomsdict

Dictionary with N atoms. Expected keys:

  • "positions" : (N, 3) array-like

    Positions of the atoms in the basis of lattice vectors (cell). In other words - relative coordinates of atoms.

  • "names" : (N, ) list of str, optional

    See Notes

  • "species" : (N, ) list of str, optional

    See Notes

  • "spglib_types" : (N, ) list of int, optional

    See Notes

Hint

Pass atoms = dict(positions=[[0, 0, 0]], spglib_types=[1]) if you would like to interpret the cell alone (effectively assuming that the cell is a primitive one).

spglib_dataSyntacticSugar, optional

If you need more control on the parameters passed to the spglib, then you can get spglib_data manually and pass it to this function. Use wulfric's interface to spglib as

spglib_data = wulfric.get_spglib_data(...)

using the same cell and atoms["positions"] that you are passing to this function.

Returns:
extended_bl_typestr

Extended Bravais lattice symbol.

Notes

spglib uses types to distinguish the atoms. To see how wulfric deduces the types for given atoms see wulfric.get_spglib_types().

References

[1]

Hinuma, Y., Pizzi, G., Kumagai, Y., Oba, F. and Tanaka, I., 2017. Band structure diagram paths based on crystallography. Computational Materials Science, 128, pp.140-184.

Examples

>>> import wulfric
>>> wulfric.crystal.hpkot_get_extended_bl_symbol(
...     cell=[[1, 0, 0], [0, 1, 0], [0, 0, 1]],
...     atoms=dict(positions=[[0, 0, 0]], spglib_types=[1]),
... )
'cP2'