Skip to content

Commit

Permalink
Add initial quarto content
Browse files Browse the repository at this point in the history
Add all necessary files to create a quarto book.
  • Loading branch information
cassienickles committed Jan 4, 2024
1 parent 44e7e62 commit 11e8030
Show file tree
Hide file tree
Showing 9 changed files with 205 additions and 0 deletions.
45 changes: 45 additions & 0 deletions .github/workflows/quarto-publish.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
name: Render and deploy quarto files
on:
push:
branches: main
pull_request:
branches: main

jobs:
quarto-render-and-deploy:
runs-on: ubuntu-latest
defaults:
run:
shell: bash -l {0}
steps:
- uses: actions/checkout@v2
# - uses: conda-incubator/setup-miniconda@v2
# with:
# python-version: 3.8
# channels: conda-forge
# miniforge-variant: Mambaforge
# activate-environment: quarto-import#
# environment-file: _import/environment.yml


# - name: "Import external notebooks"
# working-directory: ./_import
# run: |
# conda info
# pytest
# python quarto_import.py -f assets.json

- name: Set up Quarto
uses: quarto-dev/quarto-actions/setup@v2
with:
# To install LaTeX to build PDF book
tinytex: true
# uncomment below and fill to pin a version
# version: 0.9.600

- name: Publish to GitHub Pages (and render)
uses: quarto-dev/quarto-actions/publish@v2
with:
target: gh-pages
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # this secret is always available for github actions
12 changes: 12 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
ipynb_checkpoints
*core.*
.Rproj.user
.Rhistory
.RData
.Ruserdata

/.quarto/
.ipynb_checkpoints
*_cache/
_site/
/_site/
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,6 @@
# 2024-SWOT-Hydro-Workshop
2024 in person pre-conference workshop at AGU Chapman: Remote Sensing of the Water Cycle, hosted by NASA PO.DAAC.

Tuesday, February 13th, 2024
9:00am - 12:30pm
Honolulu, HI
57 changes: 57 additions & 0 deletions _quarto.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
project:
type: website

website:
title: "Data Access Workshop for NASA’s SWOT Satellite"
site-url: https://podaac.github.io/2024-SWOT-Hydro-Workshop/
repo-url: https://github.com/podaac/2024-SWOT-Hydro-Workshop
repo-actions: [edit, issue]
page-navigation: true
page-footer: "PO.DAAC (2024)."

navbar:
background: primary
right:
- sidebar:welcome
- icon: github
href: https://github.com/podaac/2024-SWOT-Hydro-Workshop

sidebar:
- id: welcome
title: "Menu"
logo: podaac-logo.png
style: "docked"
collapse-level: 1
align: left
contents:
- text: "Welcome"
href: index.md
- text: "Prerequisites"
href: prerequisites.md
- text: "Schedule"
href: schedule.md
- text: "Slides"
href: slides.md
- section: "Tutorials"
contents:
- text: "Search & Discovery"
href:
- text: "Access, Subset & Plot"
href:
# - section: "Additional Resources"
# contents:


format:
html:
theme:
light: sandstone
dark: [superhero, theme-dark.scss]
code-background: true
code-copy: true
css: styles.css
toc: true

#filters:
# - include-files.lua
# - quarto
32 changes: 32 additions & 0 deletions index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: "Data Access Workshop for NASA’s SWOT Satellite"
subtitle: "An in person workshop at AGU Chapman: Remote Sensing of the Water Cycle"

author: "Cassie Nickles & Catalina Taglialatela"
---

## Welcome

