|
2 | 2 | "cells": [
|
3 | 3 | {
|
4 | 4 | "cell_type": "markdown",
|
| 5 | + "id": "7d00c63281a63fa0", |
| 6 | + "metadata": { |
| 7 | + "collapsed": false |
| 8 | + }, |
5 | 9 | "source": [
|
6 | 10 | "# Passivate Slab Surface\n",
|
7 | 11 | "\n",
|
|
20 | 24 | "1. Surface atoms are detected by analyzing atomic positions along z-axis\n",
|
21 | 25 | "1. \"Shadowing radius\" controls the exclusion of atoms below the surface ones from being passivated\n",
|
22 | 26 | "1. Passivants are added at specified bond lengths from surface atoms"
|
23 |
| - ], |
24 |
| - "metadata": { |
25 |
| - "collapsed": false |
26 |
| - }, |
27 |
| - "id": "7d00c63281a63fa0" |
| 27 | + ] |
28 | 28 | },
|
29 | 29 | {
|
30 | 30 | "cell_type": "markdown",
|
| 31 | + "id": "d80280b47f767281", |
| 32 | + "metadata": { |
| 33 | + "collapsed": false |
| 34 | + }, |
31 | 35 | "source": [
|
32 | 36 | "## 1. Prepare the Environment\n",
|
33 | 37 | "### 1.1. Set up the notebook\n",
|
|
36 | 40 | "Visualization of the parameters of passivation on the image below:\n",
|
37 | 41 | "\n",
|
38 | 42 | "<img src=\"https://i.imgur.com/sVd7BWn.png\" alt=\"Passivation parameters\" width=\"600\"/>\n"
|
39 |
| - ], |
40 |
| - "metadata": { |
41 |
| - "collapsed": false |
42 |
| - }, |
43 |
| - "id": "d80280b47f767281" |
| 43 | + ] |
44 | 44 | },
|
45 | 45 | {
|
46 | 46 | "cell_type": "code",
|
| 47 | + "execution_count": 5, |
| 48 | + "id": "92b3518bebdcf547", |
| 49 | + "metadata": { |
| 50 | + "collapsed": false |
| 51 | + }, |
47 | 52 | "outputs": [],
|
48 | 53 | "source": [
|
49 | 54 | "# Material selection\n",
|
|
58 | 63 | "SHADOWING_RADIUS = 2.5 # Radius to exclude subsurface atoms, in Angstroms\n",
|
59 | 64 | "DEPTH = 5.0 # How deep to look for surface atoms, in Angstroms\n",
|
60 | 65 | "\n",
|
61 |
| - "CREATE_SLAB = False # Create a slab if the input material is not a slab\n", |
| 66 | + "BYPASS_SLAB_CREATION = False # If True, will use input material directly\n", |
62 | 67 | "\n",
|
63 | 68 | "# Slab parameters for creating a new slab if previous option is set to True\n",
|
64 | 69 | "DEFAULT_SLAB_PARAMETERS = {\n",
|
|
72 | 77 | "# Visualization parameters\n",
|
73 | 78 | "SHOW_INTERMEDIATE_STEPS = True\n",
|
74 | 79 | "CELL_REPETITIONS_FOR_VISUALIZATION = [1, 1, 1] # Structure repeat in view"
|
75 |
| - ], |
76 |
| - "metadata": { |
77 |
| - "collapsed": false |
78 |
| - }, |
79 |
| - "id": "92b3518bebdcf547", |
80 |
| - "execution_count": null |
| 80 | + ] |
81 | 81 | },
|
82 | 82 | {
|
83 | 83 | "cell_type": "markdown",
|
84 |
| - "source": [ |
85 |
| - "### 1.2. Install packages\n", |
86 |
| - "The step executes only in Pyodide environment. For other environments, the packages should be installed via `pip install`." |
87 |
| - ], |
| 84 | + "id": "11bd9b5fca1510fc", |
88 | 85 | "metadata": {
|
89 | 86 | "collapsed": false
|
90 | 87 | },
|
91 |
| - "id": "11bd9b5fca1510fc" |
| 88 | + "source": [ |
| 89 | + "### 1.2. Install packages\n", |
| 90 | + "The step executes only in Pyodide environment. For other environments, the packages should be installed via `pip install`." |
| 91 | + ] |
92 | 92 | },
|
93 | 93 | {
|
94 | 94 | "cell_type": "code",
|
| 95 | + "execution_count": 6, |
| 96 | + "id": "42863fe84bfab53c", |
| 97 | + "metadata": { |
| 98 | + "collapsed": false |
| 99 | + }, |
95 | 100 | "outputs": [],
|
96 | 101 | "source": [
|
97 | 102 | "import sys\n",
|
|
103 | 108 | " from utils.jupyterlite import install_packages\n",
|
104 | 109 | "\n",
|
105 | 110 | " await install_packages(\"\")"
|
106 |
| - ], |
107 |
| - "metadata": { |
108 |
| - "collapsed": false |
109 |
| - }, |
110 |
| - "id": "42863fe84bfab53c", |
111 |
| - "execution_count": null |
| 111 | + ] |
112 | 112 | },
|
113 | 113 | {
|
114 | 114 | "cell_type": "markdown",
|
115 |
| - "source": [ |
116 |
| - "### 1.3. Load and preview input material" |
117 |
| - ], |
| 115 | + "id": "6983ab284dff18c0", |
118 | 116 | "metadata": {
|
119 | 117 | "collapsed": false
|
120 | 118 | },
|
121 |
| - "id": "6983ab284dff18c0" |
| 119 | + "source": [ |
| 120 | + "### 1.3. Load and preview input material" |
| 121 | + ] |
122 | 122 | },
|
123 | 123 | {
|
124 | 124 | "cell_type": "code",
|
| 125 | + "execution_count": null, |
| 126 | + "id": "a51551f4af6456c7", |
| 127 | + "metadata": { |
| 128 | + "collapsed": false |
| 129 | + }, |
125 | 130 | "outputs": [],
|
126 | 131 | "source": [
|
127 | 132 | "from utils.jupyterlite import get_materials\n",
|
128 | 133 | "from utils.visualize import visualize_materials\n",
|
129 | 134 | "\n",
|
130 | 135 | "materials = get_materials(globals())"
|
131 |
| - ], |
132 |
| - "metadata": { |
133 |
| - "collapsed": false |
134 |
| - }, |
135 |
| - "id": "a51551f4af6456c7", |
136 |
| - "execution_count": null |
| 136 | + ] |
137 | 137 | },
|
138 | 138 | {
|
139 | 139 | "cell_type": "markdown",
|
140 |
| - "source": [ |
141 |
| - "### 1.4. Create a slab if the input material is not a slab" |
142 |
| - ], |
| 140 | + "id": "6b929ffec7c4876e", |
143 | 141 | "metadata": {
|
144 | 142 | "collapsed": false
|
145 | 143 | },
|
146 |
| - "id": "6b929ffec7c4876e" |
| 144 | + "source": [ |
| 145 | + "### 1.4. Create a slab if the input material is not a slab" |
| 146 | + ] |
147 | 147 | },
|
148 | 148 | {
|
149 | 149 | "cell_type": "code",
|
| 150 | + "execution_count": null, |
| 151 | + "id": "ad71f877f76f0550", |
| 152 | + "metadata": { |
| 153 | + "collapsed": false |
| 154 | + }, |
150 | 155 | "outputs": [],
|
151 | 156 | "source": [
|
152 | 157 | "from mat3ra.made.tools.build.slab import create_slab_if_not, SlabConfiguration\n",
|
|
161 | 166 | " xy_supercell_matrix=DEFAULT_SLAB_PARAMETERS[\"xy_supercell_matrix\"]\n",
|
162 | 167 | ")\n",
|
163 | 168 | "\n",
|
164 |
| - "slab = create_slab_if_not(material, default_slab_config) if CREATE_SLAB else material\n", |
| 169 | + "slab = material if BYPASS_SLAB_CREATION else create_slab_if_not(material, default_slab_config)\n", |
165 | 170 | "\n",
|
166 | 171 | "if SHOW_INTERMEDIATE_STEPS:\n",
|
167 | 172 | " print(\"Initial slab structure:\")\n",
|
168 | 173 | " visualize_materials(slab, repetitions=CELL_REPETITIONS_FOR_VISUALIZATION)\n",
|
169 | 174 | " visualize_materials(slab, repetitions=CELL_REPETITIONS_FOR_VISUALIZATION, rotation=\"-90x\")"
|
170 |
| - ], |
171 |
| - "metadata": { |
172 |
| - "collapsed": false |
173 |
| - }, |
174 |
| - "id": "ad71f877f76f0550", |
175 |
| - "execution_count": null |
| 175 | + ] |
176 | 176 | },
|
177 | 177 | {
|
178 | 178 | "cell_type": "markdown",
|
179 |
| - "source": [ |
180 |
| - "## 2. Create target material\n", |
181 |
| - "### 2.1. Set up passivation configuration and builder\n" |
182 |
| - ], |
| 179 | + "id": "cee250785246811a", |
183 | 180 | "metadata": {
|
184 | 181 | "collapsed": false
|
185 | 182 | },
|
186 |
| - "id": "cee250785246811a" |
| 183 | + "source": [ |
| 184 | + "## 2. Create target material\n", |
| 185 | + "### 2.1. Set up passivation configuration and builder\n" |
| 186 | + ] |
187 | 187 | },
|
188 | 188 | {
|
189 | 189 | "cell_type": "code",
|
| 190 | + "execution_count": 9, |
| 191 | + "id": "7e26e8e7fb8319a", |
| 192 | + "metadata": { |
| 193 | + "collapsed": false |
| 194 | + }, |
190 | 195 | "outputs": [],
|
191 | 196 | "source": [
|
192 | 197 | "from mat3ra.made.tools.build.passivation import (\n",
|
|
208 | 213 | ")\n",
|
209 | 214 | "\n",
|
210 | 215 | "builder = SurfacePassivationBuilder(build_parameters=builder_params)"
|
211 |
| - ], |
212 |
| - "metadata": { |
213 |
| - "collapsed": false |
214 |
| - }, |
215 |
| - "id": "7e26e8e7fb8319a", |
216 |
| - "execution_count": null |
| 216 | + ] |
217 | 217 | },
|
218 | 218 | {
|
219 | 219 | "cell_type": "markdown",
|
220 |
| - "source": [ |
221 |
| - "### 2.2. Generate passivated structure\n" |
222 |
| - ], |
| 220 | + "id": "2950f29de8bc79b2", |
223 | 221 | "metadata": {
|
224 | 222 | "collapsed": false
|
225 | 223 | },
|
226 |
| - "id": "2950f29de8bc79b2" |
| 224 | + "source": [ |
| 225 | + "### 2.2. Generate passivated structure\n" |
| 226 | + ] |
227 | 227 | },
|
228 | 228 | {
|
229 | 229 | "cell_type": "code",
|
| 230 | + "execution_count": null, |
| 231 | + "id": "a4ed473eb2129ac4", |
| 232 | + "metadata": { |
| 233 | + "collapsed": false |
| 234 | + }, |
230 | 235 | "outputs": [],
|
231 | 236 | "source": [
|
232 | 237 | "from mat3ra.made.tools.build.passivation import create_passivation\n",
|
|
238 | 243 | "print(f\"Bond length: {BOND_LENGTH} Å\")\n",
|
239 | 244 | "print(f\"Surfaces passivated: {SURFACE}\")\n",
|
240 | 245 | "print(f\"Number of atoms: {len(passivated_slab.basis.elements.ids)}\")"
|
241 |
| - ], |
242 |
| - "metadata": { |
243 |
| - "collapsed": false |
244 |
| - }, |
245 |
| - "id": "a4ed473eb2129ac4", |
246 |
| - "execution_count": null |
| 246 | + ] |
247 | 247 | },
|
248 | 248 | {
|
249 | 249 | "cell_type": "markdown",
|
250 |
| - "source": [ |
251 |
| - "## 3. Visualize the result" |
252 |
| - ], |
| 250 | + "id": "56ec05c6ed2f91cd", |
253 | 251 | "metadata": {
|
254 | 252 | "collapsed": false
|
255 | 253 | },
|
256 |
| - "id": "56ec05c6ed2f91cd" |
| 254 | + "source": [ |
| 255 | + "## 3. Visualize the result" |
| 256 | + ] |
257 | 257 | },
|
258 | 258 | {
|
259 | 259 | "cell_type": "code",
|
| 260 | + "execution_count": null, |
| 261 | + "id": "c4b5e1e0ec0ab02a", |
| 262 | + "metadata": { |
| 263 | + "collapsed": false |
| 264 | + }, |
260 | 265 | "outputs": [],
|
261 | 266 | "source": [
|
262 | 267 | "print(\"Final passivated structure:\")\n",
|
263 | 268 | "visualize_materials(passivated_slab, repetitions=CELL_REPETITIONS_FOR_VISUALIZATION)\n",
|
264 | 269 | "visualize_materials(passivated_slab, repetitions=CELL_REPETITIONS_FOR_VISUALIZATION, rotation=\"-90x\")"
|
265 |
| - ], |
266 |
| - "metadata": { |
267 |
| - "collapsed": false |
268 |
| - }, |
269 |
| - "id": "c4b5e1e0ec0ab02a", |
270 |
| - "execution_count": null |
| 270 | + ] |
271 | 271 | },
|
272 | 272 | {
|
273 | 273 | "cell_type": "markdown",
|
274 |
| - "source": [ |
275 |
| - "### 4. Pass data to the outside runtime\n" |
276 |
| - ], |
| 274 | + "id": "eab7e14d2c7880a5", |
277 | 275 | "metadata": {
|
278 | 276 | "collapsed": false
|
279 | 277 | },
|
280 |
| - "id": "eab7e14d2c7880a5" |
| 278 | + "source": [ |
| 279 | + "### 4. Pass data to the outside runtime\n" |
| 280 | + ] |
281 | 281 | },
|
282 | 282 | {
|
283 | 283 | "cell_type": "code",
|
| 284 | + "execution_count": null, |
| 285 | + "id": "d66a15a29d27c6ea", |
| 286 | + "metadata": { |
| 287 | + "collapsed": false |
| 288 | + }, |
284 | 289 | "outputs": [],
|
285 | 290 | "source": [
|
286 | 291 | "from utils.jupyterlite import set_materials\n",
|
287 | 292 | "\n",
|
288 | 293 | "set_materials(passivated_slab)"
|
289 |
| - ], |
290 |
| - "metadata": { |
291 |
| - "collapsed": false |
292 |
| - }, |
293 |
| - "id": "d66a15a29d27c6ea", |
294 |
| - "execution_count": null |
| 294 | + ] |
295 | 295 | }
|
296 | 296 | ],
|
297 | 297 | "metadata": {
|
298 | 298 | "kernelspec": {
|
299 |
| - "display_name": "Python 3", |
| 299 | + "display_name": ".venv-3.11", |
300 | 300 | "language": "python",
|
301 | 301 | "name": "python3"
|
302 | 302 | },
|
303 | 303 | "language_info": {
|
304 | 304 | "codemirror_mode": {
|
305 | 305 | "name": "ipython",
|
306 |
| - "version": 2 |
| 306 | + "version": 3 |
307 | 307 | },
|
308 | 308 | "file_extension": ".py",
|
309 | 309 | "mimetype": "text/x-python",
|
310 | 310 | "name": "python",
|
311 | 311 | "nbconvert_exporter": "python",
|
312 |
| - "pygments_lexer": "ipython2", |
313 |
| - "version": "2.7.6" |
| 312 | + "pygments_lexer": "ipython3", |
| 313 | + "version": "3.11.7" |
314 | 314 | }
|
315 | 315 | },
|
316 | 316 | "nbformat": 4,
|
|
0 commit comments