Skip to main content

Generic Python Materials Science tools

Project description

Matscipy is a generic materials science toolbox built around the Atomic Simulation Environment (ASE). It provides useful routines for:

  • Plasticity and dislocations

  • Fracture mechanics

  • Electro-chemistry

  • Tribology

  • Elastic properties

In addition to domain-specific routines, it also implements a set of general-purpose, low-level utilies:

  • Efficient neighbour lists

  • Atomic strain

  • Ring analysis

  • Correlation functions

  • Second order potential derivatives

Quick start

Matscipy can be installed on Windows, Linux and x86 macos with:

python3 -m pip install matscipy

To get the latest version directly (requires a working compiler):

python3 -m pip install git+

Compiled up-to-date wheels for Windows, Linux and x86 macos can be found here.


Sphinx-generated documentation for the project can be found here. Since Matscipy is built on top of ASE’s Atoms and Calculator objects, ASE’s documentation is a good complement to Matscipy’s.

Seeking help

Issues can be used to ask questions about Matscipy.


Contributions, in the form of bug reports, improvement suggestions, documentation or pull requests, are welcome.

Running tests

To run the tests locally, from Matscipy’s root directory:

python3 -m pip install .[test]  # installs matscipy + test dependencies
cd tests/
python3 -m pytest .


The package requires:

Optional packages:


matscipy was partially funded by the Deutsch Forschungsgemeinschaft (project 258153560) and by the Engineering and Physical Sciences Research Council (grants EP/P002188/1, EP/R012474/1 and EP/R043612/1).

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

matscipy-0.8.0.tar.gz (12.1 MB view hashes)

Uploaded source

Built Distributions

matscipy-0.8.0-cp311-cp311-win_amd64.whl (1.6 MB view hashes)

Uploaded cp311

matscipy-0.8.0-cp310-cp310-win_amd64.whl (1.6 MB view hashes)

Uploaded cp310

matscipy-0.8.0-cp39-cp39-win_amd64.whl (1.6 MB view hashes)

Uploaded cp39

matscipy-0.8.0-cp38-cp38-win_amd64.whl (1.6 MB view hashes)

Uploaded cp38

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