소개 / 수치 검증

수치는 이렇게 검증합니다

EIGENROOM의 모든 수치는 코드로 계산하며, 공개한 수치 대부분은 테스트 코드가 별도로 한 번 더 계산합니다. 이 페이지는 그 검증이 무엇을 다루는지, 언제 실행되는지, 아직 무엇을 다루지 못하는지 밝힙니다.

공개한 답을 다시 계산합니다

강의 51개 모두의 연습 문제는 단위 테스트가 문제의 조건에서 출발해 숫자로 된 답을 다시 계산합니다. 다항식의 근, 라우스 표의 열, 부분분수 전개의 계수, 룽게–쿠타 시뮬레이션, 수치 적분, 행렬 지수함수, 주파수 스윕, 나이퀴스트 선도가 −1을 감싸는 횟수, 리카티 방정식의 해를 테스트 안의 별도 코드로 구합니다. 이어서 페이지가 그 값을 표시한 자릿수에 맞게 반올림해 적었는지 확인합니다.

강의 참고 표의 값도 표를 출력하는 코드와 별개로 같은 방식으로 다시 계산합니다. 라우스 표, 시스템 형별 정상상태 오차, 2차 시스템 사양, 보드 선도의 인자, 진상 보상기의 위상, 지글러–니콜스 규칙, 근궤적 작도 규칙, 라플라스 변환과 z변환 쌍, 애커만 이득, LQR 가중치가 여기에 해당합니다.

계산 강의 8개(라플라스 역변환, 2차 시스템 사양, 근궤적 작도, 보드 선도 작도, 나이퀴스트 안정도 판별법, PID 동조, 상태방정식의 해, z변환)의 풀이 예제와 신호흐름선도, 진상·지상 보상기 설계, 상태공간 설계 강의의 설계 예제는 단계마다 다시 계산하며, 이 강의들이 인용하는 실험실의 수치도 함께 확인합니다. 계산 강의 8개에서는 또한 강의 본문과 핵심 정리, 자주 묻는 질문에 나오는 모든 소수가 영어와 한국어 모두에서 테스트가 다시 계산한 값이거나, 문제의 조건처럼 본문이 정한 입력값이어야 합니다.

이제 나머지 강의도 같은 방식으로 확인합니다. 강의 51개 전체의 본문, 절, 공식 설명, 풀이 예제, 핵심 정리, 자주 묻는 질문에 나오는 수치 600여 개를 추가로 다시 계산하며, 강의가 실험실 결과를 인용한 곳은 실험실 엔진으로 직접 확인합니다. 각 값은 영어와 한국어 모두에 표시한 자릿수대로 적혀 있어야 합니다.

수식, 번역, 링크

  • 수식. 강의의 모든 수식(방정식, 기호 표, 풀이 단계, 연습 문제, 핵심 정리, 참고 표)을 테스트에서 KaTeX 엄격 모드로 렌더링합니다. 구문 오류가 있거나 화면 낭독기용 MathML이 나오지 않으면 테스트가 실패합니다.
  • 두 언어. 모든 강의 단락, 연습 문제, 자주 묻는 질문, 실전 노트에 영어와 한국어가 모두 있어야 하며, 한 강의 페이지에 같은 문단이 두 번 나오면 테스트가 실패합니다.
  • 링크. 강의와 실전 노트에서 실험실로 가는 링크는 실제로 있는 실험을 가리켜야 합니다.

