Skip to content

Add infographic #510

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions core/overview.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Overview

![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)

You've made it to the **Core Packages** section of the book!

As you might know by now that Python is a programming language. To make your job easier, developers of this programming language provide users like you with libraries (or packages). Core libraries will help you with fundamental numerical functions, and high-level libraries will help you efficiently analyze and visualize your data. Some of these libraries are used all across the Python community, while others are domain-specific. Read below to learn more about core and high-level libraries, and domain-specific libraries of the geoscience community. We suggest that new users start with the [Foundational Skills](../foundations/overview) section in order to get the most out of the tutorials below.

## Core libraries
Expand Down Expand Up @@ -105,11 +109,9 @@ Similarly, a group at the Atmospheric Radiation Measurement (ARM) Climate Resear
have released their Python ARM Radar Toolkit ([Py-ART](http://arm-doe.github.io/pyart/))
for analysing weather radar data.

There are too many domain specific libraries to mention here,
but online resources such as the
[Python for Atmosphere and Ocean Science (PyAOS) package index](https://pyaos.github.io/packages/)
attempt to keep track of the domain-specific libraries in their field.
Also check out the [Pythia Resource Gallery](https://projectpythia.org/resource-gallery.html) and try filtering by domain.
A great place to start learning about use-cases for domain-specific libraries across the geosciences is the [Pythia Cookbook Gallery](https://cookbooks.projectpythia.org). Also check out the [Pythia Resource Gallery](https://projectpythia.org/resource-gallery.html) and try filtering by domain. The [Python for Atmosphere and Ocean Science (PyAOS) package index](https://pyaos.github.io/packages/)
attempt to keep track of the domain-specific libraries in these subfiels.


## Tutorials

Expand Down
2 changes: 1 addition & 1 deletion foundations/github/basic-git.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ That's the first thing to understand. GitHub is a web-based platform for hosting

Git has been around [since the mid-2000s](https://en.wikipedia.org/wiki/Git). It was originally written by Linus Torvalds specifically for use in development of the Linux kernel. Git is [FOSS](https://foundations.projectpythia.org/foundations/github/what-is-github.html#free-and-open-source-software-foss) and comes pre-installed on many Linux and Mac OS systems.

There are many other VCSs out there. A few that you might encounter in scientific codebases include [Subversion](https://subversion.apache.org), [Mercurial](https://www.mercurial-scm.org), and [CVS](http://cvs.nongnu.org). However, git is overwhelmingly the VCS of choice for open-source projects in the Scientific Python ecosystem these days (as well as among software developers more generally).
There are many other VCSs out there. A few that you might encounter in scientific codebases include [Subversion](https://subversion.apache.org), [Mercurial](https://www.mercurial-scm.org), and [CVS](https://en.wikipedia.org/wiki/Concurrent_Versions_System). However, git is overwhelmingly the VCS of choice for open-source projects in the Scientific Python ecosystem these days (as well as among software developers more generally).

There is no universally agreed-upon meaning of the name "git". From the [git project's own README file](https://github.com/git/git/blob/master/README.md):

Expand Down
6 changes: 4 additions & 2 deletions foundations/overview.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
# Overview

This section contains cross-referenced tutorial material for foundational computing skills that one needs in order to work effectively with the open-source Scientific Python stack.
![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)

Familiarizing yourself with these topics first will allow a new user to get the most out the Python-specific material in the [Core Scientific Python Packages](../core/overview) section of the book!
This **Foundational Skills** section of the book contains cross-referenced tutorial material for computing skills that one needs in order to work effectively with the open-source Scientific Python stack.

Familiarizing yourself with these topics first will allow you to get the most out the Python-specific material in the [Core Scientific Python Packages](../core/overview) section of the book!

## Topics

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 8 additions & 3 deletions preamble/how-to-use.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
# How to Use This Book

## Preamble
![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)

Pythia Foundations is intended to educate the reader on the essentials
for using the Scientific Python Ecosystem (SPE): a collection of
## Overview

Pythia Foundations is a geoscience-flavored introduction to essential tools in the Scientific Python Ecosystem (SPE) and [Pangeo](https://pangeo.io) stack. It covers the foundational knowledge that's needed to get started with Python in the computational geosciences, as well as to become an effective citizen-practitioner in key open geoscience software ecosystems. The intended audience is anyone from undergraduate students through established geoscientists who are relatively new to working in Python. The tutorials in this book also serve as references and prerequisites for the more advanced and domain-specific content in the [Pythia Cookbook Gallery](https://cookbooks.projectpythia.org).

## What's included

The Scientific Python Ecosystem (SPE) is a collection of
open source Python packages that support analysis, manipulation,
and visualization of scientific data. While Project Pythia is focused
on the geoscience communities, the material contained in Pythia
Expand Down
Loading