SMART IDEA Functions

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

Fns :

This displays a drop down menu with 13 options that operate on the WHOLE PRIME AAR :

• Change Units
• Data Tags...
• Fix SWS07
• !DispAAR
• Overplot Bad Data
• Bad...
• Determine Active LWS Detector
• Convert...
• Defringe...
• Store Prime
• Undo Last Operation
• Split Apart AAR
• Merge Groups of AARs

|

Change Units :

This displays the IDEA Function Units Conversion window.

|Data Tags : |This is a drop-down help menu with 2 options :

Add Data Tag :

This option will allow you to add a new data tag and assign a value to that tag for a given YAAAR.
This routine is useful if a data tag has been lost after using IDEA Application Average. |

Increment Data Tag :

This option will allow you to increment or decrement the value of one of the tags for your entire prime dataset.
The routine will show you what tags are present, the range of values for those tags that are present and will allow you to enter
a negative or positive integer to increment the selected tag values.
One use of this routine is to allow IDEA Application Average to effectively average across different lines in an AAR.
This may be done as follows :

1. Break the AAR into one AAR for each line.
2. Use INCREMENT DATA TAG to change the line tags in each AAR to a common value.
3. Use "Merge with Prime Data Set" on IDEA Stored Data Sets to combine the AARs.
4. The lines now all have the same tag number and IDEA Application Average will average across them.
   
   

|

| |Fix SWS07 : |For SWS07 ONLY. Sets scan directions that have been misidentified as -1 by the pipeline to +1. |

!DispAAR :	Displays the AAR in a separate winddow. (Click "QUIT" to close.)
OVERPLOT BAD DATA :

When taken this option will display the message : "Use the Fns=>Bad=>Show/Remove Bad IRS data - until we implement it here :)"
To overplot bad data click the "Fns" button, then take the "Bad" option, then the "Show/Remove Bad IRS data flagged by BMASK" option.
(For details see also IDEA Function BMASK.) | | |Bad : |This is a drop-down help menu with 9 options :

Show/Remove bad IRS data flagged by BMASK :

Please see IDEA Function BMASK |

Remove bad LWS data :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the LWS "STATUS" word (see IDEA Bad Data). |

Discard LWS Post-glitch data :

Deletes data based on the LWS "STATUS" word(see IDEA Bad Data). |

Remove LWS out of band data :

Deletes data based on the LWS "STATUS" word(see IDEA Bad Data). |

Remove ALL Bad SWS Data (all options below) :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the SWS "FLAG" word (see IDEA Bad Data). |

Remove SWS data flagged as NODATA :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the SWS "FLAG" word flagged as NODATA only (see IDEA Bad Data). |

Remove SWS data flagged as GLITCHED :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the SWS "FLAG" word flagged as GLITCHED only (see IDEA Bad Data). |

Remove SWS data flagged as partially out of limit :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the SWS "FLAG" word flagged as partially OUT OF LIMIT only (see IDEA Bad Data). |

Remove SWS data flagged as totally out of limit :

This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
Deletes data based on the SWS "FLAG" word flagged as totally OUT OF LIMIT only (see IDEA Bad Data). | | |Determine Active LWS Detector : |This button will be unavailable (ie. grayed out) if your PRIME AAR is not LWS data.
A simple pop-up window lists the active detectors and corresponding line numbers for a L02 or L04 observation (ie. Where to look your expected lines.) | |Convert : |This is a drop-down help menu with 8 options :

CONVERT FLUX TO BRIGHTNESS (LWS) :

Each spectral point in the spectrum gets divided by the LWS beam solid angle; the final units will then be flux/sr.
The beam solid angle adopted is the size of the equivalent cylinder which contains the observed flux;
radii (one per detector) of this cylinder are read from the calibration file fl2bright.dat
in the directory data/cal_lws in your IDEA distribution tree.
The LWS beam sizes are still tentative; investigations are still under way and these numbers could change.

CONVERT LWS FABRY PEROT FLUX UNITS :

This button changes the flux units in a LWS Fabrey Perot AAR from w/cm^2 to w/cm^2/um by dividing the flux by wavelength.

APPLY EXTENDED SOURCE CORRECTION (LWS) :

This button applies a gain correction which takes into account the fact that the absolute, as well as relative,
calibration of the LWS was derived using a point-source; in essence, it makes the LWS calibration valid for extended sources also.
It is then clear that this button should not be used if the spectrum is from a point source. The correction factor applied to each spectral point is obtained by linear interpolation from a set of factors derived from optical modelling of the LWS instrument;
these numbers are contained in the calibration file ps2escorr.dat in the directory data/cal_lws in your IDEA distribution tree.
The LWS extended source correction factors are still tentative; investigations are still under way
and these numbers could change.

CONVERT LINE -> AOT BAND(SWS AOT 1) :

This routine was written to enable you to easily select the various AOT bands in an SWS AOT1.
The line tag is mapped to reflect the AOT band where :

BANDLINE tag |

1A	911
1B	912
1D	914
1E	915
2A	921
2B	922
2C	923
3A	931
3C	933
3D	934
3E	935
4	940
5A	951
5B	952
5C	953
5D	954
6	960

N.B. Pipeline 6 AARs (SWS01) the line tag does correspond to a single aot band (continuous counting from 1 to 16),
which is, however not yet reliable. Pipeline 7 will have the remaining bugs removed,
and the conversion in IDEA will not be necessary for those AARs. |

|Defringe : |This is a drop down menu with 3 options:

DEFRINGE LWS AOT1 :

Please see IDEA Function Defringe LWS AOT1 |

Defringe (SWS ALGORITHM) :

Please see Defringe SWS? procedure header. |

Defringe (IRS Algorithm) :

Please see SMART Defringing Method |

|STORE PRIME : |This is an EXTREMELY IMPORTANT button.
It can be found on the sub-menu from Special Functions labeled "STORE PRIME" as well as at the top of the SMART IDEA Window labeled "STORE".
The SMART IDEA Window does not automatically save your working dataset. (ie. Your PRIME AAR).
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. | |UNDO LAST OPERATION : |The undo button can be found on the sub-menu from Special Functions as well as at the top of the SMART IDEA Window.
It 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
(ie. 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. | |SPLIT APART AAR : |The split apart aar button can be found under the Special Functions submenu. It is a popup which will ask how the user wishes to split an AAR.
After splitting an AAR by the tags the user selects, these individual datasets are then stored under Stored Datasets from which they can now select. | |MERGE GROUP OF AARS : |This button allows user to combine data for common tags in a group of AARS selected from stored data sets.
The header of the output combined AAR is copied from the header of the first AAR in the group. |