Skip to main content

Symmetry finder and symmetric Hamiltonian generator

Project description


Install with pip install wtih conda pipeline status coverage report docs status

Symmetry finder and symmetric Hamiltonian generator

qsymm is an open-source Python library that makes symmetry analysis simple.

It automatically generates model Hamiltonians from symmetry constraints and finds the full symmetry group of your Hamiltonian.

Check out the introductory tutorial to see examples of how to use qsymm.

Implemented algorithms

summary of methods

The two core concepts in qsymm are Hamiltonian families (Hamiltonians that may depend on free parameters) and symmetries. We provide powerful classes to handle these:

  • Model is used to store symbolic Hamiltonians that may depend on momenta and other free parameters. We use sympy for symbolic manipulation, but our implementation utilizes numpy arrays for efficient calculations with matrix valued functions.

  • PointGroupElement and ContinuousGroupGenerator are used to store symmetry operators. Besides the ability to combine symmetries, they can also be applied to a Model to transform it.

We implement algorithms that form a two-way connection between Hamiltonian families and symmetries.


qsymm works with Python 3.5 and is available on PyPI:

pip install qsymm

Some of the example notebooks also require Kwant.


Qsymm's documentation is hosted on Read the Docs


Check out for instructions on how to cite Qsymm in your publications.


qsymm is on Gitlab, visit there if you would like to to contribute, report issues, or get the latest development version.

Project details

Download files

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

Files for qsymm, version 1.3.0
Filename, size File type Python version Upload date Hashes
Filename, size qsymm-1.3.0-py3-none-any.whl (83.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size qsymm-1.3.0.tar.gz (79.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page