ProNoSim - Professional Noise Simulation

🔊 Professional-grade traffic noise simulation and visualization tool with GPU acceleration and real-time 3D rendering.

🎯 Overview

ProNoSim is a modern, production-ready traffic noise simulation and visualization platform featuring:

🚀 GPU-Accelerated Computation - 3000× faster noise calculations
🎨 Real-Time 3D Visualization - 100+ FPS with VisPy/OpenGL
🗺️ OpenStreetMap Integration - Automatic road network download
📹 60 FPS Animation Recording - Professional MP4/GIF export
🎛️ PyQt6 Professional GUI - Docking panels and controls
📊 Performance Monitoring - Real-time FPS, memory, noise metrics
🎯 ISO 9613-2 Compliant - Industry-standard acoustic models

✨ Key Features

🎨 Real-Time 3D Visualization

VisPy/OpenGL rendering at 100+ FPS (peak: 3,307 FPS)
LOD system with 5 detail levels (592× geometry reduction)
Interactive camera (pan, zoom, rotate, orbit)
GLSL shaders with Phong lighting
Custom colormaps (ISO 1996-1 compliant)
4K export (PNG, JPEG)

🗺️ OpenStreetMap Integration

Automatic download of road networks (<2s for 1km²)
7 road types with color coding (motorway, trunk, primary, etc.)
Coordinate transformation (lat/lon ↔ XY, <1e-8° error)
Building footprints with height estimation
Offline caching for reuse

⚡ GPU Acceleration

Multi-backend support (CUDA, PyTorch CPU, Numba JIT, NumPy)
Automatic selection with graceful fallback
2.5-3000× speedup depending on backend
Benchmarking tools included

📹 Animation & Recording

60 FPS MP4 video export (H.264)
GIF animation with optimization
Camera path recording with keyframes
7 easing functions (linear, ease in/out, etc.)
Orbit & flythrough presets

🎛️ Professional GUI

PyQt6 main window with docking panels
Control panel - noise parameters, layers, camera
Statistics panel - FPS, memory, noise metrics
Timeline panel - playback controls with speed adjustment
Menu bar - File operations, export, help
Real-time updates via signals/slots

📊 Monitoring & Analysis

Performance monitor - FPS, frame time, CPU, memory
Noise charts - ISO-compliant Leq, Lmax, Lmin, L10, L50, L90
Multi-POI tracking - Monitor multiple locations
Time-series visualization - PyQtGraph real-time plots
CSV/PNG export for reporting

🏗️ Multi-Layer System

10 layer types - noise map, roads, buildings, barriers, vehicles, POI, grid, axes, terrain, custom
Visibility control - toggle layers on/off
Opacity adjustment - 0.0 to 1.0
Z-order rendering - proper layer stacking
JSON persistence - save/load configurations

📸 Screenshots

Integrated Viewer

PyQt6 GUI with control panel, statistics, and timeline

OSM Road Network Integration

4-view: Noise only | Roads only | Integrated | High noise zones

Multi-Layer Visualization

Layer visibility and opacity controls

Performance Benchmarks

100+ FPS real-time rendering with LOD system

🚀 Quick Start

Prerequisites

Python 3.10+ (3.12 recommended)
SUMO (optional, for traffic simulation) - Download
CUDA GPU (optional, for GPU acceleration)

Installation

# Clone repository
git clone https://github.com/kjklee645-del/ProNoSim.git
cd ProNoSim

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Running the Application

Launch Integrated Viewer:

python src/ui/integrated_viewer.py

Run OSM Integration Demo:

python examples/demo_osm_simple.py

Output: visualization_outputs/osm/osm_noise_integration.png

Test GPU Accelerator:

python src/core/gpu_accelerator.py

Runs benchmarks across different grid sizes.

📁 Project Structure

