hannahwoodward / docker-rocke3d

ROCKE-3D Docker Image

ROCKE-3D Docker Image

Docker/Podman image to install and run a containerised ROCKE-3D on Fedora.

Useful links

• ROCKE-3D Model Description (doi:10.3847/1538-4365/aa7a06)
• ROCKE-3D Webpage
• ROCKE-3D Compilers & libraries
• ROCKE-3D Installation
• ROCKE-3D Tutorial Videos
• ROCKE-3D Publication Supplements (inc rundecks)
• Docker build help
• Docker run help

Installation & running via published image

• Install Docker desktop
• Ensure Docker desktop is running
• Download published image:

docker pull woodwardsh/rocke3d:latest

• Navigate to chosen directory for storing model input and output using cd
• Ensure model input/output folders have been created:

mkdir -p exec huge_space prod_decks prod_input_files prod_runs

Docker

• Run container, noting the mounting of local current working directory (${PWD}) to container path /home/app/ModelE_Support for shared storage of model input/output:

docker run -itd --volume=${PWD}:/home/app/ModelE_Support woodwardsh/rocke3d:latest

Podman

• Run container, noting the mounting of local current working directory (${PWD}) to container path /home/app/ModelE_Support for shared storage of model input/output, and note additional options to fix permissions on mounted volumes (see podman run):

podman run -itd -v ${PWD}/ModelE_Support:/home/app/ModelE_Support --security-opt label=disable woodwardsh/rocke3d:latest

Notes on docker/podman options

• -itd: interactive & TTY (starts shell inside container) & detached
• -v: mount local directory inside container

Installation & running via locally built image

• Clone repo & navigate inside:

git clone [email protected]:hannahwoodward/docker-rocke3d.git && cd docker-rocke3d

Docker

• Build image from Dockerfile (~15 min):

docker build -t rocke3d .

• Or, if debugging:

docker build -t rocke3d . --progress=plain --no-cache

• Navigate to chosen directory for storing model input and output using cd
• Ensure model input/output folders have been created:

mkdir -p exec huge_space prod_decks prod_input_files prod_runs

• Run locally built container:

docker run -itd -v ${PWD}/ModelE_Support:/home/app/ModelE_Support rocke3d

Podman

• Build with similar command, replacing docker with podman:

podman build -t rocke3d .

• Navigate to chosen directory for storing model input and output using cd
• Ensure model input/output folders have been created:

mkdir -p exec huge_space prod_decks prod_input_files prod_runs

• Start container from image, with additional options to fix permissions on mounted volumes (see podman run):

podman run -itd -v ${PWD}/ModelE_Support:/home/app/ModelE_Support --security-opt label=disable rocke3d

Testing

• Start container
• Run sh test-earth.sh (output written to ModelE_Support/huge_space/E1oM20_Test)
• Run sh test-planet.sh (uses SOCRATES; output written to ModelE_Support/huge_space/P1SoM40_Test)

Diagnostics & Post-processing

• ROCKE-3D Diagnostics info
• The following directories have been added to $PATH, which contain scripts to generate readable netcdf model outputs. Use both in model output directories (i.e. ModelE_Support/huge_space/<simulation_name>:
  • $HOME/$MODELDIR/model/mk_diags:
    • scaleacc for interim/accumulative source files (e.g. PARTIAL.acc$RUN_ID.nc aij)
    • sumfiles to combine multiple acc files across different time periods
    • Documention can be found in $MODELDIR/model/mk_diags/conventions.txt
  • $HOME/bin:
    • scaleaccm the multifile equivalent of scaleacc, usage e.g. scaleaccm "ANN*.acc*.nc" aij

Publishing image

docker login && docker tag rocke3d woodwardsh/rocke3d && docker push woodwardsh/rocke3d

Model info

• Create a rundeck P2{G,S}{A,x,N}{p,q,o}{F,M}40
  • GISS/SOCRATES radiation
  • Atmosphere of PI Earth Ocean {p,q,o}
  • M40 4degx5deg with 40 layers in atmosphere, 13 layers in ocean
• Rundeck start/stop times:
  • YEAR is just an index, MONTH always 1 to 12, HOUR always 0 to 23
    • Calendar system used divides days into 24 model "hours" and years into 12 "months", so with varying orbital/rotation periods will therefore not generally be 3600s or 720hrs, respectively
  • ISTART=2 way to tell the model that initial conditions will be provided (AIC atmosphere, ground GIC, and if relevant ocean OIC)
  • IRANDI=X random number generation seed/adding numerical noise, used for cloud generation
  • master_yr=1850 tells model to use Earth greenhouse gas concentrations
  • master_yr=0 runs a transient simulation
• For non-Earth continental configurations:
  • Ensure land mass added at south pole to prevent grid singularity issues
  • Update OCNDYN.f#L5812: J1O=1 (or whatever latitude south pole landmass ends at, default J1O=4, default in image J1O=1)

docker-rocke3d's Issues

Update README to include ModelE_Support subdirectories creation

Set bottom ocean latitude to 1

Change OCNDYN.f#L5812: J10=4 to J10=1

Add example decks (land, continents, aqua)

Automatically copy over SEAICE_DRVLOWTEMP.f and ATMDYN_HIGHLOWTEMP.f

dest: $HOME/$MODELDIR/model/

Update README for detached container