CRRM: A 5G system-level simulator
Keith Briggs & Ibrahim Nur · 2025
Read CRRM: A 5G system-level simulator by Keith Briggs & Ibrahim Nur (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2511-02692.txt.
Introduction
Keith Briggs and Ibrahim Nur built CRRM, an open-source simulator for 5G mobile networks, and describe it in a 2025 paper. System-level simulators help test new network algorithms, but many are slow or awkward for machine learning work. CRRM is written in pure Python so it can plug straight into modern AI tools.
Most simulators step through events one by one. CRRM instead models the network as linked blocks in a directed graph, each block computed only when its inputs change. The authors call that trick smart update. It lets parts of the system sit idle until needed, which speeds up runs. The design targets researchers who want quick tests of learning-based network control.
Catalog record
| CREATOR | Keith Briggs & Ibrahim Nur |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 20 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2511-02692
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
CRRM: A 5G system-level simulator Keith Briggs & Ibrahim Nur Abstract System-level simulation is indispensable for developing and testing novel algorithms for 5G and future wireless networks, yet a gap persists between the needs of the machine learning research community and the available tooling. To address this, we introduce the Cellular Radio Reference Model (CRRM), an open-source, pure Python simulator we designed specifically for speed, usability, and direct integration with modern AI frameworks. The core scientific contribution of CRRM lies in its architecture, which departs from traditional discrete-event simulation. We model the system as a set of inter-dependent computational blocks which form nodes in a directed graph. This enables a compute-on-demand mechanism we term smart update . 1 Introduction The optimization of the performance of modern cellular networks increasingly depends on machine-learning algorithms, and these require simulators which integrate directly with AI frameworks based on Python, such as PyTorch and TensorFlow. A significant usability gap exists, as established high-fidelity simulators like ns-3 are built on C ++ and demand substantial, specialised expertise, creating a barrier to entry for researchers focused on AI applications. This project was initiated to address this specific gap by developing the Cellular Radio Reference Model (CRRM), a pure Python, open-source 5G system-level simulator. Its performance is founded on a compute-on-demand architecture that avoids redundant calculations; timing tests demonstrate this smart update mechanism delivers a speed-up factor of close to 2, over a full system recalculation in scenarios with a 10% UE mobility factor. The simulator’s utility is not confined to its architecture. Its capabilities are grounded in a library of validated 3GPP TR 38.901 propagation models, including Rural Macrocell (RMa), Urban Macrocell (UMa), Urban Microcell (UMi), and Indoor Hotspot (InH), which allows for the analysis of a diverse range of scenarios. The physical layer modelling extends to advanced features, such as 3-sector antenna patterns that are based on 3GPP specifications, which creates a clear angular dependency on UE throughput. Furthermore, CRRM is a functional tool for investigating resource management strategies. It implements subband-based interference coordination, where a UE’s Signal-to-Interference-plus-Noise Ratio (SINR) can be improved from 0dB to 20dB through cell power coordination, and a tunable resource allocation fairness parameter ( p ), to study throughput distribution among users. This paper documents the design and implementation of the CRRM simulator. It begins by detailing the compute-on-demand architecture that underpins its performance. It then presents the suite of implemented physical layer models and network features. Finally, it provides evidence of the simulator’s scientific validity by comparing its output against known analytical theory for a Poisson Point Process network deployment (CRRM example 12), and quantifies the performance benefits of its core design. 2 Core architecture The fundamental design philosophy of CRRM is a dependency chain of computational blocks, an architectural choice which represents a specific hypothesis about the nature of system-level cellular simulation. This paradigm deviates from the discrete-event schedulers that form the core of traditional network simulators like ns-3 . The implicit argument is that for this problem domain, where the system state is largely static except for discrete changes such as user equipment (UE) movement, tracking data dependencies is a more efficient computational model than managing a continuous timeline of events. This design is realised through a smart update mechanism, a practical implementation of lazy evaluation where expressions are not evaluated until their results are explicitly needed. This approach delivers a measured speed-up factor of at least 2, compared to a full system recalculation in typical mobility scenarios. The basic mathematical blocks, each represented in the code by a python class, with a NumPy array holding the data, are as follows. All geometric calculations in CRRM are in three dimensions, partly because some of the pathloss models require this, but also to allow modelling scenarios such as tall buildings. Further details are in the docstrings for each class or function. • U : a 3-column array in which row i is the position of UE i . • C : a 3-column array in which row j is the position of Cell j . • D : Distance matrix, defined by D_{ij}=|\!|u_{i}-c_{j}|\!| . This class computes both 2d and 3d distances, and also angles for use in antenna radiations patterns. • P : p_{jk} represent the current transmit power of Cell j in subband k . • a : attachment vector, with the meaning that UE i is attached to Cell {}_{a_{j}} . • G : gain matrix, defined as some function g of the distance matrix as G=g(D) , in which g is defined by a pathloss model. It satisfies \implies 0\leqslant G<1 . • R : RSRP (received signal reference power) matrix, in which R_{ijk}=p_{jk}G_{ij} , with k indexing the subband. • w : the wanted signal vector, computed from w_{ik}=R_{i,a_{i},k} . • u : the unwanted interference vector defined by u_{ik}=\sum_{j}R_{ijk}-w_{ik} . • \gamma : the signal plus interfernce to noise ratio (SINR) vector \gamma=\frac{w}{\sigma^{2}+u} , in which division is element-wise. • CQI (channel quality index): this is computed from the SINR in dB, using a look-up table. The values are in the range [0,15] . • Shannon: this block computes channel capacity, including for MIMO, using information theory. It is an upper bound on channel throughput. • MCS (modulation and coding scheme index): this is a scaled version of CQI. The values are in the range [0,28] . These values are mapped onto actual data rates for the different modulation and coding schemes using standard 3GPP tables. • Resource allocation. See Section 3.3.2 . • Throughput: the final output is computed by combining MCS, resource allocation, and bandwidth. Figure 1: The CRRM computational data flow, with the shapes of the arrays indicated. Data propagates from root nodes like U (representing UE locations), C , and P (power), through a series of dependent blocks, each representing a distinct mathematical operation. The stacked blocks for RSRP, SINR, etc. illustrate the handling of multiple subbands. The horizontal red stripe indicates the rows of all the arrays requiring to be updated if a UE moves. Python advanced indexing is used to perform multiple UE move updates in one operation. The flow of data and the mathematical dependencies between blocks are shown in Figure 1 . The simulation pipeline is a sequence of transformations beginning with the root inputs, until the final outputs of capacity of throughput are reached. This compute-on-demand mechanism is orchestrated by components within the internal _Node base class: a boolean up_to_date flag and lists for dependencies ( watchees ) and dependents ( watchers ). The process consists of two distinct phases. First, an invalidation phase occurs when a root node’s data is altered, for example when a UE moves. This triggers the flood_out_of_date() method, which recursively traverses the watchers’ lists to set the up_to_date flag of all downstream nodes to False. This cascade efficiently validates the specific path of computations affected by the change without performing any new calculations. Second, a recursive update phase is initiated when a final result is requested, for example by get_UE_throughputs() . This calls the update() method on the terminal node, which first checks its up_to_date flag. If False, it recursively calls update() on each of its watchees. This