Merged PR 458: Carry over airspace hotfixes from internal

## Summary
Carried over hit fixes from internal that backtracked on the complex channel width stuff for now and focussed on getting a stable data rate baked in for each frequency.  Implemented overriding of frequency max capacities on the airspace. updated documentation to reflect the changes in airspace.py.

## Test process
- Original tests still work
- Tested reading the frequency capacity overrides from config file
- Tested that setting the frequency override to 0.0 blocks the channel

## Checklist
- [X] PR is linked to a **work item**
- [X] **acceptance criteria** of linked ticket are met
- [X] performed **self-review** of the code
- [X] written **tests** for any new functionality added with this PR
- [X] updated the **documentation** if this PR changes or adds functionality
- [ ] written/updated **design docs** if this PR implements new functionality
- [X] updated the **change log**
- [X] ran **pre-commit** checks for code style
- [X] attended to any **TO-DOs** left in the code

Related work items: #2745

docs/source/configuration/simulation.rst

@@ -108,31 +108,23 @@ This is an integer value specifying the allowed bandwidth across the connection.
 ``airspace``
 ------------
 
-This section configures settings specific to the wireless network's virtual airspace. It defines how wireless interfaces within the simulation will interact and perform under various environmental conditions.
+This section configures settings specific to the wireless network's virtual airspace.
 
-``airspace_environment_type``
+``frequency_max_capacity_mbps``
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-This setting specifies the environmental conditions of the airspace which affect the propagation and interference characteristics of wireless signals. Changing this environment type impacts how signal noise and interference are calculated, thus affecting the overall network performance, including data transmission rates and signal quality.
+This setting allows the user to override the default maximum bandwidth capacity set for each frequency. The key should
+be the AirSpaceFrequency name and the value be the desired maximum bandwidth capacity in mbps (megabits per second) for
+a single timestep.
 
-**Configurable Options**
+The below example would permit 123.45 megabits to be transmit across the WiFi 2.4 GHz frequency in a single timestep.
+Setting a frequencies max capacity to 0.0 blocks that frequency on the airspace.
 
-- **rural**: A rural environment offers clear channel conditions due to low population density and minimal electronic device presence.
+.. code-block:: yaml
 
-- **outdoor**: Outdoor environments like parks or fields have minimal electronic interference.
-
-- **suburban**: Suburban environments strike a balance with fewer electronic interferences than urban but more than rural.
-
-- **office**: Office environments have moderate interference from numerous electronic devices and overlapping networks.
-
-- **urban**: Urban environments are characterized by tall buildings and a high density of electronic devices, leading to significant interference.
-
-- **industrial**: Industrial areas face high interference from heavy machinery and numerous electronic devices.
-
-- **transport**: Environments such as subways and buses where metal structures and high mobility create complex interference patterns.
-
-- **dense_urban**: Dense urban areas like city centers have the highest level of signal interference due to the very high density of buildings and devices.
-
-- **jamming_zone**: A jamming zone environment where signals are actively interfered with, typically through the use of signal jammers or scrambling devices. This represents the environment with the highest level of interference.
-
-- **blocked**: A jamming zone environment with total levels of interference. Airspace is completely blocked.
+    simulation:
+      network:
+        airspace:
+          frequency_max_capacity_mbps:
+            WIFI_2_4: 123.45
+            WIFI_5: 0.0

docs/source/simulation_components/network/airspace.rst

@@ -22,79 +22,21 @@ The AirSpace is a virtual representation of a physical wireless environment, man
 ^^^^^^^^^^^^^^^^^^
 
 - **Wireless Network Interfaces**: Representations of network interfaces connected physical devices like routers, computers, or IoT devices that can send and receive data wirelessly.
-- **Environmental Settings**: Different types of environments (e.g., urban, rural) that affect signal propagation and interference.
-- **Channel Management**: Handles channels and their widths (e.g., 20 MHz, 40 MHz) to determine data transmission over different frequencies.
-- **Bandwidth Management**: Tracks data transmission over channels to prevent overloading and simulate real-world network congestion.
+- **Bandwidth Management**: Tracks data transmission over frequencies to prevent overloading and simulate real-world network congestion.
 
