DataARC Ecosystem Explorer Guide
================================

The dataARC Ecosystem Explorer is a Jupyter Notebook designed to allow for interactive exploration of existing dataARC
datasets and concepts, and their relationships. This guide will walk you through how to navigate the Jupyter Notebook
while learning about dataARC.

Open the dataARC Ecosystem Explorer
-----------------------------------

.. note::
  Is your Binder session still up and running from completing the Jupyter Notebook Basics Tutorial? You can skip ahead to Step 3.


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_binder|.

   |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_binder| 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 ``dataarc_pyvis.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 instructions in 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>


Ready to take it one step further? Do the :ref:`Add Your Own Combinator Tutorial` next.
---------------------------------------------------------------------------------------