소프트웨어명: rcpvms 버전: 0.0.3 문서 최종 수정일: 2026-02-11
본 소프트웨어는 **RCPVMS(원자로 냉각재 펌프 감시계통)**에서 출력된 진동 데이터 파일(.BIN)을 딥러닝 모델로 분석하여, 원자로 냉각재 펌프의 상태를 정상(Normal) 또는 **비정상(Abnormal)**으로 판별하는 데스크톱 애플리케이션입니다.
소프트웨어는 다음 4개의 RCP 궤도를 각각 독립적으로 분석합니다:
| 분석 항목 | 설명 |
|---|---|
| RCP1A | 1번 냉각재 펌프 A 궤도 |
| RCP1B | 1번 냉각재 펌프 B 궤도 |
| RCP2A | 2번 냉각재 펌프 A 궤도 |
| RCP2B | 2번 냉각재 펌프 B 궤도 |
각 궤도에 대해 정상/비정상 확률이 산출되며, 4개 궤도의 결과를 종합하여 최종 판정이 내려집니다. 최종 판정 기준은 다음과 같습니다:
- ABNORMAL: 4개 궤도 중 하나라도 비정상으로 판정된 경우
- NORMAL: 4개 궤도 모두 정상으로 판정된 경우
- 단일 파일 분석: BIN 파일 1개를 선택하여 즉시 분석
- 배치 처리: 여러 BIN 파일을 한 번에 분석 (병렬 처리 지원)
- 시각화: 궤도 이미지, Grad-CAM 히트맵, 오버레이, 타임라인 제공
- 결과 내보내기: JSON, CSV, Excel(이미지 포함) 형식으로 저장
분석에 사용할 .BIN 파일은 외부 RCPVMS 장비에서 추출해야 합니다. USB 저장 장치 또는 PC 공유 폴더를 통해 분석용 PC로 복사하십시오.
- 설치 파일(
rcpvms-{버전}-setup.exe)을 더블 클릭하여 실행합니다. - 설치 마법사의 안내에 따라 진행합니다.
- 설치가 완료되면 바탕화면에 rcpvms 바로가기가 자동으로 생성됩니다.
별도의 추가 설치(Python, 모델 파일 등)는 필요하지 않습니다. 모든 구성 요소가 설치 파일에 포함되어 있습니다.
- 바탕화면의 rcpvms 바로가기를 더블 클릭합니다.
- 프로그램이 시작되면 내부 분석 엔진(딥러닝 모델)이 자동으로 로딩됩니다.
- 모델 로딩이 완료되면 로그인 화면이 표시됩니다.
참고: 프로그램을 실행할 때마다 분석 엔진 초기화에 약 30~40초가 소요됩니다 (첫 실행뿐 아니라 매 실행 시). 이 시간 동안 프로그램이 응답하지 않는 것처럼 보일 수 있으나, 정상적인 동작입니다.
Windows 설정 > 앱 > rcpvms를 선택하여 제거할 수 있습니다.
프로그램을 처음 사용하는 경우 계정을 생성해야 합니다.
- 로그인 화면에서 "계정이 없으신가요? 회원가입" 링크를 클릭합니다.
- 아이디와 비밀번호를 입력합니다.
- "가입하기" 버튼을 클릭합니다.
- "회원가입 성공! 로그인해주세요." 메시지가 표시되면 로그인 화면으로 전환됩니다.
주의: 이미 존재하는 아이디로는 가입할 수 없습니다.
비밀번호 분실 시: 별도의 비밀번호 복구 기능은 제공되지 않습니다. 비밀번호를 분실한 경우 새로운 아이디로 재가입하십시오. 모든 계정을 초기화해야 하는 경우 유지보수 가이드(9.1절)의 데이터베이스 항목을 참조하십시오.
- 아이디와 비밀번호를 입력합니다.
- "로그인" 버튼을 클릭합니다.
- 로그인 성공 시 분석 대시보드 화면으로 이동합니다.
세션은 프로그램 재시작 후에도 유지됩니다. 이전에 로그인한 상태라면 자동으로 대시보드로 이동합니다.
대시보드 우측 상단의 "로그아웃" 버튼을 클릭합니다.
로그인 후 표시되는 대시보드에서 분석을 수행합니다.
- 화면 상단의 모드 선택에서 "단일 파일" 이 선택되어 있는지 확인합니다.
- "📂 파일 찾기" 버튼을 클릭합니다.
- 파일 선택 대화상자에서 분석할 .BIN 파일을 선택합니다.
- 선택한 파일 경로가 화면에 표시됩니다.
- "🚀 분석 시작" 버튼을 클릭합니다.
- "⏳ 분석 진행 중..." 표시가 나타나며, 분석이 완료될 때까지 대기합니다.
- 분석이 완료되면 결과가 화면에 표시됩니다.
분석이 완료되면 다음 정보가 표시됩니다:
- 최종 분석 판정: NORMAL 또는 ABNORMAL
- RCP별 상세 결과: 4개 궤도(RCP1A, RCP1B, RCP2A, RCP2B) 각각의 판정과 확률
- 시각화 이미지: 각 RCP 카드에서 탭을 전환하여 확인 (5장 참조)
분석 결과 상단에 표시되는 최종 분석 판정은 4개 RCP 궤도의 결과를 종합한 것입니다.
| 판정 | 의미 | 조건 |
|---|---|---|
| NORMAL | 분석 대상 펌프의 진동 상태가 정상 범위 내 | 4개 궤도 모두 정상 |
| ABNORMAL | 분석 대상 펌프의 진동 상태에 이상 징후 감지 | 4개 궤도 중 1개 이상 비정상 |
즉, RCP1A~RCP2B 중 하나의 궤도라도 비정상으로 판정되면 최종 판정은 ABNORMAL이 됩니다.
각 RCP 카드에는 다음 정보가 표시됩니다:
- 판정(Prediction): 해당 궤도의 정상/비정상 판정
- 확률(Probabilities): Normal과 Abnormal 각각의 확률(백분율)
확률 막대 그래프를 통해 판정의 신뢰도를 직관적으로 확인할 수 있습니다.
각 RCP 카드 하단의 탭을 전환하여 4가지 시각화를 확인할 수 있습니다:
| 탭 | 설명 |
|---|---|
| 궤도 | 해당 RCP의 궤도(Orbit) 원본 이미지 |
| Grad-CAM | 모델이 판정 시 주목한 영역을 히트맵으로 표시 (아래 설명 참조) |
| 오버레이 | 궤도 이미지 위에 Grad-CAM 히트맵을 겹쳐서 표시 |
| 타임라인 | 0초~9초 구간의 시간대별 궤도 이미지 (슬라이더로 이동) |
Grad-CAM(Gradient-weighted Class Activation Mapping)은 딥러닝 모델이 판정을 내릴 때 궤도 이미지의 어느 영역을 근거로 판단했는지를 시각적으로 보여주는 기술입니다.
- 붉은색 영역: 모델이 판정에 강하게 영향을 받은 부분 (높은 관심도)
- 파란색/투명 영역: 판정에 큰 영향을 주지 않은 부분 (낮은 관심도)
오버레이 탭에서는 원본 궤도 이미지 위에 이 히트맵을 겹쳐 볼 수 있어, 궤도의 어느 부분에 이상이 감지되었는지 직관적으로 확인할 수 있습니다.
타임라인 탭을 선택하면 이미지 하단에 슬라이더가 나타납니다. 슬라이더를 좌우로 움직여 0초부터 9초까지의 궤도 변화를 시간순으로 확인할 수 있습니다.
여러 BIN 파일을 한 번에 분석할 때 사용합니다.
- 화면 상단의 모드 선택에서 **"배치 처리"**를 클릭합니다.
- "📂 파일 추가 (다중 선택)" 버튼을 클릭합니다.
- 파일 선택 대화상자에서 분석할 BIN 파일을 여러 개 선택합니다.
Ctrl키를 누른 채 클릭하면 개별 파일을 추가 선택할 수 있습니다.Shift키를 누른 채 클릭하면 범위를 지정하여 선택할 수 있습니다.
- 선택된 파일 목록이 화면에 표시됩니다.
- 필요 시 병렬 처리 수준을 설정합니다 (6.2절 참조).
- "🚀 전체 분석 시작" 버튼을 클릭합니다.
파일 추가 버튼 옆의 "병렬 처리 수준" 드롭다운에서 동시에 분석할 파일 수를 설정합니다.
| 수준 | 설명 | 권장 |
|---|---|---|
| 1 | 순차 처리 (한 번에 1개씩) | 저사양 PC |
| 2 | 동시에 2개 파일 처리 | 대부분의 PC에 권장 |
| 3 | 동시에 3개 파일 처리 | 중상위 사양 PC |
| 4 | 동시에 4개 파일 처리 (고부하) | 고사양 PC만 사용 |
주의: 수준 4를 선택하면 경고 메시지가 표시됩니다. CPU 및 메모리 사용량이 크게 증가하므로, 시스템 사양을 고려하여 선택하십시오.
배치 분석이 진행되는 동안 다음 정보가 실시간으로 업데이트됩니다:
- 진행률 바: 전체 완료 비율 표시
- 진행 텍스트: 완료 파일 수 / 전체 파일 수 (실패 건수 포함)
- 현재 분석 중: 현재 처리 중인 파일명 표시
- 파일별 상태 아이콘:
- ⏸ 대기 중 (pending)
- ⏳ 분석 중 (running)
- ✓ 완료 (completed)
- ✗ 실패 (failed)
- 파일 추가: 분석 전에 "파일 추가" 버튼을 다시 클릭하여 추가할 수 있습니다. 중복 파일은 자동으로 제외됩니다.
- 파일 제거: 각 파일 항목 우측의 ✕ 버튼을 클릭하여 목록에서 제거합니다.
- 재분석: 실패한 파일은 ↻ 버튼을 클릭하여 개별적으로 재분석할 수 있습니다.
분석 진행 중 "⏹ 취소" 버튼을 클릭하면 진행 중인 배치 분석을 중단할 수 있습니다. 이미 완료된 파일의 결과는 유지됩니다.
배치 분석이 완료되면 하단에 각 파일별 결과가 아코디언(접기/펼치기) 형태로 표시됩니다. 각 파일을 클릭하면 단일 분석과 동일한 상세 결과(최종 판정, RCP별 결과, 시각화)를 확인할 수 있습니다.
배치 처리에서 완료된 결과를 외부 파일로 저장할 수 있습니다. 분석이 완료된 파일이 1개 이상 있으면 내보내기 버튼이 표시됩니다.
참고: 결과 내보내기는 배치 처리 모드에서만 사용할 수 있습니다. 단일 파일 분석 결과를 저장하려면, 배치 처리 모드에서 파일 1개를 추가하여 분석한 후 내보내기를 사용하십시오.
"📄 JSON 내보내기" 버튼을 클릭합니다.
- 저장 위치와 파일명을 지정합니다.
- 분석 결과 전체(파일 경로, 판정, RCP별 확률, 시각화 경로)가 JSON 형식으로 저장됩니다.
- 프로그래밍적으로 결과를 후처리할 때 유용합니다.
"📊 CSV 내보내기" 버튼을 클릭합니다.
- 저장 위치와 파일명을 지정합니다.
- 각 파일의 분석 결과가 테이블 형태로 저장됩니다.
- 포함 항목: 파일명, 최종판정, 상태, RCP1A, RCP1B, RCP2A, RCP2B
- Excel에서 바로 열 수 있습니다 (한글 인코딩 지원).
"📊 Excel 내보내기 (이미지 포함)" 버튼을 클릭합니다.
- 저장 위치와 파일명을 지정합니다.
- CSV와 동일한 분석 결과에 더해, 각 RCP의 Grad-CAM 오버레이 이미지가 셀에 삽입됩니다.
- 보고서 작성 시 시각적 근거를 함께 제출해야 할 때 유용합니다.
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 프로그램 실행 후 화면이 표시되지 않음 | 분석 엔진 초기화 중 | 잠시 대기합니다. 초기화에 시간이 소요될 수 있습니다. |
| "서버 연결 오류가 발생했습니다." | 내부 통신 오류 | 프로그램을 종료 후 다시 실행합니다. |
| "BIN file not found" 오류 | 선택한 파일이 이동 또는 삭제됨 | 파일 경로를 확인하고 다시 선택합니다. |
| "Invalid file type" 오류 | .BIN 이외의 파일 선택 | .BIN 확장자의 파일만 선택하십시오. |
| 분석 결과에 시각화 이미지가 표시되지 않음 | 임시 이미지 파일 생성 실패 | 디스크 용량을 확인하고 프로그램을 재시작합니다. |
| 배치 처리 중 일부 파일 실패 | 개별 파일 손상 또는 형식 오류 | 실패한 파일 옆의 ↻ 버튼으로 재시도하거나, 원본 BIN 파일을 확인합니다. |
| 프로그램이 느리게 동작함 | 병렬 처리 수준이 너무 높음 | 병렬 처리 수준을 2 또는 3으로 낮추십시오. |
| "이미 존재하는 아이디입니다." | 중복 아이디로 회원가입 시도 | 다른 아이디를 사용하십시오. |
| 로그인 후 자동 로그아웃됨 | 세션 데이터 손상 | 프로그램을 재시작하고 다시 로그인합니다. |
프로그램이 응답하지 않는 경우:
Ctrl + Shift + Esc를 눌러 작업 관리자를 엽니다.- rcp-desktop-app 프로세스를 찾아 **"작업 끝내기"**를 클릭합니다.
- inference_daemon.exe 프로세스가 남아 있다면 함께 종료합니다. (이 프로세스는 분석 엔진을 실행하는 백그라운드 프로그램입니다.)
- 프로그램을 다시 실행합니다.
분석 과정에서 생성되는 시각화 이미지(궤도, 히트맵, 오버레이)는 시스템 임시 폴더에 저장됩니다. 이 파일들은 다음 배치 분석을 시작할 때 자동으로 정리됩니다.
수동으로 정리가 필요한 경우:
- Windows 임시 폴더(
%TEMP%)에서rcp-inference-로 시작하는 폴더를 삭제합니다.
사용자 계정 및 시스템 로그는 다음 경로에 저장됩니다:
%APPDATA%\rcpvms\logs.db
경로 접근 방법: Windows 탐색기의 주소 표시줄에
%APPDATA%\rcpvms를 입력하고 Enter를 누르면 해당 폴더로 이동합니다.
주의: 이 파일을 삭제하면 등록된 계정과 로그 기록이 모두 삭제됩니다.
로그인 세션 정보는 다음 경로에 저장됩니다:
%APPDATA%\rcpvms\user-session.json
자동 로그인이 문제를 일으키는 경우 이 파일을 삭제하면 세션이 초기화됩니다.
새 버전의 설치 파일을 받은 경우:
- 기존 프로그램을 종료합니다.
- 새 설치 파일을 실행합니다.
- 기존 버전이 자동으로 덮어씌워집니다.
업데이트 시 기존 계정 정보와 로그는 유지됩니다.
- Windows 설정 > 앱 > 설치된 앱으로 이동합니다.
- 목록에서 rcpvms를 찾아 **"제거"**를 클릭합니다.
- 완전 삭제를 원하는 경우 다음 경로의 데이터도 수동으로 삭제합니다:
%APPDATA%\rcpvms\(계정 정보, 로그, 세션)
본 문서는 rcpvms 버전 0.0.3 기준으로 작성되었습니다.