2.1 Interactive graphical tools
When launched CASSIS opens its main window: Cassis-3.4.x-yymmdd-buildxxxx - IRAP.
Many tools can be used
to interactively examine a spectrum plotted via one of the models described in Section 3:
- With the mouse:
- Zooming in is performed by selecting the region with a left-click on your mouse from the upper-left corner to the lower-right
corner of the region of interest.
- Zooming out is done by holding a left-click while going from the lower-right to the upper left of the display window.
- The cursor gives
the coordinates (x-axis, y-axis) when pressing the "Shift" button while moving the mouse over the plot.
- Left clicking on the spectrum will
give the name and some parameters of the closest transition in a small pop-up window
(except for an observational datafile without any overlays).
- Right-clicking on the spectrum allows to manage the plot via the usual java "Properties..." panel.
- File > Save (top menu) will allow you to save the spectrum in different formats such as pdf, png, votable.
- Via the X Tools and Y Tools tabs at the bottom of the window:
- Shift: to displace the plotted spectrum by half of the width of the window, toward increasing (>>) or decreasing (<<) values of the axis.
- Zoom: to zoom in (+) or out (-) by a factor 2.
- Search: typing a value in the box and hitting the carriage return key or clicking on "Go" will center the axis on that value.
- Range: typing a value in the box and hitting the carriage return key or clicking on "Set" will modify the plotted range to match
the specified value.
- Xbot / Xtop : allows you to toggle the X-axis between different scales (frequency, velocity, wavelength, wavenumber, energy) and different associated units.
- The Stack/Mosaic tab is useful in the "Line Spectrum" (top) tab only:
- In the Mosaic tab (first available after clicking "Display" in the "Line Analysis" window),
List of plots allows you to specify a subset of lines, e.g., 1,3-5,8 ;
the arrows (< and >) under
Gallery number allow you to flip through all the pages needed to account for the lines specified in the "List of plots" field (default: all the lines found by the "Line Analysis" window).
- In the Stack tab (available after double-clicking on a chosen line from the mosaic),
the arrows (< and >) next to
Plot number allow you to flip through all the lines found
by the "Line Analysis" window.
The green bended arrow above the "Stack" tab allows you to go back to the mosaic.
- In both "Stack" and "Mosaic" tabs, you can choose line sorting by frequency, Eup or Aij.
- The plot panel in which the spectrum is displayed is divided in 3 sub-panels:
- top: line information (in "Line Analysis") or line lists (in "Spectrum Analysis")
- middle: spectrum and/or model
- bottom: other species
The sub-panels can be resized in order to customize the plot, for example:
Note that in several places in CASSIS, you will encounter greyed out buttons/fields. This means that we are planning
on having these functionalities in future versions of CASSIS, but that they are not yet available.
2.2 Manipulate the spectrum
In the "Full Spectrum" and "Line Spectrum" tabs,
the plot can be managed using the tabs on the right-hand side of the window:
- InfoPanel shows all the data currently in memory.
- Checking/unchecking the box on the left of a dataset
will display/remove the corresponding spectrum.
- Clicking on the 'X' on the right of a dataset will remove it from memory.
- Clicking on the color box of a given dataset will bring a pop-up window allowing you to change the color and other plot parameters.
- Overlays gives the possibility to overlay other data files and linelists.
- Species gives the possibility to overlay the positions of the transitions of all the species in the selected template, which
are present in the displayed range. This overlay can be customized by specifying the following parameters:
Thresholds and Settings (Eup, Aij), Template (choose from the pull-down menu).
- Fit tab allows baseline and line fitting with
two different algorithms: Amoeba fitter and Levenberg-Marquardt fitter.
- Manage Components pull-down menu: allows to add as many components as desired, one at a time.
The component can be either a baseline (polynomial or sinusoidal) or a line (Gaussian, Lorentzian, Voigt, or Sinc).
In case of a single component,
select the domain to be fitted by clicking-and-dragging the middle mouse button over the region.
If you do not have an external mouse,
the middle mouse can be emulated with "Alt"+click on a Mac or "Ctrl"+click on a PC.
In case of several component (e.g. a polynomial and 3 Gaussians), the procedure is the following:
 | i. add the polynomial component |
 | ii. add a Gaussian component,
select the domain to be fitted for this Gaussian by clicking-and-dragging the middle mouse button
and block the guessed values by checking the box next to "Line : Gaussian" |
 | iii. repeat for the second and third Gaussians,
making sure all values are blocked |
 | iv. click on "Reset all" in the "Selection" area |
 | v. un-blocked the values by un-checking the box next to "Line : Gaussian" |
 | vi. finally click on "Fit current" |
- Actions panel:
- Fit current: fits the last component added.
- Fit all: fits all the lines simultaneously (only in the "Line Spectrum" tab)
- Select file: opens a pop-up window to select an existing file (to append fit parameters) or
to create a new one.
- Save: save the parameters of the current fit in the file opened with "Select file". The file can be used in the rotational diagram analysis (see Section 3.6).
- Operation and Selection panels:
all toggle buttons should be self-explanatory. Some of them
are not yet active but will be in a forthcoming version of CASSIS. Moreover, depending on current action in the fitting process,
the appearance of the toggle button is not always updated. We are working on solving this issue.
-
Tools tab allows you to perform mathematical operations on spectra:
- subtract or add two spectra,
- add a constant to a spectrum,
- multiply a spectrum by a constant,
- apply smooth Hanning,
- average spectra,
- resample,
- change the frequency frame (different Vlsr),
- change from REST to SKY frequency, or the opposite.
All drop-down menus and fields in the "Parameters" section should be self-explanatory.