PUBLIC INTERFACE ~ PUBLIC DATA ~ PUBLIC ROUTINES ~ NAMELIST ~ DIAGNOSTIC FIELDS ~ ERROR MESSAGES ~ REFERENCES ~ NOTES

Program regrid_3d

Contact: Bonnie Samuels ,  Zhi Liang
Reviewers: M.J. Harrison
Change History: WebCVS Log

OVERVIEW

regrid 3-d lat-lon gridded data to logically rectangular grid described by grid descriptor file. Applies only to scalar fields No missing points allowed on input grid.


MODULES USED

         mpp_mod
      mpp_io_mod
 mpp_domains_mod
horiz_interp_mod
  axis_utils_mod
         fms_mod
   constants_mod

PUBLIC INTERFACE


PUBLIC DATA

None.

PUBLIC ROUTINES

    NAMELIST

    &regrid_3d_nml

    src_file
    Name of input file containing grid and data to be regridded.
    [character(len=128), default: src_file.nc]
    numfields
    Number of fields.
    [integer, default: 2]
    src_field_name
    Name of input field(s). default is (/'temp', 'salt'/)
    [character(len=128), dimension(max_fields)]
    dest_field_name
    Name of output field(s). If it is not specified in the namelist, it will get the value from src_field_name
    [character(len=128), dimension(max_fields)]
    dest_grid
    Name of grid descriptor file containing target grid information.
    [character(len=128), default: dest_grid.nc]
    dest_file
    Name of output file.
    [character(len=128), default: dest_file.nc]
    num_nbrs
    Number of nearest neighbors for regridding
    [integer, default: 10]
    max_dist
    Maximum radial influence for regridding.
    [integer, units: radians, default: 0.17]
    scale_factor
    scaling factor for data (e.g. -1 to flip sign or 0.01 to convert from centimeters)
    [real ]
    stop_crit
    The stopping criteria when extrapping data onto missing points.
    [character(len=1),dimension(2), default: 0.001]
    use_source_vertical_grid
    when use_source_vertical_grid is set to true, the destination data will have the same vertical level as the source data. When use_source_vertical_grid is false, the vertical grid of destination data will come from dest_grid. A linear vertical interpolation will be done when the source vertical is different from destination vertical grid.
    [logical, default: .false.]
    apply_mask
    flag to indicate if the land/sea mask of source/destination grid will be applied on the output dest_file. When apply_mask is false, the destination data will be global data, i.e. no missing value in the destination data file. When apply_mask is true, mask will be applied to the destination data. The mask can be either source grid or destination grid determined by nml use_source_vertical_grid. When use_source_vertical_grid is true, source grid mask will be applied, otherwise destination grid mask will be applied.
    [logical, default: true]
    interp_method
    specifying the remapping method when remampping data onto current grid. Its value can be "spherical" or " bilinear". "spherical" interpolation is a inverse distance weighted interpolation algorithm. Default value is "bilinear". "bilinear" interpolation is recommanded, since bilinear interpolation will provide more smooth results than "spherical" interpolation (especially when interpolating from coarse grid to fine grid). Plus bilinear interpolation is much more efficiency than "spherical interpolation".
    [character(len=20)]
    debug
    For Debugging. Set true to print out chksum information for debugging reproducing ability accross processors. default is false.
    [logical]

    DATA SETS

    None.

    ERROR MESSAGES

    None.

    top