Knowledgebase
diff --git a/src/pages/SatellitePage.jsx b/src/pages/SatellitePage.jsx
new file mode 100644
index 0000000..a91c182
--- /dev/null
+++ b/src/pages/SatellitePage.jsx
@@ -0,0 +1,1169 @@
+import { useState, useMemo } from 'react'
+import { useSatelliteDesign } from '../hooks/useSatelliteDesign.js'
+import DesignSection from '../components/engine/DesignSection.jsx'
+import { formatValue } from '../engine/format.js'
+import { STRUCTURAL_MATERIALS } from '../engine/knowledgebaseData.js'
+import { CUBESAT_FORM_FACTORS, MODULATION_EB_N0 } from '../engine/satelliteCalcs.js'
+
+// ── Local primitives ────────────────────────────────────────────────────────
+
+function NumInput({ label, value, onChange, units, step, min, max, placeholder }) {
+ function handleChange(str) {
+ if (str === '') { onChange(null); return }
+ const v = parseFloat(str)
+ if (!isNaN(v)) onChange(v)
+ }
+ return (
+
+
+ handleChange(e.target.value)}
+ className="flex-1 min-w-0 px-2 py-1 bg-slate-800 border border-slate-600 rounded text-sm
+ text-slate-100 focus:border-blue-500 focus:outline-none placeholder-slate-600"
+ />
+ {units && {units}}
+
+ )
+}
+
+function SelectInput({ label, value, onChange, options }) {
+ return (
+
+
+
+
+ )
+}
+
+function TextInput({ label, value, onChange, placeholder }) {
+ return (
+
+
+ onChange(e.target.value)}
+ className="flex-1 min-w-0 px-2 py-1 bg-slate-800 border border-slate-600 rounded text-sm
+ text-slate-100 focus:border-blue-500 focus:outline-none placeholder-slate-600"
+ />
+
+ )
+}
+
+function CheckboxRow({ label, value, onChange }) {
+ return (
+
+
+ onChange(e.target.checked)}
+ className="w-4 h-4 accent-blue-500 cursor-pointer"
+ />
+
+ )
+}
+
+function ResultSection({ title, children }) {
+ return (
+
+ )
+}
+
+function ResultRow({ label, value, units, colorClass }) {
+ const color = colorClass ?? 'text-green-400'
+ return (
+
+ {label}
+
+ {value == null ? '—' : value}
+ {value != null && units ? {units} : null}
+
+
+ )
+}
+
+function StatusBadge({ status, labels }) {
+ const cfg = {
+ ok: { bg: 'bg-green-900/40 border-green-700', text: 'text-green-300' },
+ deficit: { bg: 'bg-red-900/40 border-red-700', text: 'text-red-300' },
+ failed: { bg: 'bg-red-900/40 border-red-700', text: 'text-red-300' },
+ marginal: { bg: 'bg-amber-900/40 border-amber-700', text: 'text-amber-300' },
+ overrun: { bg: 'bg-red-900/40 border-red-700', text: 'text-red-300' },
+ critical: { bg: 'bg-red-900/40 border-red-700', text: 'text-red-300' },
+ unknown: { bg: 'bg-slate-800 border-slate-600', text: 'text-slate-400' },
+ }
+ const s = cfg[status] ?? cfg.unknown
+ return (
+
+ {labels[status] ?? status}
+
+ )
+}
+
+// ── CubeSat SVG diagram ─────────────────────────────────────────────────────
+
+function CubeSatDiagram({ formFactor, deployablePanelArea }) {
+ const ff = CUBESAT_FORM_FACTORS[formFactor] ?? CUBESAT_FORM_FACTORS['3U']
+ const [W_mm,, L_mm] = ff.dims // width, (height is depth), length = long axis
+
+ // Scale body to fit in a ~120 × 200 px drawing area within 400×300 viewBox
+ const maxDrawW = 110, maxDrawH = 190
+ const scale = Math.min(maxDrawW / W_mm, maxDrawH / L_mm)
+ const drawW = W_mm * scale
+ const drawH = L_mm * scale
+ const cx = 200, cy = 148
+
+ const x0 = cx - drawW / 2
+ const y0 = cy - drawH / 2
+
+ const hasDeploy = deployablePanelArea > 0
+ const panelW = hasDeploy ? Math.min(78, Math.max(20, deployablePanelArea * 12000)) : 0
+ const panelH = drawH * 0.6
+ const panelY = cy - panelH / 2
+
+ return (
+
+ )
+}
+
+// ── Power orbit chart ───────────────────────────────────────────────────────
+
+function PowerOrbitChart({ orbitData, powerBudget, powerInputs }) {
+ const chartData = useMemo(() => {
+ if (!orbitData || !powerBudget || !powerBudget.C_batt) return null
+ const { t_sun, t_eclipse, T } = orbitData
+ const { chargeRateW, dischargeRateW, C_batt, DOD = 0.3 } = powerBudget
+ const DOD_val = powerInputs?.DOD ?? DOD ?? 0.3
+ const C_batt_Ws = C_batt * 3600 // Wh → Ws
+
+ const N = 120
+ const pts = []
+ let soc = 1.0 // start at full charge
+
+ // Steady-state: find starting SoC at eclipse entry
+ // SoC_min = 1 - DOD_val (minimum allowed)
+ // Actually let's simulate a full cycle starting from "end of sunlight"
+ for (let i = 0; i <= N; i++) {
+ const t = (i / N) * T
+ let s
+ if (t <= t_sun) {
+ // Sunlight: recharging from SoC after eclipse
+ // We start from SoC_after_eclipse and charge up
+ s = (1 - DOD_val) + (chargeRateW / C_batt_Ws) * t
+ } else {
+ // Eclipse: discharging
+ s = 1.0 - (dischargeRateW / C_batt_Ws) * (t - t_sun)
+ }
+ pts.push({ t, soc: Math.min(1.0, Math.max(0, s)) })
+ }
+ return { pts, t_sun, t_eclipse, T, DOD_val, soc_min: 1 - DOD_val }
+ }, [orbitData, powerBudget, powerInputs])
+
+ if (!chartData) {
+ return (
+
+
Enter orbit and power inputs to see chart
+
+
Enter link budget inputs to see chart
+
+
Enter thermal inputs to see chart
+
+
Enter subsystem masses to see chart
+
+ setPowerInput('solarCellType', v)}
+ options={['Si', 'GaAs', 'InGaP']} />
+ setPowerInput('etaCell', v)} step={0.01} units="—" />
+ setPowerInput('etaPacking', v)} step={0.01} units="—" />
+ setPowerInput('deployablePanelArea', v ?? 0)}
+ step={0.001} min={0} units="m²" placeholder="0" />
+
+
+
+
+
+ setPowerInput('DOD', v)} step={0.05} min={0} max={1} units="—" />
+ setPowerInput('etaCharge', v)} step={0.01} units="—" />
+ setPowerInput('etaDischarge', v)} step={0.01} units="—" />
+ setPowerInput('designLife', v)} step={0.5} min={0} units="yr" />
+ setPowerInput('degradationPerYear', v)}
+ step={0.005} units="—" placeholder="-0.030" />
+
+
+
+
+
+ setPowerInput('P_sunlight_load', v)} step={0.1} min={0} units="W" />
+ setPowerInput('P_eclipse_load', v)} step={0.1} min={0} units="W" />
+
+
+
+ )
+
+ if (activeTab === 'link') return (
+ <>
+
+
+ setLinkInput('P_tx_W', v)} step={0.1} min={0} units="W" />
+ setLinkInput('G_tx_dBi', v)} step={0.5} units="dBi" />
+ setLinkInput('L_feed_dB', v)} step={0.1} min={0} units="dB" />
+ setLinkInput('frequencyMHz', v)} step={1} min={1} units="MHz" />
+ {
+ setLinkInput('modulation', v)
+ setLinkInput('Eb_N0_req_dB', MODULATION_EB_N0[v] ?? linkInputs.Eb_N0_req_dB)
+ }}
+ options={Object.keys(MODULATION_EB_N0)} />
+
+
+
+
+
+ setLinkInput('elevationAngleDeg', v)} step={1} min={1} max={90} units="°" />
+ setLinkInput('L_atm_dB', v)} step={0.1} min={0} units="dB" />
+ setLinkInput('L_point_dB', v)} step={0.1} min={0} units="dB" />
+
+
+
+
+
+ setLinkInput('G_rx_dBi', v)} step={0.5} units="dBi" />
+ setLinkInput('T_sys_K', v)} step={10} min={1} units="K" />
+ setLinkInput('dataRateBps', v)} step={100} min={1} units="bps" />
+ setLinkInput('Eb_N0_req_dB', v)} step={0.1} units="dB" />
+
+
+
+ )
+
+ if (activeTab === 'thermal') return (
+ <>
+
+
+ setThermalInput('alpha', v)} step={0.01} min={0} max={1} units="—" />
+ setThermalInput('epsilon', v)} step={0.01} min={0} max={1} units="—" />
+
+
+
+
+
+ setThermalInput('A_sun', v)} step={0.001} min={0} units="m²" />
+ setThermalInput('A_earth', v)} step={0.001} min={0} units="m²" />
+ setThermalInput('A_rad', v)} step={0.001} min={0} units="m²" />
+
+
+
+
+
+
setThermalInput('Q_int', v)} step={0.1} min={0} units="W" />
+
+ Orbit-averaged solar flux and Earth IR are derived from the orbit parameters above.
+
+
+ setSubsystem('adcs', { controlMode: v })}
+ options={['sun-pointing', 'nadir', '3-axis stabilised']} />
+ setSubsystem('adcs', { pointingAccuracyDeg: v })} step={0.5} units="°" />
+ setSubsystem('adcs', { reactionWheels: v })} />
+ setSubsystem('adcs', { magnetorquers: v })} />
+ setSubsystem('adcs', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ setSubsystem('adcs', { avgPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('adcs', { peakPower: v ?? 0 })} step={0.1} min={0} units="W" />
+
+
+
+
+
+
setSubsystem('comms', { frequencyMHz: v })} step={1} units="MHz" />
+ setSubsystem('comms', { P_tx_W: v })} step={0.1} min={0} units="W" />
+ setSubsystem('comms', { antennaType: v })}
+ options={['dipole', 'patch', 'helical', 'yagi']} />
+ setSubsystem('comms', { modulation: v })}
+ options={Object.keys(MODULATION_EB_N0)} />
+ setSubsystem('comms', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ setSubsystem('comms', { avgPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('comms', { peakPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ Detailed link budget analysis in the Link tab.
+
+ setSubsystem('cdh', { processor: v })}
+ options={['ARM Cortex-M4', 'ARM Cortex-A9', 'LEON3', 'Raspberry Pi CM']} />
+ setSubsystem('cdh', { storageGB: v })} step={1} min={0} units="GB" />
+ setSubsystem('cdh', { housekeepingRateHz: v })} step={0.5} min={0} units="Hz" />
+ setSubsystem('cdh', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ setSubsystem('cdh', { avgPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('cdh', { peakPower: v ?? 0 })} step={0.1} min={0} units="W" />
+
+
+
+
+
+
setSubsystem('eps', { batteryChemistry: v })}
+ options={['Li-ion', 'LiPo', 'NiH2']} />
+ setSubsystem('eps', { solarCellType: v })}
+ options={['Si', 'GaAs', 'InGaP']} />
+ setSubsystem('eps', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ Solar array and battery sizing configured in Power tab.
+
+ setSubsystem('structure', { materialId: v })}
+ options={MATERIAL_OPTIONS} />
+ setSubsystem('structure', { configuration: v })}
+ options={['standard', 'custom']} />
+ setSubsystem('structure', { mass: v ?? 0 })} step={10} min={0} units="g" />
+
+
+
+
+
+ setSubsystem('propulsion', { type: v })}
+ options={[
+ { value: 'none', label: 'None' },
+ { value: 'cold_gas', label: 'Cold Gas' },
+ { value: 'monoprop', label: 'Monopropellant' },
+ { value: 'electrospray', label: 'Electrospray' },
+ ]} />
+ {subsystems.propulsion.type !== 'none' && (
+ <>
+ setSubsystem('propulsion', { propellant: v })}
+ placeholder="e.g. N₂, Hydrazine" />
+ setSubsystem('propulsion', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ setSubsystem('propulsion', { avgPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('propulsion', { peakPower: v ?? 0 })} step={0.1} min={0} units="W" />
+
+ )}
+
+
+
+
+
+ setSubsystem('payload', { name: v })}
+ placeholder="e.g. Multispectral Imager" />
+ setSubsystem('payload', { type: v })}
+ options={['Earth Obs', 'Science', 'Comms', 'Tech Demo', 'Other']} />
+ setSubsystem('payload', { mass: v ?? 0 })} step={10} min={0} units="g" />
+ setSubsystem('payload', { avgPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('payload', { peakPower: v ?? 0 })} step={0.1} min={0} units="W" />
+ setSubsystem('payload', { interface: v })}
+ options={['UART', 'SPI', 'I2C', 'Ethernet', 'USB', 'Custom']} />
+
+
+
+ )
+ return null
+ }
+
+ // ── Right panel content per tab ──
+ function renderRightResults() {
+ if (activeTab === 'power') return (
+ <>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {powerBudget && (
+
+ )}
+
+ )
+
+ if (activeTab === 'link') return (
+ <>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {linkBudget && (
+
+ )}
+
+ )
+
+ if (activeTab === 'thermal') return (
+ <>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {thermalBalance && (
+
+ )}
+
+ )
+
+ if (activeTab === 'subsystems') return (
+ <>
+
+ {massBudget?.breakdown.map(row => (
+
+ ))}
+ {massBudget && (
+ <>
+
+
+
+
+
+
+
+
+ )}
+
+
+
+
+
+
+
+
+ )
+ return null
+ }
+
+ return (
+
+ {/* Sub-header */}
+
+
+
Satellite Bus Design
+
+ {tabs.map(tab => (
+
+ ))}
+
+
+
+
+ {/* Three-column body */}
+
+ {/* ── Left: inputs ── */}
+
+ {/* Orbit & Mission always visible */}
+
+
+ setPowerInput('formFactor', v)}
+ options={FORM_FACTOR_OPTIONS} />
+ setOrbitInput('altitudeKm', v)} step={10} min={200} units="km" />
+ setOrbitInput('betaAngleDeg', v)} step={5} min={0} max={90} units="°"
+ placeholder="0" />
+
+
+
+ {renderLeftInputs()}
+
+
+ {/* ── Centre: CubeSat diagram + chart ── */}
+
+ {/* CubeSat diagram — fixed 240px height */}
+
+
+
+
+ {/* Tab chart — fills remaining space */}
+
+ {activeTab === 'power' &&
}
+ {activeTab === 'link' &&
}
+ {activeTab === 'thermal' &&
}
+ {activeTab === 'subsystems' &&
}
+
+
+
+ {/* ── Right: results ── */}
+
+ {renderRightResults()}
+
+
+
-
{label}
-
-
- {display}
-
- {unit && {unit}}
-
-
-
-
- onChange(parseFloat(e.target.value) || 0)}
- className="flex-1 px-2 py-1 bg-slate-800 border border-slate-600 rounded text-sm text-slate-100
- focus:border-blue-500 focus:outline-none"
- />
- {units && {units}}
-
-
-
-
-
- )
-}
-
-function ResultSection({ title, children }) {
- return (
-
-
- {title}
-
-
{children}
-
- {/* Main content area: left panel + center plot */}
-
- {/* Left panel */}
-
-
Trajectory Simulation
-
- {/* Import */}
-
-
-
- {importError && (
-
{importError}
- )}
-
-
- {/* Simulation parameters */}
-
-
- Engine Parameters
-
- trajectory.updateConfig('F', v)}
- units="N"
- step={100}
- />
- trajectory.updateConfig('Isp', v)}
- units="s"
- step={5}
- />
- trajectory.updateConfig('mdot', v)}
- units="kg/s"
- step={0.1}
- />
- trajectory.updateConfig('m_wet', v)}
- units="kg"
- />
- trajectory.updateConfig('m_dry', v)}
- units="kg"
- />
- trajectory.updateConfig('burnTime', v)}
- units="s"
- step={1}
- />
-
-
-
-
- Aerodynamics
-
- trajectory.updateConfig('Cd', v)}
- units=""
- step={0.01}
- />
- trajectory.updateConfig('A_ref', v)}
- units="m²"
- step={0.001}
- />
-
-
-
-
- Flight Profile
-
- trajectory.updateConfig('pitchStartAlt', v)}
- units="m"
- step={10}
- />
- trajectory.updateConfig('launchAngle', v)}
- units="°"
- step={1}
- />
- trajectory.updateConfig('dt', v)}
- units="s"
- step={0.01}
- />
- trajectory.updateConfig('t_max', v)}
- units="s"
- step={10}
- />
-
-
- {/* Run button */}
-
-
- {error && (
-
{error}
- )}
-
- {/* Results */}
- {simulationResults && (
-
-
-
-
-
-
-
-
-
-
- {currentState && (
-
-
-
-
-
-
-
-
- )}
-
- )}
-
-
- {/* Center: plot */}
- {simulationResults ? (
-
- trajectory.setCurrentTime(t)}
- />
-
- ) : (
-
-
- Import an engine and click "Run Simulation" to see trajectory
-
-
- )}
-
-
- {/* Timeline at bottom */}
- {simulationResults && (
-
trajectory.setIsPlaying(!trajectory.isPlaying)}
- playbackSpeed={trajectory.playbackSpeed}
- onPlaybackSpeedChange={trajectory.setPlaybackSpeed}
- />
- )}
-