Welcome to the **2024 Data Access Workshop for NASA’s SWOT Satellite** hosted by [PO.DAAC](https://podaac.jpl.nasa.gov/)!

**The workshop will take place in person at the AGU Chapman: Remote Sensing of the Water Cycle Conference on Tuesday, February 13, 2024 from 9am-12:30pm in Honolulu, HI.**


## About

### Workshop Goals

- Provide an inclusive place to learn about and experience working with NASA's SWOT Hydrology Data;
- Provide strategies and best practices for finding and accessing NASA Earthdata in the Cloud. Specifically, participants will learn how to access data from AWS S3 buckets and have a better understanding of the Python ecosystem used to analyze the data depending on size and data formats;
- Better understand the needs of Earthdata data scientists by providing a post survey and engaging in discussions with workshop participants;
- Identify and practice using popular open source tools and utilities.


### Workshop Description

The Surface Water and Ocean Topography (SWOT) satellite, a joint NASA-CNES venture, provides unprecedented measurements of surface water extents and elevations for hydrologic science and applications. The observations are offered through a range of data products including river and lake vector data in shapefiles, and raster, pixel cloud, and pixel vector data in netCDF. The shapefile products will also contain estimates of river discharge and lake storage change. In this pre-meeting workshop, participants will be introduced to SWOT and the various ways to access and utilize its data products, including via cloud computing, local download, and data transformation tools. Participants will be able to utilize a provided cloud computing environment accessed via personal laptops, or their own laptop’s compute power to explore SWOT data using data recipes by PO.DAAC, NASA’s Physical Oceanography Data Active Archive Center. No prior cloud computing experience is necessary. We welcome all to come and see how SWOT data could augment existing workflows or initiate new, innovative science and applications! The data tutorials at the workshop will use Python, but no prior experience is needed.


## Acknowledgements

This Workshop and its content has been developed by a large team at PO.DAAC.
Binary file added podaac-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 16 additions & 0 deletions prerequisites.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: Prerequisites
---

## Before the Workshop, you will need the following:

### 1. Earthdata Login Account

An Earthdata Login account is required to access data, as well as discover restricted data, from the NASA Earthdata system. Thus, to access NASA data, you need Earthdata Login. Please visit https://urs.earthdata.nasa.gov to register and manage your Earthdata Login account. This account is free to create and only takes a moment to set up. Please remember your username and password!

### 2. GitHub Account

A GitHub account is required to gain access to the provided 2i2c cloud computing platform. Please visit https://github.com/join to register and create a free GitHub account. There was an opportunity to send in your GitHub username when you registered for the workshop, if you did not do so, please email [email protected] with your GitHub username and mention you are a participant for this workshop.

### 3. Laptop or tablet
Participation in the exercises requires a laptop or tablet. Yes, a tablet works too! All participants will have access to a 2i2c Jupyter Lab instance running in AWS us-west 2.
32 changes: 32 additions & 0 deletions schedule.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: Schedule
---

**The Data Access Workshop for NASA’s SWOT Satellite will take place on Tuesday, February 13th from 9:00-12:30**.

**Note,** hands-on exercises will be executed from a **Jupyter Lab instance in 2i2c.** [Click here to deploy the instance]() and simultaneously clone this GitHub repository to follow along with the tutorials. Please pass along your GitHub Username to get access.

## Workshop Schedule

### February 13th, 2024

| Time, HST (UTC-10) | Event |
|------|-------|-------------------|
| 9:00 am | Welcome / Ice Breaker |
| 9:20 am | Introduction to SWOT |
| am | Orientation and setup in JupyterHub in the Cloud |
| am | Tutorial: |
| am | Break |
| am | Tutorial: |
| am | Q & A |
| pm | Closing Survey |


## Closing - Close out your Jupyter Hub!

- Close out your JupyterHub instance if you are finished for the day, following [these instructions](https://podaac.github.io/2022-SWOT-Ocean-Cloud-Workshop/tutorials/00_Setup.html#how-do-i-end-my-session).
- You will continue to have access to the 2i2c JupyterHub in AWS for two weeks following this Workshop. You may use that time on your own to continue work and learn more about migrating data access routines and science workflows to the cloud. This cloud compute environment is supported by the [NASA Openscapes](https://nasa-openscapes.github.io/) project.

### **Thank you!**


7 changes: 7 additions & 0 deletions slides.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: Workshop Slides
---

## Data Access Workshop for NASA’s SWOT Satellite

TODO: embed slides

0 comments on commit 11e8030

Please sign in to comment.