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
  • Mixing Rules
  • References

Was this helpful?

Edit on GitHub
Export as PDF
  1. Methodology
  2. Materials Methodology
  3. Thermodynamic Stability
  4. Energy Corrections

GGA/GGA+U/r2SCAN Mixing

Details on the GGA/GGA+U/r2SCAN mixing scheme corrections

PreviousAnion and GGA/GGA+U MixingNextPhase Diagrams (PDs)

Last updated 2 years ago

Was this helpful?

An updated energy correction scheme is used to allow for the mixing of GGA, GGA+U, and r2SCAN calculations. This is constructed by considering all electronic energies to be the sum of a reference energy, and a relative energy. The reference energy (ErefE_{ref}Eref​) for each functional is defined as the () electronic energy of the GGA(+U) ground-state structure at each point in composition space. The energy of a material associated with either functional can then be expressed as a difference relative to a specific reference energy (ΔEref\Delta E_{ref}ΔEref​). The formation energy of a material is calculated in the usual way by subtracting the electronic energies of the elemental endpoints in each respective functional. It should be noted that ΔEref\Delta E_{ref}ΔEref​ is calculated from the differences in polymorph energies, and consequently does not depend on the elemental endpoint energies. While the updated mixing scheme is similar to the previous scheme involving only GGA and GGA+U calculations, it extends the approach to be amenable to any two functionals without relying on pre-fitted energy correction parameters.

Mixing Rules

The two rules used to construct mixed GGA/GGA+U/r2SCAN phase diagrams are as follows:

  1. Start with a GGA(+U) convex energy hull. Replace GGA(+U) energies with r2SCAN energies by adding their ΔEref\Delta E_{ref}ΔEref​ to the corresponding GGA(+U) reference energy.

  2. Construct the convex energy hull using formation energy calculated using r2SCAN energies, only when r2SCAN calculations exist for every reference structure (i.e. every stable GGA(+U) structure). In this case, add any missing GGA(+U) materials by adding their ΔEref\Delta E_{ref}ΔEref​to the corresponding r2SCAN reference energy.

References

For more detailed information on the mixing scheme and its benchmarks, see the original publication in Ref .

[1] Kingsbury, R.S., Rosen, A.S., Gupta, A.S. et al. A flexible and scalable scheme for mixing computed formation energies from different levels of theory. npj Comput Mater 8, 195 (2022).

https://doi.org/10.1038/s41524-022-00881-w
[1]
empirically corrected
[1]
Figure 1. Rules for mixing GGA(+U) (blue) and r2SCAN (red) energies onto a single phase diagram. (left) r2SCAN energies are placed onto the GGA(+U) hull by referencing them to the r2SCAN energy of the GGA(+U) ground state via ΔEref\Delta E_{ref}ΔEref​. A, B, C, ad D represent different polymophs at a single composition, and polymorph A is the ground state. (right) r2SCAN formation energies are used to build the convex hull only when there are r2SCAN calculations for every GGA(+U) ground state.