// Point3d doxygen page

/**

  \page Point3DPage  Point3D Classes



To avoid exposing templated parameter to the users, typedefs are defined for all types of  vectors based an double's and float's. To use them, one must include the header file <em>Math/Point3D.h</em>.
The following typedef's, defined in the header file <em>Math/Point3Dfwd.h</em>, are available for the different instantiations of the template class ROOT::Math::PositionVector3D:    


<ul>
<li>ROOT::Math::XYZPoint  point based on x,y,z coordinates (cartesian) in double precision
<li>ROOT::Math::XYZPointF  point based on x,y,z coordinates (cartesian) in float precision
<li>ROOT::Math::Polar3DPoint point based on r,theta,phi coordinates (polar) in double precision
<li>ROOT::Math::Polar3DPointF point based on r,theta,phi coordinates (polar) in float precision
<li>ROOT::Math::RhoZPhiPoint point based on rho,z,phi coordinates (cylindrical using z) in double precision
<li>ROOT::Math::RhoZPhiPointF point based on rho,z,phi coordinates (cylindrical using z) in float precision
<li>ROOT::Math::RhoEtaPhiPoint point based on rho,eta,phi coordinates (cylindrical using eta instead of z) in double precision
<li>ROOT::Math::RhoEtaPhiPointF point based on rho,eta,phi coordinates (cylindrical using eta instead of z) in float precision
</ul>

<h4>Constructors and Assignment</h4>
The following declarations are available: 
<pre>
 XYZPoint         p1;                     // create an empty vector (x = 0, y = 0, z = 0) 
 XYZPoint         p2( 1,2,3);             // create a vector with x=1, y = 2, z = 3; 
 Polar3DPoint     p3( 1, PI/2, PI);       // create a vector with r = 1, theta = PI/2 and phi=PI
 RhoEtaPHiPoint   p4( 1, 2, PI)           // create a vector with rho= 1, eta = 2, phi = PI
</pre>
Note that each type of vector is constructed by passing its coordinates representations, so a XYZPoint(1,2,3) is different from a 
Polar3DPoint(1,2,3). 
<p>
In addition the Point classes can be constructed by any vector, which implements the accessors x(), y() and z().   
This con be another Point3D based on a different coordinate system types or even any vector of a different package, like the CLHEP HepThreePoint that implements the required signatures.  
<pre>
  XYZPoint             p1(1,2,3); 
  RhoEtaPHiPoint       r2(v1); 
  CLHEP::HepThreePoint q(1,2,3); 
  XYZPoint             p3(q)  
</pre>

<h4>Coordinate Accessors and Setter Methods</h4>
For the Points classes we have the same getter and setter methods as for the Vector classes. 
See the examples for the \ref Vector3DPage.

<h4>Point-Vector Operations</h4>
The following operations are possible between points and vector classes: 
( p1 ,p2 and p3 are instantiations of the ROOT::Math::PositionVector3D class, p1 and p3 of the same type v1 and v2 are a ROOT::Math::DisplacementVector3D class ) 
<pre>
p1 += v1; 
p1 -= v1;   
p3 = p1 + v1;      // p1 and p3 are the same type 
p3 = v1 + p1;      // p3 is based on the same coordinate system as v1    
p3 = p1 - v1;   
p3 = v1 - p1;      
v2 = p1 - p2;    // difference between points returns a vector v2 based on the same coordinate system as p1
</pre>
Note that additions between two points is NOT possible and the difference between points returns a vector. 

<h4>Other Operations</h4>
Exactly as for the 3D Vectors, the following operations are allowed: 
<ul>
<li>comparison of points
<li>scaling and division of points with a scalar
<li>dot and cross product with any type of vector
</ul>



*/