Metadata-Version: 2.1
Name: seebuoy
Version: 0.2.1
Summary: Remote data access for oceanographic data.
Author: nickc1
Author-email: nickcortale@gmail.com
Requires-Python: >=3.9.11,<4.0.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: beautifulsoup4 (>=4.9.3,<5.0.0)
Requires-Dist: lxml (>=4.9.1,<5.0.0)
Requires-Dist: pandas (>=1.1.2,<2.0.0)
Requires-Dist: requests (>=2.24.0,<3.0.0)
Requires-Dist: scikit-learn (>=1.1.3,<2.0.0)
Description-Content-Type: text/markdown

# 
<p align="center">
  <a href="#"><img src="https://raw.githubusercontent.com/nickc1/seebuoy/master/docs/img/seebuoy_logo_text.png" alt="seebuoy"></a>
</p>
<p align="center">
<em>Easily access real time and historical data from the <a href="http://www.ndbc.noaa.gov">National Data Buoy Center</a>.</em>

<p align="center">
<em> <a href="https://www.seebuoy.com">DOCUMENTATION</a>.</em>

</p>

---

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/)



