2. Download

This section provides directions to download the ECCO V4r2 model output for analysis (Section 2.1), or download the underlying model setup to reproduce ECCO V4r2 (Section 2.2).

2.1. Model Solution

ECCO V4r2 was the first update to the original ECCO V4 solution [FCH+15] with :

  1. additional corrections listed in [FCH+16]

  2. additional model-data misfit and model budget output

  3. easier to rerun than ECCO version 4 release 1

The reference output for ECCO V4r2 is permanently archived in this Dataverse , which provides citable identifiers for the various datasets (see README.pdf). For direct downloads we recommend Dataverse.jl or one of the other Dataverse APIs.

Note

Alternatively, you can also download files from this MIT server. Folders that start with nctiles_ contain model output on the native LLC90 grid in the nctiles format [FCH+15]. This format is easily read in Julia, Python, and Matlab/Octave (see Section 3.1). Interpolated model output, on a \(1/2\times1/2^\circ\) grid in standard NetCDF, are provided in the interp_monthly/ folder. Folders that start with input_ directories contain binary and netcdf input files for MITgcm (Section 4.1). The profiles/ folder contains the MITprof collections of collocated in situ and state estimate profiles [FCH+15].

2.2. Model Setup

Download MITgcm source code and ECCO V4r2 setup from GitHub.

git clone https://github.com/MITgcm/MITgcm
cd MITgcm
git checkout checkpoint68o
cd ..
git clone https://github.com/gaelforget/ECCOv4
mkdir MITgcm/mysetups
mv ECCOv4 MITgcm/mysetups/.

To run ECCO V4r2 requires surface forcing input (96G of 6-hourly fields), initial condition, grid, etc. input (610M), and observational input (25G) from this Dataverse.

Using Julia, we recommend MITgcm.jl via the provided input/download_files.jl (see below): :

cd MITgcm/mysetups/ECCOv4
julia input/download_files.jl

Or directly in the linux terminal (bash), download from the MIT server:

cd MITgcm/mysetups/ECCOv4

export FTPv4r2=engaging-web.mit.edu/~gforget/harbor/version_4/release2
wget --recursive -l1 https://$FTPv4r2/input_init
wget --recursive -l1 https://$FTPv4r2/input_forcing
wget --recursive -l1 https://$FTPv4r2/input_ecco/input_insitu

mkdir input_files
mv $FTPv4r2/input_init/* input_files/.
mv $FTPv4r2/input_forcing input_files/forcing_baseline2
mv $FTPv4r2/input_ecco/input_insitu/* input_files/.

The Recommended Directory Organization is shown below. While organizing the downloaded directories differently is certainly possible, the Section 4.1 instructions to Compile, Link, And Run the model and Verify Results Accuracy are based on this organization.

Recommended Directory Organization

MITgcm/
  model/   (MITgcm core)
  pkg/     (MITgcm modules)
  tools/
    genmake2        (shell script)
    build_options   (compiler options)
  mysetups/         (user created)
    ECCOv4/
      build/                (build directory)
      code/                 (compile-time settings)
      input/                (run-time settings)
      test/                 (reference results)
      input_folder/         (user installed)

Note

Some subdirectories are omitted in this depiction.