Skip to content

Commit c4ba5ae

Browse files
authored
Merge f431ed9 into fa360b4
2 parents fa360b4 + f431ed9 commit c4ba5ae

File tree

5 files changed

+20
-11
lines changed

5 files changed

+20
-11
lines changed

core/overview.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
# Overview
22

3+
![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)
4+
5+
You've made it to the **Core Packages** section of the book!
6+
37
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.
48

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

108-
There are too many domain specific libraries to mention here,
109-
but online resources such as the
110-
[Python for Atmosphere and Ocean Science (PyAOS) package index](https://pyaos.github.io/packages/)
111-
attempt to keep track of the domain-specific libraries in their field.
112-
Also check out the [Pythia Resource Gallery](https://projectpythia.org/resource-gallery.html) and try filtering by domain.
112+
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/)
113+
attempt to keep track of the domain-specific libraries in these subfiels.
114+
113115

114116
## Tutorials
115117

foundations/github/basic-git.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ That's the first thing to understand. GitHub is a web-based platform for hosting
5656

5757
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.
5858

59-
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).
59+
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).
6060

6161
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):
6262

foundations/overview.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
# Overview
22

3-
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.
3+
![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)
44

5-
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!
5+
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.
6+
7+
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!
68

79
## Topics
810

Loading

preamble/how-to-use.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
11
# How to Use This Book
22

3-
## Preamble
3+
![Foundations Infographic](../images/ProjectPythia_Foundations_Infographic_v4.jpg)
44

5-
Pythia Foundations is intended to educate the reader on the essentials
6-
for using the Scientific Python Ecosystem (SPE): a collection of
5+
## Overview
6+
7+
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).
8+
9+
## What's included
10+
11+
The Scientific Python Ecosystem (SPE) is a collection of
712
open source Python packages that support analysis, manipulation,
813
and visualization of scientific data. While Project Pythia is focused
914
on the geoscience communities, the material contained in Pythia

0 commit comments

Comments
 (0)