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). Any value can be switched independently, and it remembers your choice.

  1. Tap the value you want to change
    Tap directly on any depth, range, or coordinate readout — for example a depth in feet.
  2. It cycles to the next unit
    Each tap steps to the next option (feet → metres → fathoms → back to feet). Coordinates cycle DMS → DDM → DD → MGRS/UTM.
  3. That's it — it sticks
    Your choice for that field is saved. The underlying result never changes; only the display does.
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. Set up your source & scenario first
    Place the Source, set its level, frequency and depth. Impact ranges are computed from the same prediction as everything else.
  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. 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.
  5. 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.
  6. 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, with a plain-language note on where the conventions disagree.
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 methodology export below — it documents exactly which thresholds and inputs produced these ranges.
§

Export a methodology report MUIRWAVE PRO

The methodology export is the regulator-ready document that makes your work defensible: it records your inputs, the data sources, the thresholds, and the results in one multi-page PDF.

  1. Finish your scenario
    Make sure the prediction and impact ranges reflect what you want to report — the export captures the current state.
  2. Open Export Methodology
    From the panel rail (ANIMAL IMPACT group), tap the Export Methodology action tile.
  3. Confirm and share
    Tap Export…. MuirWave renders the multi-page PDF and hands it to the iOS share sheet — save it, email it, or drop it into your report.
What's free vs Pro. The Markdown methodology export and the watermarked Brief Sheet are free for everyone. MuirWave Pro unlocks the regulator-facing versions — the methodology PDF and the formal EIA report. If a Pro option 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 Data Management
    Go to Data Management 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.