Quick Links
The GUI
Installation instructions
Using it
Screen shots
Previous versions
|
|
|
|
 The GUI
A Graphical dialog to setup your data reduction. Built with QT
libraries 4 (visit the QT website).
A version of these libraries
are open-source and portable across multiple platforms. Take a look at
the screen shots (Mac OSX, Linux) and download the code.
Installation
instructions
Under Mac OSX, download the QT libraries
for
Mac OSX. Follow the
instructions to compile and install them (this is usually “./configure;
make; sudo make install”). This should install the libraries into
a directory like /usr/local/Trolltech/Qt-4.1.1, depending on the QT
version you downloaded. Then, make sure that the directory
/usr/local/Trolltech/Qt-4.1.1/bin is in your path in order to make
qmake work. You may have fetched a more recent version of QT from
Troll's website (ie.: 4.1.4). That should not be a problem. Just make
sure that your path points to the proper directory.
Under Linux, you may already have the source package of the QT
libraries installed with your system. If you do not, download and
install the QT
libraries for X11. Follow the instructions to compile
and install them (usually, you have to run “./configure; gmake; sudo
make install”). This should install the libraries into
/usr/local/Trolltech/Qt-4.1.1. Then, make sure that the directory
/usr/local/Trolltech/Qt-4.1.1/bin is in your path in order to make
qmake work.
Then, on both platforms, download the Fabry-Perot
Data reduction
wizard source (latest version: 5.03). Into the directory of the
project,
type “qmake; make”. This
will create the application's executable file (reducWizard.app under
Mac OSX, reducWizard under Linux).
Under Windows, the compiled version is readily available. Just download
and install the Fabry-Perot Data
reduction installation package (latest version: 5.03).
Using it
Next, you may use the reducWizard application to build your .adp or
.conf files
that sets the basic parameters of the data reduction process. However,
it is strongly recommended to use the new conf file that allows you to
issue a single parameter, the name of the conf file, to te data
reduction package. This file contains all the parameters needed by
computeeverything to work. You may
build the conf file from the adt file created during the observation.
The adt file contains
- the name of the object
- the observation time and date (UT)
- the X,Y and Z dimensions of the data
- the interference order of the FP etalon used
- the scanning wavelength of the observation
Make sure that the FP interference reference wavelength, object's rest
wavelength and the calibration wavelength are accurate. These values
are not available in the adt file. The values provided are default
values (the Hα line for the FP interference reference wavelength and
object's rest wavelength and the Ne line at 6598.95Å for the
calibration wavelength).
All these values allows you to calculate the FP free spectral range,
the wavelength of the first channel of the data cube and the
heliocentric velocity of the object.
To calculate the heliocentric velocity correction of the object, you
must also enter the RA and DEC coordinates of the object. Go into the
“Field” tab and enter them or use the "Query" button on the side of the
object name to fetch them from NED. The observation time should already
be
displayed (taken from the ADT). Make sure it is accurate. You may also
enter the pixel size
of the observation and the field rotation (if known). These last values
will help you include the wcs coordinates into your data files.
Now, go to the “Data reduction” tab and fill the blank spaces for the
Observation directory (the directory that contains the raw data files),
the calibration directory (the directory containing the ad3 files
created during the calibration. You may enter many calibration
directories, separated by a coma) and the output directory (where the
results of the data reduction process will be stored). Then, choose how
you want your data to be precessed. You may
- Correct the guiding errors
- Apply a spectral smoothing
- Subtract the sky emission spectrum
- Apply a spatial smoothing
- Make IDL plot some data during the reduction
process. Note that if you
chose to have the guiding errors correction, you must have the plot
enabled.
Finally, you may save your work as an adp file or conf file. This file
may then be
used by the computeeverything routine in idl.
On Mac and Linux, you may use the data reduction wizard to launch IDL
and process your
data using the conf file. In order to do so, your IDL_STARTUP
environment variable must be
accessible within the wizard. You must define it in the "General" tab.
The path to your IDL executable must also be defined in this tab. The
X11 display environment variable, DISPLAY, must also be set in this
tab for Mac users (under Leopard, the DISPLAY environment variable was
not accessible). Once this is
done, the IDL command computeeverything can be launched by clicking the
“Launch reduction” button. In order for the data reduction to work
through this mechanism, make sure that the data reduction is already
working through the IDL command-line. Read the instructions to make it
work here.
Under Windows, you can't run the data reduction directly from the
Wizard. You must launch IDL by hand and run the computeeverything
command yourself. It is usually as simple as running
- computeeverything, conffile='path_to_conffile'
Screen shots
The
"Parameters" tab
|
The "Field" tab
 |
The "Data
reduction" tab
 |
The "Deduced
parameters" tab
|
The data reduction
output window
 |
|
Previous versions
Previous version of GUI: Unnumbered version,
version 4.03.
Previous version of IDL package: Unnumbered
version, version 4.03. |
