Description of the components of the phase diagram app, the intended functionality of each component, and a short review of the origin of the phase diagram construction and MP thermodynamic data.

The Phase Diagram App allows a user to create and visualize compositional phase diagrams for 1, 2, 3, and 4 element chemical systems using Materials Project data. It is also possible to create and visualize the corresponding chemical potential diagrams for 2 and 3 element systems. The user has access to some customization features, such as 1) changing the style of plot, 2) selecting data calculated with a certain DFT functional, 3) and using machine learning (ML)-estimated finite temperature data.


The methodology behind thermodynamic energy calculations, phase diagram construction, and chemical potential diagram construction has been extensively discussed in the Methodology section of the MP Docs. See the links below:

Energy CorrectionsPhase Diagrams (PDs)Chemical Potential Diagrams (CPDs)Finite Temperature Estimation

App Components

Search by chemical system

Phase diagrams are created by chemical system (i.e., a collection of elements). To create a phase diagram in the Phase Diagram App, first select a set of elements by typing them either as a single string separated by dashes, or by clicking the elements in the periodic table viewer (which will auto-populate the search box).


Phase diagrams can only be plotted for chemical systems containing 1-4 elements. It is still possible to create phase diagrams for 5 or more elements, but this feature is only currently available in pymatgen.

Visualization Viewer

Once a chemical system has been selected (e.g., Li-Fe-O), you will an illustration of the compositional phase diagram for your system of interest load in the the viewer. Within the viewer, you can switch to the chemical potential diagram to view the same phase equilibria but within chemical potential space (see Methodology for more information).

1) Phase Diagram

2) Chemical Potential Diagram

If you are

Configure Visualization

The phase diagram viewer can be configured

Advanced Options

Data Table

Last updated