Community코딩 & 개발github.com

openfoam-simulation

오픈소스 OpenFOAM 유한체적 시뮬레이션을 실행합니다. 사용자가 일반 언어로 기하학, 유체 및 작동 조건을 설명하면, 이를 검증된 케이스 파일로 변환하고 명령줄에서 OpenFOAM 케이스를 빌드 및 실행한 후 벽 토크를 물리적 결과(예: Couette 유동 곡선)로 변환합니다.

openfoam-simulation란 무엇인가요?

이 스킬은 ESI/OpenCFD의 오픈소스 CFD 표준인 OpenFOAM을 활용하여 Couette rheometer, 채널, 교반 탱크 등 무료 라이선스 CFD 시뮬레이션을 수행합니다. M-Star나 Palabos와 같은 격자 볼츠만 코드가 아닌, Navier-Stokes 방정식을 메시 기반으로 풀며 Newtonian, power-law, Herschel-Bulkley, Bird-Carreau, Cross, Casson 점도 모델을 내장하고 있습니다. 토크 계산을 위해 `forces` functionObject를 사용하고, 정상상태(`simpleFoam`) 및 과도상태(`pimpleFoam`) 솔버를 지원합니다. 이 스킬은 논의 → 케이스 파일 → 실행 → 보고서 워크플로우를 따르며, 무료 라이선스로 명령줄 기반의 사전 파일 작성을 통해 시뮬레이션을 수행합니다. 예제로 Couette 유동을 통해 Newtonian 검증(오차 0.03%)을 완료했으며, 사용자와의 협의를 통해 시뮬레이션 조건을 명확히 하고 검증 게이트를 통과한 후에만 고급 모델로 진행합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/marcocaggioni/openfoam-skill/tree/HEAD/.github/skills/openfoam-simulation

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

OpenFOAM 시뮬레이션

OpenFOAM(openfoam.com, ESI/OpenCFD)은 유한체적 CFD를 위한 오픈소스 표준이며, GPL, C++, MPI 기반입니다. M-Star 또는 Palabos와 같은 격자 볼츠만 코드가 아닙니다: 메시 상에서 Navier-Stokes 방정식을 풀며, 내장 점도 모델(Newtonian, power-law, Herschel-Bulkley, Bird-Carreau, Cross, Casson), rotatingWallVelocity 경계 조건, 정상상태(simpleFoam) 및 과도상태(pimpleFoam) 솔버를 제공합니다. 토크는 forces functionObject로부터 계산됩니다. 이 스킬은 비공개 mstar-skill 저장소의 mstar-simulation 스킬과 palabos-simulation의 오픈소스 대응물입니다: 동일한 논의 → 케이스 → 실행 → 보고서 워크플로우, 동일한 Couette 예제, 다른 솔버 — 라이선스 시트가 없고, GUI가 없으며, .msb 파일이 없습니다. 대신 사전 파일을 작성하고 명령줄에서 솔버를 실행합니다.

순서대로의 워크플로우

1. 논의 (영어)     -> 어떤 유체, 어떤 기하학, 무엇을 측정할 것인가?
2. case.yaml 작성     -> 모든 숫자를 단위와 함께 하나의 파일에 기록합니다. 사용자에게 보여주고 승인을 받습니다.
3. 메시 생성            -> blockMeshDict: Couette용 쐐기 섹터. checkMesh로 확인합니다.
4. 케이스 빌드        -> 템플릿을 복사하고 Omega를 대체합니다. GUI가 없습니다.
5. 스위프 / 실행          -> 전단율당 하나의 simpleFoam 실행, 실행당 토크 CSV
6. 후처리          -> 토크 -> 응력, 오메가 -> 전단율, 유동 곡선 + 검증
7. 보고서                -> 플롯 + CSV + 가정된 사항, 확인된 사항, 검증되지 않은 사항

