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.
    

    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.
      

      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