PK_GEOM_range_array_o_t

struct PK_GEOM_range_array_o_s
    {
    int                     o_t_version;     --- version number of option
                                             --- structure
    PK_LOGICAL_t            have_tolerance;  --- (PK_LOGICAL_false)
    double                  tolerance;       --- tolerance
    PK_range_bound_t        bound;           --- bounds on min separation
    PK_range_type_t         range_type;      --- whether to find the global
                                             --- minimum or the global
                                             --- maximum distance
                                             --- (PK_range_type_minimum_c) [NF]
    PK_range_param_bound_t *param_bounds[2]; --- parameter bound for the
                                             --- geometrical entities supplied
                                             --- (NULL, NULL) [PF]
    PK_range_opt_t          opt_level;       --- the level of analysis
                                             --- (PK_range_opt_performance_c)
   };

typedef struct PK_GEOM_range_array_o_s PK_GEOM_range_array_o_t;



Holds optional controls for finding the global minimum separations between two
arrays of geometrical entities.

Used in:

PK_GEOM_range_array

'have_tolerance'   : whether a tolerance value is provided.

'tolerance'        : a tolerance on the accuracy of the minimum distance
                     measurement. This will allow slacker computation of
                     minimum distance, when default accuracy is not required.
                     The default accuracy will be the linear precision
                     of the modeller.

'bound'            : option structure consisting of:
                     'have_upper_bound': whether an upper bound is supplied.
                     `upper_bound      : an upper bound on the minimum
                                         distance to be computed.
                                         If supplied, the minimum distance
                                         achieved will only be identified
                                         if it is less than the bound.
                     'have_lower_bound': whether a lower bound is supplied.
                     `lower_bound      : a lower bound on the minimum distance.
                                         For this option, if the closest
                                         approach between entities is found
                                         to be less than this bound, no
                                         solution will be determined.

'range_type'       : specifies whether to find the global minimum or the
                     global maximum distance.
                     When calculating maximum distance parameter range
                     information must be supplied for unbounded geometry.

'param_bounds'     : an array of two arrays of structures for supplying
                     parameter range information.
                     The first array contains the parameter range information
                     for the first geometrical array and similarly the second
                     array contains the parameter range information for the
                     second geometrical array. If no parameter range is
                     supplied for the first geometrical array the
                     `param_bounds[0]' can be NULL and similarly if no
                     parameter range is supplied for the second geometrical
                     array the `param_bounds[1]' can be NULL.
                     If the first or second of these arrays is not NULL
                     then it must have length n_geoms_1 or n_geoms_2
                     respectively.
                     Note that supplying parameter range information for a
                     surface of class PK_CLASS_mesh is not supported.

'opt_level'        : an option to control the level of analysis that is
                     undertaken to resolve closely separated local
                     minima/maxima. (PK_range_opt_performance_c)

See here for more information about the options available.