Skip to main content

A fast, web-based NetCDF explorer for glider data.

Project description

Glider Playground

A fast, web-based NetCDF explorer for glider data. Load your .nc files and instantly explore, plot, and QC your data — no scripting required.

Live demo: glider-playground.co.uk (running on a Raspberry Pi — may be slow)

Glider Playground Home View


Install & Run

pip install glider-playground
glider-playground

This opens the app in your browser. Press Ctrl+C in the terminal to stop it.

Virtual environment recommended. If you use one, activate it before running.

Install from source
git clone https://github.com/Orlando-PB/glider-playground.git
cd glider-playground
pip install .

Loading Data

Click the file button (top-left) to open the file panel. From there you can:

  • Add files — pick individual .nc files
  • Add folder — load an entire folder of .nc files at once
  • Download demo data — grab two example files to try immediately

Files are processed in the background. Once ready, click one to load it.

Sample data is available from the BODC Deployment Catalogue.


Exploring Data

Plot

Pick your X, Y, and optionally a Colour variable from the dropbdowns. The plot updates automatically.

Use the View menu for built-in presets: Thermal Structure, T-S Diagram, Salinity, Density, Chlorophyll, Oxygen, Backscatter. Save your own combinations as Custom Views.

Zoom & Inspect

  • Box zoom — click and drag on the plot
  • Axis sliders — trim the X, Y, or colour range precisely
  • Click a point — see exact values in the sidebar and the glider's GPS position on the map
  • Reset Lims — return to the full view

Profiles

If your file contains dive profiles, a profile selector appears in the toolbar. Step through individual profiles or view them all at once.

3D View & Map

The right sidebar shows:

  • 3D View — an interactive 3D track with bathymetry
  • Map — glider GPS track; updates to the clicked position when using the inspector

Quality Control

Toggle What it does
Apply QC Hides points whose _QC flag isn't in the allowed list (default: 0,1,2,5,8)
Highlight Shows bad-QC points in red instead of hiding them
Interpolate Fills NaN gaps in PRES/TEMP/CNDC by time (filled points flagged QC=5)
Clean Flags zero fill-values, auto-scales CNDC units, cross-flags 5σ CNDC outliers
MLD Overlays Mixed Layer Depth (ΔT = 0.2 °C threshold)

Edit the QC flags field to customise which flags count as good.


Other Features

  • Plot All — disables the 200k-point cap to render every sample
  • Download — saves the current plot as a PNG
  • Jelly — an AI assistant (bottom-right bubble); paste your OpenAI key to enable it. The key is saved locally and never leaves your machine.

Uninstall

pip uninstall glider-playground

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glider_playground-0.2.3.tar.gz (5.4 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

glider_playground-0.2.3-py3-none-any.whl (5.4 MB view details)

Uploaded Python 3

File details

Details for the file glider_playground-0.2.3.tar.gz.

File metadata

  • Download URL: glider_playground-0.2.3.tar.gz
  • Upload date:
  • Size: 5.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for glider_playground-0.2.3.tar.gz
Algorithm Hash digest
SHA256 afcec38a3dfb4a83fbee73a9c2337c3a1752bb720d1d170cda11649b3810826d
MD5 fdc33450d4b143461b37373b5ac82e4d
BLAKE2b-256 35995d3cf53b257cbe7dff068151662b1349b9afe8923139b1e71c58099b6120

See more details on using hashes here.

File details

Details for the file glider_playground-0.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for glider_playground-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7630bf73dadd2b59b26968bbcf945859dc937fc5d0cf066d21a0489a86b46b4e
MD5 fb749f844fd1a55f83ba92e1485da5b1
BLAKE2b-256 e218b9a41daeb08db3e05c3bd990ff228a9c20a8d8034f3014faad1e9279c3f0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page