# Tesla Coil Spark Physics: Interactive Course

Complete educational course teaching the physics, mathematics, and simulation techniques for understanding and modeling Tesla coil sparks. From basic circuit theory to advanced distributed modeling with FEMM.

**Version:** 1.0.0
**Created:** 2025-10-10
**Format:** Structured markdown lessons with YAML metadata

---

## 📚 Course Overview

### What You'll Learn

This course provides comprehensive coverage of:
- Circuit fundamentals and admittance analysis
- Topological phase constraints and optimization
- Thévenin equivalent analysis and power calculations
- Spark growth physics and energy requirements
- Thermal dynamics and streamer-to-leader transitions
- FEMM-based capacitance extraction
- Lumped and distributed spark modeling
- Resistance optimization algorithms

### Prerequisites

**Required:**
- Basic AC circuit analysis (impedance, phasors)
- Complex number arithmetic
- Basic calculus (derivatives, integrals)
- Familiarity with SPICE circuit simulation

**Recommended:**
- Electromagnetic field theory basics
- Experience with FEMM or similar FEA software
- Tesla coil operating experience

### Course Statistics

- **30 lessons** across 4 parts
- **18 exercises** (525 total points)
- **~14 hours** estimated completion time
- **5 comprehensive worked examples**
- **3 reference documents** (equations, bounds, glossary)
- **45+ images** needed (specifications provided)

---

## 📂 Directory Structure

```
spark-lessons/
├── course.json                 # Course structure and navigation
├── lessons/                    # All lesson content
│   ├── 01-fundamentals/       # Part 1: Circuit Fundamentals (8 lessons)
│   ├── 02-optimization/       # Part 2: Optimization & Simulation (7 lessons)
│   ├── 03-spark-physics/      # Part 3: Spark Growth Physics (9 lessons)
│   └── 04-advanced-modeling/  # Part 4: Advanced Modeling (6 lessons)
├── exercises/                  # Practice problems in YAML format
│   ├── 01-fundamentals/       # 10 exercises
│   ├── 02-optimization/       # 3 exercises
│   ├── 03-spark-physics/      # 4 exercises
│   └── 04-advanced-modeling/  # 1 exercise
├── worked-examples/            # Complete worked examples
│   ├── calculating-ropt.md
│   ├── thevenin-extraction.md
│   ├── spark-growth-timeline.md
│   ├── femm-lumped-extraction.md
│   └── distributed-model-complete.md
├── reference/                  # Quick reference materials
│   ├── equation-sheet.md      # All key formulas
│   ├── physical-bounds.md     # Validation ranges
│   └── glossary.yaml          # 64 technical terms
├── assets/                     # Images and media
│   ├── shared/                # Shared images
│   └── IMAGE-REQUIREMENTS.md  # Specifications for 45+ images
└── _originals/                 # Backup of source files
    ├── spark-lesson.txt
    └── spark-physics.txt
```

---

## 🎓 Course Structure

### Part 1: Circuit Fundamentals (200 min)
**Lessons 01-08** | Beginner to Intermediate

Learn the foundational circuit theory for spark modeling:
- AC circuit review and complex analysis
- Basic spark circuit model (C_mut, C_sh)
- Admittance analysis of parallel networks
- Phase angles and topological constraints
- Why -45° is often mathematically impossible
- Correct measurement port determination

**Key Outcomes:** Understand spark impedance, phase constraints, and measurement techniques.

---

### Part 2: Optimization & Simulation (280 min)
**Lessons 01-07** | Intermediate to Advanced

Master power optimization and simulation methods:
- R_opt_power vs R_opt_phase (two critical resistances)
- The "hungry streamer" self-optimization principle
- Thévenin equivalent extraction and analysis
- Power calculations for any load impedance
- **Frequency tracking and loaded poles** (critical!)
- DRSSTC operating modes comparison

**Key Outcomes:** Perform Thévenin analysis, optimize power transfer, understand frequency tracking importance.

---

### Part 3: Spark Growth Physics (260 min)
**Lessons 01-09** | Intermediate to Advanced

Understand the physics of spark formation and growth:
- Electric field thresholds (E_inception, E_propagation)
- Voltage-limited vs power-limited operation
- Energy per meter (ε) concept and calibration
- Thermal time constants and channel persistence
- Streamers vs leaders (transition mechanisms)
- Capacitive divider problem
- Freau's empirical scaling relationships

**Key Outcomes:** Model spark growth, estimate energy requirements, understand operating mode differences.

---

### Part 4: Advanced Modeling (285 min)
**Lessons 01-06** | Advanced

