마취과약물 PK/PD 시뮬레이터 — 일반 용법으로 투여 시 예측 농도 변화 시각화 (Propofol, Remifentanil, Remimazolam) v3.4

patch note 2026.07.29

ver 3.4

# TIVA PK Simulator v2.1 → v3.4 통합 패치노트 (요약본)

작성일: 2026-07-29 · 현재 사용본: **`TIVA PK Simulator v3.4.html`**
상세 근거는 각 버전별 개별 패치노트 참조.

| 버전 | 한줄 요약 |
|---|---|
| v2.1 | 원본 (무수정 보존) |
| v2.2 | Cₑ 적분을 Euler → 지수적분+세분적분으로 교체 (오차 최대 340% → 표시오차 이하) |
| v2.3 | 볼러스 = 0 입력 시 NaN 나던 버그 수정 |
| v3.0 | Rate Solver 최초 추가 — **결함으로 즉시 폐기** |
| v3.1 | Rate Solver 재설계 (로딩용량 정식화) + 전용 페이지 신설 |
| v3.2 | Rate Solver에 제제 농도(1%/2% 등) 선택 추가 |
| v3.3 | Rate Solver에 6시간 단계적 감량 스케줄 추가 |
| v3.4 | Rate Solver 페이지 스크롤 안 되던 CSS 버그 수정 |

---

## v2.2 — Cₑ 적분 방식 교체

**증상**: 기존 패치노트가 주장한 오차 범위(초기 <16%)가 실측과 달랐음. 시간범위 6~12시간 뷰에서 최대 **+340%**까지 벌어짐 — Forward Euler 적분이 큰 Δt(최대 0.5분)에서 무너진 것.

**수정**: 1차 Euler → **지수적분(exponential integrator) + 내부 세분적분**. 볼러스처럼 짧은 구간도 정확히 처리.

**검증**: 6개 시간범위 × 3약물 × 여러 모드 전수 스윕. 수정 후 오차가 **표시 반올림 수준 이하**로 수렴.

---

## v2.3 — 볼러스 0 NaN 버그

**증상**: 볼러스 용량을 0으로 두면 `0/0` 나눗셈으로 Cₑ 전체가 NaN.

**수정**: 볼러스 0일 때 분기 처리. 검증 완료.

---

## v3.0 — Rate Solver 최초 추가 (폐기됨)

목표 농도 → 필요 주입속도 역산 기능을 처음 넣었으나, **로딩용량 계산 로직에 결함**이 있어 임상적으로 위험한(과다) 용량을 제시할 수 있는 것으로 확인됨. **v3.0은 사용 금지, v3.1에서 전면 재설계.**

---

## v3.1 — Rate Solver 재설계

v3.0의 결함을 근본 수정. **로딩용량 정식화**로 목표 도달시각을 반영해 초기 과다/과소 투여를 방지. Rate Solver를 사이드바가 아닌 **전용 페이지**로 분리.

---

## v3.2 — 제제 농도 선택

Propofol 1%/2%, Remifentanil/Remimazolam 등 실제 앰플 농도를 선택하면 그에 맞춰 mL/hr 단위 속도를 재계산.

---

## v3.3 — 6시간 감량 스케줄

목표 농도를 장시간 유지하기 위한 **단계적 감량 스케줄**(0~6시간, 여러 구간) 계산 기능 추가. 재분포에 따른 과다투여를 막기 위해 시간에 따라 속도를 낮추는 표를 제시.

---

## v3.4 — 스크롤 CSS 버그 수정

**증상**: Rate Solver 페이지 내용이 길어지며 스크롤이 막힘.

**원인**: 이 앱은 탭마다 내부 스크롤 컨테이너를 갖는 구조인데, Solver 페이지엔 스크롤 컨테이너가 지정 안 돼 있었음(`flex-shrink` 관련 CSS 누락).

**수정**: `#panelSolver`에 `overflow-y:auto` + `flex-shrink:0` 부여. **JS는 한 글자도 변경 없음, CSS 전용 수정.**

---

## 공통 사항

- 모든 버전에서 원본 v2.1은 **byte-identical로 보존**, 각 버전은 새 파일로 저장.
- PK 엔진(`propSimulate`/`remiSimulate`/`remaSimulate`) 자체는 v2.2 이후 로직 변경 없음 — 이후 버전 변경은 전부 Rate Solver·UI 레이어.

---

 

patch note 2026.04.23
ver 2.1

design change
patient covariates bug fix -

---

Documented at 2026.3.24

Ver 1.0 release

Ver 1.1 - 2026.3.26 release

Propofol - Schnider, Modified Marsh model

Remifentanil - Minto model

Remimazolam - Eleveld, Zhou model

Patient covariates는 직접 입력이 되지 않아 슬라이드 작동으로 해야 합니다.

3. General Disclaimer

본 시뮬레이터는 교육 및 임상 참고 목적으로만 제공됩니다.

• 모델 예측값은 모집단 평균 약동학을 반영하며 개인 간 변이(IIV), 약물 상호작용, 단백 결합 변화, 비정상적 생리 상태를 반영하지 않습니다.
• 추정 농도는 직접적인 임상 모니터링(BIS, 혈역학, 임상 징후)을 대체하지 않습니다.
• 개발자는 본 도구를 기반으로 한 임상 결정에 대해 어떠한 법적·윤리적 책임도 지지 않습니다.