Find Matchup

Returns satellite level-2 file names and download links for a time and point or region.

Note: This is a python script fd_matchup.py which is included in the OCSSW installation (currently only available for use on the command line).



~/ocssw/scripts$ ./fd_matchup.py -h
usage: fd_matchup.py [-h] -sat
                     {modisa,modist,viirsn,goci,meris,czcs,octs,seawifs}
                     [-data_type {oc,iop,sst}] [-lat_pnt LAT_PNT]
                     [-lon_pnt LON_PNT] [-lat_range_min LAT_RANGE_MIN]
                     [-lat_range_max LAT_RANGE_MAX]
                     [-lon_range_min LON_RANGE_MIN]
                     [-lon_range_max LON_RANGE_MAX] [-time_pnt TIME_PNT]
                     [-time_window TIME_WINDOW]
                     [-time_range_min TIME_RANGE_MIN]
                     [-time_range_max TIME_RANGE_MAX]
                     [-seabass_file SEABASS_FILE] [-get_data GET_DATA]

      This program perform searches of the EarthData Common Metadata Repository (CMR) for satellite
      granule names given an OB.DAAC satellite/instrument, lat/lon/time pair or range

      Outputs:
         1) a list of OB.DAAC L2 satellite file granule names that contain the input criteria, per the CMR records.
         2) a list of public download links to fetch the matching satellite file granules, per the CMR's records.

      Inputs:
        The argument-list is a set of -keyword value pairs.

      Example usage calls:
         fd_matchup.py -sat=modist -lat_pnt=23.0 -lon_pnt=170.0 -time_pnt=2015-11-16T09:00:00Z -time_window=8
         fd_matchup.py -sat=modist -time_range_min=2015-11-15T09:00:00Z -time_range_max=2015-11-17T09:00:00Z -lat_range_min=23.0 -lat_range_max=25.0 -lon_range_min=170.0 -lon_range_max=175.0
         fd_matchup.py -sat=modist -time_window=4 -seabass_file=[your SB file name].sb


optional arguments:
  -h, --help            show this help message and exit
  -sat {modisa,modist,viirsn,goci,meris,czcs,octs,seawifs}
                              String specifier for satellite platform/instrument

                              Valid options are:
                              -----------------
                              modisa  = MODIS on AQUA
                              modist  = MODIS on TERRA
                              viirsn  = VIIRS on NPP
                              meris   = MERIS on ENVISAT
                              goci    = GOCI on COMS
                              czcs    = CZCS on Nimbus-7
                              seawifs = SeaWiFS on OrbView-2
                              octs    = OCTS on ADEOS-I

  -data_type {oc,iop,sst}
                              OPTIONAL: String specifier for satellite data type
                              Default behavior returns all product suites

                              Valid options are:
                              -----------------
                              oc   = Returns OC (ocean color) product suite
                              iop  = Returns IOP (inherent optical properties) product suite
                              sst  = Returns SST product suite (including SST4 where applicable)

  -lat_pnt LAT_PNT            Latitude (point) of interest
                              Valid values: (-90,90N)
                              Use with -lon_pnt

  -lon_pnt LON_PNT            Longitude (point) of interest
                              Valid values: (-180,180E)
                              Use with -lat_pnt

  -lat_range_min LAT_RANGE_MIN
                              Minimum latitude (range) for region of interest
                              Valid values: (-90,90N)
                              Use with -lon_range_min, -lon_range_max, -lat_range_max

  -lat_range_max LAT_RANGE_MAX
                              Maximum latitude (range) for region of interest
                              Valid values: (-90,90N)
                              Use with -lon_range_min, -lon_range_max, -lat_range_min

  -lon_range_min LON_RANGE_MIN
                              Minimum longitude (range) for region of interest
                              Valid values: (-180,180E)
                              Use with -lon_range_max, -lat_range_min, -lat_range_max

  -lon_range_max LON_RANGE_MAX
                              Maximum longitude (range) for region of interest
                              Valid values: (-180,180E)
                              Use with -lon_range_min, -lat_range_min, -lat_range_max

  -time_pnt TIME_PNT          Time (point) of interest in UTC
                              Default behavior: returns matches within 90 minutes before and 90 minutes after this given time
                              Valid format: string of the form: yyyy-mm-ddThh:mm:ssZ
                              OPTIONALLY: Use with -time_window

  -time_window TIME_WINDOW
                              Hour time window about given time(s)
                              OPTIONAL: default value 3 hours (i.e. - 90 minutes before and 90 minutes after given time)
                              Valid values: integer hours (1-11)
                              Use with -seabass_file OR -time_pnt

  -time_range_min TIME_RANGE_MIN
                              Minimum time (range) of interest in UTC
                              Valid format: string of the form: yyyy-mm-ddThh:mm:ssZ
                              Use with -time_range_max

  -time_range_max TIME_RANGE_MAX
                              Maximum time (range) of interest in UTC
                              Valid format: string of the form: yyyy-mm-ddThh:mm:ssZ
                              Use with -time_range_min

  -seabass_file SEABASS_FILE
                              Valid SeaBASS file name
                              File must contain lat,lon,date,time as /field entries OR
                              lat,lon,year,month,day,hour,minute,second as /field entries.