https://github.com/sibyx/monadcount-sim
Indoor GeoJSON-based NS-3 simulator environment
https://github.com/sibyx/monadcount-sim
Last synced: 3 months ago
JSON representation
Indoor GeoJSON-based NS-3 simulator environment
- Host: GitHub
- URL: https://github.com/sibyx/monadcount-sim
- Owner: Sibyx
- Created: 2025-04-01T18:47:14.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-05-09T18:10:28.000Z (5 months ago)
- Last Synced: 2025-05-09T19:23:52.341Z (5 months ago)
- Language: C++
- Size: 380 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MonadCountSim: Indoor GeoJSON-based NS-3 environment
**Work in Progress - PhD Sanity Optional**
A simulation framework for indoor environments using GeoJSON and NS-3. Uses fancy algorithms to model pedestrian
movement, Wi-Fi signal propagation, and general chaos.
## Architecture
```mermaid
flowchart TD
A[GeoJSON File] --> B[GeoJSONParser]
B --> C((Feature Objects))
C --> D[EnvironmentBuilder]
D --> E((ScenarioEnvironment))
E --> E1[AP Nodes]
E --> E2[Obstacles]
E --> E3[Seats]
E --> E4[Doors]
E --> E5[Terminals]
E --> E6[EventDispatcher]
K[Scenario Manager] --> I
K -->|Monitors events| E6
K -->|Controls spawn rate| F
E4 --> F[Door]
F --> I[PedestrianFactory]
I --> J[Pedestrian]
J -- "Events" --> E6
style A fill:#ffd,stroke:#333
style B fill:#ccf,stroke:#333
style D fill:#ccf,stroke:#333
style E fill:#afa,stroke:#333
style F fill:#fcc,stroke:#333
style I fill:#cfc,stroke:#333
style J fill:#cfc,stroke:#333
style K fill:#ccf,stroke:#333
```
## Install
**Pre-requisites:**
- C++20 compatible compiler
- CMake 3.14+
- Git
### Step 1: Clone the Repository with Submodules
```shell
git clone https://github.com/Sibyx/monadcount-sim.git
cd monadcount-sim
git submodule update --init --recursive
```
### Step 2: Build dependencies
```shell
make all
```
This will:
- Build NS-3 from the submodule
- Install NS-3 to the local `extern/ns3-dist` directory
- Configure and build the MonadCountSim project
**Alternative: Step-by-Step Build**
```shell
# Build NS-3
make ns3
# Build netanim
# Build MonadCountSim
make build
```
## Running the Simulation
```shell
# Run the default scenario
bin/monadcount-sim
# Run with a specific scenario and GeoJSON input
bin/monadcount-sim --scenario=basic --input=geojson/room.geo.json
# output of simulation is in data/*
# Open simulation using netanim
bin/netanim data/basic/netanim.xml
```
## LEGACY: Project & Toolchain Setup
This part of readme is for now just a note for me, to not forget how to set up the project and toolchain.
Use just for troubleshooting, not for normal development.
### Project creation from scratch
```shell
git submodule add https://gitlab.com/nsnam/ns-3-dev.git extern/ns3-src
git submodule add https://github.com/nlohmann/json.git extern/nlohmann_json
git submodule add https://gitlab.com/nsnam/netanim.git extern/netanim
git submodule add https://github.com/usnistgov/NetSimulyzer-ns3-module extern/netsimulyzer-ns3
git submodule add https://github.com/usnistgov/NetSimulyzer extern/netsimulyzer-gui
git submodule update --init --recursive
cd extern/ns3-src && git checkout tags/ns-3.43
cd extern/nlohmann_json && git checkout tags/v3.11.3
```
### Manual NS-3 build
```shell
# Sync submodules
git submodule update --init --recursive
# Configure and build NS3
cd extern/ns3-src
# Ugly, need to take notes. Me lazy fuck
./ns3 configure --enable-examples --enable-tests --enable-mpi --prefix /Users/jdubec/Projects/MonadCount/monadcount-sim/extern/ns3-dist
./ns3 build
./ns3 install
# Execute cmake: TBD
```