-3. AirSpace Environment Types
------------------------------
 
-The AirspaceEnvironmentType is a critical component that simulates different physical environments:
-
-- Urban, Suburban, Rural, etc.
-- Each type simulates different levels of electromagnetic interference and signal propagation characteristics.
-- Changing the AirspaceEnvironmentType impacts data rates by affecting the signal-to-noise ratio (SNR).
-
-4. Simulation of Environment Changes
-------------------------------------
-
-When an AirspaceEnvironmentType is set or changed, the AirSpace:
-
-1. Recalculates the maximum data transmission capacities for all managed frequencies and channel widths.
-2. Updates all wireless interfaces to reflect new capacities.
-
-5. Managing Wireless Network Interfaces
+3. Managing Wireless Network Interfaces
 ---------------------------------------
 
 - Interfaces can be dynamically added or removed.
 - Configurations can be changed in real-time.
-- The AirSpace handles data transmissions, ensuring data sent by an interface is received by all other interfaces on the same frequency and channel.
+- The AirSpace handles data transmissions, ensuring data sent by an interface is received by all other interfaces on the same frequency.
 
-6. Signal-to-Noise Ratio (SNR) Calculation
-------------------------------------------
 
-SNR is crucial in determining the quality of a wireless communication channel:
-
-.. math::
-
-   SNR = \frac{\text{Signal Power}}{\text{Noise Power}}
-
-- Impacted by environment type, frequency, and channel width
-- Higher SNR indicates a clearer signal, leading to higher data transmission rates
-
-7. Total Channel Capacity Calculation
--------------------------------------
-
-Channel capacity is calculated using the Shannon-Hartley theorem:
-
-.. math::
-
-   C = B \cdot \log_2(1 + SNR)
-
-Where:
-
-- C: channel capacity in bits per second (bps)
-- B: bandwidth of the channel in hertz (Hz)
-- SNR: signal-to-noise ratio
-
-Implementation in AirSpace:
-
-1. Convert channel width from MHz to Hz.
-2. Recalculate SNR based on new environment or interface settings.
-3. Apply Shannon-Hartley theorem to determine new maximum channel capacity in Mbps.
-
-8. Shared Maximum Capacity Across Devices
------------------------------------------
-
-While individual devices have theoretical maximum data rates, the actual achievable rate is often less due to:
-
-- Shared wireless medium among all devices on the same frequency and channel width
-- Interference and congestion from multiple devices transmitting simultaneously
-
-9. AirSpace Inspection
+4. AirSpace Inspection
 ----------------------
 
 The AirSpace class provides methods for visualizing network behavior:
 
 - ``show_wireless_interfaces()``: Displays current state of all interfaces
-- ``show_bandwidth_load()``: Shows channel loads and bandwidth utilization
+- ``show_bandwidth_load()``: Shows bandwidth utilisation

docs/source/simulation_components/network/nodes/wireless_router.rst

@@ -50,7 +50,6 @@ additional steps to configure wireless settings:
         port=1, ip_address="192.168.2.1",
         subnet_mask="255.255.255.0",
         frequency=AirSpaceFrequency.WIFI_2_4,
-        channel_width=ChannelWidth.ChannelWidth.WIDTH_40_MHZ
     )
 
 
@@ -132,14 +131,12 @@ ICMP traffic, ensuring basic network connectivity and ping functionality.
         ip_address="192.168.1.1",
         subnet_mask="255.255.255.0",
         frequency=AirSpaceFrequency.WIFI_2_4,
-        channel_width=ChannelWidth.ChannelWidth.WIDTH_40_MHZ
     )
     router_2.configure_wireless_access_point(
         port=1,
         ip_address="192.168.1.2",
         subnet_mask="255.255.255.0",
         frequency=AirSpaceFrequency.WIFI_2_4,
-        channel_width=ChannelWidth.ChannelWidth.WIDTH_40_MHZ
     )
 
     # Configure routes for inter-router communication