Skip to main content

An interface to atomistic simulation codes including but not limited to GPAW, LAMMPS, S/Phi/nX and VASP.

Project description

Coverage Status Codacy Badge Release_Date Build Status Downloads Documentation Status Screenshot of pyiron running inside jupyterlab.

pyiron - an integrated development environment (IDE) for computational materials science. It combines several tools in a common platform:

  • Atomic structure objects – compatible to the Atomic Simulation Environment (ASE).

  • Atomistic simulation codes – like LAMMPS and VASP.

  • Feedback Loops – to construct dynamic simulation life cycles.

  • Hierarchical data management – interfacing with storage resources like SQL and HDF5.

  • Integrated visualization – based on NGLview.

  • Interactive simulation protocols - based on Jupyter notebooks.

  • Object oriented job management – for scaling complex simulation protocols from single jobs to high-throughput simulations.

pyiron (called pyron) is developed in the Computational Materials Design department of Joerg Neugebauer at the Max Planck Institut für Eisenforschung (Max Planck Institute for iron research). While its original focus was to provide a framework to develop and run complex simulation protocols as needed for ab initio thermodynamics it quickly evolved into a versatile tool to manage a wide variety of simulation tasks. In 2016 the Interdisciplinary Centre for Advanced Materials Simulation (ICAMS) joined the development of the framework with a specific focus on high throughput applications. In 2018 pyiron was released as open-source project. See the Documentation page for more details.

Installation

You can test pyiron on Mybinder.org (beta). For a local installation we recommend to install pyiron inside an anaconda environment:

conda install -c conda-forge pyiron

After the installation of pyiron you need to configure pyiron. The default configuration can be generated automatically. Start a new Python session and import pyiron:

> import pyiron
> pyiron.install()
>>> It appears that pyiron is not yet configured, do you want to create a default start configuration (recommended: yes). [yes/no]:
> yes
> exit()

See the Documentation-Installation page for more details.

Example

After the successful configuration you can start your first pyiron calculation. Navigate to the projects directory and start a jupyter notebook or jupyter lab session correspondingly:

cd ~/pyiron/projects
jupyter notebook

Open a new jupyter notebook and inside the notebook you can now validate your pyiron calculation by creating a test project, setting up an initial structure of bcc Fe and visualize it using NGLview:

from pyiron_atomistics import Project
pr = Project('test')
structure = pr.create_structure('Fe', 'bcc', 2.78)
structure.plot3d()

Finally a first lammps calculation can be executed by:

job = pr.create_job(job_type=pr.job_type.Lammps, job_name='lammpstestjob')
job.structure = structure
job.potential = job.list_potentials()[0]
job.run()

Getting started:

Test pyiron with mybinder:

mybinder

License and Acknowledgments

pyiron is licensed under the BSD license.

If you use pyiron in your scientific work, please consider citing

@article{pyiron-paper,
  title = {pyiron: An integrated development environment for computational materials science},
  journal = {Computational Materials Science},
  volume = {163},
  pages = {24 - 36},
  year = {2019},
  issn = {0927-0256},
  doi = {https://doi.org/10.1016/j.commatsci.2018.07.043},
  url = {http://www.sciencedirect.com/science/article/pii/S0927025618304786},
  author = {Jan Janssen and Sudarsan Surendralal and Yury Lysogorskiy and Mira Todorova and Tilmann Hickel and Ralf Drautz and Jörg Neugebauer},
  keywords = {Modelling workflow, Integrated development environment, Complex simulation protocols},
}

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pyiron_atomistics-0.4.18.tar.gz (311.0 kB view details)

Uploaded Source

Built Distribution

pyiron_atomistics-0.4.18-py3-none-any.whl (374.8 kB view details)

Uploaded Python 3

File details

Details for the file pyiron_atomistics-0.4.18.tar.gz.

File metadata

  • Download URL: pyiron_atomistics-0.4.18.tar.gz
  • Upload date:
  • Size: 311.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for pyiron_atomistics-0.4.18.tar.gz
Algorithm Hash digest
SHA256 e2e86c21003f9b57c9605c13c8d7e44c4e21eadb9e1fefaa6136e065b76a0fb1
MD5 71ed1d77dcac5b38c1efdc30d600332a
BLAKE2b-256 5d5ba25e720fefdba1063bcda2f5cc80ad7940f9ea5ee1f4ba56534b6c8d4b39

See more details on using hashes here.

File details

Details for the file pyiron_atomistics-0.4.18-py3-none-any.whl.

File metadata

File hashes

Hashes for pyiron_atomistics-0.4.18-py3-none-any.whl
Algorithm Hash digest
SHA256 a326ddd585d8cbfa156d3fe3071136b334c769105f8bb297855901e67e06bb8c
MD5 6af8060a74e77dff3efc966f0aa92763
BLAKE2b-256 cefcf8a19538f9e4684270e1ed0a3080739e7c67981ce5d91729f88f682acd9e

See more details on using hashes here.

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