spurious

NAME

spurious - asign spurious signals on profiless

SYNOPSIS

DESCRIPTION

This command asigns spurious signals. The asinged channels are not used for other processes, such as baseline, integ and smooth. The command only give "a spurious flag" for the asigned channel, and does not make any more processes such as interpolation using signles in channles near the spurious. You can use the command interctively with graphical user interface. Also you can use it as batch process with character user interface in the command line.
The spurious channels asigned before are not cleared at first.

FILTER TYPE

.scn | spurious | .scn

OPTIONS

all X11 standard options, such as -display, are accepted.

-size size_of_window

This option is valid only in the GUI mode. It gives the size of a working window like -geometry but in cm (The system assumes you are using 72 dpi monitor).

-ch range | -v range

These options are valid only in the GUI mode. The range is composed of two values devided by the character ",". For example

-v -20,60

means velocity ranges from -20 km/s to 60 km/s.
The keyword -v without any velocity range value the command shows the whole profile. The presentation unit is in km/s of the LSR velocity.

-T range

This option is valid only in the GUI mode. The range is composed of two values devided by the character ",". The presentation unit is K. For example

-T -10,60

means velocity ranges from -10 K to 60 K.

-gui | -nogui | -cui

These option keywords give a mode of the command. The keywords -gui and -nocui give the process interactively. The keywords -cui and -nogui give the process batch-like. In the GUI mode you can assign and change any fitting paramters through a working window which will appear automatically. Most optional parameters are accesible through menu bar on the top of the window. The next button apply the baseline and the system proceeds the next step. See the next section in detail about the GUI mode.

-v_check ranges | -ch_check ranges

The keywords -v_check or -ch_check gives the ranges for spurious signal searching. The ranges is a single word, which means no blank must be included. The value is composed of several (at least 1) ranges devided by the character ":". Each range is composed of two values devided by the character ",". For example

-v_check -20,30:50,60

means two velocity ranges from -20 km/s to 30 km/s and 50 km/s to 60 km/s are used for fitting.

-v_check -50,-30:-10.5,0.3:1.4,2.0

means thress velocity ranges.

-clip_level clip_level_min,clip_level_max

The criteria for spurious asignment are given. The signal in the searching channel ranges with the value less than clip_level_min or with the value more then clip_level_max will be assigned. The unit for values is K.
All "clip_level" values are the same for all searching ranges. If you want to different levels for each channel/velocity ranges, you should use several spurious commands in a single pipeline.

-keep | -clear

Keep or clear all spurious flags before processing.

-P printer

Printer name to print out. The printer must suport PostScritp.

PARAMETERS

-P option is not supported in the .prm files.

ENVIRONMENT

All environment parameters for X11, such as DISPLAY, are also valid.
PRINTER: printer name for print out. See lpr command of your OS.

DEFAULTS

-size 15x20 -cui -keep -prm spurious.prm
-ch: The working window shows the whole profile range in channel.
-T: The working window shows the whole temperature range which is scaled automatically depending on the maximum and minimum values in the displaying range.
-ch_check, -v_check: No searching ranges
-clip_level: Signal with any value is asigned as the spurious signal.

GUI

MENU BAR

next
Pass the present profile and go to the next profile. If it is the last, go to the next processing stage of the pipeline. Before do "flag", improper profile data may be passed.
flag
Execute flagging. Before push "next" you should execute "flag".
reshow
Show the processed profile with a green line
clear
Clear all spurios flags and ranges including the original
retry
Cancel the flag procesure and recover the original profile. If you give "-keep" option, the original sproius flags are also recovered.
print
Print out the present screen
quit
Stop all processes after this step.
MAIN WINDOW
cross cursor
point for the spurious check ranges. Both horizontal and vertical positions are valid.
Blue line
actual profile
Green line
processed profile
Red line
spurious flagged channels
Red boxes
assigned check regions.

BUGS

In GUI mode, if the pipe flow requires more than 2 pages and with other commands using X11, you must also use the command pipewait. See pipewait in detail.
In GUI mode, the "next" button passes unflagged profile to the next stage before you push the first "flag" for the profile.
In GUI mode, the cross cursor position pointed out of the showing range gives the corresponding out range, although the red box is adjusted. Only if the corresponding channel is out of valid channel range (not presenting), the range is adjusted.
The option "-clip_level" should be able to give different values for different searching ranges.

HISTORY

ver.3.00: 1998/1/5 T.Handa
ver.3.25: 1998/5/21 T.Handa

MANUAL VERSION

1998/5/23 T.Handa