NERSC-HYCOM-CICE Documentation

NERSC-HYCOM-CICE is a coupled ocean–sea ice model developed at the Nansen Environmental and Remote Sensing Center (NERSC). It combines the HYCOM ocean model with the CICE sea ice model, coupled via the Earth System Modeling Framework (ESMF).

Overview

• Model components
• Directory structure

Installation

• Clone the repositories
• Configure ~/.bashrc
• Python environment
  • Set up conda
  • Create the environment
  • Use the environment
  • Update the environment
• HPC environment

Experiment setup

• Set up the work directory
• Configure blkdat.input
• Configure EXPT.src

Compilation

• Compile MSCPROGS (libhycnersc.a)
• BGC dependencies (FABM)
  • Compile FABM (libfabm.a)
• Compile HYCOM-CICE
• Compile hycom_ALL

Forcing Files

• Initial conditions
  • Restart files
• Open boundary forcing
  • Boundary configuration files
  • Nesting files
  • Sponge layers
• Climatologies and river forcing

Running the Model

• Submit a job
• Check results
• Restarting after a crash
• Visualization

Post-processing

• MSCPROGS post-processing tools
  • Running the tools
  • hyc2proj and hyc2stations — projection and interpolation
  • m2nc / m2t — 2D field extraction to NetCDF
  • h2nc (ExtractNC3D) — 3D field extraction to NetCDF
  • hycave — temporal averaging
  • m2section, m2transport, m2transport2 — section transports
  • icedrift2 — Lagrangian ice drift
  • nestbat — nesting bathymetry
  • Tides_FES2014 — tidal forcing from FES atlas
  • Other tools
  • Post-processing runs from NIRD
  • Input files
• xhycom post-processing tools

Development

• Contributor Guide
  • Building the documentation locally