RCPVMS 분석 소프트웨어 사용자 매뉴얼

소프트웨어명: rcpvms 버전: 0.0.3 문서 최종 수정일: 2026-02-11

1. 개요

1.1 소프트웨어 소개

본 소프트웨어는 **RCPVMS(원자로 냉각재 펌프 감시계통)**에서 출력된 진동 데이터 파일(.BIN)을 딥러닝 모델로 분석하여, 원자로 냉각재 펌프의 상태를 정상(Normal) 또는 **비정상(Abnormal)**으로 판별하는 데스크톱 애플리케이션입니다.

1.2 분석 대상

소프트웨어는 다음 4개의 RCP 궤도를 각각 독립적으로 분석합니다:

분석 항목	설명
RCP1A	1번 냉각재 펌프 A 궤도
RCP1B	1번 냉각재 펌프 B 궤도
RCP2A	2번 냉각재 펌프 A 궤도
RCP2B	2번 냉각재 펌프 B 궤도

각 궤도에 대해 정상/비정상 확률이 산출되며, 4개 궤도의 결과를 종합하여 최종 판정이 내려집니다. 최종 판정 기준은 다음과 같습니다:

ABNORMAL: 4개 궤도 중 하나라도 비정상으로 판정된 경우
NORMAL: 4개 궤도 모두 정상으로 판정된 경우

1.3 주요 기능

단일 파일 분석: BIN 파일 1개를 선택하여 즉시 분석
배치 처리: 여러 BIN 파일을 한 번에 분석 (병렬 처리 지원)
시각화: 궤도 이미지, Grad-CAM 히트맵, 오버레이, 타임라인 제공
결과 내보내기: JSON, CSV, Excel(이미지 포함) 형식으로 저장

1.4 BIN 파일 준비

분석에 사용할 .BIN 파일은 외부 RCPVMS 장비에서 추출해야 합니다. USB 저장 장치 또는 PC 공유 폴더를 통해 분석용 PC로 복사하십시오.

2. 설치

2.1 설치 파일 실행

설치 파일(rcpvms-{버전}-setup.exe)을 더블 클릭하여 실행합니다.
설치 마법사의 안내에 따라 진행합니다.
설치가 완료되면 바탕화면에 rcpvms 바로가기가 자동으로 생성됩니다.

별도의 추가 설치(Python, 모델 파일 등)는 필요하지 않습니다. 모든 구성 요소가 설치 파일에 포함되어 있습니다.

2.2 첫 실행

바탕화면의 rcpvms 바로가기를 더블 클릭합니다.
프로그램이 시작되면 내부 분석 엔진(딥러닝 모델)이 자동으로 로딩됩니다.
모델 로딩이 완료되면 로그인 화면이 표시됩니다.

참고: 프로그램을 실행할 때마다 분석 엔진 초기화에 약 30~40초가 소요됩니다 (첫 실행뿐 아니라 매 실행 시). 이 시간 동안 프로그램이 응답하지 않는 것처럼 보일 수 있으나, 정상적인 동작입니다.

2.3 소프트웨어 삭제

Windows 설정 > 앱 > rcpvms를 선택하여 제거할 수 있습니다.

3. 계정 관리

3.1 회원가입

프로그램을 처음 사용하는 경우 계정을 생성해야 합니다.

로그인 화면에서 "계정이 없으신가요? 회원가입" 링크를 클릭합니다.
아이디와 비밀번호를 입력합니다.
"가입하기" 버튼을 클릭합니다.
"회원가입 성공! 로그인해주세요." 메시지가 표시되면 로그인 화면으로 전환됩니다.

주의: 이미 존재하는 아이디로는 가입할 수 없습니다.

비밀번호 분실 시: 별도의 비밀번호 복구 기능은 제공되지 않습니다. 비밀번호를 분실한 경우 새로운 아이디로 재가입하십시오. 모든 계정을 초기화해야 하는 경우 유지보수 가이드(9.1절)의 데이터베이스 항목을 참조하십시오.

3.2 로그인

아이디와 비밀번호를 입력합니다.
"로그인" 버튼을 클릭합니다.
로그인 성공 시 분석 대시보드 화면으로 이동합니다.

세션은 프로그램 재시작 후에도 유지됩니다. 이전에 로그인한 상태라면 자동으로 대시보드로 이동합니다.

3.3 로그아웃

