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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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