Metadata-Version: 2.4
Name: featomic
Version: 0.6.4
Summary: Computing representations for atomistic machine learning
Author: Guillaume Fraux, Philip Loche, Sergei Kliavinek, Kevin Kazuki Huguenin-Dumittan, Davide Tisi, Alexander Goscinski
License-Expression: BSD-3-Clause
Project-URL: homepage, https://metatensor.github.io/featomic/latest/
Project-URL: documentation, https://metatensor.github.io/featomic/latest/
Project-URL: repository, https://github.com/metatensor/featomic
Keywords: computational science,machine learning,molecular modeling,atomistic representations
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: metatensor-core<0.2,>=0.1.15
Requires-Dist: metatensor-operations<0.5,>=0.4.0
Requires-Dist: wigners
Provides-Extra: torch
Requires-Dist: featomic-torch; extra == "torch"
Dynamic: author
Dynamic: license-file
Dynamic: provides-extra

Featomic
=========

|test| |docs| |cov|

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
###################################

.. inclusion-marker-representations-start

.. list-table::
   :widths: 25 50 20
   :header-rows: 1

   * - 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

.. inclusion-marker-representations-end

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

.. _`documentation`: https://metatensor.github.io/featomic/index.html

.. |test| image:: https://img.shields.io/github/check-runs/metatensor/featomic/main?logo=github&label=tests
    :alt: Tests status
    :target: https://github.com/metatensor/featomic/actions?query=branch%3Amain

.. |docs| image:: https://img.shields.io/badge/📚_documentation-latest-sucess
    :alt: Documentation
    :target: `documentation`_

.. |cov| image:: https://codecov.io/gh/metatensor/featomic/branch/main/graph/badge.svg
    :alt: Coverage Status
    :target: https://codecov.io/gh/metatensor/featomic