대시보드 우측 상단의 "로그아웃" 버튼을 클릭합니다.

4. 단일 파일 분석

로그인 후 표시되는 대시보드에서 분석을 수행합니다.

4.1 분석 절차

화면 상단의 모드 선택에서 "단일 파일" 이 선택되어 있는지 확인합니다.
"📂 파일 찾기" 버튼을 클릭합니다.
파일 선택 대화상자에서 분석할 .BIN 파일을 선택합니다.
선택한 파일 경로가 화면에 표시됩니다.
"🚀 분석 시작" 버튼을 클릭합니다.
"⏳ 분석 진행 중..." 표시가 나타나며, 분석이 완료될 때까지 대기합니다.
분석이 완료되면 결과가 화면에 표시됩니다.

4.2 분석 결과 화면

분석이 완료되면 다음 정보가 표시됩니다:

최종 분석 판정: NORMAL 또는 ABNORMAL
RCP별 상세 결과: 4개 궤도(RCP1A, RCP1B, RCP2A, RCP2B) 각각의 판정과 확률
시각화 이미지: 각 RCP 카드에서 탭을 전환하여 확인 (5장 참조)

5. 결과 해석 및 시각화

5.1 최종 판정

분석 결과 상단에 표시되는 최종 분석 판정은 4개 RCP 궤도의 결과를 종합한 것입니다.

판정	의미	조건
NORMAL	분석 대상 펌프의 진동 상태가 정상 범위 내	4개 궤도 모두 정상
ABNORMAL	분석 대상 펌프의 진동 상태에 이상 징후 감지	4개 궤도 중 1개 이상 비정상

즉, RCP1A~RCP2B 중 하나의 궤도라도 비정상으로 판정되면 최종 판정은 ABNORMAL이 됩니다.

5.2 RCP별 상세 결과

각 RCP 카드에는 다음 정보가 표시됩니다:

판정(Prediction): 해당 궤도의 정상/비정상 판정
확률(Probabilities): Normal과 Abnormal 각각의 확률(백분율)

확률 막대 그래프를 통해 판정의 신뢰도를 직관적으로 확인할 수 있습니다.

5.3 시각화 탭

각 RCP 카드 하단의 탭을 전환하여 4가지 시각화를 확인할 수 있습니다:

탭	설명
궤도	해당 RCP의 궤도(Orbit) 원본 이미지
Grad-CAM	모델이 판정 시 주목한 영역을 히트맵으로 표시 (아래 설명 참조)
오버레이	궤도 이미지 위에 Grad-CAM 히트맵을 겹쳐서 표시
타임라인	0초~9초 구간의 시간대별 궤도 이미지 (슬라이더로 이동)

Grad-CAM이란?

Grad-CAM(Gradient-weighted Class Activation Mapping)은 딥러닝 모델이 판정을 내릴 때 궤도 이미지의 어느 영역을 근거로 판단했는지를 시각적으로 보여주는 기술입니다.

붉은색 영역: 모델이 판정에 강하게 영향을 받은 부분 (높은 관심도)
파란색/투명 영역: 판정에 큰 영향을 주지 않은 부분 (낮은 관심도)

오버레이 탭에서는 원본 궤도 이미지 위에 이 히트맵을 겹쳐 볼 수 있어, 궤도의 어느 부분에 이상이 감지되었는지 직관적으로 확인할 수 있습니다.

타임라인 사용법

타임라인 탭을 선택하면 이미지 하단에 슬라이더가 나타납니다. 슬라이더를 좌우로 움직여 0초부터 9초까지의 궤도 변화를 시간순으로 확인할 수 있습니다.

6. 배치 처리

여러 BIN 파일을 한 번에 분석할 때 사용합니다.

6.1 배치 분석 절차

화면 상단의 모드 선택에서 **"배치 처리"**를 클릭합니다.
"📂 파일 추가 (다중 선택)" 버튼을 클릭합니다.
파일 선택 대화상자에서 분석할 BIN 파일을 여러 개 선택합니다.
- Ctrl 키를 누른 채 클릭하면 개별 파일을 추가 선택할 수 있습니다.
- Shift 키를 누른 채 클릭하면 범위를 지정하여 선택할 수 있습니다.
선택된 파일 목록이 화면에 표시됩니다.
필요 시 병렬 처리 수준을 설정합니다 (6.2절 참조).
"🚀 전체 분석 시작" 버튼을 클릭합니다.

