notebook/lattice-vibration/Phonon_1D.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# **Introduction to 1D phonons**\n",
    "\n",
    "<i class=\"fa fa-home fa-2x\"></i><a href=\"../index.ipynb\" style=\"font-size: 20px\"> Go back to index</a>\n",
    "\n",
    "**Source code:** https://github.com/osscar-org/quantum-mechanics/blob/master/notebook/lattice-vibration/Phonon_1D.ipynb\n",
    "\n",
    "<hr style=\"height:1px;border:none;color:#cccccc;background-color:#cccccc;\" />\n",
    "\n",
    "## **Tasks and exercises**\n",
    "\n",
    "1. Visualize the lattice vibration at $k=0$ and $k=\\frac{\\pi}{a}$. What characteristics do you observe ? \n",
    "    <details>\n",
    "    <summary style=\"color: red\">Solution</summary>\n",
    "    The atom indexed $n$ has a displacement given by $u=\\exp(i(n\\cdot ka-\\omega t))$.\n",
    "    \n",
    "    At $k=0$, the displacement is given by $u=\\exp(-i\\omega t)$. Therefore, all atoms are displaced identically, which creates a translation. However, since $\\omega=0$ at $k=0$, atoms stay static.\n",
    "    \n",
    "    At $k=\\frac{\\pi}{a}$, the displacement is given by $u=\\exp(i(n\\cdot\\pi-\\omega t))=\\exp(i\\cdot n\\cdot\\pi)\\exp(-i\\omega t)$. Therefore, the neighbouring atom at $n+1$ has an amplitude given by $u'=u\\exp(i\\pi)=-1$. Thus, neighbouring atoms oscillate out-of-phase.\n",
    "    \n",
    "    To make atoms oscillate out-of phase, a lot of energy is required since the phonon contains a lot of potential energy. As energy is directly linked to frequency with $E=h\\nu$, the maximum of frequency is thus found at $k=\\pm \\frac{\\pi}{a}$.\n",
    "    </details>\n",
    "\n",
    "\n",
    "2. The first Brillouin zone is defined between $\\frac{-\\pi}{a}$ and $\\frac{\\pi}{a}$. Explain why the first Brillouin zone contains all the necessary information by looking at $k'=k+\\frac{2\\pi}{a}$\n",
    "    <details>\n",
    "    <summary style=\"color: red\">Solution</summary>\n",
    "    At $k'=k+2\\frac{\\pi}{a}$ the lattice vibration stays identical to the phonon with wave vector $k$. Therefore, the frequency will also be identical.\n",
    "    \n",
    "    From the equation of displacement, we get $u'=\\exp(i(n\\cdot k'a-\\omega t))=\\exp(i(n\\cdot ka-\\omega t))\\exp(i\\cdot n\\cdot2\\pi)\n",
    "    =u$.\n",
    "\n",
    "    </details>\n",
    "\n",
    "\n",
    "3. Visualize the phonon dispersion for a diatomic chain. What is the difference between the acoustic and optical branch at $k=0$ and $k=\\pm\\frac{\\pi}{2a}$ ? How do the atoms displacements relate to frequency ?\n",
    "    <details>\n",
    "    <summary style=\"color: red\">Solution</summary>\n",
    "    At $k=0$, in the acoustic branch, as in the monoatomic chain, the atoms do not move. Instead, in the optical branch the two atoms are moving out-of-phase. The latter therefore has a high frequency.\n",
    "    \n",
    "    At $k=\\pm\\frac{\\pi}{2a}$, in the acoustic branch, the light atoms stand still whearas the heavier atoms move. In the optical branch, the opposite is observed. Since frequency is proportional to $\\sqrt{1/M}$, the frequency is higher when lighter atoms move. \n",
    "    </details>\n",
    "    \n",
    "    \n",
    "4. Adjust the mass ratio of the molecules. What happens when the ratio is high ? How about when the ratio is close to unity ? How does the band dispersion change ?\n",
    "    <details>\n",
    "    <summary style=\"color: red\">Solution</summary>\n",
    "    As the ratio grows, the gap of forbidden frequencies grows as well. At $k=\\pm\\frac{\\pi}{2a}$, the gap is proportional to $\\sqrt{1/M_{gray}}-\\sqrt{1/M_{red}}$.\n",
    "    \n",
    "    Furthermore, at $k=0$, we have $\\frac{u_{red}}{u_{gray}}=\\frac{-M_{gray}}{M_{red}}$, and thus the oscillation amplitude of the heavier atom decreases as it gets heavier.\n",
    "    </details>\n",
    "    \n",
    "    \n",
    "5. Set the mass ratio to 1. How does it compare to the case of the monoatomic chain ?\n",
    "    <details>\n",
    "    <summary style=\"color: red\">Solution</summary>\n",
    "    When the ratio is 1, the chain is identical to the monoatomic one, except that the lattice parameter is twice as big, shrinking the Brillouin zone to half the size of the monoatomic case. One recognizes the dispersion relation of the monoatomic chain in the first BZ between $k=-\\frac{\\pi}{a}$ and $k=\\frac{\\pi}{a}$.\n",
    "    \n",
    "    The optical branch in the first BZ now represents the monoatomic dispersion relation but at $k'=k\\pm\\frac{\\pi}{a}$. This is called band folding.\n",
    "    </details>\n",
    "   \n",
    "\n",
    "<hr style=\"height:1px;border:none;color:#cccccc;background-color:#cccccc;\" />"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "f0b65bc10a6f44ff9a4160c1703cb6b9",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": []
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "%matplotlib widget\n",
    "import matplotlib\n",
    "matplotlib.rcParams['figure.facecolor']='w'\n",
    "from ase.io.trajectory import Trajectory\n",
    "from ase import Atoms\n",
    "import time\n",
    "\n",
    "from NGLTrajectoryClass import NGLTrajectory\n",
    "\n",
    "import ipywidgets as widgets\n",
    "from ipywidgets import jslink,HBox, VBox, HTMLMath,Label,IntSlider, Tab,Play, Layout, AppLayout\n",
    "from IPython.display import display"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "traj=Trajectory('dummy.traj','w')\n",
    "traj.write(Atoms(2*'C',[[0,0,0],[1,1,1]]))\n",
    "handler=NGLTrajectory(trajectory=Trajectory('dummy.traj','r'))\n",
    "handler.view.stage.set_parameters(mouse_preset=\"pymol\")\n",
    "\n",
    "handler.view._js(\"\"\"\n",
    "this.mouseOverDisplay('block')\n",
    "var container = this.stage.viewer.container\n",
    "var that = this\n",
    "container.addEventListener('mouseout', function(e) {\n",
    "          that.mouseOverDisplay('block')\n",
    "      }, false);\n",
    "\"\"\")\n",
    "\n",
    "\n",
    "view = handler.view        \n",
    "# view.on_displayed(loop)\n",
    "\n",
    "widgets=[\n",
    "    handler.slider_C,\n",
    "    handler.slider_M,\n",
    "    handler.slider_amplitude,\n",
    "    handler.button_chain,\n",
    "]\n",
    "for widget in widgets:\n",
    "    handler.widgetList.append(widget)\n",
    "\n",
    "handler.slider_atom_radius.value=0.1\n",
    "handler.slider_arrow_radius.value=0.05\n",
    "handler.tick_box_arrows.value=True\n",
    "handler.addArrows() # add arrows by default\n",
    "handler.set_player_parameters(delay=handler.init_delay)\n",
    "handler.set_view_parameters(clipDist=1,quality='low')\n",
    "\n",
    "handler.initialize_dispersion_plot()\n",
    "handler.button_chain.value='diatomic'\n",
    "handler.compute_dispersion()\n",
    "handler.compute_dispersion_relation()\n",
    "handler.button_chain.value='monoatomic'\n",
    "handler.compute_dispersion()\n",
    "handler.compute_dispersion_relation()\n",
    "\n",
    "handler.band_dispersion()\n",
    "\n",
    "\n",
    "handler.set_view_dimensions()\n",
    "handler.view.stage.set_parameters(mouse_preset=\"pymol\")\n",
    "\n",
    "handler.compute_trajectory_1D()\n",
    "\n",
    "\n",
    "\n",
    "chain= HBox([handler.button_chain_description,handler.button_chain])\n",
    "mass_ratio=handler.output_ratio\n",
    "click=HTMLMath(value='''Click on the plot to get the corresponding phonon''')\n",
    "# phonon = HBox(\n",
    "#     [VBox([chain,mass_ratio]), VBox([click,handler.fig.canvas])]\n",
    "# )\n",
    "phonon= AppLayout(left_sidebar=VBox([chain,mass_ratio]),center=VBox([click,handler.fig.canvas]),right=None)\n",
    "\n",
    "camera_orientation=HBox([handler.camera_orientation_description,handler.output_camera_position])\n",
    "camera_text_orientation=handler.text_orientation\n",
    "camera_error=handler.output_camera_position_error\n",
    "camera_position=VBox([camera_orientation,camera_text_orientation,camera_error])\n",
    "\n",
    "amplitude=HBox([handler.slider_amplitude_description,handler.slider_amplitude])\n",
    "radius=HBox([handler.slider_atom_radius_description,handler.slider_atom_radius])\n",
    "atom=VBox([amplitude,radius])\n",
    "\n",
    "appearance=HBox([handler.arrow,atom])\n",
    "gif=HBox([handler.movie,handler.output_gif])\n",
    "\n",
    "\n",
    "tab = Tab()\n",
    "tab.children = [phonon, appearance, gif,camera_position, HBox()]\n",
    "titles = [\"Phonon\", \"Appearance\", \"Generate GIF\", \"Camera settings\", \"Hide parameters\"]\n",
    "for i in range(5):\n",
    "    tab.set_title(i, titles[i])\n",
    "    \n",
    "\n",
    "camera_actions_1=HTMLMath(value='''Hover to play animation<br> \n",
    "Scroll to zoom''')\n",
    "camera_actions_2=HTMLMath(value='''\n",
    "Left click to rotate<br> \n",
    "Right click to translate \n",
    "''')\n",
    "spacer=HTMLMath(value='''<p style=\"color: white\"></p>''')\n",
    "\n",
    "helper_text=HBox([spacer,camera_actions_1,spacer,camera_actions_2])\n",
    "actions=VBox([tab,HBox([Label('Camera axis: '),handler.button_x,handler.button_y,handler.button_z,helper_text])])\n",
    "\n",
    "# player = Play(interval=50)\n",
    "\n",
    "\n",
    "layout = Layout(display='flex',\n",
    "                flex_flow='column',\n",
    "                align_items='center',)\n",
    "# slider = IntSlider(max=50)\n",
    "# jslink((player, 'value'), (slider, 'value'))\n",
    "# jslink((player, 'value'), (handler.view, 'frame'))\n",
    "# def on_display(w):\n",
    "#     c = \"\"\"\n",
    "\n",
    "#     var pe = document.getElementsByClassName('what')[0]\n",
    "\n",
    "#     pe.style.position = 'absolute'\n",
    "#     pe.style.zIndex = 100\n",
    "#     pe.style.top = '10%'\n",
    "#     pe.style.left = '10%'\n",
    "#     this.$container.append($(pe))\n",
    "#     this.$player.hide();\n",
    "#     \"\"\"\n",
    "#     view._execute_js_code(c)\n",
    "\n",
    "# box = HBox([player,slider])\n",
    "# box.add_class('what')\n",
    "# box.on_displayed(on_display)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<style>\n",
       ".box_style{\n",
       "    border : 2px solid red;\n",
       "}\n",
       "</style>\n"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%%html\n",
    "<style>\n",
    ".box_style{\n",
    "    border : 2px solid red;\n",
    "}\n",
    "</style>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "546ceb73714c49eda44588698ece25b7",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "VBox(children=(Tab(children=(HBox(children=(VBox(children=(HBox(children=(HTMLMath(value='Atomic chain type', …"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "54e9045ba2714f91b1b621812b162fb5",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "HBox(children=(NGLWidget(max_frame=50),), layout=Layout(align_items='center', display='flex', flex_flow='colum…"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "display(actions,HBox([handler.view],layout=layout).add_class(\"box_style\"))\n",
    "stop = False\n",
    "def loop(view):\n",
    "    def do():\n",
    "        while True and not stop:\n",
    "            if view.frame == view.max_frame:\n",
    "                view.frame = 0\n",
    "            view.frame = view.frame + 1\n",
    "            time.sleep(0.2)\n",
    "    view._run_on_another_thread(do)\n",
    "      \n",
    "def init_view():\n",
    "        time.sleep(5)\n",
    "        handler.onclick(None)\n",
    "\n",
    "\n",
    "hv_thread=handler.view._run_on_another_thread(init_view)\n",
    "# time.sleep(5)\n",
    "# loop(view)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<hr style=\"height:1px;border:none;color:#cccccc;background-color:#cccccc;\" />\n",
    "\n",
    "# Using the interactive visualization\n",
    "\n",
    "\n",
    "### Phonon viewer\n",
    "The bottom view shows an interactive animation of a lattice vibration.\n",
    "\n",
    "- Hover over the view to access the play and pause buttons.\n",
    "\n",
    "- Rotate the surface by left clicking and dragging.\n",
    "\n",
    "- Translate the surface by right clicking and dragging.\n",
    "\n",
    "You can reset the view by clicking the corresponding 'camera axis' buttons.\n",
    "\n",
    "A specific camera view can be given in the 'Advanced' tab.\n",
    "\n",
    "### Phonon\n",
    "Under the 'Phonon' tab are parameters related to the atomic chain and the phonon dispersion plot.\n",
    "\n",
    "Click on the phonon dispersion plot to get the corresponding lattice vibration.\n",
    "\n",
    "\n",
    "### Appearance\n",
    "Under the 'Appearance' tab are parameters related to showing arrows along the oscillations or modifying the atoms appearance.\n",
    "\n",
    "\n",
    "### Camera settings\n",
    "Under the 'Camera settings' tab, a custom camera position can be sent to the viewer.\n",
    "\n",
    "\n",
    "### Generate GIF\n",
    "A GIF of the actual animation can be generated and downloaded.\n",
    "\n",
    "Different rendering resolutions can be selected for convenience.\n",
    "The animation speed will be reflected in the GIF animation speed.\n",
    "\n",
    "Clicking 'Render GIF' will start savings each frames of the animation and then compiling them into a GIF.\n",
    "During the GIF rendering, the view will flicker.\n",
    "Do not change browser window or the rendering will fail.\n",
    "\n",
    "Once the rendering has been successfully done, a preview of the GIF is shown. Right click on it to download the GIF.\n"
   ]
  }
 ],
 "metadata": {
  "hide_input": false,
  "interpreter": {
   "hash": "e4cce46d6be9934fbd27f9ca0432556941ea5bdf741d4f4d64c6cd7f8dfa8fba"
  },
  "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.10.12"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}