최종 수정: 2025-10-06 읽기 약 4분
명령줄 사용법
실행 파일
설치 후 두 가지 실행 파일 사용 가능:
UVSim3D_SP.exe(Linux:UVSim3D_SP): 단정밀도 (32비트 부동소수점) - 권장UVSim3D_DP.exe(Linux:UVSim3D_DP): 배정밀도 (64비트 부동소수점)
기본 문법
bash
UVSim3D_DP --config --mesh [옵션] 필수 인수
| 인수 | 설명 | 예제 |
|---|---|---|
--config <파일> | JSON 설정 파일 경로 | --config reactor.json |
--mesh <파일> | 계산 포인트가 있는 메쉬 파일 경로 (--dry 사용 시 선택사항) | --mesh nodes.vtu |
선택 인수
| 인수 | 설명 | 기본값 | 예제 |
|---|---|---|---|
--output <파일> | 출력 파일 경로 | 자동 생성 | --output results.vtu |
--format <형식> | 출력 형식: txt, vtu, vtkhdf | 확장자에서 자동 감지 | --format vtu |
--dry | 드라이 런: 설정 파일 검증만 수행, 메쉬 로딩 및 계산 생략 | - | --dry |
--log | 로그 파일 생성 여부 (on: 파일+콘솔, off: 콘솔만) | on | --log off |
--help | 도움말 메시지 표시 | - | --help |
예제
1. 텍스트 출력으로 기본 시뮬레이션:
bash
UVSim3D_DP --config my_reactor.json --mesh nodes.txt --output results.txt2. VTU 메쉬 및 출력 사용:
bash
UVSim3D_DP --config my_reactor.json --mesh reactor_mesh.vtu --output fluence.vtu3. VTKHDF 형식의 대형 메쉬 (>1M 포인트 권장):
bash
UVSim3D_DP --config my_reactor.json --mesh large_mesh.vtkhdf --output results.vtkhdf4. 출력 파일 없이 계산만 수행:
bash
UVSim3D_DP --config my_reactor.json --mesh nodes.txt5. 드라이 런 (설정 파일 검증만, 메쉬 로딩/계산 생략):
bash
UVSim3D_DP --config my_reactor.json --dry설정 파일 문법 오류나 매개변수 유효성 문제를 빠르게 확인할 수 있습니다.
6. 로그 파일 없이 콘솔 출력만:
bash
UVSim3D_DP --config my_reactor.json --mesh nodes.txt --output results.txt --log off임시 테스트나 스크립트 실행 시 로그 파일이 불필요할 때 유용합니다.
7. 드라이 런 + 로그 파일 없이:
bash
UVSim3D_DP --config my_reactor.json --dry --log off설정 파일만 빠르게 검증하고 로그 파일도 생성하지 않습니다.
출력 파일
모든 실행은 다음 파일들을 생성합니다:
- 로그 파일 (
): 상세한 실행 로그 (--log off가 아닌 경우).log - 출력 파일 (
--output지정 시): 계산된 조사량 결과
로그 파일 위치 (--log off가 아닌 경우):
--output지정 시: 출력 파일과 동일한 디렉토리- 그렇지 않으면: 설정 파일과 동일한 디렉토리
로그 파일 제어:
- 기본 동작 (또는
--log on): 로그 파일 생성 + 콘솔 출력 --log off: 로그 파일 생성 안 함, 콘솔에만 출력
로그 파일 예제 (my_reactor.log):
code
[2025-10-06 14:30:15.123] [info] Log file: C:\Results\my_reactor.log
[2025-10-06 14:30:15.124] [info] Config file: my_reactor.json
[2025-10-06 14:30:15.125] [info] Mesh file: nodes.vtu
[2025-10-06 14:30:15.200] [info] SUCCESS: JSON loaded successfully!
[2025-10-06 14:30:15.201] [info] Loaded configuration: 나의 첫 UV 반응기 시뮬레이션
[2025-10-06 14:30:15.202] [info] Lamps: 1
[2025-10-06 14:30:15.203] [info] Bands: 1
[2025-10-06 14:30:16.500] [info] Total nodes: 15000
[2025-10-06 14:30:25.123] [info] Progress: 100.0% (15000/15000) - Computing
[2025-10-06 14:30:25.456] [info] UV Fluence Calculation Completed!