Downloads · 30 days
0
surfe-diem/surfe-diem-wave-forecast-v1-usa-southwest
surfe-diem-wave-forecast-v1-usa-southwest is a machine learning model from surfe-diem. Use it for the machine learning task on the model card, and read the license before you ship it in a product. It is set up for lightgbm. The card lists the license as mit.
A LightGBM regression model trained to predict ocean wave heights 6 hours in advance using real-time buoy observations from NOAA's National Data Buoy Center (NDBC).
Downloads · 30 days
0
Access
Public
Updated Apr 21, 2026
Repo size
—
Likes
0
Public
Click a slice to open those files.
.txt765 KB · 99%
From the Hugging Face model README
A LightGBM regression model trained to predict ocean wave heights 6 hours in advance using real-time buoy observations from NOAA's National Data Buoy Center (NDBC).
Developed by: Surfe Diem
Model type: Gradient Boosted Decision Trees (LightGBM)
Language: Python
License: MIT
Provide 6-hour wave height forecasts for surf forecasting applications along the California coast (USA Southwest Pacific region as defined by https://www.ndbc.noaa.gov/)
Source: NOAA NDBC Buoy Spectral Wave Density Data
Stations: 15 NDBC buoys along the California coast "46011", "46012", "46013", "46014", "46022", "46025", "46026", "46027", "46028", "46042", "46047", "46053", "46054", "46069", "46086"
Records: ~1.8M observations (226 Parquet files w/ stdmet and spectral aligned columns)
Features:
Split: 80/20 train/test, time-series ordered (no shuffle)
Test MAE: 0.19 meters (~7.5 inches)
Evaluated on held-out 2024 data with proper time-series validation (train on past, test on future).
Algorithm: LightGBM
Objective: Regression (L2 loss)
Learning rate: 0.05
Max depth: 5
Num iterations: 170
Early stopping: 10 rounds
Feature engineering:
import lightgbm as lgb
import pandas as pd
# Load model
model = lgb.Booster(model_file="surfe_diem_v1_usa_southwest_model.txt")
# Prepare observation (example)
obs = pd.DataFrame({
'wvht': [2.5], 'dpd': [12.0], 'apd': [8.5],
'mwd': [270], 'wspd': [15.0], 'wdir': [280],
'pres': [1013.0], 'atmp': [18.0], 'wtmp': [16.0],
# ... + spectral features + lag features + station_id
})
# Predict
wave_height_6h = model.predict(obs)[0]
Full inference pipeline available in GitHub repo.
@misc{surfediem2025wave,
author = {Surfe Diem},
title = {Wave Height Forecasting Model v1 - USA Southwest},
year = {2025},
publisher = {Hugging Face},
howpublished = {\url{https://huggingface.co/datasets/surfe-diem/wave-archive-USA-southwest}}
}
For questions or issues, please open an issue in the GitHub repository.