Using the Binary Forcing Regridding Utility

Overview

GMAO_Shared has a utility program regrid_forcing_esmf.x that is used to regrid files in the MAPL binary forcing format to a different grid. The MAPL binary forcing format consists of an unformatted file consist of pairs of repeated records consisting of 1 record that is read a size 14 real array that contains the start/end time of the valid range of the data in the next record. The next record is read as a real 1D array that is of the size of the grid or tile, whatever is appropriate for the data.

This utility have be given an input file and an rc file and will regrid it.

Resource File

The program assumes you have a resource file named REGRID_FORCING.rc of which an example can be found in the net section. This is in the standard ESMF config config format.

Example Resource File

INPUT_FILE: merra2_2022.data
OUTPUT_FILE: regridded_sst_2022.data

NX: 1
NY: 1
INPUT_GRIDNAME: PE2880x1440-DE
PE2880x1440-DE.NX: 1
PE2880x1440-DE.NY: 1
PE2880x1440-DE.IM_WORLD: 1440
PE2880x1440-DE.JM_WORLD: 720
PE2880x1440-DE.POLE: 'PE'
PE2880x1440-DE.DATELINE: 'DE'
PE2880x1440-DE.GRID_TYPE: LatLon

OUTPUT_GRIDNAME: PE360x180-DE
PE360x180-DE.GRID_TYPE: LatLon
PE360x180-DE.IM_WORLD: 360
PE360x180-DE.JM_WORLD: 180
PE360x180-DE.POLE: 'PE'
PE360x180-DE.DATELINE: 'DE'
PE360x180-DE.NX: 1
PE360x180-DE.NY: 1

#The next two parameters would only be needed if you wanted a subset of the input file
#START_DATE: 202020101
#END_DATE: 202221231

#This parameter will reset a variable to be between 0 and 1 if it falls outside
#useful for ice fractions if there are floating point round off issues
#ONLY SET THIS TO TRUE IF THE VALUE YOU ARE REGRIDDING IS A FRACTION AND REALLY SHOULD BE CONSTRAINED TO RANGE OF 0 TO 1
FIX_FRACTION: .false.

RUN_DT: 1800