문제 해결

일반적인 오류 및 해결 방법

오류: "Mesh file is required"

원인: --mesh 인수 누락

해결책:

UVSim3D_DP --config reactor.json --mesh nodes.vtu --output results.vtu

오류: "Failed to load JSON file"

원인: 잘못된 JSON 구문

해결책:

1. 온라인 검증기(jsonlint.com)로 JSON 구문 확인
2. 일반적인 실수:
   • 배열 요소 사이의 쉼표 누락
   • 마지막 요소 뒤의 쉼표
   • 닫는 중괄호 } 누락

잘못된 JSON 예제:

{
    "lampConfig": [
        { "power": 150.0 }  // 여기 쉼표 누락
        { "power": 200.0 }
    ]
}

수정됨:

{
    "lampConfig": [
        { "power": 150.0 },
        { "power": 200.0 }
    ]
}

오류: "Sum of uvBands.relativeEnergy must equal 1.0"

원인: 밴드 에너지가 1.0으로 합산되지 않음

해결책: relativeEnergy 값 조정:

"uvBands": [
    {"lambda": 185, "relativeEnergy": 0.04, ...},
    {"lambda": 254, "relativeEnergy": 0.96, ...}  // 합계 = 1.0
]

오류: "Configuration validation failed: lamps[0].eta must be between 0 and 1"

원인: 잘못된 매개변수 값

해결책: 모든 매개변수 범위 확인:

• eta: 0.0 ~ 1.0 (반드시 > 0)
• waterUVT: 0.0 ~ 1.0 (반드시 > 0)
• sleeveUVT: 0.0 ~ 1.0 (반드시 > 0)
• dimming: 0.0 ~ 1.0 (반드시 > 0)
• power: > 0
• arcLength: > 0
• diameter: > 0

느린 성능

증상: 계산이 매우 오래 걸림

해결책:

1. 공간 필터 활성화: 관심 영역만 계산
2. 메쉬 포인트 줄이기: 중요도가 낮은 영역의 메쉬 조밀도 낮추기
3. numThreads 확인: numThreads: 0으로 모든 코어 사용

예상 시간:

• 10,000 포인트, 1개 램프, 1 CPU: ~0초
• 100,000 포인트, 4개 램프, 4 CPU: ~00초
• 1,000,000 포인트, 24개 램프, 20 CPU: ~ 4분

도움말

로그 파일

항상 로그 파일을 먼저 확인하세요:

• 위치: 출력 파일과 동일한 디렉토리 (또는 출력이 없으면 설정 파일)
• 이름: .log
• 내용: 상세한 실행 추적, 경고, 오류

지원

기술 지원:

1. 이 가이드 확인 일반적인 문제
2. 샘플 케이스 검토 samples/ 디렉토리
3. 문의: [귀하의 지원 이메일]

문제 보고 시 포함 사항:

• UVSim3D 버전 (UVSim3D_DP --help에서)
• 운영 체제
• 설정 파일
• 로그 파일
• 오류 메시지