Skip to content
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
19 changes: 11 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,24 @@

## Manifesto

- I don't like the [Nearshore Wave Prediction System (NWPS) model viewer](https://polar.ncep.noaa.gov/nwps/nwpsloop.php?site=MTR&loop=sigwaveheight&cg=3)
because you have to click through the frames and it is difficult to get a numerical value for the wave height.
- I don't like [Windy](https://www.windy.com/36.616/-121.889/gfsWaves/waves?gfs,36.515,-121.898,11) because the forecasts don't make much sense
between dive sites; why is a 6 ft swell at Breakwater no big deal, but a 6 ft swell at Monastery un-divable?!
- The [Nearshore Wave Prediction System (NWPS) model](https://polar.ncep.noaa.gov/nwps/nwpsloop.php?site=MTR&loop=sigwaveheight&cg=3)
has high-resolution data and is quite accurate because it uses a sophisticated nearshore wave model.
However, I don't like the user interface; you have to click through individual frames and it is difficult to get numerical values.
- [Windy](https://www.windy.com/36.616/-121.889/gfsWaves/waves?gfs,36.515,-121.898,11) has a great user interface that also displays wind, tides, etc.
However, the data doesn't feel very accurate since forecasts don't make much sense between dive sites; why is a 6 ft swell at Breakwater no big deal, but a 6 ft swell at Monastery un-divable?!

**The goal of this project is to combine the accuracy of NWPS with the user interface of Windy.**

## Summary

The wave and swell forecast data for [NWPS](https://polar.ncep.noaa.gov/nwps/) is obtained from https://nomads.ncep.noaa.gov/.
The map visuals were kept largely intact, with the major modifications being zooming into the Monterey peninsula, and adding a slider to scrub through time.
A graph was added to plot the wave height over time for two dive sites, Breakwater (San Carlos beach) and Monastery beach.
Similar to Windy's user interface, this can be useful for tracking how conditions for a particular site develop over time.
A graph was added to plot the wave height over time for two dive sites, [Breakwater (San Carlos beach)](https://maps.app.goo.gl/wHzyiZY1mi4THkto8) and [Monastery beach](https://maps.app.goo.gl/nZdXUZvYriEUVF8z9).
Similar to Windy's user interface, this is useful for tracking how conditions for a particular site develop over time.

We use [basemap-data-hires](https://matplotlib.org/basemap/stable/) to render the coastline map.
The website updates twice a day, when data for new NWPS runs are available.

We use [basemap](https://matplotlib.org/basemap/stable/) to render the coastline map.

## Local Development

Expand All @@ -32,7 +35,7 @@ uv sync
To generate the webpage,

```
uv run main.py
uv run -m wavey
```

This will create a directory "_site/" which contains the webpage.
13 changes: 12 additions & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,8 +1,19 @@
[project]
name = "wavey"
version = "0.1.0"
description = "Add your description here"
authors = [
{name = "Kevin Chen"},
]
description = "Visualizing nearshore wave forecasts for Monterey scuba diving"
readme = "README.md"
license = "MIT"
classifiers = [
"Development Status :: 3 - Alpha",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.13",
"Programming Language :: Python :: 3.14",
]
requires-python = ">=3.12"
dependencies = [
"basemap",
Expand Down