Virtual Cavity RF Simulator

A comprehensive Radio Frequency cavity simulation platform with advanced graphical interface for accelerator physics applications

Python Version License Platform Status

๐ŸŒŸ Key Features

๐ŸŒ Try the Web Simulator Now!

No installation required - Run the full RF cavity simulator in your browser

Launch Simulator
๐ŸŽ›๏ธ
Real-time Control

Multi-parameter control interface with precision sliders for amplitude, phase, frequency, and beam current.

๐Ÿ“Š
Advanced Visualization

Multi-curve dynamic display with real-time plotting of cavity voltage, reflection, detuning, and mechanical modes.

๐Ÿ”
Data Analysis

Historical data recording, playback, export in CSV/JSON formats with 10,000+ data points capacity.

๐Ÿงช
Parameter Scanning

Automated parameter sweeping with custom ranges and 20-point response curve generation.

๐Ÿš€ Quick Start

Installation
# Clone the repository
git clone https://github.com/iuming/virtual-cavity-simulator.git
cd virtual-cavity-simulator

# Install dependencies
pip install -r requirements.txt

# Launch the GUI
python launch_gui.py

๐Ÿ“– Usage Examples

Basic Simulation

from examples.basic_simulation import basic_cavity_simulation

# Run basic simulation
time_data, vc_data, vr_data, detuning = basic_cavity_simulation()

print(f"Average cavity voltage: {np.mean(np.abs(vc_data))*1e-6:.2f} MV")

GUI Application

# Launch full-featured GUI
python launch_gui.py

# Or run standalone simulation
python sim_cavity_standalone.py

๐Ÿ”ง Technical Specifications

Simulation Parameters

  • Time Resolution: 1 ฮผs time steps
  • Cavity Frequency: 1.3 GHz (configurable)
  • Quality Factor: 3ร—10โถ (loaded)
  • Mechanical Modes: 5 modes (280-618 Hz)
  • Beam Parameters: 0-20 mA variable current

Performance Metrics

  • Real-time Performance: 1000+ simulations/second
  • Memory Usage: <100MB for typical operations
  • Data Capacity: 10,000+ data points
  • Platform Support: Windows, Linux, macOS
  • Simulation Accuracy: <1% error validated