Skip to main content

jarvis-tools: an open-source software package for data-driven atomistic materials design. https://jarvis.nist.gov/

Project description

https://circleci.com/gh/usnistgov/jarvis.svg?style=shield https://travis-ci.org/usnistgov/jarvis.svg?branch=master https://ci.appveyor.com/api/projects/status/d8na8vyfm7ulya9p/branch/master?svg=true https://api.codacy.com/project/badge/Grade/be8fa78b1c0a49c280415ce061163e77 https://img.shields.io/pypi/dm/jarvis-tools.svg https://pepy.tech/badge/jarvis-tools https://codecov.io/gh/usnistgov/jarvis/branch/master/graph/badge.svg https://www.ctcms.nist.gov/~knc6/jlogo.png

jarvis-tools: an open-source software package for data-driven atomistic materials design

NIST-JARVIS (Joint Automated Repository for Various Integrated Simulations) is an integrated framework for computational science using density functional theory, classical force-field/molecular dynamics and machine-learning. The jarvis-tools package consists of scripts used in generating and analyzing the dataset. The NIST-JARVIS official website is: https://jarvis.nist.gov . This project is a part of the Materials Genome Initiative (MGI) at NIST (https://mgi.nist.gov/).

  • A summary of the projects

    Projects

    Brief description

    JARVIS-DFT

    Density functional theory calculation database for ~40000 3D and ~1000 2D materials. Some of the material-properties include: Heat of formation, Crystal-structural data using OptB88vdW, PBE, LDA functionals, Bandgaps using semi-local, meta-GGA, HSE06 and other beyond DFT methods, Electron and phonon-bandstructures, Elastic, Piezoelectric, Thermoelectric, Dielectric tensors, Exfoliation energies for low-diemnsional materials, Frequency dependent dielectric function, Absorption coefficients, Work-function for 2D materials, Infrared and Raman intensities, Electric field gradient, Magnetic moment, Solar-cell efficiencies, Scanning Tunneling Microscopy (STM) images, Topological spin-orbit spillage, converged k-point and plane wave cut-offs, Wannier-tight binding Hamiltonian parameters and more. The website for JARVIS-DFT: https://www.ctcms.nist.gov/~knc6/JVASP.html

    JARVIS-FF

    Classical molecular dynamics calculation database for ~2000 3D materials with interatomic potential/force-fields. Some of the properties included in JARVIS-FF are energetics, elastic constants, surface energies, defect formations energies and phonon frequencies of materials. The website for JARVIS-FF: https://www.ctcms.nist.gov/~knc6/periodic.html

    JARVIS-ML

    Machine learning prediction tools trained on the JARVIS-DFT data. Some of the ML-prediction models are for Heat of formation, GGA/METAGGA bandgaps, Refractive indices, Bulk and shear modulus, Magnetic moment, Thermoelectric, Piezoelectric and Dielectric properties properties, Exfoliation energies, Solar-cell efficiency, and STM image classification. The website for JARVIS-ML: https://www.ctcms.nist.gov/jarvisml/

    JARVIS-Het.

    Heterostructure design tools for 2D materials in the JARVIS-DFT database. Some of the properties available are: work function, Band-alignment, and Heterostructure classification. JARVIS-Heterostructure website: https://www.ctcms.nist.gov/jarvish/

    JARVIS-PV

    Solar-cell/Photovoltaic cell design tools. Dataset is made available and the website will be available soon.

    JARVIS-STM

    Scanning-tunneling microscopy images for 2D materials. Dataset is made available and the website will be available soon.

    JARVIS-WTB

    Wannier Tight Binding Hamiltonian parameter dataset. Dataset will be made available and the website will be available soon.

    JARVIS-EFG

    Electric field gradient dataset. Dataset will be made available and the website will be available soon.

Installing jarvis-tools

  • 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.

Example Jupyter notebooks

Look into the notebooks folder

Example function

>>> from jarvis.core.atoms import Atoms
>>> box = [[2.715, 2.715, 0], [0, 2.715, 2.715], [2.715, 0, 2.715]]
>>> coords = [[0, 0, 0], [0.25, 0.25, 0.25]]
>>> elements = ["Si", "Si"]
>>> Si = Atoms(lattice_mat=box, coords=coords, elements=elements)
>>> density = round(Si.density,2)
>>> print (density)
2.33
>>>
>>> from jarvis.db.figshare import data
>>> dft_3d = data(dataset='dft_3d')
>>> print (len(dft_3d))
36099

References

Correspondence

Please report bugs as Github issues (https://github.com/usnistgov/jarvis/issues) or email to kamal.choudhary@nist.gov.

Funding support

NIST-MGI (https://www.nist.gov/mgi).

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-2020.6.8.tar.gz (732.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jarvis_tools-2020.6.8-py2.py3-none-any.whl (794.2 kB view details)

Uploaded Python 2Python 3

File details

Details for the file jarvis-tools-2020.6.8.tar.gz.

File metadata

  • Download URL: jarvis-tools-2020.6.8.tar.gz
  • Upload date:
  • Size: 732.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.6.2

File hashes

Hashes for jarvis-tools-2020.6.8.tar.gz
Algorithm Hash digest
SHA256 26ac65cc2c10dfba17e97ea5ff8441c0037ba01e9150759236b5a90710034530
MD5 ed8254fe70b8f941e18d5a0d7fedd61a
BLAKE2b-256 4b9f58c604b334ca38dc42098f981cf11515ebb94185d38af6134be28360d2dd

See more details on using hashes here.

File details

Details for the file jarvis_tools-2020.6.8-py2.py3-none-any.whl.

File metadata

  • Download URL: jarvis_tools-2020.6.8-py2.py3-none-any.whl
  • Upload date:
  • Size: 794.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.6.2

File hashes

Hashes for jarvis_tools-2020.6.8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 bf2836f01058e4f23d7ad812b0f65b870f3b90c87ee464a5bea1413368d5720f
MD5 15c57766611fd445cd7689c91fdb90f6
BLAKE2b-256 7a296770a4678c9f3f7032e901db13e5ba596668b611db9d2f65a48764595e29

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page