SUNY Oswego Workshop Cookbook

This Project Pythia Cookbook covers working with radar data in Python, including examples from NEXRAD and the Doppler of Wheels from the SUNY Oswego SOURCE project.

Motivation

This cookbook will serve as a basis for an introduction to the open-radar science software stack, mainly Py-ART and xradar. Users are encouraged to join the Open Radar Discourse group for further interaction with the open-radar community. The majority of the material is repurposed from the Project Pythia Radar Cookbook and includes further details.

Authors

Joe O’Brien Max Grover, Kai Mühlbauer, Alfonso Ladino, Scott Collis, Zach Sherman, Bobby Jackson, Joe O’Brien

Contributors

Structure

This cookbook will be broken into three sections which include radar basics, radar software foundations, and an example from LEE for group exercise.

Section 1 ( Radar Basics )

Radar basics will include a presentation on radar data formats and background information on the open radar software stack.

Section 2 (Py-ART Basics)

Example notebooks on the basics of Py-ART

Section 3 ( SOURCE Example )

Students will work through an example notebook utilizing data obtained from SOURCE.

Running the Notebooks

You can either run the notebook using Binder or on your local machine.

Running on Binder

The simplest way to interact with a Jupyter Notebook is through Binder, which enables the execution of a Jupyter Book in the cloud. The details of how this works are not important for now. All you need to know is how to launch a Pythia Cookbooks chapter via Binder. Simply navigate your mouse to the top right corner of the book chapter you are viewing and click on the rocket ship icon, (see figure below), and be sure to select “launch Binder”. After a moment you should be presented with a notebook that you can interact with. I.e. you’ll be able to execute and even change the example programs. You’ll see that the code cells have no output at first, until you execute them by pressing Shift+Enter. Complete details on how to interact with a live Jupyter notebook are described in Getting Started with Jupyter.

Running on Your Own Machine

If you are interested in running this material locally on your computer, you will need to follow this workflow:

Clone the https://github.com/jrobrien91/suny-oswego-workshop-2024/ repository:
```
 git clone https://github.com/jrobrien91/suny-oswego-workshop-2024.git
```
Move into the suny-oswego-workshop-2024 directory
```
cd suny-oswego-workshop-2024
```

Create and activate your conda environment from the environment.yml file

conda env create -f environment.yml
conda activate oswego-radar

Move into the notebooks directory and start up Jupyterlab
```
cd notebooks/
jupyter lab
```