From 55a1449a12de4d7dd62738845174a2812c033d8c Mon Sep 17 00:00:00 2001 From: ApsisRS contributors Date: Fri, 2 Oct 2026 01:58:31 +0800 Subject: [PATCH] docs: finish the rf test comments --- crates/rf/apsis-link/tests/budget.rs | 6 ++---- crates/rf/apsis-rf/tests/free_space.rs | 3 +-- 2 files changed, 3 insertions(+), 6 deletions(-) diff --git a/crates/rf/apsis-link/tests/budget.rs b/crates/rf/apsis-link/tests/budget.rs index 4f2ab59..e2ecc7c 100644 --- a/crates/rf/apsis-link/tests/budget.rs +++ b/crates/rf/apsis-link/tests/budget.rs @@ -41,8 +41,7 @@ fn downlink() -> LinkBudget { fn eirp_sums_the_power_gain_and_loss() { let budget = downlink(); // 10 dBW + 30 dBi - 1 dB = 39 dBW. - // 10 dBW + 30 dBi - 1 dB = 39 dBW。 - // 10 dBW + 30 dBi - 1 dB = 39 dBW。 + // 即发射功率加发射增益再减发射损耗，得出等效全向辐射功率。 let eirp = budget.eirp().expect("valid budget"); assert!((eirp.dbw().expect("positive") - 39.0).abs() < TOLERANCE); } @@ -66,8 +65,7 @@ fn the_carrier_power_matches_the_hand_computation() { let budget = downlink(); let carrier = budget.received_power().expect("valid budget"); // 39 dBW - 205.627 dB + 35 dBi - 0.5 dB = -132.127 dBW. - // 39 dBW - 205.627 dB + 35 dBi - 0.5 dB = -132.127 dBW。 - // 39 dBW - 205.627 dB + 35 dBi - 0.5 dB = -132.127 dBW。 + // 即从等效全向辐射功率减去路径损耗、加上接收增益、再减接收损耗。 assert!( (carrier.dbw().expect("positive") + 132.127_080_075_172_1).abs() < 1e-9, "{}", diff --git a/crates/rf/apsis-rf/tests/free_space.rs b/crates/rf/apsis-rf/tests/free_space.rs index 54c67b4..bb9c755 100644 --- a/crates/rf/apsis-rf/tests/free_space.rs +++ b/crates/rf/apsis-rf/tests/free_space.rs @@ -44,8 +44,7 @@ fn path_loss_matches_the_engineering_form() { // 链路预算中所用的形式，距离以千米、频率以兆赫兹计， // // L = 32.44 + 20 log10(d_km) + 20 log10(f_MHz) - // L = 32.44 + 20 log10(d_km) + 20 log10(f_MHz) - // L = 32.44 + 20 log10(d_km) + 20 log10(f_MHz) + // 即以千米计的距离与以兆赫兹计的频率表示的工程形式。 // // has a constant that follows from the speed of light rounded to // 299 792 458 m/s, and agrees with the expression used here to the