# Simulation Tab

# Simulation Tab Explained

The Simulation tab provides visual analysis of your VIC circuit design. It generates frequency response curves, time-domain waveforms, and key performance metrics that help you understand and optimize circuit behavior.

## Simulation Overview

The simulation performs several types of analysis:

#### 1. Frequency Domain Analysis

Sweeps through a frequency range to show how the circuit responds at different frequencies.

#### 2. Impedance Analysis

Shows how circuit impedance varies with frequency, identifying resonant points.

#### 3. Time Domain Analysis

Simulates actual voltage and current waveforms during pulse operation.

#### 4. Ring-down Analysis

Shows how oscillations decay after excitation stops.

## Frequency Response Display

The frequency response plot shows amplitude vs. frequency:

```
Amplitude
    ↑
    │
    │              ╱╲
    │             ╱  ╲          ← Secondary resonance
    │            ╱    ╲
    │           ╱      ╲
    │   ╱╲     ╱        ╲
    │  ╱  ╲   ╱          ╲
    │ ╱    ╲ ╱            ╲
    │╱      ╳              ╲
    └─────────────────────────→ Frequency (kHz)
         ↑           ↑
    Primary      Secondary
    resonance    resonance
```

### Key Features in Plot

<table id="bkmrk-feature-what-it-mean" style="width: 100%; border-collapse: collapse; margin: 20px 0;"><thead><tr style="background: #007bff; color: white;"><th style="padding: 10px; border: 1px solid #ddd;">Feature</th><th style="padding: 10px; border: 1px solid #ddd;">What It Means</th><th style="padding: 10px; border: 1px solid #ddd;">Ideal Characteristic</th></tr></thead><tbody><tr><td style="padding: 10px; border: 1px solid #ddd;">Peak Height</td><td style="padding: 10px; border: 1px solid #ddd;">Voltage magnification at resonance</td><td style="padding: 10px; border: 1px solid #ddd;">Higher = more voltage gain</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">Peak Sharpness</td><td style="padding: 10px; border: 1px solid #ddd;">Q factor (sharp = high Q)</td><td style="padding: 10px; border: 1px solid #ddd;">Depends on application</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">Peak Location</td><td style="padding: 10px; border: 1px solid #ddd;">Resonant frequency f₀</td><td style="padding: 10px; border: 1px solid #ddd;">Should match design target</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">-3dB Bandwidth</td><td style="padding: 10px; border: 1px solid #ddd;">Frequency range at 70.7% of peak</td><td style="padding: 10px; border: 1px solid #ddd;">Narrower = higher Q</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">Multiple Peaks</td><td style="padding: 10px; border: 1px solid #ddd;">Primary and secondary resonances</td><td style="padding: 10px; border: 1px solid #ddd;">Aligned for max transfer</td></tr></tbody></table>

## Calculated Metrics

The simulation calculates and displays these key values:

#### Resonance Parameters

<div id="bkmrk-primary-f%E2%82%80%3A-resonant" style="background: #e7f3ff; padding: 20px; border-radius: 5px; margin: 20px 0;"><div style="background: #e7f3ff; padding: 20px; border-radius: 5px; margin: 20px 0;"><table style="width: 100%; border-collapse: collapse;"><tbody><tr><td style="padding: 8px;">**Primary f₀:**</td><td style="padding: 8px;">Resonant frequency of L1-C1 tank</td></tr><tr><td style="padding: 8px;">**Secondary f₀:**</td><td style="padding: 8px;">Resonant frequency of L2-C<sub>wfc</sub> tank</td></tr><tr><td style="padding: 8px;">**Match Status:**</td><td style="padding: 8px;">How well primary and secondary are tuned</td></tr></tbody></table>

</div></div>#### Q Factor Metrics

<div id="bkmrk-primary-q%3A-q-factor-" style="background: #e7f3ff; padding: 20px; border-radius: 5px; margin: 20px 0;"><div style="background: #e7f3ff; padding: 20px; border-radius: 5px; margin: 20px 0;"><table style="width: 100%; border-collapse: collapse;"><tbody><tr><td style="padding: 8px;">**Primary Q:**</td><td style="padding: 8px;">Q factor of primary circuit</td></tr><tr><td style="padding: 8px;">**Secondary Q:**</td><td style="padding: 8px;">Q factor of secondary circuit</td></tr><tr><td style="padding: 8px;">**System Q:**</td><td style="padding: 8px;">Effective Q of coupled system</td></tr></tbody></table>

</div></div>#### Performance Metrics

<div id="bkmrk-voltage-magnificatio" style="background: #e7f3ff; padding: 20px; border-radius: 5px; margin: 20px 0;"><table style="width: 100%; border-collapse: collapse;"><tbody><tr><td style="padding: 8px;">**Voltage Magnification:**</td><td style="padding: 8px;">V<sub>out</sub>/V<sub>in</sub> at resonance</td></tr><tr><td style="padding: 8px;">**Bandwidth:**</td><td style="padding: 8px;">-3dB frequency range</td></tr><tr><td style="padding: 8px;">**Ring-down Time:**</td><td style="padding: 8px;">Time constant τ = 2L/R</td></tr><tr><td style="padding: 8px;">**Ring-down Cycles:**</td><td style="padding: 8px;">Oscillation cycles during decay</td></tr></tbody></table>

</div>## Impedance Plot

