handoverlab 2.3.0__tar.gz → 2.4.0__tar.gz

{handoverlab-2.3.0 → handoverlab-2.4.0}/CHANGELOG.md

@@ -7,6 +7,65 @@ All notable changes to this project are documented in this file. The format foll
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-10-22
+
+### Added
+
+- 7 GHz large-scale calibration (TR 38.901 V19.5.0 clause 7.8.1, Table 7.8-1A) in the `verify` group
+  `calibration`: UMa and UMi at 7 GHz, UMa and UMi at 6 GHz with the updated model, and SMa with ISD 1299 m and
+  1732 m (35 m sites with a mechanical downtilt of 95 / 92 deg through Eqs. 7.1-7 and 7.1-8, 20 % of the users
+  in cars with the car penetration loss, 80 % in residential and commercial buildings over their floors with the
+  low-loss A model), compared with the companies of 3GPP R1-2506406 (RAN1 #122; mean and range in
+  `verify/data/r1_2506406.csv`). Pre-registered result (30 000 users, seed 1): every percentile 5-95 % lies
+  inside the company range (18 of 18 case-metric pairs pass, 342 of 342 percentiles); the largest distance from
+  the company mean is 1.65-2.88 dB, so the second criterion (at most 1.5 dB) fails for all six cases. It is
+  reported as a note. The checks against R1-165974 are unchanged. `simulate_drops` takes the IRR-glass loss of
+  the case's reference when `irr_glass` is not given (unchanged for the old cases).
+- Compiled slot scheduler: with `run.backend: numba` (`pip install handoverlab[fast]`) the slots of
+  `protocol.scheduler` are played by a compiled loop (`handoverlab.engine._kernels.sched_slots`). The MCS
+  look-ups, logarithms and block error probabilities still come from the NumPy functions of the reference loop
+  (per-interval tables), and the loop uses only basic arithmetic in the reference order, so every result is
+  bit-identical to the NumPy loop (`tests/test_sched_kernel.py`, which also runs the loop's logic as plain Python
+  without Numba). On the ns-3 card the engine time with the scheduler drops by a factor of 8 to 60 (case and machine load) (about 3 times the rate model instead of 50-80 times; see `docs/performance.md`). The NumPy loop stays the reference and the default and runs in debug mode.
+- UE receive beams as an option of the beam model (`radio.beams.ue_panels` 1, 2 or 4, off by default): UE panels
+  of TR 38.802 V14.2.0 Table A.2.1-4 (Config 1: two panels 180 deg apart, Config 2: four at 90 deg; `ue_panel`
+  [M, N] = [2, 4] at half a wavelength, one polarisation) with the element of Table A.2.1-8 (model 1, 5 dBi;
+  = ITU-R M.2412-0 Table 11), `ue_beams` DFT receive beams per panel over `ue_beam_span_deg`, bearing uniform
+  per UE (`ue_orientation: random`) or along the direction of travel (`heading`). Measurements use the best
+  receive beam of the best panel (`ue_rx: best`; TS 38.215 5.1.1 receiver branches) or a sweep over the beams,
+  one per L1 instant, with the highest of the last samples reported (`sweep`); data, RLM, beam failure
+  detection and recovery and the interference use the serving receive beam. The FR2 time scaling of the sweep
+  was already in `protocol.meas_periods: ts38133` (Mmeas_period_w/o_gaps = 24, TS 38.133 V19.6.0 9.2.5.1) and is
+  not applied twice; `sweep` is refused with `ts38133`. New random stream `ue_beams`. Not combined with
+  `protocol.dc`. With the option off every result is unchanged. Guide: `docs/guides/ue-beams.md`.
+- AI/ML-based mobility after 3GPP TR 38.744 V19.0.1 (Release 19) as an optional rule, `a3_pred` (NumPy only, off
+  unless a run names it): prediction of the L3 cell-level RSRP of a cell from its own past L3 results (RRM
+  sub-use case 2), in case A (prediction window ahead; handover on the predicted Event A3, handover model
+  option 2 with the preparation started at the report) and case B (measurement skipping with MRRT =
+  skip / (skip + 1), L3 filtering options 1-3, Event A3 on the measured-and-predicted series, option 3).
+  Predictors: sample and hold (the non-AI baseline of TR 38.744 clause 5.1) and a ridge-regression
+  autoregressive model trained on runs of training seeds (`handoverlab.rules.predict.fit_predictor`,
+  `collect`, JSON weights), or a user object. Statistics after a run (`PredA3.stats`, `Recorder`): prediction
+  accuracy per horizon against the fully measured L3 result, MRRT, and the counters n1, n2, n3 and F1 score of
+  the indirect A3 event prediction (clause 5.3.1). With `act: false` and in case B without skipping the rule
+  gives the event log of `a3`. `handoverlab verify --only learning` gained four checks (P1-P4). Guide
+  `docs/guides/ai-mobility.md` with the evaluation against TR 38.744 and what is not modelled (RLF
+  prediction, frequency- and spatial-domain prediction, beam-level prediction, option 1, LCM); compliance rows
+  in `docs/standard-compliance.md`. Pre-registered evaluation (FR1 case B, FR2 case A): ridge more accurate
+  than sample and hold, errors rising with speed, PW and MRRT as TR 38.744 observes; MRRT 50 % costs
+  +0.7-0.9 percentage points of HOF rate; option 2 cuts the HOF rate from 2.4 % to 0.3 % but with 55 % more
+  attempts and three times the ping-pongs, and sample and hold does the same; generalization criterion G2
+  failed. Every existing result is unchanged.
+
+### Documentation
+
+- `docs/comparison.md`: HandoverLab next to ns-3 with 5G-LENA and the mmWave module, Simu5G, the Vienna 5G System
+  Level Simulator, the MATLAB 5G Toolbox, OpenAirInterface and Sionna on the points that matter for handover
+  studies (A3, CHO, DAPS, LTM, radio-link failure, dual connectivity, NTN, beams, fast fading and link-to-system
+  mapping, scheduler, speed and scale, licence, language, last release, validation against 3GPP). Every cell
+  about another tool cites its official documentation, repository or paper (accessed 2026-10-22); facts not
+  found are marked "not stated"; a section lists where the other tools are stronger.
+
 ## [2.3.0] - 2026-10-22
 
 ### Added
@@ -1005,7 +1064,8 @@ First alpha release (stage 1: the core simulator).
 - Documentation: README, user guide, contribution guide, citation file; CI on Linux, Windows and
   macOS with Python 3.9-3.12.
 
