Contents:

• NgspiceTclBridge - drive ngspice (shared library) from Tcl
  • What it gives you (at a glance)
  • Building & requirements
  • Documentation
  • Notes
  • Warnings
  • Quick start (synchronous operation)
• Examples
  • Parametric simulation
• Troubleshooting
• ::ngspicetclbridge
  • Commands
    • getCircuit
    • getCircuitTitle
    • getPlotDate
    • getPlotName
    • getScaleInfo
    • new
    • readVecsAsync
    • run
    • SIM
    • SIM abort
    • SIM asyncvector
    • SIM circuit
    • SIM command
    • SIM destroy
    • SIM eventcounts
    • SIM initvectors
    • SIM inputpath
    • SIM isrunning
    • SIM messages
    • SIM plot
    • SIM vectors
    • SIM waitevent
• Notes and internals
  • How instance subcommands are implemented
    • Command creation
    • Subcommand dispatching
    • Thread safety and state transitions
    • Deferred command queue
    • Capture mode
    • Command deletion and cleanup
    • Summary
  • How sync callbacks from Ngspice is implemented
    • Registration of callbacks
    • Callback invocation model
    • Thread safety and queueing behavior
    • Controlled flow of data
    • Background thread lifecycle callbacks
    • Generation and stale-event handling
    • Controlled exit coordination
    • Safety and teardown integration
  • How event queue interaction is implemented
    • Event structure definition
    • Event allocation and queuing
    • Event processing
    • Event deletion and resource balancing
    • Generation handling and safety
    • Synchronization guarantees
  • How thread safety is ensured
  • How data processing is implemented
    • Overview of the data flow
    • Asynchronous access structures
    • Synchronous access structures (event-driven)
    • Internal buffering and memory layout
    • Conversion into Tcl objects
    • Data lifecycle and cleanup
    • Thread safety in data handling
  • How message queue is implemented
    • Overview
    • Message production (ngspice callbacks)
    • Message consumption (Tcl commands)
    • Capture mode (-capture)
    • Clearing and freeing queues
    • Synchronization and safety guarantees
    • Summary
  • How dynamic library loading and portability is implemented
    • Abstracted portability layer
    • Unicode and Tcl path integration
    • Function symbol resolution
    • Safe unloading and crash prevention
    • Platform-specific nuances
    • Summary
• Index