Skip to main content

High throughput computation with density functional theory, molecular dynamics and machine learning. https://jarvis.nist.gov/

Project description

.. class:: center .. image:: https://circleci.com/gh/usnistgov/jarvis.svg?style=shield :target: https://circleci.com/gh/usnistgov/jarvis .. image:: https://travis-ci.org/usnistgov/jarvis.svg?branch=master :target: https://travis-ci.org/usnistgov/jarvis .. image:: https://ci.appveyor.com/api/projects/status/d8na8vyfm7ulya9p/branch/master?svg=true :target: https://ci.appveyor.com/project/knc6/jarvis-63tl9 .. image:: https://api.codacy.com/project/badge/Grade/be8fa78b1c0a49c280415ce061163e77 :target: https://www.codacy.com/app/knc6/jarvisutm_source=github.com&utm_medium=referral&utm_content=usnistgov/jarvis&utm_campaign=Badge_Grade .. image:: https://codecov.io/gh/knc6/jarvis/branch/master/graph/badge.svg :target: https://codecov.io/gh/knc6/jarvis

JARVIS

Joint Automated Repository for Various Integrated Simulations (JARVIS) is an integrated framework for computational science using density functional theory, classical force-field/molecular dynamics and machine-learning. Official website: https://jarvis.nist.gov

Installing JARVIS

  • We recommend installing miniconda environment from https://conda.io/miniconda.html ::

    bash Miniconda3-latest-Linux-x86_64.sh (for linux)
    bash Miniconda3-latest-MacOSX-x86_64.sh (for Mac)
    Download 32/64 bit python 3.6 miniconda exe and install (for windows)
    Now, let's make a conda environment just for JARVIS::
    conda create --name my_jarvis python=3.6
    source activate my_jarvis
    
  • Git clone install (Recommended)::

    pip install numpy scipy matplotlib
    git clone https://github.com/usnistgov/jarvis.git
    cd jarvis
    python setup.py install
    
  • Alternative pip install::

    pip install numpy scipy matplotlib
    pip install jarvis-tools
    
  • Alternative nix install:: Nix allows a robust and reproducible package for Linux. To generate a Nix environment for using JARVIS, follow the Nix instructions_.

.. _Nix instructions: ./nix/README.md

Jupyter notebooks

References

Link to presentation slides

https://www.slideshare.net/KAMALCHOUDHARY4

Pypi page

  • jarvis-tools:

    https://pypi.org/project/jarvis-tools
    

Readthedocs page

  • jarvis-tools:

    https://jarvis-tools.readthedocs.io/en/latest/
    

Running the examples

  • For running high-throughput calculations, set HPC/system related information in env_variables
  • Run py.test in tests folder to ensure basic setup
  • LAMMPS example:: An example calculation for Aluminum is given in the lammps folder for running EAM calculation (https://github.com/usnistgov/jarvis/blob/master/jarvis/lammps/examples/basic_input_output.py). Untar the example folder using tar -xvzf Al03.eam.alloy_nist.tgz . Change the 'parameters' variable in run_alloy.py to accommodate your lammps executable path, inelast.mod and dsiplace.mod path according to your system. Right now, crystal structures are obtained from materials-project, so MAPI_KEY needs to be adjusted also. Then, type python run_alloy.py which will launch jobs on your cluster. A json file is created as any lammps calculation get created. First, the geometry is optimized using LAMMPS. Then, symmetrically distinct vacancies are created and their energetics is determined. Reference elements are also downloaded from MP and their energies are calculated for measuring the chemical potemtial used in defect calculation. Afterthat, surfaces with miller index upto 3 is created and their energies are calculated. Perfect cell is used as reference to calculate surface energies. Finally, phonons are calculated using phonopy package. We use ASE to make interface between phonopy and LAMMPS.
  • VASP example:: Similarly, an example calculation for Silicon is given in vasp folder (https://github.com/usnistgov/jarvis/blob/master/jarvis/vasp/examples/runstruct_pyvasp.py). The input is a POSCAR file, which is already provided. executable paths, pseudopotential directory path and Special_POTCAR.yaml path needs to be adjusted in joptb88vdw.py top section. The master.py can be submitted to the queuing system with qsub sub.sh. Adjust path and your cluster specifics in sub.sh. The contents of master.py and joptb88vdw.py should be independent of PBS/SLURM or any other cluster. After successful submission of the sub.sh script a series of ENCUT- and KPOINTS- files are produced for plane wave convergence and kpoint convergence. After that, geometry is optimized with force-convergence criteria in MAIN-RELAX file. The crystal structure used in MAIN-RELAX calculation is then used for subsequent band-structure, dielectric function, MBJ calculation and elastic property calculations. Each complete calculation is notified with generation of respective json file.
  • ML example:: We trained machine learning models using JARVIS-DFT data on bandgaps, formation energies and elastic modulus and other properties. We used both chemical and structural descriptors during GradientBoostingRegression training. Example of getting 1557 descriptors for a system is given at: https://github.com/usnistgov/jarvis/blob/master/jarvis/sklearn/examples/desc_example.py
  • Access to JARVIS database:: Our database is freely available at https://www.ctcms.nist.gov/~knc6/JVASP.html and https://www.ctcms.nist.gov/~knc6/periodic.html, https://www.ctcms.nist.gov/~knc6/JLAMMPS.html for JARVIS-DFT and JARVIS-FF. JARVIS-FF and its development version has data for energetics, elastic constants, defect formation energies, surface energies and phonon properties. JARVIS-DFT has 3D and 2D properties of materials such as energetics, X-ray diffraction (for 3D), radial-distribution function, electronic density of states, electrostatic potential and band-structure, MBJ and semi-local dielectric function calculation, elastic properties and allied gamma-point unconverged phonons and thermoelectric properties. JARVIS-DFT can be downloaded in json format also now using the link provided and JARVIS-DFT webpage. We can also load the dataset using python scripts similar to https://github.com/knc6/jarvis/blob/master/jarvis/db/static/explore_db.py .
  • Uploading your data using JARVIS-API:: In addition to downloading/browsing through the JARVIS-database, one can also upload their data and query using JARVIS-API. Follow the instructions in https://github.com/usnistgov/jarvis/blob/master/jarvis/db/mdcs/mdcs_api.py

Founders

Kamal Choudhary, Francesca Tavazza (NIST)

Contributors

Daniel Wheeler, Faical Yannick Congo, Kevin Garrity, Brian DeCost, Adam Biacchi, Lucas Hale, Andrew Reid, Marcus Newrock (NIST)

Plot-gallery with additional jupyter notebooks

.. class:: center .. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/RDF.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/RDF%2CPRDF%2CADF%2CDDF.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/ADF-a.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/RDF%2CPRDF%2CADF%2CDDF.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/ADF-b.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/RDF%2CPRDF%2CADF%2CDDF.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/DDF.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/RDF%2CPRDF%2CADF%2CDDF.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/bandstr.jpg :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/band_structure.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Dos.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/band_structure.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Wulff.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Wulff.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/BoltzTrap.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Boltztrap.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/kp_converg.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Convergence.ipynb

.. image:: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/en_converg.png :Notebook: https://github.com/usnistgov/jarvis/blob/master/jarvis/db/static/Convergence.ipynb

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jarvis-tools-2019.7.21.2.tar.gz (692.6 kB view hashes)

Uploaded Source

Built Distribution

jarvis_tools-2019.7.21.2-py2.py3-none-any.whl (768.8 kB view hashes)

Uploaded Python 2 Python 3

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