RANFusion Simulator is a tool designed to simulate the behavior and performance of 5G network components. Our simulator offers a detailed framework to test and analyze various components of 5G technology, including the RAN functionalities, behavior, and performance of 5G networks, This version (1.0.0) just focuses on handover processes.

We are continuously developing and improving RANFusion. Your feedback and contributions are invaluable to us. If you encounter any bugs or have suggestions for new features, please open an issue or submit a pull request. Together, we can make RANFusion even better!

If you find our work useful, please consider citing our paper:

@misc{natanzi2024ranfusion,
      title={RANFusion: A Comprehensive Tool for Simulating Handover In Next-G RAN}, 
      author={Seyed Bagher Hashemi Natanzi and Bo Tang},
      year={2024},
      eprint={2405.19480},
      archivePrefix={arXiv},
      primaryClass={cs.NI}
}

• Initial UE Configuration

  

• Simulation Logs

  

• Command Line menu

  

• InfluxDB GUI for Performance Metrics

  

• Realistic RAN Simulation: Models 5G network elements and protocols accurately.
• Multi-Support: For multiple gNodeB, Cells, Sectors, and UEs.
• API Enabled: To add, remove, and update UEs with parameters.
• CLI/CD Enabled: To see the state of each entity.
• Customizable Scenarios: For configuring various network scenarios.
• Supported Scenarios: Traffic generation for UEs and soft handover within gNodeB.
• Performance Metrics via InfluxDB: Comprehensive metrics for insightful 5G network analysis.

• Operating System: Windows
• Python: Version 3.x.
• Dependencies: Install InfluxDB and Libraries via pip install -r requirements.txt.

1. Clone the Repository: Obtain the project on your machine.
2. Navigate: Move to the project directory.
3. InfluxDB Make sure influxDB separately install on you machine
4. Setup: Execute setup.py and wait.
5. InfluxDB: Install and setup on your machine.
6. API Token: Get the API token from InfluxDB GUI (http://localhost:8086/).
7. Configure: Insert the token into setup.py.
8. Run: Start the simulation with main.py.
9. Send command via API: Start a new terminal and past a sample API like add or remove ue.

Explore RANFusion further in our documentation.(https://RANFusion.com/doc).

To get the list of the all ue:

$response = Invoke-RestMethod -Uri 'http://localhost:5000/api/ues' -Method Get; $response | ConvertTo-Json -Depth 10

To remove a UE, for example, remove "UE10" :

Invoke-RestMethod -Uri 'http://localhost:5000/del_ue' -Method Post -ContentType 'application/json' -Body '{"ue_id": "ue10"}'

To stop a UE traffic, for example, stop "UE1" :

Invoke-RestMethod -Uri "http://localhost:5000/api/stop_ue_traffic" -Method Post -ContentType "application/json" -Body '{"ue_id": "ue1"}'

To update a UE parameter, for example, set "MaxBandwidth" of "UE10" to 150 :

Invoke-RestMethod -Method Post -ContentType "application/json" -Body '{
    "ue_id": "ue10",
    "MaxBandwidth": 150
}' -Uri http://localhost:5000/update_ue

To receive a UE metric, for example, "ue1" :

Invoke-RestMethod -Uri 'http://localhost:5000/api/ue_metrics?ue_id=ue1' -Method Get

To exit from RANFusion:

Invoke-RestMethod -Uri 'http://localhost:5000/api/shutdown' -Method Post

To Remove all information inside the influx db:

Invoke-RestMethod -Uri "http://localhost:5000/flush_database" -Method Post -Headers @{"Content-Type"="application/json"} -Body '{"confirm":"yes"}'

To change a UE traffic, for example, "UE10" :

Invoke-RestMethod -Uri 'http://localhost:5000/set_traffic' -Method Post -ContentType 'application/json' -Body '{"ue_id": "5", "traffic_params": {"throughput": 30}}'

To add a UE for example add "UE11" to sector "AX1112-A1" :

Invoke-RestMethod -Uri 'http://localhost:5000/add_ue' -Method Post -ContentType 'application/json' -Body '{
  "ue_id": "42",
  "service_type": "data",
  "sector_id": "AX1112-A1",
  "gnodeb_id": "",
  "IMEI": "",
  "location": {
    "latitude": 42.2745,
    "longitude": -71.8064
  },
  "connectedCellID": "",
  "isMobile": "",
  "initialSignalStrength": 0.75,
  "rat": "NR",
  "maxBandwidth": 200,
  "duplexMode": "TDD",
  "txPower": 23,
  "modulation": [
    "QPSK"
  ],
  "coding": "LDPC",
  "mimo": "2x2",
  "processing": "Category 4",
  "bandwidthParts": [
    50
  ],
  "channelModel": "TDL-C",
  "velocity": 50,
  "direction": 135,
  "trafficModel": "Full Buffer",
  "schedulingRequests": true,
  "rlcMode": "AM",
  "snrThresholds": [
    18
  ],
  "hoMargin": 6,
  "n310": 1,
  "n311": 5,
  "model": "Iphon14 pro",
  "screensize": "6.12",
  "batterylevel": 80,
  "datasize": ""
}'