diff --git a/notebooks/ex-regrid-plot.ipynb b/notebooks/ex-regrid-plot.ipynb index f130e19..f510e83 100644 --- a/notebooks/ex-regrid-plot.ipynb +++ b/notebooks/ex-regrid-plot.ipynb @@ -92,11 +92,11 @@ "import os\n", "import intake_esgf\n", "\n", - "# Run this on the DKRZ node in Germany\n", + "# Run this on the DKRZ node in Germany, using the ESGF1 index node at LLNL\n", "os.environ[\"ROOK_URL\"] = \"http://rook.dkrz.de/wps\"\n", "intake_esgf.conf.set(indices={\"anl-dev\": False,\n", " \"ornl-dev\": False,\n", - " \"esgf-data.dkrz.de\": True})\n", + " \"esgf-node.llnl.gov\": True})\n", "\n", "import rooki.operators as ops\n", "import matplotlib.pyplot as plt\n", diff --git a/notebooks/rooki_enso_nonlinear.ipynb b/notebooks/rooki_enso_nonlinear.ipynb index cc60578..26678ce 100644 --- a/notebooks/rooki_enso_nonlinear.ipynb +++ b/notebooks/rooki_enso_nonlinear.ipynb @@ -95,11 +95,11 @@ "import os\n", "import intake_esgf\n", "\n", - "# Run this on the DKRZ node in Germany\n", + "# Run this on the DKRZ node in Germany, using the ESGF1 index node at LLNL\n", "os.environ[\"ROOK_URL\"] = \"http://rook.dkrz.de/wps\"\n", "intake_esgf.conf.set(indices={\"anl-dev\": False,\n", " \"ornl-dev\": False,\n", - " \"esgf-data.dkrz.de\": True})\n", + " \"esgf-node.llnl.gov\": True})\n", "\n", "import matplotlib.pyplot as plt\n", "import numpy as np\n", diff --git a/notebooks/running-on-nimbus.md b/notebooks/running-on-nimbus.md new file mode 100644 index 0000000..1257cdb --- /dev/null +++ b/notebooks/running-on-nimbus.md @@ -0,0 +1,42 @@ +# Running Notebooks on Nimbus + +Interested in running your notebooks on ESGF infrastructure? Please follow these steps! + +## 1. Apply for access to the Nimbus Access + +Please fill out [this form](https://forms.gle/h8y14hfefcaCraEJ8) to request access to the Nimbus Jupyterhub! + +You will be added to the [Nimbus User Group](https://github.com/orgs/esgf-nimbus/people), which is used for authentication! + +## 2. Clone this repository + +Once you log into the Jupyterhub (https://nimbus.llnl.gov/), go to your home directory (shown by default) and clone this repository + +```bash +git clone https://github.com/ProjectPythia/esgf-cookbook.git +``` + +## 3. Build your Execution Environment +The cookbook environment is slightly different than the base environment available on the hub. You will need to build the required environment, using the `environment.yml` file in the repository. + +```bash +conda env create -f esgf-cookbook/environment.yml +``` + +## Activate Your Environment +Once you build the enivronment, you will need to activate it. You will need to follow the following steps: + +```bash +# Make sure you can activate the environment +source .bashrc + +# Activate the environment +conda activate esgf-cookbook-dev +``` + +## Open a Notebook and Select the `esgf-cookbook-dev` environment +Now that you have an environment, you can select this when opening a notebook. Select in the top right corner the kernel options, and select `esgf-cookbook-dev`. + +Wait a second for the notebook to pick up on this, then execute your cells! + +If you need to install more packages, or update versions, you can do so by updating your `environment.yml` file or by installing via the command line. \ No newline at end of file diff --git a/notebooks/use-intake-esgf-with-rooki.ipynb b/notebooks/use-intake-esgf-with-rooki.ipynb index 0eca99e..0f6b06c 100644 --- a/notebooks/use-intake-esgf-with-rooki.ipynb +++ b/notebooks/use-intake-esgf-with-rooki.ipynb @@ -83,7 +83,7 @@ "source": [ "import os\n", "\n", - "# Configuration line to set the wps node - in this case, use DKRZ in Germany\n", + "# Configuration line to set the wps node - in this case, use ORNL in the USA\n", "url = \"https://esgf-node.ornl.gov/wps\"\n", "os.environ[\"ROOK_URL\"] = url\n", "\n", @@ -115,7 +115,7 @@ "id": "7dd9b81a-9aeb-4769-8c67-4db88a089859", "metadata": {}, "source": [ - "## Search and Find Data for Surface Temperature on DKRZ Node\n", + "## Search and Find Data for Surface Temperature on the ORNL Node\n", "\n", "Let's start with refining which index we would like to search from. For this analysis, we are remotely computing on the ORNL node since this is where rooki is running. We know this from checking the `._url` method of rooki!" ]