dapps 0.0.2__tar.gz → 0.0.3__tar.gz

{dapps-0.0.2 → dapps-0.0.3}/.github/workflows/tag-and-release.yml

@@ -9,7 +9,7 @@ jobs:
   create-tag:
     runs-on: ubuntu-latest
     outputs:
-      version: ${{ steps.set_version.outputs.version }}
+      version: ${{ steps.get_version.outputs.version }}
       tag_created: ${{ steps.set_output.outputs.tag_created }}
     steps:
       - name: Checkout repository
@@ -48,11 +48,6 @@ jobs:
             echo "tag_created=false" >> $GITHUB_OUTPUT
           fi
 
-      - name: Set version output
-        id: set_version
-        run: |
-          echo "version=${{ steps.get_version.outputs.version }}" >> $GITHUB_OUTPUT
-
   build:
     name: Build distribution 📦
     runs-on: ubuntu-latest
@@ -78,7 +73,9 @@ jobs:
 
   publish-to-pypi:
     name: Publish to PyPI
-    needs: build
+    needs: 
+      - build
+      - create-tag
     runs-on: ubuntu-latest
     if: ${{ needs.create-tag.outputs.tag_created == 'true' && github.repository == 'wineslab/dApp-library' }}
     environment:
@@ -97,7 +94,9 @@ jobs:
 
   github-release:
     name: Sign packages with Sigstore and upload them to GitHub Release
-    needs: publish-to-pypi
+    needs: 
+      - publish-to-pypi
+      - create-tag
     runs-on: ubuntu-latest
     if: ${{ needs.create-tag.outputs.tag_created == 'true' && github.repository == 'wineslab/dApp-library' }}
     permissions:
@@ -126,7 +125,9 @@ jobs:
 
   publish-to-testpypi:
     name: Publish to TestPyPI
-    needs: build
+    needs: 
+      - publish-to-pypi
+      - create-tag
     runs-on: ubuntu-latest
     if: ${{ needs.create-tag.outputs.tag_created == 'true' && github.repository == 'wineslab/dApp-library' }}
     environment:

