Setting User Parameters

The SMART Parameters are a set of parameters used by SMART in processing data. Default values are supplied for all of them, however users may change them if necessary.

The Parameters window is invoked from the "Calibration" ==> "SMART Parameters" option on the Project Manager window. Initially it looks like this :

If incorrect parameters are entered an error message will appear.

Click "Return" to continue and enter a valid value.

Once the relevant user parameter values have been set exit by clicking on one of the buttons at the foot of the box. Multiple selections of User Parameters may be selected at any one time. New Parameters are set on exit from the window. The clickable buttons at the foot of the window determine what happens on exit :

SMART Parameters

FWHM scaling factor

Values : -1.0 or range 0.1 - 30.0. System Default : -1.0

To select the system default value (-1.0) click the "SYS DEFAULT -1.0" radio button.

To select any other value click the "Range 0.1 - 30.0" radio button. Then enter the selected value in the input field next to the "Range 0.1 - 30.0" radio button. The entered value must be in the range 0.1 - 30.0. NOTE : When the system default is selected this field will display "-1.0". Choosing a value outside the range 0.1 - 30.0 will display an error.

Click "Return" to continue and enter a value in the valid range.

If a value is selected for sm_fwhmfactor which is between 0.1 and 0.99999 a warning message;

Click "OK" to continue. The entered value will be accepted and used by SMART for extraction. Values between 0.1 and 0.99999 are valid. However they can be the cause of artifacts in extracted data. Please exercise caution when using sm_fwhmfactor values between 0.1 and 0.99999.

The sm_fwhmfactor is used during extraction. Its effect is different for different extraction types :

1. Full Extraction - No effect.
2. Gaussian Extraction :
   
   
   1. Set to -1.0 (default value) :
      The full width half maximum (fwhm) factor for Gaussian fitting of each order/wavelength during extraction is taken directly from the relevant module "psf-fov" file.
      These files are listed and can be viewed/set from the "wave" functional group in Calibration Selection.
   2. Set to any positive value (range 0.1 - 30.0) the following occurs :
      
      1. The full width half maximum (fwhm) factor for Gaussian fitting of each order/wavelength during extraction
         is taken from the "S_OXPXA" and "S_OXPXB" FITS Header Keywords.
         These are set automatically during automatic extraction or manually with the Manual Source Finder.
      2. The full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords are then multiplied by the value of "!sm_fwhmfactor".
      3. To use exactly the full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords set "!sm_fwhmfactor" equal to 1.0.
      4. NOTE for High Resoloution Data :
         If an attempt is made to extract high resoloution (SH or LH) data while "!sm_fwhmfactor" is set equal to -1.0 (negative)
         then on an order by order basis it will be overridden to 1.0 (positive) just for the high resoloution data.
         Using any value for sm_fwhmfactor in the range 0.1 - 30.0 will result in high resoloution data being extracted
         in exactly the same way as low resoloution data described above.

3. Tapered Column Extraction :
   
   
   1. Set to -1.0 : (default value)
      The width of the tapered extraction column of each order/wavelength during extraction is taken directly from the relevant module "psf-fov" file.
      These files are listed and can be viewed/set from the "wave" functional group in Calibration Selection.
   2. Set to any positive value (range 0.1 - 30.0) the following occurs :
      
      1. The width of the tapered extraction column of each order/wavelength during extraction is taken from the "S_OXPXA" and "S_OXPXB" FITS Header Keywords.
         These are set automatically during automatic extraction or manually with the Manual Source Finder.
      2. The full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords are then multiplied by the value of "!sm_fwhmfactor".
      3. To use exactly the full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords set "!sm_fwhmfactor" equal to 1.0.
      4. NOTE for High Resoloution Data :
         If an attempt is made to extract high resoloution (SH or LH) data while "!sm_fwhmfactor" is set equal to -1.0 (negative)
         then on an order by order basis it will be overridden to 1.0 (positive) just for the high resoloution data.
         Using any value for sm_fwhmfactor in the range 0.1 - 30.0 will result in high resoloution data being extracted
         in exactly the same way as low resoloution data described above.

4. Fixed Column Extractions :
   
   
   1. Set to -1.0 : (default value)
      The width of the fixed extraction column of each order/wavelength during extraction is taken directly from the relevant module "psf-fov" file.
      These files are listed and can be viewed/set from the "wave" functional group in Calibration Selection.
   2. Set to any positive value (range 0.1 - 30.0) the following occurs :
      
      1. The width of the fixed extraction column of each order/wavelength during extraction is taken from the "S_OXPXA" and "S_OXPXB" FITS Header Keywords.
         These are set automatically during automatic extraction or manually with the Manual Source Finder.
      2. The full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords are then multiplied by the value of "!sm_fwhmfactor".
      3. To use exactly the full width half maximum (fwhm) values from the "S_OXPXA" and "S_OXPXB" FITS header keywords set "!sm_fwhmfactor" equal to 1.0.
      4. NOTE for High Resoloution Data :
         If an attempt is made to extract high resoloution (SH or LH) data while "!sm_fwhmfactor" is set equal to -1.0 (negative)
         then on an order by order basis it will be overridden to 1.0 (positive) just for the high resoloution data.
         Using any value for sm_fwhmfactor in the range 0.1 - 30.0 will result in high resoloution data being extracted
         in exactly the same way as low resoloution data described above.

Use of the sm_fwhmfactor user parameter during extraction is documented by the following output FITS header keywords :

Source finder plot

Values : "Show Source Finder Plot"

System Default : OFF

