CLI 시작 가이드
최종 수정: 2026-11-17 읽기 약 4분
대상 소프트웨어 버전: UVSim3D 4.0.0
명령줄 계산기(CLI)는 반복 계산, 스크립트 자동화 또는 외부 격자의 계산점에 대한 결과 산출에 사용할 수 있는 선택 도구입니다. 일반적인 배치 설계는 시작 가이드에서 안내하는 데스크톱 프로그램으로 진행합니다.
실행 준비
사용 중인 운영체제에 맞는 UVSim3DSolver 배포본을 준비하고 실행 파일 위치를 확인합니다.
CLI 계산기는 GUI와 별도의 실행 파일입니다. 파일 이름은 정밀도 구성에 따라
UVSim3DSolver_fp64, UVSim3DSolver_mixed, UVSim3DSolver_fp32이며 Windows에서는 .exe가 붙습니다.
아래 예제는 UVSim3DSolver_fp64를 사용하며 실행 파일이 PATH에 등록되어 있다고 가정합니다.
bash
UVSim3DSolver_fp64 --helpCLI에는 계산 조건 JSON과 계산점 또는 외부 격자 파일을 전달합니다.
GUI의 .uvsim 프로젝트나 **Export Project JSON…**으로 내보낸 파일과 CLI 계산 조건 JSON은 서로 다른 형식입니다.
CLI 입력 구조는 CLI 설정 파일을 참조하십시오.
빠른 시작 튜토리얼
1단계: 메쉬 파일 준비
계산 포인트(x, y, z 좌표, 단위: 미터)가 포함된 간단한 텍스트 파일 nodes.txt 생성:
code
0.0, 0.0, 0.1
0.0, 0.0, 0.2
0.0, 0.0, 0.3또는 VTU/VTKHDF/CGNS 형식의 CFD 메쉬 사용 가능.
2단계: 설정 파일 생성
my_reactor.json 파일 생성 (JSON v3.0 형식):
json
{
"version": "3.0",
"title": "나의 첫 UV 반응기 시뮬레이션",
"description": "단일 LP 램프 반응기",
"id": "reactor_001",
"reactorConfig": {
"lampSpecs": [
{
"id": "LP150W",
"lampType": "lp",
"description": "150W LP 램프",
"power": 150.0,
"eta": 0.35,
"arcLength": 0.8,
"diameter": 0.015,
"sleeveDia": 0.025,
"sleeveThickness": 0.002,
"uvBands": [
{
"lambda": 254,
"waterRI": 1.33,
"waterUVT": 0.95,
"relativeEnergy": 1.0,
"sleeveRI": 1.5,
"sleeveUVT": 0.90,
"gef": 1.0
}
]
}
],
"lampLayout": [
{
"lampId": "LP150W",
"dimming": 1.0,
"position": [0.0, 0.0, 0.0],
"direction": [0.0, 0.0, 1.0]
}
]
},
"solverConfig": {
"radiationModel": "msss",
"rootFindingMethod": "brents",
"enableShadowing": false,
"numThreads": 0,
"relativeTolerance": 1.0e-5,
"lampSegmentation": 1000,
"maxIteration": 50
}
}3단계: 시뮬레이션 실행
bash
UVSim3DSolver_fp64 --config my_reactor.json --mesh nodes.txt --output results.txt4단계: 결과 확인
출력 파일 results.txt 확인:
code
# UVSim3D Results
# nodes: 3, bands: 1
# x, y, z, band1, lamda = 254nm
0.000000, 0.000000, 0.100000, 125.456
0.000000, 0.000000, 0.200000, 98.234
0.000000, 0.000000, 0.300000, 76.891마지막 열은 각 포인트에서의 UV 조사율(W/m²)을 나타냅니다.