Tutorials#
These tutorial notebooks guide Rubin scientists through the process of creating a Zooniverse project and retrieving classifications. The purpose of each individual notebook is outlined below.
Citizen Science notebooks GitHub repository
Introduction to Rubin Citizen Science#
Notebook: 01_Introduction_to_Citsci_Pipeline.ipynb
Start with this notebook to learn how to create a Zooniverse project with Rubin, send images from the Rubin Science Platform (RSP) to Zooniverse, and retrieve raw classifications.
Create an Image Flipbook on Zooniverse#
Notebook: 02_Send_Flipbook_Variable_Stars_Imaging.ipynb
Use this notebook to query and send a flipbook of variable star images from the RSP to Zooniverse. A flipbook is a collection of multiple images, useful for tracking and identifying sources at the same location that change over time. This notebook focuses on variable stars, which exhibit brightness variations.
Download and Aggregate Zooniverse User Classifications#
Notebook: 03_Aggregate_Classifications.ipynb
Use this notebook to retrieve and aggregate classification data from Zooniverse.
This tutorial aggregates (or combines) user classifications by grouping them by task and user.
It selects the most recent classification from each user and applies Zooniverse’s question_consensus_reducer function to determine consensus for each subject ID.
This notebook builds on the retrieval process demonstrated in the first tutorial and extends it to aggregating raw user classifications.
rubin.citsci package#
The rubin.citsci package is intended to be used on the Vera Rubin Observatory’s Science Platform (RSP) in the hosted Notebook Aspect at http://data.lsst.cloud. This package will not work in any other environment.
It contains utility functions useful for sending and receiving Rubin data to and from the Zooniverse.
For instance, it contains functions such as login_to_zooniverse and create_project_from_template to assist Rubin users with the process of creating Zooniverse projects.
Functions such as write_manifest_file and send_tabular_data assist with sending data to Zooniverse while functions such as download_batch_metadata and retrieve_data are used to download information and classifications from Zooniverse.