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

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.5.13.tar.gz (733.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.5.13-py2.py3-none-any.whl (791.4 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

  • Download URL: jarvis-tools-2020.5.13.tar.gz
  • Upload date:
  • Size: 733.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.5.13.tar.gz
Algorithm Hash digest
SHA256 64bc8de78832afa598662be7ede1120fbe97cba15a34ce53b034768320c1f8ce
MD5 3e805ab75cd3d9089adf27e48265f989
BLAKE2b-256 988e6112cc466d713c94be08d59a2f060bc1ba4186b685ff66f0ed5b35cbb986

See more details on using hashes here.

File details

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

File metadata

  • Download URL: jarvis_tools-2020.5.13-py2.py3-none-any.whl
  • Upload date:
  • Size: 791.4 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.5.13-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 77fa34902f056f8866dd1847058c94526569d292d73120585fd50cf1c4245e3d
MD5 2b50b33b99b48390ecf16bcb75450962
BLAKE2b-256 1b9a766424ba6d5beb5a712c5abd46ef9fac490861798746e4cc3a47faf86a35

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