Skip to content

README.md

Latest commit

 

History

History
64 lines (49 loc) · 4.13 KB

README.md

File metadata and controls

64 lines (49 loc) · 4.13 KB
Raw

SpiceSharpParser Circuit Cookbook

This cookbook contains complete circuits that solve recognizable design problems using the existing SpiceSharpParser feature set. Every cookbook entry includes a runnable netlist, named measurements, plot requests, a schematic, documented design calculations, and automated regression coverage.

Cookbook Circuits

Circuit Track Analyses Difficulty Main lesson
PWM digital-to-analog converter Pure SPICE TRAN Simple Duty-cycle averaging, ripple attenuation, and settling
RC sensor filter and input protector Pure SPICE AC, TRAN Simple Noise filtering, bandwidth, rail clamps, and fault current
BJT relay driver with flyback diode Pure SPICE TRAN Simple Inductive-load switching, saturation, flyback clamping, and release decay
Loaded voltage divider and emitter-follower buffer Pure SPICE OP, TRAN Simple Source loading, Thevenin resistance, transistor buffering, and output impedance
Diode peak detector and AM envelope follower Pure SPICE TRAN Simple Diode-drop error, RC attack/release, carrier ripple, and envelope recovery
Two-transistor astable LED flasher Pure SPICE TRAN Simple Cross-coupled feedback, RC timing, transistor switching, and free-running oscillation
Rectifier power supply Pure SPICE TRAN Medium Rectification, reservoir ripple, Zener regulation, and a load step
BJT audio preamplifier Pure SPICE OP, AC, TRAN, FOUR Medium Biasing, gain, bandwidth, coupling, loading, and harmonic distortion
Active anti-alias filter and ADC buffer Pure SPICE AC, TRAN Medium Buffered filter poles, stopband attenuation, settling, and ADC loading
Ideal-diode redundant power input CustomComponents TRAN Medium Supply OR-ing, automatic failover, handback, and reverse-current blocking
Simple phase-locked loop CustomComponents TRAN Difficult Phase detection, loop filtering, and voltage-controlled oscillation
Transmission-line termination Pure SPICE TRAN Difficult Propagation delay, reflections, ringing, and impedance matching

Other Runnable Examples

The following directories remain valuable device demonstrations and implementation-validation fixtures:

Cookbook circuits are organized by application. Milestone and A-device examples are organized by the library feature they validate.

Common Contract

A cookbook circuit must:

  • use existing public APIs and supported syntax;
  • compile without errors and complete every simulation;
  • expose important behavior through .MEAS statements;
  • request the waveforms discussed in its guide with .SAVE and .PLOT;
  • document its calculations, assumptions, experiments, and model boundary;
  • pass the data-driven CircuitCookbookTests regression suite.

Run the fast documentation, layout, and generated-asset audit from the repository root:

.\tools\cookbook-schematic\.venv\Scripts\cookbook-report

Then run the simulation regression suite:

dotnet test src/SpiceSharpParser.Tests/SpiceSharpParser.Tests.csproj `
  --filter 'FullyQualifiedName~CircuitCookbookTests'

The pure-SPICE track needs only SpiceSharp-Parser. The custom-components track also requires SpiceSharpParser.CustomComponents and explicitly enables its reader mappings.