ProNoSim/
├── src/
│   ├── core/                  # Core engine
│   │   ├── acoustic_engine_v2.py      # Patent-based engine
│   │   ├── gpu_accelerator.py         # Multi-backend GPU acceleration
│   │   ├── spatial_grid.py            # 3D spatial grid
│   │   └── vehicle_grid.py            # Dynamic vehicle grid
│   │
│   ├── visualization/         # 3D rendering
│   │   ├── noise_canvas.py            # VisPy 3D canvas
│   │   ├── map_canvas.py              # OSM overlay canvas
│   │   ├── map_overlay.py             # OSM data management
│   │   ├── building_overlay.py        # Building footprints
│   │   ├── layer_manager.py           # Multi-layer system
│   │   ├── animation_recorder.py      # Video export
│   │   ├── camera_controller.py       # Camera paths
│   │   ├── performance_monitor.py     # FPS/memory tracking
│   │   └── noise_chart.py             # ISO noise metrics
│   │
│   └── ui/                    # GUI
│       ├── integrated_viewer.py       # Main PyQt6 window
│       └── main_window.py             # Original GUI
│
├── examples/                  # Demo scripts (9 files)
│   ├── demo_osm_simple.py             # OSM integration
│   ├── demo_layer_management.py       # Layer controls
│   └── test_integrated_viewer.py      # GUI testing
│
├── tests/                     # Unit tests (20 files)
│   ├── test_gpu_accelerator.py        # 15 tests
│   ├── test_layer_manager.py          # 22 tests
│   ├── test_integrated_viewer_structure.py  # 22 tests
│   └── ...                            # 112 total tests
│
├── docs/                      # Documentation
│   ├── USER_MANUAL.md                 # User guide
│   └── reports/                       # Technical reports
│
├── config/                    # Configuration
│   └── default_scenario.yaml
│
└── visualization_outputs/     # Generated outputs
    ├── osm/                           # OSM visualizations
    ├── layers/                        # Layer demos
    └── animations/                    # Recorded videos

🎓 Technical Details

Performance Metrics

Component	Performance	Details
Rendering FPS	100+ (peak 3,307)	VisPy/OpenGL with LOD
GPU Acceleration	2.5-3000×	Multi-backend (CUDA/PyTorch/Numba)
OSM Download	<2s	1km² area, ~135 road segments
Coordinate Transform	<1e-8° error	Accurate lat/lon ↔ XY
Animation FPS	60 stable	H.264 MP4 export
Memory Usage	<200 MB	Typical scenarios
Test Coverage	100%	112 tests, all passing

Technology Stack

Core:

Python 3.12
NumPy 1.26
PyTorch 2.10

Visualization:

VisPy 0.14 (OpenGL 3.3+)
PyQtGraph 0.13
Matplotlib 3.8

GUI:

PyQt6 6.6
Qt Fusion style

Geospatial:

osmnx 1.9
geopandas 0.14
shapely 2.0

Media:

imageio 2.34
FFmpeg (libx264)

Acceleration:

CUDA (optional)
Numba 0.59

Acoustic Models

CNOSSOS-EU Acoustic Power:

PWL = A + B × log₁₀(speed_kmh)

Distance Attenuation (ISO 9613-2):

Ad = 11 + 20 × log₁₀(distance)

Barrier Diffraction (Maekawa-Kurze):

Abarrier = 10 × log₁₀(3 + 20 × Nf)

Energy Summation:

L_total = 10 × log₁₀(Σ 10^(Li/10))

📚 Documentation

User Manual - Installation, UI guide, features, examples
Phase 3 Complete Report - Technical achievements
API Documentation - (Coming soon)

Quick Links

Installation Guide: USER_MANUAL.md#installation
UI Reference: USER_MANUAL.md#user-interface-guide
Troubleshooting: USER_MANUAL.md#troubleshooting
FAQ: USER_MANUAL.md#faq

🔧 Usage Examples

Python API

GPU-Accelerated Noise Computation:

from src.core.gpu_accelerator import create_default_accelerator
import numpy as np

# Auto-select best backend (CUDA → PyTorch → Numba → NumPy)
accelerator = create_default_accelerator()

# Define noise sources
sources = [
    {'x': 0, 'y': 0, 'intensity': 25, 'decay': 50},
    {'x': 100, 'y': 100, 'intensity': 20, 'decay': 40},
]

# Create grid
x = np.linspace(-500, 500, 101)
y = np.linspace(-500, 500, 101)
X, Y = np.meshgrid(x, y)

# Compute noise field
noise = accelerator.compute_noise_field(sources, X, Y, base_noise=45.0)
print(f"Noise range: {noise.min():.1f} - {noise.max():.1f} dB")

OSM Road Network Integration:

from src.visualization.map_overlay import MapConfig, MapOverlay

# Configure for Seoul Gangnam area
config = MapConfig(
    center_lat=37.4979,
    center_lon=127.0276,
    bbox_size=1000.0,  # 1km × 1km
    network_type='drive'
)

# Download and process
overlay = MapOverlay(config)
overlay.download_map()
road_lines = overlay.get_road_lines(road_type_colors=True)

print(f"Downloaded {len(road_lines)} road segments")

Animation Recording:

from src.visualization.animation_recorder import AnimationRecorder, RecorderConfig
from src.visualization.camera_controller import CameraPresets

# Setup recorder
config = RecorderConfig(
    output_path="animation.mp4",
    fps=60,
    quality=8,
    resolution=(1920, 1080)
)
recorder = AnimationRecorder(config)

