SPATRAM  18/09/2017
PRG Commands

PRG Commands

The complete set of keywords recognized by DAS is (the first link is for the command syntax the second one is for the corresponding function executing the command):

  1. AUTORNG (E_AutoRange)
  2. AVGCCD (E_Average)
  3. BEGIN ( E_DeltaSZA)
  4. CALIBRA (E_Calibra)
  5. DARKC (E_Dark)
  6. EXPO (E_Expo)
  7. FILTER (E_Filter)
  8. GETCCD (E_GetCCD)
  9. H_FILTER (E_Home_SM3)
  10. H_GRAT (E_Home_SM2)
  11. H_MIRROR (E_Home_SM1)
  12. HG_ON (E_Hg_Off)
  13. HG_OFF (E_Hg_On)
  14. LABEL (E_Label)
  15. MEASURE (E_Measure)
  16. MEASHOR (E_Meashor)
  17. MIRROR (E_Mirror)
  18. PLOT (E_Plot)
  19. QJ_OFF (E_Qj_Off)
  20. QJ_ON (E_Qj_On)
  21. RADIO (E_Radio)
  22. REM (E_REM)
  23. SAVE (E_Save)
  24. WAIT (E_WAIT)
  25. WAVELEN (E_Lambda)
  26. XEND ()
  27. ELAMPON (E_ExtLampON)
  28. ELAMPOFF (E_ExtLampOFF)
  29. ESHUTOP (E_ExtShutOpen)
  30. ESHUTCL (E_ExtShutClose)
  31. H_ZEN (E_Home_SM5)
  32. H_AZI (E_Home_SM6)
  33. ZENITH (E_Zenith)
  34. AZIMUTH (E_Azimuth)
  35. AAMEASURE (E_AAMeasure)
  36. AVGCCDHOR (E_AvgCCDHor)
  37. CHKEXLAMP (E_ChkExLamp)
  38. AAPOSIT (E_AAPos)
  39. IREFSUN (E_IRefSun)
  40. MEASHOR2 (E_Meashor2)
  41. SETCCDTEMP (E_SetCCDTemp)
  42. SETCCDVBIN (E_SetCCDVBin)
  43. SETCCDPOW (E_SetCCDPow)
  44. NDFILTER (E_NDFilter)
  45. H_NDFW (E_Home_SM4)
  46. DFMEASURE (E_DFMeasure)
  47. SETCCDOFFS (E_SetCCDOffSet)
  48. QJSCAN (E_QjScan) .
  49. H_GRAT_CAL (E_HGratCal) .
  50. HGSCAN (E_HgScan) .
  51. ALMUCANTAR (E_Almucantar)
  52. DIRECTSUN (E_DirectSun) . Until DAS315 the PRG files are of the type reported in the figure below.
    PRG_Example.png
    Example of PRG file for DAS version <=315
    In the previous example only some of the several KeyWords recognized by DAS are reported,
    It has to be noted that in the instructions related with the grating positioning (AVGCCD, MEASURE, WAVELEN and all the ones involving a spectral window selection, the value of the central wavelength is codified with fixed IDs ranging from 0 to 14,
    In addition the last instruction of a PRG file it has to be BEGIN (without CR after it) to ensure the repetition of the cycle.

    Starting from DAS316 the syntax of a PRG file has been changed:
    • the last instruction has to be XEND (with one or more CRs after the instruction)
    • in the instructions involving a grating positioning, the wavelength has to be used with its real value in amstrong as stored in wlstep file.
      PRG_Example_New.png
      Example of PRG file for DAS version >=316

KeyWords

  • KeyWords Table
    -# Keyword Syntax Action
    1 AUTORNG AUTORNG Perform a short measurement for the computation of the optimal exposure time
    2 AVGCCD AVGCCD m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		Averaged Measurements
    3 BEGIN BEGIN re-start the execution of the PRG file
    4 CALIBRA CALIBRA Auto calibration with HG Lamp (hg line at 4358A on pix 512)
    5 DARKC DARKC Perform a DARK Measurement (shutter closed), with the exposure time previously calculated
    6 EXPO EXPO x.xx:
    - x.xx = Exposure time (sec.)     		Set the exposure time
    7 FILTER FILTER x :
    - x = Filter wheel position (0-5 for SPATRAM, GASCODNG and TROPO; 0-7 for LIS)
    		Set the filter position
    8 GETCCD GETCCD Performs a LIGHT Measurement (shutter opened)
    9 H_FILTER H_FILTER Home for filter wheel
    10 H_GRAT H_GRAT Home for Grating
    11 H_MIRROR H_MIRROR Home for Input Mirror
    12 HG_OFF HG_OFF HG lamp off
    13 HG_ON HG_ON HG lamp on
    14 LABEL LABEL text after this command is displayed in the status label
    15 MEASURE MEASURE m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		Performs a measurement setting mirror, filter, grating, TExp.....
    16 MIRROR MIRROR mir:
    - mir = Mirror position code (0-3)     		set mirror position (0-3) (Mirror)
    17 PLOT PLOT Display Plot
    18 QJ_OFF QJ_OFF QJ lamp off
    19 QJ_ON QJ_ON QJ lamp on
    20 RADIO RADIO UnUsed
    21 REM REM text after this keyword is a comment
    22 SAVE SAVE save the measurement in the predefined file
    23 WAIT WAIT xx:
    - xx = milliseconds freezing the program     		Pause the program for xx msec
    24 WAVELEN WAVELEN wl:
    - wl = Wavelength code     		Set Grating Position
    25 XEND XEND stop the execution of the PRG file

    More keywords command are available for Horizontal-active and for Off-Axis measurements (using a telescope with a retro-refractive mirror and an Alt-Azimuth platform respectively linked to the main-body of the Spectrometer by optic-fibre)

    Available commands for TROPOGAS
    -# Keyword Syntax Action
    26 MEASHOR MEASHOR m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		horizontal measurements with external lamp
    Performs 3 measurement setting mirror, filter, grating, TExp.....
    The first measurement is made with the External lamp switched-on (or with the external shutter opened)
    The second measurement is obtained with the same exposure calculated for the first measurement,
    but with the external lamp switched-off (or the external shutter closed)
    The third measurement is made with the external lamp switched-off (or the external shutter closed),
    but exposure time is re-calculated
    27 ELAMPON ELAMPON External Lamp ON
    28 ELAMPOFF ELAMPOFF External Lamp OFF
    29 ESHUTOP ESHUTOP External Shutter OPEN
    30 ESHUTCL ESHUTCL External Shutter CLOSED
    31 AVGCCDHOR AVGCCDHOR m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		horizontal AVERAGED measurements with external lamp Performs 3 measurement setting mirror, filter, grating, TExp.....
    The first measurement is made with the External lamp switched-on (or with the external shutter opened)
    The second measurement is obtained with the same exposure calculated for the first measurement,
    but with the external lamp switched-off (or the external shutter closed)
    The third measurement is made with the external lamp switched-off (or the external shutter closed),
    but exposure time is re-calculated
    32 CHKEXLAMP CHKEXLAMP Check External lamp status ( after this procedure the External lamp has to be ON (The external Shutter has to be open)


    Available commands for TROPOGAS, SPATRAMPLUS, GASCODNG1, NG2, NG3
    -# Keyword Syntax Action
    33 H_ZEN H_ZEN Home for zenith Axis
    34 H_AZI H_AZI Home for azimuth Axis
    35 ZENITH ZENITH z.zz :
    z.zz = zenith position [-91 45]         		Positioning of zenith Axis
    36 AZIMUTH AZIMUTH a.aa :
    a.aa = azimuth position [20 305]         		Positioning of azimuth Axis
    37 AAMEASURE AAMEASURE m l f z az a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position [0, 6]
    • z = zenith position [0, 180]
    • az = azimuth position [0, 360]
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		Measuremets with Alt Azimut platform (stepper motors positioning simoultaneously)
    38 AAPOSIT AAPOSIT z.zz a.aa:
    • z.zz = zenith position [0, 180]
    • a.aa = azimuth position [0, 360]
    		Position Alt Azimuth platform with only one instruction
    39 IREFSUN IREFSUN m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position [0, 6]
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		Measuremets with Alt Azimut platform (stepper motors positioning simoultaneously)
    40 MEASHOR2 MEASHOR2 m l f a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		horizontal measurements with external lamp
    Performs 2 measurement setting mirror, filter, grating, TExp.....
    The first measurement is made with the External lamp switched-on (or with the external shutter opened)
    The second measurement is obtained with the same exposure calculated for the first measurement,
    but with the external lamp switched-off (or the external shutter closed)
    41 SETCCDTEMP SETCCDTEMP x.xx
    where:
    • x.xx = Target CCD Temperature
    		Set the CCD target Temperature
    42 SETCCDVBIN SETCCDVBIN x
    where:
    • x = Target CCD Vertical Binning
    		Set the CCD vertical Binning
    43 SETCCDPOW SETCCDPOW x
    where:
    • x = Target CCD Initial Power times 100
    		Set Target CCD Initial Power. The x has to be the desired power time 100
    i.e - init power 30% –> x = 300/n
    44 NDFILTER NDFILTER x
    where:
    • x = ND filter position
    		Set Neutral density filter wheel position/n
    45 H_NDFW H_NDFW Set Reference Position forNeutral density filter wheel/n
    46 DFMEASURE DFMEASURE m l f nf a t d s p
    where:
    • m = Mirror position 0, 3
    • l = Grating position:
      • DAS rel <= 315 –>0, 14
      • DAS rel >= 316 –> Wl_Min, Wl_Max
    • f = Filter position 0, 5(7)
    • nf= Neutral Density Filter Wheel Position 0, 5(1)
    • a = autoranging (1 perform arange; 0 do not perform)
    • t = Exposure time if the autorange fails (x.xx seconds)
    • d = make measurement (1 = Light Meas, 0 = DARK Meas.)
    • s = saving meas (1 = save, 0 = NOT save)
    • p = plot (1 = show, 0 = NOT show)
    		Performs a measurement setting mirror, filter, ndfilter grating, TExp.....
    47 SETCCDOFFS SETCCDOFFS x
    where:
    • x = [0, 512] offset value
    		Set Offset Value for CCD (Only for HiresV)/n
    48 QJSCAN QJSCAN
    		Performs a full spectral scan with QJ on to evaluate the CCD degradation /n
    49 H_GRAT_CAL H_GRAT_CAL
    		Home grating and HG calibration /n
    50 HGSCAN HGSCAN
    		Performs a full spectral scan with HG on /n
    51 ALMUCANTAR ALMUCANTAR
    		ALMUCANTAR measurements (360° in the solar plan) /n
    52 DIRECTSUN DIRECTSUN

    Performs a measurement with MIGE pointing the Sun/n

______________________________________________________________________________________
Generated on Wed Sep 20 2017 10:33:07 for SPATRAM - Rel. 18/09/2017.