Changeset 3439 in Sophya for trunk/SophyaLib/Manual/piapp.tex

Timestamp:

Dec 13, 2007, 11:49:04 AM (18 years ago)

Author:

ansari

Message:

Chapitre 5 (tables and expression plotting) + figures complete ds piapp.tex - Reza 13/12/2007

File:

• trunk/SophyaLib/Manual/piapp.tex (modified) (10 diffs)

trunk/SophyaLib/Manual/piapp.tex

@@ -151 +151 @@
 contain {\tt \$SOPHYABASE /exe}. Refer to the SOPHYA overview manual 
 for more information on SOPHYA directory structure. \\
-It might also be necessary to define the environment variable 
-{\bf PIXKBMOMASK}, used by the libPI.a to map correctly 
-the {\tt <Alt>} key with some X servers (in particular with 
-X11 on MacOS X). \\
-{\tt csh> setenv PIXKBMODMASK 2 }
 \par
 {\tt (s)piapp -h} provides a brief help of the command line 
@@ -192 +187 @@
 commands can be entered in this widget. It is also possible to keep
 the terminal where piapp was started  for {\tt stdout/stderr} (flag {\tt -nored}).
-It is also possible to have a command reader on  the terminal
-({\tt stdin}), using the flag {\tt -term}. \\[1mm]
-%
-{\bf Warning:} The output redirection uses unix pipes. On Linux, with commands
-producing long outputs, the application may block because of incorrect management
-of pipes. If this happens, use piapp with  {\tt -nored} flag. This problem has been 
-in principle solved with SOPHYA V=2.1 / piapp V=4.1
+The flag {\tt -term} activate a command reader on the terminal 
+It is also possible to have a command reader on  the terminal ({\tt stdin}).  \\[1mm]
 
 \par 
@@ -208 +198 @@
 and help items. Various interactive control windows are described in appendix.
 
+\subsection{DemoPIApp and DemoData}
+The directory {\bf DemoPIApp} contains a number of example scripts, such as the 
+{\tt demo.pic} and the associated data file {\tt demo.ppf}. It contains 
+also examples of loadable modules for piapp. The  DemoPIApp/CONTENT 
+file contains a brief description of the different files. \\
+The {\bf DemoData} contains a number of data files, in PPF and FITS format, which are 
+used for the examples in this document.
+
+\subsection{Warnings/Known problems}
+\begin{enumerate} 
+\item It might  be necessary to define the environment variable 
+{\bf PIXKBMOMASK}, used by the libPI.a to map correctly 
+the {\tt <Alt>} key with some X servers (in particular with 
+X11 on MacOS X). \\
+{\tt csh> setenv PIXKBMODMASK 2 }
+However, the default value has been changed in PI/piapp V=4.1 and it should not be
+necessary anymore to define PIXKBMODMASK.
+%%
+\item The output redirection uses unix pipes. On Linux, with commands
+producing long outputs, the application may block because of incorrect management
+of pipes. If this happens, use piapp with  {\tt -nored} flag. This problem has been 
+in principle solved with SOPHYA V=2.1 / piapp V=4.1
+\end{enumerate}
 
 \newpage
@@ -232 +245 @@
 command script and sample data files.
 
-\subsection{the Object Manager (NamedObjMgr)}
+\subsection{The Object Manager (NamedObjMgr)}
 The {\bf piapp} application is built around an object manager
 (class {\tt NamedObjMgr}) and a graphic application
@@ -318 +331 @@
 It is possible to plot various expressions of objects, seen as
 a 2D table, with named columns. This possibility exist not only 
-for NTuples, but also for most objects (from SOPHYA) handled 
-by piapp. See command groups {\bf Expr.Plotting} and 
-{\bf pawCmd}
+for NTuples/DataTables, but also for most objects (from SOPHYA) handled 
+by piapp. The related commands are grouped under {\bf Expr.Plotting} and 
+{\bf pawCmd} and are described in section \ref{tableplot}.
 
 \subsection{C++ execution inside piapp}
@@ -364 +377 @@
 \end{verbatim}
 
-See command group {\bf CxxExecutorCmd} for more information,
-and the option window activated by the menu: 
-{\bf Special/CxxExecOption}.
+See section \ref{flycplusplus} and command group {\bf CxxExecutorCmd} 
+for more information.
 
 \subsection{Extending the application}
@@ -433 +445 @@
  {\bf w2eps} \myppageref{w2eps} as well the menu  \menubar{PostScript} can 
  be used to export graphics. \\[2mm]
-The examples in the followwing pages illustrates the usage of some piapp graphic commands. 
-\newpage
+The examples in the following pages illustrates the usage of some piapp graphic commands. 
+% \newpage
 \begin{enumerate}
