From 826d56ede2c59cad19748f61d8b5d75d08a702d9 Mon Sep 17 00:00:00 2001
From: Claudomator Agent <agent@claudomator>
Date: Sun, 15 Mar 2026 03:44:25 +0000
Subject: feat: add harmonic tide height predictions (Section 3.2 / 4.2)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Implement offline harmonic tide prediction as specified in COMPONENT_DESIGN.md:
- TideConstituent: name, speedDegPerHour, amplitudeMeters, phaseDeg
- TidePrediction: timestampMs, heightMeters
- TideStation: id, name, lat, lon, datumOffsetMeters, constituents
- HarmonicTideCalculator: predictHeight(), predictRange(), findHighLow()
  Formula: h(t) = Z0 + Σ [ Hi × cos( ωi × (t − t0) − φi ) ]
- 15 unit tests covering all calculation paths

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../main/kotlin/org/terst/nav/data/model/TideConstituent.kt   |  9 +++++++++
 .../main/kotlin/org/terst/nav/data/model/TidePrediction.kt    |  7 +++++++
 .../src/main/kotlin/org/terst/nav/data/model/TideStation.kt   | 11 +++++++++++
 3 files changed, 27 insertions(+)
 create mode 100644 android-app/app/src/main/kotlin/org/terst/nav/data/model/TideConstituent.kt
 create mode 100644 android-app/app/src/main/kotlin/org/terst/nav/data/model/TidePrediction.kt
 create mode 100644 android-app/app/src/main/kotlin/org/terst/nav/data/model/TideStation.kt

(limited to 'android-app/app/src/main/kotlin/org')

diff --git a/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideConstituent.kt b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideConstituent.kt
new file mode 100644
index 0000000..deb73d6
--- /dev/null
+++ b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideConstituent.kt
@@ -0,0 +1,9 @@
+package com.example.androidapp.data.model
+
+/** A single harmonic tidal constituent used in harmonic tide prediction. */
+data class TideConstituent(
+    val name: String,            // e.g. "M2", "S2", "K1"
+    val speedDegPerHour: Double, // angular speed in degrees per hour
+    val amplitudeMeters: Double, // amplitude in metres
+    val phaseDeg: Double         // phase lag (kappa) in degrees
+)
diff --git a/android-app/app/src/main/kotlin/org/terst/nav/data/model/TidePrediction.kt b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TidePrediction.kt
new file mode 100644
index 0000000..51eea44
--- /dev/null
+++ b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TidePrediction.kt
@@ -0,0 +1,7 @@
+package com.example.androidapp.data.model
+
+/** A predicted tide height at a specific point in time. */
+data class TidePrediction(
+    val timestampMs: Long,   // Unix epoch milliseconds
+    val heightMeters: Double // predicted water height above chart datum in metres
+)
diff --git a/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideStation.kt b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideStation.kt
new file mode 100644
index 0000000..c9f96a6
--- /dev/null
+++ b/android-app/app/src/main/kotlin/org/terst/nav/data/model/TideStation.kt
@@ -0,0 +1,11 @@
+package com.example.androidapp.data.model
+
+/** A tide station with harmonic constituents for offline tide prediction. */
+data class TideStation(
+    val id: String,
+    val name: String,
+    val lat: Double,
+    val lon: Double,
+    val datumOffsetMeters: Double,  // mean water level above chart datum (Z0)
+    val constituents: List<TideConstituent>
+)
-- 
cgit v1.2.3