Build sophisticated spark models using FEMM:
- Lumped model theory and workflow
- FEMM electrostatic extraction for lumped models
- Distributed nth-order model theory
- FEMM extraction for distributed models (capacitance matrices)
- Resistance optimization (iterative and circuit-determined methods)
- Complete modeling project with validation

**Key Outcomes:** Extract capacitance matrices from FEMM, build lumped and distributed models, optimize resistance distribution.

---

## 🎯 Learning Paths

### Beginner Path (~8 hours)
Focus on fundamentals and basic simulation:
- Part 1: All lessons (fund-01 through fund-08)
- Part 2: Lessons 01, 03, 04 (skip hungry streamer details)
- Part 3: Lessons 01-03, 08 (basic physics and scaling)
- Part 4: Skip (or just lesson 01 for overview)

### Complete Course (~14 hours)
Full curriculum for comprehensive understanding:
- All 30 lessons in sequence
- All 18 exercises
- All 5 worked examples

### Simulation Focus (~10 hours)
For those primarily interested in modeling:
- Part 1: Lessons 01-03, 05, 08
- Part 2: All lessons (especially 06!)
- Part 3: Lessons 01-04
- Part 4: All lessons

### Physics Focus (~9 hours)
For those primarily interested in spark physics:
- Part 1: Lessons 01-03 (circuit basics only)
- Part 2: Lessons 01-02 (optimization principles)
- Part 3: All lessons (complete physics coverage)

---

## 📖 Lesson Format

Each lesson file includes:

```markdown
---
id: fund-01                    # Unique identifier
title: "Lesson Title"
section: "Fundamentals"
difficulty: "beginner"         # beginner | intermediate | advanced
estimated_time: 20             # minutes
prerequisites: []              # List of required prior lessons
objectives:                    # Learning goals
  - Objective 1
  - Objective 2
tags: ["circuit-theory", ...]  # Topic tags
---

# Lesson Title

## Introduction
[Lesson content...]

## Key Takeaways
- Bullet point 1
- Bullet point 2

## Practice
{exercise:fund-ex-01}

---
**Next Lesson:** [Next Title](next-file.md)
```

---

## 📝 Exercise Format

Practice problems are stored as YAML files:

```yaml
id: fund-ex-01
type: calculation                    # calculation | conceptual | design | multi-part
difficulty: easy                     # easy | medium | hard
points: 10
related_lesson: fund-02
question: |
  [Full question text]

hints:
  - "Hint 1"
  - "Hint 2"

solution:
  steps:
    - "Step 1 description"
    - "Step 2 description"
  answer: "66.3"
  unit: "kΩ"
  tolerance: 2.0                    # percentage

explanation: |
  [Why this matters]

related_concepts: ["concept1", "concept2"]
```

---

## 🔧 Using This Course

### For Self-Study

1. Start with `course.json` to see overall structure
2. Follow your chosen learning path (see above)
3. Read lessons in order (prerequisites specified in frontmatter)
4. Complete exercises to reinforce learning
5. Refer to worked examples when stuck
6. Use reference materials (equation sheet, glossary) as needed

### For Interactive App Development

This course is **designed for PyQt application** development:

1. **Parse `course.json`** for navigation structure
2. **Render markdown lessons** with proper equation support (MathJax)
3. **Load exercise YAML** for interactive practice
4. **Track progress** using lesson IDs
5. **Implement custom tags:**
   - `{exercise:ex-id}` → Load and display exercise
   - `{image:filename}` → Display image from assets/
   - `{interactive:type}` → Launch interactive element

### For PDF Generation

Compile to PDF using Pandoc:

```bash
# All lessons
pandoc lessons/**/*.md -o tesla-coil-spark-course.pdf \
  --toc --number-sections --pdf-engine=xelatex

# Single part
pandoc lessons/01-fundamentals/*.md -o part1-fundamentals.pdf \
  --toc --pdf-engine=xelatex
```

---

## 📊 Reference Materials

### Equation Sheet
`reference/equation-sheet.md`

45+ key formulas organized by category:
- Circuit analysis (Y, Z, φ)
- Optimization (R_opt_power, R_opt_phase)
- Thévenin equivalent
- Spark growth (ε, E_threshold, dL/dt)
- Thermal physics
- And more...

### Physical Bounds
`reference/physical-bounds.md`

Validation ranges and typical values:
- Resistance bounds (1 kΩ to 100 MΩ)
- Capacitance values (2 pF/foot rule)
- Field thresholds (0.4-3.0 MV/m)
- Energy per meter (5-100 J/m by mode)
- Phase angles (-55° to -75° typical)
- And more...

### Glossary
`reference/glossary.yaml`

64 technical terms with:
- Full definitions
- Units and typical ranges
- Related concepts
- Related lessons