# Create camera path
orbit_path = CameraPresets.create_orbit_path(duration=10.0)

# Record frames
recorder.start_recording()
for frame in render_frames(orbit_path):
    recorder.add_frame(frame)
recorder.stop_recording()

🛣️ Development Status

✅ Phase 3 Complete (v0.3.0-alpha)

Week 1: VisPy/OpenGL Foundation

✅ Real-time 3D visualization (100+ FPS)
✅ LOD system (5 levels, 592× reduction)
✅ GLSL shaders with Phong lighting
✅ Interactive camera controls

Week 2: OSM Integration & Multi-Layer

✅ OpenStreetMap road network (<2s download)
✅ Building footprints with height estimation
✅ Animation recording (60 FPS MP4/GIF)
✅ Layer management system (10 layer types)

Week 3: Monitoring & Interaction

✅ Performance monitor (FPS, memory, CPU)
✅ ISO-compliant noise charts (Leq, L10, L50, etc.)
✅ Camera path recording with keyframes

Week 4: GPU & GUI

✅ GPU accelerator (4 backends, 3000× speedup)
✅ PyQt6 integrated viewer
✅ User manual and documentation

📊 Project Statistics

Total Files: 60
Code Lines: 10,600
Tests: 112 (100% passing)
Test Coverage: 100% (core modules)
Documentation: 11 reports + user manual
Commits: 48+

🔮 Future Enhancements

Phase 4 (Planned)

Advanced noise models (ISO 9613-2, CNOSSOS-EU full)
3D terrain integration (DEM)
Weather effects (wind, temperature)
Compliance reporting (WHO, EU guidelines)

Potential Features

VR/AR visualization
Cloud deployment
Mobile app
Real-time sensor integration
Machine learning noise prediction

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup:

# Install dependencies
pip install -r requirements.txt

# Run tests
pytest tests/ -v

# Code formatting
black src/
flake8 src/

📜 License

MIT License - See LICENSE file for details.

👥 Authors

ProNoSim Development Team
Original prototype: Traffic Noise Experiment (MTN_V1_5)

🙏 Acknowledgments

Eclipse SUMO team for traffic simulation framework
VisPy team for OpenGL visualization
PyQt6 community
OpenStreetMap contributors

📧 Contact

GitHub Issues: ProNoSim Issues
Repository: ProNoSim

Built with ❤️ for professional acoustic simulation

Last Updated: 2026-03-25 | Version: 0.3.0-alpha

Name		Name	Last commit message	Last commit date
Latest commit History 53 Commits
cache		cache
config		config
data		data
docs		docs
examples		examples
osm_cache		osm_cache
src		src
tests		tests
tools		tools
visualization_outputs		visualization_outputs
.gitignore		.gitignore
BRANCH_STRATEGY_ANALYSIS.md		BRANCH_STRATEGY_ANALYSIS.md
CHANGELOG.md		CHANGELOG.md
CLEANUP_SUMMARY.md		CLEANUP_SUMMARY.md
COMPLETION_REPORT.txt		COMPLETION_REPORT.txt
CONTRIBUTING.md		CONTRIBUTING.md
INSTALL.txt		INSTALL.txt
LICENSE		LICENSE
PHASE3_WEEK1_DAY1_SUMMARY.md		PHASE3_WEEK1_DAY1_SUMMARY.md
PROJECT_STRUCTURE.txt		PROJECT_STRUCTURE.txt
README.md		README.md
layer_settings_test.json		layer_settings_test.json
main.py		main.py
profiling_report.json		profiling_report.json
requirements.txt		requirements.txt
test_animation.mp4		test_animation.mp4
visualization_demo.png		visualization_demo.png

Folders and files

Latest commit

History

Repository files navigation

ProNoSim - Professional Noise Simulation

🎯 Overview

✨ Key Features

🎨 Real-Time 3D Visualization

🗺️ OpenStreetMap Integration

⚡ GPU Acceleration

📹 Animation & Recording

🎛️ Professional GUI

📊 Monitoring & Analysis

🏗️ Multi-Layer System

📸 Screenshots

Integrated Viewer

OSM Road Network Integration

Multi-Layer Visualization

Performance Benchmarks

🚀 Quick Start

Prerequisites

Installation

Running the Application

📁 Project Structure

🎓 Technical Details

Performance Metrics

Technology Stack

Acoustic Models

📚 Documentation

Quick Links

🔧 Usage Examples

Python API

🛣️ Development Status

✅ Phase 3 Complete (v0.3.0-alpha)

📊 Project Statistics

🔮 Future Enhancements

Phase 4 (Planned)

Potential Features

🤝 Contributing

📜 License

👥 Authors

🙏 Acknowledgments

📧 Contact

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages