Skip to main content

Computing representations for atomistic machine learning

Project description

Tests status Documentation Coverage Status

Featomic is a library for the efficient computing of representations for atomistic machine learning also called “descriptors” or “fingerprints”. These representations can be used for atomistic machine learning (ml) models including ml potentials, visualization or similarity analysis.

The core of the library is written in Rust and we provide APIs for C/C++ and Python as well.

List of implemented representations

representation

description

gradients

Spherical expansion

Atoms are represented by the expansion of their neighbor’s density on radial basis and spherical harmonics. This is the core of representations in SOAP (Smooth Overlap of Atomic Positions)

positions, strain, cell

SOAP radial spectrum

Atoms are represented by 2-body correlations of their neighbors’ density

positions, strain, cell

SOAP power spectrum

Atoms are represented by 3-body correlations of their neighbors’ density

positions, strain, cell

LODE Spherical Expansion

Core of representations in LODE (Long distance equivariant)

positions

Sorted distances

Each atom is represented by a vector of distance to its neighbors within the spherical cutoff

no

Neighbor List

Each pair is represented by the vector between the atoms. This is intended to be used as a starting point for more complex representations

positions

AtomicComposition

Obtaining the stoichiometric information of a system

positions, strain, cell

For details, tutorials, and examples, please have a look at our documentation.

Citing featomic

If you found featomic useful for your work, please cite the corresponding article:

F. Bigi, J.W. Abbott, P. Loche et al., Metatensor and metatomic: foundational libraries for interoperable atomistic machine learning, (2026). https://doi.org/10.1063/5.0304911

@article{bigi_metatensor_2026,
  title = {Metatensor and Metatomic: {{Foundational}} Libraries for Interoperable Atomistic Machine Learning},
  shorttitle = {Metatensor and Metatomic},
  author = {Bigi, Filippo and Abbott, Joseph W. and Loche, Philip and Mazitov, Arslan and Tisi, Davide and Langer, Marcel F. and Goscinski, Alexander and Pegolo, Paolo and Chong, Sanggyu and Goswami, Rohit and Febrer, Pol and Chorna, Sofiia and Kellner, Matthias and Ceriotti, Michele and Fraux, Guillaume},
  year = 2026,
  month = feb,
  journal = {J. Chem. Phys.},
  volume = {164},
  number = {6},
  pages = {064113},
  issn = {0021-9606},
  doi = {10.1063/5.0304911},
}

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

featomic-0.6.7.tar.gz (319.2 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

featomic-0.6.7-py3-none-win_amd64.whl (1.1 MB view details)

Uploaded Python 3Windows x86-64

featomic-0.6.7-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (1.2 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

featomic-0.6.7-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

featomic-0.6.7-py3-none-macosx_11_0_x86_64.whl (1.2 MB view details)

Uploaded Python 3macOS 11.0+ x86-64

featomic-0.6.7-py3-none-macosx_11_0_arm64.whl (1.0 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file featomic-0.6.7.tar.gz.

File metadata

  • Download URL: featomic-0.6.7.tar.gz
  • Upload date:
  • Size: 319.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for featomic-0.6.7.tar.gz
Algorithm Hash digest
SHA256 b683d2ef127a2813e727eaf34a9caee40e5354ce56c5624f2adf7df52f930f40
MD5 8672c650c259613fd06dca114f28120f
BLAKE2b-256 f56f43e6bd1005037c55899f60069ab5c29835ecfc43c0ca4449ae46efcf212b

See more details on using hashes here.

File details

Details for the file featomic-0.6.7-py3-none-win_amd64.whl.

File metadata

  • Download URL: featomic-0.6.7-py3-none-win_amd64.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for featomic-0.6.7-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 f27530cb98f91c524c1826509395e16818738e2fcbe67b14f457c7977a4a800e
MD5 c9ea9bcd72be046e1a8a85c7d7f2ab90
BLAKE2b-256 43f7e965b76ec00e66b1ebaa73128a790b71d6bb84a3d64d95b0b78b7aa585f2

See more details on using hashes here.

File details

Details for the file featomic-0.6.7-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for featomic-0.6.7-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 7ffc4b7df849a36fc6d1402a43c6ae88ac58cee4a443195e8df0e0bb16bb74cb
MD5 cdde76ed92aa65c7efd60ede34e4ab19
BLAKE2b-256 71f5c6d5e8599528ebc77fdfe1a1cfd5ebd2b31c6d8f9c610b07d16d7cbeea21

See more details on using hashes here.

File details

Details for the file featomic-0.6.7-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl.

File metadata

File hashes

Hashes for featomic-0.6.7-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 3df497aa4cbadd3e4e3a865ad1c5ee351f2007c40dbc5cc2a2bc687b53368985
MD5 ea2a756e5f9a1404570f0a83aa4626ed
BLAKE2b-256 b5c047068e41c8e7a8d909347feeb7664f903b32ca22f4bcc3d7f4ec1fc09334

See more details on using hashes here.

File details

Details for the file featomic-0.6.7-py3-none-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for featomic-0.6.7-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 13502487d4925fca287c443cee47d7efa7f6c295b5aec2afe6941b8b5ae1a559
MD5 5801a7baa92355f2924731e2ad2ce852
BLAKE2b-256 70486466d8e501f6681d2999d6c7c279532792811856e3fb498f1ad57a739a7e

See more details on using hashes here.

File details

Details for the file featomic-0.6.7-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for featomic-0.6.7-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 112d85f775735c1d9387a12876c2b26adefd68db82f7071dfe5adf4dddd4f647
MD5 b57a4322f43d6ed95b79d283c52ce5e9
BLAKE2b-256 4ea5da8356d0586c09e6aa61e2d18e9946e1ea5494d36c4d7b5d5e7c67e91e58

See more details on using hashes here.

Supported by

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