SUBCONV

NAME
 subconv - subset and convert data files

SYNOPSIS
 (1) subconv [options] REQUEST_NUMBER DOWNLOAD_DIRECTORY

 (2) subconv -B REQUEST_NUMBER

 (3) subconv -T RINFO_STRING

DESCRIPTION
subconv processes a dsrqst request by performing some combination of parameter, temporal, and spatial
subsetting. Also, possibly perform a format conversion from the native data format to some other data format.
subconv can run in a mode that analyzes a data request and then outputs suggested sbatch options.
subconv can run in a mode that tests whether or not a given data request will return any data. This is useful
for users who are submitting requests via an API, and thereby bypassing error detection that occurs with the
web interface submission.
REQUEST_NUMBER
      The six-digit dsrqst ID for the subset request.
DOWNLOAD_DIRECTORY
      The full path to the directory from where the user will download the processed data files.
RINFO_STRING
      The "subsetting string" that gets stored in the "rinfo" field for the dsrqst subset request.
-B    Run in "sbatch" mode.
-T    Run in "test" mode. This is used to test whether or not a subsetting string is properly specified and will
      match a non-zero number of grids.
OPTIONS
-I    Ignore the cumulative output volume and allow a large request to successfully process. The current default
      is 900 MB.

-n NUM_THREADS
      The number of threads to use to process the request. This option should NOT be used when a request is 
      processed with the sbatch options that were suggested by the sbatch mode of subconv.

-t    Turn on internal timings.

EXAMPLES

AUTHOR
 Bob Dattore (dattore@ucar.edu)