2단계를 절대 건너뛰지 마십시오. M-Star 및 Palabos 스킬과 동일한 규칙: 전단율 범위, 유체 모델 또는 기하학이 확인되지 않은 시뮬레이션은 낭비입니다. 사용자가 숫자를 명시하지 않았다면 물어보십시오 — 직접 숫자를 만들어 사전에 숨기지 마십시오. 예제의 기본값은 default:로 표시되며 반드시 확인되어야 합니다.

여기서 실행은 무료입니다 (라이선스 시트 없음), 하지만 여전히 공짜는 아닙니다: 미세 해상도의 3D 실행은 실제 CPU 시간이 소요됩니다. 기본적으로 저렴한 첫 실행(거친 메시, 하나의 전단율)을 수행한 후에만 스위프합니다.

1. 논의 — 무엇을 이끌어낼 것인가

M-Star 스킬과 동일한 체크리스트에 OpenFOAM 특화 항목을 추가합니다:

기하학

  • 내부(회전) 반경 R_i, 외부(고정) 반경 R_o, 침지 길이 L. 미터 단위.
  • 첫 번째 버전은 전체 환형이 아닌 쐐기 섹터입니다. OpenFOAM은 3D 유한체적이므로 Couette 셀은 얇은 쐐기(4°, 축은 X 방향, 1 mm 축 방향 슬라이스, 축 방향 1 셀)로 모델링되며, 두 섹터 면은 wedge 패치, 두 축 방향 면은 empty 패치를 사용합니다. 쐐기 경계 조건은 해를 축대칭으로 만듭니다: Taylor 소용돌이, 끝 효과 없음 — 해석적 토크가 가정하는 이상적인 무한 길이 Couette 셀과 정확히 일치합니다. 어떤 것을 실행 중인지 명시하십시오. 전체 3D 환형은 후속 작업입니다: 끝 효과와 임계 Taylor 수 Ta_c ≈ 41.3 이상에서 Taylor 소용돌이가 추가되어 토크가 해석적 층류 값보다 증가하고 검증 게이트를 통과하지 못합니다. 이 경우(η = 1 Pa·s, ρ = 1000 kg/m³) 전체 스위프에서 Re ≤ 1.8 및 Ta ≤ 0.9이므로 전체 환형도 층류를 유지합니다 — 하지만 쐐기가 여전히 더 저렴하고 깨끗한 검증입니다.

유체 — 하나의 유변학을 선택하고 숫자를 기입하십시오

OpenFOAM은 constant/transportProperties에 유변학 드롭다운이 있습니다: transportModel Newtonian;은 검증 케이스이고, HerschelBulkley, BirdCarreau, Casson, powerLaw, CrossPowerLaw는 내장된 generalisedNewtonian 모델입니다. Herschel-Bulkley와 Bird-Carreau는 문서화된 후속 작업이며, 검증 케이스가 아닙니다. 두 가지 함정:

  • transportProperties의 점도는 동점도 nu = η/ρ (m²/s)이며, 동적 점도 η가 아닙니다. η = 1.0 Pa·s 및 ρ = 1000 kg/m³의 경우 nu = 1e-03입니다 — 1e-06(물의 값, η = 1e-3 Pa·s)이 아닙니다. 이 저장소의 초기 초안은 1e-06을 사용했으며 토크가 정확히 1000배 작게 나온 반면 속도 프로파일은 올바르게 보였습니다 — Newtonian Couette 프로파일은 점도와 무관하므로 프로파일은 이 실수를 잡아내지 못합니다. 토크는 잡아냅니다.
  • 비뉴턴 계수도 동점도입니다(nu0 = η0/ρ, k = K/ρ); 항복 응력 tau0은 Pa 단위입니다. 비뉴턴 실행을 신뢰하기 전에 모델 소스와 대조하여 확인하십시오. 사용자가 실제 재료를 명명한 경우 매개변수를 직접 만들지 마십시오: 측정된 유동 곡선, rheofit 피팅 또는 문헌 값을 요청하거나 Newtonian으로 시작하십시오.

