Repository navigation
feat: scientific validation and constraint-aware control synthesis - #1
Merged
Merged
Conversation
…hmarks and changelog
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Contexto
Após a migração do motor matemático do ControLAB de Python para Rust nativo, foi conduzida uma validação científica, numérica, funcional, visual e de desempenho em 11 etapas tomando como base as listas acadêmicas da disciplina de Sistemas de Controle II da UFERSA (19 casos de Lugar Geométrico das Raízes e 9 questões de Projeto de Controladores), comparadas com derivações analíticas fechadas, execuções independentes no MATLAB R2022b (Control System Toolbox) e referências congeladas do motor Python legado (
be79347).Resumo das Alterações
1. Motor de Verificação e Síntese por Restrições (
crates/control-engine)crates/control-engine/src/controller_synthesis.rs:verify_controller) sobre o polinômio característico não reduzido (estabilidade externa e interna, rejeitando cancelamentos no SPD/$j\omega$).DampingSpec::{Equal, AtLeast, DidacticEstimate},NaturalFreqSpec::{Equal, AtLeast, OptionalEstimate},SettlingSpec::{AtMost, Equal}com tolerância padrão uniforme (±2%, piso0,02 s),max_overshoot_pct, erro atuante no somador vs rastreamento da saída em realimentação não unitária, identificação do polo/par de referência e razão exata de resíduos modais de Heaviside.temporal_refinedeauto_simplestpercorrendoP -> PI -> PD -> Lead -> PID), com parametrização canônica[Kp, Ki, Kd]para PID (zeros reais ou complexos no SPE) e classificação explícitaFeasibilityClass::{Feasible, ProvenInfeasible, NotFoundWithinSearchBounds}(incluindo provas algébricas diferenciadas paralgr_classic) e da paridade legada (152/152).crates/control-engine/src/controllers.rs: corrigidas regressões de formatação e paridade do commitc32b2d4, restaurando152/152casos emxtask parity.2. Interface Nativa (
native)Modo de Síntese,Restrição de tseRestrição de ξemnative/modules.json.native/src/results.rsexibindo banner (CONFORME,CONFORME COM ALERTAS,NÃO CONFORME), motivos de não conformidade,Polo(s) de referência (ξ/ωn)com razão de resíduos, tabelaSolicitado × Teórico × Medido × Diferençacom marcações[OBRIGATÓRIA]vs[ESTIMATIVA OPCIONAL]e advertências técnicas.native/src/ui_tests.rs.3. Suítes Permanentes de Regressão Acadêmica (100% Rust, sem Python/MATLAB em runtime)
crates/control-engine/tests/academic_lgr_validation.rs(19 casos LGR + Routh + resíduos decrates/control-engine/tests/academic_controllers_validation.rs(9 questões de controladores + perturbação Q8 + critério definitivo decrates/control-engine/tests/academic_requirements_compliance.rs(não conformidade clássica, sistemas instáveis/SPD, referência independente Q8-1 - 0,2/scom perturbaçõesProvenInfeasibleeNotFoundWithinSearchBounds)crates/blocklab-core/tests/academic_diagrams.rs(redução exata via Mason de todos os diagramas das duas listas + Q8 referência1.44/(s+1.44))crates/mscript/tests/academic_validation.rs(reprodução em scripts.mno Studio)4. Documentação Científica, CI e Curadoria
docs/validation/(README.md,methodology.md,academic-validation.md,synthesis-comparison.md,benchmarks.md,final-acceptance.md,validation-matrix.csvcom 42 configurações e 4 capturas selecionadas emdocs/validation/assets/).README.md,CHANGELOG.md(Unreleased),.gitignore(preservando artefatos/logs locais emartifacts/fora do controle de versão) e.github/workflows/build-all.yml(executandocargo run --locked --release -p xtask -- parityna CI Linux).Resultados de Validação e Benchmarks
cargo test --workspace):411 passed, 0 failed, 3 ignored(testes opt-in MATLAB).cargo test --release -p mscript -- --ignored):3/3 passed(erro relativo escalado máximo7,883e-15).cargo run --release -p xtask -- parity):152/152 matched(complete_parity: true, 260 ativos visuais).cargo run --release -p xtask -- check-sources): aprovado (0 dependências Python/JS/TS/HTML/CSS).--releasevs Python legadobe79347, processo persistente JSON-lines, 3 warmups, 5–25 iterações, Linux Intel Core i5-13420H): aceleração mediana de 3,76× a 15,50× (9,01× em síntese de controladores, 12,89× em LGR, 15,50× na suíte completa de 19 LGRs) e redução de RSS de até 11,47× (detalhes e escopo emdocs/validation/benchmarks.md).Evidências Visuais
NÃO CONFORME,CONFORME COM ALERTAS,Limitações Conhecidas
docs/validation/synthesis-comparison.md).Checklist de Qualidade
cargo fmt --all -- --checkcargo clippy --workspace --all-targets -- -D warningscargo test --workspace(411 passed, 0 failed)cargo build --workspace --releasecargo run --release -p xtask -- parity(152/152 matched)cargo run --release -p xtask -- check-sourcescargo test --release -p mscript -- --ignored(3/3 passed contra MATLAB R2022b)git diff --check