-\item Image display 
+\item Image display. The following example uses the data file francetop.ppf
+which can be found in the {\bf DemoData} directory. This PPF file has been 
+made using topographic satellite data available from the {\bf N}ational 
+{\bf G}eophysical {\bf D}ata {\bf C}enter 
+\href{http://www.ngdc.noaa.gov/mgg/topo/globeget.html}{({\bf NGDC})}.
+\footnote{NGDC web site: \hspace{5mm} 
+http://www.ngdc.noaa.gov/mgg/topo/globeget.html }
 \begin{verbatim}
 #  Open a PPF file containing topographic data for france
 #  as a TMatrix<short> 1332x1548 
+#  The file is in the directory DemoData/
 openppf francetopo.ppf
 #  Display the matrix, whit a zoom factor, lut and color map
@@ -949 +968 @@
 
 The following commands shows how to open a FITS file containing a synchrotron map
-of our galaxy:
+of our galaxy. This file has been made, by rebinning, from the Haslam 408 MHz 
+all sky survey map, available from the NASA CMB data repository 
+\href{http://lambda.gsfc.nasa.gov/}{\bf LAMBDA}.
+\footnote{LAMBDA web site: \hspace{5mm} http://lambda.gsfc.nasa.gov/}
 \begin{verbatim}
 #  Open the fits file : the map is in HEALPix format
@@ -1095 +1117 @@
 \end{itemize}  
 
+%%%%%
+\subsection{Examples}
+The following examples illustrates the use of some Expression Plotting commands
+(see the command groups {\bf Expr. Plotting} \myppageref{ExprZZPlotting} and
+ {\bf pawCmd} \myppageref{pawCmd}).
+The {\bf pawCmd} defines a number of operations with command name and syntax 
+similar to the CERN PAW program.
+The graphic output from the examples below are shown in the figures 
+\ref{exhis2dpl} and \ref{uzcpos}.
+\begin{enumerate}
+\item 2D plot with error bars \\[1mm]
+\begin{verbatim}
+# Set the axes attibute (the font used for axes ...)
+setaxesatt 'font=helvetica,bold,16 minorticks fixedfontsize'
+#  Open the file demo.ppf (in DemoPIApp)
+openppf demo.ppf 
+print nt21
+print nt22 
+# 2D plot directly from the NTuple columns (nt2d)
+# nt2d DO NOT use a compiled c file
+nt2d nt21 x y - - - - 'font=helvetica,bold,16'
+# Overlay a plot with scaled error bars from nt22
+plot2de nt22 x y ex*0.3 ey*0.5 1 \
+  'same marker=box,7 red font=helvetica,bold,16 ' 
+\end{verbatim}
+\vspace*{4mm}
+\item Compute the histogram of pixel values for a spherical map.
+syncmap.fits has been made from Haslam 408 MHz map
+available from NASA \href{http://lambda.gsfc.nasa.gov/}{\bf LAMBDA} data server. \\[1mm]
+\begin{verbatim}
+# Open the synchrotron map file 
+# The file can be found in directory DemoData/
+readfits syncmap.fits
+# Compute and display the pixel value histogram (brightness temperature)
+n/plot syncmap.val val<200 ! ! 'font=helvetica,bold,16'
+settitle 'Sky brightness @ 408 MHz' ' ' 'font=helvetica,bold,16'
+\end{verbatim}
+\vspace*{4mm}
+\item Sources (galaxies) distribution over the sky. The data used below (uzc.ppf)
+has been extracted from the {\bf U}pdated {\bf Z}wicky {\bf C}atalog of Galaxies,
+available from the Harvard-Smithsonian Center For Astrophysics 
+\href{http://tdc-www.harvard.edu/uzc/}{CfA/UZC web site}.
+\footnote{CfA web site: \hspace{5mm} http://tdc-www.harvard.edu/uzc/} \\[1mm]
+%%% 
+\begin{verbatim}
+#  Keep the synchrotron map
+#  Open the Updated Zwicky Catalog of galaxies (in DemoData)
+openppf uzc.ppf
+zone 1 2
+# Draw a longitude-latitude grid in Molleweide projection
+mollgrid 5 7 'axesnone black font=helvetica,roman,12'
+# Overlay the sources distribution from UZC, for bright objects (mag<14)
+plot2d uzc longlat2mollX(ra*15,dec) longlat2mollY(dec) mag<14 \
+  'same red marker=circle,5'
+# Change the plot title
+settitle 'RA-Dec in degrees UZC (Updated Zwicky Catalog)' ' ' \
+  'font=helvetica,bold,16 red'
+# Display the synchrotron map
+disp syncmap 'lut=lin,2,40 grey128'
+# Add the source distribution in Galactic coordinates
+plot2d uzc longlat2mollX(glong,glat) longlat2mollY(glat) mag<14  \
+  'same nsta red marker=circle,5'
+\end{verbatim}
+\end{enumerate}
+
+\begin{figure}[p]
+\includegraphics[width=15cm]{exhis2dpl.eps}
+\caption{
+top: 2d plot example with error bars \hspace{5mm}
+bottom: Histogram of pixel values from the synchrotron map 
+of our galaxy}
+\label{exhis2dpl}
+\end{figure}
+
+\begin{figure}[p]
+\includegraphics[width=15cm]{uzcpos.eps}
+\caption{UZC: Updated Zwicky Catalog. \hspace{5mm}
+top: The galaxy position distribution in equatorial 
+$(\alpha, \delta)$ coordinates. \hspace{5mm}
+bottom: Position distribution in Galactic coordinates, superimposed on 
+the synchrotron map.}
+\label{uzcpos}
+\end{figure}
+
 %%%%%%%%%%%%%%% Section 6 :  command interpreter 
 \newpage
@@ -1394 +1500 @@
 \newpage
 \section{On the fly C++ execution}
+\label{flycplusplus}
+and the option window activated by the menu: 
+{\bf Special/CxxExecOption}.
 
 %%%%%%%%%%%%%%% Section 8 :  command reference