PUBLIC INTERFACE ~ PUBLIC ROUTINES ~ NAMELIST

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 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)]
    ntimes_saved
    number of time levels to be saved. Its value has to be less than or equal to the number of time levels in the source data file.
    [integer]
    timelevel_saved
    specify the selection of time levels to be saved. The number of elements to be specified should be equal to ntimes_saved.
    [integer(max_ntimes_saved)]
    debug
    For Debugging. Set true to print out chksum information for debugging reproducing ability accross processors. default is false.
    [logical]

    top