mirror of
https://github.com/praktimarc/kst4contest.git
synced 2026-11-19 01:52:29 +01:00
Add the setup wizard's antenna and power answers
Written-by: DeepSeek V4 Pro Written-by: Claude Fable 5.2
This commit is contained in:
2 files changed
+168
No files matched your search
@@ -0,0 +1,60 @@
|
||||
package kst4contest.view.compose.wizard
|
||||
|
||||
import androidx.compose.runtime.getValue
|
||||
import androidx.compose.runtime.mutableStateOf
|
||||
import androidx.compose.runtime.setValue
|
||||
import kst4contest.model.ChatPreferences
|
||||
import kst4contest.view.compose.tabs.StationTabState
|
||||
|
||||
/**
|
||||
* The setup wizard's answers about antenna and power.
|
||||
*
|
||||
* These numbers have no empty state: every answer starts as the stored value and is a
|
||||
* proposal the operator may pass unchanged, also when a station is set up anew. They feed the
|
||||
* path analysis and the antenna sector on the map; the chat does not need them.
|
||||
*
|
||||
* The site elevation is the exception in form, not in rule: it is text, because empty is a
|
||||
* value of its own -- "let the elevation model decide" -- and it is read exactly as the
|
||||
* Station tab reads it.
|
||||
*
|
||||
* @param prefs the profile's preferences, already read from its file
|
||||
*/
|
||||
class WizardAntenna(prefs: ChatPreferences) {
|
||||
|
||||
var beamWidthDeg: Double by mutableStateOf(prefs.getStn_antennaBeamWidthDeg())
|
||||
var gainDbi: Double by mutableStateOf(prefs.getStn_pathAnalysisOwnAntennaGainDbi())
|
||||
var heightMeters: Double by mutableStateOf(prefs.getStn_pathAnalysisOwnAntennaHeightMeters())
|
||||
var txPowerWatts: Double by mutableStateOf(prefs.getStn_pathAnalysisOwnTxPowerWatts())
|
||||
|
||||
/** The site elevation above sea level as the operator types it; empty for the model. */
|
||||
var heightAslText: String by mutableStateOf(elevationText(prefs.getStn_pathAnalysisOwnHeightAslMeters()))
|
||||
|
||||
/** A site elevation that is neither empty nor a number in the accepted range. */
|
||||
val heightAslRefused: Boolean
|
||||
get() = StationTabState.parseOwnHeightAsl(heightAslText) == null
|
||||
|
||||
/** Whether every answer can be stored as it stands. */
|
||||
val complete: Boolean
|
||||
get() = beamWidthDeg.isFinite() && gainDbi.isFinite() && heightMeters.isFinite() &&
|
||||
txPowerWatts.isFinite() && !heightAslRefused
|
||||
|
||||
/** Puts the answers into [prefs]. Call only while [complete]. */
|
||||
fun writeTo(prefs: ChatPreferences) {
|
||||
prefs.setStn_antennaBeamWidthDeg(beamWidthDeg)
|
||||
prefs.setStn_pathAnalysisOwnAntennaGainDbi(gainDbi)
|
||||
prefs.setStn_pathAnalysisOwnAntennaHeightMeters(heightMeters)
|
||||
prefs.setStn_pathAnalysisOwnTxPowerWatts(txPowerWatts)
|
||||
prefs.setStn_pathAnalysisOwnHeightAslMeters(
|
||||
StationTabState.parseOwnHeightAsl(heightAslText) ?: Double.NaN
|
||||
)
|
||||
}
|
||||
|
||||
private companion object {
|
||||
/** Empty for "unset"; a whole number without ".0", so the field shows what one types. */
|
||||
fun elevationText(meters: Double): String = when {
|
||||
meters.isNaN() -> ""
|
||||
meters == Math.floor(meters) && !meters.isInfinite() -> meters.toLong().toString()
|
||||
else -> meters.toString()
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,108 @@
|
||||
package kst4contest.view.compose.wizard
|
||||
|
||||
import kst4contest.model.ChatPreferences
|
||||
import org.junit.jupiter.api.Assertions.assertEquals
|
||||
import org.junit.jupiter.api.Assertions.assertFalse
|
||||
import org.junit.jupiter.api.Assertions.assertTrue
|
||||
import org.junit.jupiter.api.Test
|
||||
import java.nio.file.Path
|
||||
|
||||
/**
|
||||
* The antenna and power answers: always proposals taken from what is stored, never empty,
|
||||
* and the site elevation read the way the Station tab reads it.
|
||||
*/
|
||||
class WizardAntennaTest {
|
||||
|
||||
private fun prefs(configure: ChatPreferences.() -> Unit = {}): ChatPreferences =
|
||||
ChatPreferences(Path.of("wizard-antenna-test-unused.xml")).apply(configure)
|
||||
|
||||
private fun stored() = prefs {
|
||||
setStn_antennaBeamWidthDeg(28.0)
|
||||
setStn_pathAnalysisOwnAntennaGainDbi(16.5)
|
||||
setStn_pathAnalysisOwnAntennaHeightMeters(18.0)
|
||||
setStn_pathAnalysisOwnTxPowerWatts(400.0)
|
||||
setStn_pathAnalysisOwnHeightAslMeters(612.0)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun theAnswersStartAsTheStoredValues() {
|
||||
val antenna = WizardAntenna(stored())
|
||||
|
||||
assertEquals(28.0, antenna.beamWidthDeg)
|
||||
assertEquals(16.5, antenna.gainDbi)
|
||||
assertEquals(18.0, antenna.heightMeters)
|
||||
assertEquals(400.0, antenna.txPowerWatts)
|
||||
assertEquals("612", antenna.heightAslText, "a whole number is shown without a decimal point")
|
||||
assertTrue(antenna.complete)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun anUnsetSiteElevationIsAnEmptyField() {
|
||||
val antenna = WizardAntenna(prefs { setStn_pathAnalysisOwnHeightAslMeters(Double.NaN) })
|
||||
|
||||
assertEquals("", antenna.heightAslText)
|
||||
assertFalse(antenna.heightAslRefused, "empty means the elevation model, not an error")
|
||||
assertTrue(antenna.complete)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aFractionalSiteElevationKeepsItsFraction() {
|
||||
val antenna = WizardAntenna(prefs { setStn_pathAnalysisOwnHeightAslMeters(250.5) })
|
||||
|
||||
assertEquals("250.5", antenna.heightAslText)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun theSiteElevationIsReadTheWayTheStationTabReadsIt() {
|
||||
val antenna = WizardAntenna(stored())
|
||||
|
||||
listOf("", " ", "250", "250,5", "250.5", "-100").forEach {
|
||||
antenna.heightAslText = it
|
||||
assertFalse(antenna.heightAslRefused, "'$it' must be accepted")
|
||||
}
|
||||
listOf("abc", "99999", "-501", "12 m").forEach {
|
||||
antenna.heightAslText = it
|
||||
assertTrue(antenna.heightAslRefused, "'$it' must be refused")
|
||||
assertFalse(antenna.complete)
|
||||
}
|
||||
}
|
||||
|
||||
@Test
|
||||
fun aNumberThatIsNotOneMakesThePageIncomplete() {
|
||||
val antenna = WizardAntenna(stored())
|
||||
|
||||
antenna.gainDbi = Double.NaN
|
||||
assertFalse(antenna.complete)
|
||||
|
||||
antenna.gainDbi = 12.0
|
||||
antenna.txPowerWatts = Double.POSITIVE_INFINITY
|
||||
assertFalse(antenna.complete)
|
||||
}
|
||||
|
||||
@Test
|
||||
fun writingPutsTheAnswersIntoThePreferences() {
|
||||
val target = prefs()
|
||||
val antenna = WizardAntenna(stored())
|
||||
antenna.beamWidthDeg = 35.0
|
||||
antenna.heightAslText = "250,5"
|
||||
|
||||
antenna.writeTo(target)
|
||||
|
||||
assertEquals(35.0, target.getStn_antennaBeamWidthDeg())
|
||||
assertEquals(16.5, target.getStn_pathAnalysisOwnAntennaGainDbi())
|
||||
assertEquals(18.0, target.getStn_pathAnalysisOwnAntennaHeightMeters())
|
||||
assertEquals(400.0, target.getStn_pathAnalysisOwnTxPowerWatts())
|
||||
assertEquals(250.5, target.getStn_pathAnalysisOwnHeightAslMeters())
|
||||
}
|
||||
|
||||
@Test
|
||||
fun anEmptySiteElevationIsWrittenAsUnset() {
|
||||
val target = prefs { setStn_pathAnalysisOwnHeightAslMeters(612.0) }
|
||||
val antenna = WizardAntenna(stored())
|
||||
antenna.heightAslText = ""
|
||||
|
||||
antenna.writeTo(target)
|
||||
|
||||
assertTrue(target.getStn_pathAnalysisOwnHeightAslMeters().isNaN(), "empty hands the elevation back to the model")
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user