PK_VECTOR_make_lsq_plane

PK_ERROR_code_t                     PK_VECTOR_make_lsq_plane
(
--- received arguments ---
int                                 n_positions, --- number of positions
const PK_VECTOR_t                  *positions,   --- positions to fit to
const PK_VECTOR_make_lsq_plane_o_t *options,     --- options

--- returned arguments ---
PK_PLANE_t                   *const plane        --- the plane
)


This function creates a plane by least-squares fitting to a set of
position vectors.


Specific Errors:
    PK_ERROR_insufficient_points    too few linearly independent 'positions'
                                    have been supplied (MILD)

    PK_ERROR_not_unique             a unique plane could not be found (MILD)



At least three non-colinear positions must be supplied.