Register /metrics endpoint and HTTP instrumentation hooks on *app*. Also attempts to configure OpenTelemetry tracing if the SDK is available.

将拉取的 TLE 条目注入到星座卫星配置列表。 遍历 ``satellites`` 列表，按卫星名称模糊匹配 TLE 条目并设置 ``tle_line1`` / ``tle_line2`` 属性（若对象支持）。 参数 ---- entries : list

仅保留最近 n 条请求（按 submit_time），返回删除行数。

计算两颗卫星之间的激光 ISL 可达速率 (Mbps)。 包含地球遮挡判定：当视线被地球遮挡时返回 0.0。 Parameters ---------- sat1_pos : dict 卫星1位置，含 ``lat``、``lon``（度）、``al

返回缓冲中所有轨迹（从旧到新）。

Persist locale on change.

计算 t 时刻卫星位置。 参数 ---- t : datetime 目标时刻（naive 视为 UTC）。 返回 ---- (lat, lon, alt) : tuple[fl

删除 submit_time 早于 cutoff_ts 的请求，返回删除行数。

计算雨衰 A_rain (dB)，按 ITU-R P.618-13 / P.838-3 简化方法。 方法 ---- 1. 查 P.838 表得比雨衰系数 k、α。 2. 计算比雨衰 γ_R = k · R^α (dB/km)。 3. 等效斜路径长度 L_s

将偏轴扫描损耗折算到可达速率。 假设速率与信噪比线性相关（Shannon容量在线性域中与 SNR 单调）， 此处简化为：可达速率 ∝ 功率因子（线性近似）。 Parameters ---------- base_rate_mbps : float

注册兜底错误处理器，保证 4xx/5xx 都返回脱敏结构。

计算从当前指向切换到目标指向所需时间 (ms)。 以二范数计算角度空间中的欧氏距离作为扫描角变化量， 除以 scan_speed 得到重指向时间。 Parameters ---------- current_az_deg : float 当

Clear all request/runtime transmission state for a fresh server start.

选链入口：先过滤安全不兼容链路，再委托基础策略，最后限速。

Update the base URL and persist it to localStorage if non-empty.

* Switch the active locale.

* Switch to the given theme.

是否允许切换到 new_rate 的新链路。

Generator that yields SSE-formatted frames for a single HTTP connection. ``timeout`` – if > 0, close the stream after that many seconds (use

Launch the background snapshot-push thread (daemon, will not block shutdown).

Register a new subscriber and return its dedicated queue.

将遥测级别字符串转换为 Python logging 级别整数。

将场景字典序列化为 JSON 字符串。

将场景字典序列化为 YAML 字符串。 若 PyYAML 不可用，退回 JSON（并附带注释说明）。

计算总大气衰减（雨衰 + 气体吸收），返回各分量与合计。 Parameters ---------- freq_hz : float 载波频率（Hz）。 elevation_deg : float 卫星仰角（度）。 rainf

Remove a subscriber queue (called when the HTTP connection closes).

* Update coverage footprints for all LEO satellites and GEO relay visibility rings. * Called as part of updateScene to keep footprints in sync with

Pull current stats from the simulation engine and update Prometheus gauges/counters. Called on each /metrics scrape to keep values fresh.

校验场景字典的结构合法性。 Parameters ---------- data: 待校验的对象。 Returns ------- list[str]

启动时校验：生产模式下必须显式提供密钥，缺失即拒启。返回告警列表。

参数 ---- name : str 卫星名称（用于日志）。 tle_line1 : str, optional TLE 第一行；非 None 且 sgp4 可用时启用 SGP4 路径。

* 将 SSE snapshot 事件的内容应用到 Vue 响应式数据中。 * snapshot 结构与 /api/data 返回的结构兼容。

计算当前三类资源的平均利用率。

对 n 个随机点对计算大圆地心角。

统计结果列表中被拒绝（reject_reason 非 None/非空）的数量。

有效优先级 = 基础优先级 + 老化加权（随等待时间单调上升，封顶 AGING_MAX）。 使长期得不到链路的低优先级请求随等待自动升权，避免饥饿。

函数作用域内的隔离引擎（固定种子、不启动线程）。

加载黄金快照，供各测试用例复用。

* 根据传输方式返回对应的链路颜色（Cesium.Color）。 * - direct（直连）：金黄色 * - relay（单中继）：青绿色 * - multi_relay（多跳）：紫色 * @param {string} method - 传输方式

* 将传输速率（Mbps）归一化为链路线宽（1.5–6px）。 * 使用对数映射，使低速率链路也有明显变化。 * @param {number} rateMbps - 传输速率（Mbps） * @returns {number} 线宽（px）

* 节流控制器：仅当卫星数量变化或距上次刷新超过 60 秒（模拟时间）时才拉取新轨迹。 * 轨迹数据变化慢（轨道根数基本固定），无需每帧刷新。