Removal of Content Advisory - April 2024

Advisory to Numerical Weather Prediction (NWP) containers users: As of the beginning of April 2024, all support assets for Numerical Weather Prediction (NWP) containers will be removed from the DTC website. Users should download all reference materials of interest prior to April 2024.

NWP Containers Online Tutorial | Software Containers > GSI data assimilation

The GSI container will be used to perform data assimilation. There are three options for establishing the image from which the software container will be instantiated.  Please follow the appropriate section below that fits your needs.

Option 1: Pull the dtcenter/gsi image from Docker Hub

If you do not want to build the image from scratch, simply use the prebuilt image by pulling it from Docker Hub.

cd ${PROJ_DIR}
docker pull dtcenter/gsi:${PROJ_VERSION}

To see what images you have available on your system, type:

docker images

Option 2: Build the dtcenter/gsi image from scratch

To access the GSI container from the Git repository and build the image from scratch, first go to your project space where you cloned the repository:

cd ${PROJ_DIR}/container-dtc-nwp/components

and then build an image called dtcenter/gsi:

cd gsi ; docker build -t dtcenter/gsi:${PROJ_VERSION} . ; cd ..

This command goes into the gsi directory and reads the Dockerfile directives. Please review the contents of the gsi/Dockerfile for additional information.

To see what images you have available on your system, type:

docker images

OPTION 3: Pull the dtcenter/gsi Docker Hub image and convert it to a Singularity image

If you are using Singularity rather than Docker, the commands are similar:

cd ${PROJ_DIR}
singularity pull docker://dtcenter/gsi:${PROJ_VERSION}

Unlike Docker, Singularity does not keep track of available images in a global environment; images are stored in image files with the .sif extension. Use the `ls` command to see the image file you just downloaded

ls -al *.sif
-rwxr-xr-x 1 ec2-user ec2-user 758505472 Sep 29 20:55 gsi_${PROJ_VERSION}.sif
-rwxr-xr-x 1 ec2-user ec2-user 879349760 Sep 29 20:49 wps_wrf_${PROJ_VERSION}.sif