Skip to content

Repository files navigation

RadarSim Logo

RadarSim v2.4.0

Professional Pulse-Doppler Radar Simulation Platform
Physics-Based • AI-Enhanced • Imaging Radar • Open Source

FeaturesQuick StartShortcutsDocsCitation

Python 3.10+PyQt6MIT Licensev2.4.0217 testsPhase 30


📖 Overview

RadarSim is a scientifically-validated radar simulation engine for education, research, and professional training. Built with NumPy/Numba for performance and PyQt6 for a modern UI.

🔬 Scientific Core

  • Pulse-Doppler Engine: Signal-level processing (CPI, MTI, FFT) referenced from Richards (2005).
  • Advanced Tracking: Extended Kalman Filter (EKF) with polar coordinates.
  • Electronic Warfare: DRFM Jamming (RGPO/VGPO) and Frequency Agility.
  • Sensor Fusion: Networked Radar & Strobe Triangulation.
  • Imaging: High-resolution SAR/ISAR algorithms.
  • AI/Cognitive Control: Dynamic logic referenced from Haykin (2006).

Key Validation: Radar Equation calculations achieve ±0.005 dB accuracy vs. Skolnik reference values.

PPI ScopeFigure 1: Main Plan Position Indicator (PPI) display showing detected targets.


✨ Features

🎯 Physics Engine

FeatureImplementationReference
Radar EquationMonostatic/Bistatic with Numba JITSkolnik, Ch. 2
Atmospheric AttenuationITU-R P.676-12 (O₂ + H₂O)IEEE Std
Swerling RCS ModelsTypes 0-4 fluctuationSwerling (1960)
Monopulse TrackingSum/Difference patterns, sub-beamwidth accuracyPhase 20
3D Terrain Masking4/3 Earth refraction, LOS shadowingITU-R P.526

🌪️ Environmental Effects

FeatureDetails
Ground ClutterWeibull distribution, σ⁰ coefficients
Sea ClutterGIT Model, Douglas sea states (1-6)
Rain PhysicsITU-R P.838 Attenuation + Marshall-Palmer Clutter
MTI FilteringVelocity threshold, slow-mover rejection

⚔️ Electronic Warfare

TechniqueTypeStatus
Noise JammingECM
DRFM RepeaterECM
RGPO/VGPO DeceptionECM
Frequency AgilityECCM
Burn-Through DisplayECM Strobe

🛰️ Imaging Radar (Phase 30)

FeatureImplementationReference
SAR (RDA)Vectorized 5-stage Range-Doppler AlgorithmCumming & Wong (2005)
ISARCross-range imaging via target rotationChen & Ling (2002)
ResolutionΔr = c/(2B) = 1.5m, Δa = D/2 = 0.5mVerified

🤖 AI Tactical Director (Phase 30)

FeatureDescription
Coverage Analysis2D Pd map from multi-radar network
Blind Zone DetectionFlood-fill connected component analysis
Attack Planning3 difficulty levels (Easy/Medium/Hard)
Low-Pd RoutingGreedy corridor navigation
Jammer DeploymentOptimal DRFM positioning

📊 Visualization Scopes

ScopeDescription
PPIPlan Position Indicator with phosphor decay
B-ScopeRange vs Azimuth (AESA style) with ECM strobes
A-ScopeAmplitude vs Range with CFAR hover visualization
RHIRange-Height Indicator (elevation)
3D TacticalOpenGL terrain with target spheres
SAR ViewerReal physics-based Synthetic Aperture Radar imaging

📸 Visualization Gallery

SAR Imaging3D Tactical Map
Real-time SAR formation (Range-Doppler)3D situation awareness
RHI ScopeA-Scope Analysis
Elevation scanning (Range-Height)CFAR threshold visualization

📈 Analysis Tools

ToolFunction
Ambiguity DiagramPRF vs Range/Velocity trade-off
ROC CurvesPd vs Pfa for Swerling models
SNR HistogramDetection strength distribution

