연구 방법 · 분석 패키지 인계
연구 분석 재현 패키지는 어떻게 인계할까? README부터 재실행 검증까지
인계는 ZIP 파일만 건네는 일이 아닙니다. 권한 있는 입력부터 지정 결과까지 확인 가능한 경로입니다. 버전·순서·환경·판정 기준을 적고 별도 디렉터리에서 재실행하여 차이를 기록합니다.
사용 권한이 있는 공개 또는 합성 연구 자료를 대상으로, 협력자가 어디서 시작하고 어떻게 결과를 대조할지 설명합니다. 투고 전 점검은 원고의 일관성을 다루며, 이 글은 동일 자료와 코드로 결과를 다시 생성할 수 있는지를 다룹니다.
The Turing Way의 계산 재현 정의, 즉 같은 데이터와 분석 단계로 결과를 다시 만드는 의미를 사용합니다. 분야마다 용어가 다릅니다. 새 데이터 검증, 다른 방법의 강건성 평가, 일반화 가능성은 한 번의 재실행으로 대신할 수 없습니다.
최소 디렉터리에도 파일별 역할이 필요하다
아래 이름은 교육용 구성 제안이지 필수 소프트웨어나 RigorMed 내보내기 형식이 아닙니다. 실제 프로젝트에 맞춰 입력 취득과 출력 생성 단계를 적습니다.
| 위치 예시 | 기록할 사항 | 수신자의 확인 |
|---|---|---|
| README | 범위, 자료 권한, 진입점, 순서, 기대 출력, 중단 조건, 연락 역할 | 구두 설명 없이 시작점과 한계를 파악 |
| inputs/ 및 data-dictionary | 출처 버전 또는 파일ID, 상대 경로, 단위, 코드, 결측 정의; 재배포 불가 시 합법적 취득 방법 | 취득 가능한 입력이 분석 버전과 일치 |
| scripts/ 및 analysis-plan | 정제·분석·표와 그림 생성 순서, 매개변수, 적격 기준 | 주요 결과마다 생성 단계가 있고 수동 복사가 아님 |
| environment | 실제 OS·언어·패키지 버전과 설치 설명; 필요 시 시드·스레드·하드웨어 제약 | 최신 버전이라는 말 대신 명시된 환경에서 실행 가능 |
| expected/ 및 output-map | 기대 파일, 표·그림 연결, 비교 필드, 사전 허용 오차 | 파일 존재나 반올림 후 유사함이 아닌 내용 일치 |
| rerun-record | 실제 날짜, 환경, 단계, 종료 상태, 차이, 미완료 항목 | 미실행·실패·부분 통과 및 확인 범위를 구분 |
비밀키, 토큰, 개인 절대 경로와 공유 불가 행 단위 자료를 제외합니다. 코드 라이선스, 데이터 이용 조건, 접근 제한을 따로 적습니다. 다운로드 가능하다고 재배포가 허용되는 것은 아닙니다.
목록을 만들고 이전 결과에 기대지 않고 재실행하기
재현 대상을 고정
원고·분석 버전, 주요 표·그림, 계획을 지정하고 탐색 출력을 공식 결과와 섞지 않습니다. 자료 누락이나 권한 불명은 공백으로 남기고 논문에서 원자료를 역산하지 않습니다.
입력·단계·출력 연결
표·그림별 입력 위치, 생성 스크립트, 매개변수, 출력 경로를 적습니다. 상대 경로와 선후 의존성을 명시하고 수동 판단은 규칙과 실제 기록을 남겨 자동 처리라고 하지 않습니다.
실행 가능한 환경과 시작점 명시
README에는 작성자가 실제 검증한 설치·실행 명령, 작업 디렉터리와 순서를 씁니다. 이 글은 미검증 범용 명령을 제시하지 않습니다. 시드는 소프트웨어·스레드·하드웨어가 달라도 비트 단위로 같음을 보장하지 않습니다.
새 디렉터리에서 실행
원입력과 공식 출력을 보존하고 새 결과를 별도 저장합니다. expected/의 옛 파일을 복사해 새 계산이라고 하지 않습니다. 온라인 입력은 고정 버전과 합법적 취득 경로를 쓰며 바뀌는 개인 링크에 의존하지 않습니다.
사전 기준으로 내용 비교
표본 수·분모·변수·모형·효과 단위를 먼저, 추정치·구간·표와 그림 데이터를 다음에 비교합니다. 날짜 같은 비과학적 차이는 따로 적고 부동소수점 허용 오차를 결과를 본 뒤 넓히지 않습니다.
실패 범위를 기록한 뒤 인계
실행과 차이 기록을 보존합니다. 입력 누락·의존성 실패·핵심 결과 불일치는 해당 결론을 중단하며 0을 채우거나 출력을 수동 수정하지 않습니다. 미실행은 재실행 대기이고 한 번의 성공은 환경 간·품질 인증이 아닙니다.
합성 교육 예시: CSV가 생겼다는 것보다 구체적인 판정
직접 만든 교육 입력은 x 한 열, 5행으로 1, 2, 3, 4와 빈칸입니다. 이 산술 예제에 한해 사전 규칙은 대치 없이 비결측 평균을 구하는 것입니다. 전체5·유효4·결측1·평균2.5를 확인합니다. 환자 자료, 실제 연구 결과, 통계 권고나 제품 실행이 아닙니다.
summary.csv의 n_total/n_valid/n_missing/mean_x를 README 점검에 연결하고 실제 명령·환경·대조는 별도 실행 기록에 적습니다. 2.5가 쓰인 파일이 있다고 계산 실행이 입증되지는 않습니다.
평균2.0이면 빈칸을0으로 채웠는지, 유효 수5이면 파싱·전처리 규칙을 먼저 확인합니다. 기대값을 먼저 바꾸지 않습니다. 인계에는 비슷한 표뿐 아니라 규칙과 분모가 필요합니다.
AI에게 성공 선언이 아닌 인계 공백 정리를 요청
권장 자료: 권한 있는 파일 목록, 공개·합성 데이터 사전, 기존 README, 확인된 실행 설명, 민감정보를 제거한 실행 요약. 목록 정리를 위해 환자 행·자격증명·공유 권한 없는 전문을 올리지 않습니다.
요청 예: 제공 자료만으로 목표 결과—입력 버전/위치—단계/매개변수—출력—검증 필드—공백을 연결한 인계표와 README 초안을 작성하라. 명령·버전·실행 근거가 없으면 확인 필요로 남기고 환경·결과·통과 기록을 만들지 말라.
인계표, README 초안, 확인 질문이 제안 산출물입니다. 이번 실제 실행이나 고객 성과가 아닙니다. 특정 코드 실행에는 자료·기능·권한·실행 전 확인을 별도로 검토해야 합니다.
인계 시 다섯 질문
인계 시 다섯 질문
- 같은 버전 입력을 합법적으로 얻고 사전과 매개변수가 명확한가?
- 주요 출력마다 생성 단계가 있으며 작성자 PC의 수동 파일이 아닌가?
- 환경·명령·순서를 실제 검증했고 미검증 부분을 표시했는가?
- 종료 코드0·파일 존재뿐 아니라 내용·분모·단위·사전 오차를 비교했는가?
- 실패·미실행·수동 단계·비공개 부분을 정직하게 기록했는가?
명확한 재현 경로만으로 설계·편향 통제·자료 권한·인과 결론이 옳음을 증명하지 못합니다. PLOS 정책은 해당 출판 체계의 요구이며 모든 저널에 자동 적용되지 않습니다. 적용 정책에 따라 제한과 합법적 접근 방법을 설명하고 민감 자료는 공개하지 않습니다.
검증된 출처
아래 공식 출처는 2026-10-21에 확인되었으며 게시 전에 접근 조건과 업데이트 날짜를 다시 확인합니다.
- The Turing Way: 재현성 정의
동일 데이터·절차의 재현과 새 데이터 검증의 구분; 분야별 용어 차이.
- PLOS: 자료·소프트웨어·코드 공유
코드·실행 문서·의존성·시험 자료와 공유 제한의 정책 범위.
연구 재현과 인계
기존 자료를 검토 가능한 인계 문서로
RigorMed 작업공간에 자료 권한·보유 파일·인계 질문을 설명하고 위 요청을 조정할 수 있습니다. 지원 범위와 실제 산출물을 먼저 확인하고 연구자가 출처·실행 기록·차이를 검토하세요. 목록 정리는 재실행 완료가 아닙니다.