U.S. Geological Survey home page

SPECtrum Processing Routines

Users Manual

Version 3

(program SPECPR)

by

Roger N. Clark

U.S. Geological Survey, MS 964
Box 25046 Federal Center
Denver, CO 80225-0046
(303) 236-1332

rclark@usgs.gov

USGS Open File Report no. 93-595

Reference:
Clark, R.N., 1993, SPECtrum Processing Routines User's Manual Version 3 (program SPECPR), U.S. Geological Survey, Open File Report 93-595, 228 pages.


TABLE OF CONTENTS

Acknowledgements

1 INTRODUCTION
1.1 Introduction
1.2 History of Specpr
1.3 Specpr Design Philosophy

2 PROGRAM STRUCTURE
2.1 Block Diagram of Program Structure
2.2 File Structure from the Users View
2.2.1 Deleted point values
2.2.2 General data file I/O
2.2.3 Transfer Restrictions
2.3 File Protection
2.3.1 Use of Specpr File Protection
2.4 Command Interpretation
2.5 Alias Definitions and Substitions
2.5.1 Creating Alias Words
2.5.2 Translating Alias Words
2.5.3 Listing and Saving Alias Words and Translations
2.5.4 Reading Alias Words into specpr from a File
2.5.5 Deleting or Writing Over an Alias Word
2.6 Variable Parsing
2.7 Order of Substitution and Command Interpretation
2.7.1 Flow Chart for Command Interpretation Order
2.8 Specpr File Types and Content
2.8.1 The Standard File Content
2.9 "Wavelengths" and other concepts of x-y paired data
2.10 Help!

3 STARTING SPECPR
3.1 Starting Specpr on Unix
3.2 HELP
3.3 Configuring Your Environment

4 IMPORTANT RULES
4.1 Important Rules
4.2 Protective Locks
4.3 Make Specpr Files Read Only When Outside Your Directory
4.4 Bug Reports
4.5 Keep Track of the Number of Channels and
the Wavelength Set!
4.5.1 Rules of Operation for Channels
4.5.2 If You Must Change The Number Of Channels
4.5.3 Setting Channels

5 PROGRAM INITIALIZATION
5.1 Introduction
5.2 Beginning
5.3 Protection
5.4 Observatory Location
5.5 Device and File Assignments
5.6 Data File Names
5.7 Graphics Options
5.8 Automatically Checking File Protection

6 DEVICE AND FILE ASSIGNMENTS
6.1 Device and File Assignments
6.2 3D File Types
6.2.1 3D File Parameters
6.2.2 3D Algorithm Description
6.2.3 3D I/O Setup Examples
6.2.4 3D I/O Suggestions
6.2.5 3D I/O Demonstration

7 MAIN MENU: PROGRAM OPERATIONS CONTROL
7.1 Introduction
7.2 Menu Information
7.3 Listing the Contents of a Data File
7.4 Terminating Program
7.5 File Display, Transfer, and Overlap
7.6 Changing Initialization Parameters
7.7 Device and File Assignments
7.8 Extinction Routines
7.9 Plot Routines (to Hardcopy Plotters)
7.10 Math Operations
7.11 Restart Summary

8 MATH OPERATIONS
8.1 Introduction
8.1.1 Multiple commands from the math command menu.
8.1.2 Menu Information
8.2 Subtraction, Multiplication, and Division
8.3 Addition Routine
8.4 Error Analysis
8.5 Algebraic and Trigonometric Functions
8.6 Special Functions
8.7 Return from a Math Operation or Function
8.8 The Titles Routine
8.9 Band Normalization

8.f1 F1: List of Special Functions
8.f2 F2: Shift
8.f3 F3: Sequential Processor
8.f4 F4: Sequential Processor (No User Process)
8.f5 F5: Continuum Removal
8.f6 F6: Black Body Computation
8.f7 F7: Smoothing Function
8.f8 F8: Channel-File Transpose
8.f9 F9: Band Removal (Reflection Method)

8.f10 F10: Sorting Routine
8.f11 F11: Lunar Thermal Removal
8.f12 F12: Cubic Spline Interpolation
8.f13 F13: Merge Two Spectra to One
8.f14 F14: Edits Spectral Data and Error Value
8.f15 F15: Formats Gaussian Parameter File
8.f16 F16: Line Segment Generator
8.f17 F17: High To Low Resolution Convolution
8.f18 F18: Block Averages and Statistics
8.f19 F19: Polynomial Fit (10 Term)

