{ "cells": [ { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "# Building a Nanotube\n", "\n", "> ### In this tutorial we will cover:\n", "> - how we can create molecules completely from scratch\n", "> - how we may use BuildAMol to create a nanotube" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Nanotubes are polymers that form a large tube-like structure which have some nice structural properties. \n", "\n", "![](https://cdn.britannica.com/29/193229-050-ACB6E78D/Illustration-carbon-nanotube.jpg)\n", "\n", "There are excellent nanotube building applications around, so feel free to use one of these instead of BuildAMol. Because from BuildAMol's perspective nanotubes are a bit of challenge. The problem with nanotubes is that they are not only circular but are so regularly structured that it is difficult to find a suitable \"fragment\" molecule to start with. \n", "\n", "So, if we want to build a nanotube in BuildAMol it is probably easier to assemble the entire tube-molecule from scratch; i.e. without any template molecules! \n", "\n", "In this tutorial we will be assembling a nanotube atom by atom! \n", "Sounds like a major headache, right? Well, it was a bit for me when making this tutorial but the final procedure actually turned out simpler than expected.\n", "\n", "Let's dive into it..." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "> ### Disclaimer:\n", "> If you just want to make a nanotube but don't care about the tutorial part about making it from scratch you can\n", "> use the `polymers` extension to get a nanotube like this:\n", "> ```python\n", "> from buildamol.extensions.polymers import nanotube\n", "> length = 20\n", "> width = 10\n", "> my_nanotube = nanotube(length, width)\n", "> ```\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Building one unit-ring \n", "\n", "Let's start by making one unit-ring which we can then stack to generate a tube. \n", "\n", "In order to do this, we have to start with some math, unfortunately. This is because in order to make a molecule, we need to know where the atoms should be. In the case of nanotubes we can use the math relating to circles and triangles that we all know from high school to compute the respective atom coordinates. Here's how:" ] }, { "cell_type": "code", "execution_count": 33, "metadata": {}, "outputs": [], "source": [ "import buildamol as bam\n", "import numpy as np\n", "# the number of carbons in the ring...\n", "ring_size = 50\n", "\n", "# we can use geometric reasoning to first build some ring coordinates\n", "# for the atoms to occupy\n", "length = 1.54\n", "\n", "# the angle between the xy plane and elevated atoms from the later hexagons\n", "# (don't worry about it too much, it's just a geometric trick to make the\n", "# 120° angles in the final molecule work out nicely)\n", "angle = np.radians(30)\n", "\n", "# we can approximate the ring radius by the length and number of carbon atoms\n", "# given the formula: u = 2 * r * pi , where the circumference u is roughly \n", "# length * ring_size * cos(angle) (otherwise the bond lengths would be off)\n", "radius = (np.cos(angle) * length) * (ring_size+1) / (2 * np.pi)\n", "\n", "# now we can calculate the coordinates for the carbon and hydrogen atoms\n", "# in the ring\n", "theta = np.linspace(0, 2 * np.pi, ring_size, endpoint=False)\n", "\n", "X = radius * np.cos(theta)\n", "Y = radius * np.sin(theta)\n", "\n", "# as mentioned, every second atom will be slightly elevated to form an angle of\n", "# 30° relative to the xy-plane which will later be flipped to make \n", "# 120° angles in the final molecule\n", "Z = np.zeros(ring_size)\n", "Z[1::2] = np.sin(angle) * length" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Phew, that was a lot of math just now. But these computations are what allow us to now fairly easily assemble the unit ring for our nanotube. Here's how:" ] }, { "cell_type": "code", "execution_count": 34, "metadata": {}, "outputs": [ { "data": { "application/3dmoljs_load.v0": "
\n

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n jupyter labextension install jupyterlab_3dmol

\n
\n", "text/html": [ "
\n", "

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n", " jupyter labextension install jupyterlab_3dmol

\n", "
\n", "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# make a new molecule for the ring\n", "ring = bam.Molecule.new(id=\"RNG\")\n", "\n", "# now make atoms and bonds\n", "atoms = []\n", "bonds = [] \n", "for i in range(ring_size):\n", " c = bam.Atom(f\"C{i+1}\", [X[i], Y[i], Z[i]], element=\"C\")\n", " atoms.append(c)\n", "\n", " bond = (f\"C{i+1}\", f\"C{(i+1)%ring_size+1}\")\n", " bonds.append(bond)\n", "\n", "# and add them to the molecule\n", "ring.add_atoms(*atoms)\n", "ring.add_bonds(*bonds)\n", "\n", "# and visualize the molecule\n", "ring.py3dmol().show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now that we have one single unit ring, we can flip it and attach it again to get our first proper layer of hexagons." ] }, { "cell_type": "code", "execution_count": 35, "metadata": {}, "outputs": [], "source": [ "# make a copy, move, and flip it\n", "other = ring.copy()\\\n", " .move([0,0, length])\\\n", " .flip(\"xy\")\n", "\n", "# now merge it into the original ring\n", "ring.merge(other)\n", "\n", "# now add double bonds between the two rings\n", "for i in range(0, ring_size, 2):\n", " c = f\"C{i+1}\"\n", " a = ring.get_atom(c, residue=1)\n", " b = ring.get_atom(c, residue=2)\n", " ring.add_bond(a, b, order=2)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Awesome! Now we have a finished unit ring that we can stack to create a nanotube! Let's inspect what it looks like." ] }, { "cell_type": "code", "execution_count": 36, "metadata": {}, "outputs": [ { "data": { "application/3dmoljs_load.v0": "
\n

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n jupyter labextension install jupyterlab_3dmol

\n
\n", "text/html": [ "
\n", "

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n", " jupyter labextension install jupyterlab_3dmol

\n", "
\n", "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# visualize the ring\n", "ring.py3dmol().show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Stacking the unit-ring to form a nanotube\n", "\n", "Now that we have the unit ring ready, we can simply stack to create a tube! We can actually use the same code snippet from the cell above with minimal adjustments. Here's how:" ] }, { "cell_type": "code", "execution_count": 37, "metadata": {}, "outputs": [ { "data": { "application/3dmoljs_load.v0": "
\n

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n jupyter labextension install jupyterlab_3dmol

\n
\n", "text/html": [ "
\n", "

You appear to be running in JupyterLab (or JavaScript failed to load for some other reason). You need to install the 3dmol extension:
\n", " jupyter labextension install jupyterlab_3dmol

\n", "
\n", "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# define how many times we want to repeat the ring\n", "n = 3\n", "\n", "# move the ring to sit on the xy-plane (will make it a bit easier...)\n", "# and also get the height of the ring which we need for the stacking\n", "_min = min(i.coord[2] for i in ring.atoms)\n", "ring.move([0, 0, -_min])\n", "height = max(i.coord[2] for i in ring.atoms)\n", "dz = length + height # the distance between the rings\n", "\n", "# now build the nanotube\n", "nanotube = ring.copy()\n", "\n", "for i in range(n):\n", "\n", " # get a new ring and move it to the correct position\n", " # (we move downward by the length of the ring...)\n", " other = ring.copy().move([0, 0, - dz * (i+1)])\n", "\n", " # add it to the nanotube\n", " nanotube.merge(other)\n", "\n", " # and add bonds between the incoming and the previous ring\n", " # (careful, here we use a shifted index, compared to the previous cell)\n", " for j in range(1, ring_size+1, 2):\n", " c = f\"C{j+1}\"\n", " a = nanotube.get_atom(c, residue=-2)\n", " b = nanotube.get_atom(c, residue=-3)\n", " nanotube.add_bond(a, b, order=2)\n", "\n", "# let's look at the nanotube\n", "nanotube.py3dmol().show()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And there we have it, a nanotube from scratch! It wasn't that difficult to do, right? Probably the most challenging part was the initial math session to compute the ring coordinates. If we want to make it a different size, we simply have to adjust the `ring_size` parameter in the first cell and re-run this notebook. " ] }, { "cell_type": "code", "execution_count": null, "metadata": {}, "outputs": [], "source": [ "# let's save the nanotube to a PDB file\n", "nanotube.to_pdb(\"./files/nanotube.pdb\")" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And with that we come to the end of this tutorial. Hopefully you could see that, using a little mathematics we can create large polymers like nanotubes fairly easily using BuildAMol. The most heavy part was the coordinate computation, everything else was just moving molecules, and manually establishing some bonds. We were able to automate the whole thing using some for-loops! \n", "\n", "Thanks and good luck with your research!" ] } ], "metadata": { "kernelspec": { "display_name": "glyco2", "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.11.0" }, "orig_nbformat": 4 }, "nbformat": 4, "nbformat_minor": 2 }