Jupyter Notebooks Basics
========================

Learning Objectives
-------------------

* Open and navigate a Jupyter Notebook using Binder
* Introduce conventions adopted by dataARC Ecosystem Explorer
* Become comfortable with running cells and making minor edits to code blocks.


.. note::
  The Jupyter Notebooks provided for your navigation are running on a remote server and no changes are saved when
  executing the code. This gives you the freedom to play and not worry about breaking anything! You can always return to
  Step 1 (below) with a clean slate. **Have fun!**


Open the Tutorial Notebook
--------------------------
1. Navigate to the |demo|

.. |demo| raw:: html

  <a href="https://github.com/ropitz/dataarc-demo" target=_blank> dataARC Demo GitHub Repository</a>

2. Scroll down a bit and click on |launch|.

   |launch_screen|

   This process will take about a minute while binder processes the request. Your screen should look like this while
   it's running:

   |binder_spinup|

.. |binder_spinup| raw:: html

  <center>
  <img src="../_static/binder_spinup.png" width=650 style="border:5px solid black"/>
  </center>

.. |launch| raw:: html

  <img src="../_static/launch_binder_button.png" width=120/>

.. |launch_screen| raw:: html

  <center>
  <img src="../_static/launch_screen.png" width=650 style="border:5px solid black"/>
  </center>



3. When Binder has completed its spin-up process, click on the Jupyter Notebook `Jupyter Notebook Tutorial.ipynb`

   |jupyter_home|

   The Jupyter Notebook will open in a new window, ready to run!

   |tutorial_notebook|


.. |jupyter_home| raw:: html

  <center>
  <img src="../_static/jupyter_homepage.png" width=650 style="border:5px solid black"/>
  </center>

.. |tutorial_notebook| raw:: html

  <center>
  <img src="../_static/tutorial_notebook.png" width=650 style="border:5px solid black"/>
  </center>


4. Follow along with the Six Steps for learning all you need to know inside the Jupyter Notebook.


Troubleshooting
===============

You may find that your Jupyter Notebook looks like this:

  |github_notebook_view|

In this case, Binder is not running. Return to Step 1, and ensure that you wait for the Binder spin-up to complete.


.. |github_notebook_view| raw:: html

  <center>
  <img src="../_static/github_notebook_view.png" width=650 style="border:5px solid black"/>
  </center>


Once you've completed the Jupyter Notebook Tutorial, move on to the :ref:`DataArc Ecosystem Explorer Guide`.
------------------------------------------------------------------------------------------------------------