Skip to main content

Irreducible Brillouin zone symmetry and interpolation.

Project description

brille

A C++ library for symmetry operations and linear interpolation within an irreducible part of the first Brillouin zone. Wrapped for use in python using pybind11.

irreducible polyhedron

When provided with the lattice parameters or basis vectors of a real space spacegroup and its Hall symbol or number as determined by, e.g., Spglib, brille can

  • construct the first Brillouin zone
  • determine its high symmetry points
  • find a irreducible polyhedron and verify that its conforms to the pointgroup symmetry of the spacegroup.

Constructing and irreducible Brillouin zone polyhedron for a face centered cubic lattice can be accomplished with, e.g.,

	import brille

	direct_lattice = brille.Direct((4.96, 4.96, 4.96), (90, 90, 90), 'Fd-3m')
	brillouin_zone = brille.BrillouinZone(direct_lattice.star)

interpolation

Interpolating eigenvalues and eigenvectors across a degenerate point could lead to misidentified equivalent modes. Since the eigenvectors are distinguishable at all points away from the high-symmetry directions, a hybrid orthogonal/triangulated grid defined in an irreducible part of the Brillouin zone can be used to avoid mode misidentification.

brille can construct

  • an orthogonal grid guaranteed to contain the first Brillouin zone
  • a triangulated set of points filling an irreducible polyhedron or the first Brillouin zone
  • or a hybrid orthogonal/triangulated grid where only the surface cells are triangulated to improve point location time while preserving polyhedral conformity.

Of these options the third is most appropriate for the interpolation of models used in the analysis of inelastic neutron scattering data is the hybrid grid.

Dependencies

TetGen

A modified version of TetGen is used to create refined tetrahedral meshes in the irreducible portion of the first Brillouin zone.

The modified version is included as part of this repository.

Installation

From the root folder of this repository use Python 3 to build and install this library.

python setup.py install

Alternatively, the python module, C++ library, and catch2 based tests can be built directly using cmake.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brille-0.7.0.tar.gz (2.1 MB view hashes)

Uploaded Source

Built Distributions

brille-0.7.0-cp311-cp311-win_amd64.whl (2.5 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

brille-0.7.0-cp311-cp311-musllinux_1_1_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ x86-64

brille-0.7.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

brille-0.7.0-cp311-cp311-macosx_10_15_x86_64.whl (3.2 MB view hashes)

Uploaded CPython 3.11 macOS 10.15+ x86-64

brille-0.7.0-cp310-cp310-win_amd64.whl (2.5 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

brille-0.7.0-cp310-cp310-musllinux_1_1_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

brille-0.7.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

brille-0.7.0-cp310-cp310-macosx_10_15_x86_64.whl (3.2 MB view hashes)

Uploaded CPython 3.10 macOS 10.15+ x86-64

brille-0.7.0-cp39-cp39-win_amd64.whl (2.5 MB view hashes)

Uploaded CPython 3.9 Windows x86-64

brille-0.7.0-cp39-cp39-musllinux_1_1_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

brille-0.7.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

brille-0.7.0-cp39-cp39-macosx_10_15_x86_64.whl (3.2 MB view hashes)

Uploaded CPython 3.9 macOS 10.15+ x86-64

brille-0.7.0-cp38-cp38-win_amd64.whl (2.5 MB view hashes)

Uploaded CPython 3.8 Windows x86-64

brille-0.7.0-cp38-cp38-musllinux_1_1_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ x86-64

brille-0.7.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

brille-0.7.0-cp38-cp38-macosx_10_15_x86_64.whl (3.2 MB view hashes)

Uploaded CPython 3.8 macOS 10.15+ x86-64

brille-0.7.0-cp37-cp37m-win_amd64.whl (2.5 MB view hashes)

Uploaded CPython 3.7m Windows x86-64

brille-0.7.0-cp37-cp37m-musllinux_1_1_x86_64.whl (3.9 MB view hashes)

Uploaded CPython 3.7m musllinux: musl 1.1+ x86-64

brille-0.7.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

brille-0.7.0-cp37-cp37m-macosx_10_15_x86_64.whl (3.2 MB view hashes)

Uploaded CPython 3.7m macOS 10.15+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page