8.f20 F20: Text File Input
8.f20.1 Using Function 20
8.f20.2 Setting Up the Text File
8.f20.3 Example

8.f21 F21: Calculate N term Polynomial
8.f22 F22: Tablet Graphics (TABGRAF)
8.f23 F23: Mathmatical Parser
8.f24 F24: Star Moon Thermal Removal
8.f25 F25: Two Component Areal Mix Least Squares
8.f26 F26: not developed yet
8.f27 F27: not developed yet
8.f28 F28: not developed yet
8.f29 F29: not developed yet
8.f30 F30: not developed yet
8.f31 F31: not developed yet
8.f32 F32: not developed yet
8.f33 F33: not developed yet
8.f34 F34: not developed yet
8.f35 F35: not developed yet
8.f36 F36: not developed yet
8.f37 F37: not developed yet
8.f38 F38: not developed yet
8.f39 F39: Noise Generator
8.f40 F40: least squares between two spectra (Under Dev.)
8.f41 F41: Binning Routine (Under Development)
8.f42 F42: Fit Band Profile from a Reference Spectrum
8.f43 F43: FFT and Inverse FFT
8.f44 F44: Segmented Upper Hull Continuum
8.f45 F45: Automatic Band Analysis
8.f46 F46: Band Analysis Output
8.f47 F47: Spectrum Recreation from F46 output
8.f48 F48: HP Graphics Terminal Tablet Digitization
8.f49 F49: Linear Interpolation
8.f50 F50: Wavelength Registration

9 CRT PLOT ROUTINES
9.1 Introduction
9.2 Plotting Mode
9.3 Changing Scale
9.3.1 Changing Scale by Typing in the Range
9.3.2 Changing Scale by Graphics Sub-Window
9.4 Line Type
9.5 Horizontal Axis Labels
9.6 Changing the Wavelength Set
9.7 Graphics Cursor Position
9.8 Interactive Band Analysis
9.9 Deleting Individual Data Channels
9.10 Glitch Removal
9.11 Information Display and Information Change
9.12 Printer Listings and Printer Plots
9.13 Multiple Commands in the CRT Plot Routines
9.14 Exiting the CRT Plot Routines

10 DATA DISPLAY, TRANSFER, AND OVERLAY
10.1 Introduction
10.2 Data Display
10.3 File Transfer
10.3.1 File Tranfer with Plot or Information Change
10.3.2 Starpack Transfers
10.4 Overlaying Data Sets
10.5 Multiple Commands in Data Display Transfer and Overlay
10.6 Extraction of Data from 3D Files for Display and Transfer

11 DATA FILE LIST
11.1 Introduction
11.2 Listing Mode
11.3 CRT Listing Options
11.4 Printer Listing Options
11.5 Search Capability
11.6 Listing Limits
11.7 Continuing/Ending the List
11.8 Sample Listing

12 EXTINCTION ROUTINES
12.1 Introduction
12.2 Starpack List and Display
12.3 Extinction Calculation
12.4 CRT Plot
12.5 Airmass Versus Log Intensity Plots and Deletion
and Restoration of Runs and Channels
12.6 Writing a Starpack
12.7 Starpack Manual History

13 PLOTTING ROUTINES FOR WORK AND PUBLICATION
13.1 Introduction
13.2 Plotting Mode Type
13.2.1 User-selected wavelength limits:
13.3 Vertical Axis Label
13.4 Delete From All Spectra
13.5 Scale of Plot
13.6 Plot Scale Factors
13.7 Data Set Input and Options

14 RADIATIVE TRANSFER ROUTINES

15 STANDALONE UTILITIES
15.1 Introduction
15.2 Spprint
15.3 Spfeatures
15.4 Data Translation
15.4.1 sptoascii
15.4.2 asciitosp
15.4.3 oldsptoascii
15.4.4 cgastosp

APPENDICES

A SPECPR STANDARD FORMAT OF DATA FILES
B HOW TO OBTAIN SPECPR


Acknowledgements


U.S. Geological Survey, a bureau of the U.S. Department of the Interior
This page URL= http://speclab.cr.usgs.gov/specpr.manual.html
This page is maintained by: Dr. Roger N. Clark rclark@usgs.gov
Last modified November 09, 2010.