How-To · Recipes for a task

How-To Guides

Short recipes for something specific you already understand. Each is a handful of steps with what to expect. New to MuirWave? Start with Your First Prediction instead — it walks the whole flow end-to-end.

§

Change your units

MuirWave opens in nautical-chart conventions (feet, nautical miles, DMS, knots). There are two ways to change that, and they write the same setting.

All of them at once — Settings → Units
  1. Open Settings from the home screen, then Units
    Six rows: depth, range, coordinates, speed, temperature and sound speed.
  2. Tap the option you want
    Every option for that quantity is on screen, so there's no cycling to find one. The full name of your choice appears under the row.
  3. The whole app follows immediately
    Every readout, chart axis, map label and chip switches at once — and stays switched across relaunches, Reset, and opening someone else's project.
One of them, without leaving the page
  1. Tap the readout itself
    Most depth, range, coordinate and sound-speed readouts cycle on tap — feet → metres → fathoms → back to feet; coordinates DMS → DDM → DD. Quicker when you're looking at the number and just want the other unit.
  2. It's the same setting
    Cycling a chip changes the same preference the Settings card shows, so the two can never disagree.
The result never changes — only the display does. Every value is stored in SI internally and converted at the moment it's drawn, so switching units can't move a prediction.
See the full table in Reference → Units & conventions.
§

Probe the water vs. place a source

MuirWave separates two jobs so you never confuse "what are conditions here" with "what does my source do". Both live on the map.

The Probe default
A sampling cursor. Move it anywhere to read the environment at that spot — sound-speed profile, wind, currents, seabed. It asks nothing of the physics; it just reports conditions.
The Source
Your acoustic source — the thing making noise. Set its position, depth and frequency, and MuirWave runs the full propagation prediction around it.
Rule of thumb: use the Probe to scout conditions across your survey area; drop the Source where you want an actual prediction.
§

Enter a measured layer depth

You dropped a bathythermograph and the layer is at 600 ft; the model says 164 ft. Type what you measured and every prediction rebuilds through it — measured truth beats modelled truth. Free for everyone, works fully offline.

  1. Open the Water Column panel
    From the panel rail (OCEAN group), open Water Column and find the MEASURED LAYER · BT/XBT OBSERVATION block. It's there with or without a regional pack.
  2. Enter your sonic layer depth
    Tap the Measured SLD row and type the depth you observed (any depth unit — tap the unit chip to switch). The row records when and where you entered it.
  3. Flip USE MEASURED on
    The sound-speed profile rebuilds: well-mixed from the surface to your depth, then a smooth splice into the model's structure below. The BELOW LAYER row names exactly what it splices into — live model or climatology, whichever is really underneath.
  4. Read the chip
    The top-bar SSP chip turns solid brass with a ◆ glyph — ◆ SSP · MEASURED · <1 H. That look means your observation is driving the solver. The Propagation panel shows both curves: your measured profile bright, the model dashed for comparison.
  5. Revert any time
    Toggle USE MEASURED off — or tap the chip and choose REVERT TO MODEL — and the model answer returns instantly. Your entry is kept for one-tap re-enable.
A measurement is perishable: the chip's age token ambers after 6 hours, reads STALE after 24, and ambers on distance once you're ~30 nm from where you took it. It keeps driving until you revert — see Concepts → Measured beats modelled.
§

Enter measured ambient noise

Your display says the noise floor is 74 dB at 400 Hz; the model says 70.7. Enter a handful of points and the modelled spectrum warps through your measurements, re-anchoring the noise level and the whole detection picture. Also free.

  1. Open the Ambient Noise panel
    From the panel rail (OCEAN group, just below Currents), open Ambient Noise and scroll to MEASURED NOISE · FIELD OBSERVATION.
  2. Add your points
    Tap ADD POINT, enter a frequency and level in the fields that open, then tap SAVE POINT. Up to 12 points; one is perfectly valid. Levels are omnidirectional spectrum level, dB re 1 µPa²/Hz — mind the unit traps in Troubleshooting.
  3. Flip USE MEASURED on
    The noise total anchors to your points. The component rows dim ("model breakdown · total is measured-anchored") and the TOTAL row wears a brass MEASURED tag with the model's number kept in fine print — the disagreement is your field intelligence.
  4. Watch the fade
    Your points govern within one decade of frequency on either side; beyond that the model honestly takes over. On the spectrum chart your points are brass diamonds the anchored curve passes through; the model total stays dashed underneath.
While ON, your measured total outranks every model noise control — including the SHIPPING override. Live wind keeps updating underneath; your points hold, and the model-vs-measured gap moves honestly.
§

Estimate impact ranges

The Impact Ranges panel estimates how far your source could affect marine life, judged against recognised regulatory thresholds — the core of an impact assessment.

  1. Drop the pin on your site
    Only the map pin matters here — impact work is self-contained and takes nothing from Acoustics Setup. You never need to open the acoustics scenario for an impact assessment.
  2. Open the Impact Ranges panel
    From the panel rail, open Impact Ranges (in the ANIMAL IMPACT group).
  3. Choose your receptor & source type
    Pick mammals or fish/turtles, then the source type: impulsive (pile driving, airguns), non-impulsive (vibratory piling, drilling), or continuous (turbines, shipping). These select the correct threshold family.
  4. Describe the source in the panel
    The panel's numbers are driven entirely by its own source description: hammer energy and strike count for impulsive sources, or source level and frequency otherwise. Source depth defaults to AUTO (mid-water at the pin — the published pile-driving convention); override it in the panel if you know the real depth.
  5. Set the hearing-group convention
    In the panel, choose the hearing-group convention — NMFS 2024 or Southall 2019. This sets which species-group thresholds are used.
  6. Set your jurisdiction (in Settings)
    The Compliance Jurisdiction (Settings) — NMFS, BSH, JNCC, EPBC or Southall — frames the assessment for your regulator. All share the NMFS 2024 / Southall 2019 base thresholds, but some (e.g. BSH, JNCC, EPBC) layer additional criteria on top, which the panel and export reflect.
  7. Read the ranges
    MuirWave returns the distance at which each threshold (injury / behavioural) is reached, per hearing group — shown as ranges and on the map.
