source: Sophya/trunk/SophyaLib/Manual/modifs.tex@ 3548

Last change on this file since 3548 was 3548, checked in by ansari, 17 years ago

Mise a jour fichier modifs suite ajout table RGB32768 et debug PIImage - Reza 17/11/2008

File size: 65.6 KB
Line 
1\documentclass[twoside,11pt,A4]{article}
2% \documentclass[twoside,11pt,A4]{report}
3\usepackage[french]{babel}
4
5% \usepackage[T1]{fontenc}
6\usepackage[applemac]{inputenc}
7\usepackage{palatino}
8% \usepackage{times}
9% package pour ecrire DRAFT en fond de page
10% \usepackage[light,all,draft]{draftcopy}
11
12% \usepackage{epsfig}
13\usepackage{graphicx}
14\usepackage{amsmath}
15\usepackage{amssymb}
16
17\setlength{\textwidth}{16cm}
18\setlength{\textheight}{23 cm}
19\setlength{\topmargin}{0.2cm}
20\setlength{\oddsidemargin}{0.cm}
21\setlength{\evensidemargin}{0.cm}
22\setlength{\unitlength}{1mm}
23
24\newcommand{\tcls}[1] {#1$<$T$>$}
25\newcommand{\tclsc}[2] {#1$<$#2$>$}
26
27\newcommand{\rond}{$\bullet \ $}
28\newcommand{\etoile}{$\star \ $}
29\newcommand{\cercle}{$\circ \ $}
30\newcommand{\carre}{$\Box \ $}
31
32%%%% Pour le decoupage en sections
33% \newcommand{\groupe}[1]{\chapter{#1}}
34% \newcommand{\titre}[1]{\section{#1}}
35% \newcommand{\soustitre}[1]{\subsection{#1}}
36%%%
37\newcommand{\groupe}[1]{\section{#1}}
38\newcommand{\titre}[1]{\subsection{#1}}
39\newcommand{\soustitre}[1]{\subsubsection{#1}}
40%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
41%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
42\begin{document}
43\begin{titlepage}
44\begin{center}
45{\Large \bf SOPHYA Change Log \\[1mm]
46 Liste des modifications de SOPHYA } \\[5mm]
47{\large Septembre 2003 - Septembre 2008 } \\[25mm]
48Liste des tags et dates : \\[5mm]
49{\large
50\begin{tabular}{lcl}
51V = 0.727 & \hspace{10mm} & Octobre 1999 \\
52V = 0.8 & \hspace{10mm} & F\'evrier 2000 \\
53V = 1.1 & \hspace{10mm} & F\'evrier 2001 \\
54V = 1.2 & \hspace{10mm} & Juillet 2001 \\
55V = 1.3 & \hspace{10mm} & Novembre 2001 \\
56V = 1.5 & \hspace{10mm} & D\'ecembre 2002 \\
57V = 1.7 & \hspace{10mm} & Septembre 2003 \\
58V = 1.9 & \hspace{10mm} & Juin 2005 - SANS tag CVS \\
59V = 1.9xx & \hspace{10mm} & 09/2005 ... 09/2006 \\
60V = 2.0 & \hspace{10mm} & Septembre 2006 - tag CVS \\
61V = 2.046 & \hspace{10mm} & Ao\^{u}t 2007 - NO tag \\
62V = 2.1 & \hspace{10mm} & Novembre 2007 - tag CVS \\
63V = 2.1xx & \hspace{10mm} & 12/ 2007 - \ldots \\
64V = 2.125 & \hspace{10mm} & Sept-Oct 2008 - NO tag \\
65
66\end{tabular}
67} \\[8mm]
68%%%%%%
69\begin{tabular}{ll}
70R. Ansari & ansari@lal.in2p3.fr \\
71C. Magneville & cmv@hep.saclay.cea.fr
72\end{tabular}
73\\[5mm]
74\today
75\end{center}
76\end{titlepage}
77
78\newpage
79\tableofcontents
80\newpage
81
82%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
83%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
84\groupe{De V2.1 (Dec2007) ˆ V2.2 \ldots }
85\titre{BaseTools}
86\begin{itemize}
87\item[\rond] A FAIRE : heritage des PExceptions de std::exception
88\item[\rond] Oct 2008 : Suppression des flags {\tt OS\_xxx (OS\_MACOSX OS\_LINUX OS\_AIX ...) }
89de machdefs\_mkmf.h et ajout constructeur MuTyV(uint\_4, uint\_8)
90\end{itemize}
91
92\titre{TArray}
93\begin{itemize}
94\item[\rond] Jan 2008 : Correction bug de protection dans TArray::Resize() \\
95(lors de resize avec ndim=BASEARRAY\_MAXNDIMS = 5)
96\end{itemize}
97
98\titre{SkyMap/Samba}
99\begin{itemize}
100\item[\rond] Sep 2008 : Nettoyage cosmetique ds lambdaBuilder.h .cc - {\bf A FAIRE :} rendre
101LambdaLMBuilder thread-safe.
102\item[\rond] Aout 2008 {\bf (Samba)}: Nettoyage cosmetique ds alm.h .cc, utilisation de la
103classe RandomGenerator par la classe Alm$<$T$>$. Possibilite de specifier un objet
104RandomGenerator au constructeur de la classe SphericalTransformServer. Adaptation
105programme PrgMap/cl2map.cc.
106\item[\rond] Aout 2008 {\bf (SkyMap)} : modifs/correction ds la classe SphereECP$<$T$>$.
107Ajout m\'ethode \\
108{\tt SphereECP<T>::ExtractPartial() } \hspace{5mm} et correction calcul phi ds \\
109{\tt SphereECP<T>::PixThetaPhi() } et modif programme Tests/tsphereecp.cc
110\end{itemize}
111
112\titre{NTools}
113\begin{itemize}
114\item[\rond] Oct 2008 : Instanciation explicite des classes
115\tcls{Image} et \tcls{ArrayFitter} pour T=uint\_4, uint\_8
116\end{itemize}
117
118\titre{FitsIOServer}
119\begin{itemize}
120\item[\rond] Avril 2008 : Ajout m\'ethodes de lecture/Žcriture tableaux avec offset: \\
121{\tt FitsArrayHandler::ReadAtOffset() , WriteAtOffset() } \\
122$\longrightarrow$ PossibilitŽ de lecture/Žcriture de tableaux par morceaux
123de HDU IMAGE
124\item[\rond] Jan 2008 : Ajout {\tt FitsInOutFile::SetBScaleBZero(...)} et type LONGLONG
125pour HDU\_Image. Enregistrement conditionnel handler TArray$<$int\_8$>$.
126\end{itemize}
127
128\titre{PI/piapp}
129{\bf IMPORTANT } Reste a faire : debug / prise en charge des images avec tables de couleurs de plus de
130256 entrees dans fichier postscript.
131\begin{itemize}
132\item[\rond] Nov 2008 {\bf PIext} Ajout commande {\bf pirgbdisp} - Lecture et affichage d'image RGB
133(objet PIPixRGBArray)
134\item[\rond] Nov 2008 {\bf PI} Optimisation classe LUT, introduction typeExp
135\item[\rond] Oct 2008 {\bf PIext} : Instanciation explicite et enregistrement des adaptateurs NObjMgrAdapter pour TArray, et TMatrix/TVector $<$T$>$ pour T=uint\_4, uint\_8
136\item[\rond] Sep-Nov 2008 {\bf PI} : Modifs importantes pour permettre la visalisation des images
137ou photos couleurs (RGB) ds piapp :
138\begin{enumerate}
139\item Introduction des classes auxiliaires PIPixColIdx , PIPixRGB , PIPixRGBArray
140(nouveau fichier pipixutils.cc .h) pour support de tables de couleurs avec $>$ 256 couleurs.
141\item Ajout de tables de couleurs RGB (RGB216CM , RGB512CM, RGB4096CM, RGB32768CM)
142pour representation d'images/photos couleurs RGB
143\item Extension et modification de la classe P2DArrayAdapter, introduction de la methode
144P2DArrayAdapter::MeanVal()
145\item Modif de la classe LUT pour introduction typeRGB et methode LUT::ApplyRGB()
146\end{enumerate}
147\item[\rond] Avril 2008 {\bf (PI)}: Ajout d\'ecodage options sens des axes X,Y ˆ PiScDrawWdg. \\
148{\tt revax = axerl } (kAxeDirRtoL) \hspace{5mm} {\tt axelr} (kAxeDirLtoR) \\
149{\tt revay = axeud} (kAxeDirUpDown) \hspace{5mm} {\tt axedu} ((kAxeDirDownUp)
150\item[\rond] Fevrier 2008 {\bf (PI)}: Nouvelle m\'ethode de calcul de limite de LUT\\
151On garde les $frackeep$ valeurs centrales des pixels, cad on vire les $(1-frackeep)/2$
152valeurs les plus petites et les $(1-frackeep)/2$ valeurs les plus grandes.
153\begin{verbatim}
154 autolut=hisrng,frackeep,min,max
155\end{verbatim}
156\item[\rond] Janvier 2008 {\bf (ProgPI)} Ajout de l'option {\tt -nobsz} ˆ la commande {\bf readfits}
157et ajout de la commande de lecture array from fits : {\bf rdfitsarr}
158\end{itemize}
159
160\groupe{De V2.0 (Sep2006) ˆ V2.1 (Nov2007) }
161\titre{BuildMgr}
162\begin{itemize}
163\item[\rond] Nov 2007 : configure detecte Linux 64 bits {(\tt -> /usr/X11R6/lib64)}
164et correction bug lors de l'execution de sed pour la creation de sophyamake.inc
165{\tt AIX, -X 64 }.
166\item[\rond] Oct 2007 : Ajout flag {\tt -alsofftwfloat} au script pour compilation/link
167methodes float (r\_4) de FFTWServer.
168\item[\rond] Avril 2007 : AmŽlioration du script configure, qui prend en charge
169la gestion des diffŽrents flags de compilation (mis dans fichier machdefs.h gŽnŽrŽ
170ou dans sophyamake.inc (pour les flags du compilateur) - Nettoyage du fichier
171BaseTools/machdefs\_mkmf.h et des fichiers osname\_compilo.inc
172\begin{verbatim}
173csh> cd BuildMgr/
174csh> ./configure -h
175configure [-sbase SOPHYABASE] [-scxx SOPHYACXX] [-incln]
176 [-minc mymake.inc] [-compopt 'cc/cxxOptions']
177 [-arch64] [-sasz64] [-nofpic] [-nothsafe] [-boundcheck] [-sodebug]
178 [-extp dir1 -extp dir2 ...] [-extip dir1 -extip dir2 ... ]
179 [-extlp dir1 -extlp dir2 ... ]
180 [-noextlib] [-noext fits] [-noext fftw]
181 [-noext lapack] [-noext astro]
182 [-noPI] [-slballinone]
183 [-usefftw2 -uselapack2]
184 (See SOPHYA manual/web pages for a detailed description
185 of configure options)
186\end{verbatim}
187\end{itemize}
188
189%%%%%%
190\titre{BaseTools}
191\begin{itemize}
192\item[\rond] Novembre 2007 : Ajout de la classe de gŽnŽrateur alŽatoire
193thread-safe {\bf RandomGenerator } - fichiers {\tt stsrand.h .cc} -
194Ajout du programme {\tt Tests/tmtrnd,3.cc }.\\
195Correction , protection I/O PPF pour NDataBlock de taille nulle.
196\item[\rond] Aout 2007 : Passage numŽro de version SOPHYA V=2.135
197ˆ V=2.046 - Les numŽros V=A.B sont dŽsormais rŽservŽs aux versions
198avec un tag cvs.
199\item[\rond] Avril 2007 : {\bf ThreadSafe } \hspace{5mm}
200Les opŽrations de partage de rŽfŽrence rendues thread-safe pour les classes
201{\bf NDataBlock$<$T$>$ , SegDataBlock$<$T$>$, SwSegDataBlock$<$T$>$}
202\begin{itemize}
203\item Ajout de la classe {\bf ThSafeOp} avec les mŽthodes {\tt lock() , unlock() } utilisant
204un mutex.
205\item Ces mŽthodes peuvent tre rendues transparentes (sans effet) en activant le flag \\
206{\tt SO\_NOTHSAFE} (option -nothsafe de configure)
207\item Cette protection / synchronisation semble tre efficace en ce qui concerne les
208constructeurs de copie et l'extraction de sous-tableaux pour TArray, TMatrix,TVector.
209(programme de vŽrification Tests/zthr.cc - option sync ).
210\item En ce qui concerne les classes SegDataBlock , SwSegDataBlock, l'efficacitŽ
211de la protection n'a pas ŽtŽ testŽe. Les opŽrations d'Žcriture sur les DataTable
212devront aussi tre protŽgŽes pour l'utilisation multi-thread.
213\end{itemize}
214\item[\rond] Avril 2007 : Nettoyage du fichier machdefs\_mkmf.h, suppression des flags
215de compilation optionnelle MacOS 8.x 9.x / compilo CodeWarrior
216\item[\rond] Fev 2007 : Ajout methode NDataBlock::RenewObjId() , et Dealloc() (alias de Delete())
217et correction bug ds SwSegDataBlock::GetCstSegment()
218\end{itemize}
219
220%%%%%%
221\titre{TArray}
222\begin{itemize}
223\item[\rond] Oct 07 : MŽthode TArray::SumX2() renommŽe en SumSq(), Norm2() appelle SumSq() sauf pour les tableaux complexes, o on calcule une norme rŽelle positive (Sum[el x conj(el)).
224\item[\rond] Avr 07 : Constructeur de copie et extraction de sous-tableaux rendus thread-safe
225(voir ci-dessus)
226\item[\rond] Jan 07 : Ajout classes/methodes de cast de contenu - sans conversion (fichier arrctcast.h)
227\item[\rond] Fev 07 : Ajout methode TArray::RenewObjId() (reecriture PPF), et ZeroSize()
228(deallocation tableau / le rendre vierge=sans taille)
229\end{itemize}
230
231%%%%%%
232\titre{HiStats}
233
234\begin{itemize}
235\item[\rond] Novembre 2007 : Les methodes de remplissage de NTuple {\tt Fill() }
236et de DataTable, SwPPFDataTable {\tt AddRow() }, ainsi que
237{\tt BaseDataTable::GetRow() } rendues thread-safe. \\
238Activation avec la methode {\tt SetThreadSafe(bool fg=true) }
239pour chaque NTuple ou DataTable / SwPPFDataTable. Ajout du programme Tests/tmtdt.cc.
240\item[\rond] Janvier 2007 : Remaniement de la classe HistoErr: elle n'h\'erite plus
241de Histo et devient stand-alone avec des TVector comme support des donne\'ees. \\
242Introduction de la classe Histo2DErr qui fait la meme chose que HistoErr
243mais \`a $2$ dimensions. \\
244Modifs des adaptateurs: NOMAdapter\_Histo ne contient plus HistoErr,
245et NOMAdapter\_HistoErr, NOMAdapter\_Histo2DErr sont cr\'ees dans PIext.
246
247\end{itemize}
248
249%%%%%%
250\titre{SkyMap}
251
252\begin{itemize}
253\item[\rond] Aou 2007 : Correction de signe dans {\tt LocalMap::PixToSphereC()} suite message de
254S. Plaszczynski du 12/07/07
255\item[\rond] Fev 2007 : Ajout methode RenewObjId() (reecriture PPF) pour les cartes spheriques
256et localmap
257\end{itemize}
258
259%%%%%%
260\titre{SysTools}
261
262\begin{itemize}
263\item[\rond] Jul 2007 : Ajout d'acces au temps CPU et elapsed ds la classe Timer - et
264ajout test specifique dans Tests/tcmd.cc {\tt (tcmd timer)}. \\
265{\tt Timer::TotalElapsedTime() , PartialElapsedTime() , TotalCPUTime() , PartialCPUTime() }
266\end{itemize}
267
268%%%%%%
269\titre{FitsIOServer}
270
271\begin{itemize}
272\item[\rond] Nov 2007 : propagation des modifs BaseDataTable-Thread-safe dans
273SwFitsDataTable. Mais les SwFitsDataTable NE sont toujours pas thread-safe.
274\item[\rond] Jan/Fev 2007 : Passage a la version LONGLONG ( fits\_xxxll ) permettant
275la gestion de tailles $ > 2^{32} $
276\end{itemize}
277
278\titre{IFFTW}
279
280\begin{itemize}
281\item[\rond] Nov 2007 : Correction resize tableau de sortie {\tt FFT(complexe -> reel)} multi-dim.
282\item[\rond] Oct 2007 : Ajout version float (r\_4) des methodes {\tt FFTForward} et {\tt FFTBackward}
283a la classe FFTWServer. (compilation sous condition et flag -alsofftwfloat du script configure)
284\end{itemize}
285
286%%%%%%
287\titre{PI/piapp}
288\begin{itemize}
289%%%
290\item[\rond] Novembre 2007 {\bf PIext/ProgPI}: \\
291- Ajout commande de trace d'ellipse d'erreur {\tt errorellipse} \\
292- Axes en degres (0..360, -90..90) pour la projection molleweide et adaptation de la commande {\tt mollgrid}. Suppression de mollgridsph. \\
293- Ajout fonctions tetphi2mollX/Y() et longlat2mollX/Y() ds les fichiers d'expressi
294on ntuple generes par piapp pour trace sur projection de type molleweide. \\
295- Ajout flag [-s] a openppf . openfits/savefits comme alias de readfits/writefits.
296- Verification arret thread Reveil avant destruction de l'objet.
297\item[\rond] Octobre 2007 {\bf (PI/PIext)}: Ajout methodes de redirection stdout/stderr vers un objet PIConsole,
298a travers un fichier disque (fichiers PI/piapplx.h .cc) avec possibilite de recopie sur stdout/stderr
299original (terminal) - en plus d'affichage sur PIConsole. \\
300+ Adaptation au niveau de PIext/pistdimgapp.h .cc et ProgPI/piapp.cc \\
301+ la redirection passe par les fichiers PIATmp\_xxx/sout.log /serr.log \\
302+ le flag (s)piapp -doublered permet la redirection avec recopie sur terminal
303%%%
304\item[\rond] Octobre 2007 {\bf (PIext)}: Correction/protection au niveau de gestion des locks de mutex
305(classes NamedObjMgr , PIStdImgApp) pour eviter les blocages de l'application sous certaines
306conditions ( lors de l'affichage de la fenetre de gestion d'objets et lecture PPF). \\
307Modification des classes NamedObjMgr . ObjMgrWind, la methode
308{ \tt UpdateObjMgrWindow() } de NamedObjMgr en particulier. \\
309Ajout de la classe {\bf SOpExObj} (ds piacmd.h piacmd.cc) pour executer
310- de maniere asynchrone -
311les commandes display,print \ldots sur les objets, initiees au niveau
312de la boucle d'evenements (fenetre ObjMgrWind).
313\item[\rond] Octobre 2007 {\bf (PIext)}: Ajout attributs graphiques \\
314{\tt samew=WdgName } specification de widget cible pour trace en superposition \\
315{\tt wname=Nom } Pour specifier un nom de widget (= nom d'objet par defaut) \\
316{\tt inset=fx1,fx2,fy1,fy2 } pour specifier la position du drawer en inset (medaillon)
317\item[\rond] Octobre 2007 {\bf (PIGcont/PIext)}: Codage mŽthode PIContourDrawer::GetOptionsHelpInfo() pour le traceur de contour. \\
318Ajout accs aux attributs {\tt min max minmax sumsq norm2 } aux niveau des adaptateurs
319des objets de type TArray, TMatrix, TVector ({\tt \$\{arrName.sumsq\} \$\{arrName.min\} } \ldots).
320\item[\rond] Aout 2007 {\bf (PI)}: Nouvelles mŽthodes de calcul de limite de LUT
321dans PIImage (AutoLut) et ajout du dŽcodage de l'option {\tt autolut=alt[,ns[,minp,maxp]]}.
322Si {\tt minp,maxp} spŽcifiŽs, seuls les pixels entre {\tt minp <= pixval <= maxp}
323sont utilisŽs pour le calcul des limites.
324\begin{verbatim}
325 autolut=minmax,frac Fraction de la dynamique totale
326 autolut=meansig,ns min=mean-ns*sigma , max=mean+ns*sigma
327 autolut=histail,ns Queue de l'histo des pixels
328 autolut=hispeak,ns Pic de l'histo des pixels
329\end{verbatim}
330%
331\item[\rond] Aout 2007 {\bf (PI)}: Contournement d'un problme d'Žvenements X expose
332perdu - apparu avec des versions rŽcentes du serveur XFree ou le serveur X sur Linux
333ou une combinaison des deux. RŽsultat, contenu non affichŽ lors d'une crŽation de fentre
334suivi d'un ajout de PIBaseWidget (sauf PIImage) et plantage lors du click dans la fentre.
335Correction: Ajout de {\tt XFlush() + usleep(5000)} (5 $\mu$s).
336\item[\rond] Juin 2007 {\bf (PI/PIext)}: Ajout des mŽthodes
337{\tt PIGraphicAtt::ColNameToColor() , ColIndexToColor()} et possibilitŽ d'utiliser le contenu
338d'une colonne d'une table comme nom de couleur ou numŽro de couleur pour le tracŽ
339des markers par PINTuple {\tt PINTuple::SelectColorByName() , SelectColorByIndex()}.
340Ajout des commandes {\bf nt2dcn} et {\bf nt2dci} et {\bf plot2dc} ds piapp.
341\item[\rond] Avril 2007 {\bf (PI)}: La source des problmes sur MacOS/PowerPC (G4/G5)
342et AIX (architecture Power) a finalement ŽtŽ identifiŽ et corrigŽ/
343Parmi ces problmes: des pull-down menus mal placŽs (MenuBar), ou encore des
344dysfonctionnement de boutons dans les fentres de dialogues. \\
345Source et correction: \hspace{5mm} {\tt XtMoveWidget / XtResizeWidget} remplacŽ par \\
346\hspace*{10mm} {\tt XtMakeGeometryRequest}
347\item[\rond] Avril 2007 {\bf (PIext/piapp)}:
348\begin{itemize}
349\item Ajout de la classe {\bf NOMAdapter\_DVList}
350pour la prise en charge des objets DVList.
351Accs aux variables par {\tt \$\{dvlName.varName\} }
352\item Accs ˆ l'objet DVList attachŽ aux TArray, TMatrix, DataTable et NTuple par \\
353\hspace*{5mm} {\tt \$\{objName.info.varName\} }
354\item L'adaptateur de DataTable permet aussi d'accŽder aux lignes de la table par \\
355\hspace*{5mm} {\tt \$\{tableName.row.num\} }
356\item Prise en charge de la classe {\tt Image<T>} par l'adaptateur des matrices
357{\tt NOMAdapter\_TMatrix<T> } au lieu de l'adaptateur spŽcifique
358{\tt NOMAdapter\_Image<T> }
359\end{itemize}
360\item[ \rond] Janvier 2007 {\bf (PIext)}: modification des trac\'es des histogrammes PIHisto.
361La classe PIHisto prend en entr\'ee un wrapper P1DHistoWrapper.
362Les wrappers HistoWrapper et HistoErrWrapper sont cr\'ees.
363Ainsi les HistoErr peuvent \^etre dessin\'es sous forme d'histogrammes.
364Mise en place des options graphiques permettant de dessiner les
365valeurs (``val''), erreurs (``err'') et le nombre d'entr\'ees par bin (``nb'')
366pour les HistoErr. Idem pour les versions $2$ dimensions.
367\end{itemize}
368
369%%%%%%%%
370\titre{Documentation (Manual/) }
371\begin{itemize}
372\item[\rond] Jan 2007 : Ajout fichier de mesure de performances comparees entre
373differentes processeur / OS / compilateur {\tt perfmachine.txt }
374\end{itemize}
375
376
377%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
378%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
379\groupe{De V1.7 (Sep2003) ˆ V2.0 (Sep2006) }
380\titre{BuildMgr}
381\begin{itemize}
382\item[\rond] Juin 2006 : Ajout targets cleanobj prgall tests prgutil
383\item[\rond] Avril 2006 : suppression de libextsophya.so pour fabriquer libPI.so
384(PIext rendu independant de FitsIOServer)
385\item[\rond] Dec 2005/Jan 2006 : Portage sur AIX - xlC
386\item[\rond] Dec 2005 : check Compil avec icc , compil avec gcc-4
387\item[\rond] Avril-Mai 2005 : Introduction de la nouvelle version de
388scripts de gestion du code - avec un script principal configure. \\
389Variable d'environnement {\bf SOPHYABASE } - \\
390Pour les makefiles, l'ensemble des dŽfinitions se trouve dans : \\
391SOPHYABASE/include/sophyamake.ic \\
392\end{itemize}
393
394%%%%%%
395\titre{BaseTools}
396
397\soustitre{Modifs}
398
399\begin{itemize}
400\item[\rond] Jun/Jul 2006 : Amelioration gestion initialiseur modules \\
401- Ajout methodes statique {\tt RegisterModule(const char* name, double version)
402ListModules(ostream\& os) } a la classe de base SophyaInitiator. \\
403- Enregistrement des modules avec leur nom et un numero de version par module,
404independante du numero de version SOPHYA \\
405- le programme scanppf peut donner la liste des modules enregistrees et leur numero
406de version.
407\item[\rond] Octobre-Novembre 2005 : \\
4081/ Correction bug TimeStamp::ToDays() + petites amelioration \\
4092/ Prise en compte du type TimeStamp dans MuTyV (sous forme de double en interne) \\
4103/ Adaptation DVList a modifs MuTyV (typ TimeStamp) et R/W PPersist \\
4114/ Gestion format YYYY-MM-DDThh:mm:ss par TimeStamp \\
4125/ Gestionnaire PPersist pour TimeStamp
413%
414\item[\rond] Septembre 2004 - {\bf Namespace SOPHYA } \\
415Suppression de {\tt using namespace SOPHYA ; } ds machdefs.h -
416Ajout fichier {\tt \#include "sopnamsp.h"} dans les .cc de SOPHYA,
417ainsi que lors de la gŽnŽration automatique du code (runxx, c++exec)
418\end{itemize}
419
420\soustitre{PPF}
421\begin{itemize}
422\item[\rond] Avril 2005 - Ajout de wrapper de lecture/ecriture PPF pour les vecteurs de
423la librairie standard (classe PPFWrapperSTLVector$<$T$>$ ) fichier ppfwrapstlv.h
424\item[\rond] Ajout de la classes utilitaire PPF\_TPointer\_IO$<$T$>$
425(fichiers ppftpointer.h .cc)
426\item[\rond] Amelioration de l'impression ds AnalyseTags (ppfbinstream.cc)
427\item[\rond] scanppf.cc revision 1.8 (2005/04/05)
428modification programme scanppf: ajout option -lh -lho pour lister les classes PP
429ersist handler
430\item[\rond] DŽcembre 2003 (9/12/2003) Fin de l'ensemble des modifs pour les
431PPF V3 \\
432- Ecriture nombre complexes r4, r8 avec tag spŽcifique. \\
433Tag de positionnement sous forme de \\
434\centerline{\tt <tag (1 byte)><FilePosition (8 byte, long int)> } \\
435- Ecriture PosTagTable \\
436- Ecriture Statistiques en fin de fichier \\
437- Voir BaseTools/ppfbinstream.h: \\
438\centerline{\tt GotoPositionTag(int\_8 pos) , }
439\centerline{\tt GetPosTagTable(...) }
440\centerline{\tt int\_8 WritePositionTag() PutPosTagTable(...) }
441- Ajout programme de test Tests/ppftswap.cc
442\item[\rond] DŽcembre 2003 - Ajout ppfbinstream.h .cc \\
443Classes PPFBinaryIOStream , PPFBinaryInputStream , PPFBinaryOutputStream
444\item[\rond] Novembre 2003 (21/11/2003) - Ajout rawstream.h .cc \\
445Classes RawInOutStream , RawInFileStream , RawOutFileStream
446
447\end{itemize}
448
449
450\soustitre{Nouvelles classes}
451\begin{itemize}
452\item[\rond] Ajout de la classe {\bf TimeStamp} pour la manipulation de date et heure -
453calcul de duree. - Ajout du prog. test Tests/ttimestamp.cc (Mars 2005)
454\item[\rond] { \bf Segmented Data Block :} \\
455Mars-Avril 2005: Introduction des classes similaires aux NDataBlock, mais permettant
456de gerer des blocs de donnees segementes, pour tout type de donnees, de structures
457et de classes (template pour tout type T).
458\begin{enumerate}
459\item Ajout de la classe {\tt SegDataBlock<T>} (et l'interface { \tt SegDBInterface<T>} )
460pour la gestion de blocs de donnees segmentes (segdatablock.h) et son
461gestionnaire PPF {\tt FIO\_SegDataBlock<T>} (fichier fiosegdb.h )
462\item Ajout de la classe {\tt SwSegDataBlock<T>} (Data bloc segmente avec gestion
463de swap) et la classe swapper PPF {\tt PPFDataSwapper<T>} (fichiers
464ppfswapper.h et swsegdb.h)
465\item Ajout programme de test Tests/tstsegdb.cc
466\end{enumerate}
467\end{itemize}
468
469%%%%%
470\titre{TArray}
471%%
472Il s'agit essentiellement des ameliorations en terme de performances et
473de correction d'erreur.
474
475\begin{itemize}
476\item[\rond] Avril 2006 \\
477- Instanciation explicite des tableaux , matrices et vecteurs en types \\
478{\tt int\_2 uint\_2 uint\_4 uint\_8 } \\
479- Optimisation du code (ds tarray.cc) des operations sur tableaux \\
480{\tt (TArray::Add/Mul/Sub/DivCst TArray::Add/Mul/Sub/DivElt ) } \\
481a travers le choix entre Share() ou Allocation si le tableau resultat est non alloue.
482D'apres les tests de performances (TCPU), {\bf (tjet , spar)}, il ne semble pas y
483avoir de cas de pertes, et on a en general des gains de l'ordre de 20\% dans la plupart
484des cas de tests, et un ou deux cas avec des gains de 50-80\%. \\
485- Declaration de l'operateur / entre tableaux (DivElt) et l'operateur \& \& pour la
486multiplication element par element (MulElt)
487\item[\rond] Janvier, FŽvrier 2006 \\
488- AmŽlioration des fonctionalitŽs de la classe {\bf Range} et des mŽthodes d'extraction
489de sous-tableaux (+ correction bugs et amŽlioration documentation) \\
490- Ajout de la methode BaseArray::ValueAtPositionDB() pour corriger un gros bug au
491niveau de la conversion de type (r\_4 r\_8 ...) des tableaux \\
492- Compil avec g++ 4 : ajouts fichiers declarations privees tmatrix\_tsnl.h tvector\_tsnl.h
493
494\item[\rond] Juillet 2004 \\
495- Optimisation de la multiplication matricielle (CMV) - Extrait du
496message (from CMV) du 30 Juillet 2004: \\
497\begin{verbatim}
498- on definit un flag d'optimisation
499 Contrairement a ce qu'on avait dit, je n'ai pas ajoute
500 un argument a Multiply car on ne peut pas jouer
501 avec qiand on utilise l'operateur * surcharge.
502 Or au vu des performance il'ma parut interessant que l'utilisateur
503 meme lambda puisse choisir le niveau d'optimisation
504 --> donc j'ai ajoute une methode statis dans BaseArray::
505 void BaseArray::SetMatProdOpt(uint_2);
506 uint_2 BaseArray::GetMatProdOpt();
507
508- Je n'ai refait les test de rapidite que sur OSF:
509
5101./ pour les matrices 1000x1000 (grosses)
511 on arrive effectivement au meme temps pour les 4 cas
512 si on copie dans le cas lent (FxC)
513 ---EndMultiply FxC CPUTime: Total= 93.1296 (Partial= 69.3806) Sec.
514 devient
515 ---EndMultiply FxC CPUTime: Total= 34.9653 (Partial= 11.1829) Sec.
516 exactement comme les copains:
517 La copie prend de la place mais ne prend absolument
518 pas de temps pour les grosses matrices
519
5202./ pour les matrices 10x10 (1000000 multiplications par cas)
521 on a bien ce que l'on attend a savoir que
522 la copie faites 100000 fois finie par nous faire perdre du temps
523 ---EndMultiply FxC CPUTime: Total= 37.4152 (Partial= 12.4662) Sec.
524 devient
525 ---EndMultiply FxC CPUTime: Total= 53.9978 (Partial= 28.8322) Sec.
526 dans ce cas on perd un gros facteur 2 a cause de la copie
527 mais rien de surprenant la dedans.
528
529-----------------------------------------------------------------------
530- ensuite j'ai implemente une prise de decision au niveau de
531l'optimisation pour les petites matrices:
532le test est simple mais me semble OK:
533je calcule sza taille du NDataBlock de A
534 szb B
535si ((sza+szb)*sizeof(T) < 100000 ) pas d'optimisation
536IDEE: on pifometre que raisonnablement il y a 100 koctets
537 de disponible pour les matrices A et B dans le cache processeur
538 et que dans ce cas elles sont copiees toutes les 2 dans le cache
539 par l'optimiseur du compilo qui est tres malin et surtout qui
540 veux absolument nous faire plaisir......
541
542-----------------------------------------------------------------
543===> Les resultats sont dans le fichier toto.calc en attached
544.. En tete tu as l'explication des flags d'optimisation
545...Avec les 2 sections:
546 GROSSE MATRICE
547 et
548 PETITE MATRICE
549\end{verbatim}
550
551\item[\rond] Juillet 2004 : Optimisation operations diverses, en particulier \\
5521) Remplacement des methodes Add/Sub/Mul/DivElt(a) par
553 Add/Sub/Mul/DivElt(TArray a, TArray res) \\
5542) Operateurs += -= A+B A-B TArray et TMatrix/TVecteur modifies en consequence
555\item[\rond] Extrait de {\tt cvs log tarray.cc }
556{\small \begin{verbatim}
557----------------------------
558revision 1.38
559date: 2004/07/30 13:31:39; author: ansari; state: Exp; lines: +28 -24
560Diverses petites optimisations ds les methodes operations/affectations de TArray - Reza 30 Juillet 2004
561----------------------------
562----------------------------
563revision 1.36
564date: 2004/07/27 11:44:23; author: ansari; state: Exp; lines: +4 -1
565Corrections bug apres modifs methods Add/Sub/Mul/DivCst(x,res) - Reza 27 Juillet 2004
566----------------------------
567revision 1.35
568date: 2004/07/26 17:30:40; author: ansari; state: Exp; lines: +187 -108
569Remplacement methodes Add/Mul/Sub/Div(T x) par AddCst/MulCst/SubCst/DivCst(T x, TArray<T> res) ds TArray - Reza 26 Juillet 2004
570----------------------------
571\end{verbatim} }
572
573\item[\rond] Extrait de {\tt cvs log tarray.cc }
574{\small \begin{verbatim}
575----------------------------
576revision 1.27
577date: 2004/07/30 10:24:12; author: cmv; state: Exp; lines: +97 -32
578- Intro decision auto d'optimisation produit de matrices
579- Possibilite a l'utilisateur pour choisir l'optimisation
580- cas FxC optimise par copie
581 cmv 30/07/04
582----------------------------
583revision 1.26
584date: 2004/07/29 12:31:16; author: ansari; state: Exp; lines: +7 -5
5851/ Remplacement des methodes Add/Sub/Mul/DivElt(a) par
586 Add/Sub/Mul/DivElt(TArray a, TArray res)
5872/ Operateurs += -= A+B A-B TArray et TMatrix/TVecteur modifies en consequence
5883/ Ajout methode TArray::ScalarProduct()
5894/ Methode TArray::SetT renomme en SetCst() SetT garde en alias
5905/ Ajout parametre bool fzero (mise a zero) ajoute ds constructeur et
591 ReSize() de TMatrix et TVecteur.
592 Reza 29/07/2004
593----------------------------
594revision 1.25
595date: 2004/07/29 08:40:49; author: cmv; state: Exp; lines: +148 -1
596Optimisation produit de matrice a la sauce cmv 29/07/04
597----------------------------
598\end{verbatim} }
599
600\end{itemize}
601
602
603%%%%%%%%
604\titre{HiStats}
605%%%%%
606\soustitre{Classe Histo,HProf,HistoErr,Histo2D }
607\noindent
608- Aout 2006 : refonte profonde des allocations memoire et delete de
609 Histo,HProf,HistoErr,Histo2D pour faciliter la gestion des IO FITS. \\
610- Sept 2004 : Ajout classe HistoErr.
611C'est un Histo qui garde le nombre d'entr\'ees dans chaque bin) \\
612\soustitre{NTuple}
613la classe NTuple peut maintenant avoir des colonnes float ou double.
614Il y a maintenant deux methodes Fill(r\_4 *) et Fill(r\_8 *)
615Les noms ne sont plus limites a 8 caracteres.
616
617
618\soustitre{ Les DataTable (SuperNTuple) }
619
620{\bf Octobre-Novembre 2005 } \\
621\begin{itemize}
622\item[\rond] Ajout classe {\bf DataTableRow} pour manipulation d'une ligne de la table.
623Ajout/maj methode BaseDataTable::EmptyRow() AddRow() GetRow()
624\item[\rond] Gestion des types {\tt complex<r\_4> , complex<r\_8> , TimeStamp } par
625BaseDataTable, DataTable et SwPPFDataTable
626\item[\rond] Codage methode Print() (Dump ascii) et NTFrAscii (decodage fichier
627text) dans BaseDataTable.
628\item[\rond] Codage mŽthode BaseDataTable::GetColumnD() pour recuperer
629une colonne de la table en {\tt TVector<r\_8>} - NON TESTE
630\end{itemize}
631
632\begin{verbatim}
633BaseDataTable
634 -------- DataTable
635 -------- SwPPFDataTable
636\end{verbatim}
637
638\noindent {\bf BaseDataTable} : Classe de base, avec qques methodes virtuelles
639pures, implementent la presque totalite des fonctionalites, en particulier
640celles de l'interface NTupleInterface.
641
642\noindent {\bf DataTable} : Implementation concrete de BaseDataTable avec donnees en
643memoire \\
644(utilise SegDataBlock$<$T$>$ pour stocker les colonnes)
645
646\noindent {\bf SwPPFDataTable} : Implementation concrete de BaseDataTable avec donnees
647en swap sur stream PPF (POutPersist)- \\
648Utilise (SwSegDataBlock$<$T$>$ avec
649un data-swapper PPF (classe PPFDataSwapper$<$T$>$ )
650
651DataTable et SwPPFDataTable respecte +/- les conventions SOPHYA ,
652constructeur de copie avec partage ou copie de donnees, operateur =
653Datatable : partage et copie , = : fait une copie
654SwPPFDataTable : C'est toujours partage (presque par definition)
655Autre point, compte tenu de la structure des streams PPF ,
656les SwPPFDataTable fonctionne en ecriture OU en lecture, mais
657pas les deux a la fois.
658
659Classe de gestion de persistence commune : \\
660{\bf ObjFileIO$<$BaseDataTable$>$ }
661
662Lit et ecrit les DataTable et SwPPFDataTable
663Actuellement, on ne peut les relires que dans le meme type,
664cad on ne peut relire avec un SwPPFDataTable un objet
665ecrit comme DataTable - mais cette possibilite pourra
666peut-etre codee ulterieurement (d'ou l'interet en particulier
667d'un gestionnaire commun ObjFileIO$<$BaseDataTable$>$
668
669(les operateurs habituel $<<$ et $>>$ sur PIn/OutPersist sont definies)
670
671
672Les merges et copie sont prevues,
673on doit en principe pouvoir ecrire par exemple:
674\begin{verbatim}
675SwPPFDataTable swdt;
676PInPersist pis("swdt.ppf");
677pis >> swdt;
678DataTable dt;
679dt = swdt; // Pour tout charger en memoire
680\end{verbatim}
681
682{\it On pourra aussi ajouter des methodes d'acces aux variables
683membres pour enrichier l'interface. }
684
685
686{\bf DataTable cote PIAPP :} \\
687Cote piapp, les DataTable et SwPPFDataTable sont pris en charge par
688{\tt NOMAdapter\_DataTable} (qui prend en charge tous les 'BaseDataTable' )
689Il faudrait peut-etre rajouter deux commandes : \\
690newdt ou newdatatable
691newdt ncol col1 [col2 .... ] \\
692avec possibilite de specifier coli sous fome de X:colname ou X = D,F,S,I,L ...
693et puis dtfromascii ...
694
695Voir Tests/tnt.cc pour exemple d'utilisation :
696\begin{verbatim}
697DataTable dt(64);
698dt.AddIntegerColumn("line");
699dt.AddDoubleColumn("x");
700dt.AddFloatColumn("f_sin");
701MuTyV rec[10];
702for(int k = 0; k<1000; k++) {
703 rec[0] = k;
704 double x = M_PI*k/100.;
705 double fx = sin(x)*cos(x);
706 rec[1] = x;
707 rec[2] = sin(x);
708}
709 POutPersist po("dtable.ppf");
710 po << dt;
711\end{verbatim}
712
713Pour SwPPFDataTable, il faut juste creer un stream PPF avant, qui doit rester
714ouvert tant que le SwPPFDataTable est actif: \\
715\begin{verbatim}
716 POutPersist po("swdtable.ppf");
717 SwPPFDataTable dt(po, 64);
718\end{verbatim}
719
720
721
722\titre{SkyMap}
723%%%
724\begin{itemize}
725\item[\rond] Juin 2006: Prise en charge du rangement mŽmoire {\bf NESTED} dans
726les SphereHEALPix , + I/O PPF et FITS
727\item[\rond] Juin 2006: Nettoyage et amŽliorations diverses dans les classes
728Vector3d, UnitVector, LongLat \ldots et les cartes sphŽriques, en particulier :
729\begin{enumerate}
730\item Nettoyage/uniformation mŽthodes {\tt Print()} des cartes, et
731 ajout de la mŽthode {\tt Show()} dans PixelMap
732 \item Ajout mŽthodes {\tt HasSymThetaSlice() , GetSymThetaSliceIndex() }
733 dans les cartes sphŽriques (SphericalMap)
734 \item Ajout methode {\tt ResolToSizeIndex() SizeIndexToResol() }
735 ds SphereThetaPhi , SphereHEALPix et SphereECP
736 \item Petites optimisations dans {\tt GetThetaSlice()} + methode {\tt GetThetaSliceDataPtr() }
737 \end{enumerate}
738\item[\rond] Juin 2006: Introduction de la classe {\bf Angle} - pour conversion d'angle.
739\begin{verbatim}
740 // Example to convert 0.035 radians to arcsec
741 double vr = 0.035;
742 cout << "Angle rad= " << vr << " ->arcsec= " << Angle(vr).ToArcSec() << endl;
743 // Example to convert 2.3 arcmin to radian - we use the conversion operator
744 double vam = 2.3;
745 cout << "Angle arcmin= " << vam << " ->rad= "
746 << (double)Angle(vam, Angle::ArcMin) << endl;
747\end{verbatim}
748%
749
750
751\item[\rond] {\bf SphereECP} - Septembre 2004 \\
752Extrait du message du 7 Septembre 2004
753\begin{verbatim}
754 J'ai mis dans la base (module SkyMap) le code de la classe
755SphereECP<T> (pixelisation avec projection cylindrique) - carte partielle et complete,
756+ gestionnaire PPersist + modifs adaptateur NomSkyMapAdaptor (PIext/ spiapp)
757
758Programme test (avec appel a transforme en Alm) ds Test/tsphereecp.cc
759Attention, mettre le parametere de pixelisation a -1 lors de l'appel a Generate pour eviter
760le Resize de la sphereECP
761ylmserver.GenerateFromCl(map, -1, clin, 0.);
762
763Dans piapp, c'est visualise par defaut en projection Molleweide
764On peut ajouter dans les options d'affichage :
765ecparray : affichage direct du tableau TArray des pixels (X:Phi, Y:Theta)
766Si option ecparray, on peut preciser en plus
767 - ecpscaledeg: echelle des axes en degres au lieu de pixels
768 - ecpscalerad: echelle des axes en radians au lieu de pixels
769Exemple:
770Cmd> disp mapecp 'ecparray ecpscaledeg zoomx2 stdaxes'
771\end{verbatim}
772
773\item[\rond] Bug non corrigŽ ds classe Circle
774\begin{verbatim}
775From: Laurence Perotto <perotto@cdf.in2p3.fr>
776Date: Mon Jan 5, 2004 4:59:12 PM Europe/Paris
777To: Reza Ansari <ansari@lal.in2p3.fr>, Christophe Magneville <cmv@hep.saclay.cea.fr>
778Subject: un bug dans sophya...
779
780 Bonjour et bonne annee a tous les deux...
781
782 Je viens de trouver un ptit bug dans la fonction TanOnCircle de la classe Circle: Il
783s'agit d'un melange entre les coordonnees (beta, lambda) de Benoit et les (theta, phi)
784utilises dans Sophya. Lors du passage de l'un a l'autre, une transfo sin->cos a ete
785oubliee...
786 Voila...
787 Bonne journee.
788
789 Laurence.
790\end{verbatim}
791\end{itemize}
792
793\titre{Samba }
794
795\begin{itemize}
796\item[\rond] {\bf Juin 2006:} correction bug de calcul $a_{lm} \rightarrow$ SphereHEALPix
797(zones polar cap): le problme venant du choix de taille lors du calcul de la transformŽ
798de Fourier complex $\rightarrow$ rŽel (n/2 - 1 ou n/2 -2) .
799Correction dans {\tt RfourierSynthesisFromB } et utilisation de cette mŽthode
800pour tout type de carte.
801On gagne un peu encore en temps de calcul - sur asc (OSF1-cxx) , avec
802SphereThetaPhi(m=400), $l_{max} = 511$ \\[2mm]
803\begin{tabular}{|l|c|c|}
804\hline
805OpŽration & TCPU Avant & TCPU Aprs OPT \\
806\hline
807map $\rightarrow a_{lm}$ & 10 s & 3.6 s. \\
808$a_{lm} \rightarrow$ map & 26 & 10.5 s. \\
809\hline
810\end{tabular} \\[1mm]
811%
812\item[\rond] {\bf Mai 2006:} Optimisation calcul transformŽ en harmoniques sphŽriques
813{\bf SphericalTransformServer}. \\
814Au lieu de calculer un tableau de $\lambda_{lm}$ dans LambdaLMBuilder
815et utiliser ensuite ce tableau, on calcule les sommes nŽcessaires au vol,
816dans des mŽthodes spŽcifiques de la classe LambdaLMBuilder qui
817sont utilisŽes dans SphericalTransformServer (pour les transformŽs
818scalaire/tempŽrature) - PAS fait pour la polarisation pour le moment.
819On peut encore gagner un facteur 2 en utilisant la symŽtrie
820en $\theta <> \pi-\theta$. \\
821Extrait de cvs log :
822\begin{verbatim}
823revision 1.8
824date: 2006/06/01 11:34:50; author: ansari; state: Exp; lines: +147 -12
8251/ passage en sa_size_t (au lieu de int) dans Alm<T> et Bm<T>
8262/ Ajout des methodes optimisees (statiques) pour calcul transforme Ylm
827ds LambdaLMBuilder et utilisation ds SphericalTransformServer
828 Reza , 1/06/2006
829\end{verbatim}
830
831\item[\rond] {\bf Fin 2004} : Tests et vŽrifications des polynomes de Legendre.
832La classe LambdaLMBuilder donne les bons r\'esultats mais calcule les Plm
833pour tous les $l,m$.
834Introduction d'une routine (C-like) ``HarmSph\_array\_teta'' qui calcule
835les Plm pour $m$ fix\'e et $l\in [0,l_{max}]$ comme ce qui est fait
836dans la GSL... (la routine GSL ne marche pas corectement).
837\end{itemize}
838
839%%%%%%%%%%%
840\titre{SysTools}
841{\bf Mai-Juin 2006 } classe ZThread - petites modifs/amŽliorations liŽes
842ˆ la gestion des signaux et mŽthodes kill
843
844\soustitre{Classe SOPHYA::Commander (module SysTools) }
845Mai-Juin 2006:
846Debug (?) de gestion/controle des threads dans la classe Commander -
847Extrait de cvs log :
848\begin{verbatim}
849date: 2006/05/29 17:27:35; author: ansari; state: Exp; lines: +62 -11
850Ajout gestionnaire signal ds ZThread et correction/adaptation gestion des thread
851s (killthr) dans Commander - Reza 29 mai 2006
852----------------------------
853revision 1.7
854date: 2006/04/26 15:22:09; author: ansari; state: Exp; lines: +13 -0
855ajout methode ZThread::kill() pour envoi de signal a un thread + remplacement Ca
856ncelThread par StopThread (par kill/SIGUSR1) dans Commander (commander.cc) + ame
857----------------------------
858revision 1.22
859date: 2006/05/31 12:30:13; author: ansari; state: Exp; lines: +20 -11
860correction gestion & pour ThrExec ds Commander - Reza 31/05/2006
861----------------------------
862revision 1.21
863date: 2006/05/29 17:27:35; author: ansari; state: Exp; lines: +37 -16
864Ajout gestionnaire signal ds ZThread et correction/adaptation gestion des thread
865s (killthr) dans Commander - Reza 29 mai 2006
866----------------------------
867revision 1.20
868date: 2006/04/26 15:22:08; author: ansari; state: Exp; lines: +55 -15
869ajout methode ZThread::kill() pour envoi de signal a un thread + remplacement Ca
870ncelThread par StopThread (par kill/SIGUSR1) dans Commander (commander.cc) + ame
871lioration documentation , Reza 26/4/2006
872
873\end{verbatim}
874
875Mars-Avril 2004 :
876Classe d'interprŽteur de ligne de commande inspire de C-Shell,
877destine a etre incluee dans des applications C/C++. \\
878( Programme test Test/tcmd.cc ) \\
879Avril 2005 : Introduction de la possibilite d'execution de commandes
880en multithreads \\
881Avril 2005 : Controle strict sur les noms de variables, limites
882aux caracteres alphanumeriques + underscore - Adaptation
883de l'algorithme de substitution en consequence.
884
885{\bf Mini guide de l'interpreteur - Message du 19 Mars 2004 } \
886
887\begin{itemize}
888
889\item[\rond] {\bf Gestion des variables } \\
890 - Les variables sont non typees toutes traitees comme des chaines
891de caracteres.
892 - Acces aux variables d'environnement -
893 - Un niveau variable d'environnement application est aussi prevu
894 - Toutes les variables de l'interpreteur sont traitees comme des vecteurs.
895extensibles automatiquement (difference avec le C-Shell)
896
897\item[\rond] {\bf Creation / initialisation de variables } \\
898\begin{verbatim}
899Cmd> set sv StringValue
900# Suppression d'une variable : unset ou clearvar
901Cmd> unset sv
902
903# Initialisation de type vecteur - Espace avant/apres ')' et avant ')' obligatoire
904Cmd> set vecv ( mot1 mot2 mot3 mot4 mot5 )
905#Calcul numerique : expression de type C - Espace avant/apres '=' obligatoire
906Cmd> a = 2+3*sqrt(4)
907# Le signe egal peut etre utilise pour attribuer une chaine de caracteres
908Cmd> a = 'Bonjour Madame'
909# Un element de tableau peut etre specifie avant le signe egal
910Cmd> vecv[2] = 'coucou'
911# Ou bien
912Cmd> i = 3
913Cmd> vecv[i] = 'Ooohhh'
914\end{verbatim}
915
916A droite du signe egal (membre de droite), les variables doivent etre
917adressees a l'aide du signe \$.
918
919Une chaine peut etre cassee en mots a l'aide de la commande var2words
920\begin{verbatim}
921Cmd> var2words varname wordvarname [separateur]
922\end{verbatim}
923
924\item[\rond] {\bf Acces aux variables } \\
925L'acces aux variables s'effectue par le signe \$ {\tt \$varname} .
926Les {\tt \$xxx} sont remplaces par le contenu de la variable xxx.
927Cette substitution ne s'effectue pas entre simple quotes {\tt ' ... \$xxx '},
928mais se fait entre double quotes {\tt " ... \$xxx ... "} . Les formes
929{\tt \${vname} } ou {\tt \$(vname)} peuvent etre utilisees.
930
931\begin{verbatim}
932Cmd> x = 'Hello'
933Cmd> echo $x
934# Taille d'une variable de type vecteur $#vname
935Cmd> set vx ( 111 2222 3333 444444 )
936Cmd> echo $#vx
937# Acces aux elements de tableau
938Cmd> echo $vx[0] $vx[1]
939# ou bien indexe par une variable
940Cmd> i = 2
941Cmd> echo $vx[i]
942# Une syntaxe particuliere: $[vname] retourne le contenu de
943# la variable dont le nom est ds vname
944Cmd> zzz = 'Commander'
945Cmd> xxx = 'zzz'
946Cmd> echo '$[xxx]= ' $[xxx]
947$[xxx]= Commander
948\end{verbatim}
949
950Variables d'environnement: L'acces aux variables d'environnement
951se fait simplement par{\tt \$varenvname}. Attention, les variables locales
952de l'interpreteur sont prioritaires.
953
954\item[\rond] {\bf Variables particulieres: } \\
955{\tt \$retval} ou {\tt \$retstr} : chaine specifee sur la derniere commande return
956{\tt \$status} : code de retour de la derniere commande executee.
957(variable existe et est rempli - mais il faudra se donner une regle
958plus claire ...)
959Arguments des fichiers .pic appeles par la commande exec
960{\tt \$\# } : nombre d'arguments, a part \$0
961{\tt \$0} nom du fichier ou du script
962{\tt \$1 \$2 \$3} .... les arguments (pour les scripts et les .pic (exec))
963
964
965\item[\rond] {\bf Structures de controle } \\
966\begin{verbatim}
967foreach f ( w1 w2 w3 ... )
968 ...
969 echo $f
970end
971\end{verbatim}
972
973Espace avant/apres '(' et avant ')' obligatoire.
974
975\begin{verbatim}
976foreach v vecname
977 ...
978 echo $v
979end
980\end{verbatim}
981
982Boucle de type integer:
983\begin{verbatim}
984for i startInt:endInt[:stepInt]
985 ....
986 echo $i
987end
988\end{verbatim}
989
990Boucle de type float
991\begin{verbatim}
992for f startFloat:endFloat[:stepFloat]
993 ....
994 echo $f
995end
996\end{verbatim}
997
998Boucle sur les lignes d'un fichier:
999\begin{verbatim}
1000forinfile line FileName
1001 ...
1002 echo $line
1003end
1004\end{verbatim}
1005
1006Instruction {\tt break} pour casser une boucle
1007
1008\item[\rond] {\bf Les tests }
1009\begin{verbatim}
1010if ( test ) then
1011endif
1012
1013if ( test ) then
1014 ....
1015else
1016 ....
1017endif
1018\end{verbatim}
1019
1020Espace avant/apres '(' et avant ')' obligatoire.
1021
1022test de type {\tt a == b} OU {\tt a != b} OU {\tt a < b} OU {\tt a > b}
1023OU {\tt a <= b} OU {\tt a >= b}
1024les espaces avant l'operateur de comparaison sont obligatoires.
1025{\tt ==} et {\tt !=} effectue une comparaison de chaines de caracteres.
1026{\tt < , > , <= , >=}une comparaison apres conversion en valeur flottante.
1027
1028\item[\rond] {\bf Definition de script } \\
1029\begin{verbatim}
1030defscript scriptname [description ]
1031 ....
1032endscript
1033\end{verbatim}
1034
1035L'appel a un script se fait simplement a l'aide
1036du nom de script (contrairement aux fichiers
1037de commande qui sont executes a l'aide de la
1038commande {\tt exec} )
1039\begin{verbatim}
1040Cmd> scriptname arg1 arg2 arg3 ....
1041\end{verbatim}
1042
1043L'instruction {\tt return} provoque l'arret (et le retour) d'execution d'un
1044script ou d'un fichier de commandes.
1045Commandes {\bf listscript }et {\bf clearscript scriptname}
1046 permettet d'avoir la liste des scripts
1047 definis / supprimer la definition d'un script
1048
1049\item[\rond] {\bf Autres commandes}
1050\begin{itemize}
1051\item Instruction {\bf echo } pour ecrire sur cout/stdout
1052\item Instruction {\bf echo2file} pour ecrire a la fin d'un fichier
1053\item Instruction {\bf sleep nsec} (attente de nsec seconds )
1054\item Instructions {\bf timingon , timingoff , traceon , traceoff } \\
1055%
1056\item Commande {\bf exec commandfilename [arg1 arg2 ... ] }
1057\item Commandes {\bf help et help keyword/commandname }
1058\item Commandes {\bf listvars , listcommands }
1059\item Defintion et liste d'alias : {\bf alias aliasname 'string ' } et {\bf listalias}
1060\end{itemize}
1061
1062\item[\rond] {\bf Threads d'execution de commandes (Avril 2005)} \\
1063Possibilite de lancer des commandes (autre que les commandes
1064 de l'interpreteur lui-meme) en thread separe (il suffit de mettre un \&
1065 a la fin de la commande) \\
1066 Commandes des gestion des threads : \\
1067 {\bf thrlist ; cleanthrlist ; cancelthr ThId ; waitthr } \\
1068 Attention, la possibilite de lancer des commandes en threads separes ne fonctionne que
1069pour des commandes "thread-safe".
1070La plupart de nos commandes de piapp sont \\
1071 - soit trop rapide, \\
1072 - soit non "thread-safe" \\
1073
1074 \item[\rond] controle d'execution : \\
1075Possibilite d'arreter l'execution de l'interpreteur (dans une boucle
1076 ou dans dans un fichier .pic ...
1077 Utiliser la commande {\bf stop} ou {\tt <Cntrl C>} dans PIConsole
1078
1079\end{itemize}
1080
1081\soustitre{Classes CExpressionEvaluator et RPNExpressionEvaluator }
1082\begin{itemize}
1083\item[\rond] Ajout des classes RPNExpressionEvaluator et CExpressionEvaluator
1084d'Žvaluation d'expressions numŽriques en notation polonaise inverse
1085et avec la syntaxe C . Utilise dans la classe Commander.
1086\item[\rond] Programme test Test/tcmd.cc
1087\item[\rond] extrait de {\tt cvs log cexpre.cc }
1088{\small \begin{verbatim}
1089----------------------------
1090revision 1.3
1091date: 2004/03/18 18:15:19; author: ansari; state: Exp; lines: +10 -6
1092Suite (presque finie) des modifications de l'interpreteur - gestion des variables en particulier - Reste au moins un bug ds CExpressionEvaluator - Reza 18/03/2004
1093----------------------------
1094revision 1.2
1095date: 2004/03/16 08:47:48; author: ansari; state: Exp; lines: +5 -6
1096suppression variables inutilisees ds cexpr.cc - Reza 16 Mars 2004
1097----------------------------
1098revision 1.1
1099date: 2004/03/15 22:19:43; author: ansari; state: Exp;
1100Ajout fichiers des classes RPNExpressionEvaluator et CExpressionEvaluator (expression arithmetiques) et MAJ du fichier Makefile et objlist.list - Reza 15 Mars 2003
1101\end{verbatim} }
1102
1103\item[\rond] Extrait du message du 3 Mars 2004
1104\begin{verbatim}
1105Le code est base sur une hierarchie de classe d'expression :
1106 Expr -------- NumberExp
1107 --------- BinExp ------ AddExp
1108 ------ MulExp
1109 ------ SubExp
1110 ------ DivExp
1111 --------- FuncExp
1112 --------- CExpressionEvaluator
1113
1114NumberExp : expression elementaire de nombre, sait actuellement traduire Pi et E
1115 tres facile d'ajouter d'autres constantes
1116BinExp: Classe d'operations binaires (deux operandes) a+b a-b a*b a/b
1117 avec gestion de niveau de priorite des operateurs
1118 On peut facilement ajouter d'autres operateurs binaires (par exemple
1119 puissance ^ a^b ) - et les priorites relatives seront gerees en principe.
1120FuncExp: classe d'expression fonctionnelle, avec n arguments f(x1,x2,...x3)
1121 actuellemenent, n=0 a n=3 arguments et quelques fonctions
1122 usuelles sont decodes ds cette classe (sin,cos,tan, asin, acos, atan, exp, log,
1123 atan2, pow ) - voir ds le code
1124
1125CExpressionEvaluator : C'est la classe de haut niveau a utiliser -
1126 la fonction de decodage de la chaine ASCII (qui utilise
1127 les fonctionalites des differentes classes est la dedans
1128 et ce n'est pas tres long.
1129(+ une classe d'exception specifique).
1130\end{verbatim}
1131
1132\end{itemize}
1133
1134
1135%%%%%%%%
1136\titre{FitsIOServer}
1137%%%
1138\begin{itemize}
1139\item[\rond] Aout 2006 : Ecriture/Lecture des classes Histo,HProf,HistoErr,Histo2D dans fichier FITS.
1140Les Histo2D et leurs projections 1D associ\'ees sont lus et \'ecrits
1141sur plusieurs HDU cons\'ecutifs.
1142\item[\rond] Juin 2006 : Ajout verification/correction noms de colonne lors de lecture FITS / DataTable,
1143et remplacement throw par un warning lors de lecture fits-healpix avec $nbcols > 1$ \\[1mm]
1144\item[\rond] { \large Sep 2005-Jan 2006 : Refondation totale du module }
1145\begin{itemize}
1146\item[\rond] Amelioration du programme PrgUtil/scanppf -
1147(scanfits -V1 -lh -rd -header filename)
1148\item[\rond] La classe FitsFile (et donc FitsInFile FitsOutFile) heritent de FitsInOutFile.
1149(Jan 2006)
1150\item[\rond] Fonctionalites classe {\bf FitsManager } etendues - en particulier ScanFile()
1151\item[\rond] Les FitsIOHandler (ancien) heritent de FitsHandlerInterface -
1152Tous les handlers sont pris en charge et enregistre par FitsManager (Jan 2006)
1153\item[\rond] Ajout classe d'initialisation du module {\bf FitsIOServerInitiator },
1154fichiers fiosinit.h .cc (Dec 2005)
1155\item[\rond] Classe { \bf SwFitsDataTable } (DataTable avec swap sur FITS) ajoute
1156 + classe FitsHandler<BaseDataTable> modifie pour prise
1157en charge de SwFitsDataTable (Dec 2005 - Jan 2006)
1158\item[\rond] Classes {\bf FITSDataSwapper$<$T$>$} modifies (Dec 2005)
1159\item[\rond] Prise en charge de types TSTRING et TCOMPLEX et TDBLCOMPLEX
1160lors de lecture/ecriture de colonnes FITS.
1161\item[\rond] Prise en charge de l'ensemble des types de colonnes pour le handler de Fits
1162de DataTable
1163\item[\rond] Classe {\bf FitsInOutFile } comme wrapper des fonctions de la librairie cfitsio +
1164classe d'exception spŽcifique {\bf FitsIOException} , et la classe des types FITS {\bf FitsTypes}.
1165\item[\rond] Classe template {\bf FitsBlockRW$<$T$>$} pour lecture/Žcriture (tableaux de donnŽes)
1166sur IMGHDU et Tables.
1167\item[\rond] Classes gestionnaires I/O Fits pour les objets {\bf FitsHandler$<$T$>$} et {\bf FitsManager}
1168\item[\rond] Classes gestionnaire pour les tableaux : {\bf FitsArrayHandler$<$T$>$}
1169\item[\rond] Classes gestionnaire pour les DataTable {\bf FitsHandler$<$BaseDataTable$>$}
1170\item[\rond] Mai 2005 : Classe {\bf FITSDataSwapper$<$T$>$} pour la gestion des
1171SwSegDataBlock sur fichiers FITS
1172\end{itemize}
1173\end{itemize}
1174
1175\titre{LinAlg}
1176Extension des fonctionalitŽs de la classe {\tt LapackServer<T>} :
1177(Juillet 2004 / cmv , FŽvrier 2005 / Reza)
1178\begin{itemize}
1179\item[\rond] Ajout lancement d'exception sur renvoi de code d'erreur par lapack
1180(desactivable par flag au niveau du constructeur de la classe serveur)
1181\item[\rond] Introduction de l'interface Lapack d'inversion des matrices symetriques (21/7/2004)
1182\item[\rond] Introduction de l'interface Lapack de recherche de valeurs et vecteurs propres
1183 (cas general, symetrique et hermitique) (21/7/2004)
1184\item[\rond] Introduction d'un fonction d'interface pour le calculateur de workspace
1185 (ilaenv\_) (21/7/2004)
1186\item[\rond] Ajout prog test Tests/tsttminv.cc + Commentaires sur les diverses methodes et sur les matrices FORTRAN (21/7/2004)
1187\item[\rond] Ajout SVD decomp by Divide and Conquer SVD\_DC (23/7/2004)
1188\item[\rond] Ajout Least Square with SVD DC
1189\item[\rond] Ajout methode calcul de la matrice inverse par Lapack en utilisant la
1190resolution de systemes (07/02/2005)
1191\end{itemize}
1192
1193\titre{IFFTW}
1194\noindent
1195- Juillet 2007 : Passage a FFTW 3 \\
1196- Nov 2005 : Correction du bug dans le cas de FFT-1D Backward(complex -> reel)
1197in(1).imag() pouvait etre ecrase.
1198
1199\titre{PI,PIext,piapp}
1200\soustitre{PI: Classes modifiees - ameliorees}
1201\begin{itemize}
1202\item[\rond] {\bf PIImageNavigator } \\
1203Ajout de la classe {\tt PIImageNavigator } permettant de visualiser une image
1204avec ses propres widget zoom / global view et colormap. (Fevrier 2005) \\
1205Commande {\tt imagnav} ajoute ds piapp/baseexcute.cc . \\
1206\item[\rond] Avril 2005 - Amelioration de la classe {\bf PIConsole} \\
12071/Envoi Message PIMSG\_Cancel lors de {\tt <Cntl C>} \\
1208 2/ Correction positionnement curseur lors de rappel de commande,
1209 Si possible en fin de commande - mais toujours avec le
1210 debut de commande visible. \\
12113/ Correction (probable) du petit bug sur les derniers caracteres lors de copier/coller
1212 ds PIConsole
1213\item[\rond] Codage Options graphiques en text (string) pour PIGraphicAtt (Nov-Dec 2005)
1214\item[\rond] Corrections diverses trace d'axes etc ... (Dec 2005)
1215\item[\rond] PIext rendu indŽpendant de FITS (Avril 2006) - commandes spŽcifiques dans
1216ProgPI/fitsbtadapter.cc
1217\item[\rond] BUG A corriger, DrawOpaqueString ds PIGraphPS (sortie postscript)
1218\end{itemize}
1219%%%%
1220\soustitre{ Codage texte des options graphiques (11 Mars 2004)}
1221\begin{verbatim}
1222// Methode retournant un vecteur de string a partir des options
1223virtual int PIDrawer::OptionToString(vector<string> & opt) const
1224qui vient completer les deux methodes
1225virtual int PIDrawer:: DecodeOptionString(vector<string> & opt, bool ...) et
1226virtual void PIDrawer:: GetOptionsHelpInfo(string& info);
1227Ces methodes s'occupent de decoder les options graphiques (et l'aide
1228associe). La methode ajoutee permet de faire l'operation inverse, fabriquer
1229une serie de chaine de caracteres a partir des options graphiques.
1230Il y a aussi la methode
1231virtual int PIWdgGen::OptionToString(vector<string> & opt) const
1232que j'ai ajoute (rien a faire pour le moment) - ainsi que
1233int PIGraphicAtt::AttToStrings(vector<string> & att) const.
1234
1235Peux-tu remplir la methode PIGraphicAtt::AttToStrings(vector<string> & att) const.
1236L'implementation par defaut de PIDrawer::OptionToString(vector<string> & opt) const
1237appelle PIGraphicAtt::AttToStrings() - a laisser donc tel quel.
1238
1239par contre, pour les autres drawer (PIYfXDrawer, PIFuncDrawer, PIElDrawer,
1240PISurfaceDrawer, PIHisto, PIHisto2D, PINTuple ...) - lorsque
1241DecodeOptionString(vector<string> & opt, bool ...) est modifie,
1242rajouter la methode OptionToString(vector<string> & opt) et verifier le help.
1243Attention, il ne faut pas mettre l'argument opt a zero, mais ajouter des chaines
1244derriere (push_back()) afin de pouvoir cumuler les options de base + options
1245specifiques.
1246
1247Comment tester ?
1248Pour tester, tu peux utiliser la fenetre des options texte ou j'ai ajoute le bouton
1249[GetOption] . Tu peux acceder a cette fenetre a partir de la fenetre des options
1250graphiques <Alt>O , ou directement sur un objet de gestionnaire 2D - par
1251<Alt>T - <Shift>Button-1 permet de selectionner le drawer actif
1252\end{verbatim}
1253
1254\soustitre{ Trace des axes (11 Mars 2004)}
1255 Ajouter la possibilite de specifier l'origine (le point de croisement des axes)
1256lorsque les axes ne sont pas de type 'box' - classes PIAxes et PIElDrawer. FAIT
1257
1258\soustitre{ Selection graphique (souris) du drawer actif (11 Mars 2004)}
1259\begin{verbatim}
1260J'ai ajoute la methode PIDrawer::GetDistanceToPoint(double x, double y)
1261// Renvoie une distance au point x,y
1262// 0: au(x) point(s) le(s) plus proche(s) ... 1 au bord xmin/xmax , ymin/ymax
1263// La methode par defaut calcule la distance normalisee au point ((xmin+xmax)/2,
1264(ymin+ymax)/2)
1265 virtual double PIDrawer::GetDistanceToPoint(double x, double y);
1266
1267ainsi que ce qu'il faut ds PIBaseWdgGen et ds PIDrawer pour exploiter cette
1268methode + code permettant le test ds PIScDrawWdg.
1269(virtual void PIDrawer::WdgCoord2DrwCoord(int x, int y, double& xu ...
1270 virtual int PIBaseWdgGen:;FindNearestDrawerId(int x, int y) ...)
1271Tu as a t'aoccuper de la methode PIDrawer::GetDistanceToPoint(double x, double y)
1272qui doit etre redefinie si possible pour chaque drawer, afin de fournir une
1273distance raisonnable au point (x,y) en argument.
1274J'ai juste mis une implementation par defaut (ds PIDrawer) et une implementation
1275partielle pour PIElDrawer (qui trace les axes en particulier) - qu'il faut
1276completer.
1277
1278Comment tester ?
1279J'ai mis ce qu'il faut ds le gestionnaire 2D (PIScDrawWdg) -
1280<Shift>Button-1 choisit le drawer le plus proche (base sur la
1281valeur de retour de PIDrawer::GetDistanceToPoint(double x, double y)
1282comme drawer actif. Ce drawer est passe en 'highlight' pendant que
1283le bouton est appuye.
1284\end{verbatim}
1285
1286\soustitre{ Manipulation interactive des drawers (3 Juin 2004) }
1287La manipulation interactive des drawers (ˆ l'aide d'un menu) a
1288ŽtŽ finalisŽe pour les PIImage PIScDrawWdg PI3DWdg .
1289
1290\begin{verbatim}
1291 o <Alt>D affiche le menu avec les differentes option
1292 o Move/Resize: Affichage du rectangle + rectangle milieu
1293 (deplacement) + coin bas-droite (deplacement) -
1294 clicker ailleurs pour finir
1295 o Mouse Select : Le mouse select des drawers est gere
1296 maintenant par un PIEventHandler (comme pour Move/ReSize)
1297 Drawer actif affiche par le rectangle muni d'un petit coin
1298 (petit carre + rond dedans, en bas a droite).
1299 Click souris change eventuellement le drawer actif.
1300 On termine en clickant ds le petit [carre+rond]
1301\end{verbatim}
1302
1303\soustitre{ Traceur de bar-graph (classe PIBarGraph) (3 Juin 2004) }
1304Ajout du traceur de bar-graph (classe {\bf PIBarGraph}) ds module PI/
1305et commande {\tt bargraph} ds PIext/basexecut.cc .
1306La commande bargraph ne gere pas encore toutes les possibilites
1307de la classe PIBarGraph. \\
1308Exemple d'utilisation:
1309\begin{verbatim}
1310Cmd> bargraph ' ' -10. 15. 22. 8. 33. 7 -4.
1311Cmd> bargraph 'blue ' -10. 15. 22. 8. 33. 7 -4.
1312Cmd> bargraph 'blue horizontalbars' -10. 15. 22. 8. 33. 7 -4.
1313Cmd> bargraph 'blue horizontalbars barvaluelabel ' -10. 15. 22. 8. 33. 7 -4.
1314Cmd> bargraph 'blue verticalbars nofill barvaluelabel ' -10. 15. 22. 8. 33. 7 -4.
1315Cmd> bargraph 'font=times,bold,16 blue verticalbars nofill barvaluelabel ' \
1316 -10. 15. 2 2. 8. 33. 7 -4.
1317Cmd> bargraph 'font=times,bold,16 blue verticalbars fill barvaluelabel packfrac=0.8' \
1318 -10. 15. 22. 8. 33. 7 -4.
1319\end{verbatim}
1320
1321\soustitre{ Traceur de lignes de texte (classe PITextDrawer) (3 Juin 2004) }
1322
1323Ajout d'une classe de traceur de lignes de texte (classe {\bf PITextDrawer}) et commande
1324{\tt textdrawe}r ds PIext/basexecut.cc . Mais le traceur (et sa commande)
1325doivent etre completes. \\
1326Exemple d'utilisation:
1327\begin{verbatim}
1328# On affiche qque chose
1329Cmd> openppf demo.ppf
1330Cmd> disp h1d
1331Cmd> textdrawer 'frame line=solid,2 font=times,bold,16 red inset' \
1332 ' Christophe ' ' Reza Ansari' ' SOPHYA '
1333\end{verbatim}
1334
1335\soustitre{ Gestion de re-scale-ing des axes en 3D (3 Juin 2004) }
1336
1337Mise en place complete (?) de la gestion de re-scale-ing des axes en 3D
1338avec gestion des options graphiques (texte) - Il est possible en particulier d'imposer
1339les limites de la boites 3D.
1340cela a ete une grosse prise de tete de tout un apres-midi.
1341J'ai eu ensuite mal a la tete une partie de la soiree ! \\
1342Exemple d'utilisation:
1343
1344\begin{verbatim}
1345
1346# On ouvre le fichier demo.ppf
1347Cmd> openppf demo.ppf
1348Cmd> surf mtx1 'colbr32'
1349Cmd> surf mtx1 'colbr32 noautoscale'
1350Cmd> surf mtx1 'colbr32 lim3dbox=-10,60,-10,60,-3,15 autoscale3dbox'
1351# Affichage avec superposition
1352Cmd> nt3d nt32 x y z - - - - - 'marker=circle,7 red'
1353Cmd> nt3d nt32 x y z - - - - - 'same marker=cross,5 blue '
1354# Ou bien :
1355Cmd> nt3d nt32 x y z - - - - - 'marker=circle,7 red noautoscale'
1356Cmd> nt3d nt32 x y z - - - - - 'same marker=cross,5 blue '
1357
1358\end{verbatim}
1359\soustitre{piapp (PIext/ProgPI) }
1360\begin{itemize}
1361%%%%
1362\item[\rond] Juillet 2006 : Ameliorations et ajouts divers : \\
1363- Ajout commande {\bf plot3dw} ({\tt Services2NObjMgr::DisplayPoints3DW() }) \\
1364- Ajout possibilite d'acces aux caracteristiques des objets par {\tt \$\{objname.att\} } \\
1365{\tt (PIACmd::GetVarApp()) } et amelioration verification du nom des objets
1366(methode {\tt NamedObjMgr::CheckName()}) \\
1367- Operations sur objets: commande {\bf objaoper} ({\tt NObjMgrAdapter::PerformOperation()})
1368
1369\begin{verbatim}
1370# Extracting row / column from matrix
1371Cmd> objaoper matrixname row 23
1372Cmd> objaoper matrixname col 148
1373# Extracting plane from 3D array (slicexy slicexz sliceyz)
1374Cmd> objaoper arr3dname slicexy 14
1375\end{verbatim}
1376%%%%
1377\item[\rond] Avril 2006: Ajout possibilite de lecture des commandes sur le terminal (stdin)
1378et flag en argument de commande {\tt -small} \\
1379Extrait de cvs log :
1380\begin{verbatim}
1381revision 1.16
1382date: 2006/04/26 15:53:18; author: ansari; state: Exp; lines: +20 -11
13831/ Ajout classe de lecture sur stdin (terminal) avec thread separe pour
1384piapp - incluant la possibilite d'utilisation de la librairie GNU readline
1385(fichiers piacmdrdr.cc piacmdrdr.h + fichier makfile specifique makefile_wgrdl
1386 pour compil+link avec GNU readline)
13872/ MAJ Makefile et modif programme principal piapp.cc avec flag -small
1388et activation thread de lecture sur terminal
1389 Reza , 26/04/2006
1390
1391----------------------------
1392\end{verbatim}
1393
1394\item[\rond] Jan 2006 : commandes readfits writefits scanfits ont ete ajoutees
1395dans ProgPI/fitsbtadapter.cc en utilisant le nouveau FITS -
1396Le menu OpenFits de PIStdImgApp utilise desormais ces commandes
1397\item {\bf BUG } a corriger pour {\tt imagvav}:
1398La destruction de l'objet et/ou widget pascorrectement geres -
1399provoque des plantages lors de la sortie de l'application.
1400\end{itemize}
1401\soustitre{piapp multi-thread }
1402\begin{itemize}
1403\item[\rond] Avril 2005: PossibilitŽ d'execution de commandes en threads separes, en
1404ajoutant {\bf \&} en fin de ligne de commande.
1405\item[\rond] Janvier 2004: Le multithreading a ŽtŽ mis en oeuvre dans piapp .
1406
1407\item[\rond] Extrait de {\tt cvs log pistdimgapp.cc } :
1408\begin{verbatim}
1409revision 1.77
1410date: 2005/04/27 11:55:00; author: ansari; state: Exp; lines: +26 -10
14111/ Prise en charge de DataTable et SwPPFDataTable pour piapp (NObjMgrAdapter) :
1412nomhistadapter.cc et piiinit.cc
14132/ Lecture de tous les objets ds un fichier PPF par NamedObjMgr::ReadAll() pour
1414fichier PPF sans nametag.
14153/ Ajout bloc try/catch ds PIStdImgApp::Run() (boucle d'evenements)
1416 Reza , 27 Avril 2005
1417----------------------------
1418revision 1.76
1419date: 2005/04/19 09:13:49; author: ansari; state: Exp; lines: +3 -1
1420Ajout de l option nodisp ds les affichages des NamedObjMgr, prise en compte de
1421<Cntrl C> (Msg_Cancel) pour arreter l'execution de l'interpreteur ds PIStdImgApp
1422et remplacement commande breakexe par stop ds PIACmd - Reza 19/4/2005
1423----------------------------
1424revision 1.75
1425date: 2005/04/19 06:56:52; author: ansari; state: Exp; lines: +5 -4
1426Remis en marche la possibilite d'execution d'un .pic au lancement de piapp -
1427Reza 19/4/2005
1428----------------------------
1429revision 1.74
1430date: 2005/02/18 14:09:47; author: ansari; state: Exp; lines: +62 -37
1431Modifications pour l'utilisation viewer PIImageNavigator (ajout commande imagnav
1432) - Reza 18 Fev 2005
1433----------------------------
1434revision 1.73
1435date: 2004/11/19 17:41:07; author: ansari; state: Exp; lines: +26 -0
1436Ajout commandes addoval addfoval pour trace d'ellipse - Reza 19/11/2004
1437----------------------------
1438revision 1.71
1439date: 2004/09/07 07:10:18; author: ansari; state: Exp; lines: +35 -0
1440Ajout bloc try/catch ds piacmd.cc (thread execution commandes) et ds pistdimgapp.cc (
1441methode process, thread boucle d'evts) - Reza 07/09/2004
1442----------------------------
1443revision 1.70
1444date: 2004/01/06 18:44:56; author: ansari; state: Exp; lines: +11 -1
1445 Suite debugging gestion lock entre threads ds piapp - A l'air de
1446marcher sur OSF1 et Linux ... Reza 06/01/2004
1447----------------------------
1448revision 1.69
1449date: 2004/01/06 17:05:25; author: ansari; state: Exp; lines: +33 -7
1450Suite debug piapp multithread : on ne peut pas utiliser ZSync() ds un if (destructeur
1451 appele de suite) - Reza 06/01/2004
1452----------------------------
1453revision 1.68
1454date: 2004/01/04 19:02:43; author: ansari; state: Exp; lines: +43 -13
1455Suite des modifs pour piapp multi-threads
14561) Ajout Mutex de synchronisation ds ls classe NamedObjMgr
14572) Suite controle de gestion d'appel aux methodes de PIStdImgApp depuis
1458la classe elle-meme, a travers le NamedObjMgr
14593) Modification de la boucle d'evenements, avec un thread de reveil
1460periodique
1461 Reza, 4 Janvier 2004
1462\end{verbatim}
1463\item[\rond] Extrait de {\tt cvs log pistdimgapp.cc } :
1464\begin{verbatim}
1465----------------------------
1466revision 1.62
1467date: 2003/11/27 10:51:58; author: ansari; state: Exp; lines: +45 -20
1468Suite modification/adaptations a la classe PIACmd qui herite maintenent de SOPHYA::Co
1469mmander - Reza 27/11/2003
1470----------------------------
1471revision 1.61
1472date: 2003/11/26 23:01:55; author: ansari; state: Exp; lines: +20 -1755
1473Modification du code de PIACmd : La classe PIACmd herite maintenant de la classe Comm
1474ander (de SysTools) - Reza 26/11/2003
1475----------------------------
1476revision 1.60
1477date: 2003/07/21 21:13:10; author: cmv; state: Exp; lines: +3 -3
1478- introduction notion de numero de ligne dans expression ntuple
1479 modif prototype PlotExprFunc NTLoopExprFunc (add _nl _nstart _nend)
1480 modif int_4 -> int_8_exprf (long long) pour _nl (DecodeLoopParameters,
1481 PrepareNTExpressionCFile, LinkExprFunc,...)
1482- doc pour _nl _nstart _nend et arragement repartition RegisterHelp/RegisterCommand
1483 (rz + cmv 21/7/2003)
1484----------------------------
1485\end{verbatim}
1486\end{itemize}
1487
1488\titre{Documentation (Manual/) }
1489%%%%
1490Documentation des classes de SysTools. \\
1491Extrait message du 12 Aout 2004 : \\
1492\begin{verbatim}
1493---> Au sujet de la doc (Manual/)
1494 J'ai installe doxygen sur le Mac, version 1.3.8 -
1495 Il faut updater le fichier de config de depart (dox_sophya.conf)
1496 Pour ma part, j'ai du modifier mkmf (en version privee) -
1497 En effet, il n'y avait pas le program doxysearch - Je ne sais pas si c'est general
1498 ou specifique Mac.
1499
1500 J'ai aussi modifie certaines options de doxygen (en version privee)
1501 EXTRACT_LOCAL_CLASSES --> NO (au lieu de YES)
1502 DETAILS_AT_TOP ---> YES (au lieu de No)
1503 SORT_MEMBER_DOCS ---> NO (au lieu de YES)
1504
1505 Si on est d'accord, on peut modifier ces options ds le fichier dox_sophya.conf et
1506 utiliser la fonction update de doxygen (doxygen -u)
1507\end{verbatim}
1508
1509\titre{Mgr}
1510\begin{itemize}
1511\item Avril-Mai 2005 : Basculement vers la nouvelle version de scripts
1512de gestion du code (module {\bf BuildMgr/ } )
1513On n'a plus a se preoccuper des indications de cette section
1514
1515\item
1516Septembre 2003 (17/9/2003) : Changement DPCDEVREP, DPCBASEREP
1517en SOPHYADEVREP , SOPHYABASEREP , EROSCXX en SOPHYACXX
1518\end{itemize}
1519
1520
1521
1522\titre{Plan de modifs pour SOPHYA V 2.x PI/piapp V 4.x }
1523
1524{\bf Sep 2006} : La grande majorit\'e des modifs pr\'evues en 2003 ont \'et\'e
1525effectu\'ees. Reste \`a faire , si besoin :
1526\begin{itemize}
1527\item SophyaLib::TArray/
1528\begin{verbatim}
1529 - Ajouter une classe de base abstraite GenericMatrix<T>
1530 avec methode d'acces aux elements, nb de lignes, nb de colonnes,
1531 - Introduire les TinyMatrix (TinyMatrix<T, int L, int C>)
1532 avec passage de/vers TMatrix<T> (et TinyVector<T, int N>) ?
1533 - Introduire des matrices creuses simples SpareMatrix<T>
1534 - Introduire les DiagonalMatrix<T>
1535Remarque: Les TMatrix TinyMatrix et SparseMatrix heritent de GenericMatrix
1536\end{verbatim}
1537
1538\item PI/ piapp
1539\begin{verbatim}
1540o Ajouter un traceur de ApplePie (BarChart fait )
1541o Ajouter un traceur de Lego-Plot
1542o (?) Une fonction pour faire facilement une fenetre d'alerte ou d'info (?)
1543o Voir comment on pourrait "joindre" deux objets ayant l'interface NTupleInterface
1544 pour pouvoir plotter des objets, l'un vs l'autre
1545o (???) Introduire quelque chose du style
1546 AddDialogue("Cmd", "dialogue-description)
1547 qui pourrait fabriquer automatiquement une fenetre avec des champs a remplir
1548 pour les commandes usuelles (???)
1549\end{verbatim}
1550\end{itemize}
1551
1552
1553\end{document}
Note: See TracBrowser for help on using the repository browser.