PK_TOPOL_identify_redundant

PK_ERROR_code_t                        PK_TOPOL_identify_redundant
(
--- received arguments ---
int                                    n_topols,          --- number of topols
const PK_TOPOL_t                       topols[],          --- array of topols
const PK_TOPOL_identify_redundant_o_t *options,           --- options structure

--- returned arguments ---
int                             *const n_redundant_topols,--- number of topols
                                                          --- identified
PK_TOPOL_t                     **const redundant_topols   --- identified topols
)


This function identifies redundant topology or subtopology from the given
list of topologies.


Redundant topologies are identified from the given array of topols, which may
be a single body, list of faces, list of edges or list of vertices.

A topology may be identified as redundant if it forms the boundary between two
topologies which have geometry on their interior that is either shared or
equivalent and smooth across that entire boundary topology.

A redundant topology can be an edge or a vertex.

A vertex will normally be redundant if it is attached to a split ring edge, or
if it is attached to only two edges, with the same curve geometry.

An edge will normally be redundant if it is a wire edge, or if the faces
on either side have the same or equivalent surface geometry.

The behaviour of the function is controlled by option structure
PK_TOPOL_identify_redundant_o_t.