Shows circuit impedance magnitude and phase vs. frequency:

```
|Z| (Ω)                          Phase
   ↑                               ↑
   │      ╱╲                       │         ╱────
   │     ╱  ╲    ← Peak at        │        ╱
   │    ╱    ╲     resonance      │       ╱
   │   ╱      ╲                    │──────╳  ← 0° at f₀
   │  ╱        ╲                   │     ╱
   │ ╱          ╲                  │    ╱
   │╱            ╲                 │───╱────
   └──────────────────→ f         └──────────────→ f
```

### Interpreting Impedance

- **Peak impedance:** Maximum at parallel resonance
- **Minimum impedance:** At series resonance points
- **Phase = 0°:** Indicates resonant frequency
- **Positive phase:** Inductive behavior (current lags)
- **Negative phase:** Capacitive behavior (current leads)

## Time Domain Waveforms

The time-domain view shows actual voltage and current over time:

#### Waveforms Displayed:

<div id="bkmrk-input-voltage%3A-the-d" style="background: #f8f9fa; padding: 20px; border-radius: 5px; margin: 20px 0;"><div style="background: #f8f9fa; padding: 20px; border-radius: 5px; margin: 20px 0;">- **Input Voltage:** The driving pulse waveform
- **Primary Current:** Current through L1
- **WFC Voltage:** Voltage across the water cell
- **WFC Current:** Current through the cell

</div></div>#### What to Look For:

<div id="bkmrk-voltage-build-up-dur" style="background: #f8f9fa; padding: 20px; border-radius: 5px; margin: 20px 0;">- Voltage build-up during resonance
- Ring-down oscillations after pulse ends
- Phase relationship between V and I
- Settling time and stability

</div>## Ring-Down Display

Shows oscillation decay after excitation stops:

```
Voltage
   ↑
   │╱╲
   │  ╲╱╲
   │    ╲╱╲
   │      ╲╱╲
   │        ╲╱╲
   │          ╲╱╲
   │            ╲╱─── → Envelope decay
   │              ╲
   └────────────────────→ Time

   ←─── τ ───→
   (63% decay)
```

### Ring-Down Metrics

<table id="bkmrk-metric-formula-signi" style="width: 100%; border-collapse: collapse; margin: 20px 0;"><thead><tr style="background: #28a745; color: white;"><th style="padding: 10px; border: 1px solid #ddd;">Metric</th><th style="padding: 10px; border: 1px solid #ddd;">Formula</th><th style="padding: 10px; border: 1px solid #ddd;">Significance</th></tr></thead><tbody><tr><td style="padding: 10px; border: 1px solid #ddd;">Time Constant (τ)</td><td style="padding: 10px; border: 1px solid #ddd;">τ = 2L/R</td><td style="padding: 10px; border: 1px solid #ddd;">Time to decay to 37%</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">Ring-down Cycles</td><td style="padding: 10px; border: 1px solid #ddd;">n ≈ 0.733 × Q</td><td style="padding: 10px; border: 1px solid #ddd;">Oscillations before decay</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">Settling Time</td><td style="padding: 10px; border: 1px solid #ddd;">~5τ for 99% decay</td><td style="padding: 10px; border: 1px solid #ddd;">Time to reach steady state</td></tr></tbody></table>

## Warning Indicators

The simulation flags potential issues:

<table id="bkmrk-warning-meaning-acti" style="width: 100%; border-collapse: collapse; margin: 20px 0;"><thead><tr style="background: #dc3545; color: white;"><th style="padding: 10px; border: 1px solid #ddd;">Warning</th><th style="padding: 10px; border: 1px solid #ddd;">Meaning</th><th style="padding: 10px; border: 1px solid #ddd;">Action</th></tr></thead><tbody><tr><td style="padding: 10px; border: 1px solid #ddd;">⚠️ Near SRF</td><td style="padding: 10px; border: 1px solid #ddd;">Operating frequency close to choke SRF</td><td style="padding: 10px; border: 1px solid #ddd;">Reduce frequency or redesign choke</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">⚠️ Low Q</td><td style="padding: 10px; border: 1px solid #ddd;">Q factor below recommended threshold</td><td style="padding: 10px; border: 1px solid #ddd;">Reduce losses (DCR, water R)</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">⚠️ Frequency Mismatch</td><td style="padding: 10px; border: 1px solid #ddd;">Primary and secondary not aligned</td><td style="padding: 10px; border: 1px solid #ddd;">Adjust C1 or component values</td></tr><tr><td style="padding: 10px; border: 1px solid #ddd;">⚠️ High Voltage</td><td style="padding: 10px; border: 1px solid #ddd;">Magnified voltage exceeds safe limits</td><td style="padding: 10px; border: 1px solid #ddd;">Verify insulation ratings</td></tr></tbody></table>

## Using Simulation Results

#### Design Iteration Process:

<div id="bkmrk-run-initial-simulati" style="background: #d4edda; padding: 20px; border-radius: 5px; margin: 20px 0;">1. Run initial simulation with your component values
2. Check if resonant frequency matches your target
3. Evaluate Q factor—is it sufficient for your goals?
4. Look for warnings and address them
5. Adjust parameters and re-simulate
6. Compare before/after to verify improvements

</div>**Pro Tip:** Save your circuit profile before making changes. This allows you to compare different configurations side-by-side and roll back if needed.

*Next: Circuit Optimization Strategies →*