https://github.com/nickc1/seebuoy
Easily pull data from the National Data Buoy Center.
https://github.com/nickc1/seebuoy
buoy ndbc ndbc-buoy-data noaa science
Last synced: 2 months ago
JSON representation
Easily pull data from the National Data Buoy Center.
- Host: GitHub
- URL: https://github.com/nickc1/seebuoy
- Owner: nickc1
- License: mit
- Created: 2019-02-17T13:45:26.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-07-25T21:01:15.000Z (almost 3 years ago)
- Last Synced: 2025-09-21T20:21:51.292Z (9 months ago)
- Topics: buoy, ndbc, ndbc-buoy-data, noaa, science
- Language: Python
- Homepage: https://seebuoy.com
- Size: 1.38 MB
- Stars: 28
- Watchers: 4
- Forks: 7
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
Awesome Lists containing this project
README
#
Easily access real time and historical data from the National Data Buoy Center.
---
seebuoy provides an easy to use python interface to the [National Data Buoy Center](http://www.ndbc.noaa.gov). Easily access realtime data, historical data, and metadata about buoys, gliders, and ADCPs.
## Quick Start
```python
from seebuoy import NDBC
ndbc = NDBC()
# Information on NDBC's ~1800 buoys and gliders
df_buoys = ndbc.stations()
# list all available data for all buoys
df_data = ndbc.available_data()
# get all data for a buoy
station_id = "41037"
df_buoy = ndbc.get_station(station_id)
```
See the [documentation](https://seebuoy.com/ndbc) for more detailed description.
## Examples
In addition to this documentation, we also provide standalone jupyter notebooks. You can see them rendered on github:
- [North Carolina Stations](https://github.com/nickc1/seebuoy/blob/master/examples/north_carolina_stations.ipynb): Find all buoys near North Carolina, list all available data, and pull data for a specific buoy.
- [Historical Data](https://github.com/nickc1/seebuoy/blob/master/examples/historical_data.ipynb): Get all historical data for the South Hatteras buoy going back to 1973.
## Installation
```
pip install seebuoy
```
## Other Resources
- [The Distributed Oceanographic Data Systems](https://dods.ndbc.noaa.gov)
- [Measurement Descriptions](https://www.ndbc.noaa.gov/measdes.shtml)
- [NDBC File Directory](https://www.ndbc.noaa.gov/data/)