Skip to content

Matriz de Paridade: PulsimGui -> Backend v1

Esta página documenta a paridade entre componentes do catálogo do PulsimGui e o backend unificado v1 usado por YAML + Python.

  • Snapshot de inventário: 2026-05-11
  • Escopo desta matriz: 40 componentes (34 originais + 6 da Fase 28 trifásica)
  • Resultado atual: 40/40 cobertos no backend (modelo físico, surrogate ou virtual)
  • PulsimGui ≥ 0.8.0 expõe os blocos da Fase 28 (Clarke / Park / PLL / SVM) no palette sob a categoria Three-Phase / Vector Control.

Status por componente

Componente GUI Tipo YAML canônico Representação backend Status
BJT_NPN bjt_npn surrogate sobre mosfet supported
BJT_PNP bjt_pnp surrogate sobre mosfet supported
THYRISTOR thyristor switch + controlador de latch/evento supported
TRIAC triac switch + controlador bidirecional de latch/evento supported
SWITCH switch dispositivo elétrico direto supported
FUSE fuse switch + evento de trip por I²t supported
CIRCUIT_BREAKER circuit_breaker switch + evento de overcurrent/delay supported
RELAY relay par switch (NO/NC) + evento de bobina supported
OP_AMP op_amp bloco virtual de controle supported
COMPARATOR comparator bloco virtual de controle supported
PI_CONTROLLER pi_controller bloco virtual de controle supported
PID_CONTROLLER pid_controller bloco virtual de controle supported
MATH_BLOCK math_block bloco virtual de controle supported
PWM_GENERATOR pwm_generator bloco virtual de controle supported
INTEGRATOR integrator bloco virtual de controle supported
DIFFERENTIATOR differentiator bloco virtual de controle supported
LIMITER limiter bloco virtual de controle supported
RATE_LIMITER rate_limiter bloco virtual de controle supported
HYSTERESIS hysteresis bloco virtual de controle supported
LOOKUP_TABLE lookup_table bloco virtual de controle supported
TRANSFER_FUNCTION transfer_function bloco virtual de controle supported
DELAY_BLOCK delay_block bloco virtual de controle supported
SAMPLE_HOLD sample_hold bloco virtual de controle supported
STATE_MACHINE state_machine bloco virtual de controle supported
SATURABLE_INDUCTOR saturable_inductor inductor + controlador virtual não linear supported
COUPLED_INDUCTOR coupled_inductor 2x inductor + controlador virtual de acoplamento supported
SNUBBER_RC snubber_rc macro expandida para ramo R-C supported
VOLTAGE_PROBE voltage_probe instrumento virtual (sem stamp MNA) supported
CURRENT_PROBE current_probe instrumento virtual (sem stamp MNA) supported
POWER_PROBE power_probe instrumento virtual (sem stamp MNA) supported
ELECTRICAL_SCOPE electrical_scope instrumento virtual/canais supported
THERMAL_SCOPE thermal_scope instrumento virtual/canais térmicos supported
SIGNAL_MUX signal_mux roteamento virtual supported
SIGNAL_DEMUX signal_demux roteamento virtual supported
CLARKE_TRANSFORM clarke_transform bloco virtual de controle (Fase 28) supported
INVERSE_CLARKE_TRANSFORM inverse_clarke_transform bloco virtual de controle (Fase 28) supported
PARK_TRANSFORM park_transform bloco virtual de controle (Fase 28) supported
INVERSE_PARK_TRANSFORM inverse_park_transform bloco virtual de controle (Fase 28) supported
PLL pll bloco virtual de controle (Fase 28) supported
SVM svm bloco virtual de controle, SVPWM (Fase 28) supported

Notas de execução

  • Fase do scheduler mixed-domain por passo aceito: electrical -> control -> events -> instrumentation.
  • Blocos virtuais não alteram topologia MNA.
  • Estados de evento (trip/latch/contato) são determinísticos.

Diagnósticos e compatibilidade

  • Use YamlParserOptions(strict=True) para validações de pinagem/parâmetros.
  • Todos os tipos da matriz acima não devem gerar Unsupported component type.
  • Aliases de GUI são normalizados para nomes canônicos no parser.

Gate de regressão recomendado (CI)

PYTHONPATH=build/python pytest -q python/tests/test_gui_component_parity.py
PYTHONPATH=build/python pytest -q python/tests/test_runtime_bindings.py
./build-test/core/pulsim_simulation_tests "[v1][yaml][gui-parity]"