Project Pythia Portal Overview

ProjectPythia
pangeo
Published in
5 min readSep 28, 2021
Project Pythia Logo
Project Pythia Logo

Last year, the Project Pythia team was formed (thanks to funding from NSF/EarthCube) to “provide a public, web-accessible training resource that will help educate current, and aspiring, earth scientists to more effectively use both the Scientific Python Ecosystem and Cloud Computing to make sense of huge volumes of numerical scientific data.”

The team is formally a collaboration between three main organizations, although contributors come from throughout the scientific Python community, inspired by the Pangeo community:

Project Pythia organizational partners

In early June 2021, the Project Pythia Team presented progress on the project at the Earthcube Annual Meeting, the major milestones being the development of the Foundations Book and the Resource Gallery.

Navigating the Portal

The main landing page for Project Pythia is known as the “Pythia Portal”.

A screenshot of the Project Pythia Portal — the main landing page

The main page provides an overview of the project, including the motivation and a summary of what the goals of this project are. The main tabs here are the:

  • Project overview: the big block of text you see in the image above describing the overall project vision and goals
  • Start learning: links to the main learning resources, including the Foundations Book and Resource Gallery
  • Join us : how to get involved with the project as a contributor and user
  • Team: list of the current team members
  • About: a more detailed description of project goals, future directions for content, and links to relevant presentations

Foundations Book

The Foundations Book is one of the major milestones that the Project Pythia team has accomplished thus far. This is the place to go if you are looking for content related to foundational Python for the Geosciences.

Clicking on the link on the Pythia Portal will take you to the JupyterBook containing the instructional material — this can also be accessed using foundations.projectpythia.org.

Where to find the Foundations Book on the Project Pythia Portal

Once within the Foundations Book, you will see the typical Jupyterbook interface with a few primary sections, outlined below:

Anatomy of the Project Pythia Foundations Book

Each notebook is its own “page”, separated into sections outlined in the table of contents which can be found along the left sidebar. On the right side of the page is the table of contents for a single notebook, which is determined using the header information in each notebook. This can be useful when wanting to navigate to specific section of a notebook.

These notebooks are executable — which is what makes this Jupyterbook interface so useful! If you select the space ship button near the top of the page, the notebook will open up on binder which enables you to interactively run the Jupyter Notebook on the cloud.

If you would like to download a local copy of the notebook, select the download button in the top right corner, and select whether to download as a PDF or ipynb (notebook).

An example notebook within the book is provided below:

Example Introduction to Pandas Notebook

Within the foundational content notebooks, you will find that each notebook follows the same format, including the following sections:

  • Overview — a brief overview of what is covered in that notebook
  • Prerequisites — what material is required before diving into the content
  • Desired experience level — the difficulty level of the notebook
  • Time to learn — estimated time to complete notebook
  • The actual content — which often includes imports, and several headings (ex. The Pandas Dataframe)
  • Summary — main takeaways from the notebook
  • What’s next — what is covered in additional notebooks in that section
  • Resources and references — data references, where to find more resources

Resource Gallery

The Resource Gallery includes links to a variety of external (to Project Pythia) material that is useful to the Geoscience community! This is a great place to go if you are looking for additional training or reference materials or more specific examples or galleries.

If you continue scrolling down the page, you will find various ways to engage with the project, including via Github Discussions or by checking to the resource gallery or foundations book, using the contributor’s guide as a reference.

Contributing to this Project

If you continue scrolling down the main portal, you will find various ways to engage with the project, including via Github Discussions or by checking to the resource gallery or foundations book, using the contributor’s guide as a reference.

Join us section of the Pythia Portal — find links to contributors resources

If you are interested in being involved with this project, I encourage you to check out our weekly meetings, separated by working groups, which include an Education Working Group, an Infrastructure Working Group, and an Outreach Working group.

We are also active on our Github Discussions Board, where you can find discussion threads related to our project.

Here is a link to the calendar shown below.

Calendar displayed on the Project Pythia Portal

Conclusions

We look forward to continuing to make progress on this project, and gather input from the community on how to improve our content, and entrain other contributors.

Continue to check back at this blog for additional updates to new content and project milestones. Also, be sure to follow us on Twitter!

--

--

ProjectPythia
pangeo
Writer for

A community educational resource for the Python Geoscience Software and Data Ecosystem. Inspired by Pangeo. Funded by EarthCube/NSF.