Materials Project Documentation
Return to materialsproject.org
  • Introduction
  • Frequently Asked Questions (FAQ)
    • Glossary of Terms
  • Changes and Updates
    • Database Versions
    • Website Changelog
  • Documentation Credit
  • Community
    • Getting Help
    • Getting Involved
      • Contributor Guide
      • Potential Collaborators
      • MP Community Software Ecosystem
    • Community Resources
    • Code of Conduct
  • Services
    • MPContribs
  • Methodology
    • Materials Methodology
      • Overview
      • Calculation Details
        • GGA/GGA+U Calculations
          • Parameters and Convergence
          • Hubbard U Values
          • Pseudo-potentials
        • r2SCAN Calculations
          • Parameters and Convergence
          • Pseudopotentials
      • Thermodynamic Stability
        • Energy Corrections
          • Anion and GGA/GGA+U Mixing
          • GGA/GGA+U/r2SCAN Mixing
        • Phase Diagrams (PDs)
        • Chemical Potential Diagrams (CPDs)
        • Finite Temperature Estimation
      • Electronic Structure
      • Phonon Dispersion
      • Diffraction Patterns
      • Aqueous Stability (Pourbaix)
      • Magnetic Properties
      • Elastic Constants
      • Piezoelectric Constants
      • Dielectric Constants
      • Equations of State (EOS)
      • X-ray Absorption Spectra (XAS)
      • Surface Energies
      • Grain Boundaries
      • Charge Density
      • Suggested Substrates
      • Related Materials
      • Optical absorption spectra
      • Alloys
    • Molecules Methodology
      • Overview
      • Calculation Details
      • Atomic Partial Charges
      • Atomic Partial Spins
      • Bonding
      • Metal Coordination and Binding
      • Natural Atomic and Molecular Orbitals
      • Redox and Electrochemical Properties
      • Molecular Thermodynamics
      • Vibrational Properties
      • Legacy Data
    • MOF Methodology
      • Calculation Parameters
        • DFT Parameters
        • Density Functionals
        • Pseudopotentials
        • DFT Workflow
  • Apps
    • Explore and Search Apps
      • Materials Explorer
        • Tutorial
      • Molecules Explorer
        • Tutorial
        • Legacy Data
      • Battery Explorer
        • Background
        • Tutorial
      • Synthesis Explorer
        • Background
        • Tutorial
      • Catalysis Explorer
        • Tutorial
      • MOF Explorer
        • Downloading the Data
        • Structure Details
          • QMOF IDs
          • Structure Sources
          • Finding MOFs by Common Name
          • Structural Fidelity
        • Property Definitions
          • SMILES, MOFid, and MOFkey
          • Pore Geometry
          • Topology
          • Electronic Structure
          • Population Analyses and Bond Orders
          • Symmetry
        • Version History
        • How to Cite
    • Analysis Apps
      • Phase Diagram
        • Background
        • Tutorials
        • FAQ
      • Pourbaix Diagram
        • Background
        • Tutorial
        • FAQ
      • Crystal Toolkit
        • Background
        • Tutorial
        • FAQ
      • Reaction Calculator
      • Interface Reactions
    • Characterization Apps
      • X-ray Absorption Spectra (XAS)
    • Explore Contributed Data
  • Downloading Data
    • How do I download the Materials Project database?
    • Using the API
      • Getting Started
      • Querying Data
      • Tips for Large Downloads
      • Examples
      • Advanced Usage
    • Differences between new and legacy API
    • Query and Download Contributed Data
    • AWS OpenData
  • Uploading Data
    • Contribute Data
  • Data Production
    • Data Workflows
    • Data Builders
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
Export as PDF
  1. Apps

Explore Contributed Data

Walkthrough for exploring contributed data on the Materials Project (MP) website.

PreviousX-ray Absorption Spectra (XAS)NextHow do I download the Materials Project database?

Last updated 1 year ago

Was this helpful?

Contributions displayed in dedicated section on materials detail page for mp-2715

Contributed data from MPContribs projects are included in the materials details pages on MP for every contribution that uses an mp-id as its identifier. Public contributions in public projects are shown to all MP users whereas private projects or private contributions in public projects are only shown to the project owner and their collaborators. A summary of each contribution to a material is summarized in form of a contribution card containing meta-data in form of project info, data columns and download links to the other contribution components structures, tables, and attachments if available. The project title is linked to its project landing page in the MPContribs portal and the contribution ID is linked to the according contribution detail page.

The main page of an MPContribs deployment contains an entry for every contributed dataset/project with their titles linking to their respective landing pages. Each entry also includes the project's publication status, its authors, and statistics about their contents. A search box is provided to filter project titles, authors, and descriptions by keywords and reduce the list accordingly. The dropdowns in the column headers can be used to filter the list of projects by values in each column.

The MPContribs search interface allows for filtering and previewing contributions across all materials and projects. Projects, formulas and identifiers can be selected to generate a list of results. The selected result is displayed in form of a contribution card. The title of the card links to the project's landing page, and the Details/Info button opens the corresponding detail page. Authors and description are expandable, and references linked above the title. Each contribution card also contains its hierarchical data.

Each project/dataset has a landing page with a unique URL on the MPContribs Portal. Upon approval of the project by MP, a Digital Object Identifier (DOI) can be assigned to the landing page for citation in journals. This page thus serves as entry point for contributors to share their data with their community and refer to an overview of their dataset in journals, for instance. In addition to title, description, authors and references, a landing page also contains a generic overview table listing all the project's contributions to MP materials (or alternatively formulas or chemical systems). This default table provides a few important functionalities out of the box:

  • Search Box: Filter the list of contributions by searching for specific sub-strings in the identifier or formula columns. Any other string-type columns in the data component can be filtered, too.

  • Grouped Headers: Nested fields in the data component automatically appear grouped in the table header. Units are also pulled into header next to the column name.

  • Column Sort: By default, the table is sorted by contribution insertion order (natural). Any other column can be used for the table sort by clicking on the column name. Repeated clicks cycle through ascending, descending and natural order.

  • Pagination: Contributions are paginated. The pages can be iterated by scrolling to the bottom of the table.

  • MP Details Pages: If the identifier column contains an MP material ID or formula, the cell will automatically link to the according materials details or disambiguation pages.

  • Contribution Details Pages: The id links to the details page for a contribution containing a rendered version of the full database entry.

  • Column Manager: Table columns to be shown or hidden can be selected via simple dropdown menu.

  • Components: the lists for each contribution component are rendered as tab containing a link to reveal their meta-data and to download a specific structure/table/attachment.

  • Downloads: Archives with contributions in CSV or JSON format can be downloaded either for the entire project with or without a selection of components, or for a subset of contributions by first filtering the contributions to include.

There are also dedicated explorers available for the MPContribs projects qmof and open_catalyst_project which provide an alternative view/interface for the project's data that's integrated with the Materials Project website. These explorers will likely become the default for all MPContribs projects in the future.

MPContribs interface to search across all contributions and display results in list and card form
MOF Explorer serving data stored in the qmof MPContribs project

Each contribution in a dataset is assigned a unique identifier (see MongoDB ) which can be used to access its Contribution Details Page rendering an interactive version of its full content. The detail page is a static version of a fully functional notebook using the MPContribs python library. It contains code showing how to interact with a contribution programmatically along with the resulting output. The navigation bar at the top provides links to jump to a respective component and a download button to retrieve the contribution in JSON format.

ObjectId
Jupyter
API Client
Main page of the default MPContribs deployment at https://contribs.materialsproject.org
Project landing page for the "Carrier Transport" dataset