작동 조건 — 스위프

  • 전단율 범위 및 간격, 예: 0.1 → 100 s⁻¹, 로그 간격.
  • 메시 해상도: 간격을 가로지르는 셀 수(기본 40, 즉 dx = 0.125 mm). 더 많은 셀 = 더 정확한 벽 전단, 훨씬 높은 비용.
  • 실행 길이: simpleFoam은 초 단위가 아닌 반복 횟수로 실행됩니다. endTime 3000 with residualControl 1e-8 — 솔버는 수렴 시 조기 중지됩니다(γ̇ = 10은 ~2050 반복, ~2초에 수렴). 토크 평균을 위한 정상 창은 moment.dat 샘플의 마지막 20%입니다.

측정 대상

  • Couette: 회전 보브의 토크 → 전단 응력, 회전 속도 → 전단율. 유동 곡선. 실행 전에 결과 파일 이름(postProcessing/forces/0/moment.dat, forces functionObject에 의해 작성됨)을 명시하십시오.

2. case.yaml 작성

시뮬레이션당 하나의 파일, examples/<name>/case.yaml에 위치합니다. 이것은 계약입니다: 스크립트가 이 파일을 읽고, 채팅에서 숫자를 다시 유도하지 않습니다. 템플릿: examples/couette/case.yaml. 사용자에게 보여주고 빌드 전에 승인을 받으십시오.

3. 메시 — M-Star가 숨기는 단계

OpenFOAM은 메시가 필요하며, 여기서는 system/blockMeshDict에서 blockMesh로 빌드합니다. Couette 메시는 단일 육각 블록입니다:

축 = X (원통 축), 방사형 = Y, 쐐기는 Y-Z 평면에서 열림
쐐기 각도 총 4도(OpenFOAM은 < 5도 필요), 반각 2도
축 방향 범위 x = 0..0.001 m, 하나의 셀(축 방향 변화 없음)
방사형: 5 mm 간격을 가로질러 40개 셀, simpleGrading (1 1 1)
패치: innerWall, outerWall, back/front (유형 wedge),
         left/right (유형 empty)

checkMesh로 해결 전에 확인하십시오: Mesh OK., 쐐기 각도 2° per side, 비직교성 0을 보고해야 합니다. 하나의 메시에서 empty + wedge 조합은 v2412에서 허용됩니다(여기서 확인됨); 향후 버전에서 거부하면 축 방향 면을 symmetry로 전환하십시오.

토크 스케일링: 섹터는 60 mm 원통의 1 mm 슬라이스 중 4° 조각이므로,

T_full = M_x(sector) * (360/4) * (0.060/0.001) = M_x * 5400

여기서 M_x는 innerWall의 forces functionObject에서 X축에 대한 모멘트입니다(CofR은 원점, 축 위). 부호는 음수입니다(유체 항력이 회전을 반대함); 구동 토크는 크기입니다.

4. 케이스 빌드

OpenFOAM은 라이브러리가 아닌 애플리케이션 세트입니다: 사전 파일을 작성하고 실행합니다. 저장소 레이아웃:

bash scripts/install-openfoam.sh   # 공식 Debian 저장소, v2412
source /usr/lib/openfoam/openfoam2412/etc/bashrc
bash scripts/check-setup.sh        # simpleFoam, blockMesh, checkMesh, uv
./run-couette.sh                   # 드라이런: 메시 빌드 + checkMesh만

couette_build.py는 템플릿(examples/couette/case/)을 실행 디렉토리로 복사하고 0/U의 __OMEGA__를 전단율에 대한 각속도로 대체합니다:

Omega = gamma * (Ro^2 - Ri^2) / (2 * Ro^2)

경계 조건(v2412 튜토리얼에 대해 확인됨):

  • innerWall: rotatingWallVelocity, axis (1 0 0), omega constant <Omega> (rad/s), origin (0 0 0). 패턴: climbingRod 튜토리얼의 rotatingWallVelocity.
  • outerWall: noSlip.
  • back/front: wedge; left/right: empty.
  • 압력: 두 벽 모두 fixedFluxPressure(전체 벽 케이스).
  • constant/transportProperties: transportModel Newtonian; nu 1e-03; (§1 참조 — 동점도, 동적 아님).
  • constant/turbulenceProperties: simulationType laminar;. v2412는 turbulenceProperties를 읽습니다; 최신 버전에서는 이름이 momentumTransport로 변경됨 — 솔버가 다른 이름을 찾을 수 없다고 불평하면 파일과 내부 object의 이름을 변경하십시오.
  • system/fvSolution: SIMPLE with pRefCell 0; pRefValue 0; (필수: 모든 경계가 벽이므로 압력은 참조 셀이 필요합니다 — 없으면 simpleFoam이 "Unable to set reference cell for field p" 오류와 함께 종료됨), p에 GAMG, U에 smoothSolver, residualControl p/U 1e-8.
  • system/controlDict: simpleFoam, endTime 3000 반복, forces functionObject (patches (innerWall), rho rhoInf; rhoInf 1000;, CofR (0 0 0), writeInterval 5). v2412는 force.dat 및 moment.dat (별도 파일)를 작성하며, forces.dat가 아닙니다.

상태: 정상상태 케이스는 이 VM(OpenFOAM v2412, 2026-11-17)에서 실제로 실행되었으며 §6의 Newtonian 검증을 통과합니다(γ̇ = 10에서 해석적 토크 오차 0.03% — examples/couette/RUN_REPORT.md 참조). 과도상태 pimpleFoam 변형(case-transient/, 회전 가속 비디오용)도 실행됩니다: ~2초에 1000단계, 동일한 토크로 수렴.

비뉴턴: transportProperties에서 transportModel을 변경합니다(첫 번째 Herschel-Bulkley, 두 번째 Bird-Carreau). Newtonian 경로를 기본값 및 검증 게이트로 유지하십시오 — 검증되지 않은 기하학에서 비뉴턴 모델을 디버깅하지 마십시오.

5. 실행

./run-couette.sh --run           # 전단율당 한 번 실행, examples/couette/runs/에 저장
# 또는, 지점별:
python3 couette_build.py --gamma 10 --out runs/gamma_10
cd runs/gamma_10 && blockMesh && simpleFoam

각 실행은 torque.csv(반복, 섹터 모멘트, 전체 원통 토크)와 run_info.json(수렴 플래그, 반복 횟수, 벽 시간)을 작성합니다. 실행이 느리면 먼저 메시 또는 실행 시간을 개선하십시오 — 빠르게 만들기 위해 기하학을 조용히 변경하지 마십시오. Uz 잔차가 1e-7 아래로 떨어지지 않고 endTime에 도달한 실행은 converged: false로 표시됩니다 — 신뢰하기 전에 진단하십시오(메시, 경계 조건, 이완).

6. 후처리 — 토크에서 유동 곡선으로 (Couette)

M-Star 및 Palabos 스킬과 동일한 변환:

내부 벽에서의 전단율:  gamma_i = 2*Omega*Ro^2 / (Ro^2 - Ri^2)
내부 벽에서의 전단 응력: tau_i  = T / (2*pi*Ri^2*L)
겉보기 점도:             eta_app = tau_i / gamma_i

case.yaml에 지정된 정상 창(샘플의 마지막 20%)에 걸쳐 토크를 평균화하고, 표준 편차를 정상성 확인으로 보고합니다.

검증 게이트 (새 기하학의 첫 번째 실행에 필수). 먼저 알려진 eta의 Newtonian 유체로 실행하고 해석적 Couette 토크와 비교하십시오:

T_analytic = 4*pi*L*eta*Omega*Ri^2*Ro^2 / (Ro^2 - Ri^2)