6.2 병렬 처리 수준 설정

파일 추가 버튼 옆의 "병렬 처리 수준" 드롭다운에서 동시에 분석할 파일 수를 설정합니다.

수준	설명	권장
1	순차 처리 (한 번에 1개씩)	저사양 PC
2	동시에 2개 파일 처리	대부분의 PC에 권장
3	동시에 3개 파일 처리	중상위 사양 PC
4	동시에 4개 파일 처리 (고부하)	고사양 PC만 사용

주의: 수준 4를 선택하면 경고 메시지가 표시됩니다. CPU 및 메모리 사용량이 크게 증가하므로, 시스템 사양을 고려하여 선택하십시오.

6.3 진행 상황 확인

배치 분석이 진행되는 동안 다음 정보가 실시간으로 업데이트됩니다:

진행률 바: 전체 완료 비율 표시
진행 텍스트: 완료 파일 수 / 전체 파일 수 (실패 건수 포함)
현재 분석 중: 현재 처리 중인 파일명 표시
파일별 상태 아이콘:
- ⏸ 대기 중 (pending)
- ⏳ 분석 중 (running)
- ✓ 완료 (completed)
- ✗ 실패 (failed)

6.4 파일 관리

파일 추가: 분석 전에 "파일 추가" 버튼을 다시 클릭하여 추가할 수 있습니다. 중복 파일은 자동으로 제외됩니다.
파일 제거: 각 파일 항목 우측의 ✕ 버튼을 클릭하여 목록에서 제거합니다.
재분석: 실패한 파일은 ↻ 버튼을 클릭하여 개별적으로 재분석할 수 있습니다.

6.5 배치 분석 취소

분석 진행 중 "⏹ 취소" 버튼을 클릭하면 진행 중인 배치 분석을 중단할 수 있습니다. 이미 완료된 파일의 결과는 유지됩니다.

6.6 배치 결과 확인

배치 분석이 완료되면 하단에 각 파일별 결과가 아코디언(접기/펼치기) 형태로 표시됩니다. 각 파일을 클릭하면 단일 분석과 동일한 상세 결과(최종 판정, RCP별 결과, 시각화)를 확인할 수 있습니다.

7. 결과 내보내기

배치 처리에서 완료된 결과를 외부 파일로 저장할 수 있습니다. 분석이 완료된 파일이 1개 이상 있으면 내보내기 버튼이 표시됩니다.

참고: 결과 내보내기는 배치 처리 모드에서만 사용할 수 있습니다. 단일 파일 분석 결과를 저장하려면, 배치 처리 모드에서 파일 1개를 추가하여 분석한 후 내보내기를 사용하십시오.

7.1 JSON 내보내기

"📄 JSON 내보내기" 버튼을 클릭합니다.

저장 위치와 파일명을 지정합니다.
분석 결과 전체(파일 경로, 판정, RCP별 확률, 시각화 경로)가 JSON 형식으로 저장됩니다.
프로그래밍적으로 결과를 후처리할 때 유용합니다.

7.2 CSV 내보내기

"📊 CSV 내보내기" 버튼을 클릭합니다.

저장 위치와 파일명을 지정합니다.
각 파일의 분석 결과가 테이블 형태로 저장됩니다.
포함 항목: 파일명, 최종판정, 상태, RCP1A, RCP1B, RCP2A, RCP2B
Excel에서 바로 열 수 있습니다 (한글 인코딩 지원).

7.3 Excel 내보내기 (이미지 포함)

"📊 Excel 내보내기 (이미지 포함)" 버튼을 클릭합니다.

저장 위치와 파일명을 지정합니다.
CSV와 동일한 분석 결과에 더해, 각 RCP의 Grad-CAM 오버레이 이미지가 셀에 삽입됩니다.
보고서 작성 시 시각적 근거를 함께 제출해야 할 때 유용합니다.

8. 문제 해결

8.1 자주 발생하는 문제

