Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

sea ice notebook tweaks (#405) #1027

Merged
merged 1 commit into from
Jan 26, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 48 additions & 11 deletions doc/jupyter/Demo/Demo_9_seaIceExtent_ivanova.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"id": "acb8d42e",
"metadata": {},
"source": [
"# Sea Ice Demo"
"# PCMDI Metrics Package Sea Ice Demo"
]
},
{
Expand All @@ -14,7 +14,7 @@
"metadata": {},
"source": [
"**Summary** \n",
"The PCMDI Metrics sea ice driver produces metrics that compare modeled and observed sea ice extent. This notebook demonstrates how to run the PCMDI Metrics sea ice code.\n",
"The PCMDI Metrics Package (PMP) sea ice driver produces metrics that compare modeled and observed sea ice extent. This notebook demonstrates how to run the PMP sea ice code.\n",
"\n",
"**Authors** \n",
"Ana Ordonez, Jiwoo Lee, Paul Durack, Peter Gleckler (PCMDI, Lawrence Livermore National Laboratory)\n",
Expand All @@ -29,9 +29,9 @@
"metadata": {},
"source": [
"## Demo data\n",
"This demo uses three CMIP6 models. The 'siconc' and 'areacello' variables are needed and can be found in the following directories. In addition, six other models are available that can be added to the analyses in this demo:\n",
"This demo uses three CMIP6 models. The Sea-Ice Area Percentage (Ocean Grid; 'siconc') and Grid-Cell Area for Ocean Variables ('areacello') variables are needed and can be found in the following directories. In addition, six other models are available that can be added to the analyses in this demo:\n",
"```\n",
"/p/user_pub/pmp/demo/sea-ice/links_siconc \n",
"/p/user_pub/pmp/demo/sea-ice/links_siconc\n",
"/p/user_pub/pmp/demo/sea-ice/links_area\n",
"```"
]
Expand All @@ -41,7 +41,7 @@
"id": "00d48042",
"metadata": {},
"source": [
"The observation dataset provided is a satellite derived sea ice concentration dataset from EUMETSAT OSI SAF. More information about this data can be found at the [osi-450-a product page](https://osi-saf.eumetsat.int/products/osi-450-a). The path to this data is:\n",
"The observational dataset provided is the satellite derived sea ice concentration dataset from EUMETSAT OSI-SAF. More data information can be found at the [osi-450-a product page](https://osi-saf.eumetsat.int/products/osi-450-a). The path to this data is:\n",
"```\n",
"/p/user_pub/pmp/demo/sea-ice/EUMETSAT\n",
"```"
Expand All @@ -53,7 +53,7 @@
"metadata": {},
"source": [
"## Sectors\n",
"This code block produces maps that show the different regions used in the analysis along with the mean observed sea ice concentration. The code to generate these figures can be found in the script `sea_ice_sector_plots.py`.\n",
"This code block produces maps that show the different regions used in the analysis along with the mean observed (OSI-SAF) sea ice concentration. The code to generate these figures can be found in the script `sea_ice_sector_plots.py`.\n",
"\n",
"Below process will take about 30 seconds."
]
Expand Down Expand Up @@ -132,7 +132,7 @@
"id": "f316897b",
"metadata": {},
"source": [
"This first case will work with sea ice concentration ouput from a single model, E3SM-1-0. Two overview plots are shown below to visualize the Arctic sea ice in this model.\n",
"This first case will work with sea ice concentration ouput from a single model, E3SM-1-0. Two overview plots are shown below to visualize the Arctic sea ice evolution over time in this model.\n",
"\n",
"For this demo, we start the OSI-SAF satellite data in 1988 as that avoids missing data in earlier parts of the record.\n",
"\n",
Expand Down Expand Up @@ -196,6 +196,14 @@
"display_png(a,b)"
]
},
{
"cell_type": "markdown",
"id": "404ed8d1",
"metadata": {},
"source": [
"# Introducing the PCMDI Metrics Package (PMP) parameter file"
]
},
{
"cell_type": "markdown",
"id": "2540cd5d",
Expand Down Expand Up @@ -283,6 +291,14 @@
"To see all of the parameters available for the sea ice metrics, run the --help command as shown here:"
]
},
{
"cell_type": "markdown",
"id": "dc0d0eeb",
"metadata": {},
"source": [
"# Introducing the PMP driver file"
]
},
{
"cell_type": "code",
"execution_count": 7,
Expand Down Expand Up @@ -408,10 +424,11 @@
"id": "9bfa9c97",
"metadata": {},
"source": [
"# Running the PMP sea ice demo\n",
"The PMP drivers are run on the command line. In this Jupyter Notebook, we use the bash cell magic function %%bash to run command line functions from the notebook.\n",
"\n",
"The PMP sea ice metrics driver call follows the basic format:\n",
"ice_driver.py -p parameter_file.py --additional arguments\n",
"sea_ice_driver.py -p parameter_file.py --additional arguments\n",
"\n",
"The following cell runs the driver with the demo parameter file we saw above.\n",
"\n",
Expand Down Expand Up @@ -1048,7 +1065,7 @@
"id": "cadb1306",
"metadata": {},
"source": [
"Since we have averaged four different realizations, the resulting statistics are different than seen in example 1. The bar chart now contains markers showing the overall spread among the realizations."
"Since we have averaged four different realizations (E3SM-1-0: 'r1i2p2f1', 'r2i2p2f1', 'r3i2p2f1', 'r4i2p2f1'), the resulting statistics are different than seen in example 1. The bar chart now contains markers showing the overall spread among the realizations."
]
},
{
Expand Down Expand Up @@ -2716,7 +2733,7 @@
"\n",
"As a reminder, data for nine models is available here:\n",
"```\n",
"/p/user_pub/pmp/demo/sea-ice/links_siconc \n",
"/p/user_pub/pmp/demo/sea-ice/links_siconc\n",
"/p/user_pub/pmp/demo/sea-ice/links_area\n",
"```\n",
"\n",
Expand All @@ -2733,10 +2750,30 @@
"```\n"
]
},
{
"cell_type": "markdown",
"id": "f1161f29",
"metadata": {},
"source": [
"# Debugging the LLNL Nimbus binder environment"
]
},
{
"cell_type": "markdown",
"id": "fc4b0ab9",
"metadata": {},
"source": [
"For CAMAS workshop users, if you hit an issue at login `User $id already has a running server`.\n",
"\n",
"The fix is to login (using your GitHub credentials) using [https://binder-nimbus.llnl.gov/hub/home](https://binder-nimbus.llnl.gov/hub/home) and select \"Stop My Server\".\n",
"\n",
"Once you refresh the start page ([https://binder-nimbus.llnl.gov](https://binder-nimbus.llnl.gov)), login and start again, it should work as expected"
]
},
{
"cell_type": "code",
"execution_count": null,
"id": "f1161f29",
"id": "88955af5",
"metadata": {},
"outputs": [],
"source": []
Expand Down
Loading