NAME

parse-sumfiles - parse sum files and write header info to an rdb file


SYNOPSIS

parse-sum [options] path1 [ path2 ... ]


OPTIONS

-help

Print this

-verbose

Print the name of the sum file to STDERR.

-output

Specify the name of the output rdb table.

-split

Split the output up into one file per directory, using the name of the directory as the rdb file name.

-fields fields

Specify the fields to grab out of the header. fields may either be a comman separated list of field names, or (if preceded by the @ character) the name of a file containing field names. This list overrides the default list of fields. The fields runid and filename will always be present.

-getkeyw

Parse the sum files looking for all of the keywords. Instead of generating an rdb table with the sum files' keyword values, it just dumps a list of all of the keywords that were found. It normally lists only keywords which had useful information in them for at least one sum file. See also -allkeys.

-allkeys

If true and -getkeyw is true, parse-sumfiles will output all of the keywords found, not just the ones with useful information.

If true and -getkeyw is not true, then parse-sumfiles's default set of keywords to extract will include fields found to not contain any useful information at the XRCF (i.e., from a fiducial run of parse-sumfiles with both -getkeyw and -allkeys set). Normally a list of keywords determined by a fiducial run with only -getkeyw set is used.


DESCRIPTION

parse-sumfiles parses sum file headers and outputs an rdb table suitable for ingestion into Postgres.

The files to be parsed are specified on the command line. They may be specified as:

When parse-sumfiles searches directories, it looks for files matching the Perl regular expression /\d+d\d+.sum$/.

Unless overriden with the -fields or -allkeys options, the output rdb file will have contain keywords determined by a fiducial run with -getkeyw.

The column path is created by parse-sumfiles. path is the last segment of the sum file's path (i.e. it's parent directory). runid replaces uniqueId. runid and filename will always be present.