수식 파이프라인 점검

이 페이지는 이후 모든 페이지가 의존하는 검증 체인을 실제로 거쳐 봅니다.

1. packages/pe-core/equations/equations.yaml에 수식, 가정, 인용, 손으로 확인한 테스트 값이 들어 있습니다.
2. python scripts/gen_equations.py가 sympy로 이를 파싱하여 LaTeX와 공유 테스트 벡터를 생성하며, 테스트 값이 수식과 다르면 실패합니다.
3. TypeScript 엔진은 이 벡터로 테스트하며(상대 오차 1e-9), 생성된 모든 수식은 KaTeX 엄격 모드(strict mode)로 렌더링합니다.
4. 문서는 <Eq id="…" />로 결과를 삽입합니다. LaTeX를 직접 입력하는 일은 없습니다.

$$M = D$$

$M$

변환비(conversion ratio)

$D$

듀티비(duty ratio)

벅(buck) 변환비, CCM✓ 테스트 8개로 검증됨

가정, 표기 규약, 출처

가정

• 이상적(무손실) 스위치와 수동 소자
• 연속 전도 모드(CCM)
• 주기적 정상상태
• 소리플 근사(small-ripple approximation)

표기 규약

$M = V/V_g$

출처

Erickson & Maksimović 2020, Ch. 2 (Principles of Steady-State Converter Analysis)

유도

sympy 단계별 유도

수식 id

buck.ccm.M · equations.yaml 항목

수식 아래의 펼침 메뉴에서 가정과 출처를 확인할 수 있으며, 배지는 패리티 테스트로 연결됩니다. 수식 자체의 설명은 전압-초 평형 페이지에 있습니다.

브라우저에서 동작하는 같은 엔진

아래 차트는 CCM에서 이상적인 벅과 부스트 변환비(conversion ratio)의 TypeScript 평가 함수(evaluator)를 브라우저에서 호출해 Plotly로 그리는 React 아일랜드입니다. 수식 탐색기는 카탈로그의 모든 수식에 대해 같은 일을 합니다.