Merge pull request #54 from discos/master

Porting changes for Medicina user guide into stable

Author: aorlati

user/medicina/ChecklistSA.rst

@@ -87,7 +87,11 @@ automatically rejected (bug under fixing).
 Remember: for full-Stokes setups, only section 0 is to be configured. 
 For spectral-only setups, both sections 0 and 1 must be configured. 
 
-** Measure RMS in order to verify the signal level ** (op)::
+**If a non-default value is needed, set the integration** (op)::
+
+	> integration=[n]  (expressed in milliseconds)
+
+**Measure RMS in order to verify the signal level** (op)::
 
 	> getRms
 

user/medicina/Quicklook.rst

@@ -9,7 +9,7 @@ it here: :download:`pdf <attachments/MED-MAN-FITS-02.pdf>`
 
 Waiting for a comprehensive GUI which is going to include also a real-time 
 preview of the data under acquisition, users are provided with two different 
-tools in order to inspect the data produced by the TPB and XARCOS. 
+tools in order to inspect the data produced by the TPB and XARCOS or SARDARA. 
 
 If writer is MANAGEMENT/FitsZilla
 =================================
@@ -22,74 +22,10 @@ last completed FITS file.
 
 .. admonition:: WARNING: 
 
-   * **The web-based tool does not work with spectral acquisitions**
+   * **The web-based tool does not work with XARCOS acquisitions**
 
-Due to a bug, only total power acquisitions can, at the moment, be viewed with 
-this new tool. 
-
-
-When acquiring FITS files through a schedule, there is also the old IDL tool available 
-for the almost-realtime quick-look of the saved data.
- 
-Open a terminal on the projects machine (see instructions provided by user support). 
-Launch IDL::
-
-    $ idl
-
-At the IDL prompt, compile and run the program fitslook.pro:: 
-
-    IDL> .r fitslook
-    IDL> fitslook
-
-The last completed FITS file (i.e. the most recent subscan carried out, either 
-being a TP or a spectral one) will be displayed. 
-
-.. note:: The program automatically identifies the recorded sections and 
-   plots them all. If you are using the multi-feed receiver with the aim of 
-   actually exploiting only the central feed, adjust your schedule so that only
-   sections 0 and 1 are enabled, otherwise all the sections will be recorded 
-   and displayed. 
-
-The plots show the proper file content, according to its continuum or spectral 
-nature. Read all the program options using::
-
-    IDL> fitslook, /help
-
-.. note:: By default, fitslook displays raw data (in arbitrary counts). 
-   Data streams in antenna temperature are available - and selectable - only 
-   for the TPB and under the condition that a Tsys has been correctly acquired 
-   prior to the execution of the scan. 
-
-.. figure:: images/IDL_quicklook.png
-   :scale: 100%
-   :alt: Quick-look of a continuum OTF scan acquired with a single-feed receiver 
-   :align: center
-   
-When performing ON-OFF spectral observations, users might also choose a 
-different quick-look, displaying the (ON-OFF)/OFF result obtained by 
-integrating all the subscans present in the last completed scan.
-Users must specify the duty cycle, e.g. '3:3:1' if each scan is composed by 
-3 on-scans, 3 off-scans and 1 cal-scan. Zero values are accepted. 
-To invoke this program::
-
-    IDL> .r onoff
-    IDL> onoff, dutyc='[N_on]:[N_off]:[N_cal]' 
-
-If wanting to display the spectra vs the topocentric radial velocity, use::
-
-    IDL> onoff, dutyc='[N_on]:[N_off]:[N_cal]', xtype='vel'
-
- 
-    
-.. figure:: images/IDL_quicklook_onoff.png
-   :scale: 100%
-   :alt: Quick-look of the (ON-OFF)/OFF scan, acquired with XARCOS in XK00 mode 
-   :align: center
-    
-Click on the above images to open the zoomable version. 
-
-Please report any problem/request about these tools, which are constantly under 
-development.
+Please report any problem/request about this tool, which is under 
+refinement.
 
 
 If writer is MANAGEMENT/Point or MANAGEMENT/CalibrationTool

user/medicina/Troubleshooting.rst

@@ -108,11 +108,7 @@ operations will become impossible to perform.
       crashed.**
 
 Pay attention to the syntax, you might have inserted unwanted characters like 
-an extra “ / ”: the *startSchedule* command must be either given as::
-
-    > startSchedule=[project]/[schedname].scd,[N]
-
-or, if you have already given the project=code command:: 
+an extra “ / ”: the *startSchedule* command must be given as::
 
     > startSchedule=[schedname].scd,[N]
 
@@ -149,16 +145,10 @@ the operatorInput panel, then starting the client in the terminal shell.
 
 .. admonition:: PROBLEM:  
 
-    * **The IDL quick-look procedures abort, or they do not actually show the 
-      latest acquisitions**
-
-These tools are all but refined. Ideally, they always show the last completed
-FITS subscan (fitslook.pro) or the last completed ON-OFF-CAL spectrum 
-(onoff.pro). Yet, to do so while avoiding incomplete subscans or unsuitable 
-files, they sometime fail. Folders containing one subscan only, as it is often 
-the case with skydips, will never produce a display, because as soon as the FITS 
-is complete a new folder is generated, and the procedure points to it. 
-When UT midnight comes, the procedure might not automatically switch to the 
-new YYYMYMMDD tree, so you might need to stop and restart it to go on 
-displaying the incoming data. Please report any problem and your "wishlist" 
-about these tools. 
+    * **The web-based quick-look is not showing XARCOS data**
+
+This is a known bug, presently under fixing. The old IDL tools are not available 
+anymore, so at the moment there is no option to visually inspect XARCOS data
+in realtime.
+
+