PK_ERROR_code_t     PK_GEOM_is_coincident
(
--- received arguments ---
PK_GEOM_t           geom_1,         --- first geometric entity
PK_GEOM_t           geom_2,         --- second geometric entity

--- returned arguments ---
PK_LOGICAL_t *const is_coincident   --- whether coincident
)


This function will compare two points, two curves, or two surfaces to detect
whether they occupy the same position(s) in space.


Specific Errors:
    PK_ERROR_bad_type_combn         geometries are of different types
    PK_ERROR_invalid_geometry       geometry is invalid
    PK_ERROR_wrong_sub_type         geometry is wrong sub-type


PK_GEOM_is_coincident will compare two points, two curves, or two surfaces.
If they occupy the same position(s) in space, is_coincident will be
returned as PK_LOGICAL_true, otherwise it will be returned as PK_LOGICAL_false.

All comparisons of length or position are made to within modeller resolution.

PK_GEOM_is_coincident is not guaranteed to detect equivalence but it will
never claim two entities are equivalent when they are not.

Any curve or surface must be capable of passing the full checks imposed by
PK_GEOM_check.