Skip to content
This repository has been archived by the owner on Jun 24, 2022. It is now read-only.
/ MPCite Public archive
forked from materialsproject/MPCite

Continuous and High-Throughput Allocation of Digital Object Identifiers for Materials Data in the Materials Project

Notifications You must be signed in to change notification settings

wuxiaohua1011/MPCite

 
 

Repository files navigation

MPCite

Continuous and High-Throughput Allocation of Digital Object Identifiers
for computed and contributed Materials Data in the Materials Project
        - Accepted as invited talk at “Reproducibility" mini-symposium of
          SciPy16 (http://scipy2016.scipy.org/ehome/146062/332963/)

Quick Start

pip install -r requirements.txt

python setup.py install

mpcite --config-file YOUR_PROJ_DIR/files/config.json

Brief Description

“MPCite” enables the continuous request, validation, and dissemination of Digital Object Identifiers (DOIs) for all inorganic materials currently available in the Materials Project (MP, www.materialsproject.org). The library provides MP's users with the necessary software infrastructure to achieve a new level of reproducibility in their research: (i) convenient and persistent citation of MP's materials data in online and print publications, and (ii) facilitated sharing amongst collaborators. "MPCite" can also be employed for the assignment of DOIs to non-core database entries such as theoretical and experimental data contributed through "MPContribs" or suggested by the user for calculation via the “MPComplete” service. The fundamental principle underlying MPCite can easily be extended to other scientific domains where the number of data records demands high-throughput and continuous allocation of DOIs.

Long Description

The new open-source software package, “MPCite” [1] enables the continuous request, validation, and dissemination of Digital Object Identifiers (DOIs) for all >70k inorganic materials currently available in the Materials Project (MP, www.materialsproject.org) database. Materials defined by a set of similar inorganic crystal structures are a good match for DOIs because they have a unique and stable definition. The functionality provided by MPCite is increasingly important in support of “MPComplete”, a service where users suggest new compounds for which MP will calculate detailed electronic structure properties. MPComplete then automatically integrates the results of each calculation with MP’s core dataset. Users are increasingly willing to delegate computation to MP because they quickly get reproducible results from a trusted analysis pipeline with DOIs they can cite in their follow-up analysis papers.

The DOE Office of Scientific and Technical Information (OSTI) [2] provides the E-Link service and programming interface free of charge to DOE-funded scientific projects. It allows researchers to submit information about OSTI products (in form of XML meta-data records) and retrieve a persistent DOI to identify it on the world wide web. DOIs are most commonly used for referencing and locating journal papers because they provide a unique URL linking to the journal’s online landing page with more information about the publication. The landing page might change over time, but the DOI - once requested - is immutable.

With MPCite, we are expanding and applying the use of DOIs from papers, reports and small singular/static datasets to the ever-growing set of materials data available in MP. For OSTI, the tens of thousands of requests from a single client constitutes an unprecedented scale. The resulting workload can only be managed with a continuously running task manager which sends requests to OSTI in chunks to initially achieve full DOI coverage within a few months. Not only does the manager subsequently keep requesting DOIs as new materials become available, it also assures the propagation of updates in materials data to OSTI without duplicating DOIs. To support such a “high-throughput” mode, MPCite includes self-healing error handlers and monitoring capabilities that are usually not required when dealing with up to a few dozen DOI requests and one entry at a time. Another integral task of the DOI manager is the automated generation of BibTeX strings for each material, which are also used to validate that the DOIs successfully resolve to the appropriate landing page. This functionality is exposed to the user on the materials details page in our portal [3]. MPCite interactively live-monitors the overall status of requested versus validated DOIs in comparison to the total number of materials through Plotly’s Streaming API [4]. In recognition that user analyses will often use many related materials, the user can also manually request a representative DOI through our portal to reference a collection of materials used in his analysis, or to share it with collaborators.

In summary, our efforts to assign DOIs to all materials available in MP provides our users with the necessary software infrastructure to achieve a new level of reproducibility in their research. This is not only evident in the convenient and persistent citation of our materials data in online and print publications, but also in the facilitated sharing amongst collaborators. In the future, we plan to extend the use of DOIs to non-core database entries such as theoretical and experimental data contributed by our users through "MPContribs" [5]. Once established in MP, MPCite can also be easily extended to other scientific domains where the number of data records demands the high-throughput and continuous allocation of DOIs.

[1] MPCite, https://github.com/materialsproject/MPCite [2] OSTI, https://www.osti.gov [3] Example Materials Detail Page for As (mp-10), http://dx.doi.org/10.17188/1184812 [4] Plotly, https://plot.ly [5] MPContribs, arXiv:1510.05024, arXiv:1510.05727, MRS Spring 2016

About

Continuous and High-Throughput Allocation of Digital Object Identifiers for Materials Data in the Materials Project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 99.4%
  • Other 0.6%