시뮬레이션

  • 결정성. 테스트가 시뮬레이션을 다시 실행해 샘플이 완전히 같은지 확인합니다. 시드를 고정한 센서 잡음이 들어간 실행도 포함합니다. 실험실 엔진은 사인, 코사인, 지수함수, 아크탄젠트를 브라우저 대신 자체 JavaScript 함수로 계산하므로, 공유한 실행은 어느 휴대폰·컴퓨터·브라우저에서도 비트 단위까지 같은 결과를 냅니다. 엔진이 기기에 따라 마지막 비트가 달라지는 함수를 부르면 테스트가 실패합니다.
  • 적분 간격. 적분 간격을 더 줄여 다시 계산해도 실제로 쓰는 간격의 결과와 작은 허용 오차 안에서 일치해야 합니다.
  • 정확한 해와 비교. 저장소의 Python 스크립트 6개가 엔진의 결과를 독립적으로 구한 해와 비교합니다. DC 모터, 질량–스프링–댐퍼, 상태 피드백, RLC, 시스템 형 모델은 행렬 지수함수로, 열 제어기는 입력을 유지할 때의 정확한 해로, 비선형 물탱크와 2자유도 실험대는 SciPy 수치 적분으로, 라우스 실험대는 다항식의 근으로 확인합니다.
  • 결과 고정. DC 모터 엔진 1.5.0에 선택형 지연시간과 우반평면 영점을 추가할 때, 모든 안내 실험과 기존 설정 몇 가지의 결과가 1.4.0과 비트 단위까지 같도록 테스트로 고정했습니다. 그래서 이전에 만든 링크도 똑같이 재생됩니다.
  • 정의 명시. 상승시간, 오버슈트, 정착시간의 정의를 화면에 적고, 테스트가 그 문장대로 정의를 다시 구현해 엔진이 보고하는 값과 비교합니다.
  • 실험 노트. 모터·역진자 실험마다 딸린 이론 노트는 실행 결과를 손 계산으로 예측합니다. 테스트가 손 계산을 다시 하고 실험 설정과 노트에 적은 두 가지 변화로 엔진을 다시 실행해, 나온 수치가 두 언어 모두에 있어야 통과합니다. 노트의 다른 소수는 모두 명시한 입력값이어야 합니다.

계산기

전달함수 계산기는 답이 알려진 사례로 테스트합니다. 표준 2차 시스템의 오버슈트와 피크시간, 여러 이득에서 K/[s(s+1)(s+2)]의 이득여유와 위상여유, 개루프가 불안정한 루프의 Z = N + P, 근궤적의 허수축 교차점과 이탈점, 첫 열에 0이 나오거나 한 행이 모두 0인 라우스 표, 무작위 다항식에서 라우스 표의 부호 변화 수와 수치로 구한 근의 비교가 들어 있습니다. 이산화 계산기는 영차 홀드의 닫힌 형태 결과, 따로 구현한 테일러 급수 행렬 지수, 샘플링 순간의 계단응답, 사전 왜곡 주파수에서 쌍일차 변환이 정확히 맞는지, MATLAB의 극점·영점 정합 결과와 비교하고, 상태공간 계산기는 상태 피드백·관측기 설계 강의의 풀이 예제, C(sI − A)⁻¹B + D의 직접 계산, A − BK와 A − LC의 고유값과 비교합니다. 계산기 페이지의 설명에 인용한 수치도 계산기가 직접 낸 값입니다.

검증이 실행되는 때

  • 변경을 올릴 때마다. main 브랜치에 변경을 올릴 때마다 GitHub Actions가 타입 검사, 모든 단위 테스트, 린트, 블로그 테스트, 배포용 빌드를 실행합니다.
  • 직접 실행. Python 참조 스크립트는 NumPy와 SciPy가 필요해 변경마다 자동으로 돌리지 않고 직접 실행합니다. 브라우저 스크립트(Playwright와 axe)도 마찬가지입니다. 로컬 빌드를 열어 두 언어의 강의, 실험실마다 재생, 공유, 가져오기와 내보내기, 휴대폰 화면, 접근성을 확인합니다.
  • 큰 병합 뒤. 2026년 11월 15일의 병합 뒤에는 빌드한 사이트를 훑어 한국어 페이지에 번역되지 않은 문장이 남았는지 확인했고, 찾은 내용은 변경 기록에 적었습니다.

아직 검증하지 못한 것

  • 모델의 충실도. 테스트를 통과했다는 것은 코드가 밝힌 모델을 정확히 계산한다는 뜻이지, 그 모델이 특정 실제 장치와 같다는 뜻은 아닙니다. 모델마다의 가정은 모델과 계산 방법 페이지에 있습니다.

모델과 계산 방법 →

틀린 수치를 찾았다면

GitHub의 공개 피드백 저장소에 제보해 주세요. 공개된 내용을 고친 경우 변경 기록에 날짜와 함께 ‘내용 정정’으로 남깁니다.