Training materials
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
MatMiner_demos
SMA_demo
SyntheticDataDemo
ci
example_data
.gitignore
.travis.yml
AdvancedPif.ipynb
AdvancedQueries.ipynb
ExperimentalDesign.html
ExperimentalDesign.ipynb
ImportInstron.ipynb
ImportVASP.html
ImportVASP.ipynb
IntroQueries.html
IntroQueries.ipynb
JournalPaperToModel.ipynb
MLonCitrination.html
MLonCitrination.ipynb
README.md
WorkingWithPIFs.html
WorkingWithPIFs.ipynb
requirements.txt
serve.sh
thermo_mechanical_analysis.py
tsneDemo.ipynb

README.md

learn-citrination

Demos and tutorials for API access to Citrination.com For support, see the citrination user group.

Contents

Four of the tutorials are organized as a sequence demonstrating the import and usage of DFT data:

  1. Importing VASP calculations
  2. Working with PIFs
  3. Introduction to queries
  4. Machine learning on Citrination

There are also advanced topics tutorials:

Requirements

Most of these tutorials are jupyter notebooks backed by a python3 kernel. You'll need:

  • python3 with Jupyter. Anaconda is highly recommended.
  • pypif and citrination_client packages:

pip install pypif citrination_client dfttopif

  • A valid citrination client API key set in your environment variables: 0. Create an account on Citrination (if you don't already have one)

    1. Go to your account page and look for "API Key"
    2. Add the key to your environment. If you use a bash shell, the command is:

    export CITRINATION_API_KEY=<your key copied from the website>

    You can add this command to your .bashrc file to automatically set the API key in each new session.

    The API key functions as the password for the client, so its important to keep it private. Its a good practice to put it in your environment instead of in the source code to help avoid unintentional sharing or publication of your API key.

References

The example data used in these tutorials is drawn from: