Ramses Quickstart

이 챕터에서는 아무것도 설치되어 있지 않은 상태에서 시작해, Conda 가상환경 기반으로 RAMSES 1D hydro 테스트를 빌드하고 실행해 봅니다.

목표 체크리스트

• OS에 맞게 Conda(Miniforge)를 설치합니다.
• ramses-lab 가상환경에서 Fortran 빌드 도구를 준비합니다.
• ramses1d를 빌드하고 tube1d.nml을 실행합니다.

Installation

Windows (WSL2)

0) WSL2 + Ubuntu 설치/검증

먼저 PowerShell/Windows Terminal을 관리자 권한으로 실행하세요.

wsl --install -d Ubuntu
wsl --set-default-version 2
wsl -l -v

wsl --install이 도움말만 출력되면 아래를 실행하세요.

wsl --list --online
wsl --install -d Ubuntu

설치가 0.0%에서 멈추면 아래를 시도하세요.

wsl --install --web-download -d Ubuntu

재부팅 후 Ubuntu를 열어 Linux 사용자 계정을 만든 뒤 설치를 계속하세요.

1) Miniforge 설치 (Ubuntu 터미널)

sudo apt update
sudo apt install -y curl bzip2

curl -L -o ~/miniforge.sh \
  "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-$(uname -m).sh"
bash ~/miniforge.sh -b -p "$HOME/miniforge3"

source "$HOME/miniforge3/etc/profile.d/conda.sh"
conda init bash

macOS

0) Miniforge 설치

xcode-select --install

curl -L -o ~/miniforge.sh \
  https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-MacOSX-$(uname -m).sh
bash ~/miniforge.sh -b -p "$HOME/miniforge3"

source "$HOME/miniforge3/etc/profile.d/conda.sh"
conda init zsh

Linux (Ubuntu)

0) Miniforge 설치

sudo apt update
sudo apt install -y curl bzip2

curl -L -o ~/miniforge.sh \
  "https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-$(uname -m).sh"
bash ~/miniforge.sh -b -p "$HOME/miniforge3"

source "$HOME/miniforge3/etc/profile.d/conda.sh"
conda init bash

1) ramses-lab 가상환경 생성

conda create -n ramses-lab -c conda-forge \
  python=3.11 compilers make cmake git -y

conda activate ramses-lab
which gfortran
echo "$CONDA_PREFIX"

처음에는 1D 테스트부터

RAMSES는 기능이 많기 때문에, 1D hydro 테스트를 먼저 성공시킨 뒤 고급 모듈을 추가하는 것이 안전합니다.

나중에 MPI/HDF5 빌드가 필요하면 아래를 추가 설치하세요.

conda install -c conda-forge openmpi mpi4py hdf5 -y
which mpif90

2) 소스 코드 받기

cd ~
git clone https://github.com/ramses-organisation/ramses.git
cd ramses

3) bin/Makefile 최소 설정

cd bin

Makefile에서 아래를 확인/수정하세요.

• 첫 1D 테스트에서는 기본 직렬 설정(FFLAGS의 -DWITHOUTMPI)을 유지해도 됩니다.
• 1D 테스트 설정: NDIM=1, SOLVER=hydro, NVAR=3

MPI 병렬 실행으로 확장할 때는 F90 = mpif90로 바꾸고 FFLAGS에서 -DWITHOUTMPI를 제거하세요.

4) 빌드

make clean
make

빌드가 완료되면 bin/ramses1d가 생성됩니다.

5) 1D 테스트 실행

cd ..
bin/ramses1d namelist/tube1d.nml

로그 파일로 저장하려면:

bin/ramses1d namelist/tube1d.nml > tube.log

6) 빠른 검증

• 실행 출력이 정상 진행되고 마지막에 Run completed가 나타납니다.
• 출력 파일이 생성됩니다.
• 런타임 라이브러리 오류가 없으면 환경 검증이 완료된 것입니다.

공식 빌드 참조

• RAMSES docs: Getting started
• RAMSES docs root