Skip to main content

Extensible schema for atomistic data and calculations.

Project description

atomea

Extensible schema for atomistic data and calculations.

Build Status Build Status PyPI version PyPI - Python Version codecov GitHub release (latest by date) License GitHub repo size Black style Black style Black style

Documentation

Overview

Atomea is a Python package designed to simplify and standardize the setup and data management for atomistic data and calculations. It leverages the power of Pydantic for schema definition and Jinja2 templates for input file generation, making it easy to automate, document, and prepare input files for various computational chemistry and biology tools.

Key features

  • Extensible Schema Definition: Easily define schemas for various computational packages using Pydantic.
  • Automated Input File Preparation: Generate input files with Jinja2 templates to ensure consistency and reproducibility.
  • Data Digestion: Convert raw output files into optimized storage formats (e.g., Zarr) with a consistent interface.
  • YAML Integration: Save and load configurations and data in YAML format for easy sharing and reproducibility.

Installation

Atomea requires Python 3.10 or later. You can install it using pip, the Python package installer. This will install atomea along with its core dependencies: loguru, pydantic, pyyaml, and numpy.

pip install atomea

Atomea has several optional dependency groups that you can install based on your needs. You can include these when installing atomea or add them later.

  • storage: Allows saving digested outputs to several file types.
  • sim: Allows digesting simulations using MDAnalysis.

For example, we can install both of these optional dependencies.

pip install atomea[storage,sim]

Deploying

We use bump-my-version to release a new version. This will create a git tag that is used by poetry-dynamic-version to generate version strings and update CHANGELOG.md.

For example, to bump the minor version you would run the following command.

poetry run bump-my-version bump minor

After releasing a new version, you need to push and include all tags.

git push --follow-tags

License

This project is released under the Apache-2.0 License as specified in LICENSE.md.

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

atomea-0.0.0.post171.tar.gz (50.1 kB view details)

Uploaded Source

Built Distribution

atomea-0.0.0.post171-py3-none-any.whl (60.0 kB view details)

Uploaded Python 3

File details

Details for the file atomea-0.0.0.post171.tar.gz.

File metadata

  • Download URL: atomea-0.0.0.post171.tar.gz
  • Upload date:
  • Size: 50.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.3

File hashes

Hashes for atomea-0.0.0.post171.tar.gz
Algorithm Hash digest
SHA256 f7255fd21652c1026c4406072acd5d9aa4f6f19391dcce932879ac94f1ff6583
MD5 6dbde93d2dfa0edc302576ecfdcf295d
BLAKE2b-256 e8255073599bae43f08efb635c6afdab3f5a8e0a589f4cdf2aaded894ffbdb51

See more details on using hashes here.

File details

Details for the file atomea-0.0.0.post171-py3-none-any.whl.

File metadata

File hashes

Hashes for atomea-0.0.0.post171-py3-none-any.whl
Algorithm Hash digest
SHA256 29ae62584b2f554de7794ecbcca48fc8a06377bc42d6d9f3071fecb8703556df
MD5 9980f7c282510d98d01254dfb22cc335
BLAKE2b-256 a756909367b7d6e1f760372fb00cd4ddf2ad5faf477b00062dfd38eb432e5a8f

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