During automatic source finding for Tapered Column, Gaussian and Fixed Column extractions SMART attempts to find the source(s) in the data. Setting "Show Source Finder Plot" to "ON" displays the source finding as step by step plots. NOTE : With "Show Source Finder Plot" switched to "ON" any given extraction will run more slowly. Set "Show Source Finder Plot" to "OFF" to reduce run time when running SMART scripts. For more information about automatic source finding see : Automatic Source Finder

Show extraction plot

Values : "Show Extraction Plot"

System Default : OFF

During Gaussian/Tapered Column/Fixed Column extraction SMART makes Gaussian/Tapered Column/Fixed Column fits to data. Setting "Show Extraction Plot" to "ON" displays the Gaussian/Tapered Column/Fixed Column fitting as step by step plots. NOTE : With "Show Extraction Plot" switched to "ON" any given extraction will run more slowly. Set "Show Extraction Plot" to "OFF" to reduce run time when running SMART scripts. For more information about extraction types see : Spectral Extraction Types

Error plane

Values :

• 0 - "SMART Constructed Error Plane"
• 1 - "SSC Error Plane"

System Default : "SSC Error Plane"

If 1-plane data is being used then the setting of this parameters is irrelevant.

A SMART internally generated error plane will always be used because there is nothing else available. If 3-plane data is being used the results are dependent on the "sm_eplane" parameter setting :

• 0 - SMART Constructed Error Plane - an initial error plane with all error values equal to zero is used.
  When using SMART Image Operations SMART generated error plane values are the statistical variance of the corresponding flux values.
  For more information see : SMART Error and BMASK during Image Operations?.

• 1 - SSC Error Plane - the SSC supplied error (noise) plane is used.
  For more information see : SMART Error and BMASK during Image Operations?.

NOTE : For explanation of 1-plane and 3-plane type data in SMART see : Error and BMASK Plane Processing

Extracted data naming convention

Values :

• 0 - "Target + module + nod"
• 1 - "Input File + Ext. Type + "spect""

System Default : "Target + module + nod"

This is used during extraction. Once data is extracted by SMART it is presented in the IDEA Main Window and listed in the IDEA Stored Data Sets display. The extracted data will be presented with one of of two possible naming conventions. The user can select either naming convention for their own use. Both naming conventions are completely equal in all SMART processing :

• 0 - "Target + module + nod"

  EG. : HR_7341_SL2_1st
  
  NOTE :
  Using "Target + module + nod" can result in having two or more output extracted spectra with the same name.
  This can cause confusion.
  Further, if care is not taken when the data is written out of SMART it is possible that identically named data sets can overwrite each other.

• 1 - "Input File + Ext. Type + "spect""

  EG. : IRS_S0_16477184_0002_0000_3_bcd_Auto_Tapered_Column_spect
  
  NOTE :
  "Auto" designates automatic source finder extraction(s). When the Manual Source Finder is being used the extraction type in the file name will be of the form "...Manual_Gaussian_spec", etc., where the extraction type is taken from the one set in the Manual Source Finder. The extraction type (automatic or manual) is taken from the one REQUESTED by the user when extraction commences. This is not necessarilly the extraction type SMART will use for one or more of the orders in the source being extracted. In some circumstances SMART will default from the requested extraction type to another extraction type. (See Spectral Extraction Automatic Defaulting - Source and Spectral Extraction Automatic Defaulting - Module for full details.) If this occurs it is possible to have a file named with one extraction type containg data extracted with a different extraction type.

NOTE :
Any dataset can be renamed within SMART at any time using the "Change Name" function of the IDEA Stored Data Sets display or the "Rename File" function of the Dataset Manager.

Extract offset slit

Values : "Output "off nod" data"

System Default : OFF ("off-nod" extracted data is not produced.)

This is used during extraction.
When a low resoloution (SL or LL) dataset is extracted there is (usually) one slit of the SL or LL detector which does not have a (the) source visible in it. This is called the "off-nod" slit. SMART automatically extracts whatever happens to be in this "off-nod" slit (often background and/or noise). Extracted "off-nod" data is then presented in the IDEA Main Window and listed in the IDEA Stored Data Sets display.

The extracted "off-nod" data has the same name as the extracted actual source data appended "_nod1" or "_nod2" depending which slit (1 or 2) was "off" the source at observation time. Frequently the "off-nod" extraction is of limited use. Setting "sm_off_nod" to "off" will prevent the outputting of the "off-nod" extracted data.

Automatically choose calibration files

If set, calibration files are chosen automatically depending on the version of the images. If set, it is not possible to change the calibration files through the option in the main window.

Display sky subtraction during extraction

Values : Display sky subtraction during extraction

System Default : OFF (Sky subtracion is not displayed during extraction.)

SMART allows Sky Subtraction During Extraction. However subtracting sky during extraction is not necessary for extractions to be performed. Sky subtraction can be performed in other ways, for example with Image Operations. If sm_sky_sub_display is set to "OFF" then no sky subtraction of any sort whatsoever is performed during extraction. If sm_sky_sub_display is set to "ON" then during extraction the "Sky Subtraction" window appears and different types of sky subtraction may be performed on some or all of the data being extracted. For a full explanation of the operations possilbe see Sky Subtraction During Extraction.

Merge spectra with same BCDID in ISAP

by default, ISAP, when overplotting 2 spectra, merges them in a single aar structure. This is not convenient if the user wants to compare spectra from the same image with different extraction types. In such a case, the BCDID of the spectra is always the same. The user might want to choose not to merge the spectra when overplotting. If so, a new BCDID will be attributed.

Path to IRSCLEAN

Set here the path to IRSCLEAN in the system. See Calling IRSCLEAN from the dataset manager for more information.

Advanced parameters

see Advanced use of user parameters