SMART IDEA Positional Description

(This page is adapted from the ISAP WWW page "GUI Buttons" with all relevant acknowledgements.)

This page gives a brief description of all the buttons found on the SMART IDEA window. The descriptions are grouped roughly in the same order as the layout of the window.

Full IDEA Alphabetical Listing of SMART IDEA window buttons.

---

INPUT DATA (AAR) ID INFO :

These display the basic information about an AAR once it is input. They are located at the top left of the GUI window.

|PRIME : |The name of your working AAR. The text box is editable so you can type in a new name and then store an output AAR under a different name from the input one. |

AOT :	The AOT type of the input AAR.
OBJ :	The astronomical name of the source in the input AAR.

|REF : |The name of your reference data set. (See "Make Reference" on IDEA Applications for more information.) |

---

ABOUT the SMART IDEA window :

These buttons are located at the right hand top of the GUI window.

|Help! : |This is a drop down help menu with 7 options :

|

About :	Displays the Acknowledge SMART? window.
WWW Pages :	Invokes WWW Browser displaying SMART WWW pages.
News :	Displays a listing of what is new in SMART.
Store-Prime :	Displays the help text for the "Store-Prime" button at the top right of the GUI.

| Make AAR : |Displays the help text for the "Make AAR" button. ("Make AAR" is on the IDEA Applications window, please see !MakeAAR for more details.) | | Write To Disk : |Displays the "Help" text for the "Write to disk in..." option. (See IDEA Stored Data Sets.) |

Disclaimer :

Displays a warning that the code is under development.

| |Mail :

Displays a pop-up window to e-mail comments, suggestions and bug reports to the SMART team.

Header :

Displays a pop-up window showing the FITS header of the current input. ("Show/Edit any SIA/IDEA FITS Header")
This window also allows editing of the FITS header on a keyword by keyword basis.
Enter the relevant values in the text boxes ("Keyword", "Value" and "Comment") and use the "append", "overwrite" and "delete" buttons accordingly.
Note that the "clear fields" button clears the input fields only. It does not clear the header or previous changes from the header.

When you have finished reading/modifying the header continue by clicking on one of the "quit (no changes)"
or "exit (use modified header)" buttons at the top of the display window. (See also FITS Header Editor?.) |

Store-Prime :

This is an EXTREMELY IMPORTANT button. Clicking it will store the current data (Prime AAR). The GUI does not automatically save current data.

If you reach a stage where you wish to export the data or try two different approaches to the analysis then you should store the Prime AAR.

(A menu option with the same functionality is on the "Fns" (IDEA Functions) drop down menu.) | |Undo : | This will undo the last operation you made on your Prime AAR. It will only undo 1 previous operation.
For example if you have done 3 operations i.e. data set A-> B-> C if you click on undo you will get data set B,
if you click on undo again you will re-create data set C, click again and you get data set B, etc.

(A menu option with the same functionality is on the "Fns" (IDEA Functions) drop down menu.) | |Ref : |This displays a drop down menu with 2 options :

Store Reference :	This sets the currently displayed data as the reference dataset.
Show Reference :	This displays a pop-up window showing the current reference dataset.

(NOTE : This button will be "greyed out" (non-functional) unless a data set has been designated "reference".
See "Make Reference" on IDEA Applications for more information about reference datasets.) |

---

INPUT AAR DATA TAGS :

These display information about data tags in the input AAR(s) for user selection (part or all of data). They are located in the upper half of the GUI window.
Once an AAR is input the GUI interrogates the AAR to find out which DATA TAGS are present. If the GUI finds values for BCD, Order, Slit Pos or Module DATA TAGs it will make a clickable button for each unique value of those DATA TAGs. (If none of these DATA TAGs are present in the input AAR no clickable buttons are made, click on "plot" and all the input data will be plotted.)

If only a single unique value is found for a given DATA TAG then the default is that a single clickable button is created and it is automatically switched on.
If multiple DATA TAGs are present you must switch-on at least one in each category. Clicking "ALL" switches that whole category on. (Clicking "All" again switches the whole category off.)

For example a user could select BCD 0, Orders ALL, Slit Pos 1, Module ALL and then click on "plot" to display the results.

NOTE : The DATA TAG names are different from ISO/ISAP. Here BCD=scnt, Order=det, Slit Pos=line, Module=sdir.
For full details of the DATA TAGS and the corresponding fields in the FITS files see Data Structures?.

Data Selection Categories :

BCD :	(IDEA=scnt) The Basic Calibrated Data Set number, FITS Keywod "DCENUM".
Order :	(IDEA=det) The orders in the data. High resoloution has up to 10, low resoloution up to 3.
Slit Pos :	(IDEA=line) IRS slit position. 1=whole slit, 1-30 positions along SL/LL.
Module :	(IDEA=sdir) IRS Module number. SL1=0, SL2=1, LL1=2, LL2=3, SH=4, LH=5.

---

PLOTTING :

These buttons are used to plot and study the data. They are in a column at the left hand side of the GUI.

IRS Team Logo :

Clicking on this will display the Acknowledge SMART? window.

