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

Program regrid

Contact:  Zhi Liang
Reviewers: 
Change History: WebCVS Log

OVERVIEW

This program remap data from logically rectangular grid to logically rectangular grid.

This program expects to read data from a netcdf file, which is specfied by the namelist variable "src_data". The number of data to be remapped is specified by num_flds. The name of field to be remapped is specified by the namelist variable "fld_name". The source data should be on the source grid which is specified by namelist variable src_grid. The destination grid is specified by nml dst_grd. The output file is a netcdf file specified by the namelist variable "dst_data". Each field can be a scalar variable or a vector field, which is specified by vector_fld. The vector field should always be paired together. A laplacian extrapolation will be performed when there is any missing value in the source data to interpolate data onto missing points.

MODULES USED

         mpp_mod
 mpp_domains_mod
         fms_mod
      fms_io_mod
   constants_mod
horiz_interp_mod
  axis_utils_mod

PUBLIC INTERFACE


PUBLIC DATA

None.

PUBLIC ROUTINES

    NAMELIST

    &regrid_nml

    num_flds
    Number of fields.
    [integer, default: 0]
    src_data
    Name of input file containing to-be-remapped data.
    [character(len=128)]
    dst_data
    Name of output file containing after-remapped data.
    [character(len=128)]
    dst_grid
    Name of grid descriptor file containing target grid information.
    [character(len=128)]
    src_grid
    Name of grid descriptor file containing source grid information.
    [character(len=128)]
    fld_name
    Name of runoff field in input file.
    [character(len=128), dimension(max_flds)]
    fld_pos
    Name of grid where the field located. Valid choices are (T)racer, (C)orner, (E)ast and (N)orth.
    [character(len=1),dimension(max_flds), default: T]
    vector_field
    True if fields are vector components. All the vector field should be paired together. That is, if vector_field(n) is .true., then vector_field(n+1) should be true.
    [logical,dimension(max_flds), default: False]
    stop_crit
    The stopping criteria when extrapping data onto missing points.
    [character(len=1),dimension(max_flds), default: 0.001]
    num_nbrs
    Number of nearest neighbors for regridding.
    [integer]
    max_dist
    Maximum region of influence around destination grid points.
    [real, units: radians]
    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". Since bilinear interpolation suppose the source grid is a lat-lon grid, "spherical" need to be used if the source grid is not a lat-lon grid.
    [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