---

## 🖼️ Images

**Status:** Specifications provided, images not yet created

See `assets/IMAGE-REQUIREMENTS.md` for complete specifications of 45+ needed images:
- Circuit diagrams
- Field visualizations
- Graphs and charts
- FEMM screenshots
- High-speed photography
- Process flowcharts

**Priority:**
- **High priority:** Images 1-6, 9-11, 16-19, 28-30 (core concepts)
- **Medium priority:** Images 7-8, 12-15, 20-27, 31-37 (supporting)
- **Low priority:** Images 38-45 (nice-to-have)

---

## 🎯 Key Concepts

### Circuit Theory
- **C_mut** (mutual capacitance): Coupling between spark and topload
- **C_sh** (shunt capacitance): Spark to ground, ~2 pF/foot
- **Admittance analysis**: Essential for parallel networks
- **Topological phase constraint**: φ_Z,min = -atan(2√[r(1+r)])

### Optimization
- **R_opt_power**: Maximizes power transfer = 1/(ω(C_mut+C_sh))
- **R_opt_phase**: Minimizes phase magnitude
- **Hungry streamer**: Self-optimization toward R_opt_power
- **Thévenin equivalent**: Z_th, V_th extraction for any load analysis

### Spark Physics
- **E_inception**: 2-3 MV/m (initial breakdown)
- **E_propagation**: 0.4-1.0 MV/m (sustained growth)
- **Energy per meter (ε)**: 5-15 J/m (QCW) to 30-100 J/m (burst)
- **Thermal time constant**: τ = d²/(4α)
- **Streamers**: Thin, fast, high-resistance, purple/blue
- **Leaders**: Thick, slower, low-resistance, white/orange

### Advanced Modeling
- **Lumped model**: Single R, C_mut, C_sh (fast, <10 foot sparks)
- **Distributed model**: n segments (slow, accurate, any length)
- **Maxwell capacitance matrix**: Extract from FEMM electrostatics
- **Resistance optimization**: Iterative power maximization

---

## ⚠️ Important Notes

### Frequency Tracking
**Critical concept often overlooked!**

When simulating with different R values, you MUST retune to the loaded pole frequency for each case. Comparing at fixed frequency measures detuning, not inherent matching quality.

See: `lessons/02-optimization/06-frequency-tracking.md`

### C_sh Validation
For distributed models, extracted C_sh may differ from the 2 pF/foot rule by factor 2-3. This is **normal** - the matrix method includes all segment couplings differently. Use FEMM values.

### Sign Conventions
Maxwell capacitance matrices have **negative off-diagonal elements**. When extracting:
- C_mut = |C_12| (take absolute value!)
- C_sh = C_22 - |C_12| (subtract the absolute value)

---

## 🚀 Next Steps

### To Use This Course:

1. **Review** `course.json` to understand structure
2. **Choose** a learning path (beginner/complete/simulation/physics)
3. **Start** with Part 1, Lesson 01
4. **Complete** exercises as you go
5. **Reference** equation sheet and glossary as needed

### To Build Interactive App:

1. **Parse** course.json for navigation
2. **Implement** markdown renderer with MathJax
3. **Load** YAML exercises
4. **Track** user progress by lesson ID
5. **Add** interactive elements for {exercise:}, {interactive:} tags

### To Create Images:

1. **Review** `assets/IMAGE-REQUIREMENTS.md`
2. **Prioritize** high-priority images first
3. **Create** using tools specified (Inkscape, matplotlib, FEMM, etc.)
4. **Place** in appropriate assets/ subdirectories
5. **Update** lesson markdown with actual filenames

---

## 📄 License

Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)

You are free to:
- Share: Copy and redistribute
- Adapt: Remix, transform, and build upon

Under these terms:
- Attribution: Give appropriate credit
- ShareAlike: Distribute under same license

---

## 🙏 Acknowledgments

Based on comprehensive Tesla coil spark modeling research from the community, including:
- Steve Conner's "hungry streamer" principle
- Empirical observations from builders worldwide
- FEMM electromagnetic analysis techniques
- Circuit-theoretical foundations

---

## 📞 Support

For questions or contributions:
- **Repository:** [GitHub link to be added]
- **Issues:** [GitHub issues link]
- **Community:** [Tesla coil community forum]

---

## 📅 Version History

### Version 1.0.0 (2025-10-10)
- Initial release
- 30 lessons across 4 parts
- 18 exercises in YAML format
- 5 comprehensive worked examples
- 3 reference documents
- Complete image specifications
- Course navigation structure

---

**Ready to learn Tesla coil spark physics? Start with Part 1, Lesson 01!**

`lessons/01-fundamentals/01-introduction.md`