CREATEPLANE Create a plane in parametrized form.

   PLANE = createPlane(P1, P2, P3) 
   creates a plane containing the 3 points

   PLANE = createPlane(PTS) 
   The 3 points are packed into a single 3x3 array.

   PLANE = createPlane(P0, N);
   Creates a plane from a point and from a normal to the plane. The
   parameter N is given either as a 3D vector (1-by-3 row vector), or as
   [THETA PHI], where THETA is the colatitute (angle with the vertical
   axis) and PHI is angle with Ox axis, counted counter-clockwise (both
   given in radians).
 
   PLANE = createPlane(P0, Dip, DipDir);
   Creates a plane from a point and from a dip and dip direction angles 
   of the plane. Parameters Dip and DipDir angles are given as numbers.
   Dip : maximum inclination to the horizontal.
   DipDir : direction of the horizontal trace of the line of dip, 
            measured clockwise from north.

   The created plane data has the following format:
   PLANE = [X0 Y0 Z0  DX1 DY1 DZ1  DX2 DY2 DZ2], with
   - (X0, Y0, Z0) is a point belonging to the plane
   - (DX1, DY1, DZ1) is a first direction vector
   - (DX2, DY2, DZ2) is a second direction vector
   The 2 direction vectors are normalized and orthogonal.

   See also:
   planes3d, medianPlane
   
   ---------
   author: David Legland 
   INRA - TPV URPOI - BIA IMASTE
   created the 18/02/2005.

Package: matgeom