{ "cells": [ { "cell_type": "markdown", "id": "81c543e7", "metadata": {}, "source": [ "# Full workflow" ] }, { "cell_type": "markdown", "id": "388fd578", "metadata": {}, "source": [ "This notebook outlines a complete ramannoodle workflow and is, as always, available on [Github](https://github.com/wolearyc/ramannoodle/blob/main/docs/source/notebooks/full-workflow.ipynb). \n", "\n", "Here, we will use [ARTModel](../generated/ramannoodle.pmodel.html#module-ramannoodle.pmodel.art.ARTModel), a flavor of [InterpolationModel](../generated/ramannoodle.pmodel.html#module-ramannoodle.pmodel.interpolation.InterpolationModel), to again calculate TiO2's Raman spectrum. ARTModel uses \"atomic Raman tensors\" to predict polarizabilities, but is ultimately an InterpolationModel where\n", "\n", "1. All degrees of freedom (DOFs) are single atom displacements.\n", "2. All interpolations are first-order.\n", "3. Only two polarizabilities are used to construct each interpolation.\n", "\n", "Under these conditions, we dub each DOF polarizability interpolation (or more precisely, the derivative of the interpolation) as an **atomic Raman tensor**, or ART.\n", "\n", "Although [ARTModel](../generated/ramannoodle.pmodel.html#module-ramannoodle.pmodel.art.ARTModel) dictates that each DOF is a single atom displacement, we are free to choose the three orthogonal directions of the atom displacements. This means there are an infinite number of valid DOFs! Ultimately, the chosen atomic DOFs depends on user preference as well as the research question at hand. Still, wise choice of atomic DOFs can significantly reduce the cost of Raman calculations. \n", "\n", "Regardless of how we choose our DOFs, we want to be sure that our DOFs are **valid** before carrying out expensive polarizability calculations and feeding the results into [ARTModel](../generated/ramannoodle.pmodel.html#module-ramannoodle.pmodel.art.ARTModel). To check our DOFs, we use **dummy models**. Essentially, we will build up a polarizability model in the usual way, except we instruct the model to internally generate \"dummy polarizabilities\". Although a dummy model cannot be used to predict polarizabilities (and therefore cannot be used to compute Raman spectra), it allows us to perform a dry run before we expend our valuable computational resources.\n", "\n", "We'll begin with some imports and some customizations to matplotlib. " ] }, { "cell_type": "code", "execution_count": 1, "id": "3956373a-63a1-4128-b0f2-e2711b5a5213", "metadata": {}, "outputs": [], "source": [ "import numpy as np\n", "from matplotlib import pyplot as plt\n", "import matplotlib_inline\n", "\n", "matplotlib_inline.backend_inline.set_matplotlib_formats('png')\n", "plt.rcParams['figure.dpi'] = 300\n", "plt.rcParams['font.family'] = 'sans-serif'\n", "plt.rcParams[\"mathtext.default\"] = 'regular'\n", "plt.rcParams['axes.linewidth'] = 0.5\n", "plt.rcParams['xtick.major.width'] = 0.5\n", "plt.rcParams['xtick.minor.width'] = 0.5\n", "plt.rcParams['lines.linewidth'] = 1.5\n", "\n", "import ramannoodle as rn" ] }, { "cell_type": "markdown", "id": "d7da690f-f4db-4509-8c89-014e7a49c83b", "metadata": {}, "source": [ "### Setup of dummy model\n", "\n", "Our final goal is to calculate TiO2's Raman spectrum. As in the [basic tutorial](../notebooks/basics.html), we will start by reading in a reference structure. " ] }, { "cell_type": "code", "execution_count": 2, "id": "6102769c-0416-497a-b6a9-e451b66ca71d", "metadata": {}, "outputs": [], "source": [ "data_dir = \"../../../test/data/TiO2\"\n", "ref_structure = rn.io.vasp.poscar.read_ref_structure(f\"{data_dir}/POSCAR\")" ] }, { "cell_type": "markdown", "id": "c6831e95", "metadata": {}, "source": [ "Now that we have the reference structure, we can initialize the polarizability model. We do this the usual way, but we specify `is_dummy_model = True`. Because this is a dummy model, the value for `ref_polarizability` is completely ignored. We simply set it to ``np.zeros((3,3))``. " ] }, { "cell_type": "code", "execution_count": 3, "id": "f14761e9-96a8-4317-94cb-47153683eb88", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "╭──────────────┬──────────────┬─────────────┬────────────────────╮\n", "│ Atom index │ Directions │ Specified │ Equivalent atoms │\n", "├──────────────┼──────────────┼─────────────┼────────────────────┤\n", "│ 0 │ │ \u001b[1;31;49m0/3\u001b[0m │ 35 │\n", "│ 36 │ │ \u001b[1;31;49m0/3\u001b[0m │ 71 │\n", "╰──────────────┴──────────────┴─────────────┴────────────────────╯\n", " \u001b[1;33;49m ATTENTION: this is a dummy model. \u001b[0m" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" } ], "source": [ "model = rn.pmodel.ARTModel(ref_structure=ref_structure, \n", " ref_polarizability = np.zeros((3,3)), \n", " is_dummy_model=True) \n", "model" ] }, { "cell_type": "markdown", "id": "58d82797", "metadata": {}, "source": [ "Note that the `__repr__` string indicates that this is a dummy model. In addition, we see that there are two symmetrically distinct atoms: a Ti (at index 0) and an O (at index 36). In this structure, all Ti atoms are equivalent to one another as are all oxygens. Our task is therefore to compute and add DOFs for a single Ti atom and a single O atom. Ramannoodle will use symmetry to derive the remaining DOFs, at which point the model is fully specified. \n", "\n", "### Specifying candidate displacements\n", "\n", "For this example, we will choose atomic displacements along the x, y, and z directions as our DOFs. We first generate structures for these displacements then calculate the polarizabilities from first principles (in our case using VASP). To help set up these calculations, ramannoodle provides functions to write displaced structures in [ramannoodle.structure.displace](../generated/ramannoodle.structure.html#module-ramannoodle.structure.displace). Since we're using atomic Raman tensors, we will use [write_ast_displaced_structures](../generated/ramannoodle.structure.html#ramannoodle.structure.displace.write_ast_displaced_structures)." ] }, { "cell_type": "code", "execution_count": 4, "id": "bbc1b080", "metadata": {}, "outputs": [], "source": [ "# Degrees of freedom (atomic Raman tensor) for one of the Ti atoms\n", "rn.structure.write_ast_displaced_structures(\n", " ref_structure=ref_structure,\n", " atom_index=4,\n", " cart_direction=np.array([1,0,0]), # x direction\n", " amplitudes = np.array([0.1]), # -0.1 is symmetrically equivalent\n", " filepaths = [\"Ti5_0.1x_eps_POSCAR\"],\n", " file_format='poscar',\n", " overwrite=True\n", ")\n", "rn.structure.write_ast_displaced_structures(\n", " ref_structure=ref_structure,\n", " atom_index=4,\n", " cart_direction=np.array([0,0,1]), # z direction\n", " amplitudes = np.array([0.1]), # -0.1 is symmetrically equivalent\n", " filepaths = [\"Ti5_0.1z_eps_POSCAR\"],\n", " file_format='poscar',\n", " overwrite=True\n", ")\n", "\n", "# Degrees of freedom (atomic Raman tensor) for one of the O atoms\n", "rn.structure.write_ast_displaced_structures(\n", " ref_structure=ref_structure,\n", " atom_index=42,\n", " cart_direction=np.array([1,0,0]), # x direction\n", " amplitudes = np.array([0.1]), # -0.1 is symmetrically equivalent\n", " filepaths = [\"O43_0.1x_eps_POSCAR\"],\n", " file_format='poscar',\n", " overwrite=True\n", ")\n", "rn.structure.write_ast_displaced_structures(\n", " ref_structure=ref_structure,\n", " atom_index=42,\n", " cart_direction=np.array([0,1,0]), # y direction\n", " amplitudes = np.array([0.1]), # -0.1 is symmetrically equivalent\n", " filepaths = [\"O43_0.1y_eps_POSCAR\"],\n", " file_format='poscar',\n", " overwrite=True,\n", ")\n", "rn.structure.write_ast_displaced_structures(\n", " ref_structure=ref_structure,\n", " atom_index=42,\n", " cart_direction=np.array([0,0,1]), # z direction\n", " amplitudes = np.array([-0.1,0.1]), # these are unique\n", " filepaths = [\"O43_m0.1z_eps_POSCAR\",\"O43_0.1z_eps_POSCAR\"], \n", " file_format='poscar',\n", " overwrite=True\n", ")" ] }, { "cell_type": "markdown", "id": "3c471d73", "metadata": {}, "source": [ "### Testing candidate displacements\n", "\n", "We have chosen our displaced structures based on symmetry and written them to POSCARs. Before calculating polarizabilities with these POSCARs, however, we want to make sure that these displacements **cover all the DOFs of our system**. To do this, we build up our dummy model." ] }, { "cell_type": "code", "execution_count": 5, "id": "beb80d22", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "╭──────────────┬─────────────────────────────────────────────┬─────────────┬────────────────────╮\n", "│ Atom index │ Directions │ Specified │ Equivalent atoms │\n", "├──────────────┼─────────────────────────────────────────────┼─────────────┼────────────────────┤\n", "│ 0 │ [-1. -0. +0.], [-0. -1. -0.], [-0. -0. +1.] │ \u001b[1;32;49m3/3\u001b[0m │ 35 │\n", "│ 36 │ [+0. +0. +1.], [+1. +0. +0.], [+0. +1. +0.] │ \u001b[1;32;49m3/3\u001b[0m │ 71 │\n", "╰──────────────┴─────────────────────────────────────────────┴─────────────┴────────────────────╯\n", " \u001b[1;33;49m ATTENTION: this is a dummy model. \u001b[0m" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Now we can add the outcars. Because we have a dummy model, ramannoodle will not look for polarizabilities in these files. Therefore, we could use OUTCARs from other calculations or (more commonly) use POSCARs.\n", "model.add_art_from_files(\n", " [\"Ti5_0.1x_eps_POSCAR\"], file_format = 'poscar'\n", " )\n", "model.add_art_from_files(\n", " [\"Ti5_0.1z_eps_POSCAR\"],file_format = 'poscar'\n", " )\n", "model.add_art_from_files(\n", " [\"O43_0.1z_eps_POSCAR\", \"O43_m0.1z_eps_POSCAR\"], \n", " file_format=\"poscar\"\n", ")\n", "model.add_art_from_files(\n", " [\"O43_0.1x_eps_POSCAR\"], file_format = 'poscar'\n", ")\n", "model.add_art_from_files([\"O43_0.1y_eps_POSCAR\"],file_format = 'poscar')\n", "model" ] }, { "cell_type": "markdown", "id": "d361e957", "metadata": {}, "source": [ "Note that dummy polarizability models can be built up using files containing no polarizability data (such as POSCARs). \n", "\n", "All degrees of freedom have been specified. Clearly, we chose our DOFs wisely. Nice work! Just for kicks, what will happen if we try to compute a Raman spectrum with this dummy model?" ] }, { "cell_type": "code", "execution_count": 7, "id": "f15f0b63", "metadata": {}, "outputs": [ { "ename": "UserError", "evalue": "dummy model cannot calculate polarizabilities", "output_type": "error", "traceback": [ "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", "\u001b[0;31mValueError\u001b[0m Traceback (most recent call last)", "File \u001b[0;32m~/Research/DFT/ramannoodle/ramannoodle/pmodel/interpolation.py:224\u001b[0m, in \u001b[0;36mInterpolationModel.calc_polarizabilities\u001b[0;34m(self, positions_batch)\u001b[0m\n\u001b[1;32m 222\u001b[0m \u001b[38;5;28;01mtry\u001b[39;00m:\n\u001b[0;32m--> 224\u001b[0m \u001b[43m \u001b[49m\u001b[38;5;28;43;01mfor\u001b[39;49;00m\u001b[43m \u001b[49m\u001b[43mbasis_vector\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43minterpolation\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mmask\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;129;43;01min\u001b[39;49;00m\u001b[43m \u001b[49m\u001b[38;5;28;43mzip\u001b[39;49m\u001b[43m(\u001b[49m\n\u001b[1;32m 225\u001b[0m \u001b[43m \u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43m_cart_basis_vectors\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m 226\u001b[0m \u001b[43m \u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43m_interpolations\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m 227\u001b[0m \u001b[43m \u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43m_mask\u001b[49m\u001b[43m,\u001b[49m\n\u001b[1;32m 228\u001b[0m \u001b[43m \u001b[49m\u001b[43mstrict\u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[38;5;28;43;01mTrue\u001b[39;49;00m\u001b[43m,\u001b[49m\n\u001b[1;32m 229\u001b[0m \u001b[43m \u001b[49m\u001b[43m)\u001b[49m\u001b[43m:\u001b[49m\n\u001b[1;32m 230\u001b[0m \u001b[43m \u001b[49m\u001b[43mamplitudes\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m=\u001b[39;49m\u001b[43m \u001b[49m\u001b[43mnp\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43meinsum\u001b[49m\u001b[43m(\u001b[49m\n\u001b[1;32m 231\u001b[0m \u001b[43m \u001b[49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[38;5;124;43mi,ji\u001b[39;49m\u001b[38;5;124;43m\"\u001b[39;49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mbasis_vector\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mflatten\u001b[49m\u001b[43m(\u001b[49m\u001b[43m)\u001b[49m\u001b[43m,\u001b[49m\u001b[43m \u001b[49m\u001b[43mcart_displacements\u001b[49m\n\u001b[1;32m 232\u001b[0m \u001b[43m \u001b[49m\u001b[43m)\u001b[49m\n", "\u001b[0;31mValueError\u001b[0m: zip() argument 2 is shorter than argument 1", "\nThe above exception was the direct cause of the following exception:\n", "\u001b[0;31mUserError\u001b[0m Traceback (most recent call last)", "Cell \u001b[0;32mIn[7], line 3\u001b[0m\n\u001b[1;32m 1\u001b[0m \u001b[38;5;66;03m# Compute and plot spectrum\u001b[39;00m\n\u001b[1;32m 2\u001b[0m phonons \u001b[38;5;241m=\u001b[39m rn\u001b[38;5;241m.\u001b[39mio\u001b[38;5;241m.\u001b[39mvasp\u001b[38;5;241m.\u001b[39moutcar\u001b[38;5;241m.\u001b[39mread_phonons(\u001b[38;5;124mf\u001b[39m\u001b[38;5;124m\"\u001b[39m\u001b[38;5;132;01m{\u001b[39;00mdata_dir\u001b[38;5;132;01m}\u001b[39;00m\u001b[38;5;124m/phonons_OUTCAR\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n\u001b[0;32m----> 3\u001b[0m spectrum \u001b[38;5;241m=\u001b[39m \u001b[43mphonons\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mget_raman_spectrum\u001b[49m\u001b[43m(\u001b[49m\u001b[43mmodel\u001b[49m\u001b[43m)\u001b[49m\n\u001b[1;32m 4\u001b[0m wavenumbers, total_intensities \u001b[38;5;241m=\u001b[39m spectrum\u001b[38;5;241m.\u001b[39mmeasure(laser_correction \u001b[38;5;241m=\u001b[39m \u001b[38;5;28;01mTrue\u001b[39;00m, \n\u001b[1;32m 5\u001b[0m laser_wavelength \u001b[38;5;241m=\u001b[39m \u001b[38;5;241m532\u001b[39m, \n\u001b[1;32m 6\u001b[0m bose_einstein_correction \u001b[38;5;241m=\u001b[39m \u001b[38;5;28;01mTrue\u001b[39;00m, \n\u001b[1;32m 7\u001b[0m temperature \u001b[38;5;241m=\u001b[39m \u001b[38;5;241m300\u001b[39m)\n\u001b[1;32m 8\u001b[0m fig \u001b[38;5;241m=\u001b[39m plt\u001b[38;5;241m.\u001b[39mfigure()\n", "File \u001b[0;32m~/Research/DFT/ramannoodle/ramannoodle/dynamics/phonon.py:96\u001b[0m, in \u001b[0;36mPhonons.get_raman_spectrum\u001b[0;34m(self, polarizability_model)\u001b[0m\n\u001b[1;32m 94\u001b[0m \u001b[38;5;28;01mtry\u001b[39;00m:\n\u001b[1;32m 95\u001b[0m epsilon \u001b[38;5;241m=\u001b[39m displacement \u001b[38;5;241m*\u001b[39m RAMAN_TENSOR_CENTRAL_DIFFERENCE\n\u001b[0;32m---> 96\u001b[0m plus \u001b[38;5;241m=\u001b[39m \u001b[43mpolarizability_model\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mcalc_polarizabilities\u001b[49m\u001b[43m(\u001b[49m\n\u001b[1;32m 97\u001b[0m \u001b[43m \u001b[49m\u001b[43mnp\u001b[49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43marray\u001b[49m\u001b[43m(\u001b[49m\u001b[43m[\u001b[49m\u001b[38;5;28;43mself\u001b[39;49m\u001b[38;5;241;43m.\u001b[39;49m\u001b[43mref_positions\u001b[49m\u001b[43m \u001b[49m\u001b[38;5;241;43m+\u001b[39;49m\u001b[43m \u001b[49m\u001b[43mepsilon\u001b[49m\u001b[43m]\u001b[49m\u001b[43m)\u001b[49m\n\u001b[1;32m 98\u001b[0m \u001b[43m \u001b[49m\u001b[43m)\u001b[49m[\u001b[38;5;241m0\u001b[39m]\n\u001b[1;32m 99\u001b[0m minus \u001b[38;5;241m=\u001b[39m polarizability_model\u001b[38;5;241m.\u001b[39mcalc_polarizabilities(\n\u001b[1;32m 100\u001b[0m np\u001b[38;5;241m.\u001b[39marray([\u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39mref_positions \u001b[38;5;241m-\u001b[39m epsilon])\n\u001b[1;32m 101\u001b[0m )[\u001b[38;5;241m0\u001b[39m]\n\u001b[1;32m 102\u001b[0m \u001b[38;5;28;01mexcept\u001b[39;00m \u001b[38;5;167;01mValueError\u001b[39;00m \u001b[38;5;28;01mas\u001b[39;00m exc:\n", "File \u001b[0;32m~/Research/DFT/ramannoodle/ramannoodle/pmodel/interpolation.py:238\u001b[0m, in \u001b[0;36mInterpolationModel.calc_polarizabilities\u001b[0;34m(self, positions_batch)\u001b[0m\n\u001b[1;32m 236\u001b[0m \u001b[38;5;28;01mexcept\u001b[39;00m \u001b[38;5;167;01mValueError\u001b[39;00m \u001b[38;5;28;01mas\u001b[39;00m err:\n\u001b[1;32m 237\u001b[0m \u001b[38;5;28;01mif\u001b[39;00m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39m_is_dummy_model:\n\u001b[0;32m--> 238\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m UserError(\n\u001b[1;32m 239\u001b[0m \u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mdummy model cannot calculate polarizabilities\u001b[39m\u001b[38;5;124m\"\u001b[39m\n\u001b[1;32m 240\u001b[0m ) \u001b[38;5;28;01mfrom\u001b[39;00m \u001b[38;5;21;01merr\u001b[39;00m\n\u001b[1;32m 241\u001b[0m \u001b[38;5;28;01mraise\u001b[39;00m err\n\u001b[1;32m 243\u001b[0m \u001b[38;5;28;01mreturn\u001b[39;00m delta_polarizabilities \u001b[38;5;241m+\u001b[39m \u001b[38;5;28mself\u001b[39m\u001b[38;5;241m.\u001b[39m_ref_polarizability\n", "\u001b[0;31mUserError\u001b[0m: dummy model cannot calculate polarizabilities" ] } ], "source": [ "# Compute and plot spectrum\n", "phonons = rn.io.vasp.outcar.read_phonons(f\"{data_dir}/phonons_OUTCAR\")\n", "spectrum = phonons.get_raman_spectrum(model)\n", "wavenumbers, total_intensities = spectrum.measure(laser_correction = True, \n", " laser_wavelength = 532, \n", " bose_einstein_correction = True, \n", " temperature = 300)\n", "fig = plt.figure()\n", "axis = fig.add_subplot(111)\n", "axis.plot(wavenumbers, total_intensities)" ] }, { "cell_type": "markdown", "id": "49feb409", "metadata": {}, "source": [ "Since dummy models contain no polarizability information, they cannot be used to compute spectra! \n", "\n", "### Calculating a Raman spectrum\n", "\n", "Now that we're sure our DOFs are valid, we carry out the polarizability calculations using VASP. We can then construct the real model, this time pointing to OUTCARs generated from these polarizability calculations." ] }, { "cell_type": "code", "execution_count": 9, "id": "147f6a26-a22a-4cff-9659-336d6316e0b1", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "╭──────────────┬─────────────────────────────────────────────┬─────────────┬────────────────────╮\n", "│ Atom index │ Directions │ Specified │ Equivalent atoms │\n", "├──────────────┼─────────────────────────────────────────────┼─────────────┼────────────────────┤\n", "│ 0 │ [-1. -0. +0.], [-0. -1. -0.], [-0. -0. +1.] │ \u001b[1;32;49m3/3\u001b[0m │ 35 │\n", "│ 36 │ [+0. -0. +1.], [+1. -0. -0.], [+0. +1. -0.] │ \u001b[1;32;49m3/3\u001b[0m │ 71 │\n", "╰──────────────┴─────────────────────────────────────────────┴─────────────┴────────────────────╯" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "_, ref_polarizability = rn.io.vasp.outcar.read_positions_and_polarizability(\n", " f\"{data_dir}/ref_eps_OUTCAR\"\n", ")\n", "model = rn.pmodel.ARTModel(ref_structure=ref_structure, \n", " ref_polarizability = ref_polarizability) \n", "\n", "model.add_art_from_files(\n", " [f\"{data_dir}/Ti5_0.1x_eps_OUTCAR\"], file_format = 'outcar'\n", " )\n", "model.add_art_from_files(\n", " [f\"{data_dir}/Ti5_0.1z_eps_OUTCAR\"],file_format = 'outcar'\n", " )\n", "model.add_art_from_files(\n", " [f\"{data_dir}/O43_0.1z_eps_OUTCAR\", f\"{data_dir}/O43_m0.1z_eps_OUTCAR\"], \n", " file_format=\"outcar\"\n", ")\n", "model.add_art_from_files(\n", " [f\"{data_dir}/O43_0.1x_eps_OUTCAR\"], file_format = 'outcar'\n", ")\n", "model.add_art_from_files([f\"{data_dir}/O43_0.1y_eps_OUTCAR\"],file_format = 'outcar')\n", "model" ] }, { "cell_type": "markdown", "id": "2f249e8a", "metadata": {}, "source": [ "Now we calculate the Raman spectrum." ] }, { "cell_type": "code", "execution_count": 10, "id": "b1f2cb2c-8444-4b6a-ae8e-f1ac6c6a6e98", "metadata": {}, "outputs": [ { "data": { "image/png": "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9Vptp512Wjz//POZdX19fVx77bWxevXqeOqpp2L+/PmxevXquOaaa7ICYc8++2ycfvrp3XrGkiVL4swzz4x0Op3Z22GHHeL73/9+rFmzJhYsWBB//etf4+mnn47XX389br755th5552zzvjGN74R//d//7eNnxYAoLKt35AwGrI7HcEEwQAAAAAAAPoNQbASePnll+Mb3/hG1t6VV14Z119/fYwcOTKzV1VVFccff3zMnj07dt9998z+smXL4pprrumV2u6+++74wx/+kFnX1tbGXXfdFWeffXYMHjw4s9/Y2Bhf/OIX449//GNWx67bb7897rvvvq0+5+qrr47m5ubMeocddojZs2fHZz/72RgyZEjWtfX19fGxj30s/va3v8Vuu+2W2U+n0/H1r3+9R58TAGCgSApzbR7+aqjN/c+C1oQQGQAAAAAAAOVHEKwEpk+fHmvXrs2sDz/88Jg2bVri9bvsskv86Ec/ytr79re/HS+//HLRa+s6bvH888+Pww8/PPH6d77znVvU/tWvfnWrz+naDe2CCy6IMWPG5L1n5MiRMX369Ky9++67L9atW7fV5wEADFQt7QmjITcLfw1K6AjWuqGzV2oCAAAAAACg+ATB+lhnZ2fcdNNNWXtf+9rXIpVK5b3vyCOPjMMOOyyzXrt2bdxyyy1Fre3JJ5+Mhx9+OLNubGyMc889d6v3nXfeedHY2JhZz549OxYsWJB4fUtLSyxdujRr74QTTuhWjR/4wAeipqYms25vb48lS5Z0614AgIFofXvuMFf9ZuGvuurc/yxoEwQDAAAAAADoNwTB+tjs2bNj1apVmfWee+4ZU6ZM6da9Z5xxRtZ65syZRaxsyy5dJ510UgwdOnSr9w0dOjROPPHErL18tb3yyitb7G0+8jGfwYMHx/Dhw7P21qxZ0617AQAGovUJHcE2Hw05KHE0pCAYAAAAAABAfyEI1sfuvPPOrPVRRx211W5gm1+7ufvvvz+ampp6rbajjz662/d2re2OO+5IvHbYsGFb7LW0tHT7WV2v7RoMAwBgo3Q6nTgasqFusyBYTcJoyIR7AQAAAAAAKD+CYH3s8ccfz1pPnjy52/eOHDkydt9998y6ra0t5s+fX5S60ul0PPHEEz2u7dBDD81az5s3L9LpdM5rhwwZEnvttVfW3iOPPNKt5/zjH/+I1157LbPeYYcd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r8QPfvCDvOcBALBRYaMht+wSFqEjGAAAAAAAQH8hCFYC06ZNyxrp+MADD8RVV12VeP3y5cvjk5/8ZNbe2WefndVZLJdUKpX1053OY5dffnnW+pvf/GbMmjUr8fpctV9xxRV5n3Hcccdlff7W1tb48Ic/HK+++mre+9atWxcnnnhivPLKK5m92traOOWUU/LeBwAwUCWPhtzynwFJoyFb2wXBAAAAAAAA+gNBsBIYPnx4XHjhhVl7F1xwQUydOjVWrFiR2evs7IyZM2fG5MmT44UXXsjsjxw5Mr785S/3Sm3vfve74+ijj86s29vb45hjjonrrrsumpubM/tNTU1x7bXXxrvf/e5ob2/P7B977LFb7dA1fPjwOPfcc7P2/va3v8X+++8fN9988xbjKFtaWmLGjBnxtre9bYsxkp/+9KeNhgQASFBYR7CEIFjCGQAAAAAAAJSXVHprMwnpFZ2dnXHcccfFHXfckbVfXV0do0ePjmHDhsWiRYtizZo1We83NDTEn/70pzj00EO3+oxUKpW1vu+++2LKlClbve+ll16KQw45JBYtWrTFs/fcc89Ip9OxcOHCWL9+fdb7e+21Vzz00EPxxje+cavP6OjoiA9+8INbfP6IiJqamth7771j2LBhsXbt2nj++eejtbV1i+sOPfTQuOeee6K+vn6rz+tNTU1NmQ5n69ati8bGxpLWAwCwyZdueTx+8+jyLfZPmLRLXHPSxKy90256OO7/+6otrv304XvGhceO7a0SAQAAAAAAKkopcyQ6gpVIVVVVzJgxIz7ykY9k7Xd0dMTChQvjscce2yIE9oY3vCF+//vfdysEti122mmnuO+++2LChAlZ+y0tLfH000/H/PnztwiBTZw4Me67775uhcAiNgbeZsyYEVOnTt3ivQ0bNsQzzzwTc+bMifnz5+cMgf37v/97/P73vy95CAwAoJwVMhoysSNYe0dRawIAAAAAAKB3CIKVUH19ffzqV7+KW2+9NSZOnJh4XWNjY0ydOjXmz5/frY5exTB69Oh4+OGH46qrroqRI0cmXjdy5MiYPn16zJkzJ3bbbbeCnlFfXx//9V//FQ899FCccsop0dDQkPf6urq6OO644+Lee++Nn//857HddtsV9DwAgIEmOQhW3a29CKMhAQAAAAAA+ouaUhdAxIc+9KH40Ic+FM8991zMmTMnli9f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/erq6thjjz1i4sSJMWzYsKz3Vq1aFe95z3vioYce6tXaVq5cGUcccUQ89thjWfsNDQ2x7777xtixY7cYVTl37tw44ogjYvXq1QU/74EHHoiDDjoo5s6dm7VfXV0du+22WxxwwAGx//77x2677Vb4hwEAGECSunYVMhqyrjr32G+jIQEAAAAAAMpXWY+G7M3OV4cffnivnd1dV199ddx2221Ze2eeeWZcfPHFMXLkyIjYGBa77bbb4pxzzoklS5ZERERzc3OcdNJJ8dRTT20RFCuW0047LZ5//vnMur6+Pr75zW/Gpz71qRg8eHBERDQ1NcUNN9wQF154Yaxfvz4iIp599tk4/fTT43e/+123nzVv3rx4//vfH2vXrs3sjR07Ni688MI49thjY8cdd8y6/vXXX48HH3wwbr/99vjVr361LR8TAKDiJI2GLKQjWNK17R3pHtUEAAAAAABA70ul0+my/TanqqoqUqnc3Qi2RSqVig0bNhT93EK8/PLLsccee2SFn6688so4//zzc16/fPnyeMc73hEvvPBCZu+SSy6Jyy67rOi13X333XHMMcdk1rW1tXHPPfckhuceeOCBOOqoo6K9vT2z9+c//zmOOOKIrT6rra0t9t9//5g/f35m74tf/GJcddVVUVtbu9X7W1paIpVKbdGdrC81NTXFkCFDImLjCM/GxsaS1QIA8LYr7onV61q32L/uIxPjuIm7dOuMmx5cFJfdPn+L/TFvGhp/PKf0f1ABAAAAAABQrkqZI+kXoyHT6XTRf0pt+vTpWSGwww8/PKZNm5Z4/S677BI/+tGPsva+/e1vx8svv1z02i6++OKs9fnnn5+3g9o73/nOLWr/6le/2q1nXXnllVkhsKlTp8Y111zTrRBYxMZRlaUMgQEAlJu2DR059+uK0BHMaEgAAAAAAIDyVfZBsJ6GtlKpVNZPOens7Iybbropa+9rX/vaVus88sgj47DDDsus165dG7fccktRa3vyySfj4YcfzqwbGxvj3HPP3ep95513XlaCcfbs2bFgwYK896xcuTKuvPLKzHr06NFx9dVX96BqAAA2SRrfWFfT/V/9k0JjbR2CYAAAAAAAAOWqptQF5HPppZcWfE9zc3OsWrUqHnnkkXj66acjYmMobO+9945///d/L3aJPTJ79uxYtWpVZr3nnnvGlClTunXvGWecEX/5y18y65kzZ8ZnP/vZotV22223Za1POumkGDp06FbvGzp0aJx44onxk5/8JKu2sWPHJt7z05/+NFpb/zW26Nxzz43BgwcXXjQAABntCWGtpC5fuSSFxpLOBgAAAAAAoPQqLgi2uaeeeiouuuiiuP322+P555+P5557Lm666aaoqSntx77zzjuz1kcddVS3u5YdddRRWev7778/mpqaijZPtGttRx99dLfvPeqoo7KCYHfccUdccMEFidffeOONmdc1NTVx8sknd79QAAC20NmZjg2duTuCFRIEMxoSAAAAAACg/yn70ZDb4q1vfWvcdtttcdFFF0U6nY5f/vKX8YlPfKLUZcXjjz+etZ48eXK37x05cmTsvvvumXVbW1vMnz+/KHWl0+l44oknelzboYcemrWeN29e4mjP559/Pv7+979n1vvtt18MHz68gGoBAOgq3+jGQkZD1lbn/iOFpLGTAAAAAAAAlF5FB8E2+frXvx7HHHNMJgz2q1/9qqT1LFiwIGs9bty4gu7ven3X83pq8eLF0dzcnFk3NjbGqFGjun3/6NGjs0Y7NjU1xdKlS3Ne+8gjj2StJ0yYkHm9fPny+M///M84+OCDY+edd476+vrYZZdd4uCDD44LL7wwHn300W7XBAAwkOQb3VhXSEewhNBYvqAZAAAAAAAApTUggmAR/xozmU6nt3nk5LZoaWmJJUuWZO3ttttuBZ3R9frNO2tti67nFFpXrnuSausaBNtzzz0jnU7HddddF3vttVdcdNFFMWfOnPjnP/8Zra2tsWLFipgzZ05ceeWVccABB8SJJ54Y//znPwuuDwCgkuUb3Vhb071R5BERg/KMhkzq+AoAAAAAAEBp1ZS6gL5y8MEHx4477hivvPJKPP/88/HYY4/F/vvv3+d1rF69OuvLs9ra2hgxYkRBZ+yyyy5Z65UrVxaltq7n7LrrrgWfscsuu2SFv5Jqe+6557LW2223XXzmM5+JH/7wh916zq233hqPPPJI/PGPf4wxY8YUXGeSlStXxqpVqwq6Z/MuagAApZRvdGMxOoJFRGzoTCeOjgQAAAAAAKB0BkwQLCJi1KhR8corr0RExKOPPlqSINi6deuy1oMHD45UqrAv0hobG/Oe2VNdz+n6nO7obm1r1qzJWt98881ZIx8nTZoUH/nIR+LNb35zRET84x//iF//+tfx2GOPZa5ZvHhxHHvssfH444/HdtttV3CtuXz/+9+Pyy67rChnAQD0tXyjIWsLCYLluba9o7OgswAAAAAAAOgbAyoIVlX1ry+sitVFq1Bdg1H19fUFn9HQ0JD3zJ7qy9q6BsE2hcCqqqriO9/5TkydOnWLgNy5554b1157bXz5y1/OdFVbtGhRnHPOOfHjH/+44FoBACpNa57RkHV5unxtcW2eoFfbhs4YXFdQWQAAAAAAAPSBAfOn/J2dnbFw4cLMuichp2JYv3591rqurvBv0QYNGpS1bmlp2aaaNunL2pICYldddVV87nOfy9klLZVKxRe/+MW4/PLLs/Z/9rOfxZIlSwquFQCg0uTrCFbIaMi6muSOtW15ngEAAAAAAEDpDJiOYHfccUdWF6o3velNJamjawCtra2t4DNaW1vzntlTfVlbrv2xY8fGl770pa0+4/zzz4+f/vSn8dxzz0VExIYNG+LHP/5xfO1rXyu43q6mTp0aJ554YkH3NDc3x9vf/vZtfjYAwLbKOxqygI5g+UdDpguqCQAAAAAAgL4xIIJgzz//fKbL1KaRgu94xztKUsuQIUOy1l27cHVH1y5bXc/sqb6sLdf+GWeckTW+M0lNTU2cfvrpceGFF2b2HnjggQIrzW3EiBExYsSIgu5pamoqyrMBALZV3iBYdXKXr67yjZFsyzN+EgAAAAAAgNKp2NGQHR0dMW/evLjoooti//33jxUrVkQ6nY5UKhWHHHJI7LbbbiWpq2sAqrm5ORNO666uwaPeCoL1JODU3dpy7b/zne/s9nO6Xvu3v/2t2/cCAFSq1jwhrUJGQ+bvCCYIBgAAAAAAUI7KuiPYnnvu2aP7Wlpa4tVXX4329vaIiEwALCKiuro6vvWtbxWtxkINHz48qzNZe3t7rFy5Mnbaaadun7F8+fKsdaEdrJJ0PWfZsmUFn9Hd2nJ93re85S3dfs4+++yTtV63bl20tLREQ0NDt88AAKg0SWMba6tTmd+HuyNfEExHMAAAAAAAgPJU1kGwF154ISs01ROpVCpzRnV1dfzwhz+Mgw8+uIhVFqahoSFGjRoVixcvzuwtWbKkoCDYkiVLstZjxowpSm1dw1VLly4t+Iyu9yTVNnbs2Kx1KpWKoUOHdvs522233RZ7r776qiAYADCgtSeEtPIFu3IZlG80pI5gAAAAAAAAZalfjIbcFOYq5GeTdDod6XQ63v72t8fs2bPj4x//eAk/yUZdw1Hz588v6P4FCxbkPa+nRo8enRWkampqygqsbc3ixYujubk5s25sbEwcwTlu3LisdTqdjra2tm4/a/369VvsDR48uNv3AwBUoqSQVl2eYFcueUdD6ggGAAAAAABQlsq6I9ioUaMKGmETsTE0Vl9fH9ttt12MHj06Jk2aFMcee2zst99+vVRl4SZOnBh33XVXZl1IQO3FF1+MF154IbOura3dIlTVU6lUKsaPHx9z5szJqm306NHduv/BBx/MWo8fPz7xf79JkyZtsffSSy/FqFGjuvWslStXZq2rq6tj2LBh3boXAKBStScEwQrtCFZdlYqqVERnjsa8SeMnAQAAAAAAKK2yDoJtHniqJO973/viqquuyqzvueeeSKfT3Qq93X333VnrI444IoYMGVLU2jYPgv3pT3+KU045pVv3/ulPf8pav//970+8do899oi3vvWt8dRTT2X25s6d2+0g2Ny5c7PWb3nLWwoODQIAVJq2hG5ddQUGwSI2dhFb377leW0dHQWfBQAAAAAAQO/rF6MhK83kyZNj+PDhmfXChQvj/vvv79a9N954Y9b6uOOOK2Zp8YEPfCBrPWPGjFi3bt1W71u7dm3MmDGjoNqOP/74rPX//u//drPK2OJZU6ZM6fa9AACVqlijISOSu4i1bdARDAAAAAAAoBwJgpVAVVVVnHbaaVl7l112WaTT+b9Uu/fee+Mvf/lLZj106NA46aSTilrb+PHj48ADD8ys161bF9OnT9/qfdOnT4+mpqbM+uCDD97qyMpPfOITUVtbm1nPmDEjnnnmma0+64knnoiZM2dm7RX7vwMAQH/UntARrLa68M6pSV3EksZPAgAAAAAAUFqCYCUybdq0rJGODzzwQNa4yK6WL18en/zkJ7P2zj777KzOYrmkUqmsn+50Hrv88suz1t/85jdj1qxZidfnqv2KK67Y6nP22GOP+PSnP51Zt7W1xUc+8pF45ZVXEu9ZtWpVnHLKKbFhw4bM3sEHH6wjGABARLR35P7DgqTuXvkkdRFLGj8JAAAAAABAaQmClcjw4cPjwgsvzNq74IILYurUqbFixYrMXmdnZ8ycOTMmT54cL7zwQmZ/5MiR8eUvf7lXanv3u98dRx99dGbd3t4exxxzTFx33XXR3Nyc2W9qaoprr702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GnLjvbm7grV3pHt8JgAAAAAAAL1DEAwAACpAUkewfCMet6Y2oZuY0ZAAAAAAAADlRxAMAAAqQFtCl666muoen1mX0E0sKXQGAAAAAABA6QiCAQBABUjq0lW3LR3BEoJgbYJgAAAAAAAAZackQbA//OEPpXhsXuVYEwAAdFfyaMie/8pfZzQkAAAAAABAv1GSINh73/veOOKII2L27NmleHyWBx98MKZMmRLve9/7Sl0KAAD0WFIQLCnM1R1GQwIAAAAAAPQfJRsNOWvWrDjssMPisMMOi9tvvz3S6XSfPTudTsdtt90Whx12WBx++OExa9asPns2AAD0hqQuXdvSEay2JvdYSUEwAAAAAACA8lNTiocOHz48Vq9eHRERs2fPjg9+8IOx6667xumnnx6nnnpq7LXXXr3y3Oeeey5+9rOfxU033RTLly+PiMgE0N74xjf2yjMBAKAvtPXCaMike42GBAAAAAAAKD8l6Qj27LPPxuc///moqamJdDod6XQ6li5dGpdffnm85S1viQkTJsQll1wS9913X7S2tvb4OevXr4/77rsvLrnkkhg/fnzss88+ccUVV8SyZcsiYmMIrKamJr7whS/E3//+92J9PAAA6HNJXboG9cJoyLaOvuvmCwAAAAAAQPeUpCPYsGHD4jvf+U5MnTo1Lrnkkvjf//3fTGeudDodTz75ZDz11FPxjW98I2pra2PcuHHx1re+NfbZZ5/YddddY+edd44hQ4ZEQ0NDpNPpWL9+faxduzZefPHFWLZsWfz973+PJ598Mp555plob2/PnBsRkUr9a7zNiSeeGJdddlmMGTOm7/8jAABAESWPhsw93rE76hJCZEZDAgAAAAAAlJ+SBME2GTNmTNxyyy3x5JNPxlVXXRUzZsyI9vb2TFgrnU5HW1tbPP744zFv3ryCzt4U/IrYGP5KpVKZDmAnnXRSnHfeebHffvsV9fMAAECptCd06TIaEgAAAAAAYGAoyWjIrvbbb7/4+c9/HosXL47LLrss3vzmN28R5Npk0yjJpJ+ke/bee++4/PLLY/HixfGzn/1MCAwAgIrSltClK6mrV3ckjYbUEQwAAAAAAKD8lLQjWFdvetOb4uKLL46LL744Hn300bjjjjvirrvuikceeSQ2bNjQrTM2hcFqamriwAMPjGOOOSbe+973xgEHHNCbpQMAQEklj4bc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6tVx9tlnZ9blFOADACgnbQlhrL7oCNauIxgAAAAAAEDZKNsg2LJly2LFihWZ9bHHHpt47cMPPxwPPvhgpgPYHnvsEffcc0+0tLTE0qVL4wtf+EImDNbR0RFXX311r9e/NdOnT4+1a9dm1ocffnhMmzYt8fpddtklfvSjH2Xtffvb346XX3656LVdfPHFWevzzz8/Dj/88MTr3/nOd25R+1e/+tVtquGss86K1atXR0TEAQcckBUKAwDgX5LGM9b1xWhIHcEAAAAAAADKRtkGwZ555pnM66qqqpg4cWLitb/85S8jIiKdTkdVVVX87ne/i3e9610xaNCg2GWXXeK6666Lk046KdMd7Le//W20t7f39kdI1NnZGTfddFPW3te+9rWsUZa5HHnkkXHYYYdl1mvXro1bbrmlqLU9+eST8fDDD2fWjY2Nce655271vvPOOy9rfOPs2bNjwYIFParhjjvuiF/96lcREVFdXR0//OEPo7q6ukdnAQBUur4YDZl0liAYAAAAAABA+SjbINgLL7wQERGpVCpGjRoVgwYNSrx20wjJVCoVRx99dIwbN26Lay644ILM63Xr1sWTTz5Z3IILMHv27Fi1alVmveeee8aUKVO6de8ZZ5yRtZ45c2YRK4u47bbbstYnnXRSDB06dKv3DR06NE488cSsvZ7U9vrrr8dnP/vZzPqcc86J/fffv+BzAAAGivaOdM792ur8f2RQiOTRkLmfDQAAAAAAQN8r2yDY66+/nnm9ww47JF730ksvxd///vdMN60TTjgh53UTJkyI7bffPrN++umni1NoD9x5551Z66OOOmqr3cA2v3Zz999/fzQ1NfVabUcffXS37+1a2x133FHw888777xYtmxZRETsvvvucfnllxd8BgDAQJI0GjIpvNUTdTW5f1dt6+go2jMAAAAAAADYNmUbBGtpacm8ztcN7KGHHoqIjWMhIzaOT0yy++67Z16//PLL21hhzz3++ONZ68mTJ3f73pEjR2Z9jra2tpg/f35R6kqn0/HEE0/0uLZDDz00az1v3rzM/y7d8cADD8QNN9yQWV9//fUxePDgbt8PADAQJY1nLGoQTEcwAAAAAACAsle2QbCGhobM6827g3X1wAMPZF53DUl1VV9fn3nd3Ny8bQVugwULFmStc42yzKfr9V3P66nFixdn/XdpbGyMUaNGdfv+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47fvyiuv1NatW7Vx40YtW7ZMFRUVevnllzV48GDfOfX19TrvvPNUXV0dsbXNnDlTGzZs8G273W49+OCDKisr08qVK7V69WqVlZXp/vvv9wuErVu3TpdccklIc6WkpOiss87Sc889p5KSEu3atUsrVqzQ559/ru3bt2vNmjW6+OKL/a4pKyvTSSedpPr6+q59owAAAAmmiYpgAAAAAAAAAAAAcEAQLEbKy8v129/+1m/f3XffrUcffVSFhYW+fS6XS2eddZYWLlyooUOH+vYXFxfr/vvvj8ja3n77bb3xxhu+7ZSUFL311lu67rrrlJGR4dufmZmpn/70p3rzzTeVkpLi2//qq6/q/fff73Ce7Oxs3X777dq2bZtefvllXXjhhX7f+z5jxozRU089pb///e+yLMu3f+vWrbr33ns7+20CAAAkJFNFMHccVARr8BAEAwAAAAAAAAAAiBWCYDEya9Ys1dTU+LanT5+uW265xXj+wIED9cQTT/jte+CBB1ReXh72td1+++1+2z//+c81ffp04/lHH310u7X/4he/CDjH9773PW3cuFG/+tWv1K9fv6DW9cMf/lDXX3+9374nn3wyqGsBAAC6i8Y4qAhmCp0RBAMAAAAAAAAAAIgdgmAx4PV69fTTT/vtu/POO/2qXTk57rjjNG3aNN92TU2NXnjhhbCu7csvv9TixYt925mZmbrppps6vO7mm29WZmamb3vhwoVas2aN8fyjjjpK+fn5Ia/vlltu8fs5lZSUaOXKlSGPAwAAkIhavbaaW23HY1GtCEZrSAAAAAAAAAAAgLhDECwGFi5cqN27d/u2hw8frhkzZgR17aWXXuq3PXv27DCuTJozZ47f9nnnnafs7OwOr8vOzta5557rty/ca5Okfv36afTo0X77tm7dGvZ5AAAA4lGToRqYFN0gWIYhCNbitdXc6ty6EgAAAAAAAAAAAJFFECwGXnvtNb/t448/vsNqYPufu7/58+errq4uYms74YQTgr627drmzp0bljW1lZeX57ddXV0dkXkAAADiTWOzOWQVzdaQ6QFCZ1QFAwAAAAAAAAAAiA2CYDHwxRdf+G1PmTIl6GsLCws1dOhQ37bH49Hq1avDsi7btrVixYpOr23q1Kl+28uXL5dtO7cu6oqSkhK/7T59+oR9DgAAgHhU72kxHjNV6YqEQNXHGjwEwQAA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ugtTa8j0lOj/WZ9OEAwAAAAAEEavLt8hb+DPy/u8vLQksosBAAAAElT0SwdAkpSfn6/bbrtNt912m2/frbfeqq1bt+oXv/iFCgsLJe2tmvXKK6/ouuuu09atW33nFhYW6oYbbojI2k466SSdcMIJevvttyVJzc3NOvHEE3XPPffo8ssvV0ZGhiSprq5Of/3rX3XrrbequbnZd/0pp5yi4447LuAcd911lx577DG/fWeffbYGDRrk1yYyGMOHD9fw4cNDugYAACARmVtDRv/PerehNSTtOQAAAAAAnfFqEG0h9/lw3W5V1XuUm5EawRUBAAAAiYcgWAzdcsstWrhwoebOnevb9+ijj+rxxx/XkCFDlJOTo02bNqmqqsrvuvT0dL3wwgvKzc2N2Nr+/ve/68gjj9SmTZskSY2Njbr++ut16623avjw4bJtWxs3blRjY6PfdSNGjNDf/va3Dsd///332+176aWX9NJLL4W81l/+8pe68847Q74OAAAg0ZhbQzqHsiIp3RQEoyIYAAAAACBEDZ5WrSiuCvp8ry19WVKtaaP6Rm5RAAAAQAKiNWQMuVwuvfjii7rgggv89re2tmrjxo1atmxZuxBYnz599Prrr2vq1KkRXVu/fv30/vvva8KECX77GxoatGrVKq1evbpdCGzixIl6//331bcvT7wAAAAiod7T4rg/IwZBMNOcVAQDAAAAAITqq517gm4Luc+q7XsisxgAAAAggREEizG3263nn39eL730kiZOnGg8LzMzU1dddZVWr16tGTNmRGVtQ4YM0eLFi3Xvvff6WlU6KSws1KxZs7Ro0SINGjQoKmsDAADoabxeW43NXsdjpupckWRsDUlFMAAAAABAiEyhrozUJE0ble94bGVJdSSXBAAAACQkWkPGibPPPltnn3221q9fr0WLFqmkpEQej0e5ubk68MADNXXqVLnd7pDHte0QP0LTRmpqqm6++WbdeOONWrJkiZYvX67S0lJJUkFBgSZOnKhDDjlELldomcL58+d3aV0AAAA9TaCAVUxaQxrmbCQIBgAAAAAI0eodzkGwAwf00viiHH24rqz9NVQEAwAAANohCBZnRo4cqZEjR8Z6Ge24XC5NmjRJkyZNivVSAAAAeqRAQbCM1Oj/WW+qQtbcaqu51auUJIoPAwAAAACCY6oINq6wl8YV5jge21Rep9qm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nj17lJ6eriFDhmjKlCkqLCwM61yrVq3SkiVLtGPHDrW2tqpPnz466KCDdPjhhys5maepABBPGhsbtXDhQn311VeqrKxUamqqioqKdPjhh2v48OFhnYvnKgAQGWvXrtXy5ctVXFys+vp6paenq1+/fho9erQmTJigtLS0To/NfQIAEk9TU5OWLVumNWvWqLKyUg0NDerVq5cKCgp0yCGHaOTIkbIsq8vztLS0aNGiRVq5cqXKy8uVlJSkAQMG6NBDD9W4cePC8J18q6SkRJ988om2bNni+35Gjx6to446SllZWWGdCwDiHa+wAwDQQ8yePVu//vWvtXTpUsfjWVlZmjlzpn75y18qPz8/yqsDAFRWVmr27Nl688039d5776msrMx4bkpKik499VRdf/31Ovroo7s076ZNm3THHXfohRdekMfjaXfcsiwdffTRuuuuuzR9+vROz2Pbtp5++mnde++9+vrrrx3P6dOnj37yk5/o5z//uTIzMzs9FwD0VD/4wQ/0r3/9y2/fkCFDtHnz5pDH2r17t+666y797W9/U11dneM5hx56qG6//XadeeaZnVmuD89VACD8ampq9PDDD+uJJ57Qpk2bjOelpqZq8uTJOuecc3TdddcFPT73CQBIPEuWLNEDDzygl156SU1NTcbzBg4cqEsvvVTXXXedevfuHfI8tbW1uueee/Too4+qoqLC8ZwDDjhAt9xyi2bOnNml0NkHH3ygO++8U/Pnz3c8npqaqvPPP1+/+tWvNHTo0E7PAwCJxLJt2471IgAAQOQ0NTXp0ksv1XPPPRfU+X379tVLL73UpTf7AQChufrqq/XEE084BrE68qMf/UgPP/ywevXqFfK1L7zwgi6++GLV19d3eK5lWbr55pt19913h/wCXVVVlc477zy98847QZ0/fPhwvfLKK2H/dCgAdGevvvqqzjjjjHb7OxMEmz9/vs4999yAoeT9/ehHP9Jf//pXpaamhjQPz1UAIDLmzp2ryy67TLt27Qr6mn79+mnnzp1Bnct9AgASi9fr1W233ab77rtPXq836Ov69eunv/3tbzrppJOCvubLL7/UmWeeGTCEvL8TTzxR//73v5WTkxP0HNLeDxzecsstuu+++4I6PzMzU88884zOPvvskOYBgEREEAwAgG7M6/Xq+9//vubMmeO3PykpSYMHD1ZOTo42bdqk6upqv+MZGRmaN2+ejjzyyGguFwB6rMMOO0xLlixpt39fyfx+/fqpublZW7ZsafeYLUmTJ0/Wu+++G1Kp+xdffFEXXHBBuxcA+/btq0GDBqm0tFQlJSVq+5Tx+uuv1wMPPBD0PA0NDZoxY4YWL17stz81NVVDhw5VWlqaNm7c2K6KQN++fbVw4UKNHDky6LkAoKeqrq7WuHHjVFJS0u5YqEGwjz76SCeccIIaGhr89ufm5mrYsGGqrKzUtm3b1Nra6nf8+9//vl566aWgw8I8VwGAyHjggQd0ww03tPs73u12q7CwUPn5+WpoaNCOHTv8glzBBsG4TwBA4rn88sv1xBNPtNufkZGhESNGKD09XeXl5dq4cWO7+0dqaqpmz56tk08+ucN51q5dq6OOOqpdUDgrK0vDhw9XQ0ODNm/erObmZr/jRx55pN57772Q2vxec801+tOf/uS3z7IsFRUVqW/fvtq6dWu7dSQlJenFF1/UWWedFfQ8AJCIXLFeAAAAiJz77ruv3QtmV155pbZu3aqNGzdq2bJlqqio0Msvv6zBgwf7zqmvr9d5553nGDYAAERWbm6urrrqKr322mu+N1E+//xzLV++XOXl5Xr//fc1bdo0v2sWL16smTNnBj3Hhg0bdPHFF/uFwCZMmKD33ntPpaWlWrJkibZt26Y1a9bo+9//vt+1Dz74oF5++eWg5/rZz37mFwJzuVy6/fbbtXPnTq1du1YrVqxQRUWFnn76aeXl5fnO2717t84777x2byABANq76aabfCGwrrTWrays1Pnnn+/35v6QIUM0e/ZsVVRUaOnSpdq0aZM2b96sK664wu/al19+OaSgMM9VACD8nnzySf3sZz/zexP/5JNP1htvvKGqqipt2LBBixYt0ooVK7R7926VlJTo2Wef1dlnnx1UtS7uEwCQeF566aV2IbCxY8fqtddeU3V1tVasWKFFixZp/fr12rVrl+666y6/e4LH49GPf/xjVVZWBpynpaWlXbXI3r1765lnnlFFRYWWL1+ur7/+Wjt37tT/+3//Ty7XtzGFTz75RDfffHPQ39MLL7zQLgR29tlna+3atdq6dauWLFmi3bt3a968eRo/frzvnNbWVv34xz8OuWIyACQcGwAAdEtlZWV2dna2Lcn339133208v7i42B46dKjf+XfccUcUVwwAPdehhx5qDx06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dGlNAIDwuemmm/TGG2/47fvLX/6iQYMGdXhtV+8Rbe8PkvM9gnsRAITXk08+qXnz5knaW1Xl8ccf79Rjq0m0Hre5PwBAeJnewE5KStJrr72madOmOR7PysrSs88+qxNOOMFv/+9+97t2wTKJ+wQAdAePPfaYRowYod///vftKmu1tXXrVl111VUaOnRoh62GY3WP6Mxc3CMA9BQEwQAA6GbafgrG4/GEPEZTU1PAMQEAsfHQQw/p/vvv99t388036/zzzw/q+q7eI9reH5zGDMc8TnNxLwLQU+3YsUM33nijb/uyyy4zvrHfWdF63Ob+AADhZXoMvOyyy3T44YcHvNblcunRRx/1q/Sydu1affDBBx3Ow30CABJHc3OzzjnnHP3kJz/Rjh07JEm9e/fWHXfcocWLF6uyslIej0fbt2/XK6+8orPOOsvXlreiokKXXnqpbrrpJuP4sbpHdGYu7hEAegqCYAAAdDNZWVl+206flOlI20/CtB0TABB9//znP3X99df77Zs5c6buueeeoMfo6j3C6ZOSTvcI7kUAED5XX321qqqqJEn9+/fXrFmzwj5HtB63uT8AQHiZHgMvv/zyoK4fPny4vvvd7/rtcwqCcZ8AgMT1k5/8RP/5z39825MnT9aqVat01113adKkScrNzVVKSooGDBig008/XS+//LJmz57tF5L6/e9/r6efftpx/FjdIzozF/cIAD0FQTAAALqZtk9e6uvrHcv6B1JXVxdwTABAdM2dO1c//vGP/R7Pv//97+uJJ57wfUozGG0fz9s+3nek7fnJycmOn57s6jxO13AvAtATvfjii/rvf//r2/7jH/+o3NzcsM/T1cdt27Y79eYNz1UAoGvS09OVlJTkty87O1vf+c53gh7j6KOP9tv+/PPP253DfQIAEtP8+fP15JNP+rYLCgo09/+3d+dRUV3p3sd/BYIIOItDFAFnjOJE2sQR0w6JXrFbjUbjdWo7DkujuQ7dSbSvSboTFbXVTq7m2lE7zok3xAymE1SIU6JCO6ASB0RwxgnFAVA47x95rfYwVjGVJd/PWrUWz669z37qYNWxqh72/vpr1a5dO99xoaGh+vDDD01t06dPt+kPBEvqM6DcrnlF/VyLawSAJxWFYAAAPGFq1KhhKgq4f/++kpOT7TrG+fPnTXHNmjWLJTcAgP0iIyP10ksv6cGD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6tQpDR061NTWuHFjPffcc7n2L1++vN566y1T27Rp03Ts2LE851i3bp3WrFljjV1dXXMUD+fm97//verXr2+NT5w4oddffz3PguFbt25p+PDhysjIsLYNHTpUzZs3L3AuAHBaBgAAeGK99957hiTTbfz48cb58+etfTIzM43w8HCjfv36pn5PPfWUcePGDcclDwBlSEhISI7X63feeceIiIiw+3b9+vUC5zt58qTh6elpmq9Vq1ZGZGSkqd/x48eN/v3758jt008/tfmxvfrqq6axLi4uxqxZs0x5ZmRkGCtXrjSqVq1q6hsUFGTcv3/f5rkAAIYRGRlpei318/Ozeey1a9eM2rVr5xi/efNmIysry9rv7NmzxtixY3NcH+bNm2fzXLxXAYDitXXrVsNisZheL7t3725ER0eb+qWkpBgLFiwwvL29TX2bNGli3Lp1K985uE4AgPPp1q1bjtfTTp06GVu3bs3xmcvVq1eN+fPnG5UrV84x5rPPPst3noyMDOPpp582jalWrZrxj3/8wzTPtWvXjJkzZxouLi6mvhMmTLD5Ma1bty5HfgMHDjROnDhh6rdt2zYjKCjI1M/b29s4ffq0zXMBgDOyGIYNG/QCAACnlJWVpX79+unrr782tbu6usrPz0+VK1dWQkKCUlJSTPdXqFBBERER6tixYylmCwBl16NbNRZVZGSkQkJCCuy3YcMGDR06NMdfTPr4+Kh+/fpKTk7WuXPnctw/adIkLVmyxOZ87t69q65duyo6OtrU7u7uroCAAJUvX16nT5/W7du3TffXqFFDu3fvVpMmTWyeCwAgRUVFqVu3btbYz8/PtOVuQXbs2KFevXrl2F6lSpUqCggIUEpKipKSkpSZmWm6v1+/fgoPD7f5msZ7FQAofnPnztUf//jHHO21a9dWvXr1dOfOHcXHx5tWRZGk6tWrKzIy0rSqWF64TgCAc7l06ZI6dOighISEHPd5e3srICBAFSpU0LVr13T69OlcV9aaOnWq5s+fX+BccXFx6tSpk65fv55jnoYNG+revXtKSEjQ/fv3Tff/6le/UlRUlCpUqGDz45owYYKWLl1qarNYLPL19ZWPj48SExN19epV0/0uLi7auHGjBg4caPM8AOCMKAQDAOAJl5aWplGjRmnDhg029a9evbo2bdpkUxEBAKB4OKIQTJLWr1+v3/3ud7p3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tCsnwzCMyMhI03H++7//2zAMw3jw4IGxePFio3HjxrnO5+npaUyfPt24d+9ejmPeunXLmDFjhlGpUqVcx/r4+Bh///vfbc7RkefBMAxj3bp1RtOmTfOcs3379sbOnTvtmq+wYmJijN/+9reGu7t7vudBkhEQEGBMnDjROHr0qMMfc0JCgmn8iBEjcvQp6PHkdnuYc/bnpq23lStX2nH283bmzBnTcYcNG1ak46Wmphp/+ctf8nz+PbyVL1/e6NGjh7FhwwYjIyMj12M5w3PcEbp27WrNNyEhoUjH+uyzz0yP/8MPPyyeJAEAAAAAyAdbQwIAAAAAADiIkW2FI1u2uuvUqZMGDhyodevW6dKlS/n2zczM1Pfff69u3bpp4sSJRVpd586dO3rxxRc1efJknTx5Mtc+d+/eVVhYmHr27Kl79+5Z2+Pj49WuXTvNmzdPt27dynXslStXNGbMGL3++us25eOo85CRkaFhw4Zp6NChOn78eJ799u7dq5CQEK1atarQc9lizpw5euaZZxQeHq6MjIwC+yckJOiDDz4wrVRVkMftMTuL7777zhR37dq10MfavHmzAgIC9NZbb+X5/HsoPT1dERERevnll7V7926b53jcnuPOrkuXLqb4n//8p4MyAQAAAACUJRSCAQAAAAAAOMi5c+dMsS3b9qWlpeVoe+qpp9SiRQs9++yzatmyZa5bt3344Yd69dVXC5WnYRh6+eWXFRERYZozODhYzZs3l6urq6n/zp07NXnyZElScnKynn/+eWthicViUYMGDfTMM8+oQYMGOeZatGiR1q5dW2BOjjgPkjRixAhTflWrVlVQUJDatm2rKlWqmPpmZmZqzJgx2r9/f6Hny8/HH3+sN954Q1lZWab2ihUrqmXLlnr22WfVqlUr+fr62lRkmJfH6TE7k507d5ri4ODgQh1n4cKF6t+/v65evWpqt1gs8vX1Vbt27dS6dWs99dRThc71cXyOO7uaNWvK19fXGmf/9wAAAAAAQEmgEAwAAAAAAMABbty4oZiYGFNbu3btbBpbv359TZ06Vdu2bdPNmzd1/vx5xcbG6scff9Thw4d148YNHTp0SOPHjzcVcKxcuVLh4eF25/rJJ5/o66+/liQNGTJEx44d0/nz57V//34dPXpUly9f1oQJE0xj/v73vys2NlbDhw9XUlKSPDw89Kc//UkXLlxQfHy89u3bp/j4eP388885Vs6ZNm2a7t+//9idh9WrV2vDhg2SpBdeeEE//vijrl27pkOHDikmJkZXr15VeHi4qSAnMzNTEydOtHuugqSnp2vGjBmmtgEDBig6Olo3b97U4cOH9eOPP+rgwYNKSkrSzZs3tW3bNk2dOtWmgsOHHP2YIyIirLfp06eb7ps+fbrp/oe34cOHS5LWrl2riIgIrVmzxjSuZ8+euY57eOvVq1ex5P7o89vV1VWBgYF2H+OLL77Q1KlTTcV+tWrV0pIlS3ThwgUlJSUpOjpaBw4c0Pnz53X58mWtW7dOoaGhcnGx/aPfx/U57uxatmxp/TklJUWnTp1yYDYAAAAAgLLAYmTfgwAAAAAAAAA28/f3V2JiojWOjIxUSEhIgeOmT5+u+fPnW2NXV1clJSUVuKrPzp071aFDhxwr9OQlIiJCffv2VXp6uiTpV7/6lfbu3ZvvmKioKHXr1i1H+/z58zV16tQ8x40ePVorV660xoGBgYqLi5O3t7e2bNmizp075zru7t27Cg4OVlxcnLUtPDxcv/nNb/Kcy5HnYdasWXrnnXfyHHfixAm1adNGd+/etbYdPHhQrVq1silXW2zZskV9+vSxxsOHD9c//vEPm8ZmZGTo3Llzua7WVJqP+cyZMwoICLDGI0aMyHdbyVWrVmnUqFHWeOXKlRo5cmSe/Qs7T3FIT0+Xp6entYCrQYMGio+Pt+sYly9fVrNmzZSSkmJt69y5s7788sscK7Hl5sSJE/L09FS9evVy3OcMz/GSdurUKe3atcvUNmfOHOv2p2FhYapRo4b1Pm9vbw0cONCuOaZOnaqFCxda402bNmnAgAFFyBoAAAAAgPyxIhgAAAAAAEApMgxDCxYs0IIFC0zt48aNs2lrt86dO9tc/CRJPXr0MK2ktG/fPh07dsz2hP+/wYMH51sgIkl//vOfTasQPSz6WLhwYZ4FIpLk6empWbNmmdq+/fbbfOdy1Hno169fvgVRktSkSRNNmjTJ1FbQ47HXiRMnTHH21Zry4+7unmsRWF4el8fsTJKSkkyreOVWjFWQxYsXm4rAGjdurG+//damIjDpl9+JPfM+bs/xkrZr1y6NGjXKdHtYBCb9Uqz76H3Tpk2ze47sr+lnzpwpatoAAAAAAOSLQjAAAAAAAIBiFBMTo61bt5pu3333nTZu3KiZM2cqMDBQ06ZN06OLtD/33HMKCwsrsZyGDRtmivfs2WPXeIvFUmAhkPRL0UNwcLCpzc/PT6NHjy5wbN++fU0FJgcOHLArR1sU9TxI0nvvvWdTv8GDB5vif/3rX3bPlZ979+6ZYjc3t2I9/qMel8fsTM6ePWuK69SpY9f4jIwMLV261NS2bNkyeXl5FTm33Dwpz/HHTfbfe/Z/FwAAAAAAFLdyjk4AAAAAAADgSWLPqjHlypXT2LFjFRYWpgoVKpRYTo9uiyfZX4ARFBSkJk2a2NS3RYsW2rdvnzX+7W9/a9PKXd7e3vL399fp06cl/bKiUnEr6nlo2bKlmjdvblPfFi1aqFy5cnrw4IGk4i8Ayb7S0Jo1a9S2bdtinUN6vB6zM7l586Yp9vb2tmv8vn37TKuBtWjRQs8//3xxpJarJ+U5bo+RI0fatLVoUWT/vWf/dwEAAAAAQHGjEAwAAAAAAMABfHx89NVXX6l9+/aFPsa+ffv0xRdf6ODBg/r555+VkpKi1NRUayFOXq5evWrXPO3atbO5b/Xq1U2xPcVJ1atXtxaJ3Lp1y+ZxpXUesq+ElB83NzdVqVLFOkdxF4A8//zzcnV1VWZmpiTpr3/9q9LS0jRt2jS7tn0syOP0mJ3J3bt3TbG9hZ47d+40xS+++GKRc8rP4/4cd1aenp6m+M6dOw7KBAAAAABQVlAIBgAAAAAA4ABXrlxRr169tGnTJnXv3t2usTt37tTEiRN1+PDhQs396EpDtvDx8bG5b/bCh8KOzb71YW5K+zzUrFnTrv5eXl7WoihbHo89fH19NXr0aC1fvtzatnTpUi1dulTt2rVT9+7d1aVLFz377LOqVq1aoed5nB6zM3t0K1hbxMfHm2J7CvIK43F9jjs7e3/vAAAAAAAUlYujEwAAAAAAAHiSREZGyjAM0y01NVWHDh3S+++/byqsuXnzpkJDQ7V//36bj//RRx+pa9euhS5+kqT09HS7+nt4eBR6rqKMzY+znYeSKAhZsmSJ+vbtm6M9JiZGc+fOVZ8+fVSjRg21adNGb775po4ePWr3HI/bY3YW2Yul0tLS7Bp//fp1U2xvQZ69Hsfn+JMge7Gbl5eXgzIBAAAAAJQVrAgGAAAAAABQwry9vRUUFKSgoCCNHj1aPXv21KFDhyT9UigwePBgxcbGFlgkEBkZqfHjx5sKbMqVK6dOnTqpffv28vPzU82aNeXh4aHy5cubxvbo0aP4H5iDcB5+4eHhoc2bN2vDhg2aN2+eDh48mKOPYRg6ePCgDh48qPfff199+vTRokWL1KhRo9JPuAypUqWKKU5NTbVrfPb+3t7eRU0JDnD79m1TXLlyZQdlAgAAAAAoKygEAwAAAAAAKEU1a9bUV199pdatW1tX/UlISNDs2bMVFhaW79ipU6eaip/69OmjZcuWqV69evmOs3flq8cd5+HfLBaLhgwZoiFDhujYsWOKiIhQVFSUdu3aZd2i8VHffPONduzYoW+++UadO3d2QMZlg6+vrym+ePGiXeMrVqxoirMXFME5XLhwwRTXr1/fQZkAAAAAAMoKtoYEAAAAAAAoZb6+vjmKvpYsWaIzZ87kOebEiRM6cOCANW7RooU+//zzAoufpJzbzDkzzkPemjdvrsmTJys8PFzJyck6duyYFi1apE6dOpn6paamauDAgRQXlSBfX1+5uPz7o9dz587ZNb5atWqmODk5uVjyQunKXgjm7+/vmEQAAAAAAGUGhWAAAAAAAAAOMHLkSAUFBVnjjIwMvfvuu3n2/+mnn0zxmDFj5O7ubtNcR48eLVySjyHOg20sFosCAwM1efJk7dy5Uzt27FCNGjWs9ycnJ2v16tUOzPDJVr58eTVt2tQaJyUlKS0tzebxjRs3NsXR0dHFlhtKz88//2yKH33NBwAAAACgJFAIBgAAAAAA4AAuLi565513TG2rV69WYmJirv0vX75sih8tMinI9u3b7U/wMcV5KJzOnTtrzpw5prZdu3Y5KJvS9ejKXJJM24qWpHbt2ll/zszM1LFjx2wem33bzm+//bbY8kLpiY2Ntf5cpUoVNWrUyIHZAAAAAADKAgrBAAAAAAAAHCQ0NFStWrWyxvfv39d7772Xa9/sxSsZGRk2zZGenq4VK1YUPsnHDOeh8Dp27GiKr1696qBMSpeXl5cpvnv3bqnMm72YKyYmxuaxzzzzjGl7yCNHjpTpQkZndPnyZdOWoNn/PQAAAAAAUBIoBAMAAAAAAHAQi8WimTNnmtpWrVqls2fP5uhbu3ZtU2zrak6zZs3KsYqWM+M8FF72wq+qVas6KJPSValSJbm6ulrjhISEUpm3V69epnjHjh02j3Vzc9OECRNMbePGjdOdO3eKJTeUvOy/7+z/HgAAAAAAKAkUggEAAAAAADjQgAED9PTTT1vjjIyMHFv4SVKHDh1M8bJly3Tq1Kl8j/3RRx9p/vz5xZPoY4Lz8ItZs2ZpzZo1evDggU39DcPQggULTG2Pbl34JHNzc1OTJk2s8cGDBxUfH1/i8/r5+Zme25GRkXaNf+2110yrgp08eVK9e/dWSkqKTeOPHz9uWpEKpSsqKsoU9+7d2zGJAAAAAADKFArBAAAAAAAAHCi3VcE+/vhjXbhwwdTWqFEjPffcc9Y4NTVVXbp00WeffZajGOjQoUMaPHiwxo0bJ8MwFBgYWHIPoJRxHn4RGxur//zP/1TdunU1fvx4/fOf/9S1a9dy9MvKytKuXbvUs2dPffHFF9Z2T09PDR06tBQzdqyePXtaf87MzFSXLl309ttvKzw8XBEREdq6dav1dvHixWKb99FzfP78eUVHR9s81sfHR6tWrZLFYrG27dixQ4GBgfrggw9yXeEuOTlZ69evV2hoqJo3b15gkSRKhmEY+vLLL63xc889p4CAAAdmBAAAAAAoK8o5OgEAAAAAAICybtCgQZo9e7aOHz8uSUpPT9fcuXO1ePFiU7/58+crJCRE9+/flyRdvHhRgwYNkre3txo3biwXFxedO3fOVCDi5eWltWvXqm3btqX3gEoY5+HfkpOTtWzZMi1btkySVKdOHdWoUUNeXl66c+eOEhISdPv27RzjFixYoLp165Z2ug4zYcIEffTRR0pLS5MkXbhwQbNnz86178qVKzVy5MhimfeVV17RzJkzZRiGJOnzzz9XcHCwzeP79u2rhQsX6r/+67+sx7h06ZImTZqk1157TfXr15ePj48yMzN1+fLlHAWkcIzo6GjTamzDhg1zYDYAAAAAgLKEFcEAAAAAAAAczMXFRW+99Zapbfny5bp06ZKprUOHDlq+fLnc3NxM7bdv39aBAwcUExNjKn6qWrWqvv76a7Vp06bkkncAzkPeLl68qNjYWP3000+KjY3NUQRWoUIFLVu2TOPGjXNQho7RpEkTrV69Wt7e3qU6r5+fn2lLwHXr1ikrK8uuY0yZMkWbNm0ybRMp/bLqVGJioqKjo3XgwAGKwB4jq1evtv5csWJFCsEAAAAAAKWGQjAAAAAAAIDHwNChQ9WoUSNrfO/ePYWFheXoN2LECO3YsUNdunTJ81geHh4aPXq0jh49qpCQkJJI1+HK+nlYvny5VqxYoQEDBqhWrVoF9q9WrZrGjRunuLg4jR07thQyfPwMHDhQJ06c0Jw5c9SrVy/5+vrK29vbtPViSZgyZYr158TEREVERNh9jP79++v06dOaNWuW/Pz88u3r5eWl0NBQffHFF+rcubPdc6Fo0tPTtXbtWms8atQoVapUyYEZAQAAAADKEovxcE1xAAAAAAAAOJUzZ85o9+7dunjxotLT01WlShU1bdpUHTp0kKenp6PTKzWcBykhIUHHjx9XYmKibt68qYyMDHl7e8vHx0ctW7ZU8+bNVa5cOUenWWYFBwcrJiZGkhQaGqrNmzcX6XhxcXE6fPiwrly5opSUFHl6esrHx0fNmjVTUFCQypcvXxxpoxA++eQTjRgxQpLk5uam48ePKyAgwMFZAQAAAADKCgrBAAAAAAAAAKAEbdmyRX369JEkWSwWxcXFqWnTpg7OCiUhKChIsbGxkqRXX31VH330kYMzAgAAAACUJWwNCQAAAAAAAAAlqHfv3urYsaMkyTAMzZs3z8EZoSR888031iIwDw8PzZw508EZAQAAAADKGgrBAAAAAAAAAKCELVq0SC4uv3wc+8knn+jEiRMOzgjFyTAMzZo1yxpPmzZNvr6+DswIAAAAAFAWUQgGAAAAAAAAACUsODhYo0ePliQ9ePBAb731loMzQnHauHGjDhw4IEmqV6+e3njjDQdnBAAAAAAoiyyGYRiOTgIAAAAAAAAAAAAAAAAAUHisCAYAAAAAAAAAAAAAAAAATo5CMAAAAAAAAAAAAAAAAABwchSCAQAAAAAAAAAAAAAAAICToxAMAAAAAAAAAAAAAAAAAJwchWAAAAAAAAAAAAAAAAAA4OQoBAMAAAAAAAAAAAAAAAAAJ0chGAAAAAAAAAAAAAAAAAA4OQrBAAAAAAAAAAAAAAAAAMDJUQgGAAAAAAAAAAAAAAAAAE6OQjAAAAAAAAAAAAAAAAAAcHIUggEAAAAAAAAAAAAAAACAk6MQDAAAAAAAAAAAAAAAAACcHIVgAAAAAAAAAAAAAAAAAODkKAQDAAAAAAAAAAAAAAAAACdHIRgAAAAAAAAAAAAAAAAAODkKwQAAAAAAAAAAAAAAAADAyVEIBgAAAAAAAAAAAAAAAABOjkIwAAAAAAAAAAAAAAAAAHByFIIBAAAAAAAAAAAAAAAAgJOjEAwAAAAAAAAAAAAAAAAAnByFYAAAAAAAAAAAAAAAAADg5CgEAwAAAAAAAAAAAAAAAAAnRyEYAAAAAAAAAAAAAAAAADg5CsEAAAAAAAAAAAAAAAAAwMlRCAYAAAAAAAAAAAAAAAAATo5CMAAAAAAAAAAAAAAAAABwchSCAQAAAAAAAAAAAAAAAICToxAMAAAAAAAAAAAAAAAAAJwchWAAAAAAAAAAAAAAAAAA4OQoBAMAAAAAAAAAAAAAAAAAJ0chGAAAAAAAAAAAAAAAAAA4OQrBAAAAAAAAAAAAAAAAAMDJUQgGAAAAAAAAAAAAAAAAAE7u/wF5COGHkAyxCwAAAABJRU5ErkJggg==", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Compute and plot spectrum\n", "phonons = rn.io.vasp.outcar.read_phonons(f\"{data_dir}/phonons_OUTCAR\")\n", "spectrum = phonons.get_raman_spectrum(model)\n", "wavenumbers, total_intensities = spectrum.measure(laser_correction = True, \n", " laser_wavelength = 532, \n", " bose_einstein_correction = True, \n", " temperature = 300)\n", "wavenumbers, total_intensities = rn.spectrum.utils.convolve_spectrum(wavenumbers, total_intensities)\n", "\n", "fig = plt.figure(constrained_layout = True, figsize = (8, 3))\n", "axis = fig.add_subplot(111)\n", "axis.plot(wavenumbers, total_intensities)\n", "axis.set_ylabel(\"Intensity (a.u.)\")\n", "l = axis.set_xlabel(r\"Raman shift ($\\mathregular{cm^{-1}}$)\")" ] }, { "cell_type": "markdown", "id": "049753d4", "metadata": {}, "source": [ "Beautiful! \n", "\n", "So far, we have calculated phonon-based Raman spectra. Ramannoodle is also capable of calculating Raman spectra from molecular dynamics trajectories. This will be covered in the next tutorial: [Molecular dynamics](../notebooks/molecular-dynamics.html)" ] }, { "cell_type": "markdown", "id": "903fcd14", "metadata": {}, "source": [] } ], "metadata": { "kernelspec": { "display_name": "Python 3 (ipykernel)", "language": "python", "name": "python3" }, "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.12.4" } }, "nbformat": 4, "nbformat_minor": 5 }