@@ -21,6 +21,35 @@ A recorded walkthrough of this advanced tutorial is available [here](https://you
The ESAP Archives (accessible via the ESAP GUI) include data retrieval from the Zooniverse Classification Database using the ESAP Shopping Basket. For a tutorial on loading Zooniverse data from a saved shopping basket into a notebook and performing simple aggregation of the classification results, see [here](https://git.astron.nl/astron-sdc/escape-wp5/workflows/muon-hunters-example/-/tree/master)(also available as an Interactive Analyis workflow).
### Setup
#### Option 1: ESAP workflow as a remote notebook instance
You may need to install the `panoptes_client` and `pandas` packages.
```
!python -m pip install panoptes_client
!python -m pip install pandas
```
#### Option 2: Local computer
1. Install Python 3: the easiest way to do this is to download the Anaconda build from https://www.anaconda.com/download/. This will pre-install many of the packages needed for the aggregation code.
2. Open a terminal and run: `pip install panoptes-aggregation`
3. Download the [Advanced Project Building](https://git.astron.nl/astron-sdc/escape-wp5/workflows/zooniverse-advanced-project-building) tutorial into a suitable directory.
#### Option 3: Google Colab
Google Colab is a service that runs Python code in the cloud.
1. Sign into Google Drive.
2. Make a copy of the [Advanced Project Building](https://git.astron.nl/astron-sdc/escape-wp5/workflows/zooniverse-advanced-project-building) tutorial in your own Google Drive.
3. Right click the `AdvancedProjectBuilding.ipynb` file > Open with > Google Colaboratory.
1. If this is not an option click "Connect more apps", search for "Google Colaboratory", enable it, and refresh the page.
4. Run the following in the notebook:
1.`!pip install panoptes_aggregation --quiet` to install the needed packages (it will take a few minutes to finish),
2.`from google.colab import drive; drive.mount('/content/drive')` to mount Google Drive, and
3.`import os; os.chdir('/content/drive/MyDrive/zooniverse-advanced-project-building/')` to change the current working directory to the example folder (adjust if you have renamed the example folder).
### Other Useful Resources
Here is a list of additional resources that you may find useful when building your own Zooniverse citizen science project.
