advanced

VSDB-Analysis Tool: Run

Next, run VSDB-Analysis on the command line using the following command:

bin/vsdb_analysis \
-lookin tutorial/out/point_stat \
-out tutorial/out/vsdb_analysis/vsdb_analysis.out \
-config tutorial/config/VSDBAnalysisConfig_tutorial

VSDB-Analysis is now performing the analysis jobs we requested in the configuration file. It is writing the output of our 3 jobs to the file we specified using the -out command line argument. It should run in only a couple of seconds since we're analyzing such a small sample of VSDB data. In general though, VSDB-Analysis can be used to process very large amounts of data - whole season's worth - in a relatively short amount of time.

Next, we'll re-run the third job, but this time using command line options rather than supplying a configuration file:

bin/vsdb_analysis \
-lookin tutorial/out/point_stat \
-job vsdb_job_aggr \
-dump_row tutorial/out/vsdb_analysis/command_line.vsdb \
-vx_mask G212 \
-line_type CTC\>278.000 \
-level P850-750 \
-var TMP \
-interp_pnts 25

When specifying command line selections that include the use of special characters, such as the > character in -line_type CTC\>278.000, you may need to escape it's special meaning using the \ character.

The output of this VSDB-Analysis job is printed to the screen since we didn't redirect the output to a file using the -out command line option. The output for this job consists of 3 lines:

• The COL_NAME line consists of the column names for the statistics listed in the next line.
• The CTC line consists of the output for a typical contingency table count VSDB line. However, only the columns that would appear after the = sign are shown.
• The JOB_COMMAND line lists the job command options that were used to perform this job.