📊 Analysis Tools

Ambiguity Diagram • ROC Curves • Real-time SNR Statistics

🤖 AI/ML Pipeline

  • RandomForest Classifier trained on synthetic radar data
  • Classes: Drone 🛸, Fighter Jet ✈️, Missile 🚀
  • Real-time inference with confidence scoring

🚀 Quick Start

# Clone repository
git clone https://github.com/SpaceEngineerSS/RadarSim.git
cd RadarSim
# Create virtual environment
python -m venv .venv
.venv\Scripts\activate # Windows# source .venv/bin/activate # Linux/Mac# Install dependencies
pip install -r requirements.txt
# Run application
python run_gui.py

⌨️ Keyboard Shortcuts

KeyAction
SpacePlay/Pause simulation
RReset (stop) simulation
1Switch to PPI Scope
2Switch to RHI Scope
3Switch to 3D Tactical
4Switch to 4th tab
F11Toggle fullscreen
Ctrl+OLoad scenario
Ctrl+Shift+SSave scenario
Ctrl+RStart recording

📁 Project Structure

RadarSim/
├── run_gui.py # Main entry point (PyQt6 GUI)
├── headless.py # Headless simulation runner
├── batch_run.py # Batch scenario executor
├── requirements.txt # Dependencies
├── scenarios/ # YAML scenario files (10 scenarios)
│ ├── f16_vs_sa6.yaml
│ ├── drone_swarm_saturation.yaml
│ ├── naval_battlegroup.yaml
│ └── ...
├── src/
│ ├── physics/ # Core physics (radar_equation, clutter, ecm)
│ ├── signal/ # Signal processing (cfar, pulse_doppler, antenna)
│ ├── tracking/ # Target tracking (EKF, monopulse, track manager)
│ ├── simulation/ # Simulation engine & network manager
│ ├── ui/ # PyQt6 GUI (PPI, B-Scope, RHI, A-Scope, 3D)
│ ├── advanced/ # SAR/ISAR, AI Director, Sensor Fusion, ECCM, LPI
│ └── ml/ # AI classification pipeline
├── models/ # Trained ML models
├── docs/ # Documentation
└── tests/ # 217 unit tests

📚 Documentation

DocumentDescription
Physics EngineRadar equation, Monopulse, Ambiguity
Signal ProcessingCFAR, MTI, SAR algorithms
User GuideGUI walkthrough and Advanced features

🔬 Scientific References

  1. Skolnik, M.I.Radar Handbook, 3rd Ed., McGraw-Hill, 2008
  2. Richards, M.A.Fundamentals of Radar Signal Processing, 2nd Ed., McGraw-Hill, 2014
  3. IEEE Std 686-2017 — Radar Definitions
  4. ITU-R P.676-12 — Attenuation by Atmospheric Gases
  5. Cumming & WongDigital Processing of SAR Data, Artech House, 2005
  6. Chen & LingTime-Frequency Transforms for Radar Imaging, Artech House, 2002
  7. Bar-Shalom, Y.Estimation with Applications to Tracking, Wiley, 2001
  8. Julier & UhlmannNon-divergent Estimation Algorithm, ACC, 1997
  9. Schleher, D.C.Electronic Warfare in the Information Age, Artech House, 1999
  10. Poisel, R.Electronic Warfare Target Location Methods, Artech House, 2012

📜 License

MIT License - See LICENSE for details.


📖 Citation

If you use RadarSim in academic work, please cite:

@software{radarsim2025,
title = {RadarSim: Physics-Based Pulse-Doppler Radar Simulation},
author = {RadarSim Contributors},
year = {2025},
url = {https://github.com/SpaceEngineerSS/RadarSim}
}

👨‍💻 Developer

Mehmet Gümüş


Built with ❤️ for the Radar Community

About

Open-source radar simulation for education and research. Features radar equation, clutter models, ECM/ECCM, and ML classification.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages