Changeset 3438 in Sophya for trunk/SophyaLib/Manual/sophya.tex

Timestamp:

Dec 12, 2007, 10:34:59 PM (18 years ago)

Author:

ansari

Message:

Ajout aknowledgments ds docs et + chapitre 5 ds piapp.tex (expression plotting) - Reza 12/12/2007

File:

• trunk/SophyaLib/Manual/sophya.tex (modified) (5 diffs)

trunk/SophyaLib/Manual/sophya.tex

@@ -43 +43 @@
 G. Le Meur           &  lemeur@lal.in2p3.fr       \\
 C. Magneville        &  cmv@hep.saclay.cea.fr     \\
-S. Henrot-Versille   &  versille@in2p3.fr     
 }
 % \auteursall
@@ -102 +101 @@
 %%%
 %%%
+\subsection{Acknowlegments}
+Many people have contributed to the development SOPHYA and/or the PI library 
+and (s)piapp interactive analysis tool.
+we are grateful to the following people:
+
+\begin{tabular}{lcl}
+Reza Ansari & \hspace{5mm} & (LAL-Univ.Paris Sud, Orsay) \\
+Eric Aubourg & & (DAPNIA-CEA/APC, Saclay) \\
+Sophie Henrot-Versille & & (LAL-IN2P3/CNRS, Orsay) \\
+Alex Kim & & (LBL, Berkeley) \\
+Guy Le Meur & & (LAL-IN2P3/CNRS, Orsay) \\
+Eric Lesquoy & & (DAPNIA-CEA, Saclay) \\
+Christophe Magneville & & (DAPNIA-CEA, Saclay) \\
+Bruno Mansoux & & (LAL-IN2P3/CNRS, Orsay) \\
+Olivier Perdereau & & (LAL-IN2P3/CNRS, Orsay) \\
+Nicolas Regnault & & (LPNHE-IN2P3/CNRS, Paris) \\
+Benoit Revenu & & (APC/Univ.Paris 7, Paris) \\
+Francois Touze & & (LAL-IN2P3/CNRS, Orsay) \\
+\end{tabular}
+
+We thank also the persons who have helped us by useful suggestions, among others : \\
+S. Bargot, S. Du, S. Plasczczynski, C. Renault and D. Yvon.
+
 \subsection{SOPHYA modules}
 \label{sopmodules}
@@ -1767 +1789 @@
 in the HTML pages of the Sophya manual.
 
+\subsection{Simplex method}
+The class {\bf MinZSimplex} implements the simplex method for non linear 
+optimization / minimization. See the SOPHYA manual for more information.
+
 \subsection{Polynomial}
 \index{Polynomial} \index{Poly} \index{Poly2}
@@ -2040 +2066 @@
 %%%
 \subsection {Spherical maps}
-SkyMap module provides three kinds of complete ($4 \pi$) spherical maps according to the
+SkyMap module provides three classes for representing data with pixels distributed over complete ($4 \pi$ steradians) spheres. These classes implements the common interface defined 
+in the base class \tcls{SphericalMap} with three different algorithms or 
 pixelization scheme. 
-SphereHEALPix represents spheres pixelized following the HEALPIix algorithm (E. Hivon, K. Gorski)
-\footnote{see the HEALPix Homepage: http://www.eso.org/kgorski/healpix/ }
-, SphereThetaPhi represents spheres pixelized following an algorithm developed at LAL-ORSAY. The example below shows creating and filling of a SphereHEALPix with nside = 8 (it will be 12*8*8= 768 pixels) :
-\index{\tcls{SphereHEALPix}} 
+The spherical maps can be instanciated for the followind data types: \\
+\hspace*{5mm} int\_4 , r\_4 (float) , r\_8 (double) , complex$<$r\_4$>$ , complex$<$r\_8$>$. \\
+The SphereHEALPix can in addition be instanciated for T=uint\_2.
+
+\begin{enumerate}
+\item \index{\tcls{SphereHEALPix}} 
+{\bf \tcls{SphereHEALPix}} implements the HEALPix 
+({\bf H}ierarchical {\bf E}qual {\bf A}rea iso{\bf L}atitude {\bf Pix}elization) scheme, 
+developped originaly by K. Gorski \& E. Hivon. Refer to 
+\href{http://healpix.jpl.nasa.gov/}{HEALPix home page} for 
+detailed information about this pixelisation scheme and related software
+\footnote{HEALPix home page: http://healpix.jpl.nasa.gov/ }.
+FITS read/write for SphereHEALPix objects is handled by the \tcls{FITS\_SphereHEALPix}
+class in module FitsIOServer.
+\item \index{\tcls{SphereThetaPhi}} 
+{\bf \tcls{SphereThetaPhi}} represents spheres pixelized following an algorithm 
+developed at LAL-ORSAY, for SOPHYA. 
+The sphere is divided into a number of rings or slices
+along the parallels, corresponding to different values of the angle $\theta$.
+Each slice is then divided into a number of pixels, with an aspect ratio close 
+to one (square pixels). Pixels are exactly iso-latitude and very uniform in surface,
+over the sphere. 
+
+\item \index{\tcls{SphereECP}}
+
+The {\bf \tcls{SphereECP}} class correspond to the cylindrical projection.
+Like SphereThetaPhi class, the sphere is divided into a number of rings
+or slices, and each ring is divided into a constant number of pixels
+along the $\varphi$ direction. Although the \tcls{SphereECP} does not have 
+equal area pixels when used for complete spheres, it can be used for 
+representing partial or full spherical maps. 
+\end{enumerate}
+
+The example below shows creating and filling of a 
+SphereHEALPix with nside = 8 
+(The sphere will have $12 \times 8 \times 8= 768$ pixels) :
 
 \begin{verbatim}
@@ -2054 +2113 @@
 \end{verbatim}
 
-SphereThetaPhi is used in a similar way with an argument representing number of slices in theta (Euler angle) for an hemisphere.
+Pixels at an angular posistion can be directly accessed through the operator \\
+\hspace*{15mm} T \tcls{SphericalMap}::operator()($\theta, \varphi$) :
+\begin{verbatim}
+#include "vector3d.h"
+#include "spherethetaphi.h"
+...
+// Create a sphere with 40 arcmin resolution
+int M = SphereThetaPhi<r_4>::ResolToSizeIndex(
+        Angle(40., Angle::ArcMin).ToRadian() );
+SphereThetaPhi<r_4> sphtp(M);
+double tet, phi;
+for (int k=0; k< sphtp.NbPixels(); k++) {
+  sphtp.PixThetaPhi(k, tet, phi);
+  sphtp(k) = cos(5.*tet)*sin(7.*phi);
+}
+cout << sphtp;
+// To save sphtp to file sphtp (if executed through runcxx)
+KeepObj(sphtp);
+\end{verbatim}
+
 \index{\tcls{SphereThetaPhi}}
-The SphereECP class correspond to the cylindrical projection and can be used for representing
-partial or full spherical maps. However, it has the disadvantage of having non uniform pixel 
-size.
-\index{\tcls{SphereECP}}
 
 \subsection {Local maps}