header_diff

This is a testing utility to compare the FITS headers of one build versus another. It allows the user to ignore comment difference, to ignore a list of keywords, ignore case, and to specify the floating point tolerance.

Usage:

%header_diff [-i {ignore_list_filename}] [-comments off] [-case off] [-tolerance {value}] {baseline_directory_path} "{wildcarded_list_of_headers}"

Context:

Inputs

-i {ignore_list_filename}

The ignore_list_filename is the name of a file which contains a list of keywords which you wish to ignore. It is not necessary to supply a filename, in which case all keywords will be compared.

That file will have one capitalized keyword per line.

-comments off

The comment switch (you can use -co off) turns comparison of the comment portion of the keyword line off. Note that -c off defaults to -comments off as well.

-case off

The case switch (you can use -ca off) converts keyword values to uppercase before comparison.

-tolerance {value}

The tolerance switch (you can use -t {value}) substitutes your own tolerance for the defaulted 1.0e-8.

baseline_directory_path

This is the directory path to the location of the baseline header files. It is assumed that the header files were produced by the listhead task.

wildcarded_list_of_headers

This is the expression of what you want to difference. Wildcards are not only allowed, but encouraged. On UNIX systems you MUST use double quotes to delimit this specification!

Outputs

Examples:

%header_diff -c off /draco/observations/nic/100/ \ "/draco/observations/nic/101/*raw.lis" This example will difference all the *raw.lis files in the build 10.1 directory, and compare them with their counterparts in the build 10.0 directory.

VMS Usage: While this is primarily a unix tool, it can be run in a VMS environment. The difference is that the VMS shell will not expand the wildcarded filename to a list of files. Consequently you will have to use a command file like this: $!============================================================================= $! $! Usage: $! $define binaxp disk$leo:[leo.rose.bin.axp_vms] (for now) $! $define old disk$cmtest2:[opus100.regout.pass7.pipeline_keep] $! $define new disk$cmtest2:[opus101.regout.pass8.pipeline_keep] $! $@header_diff old: new:x*.jit_lis $! $!============================================================================= $ header_diff := "$binaxp:header_diff" $nextfile: $ file = f$search(''p2'') $ if file .eqs. "" then exit $ header_diff 'p1' 'file' $ goto nextfile $ exit