Reference · The home screen & housekeeping

Settings, Tools & Projects

The screens outside the map workspace: the home screen you launch into, plus four utility destinations off its tile grid — Settings (everything you configure, in one place), Field Calculators (quick acoustics, navigation and unit maths you'd otherwise reach for a separate app), Scratchpad (timestamped field notes), and Load Project (your iCloud-synced scenario library). None of them touch the physics of an open scenario — they set the frame everything else runs inside.

Settings is now one destination with a sidebar. Categories run down the left in three groups — APP (units, display, compliance), DATA SOURCES (every feed and dataset), and SYSTEM (storage, purchases, about) — and the panel on the right shows whichever you pick. On iPhone the same list fills the screen and tapping a category opens it.

Data Management used to be a separate tile on the home screen. It isn’t any more: everything it held is the DATA SOURCES group, documented in Data Sources.
§01

The home screen

What you land on when you open MuirWave — a status bar across the top, a grid of tiles, and a data-freshness dock. Everything else in the app opens from here.

Top status bar

The MuirWave wordmark, a tri-clock, and live-data status chips. The tri-clock reads three times at once so you're never guessing which zone a figure is in:

ClockShows
LOCALYour device's local time.
PINThe local time at your scenario pin's longitude — handy when you're working a survey area hours away.
UTCCoordinated Universal Time — the reference every data source is stamped in.
On iPhone the status bar is compact and shows UTC only; the full tri-clock appears on iPad and Mac.
The tiles — seven ways in
TileOpens
New ProjectA fresh acoustic scenario on the map workspace. If you have unsaved work, it asks first.
Continue ProjectResumes your last session where you left it. Shows a short teaser of that scenario — or reads "No session to resume" and sits disabled when there's nothing to return to.
Load ProjectYour saved, iCloud-synced library (see §05).
User GuideHow-to · Concepts · Ref. Opens this guide at muirwave.com/guide in your browser — the app itself carries no offline copy.
Field CalculatorsAcoustics · Nav · Units. Standalone calculators and the six unit converters (see §04).
ScratchpadTimestamped notes. Quick field notes, synced via iCloud (see §04).
MuirWave SettingsUnits, display, compliance, every data source, storage and purchases (see §03).
The freshness dock

A strip along the home screen showing, at a glance, how current your live data is before you start work — so you know whether you're on fresh feeds or the built-in climatology without opening a scenario.

On Mac, MuirWave also behaves like a document app: a Welcome window to start or open a project, and a File menu with New (⌘N), Open Recent, Export Report… (⌥⌘E), Export Data & Figures… (⇧⌘E) and Export Diagnostics…. The two Export commands open the same sheet, focused on its report or its data/figures section respectively. Settings opens as a normal Preferences window with ⌘,.

There is also a Data menu — and on iPad the same menu bar (including Data) appears when you swipe down from the top edge of the screen, with the same shortcuts on a connected keyboard:
Data menuDoes
Refresh Live SSP ⌘RRe-fetches the live sound-speed profile for your current pin and scenario time, without going to the panel.
Refresh Live Wind / Wave ⇧⌘RSame for the wind and wave feed.
Refresh Data Pack ListRe-reads what regional packs are available to download. Use it if a newly published pack isn't showing.
On iPhone, a one-time "Best on a larger screen" notice appears — the app works on iPhone, but its charts and panels are designed for iPad and larger.
§02

Where each screen lives

All four open from the home screen. They share the same dark chrome and readable-width layout, so they read as siblings. Here's what each one owns.

HOME SCREENUTILITY DESTINATIONWHAT IT OWNS Tile grid projects + 4 utilities MuirWave Settings sidebar · three groups units · display · compliance data sources · storage · purchases Field Calculators 11 cards, packed to fit 5 acoustics + navigation calculators plus the 6 unit converters Scratchpad newest note first timestamped field notes synced via iCloud Load Project your saved library saved scenarios, synced via iCloud search · sort · import · load
One home screen, four utility destinations. Settings holds your global preferences and every data source; Field Calculators and Scratchpad are standalone tools with no scenario dependencies; Load Project is your synced scenario library.
§03

Settings — a sidebar of categories

Settings is a sidebar on the left and a panel on the right: pick a category, and its cards fill the panel. Here's every card and what it does — each one now sits in the category named beside it rather than in one long scroll.

Unit defaults

Six rows, one per quantity, each showing every option at once rather than making you cycle blindly through them: Depth (FT · M · FM), Range (NM · KM · MI · YD · M), Coordinates (DMS · DDM · DD), Speed (KT · M/S · KM/H · MPH), Temperature (°C · °F) and Sound speed (M/S · FT/S). The full name of whatever you've picked sits under each row, because DDM means nothing until you've read "Degrees · Decimal minutes" once.

A change here reaches every readout in the app straight away and stays put — across a relaunch, across RESET, and across opening someone else's project. See Reference §01 for the full table of what each setting governs, including the two things with no row of their own: wave and swell height follow your depth unit, and vessel draught does too.

This card isn't the only way in. Most readouts in the app are still tap-to-cycle, which is quicker when you're looking at the number and want it in the other unit — the two write the same preference, so they can't disagree. What this card gives you that a chip can't is the list: what your options are, without discovering them one tap at a time.

Compliance Jurisdiction

A menu picker choosing which regulator's framing your impact ranges and methodology export are written for. Your choice drives the Impact Ranges panel's compliance row and the export's framing section — it does not change which thresholds get computed. Every jurisdiction still routes through the same NMFS 2024 / Southall 2019 species-group values; the picker only changes how the result is framed and cited. An APPLIES summary line under the picker spells out what that jurisdiction adds on top of the per-group table.

JurisdictionRegionWhat it adds (the APPLIES line)
NMFS🇺🇸 United StatesLevel A: AUD INJ. Level B (behavioural): 160 dB RMS impulsive / 120 dB RMS continuous. The default.
BSH🇩🇪 GermanyDual threshold: 160 dB SEL₀₅ + 190 dB peak at 750 m; mitigation required if exceeded.
JNCC🇬🇧 United Kingdom30-min pre-piling search (MMO and/or PAM) + soft-start ramp (20-min default); zone radii project-specific, ≥500 m minimum.
EPBC + OEI🇦🇺 AustraliaDual approval — the offshore-energy regulators (OIR / NOPSEMA) under the OEI Act, plus the federal environment department (DCCEEW) under the EPBC Act. Impacts must be reduced ALARP ("as low as reasonably practicable"); there is no single dB threshold.
Southall 2019🌐 InternationalScientific baseline for international/academic work; thresholds follow the selected criteria convention, no extra thresholds.
Not sure which to pick? Choose the regulator who'll read your report. If there isn't one — an academic paper, a survey in international waters — pick Southall 2019. The exact thresholds used are printed in the methodology export either way.

Display Settings

The appearance and interface-scale controls, plus two on/off toggles for the app’s visual flourishes:

ControlWhat it doesNotes
AppearanceDARK · LIGHT · SYSTEM — the colour palette used across the appDARK is the design default, built for low-light and night work. LIGHT is a daylight-legible chart-paper palette for bright decks and desk work — the same design system with its lightness reflected, not a different design. SYSTEM follows iPadOS. Applies immediately. The signal-excess colour ramp is identical in both appearances — a given hue always means the same decibel value, so exported plots and screenshots stay comparable between them. The detection-scale legend keeps its dark ground for that reason, and the satellite basemap is a photograph and stays one. Ambient Effects are suppressed in LIGHT; your toggle setting is remembered and returns when you switch back.
Interface ScaleDENSE · STANDARD · LARGE — size of text, chips, panels, and controls across the appDENSE is the design density and the iPad/iPhone default; the Mac starts at STANDARD (macOS renders the layout small on big displays and has no system text-size control for it). Bigger steps trade map area for readability — on iPad mini, whose display hasn’t the room LARGE trades away, the choices offered are DENSE and STANDARD. Applies immediately.
Ambient EffectsDrifting marine snow and surface light shafts behind every page (on by default)Turn off for a plain background and lower battery use — useful on a long watch, or on older hardware. One switch governs both effects.
Intro FlourishOpening animation on cold launch (on by default)Turning off takes effect on the next cold launch.

Support MuirWave

Your purchases and everything to do with them, in one card:

  • Your purchases — status rows for MuirWave Live (Active, Active — billing grace, payment issue — renewing, lapsed, or not subscribed) and MuirWave Pro (Owned / Not purchased).
  • Manage Subscription — appears once you've ever subscribed; opens Apple's system subscription sheet (iPhone/iPad).
  • Restore Purchases — reachable without hitting a paywall, per App Store rules. Re-applies anything you've already bought on this Apple ID.
  • Tip jar — three optional one-off thank-you amounts. They support development and unlock nothing.
  • Rate MuirWave on the App Store — opens the App Store's review composer. Always available here, so you never have to wait for MuirWave to ask. It may also ask you once itself, using Apple's own rating dialog, once you've been using it for a week or so across a few working sessions — and only when you've just put the work down, never mid-task, never on a first run, and never in a session where something went wrong.

About

App name and Version (read from the app's own bundle), the copyright and MuirWave™ ownership notice, and Privacy Policy and Terms of Use links. Quote the version whenever you report a problem — it's the first thing we'll ask for.

§04

Field Calculators & Scratchpad

Two small tools that sit beside the workspace rather than inside it, each on its own home-screen tile. Neither has any data dependencies and neither touches an open scenario — they're here so you don't reach for a separate app mid-workflow.

Field Calculators

Eleven cards on one scrolling page: five quick calculators, then the six unit converters. The calculators call the same solvers the prediction engine uses — so a sound speed you work out here is the sound speed MuirWave would use for that water, not a second opinion from a different formula. Each card names the reference it implements.

CalculatorWorks outReference
Sound Speedc from temperature, salinity and depth.Mackenzie 1981
Absorptionα in dB/km from frequency, temperature, salinity, depth and pH. Frequency is entered in whole Hz.François–Garrison 1982
Ambient NoiseSpectrum noise level from sea state, shipping and frequency. Shipping is the same REMOTE / LIGHT / MOD / HEAVY scale the Acoustics workspace uses.Wenz — indicative
dB MathAdds decibel levels correctly (incoherent power sum), rather than the arithmetic sum that catches everyone out.power sum
Bearing & RangeGreat-circle bearing and distance between two positions.great circle
Ambient Noise here is indicative — the card says so. It's a quick Wenz estimate from the three values you type. The workspace's Ambient Noise panel is the figure to quote: it sums eight contributors at your actual pin — turbulence, shipping, wind, thermal, offshore platforms, snapping shrimp, ice noise and rain — rather than the three you can type here.
The six unit converters
YOU TYPESTORED AS SI BASEEVERY UNIT UPDATES 1 · [ nm ▸ ] tap chip to cycle input unit 1852 m base: metre (SI) METRE 1,852 KILOMETRE 1.852 YARD 2,025.37 FOOT 6,076.12 FATHOM 1,012.69 every value stored in SI, converted at the display edge — switching units never changes the number
How one card works. Type a value, tap the chip to pick which unit you typed, and every other unit in that category updates live. Values are held internally in SI and converted only at the display edge, so the maths never drifts.
CardOpens onAlso converts
Lengthnautical milemetre · kilometre · yard · foot · fathom
Speedknotmetre/second · km/h · mph
Temperature°Ckelvin · °F
PressurehPapascal · kPa · millibar · inHg · psi
Altitudefootmetre · flight level (FL)
Angledegreeradian · NATO mil (6400 / turn)
The cards pack to fill whatever window you give them — as many columns as fit, each card dropping into the shortest column rather than sitting in a rigid grid. A Mac at full screen shows all eleven at once; iPad landscape shows three columns, a phone one. If a value is mid-typed ("1." or "-"), the readout rows show "—" until it parses — that's expected, not a glitch.
Scratchpad

Somewhere to write down the things that don't belong in a saved scenario — a hull number, a tide window, what the client actually asked for. Type into NEW NOTE and Save note; each note is stamped with the date and time and the newest sits at the top. Delete one with its .

Notes sync through iCloud on the same account, so a note written on the iPad at sea is on the Mac afterwards. Sync is Apple's to schedule and there's no way for an app to force an instant pull — to prompt it, pull down on the list (iPhone and iPad) or use the refresh button in the header (Mac). A note deleted on another device disappears here once iCloud has propagated it, which is usually seconds but occasionally longer.

§05

Load Project — your synced library

Every scenario you save from the Acoustics page lands here as a card, newest first. The library mirrors across every device signed into the same iCloud account — save on the iPad, open on the Mac.

The header carries three controls (the search field folds away on a phone to save room):

ControlWhat it does
SearchFilters the grid by project name as you type. Clear it to see everything.
SortThree orders: Most Recent (default), Name (A–Z), Date Created.
ImportOpens the Files picker to bring in a .muirwaveproject file — from AirDrop, iCloud Drive or a colleague. It lands as a new card at the top.

Opening a project

  1. Tap a card to load it
    The card's saved scenario opens on the Acoustics page — pin, frequency, depths and everything else exactly as you left them. Each card previews its frequency and source/receiver depths so you can tell scenarios apart at a glance.
  2. Long-press (or right-click) for more
    A context menu offers Rename…, Duplicate, Export… and Delete….
Menu actionResult
Rename…Edit the name in a small sheet. The change syncs to your other devices automatically.
DuplicateAn instant copy suffixed " copy" — branch a scenario without re-typing every setting.
Export…Saves the project as a .muirwaveproject file to Files / AirDrop / iCloud Drive to hand to someone else.
Delete…Asks you to confirm — and names the card first, so a misfire is obvious. Deletion removes it from every device on that iCloud account and can't be undone.
● Synced & safe
  • Saves mirror to iPad, iPhone and Mac on the same iCloud account
  • A live footer reads iCloud · syncing… while a change is in flight and iCloud · updated <time> once it lands — never a static claim, so it never disagrees with what you can see
  • Import / Export move projects in and out as portable files
● If iCloud is signed out
  • A brass-warned banner reads iCloud Sync Unavailable
  • Local saves still work — they just stay on this device
  • Sign in to iCloud in system Settings to start syncing
First run shows an empty-state with an Import Project… button, so a fresh install with a shared file can load it straight away — no need to create one first. Deleting is the only destructive action here, and it always asks before it acts.