Skip to documentation content
On this page
  1. Reference contract
  2. Authoritative source

Electrical Circuit

Defines optimization applicability and derivative ownership for Electrical Circuit.

Reference contract

FieldValueDescription
kindElectrical Circuit
namespacecir
statuscertified
visibletrue
optimizationContract{"baseStudies":["stationary","transient"],"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contributionBindings":[{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Resistor","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Capacitor","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Inductor","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Voltage Source","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Current Source","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:VCCS","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:VCVS","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:CCCS","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:CCVS","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Diode","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Switch","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Ideal Op Amp","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Op Amp Macro Model","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Differential Port","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:SPICE Netlist","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:External SPICE Component","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Ground","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Junction","runtimeOwner":"ElectricalCircuitAdapter"},{"certificationFixture":"tests/python_backend/test_differentiable_physics_contract.py::test_builtin_physics_optimization_contract_gate","contribution":"global-feature:Net Label","runtimeOwner":"ElectricalCircuitAdapter"}],"functionalReductions":["value"],"geometricModes":{"coordinate":{"applicability":"inapplicable","reason":"This interface has no spatial coordinate field."},"materialTopology":{"applicability":"inapplicable","reason":"This interface has no spatial material domain."}},"historyFields":["x"],"objectiveRules":[{"entityDimensions":["global"],"modes":["transient"],"operators":["value"],"supportsSelection":false,"symbols":["cir.x"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["transient","stationary"],"operators":["value"],"supportsSelection":false,"symbols":["*"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.V(node)"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.I(element)"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.P(element)"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.P(balance)"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.V(node).real"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.V(node).imag"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.V(node).abs"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.V(node).phase"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.I(element).real"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.I(element).imag"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.I(element).abs"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.I(element).phase"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(element).real"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(element).imag"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(element).abs"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(element).phase"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.Q(element)"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(balance).real"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(balance).imag"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(balance).abs"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.S(balance).phase"],"valueKind":"scalar-global"},{"entityDimensions":["global"],"modes":["stationary"],"operators":["value"],"supportsSelection":false,"symbols":["cir.Q(balance)"],"valueKind":"scalar-global"}],"objectiveSymbols":["cir.x","*","cir.V(node)","cir.I(element)","cir.P(element)","cir.P(balance)","cir.V(node).real","cir.V(node).imag","cir.V(node).abs","cir.V(node).phase","cir.I(element).real","cir.I(element).imag","cir.I(element).abs","cir.I(element).phase","cir.S(element).real","cir.S(element).imag","cir.S(element).abs","cir.S(element).phase","cir.Q(element)","cir.S(balance).real","cir.S(balance).imag","cir.S(balance).abs","cir.S(balance).phase","cir.Q(balance)"],"requiredDerivativeChannels":["parameter","input"],"role":"nonspatial-analysis","runtimeProvider":"ElectricalCircuitAdapter","schemaVersion":"1.0.0","stateFields":["x"]}
governingEquations[{"description":"KCL rows are augmented with branch-current unknowns for voltage sources, inductors, controlled sources, ports, and ideal op-amp constraints.","differentiability":"exact-ad","editor":null,"entityDimension":"global","latex":"\\mathbf C(\\mathbf p)\\dot{\\mathbf x}+\\mathbf g(\\mathbf x,\\mathbf p,\\mathbf u,t)=\\mathbf 0","mathml":"<math display=\"block\"><mrow><mi>C</mi><mover><mi>x</mi><mo>.</mo></mover><mo>+</mo><mi>g</mi><mo>(</mo><mi>x</mi><mo>,</mo><mi>p</mi><mo>,</mo><mi>u</mi><mo>,</mo><mi>t</mi><mo>)</mo><mo>=</mo><mn>0</mn></mrow></math>","name":"Modified nodal analysis","readOnly":true,"section":"governing-equation"},{"description":"Finite open-loop gain, unity-gain bandwidth, and output resistance are assembled as a dynamic MNA branch.","differentiability":"exact-ad","editor":null,"entityDimension":"global","latex":"\\tau\\dot v_o+v_o-A_0(v_+-v_-)-R_o i_o=0,\\quad\\tau=\\frac{A_0}{2\\pi f_u}","mathml":"<math display=\"block\"><mrow><mi>tau</mi><mover><msub><mi>v</mi><mi>o</mi></msub><mo>.</mo></mover><mo>+</mo><msub><mi>v</mi><mi>o</mi></msub><mo>-</mo><msub><mi>A</mi><mn>0</mn></msub><mo>(</mo><msub><mi>v</mi><mo>+</mo></msub><mo>-</mo><msub><mi>v</mi><mo>-</mo></msub><mo>)</mo><mo>-</mo><msub><mi>R</mi><mi>o</mi></msub><msub><mi>i</mi><mi>o</mi></msub><mo>=</mo><mn>0</mn></mrow></math>","name":"Single-pole op-amp macro model","readOnly":true,"section":"governing-equation"},{"description":"Diodes and smooth switches require an explicit complete MNA operating point. Their incremental conductance and switch control transconductance are stamped exactly.","differentiability":"exact-ad","editor":null,"entityDimension":"global","latex":"\\left(\\frac{\\partial\\mathbf g}{\\partial\\mathbf x}\\bigg|_{\\mathbf x_0}+i\\omega\\mathbf C\\right)\\widehat{\\mathbf x}=-\\frac{\\partial\\mathbf g}{\\partial\\mathbf u}\\bigg|_{\\mathbf x_0}\\widehat{\\mathbf u}","mathml":"<math display=\"block\"><mrow><mo>(</mo><msub><mi>g</mi><mi>x</mi></msub><mo>(</mo><msub><mi>x</mi><mn>0</mn></msub><mo>)</mo><mo>+</mo><mi>i</mi><mi>omega</mi><mi>C</mi><mo>)</mo><mover><mi>x</mi><mo>^</mo></mover><mo>=</mo><mo>-</mo><msub><mi>g</mi><mi>u</mi></msub><mo>(</mo><msub><mi>x</mi><mn>0</mn></msub><mo>)</mo><mover><mi>u</mi><mo>^</mo></mover></mrow></math>","name":"Nonlinear small-signal linearization","readOnly":true,"section":"governing-equation"}]

The runtime provider, evidence fixture, derivative channels, geometric modes, objective symbols, reductions, contribution bindings, and governing equations are generated from the physics catalog.

Authoritative source

Catalog
telion_backend.v2.catalog.PhysicsCatalog
Identity
PhysicsDeclaration/cir/optimizationContract
Path
src/telion_backend/v2/physics/specs.py
Symbol
DifferentiablePhysicsContract