Find Matchup |

Returns satellite level-2 file names and download links for a time and point or region.
Note: This is a python script find_matchup which is included in the OCSSW installation (currently only available for use on the command line).

    ~/ocssw/bin$ ./find_matchup -h
    usage: find_matchup [-h] --sat {modisa,modist,viirsn,viirsj1,goci,meris,czcs,octs,seawifs}
                        [--data_type {oc,iop,sst}] [--slat SLAT] [--elat ELAT] [--slon SLON] [--elon ELON]
                        [--stime STIME] [--max_time_diff MAX_TIME_DIFF] [--etime ETIME]
                        [--seabass_file SEABASS_FILE [SEABASS_FILE ...]] [--get_data GET_DATA] [--verbose]

          This program perform searches of the EarthData Search (https://search.earthdata.nasa.gov/search) Common Metadata
          Repository (CMR) for satellite granule names given an OB.DAAC satellite/instrument and lat/lon/time point or range.

          Outputs:
             1) a list of OB.DAAC L2 satellite file granule names that contain the input criteria, per the CMR's 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:
             find_matchup --sat=modist --slat=23.0 --slon=170.0 --stime=2015-11-16T09:00:00Z --max_time_diff=8
             find_matchup --sat=modist --stime=2015-11-15T09:00:00Z --etime=2015-11-17T09:00:00Z --slat=23.0 --elat=25.0 --slon=170.0 --elon=175.0
             find_matchup --sat=modist --max_time_diff=4 --seabass_file=[your SB file name].sb
             find_matchup --sat=modist --slat=23.0 --slon=170.0 --stime=2015-11-16T09:00:00Z --max_time_diff=8 --get_data=[Your path]

          Caveats:
            * This script is designed to work with files that have been properly
              formatted according to SeaBASS guidelines (i.e. Files that passed FCHECK).
              Some error checking is performed, but improperly formatted input files
              could cause this script to error or behave unexpectedly. Files
              downloaded from the SeaBASS database should already be properly formatted,
              however, please email seabass@seabass.gsfc.nasa.gov and/or the contact listed
              in the metadata header if you identify problems with specific files.

            * It is always HIGHLY recommended that you check for and read any metadata
              header comments and/or documentation accompanying data files. Information
              from those sources could impact your analysis.

            * Compatibility: This script was developed for Python 3.5.

            * Requires a valid .netrc file in the user home ($HOME), e.g.:
              machine urs.earthdata.nasa.gov login USERNAME password PASSWD

    options:
      -h, --help            show this help message and exit
      --sat {modisa,modist,viirsn,viirsj1,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 Suomi-NPP
                                  viirsj1 = VIIRS on JPSS-1/NOAA-20
                                  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)

      --slat SLAT                 Starting latitude, south-most boundary
                                  If used with --seabass_file, will override lats in the file
                                  Valid values: (-90,90N)

      --elat ELAT                 Ending latitude, north-most boundary
                                  If used with --seabass_file and --slat, will override lats in the file
                                  Valid values: (-90,90N)

      --slon SLON                 Starting longitude, west-most boundary
                                  If used with --seabass_file, will override lons in the file
                                  Valid values: (-180,180E)

      --elon ELON                 Ending longitude, east-most boundary
                                  If used with --seabass_file and --slon, will override lons in the file
                                  Valid values: (-180,180E)

      --stime STIME               Time (point) of interest in UTC
                                  Default behavior: returns matches within +/- MAX_TIME_DIFF (default +/-3 hours) about this given time
                                  If used with ETIME, this creates a search time window, between STIME and ETIME.
                                  Valid format: string of the form: yyyy-mm-ddThh:mm:ssZ
                                  OPTIONALLY: Use with --max_time_diff or --etime

      --max_time_diff MAX_TIME_DIFF
                                  Maximum time difference between satellite and in situ point
                                  OPTIONAL: default value +/-3 hours
                                  Valid values: decimal number of hours (0-36)
                                  Use with --seabass_file OR --stime

      --etime ETIME               Maximum time (range) of interest in UTC
                                  Valid format: string of the form: yyyy-mm-ddThh:mm:ssZ
                                  Use with --stime

      --seabass_file SEABASS_FILE [SEABASS_FILE ...]
                                  Valid SeaBASS file name or list of file names
                                  File must contain latitude, longitude, and date-time information as fields.

      --get_data GET_DATA         Flag to download all identified satellite granules.
                                  Requires the use of an HTTP request.
                                  Set to the desired output directory.

      --verbose                   OPTIONAL: Displays HTTP requests for each Earthdata CMR query.