NAME
specrtd - real-time spectra display
SYNOPSIS
specrtd [-select select] [-reject reject] [-backup seconds]
[-tstart start_time] [-nscl_sift nscl_expr]
[-stats_twin stats_twin] [-pf pfname]
orbname
DESCRIPTION
specrtd displays real-time spectra from ORB parameter file objects as
output by
orbsmrsp(1), for instance.
OPTIONS
-
-select select
An ORB select expression that is applied to the pf packet ORB reads.
This argument is optional.
-
-reject reject
An ORB reject expression that is applied to the pf packet ORB reads.
This argument is optional.
-
-backup seconds
If this is specified, the ORB read pointer is backed up in time relative to the -tstart
parameter, or the current time when the program starts, if -tstart is not specified.
This argument is optional.
-
-tstart start_time
Where to start processing in the ORB that contains the pf packets.
This argument is optional.
-
-nscl_sift nscl_expr
This is a regular expression that is matched against input SEED net_sta_chan[_loc] codes to determine which channels are displayed.
This argument is optional.
-
-stats_twin stats_twin
Max and min spectra of each channel over the last stats_twin seconds can be computed and displayed if this is set.
This argument is optional.
-
-pf pfname
Name of program parameter file.
The actual parameter file name is pfname.pf. If this argument
is not specified, then the default pfname is "specrtd".
-
orbname
This is a required argument and specifies the input data source. If the argument looks like an ORB name, i.e. It has a : character in it to
delimit the hostname from the portname, then the data source is assumed to be an orbserver with a name of orbname. If the argument
does not look like an ORB name, then is is assumed to be a spectrum parameter file on disk.
PARAMETER FILE
Following is an example of a parameter file.
# This is the default parameter file for specrtd
max_columns 3 # maximum number of plot columns in display
background_color \#e0e0e0 # background color outside of plot
background_plot_color \#fafafa # background plot color
channel_colors &Tbl{ # color coding for channels
..Z \#00a000 # dark greeen for Z-component
..N red # red for N-component
..E blue # blue for E-component
}
limit_colors &Arr{ # color coding for limit spectra
DRS orange
OBE \#ff6000
SSE magenta
LSA darkgray
}
plot_mode loglog # Plotting mode (loglog, loglin, linlog, linlin)
spectra_units g # Spectra plot units (g, mg, nm/s**2, m/s**2, cm/s, nm/s)
xaxis_type frequency # X-axis type (frequency, period)
ybottom 0.0001 # spectra value at bottom of plot
ytop 1.0000 # spectra value at top of plot
xleft 0.03 # frequency/period value at left side of plot
xright 100.0 # frequency/period value at right side of plot
width 500 # canvas width in pixels
height 500 # canvas height in pixels
The specrtd parameters are as follows.
-
max_columns
This is the maximum number of plot display columns.
-
background_color
This is the color of the display window background.
-
background_plot_color
This is the color of the plot window background.
-
channel_colors
This is a Tbl with each line having two fields. The first field is a regular expression applied to
data SEED chan codes. The second field is the color for channels matching that regulsr expression.
-
limit_colors
This is an Arr with key values equal to limit spectra type names and the corresponding value equal
to the colors of those limit spectra in the display.
-
plot_mode
This is one of loglog, for X-log, Y-log plots, loglin, for X-log, Y-lin plots, linlog, for X-lin, Y-log plots, or linlin, for X-lin, Y-lin plots.
-
spectra_units
This is one of g, mg, nm/s**2, m/s**2, cm/s, or nm/s for displaying spectra and limits. Acceleration/velocity transforms are done automatically.
-
xaxis_type
This is one of freqyuency, for displaying the X-axis as frequency in Hz, or period, for displaying the X-axis as period in seconds.
-
ybottom, ytop
These are the Y-axis scale values for the bottom and top of the plot respectively.
-
xleft, xright
These are the X-axis scale values for the left and right sides of the plot respectively.
-
width, height
These are the width and height of each spectrum plot canvas, including all of the annotations, in pixels.
SEE ALSO
orbsmrsp(1)
AUTHOR
Danny Harvey
Boulder Real Time Technologies, Inc.