Changeset 28604

Timestamp:

Jul 2, 2010, 4:14:01 PM (16 years ago)

Author:

Serge CHASTEL

Message:

Doc + Missign plot definitions

Location:

trunk/ippMonitor

Files:

• Makefile.in (modified) (1 diff)
• def/README (modified) (1 diff)
• def/histogramBackgroundImage.d (modified) (1 diff)
• def/histogramZptObsImage.d (added)
• raw/ipp.plots.dat (modified) (1 diff)

trunk/ippMonitor/Makefile.in

@@ -190 +190 @@
 $(DESTWWW)/histogramBackgroundImage.php \
 $(DESTWWW)/histogramCamProcessedExpImage.php \
-$(DESTWWW)/histogramChipProcessedImfileFwhmMajorImage.php \
+$(DESTWWW)/histogramZptObsImage.php \
 $(DESTWWW)/scatterPlotAirMassFwhmImage.php \
 $(DESTWWW)/scatterCpiBgReMaImage.php \

trunk/ippMonitor/def/README

@@ -98 +98 @@
 output column in the HTML table.
 
+Drawing Figures
+===============
+- Definition files (def/*.d) MUST be appended with Image.d to allow specific
+  processing (the template is not def/autocode.php but autocodeImage.php)
+     e.g.:        plotMyStuffImage.php
+- No changes to the previous file content except for these 4 items:
+
+     1) The 'restrict' keyword should be used in the 'show' column of
+        FIELD entry if displaying the column values is wanted.
+        Such FIELDs are used in the WHERE restriction clause, not in
+        the query.
+
+        Note for developpers: actually any word different from the
+        existing keywords '', 'value', 'none', 'image=xxx',
+        'value=xxx' are ok.  No code was developped to support this
+        keyword in the scritps/generate script.
+
+     2) 'TOPLOT <list of db columns>': defines the list of columns to
+        query.
+        e.g.: 
+              TOPLOT camProcessedExp.fwhm_major
+              TOPLOT chipProcessedImfile.bg, rawExp.sun_angle
+        All values (no LIMIT) are written to a temporary (text) file
+        of the /tmp directory.
+        In a row, the different values are separated by a single space
+        (i.e. ' ').
+
+     3) 'PLOTTER <php_script_name>': defines the name of the PHP
+        script that will call an external tool (e.g. a DVO script).
+        
+        It is expected that the PHP script named 'php_script_name'
+        supports the following parameters:
+        - input: the name of an input text filename;
+        - output: the name of an output image filename;
+        - title: a string (see item 4) PLOTTITLE).
+
+        e.g.:
+                PLOTTER scatterPlot.php 
+                PLOTTER plotHistogram.php
+
+        The list of existing plotters are detailed further.
+
+     4) 'PLOTTITLE <A title>': defines the title of a figure. Could be
+        used in the external program which is effectively used for
+        rendering the figure.
+
+        e.g.:
+                PLOTTITLE A title
+
+Existing plotting scripts
+=========================
+raw/skyplot.php (calls scripts/skyplot.dvo)
+        Text input file needs to contain 3 columns
+
+raw/plotHistogram.php (calls scripts/build_histogram.dvo)
+        Text input file needs to contain 1 column
+        Computes the histogram of the input file data for 100 bins.
+
+raw/scatterPlot.php (calls scripts/pot_x_vs_y.dvo)
+        Text input file needs to contain 2 columns
+        Scatter plot of the first column values vs the second ones
+        Regression line is also plotted (correlation coefficient is
+        shown in title).
+
+Known bugs of the plotting scripts
+==================================
+- the temporary files are not deleted.

trunk/ippMonitor/def/histogramBackgroundImage.d

@@ -2 +2 @@
 TITLE New histogram background
 FILE  histogramBackgroundImage.php
-MENU  ipp.imfiles.dat
+MENU  ipp.plots.dat
 
 WHERE camRun.state = 'full'

trunk/ippMonitor/raw/ipp.plots.dat

@@ -2 +2 @@
 
 menutop   | menutop      | plain   |                                   | 
-menutop   | menutop      | link    | Simple plot - raw                      | simplePlotRawImage.php
-menutop   | menutop      | link    | Simple plot - chip                     | simplePlotChipImage.php
-menutop   | menutop      | link    | Simple plot - cam                      | simplePlotCamImage.php
+menulink  | menuselect      | link    | Simple plot - raw                   | simplePlotRawImage.php
+menulink  | menuselect      | link    | Simple plot - chip                  | simplePlotChipImage.php
+menulink  | menuselect      | link    | Simple plot - cam                   | simplePlotCamImage.php
 
 menutop   | menutop      | plain   |                                   | 
-menutop   | menutop      | link    | Histogram background                   | histogramBackgroundImage.php
-menutop   | menutop      | link    | Histogram Fwhm Major (camProcessedExp) | histogramCamProcessedExpImage.php
-menutop   | menutop      | link    | Histogram Fwhm Minor (chip processed)  | histogramChipProcessedImfileFwhmMajorImage.php
+menulink  | menuselect      | link    | Histogram background                   | histogramBackgroundImage.php
+menulink  | menuselect      | link    | Histogram Fwhm Major (camProcessedExp) | histogramCamProcessedExpImage.php
+menulink  | menuselect      | link    | Histogram Zpt Obs (camProcessedExp)  | histogramZptObsImage.php
 
 menutop   | menutop      | plain   |                                   | 
-menutop   | menutop      | link    | Plot airmass vs fwhm_major (chipProcessedImfile) | scatterPlotAirMassFwhmImage.php
-menutop   | menutop      | link    | Plot Background (chipProcessedImfile) vs Moon Angle (rawExp) | scatterCpiBgReMaImage.php
-menutop   | menutop      | link    | Plot Background (chipProcessedImfile) vs Moon Phase (rawExp) | scatterCpiBgReMpImage.php
-menutop   | menutop      | link    | Plot Background (chipProcessedImfile) vs Sun Angle (rawExp) | scatterCpiBgReSaImage.php
+menulink  | menuselect      | link    | Plot airmass vs fwhm_major (chipProcessedImfile) | scatterPlotAirMassFwhmImage.php
+menulink  | menuselect      | link    | Plot Background (chipProcessedImfile) vs Moon Angle (rawExp) | scatterCpiBgReMaImage.php
+menulink  | menuselect      | link    | Plot Background (chipProcessedImfile) vs Moon Phase (rawExp) | scatterCpiBgReMpImage.php
+menulink  | menuselect      | link    | Plot Background (chipProcessedImfile) vs Sun Angle (rawExp) | scatterCpiBgReSaImage.php