Browser

A graphical interface to simplify the examination of SOUP
images and movies and allow some simple image processing tasks.
Browser will currently read SOUP fz files, FITS files (2-D
images only), GIF files, and 8 or 12 bit JPEG files. Files
not recognized will pop up an error message. There are 10
display windows available. Choosing a display window causes
the next file read to use that window and destroys any
previous image in that window. Pleae note that many of the
files used in browser are large and reading and displaying
may take a while, especially over a network.

There are 2 modes of reading in images:

1. Single Files: Browser can examine single images via the
"single file" black button. This pops up a file selection
dialog (a standard motif widget) which shows directories and
files. The directory path will initially be the one you were
in when you started browser up. It can be changed by modifying
the text under "filter" and then hitting return or the filter
button. The directories box then contains subdirectories in
this path and the file box contains files. Note that a subset
of the files can be displayed using a partial file name and *'s
in the filter text. After a file name is found, it can be selected
by clicking on it. Then either a double click or hitting the
display button will cause the file to be read and displayed if
possible.

2. File Sequences: Many series of files in the SOUP set are
named with a number as part of the name. The "file name template"
text box is intended for such a series. Enter the name with pound
signs (#'s) where the digits in the number would normally be.
Note that the number of digits should be always the same (3 or 4
are common) with leading 0's in the file names. The numerical
range is then entered in the 2 range boxes, htting return after
each one to make it update. Once this is done, the slider labeled
"image # selection" can be used to select any image in the series.
Moving the slider will cause the header (if any) to be displayed
in the header text box. To display a given file, hit the red
"display selection" button. There are also buttons for stepping
up and down the series and the increment of the step can be changed
from 1 to a larger value. This is useful for quickly scanning through
a data series.

Note that a "list known movies" black button can be used to select
and load the file template and ranges for movies that are kept in
a special file (currently /umbra/people/shine/auto/known_movies).

Large images (currently bigger than 750 pixels) are compressed by
a factor of 2 before being displayed. The original data is used for
any processing however.

When an image is displayed in window n (where n ranges from 0 to 9),
the data is internally stored in ANA (which runs browser) in an
array named $datan (where n is a number) in its original form. These
arrays are scaled for display and the display may not show all the
dynamic range of the originals. All image processing is done with
the original form. Browser can be interrupted to allow direct
manipulation of the arrays via the "interrupt Motif" widget some-
where on the screen. To restart browser, type xtloop, 1  as an ANA
command.

Several tools are available for manipulating the data associated
with the windows. These are in a series of pop up menus at the
bottom of the browser widget in 4 main classes. Each widget has its own
help button. There is also a "screen mapping" button which pops
up a widget to adjust the screen constrast and cutoffs. It also has
a help button for further details. At present, browser only displays
images in b/w which we find most useful for studying details. Color
mappings can be used via ANA commands outside of browser. A color
control widget will be constructed soon.

Share and Enjoy