Skip to content

Commit

Permalink
update toc
Browse files Browse the repository at this point in the history
  • Loading branch information
cyschneck committed Oct 2, 2024
1 parent b08165c commit 208feb0
Show file tree
Hide file tree
Showing 7 changed files with 52 additions and 44 deletions.
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ Where available, this cookbook will demonstrate how to determine the features of

- "Great Circle Terminology": Breakdown of terminology important for working with and understanding great circles including WGS-84
- "Coordinate Systems": Understanding and converted to different types of coordinate systems like Cartesian, Spherical, Polar, and Geodesic (Latitude/Longitude)
- "Geodesic and Python": General overview of powerful open-source Python packages for working with geodesic data like `pyproj` and `geopy`

Each section will make use of plotting to visually demonstrate concepts with `matplotlib` and `cartopy`

Expand Down
2 changes: 2 additions & 0 deletions _toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,3 +14,5 @@ parts:
- file: notebooks/tutorials/arc_to_point
- file: notebooks/tutorials/parallels_max_min
- file: notebooks/tutorials/path_intersection
- file: notebooks/tutorials/angles
- file: notebooks/tutorials/polygon_area
38 changes: 34 additions & 4 deletions notebooks/foundations/coordinates.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@
"\n",
"> A geographic coordinate system (GCS) is a spherical or geodetic coordinate system for measuring and communicating positions directly on Earth as latitude and longitude [(Wikipedia)](https://en.wikipedia.org/wiki/Geographic_coordinate_system)\n",
"\n",
"Geodesic coordiantes are latitude and longtiude, from -90° South to 90° North and -180° East to 180° West measured from Greenwich\n",
"\n",
"<p align=\"center\">\n",
" <img src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/e/ef/FedStats_Lat_long.svg/1024px-FedStats_Lat_long.svg.png\" alt=\"Longitude lines are perpendicular to and latitude lines are parallel to the Equator from Wikipedia\" width=400 />\n",
Expand All @@ -110,6 +111,12 @@
"\n",
"Cartesian coordinates describe points in space based on perpendicular axis lines that meet at a singlle point of origin, where any point's position is described based on the distance to the origin along xyz axis\n",
"\n",
"<p align=\"center\">\n",
" <img src=\"https://upload.wikimedia.org/wikipedia/commons/thumb/6/69/Coord_system_CA_0.svg/1024px-Coord_system_CA_0.svg.png\" alt=\"A three dimensional Cartesian coordinate system, with origin O and axis lines X, Y and Z, oriented as shown by the arrows. The tick marks on the axes are one length unit apart. The black dot shows the point with coordinates x = 2, y = 3, and z = 4, or (2, 3, 4) from Wikipedia\" width=400 />\n",
"</p>\n",
"\n",
"Image Source: [Three Dimensional Cartesian Coordiante System](https://en.wikipedia.org/wiki/Cartesian_coordinate_system#description)\n",
"\n",
"**Geodesic to Cartesian Coordinates**\n",
"\n",
"Assuming the earth's radius is 6378137 meters\n",
Expand Down Expand Up @@ -219,7 +226,9 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"### Display Coordinates of Cities"
"### Display Coordinates of Cities\n",
"\n",
"Read in latitude and longitude coordinates from locations"
]
},
{
Expand Down Expand Up @@ -408,7 +417,6 @@
}
],
"source": [
"# Read in location coordinates\n",
"import pandas as pd\n",
"\n",
"location_df = pd.read_csv(\"../location_coords.txt\")\n",
Expand Down Expand Up @@ -874,7 +882,18 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"### World Map"
"### World Map\n",
"\n",
"Full world map from -180-180 and -90-90:\n",
"```\n",
"longitude east = 180\n",
"\n",
"longitude west = -180\n",
"\n",
"latitude north = 90\n",
"\n",
"latitude south = -90\n",
"```"
]
},
{
Expand Down Expand Up @@ -917,7 +936,18 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"### United States Map"
"### United States Map\n",
"\n",
"Map of the United States roughly from -130 to -60 and 20 to 60:\n",
"```\n",
"longitude east = -60\n",
"\n",
"longitude west = -130\n",
"\n",
"latitude north = 60\n",
"\n",
"latitude south = 20\n",
"```"
]
},
{
Expand Down
11 changes: 8 additions & 3 deletions notebooks/foundations/terminology.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -127,9 +127,14 @@
"\n",
"> TODO: https://gis.stackexchange.com/questions/25494/how-accurate-is-approximating-earth-as-sphere\n",
"\n",
"To account for the error when assuming the Earth is a sphere, there are various geodetic systems and ellipsoids to include in calculations.\n",
"\n",
"### Geodesic and Python\n",
"To account for the error when assuming the Earth is a sphere, there are various geodetic systems and ellipsoids to include in calculations."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Geodesic and Python\n",
"\n",
"For the purpose of this notebook we will be taking advantage of two geodesic Python packages:\n",
"\n",
Expand Down
8 changes: 1 addition & 7 deletions notebooks/tutorials/angles.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's start here! If you can directly link to an image relevant to your notebook, such as [canonical logos](https://github.com/numpy/numpy/blob/main/doc/source/_static/numpylogo.svg), do so here at the top of your notebook. You can do this with Markdown syntax,\n",
"\n",
"> `![<image title>](http://link.com/to/image.png \"image alt text\")`\n",
"\n",
"or edit this cell to see raw HTML `img` demonstration. This is preferred if you need to shrink your embedded image. **Either way be sure to include `alt` text for any embedded images to make your content more accessible.**\n",
"\n",
"<img src=\"images/ProjectPythia_Logo_Final-01-Blue.svg\" width=250 alt=\"Project Pythia Logo\"></img>"
"<img src=\"https://www.scratchapixel.com/images/geometry/projectvec.gif?\" alt=\"Illustrating the projection of vector onto the xy plane, highlighting the adjustment of its length based on sin(delta)\"></img>"
]
},
{
Expand Down
8 changes: 1 addition & 7 deletions notebooks/tutorials/path_intersection.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"Let's start here! If you can directly link to an image relevant to your notebook, such as [canonical logos](https://github.com/numpy/numpy/blob/main/doc/source/_static/numpylogo.svg), do so here at the top of your notebook. You can do this with Markdown syntax,\n",
"\n",
"> `![<image title>](http://link.com/to/image.png \"image alt text\")`\n",
"\n",
"or edit this cell to see raw HTML `img` demonstration. This is preferred if you need to shrink your embedded image. **Either way be sure to include `alt` text for any embedded images to make your content more accessible.**\n",
"\n",
"<img src=\"images/ProjectPythia_Logo_Final-01-Blue.svg\" width=250 alt=\"Project Pythia Logo\"></img>"
"<img src=\"https://assets.weforum.org/editor/u0p_rm0X1NiSU4iew5pqT_c-ruHapJWPlXoLkS88ncQ.gif\" alt=\"24 hours of global air traffic – in just 4 seconds gif\"></img>"
]
},
{
Expand Down
28 changes: 6 additions & 22 deletions notebooks/tutorials/polygon_area.ipynb

Large diffs are not rendered by default.

0 comments on commit 208feb0

Please sign in to comment.