WebGPU · 27 통합 입자 실험 인수
단계: 복구·측정·통합 프로젝트 · 편집 가능한 예제 · 저장 ID: webgpu-step-27
목표와 학습 후 역량
- 전체 프로젝트 계약을 문서화한다.
- 실패와 재시작을 포함해 인수한다.
선수 지식
26단위 결과물과 기록을 이어 사용합니다. 통합 입자 실험 인수 실험에 앞서 이전 입력과 기준 출력을 보관합니다.
핵심 개념과 설명
구성 분리
초기 데이터·커널·렌더·readback·UI를 분리하면 오류 위치가 명확해집니다. 모듈 간 계약에는 buffer 크기와 수명이 포함됩니다.
인수 증거
보이는 애니메이션만으로 계산의 정확성을 증명할 수 없습니다. 실패 복구와 CPU 비교 결과를 함께 남깁니다.
실습 준비
예제 화면의 실행 범위 안내를 먼저 확인하세요. 다음은 과제를 별도 프로젝트로 확장할 때의 준비 환경입니다. 별도 localhost 또는 HTTPS 프로젝트에서 직접 구현하는 문서 안내 실습입니다. secure context, navigator.gpu, adapter 요청 결과를 확인하고 미지원 안내를 제공합니다. device.lost 처리와 자원 해제를 유지합니다.
연결된 예제는 출발점입니다. 아래 과제 전체가 완성된 코드는 아니며, 예제의 지원 범위를 넘는 작업은 별도 프로젝트에서 수행하세요.
실습 과제
- README.md에 모듈별 입력·출력·자원 소유권을 표로 적으세요.
- 지원 실패·device loss·resize·N=0·N=1003 다섯 시나리오를 실행하세요.
- 현재 설정 JSON과 CPU 비교 결과를 내보내고 새 세션에서 복원하세요.
관찰할 변수
| 변수 | 기준 조건 | 바꿀 조건 | 예상할 변화·검증 가설 |
|---|---|---|---|
| 시작 상태 | 기존 세션 | 새 세션과 저장 설정 | 숨은 GPU 상태 없이 같은 초기 데이터가 재현될 것으로 예상합니다. |
표의 예상은 측정 결과가 아닙니다. 한 번에 한 조건만 바꾸고 실제 결과가 다르면 원인을 기록하세요.
완료 조건
- 다섯 시나리오에 실제 관찰 또는 미실행 사유가 있다.
- 재시작 후 seed와 초기 위치가 일치한다.
자가 점검
- 애니메이션이 정상이어도 어떤 계산 오류가 숨을 수 있나요?
- 빈 입력에서 만들지 않아도 되는 GPU 작업은 무엇인가요?
공식 참고
연결된 예제와 실행 범위
실제 WebGPU/WGSL 실행. HTTPS/localhost와 지원 adapter 필요; 미지원 환경에는 사유를 표시하며 CPU 결과를 GPU로 대체하지 않습니다.
원본 코드·기록은 자동으로 덮어쓰지 않습니다. 기존 예제를 초기화할 때도 필기는 유지됩니다.
다음 학습
이전: Workgroup 크기 실험 · 다음: Compute와 Readback