Skip to main content

Introduction

The potentials package provides a Python-based interface to the content hosted on the NIST Interatomic Potentials Repository. The package directly interacts with the underlying database hosted at https://potentials.nist.gov/ allowing for the metadata for all hosted interatomic potentials to be searched and explored.

This package is integrated into atomman and iprPy, which both extend the database interactions provided here. For example, atomman adds the ability to interact with atomic structure records in the NIST database, and iprPy further adds the ability to interact with property calculation results. See the documentation for those packages if you are interested in exploring more than just interatomic potential information.

Installation

The potentials package can easily be installed using pip or conda-forge

pip install potentials

or

conda install -c conda-forge potentials

Documentation

The documentation for the potentials package consists of Jupyter Notebooks contained in the doc directory. These describe the different components of the package and provide working examples.

Basic Search Tools

  • 0. Search Potential Entries.ipynb colab logo provides a user-friendly interface for searching and exploring the known interatomic potentials.

  • 0. Search LAMMPS Potentials.ipynb colab logo provides a user-friendly interface for searching and exploring the known LAMMPS interatomic potentials. Parameter files can be downloaded, and the associated LAMMPS command lines shown.

In-depth Documentation

More in-depth documentation can be found in the doc subfolder. The Notebooks located there provide information as to the design of the potentials package, how to change default settings, and options that are specific to the supported record styles.

Scripts

The scripts subfolder contains additional Notebooks that relate to managing the NIST database using the potentials package. These are provided as examples of using the potentials package for various tasks to help more advanced users get started. WARNING: The Notebooks in scripts are working documents and are not guaranteed to have 100% current code or data, and may have poor descriptions.

Metadata

Release files for potentials 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for potentials 0.4.2
File Size Uploaded Provenance
potentials-0.4.2.tar.gz 157.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for potentials 0.4.2
File Interpreter ABI Platform
potentials-0.4.2-py3-none-any.whl Python 3 none any Details

Total release size: 367.0 kB

Release files / potentials-0.4.2.tar.gz

Download URL potentials-0.4.2.tar.gz
Size 157.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b5ee4aea363166e4c516bce54962ce4d81c91368dbf3b70e5c0a9f9c9038da68
BLAKE2b-256 checksum
How to use checksums
5ad65f6d76d56924dd07fce88511920ca9c72e79646026cb1f44a4ca7621ea99
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / potentials-0.4.2-py3-none-any.whl

Download URL potentials-0.4.2-py3-none-any.whl
Size 209.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5374c15d22ce718a99b3155cc42d1dd7801c85cd25c4a850e06275b52939d3c4
BLAKE2b-256 checksum
How to use checksums
cfc55fd76426b43aa4f96e6e76eaee5d9737badd141418317535de8716084d65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for potentials 0.4.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page