Skip to content

Commit 436849f

Browse files
zmoonzmoon
committed
Run context
1 parent 668f672 commit 436849f

4 files changed

Lines changed: 76 additions & 33 deletions

File tree

‎01-compile.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ subtitle: Building MPAS on NSF NCAR Derecho
44
label: page:build
55
---
66

7+
To begin,
8+
[log in to Derecho](https://ncar-hpc-docs.readthedocs.io/en/latest/compute-systems/derecho/#logging-in).
9+
710
First we need to clone the model repository.
811
We will use Kelly's fork, which adds additional vertical levels (based on ERA5)
912
and isobaric diagnostics.

‎02-run.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,9 @@ subtitle: Running MPAS on NSF NCAR Derecho
44
label: page:run
55
---
66

7+
As in {ref}`page:build`, we are
8+
[on Derecho](https://ncar-hpc-docs.readthedocs.io/en/latest/compute-systems/derecho/#logging-in).
9+
710
# Global
811

912
We will use the quasi-uniform 240-km mesh (10242 cells),

‎03-viz.ipynb‎

Lines changed: 60 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@
1717
"label: page:viz\n",
1818
"kernelspec:\n",
1919
" name: python3\n",
20+
" display_name: Python 3\n",
2021
"---"
2122
]
2223
},
@@ -31,6 +32,19 @@
3132
"tags": []
3233
},
3334
"source": [
35+
"```{note}\n",
36+
"This notebook is designed to run anywhere,\n",
37+
"and includes automatic dataset fetching[^data].\n",
38+
"\n",
39+
"The conda environment spec (`environment.yml`) in the GitHub repository can be used\n",
40+
"to create a local environment with the necessary packages.\n",
41+
"Or you can also [open in Binder](https://mybinder.org/v2/gh/NunezOcasioLab/mpas-tutorial/HEAD?urlpath=lab%2Ftree%2F03-viz.ipynb).\n",
42+
"```\n",
43+
"\n",
44+
"[^data]: small files by default\n",
45+
"\n",
46+
"# Intro\n",
47+
"\n",
3448
"With unstructured-grid data, the grid/coordinate information is usually stored in a separate file from the model output fields. Considerably more information is needed to reconstruct the grid than in the case of a rectangular lat/lon grid, for example, which can be expressed with 1-D coordinate variables (e.g. ERA5).\n",
3549
"\n",
3650
"With MPAS-A, the necessary grid variables are available in multiple files:\n",
@@ -51,10 +65,18 @@
5165
"```"
5266
]
5367
},
68+
{
69+
"cell_type": "markdown",
70+
"id": "2",
71+
"metadata": {},
72+
"source": [
73+
"# Data"
74+
]
75+
},
5476
{
5577
"cell_type": "code",
5678
"execution_count": null,
57-
"id": "2",
79+
"id": "3",
5880
"metadata": {
5981
"editable": true,
6082
"slideshow": {
@@ -88,7 +110,7 @@
88110
},
89111
{
90112
"cell_type": "markdown",
91-
"id": "3",
113+
"id": "4",
92114
"metadata": {
93115
"editable": true,
94116
"slideshow": {
@@ -105,7 +127,7 @@
105127
{
106128
"cell_type": "code",
107129
"execution_count": null,
108-
"id": "4",
130+
"id": "5",
109131
"metadata": {
110132
"editable": true,
111133
"slideshow": {
@@ -146,7 +168,7 @@
146168
{
147169
"cell_type": "code",
148170
"execution_count": null,
149-
"id": "5",
171+
"id": "6",
150172
"metadata": {
151173
"editable": true,
152174
"slideshow": {
@@ -172,7 +194,7 @@
172194
},
173195
{
174196
"cell_type": "markdown",
175-
"id": "6",
197+
"id": "7",
176198
"metadata": {
177199
"editable": true,
178200
"slideshow": {
@@ -189,7 +211,7 @@
189211
{
190212
"cell_type": "code",
191213
"execution_count": null,
192-
"id": "7",
214+
"id": "8",
193215
"metadata": {},
194216
"outputs": [],
195217
"source": [
@@ -216,7 +238,7 @@
216238
{
217239
"cell_type": "code",
218240
"execution_count": null,
219-
"id": "8",
241+
"id": "9",
220242
"metadata": {},
221243
"outputs": [],
222244
"source": [
@@ -243,7 +265,7 @@
243265
{
244266
"cell_type": "code",
245267
"execution_count": null,
246-
"id": "9",
268+
"id": "10",
247269
"metadata": {},
248270
"outputs": [],
249271
"source": [
@@ -265,7 +287,7 @@
265287
{
266288
"cell_type": "code",
267289
"execution_count": null,
268-
"id": "10",
290+
"id": "11",
269291
"metadata": {},
270292
"outputs": [],
271293
"source": [
@@ -294,7 +316,7 @@
294316
{
295317
"cell_type": "code",
296318
"execution_count": null,
297-
"id": "11",
319+
"id": "12",
298320
"metadata": {},
299321
"outputs": [],
300322
"source": [
@@ -317,7 +339,7 @@
317339
},
318340
{
319341
"cell_type": "markdown",
320-
"id": "12",
342+
"id": "13",
321343
"metadata": {
322344
"editable": true,
323345
"slideshow": {
@@ -336,7 +358,7 @@
336358
{
337359
"cell_type": "code",
338360
"execution_count": null,
339-
"id": "13",
361+
"id": "14",
340362
"metadata": {
341363
"editable": true,
342364
"slideshow": {
@@ -352,7 +374,7 @@
352374
},
353375
{
354376
"cell_type": "markdown",
355-
"id": "14",
377+
"id": "15",
356378
"metadata": {
357379
"editable": true,
358380
"slideshow": {
@@ -369,7 +391,7 @@
369391
{
370392
"cell_type": "code",
371393
"execution_count": null,
372-
"id": "15",
394+
"id": "16",
373395
"metadata": {
374396
"editable": true,
375397
"slideshow": {
@@ -385,7 +407,7 @@
385407
{
386408
"cell_type": "code",
387409
"execution_count": null,
388-
"id": "16",
410+
"id": "17",
389411
"metadata": {
390412
"editable": true,
391413
"slideshow": {
@@ -402,7 +424,7 @@
402424
{
403425
"cell_type": "code",
404426
"execution_count": null,
405-
"id": "17",
427+
"id": "18",
406428
"metadata": {
407429
"editable": true,
408430
"slideshow": {
@@ -418,7 +440,7 @@
418440
{
419441
"cell_type": "code",
420442
"execution_count": null,
421-
"id": "18",
443+
"id": "19",
422444
"metadata": {
423445
"editable": true,
424446
"slideshow": {
@@ -465,7 +487,7 @@
465487
},
466488
{
467489
"cell_type": "markdown",
468-
"id": "19",
490+
"id": "20",
469491
"metadata": {
470492
"editable": true,
471493
"slideshow": {
@@ -482,7 +504,7 @@
482504
{
483505
"cell_type": "code",
484506
"execution_count": null,
485-
"id": "20",
507+
"id": "21",
486508
"metadata": {
487509
"editable": true,
488510
"slideshow": {
@@ -507,7 +529,7 @@
507529
{
508530
"cell_type": "code",
509531
"execution_count": null,
510-
"id": "21",
532+
"id": "22",
511533
"metadata": {},
512534
"outputs": [],
513535
"source": [
@@ -537,7 +559,7 @@
537559
{
538560
"cell_type": "code",
539561
"execution_count": null,
540-
"id": "22",
562+
"id": "23",
541563
"metadata": {
542564
"editable": true,
543565
"slideshow": {
@@ -572,7 +594,7 @@
572594
},
573595
{
574596
"cell_type": "markdown",
575-
"id": "23",
597+
"id": "24",
576598
"metadata": {
577599
"editable": true,
578600
"slideshow": {
@@ -591,7 +613,7 @@
591613
{
592614
"cell_type": "code",
593615
"execution_count": null,
594-
"id": "24",
616+
"id": "25",
595617
"metadata": {
596618
"editable": true,
597619
"slideshow": {
@@ -634,7 +656,7 @@
634656
},
635657
{
636658
"cell_type": "markdown",
637-
"id": "25",
659+
"id": "26",
638660
"metadata": {},
639661
"source": [
640662
"(sec:geovista)=\n",
@@ -643,13 +665,19 @@
643665
"\n",
644666
"Built on PyVista/VTK, [GeoVista](https://geovista.readthedocs.io/) provides GPU-accelerated interactive visualization of geospatial data and has [builtin support](https://geovista.readthedocs.io/en/v0.5.3/reference/generated/api/geovista/bridge/#geovista.bridge.Transform.from_unstructured) for unstructured meshes.\n",
645667
"\n",
646-
"It will still work if a GPU is not available/detected, but it may be much slower to first plot and to respond."
668+
"It will still work if a GPU is not available/detected, but it may be much slower to first plot and to respond.\n",
669+
"\n",
670+
"```{note}\n",
671+
"This doesn't currently work in NCAR JupyterHub or Binder [^ci].\n",
672+
"```\n",
673+
"\n",
674+
"[^ci]: Or when this site is built, for that matter, which is why it is currently guarded."
647675
]
648676
},
649677
{
650678
"cell_type": "code",
651679
"execution_count": null,
652-
"id": "26",
680+
"id": "27",
653681
"metadata": {},
654682
"outputs": [],
655683
"source": [
@@ -684,7 +712,7 @@
684712
},
685713
{
686714
"cell_type": "markdown",
687-
"id": "27",
715+
"id": "28",
688716
"metadata": {},
689717
"source": [
690718
"\n",
@@ -699,7 +727,7 @@
699727
{
700728
"cell_type": "code",
701729
"execution_count": null,
702-
"id": "28",
730+
"id": "29",
703731
"metadata": {},
704732
"outputs": [],
705733
"source": [
@@ -726,7 +754,7 @@
726754
},
727755
{
728756
"cell_type": "markdown",
729-
"id": "29",
757+
"id": "30",
730758
"metadata": {},
731759
"source": [
732760
"````{dropdown} Result\n",
@@ -739,7 +767,7 @@
739767
},
740768
{
741769
"cell_type": "markdown",
742-
"id": "30",
770+
"id": "31",
743771
"metadata": {
744772
"editable": true,
745773
"slideshow": {
@@ -757,7 +785,7 @@
757785
{
758786
"cell_type": "code",
759787
"execution_count": null,
760-
"id": "31",
788+
"id": "32",
761789
"metadata": {
762790
"editable": true,
763791
"slideshow": {
@@ -793,7 +821,7 @@
793821
},
794822
{
795823
"cell_type": "markdown",
796-
"id": "32",
824+
"id": "33",
797825
"metadata": {},
798826
"source": [
799827
"````{dropdown} Static preview of the result\n",

‎04-regrid.md‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@ subtitle: Tools for regridding MPAS-A output to regular lat-lon grids
44
label: page:regrid
55
---
66

7+
```{note}
8+
Some of the below examples may be easier to get going on
9+
[Casper](https://ncar-hpc-docs.readthedocs.io/en/latest/compute-systems/casper/)[^casper]
10+
(NCO and CDO are already installed, etc.),
11+
but it also should be doable on your local machine or another HPC.
12+
```
13+
14+
[^casper]: Or Derecho, but Derecho is usually overkill for this kind of task.
15+
716
# Options
817

918
(pyremap)=
@@ -202,7 +211,7 @@ make
202211
export PATH="$PWD:$PATH"
203212
```
204213

205-
Now we can use the `convert_mpas` command[^rc].
214+
On Casper/Derecho this should _just work_. Now we can use the `convert_mpas` command[^rc].
206215

207216
[^rc]: For the current shell session. Add an `export` line to your `.bashrc` to make it permanent.
208217

0 commit comments

Comments
 (0)