CKBRIEF User's Guide





CKBRIEF is a command line program that allows you to easily summarize the pointing data coverage of one or more CK files.



Usage




CKBRIEF is run by typing the name of the program at a shell prompt.

           ckbrief [-option(s)] file [file ...]
A wide variety of options may be specified on the command line giving you a great deal of flexibility in the operation and summary capability of the program.



Options




Any of the following options may be specified. Some options may disable other options. For example if you request that coverages be displayed as ephemeris time and another option in the same command line will request UTC time then only UTC time will be displayed. We have not attempted to spell out all of the possible conflicts here, since for the most part you'd be unlikely to specify conflicting options intentionally.

-t

display results in a tabular format
-h

display help text
-v

display the current version of the program
-f

provide a file containing full path names of files to summarize. This flag is used as shown below


-f list_of_sources.file
-g

group together objects with the same coverage
[obj]

create a summary for the specified object. (here "obj" is the NAIF ID integer code of a spacecraft, instrument or structure. Note that CKBRIEF assumes that NAIF ID codes for a spacecraft, instrument or structure are negative integer numbers.)
-sclk

display times in space clock string format
-dpsclk

display times in space clock double precision format
-utc

display times in UTC text string format
-doy

display times in DOY text string format
-nm

("no merge") causes the program to display a separate record for each segment even when segments overlap
The names of a CK file(s) to be summarized and LSK and SCLK files required to support time conversions must be provided on the command line or in a file the name of which must be provided on the command line following the "-f" key. The names provided in a file maybe each on a line by itself, multiple names names per line separated by spaces or mixture of these two cases.

CKBRIEF will NOT display time if generic LSK file and an SCLK file for a given object were not provided.

CKBRIEF will inform user on any incorrect option, incorrect file name or file type specified in command line.