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.6.tar.gz (317.3 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.6-py3-none-win_amd64.whl (1.1 MB view details)

Uploaded Python 3Windows x86-64

featomic-0.6.6-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.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl (1.1 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

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

Uploaded Python 3macOS 11.0+ x86-64

featomic-0.6.6-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.6.tar.gz.

File metadata

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

File hashes

Hashes for featomic-0.6.6.tar.gz
Algorithm Hash digest
SHA256 84eadf5ed7d8c21ac1887b6cf32aae23b3cd18e74ad8d0eb6213d4214a44aa52
MD5 4a925ed422f8f9724f6d162761f806fe
BLAKE2b-256 c7b245860cd34dc35910223aa581986654c7f538330b3a52d482c49ba194d78d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: featomic-0.6.6-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.13.12

File hashes

Hashes for featomic-0.6.6-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 befdec0729ad505d7602b976732a52f8f5ec734133f44f543c621618ea191294
MD5 46bf55a77e314e87634c7b0883fed93b
BLAKE2b-256 02bdebdb8895aab23d87adcc640584aaed5b9e359f1b158a4842d9d833dcf8b0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for featomic-0.6.6-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 aff7a56d5efa62eeebf16f41898e7a62b4fadcc6d163d3886bb65b5b936195bd
MD5 3f9b6beb4f9d19950184c45fd862b854
BLAKE2b-256 94096899a5a877ad3a420a506d752e70413c1b02295e130b5e682b2321448bba

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for featomic-0.6.6-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Algorithm Hash digest
SHA256 e3b9d508dcde690a1b98f789011879e4102911bcb8dc995138818461229c3a01
MD5 d9c298cd7da2899633a7d5f44e42a591
BLAKE2b-256 2f52a1d93afe6252820433e343a166c225f59271a6dddd205321abef85bc1c49

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for featomic-0.6.6-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 9a77fb092f59cfa88bf42efa169f8b4ad0f0d5233e52a6524481025f13813f2e
MD5 4344edeaf46b250aee7d80864c7b093f
BLAKE2b-256 763b1dd5fef53e4d04c569ed2ebe204d8f25f4de9eb0d3fb0f5d8f6f45f0d136

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for featomic-0.6.6-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 be127fbe540f737816ff6d1461678385e38d2d8635ce5fa96993d36de999df89
MD5 6af67eafe0f8cb7650e7af48ce5fc589
BLAKE2b-256 7285b747d2f217c59479b3469a28ade1370edaa056284cf0aee406c193cc57be

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