Skip to content

Commit 3d97326

Browse files
Finish the time-to-learn improvements (#649)
* Consistent time-to-learn style * more time to learn * Cumulative time to learn * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --------- Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
1 parent 4f9f124 commit 3d97326

42 files changed

Lines changed: 187 additions & 76 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

appendix/template.ipynb

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,11 +66,14 @@
6666
"| [Understanding of NetCDF](https://foundations.projectpythia.org/core/data-formats/netcdf-cf) | Helpful | Familiarity with metadata structure |\n",
6767
"| Project management | Helpful | |\n",
6868
"\n",
69-
"- **Time to learn**: estimate in minutes. For a rough idea, use 5 mins per subsection, 10 if longer; add these up for a total. Safer to round up and overestimate.\n",
7069
"- **System requirements**:\n",
7170
" - Populate with any system, version, or non-Python software requirements if necessary\n",
7271
" - Otherwise use the concepts table above and the Imports section below to describe required packages as necessary\n",
73-
" - If no extra requirements, remove the **System requirements** point altogether"
72+
" - If no extra requirements, remove the **System requirements** point altogether\n",
73+
"\n",
74+
":::{tip icon=false} ⏱️ Time to learn\n",
75+
"Estimate in minutes. For a rough idea, use 5 mins per subsection, 10 if longer; add these up for a total. Safer to round up and overestimate.\n",
76+
":::"
7477
]
7578
},
7679
{

core/cartopy.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,7 @@ From the [Cartopy website](https://cartopy.readthedocs.io):
1818
Before working through the Cartopy notebooks in this section of Pythia Foundations, you should first have a basic knowledge of [Matplotlib](matplotlib.md).
1919

2020
In addition, please note that the geographic-features library used by Cartopy makes use of shapefiles directly served by [Natural Earth](https://www.naturalearthdata.com/).
21+
22+
:::{note icon=false} ⏱️ Time to learn (cumulative)
23+
40 minutes
24+
:::

core/cartopy/cartopy.ipynb

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,9 @@
88
"source": [
99
"# Introduction to Cartopy\n",
1010
"\n",
11-
"```{image} ../../images/cartopy_logo.png\n:width: 600\n```"
11+
"```{image} ../../images/cartopy_logo.png\n",
12+
":width: 600\n",
13+
"```"
1214
]
1315
},
1416
{
@@ -45,7 +47,9 @@
4547
"| ------------------------------ | ---------- | --------------------- |\n",
4648
"| [Matplotlib](../matplotlib.md) | Necessary | {cite:t}`Hunter:2007` |\n",
4749
"\n",
48-
"- **Time to learn**: 30 minutes"
50+
":::{tip icon=false} ⏱️ Time to learn\n",
51+
"30 minutes\n",
52+
":::"
4953
]
5054
},
5155
{

core/data-formats.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
11
# Data Formats
22

33
Geoscientific data are commonly stored in self-describing files that are readable on multiple computing platforms and programming languages (including Python). This section contains a tutorial on the widely-used netCDF data format.
4+
5+
:::{note icon=false} ⏱️ Time to learn (cumulative)
6+
1 hour
7+
:::

core/data-formats/netcdf-cf.ipynb

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,9 @@
3535
"| [Numpy Basics](../numpy/numpy-basics) | Necessary | |\n",
3636
"| [Datetime](../datetime.md) | Necessary | |\n",
3737
"\n",
38-
"- **Time to learn**: 50 minutes"
38+
":::{tip icon=false} ⏱️ Time to learn\n",
39+
"50 minutes\n",
40+
":::"
3941
]
4042
},
4143
{

core/datetime.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,7 @@ Other time libraries used in the geosciences include:
88
- [cftime library](https://unidata.github.io/cftime/) (for dealing with dates and times in non-standard calendars)
99

1010
The Python packages that are commonly used for timeseries data in the geosciences such as [Pandas](pandas.md) and [Xarray](xarray.md) leverage these libraries.
11+
12+
:::{note icon=false} ⏱️ Time to learn (cumulative)
13+
40 minutes
14+
:::

core/datetime/datetime.ipynb

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,9 @@
4848
"| [Python Quickstart](../../foundations/quickstart) | Necessary | Understanding strings |\n",
4949
"| Basic Python string formatting | Helpful | Try this [Real Python string formatting tutorial](https://realpython.com/python-string-formatting/) |\n",
5050
"\n",
51-
"- **Time to learn**: 30 minutes"
51+
":::{tip icon=false} ⏱️ Time to learn\n",
52+
"30 minutes\n",
53+
":::"
5254
]
5355
},
5456
{

core/matplotlib.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,3 +27,7 @@ Currently, Pythia Foundations provides a basic introduction to Matplotlib, as we
2727
- [Colormaps](#colormap-overview)
2828
- [Contour plots](#contour-and-filled-contour-plots)
2929
- [Customizing layouts](#mosaic-subplots)
30+
31+
:::{note icon=false} ⏱️ Time to learn (cumulative)
32+
2 hours
33+
:::

core/matplotlib/annotations-colorbars-layouts.ipynb

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,9 @@
3636
"| [NumPy Basics](../numpy/numpy-basics) | Necessary | {cite:t}`harris2020array` |\n",
3737
"| [Matplotlib Basics](matplotlib-basics) | Necessary | {cite:t}`Hunter:2007` |\n",
3838
"\n",
39-
"- **Time to learn**: *30-40 minutes*"
39+
":::{tip icon=false} ⏱️ Time to learn\n",
40+
"30-40 minutes\n",
41+
":::"
4042
]
4143
},
4244
{

core/matplotlib/histograms-piecharts-animation.ipynb

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,9 @@
3636
"| [NumPy Basics](../numpy/numpy-basics) | Necessary | {cite:t}`harris2020array` |\n",
3737
"| [Matplotlib Basics](matplotlib-basics) | Necessary | {cite:t}`Hunter:2007` |\n",
3838
"\n",
39-
"* **Time to Learn**: 30 minutes"
39+
":::{tip icon=false} ⏱️ Time to learn\n",
40+
"30 minutes\n",
41+
":::"
4042
]
4143
},
4244
{

0 commit comments

Comments
 (0)