시뮬레이션된 토크가 약 10% 이상 차이가 나면 비뉴턴 유동 곡선으로 진행하지 마십시오. 중단하고 진단하십시오: 간격을 가로지르는 메시 해상도, nu (동점도 vs 동적 — §1 참조), 실행 시간/수렴, 회전 벽 경계, 토크 스케일링. 검증 번호를 보고서에 기록하십시오. couette_post.py는 이 게이트를 강제하며 실패 시 0이 아닌 종료 코드를 반환합니다.

그런 다음 각 스위프 지점은 하나의 (gamma_i, tau_i) 지점을 제공합니다. tau vs gamma(로그-로그)와 eta_app vs gamma를 플롯하고 flow_curve.csv를 작성하며 — 사용자가 매개변수를 원하는 경우 — 별도 단계에서 rheofit(Herschel-Bulkley, Carreau, …)으로 곡선을 피팅합니다.

7. 보고서

실행당 제공: case.yaml (실행된 그대로), flow_curve.csv, flow_curve.png, 그리고 기하학(쐐기 섹터, 각도, 간격을 가로지르는 셀 수), 유체, 스위프, 검증 결과, 정상 상태 기준, 그리고 검증되지 않은 모든 것을 명시하는 짧은 메모. 실행이 실패한 경우, 솔버 로그의 꼬리를 보고하십시오 — 곡선에서 지점을 조용히 제거하지 마십시오.

GitHub Copilot CLI로 세션 시작하기

mstar-skill 및 palabos-skill과 동일한 설정: Copilot CLI는 .github/skills/에서 프로젝트 스킬을 발견하며, 이 스킬도 거기에 미러링됩니다. 저장소 루트에서:

git clone https://github.com/marcocaggioni/openfoam-skill.git
cd openfoam-skill
bash scripts/install-openfoam.sh
bash scripts/check-setup.sh
copilot

그런 다음 /skills list ( openfoam-simulation이 보여야 합니다), 그리고:

/openfoam-simulation run the Couette example in examples/couette/case.yaml

이 스킬은 의도적으로 allowed-tools frontmatter가 없습니다: Copilot은 셸 명령을 실행하기 전에, 특히 긴 솔버 실행 전에 물어봐야 합니다. 세션 중에 스킬이 추가된 경우 먼저 /skills reload를 실행하십시오.

이 스킬이 하지 않는 일

  • scripts/install-openfoam.sh의 스크립트화된 apt 경로 외에는 OpenFOAM을 설치하지 않습니다: Debian/Ubuntu 머신과 sudo가 필요합니다.
  • 설치된 OpenFOAM에 대해 실행되고 Newtonian 검증을 통과하기 전까지 케이스가 검증되었다고 주장하지 않습니다.
  • 탱크, 임펠러, 다상 또는 입자 부유 유동에 대해 M-Star를 대체하지 않습니다 — 이러한 것은 v0.1 범위 밖입니다. 이 저장소는 공개적으로 수행된 Couette 유동 곡선으로, 개방형 유한체적 경로가 작동한다는 첫 번째 증거입니다.

이 저장소의 파일

  • skills/openfoam-simulation/SKILL.md — 이 파일. .github/skills/openfoam-simulation/SKILL.md(GitHub Copilot CLI가 발견하는 사본)에 바이트 단위로 미러링됩니다. 두 사본을 동기화 상태로 유지하십시오 — 동일한 커밋에서 둘 다 편집하십시오.
  • docs/openfoam-guide.md — 설치, 메시, 경계 조건, 비뉴턴 참고 사항, 한계.
  • examples/couette/ — 작업된 Couette 예제: case.yaml, case/ (정상 simpleFoam 템플릿), case-transient/ (pimpleFoam 회전 가속 템플릿), couette_build.py, couette_sweep.py, couette_post.py, make_video.py, README.md.
  • OpenFOAM 자체: https://www.openfoam.com (GPL)

관련 스킬