{ "cells": [ { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": false }, "outputs": [], "source": [ "from pymatgen.matproj.rest import MPRester\n", "from pymatgen.phasediagram.maker import PhaseDiagram\n", "\n", "%matplotlib inline" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Generating the phase diagram\n", "\n", "To generate a phase diagram, we obtain entries from the Materials Project and call the PhaseDiagram class in pymatgen." ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "collapsed": false }, "outputs": [], "source": [ "#This initializes the REST adaptor. You may need to put your own API key in as an arg.\n", "a = MPRester()\n", "\n", "#Entries are the basic unit for thermodynamic and other analyses in pymatgen.\n", "#This gets all entries belonging to the Ca-C-O system.\n", "entries = a.get_entries_in_chemsys(['Ca', 'C', 'O'])\n", "\n", "#With entries, you can do many sophisticated analyses, like creating phase diagrams.\n", "pd = PhaseDiagram(entries)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Plotting the phase diagram\n", "\n", "To plot a phase diagram, we send our phase diagram object into the PDPlotter class." ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "from pymatgen.phasediagram.plotter import PDPlotter\n", "#Let's show all phases, including unstable ones\n", "plotter = PDPlotter(pd, show_unstable=True)\n", "plotter.show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Calculating energy above hull and other phase equilibria properties\n", "\n", "To perform more sophisticated analyses, use the PDAnalyzer object." ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": false }, "outputs": [], "source": [ "from pymatgen.phasediagram.analyzer import PDAnalyzer\n", "a = PDAnalyzer(pd)" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ " Materials ID Composition Ehull Decomposition\n", "0 mp-45 Ca 0.000508 1.00 Ca2\n", "1 mp-10683 Ca 0.396161 1.00 Ca2\n", "2 mp-21 Ca 0.013583 1.00 Ca2\n", "3 mp-166 Ca 0.013329 1.00 Ca2\n", "4 mp-132 Ca 0.000000 1.00 Ca2\n", "5 mp-1008498 Ca 0.152771 1.00 Ca2\n", "6 mp-990424 C 0.004827 1.00 C16\n", "7 mp-169 C 0.004413 1.00 C16\n", "8 mp-632329 C 0.110332 1.00 C16\n", "9 mp-66 C 0.135631 1.00 C16\n", "10 mp-47 C 0.160479 1.00 C16\n", "11 mp-569416 C 0.028801 1.00 C16\n", "12 mp-569304 C 0.029940 1.00 C16\n", "13 mp-568806 C 0.006175 1.00 C16\n", "14 mp-48 C 0.002697 1.00 C16\n", "15 mp-616440 C 0.140564 1.00 C16\n", "16 mp-611426 C 0.145308 1.00 C16\n", "17 mp-611448 C 0.142026 1.00 C16\n", "18 mp-569517 C 0.145186 1.00 C16\n", "19 mp-24 C 0.832340 1.00 C16\n", "20 mp-990448 C 0.003052 1.00 C16\n", "21 mp-579909 C 0.944071 1.00 C16\n", "22 mp-568410 C 0.506378 1.00 C16\n", "23 mp-570002 C 0.762539 1.00 C16\n", "24 mp-1008395 C 0.331788 1.00 C16\n", "25 mp-630227 C 0.393490 1.00 C16\n", "26 mp-998866 C 2.756837 1.00 C16\n", "27 mp-667273 C 0.388760 1.00 C16\n", "28 mp-997182 C 0.003585 1.00 C16\n", "29 mp-680372 C 0.407085 1.00 C16\n", ".. ... ... ... ...\n", "49 mp-1009653 CaC2 0.204859 0.33 Ca2 + 0.67 C16\n", "50 mp-684668 CaC2 0.068324 0.33 Ca2 + 0.67 C16\n", "51 mp-642822 CaC2 0.024576 0.33 Ca2 + 0.67 C16\n", "52 mp-1009655 CaC2 0.743834 0.33 Ca2 + 0.67 C16\n", "53 mp-545512 CaO 0.065085 1.00 Ca1 O1\n", "54 mp-2605 CaO 0.000000 1.00 Ca1 O1\n", "55 mp-634859 CaO2 0.007227 0.67 Ca1 O1 + 0.33 O8\n", "56 mp-995183 CO 0.559450 0.25 C16 + 0.75 C4 O8\n", "57 mp-20066 CO2 0.000000 1.00 C4 O8\n", "58 mp-556660 CO 0.692016 0.25 C16 + 0.75 C4 O8\n", "59 mp-11875 CO 0.668938 0.25 C16 + 0.75 C4 O8\n", "60 mp-995196 CO3 3.078212 0.25 O8 + 0.75 C4 O8\n", "61 mp-561848 C3O2 0.513353 0.40 C16 + 0.60 C4 O8\n", "62 mp-1001594 C4O3 0.241118 0.36 C16 + 0.64 C4 O8\n", "63 mp-556034 CO2 0.028775 1.00 C4 O8\n", "64 mp-11725 CO2 0.025395 1.00 C4 O8\n", "65 mp-644607 CO2 0.028281 1.00 C4 O8\n", "66 mp-995198 CO2 0.323686 1.00 C4 O8\n", "67 mp-995224 CO2 0.302425 1.00 C4 O8\n", "68 mp-4626 CaCO3 0.024281 1.00 Ca2 C2 O6\n", "69 mp-3205 CaCO3 0.169799 1.00 Ca2 C2 O6\n", "70 mp-558543 Ca(CO2)2 0.046302 0.07 C16 + 0.71 Ca2 C2 O6 + 0.21 C4 O8\n", "71 mp-3953 CaCO3 0.000000 1.00 Ca2 C2 O6\n", "72 mp-561412 CaCO3 0.007359 1.00 Ca2 C2 O6\n", "73 mp-556235 CaCO3 0.002015 1.00 Ca2 C2 O6\n", "74 mp-553939 CaCO3 0.013584 1.00 Ca2 C2 O6\n", "75 mp-641635 CaCO3 1.368847 1.00 Ca2 C2 O6\n", "76 mp-548403 CaCO3 0.312190 1.00 Ca2 C2 O6\n", "77 mp-696740 CaCO3 1.683982 1.00 Ca2 C2 O6\n", "78 mp-560265 CaCO3 0.008073 1.00 Ca2 C2 O6\n", "\n", "[79 rows x 4 columns]\n" ] } ], "source": [ "import collections\n", "\n", "data = collections.defaultdict(list)\n", "for e in entries:\n", " decomp, ehull = a.get_decomp_and_e_above_hull(e)\n", " data[\"Materials ID\"].append(e.entry_id)\n", " data[\"Composition\"].append(e.composition.reduced_formula)\n", " data[\"Ehull\"].append(ehull) \n", " data[\"Decomposition\"].append(\" + \".join([\"%.2f %s\" % (v, k.composition.formula) for k, v in decomp.items()]))\n", "\n", "from pandas import DataFrame\n", "df = DataFrame(data, columns=[\"Materials ID\", \"Composition\", \"Ehull\", \"Decomposition\"])\n", "\n", "print(df)" ] }, { "cell_type": "code", "execution_count": null, "metadata": { "collapsed": true }, "outputs": [], "source": [] } ], "metadata": { "anaconda-cloud": {}, "kernelspec": { "display_name": "Python [conda root]", "language": "python", "name": "conda-root-py" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.5.2" } }, "nbformat": 4, "nbformat_minor": 0 }