입력·코드·데이터셋·workflow·환경·후처리를 다시 실행 가능한 연구 객체로 남기기
논문에 PBE, 500 eV, 5×5×5라고 적혀 있어도 구조 파일·PAW 버전·smearing·U·자성 초기값과 후처리가 없으면 같은 결과를 재현하기 어렵습니다.
몇 달 뒤의 나와 다른 연구자가 계산을 같은 의미로 다시 실행하려면 무엇을 남겨야 할까요?
이번 장의 답구조와 생성 과정, 모든 물리·수치 설정, 코드·데이터셋 버전, workflow와 후처리, 수렴 근거와 실패 기록을 함께 보존합니다. 원시 출력은 immutable하게 두고 파생 데이터의 provenance를 연결합니다.
01논문 방법란보다 넓은 최소 기록
- 초기·최종 구조와 원자 순서, symmetry, charge, spin
- 코드명·정확한 버전·컴파일 옵션
- XC·vdW·U·SOC와 모든 관련 매개변수
- pseudopotential/PAW 파일명·버전·checksum
- cutoff·FFT·k-grid·smearing·SCF·relax criteria
- 후처리 코드·단위·reference와 plotting script
구조를 데이터베이스에서 받았다면 ID와 retrieval date, 변환·초격자·결함 생성 script를 남깁니다. 손으로 원자를 옮긴 경우에도 작업 이유와 좌표 변화를 기록합니다.
02자동화하되 검사를 자동 생략하지 않기
workflow는 input generation, job submission, restart, parsing과 convergence matrix를 코드화해 사람의 복사 오류를 줄입니다. 각 단계에 원자 충돌·전하·SCF·힘·대칭·에너지 이상치를 검사하는 validation gate를 둡니다.
원시 출력은 덮어쓰지 않고 content hash와 함께 보존하며, 파생 표와 그림이 어떤 run ID와 script version에서 나왔는지 연결합니다. 실패 계산도 삭제하지 않고 원인·변경한 설정을 기록하면 selection bias와 반복 시행착오를 줄입니다.
03FAIR한 계산 자료와 재실행
Findable·Accessible·Interoperable·Reusable 원칙에 맞춰 사람과 기계가 읽는 metadata, 공개 가능한 입력·구조·workflow, 라이선스와 인용 정보를 제공합니다. 대용량 wavefunction보다 재생성 가능한 필수 artifact를 우선합니다.
- 깨끗한 환경에서 대표 계산을 입력부터 재실행
- 원문 표·그림을 원시 출력에서 자동 재생성
- 단위·부호·원자/셀 정규화 수동 교차검사
- 외부 collaborator가 README만으로 한 결과를 재현
04이 글의 용어 사전
본문을 읽다가 “그래서 이 말이 정확히 뭐지?”라는 질문이 생기면 여기에서 다시 확인할 수 있습니다.
- 재현성reproducibility
- 같은 자료와 방법을 사용해 동일한 계산 결과와 분석을 다시 얻을 수 있는 성질입니다.
- provenance
- 데이터가 어떤 원본·변환·계산·후처리 과정을 거쳐 만들어졌는지의 이력입니다.
- checksum
- 파일 내용을 요약한 hash 값으로 pseudopotential 등 정확한 파일 identity를 확인합니다.
- workflow
- 입력 생성부터 실행·검사·후처리까지의 연결된 자동 또는 반자동 절차입니다.
- immutable data
- 생성 뒤 덮어쓰지 않고 새 버전으로만 추가해 원시 이력을 보존하는 데이터입니다.
- FAIR
- 연구자료를 찾을 수 있고 접근·상호운용·재사용 가능하게 만드는 원칙입니다.
05참고자료와 더 읽을거리
- Sholl & Steckel, Density Functional Theory: A Practical Introduction — 평면파 DFT의 이론·수치 설정·재료 응용·AIMD와 정확도를 잇는 이 과목의 중심 교재입니다.
- Blöchl, Projector augmented-wave method (1994) — 평면파 효율성과 핵 주변의 전전자 정보를 잇는 PAW 방법의 원 논문입니다.
- Perdew, Burke & Ernzerhof, Generalized Gradient Approximation Made Simple (1996) — 재료 계산에서 널리 쓰이는 PBE-GGA 교환-상관 범함수의 원 논문입니다.