La notion d'encapsulation

Le choix des caractéristiques de chaque objet est aussi pertinent que le choix des objets eux-mêmes. Par exemple, les données caractérisant un vertex ne sont pas les mêmes que celles qui caractérisent une trace (tableau ).

Table: Association entre les événements physiques, la reconstruction et le code O.R.C.A.

événements	$H \rightarrow Z Z \rightarrow l^{+} l^{-} j j$
physique	$K^0_s \rightarrow K \pi$
éléments	trace	vertex primaire
reconstruits	trajectoire	vertex secondaire
	...	...
caratéristiques	position	position
principales	erreur sur la position	erreur sur la position
	qualité de la reconstruction	qualité de la reconstruction
	paramètre d'impact	l'ensemble des traces associées
	impulsion	probabilité d'être un vertex primaire
	...	...
classes	RecTracks	RecVertex
C++	TrajectoryStateOnSurface	LinearVertexFitter
associées	FreeTrajectoryState	VertexFinder (partie )
	...	...

Pour illustrer ces propos, la classe RecVertex associée à chaque vertex reconstruit par O.R.C.A. va être détaillée. Pour chaque information physique utile définissant un vertex reconstruit (position, qualité de la reconstruction, etc...), on lui associe un membre privé de la classe RecVertex. Ces membres sont les suivants :

• un objet GlobalPoint (nommé thePos) correspondant à un vecteur à 3 dimensions $(x, y, z)$ définissant la position du vertex.
• un objet GlobalError (nommé thePosError) correspondant à une matrice $3 \times 3$ définissant l'erreur sur la position du vertex.
• un objet RecTrackContainer (nommé theAssociatedTracks) correspondant à l'ensemble des traces associées au vertex.
• un nombre réel (nommé theChi2) correspondant au $\chi^2$ de la reconstruction du vertex.
• un nombre réel (nommé theProb) correspondant à la probabilité du vertex d'être un vertex primaire.
• une valeur booléenne (nommée theValid) précisant si le vertex est valide ou non (un vertex est invalide en cas de mauvaise reconstruction) mais en réalité tous les RecVertex sont valides.

De plus, un constructeur portant le même nom que la classe est une fonction membre appelée automatiquement lors de la création d'un objet et permet l'initialisation des variables.

Afin d'accéder aux valeurs stockées dans ces variables ou pour les modifier, nous avons défini les méthodes suivantes:

	RecVertex ()
	Le constructeur par défaut d'un objet RecVertex
	RecVertex (const GlobalPoint &pos, const GlobalError
	&posError, const vector$<$ const RecTrack *$>$ &tracks,
	float chi2)
	Le constructeur initialisant les membres privés de l'objet
	RecVertex lors de la création.
GlobalPoint	position () const
	Cette méthode retourne la position du vertex via l'objet
	"GlobalPoint".
GlobalError	positionError () const
	Cette méthode retourne l'erreur sur la position du vertex
	via l'objet "GlobalError".
Vertex::TrackPtrContainer	tracks () const
	Cette méthode retourne l'ensemble des traces associées
	au vertex via l'objet "RecTrackContainer"
Les méthodes position,	positionError et tracks sont héritées de la classe Vertex.
int	degreesOfFreedom () const
	Cette méthode calcule et retourne le nombre de degrés
	de liberté.
float	totalChiSquared () const
	Cette méthode retourne le $\chi^2$ de la reconstruction du vertex.

float	normalisedChiSquared () const
	Cette méthode retourne le $\chi^2$ normalisé par le nombre de
	degrés de liberté.
bool	isValid () const
	Cette méthode retourne le booléen de validité du vertex.
vector $<$const RecTrack *$>$	originalTracks () const
	Cette méthode retourne l'ensemble des traces à l'origine de
	la création du vertex via un vecteur de traces reconstruites.