Skip to main content

MATerial and Atomic Databases Of Refined structures.

Project description

PyPI Version GH Actions Coverage Status Documentation Status MIT License

matador is an aggregator, manipulator and runner of first-principles calculations, written with a bent towards battery electrode materials. The source can be found on GitHub and online documentation is hosted on ReadTheDocs.

Example Jupyter notebooks and tutorials can be found online or in the examples/ folder of the matador source code.

Written & maintained by Matthew Evans (2016-).

docs/src/img/lipzn.png

Installation

In the simplest case (e.g. you already have Python 3.6+ set up), pip install matador-db is sufficient to get up and running, preferably in a fresh virtual environment. More detailed instructions can be found in the Installation instructions.

Upgrading to the latest version should be as simple as pip install -U matador-db.

Usage

matador is primarily a Python library that can be used inside Python scripts/modules to create a custom workflow. There are, however, several command-line scripts bundled with matador itself. All of these scripts are listed under CLI Usage.

For basic command-line usage, please explore the help system for command. Common workflows can be found inside examples/ and in the online docs.

Please consult the full Python API documentation for programmatic usage.

Core functionality

The API has many features that can be explored in the examples and API documentation. As a summary, matador can be used for:

  • Scraping of CASTEP (and Quantum Espresso) input/output files into flexible Python dictionaries/models.

  • The creation and curation of MongoDB collections of geometry optimisation, calculations, with a powerful querying CLI/API.

  • Customisable, publication-ready plots for all models, e.g. phase diagrams, PDF, PXRD, voltage profiles, electronic/vibrational bandstructures etc.

  • Automated high-throughput geometry optimisations, electronic and vibrational properties using CASTEP (and Quantum Espresso) with run3. Tested on several supercomputers.

  • Creation of phase diagrams and electrochemical voltage profiles from the results of DFT calculations.

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

matador-db-0.9.2.tar.gz (4.4 MB view details)

Uploaded Source

Built Distribution

matador_db-0.9.2-py3-none-any.whl (410.4 kB view details)

Uploaded Python 3

File details

Details for the file matador-db-0.9.2.tar.gz.

File metadata

  • Download URL: matador-db-0.9.2.tar.gz
  • Upload date:
  • Size: 4.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0.post20200511 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for matador-db-0.9.2.tar.gz
Algorithm Hash digest
SHA256 6e4eabaf666f297a118951f9ff33c14cd2185684cb33401b0dd66c132a4c2be2
MD5 c3527787321b30b46fc81077838e08d7
BLAKE2b-256 edeee0207bf99990952c62474452301d62135f5a3953b3bcea0c13d022136352

See more details on using hashes here.

File details

Details for the file matador_db-0.9.2-py3-none-any.whl.

File metadata

  • Download URL: matador_db-0.9.2-py3-none-any.whl
  • Upload date:
  • Size: 410.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0.post20200511 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for matador_db-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 791baa4ada8c97b0071fad6e47d98fbfcfc8df9b97fca5a0a0c3e2cc1acdf37b
MD5 c476a276557f51855a594970a4bd415f
BLAKE2b-256 1e340453d2fcd380f0085684b58b1e9ffcb7dc0ea8af59e3326419b8f82cbb90

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