How yoyuqre/iot_a-p_capstone works
This is a reproducible synthetic IoT-traffic research pipeline, not a real-device monitoring product. Its primary workflow generates normal device traffic, fingerprints each device, injects labeled anomaly scenarios, detects deviations, runs experiments, evaluates results, and visualizes findings. The README also describes interactive dashboard exploration; dashboard modules exist in the tree, though the dashboard entry point is not. Edges follow the documented workflow or shown module references; unsampled implementation details and dashboard wiring are not assumed.
Main entry points: main.py Pipeline Runner · experiments.py Experiment Runner · schemas.py Data Schemas · detector.py Statistical Detector
Components 15
Traffic Simulation
- Traffic Simulator
src/simulator.py - Anomaly Scenarios
src/anomalies.py - Wokwi Log Bridge
src/io_bridge.py
Detection Pipeline
- Device Fingerprints
src/fingerprint.py - Statistical Detector
src/detector.py
Experiments & Results
- Pipeline Runner
main.py - Experiment Runner
src/experiments.py - Metrics Evaluation
src/evaluation.py
User Exploration
- Result Visualizations
src/visualization.py - Dashboard Data
src/dashboard_data.py - Dashboard Utilities
src/dashboard_utils.py
Shared Foundation
- Simulation Config
src/config.py - Data Schemas
src/schemas.py - Shared Utilities
src/utils.py
Other components
- Researcher
Connections 22
- Researcher → Pipeline Runner: runs pipeline
README.md - Pipeline Runner → Traffic Simulator: generates traffic
main.py - Pipeline Runner → Device Fingerprints: computes baselines
main.py - Pipeline Runner → Anomaly Scenarios: injects scenarios
main.py - Pipeline Runner → Statistical Detector: runs detection
main.py - Pipeline Runner → Experiment Runner: runs experiments
main.py - Pipeline Runner → Metrics Evaluation: evaluates results
main.py - Pipeline Runner → Result Visualizations: creates figures
main.py - Experiment Runner → Traffic Simulator: generates baseline
src/experiments.py - Experiment Runner → Device Fingerprints: computes baseline
src/experiments.py - Experiment Runner → Anomaly Scenarios: injects scenarios
src/experiments.py - Experiment Runner → Statistical Detector: scores observations
src/experiments.py - Dashboard Utilities → Dashboard Data: uses dashboard data
src/dashboard_utils.py - Researcher → Dashboard Utilities: explores results
README.md - Traffic Simulator → Simulation Config: reads parameters
src/simulator.py - Device Fingerprints → Data Schemas: uses data types
src/fingerprint.py - Anomaly Scenarios → Data Schemas: uses data types
src/anomalies.py - Statistical Detector → Device Fingerprints: uses baselines
src/detector.py - Statistical Detector → Data Schemas: uses data types
src/detector.py - Experiment Runner → Data Schemas: uses data types
src/experiments.py - Metrics Evaluation → Data Schemas: uses data types
src/evaluation.py - Wokwi Log Bridge → Data Schemas: uses data types
src/io_bridge.py