generated doc

TRIQS · Jul 19, 2023 · 1abdf2c · 1abdf2c
1 parent a74ae4f
commit 1abdf2c
Show file tree

Hide file tree

Showing 103 changed files with 238 additions and 230 deletions.
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
diff --git a/.doctrees/nbsphinx/tutorials/SVO_os_qe/tutorial.ipynb b/.doctrees/nbsphinx/tutorials/SVO_os_qe/tutorial.ipynb
@@ -2,31 +2,36 @@
  "cells": [
   {
    "cell_type": "markdown",
-   "id": "ba7991f8",
+   "id": "e9d3bde4",
    "metadata": {},
    "source": [
     "*Disclaimer:*\n",
     "\n",
-    "Heavy calculations: Current tutorial is best performed on an HPC facility.\n",
+    "Heavy calculations (~ 800 core hours): Current tutorial is best performed on an HPC facility.\n",
     "\n",
     "# 1. OS with QE/W90 and cthyb: SrVO3 MIT"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "7ac68093",
+   "id": "20ad153f",
    "metadata": {},
    "source": [
-    "Hello, welcome to the first part of the tutorial for solid_dmft. Here we will guide to set up and run your first DMFT calculations. \n",
+    "Hello and welcome to the first part of the tutorial for solid_dmft. Here we will guide to set up and run your first DMFT calculations. \n",
     "\n",
-    "To begin your DMFT journey we will immediately start a DMFT run on Strontium Vanadate (SVO). SVO is a member of a family of material known as complex perovskite oxides.\n",
+    "To begin your DMFT journey we will immediately start a DMFT run on strontium vanadate (SVO). SVO is a member of a family of material known as complex perovskite oxides with 1 electron occupying the t2g manifold. Below, we show the band structure of the frontier (anti-bonding) t2g bands for SVO.\n",
     "\n",
-    "In these materials, the electrons sitting on the transition metal ions (V in this case) are fairly localized, and the fully delocalized picture of DFT is insufficient to describe their physics. DMFT accounts for the electron-electron interaction by providing a fully interacting many body correction to the DFT non-interacting problem."
+    "![svobands](./ref/bnd_structure.png \"SVO band structure\")\n",
+    "\n",
+    "In these materials, the electrons sitting on the transition metal ions (V in this case) are fairly localized, and the fully delocalized picture of DFT is insufficient to describe their physics. DMFT accounts for the electron-electron interaction by providing a fully interacting many body correction to the DFT non-interacting problem.\n",
+    "\n",
+    "If you want to generate the h5 archive `svo.h5` yourself, all the necessary files are in the `./quantum_espresso_files/` folder. We used quantum espresso in this tutorial.\n",
+    "\n"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "49c97aa6",
+   "id": "92a23678",
    "metadata": {},
    "source": [
     "---\n",
@@ -45,26 +50,26 @@
   },
   {
    "cell_type": "markdown",
-   "id": "f5a438de",
+   "id": "52c8dd9c",
    "metadata": {},
    "source": [
     "```\n",
-    "it |      mu |      G(beta/2) per orbital     |          orbital occs up+down |  impurity occ \n",
-    "0  | 0.00612 |-0.09865  -0.09865     -0.09865 | 0.33326  0.33326      0.33326 |       0.99979\n",
-    "1  | 0.00612 |-0.08200  -0.08277     -0.08239 | 0.31959  0.31995      0.32344 |       0.96298\n",
-    "2  | 0.06456 |-0.06893  -0.06847     -0.06900 | 0.32333  0.31890      0.33503 |       0.97725\n",
-    "3  | 0.08172 |-0.06873  -0.06922     -0.06997 | 0.33488  0.32465      0.32783 |       0.98735\n",
-    "4  | 0.09147 |-0.06892  -0.06967     -0.06909 | 0.32308  0.32812      0.33074 |       0.98194\n",
-    "5  | 0.10094 |-0.06916  -0.06912     -0.06902 | 0.32598  0.33605      0.32722 |       0.98925\n",
-    "6  | 0.10848 |-0.06926  -0.06942     -0.06928 | 0.33359  0.32518      0.33127 |       0.99004\n",
-    "7  | 0.11442 |-0.06931  -0.06961     -0.06954 | 0.32622  0.32944      0.32926 |       0.98492\n",
-    "8  | 0.12258 |-0.06935  -0.06951     -0.06986 | 0.34122  0.33316      0.33515 |       1.00952\n",
+    " it |        mu |            G(beta/2) per orbital |               orbital occs up+down |impurity occ\n",
+    "  0 |  12.29775 | -0.10489   -0.10489     -0.10489 |  0.33366      0.33366      0.33366 |     1.00097\n",
+    "  1 |  12.29775 | -0.09467   -0.09488     -0.09529 |  0.36155      0.35073      0.36169 |     1.07397\n",
+    "  2 |  12.31989 | -0.08451   -0.08363     -0.08463 |  0.33581      0.34048      0.34488 |     1.02117\n",
+    "  3 |  12.29775 | -0.08282   -0.08296     -0.08254 |  0.32738      0.34572      0.34479 |     1.01789\n",
+    "  4 |  12.28973 | -0.08617   -0.08595     -0.08620 |  0.33546      0.33757      0.33192 |     1.00494\n",
+    "  5 |  12.28825 | -0.08410   -0.08458     -0.08510 |  0.33582      0.33402      0.33759 |     1.00743\n",
+    "  6 |  12.28486 | -0.08474   -0.08549     -0.08618 |  0.32276      0.33028      0.32760 |     0.98063\n",
+    "  7 |  12.29097 | -0.08172   -0.08220     -0.08118 |  0.32072      0.33046      0.33529 |     0.98647\n",
+    "  8 |  12.29497 | -0.08318   -0.08254     -0.08332 |  0.34075      0.32957      0.33089 |     1.00120\n",
     "```"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "4854d140",
+   "id": "93ebb13b",
    "metadata": {},
    "source": [
     "The meaning of the column names is the following:\n",
@@ -79,65 +84,65 @@
   },
   {
    "cell_type": "markdown",
-   "id": "46de4580",
+   "id": "cfcd9e65",
    "metadata": {},
    "source": [
     "## 2. Looking at the Metal-Insulator Transition\n",
     "\n",
-    "Strontium Vanadate (SVO) has 1 electron per d-orbital manifold. In the following steps we will try to drive the system towards a Mott-insulating state. \n",
+    "In the following steps we will try to drive the system towards a Mott-insulating state. \n",
     "\n",
     "Inspect the script `run_MIT_coarse.sh`, we iterate the same type of calculation that was performed in the last step for a series of value of U {2-10} and J {0.0-1.0}. \n",
     "\n",
-    "Run the script, sit back and have a long coffee break, this is going to take a while (about 10 hours on 30 cores).\n",
+    "Run the script, sit back and have a long coffee break, this is going to take a while (about 6 hours on 30 cores).\n",
     "\n",
     "Once the run is finished run \n",
     "\n",
     "`python3 ./collect_results_coarse.py`\n",
     "\n",
-    "The script will produce a heatmap image of the value of G(beta/2) for each pair of U and J. The white area corresponds to an insulating state.\n",
+    "The script will produce a heatmap image of the value of G(beta/2) for each pair of U and J. The darker area corresponds to an insulating state.\n",
     "\n",
-    "![coarsegrid](./ref/MIT_transition.jpg \"Coarser grid\")\n",
+    "![coarsegrid](./ref/MIT_coarse.jpg \"Coarser grid\")\n",
     "\n",
     "Do you notice anything strange? (hint: look at the bottom right corner and check the output file `observables_imp0.dat` for U = 2 J=1.0. )\n",
     "\n",
-    "We have seen that for 1 electron per system U and J are competing against each other: larger J favor the metallic state. The coulomb integral U wants to repel neighbouring electrons while J would like to bring electrons together on one site,. When the latter component dominates the resulting phase is known as a charge disproportionated state which is also insulating. What is happening in the bottom right corner is that the J favors here charge disproportionation but the unit cell has a single site, therefore the system has trouble converging and oscillate between a high occupation and a low occupation state."
+    "We have seen that for 1 electron per system U and J are competing against each other: larger J favor the metallic state. The coulomb integral U wants to repel neighbouring electrons while J would like to bring electrons together on one site,. When the latter component dominates the resulting phase is known as a charge disproportionated state which is also insulating. What is happening in the bottom right corner is that the J favors here charge disproportionation but the unit cell has a single site, therefore the system has trouble converging and oscillates between a high occupation and a low occupation state."
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "2de58391",
+   "id": "d26e65ed",
    "metadata": {},
    "source": [
-    "## 3. Refinining the diagram\n",
+    "## 3. Refining the diagram\n",
     "\n",
     "In order to get better resolution in terms of the diagram you can run the script `run_MIT_fine.sh` and plot the result with \n",
     "\n",
     "`python3 ./collect_results_fine.py`\n",
     "\n",
     "The result is also visible here:\n",
     "\n",
-    "![finegrid](./ref/MIT_transition_fine.jpg \"Finer grid\")\n",
+    "![finegrid](./ref/MIT_fine.jpg \"Finer grid\")\n",
     "\n"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "4535ba02",
+   "id": "a195cb3c",
    "metadata": {},
    "source": [
     "## 4. Plotting the spectral function\n",
     "\n",
     "The spectral function in DMFT represents the local density of states of the impurity site.\n",
-    "In order to plot it we need to use one of the scripts that implements the maximum entropy method ( [Maxent](https://triqs.github.io/maxent/latest/) ), while in the folder run (sub `/path_to_solid_dmft/` with where you have installed solid_dmft) :\n",
+    "In order to plot it we need to use one of the scripts that implements the maximum entropy method ( [Maxent](https://triqs.github.io/maxent/latest/) ), while in the folder run (be aware that you need to substitute `/path_to_solid_dmft/` with the path where you have installed solid_dmft) :\n",
     "\n",
-    "`python3 /path_to_solid_dmft/maxent_scripts/maxent_gf_imp.py ./J0.0/U5/out/SCO.h5`\n",
+    "`mpirun -n 30 python3 /path_to_solid_dmft/python/solid_dmft/postprocessing/maxent_gf_imp.py ./J0.0/U4/out/svo.h5`\n",
     "\n",
     "and plot the result by running in the docker container:\n",
     "\n",
     "`python3 read_spectral_function.py`\n",
     "\n",
     "\n",
-    "![Afunc](./ref/A_func_J=0.0_U=4.25.jpg \"Afunc\")\n",
+    "![Afunc](./ref/A_func_J=0.0_U=4.jpg \"Afunc\")\n",
     "\n",
     "\n",
     "Take care to edit the values of J and U in the python file. What is happing to the spectral function (density of states) as one cranks U up?\n",
@@ -146,18 +151,18 @@
   },
   {
    "cell_type": "markdown",
-   "id": "261eb2de",
+   "id": "816a47e8",
    "metadata": {},
    "source": [
     "## 5 Visualizing the MIT\n",
     "\n",
     "We will now plot the spectral function at different U values for J = 0.0 eV:\n",
     "\n",
-    "Run the script:\n",
+    "Run the script `run_maxent_scan.sh`.\n",
     "\n",
-    "```\n",
-    "python3 read_spectral_function_transition.py\n",
-    "```\n",
+    "Then collect the data:\n",
+    "\n",
+    "`python3 read_spectral_function_transition.py`\n",
     "\n",
     "![MIT](./ref/A_func_transition.jpg \"MIT\")\n",
     "\n",

diff --git a/.doctrees/tutorials/Ce2O3_csc_w90/tutorial.doctree b/.doctrees/tutorials/Ce2O3_csc_w90/tutorial.doctree
diff --git a/.doctrees/tutorials/SVO_os_qe/tutorial.doctree b/.doctrees/tutorials/SVO_os_qe/tutorial.doctree
diff --git a/ChangeLog.html b/ChangeLog.html
@@ -179,7 +179,7 @@
 <li class="toctree-l2"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_images/A_func_J=0.0_U=4.jpg b/_images/A_func_J=0.0_U=4.jpg
diff --git a/_images/A_func_transition.jpg b/_images/A_func_transition.jpg
diff --git a/_images/MIT_coarse.jpg b/_images/MIT_coarse.jpg
diff --git a/_images/MIT_fine.jpg b/_images/MIT_fine.jpg
diff --git a/_images/bnd_structure.png b/_images/bnd_structure.png
diff --git a/_modules/csc_flow.html b/_modules/csc_flow.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dft_managers/mpi_helpers.html b/_modules/dft_managers/mpi_helpers.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dft_managers/qe_manager.html b/_modules/dft_managers/qe_manager.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dft_managers/vasp_manager.html b/_modules/dft_managers/vasp_manager.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dmft_cycle.html b/_modules/dmft_cycle.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dmft_tools/afm_mapping.html b/_modules/dmft_tools/afm_mapping.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>

diff --git a/_modules/dmft_tools/convergence.html b/_modules/dmft_tools/convergence.html
@@ -178,7 +178,7 @@
 <li class="toctree-l2"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html">1. OS with QE/W90 and cthyb: SrVO3 MIT</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#1.-Starting-out-with-DMFT">1. Starting out with DMFT</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#2.-Looking-at-the-Metal-Insulator-Transition">2. Looking at the Metal-Insulator Transition</a></li>
-<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refinining-the-diagram">3. Refinining the diagram</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#3.-Refining-the-diagram">3. Refining the diagram</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#4.-Plotting-the-spectral-function">4. Plotting the spectral function</a></li>
 <li class="toctree-l3"><a class="reference internal" href="../../tutorials/SVO_os_qe/tutorial.html#5-Visualizing-the-MIT">5 Visualizing the MIT</a></li>
 </ul>