설명서에는 분홍색 점을 두 번 누르라고 적혀 있는데, 코드는 초록색 점을 한 번 누르면 세부 그림을 열도록 되어 있었다. ClinLine의 RWD Lineage Tool을 살피며 확인한 차이다. 기능을 바꾸기 전에, 저장소에 이미 들어 있는 예제를 어떻게 실행하고 읽는지부터 설명을 맞출 수 있었다.
이 도구는 데이터가 어느 입력에서 어떤 변환을 거쳐 다음 자료로 이어지는지 그림으로 보여준다. 이때 읽는 것은 실제 환자 기록이 아니라, 예제 엑셀 파일에 적힌 변수·데이터셋·변환 사이의 대응 정보다. 그림의 화살표는 그 대응을 설명하며, 변환이 실제로 실행됐다는 증거를 만들어 주지는 않는다.
이미 있는 예제에 실행 순서를 붙였다
나는 필요한 Python 패키지를 설치하고 Lineage1.py를 실행하는 순서를 README에 추가했다. 코드가 저장소 루트를 기준으로 LineageExcel/Mapping_MIMIC_DM_v05_lim.xlsx를 읽는다는 점도 적어, 어느 폴더에서 명령을 실행해야 하는지 알 수 있게 했다. 이어 개요 그림의 대응 관계는 초록색, 데이터셋은 파란색으로 표시된다는 설명과 한 번 클릭해 상세 그림을 여는 동작을 코드에 맞췄다.
상세 그림의 데이터셋 상자, 두 데이터셋을 연결하는 결합 표시, 변환 상자에 대한 설명도 함께 고쳤다. ‘추가할 예정’으로 남아 있던 파킨슨병 예제 안내에는 이미 저장소에 있는 모의 연구계획서, 대응표 엑셀 파일, DM 정의 문서의 링크를 연결했다. PR이 바꾼 파일은 README 한 개이며, 데이터 처리나 시각화 코드를 새로 구현한 작업은 아니다.
실행 확인과 현재 상태
포함된 엑셀 파일로 Lineage1.py를 실행했을 때, 창을 띄우지 않는 Matplotlib 방식에서 프로세스가 정상 종료되는 것을 확인했다. 이 검사는 예제를 읽어 실행하는 경로에 관한 것이며, 화면에서의 클릭 조작 전체를 검수한 결과는 아니다. 수정안과 확인 범위를 PR #2에 담아 2026년 9월 23일 제출했으며, 9월 28일 기준 PR은 열려 있고 아직 병합되지 않았다.