Introduction to SUMER_SEARCH and SUMER_TOOL
The SUMER_SEARCH and SUMER_TOOL package
is one of user-contributed SUMER softwares and has been developed by J. Chae. Please e-mail to him at chae@orpheus.nascom.nasa.gov if you have any of comments, questions or problems.
What is SUMER_SEARCH?
[Go to Title Page]
-
SUMER_SEARCH is an IDL widget-based program for SUMER data search.
- SUMER_SEARCH searches through SUMER archive to determine the list of
files which satisfy the user-supplied criteria like observing time, field of
view, wave length and exposure time. Users can also impose additional criteria
such as detector, slit, object, scientist, study name, and observing sequence
upon the search.
- SUMER_SEARCH also allows users to get access to data either via
direct reading/copy (when users are working on machines which have SUMER archive disks mounted) or via FTP-copy (when users are working on remote machines).
- SUMER_SEARCH can be used to examine one or several SUMER files
by looking at FITS headers or by displaying data (which calls
SUMER_TOOL).
How to Use SUMER_SEARCH
[Go to Title Page]
- Start by calling
SUMER_SEARCH.
Then you will find an IDL widget window like
this.
- Specify all the criteria for file search and click Search
button. Be patient and you will see the list of files
satistying those criteria.
- If there is any trouble, first recover from the trouble and then
examine the setup configuration by clicking Config button.
Then it calls the program
SUMER_CONFIG
which allows you to modify the setup.
- You can sort out the file list in the order of Observing Study Name,
or wavelength, or time by clicking Sort button.
- You can select only the files which you want to look at or retrieve
by clicking them from the list.
To cancel your selection of a specific file,
double-click on that file in the list.
- Sometimes using the buttons Select All and
De-select All can be efficient.
- If you have a direct access to SOHO-Archive, you can easily
have a look at the headers of the files you want to, by clicking
the sub-buttons under the button Data. The archive directory
for the data is automatically determined by calling the function
SUMER_ARCHIVE_DIR .
- You can have a look at
the data themselves by clicking the button Data.Look at Data
(this process automatically calls
SUMER_TOOL).
- Of course, you can do the same things if the SUMER data files exist
in the directory !SUMER_CONFIG.DATA_DIR even if SOHO-Archive is not available.
The routine
SUMER_FILE
internally checks
the availability of a SUMER file.
- You can copy the SUMER FITS files into a local data directory
either by a direct copy or by FTP copy
( FTP_GETPUT )
depending on your way of data access which is defined by the
IDL system variable !SUMER_CONFIG.
- Exit from the program by clicking the button Done
and you will have the output of the list of files you selected at
the last time.
What is SUMER_TOOL?
[Go to Title Page]
- SUMER_TOOL is an IDL widget-based program for looking at and analyizing SUMER data.
- SUMER_TOOL is mainly intended for displaying raster-type SUMER data.
It shows the raster
intensity images constructed from scan data(i.e. spectroheliograms), spectrograms at each slit position, and spectral profiles at each spatial location.
- SUMER_TOOL implements the basic data reduction processes such as gain correction, saturation correction, and geometric distortion correction.
- SUMER_TOOL allows different kinds of ways for obtaining line parameters:
band filtering, integration-based Gaussain fit, and non-linear square fit.
- SUMER_TOOL can make hardcopies of spectroheilograms, spectrograms, spectral
programs. The line parameters and spectrograms can be also saved into standard
FITS files for later use.
How to use SUMER_TOOL
[Go to Title Page]
SUMER_TOOL Start
[Go to: How to use SUMER TOOL]
- Start by calling
SUMER_TOOL like
IDL> SUMER_TOOL, files, reformat=1
Note that the file names files can represent either a single
file or a set of files and they can be either full file names
including directories or simple file names.
- The program internally
checks the availability of each file using the routine
SUMER_FILE based on the
information in the system variable !SUMER_CONFIG.
- If more than one files are specified , all the data in the files
are combined by the internally called routine
SUMER_SERIAL
to form one structure of data defined in
SUMER_FITS .
In this case, the data in the files should come from the same observing
sequence performed by the same observing study program.
- If the keyword REFORMAT is set, the segments of data on the detector
plane are re-defined in the subprogram
SUMER_REFORMAT .
-
If only a single file is specfied and the keyword REFORMAT is not set,
the data in the file is simply read by the routine
SUMER_FITS .
How to use SUMER_REFORMAT
- When the routine
SUMER_REFORMAT
is called, an IDL widget window like
this shows up.
- From this interactive window, you can re-define either the size of
window segments on the detector plane by changing
N_Spectral and N_Spatial or the number of lines.
- You can also re-define the position of each segment
by clicking the buttons Y Position and
Spectral Position
and clicking the right button on the detector for each line.
- You can have a look at the newly-defined window segments
by clicking the button Show.
- If you feel a difficulty in indentifying weak lines, try
to adjust the color table using the button Color.
- IF you are satisfied, exit by clicking Done.
SUMER_TOOL Data Display
[Go to: How to use SUMER TOOL]
- Once the data are properly read, the data are displayed
in the widget window like
this.
- Initially the window shows the intensity map of the first line
which has been constructed by summing all the counts in the line
at each spatial point.
- You can also have a look at the intensity maps of another line
by choosing one from the droplist button named
like W_1031.91 which is located just above
the raster map window. Later after fitting is done, the program
can display either of intensity, Doppler shift, line width,
and continuum maps depending the choice of another Droplist button
named like intensity.
For the display of the raster scan maps, the routine
SUMER_DISPLAY_IMA
is internally called.
- The numeric value at each point of the image shown in the raster
map window can be read by clicking the
spatial point on the map with the left mouse button.
The position and the read value then appear on the above fields.
- The spectral profile at each spatial point is displayed on the
lower spectral window when the spatial point is clicked with the
right mouse button. You can change the line by choosing
another from the droplist named like W_1031.91 which is
located at the right side of the spectral widnow.
For the display of the spectral profiles, the routine
SUMER_DISPLAY_W
is internally called.
- The spectrogram of a line at each slit position
is displayed
on the spectrogram window at the right side of the raster map
window when
the slit position on the map is clicked with the central
mouse button. At the same time, the spectral profile at the
chosen point on the slit is displayed in the spectral window.
For the display of the spectrograms, the routine
SUMER_DISPLAY_SPECTRUM
is internally called.
- There are many kinds of make-ups which may help better displays
of raster maps, spectral profiles and spectrograms.
- Color Table Adjusting: Click the button Color.
- Font Selection: Click the button Font.
- Change of Coordinates Kind: Click the button
Data Handle.Coordinates.Units.
- Change of Coordinates Scales: Click the button
Data handle.Coordinates.Magnification.
- Change of the Gray Scale Minimum and Maximum for the
raster maps: Click the button
Data Handle.Gray Scale Min & Max.
- Filling the Missing Slit Data: Click the button
Data Handle.Fill Missing Data.
- Display Smoothed Data: Click the button
Data Handle.Smooth
- One can read the FITS primary and binary headers
by clicking File.Header.
SUMER_TOOL Data Reduction
[Go to: How to use SUMER TOOL]
- Spatial Region of Interest: Data manipulation can be confined to
only a specific spatial region by clicking the button
Data Handle.Reg. of Interest.Spatial Region. This request
calls the routine
XDEFROI.
- Spectral Region of Interest for each line: Click the button
Data Handle.Reg. of Interst.Spectral Lines.
- Flat Fielding: Click the button
Data Handle.Flat Filed.Correct, which calls the routines
SUMER_PICK_FLAT,
SUMER_FLAT_DSTR
and SUMER_FLAT,
successively.
- Detector Saturation Correction: Click the button
Data Handle.Saturation.Correct which calls
SUMER_SAT_COR.
Be patient. It may take time.
- Detector Geometric Distortion Correction: Click the button
Data Handle.Correct Distortion which calls
SUMER_DISTORT_COR
and SUMER_DISTORT_DSTR.
Be patient. It may take time.
SUMER_TOOL Data Fitting
[Go to: How to use SUMER TOOL]
SUMER_TOOL Data Hardcopy and Save
[Go to Title Page]
How to set up SUMER_SEARCH and SUMER_TOOL
- Basically all the required routines should be available in IDL. This can be
automatically done if the SolarSoftWare(SSW) idl package is installed and SSWIDL is called with the inclusion of SUMER instrument. If the SSW idl package is not fully installed, one needs to have all the general rountines in the directory $SSW/gen
as well as this package.
- The IDL system variable !SUMER_CONFIG for the basic setting should be defined.
Its initial setup is defined by calling the routine SUMER_CONFIG_DEF. If the vaiable is
not priorly defined, SUMER_SEARCH program automatically calls SUMER_CONFIG_DEF.
One can also modify the setting by clicking the
menu button "Config" when SUMER_SEARCH is running, or by replacing the value of each field
by a suitable one on the IDL command line. The system variable !SUMER_CONFIG has the following fields:
- WORK_DIR: a working directory where results can be written.
- DATA_DIR: a local directory for SUMER data files can be found. This may be obsolete if SUMER achive directories are accessible and SUMER files are not copied to
local directories.
- LOG_DIR: a directory where SUMER log files are found.
- ACCESS: the way of data access. This may have one of the following
strings:
- ARCHIVE: if data in SOHO archive are locally available and data copy into
another local data directory (DATA_DIR) is not necessary
- COPY: if data in SOHO archive are locally available and data copy into another local data directory (DATA_DIR) is required
- FTP: if data in SOHO archive are available via FTP and
data copy into DATA_DIR is required.
- AUTO-FTP: if data in SOHO archive are available via AUTO-LOGIN
FTP and data copy into DATA_DIR is required. This option is limited to UNIX machines
and the file $HOME/.netrc should be properly defined.
- ANONY-FTP: if data in SOHO archive are available via ANONYMOUS
FTP and data copy into DATA_DIR is required.
- FTP_NODE: the node of remote machine from which SUMER data are
copied.
- FTP_OS: the OS family of the remote machine
- FTP_USER: the USER id in the remote machine
- FTP_PASSWD: the password in the remote machine
- The SUMER archive directory should be defined in a proper way. If necessary,
please check the routine SUMER_DIR.
[Go to Title Page]