The Impact Ranges panel: receptor group (Mammals / Fish + Turtles), regulatory convention (NMFS 2024 / Southall 2019), source type, TL model, pile-driver hammer energy, strike count and exposure model, the per-hearing-group threshold-range table, the governing mitigation zone, and the soft-start ramp.
Figure. The Impact Ranges panel. Pick the receptor group and the regulatory convention (NMFS 2024 or Southall 2019 — the note explains where they disagree) and describe the source (here an impulsive pile-driver: MENCK MHU 3500S, 3000 kJ × 2k strikes); MuirWave prices the threshold ranges accordingly. Noise-abatement mitigation is a separate MuirWave Pro panel — Impact Ranges itself is the unmitigated baseline.
For a formal submission, pair this with the export below — the Impact Assessment report documents exactly which thresholds and inputs produced these ranges.
§

Export a report or the underlying data

Every export in MuirWave — scenario reports, impact-assessment PDFs, and the raw data and figures behind them — comes from one Export sheet, in two sections: REPORTS and DATA & FIGURES.

  1. Finish your scenario or your impact assessment
    Make sure the prediction, or the Impact Ranges panel's source description, reflects what you want to report — the export captures the current state, nothing more.
  2. Open the Export sheet
    Two rail tiles reach it: Export (Acoustics group) opens on REPORTS; Export Data & Figures (Animal Impact group) opens on DATA & FIGURES. It's one sheet either way — scroll to reach the other section.
  3. Pick a tile, confirm and share
    Tap a format tile, then Export…. MuirWave renders it and hands it to the share sheet (or a save panel on Mac) — save it, email it, or drop it into your report.
REPORTS
Brief Sheet — free, one-page summary (watermarked draft for free accounts). Propagation Report — MuirWave Pro, five-page PDF built from your acoustic scenario. Impact Assessment — MuirWave Pro, nine-to-ten-page PDF built from the Impact Ranges panel: thresholds, criteria, per-group ranges and figures, the regulator-facing deliverable.
DATA & FIGURES
All MuirWave Pro, and all built from the Impact Ranges panel: Markdown (drops into §3 of a written report), Data (CSV) (SI units throughout), GIS (GeoJSON) (isopleths as real polygons) and Figure (PNG) (a 1500×840 px print-ready site map). Full detail in Animal Impact → Exporting the methodology.
What's free vs Pro. Only the watermarked Brief Sheet is free. Everything else — Propagation Report, Impact Assessment, and all four DATA & FIGURES formats — is MuirWave Pro. If a tile is greyed out, see Unlock Live or Pro below.
§

Download & manage regional data packs

MuirWave ships with global-coverage data. For a survey area you care about, a high-resolution regional pack sharpens the ocean climatology behind your predictions.

  1. Open your data sources
    Go to MuirWave Settings from the home screen, then pick a source under DATA SOURCES in the sidebar, to see the available regions and what's installed on your device.
  2. Pick a region and tier
    Each region offers two tiers — Compact (smaller) and High Quality (finer depth resolution). Choose based on how much detail and storage you want.
  3. Download
    Tap to download. Once installed, that region's data is used automatically for any pin inside it — including fully offline.
  4. Manage storage
    Remove a pack any time to free space; it's always re-downloadable. Packs don't count against your iCloud backup.
Which packs need MuirWave Live? Only the Regional Forecast packs (they stream live ocean-model data). The Offline Climatology packs (Compact / High Quality) and Bathymetry packs are free for everyone — and the global baseline data works for everyone, everywhere, offline.
§

Work fully offline

There's nothing to switch on — MuirWave is offline-first. Every prediction runs on data bundled in the app. This matters most at sea, where you'll often have no signal.

  1. Before you sail
    While you still have a connection, download any regional packs for your area (Live). Everything else is already on the device.
  2. At sea, just work
    Place pins, run predictions, read results — all of it works with the network off, anywhere on Earth.
  3. Trust the labels
    The live-data chips will show they're on the built-in climatology baseline rather than a live feed. MuirWave never silently guesses — you always know the provenance of a number.
More detail on the honest-fallback behaviour in Troubleshooting → Working offline.
§

Unlock Live or Pro

The full prediction engine is free. Two optional upgrades add live data (MuirWave Live) and professional export (MuirWave Pro) — see the editions matrix for exactly what each includes.

  1. Tap the dimmed feature
    Tapping any greyed-out control — a live chip, a pack, or an export tile — opens a screen explaining what it unlocks and the current price.
  2. Purchase through the App Store
    MuirWave Live is a subscription (with a free trial); MuirWave Pro is a one-time purchase you own forever. Both go through your Apple ID.
  3. Already own it?
    Use Settings → Restore Purchases on a new device — see Troubleshooting → Restoring a purchase.