Initial Cartopy work

.gitignore

@@ -135,3 +135,4 @@ content/pages/communications.md
 content/pages/contributing.md
 content/pages/code_of_conduct.md
 content/notebooks_gallery/
+.jupyter_cache/

_config.yml

@@ -5,10 +5,15 @@ title: Project Pythia Foundations
 author: The Project Pythia community
 logo: images/ProjectPythia_Logo_Final-01-Blue.png
 
-# Force re-execution of notebooks on each build.
-# See https://jupyterbook.org/content/execute.html
 execute:
-  execute_notebooks: force
+  # See https://jupyterbook.org/content/execute.html
+  execute_notebooks: cache
+  #   "auto" should only execute those notebooks that don't have output in all cells.
+  #   "force" : force execution of all notebooks
+  #   "cache": Cache output of notebooks on each build.
+  timeout: 600
+  # Do not abort notebook execution for errors, since they may be intentional.
+  allow_errors: True
 
 # Define the name of the latex output file for PDF builds
 latex:

_toc.yml

@@ -36,6 +36,8 @@
     - file: core/numpy
     - file: core/matplotlib
     - file: core/cartopy
+      sections:
+        - file: core/cartopy/01_Cartopy_Intro
     - file: core/datetime
     - file: core/pandas
     - file: core/data-formats

core/cartopy.md

@@ -4,4 +4,19 @@
 This content is under construction!
 ```
 
-This section will contain tutorials on plotting map with [cartopy](https://scitools.org.uk/cartopy/docs/latest/). It will be cross-referenced with tutorials on [xarray](xarray) and [matplotlib](matplotlib).
+This section contains tutorials on plotting maps with [cartopy](https://scitools.org.uk/cartopy/docs/latest/).
+It will be cross-referenced with tutorials on [xarray](xarray) and [matplotlib](matplotlib).
+
+---
+
+From the [Cartopy website](https://scitools.org.uk/cartopy/docs/latest):
+Cartopy is a Python package designed for geospatial data processing in order to
+produce maps and other geospatial data analyses.
+
+Cartopy makes use of the powerful PROJ.4, NumPy and Shapely libraries and includes a programmatic interface
+built on top of Matplotlib for the creation of publication quality maps.
+
+You should have a basic familiarity with Matplotlib prior to working through the Cartopy notebooks presented here.
+
+Key features of cartopy are its object-oriented [projection definitions](https://scitools.org.uk/cartopy/docs/latest/crs/projections.html#cartopy-projections),
+and its ability to transform points, lines, vectors, polygons and images between those projections.