A python wrapper for OQMD API
Project description
qmpy_rester
A python wrapper for OQMD API (PyPI). This code is written in python 3.
Installation
pip install qmpy_rester
Usage
1. Get data through omqd-api
1.1 Example
import qmpy_rester as qr
## Return list of data
with qr.QMPYRester() as q:
kwargs = {
‘element_set’: ‘(Fe-Mn),O’, # composition include (Fe OR Mn) AND O
‘stability’: ‘<-0.1’, # hull distance smaller than -0.1 eV
‘natom’: ‘<10’, # number of atoms less than 10
}
list_of_data = q.get_oqmd_phases(**kwargs)
## Return data of a single oqmd phase
with qr.QMPYRester() as q:
phase = q.get_oqmd_phase_by_id(fe_id=4061139, fields='!sites') # Default: fields=None
1.2 Allowed attributes
composition
: compostion of the materials or phase space, e.g. Al2O3, Fe-Oelement_set
: the set of elements that the compound must have, '-' for OR, ',' for AND, e.g. (Fe-Mn),Oicsd
: whether the structure exists in ICSD, e.g. False, True, F, Tprototype
: structure prototype of that compound, e.g. Cu, CsClgeneric
: chemical formula abstract, e.g. AB, AB2spacegroup
: the space group of the structure, e.g. Fm-3mnatoms
: number of atoms in the supercell, e.g. 2, >5volume
: volume of the supercell, e.g. >10ntypes
: number of elements types in the compound, e.g. 2, <3stability
: hull distance of the compound, e.g. 0, <-0.1,delta_e
: formation energy of that compound, e.g. <-0.5,band_gap
: band gap of the materials, e.g. 0, >2fields
: return subset of fields, e.g. 'name,id,delta_e', '!sites'filter
: customized filters, e.g. 'element_set=O AND ( stability<-0.1 OR delta_e<-0.5 )'limit
: number of data return at onceoffset
: the offset of data return
2. Get data through optimade api format
2.1 Example
import qmpy_rester as qr
## Return list of data
with qr.QMPYRester() as q:
kwargs = {
‘elements’: ‘Fe,Mn’, # include element Fe and Mn
‘nelements’: ‘<5’, # less than 4 element species in the compound
‘_oqmd_stability’: ‘<0’, # stability calculted by oqmd is less than 0
}
list_of_data = q.get_optimade_structures(**kwargs)
## Return data of a single structure
with qr.QMPYRester() as q:
structure = q.get_optimade_structure_by_id(id=4061139, fields='!_oqmd_sites') # Default: fields=None
1.2 Allowed attributes
elements
: the set of elements that the compound must have, e.g. Si,Onelements
: number of elements types in the compound, e.g. 2, <3chemical_formula
: compostion of the materials, e.g. Al2O3formula_prototype
: chemical formula abstract, e.g. AB, AB2_oqmd_natoms
: number of atoms in the supercell, e.g. 2, >5_oqmd_volume
: volume of the supercell, e.g. >10_oqmd_spacegroup
: the space group of the structure, e.g. Fm-3m_oqmd_prototype
: structure prototype of that compound, e.g. Cu, CsCl_oqmd_stability
: hull distance of the compound, e.g. 0, <-0.1,_oqmd_delta_e
: formation energy of that compound, e.g. <-0.5,_oqmd_band_gap
: band gap of the materials, e.g. 0, >2fields
: return subset of fields, e.g. 'elements,chemical_formula', '!_oqmd_sites'filter
: customized filters, e.g. 'elements=O AND ( _oqmd_stability<-0.1 OR _oqmd_delta_e<-0.5 )'limit
: number of data return at onceoffset
: the offset of data return
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
qmpy_rester-0.2.0.tar.gz
(12.2 kB
view details)
Built Distribution
File details
Details for the file qmpy_rester-0.2.0.tar.gz
.
File metadata
- Download URL: qmpy_rester-0.2.0.tar.gz
- Upload date:
- Size: 12.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9143c39ecc2274ff72dc2e9346a6e44b997d18d015f3364caccf68f83b139394 |
|
MD5 | 7aa2c1257279807f3a852659e5fce9b3 |
|
BLAKE2b-256 | e4d4573339c3bf957c7c3e353defeed638be7e4eb514eeb84642ffb13dd439df |
File details
Details for the file qmpy_rester-0.2.0-py3-none-any.whl
.
File metadata
- Download URL: qmpy_rester-0.2.0-py3-none-any.whl
- Upload date:
- Size: 5.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8f4249895e3cb8f69f5948d13950c3a30fa150d633d0d65a49eff3d6230e7ab5 |
|
MD5 | aefbc49cbac9733f384249a6ca20845e |
|
BLAKE2b-256 | 518853481be68dc75cf28aaee216871f519a11dd3e19a7007bc7a4c2cdb0a99e |