#SpectrumExplorer_demo_feb2011.py: prepared for HIFI DP 
#        workshop February 2011
#
#
# v0.0 04/Feb/2011 ACAB: created
#
#

#SpectrumExplorer has MANY options. We refer for a complete description
#to Chapter 2.2.4 in the Herschel Data Analysis Guide.

# load band 1B DBS raster map observation from lstore/
obs=getObservation("1342205474",poolName="1342205474_map_dbs_1b")


#double-click on 'obs' in the variables box. 
#Expand 'level2'
#Click with right mouse button on WBS-H-LSB and select
#'Open With SpectrumExplorer' (hereafter this will
#be the default when double-clicking on a dataset).
#Click on product '0'
#This will show entries of all scans in this product.
#You may need to expand the window or scroll to see all entries.

#9 spectra are indicated, with boxes for each WBS sub-band

#click on one of the gray boxes to plot one sub-band of one scan

#clicking on any gray button will overplot the corresponding
#spectrum. Double-clicking will remove it.

#click 'All

#mouse actions on the plotted spectrum are determined by
#the mode buttons at the very top. Hover above them to see
#their function.

#The same modes and more can be selected using the right mouse button
#on the plot window.

#plot a grid of spectra on the sky using the second button on the right.

#IMPORTANT NOTE: SpectrumExplorer can be used to modify spectra (smooth, flag etc.).
#This will only work if the actual dataset is loaded into memory, not the
#context or product. To do this, single-click on one of the spectra under box_001
#and drag it to the Variable window. Then right-mouse-->Open With-->SpectrumExplorer
#(or double-click on the variable if you have done this before)

#spectrum can be zoomed by clicking 5th box from left and using
#left mouse button to draw a box

#click button 7 from left and use left mouse button to pan
#through the spectrum. 

#Middle mouse button provides automatic panning (move mouse a little
#to indicate pan direction).

#unzoom by clicking right mouse button-->Autorange-->With/Without Flags.
#(control-left mouse button does the same on many but not 
#all operating systems)

#multiple datasets (e.g. from different observations)
#can be overplotted as well. 
#To do this, click and drag another dataset from the ObservationViewer to
#the Variables window and then to the SpectrumExplorer window.

#SpectrumExplorer can be used to flag points and remove spectra.
#To flag points, click on top bar button "Select one or more datapoints",
#draw a box with the left mouse button. The selected points are indicated with
#circles. Then do an operation on those points by clicking on the right mouse
#button and select "Point selection". 
#To show that this worked, click on 'Show Flags' and the flagged regions
#will be highlighted.

#Other operations can be applied with right-mouse-->Dialogs-->Toolbox 
#select a task to perform...for example, 'Statistics' to determine the
#RMS noise. The middle mouse button can be used to apply the operation
#on selected ranges.

#Other operations can be applied to selected ranges by using the middle
#mouse button. A gray bar will appear. Click on the 'Select one or more spectra'
#button, and drag and drop the selected spectrum in the Variables window.
#Then with right-mouse-->Dialogs-->Toolbox select a task to perform...for example,
#fit a Gaussian.