Merge pull request #43 from mgrover1/add-nimbus-instructions

FIX: Fix the links/such with rooki, add nimbus instructions

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",

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",

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. 

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!"
    ]