Skip to main content

A package for making Wulff constructions

Project description

WulffPack is a tool for making Wulff constructions, typically for minimizing the energy of nanoparticles. A detailed description of the functionality provided as well as an extensive tutorial can be found in the user guide.

WulffPack constructs both continuum models and atomistic structures for further modeling with, e.g., molecular dynamics or density functional theory.

from wulffpack import SingleCrystal
from import write
surface_energies = {(1, 1, 1): 1.0, (1, 0, 0): 1.2}
particle = SingleCrystal(surface_energies)
write('', particle.atoms)

With the help of ASE and Spglib, WulffPack handles any crystalline symmetry. WulffPack also provides the backbone of a web application in SHARC, in which Wulff constructions for cubic crystals can be created interactively.


In the most simple case, WulffPack can be installed using pip as follows:

pip3 install wulffpack --user

or alternatively:

python3 -m pip install wulffpack --user

WulffPack is based on Python3 and invokes functionality from other Python libraries including


WulffPack has been developed at Chalmers University of Technology in Gothenburg (Sweden) in the Materials and Surface Theory division at the Department of Physics.

When using WulffPack in your research please cite

J. Magnus Rahm and Paul Erhart
WulffPack: A Python package for Wulff constructions
J. Open Source Softw. 5, 1944 (2020)


Bugs and feature requests are ideally submitted via the gitlab issue tracker. The development team can also be reached by email via

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 wulffpack, version 1.2
Filename, size File type Python version Upload date Hashes
Filename, size wulffpack-1.2-py2.py3-none-any.whl (32.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size wulffpack-1.2.tar.gz (26.4 kB) File type Source Python version None Upload date Hashes View

Supported by

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