|
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