-[Unreleased]: https://github.com/mjs19971997/handoverlab/compare/v2.3.0...HEAD
+[Unreleased]: https://github.com/mjs19971997/handoverlab/compare/v2.4.0...HEAD
+[2.4.0]: https://github.com/mjs19971997/handoverlab/compare/v2.3.0...v2.4.0
 [2.3.0]: https://github.com/mjs19971997/handoverlab/compare/v2.2.0...v2.3.0
 [2.2.0]: https://github.com/mjs19971997/handoverlab/compare/v2.1.0...v2.2.0
 [2.1.0]: https://github.com/mjs19971997/handoverlab/compare/v2.0.0...v2.1.0

{handoverlab-2.3.0 → handoverlab-2.4.0}/CITATION.cff

@@ -11,7 +11,7 @@ abstract: >-
   measurement chain, a radio-link failure model, an outcome label for every handover attempt,
   a plug-in interface for handover rules, equal-budget tuning studies with paired statistics,
   and verification against hand-computed values, golden event-log fingerprints and ns-3 / 5G-LENA.
-version: "2.3.0"
+version: "2.4.0"
 doi: 10.5281/zenodo.23409131
 identifiers:
   - type: doi

{handoverlab-2.3.0 → handoverlab-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: handoverlab
-Version: 2.3.0
+Version: 2.4.0
 Summary: System-level handover simulator for 5G-Advanced and beyond-5G research
 Author: Mostafa Jalili Sanjarani, Yasser Elmi Sola
 License-Expression: MIT
@@ -193,11 +193,11 @@ the clause-by-clause detail is in [standard compliance](https://github.com/mjs19
 |---|---|---|---|
 | Layouts | `street_grid` (TR 37.885 urban grid), `open_area`, `highway` (TR 37.885 / TR 36.885, wrap-around), `indoor` (TR 38.901 office), `ntn` (one LEO satellite, TR 38.821); explicit site lists | sites on the pavement with small cells (urban cards); the TR 37.885 urban macro grid without wrap-around (`urban-macro-tr37885-4ghz`) | several satellites |
 | Channel | TR 38.901 path loss and LOS (UMi, UMa, RMa, SMa, InH), LOS from buildings, spatially consistent LOS and shadowing, car and O2I building penetration loss, radio maps from a file (clause 8), TR 38.811 for the satellite | received power per site and step with a slow time-varying component; indoor users keep the LOS state and shadowing of their position; optional TDL fast fading with effective SINRs (clause 7.7.2, since 2.2.0) | CDL and the full fast-fading model of clause 7.5, MIMO |
-| Beams and carriers | SSB beams per sector, cell quality from beams, beam failure detection and recovery, several carriers with gaps and Event A5; dual connectivity (NR-DC: SN addition, PSCell change, SN release, SCG failure; option since 2.3.0) | the TR 38.901 antenna element and DFT beams; isotropic UE; the SCG as one PSCell with a full-buffer share | UE-side beamforming, conditional PSCell change, fast MCG recovery |
+| Beams and carriers | SSB beams per sector, cell quality from beams, beam failure detection and recovery, several carriers with gaps and Event A5; dual connectivity (NR-DC: SN addition, PSCell change, SN release, SCG failure; option since 2.3.0) | the TR 38.901 antenna element and DFT beams; isotropic UE unless UE receive panels are set (option since 2.4.0); the SCG as one PSCell with a full-buffer share | UE transmit beams and polarisation, conditional PSCell change, fast MCG recovery |
 | Mobility | street-following vehicles (60 km/h, two lanes), highway lanes at 70/140 km/h, a train at 350 km/h (TR 38.854), random waypoints, pedestrians | constant speed per user | handheld rotation and body blockage |
 | Traffic and load | constant rates per 5QI, full buffer, periodic, FTP model 3; cell load drives interference | rate from SINR (Shannon-type mapping), no scheduler | slot scheduler, HARQ, RLC/PDCP, TCP and applications |
 | Measurements | L1 samples with error, TS 38.331 L3 filter, TS 38.133 measurement periods and gaps (option) | wideband RSRP; SS-RSRP per resource element with beams/carriers | RSRQ, CSI reporting |
-| Procedures | baseline (A3), CHO, DAPS, LTM, conditional LTM, CHO with D1/D2 for satellites, A3/A5 between carriers; rules `a3`, `a3a5`, `a3_mro`, `a3_bandit`, `dqn`, `cho`, `cho_d2`, `daps`, `ltm`, `cltm` | fixed preparation, command and execution delays; re-establishment always succeeds after a fixed outage | condEventT1, RACH-less NTN handover, Xn signalling in detail |
+| Procedures | baseline (A3), CHO, DAPS, LTM, conditional LTM, CHO with D1/D2 for satellites, A3/A5 between carriers; rules `a3`, `a3a5`, `a3_mro`, `a3_bandit`, `dqn`, `a3_pred`, `cho`, `cho_d2`, `daps`, `ltm`, `cltm` | fixed preparation, command and execution delays; re-establishment always succeeds after a fixed outage | condEventT1, RACH-less NTN handover, Xn signalling in detail |
 | Failure model | Qout/Qin with windows, N310/N311/T310, T304, command received during T310, re-establishment, link-monitoring restart | Qout/Qin as SINR thresholds (TR 36.839 values) instead of the BLER of a hypothetical PDCCH | BLER-based link monitoring; absolute failure rates are not calibrated: compare rules with each other |
 | Time | 10 ms step by default (`protocol.step_s`); the effect of the step is measured in [time step](https://github.com/mjs19971997/handoverlab/blob/main/docs/time-step.md) | events rounded to the step | sub-slot timing |
 
@@ -218,7 +218,8 @@ networks with small cells 50-300 m apart. Three paths lead beyond 5G:
 - **Non-terrestrial networks**: a LEO satellite with earth-moving beams (TR 38.811, TR 38.821) and conditional
   handover with condEventD2 (TS 38.331 Release 18).
 - **Learning-based mobility**: the rule interface gives a rule every measurement and the outcome of every
-  attempt; `a3_bandit` and `dqn` are examples, `a3_mro` the fair tuned baseline.
+  attempt; `a3_bandit` and `dqn` are examples, `a3_mro` the fair tuned baseline, and `a3_pred` follows the
+  RRM measurement prediction of TR 38.744 (Release 19).
 
 6G itself is at the stage of requirements: TR 38.914 V20.1.0 (Release 20, last changed at RAN #113 in September
 2026) sets scenarios and key performance requirements but specifies no handover procedure, timer or measurement
@@ -434,6 +435,10 @@ the pages are plain Markdown in [docs/](https://github.com/mjs19971997/handoverl
 - [Scenario cards](https://github.com/mjs19971997/handoverlab/tree/main/docs/scenarios): the built-in scenarios with the source of every parameter.
 - [Verification](https://github.com/mjs19971997/handoverlab/blob/main/docs/verification.md), [failure-model calibration](https://github.com/mjs19971997/handoverlab/blob/main/docs/calibration.md) and
   [performance](https://github.com/mjs19971997/handoverlab/blob/main/docs/performance.md).
+- [Comparison with other simulators](https://github.com/mjs19971997/handoverlab/blob/main/docs/comparison.md): ns-3 with 5G-LENA
+  and the mmWave module, Simu5G, the Vienna 5G System Level Simulator, the MATLAB 5G Toolbox, OpenAirInterface
+  and Sionna on handover procedures, failure model, NTN, beams, PHY abstraction, scheduler, scale and validation,
+  each cell with its source, including where the other tools are stronger.
 - [Changelog](https://github.com/mjs19971997/handoverlab/blob/main/CHANGELOG.md), [contribution guide](https://github.com/mjs19971997/handoverlab/blob/main/CONTRIBUTING.md) and [releasing](https://github.com/mjs19971997/handoverlab/blob/main/docs/RELEASING.md).
 
 ## Roadmap

{handoverlab-2.3.0 → handoverlab-2.4.0}/README.md

@@ -135,11 +135,11 @@ the clause-by-clause detail is in [standard compliance](https://github.com/mjs19
 |---|---|---|---|
 | Layouts | `street_grid` (TR 37.885 urban grid), `open_area`, `highway` (TR 37.885 / TR 36.885, wrap-around), `indoor` (TR 38.901 office), `ntn` (one LEO satellite, TR 38.821); explicit site lists | sites on the pavement with small cells (urban cards); the TR 37.885 urban macro grid without wrap-around (`urban-macro-tr37885-4ghz`) | several satellites |
 | Channel | TR 38.901 path loss and LOS (UMi, UMa, RMa, SMa, InH), LOS from buildings, spatially consistent LOS and shadowing, car and O2I building penetration loss, radio maps from a file (clause 8), TR 38.811 for the satellite | received power per site and step with a slow time-varying component; indoor users keep the LOS state and shadowing of their position; optional TDL fast fading with effective SINRs (clause 7.7.2, since 2.2.0) | CDL and the full fast-fading model of clause 7.5, MIMO |
-| Beams and carriers | SSB beams per sector, cell quality from beams, beam failure detection and recovery, several carriers with gaps and Event A5; dual connectivity (NR-DC: SN addition, PSCell change, SN release, SCG failure; option since 2.3.0) | the TR 38.901 antenna element and DFT beams; isotropic UE; the SCG as one PSCell with a full-buffer share | UE-side beamforming, conditional PSCell change, fast MCG recovery |
+| Beams and carriers | SSB beams per sector, cell quality from beams, beam failure detection and recovery, several carriers with gaps and Event A5; dual connectivity (NR-DC: SN addition, PSCell change, SN release, SCG failure; option since 2.3.0) | the TR 38.901 antenna element and DFT beams; isotropic UE unless UE receive panels are set (option since 2.4.0); the SCG as one PSCell with a full-buffer share | UE transmit beams and polarisation, conditional PSCell change, fast MCG recovery |
 | Mobility | street-following vehicles (60 km/h, two lanes), highway lanes at 70/140 km/h, a train at 350 km/h (TR 38.854), random waypoints, pedestrians | constant speed per user | handheld rotation and body blockage |
 | Traffic and load | constant rates per 5QI, full buffer, periodic, FTP model 3; cell load drives interference | rate from SINR (Shannon-type mapping), no scheduler | slot scheduler, HARQ, RLC/PDCP, TCP and applications |
 | Measurements | L1 samples with error, TS 38.331 L3 filter, TS 38.133 measurement periods and gaps (option) | wideband RSRP; SS-RSRP per resource element with beams/carriers | RSRQ, CSI reporting |
-| Procedures | baseline (A3), CHO, DAPS, LTM, conditional LTM, CHO with D1/D2 for satellites, A3/A5 between carriers; rules `a3`, `a3a5`, `a3_mro`, `a3_bandit`, `dqn`, `cho`, `cho_d2`, `daps`, `ltm`, `cltm` | fixed preparation, command and execution delays; re-establishment always succeeds after a fixed outage | condEventT1, RACH-less NTN handover, Xn signalling in detail |
+| Procedures | baseline (A3), CHO, DAPS, LTM, conditional LTM, CHO with D1/D2 for satellites, A3/A5 between carriers; rules `a3`, `a3a5`, `a3_mro`, `a3_bandit`, `dqn`, `a3_pred`, `cho`, `cho_d2`, `daps`, `ltm`, `cltm` | fixed preparation, command and execution delays; re-establishment always succeeds after a fixed outage | condEventT1, RACH-less NTN handover, Xn signalling in detail |
 | Failure model | Qout/Qin with windows, N310/N311/T310, T304, command received during T310, re-establishment, link-monitoring restart | Qout/Qin as SINR thresholds (TR 36.839 values) instead of the BLER of a hypothetical PDCCH | BLER-based link monitoring; absolute failure rates are not calibrated: compare rules with each other |
 | Time | 10 ms step by default (`protocol.step_s`); the effect of the step is measured in [time step](https://github.com/mjs19971997/handoverlab/blob/main/docs/time-step.md) | events rounded to the step | sub-slot timing |
 
@@ -160,7 +160,8 @@ networks with small cells 50-300 m apart. Three paths lead beyond 5G:
 - **Non-terrestrial networks**: a LEO satellite with earth-moving beams (TR 38.811, TR 38.821) and conditional
   handover with condEventD2 (TS 38.331 Release 18).
 - **Learning-based mobility**: the rule interface gives a rule every measurement and the outcome of every
-  attempt; `a3_bandit` and `dqn` are examples, `a3_mro` the fair tuned baseline.
+  attempt; `a3_bandit` and `dqn` are examples, `a3_mro` the fair tuned baseline, and `a3_pred` follows the
+  RRM measurement prediction of TR 38.744 (Release 19).
 
 6G itself is at the stage of requirements: TR 38.914 V20.1.0 (Release 20, last changed at RAN #113 in September
 2026) sets scenarios and key performance requirements but specifies no handover procedure, timer or measurement
@@ -376,6 +377,10 @@ the pages are plain Markdown in [docs/](https://github.com/mjs19971997/handoverl
 - [Scenario cards](https://github.com/mjs19971997/handoverlab/tree/main/docs/scenarios): the built-in scenarios with the source of every parameter.
 - [Verification](https://github.com/mjs19971997/handoverlab/blob/main/docs/verification.md), [failure-model calibration](https://github.com/mjs19971997/handoverlab/blob/main/docs/calibration.md) and
   [performance](https://github.com/mjs19971997/handoverlab/blob/main/docs/performance.md).
+- [Comparison with other simulators](https://github.com/mjs19971997/handoverlab/blob/main/docs/comparison.md): ns-3 with 5G-LENA
+  and the mmWave module, Simu5G, the Vienna 5G System Level Simulator, the MATLAB 5G Toolbox, OpenAirInterface
+  and Sionna on handover procedures, failure model, NTN, beams, PHY abstraction, scheduler, scale and validation,
+  each cell with its source, including where the other tools are stronger.
 - [Changelog](https://github.com/mjs19971997/handoverlab/blob/main/CHANGELOG.md), [contribution guide](https://github.com/mjs19971997/handoverlab/blob/main/CONTRIBUTING.md) and [releasing](https://github.com/mjs19971997/handoverlab/blob/main/docs/RELEASING.md).
 
 ## Roadmap

{handoverlab-2.3.0 → handoverlab-2.4.0}/docs/calibration-3gpp.md

@@ -81,6 +81,58 @@ distribution, at most 0.12 dB below the smallest company value: the SIR of Hando
 0.5 dB below the industry mean there, which is on the conservative side. `handoverlab verify`
 passes a case when every percentile lies inside the company range widened by 0.5 dB.
 
+## 7 GHz: Table 7.8-1A against R1-2506406 (since 2.4.0)
+
+**Summary.** TR 38.901 V19.5.0 adds Table 7.8-1A to clause 7.8.1: UMa, UMi-Street Canyon and suburban macro
+(SMa, ISD 1299 m and 1732 m) at 7 GHz, plus UMa and UMi at 6 GHz again "with updated channel modeling". The
+companies reported their CDFs in the 3GPP contribution **R1-2506406** (RAN1 #122, Bengaluru, August 2025,
+InterDigital and ZTE, "Calibration Results for 7 - 24 GHz SI";
+[3GPP server](https://www.3gpp.org/ftp/tsg_ran/WG1_RL1/TSGR1_122/Docs/R1-2506406.zip); large-scale workbook
+`Calibration_LS_v35`, based on TR 38.901 V19.0.0). The criteria were fixed before the first run: every
+percentile 5-95 % inside the company range widened by 0.5 dB (C1, the rule of the cases above), and the
+largest distance from the company mean at most 1.5 dB per case (C2). Result, 30 000 users per case, seed 1:
+**C1 passes for all 18 case-metric pairs (342 of 342 percentiles strictly inside the range); C2 fails for all
+six cases (largest distance 1.65-2.88 dB).** `handoverlab verify` runs C1 as checks and C2 as notes in the
+group `calibration`.
+
+**The reference.** `src/handoverlab/verify/data/r1_2506406.csv` keeps, in the format of `r1_165974.csv`, the
+mean, the smallest and the largest company value and the number of companies per case, metric and percentile;
+the mean equals the workbook's own mean column. Companies with complete columns: 16 (coupling loss) / 15
+(SINR, SIR) at 6 GHz; 17 / 16 for UMa and UMi at 7 GHz (Huawei, InterDigital, Samsung, ZTE, CATT, Lenovo,
+Apple, Nokia, Ericsson, OPPO, MediaTek, Intel, Sharp, Spreadtrum, LGE, ETRI, Xiaomi; Spreadtrum gave the
+coupling loss only); 17 / 16 for SMa 1299 m (with vivo, without ETRI); 13 / 12 for SMa 1732 m.
+
+**The drop.** UMa and UMi as above (Table 7.8-1), with the IRR-glass loss of V19.5.0 (25.4 + 0.11 f dB) because
+the companies worked with Release 19; at 7 GHz 49 dBm (UMa) and 44 dBm (UMi) with 20 MHz, the 6 GHz values of
+Table 7.8-1, which Table 7.8-1A leaves unchanged for these two scenarios. SMa:
+
+| Item | Setting | Source |
+|---|---|---|
+| Layout | 19 sites, 3 sectors, ISD 1299 m or 1732 m, BS 35 m, geographical wrap-around, minimum 2D distance 35 m (to d2D-out) | Tables 7.2-5, 7.8-1A |
+| Antenna | element of Table 7.3-1 and 10 vertical elements (one port) without electrical tilt, the panel tilted mechanically to 95 deg (ISD 1299 m) or 92 deg (ISD 1732 m): the angles are taken into the antenna's local coordinates with Eqs. 7.1-7 and 7.1-8 | Tables 7.3-1, 7.8-1A; clause 7.1.3 |
+| Users | 20 % outdoors (in cars, 1.5 m) with the car penetration loss N(9 dB, 5 dB) of non-metallic windows; 80 % indoors, 90 % of them in residential buildings (1.5 or 4.5 m), 10 % in commercial buildings (1.5 ... 13.5 m), uniform over the floors | Tables 7.2-5, 7.8-1A; clause 7.4.3.2 |
+| O2I loss | low-loss A model (30 % glass, 70 % plywood, sigma_P 4.4 dB); d2D-in = minimum of two uniform variables up to 10 m (residential) or 25 m (commercial) | clause 7.4.3.1, Tables 7.4.3-1, 7.4.3-2 |
+| Path loss, LOS, shadowing | the SMa models of `handoverlab.channel.pathloss` (Table 7.4.1-1; LOS probability of Table 7.4.2-1 without vegetation); shadowing 4 dB (LOS below d_BP), 6 dB (LOS beyond), 8 dB (NLOS), 8 dB for indoor users | Tables 7.4.1-1, 7.4.2-1, 7.5-6 Part-4 |
+| Link budget | 49 dBm, 20 MHz, UT noise figure 9 dB, isotropic UT, attachment to the highest coupling gain | Tables 7.8-1, 7.8-1A |
+
+Results (median HandoverLab / company mean; percentiles 5-95 % strictly inside the range; largest distance
+from the mean):
+
+| Case | Coupling loss [dB] | SINR [dB] | SIR [dB] | C1 | C2 (largest distance) |
+|---|---|---|---|---|---|
+| UMa-6 GHz | 119.9 / 121.0; 19/19; 1.65 | 5.5 / 5.6; 19/19; 1.34 | 8.0 / 8.0; 19/19; 0.17 | pass | fail (1.65) |
+| UMi-6 GHz | 111.9 / 112.1; 19/19; 2.88 | 5.1 / 5.2; 19/19; 1.35 | 6.8 / 6.6; 19/19; 0.53 | pass | fail (2.88) |
+| UMa-7 GHz | 121.7 / 122.4; 19/19; 1.78 | 5.0 / 5.0; 19/19; 0.90 | 7.9 / 7.9; 19/19; 0.29 | pass | fail (1.78) |
+| UMi-7 GHz | 113.8 / 113.3; 19/19; 2.43 | 4.7 / 4.8; 19/19; 1.63 | 6.7 / 6.6; 19/19; 0.30 | pass | fail (2.43) |
+| SMa-7 GHz, ISD 1299 m | 103.5 / 104.3; 19/19; 1.31 | 5.9 / 5.7; 19/19; 1.69 | 5.9 / 5.9; 19/19; 1.57 | pass | fail (1.69) |
+| SMa-7 GHz, ISD 1732 m | 109.2 / 111.3; 19/19; 2.24 | 6.3 / 5.9; 19/19; 1.07 | 6.4 / 6.6; 19/19; 0.32 | pass | fail (2.24) |
+
+Where the distance comes from: for UMa and UMi the coupling loss of the best users (75-95 %, close to a site)
+is 1.6-2.9 dB lower than the company mean, and at UMi 7 GHz also at 5-10 %; the medians are within 1.1 dB.
+For SMa 1732 m the coupling loss is about 2.1 dB lower than the mean over most of the distribution. The
+company spread is large here (at the median, from 106.5 dB to 129.4 dB for SMa 1732 m), so the mean is a soft
+target, but C2 was fixed before the run and is reported as it came. No parameter was changed after the run.
+
 ## What this calibration covers, and what it does not
 
 - It covers the **radio model**: the path-loss formulas, the LOS probabilities, the shadowing, the
@@ -98,8 +150,8 @@ passes a case when every percentile lies inside the company range widened by 0.5
 ## Repeat it
 
 ```bash
-handoverlab verify --only calibration          # 10 000 users per case, a few seconds
-handoverlab verify --only calibration --full   # 30 000 users per case, the table above
+handoverlab verify --only calibration          # 10 000 users per case, under a minute
+handoverlab verify --only calibration --full   # 30 000 users per case, the tables above
 python tools/make_calibration_figure.py        # docs/images/calibration_38901.png
 ```
 
@@ -110,4 +162,6 @@ case = cal.CalScenario("UMa", 6.0)
 res = cal.simulate_drops(case, n_users=30000, seed=1)
 for c in cal.compare(case, res):
     print(c.metric, c.inside.sum(), "of", len(c.percentiles), "inside, largest distance", c.max_dev_db)
+
+case = cal.CalScenario("SMa", 7.0, isd_m=1299.0, reference="R1-2506406")   # compared with R1-2506406
 ```

handoverlab-2.4.0/docs/comparison.md

@@ -0,0 +1,199 @@
+# Comparison with other simulators
+
+This page sets HandoverLab 2.4.0 next to other open or widely used 5G simulators and emulators, on the points
+that matter for handover and mobility studies. It is meant to help you pick the right tool for a question, not
+to rank tools: most of them were built for other questions, and several are far more detailed than HandoverLab
+in layers that HandoverLab abstracts.
+
+**How the table was made.** Every cell about another tool comes from that project's own documentation,
+repository (README, docs, source tree, release notes) or its peer-reviewed paper; the source labels in brackets
+point to the [list of sources](#sources), all accessed on 2026-10-22. **"not stated"** means the fact was not found
+in those sources; it does not prove that the feature is absent, and a later release may add it. Corrections are
+welcome as issues. The HandoverLab column follows the code and the pages of this site for version 2.4.0.
+
+Tools compared (latest release found on 2026-10-22):
+
+| Tool | Kind | Latest release | Licence | Language |
+|---|---|---|---|---|
+| HandoverLab | system-level, procedure-centred, time-stepped | 2.4.0 (2026-10-22) | MIT | Python (optional Numba kernel) |
+| ns-3 with 5G-LENA (`nr` module) | packet-level, end-to-end, discrete-event | v5.1 (2026-08-06, ns-3.48) [L5] | GPLv2 [L6] | C++ [L6] |
+| ns-3 mmWave module (NYU / UniPD) | packet-level, end-to-end, discrete-event | v8.0 (2024-06-26, ns-3.42) [M2] | GPL-2.0 [M1] | C++ [M1] |
+| Simu5G (OMNeT++ / INET) | packet-level, end-to-end, discrete-event; real-time emulation | 1.8.0 (2026-10-07) [S2] | LGPL-3.0 [S7] | C++ and NED [S1] |
+| Vienna 5G System Level Simulator | system-level, link abstraction from link-level curves | 1.4 (October 2023) [V3, V4] | academic use only, non-commercial [V5] | MATLAB [V2, V3] |
+| MATLAB 5G Toolbox, system-level part | system-level with abstract or full PHY | R2026b (2026-09-24) [W12] | proprietary; nrGNB / nrUE also need the Wireless Network Toolbox since R2026a [W3, W13] | MATLAB |
+| OpenAirInterface 5G RAN | real-time protocol stack (emulator with RF simulator, or real radios) | v3.0.0 (October 2026) [O4] | CSSL v1.0 (code) [O1] | C [O1] |
+| NVIDIA Sionna (PHY, SYS, RT) | link-level library with a system-level part (SYS), GPU | v2.2.0 (2026-09-29) [N2] | Apache-2.0 [N1] | Python (PyTorch since 2.0.0) [N2] |
+
+## Handover and mobility procedures
+
+| Tool | Event A3 / RRC handover | CHO | DAPS | LTM | Radio-link failure | Dual connectivity |
+|---|---|---|---|---|---|---|
+| HandoverLab 2.4.0 | yes: report, preparation, command, execution; A5 between carriers; a rule on predicted measurements after TR 38.744 ([AI/ML mobility](guides/ai-mobility.md)) | yes (Rel-16, up to 8 candidates; D1/D2 for NTN) | yes | yes, and conditional LTM | Qout/Qin as SINR thresholds with windows (or the MIESM effective SINR of the hypothetical PDCCH with fading), N310/N311/T310, T304, command during T310, re-establishment after a fixed outage; absolute failure rates are not calibrated | NR-DC as an option: SN addition, PSCell change, SN release, SCG failure; no EN-DC |
+| ns-3 5G-LENA v5.1 | yes: X2-based, intra- and inter-frequency, A3 and A2-A4 algorithms, CIO; TTT scaling and ping-pong guards in v5.1 [L2, L3, L5] | not stated | not stated | not stated | Qout/Qin from the hypothetical-PDCCH BLER, N310/N311/T310, re-establishment; optional TR 36.839 handover-failure model (v5.1) [L2, L4, L5] | no: "out of scope and is future work" [L3] |
+| ns-3 mmWave v8.0 | mmWave secondary-cell switch coordinated by the LTE eNB (SINR difference with fixed or dynamic TTT), not an A3 configuration as such [M1, M4, M5] | not stated | not stated | not stated | mmWave outage by an SINR threshold; T310/N310: not stated [M4] | LTE-mmWave DC (LTE master, mmWave secondary) [M1, M5]; NR-DC: not stated |
+| Simu5G 1.8.0 | yes: Xn-prepared handover on a measurement report with the best cell, hysteresis on RSSI; A3 with TTT: not stated [S3, S4] | not stated | not stated | not stated | RLF when an RLC AM PDU exceeds its retransmission limit, RRC re-establishment (T311 = 0 disables it by default); T310/N310: not stated [S2] | EN-DC and NE-DC with split bearers [S1, S6]; NR-DC: not stated |
+| Vienna 5G SLS 1.4 | no handover procedure described; cell association by received power or SINR, fixed per segment [V1] | not stated | not stated | not stated | not stated; "we omit the implementation of the complete protocol stack" [V1] | not stated |
+| MATLAB 5G Toolbox R2026b | not stated; UE mobility models exist, the mobility example uses one gNB [W4, W6, W7] | not stated | not stated | not stated | not stated; the node stack is traffic, RLC, MAC and PHY [W5] | not stated; carrier aggregation since R2026b [W10] |
+| OpenAirInterface v3.0.0 | yes: A3 or manual triggers, intra-/inter-frequency, F1 inter-DU and N2 inter-gNB [O2, O3, O4] | not stated | not stated | not stated | RLF declared by the MAC after a number of PUSCH DTX, RRC re-establishment; T310/N310: not stated [O4, O6] | EN-DC (NSA "unstable (only one UE connection)") and NR-DC [O2, O4] |
+| Sionna v2.2.0 | no: the SYS tutorial excludes handover, users attach to the nearest base station [N6] | not stated | not stated | not stated | not stated | not stated |
+
+## Radio, beams and PHY abstraction
+
+| Tool | NTN | Beams | Fast fading and link-to-system mapping | Scheduler |
+|---|---|---|---|---|
+| HandoverLab 2.4.0 | one LEO satellite with earth-moving beams (TR 38.811, TR 38.821), CHO with D2; no several satellites, Doppler or earth-fixed beams ([NTN guide](guides/ntn.md)) | SSB beams per sector from the TR 38.901 element and DFT beams, cell quality from beams, beam failure detection and recovery; UE receive beams optional (1, 2 or 4 panels, [UE beams](guides/ue-beams.md)), isotropic UE by default; no MIMO ([beams](guides/beams-layers.md)) | off by default (large-scale channel with a slow time-varying part); option: TDL-A to TDL-E with MIESM for link monitoring and a capacity-equivalent SINR for the rate; no CDL ([fading](guides/fading.md)) | by default a rate model without a scheduler; option: slot scheduler RR or PF with MCS, TBS and HARQ (base engine only; with `run.backend: numba` 11-59 times faster than its NumPy loop, bit-identical) ([scheduler](guides/scheduler.md)) |
+| ns-3 5G-LENA v5.1 | NTN channel (TR 38.811, from ns-3 mainline [L9]) and a LEO mobility example [L1, L2] | ideal and SRS-based realistic beamforming; beam management "Simplified model; no SSB blocks" [L1]; quasi-omni beams in the RRC / handover context [L3] | TR 38.901 with fast fading; EESM-based PHY abstraction with SINR-BLER tables [L1, L8] | PF, RR, MR, QoS-aware, RL-based; OFDMA and TDMA [L1] |
+| ns-3 mmWave v8.0 | TR 38.811 channel inherited from ns-3.42; no NTN protocol features stated [M2] | SVD- and DFT-based beamforming; NR beam tracking listed as future work [M1, M3] | TR 38.901 channel, ray-tracing and measured traces; EESM error model from 5G-LENA [M1, M3] | flexible-TTI RR, PF, max-rate, max-weight [M1] |
+| Simu5G 1.8.0 | not in the official release; separate third-party work exists [S10] | not stated; antenna-gain link budget only [S1] | path loss, LOS and shadowing of TR 36.814 / 36.873 / 38.901 with Jakes or Rayleigh fading; reception from SINR and BLER curves [S5, S6] | MAX C/I, PF, DRR, QoS-aware PF [S1] |
+| Vienna 5G SLS 1.4 | not stated | precoding and MIMO (CLSM / OLSM, MU-MIMO); no beam-management procedure described [V1, V2] | small-scale fading per slot (TR 38.901 CDL, PDP models, QuaDRiGa interface); post-equalisation SINR mapped to BLER with tables from the Vienna link-level simulator [V1, V2] | RR, best CQI, weighted RR, QoS-aware, ZF MU-MIMO [V2] |
+| MATLAB 5G Toolbox R2026b | system-level LEO transparent-payload example with static satellite and UEs, no handover (R2026b) [W8] | system-level example with P-2 beam measurement and reporting, without SSB sweeping [W9] | CDL, TR 38.901 system-level channel or custom; abstract PHY (RBIR mapping and lookup tables) or full PHY [W2, W4, W5] | RR, PF, best CQI and custom schedulers [W2] |
+| OpenAirInterface v3.0.0 | GEO and LEO transparent satellites; RF simulator with LEO delay and Doppler [O5, O10] | basic FR2 beam management; analog beamforming; beam gains in the RF simulator [O4, O7, O8] | full PHY on time-domain samples; channel simulator with TR 36.873 / 38.901 models; no abstraction needed [O8, O9] | proportional fair [O2, O6] |
+| Sionna v2.2.0 | not stated; the official 3GPP channel page lists TDL, CDL, UMi, UMa, RMa, InH and InF [N7] | TR 38.901 panel arrays; beam management: not stated [N6] | TR 38.901 TDL, CDL, UMi, UMa, RMa, InH, InF; PHY abstraction with EESM and BLER tables [N4, N7] | PF for single-user MIMO; link adaptation and power control [N3, N5] |
+
+## Speed, scale and validation
+
+| Tool | Speed and scale | Validation against 3GPP |
+|---|---|---|
+| HandoverLab 2.4.0 | one process: 2 rules, 40 users, 76 cells, 60 s simulated in 10-15 s on a modest virtual machine (1.11.0 timings, [performance](performance.md)); many rules share one world; no published figures for thousands of nodes | large-scale calibration of TR 38.901 clause 7.8.1 against the 21 companies of R1-165974 (325 of 342 percentiles inside the range) and at 7 GHz against R1-2506406 (all 342 percentiles inside the range, 1.7-2.9 dB from the company mean, [details](calibration-3gpp.md)); handover counts against ns-3 / 5G-LENA; failure levels differ from ns-3 ([calibration](calibration.md)); clause-by-clause [standard compliance](standard-compliance.md) |
+| ns-3 5G-LENA v5.1 | runtime numbers: not stated for the module; a MIMO channel speed-up of up to 16 times is reported in a WNS3 paper [L11]; the calibration scenario has 12 gNBs and 120 UEs [L10] | calibrated in 3GPP outdoor reference scenarios (SIMPAT 2022) [L7]; calibration examples for RP-180524 [L2]; mobility checked against TR 36.839 (v5.1) [L5] |
+| ns-3 mmWave v8.0 | not stated | not stated (examples "verify its correct functioning" [M6]) |
+| Simu5G 1.8.0 | background cells and UEs for large scenarios; real-time emulation of "hundreds of simulated users and tens of cells" on one desktop [S1, S9] | PHY abstraction validated in 3GPP-based scenarios [S8]; fingerprint regression tests [S1] |
+| Vienna 5G SLS 1.4 | "more than 7000 users" in less than 16 GB RAM for 100 slots; runs split over cores or a cluster [V1] | not stated (TR 38.901 channels implemented; no calibration reported) [V1] |
+| MATLAB 5G Toolbox R2026b | no measured runtimes published; a full-PHY example with 19 sites of 3 sectors and 20 UEs per cell can need "several hundred gigabytes" of memory [W2, W14] | InH SINR CDF against RP-180524 and dense urban against R1-1715251 [W11] |
+| OpenAirInterface v3.0.0 | real time; "up to 100 UEs" (v3.0.0) [O4]; 55 UEs in the stress test of the paper [O10] | not stated (CI over 4G, 5G NSA and SA) [O10] |
+| Sionna v2.2.0 | GPU acceleration; runtime numbers: not stated [N1] | TR 38.901 channel models "Updated and calibrated" (v2.1.0) and calibration metrics in SYS [N2] |
+
+## Where the other tools are stronger
+
+- **Full protocol stacks and packets.** ns-3 with 5G-LENA or the mmWave module and Simu5G simulate every packet
+  through RLC, PDCP, RRC, the core network, transport and applications [L10, M6, S6]. End-to-end latency,
+  TCP behaviour during a handover, or application quality can be studied there and not in HandoverLab, which
+  has no transport layer or applications (it has an optional PDCP buffer model at handover).
+- **Real systems.** OpenAirInterface runs the real protocol stack in real time, with commercial UEs and core
+  networks [O1, O3, O10]; results from it include implementation effects that no simulator has.
+- **PHY detail.** MATLAB can switch the same network to a waveform-level full PHY [W4]; the Vienna simulator
+  takes its BLER curves from a link-level simulator with several waveforms and codes [V1]; Sionna offers a
+  differentiable link-level chain on GPUs and a ray tracer [N1]. HandoverLab has no MIMO and no CDL channel.
+- **Scale.** The Vienna simulator reports thousands of nodes [V1]; Simu5G emulates tens of cells in real time
+  [S9]. HandoverLab runs in one Python process per world and is sized for tens of cells and users per run.
+- **Packet-level handover against the 3GPP mobility study.** 5G-LENA v5.1 can be checked against the TR 36.839
+  handover-failure curves [L5], which matters because HandoverLab's absolute failure rates are not calibrated
+  ([calibration](calibration.md)).
+
+## Where HandoverLab differs
+
+- The Rel-16 to Rel-19 mobility procedures (CHO, DAPS, LTM, conditional LTM, CHO with D1/D2) sit side by side
+  behind one rule interface; none of them is stated in the sources of the other tools above.
+- Every compared rule runs on the same world per seed (paired comparison), and the cost of each procedure
+  (signalling, prepared cells, interruption, energy) is measured next to its benefit.
+- The price is abstraction: received power per step with a slow time-varying part by default, SINR thresholds
+  for link monitoring, fixed procedure delays and a fixed re-establishment outage. The
+  [model boundaries](https://github.com/mjs19971997/handoverlab#model-boundaries) and
+  [standard compliance](standard-compliance.md) say what this supports.
+
+## Sources
+
+All accessed on 2026-10-22.
+
+**HandoverLab:** the pages linked above and `CHANGELOG.md` of 2.4.0.
+
+**ns-3 5G-LENA**
+
+- [L1] 5G-LENA features: <https://5g-lena.cttc.es/features/>
+- [L2] `nr` release notes: <https://gitlab.com/cttc-lena/nr/-/raw/master/RELEASE_NOTES.md>
+- [L3] `nr` RRC layer documentation: <https://gitlab.com/cttc-lena/nr/-/raw/master/doc/source/rrc-layer.rst>
+- [L4] `nr` source, UE RRC and PHY (master branch): <https://gitlab.com/cttc-lena/nr/-/raw/master/model/nr-ue-rrc.cc>,
+  <https://gitlab.com/cttc-lena/nr/-/raw/master/model/nr-ue-phy.cc>
+- [L5] 5G-LENA v5.1 announcement: <https://5g-lena.cttc.es/blog/36/>
+- [L6] `nr` documentation: <https://cttc-lena.gitlab.io/nr/html/>
+- [L7] K. Koutlia, B. Bojovic, Z. Ali, S. Lagén, "Calibration of the 5G-LENA system level simulator in 3GPP
+  reference scenarios", Simulation Modelling Practice and Theory 119 (2022) 102580,
+  <https://doi.org/10.1016/j.simpat.2022.102580>
+- [L8] S. Lagén et al., "New radio physical layer abstraction for system-level simulations of 5G networks",
+  IEEE ICC 2020, <https://doi.org/10.1109/ICC40277.2020.9149444>
+- [L9] M. Sandri et al., "Implementation of a channel model for non-terrestrial networks in ns-3", WNS3 2023,
+  <https://doi.org/10.1145/3592149.3592158>
+- [L10] N. Patriciello et al., "An E2E simulator for 5G NR networks", Simulation Modelling Practice and Theory 96
+  (2019) 101933, <https://doi.org/10.1016/j.simpat.2019.101933>
+- [L11] M. Pagin et al., "Improving the efficiency of MIMO simulations in ns-3", WNS3 2023,
+  <https://doi.org/10.1145/3592149.3592167>
+
+**ns-3 mmWave module**
+
+- [M1] Repository and README: <https://github.com/nyuwireless-unipd/ns3-mmwave>
+- [M2] Releases: <https://github.com/nyuwireless-unipd/ns3-mmwave/releases>
+- [M3] Module documentation: <https://github.com/nyuwireless-unipd/ns3-mmwave/blob/new-handover/src/mmwave/doc/mmwave-doc.md>
+- [M4] eNB and UE RRC source: <https://github.com/nyuwireless-unipd/ns3-mmwave/blob/new-handover/src/lte/model/lte-enb-rrc.cc>,
+  <https://github.com/nyuwireless-unipd/ns3-mmwave/blob/new-handover/src/lte/model/lte-ue-rrc.cc>
+- [M5] M. Polese et al., "Improved handover through dual connectivity in 5G mmWave mobile networks", IEEE JSAC
+  35(9), 2017, <https://doi.org/10.1109/JSAC.2017.2720338>
+- [M6] M. Mezzavilla et al., "End-to-end simulation of 5G mmWave networks", IEEE Communications Surveys &
+  Tutorials 20(3), 2018, <https://doi.org/10.1109/COMST.2018.2828880>
+
+**Simu5G**
+
+- [S1] Repository and README: <https://github.com/Unipisa/Simu5G>
+- [S2] Releases (1.6.0, 1.7.0, 1.8.0): <https://github.com/Unipisa/Simu5G/releases>
+- [S3] What's new: <https://github.com/Unipisa/Simu5G/blob/master/WHATSNEW.md>
+- [S4] UE connection control: <https://github.com/Unipisa/Simu5G/blob/master/src/simu5g/stack/rrc/ConnectionControlUe.ned>
+- [S5] Stochastic channel model: <https://github.com/Unipisa/Simu5G/blob/master/src/simu5g/stack/phy/channelmodel/StochasticChannelModel.ned>
+- [S6] Simu5G site and overview: <https://simu5g.org/>, <https://simu5g.org/users-guide/overview>
+- [S7] Licence: <https://github.com/Unipisa/Simu5G/blob/master/LICENSE.md>
+- [S8] G. Nardini et al., "Simu5G: an OMNeT++ library for end-to-end performance evaluation of 5G networks",
+  IEEE Access 8, 2020, <https://doi.org/10.1109/ACCESS.2020.3028550>
+- [S9] G. Nardini, G. Stea, A. Virdis, "Scalable real-time emulation of 5G networks with Simu5G", IEEE Access 9,
+  2021, <https://doi.org/10.1109/ACCESS.2021.3123873>
+- [S10] LEON, a LEO handover simulator built on OMNeT++, INET and Simu5G, DroNet 2024,
+  <https://doi.org/10.1145/3661810.3663470>
+
+**Vienna 5G System Level Simulator**
+
+- [V1] M. K. Müller et al., "Flexible multi-node simulation of cellular mobile communications: the Vienna 5G
+  System Level Simulator", EURASIP J. Wireless Commun. Netw. 2018:227, <https://doi.org/10.1186/s13638-018-1238-7>
+- [V2] List of features, v1.4: <https://www.tuwien.at/etit/tc/wp-content/uploads/2023/11/listoffeatures-v1-4.pdf>
+- [V3] Simulator page: <https://www.tuwien.at/etit/tc/vienna-simulators/vienna-5g-simulators/>
+- [V4] Release 1.4 announcement: <https://vccsforum.nt.tuwien.ac.at/t/new-release-v1-4-vienna-5g-sl-simulator/297>
+- [V5] Licence agreement: <https://www.tuwien.at/etit/tc/wp-content/uploads/2022/06/license-agreement-5g-sl.pdf>
+
+**MATLAB 5G Toolbox**
+
+- [W1] System-level simulation: <https://www.mathworks.com/help/5g/system-level-simulation.html>
+- [W2] Overview of system-level simulation: <https://www.mathworks.com/help/5g/ug/overview-system-level-simulation-in-5g-network-analysis.html>
+- [W3] `nrGNB`: <https://www.mathworks.com/help/5g/ref/nrgnb.html>
+- [W4] `nrUE`: <https://www.mathworks.com/help/5g/ref/nrue.html>
+- [W5] Composition of NR nodes: <https://www.mathworks.com/help/5g/ug/composition-of-nr-nodes.html>
+- [W6] `addMobility`: <https://www.mathworks.com/help/5g/ref/nrue.addmobility.html>
+- [W7] Simulate mobility of a UE node: <https://www.mathworks.com/help/5g/ug/simulate-ue-mobility-in-5g-network.html>
+- [W8] NR NTN system performance with a transparent-payload LEO satellite:
+  <https://www.mathworks.com/help/5g/ug/nr-ntn-system-performance-evaluation-with-transparent-payload-leo-satellite.html>
+- [W9] NR cell performance with beam management:
+  <https://www.mathworks.com/help/5g/ug/nr-cell-performance-evaluation-with-beam-management.html>
+- [W10] Carrier aggregation in system-level simulation:
+  <https://www.mathworks.com/help/5g/ug/carrier-aggregation-in-5g-system-level-simulation.html>
+- [W11] Evaluate 3GPP indoor reference scenario: <https://www.mathworks.com/help/5g/ug/evaluate-3gpp-indoor-reference-scenario.html>
+- [W12] Release 2026b announcement: <https://www.mathworks.com/company/newsroom/mathworks-introduces-release-2026b-of-matlab-and-simulink.html>
+- [W13] R2026a product transition: <https://www.mathworks.com/products/new_products/r2026a-transition.html>
+- [W14] Run 5G system-level simulations on AWS: <https://www.mathworks.com/help/5g/ug/run-5g-system-level-simulations-on-aws-cloud.html>
+
+**OpenAirInterface**
+
+- [O1] README: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/README.md>
+- [O2] Feature set: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/doc/FEATURE_SET.md>
+- [O3] Handover tutorial: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/doc/handover-tutorial.md>
+- [O4] Changelog: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/CHANGELOG.md>
+- [O5] NTN configuration: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/doc/ntn-configuration.md>
+- [O6] MAC usage: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/doc/MAC/mac-usage.md>
+- [O7] Analog beamforming: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/doc/analog_beamforming.md>
+- [O8] RF simulator: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/radio/rfsimulator/README.md>
+- [O9] Channel simulation: <https://github.com/OPENAIRINTERFACE/openairinterface5g/blob/develop/openair1/SIMULATION/TOOLS/DOC/channel_simulation.md>
+- [O10] F. Kaltenberger et al., Computer Networks (2025) 111410, <https://doi.org/10.1016/j.comnet.2025.111410>
+
+**NVIDIA Sionna**
+
+- [N1] Repository and documentation: <https://github.com/NVlabs/sionna>, <https://nvlabs.github.io/sionna/>
+- [N2] Releases (v2.0.0, v2.1.0, v2.2.0): <https://github.com/NVlabs/sionna/releases>
+- [N3] Sionna SYS: <https://nvlabs.github.io/sionna/sys/index.html>
+- [N4] `PHYAbstraction`: <https://nvlabs.github.io/sionna/sys/api/sionna.sys.PHYAbstraction.html>
+- [N5] `PFSchedulerSUMIMO`: <https://nvlabs.github.io/sionna/sys/api/sionna.sys.PFSchedulerSUMIMO.html>
+- [N6] SYS end-to-end tutorial: <https://nvlabs.github.io/sionna/sys/tutorials/notebooks/End-to-End_Example.html>
+- [N7] 3GPP channel models: <https://nvlabs.github.io/sionna/phy/api/channel/wireless/3gpp.html>