Skip to content

Commit ca2cc83

Browse files
authored
Chore: update README (#28)
* update readme * . * .
1 parent 542850b commit ca2cc83

File tree

1 file changed

+22
-12
lines changed

1 file changed

+22
-12
lines changed

README.md

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,24 +4,24 @@
44

55
## Manifesto
66

7-
- The [Nearshore Wave Prediction System (NWPS) model](https://polar.ncep.noaa.gov/nwps/nwpsloop.php?site=MTR&loop=sigwaveheight&cg=3)
8-
has high-resolution data and is quite accurate because it uses a sophisticated nearshore wave model.
7+
**The goal of this project is to combine the accuracy of NWPS with the user interface of Windy.**
8+
9+
- The [Nearshore Wave Prediction System (NWPS)](https://polar.ncep.noaa.gov/nwps/nwpsloop.php?site=MTR&loop=sigwaveheight&cg=3)
10+
has high-resolution data and is quite accurate because it uses a sophisticated forecasting model.
911
However, I don't like the user interface; you have to click through individual frames and it is difficult to get numerical values.
1012
- [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.
1113
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?!
1214

13-
**The goal of this project is to combine the accuracy of NWPS with the user interface of Windy.**
15+
## Data
1416

15-
## Summary
17+
- All wave and tide forecast data comes from [NWPS](https://nomads.ncep.noaa.gov/pub/data/nccf/com/nwps/prod/).
18+
We make a very similar map showing the wave height in color and wave direction with arrows.
19+
We also 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).
20+
This is more similar to Windy's user interface, and is useful for tracking how conditions for a particular site develop over time.
1621

17-
The wave and swell forecast data for [NWPS](https://polar.ncep.noaa.gov/nwps/) is obtained from https://nomads.ncep.noaa.gov/.
18-
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.
19-
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).
20-
Similar to Windy's user interface, this is useful for tracking how conditions for a particular site develop over time.
22+
- The website updates daily when data from new NWPS runs are available.
2123

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

2626
## Local Development
2727

@@ -30,12 +30,22 @@ This is a Python project, and the easiest way to get started is with [uv](https:
3030
```
3131
uv venv
3232
uv sync
33+
source .venv/bin/activate
3334
```
3435

3536
To generate the webpage,
3637

3738
```
38-
uv run -m wavey
39+
python -m wavey
3940
```
4041

4142
This will create a directory "_site/" which contains the webpage.
43+
44+
We use `mypy` to perform static type checking and `ruff` to perform linting and formatting.
45+
46+
```
47+
mypy .
48+
49+
ruff check .
50+
ruff format --check .
51+
```

0 commit comments

Comments
 (0)