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

Uploaded Source

Built Distribution

matador_db-0.9.3-py3-none-any.whl (417.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: matador-db-0.9.3.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.3.tar.gz
Algorithm Hash digest
SHA256 bad2144d2b7202cf9e92711a2423b21ebfa872eccae47c55c884b226579f95da
MD5 06bda55f27957396d5d4d7de5003005f
BLAKE2b-256 07911a2f6c1e33d35b091eacf2de949019b3eacc07c934a950191c8635683949

See more details on using hashes here.

File details

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

File metadata

  • Download URL: matador_db-0.9.3-py3-none-any.whl
  • Upload date:
  • Size: 417.8 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 8eafefb9fddb6d95a67fde30a0c5ba89d18fd7dc9af327aeb2c67fc72fb9cbff
MD5 4d8c6357fe8cb7ec61e19abb54f2061e
BLAKE2b-256 9f441276151465060b34e61a4ad6d715fea60f1a6018ba1af75938a5d1e77cdf

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