Reference · Data Management

Data Management

One screen for every source of data MuirWave can draw on — live ocean and weather, downloadable regional packs, the ambient-noise contributors, vessel traffic, and the shipping and platform datasets behind the noise model. This page walks each card top-to-bottom and explains every control. Reach it from the Landing grid → Data Management.

§01

What this screen controls

Every prediction runs on bundled data first — it works fully offline out of the box. Data Management is where you optionally add live conditions (an MuirWave Live subscription) and download sharper regional packs, and where you tune the ambient-noise and shipping/platform inputs. Nothing here changes your scenario; it changes what data feeds it.

Data Management is the control surface between where data comes from (left) and the prediction that uses it (right). Cyan paths need a network connection; brass paths are on-device and work offline.

§02

Storage

The top card shows how much space your downloaded data is using. DOWNLOADED DATA is the total, with a per-category breakdown beneath it (ocean packs, bathymetry packs, and so on). It reads “Calculating…” for a moment on open while it measures, and recomputes itself whenever a download finishes.

Bundled data isn't counted here — only packs you downloaded. When nothing is installed the card reads “No downloaded packs yet.” To free space, delete individual packs from the sections below (the card reminds you: “Remove individual packs from the sections below to free space.”). iOS Settings can't itemise a third-party app's data this way, which is why this card exists.

§03

Sound Speed Profile

The most important input to any prediction. This card has three tiers, in priority order: live temperature profile, downloaded regional forecast packs, and the always-available offline climatology. MuirWave uses the best one available for your pin and labels which it used.

Live Temperature Profile LIVE

Real-time HYCOM ocean-model temperature and salinity for your pin, from which MuirWave computes the sound-speed profile on-device (Mackenzie 1981). Requires an MuirWave Live subscription.

Control	What it does
ENABLED	Turns the live tier on. If you don't have MuirWave Live, tapping it opens the upgrade sheet instead of switching on. Turning it off clears the cache so a later re-enable never shows stale data without a fresh pull.
CACHE	What's currently held: source label, pin coordinate, and how long ago it was fetched (just now / N min ago / N h ago), or (empty) before the first pull.
ERROR	Appears only when the last fetch failed (e.g. no network) — your signal for why data isn't updating.
REFRESH NOW	Fetches for your current pin and scenario time. Disabled while a fetch is in flight; shows REFRESHING… with a spinner while running.

Coverage. Live SSP spans roughly August 2024 through +8 days from now on 3-hour timesteps, snapping to the nearest step for your scenario date. Confidence is highest for today's analysis; +5–8 days is for envelope/contingency use only. Outside coverage, offline, or disabled → it falls back to WOA23 climatology automatically.

Regional Pack Forecasts LIVE

Downloaded operating-area packs of the same HYCOM forecast data, so a whole region is available at once. Because they stream live ocean-model data, downloading them needs MuirWave Live — a line of text above the chips says so when you're not subscribed. Pack chips behave exactly as described in §10.

Offline Climatology

The built-in fallback, always available offline. Per-region WOA23 climatology in two tiers — Compact (24 depth levels) and HQ (72). This is the final fallback used when there's no live data and no forecast pack covering your pin. The map and REFRESH chips at the top-right open the coverage map and re-scan for sideloaded packs.

§04

Wind / Waves / Swell LIVE

Live sea-state for the surface-noise and roughness terms. Public-domain NOAA GFS / GFS-Wave 10-metre wind speed and significant wave height, matched to your scenario time. Requires MuirWave Live.