증상	원인	해결 방법
프로그램 실행 후 화면이 표시되지 않음	분석 엔진 초기화 중	잠시 대기합니다. 초기화에 시간이 소요될 수 있습니다.
"서버 연결 오류가 발생했습니다."	내부 통신 오류	프로그램을 종료 후 다시 실행합니다.
"BIN file not found" 오류	선택한 파일이 이동 또는 삭제됨	파일 경로를 확인하고 다시 선택합니다.
"Invalid file type" 오류	.BIN 이외의 파일 선택	.BIN 확장자의 파일만 선택하십시오.
분석 결과에 시각화 이미지가 표시되지 않음	임시 이미지 파일 생성 실패	디스크 용량을 확인하고 프로그램을 재시작합니다.
배치 처리 중 일부 파일 실패	개별 파일 손상 또는 형식 오류	실패한 파일 옆의 ↻ 버튼으로 재시도하거나, 원본 BIN 파일을 확인합니다.
프로그램이 느리게 동작함	병렬 처리 수준이 너무 높음	병렬 처리 수준을 2 또는 3으로 낮추십시오.
"이미 존재하는 아이디입니다."	중복 아이디로 회원가입 시도	다른 아이디를 사용하십시오.
로그인 후 자동 로그아웃됨	세션 데이터 손상	프로그램을 재시작하고 다시 로그인합니다.

8.2 프로그램 강제 종료 후 재시작

프로그램이 응답하지 않는 경우:

Ctrl + Shift + Esc를 눌러 작업 관리자를 엽니다.
rcp-desktop-app 프로세스를 찾아 **"작업 끝내기"**를 클릭합니다.
inference_daemon.exe 프로세스가 남아 있다면 함께 종료합니다. (이 프로세스는 분석 엔진을 실행하는 백그라운드 프로그램입니다.)
프로그램을 다시 실행합니다.

9. 유지보수 가이드

9.1 데이터 관리

분석 결과 임시 파일

분석 과정에서 생성되는 시각화 이미지(궤도, 히트맵, 오버레이)는 시스템 임시 폴더에 저장됩니다. 이 파일들은 다음 배치 분석을 시작할 때 자동으로 정리됩니다.

수동으로 정리가 필요한 경우:

Windows 임시 폴더(%TEMP%)에서 rcp-inference-로 시작하는 폴더를 삭제합니다.

데이터베이스

사용자 계정 및 시스템 로그는 다음 경로에 저장됩니다:

%APPDATA%\rcpvms\logs.db

경로 접근 방법: Windows 탐색기의 주소 표시줄에 %APPDATA%\rcpvms를 입력하고 Enter를 누르면 해당 폴더로 이동합니다.

주의: 이 파일을 삭제하면 등록된 계정과 로그 기록이 모두 삭제됩니다.

세션 정보

로그인 세션 정보는 다음 경로에 저장됩니다:

%APPDATA%\rcpvms\user-session.json

자동 로그인이 문제를 일으키는 경우 이 파일을 삭제하면 세션이 초기화됩니다.

9.2 소프트웨어 업데이트

새 버전의 설치 파일을 받은 경우:

기존 프로그램을 종료합니다.
새 설치 파일을 실행합니다.
기존 버전이 자동으로 덮어씌워집니다.

업데이트 시 기존 계정 정보와 로그는 유지됩니다.

9.3 소프트웨어 삭제

Windows 설정 > 앱 > 설치된 앱으로 이동합니다.
목록에서 rcpvms를 찾아 **"제거"**를 클릭합니다.
완전 삭제를 원하는 경우 다음 경로의 데이터도 수동으로 삭제합니다:
- %APPDATA%\rcpvms\ (계정 정보, 로그, 세션)

본 문서는 rcpvms 버전 0.0.3 기준으로 작성되었습니다.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.vscode		.vscode
benchmarks		benchmarks
build		build
docs		docs
python		python
resources		resources
src		src
.dependency-cruiser.js		.dependency-cruiser.js
.editorconfig		.editorconfig
.gitignore		.gitignore
.gitmodules		.gitmodules
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc.yaml		.prettierrc.yaml
BUNDLING_GUIDE.md		BUNDLING_GUIDE.md
CLAUDE.md		CLAUDE.md
RCPVMS_Portfolio.docx		RCPVMS_Portfolio.docx
README.md		README.md
_out.txt		_out.txt
electron-builder.yml		electron-builder.yml
electron.vite.config.ts		electron.vite.config.ts
eslint.config.mjs		eslint.config.mjs
package-lock.json		package-lock.json
package.json		package.json
plan.txt		plan.txt
src_graph.svg		src_graph.svg
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
tsconfig.web.json		tsconfig.web.json

Uh oh!

Latest commit

History

Folders and files

Repository files navigation