Reference · The home screen & housekeeping

Settings, Units & Projects

The screens outside the map workspace: the home screen you launch into, plus three utility destinations off its tile grid — Settings (your unit defaults, compliance jurisdiction, display and purchases), Unit Conversions (a six-category converter you'd otherwise reach for a separate app), and Load Project (your iCloud-synced scenario library). None of them touch the physics — they set the frame everything else runs inside.

§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 — six 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).
Unit ConversionsThe six-category converter (see §04).
Data ManagementLive data, downloadable packs and sources (see Data Management).
MuirWave SettingsUnits, jurisdiction, display 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, and Export Report (⌥⌘E). 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 three open from the landing page. They share the same dark chrome and readable-width layout, so they read as siblings. Here's what each one owns.

LANDINGUTILITY DESTINATIONWHAT IT SETS Landing grid 2 × 2 tile grid Settings SettingsPage.swift units · jurisdiction · display purchases · about · test tools Unit Conversions UnitsPage.swift 6 converter cards, all on screen length · speed · temp · pressure · alt · angle Load Project ProjectsPage.swift saved scenarios, synced via iCloud search · sort · import · load
One landing grid, three utility screens. Settings holds your global preferences; Unit Conversions is a standalone calculator with no data dependencies; Load Project is your synced scenario library. Nothing here changes a prediction — they change how it's shown, judged and stored.
§03

Settings — one scrollable column

Settings is a single scrolling column of cards, top to bottom. Here's every card and what it does.

Unit defaults

Confirms what you'll see on first launch. Depth, Range and Coordinates are shown as read-only pills — FT, NM, DMS — with a note that these formats become configurable from here in a later update (for now, change them by tapping the value on the Acoustics page). The one interactive row is Temperature: a tap-to-cycle chip that walks SVP readouts between °C and °F without touching anything else.

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 watch + concurrent MMO/PAM + mandatory soft-start ramp; zone radii project-specific.
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; NMFS 2024 values applied, 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 interface-scale control, plus two on/off toggles for the app's visual flourishes:

ControlWhat it doesNotes
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. Applies immediately.
Marine SnowDrifting particles behind every page (on by default)Turn off for a plain background, or on older hardware.
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.

About

App name, Version and Build (both read from the app's own bundle), plus the live-AIS data attribution required by the feed licences. Quote the version and build when you report a problem — they pin the exact release you're on.

Test Functions is a card you may never see. It only appears on developer and TestFlight builds — never in the public App Store release — and groups tester-only tools (Diagnostics export, a beta "Live vessels (AIS)" opt-in, a tester "unlock everything" switch, and debug readouts). If it's not on your Settings screen, that's correct.
§04

Unit Conversions — six calculators at a glance

A standalone converter with no data dependencies — it's here so you don't reach for a separate app mid-workflow. All six categories are on screen at once (a grid, not a picker) because the real workflow is cross-category: "20 kt is how fast? what's 50 ft in metres?" Each card works independently.

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 layout adapts to your screen: iPad shows a 3×2 grid in landscape and 2×3 in portrait; a narrow phone stacks the cards in one column. If a value is mid-typed ("1." or "-"), the readout rows show "—" until it parses — that's expected, not a glitch.
§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/target 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 footer confirms Synced via iCloud when it's working
  • 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.