|
Download README.md from Civimatica/blue-marble-ships: direct link, hf CLI and curl.
- Browser
- Download file 6.02 kB
-
https://huggingface.co/Civimatica/blue-marble-ships/resolve/main/README.md
- Command line
-
hf download hf://Civimatica/blue-marble-ships/README.md
-
curl -L -o README.md https://huggingface.co/Civimatica/blue-marble-ships/resolve/main/README.md
6.02 kB
| license: apache-2.0 | |
| library_name: onnx | |
| pipeline_tag: object-detection | |
| tags: [earth-observation, remote-sensing, sentinel-2, satellite, edge-ai, onnx, int8, ships] | |
| <div align="center"> | |
| # Blue Marble Ships | |
| <img alt="License" src="https://img.shields.io/badge/License-Apache_2.0-2a78d6"/> <img alt="Sizes" src="https://img.shields.io/badge/Sizes-pico_路_nano_路_tiny_路_small_路_medium-2a78d6"/> <img alt="Device" src="https://img.shields.io/badge/Profiled_on-Arduino_VENTUNO_Q_NPU-2a78d6"/> <img alt="Params" src="https://img.shields.io/badge/All_models-under_15M_params-2a78d6"/> | |
| </div> | |
| ## Introduction | |
| Blue Marble Ships is a family of five ship detection models for Sentinel-2 imagery, from 32k to 13.5M parameters. Every model is under 15M parameters and runs fully in int8 on the Qualcomm Dragonwing QCS8275 NPU (Arduino VENTUNO Q). | |
| <p align="center"><img src="assets/benchmark.png" width="95%"></p> | |
| ## Highlights | |
| - **86.6 AP** on our Sentinel-2 vessel test split (tiles unseen in training), **82.4 AP** on April 2026 scenes; ship length mean absolute error 17 m (medium). | |
| - **81.2 AP at 32k parameters**; ship position and length in one pass. | |
| - **3.6 ms** per 256x256 tile (medium) on the Arduino VENTUNO Q NPU, int8, every layer on the NPU. | |
| ## Model Downloads | |
| | Model | Params | int8 size | VENTUNO Q latency | Ops on NPU | Ships test (ours): fp32 / int8 | Download | | |
| |:---|---:|---:|---:|:---:|:---:|:---| | |
| | Blue-Marble-Ships-pico | 0.032M | 0.14 MB | 1.0 ms | 62/62 | 81.2 / 78.7 | [`pico/`](./pico) | | |
| | Blue-Marble-Ships-nano | 0.19M | 0.36 MB | 1.0 ms | 76/76 | 84.3 / 81.6 | [`nano/`](./nano) | | |
| | Blue-Marble-Ships-tiny | 1.26M | 1.62 MB | 1.3 ms | 117/117 | 82.7 / 82.0 | [`tiny/`](./tiny) | | |
| | Blue-Marble-Ships-small | 2.4M | 2.86 MB | 1.5 ms | 130/130 | 80.8 / 78.3 | [`small/`](./small) | | |
| | Blue-Marble-Ships-medium | 13.5M | 14.58 MB | 3.6 ms | 224/224 | 86.6 / 86.2 | [`medium/`](./medium) | | |
| Each size folder contains: | |
| | File | Use | | |
| |:---|:---| | |
| | `model_qcs8275.dlc` | Compiled for the Qualcomm QCS8275 NPU (QNN runtime): runs as-is on the Arduino VENTUNO Q | | |
| | `model_int8.onnx` | int8 ONNX, the source of the compiled model; ONNX Runtime or your own NPU toolchain | | |
| | `model_fp32.onnx` | Full precision ONNX (CPU / GPU); the scores below are for this model | | |
| | `model.safetensors` + `config.json` | PyTorch weights for fine-tuning, with `models.py` in this repository | | |
| | `ventuno_q_profile.json` | On-device profile on the Arduino VENTUNO Q (Qualcomm AI Hub): the compute unit of every op, total latency, memory, load times | | |
| Scores in this table are for the exact files in this repository, re-scored on our held-out ships test split (332 ships). Latency and ops on NPU: on-device profile of `model_qcs8275.dlc` on an Arduino VENTUNO Q (Qualcomm AI Hub). | |
| ## Evaluation Results | |
| ### Models under 15M parameters | |
| | Model | Params | Ships test (ours) (AP) | Ships Apr-2026 (ours) (AP) | | |
| |:---|---:|---:|---:| | |
| | **Blue Marble pico** | 0.032M | 81.2 | 81.7 卤 0.6 | | |
| | **Blue Marble nano** | 0.19M | 84.3 | 80.1 卤 0.5 | | |
| | **Blue Marble tiny** | 1.26M | 82.7 | 80.7 卤 0.7 | | |
| | **Blue Marble small** | 2.4M | 80.8 | 82.2 卤 0.5 | | |
| | **Blue Marble medium** | 13.5M | **86.6** | **82.4 卤 0.8** | | |
| Blue Marble, test: the released checkpoint in this repository; Apr-2026: mean 卤 std over 3 training runs. Both are our own splits, not public leaderboards. Other models: published numbers, with inputs noted where they differ from ours (our models use Sentinel-2 only); * = trained and evaluated by us on the same data and split (parameter count includes our decoder). Best per column among models under 15M in bold. Labels: Global Fishing Watch Sentinel-2 vessel detections (AIS-matched, plus high-confidence detections without AIS); ambiguous detections are ignored. Test (332 ships) and Apr-2026 (April 2026 scenes) use tiles not seen in training. Ship length error: mean absolute error of the predicted length for matched ships. AP: detections are local maxima of the heatmap, a detection is correct if its centre is within 50 m of an unmatched label, all-point interpolated average precision. | |
| <p align="center"><img src="assets/radar.png" width="62%"></p> | |
| <p align="center"><img src="assets/size_vs_accuracy.png" width="70%"></p> | |
| <p align="center"><img src="assets/latency.png" width="70%"></p> | |
| ## Quickstart | |
| ```python | |
| import numpy as np, onnxruntime as ort | |
| MEAN = np.array([2357.089, 2137.385, 2018.788, 2082.986, 2295.651, 2854.537, 3122.849, 3040.560, 3306.481, 1473.847, 506.070, 2472.825, 1838.929], np.float32)[:, None, None] | |
| STD = np.array([1624.683, 1675.806, 1557.708, 1833.702, 1823.738, 1733.977, 1732.131, 1679.732, 1727.26, 1024.687, 442.165, 1331.411, 1160.419], np.float32)[:, None, None] | |
| def prepare(dn): # dn: Sentinel-2 L1C digital numbers, [13, H, W], H and W multiples of 16 | |
| dn = np.clip(dn - 1000, 0, None) # only for products from 2022 on (processing baseline 04.00+) | |
| return ((dn - MEAN) / STD)[None].astype(np.float32) | |
| sess = ort.InferenceSession("tiny/model_int8.onnx") | |
| out = sess.run(None, {"image": prepare(dn)})[0] | |
| ``` | |
| PyTorch: | |
| ```python | |
| import json, torch | |
| from safetensors.torch import load_file | |
| from models import BlueMarble # models.py from this repository | |
| cfg = json.load(open("tiny/config.json")) | |
| model = BlueMarble(cfg["arch"], cfg["num_classes"]).eval() | |
| model.load_state_dict(load_file("tiny/model.safetensors")) | |
| ``` | |
| - **Input:** 13 Sentinel-2 L1C bands, B01 to B12 including B8A and B10. Missing bands (other sensors): set to 0 after normalisation. | |
| - **Output:** `[1, 2, H, W]`: channel 0 ship-centre heatmap logit (sigmoid; 5x5 local maxima above 0.3 are ships), channel 1 log ship length (`length_m = exp(v) * 10`). | |
| ## License | |
| Apache-2.0. Contains modified Copernicus Sentinel data. | |
| ## Citation | |
| ```bibtex | |
| @misc{bluemarble2026, | |
| title = {Blue Marble: Edge Earth Observation Models}, | |
| author = {Harsh Kumar}, | |
| year = {2026}, | |
| url = {https://huggingface.co/Civimatica} | |
| } | |
| ``` | |