| Read : |This is a drop down menu with 4 options :
(For more information on AAR structure, please see Data Structures?.

|AAR FITS : | This option will read AARs in FITS format. Select this option and a file selection box will appear. Click on the relevant file to select. Then click on "OK".
The data set will be loaded into the GUI and made PRIME. If multiple files are selected each data set is loaded as a separate AAR and stored.
For multiple files/AARs one must be chosen as the "prime" data set. To do this click on "Store".
This will display a seperate window headed IDEA Stored Data Sets listing data sets. Select one as Prime and click on it.
(The associated clickable button will change to "on".)
Then click on "Apply Function to" on the IDEA Stored Data Sets window and a drop down menu will appear.
Choose "Make Prime Data Set" and the relevant file will become the Prime data set. | |AAR XDR : |This option will read AARs in IDL XDR format. The SMART IDEA window can only restore data sets saved in a specific structure called "memstor".
memstor={data_flag:data_flag,aar:aar,name:name} where DATA_FLAG INT 1 AAR STRUCT -> Array(1)
ie. AAR in standard IDEA IDL format. NAME STRING 'AAA' name of the data set.
As with FITS files, if multiple data sets are read in one must be chosen as "prime". Use the same procedure to choose one. | |AAR ASCII : |This option will read in data given as an ascii file with at least two but no more than fifteen columns.

The ascii files are converted to YAAAR structures upon read in. Columns must be separated by one or more blanks.
There are three types of ASCII files that the GUI can read. For examples and a more detailed explanation of these see ASCII READ.
As with FITS files, if multiple data sets are read in one must be chosen as Prime. Use the same procedure to choose one. | |SURVEY PRODUCT : |This option will read in the Survey Products which are ASCII FITS files that were generated by the ISO Browse software in the ISO Archive.

As with FITS files, if multiple data sets are read in one must be chosen as Prime. Use the same procedure to choose one. |

| |Store : |This displays a seperate window IDEA Stored Data Sets. | |2Proj : |This will copy all spectra currently in the IDEA window to the Dataset Manager for storage while leaving the IDEA window open and active to continue analysis.
Copied spectra are stored in the Project Manager with the names assigned to them in the IDEA window. |

Style :

This displays a seperate window IDEA Plot Style Preferences.

|Plot : |Plots the chosen data based on selection of the Data Tag buttons and using IDEA Plot Style Preferences. | |Fns : |This displays a drop down IDEA Functions menu with 13 options that operate on the WHOLE PRIME AAR. |

Bad :	This displays a seperate window Bad Data Removal.
CFO :	Performs Check For Overrides.

---

MOUSE and QUIT :

These buttons are used to control mouse function and exit the GUI. They are at the left hand side of the GUI, below the Plotting buttons.

| Mouse : |This displays a drop down menu with 9 options :

Fix STDEV
Mask
Tippex
!UnMask
Zap
Zap Assoc
Zap Masked
Selection Info
End Mouse Preselect

The first 8 are IDEA Applications that can be switched on or off. (The same as can be accessed from the IDEA Applications window.)

When the SMART IDEA window is first invoked none of the IDEA Applications are active and the clickable button displays "OFF".
Selecting any of the first 8 options from the drop down menu invokes that IDEA Application ready for use and the name on the button changes accordingly.
Selecting the last option "End Mouse Preselect" switches off any invoked IDEA Application and returns the button display to "OFF". | | QUIT: |This ends your GUI Session - YOU MUST SAVE YOUR DATA BEFORE QUITTING!
For example, if you wish to save your Prime AAR, you must first store it (see IDEA Stored Data Sets) then Write it either as an IDL saveset, a FITS file or in ASCII format.

If you do not want to exit, click the mouse button outside of the GUI window to cancel the selection. |

---

X and Y CO-ORDINATES :

These display and enable setting and freezing the X and Y ranges of the display box. They are in a column at the right hand side of the GUI.

|X : |X position of mouse cursor on the display box in units of the x-axis. (Changes with "Change Units" on the "Fns" (IDEA Functions drop down menu.) | |Y : |Y position of mouse cursor on the display box in units of the y-axis. (Changes with "Change Units" on the "Fns" (IDEA Functions drop down menu.) | |Freeze : |Click "on" to freeze x and y co-ordinate range values set in the min/max boxes.
Click "off" to unfreeze. (Default=off.) |

Xmin :	Text box to set minimum value of x co-ordinate range. (Default=input data minimum.)
Xmax :	Text box to set maximum value of x co-ordinate range. (Default=input data maximum.)
Ymin :	Text box to set minimum value of y co-ordinate range. (Default=input data minimum.)
Ymax :	Text box to set maximum value of y co-ordinate range. (Default=input data maximum.)

Having set and frozen a range click Replot to plot just that range in the display box.

---

REPLOTTING and OUTPUT :

These buttons allow replotting of data. They are in a column at the right hand side of the GUI, below the X and Y co-ordinate buttons.

|Replot : | Click on this button to :

• Replot data with different range(s) that have been set in the max/min boxes and (un)frozen with the "Freeze" button.
• Replot original data after using one or more of the IDEA Applications.
• Replot original data after changing ranges using the Copy Range button.

| |Unzoom : |Click on this button to reverse the effect of "zooming" with the left mouse button. | |Copy Range : |Plots data in exactly the plot range of the previous plot.
For instance, when using "Average" on the IDEA Applications window, if you zoom in on the data in the "before" display, and then click on "copied range" in the "after" display,
the averaged data in "after" will be plotted with exactly the same range as "before". | |Hard Copy : | A Pop-up widget gives the option of writing either a color or black and white postscript file to disk. (Default=black and white (B/W).)

The filename can be edited. (Default="hardcopy.ps".) The title for a hardcopy plot can be edited. (Default=object name).
Click "OK" to make the postscript file or "CANCEL" to quit without generating a postscript file. |

---

MOUSE BUTTONS :

The normal defaults of the mouse buttons on the data display box are :

|Left Mouse Button : |Draws a rectangular area selecting data which is then zoomed to fill the whole display box. (The effect can be reversed by clicking on the Unzoom button.) | |Right Mouse Button : |Draws a rectangular area selecting data for further processing with one or more of the IDEA Applications and displays the IDEA Applications Menu Window. |

---

LOWER BOX :

The lower part of the SMART IDEA window contains a display box with a scrollable list of all actions during the current session.