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.4.tar.gz (4.4 MB view details)

Uploaded Source

Built Distribution

matador_db-0.9.4-py3-none-any.whl (417.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: matador-db-0.9.4.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.4.tar.gz
Algorithm Hash digest
SHA256 5b997adf18750520400fbdfdaaf331ea2a68f7d62d7ec41ccd19582a02aac1d7
MD5 f395b431882d6b72f22b0b5ee355ac1d
BLAKE2b-256 757fdd072f09749f17c74cb3e4f83c4ef1c98244268be4523792b868d58b999e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: matador_db-0.9.4-py3-none-any.whl
  • Upload date:
  • Size: 417.7 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 cce968e2aebd3d05470063f92848ed0c7867cd63f9f41d96ac5b071598aa41b3
MD5 d18bbdbf17d254227daa686c0cfe6549
BLAKE2b-256 13ab2e372a076d4585e6a146896c7c8d10afc0c293d31420ebe1396ca5adc97e

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