This is a place for all documentation relating to the MaterialsAtlas (MAtalas). The online docs are accessible here
- Foundations: concepts in materials and data science for materials discovery
- Algorithms: key materials informatics algorithms
- Case Studies: Examples of materials discovery using our web apps
- Tutorial: Using our web apps, application programming interface (API), and open source code.
- Contribution: Developer guides and design specifications
If you notice an error or omission, please post an issue or suggest an edit to us via a Pull Request.
Thanks, MaterialsAtlas Team
We use MkDocs, a static site generator for project documentation. We also use the mkdocs-material theme for styling.
Fork this repository and then clone it to your computer.
Create a Python 3 environment for this project and activate it. Example flow using conda
:
$ conda create -n madocs python=3
$ conda activate madocs
Navigate to the folder of your cloned repository, and install dependencies:
(madocs)$ pip install -r requirements.txt
Start the development server:
(madocs)$ mkdocs serve
Open http://127.0.0.1:8000/ to preview the site and see changes as you make them.
Create a new git branch to record any changes. When you push your branch to GitHub, you can then initiate a Pull
Request against the master
branch of this repo.
Some of the documentation sentences and structures are adapted from Materials Project documentation https://docs.materialsproject.org/. They are our role model -:)