SPECPR Users’ Manual                                                   Page 15.1

CHAPTER 15

STANDALONE UTILITIES

15.1 Introduction

This chapter describes specpr support utilities. They are independent programs to do tasks related to specpr. Each utility has a Unix-style manual page. You may want to copy these manual pages and put them into your local list of user-available commands.

Spprint is a routine that prints the contents of a specpr file, similar to the "list" function in specpr (section 11 of the specpr manual), but the advantage in using it is you do not have to start a specpr process, assign a file, and then go to the list routines. It is useful for checking the contents of a specpr file you happen across. This routine is used to provide rapidly searchable lists of online specpr files at the U.S. Geological Survey, Denver Spectroscopy Laboratory. Spprint is described in section 15.2. Spfeatures is a program that reads a data file created by specpr special function f46. Thus, spfeatures queries a spectral features database and allows a user to find spectra with certain user-defined features. Spfeatures is described in section 15.3. The data translation routines are used to convert specpr data files to ascii and those ascii files back to specpr format data files.

15.2 spprint

NAME
     spprint - print a summary of a specpr format file

SYNOPSIS
     spprint  file

DESCRIPTION
     This program uses the specpr listing routines to provide a listing
to the standard output of the header and data, similar to the specpr
list routines, Chapter 11 of the specpr manual.

FILES
     "file" is a user-specified specpr file

AUTHOR
     Matthew Klejwa

15.3 spfeatures


NAME
     spfeatures - search spectral features data base

SYNOPSIS
     spfeatures [-c range] [-w range] [-d range] [-e range]
                [-a range] [-F file] [-o file] [-h] [-v] [-b]


DESCRIPTION
     This program searches the spectral features database selecting
entries based on the band center, width, depth, asymmetry, or error on the
depth of the feature.  All numbers refer to microns in the database.

     Options:

            -c c1 c2 : Band Center --  Causes program to select
                         all features with a band center within
                         the bounds of c1 and c2.   c2 must be
                         greater than or equal to c1.

            -w w1 w2 : Band Width --  Causes program to select
                         all features with a band width within
                         the bounds of w1 and w2.  w2 must be
                         greater than or equal to w1.

            -d d1 d2 : Band Depth --  Causes program to select
                         all features with a band depth within
                         the bounds of d1 and d2.   d2 must be
                         greater than or equal to d1.

            -e e1 e2 : Error on band depth --  Causes program 
                        to select all features with an error
                        on the band depth that is within the
                        bounds of e1 and e2.   e2 must be
                        greater than or equal to e1.

            -a a1 a2 : Band Asymmetry --  Causes program to
                        select all features with a band asymmetry
                        within the bounds of a1 and a2.  a2
                        must be greater than or equal to a1.

            -F file  : Database file --  Causes program to use
                        "file" as a database, rather than the
                        default file.

            -o file  : Output file -- Causes output to be written
                        to "file", rather than standard output.
                        "File" is outputted in binary form, and
                        is not compatible with the "-b" option.
                                (-h and -v are ignored)

            -h       : Header -- Causes the appropriate header
                        to be included in the output.
                                (default is no header)

            -v       : Verbose -- Prints the entire title and the
                        comments to each band.  (default is a
                        seventeen character name, and no comments)

            -b       : Bandanal format -- Causes program to use
                        the output from Specpr Interactive Band
                        Analysis routine, see section 9.8 of the specpr
                        manual.  This option is not compatible with the
                        -o option, and causes a fatal error.  (-v is
                        ignored, and -h header is changed)



     When more than one option is given, the search is by "and" as
compared to an "or" search.  If an "or" search is desired, run the
program separately, and append the output to a file.

EXAMPLES

Find all features with a center between 1.38 and 1.41 microns:

       spfeatures -c 1.38 1.41

Find all features between 1.38 and 1.41 microns with a full width at
half maximum less than 0.01 micron:

       spfeatures -c 1.38 1.41 -w 0 0.01

Find all features between 1.38 and 1.41 microns with full width at
half maximum less than 0.01 micron, and belonging to Alunite:

       spfeatures -c 1.38 1.41 -w 0 0.01 | grep Alunite

Find all features between 1.38 and 1.41 microns with full width at
half maximum greater than 0.01 micron, and all features between 2.1 
and 2.4 microns that belong to Alunite, and put the output in a file
called temp1 with a header:

       spfeatures -h -c 1.38 1.41 -w 0.01 9999 | grep Alunite > temp1
       spfeatures -c 2.1 2.4 | grep Alunite >> temp1

FILES
     /d1/samples/features/FWHM_46      binary features database
     /d1/samples/features/FWHM         bandanl features database
     *                                 user's features database
     NOTE: the above files are be site dependent.

NOTES
    1) There will be no output if there are no options (null default).

AUTHORS
     Noel Gorelick, Roger Clark, Matthew Klejwa


15.4 Data Translation

15.4.1 sptoascii


NAME
     sptoascii - convert a specpr format file to ascii data

SYNOPSIS
     sptoascii file

DESCRIPTION
     This program converts a specpr file to ascii so that it may be
easily transferred to a different machine and retranslated to the
local machine format, thus avoiding the writing of special floating
point number conversion routines.

FILES
     "file"       user-specified specpr file

AUTHOR
     Robert Burtzlaff

15.4.2 asciitosp

NAME
     asciitosp - convert an ascii data file to specpr format

SYNOPSIS
     asciitosp file < asciifile

DESCRIPTION
     This program converts an ascii file to specpr format, version 2
(version 3 specpr has the same format as version 2).  The ascii format
must be the same as that generated by sptoascii or oldsptoascii.

FILES
     "file"       user-specified specpr file

AUTHOR
     Robert Burtzlaff

15.4.3 oldsptoascii

NAME
     oldsptoascii - convert a specpr version 1 format file on a DEC
                    VAX to ascii data

SYNOPSIS
     oldsptoascii file

DESCRIPTION
     This program converts a specpr version 1 file to ascii so that it
may be easily transferred to a different machine (or the same machine)
and retranslated to the local machine format, thus avoiding the writing
of special floating point number conversion routines.

     This program MUST be compiled and run on a VAX Unix (or VAX
Eunice) system.

     The output is written to standard out, which may be redirected
to another file.

FILES
     "file"       user-specified specpr file

AUTHOR
     Robert Burtzlaff

15.4.4 cgastosp

NAME
     cgastosp - convert an ascii data file from the NASA Infrared
                Telescope Facility, Cooled Grating Array
                Spectrometer (CGAS) to specpr format

SYNOPSIS
     cgastosp file < asciifile

DESCRIPTION
     This program converts an ascii file made at the University of
Hawaii, from the NASA Infrared Telescope Facility, Cooled Grating Array
Spectrometer (CGAS) to specpr format, version 2
(version 3 specpr has the same format as version 2).

FILES
     "file"       user-specified specpr file

AUTHOR
     Roger N. Clark