njtbx-icon
Netcdf-Java Toolbox
previous Function nj_info
Function nj_time Next

 
 
Function nj_subsetGrid

PURPOSE ^

NJ_SUBSETGRID: Subset grid based on lat-lon bounding box and time

SYNOPSIS ^

function [data,grd]=nj_subsetGrid(ncRef,var,lonLatRange,dn1,dn2)

DESCRIPTION ^

NJ_SUBSETGRID: Subset grid based on lat-lon bounding box and time

 Usage:
   [data, grd]=nj_subsetGrid(uri,var,[lonLatRange], dn1, dn2);
 where,
   ncRef - Reference to netcdf file. It can be either of two
           a. local file name or a URL  or
           b. An 'mDataset' matlab object, which is the reference to already
              open netcdf file.
              [ncRef=mDataset(uri)]

  var - variable to subset
  lonLatRange - [minLon maxLon minLat maxLat]  % matlab 'axes' function      
  dn1 - Matlab datenum, datestr or datevec  ex: [1990 4 5 0 0 0] or '5-Apr-1990 00:00'        
  dn2 - Matlab datenum, datestr or datevec (optional)  

 Returns,
   data - subset data  based on lonlat and time range
   grd - structure containing lon,lat

  e.g,
   ncRef='http://www.gri.msstate.edu/rsearch_data/nopp/bora_feb.nc';
   var = 'temp';
   lonLatRange = [13.0 16.0 41.0 42.0];   [minlon maxlon minlat maxlat]
   dn1 = '14-Feb-2003 12:00:00';
   dn2 = [2003 2 16 14 0 0];
   [data, grd]=nj_subsetGrid(ncRef,var,lonLatRange,dn1, dn2)     or
   [data, grd]=nj_subsetGrid(ncRef,var,lonLatRange,dn1)          or
   [data, grd]=nj_subsetGrid(ncRef,var,lonLatRange)              or
   [data, grd]=nj_subsetGrid(ncRef,var) 

CROSS-REFERENCE INFORMATION ^

This function makes following njTBX API calls:
  • mDataset mDataset class constructor - opens a netcdf file and creates a grid or netcdf mDataset object.
  • getGeoGridVar mDataset/getGeoGridVar - Get variable into a GeoGrid if it has a Georeferencing coordinate system.

See demos using function nj_subsetGrid:
  • bathy_comp BATHY_COMP - plot comparison between two bathymetry datasets


previous Function nj_info
Function nj_time Next
© 2006-2009   Mississippi State University   • License Terms   • Credits