PK_BSURF_fitted_fault_t

struct PK_BSURF_fitted_fault_s
    {
    PK_BSURF_fitted_t  status;          --- status for the fit
    double             distance_error;  --- final maximum distance error
    double             angular_error;   --- final maximum angular error
    PK_UV_t            error_uv;        --- parameters at which the
                                        --- algorithm failed
    };

typedef struct PK_BSURF_fitted_fault_s PK_BSURF_fitted_fault_t;



This structure returns surface fit status and related data.

Used in:

PK_BSURF_create_fitted

The structure's fields are:

'status'            a value specifying the final status of the attempt to
                    fit the input surface with a B-surface.

'distance_error'    the maximum distance error for the fit.  In a
                    successful fitting this distance will be less than the
                    'tolerance' supplied.  If fitting failed this value may be
                    undefined, depending on the 'status' for the B-surface.

'angular_error'     the maximum angular error for the fit, if a
                    non-zero angular tolerance was provided.  If no angular
                    tolerance was supplied this value will be zero. If fitting
                    failed this value may be undefined, depending on the
                    'status' for the B-surface.

'error_uv'          the parameters on the B-surface at which the fitting
                    algorithm has failed, if such a failure has occurred. Error
                    parameters will only be returned for certain 'status'
                    values and should be interpreted accordingly.

The 'status' values which return a B-surface and associated 'distance_error'
and 'angular_error' are:

    PK_BSURF_fitted_success_c
    PK_BSURF_fitted_eval_failure_c

The 'status' values which return associated 'error_uv' and the
appropriate interpretations are:

    PK_BSURF_fitted_eval_failure_c       the parameters (u,v) at which the
                                         evaluator failed
    PK_BSURF_fitted_u_interp_parm_c      `error_uv.param[0]' =
                                         the bad u interpolation parameter
                                         `error_uv.param[1]' = undefined

    PK_BSURF_fitted_v_interp_parm_c      `error_uv.param[1]' =
                                         the bad v interpolation parameter
                                         `error_uv.param[0]' = undefined