dapps-0.0.3/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: dapps
+Version: 0.0.3
+Summary: A library for creating and connecting dApps to Open RAN units.
+Project-URL: Homepage, https://openrangym.com/o-ran-frameworks/dapps
+Project-URL: Package, https://pypi.org/project/dapps/
+Project-URL: Source, https://github.com/wineslab/dApp-library
+Project-URL: Bug Tracker, https://github.com/wineslab/dApp-library/issues
+Author-email: Andrea Lacava <thecave003@gmail.com>
+License-File: LICENSE
+Keywords: 5G,O-RAN,cellular,dApps,networks
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.8
+Requires-Dist: asn1tools
+Requires-Dist: numpy
+Requires-Dist: pyzmq
+Requires-Dist: typing-extensions
+Provides-Extra: all
+Requires-Dist: flask; extra == 'all'
+Requires-Dist: flask-socketio; extra == 'all'
+Requires-Dist: influxdb-client; extra == 'all'
+Requires-Dist: libiq; extra == 'all'
+Requires-Dist: matplotlib; extra == 'all'
+Requires-Dist: pysctp; extra == 'all'
+Provides-Extra: api
+Requires-Dist: influxdb-client; extra == 'api'
+Provides-Extra: cnn
+Requires-Dist: libiq; extra == 'cnn'
+Provides-Extra: gui
+Requires-Dist: flask; extra == 'gui'
+Requires-Dist: flask-socketio; extra == 'gui'
+Requires-Dist: matplotlib; extra == 'gui'
+Provides-Extra: network
+Requires-Dist: pysctp; extra == 'network'
+Description-Content-Type: text/markdown
+
+# dApp Library
+
+A complete tutorial on how to deploy a dApp can be found on the [OpenRAN Gym website](https://openrangym.com/tutorials/dapps-oai). Please refer to that guide to instrument your system.
+
+## Installation
+
+### Python package installation
+
+```
+pip3 install dapps[all]
+```
+
+### Manual installation
+Clone the repository and install it manually
+
+```
+hatch build
+pip3 install dist/*.tar.gz
+```
+
+### Launch the Spectrum Sharing dApp
+
+OAI should start _before_ running the dApp
+
+```python 
+python3 examples/spectrum_dapp.py
+```
+
+This dApp implements a spectrum sharing use case discussed in [our paper](https://arxiv.org/pdf/2501.16502).
+
+
+The dApp can be controlled through the following command-line arguments:
+
+- `--ota` (store_true, default: False): Specify if this is OTA or on Colosseum  
+- `--link` (str, default: 'zmq', choices: [layer.value for layer in E3LinkLayer]): Specify the link layer to be used  
+- `--transport` (str, default: 'ipc', choices: [layer.value for layer in E3TransportLayer]): Specify the transport layer to be used  
+- `--save-iqs` (store_true, default: False): Specify if this is data collection run or not. In the first case I/Q samples will be saved  
+- `--control` (store_true, default: False): Set whether to perform control of PRB  
+- `--energy-gui` (store_true, default: False): Set whether to enable the energy GUI  
+- `--iq-plotter-gui` (store_true, default: False): Set whether to enable the IQ Plotter GUI  
+- `--demo-gui` (store_true, default: False): Set whether to enable the Demo GUI  
+- `--timed` (store_true, default: False): Run with a 5-minute time limit  
+- `--model` (str, default: ''): Path to the CNN model file to be used  
+- `--time-window` (int, default: 5): Number of input vectors to pass to the CNN model  
+- `--input-vector` (int, default: 1536): Number of I/Q samples per input vector  
+- `--moving-avg-window` (int, default: 30): Window size (in samples) for the moving average used to detect energy peaks in the spectrum  
+- `--extraction-window` (int, default: 600): Number of samples to retain after detecting an energy peak
+
+
+If you use the dApp concept and/or the framework to develop your own dApps, please cite the following paper:
+
+```text
+@article{LACAVA2025111342,
+title = {{dApps: Enabling Real-Time AI-based Open RAN Control}},
+journal = {Computer Networks},
+pages = {111342},
+year = {2025},
+issn = {1389-1286},
+doi = {https://doi.org/10.1016/j.comnet.2025.111342},
+url = {https://www.sciencedirect.com/science/article/pii/S1389128625003093},
+author = {Andrea Lacava and Leonardo Bonati and Niloofar Mohamadi and Rajeev Gangula and Florian Kaltenberger and Pedram Johari and Salvatore D’Oro and Francesca Cuomo and Michele Polese and Tommaso Melodia},
+keywords = {Open RAN, dApps, Real-time control loops, Radio Resource Management (RRM), Spectrum sharing, Positioning, Integrated Sensing and Communication (ISAC)},
+abstract = {Open Radio Access Networks (RANs) leverage disaggregated and programmable RAN functions and open interfaces to enable closed-loop, data-driven radio resource management. This is performed through custom intelligent applications on the RAN Intelligent Controllers (RICs), optimizing RAN policy scheduling, network slicing, user session management, and medium access control, among others. In this context, we have proposed dApps as a key extension of the O-RAN architecture into the real-time and user-plane domains. Deployed directly on RAN nodes, dApps access data otherwise unavailable to RICs due to privacy or timing constraints, enabling the execution of control actions within shorter time intervals. In this paper, we propose for the first time a reference architecture for dApps, defining their life cycle from deployment by the Service Management and Orchestration (SMO) to real-time control loop interactions with the RAN nodes where they are hosted. We introduce a new dApp interface, E3, along with an Application Protocol (AP) that supports structured message exchanges and extensible communication for various service models. By bridging E3 with the existing O-RAN E2 interface, we enable dApps, xApps, and rApps to coexist and coordinate. These applications can then collaborate on complex use cases and employ hierarchical control to resolve shared resource conflicts. Finally, we present and open-source a dApp framework based on OpenAirInterface (OAI). We benchmark its performance in two real-time control use cases, i.e., spectrum sharing and positioning in a 5th generation (5G) Next Generation Node Base (gNB) scenario. Our experimental results show that standardized real-time control loops via dApps are feasible, achieving average control latency below 450microseconds and allowing optimal use of shared spectral resources.}
+}
+```

dapps-0.0.3/README.md

@@ -0,0 +1,65 @@
+# dApp Library
+
+A complete tutorial on how to deploy a dApp can be found on the [OpenRAN Gym website](https://openrangym.com/tutorials/dapps-oai). Please refer to that guide to instrument your system.
+
+## Installation
+
+### Python package installation
+
+```
+pip3 install dapps[all]
+```
+
+### Manual installation
+Clone the repository and install it manually
+
+```
+hatch build
+pip3 install dist/*.tar.gz
+```
+
+### Launch the Spectrum Sharing dApp
+
+OAI should start _before_ running the dApp
+
+```python 
+python3 examples/spectrum_dapp.py
+```
+
+This dApp implements a spectrum sharing use case discussed in [our paper](https://arxiv.org/pdf/2501.16502).
+
+
+The dApp can be controlled through the following command-line arguments:
+
+- `--ota` (store_true, default: False): Specify if this is OTA or on Colosseum  
+- `--link` (str, default: 'zmq', choices: [layer.value for layer in E3LinkLayer]): Specify the link layer to be used  
+- `--transport` (str, default: 'ipc', choices: [layer.value for layer in E3TransportLayer]): Specify the transport layer to be used  
+- `--save-iqs` (store_true, default: False): Specify if this is data collection run or not. In the first case I/Q samples will be saved  
+- `--control` (store_true, default: False): Set whether to perform control of PRB  
+- `--energy-gui` (store_true, default: False): Set whether to enable the energy GUI  
+- `--iq-plotter-gui` (store_true, default: False): Set whether to enable the IQ Plotter GUI  
+- `--demo-gui` (store_true, default: False): Set whether to enable the Demo GUI  
+- `--timed` (store_true, default: False): Run with a 5-minute time limit  
+- `--model` (str, default: ''): Path to the CNN model file to be used  
+- `--time-window` (int, default: 5): Number of input vectors to pass to the CNN model  
+- `--input-vector` (int, default: 1536): Number of I/Q samples per input vector  
+- `--moving-avg-window` (int, default: 30): Window size (in samples) for the moving average used to detect energy peaks in the spectrum  
+- `--extraction-window` (int, default: 600): Number of samples to retain after detecting an energy peak
+
+
+If you use the dApp concept and/or the framework to develop your own dApps, please cite the following paper:
+
+```text
+@article{LACAVA2025111342,
+title = {{dApps: Enabling Real-Time AI-based Open RAN Control}},
+journal = {Computer Networks},
+pages = {111342},
+year = {2025},
+issn = {1389-1286},
+doi = {https://doi.org/10.1016/j.comnet.2025.111342},
+url = {https://www.sciencedirect.com/science/article/pii/S1389128625003093},
+author = {Andrea Lacava and Leonardo Bonati and Niloofar Mohamadi and Rajeev Gangula and Florian Kaltenberger and Pedram Johari and Salvatore D’Oro and Francesca Cuomo and Michele Polese and Tommaso Melodia},
+keywords = {Open RAN, dApps, Real-time control loops, Radio Resource Management (RRM), Spectrum sharing, Positioning, Integrated Sensing and Communication (ISAC)},
+abstract = {Open Radio Access Networks (RANs) leverage disaggregated and programmable RAN functions and open interfaces to enable closed-loop, data-driven radio resource management. This is performed through custom intelligent applications on the RAN Intelligent Controllers (RICs), optimizing RAN policy scheduling, network slicing, user session management, and medium access control, among others. In this context, we have proposed dApps as a key extension of the O-RAN architecture into the real-time and user-plane domains. Deployed directly on RAN nodes, dApps access data otherwise unavailable to RICs due to privacy or timing constraints, enabling the execution of control actions within shorter time intervals. In this paper, we propose for the first time a reference architecture for dApps, defining their life cycle from deployment by the Service Management and Orchestration (SMO) to real-time control loop interactions with the RAN nodes where they are hosted. We introduce a new dApp interface, E3, along with an Application Protocol (AP) that supports structured message exchanges and extensible communication for various service models. By bridging E3 with the existing O-RAN E2 interface, we enable dApps, xApps, and rApps to coexist and coordinate. These applications can then collaborate on complex use cases and employ hierarchical control to resolve shared resource conflicts. Finally, we present and open-source a dApp framework based on OpenAirInterface (OAI). We benchmark its performance in two real-time control use cases, i.e., spectrum sharing and positioning in a 5th generation (5G) Next Generation Node Base (gNB) scenario. Our experimental results show that standardized real-time control loops via dApps are feasible, achieving average control latency below 450microseconds and allowing optimal use of shared spectral resources.}
+}
+```

dapps-0.0.3/VERSION

@@ -0,0 +1 @@
+0.0.3

{dapps-0.0.2 → dapps-0.0.3}/examples/spectrum_dapp.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-Usage example for the Spectrum Sharing dApp 
+Example script to showcase the Spectrum Sharing dApp 
 """
 
 import argparse
@@ -24,6 +24,19 @@ def main(args, time_to_wait: float = 60.0):
     # with open(f"{LOG_DIR}/busy.txt", "w") as f:
     #     f.close()
 
+    if args.model:
+        try:
+            from libiq.classifier.cnn import Classifier
+        except ModuleNotFoundError:
+            print(
+                "Optional dependencies to run this example are not installed.\n"
+                "Fix this by running:\n\n"
+                "    pip install libiq  # OR\n"
+                "    pip install dapps[cnn] (minimal) # OR\n"
+                "    pip install dapps[all] (preferred)\n"
+            )
+            exit(-1)
+
     if args.ota:
         print(f'Using OTA configuration')
         noise_floor_threshold = 20 # this really depends on the RF conditions and should be carefully calibrated
@@ -32,9 +45,20 @@ def main(args, time_to_wait: float = 60.0):
         noise_floor_threshold = 53
 
     print(f'Threshold {noise_floor_threshold}')
-    
+
+    classifier = None
+    if args.model:
+        classifier = Classifier(
+            time_window = args.time_window,
+            input_vector = args.input_vector,
+            moving_avg_window = args.moving_avg_window,
+            extraction_window = args.extraction_window,
+            model_path = args.model
+        )
+
     dapp = SpectrumSharingDApp(noise_floor_threshold=noise_floor_threshold, save_iqs=args.save_iqs, control=args.control, link=args.link, transport=args.transport,
-                energyGui=args.energy_gui, iqPlotterGui=args.iq_plotter_gui, dashboard=args.demo_gui)
+                energyGui=args.energy_gui, iqPlotterGui=args.iq_plotter_gui, dashboard=args.demo_gui, classifier=classifier)
+
     dapp.setup_connection()
     
     if args.timed:
@@ -51,19 +75,23 @@ def main(args, time_to_wait: float = 60.0):
 
 
 if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="dApp example")
+    parser = argparse.ArgumentParser(description="Example of a dApp for Spectrum Sharing")
     parser.add_argument('--ota', action='store_true', default=False, help="Specify if this is OTA or on Colosseum")
     parser.add_argument('--link', type=str, default='zmq', choices=[layer.value for layer in E3LinkLayer], help="Specify the link layer to be used")
-    parser.add_argument('--transport', type=str,  default='ipc', choices=[layer.value for layer in E3TransportLayer], help="Specify the transport layer to be used")
+    parser.add_argument('--transport', type=str, default='ipc', choices=[layer.value for layer in E3TransportLayer], help="Specify the transport layer to be used")
     parser.add_argument('--save-iqs', action='store_true', default=False, help="Specify if this is data collection run or not. In the first case I/Q samples will be saved")
     parser.add_argument('--control', action='store_true', default=False, help="Set whether to perform control of PRB")
     parser.add_argument('--energy-gui', action='store_true', default=False, help="Set whether to enable the energy GUI")
     parser.add_argument('--iq-plotter-gui', action='store_true', default=False, help="Set whether to enable the IQ Plotter GUI")
     parser.add_argument('--demo-gui', action='store_true', default=False, help="Set whether to enable the Demo GUI")
     parser.add_argument('--timed', action='store_true', default=False, help="Run with a 5-minute time limit")
+    parser.add_argument('--model', type=str, default='', help="Path to the CNN model file to be used")
+    parser.add_argument('--time-window', type=int, default=5, help="Number of input vectors to pass to the CNN model.")
+    parser.add_argument('--input-vector', type=int, default=1536, help="Number of I/Q samples per input vector.")
+    parser.add_argument('--moving-avg-window', type=int, default=30, help="Window size (in samples) for the moving average used to detect energy peaks in the spectrum.")
+    parser.add_argument('--extraction-window', type=int, default=600, help="Number of samples to retain after detecting an energy peak.")
 
     args = parser.parse_args()
-
     print("Start dApp")
 
     main(args)

dapps-0.0.3/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = [ "hatchling" ]
+build-backend = "hatchling.build"
+
+
+[project]
+name = "dapps"
+dynamic = [ "version" ]
+description = "A library for creating and connecting dApps to Open RAN units."
+readme = "README.md"
+requires-python = ">=3.8"
+keywords = [ "dApps", "O-RAN", "5G", "cellular", "networks" ]
+classifiers = [
+"Development Status :: 4 - Beta",
+"Programming Language :: Python",
+"Programming Language :: Python :: 3.8",
+"Programming Language :: Python :: 3.9",
+"Programming Language :: Python :: 3.10",
+"Programming Language :: Python :: 3.11",
+"Programming Language :: Python :: 3.12",
+"Programming Language :: Python :: Implementation :: CPython",
+"Programming Language :: Python :: Implementation :: PyPy"
+]
+dependencies = [ "asn1tools", "typing_extensions", "numpy", "pyzmq" ]
+
+
+[[project.authors]]
+name = "Andrea Lacava"
+email = "thecave003@gmail.com"
+
+
+[project.urls]
+Homepage = "https://openrangym.com/o-ran-frameworks/dapps"
+Package = "https://pypi.org/project/dapps/"
+Source = "https://github.com/wineslab/dApp-library"
+"Bug Tracker" = "https://github.com/wineslab/dApp-library/issues"
+
+
+[project.optional-dependencies]
+api = [ "influxdb_client" ]
+cnn = [ "libiq" ]
+gui = [ "flask", "flask-socketio", "matplotlib" ]
+network = [ "pysctp" ]
+all = [
+"pysctp",
+"flask",
+"flask-socketio",
+"matplotlib",
+"influxdb_client",
+"libiq"
+]
+
+
+[tool.hatch.version]
+path = "VERSION"
+pattern = "(?P<version>\\d+\\.\\d+\\.\\d+)"
+
+
+[tool.hatch.build.targets.wheel]
+packages = [
+"src/dapp",
+"src/e3interface",
+"src/spectrum",
+"src/visualization"
+]
+sources = [ "src" ]

{dapps-0.0.2 → dapps-0.0.3}/src/visualization/templates/index.html

@@ -17,13 +17,20 @@
         var waterfall = [{
             z: [],
             type: 'heatmap',
-            colorscale: "Viridis"
+            colorscale: "Viridis",
+            colorbar: {
+                title:{ 
+                    text: "Magnitude [dB]",
+                    side: 'right'
+                },
+                orientation: 'h'
+            }
         }];
 
         var waterfallLayout = {
-            title: "Magnitude of the Sensed Spectrum",
+            title: "Sensed Spectrum",
             xaxis: {
-                title: "Subcarriers of the OFDM Symbol"
+                title: "OFDM Symbol Subcarriers"
             },
             yaxis: {
                 title: "Time samples",
@@ -155,7 +162,7 @@
 
         var classifierLayout = {
             title: {
-                text: "Predicted Label: N/A",
+                text: "RFI Predicted: N/A",
                 font: { size: 24 }
             },
             xaxis: { visible: false },
@@ -199,9 +206,9 @@
                 data.prb_list.forEach(index => prbs_buffer[0][index] = 1);
                 Plotly.restyle('prbs', { z: [prbs_buffer] });
             } else if ('predicted_label' in data) {
-                console.log("Predicted label is: ", data.predicted_label);
+                console.log("RFI Predicted is ", data.predicted_label);
                 Plotly.relayout('predicted_label', {
-                    'title.text': `Predicted Label: ${data.predicted_label}`
+                    'title.text': `RFI Predicted: ${data.predicted_label}`
                 });
             } else {
                 console.error('Error unknown values in data ', data);

dapps-0.0.2/PKG-INFO

@@ -1,83 +0,0 @@
-Metadata-Version: 2.4
-Name: dapps
-Version: 0.0.2
-Summary: A library for creating and connecting dApps to Open RAN units.
-Project-URL: Homepage, https://openrangym.com/ran-frameworks/dapps
-Project-URL: Package, https://pypi.org/project/dapps/
-Project-URL: Source, https://github.com/wineslab/dApp-library
-Project-URL: Bug Tracker, https://github.com/wineslab/dApp-library/issues
-Author-email: Andrea Lacava <thecave003@gmail.com>
-License-File: LICENSE
-Keywords: 5g,dApps,o-ran
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.8
-Requires-Dist: asn1tools
-Requires-Dist: numpy
-Requires-Dist: pyzmq
-Requires-Dist: typing-extensions
-Provides-Extra: all
-Requires-Dist: flask; extra == 'all'
-Requires-Dist: flask-socketio; extra == 'all'
-Requires-Dist: influxdb-client; extra == 'all'
-Requires-Dist: matplotlib; extra == 'all'
-Requires-Dist: pysctp; extra == 'all'
-Provides-Extra: api
-Requires-Dist: influxdb-client; extra == 'api'
-Provides-Extra: gui
-Requires-Dist: flask; extra == 'gui'
-Requires-Dist: flask-socketio; extra == 'gui'
-Requires-Dist: matplotlib; extra == 'gui'
-Provides-Extra: network
-Requires-Dist: pysctp; extra == 'network'
-Description-Content-Type: text/markdown
-
-# dApp Library
-
-A complete tutorial on how to deploy a dApp can be found on the [OpenRAN Gym website](https://openrangym.com/tutorials/dapps-oai). Please refer to that guide to instrument your system.
-
-## Installation
-
-Clone the repository
-
-```
-hatch build
-pip3 install dist/*.tar.gz
-```
-
-### Launch the Spectrum Sharing dApp
-
-OAI should start _before_ running the dApp
-
-```python 
-python3 examples/spectrum_dapp.py
-```
-
-This dApp implements a spectrum sharing use case discussed in [our paper](https://arxiv.org/pdf/2501.16502).
-
-The dApp can be controlled through the following command-line arguments:
-- `ota` bool (false): If true, use the OAI and spectrum configurations for OTA else use the ones of Colosseum
-- `control` bool (false): If set to true, performs the PRB masking
-- `energy-gui` bool (false): If set to true, creates and show the energy spectrum
-- `iq-plotter-gui` bool (false): If set to true, creates and show the sensed spectrum
-- `save-iqs` bool (false): Specify if this is data collection run or not. In the first case I/Q samples will be saved
-- `timed` bool (false): Run with a 5-minute time limit
-
-
-If you use the dApp concept and/or the framework to develop your own dApps, please cite the following paper:
-
-```text
-@ARTICLE{lacava2025dApps,
-author={Andrea Lacava and Leonardo Bonati and Niloofar Mohamadi and Rajeev Gangula and Florian Kaltenberger and Pedram Johari and Salvatore D'Oro and Francesca Cuomo and Michele Polese and Tommaso Melodia},
-title: {dApps: Enabling Real-Time AI-Based Open RAN Control},
-url={https://arxiv.org/pdf/2501.16502},
-year={2025}
-}
-```

dapps-0.0.2/README.md

@@ -1,42 +0,0 @@
-# dApp Library
-
-A complete tutorial on how to deploy a dApp can be found on the [OpenRAN Gym website](https://openrangym.com/tutorials/dapps-oai). Please refer to that guide to instrument your system.
-
-## Installation
-
-Clone the repository
-
-```
-hatch build
-pip3 install dist/*.tar.gz
-```
-
-### Launch the Spectrum Sharing dApp
-
-OAI should start _before_ running the dApp
-
-```python 
-python3 examples/spectrum_dapp.py
-```
-
-This dApp implements a spectrum sharing use case discussed in [our paper](https://arxiv.org/pdf/2501.16502).
-
-The dApp can be controlled through the following command-line arguments:
-- `ota` bool (false): If true, use the OAI and spectrum configurations for OTA else use the ones of Colosseum
-- `control` bool (false): If set to true, performs the PRB masking
-- `energy-gui` bool (false): If set to true, creates and show the energy spectrum
-- `iq-plotter-gui` bool (false): If set to true, creates and show the sensed spectrum
-- `save-iqs` bool (false): Specify if this is data collection run or not. In the first case I/Q samples will be saved
-- `timed` bool (false): Run with a 5-minute time limit
-
-
-If you use the dApp concept and/or the framework to develop your own dApps, please cite the following paper:
-
-```text
-@ARTICLE{lacava2025dApps,
-author={Andrea Lacava and Leonardo Bonati and Niloofar Mohamadi and Rajeev Gangula and Florian Kaltenberger and Pedram Johari and Salvatore D'Oro and Francesca Cuomo and Michele Polese and Tommaso Melodia},
-title: {dApps: Enabling Real-Time AI-Based Open RAN Control},
-url={https://arxiv.org/pdf/2501.16502},
-year={2025}
-}
-```

dapps-0.0.2/VERSION

@@ -1 +0,0 @@
-0.0.2

dapps-0.0.2/pyproject.toml

@@ -1,58 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "dapps"
-dynamic = ["version"]
-description = 'A library for creating and connecting dApps to Open RAN units.'
-readme = "README.md"
-requires-python = ">=3.8"
-keywords = ["dApps", "o-ran", "5g"]
-authors = [
-  { name = "Andrea Lacava", email = "thecave003@gmail.com" },
-]
-classifiers = [
-  "Development Status :: 4 - Beta",
-  "Programming Language :: Python",
-  "Programming Language :: Python :: 3.8",
-  "Programming Language :: Python :: 3.9",
-  "Programming Language :: Python :: 3.10",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.12",
-  "Programming Language :: Python :: Implementation :: CPython",
-  "Programming Language :: Python :: Implementation :: PyPy",
-]
-
-dependencies = [
-  "asn1tools",
-  "typing_extensions",
-  "numpy",
-  "pyzmq"
-]
-
-[project.urls]
-Homepage = "https://openrangym.com/ran-frameworks/dapps"
-Package = "https://pypi.org/project/dapps/"
-Source = "https://github.com/wineslab/dApp-library"
-"Bug Tracker" = "https://github.com/wineslab/dApp-library/issues"
-
-[tool.hatch.version]
-path = "VERSION"
-pattern = "(?P<version>\\d+\\.\\d+\\.\\d+)"
-
-[tool.hatch.build.targets.wheel]
-packages = ['src/dapp', 'src/e3interface', 'src/spectrum','src/visualization']
-sources = ["src"]
-
-[project.optional-dependencies]
-network = ["pysctp"]
-gui = ["flask", "flask-socketio", "matplotlib"]
-api = ["influxdb_client"]
-all = [
-  "pysctp",
-  "flask",
-  "flask-socketio",
-  "matplotlib", 
-  "influxdb_client"
-]