Control	What it does
ENABLED	Turns the live wind/wave tier on (upgrade sheet first if you're not subscribed). Switching it on fires an immediate fetch for your pin so you don't wait for the next pin move.
ERROR	Shown inline only if the last fetch failed — otherwise the row is hidden.
LAST PULL	Appears once there's cached data: the upstream source label plus how long ago it landed.

There's no manual refresh button here by design — it re-fetches automatically each time you move the source pin or change the date. The WIND pill on the Wind & Sea State panel (and the top-bar WIND chip) is your at-a-glance status. Coverage runs from about 7 days back through +5 days ahead; outside that, or when disabled/offline, it falls back to your SeaState preset.

§05

Bathymetry

Seafloor depth packs, derived from GEBCO 2025 sub-ice. There's no live tier — the seabed doesn't move on scenario timescales — so this is a set of downloadable regional packs plus the always-on bundled global tile.

Tier	Resolution	Role
Compact	4 arc-minute (~6 km at the equator)	Lightweight regional detail.
HQ	20 arc-second (~0.6 km)	High-resolution seafloor for close work.
Bundled global	5 arc-minute	Always present — the fallback when no regional pack covers your pin.

Each region shows a Compact and an HQ chip (see §10). The map chip opens the coverage map; REFRESH re-scans for installed packs. The card's ⓘ tip carries the resolution details.

§06

Tertiary Ambient Noise Sources

The background-noise floor for the sonar equation. The Wenz baseline is always in the sum; the three rows below are opt-in contributors that only add noise where local conditions warrant it. “Tertiary” means these sit on top of the Wenz floor (primary) and the platform terms (secondary).

■

Wenz curves — always on

The four-component floor (turbulence, distant shipping, wind/sea-state, thermal). No toggle — it carries an ALWAYS ON pill because you'd never want it off. Everything else is added to it as a power sum.

🦐

Snapping shrimp — toggle

Adds a biological term that gates on habitat — bottom temperature, substrate (Dutkiewicz 2015), and depth (GEBCO). Zero outside warm, shallow, coarse-substrate locations; 20–30 dB above Wenz in viable habitat.

❄

Ice noise — toggle (on by default)

Cryogenic noise gated on sea-ice concentration for the scenario month and wind speed. Peaks at the marginal ice zone; zero at mid-latitude and tropical pins.

☔

Rain noise — toggle + rate

Precipitation impact noise. When on, a RAIN RATE slider appears.

Rain rate slider (0–50 mm/h). At 0 = AUTO it uses the live forecast rain at your pin (needs live weather; silent if there's no forecast rain or live data is off). Set any positive value to override with a manual what-if rate. When a term dominates the noise, the NL chip's caption flags it — SHRMP, ICE, or RAIN.

§07

Shipping source

The distant-shipping noise contribution comes from a bundled global density tile — Halpern et al. 2015, licensed CC-BY 4.0. This card discharges the attribution the licence requires.

Each loaded tile lists its source, coverage, and licence. Tap the attribution line (it carries a copy icon) to copy the full citation to the clipboard — handy when you're pasting it beside a screenshot in a report. Regional high-resolution shipping packs may arrive in a later update; when one lands it appears here automatically.

§08

AIS Vessel Traffic BETA

Live vessel positions drawn on the map, and — when vessels are within about 50 nm of the probe — a measured shipping-noise term (JOMOPANS-ECHO) that replaces the Halpern climatology. This card is a beta feature and appears only in builds where it's enabled.

Control	What it does
ENABLED	Turns the feed on. The first time, a privacy notice appears — you confirm (Turn On) before any network fetch happens.
Feed status	One row per active feed (Fintraffic / digitraffic.fi, CC BY 4.0; BarentsWatch, NLOD — both Nordic waters) with its live status, plus a LAST FETCH time.
AISSTREAM.IO	Optional global, community-received feed over WebSocket. Flip on and paste a free API key to add worldwide coverage alongside the Nordic feeds.
API KEY	Your aisstream.io key. Stored in the device Keychain and never displayed again — the row reads “stored in Keychain” with a REPLACE button. SAVE is disabled until you've pasted a key.

Privacy. Only the map viewport area is sent to the feeds — never your device location. An empty or offline feed never zeroes the noise term; it quietly falls back to the shipping climatology.

§09

Platform sources

Offshore-platform datasets (BSEE / SodIR / OpenStreetMap) and the per-kind source levels behind the platform noise term. The top of the card lists each dataset with its merged-output licence (typically ODbL, from OSM's share-alike) and tappable attribution lines that copy to the clipboard.

Platform NL defaults

Per-kind broadband source levels from Erbe 2017, editable so you can override any platform type. Edits take effect on the live noise chip's next tick when “Include platform NL in SE” is on.

Field	Range	Notes
Source level (per kind)	100 – 220 dB re 1 µPa @ 1 m	One field per platform kind; published Erbe defaults span 125–184 dB, with headroom either side for sensitivity tests.
Range cap	1 – 500 km (default 100 km)	How far out platforms are counted into the noise term.

RESET SL TO ERBE DEFAULTS clears every override you've made in one tap, returning all kinds to the published values.

§10

Reading the pack chips

The Sound Speed Profile (Offline Climatology and Regional Forecasts) and Bathymetry cards all use the same chips. Every region shows a Compact and an HQ chip — 10 regions × 2 tiers. A chip's look tells you its state; its right-hand text shows the pack size or progress.

State	Means	Tap does
BUNDLED	Ships inside the app (seal icon).	Nothing — it's always present.
AVAILABLE	Not downloaded yet (download icon, shows size).	Starts the download.
DOWNLOADING	In progress, shows a percentage.	Nothing — wait for it.
VERIFYING	Checking the download's integrity.	Nothing — nearly done.
INSTALLED	On your device (trash icon, shows size).	Arms it for deletion.
CONFIRM DELETE	Armed (orange). Auto-disarms after 5 seconds.	Deletes the pack.
RETRY	The download failed.	Tries again.

● Deleting is safe

Deletes only remove the downloaded copy — you can re-download any time.
After deleting, predictions fall back to the bundled global data.
A muted “—” chip means that tier isn't published for that region.

● Worth knowing

Downloading a Regional Forecast pack needs MuirWave Live; Offline Climatology and Bathymetry packs don't.
Delete is two-tap on purpose (arm, then confirm) so you can't lose a pack by accident.
Compact is the light option; HQ is larger and sharper — check the size on the chip before downloading on a metered connection.

Compact says 24 levels and HQ says 72 — is that exact?

Those are the tier labels MuirWave uses for ocean climatology (Compact = the lighter vertical grid, HQ = the fine one), and Compact/HQ is the distinction that matters when you choose. Treat them as “light vs high-resolution” rather than a promise of a precise level count for every pack — the exact depths sampled can vary by pack and region, and the Provenance view always shows what actually fed a given result.