# Project Pythia

:::{banner}
:color: rgba(26, 100, 143, 0.85)
:image: _static/images/backgrounds/pexels-jeff-stapleton-5792818.jpg
:caption: Photo by Jeff Stapleton from Pexels
:class: dark-banner
:::

<span style="font-size: 2.6rem;">An education and training hub for the geoscientific Python community</span>

<a href="https://projectpythia.org/pythia-cookoff-2024/" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none; background-color: #ccc; border: rgba(var(--spt-color-dark), 1);">
         Project Pythia is hosting a Cookbook Cook-Off June 11-14, 2024.<br>
         Learn more here.
 </a>

[Project Pythia](about) is the education working group for [Pangeo](https://pangeo.io)
and is an educational resource for the entire geoscience community.
Together these initiatives are helping geoscientists make sense of huge volumes of
numerical scientific data using tools that facilitate open, reproducible science,
and building an inclusive [community of practice](https://en.wikipedia.org/wiki/Community_of_practice)
around these goals.

Project Pythia is a home for Python-centered learning resources that are _open-source_,
_community-owned_, _geoscience-focused_, and _high-quality_.

<span class="d-flex justify-content-center py-4">
    <a href="about.html" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none;">
        About <img src="./_static/images/logos/pythia_logo-blue-rtext.svg" alt="Project Pythia" height="35px" style="margin-left: 0.5rem;">
    </a>
    <div class="horizontalgap" style="width:70px"></div>
    <a href="https://pangeo.io/about" role="button" class="btn btn-light btn-lg" style="display: flex; align-items: center; font-weight: 600; text-decoration: none;">
        About <img src="https://raw.githubusercontent.com/pangeo-data/pangeo/master/docs/_static/small_e_logo_cropped.png" alt="Pangeo logo" height="35px" style="margin-left: 0.5rem;">
        <img src="https://raw.githubusercontent.com/pangeo-data/pangeo/master/docs/_static/pangeo_simple_logo.svg" alt="Pangeo" height="22px">
    </a>
</span>


## Start Learning

Project Pythia has several resources for you to use to start learning how to use Python
and the technology in the Python ecosystem for the geosciences.

### The Foundations Book

The [Pythia Foundations Book](https://foundations.projectpythia.org) is a
[Jupyter Book](https://jupyterbook.org/) developed by the Pythia community to
act as a **comprehensive set of tutorials** covering the **foundational skills**
everyone needs to get started with **computing in the open-source Python ecosystem**.
These foundational tutorials will serve as common references for more advanced and
domain-specific content to be housed here in the Pythia Portal.

<span class="d-flex justify-content-center pt-1 pb-3">
    <a href="https://foundations.projectpythia.org" role="button" class="btn btn-primary btn-lg">
        Read the Pythia Foundations Book
    </a>
</span>

### Pythia Cookbooks

Pythia Cookbooks are collections of more advanced and domain-specific example workflows building on top of Pythia Foundations.

<span class="d-flex justify-content-center pt-1 pb-3">
    <a href="https://cookbooks.projectpythia.org" role="button" class="btn btn-primary btn-lg">
        Visit Pythia Cookbooks
    </a>
</span>

### The Resource Gallery

There is a wealth of educational resources out there on the internet for learning
Python and how to use it in the geosciences! We have attempted to gather together
a curated and filterable list of these resources (including Pythia's own content)
into our [Pythia Resource Gallery](/resource-gallery).
Click the link below to see a hand-picked selection of resources for learning at
your own pace.

<span class="d-flex justify-content-center pt-1 pb-3">
    <a href="/resource-gallery.html" role="button" class="btn btn-primary btn-lg">
        Visit the Pythia Resource Gallery
    </a>
</span>

### Webinar Tutorial Series

The [Pythia Webinar Tutorial Series](https://ncar-xdev.github.io/status/tutorials.html) is hosted regularly by the Project Pythia team. Anyone can join
these hour-long, instructor-led interactive tutorials. Participants can
sit back and learn, or download a Jupyter Notebook and work along with
the instructor. Each seminar is recorded for later viewing on the
[Project Pythia YouTube channel](https://www.youtube.com/channel/UCoZPBqJal5uKpO8ZiwzavCw).
Click the link below to view past and upcoming seminars, covering a range of
topics from beginning to advanced.

<span class="d-flex justify-content-center pt-1 pb-3">
    <a href="https://ncar-xdev.github.io/status/tutorials.html" role="button" class="btn btn-primary btn-lg">
        Visit the Pythia Webinar Tutorial Series
    </a>
</span>

### Pythia Data Collection

Looking for a free, public domain geoscience data set that you can use to
sharpen your skills while learning the Scientific Python Ecosystem? All of
the example data used by the [Pythia Foundations Book](https://foundations.projectpythia.org) are freely accessible.

<span class="d-flex justify-content-center pt-1 pb-3">
    <a href="https://github.com/ProjectPythia/pythia-datasets" role="button" class="btn btn-primary btn-lg">
        Visit the Pythia Data Repository
    </a>
</span>

<!--
<a href="/gallery.html">
<div id="galleryCarousel" class="carousel carousel-dark slide py-4" data-bs-ride="carousel">
    <div class="carousel-indicators">
        <button type="button" data-bs-target="#galleryCarousel" data-bs-slide-to="0" class="active" aria-current="true" aria-label="Slide 1"></button>
        <button type="button" data-bs-target="#galleryCarousel" data-bs-slide-to="1" aria-label="Slide 2"></button>
        <button type="button" data-bs-target="#galleryCarousel" data-bs-slide-to="2" aria-label="Slide 3"></button>
    </div>
    <div class="carousel-inner">
        <div class="carousel-item active">
            <img src="_static/images/pexels-brett-sayles-1431822.jpg" height="200" width="400" class="d-block w-100" alt="1"/>
            <div class="carousel-caption d-none d-md-block">
                <h5>Slide 1</h5>
                <p>This is Slide 1.</p>
            </div>
        </div>
        <div class="carousel-item">
            <img src="_static/images/pexels-pixabay-209831.jpg" height="200" width="400"  class="d-block w-100" alt="2"/>
            <div class="carousel-caption d-none d-md-block">
                <h5>Slide 2</h5>
                <p>This is Slide 2.</p>
            </div>
        </div>
        <div class="carousel-item">
            <img src="_static/images/pexels-pixabay-531756.jpg" height="200" width="400"  class="d-block w-100" alt="3"/>
            <div class="carousel-caption d-none d-md-block">
                <h5>Slide 3</h5>
                <p>This is Slide 3.</p>
            </div>
        </div>
    </div>
    <button class="carousel-control-prev" type="button" data-bs-target="#galleryCarousel" data-bs-slide="prev">
        <span class="carousel-control-prev-icon" aria-hidden="true"></span>
        <span class="visually-hidden">Previous</span>
    </button>
    <button class="carousel-control-next" type="button" data-bs-target="#galleryCarousel" data-bs-slide="next">
        <span class="carousel-control-next-icon" aria-hidden="true"></span>
        <span class="visually-hidden">Next</span>
    </button>
</div>
</a>
-->

## Join us!

If you have questions or want to share anything with the Project
Pythia Team, please reach out to us through the [Project Pythia
category on the Pangeo Discourse forum](https://discourse.pangeo.io/c/education/project-pythia/)
or join us at any of our [Monthly Project Meetings](#monthly-pythia-meetings).

<span class="d-flex justify-content-center pt-1 pb-4">
    <a href="https://discourse.pangeo.io/c/education/project-pythia/" role="button" class="btn btn-primary btn-lg">
        Go to Pangeo Discourse
    </a>
</span>

### Contributing

Anyone can contribute to and participate in Project Pythia!
We conduct all of our work in the open, and all of our work is Open Source Licensed.
We welcome contributions from anyone in the community.
Please see our [Contributor’s Guide](/contributing)
for details on how you can get involved, and come see our work in the
[ProjectPythia GitHub Organization](https://github.com/ProjectPythia).

<div class="container">
<div class="row">
<div class="col-12 col-md m-2">
<a class="btn btn-primary btn-lg w-100" href="/contributing.html" role="button">Read our Contributor’s Guide</a>
</div>
<div class="col-12 col-md-3 m-2">
<a class="btn btn-primary btn-lg w-100" href="https://github.com/ProjectPythia" role="button">Visit us on GitHub</a>
</div>
<div class="col-12 col-md-4 m-2">
<a class="btn btn-primary btn-lg w-100" href="/code_of_conduct.html" role="button">Read our Code of Conduct</a>
</div>
</div>
</div>

### Monthly Pythia Meetings

Project Pythia holds regular public meetings via Zoom as scheduled on the calendar below.
Do you want to learn about the project, engage with other excited folks, or share your own needs and interests in Python learning?
You are welcome and encouraged to join! Unsure where to start?
Come to our monthly Pythia Community Meeting for updates, successes, and community participation across the project.
For a smaller group and to connect with the project on social media and at conferences, you can also join the monthly Pythia Outreach Meeting.
Please find links and information about how to join in the calendar below.
We publish all notes and agendas of our
[Community Meetings](https://docs.google.com/document/d/e/2PACX-1vQWQrgHs_G5XyNH5GTFYydH_woUZcyZibdxPUWLpqFUYs20WM93kdx5onwOaizC_3-tfnbreMNQbYAp/pub)
and [Outreach Meetings](https://docs.google.com/document/d/e/2PACX-1vQBAt5B24wig2eh-hxHzgJiXjKCpSeGKsw3PFizZjwH7ka71dagipKwCwQvmE-obmSOfR4Psj2lgbvU/pub).

### Meeting & Event Calendar

<div class="iframe-4x3">
    <iframe src="https://calendar.google.com/calendar/embed?src=c_4qpvf316afd9mv0ci7d2uiafog%40group.calendar.google.com" frameborder="0" scrolling="no"></iframe>
</div>

## How to Cite

The material in Project Pythia is licensed for free and open consumption and reuse. All code is served under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0), while all non-code content is licensed under [Creative Commons BY 4.0 (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). Effectively, this means you are free to share and adapt this material so long as you give appropriate credit to the Project Pythia community.

To cite this project, please site our [NSF GEO OSE proposal](https://zenodo.org/record/8184298). Individual components of the project may be cited separately.

> Rose, Brian E. J., Clyne, John, May, Ryan, Munroe, James, Snyder, Amelia, Eroglu, Orhan, & Tyle, Kevin. (2023). Collaborative Research: GEO OSE TRACK 2: Project Pythia and            Pangeo: Building an inclusive geoscience community through accessible, reusable, and reproducible workflows. Zenodo. https://doi.org/10.5281/zenodo.8184298

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8184298.svg)](https://doi.org/10.5281/zenodo.8184298)


```{toctree}
---
hidden: True
maxdepth: 1
---
about.md
contributing.md
code_of_conduct.md
cookbook-gallery.md
resource-gallery.md
metrics.md
```