PK_TOPOL_make_new

PK_ERROR_code_t                PK_TOPOL_make_new
(
--- received arguments ---
PK_TOPOL_t                     topol,       --- topol
const PK_TOPOL_make_new_o_t   *options,     --- options structure

--- returned arguments ---
PK_TOPOL_t              *const new_topol    --- new topol
)


This function removes groups and attributes attached to 'topol' and
replaces 'topol' with 'new_topol'.The topological entity must be a face.


Specific Errors:
    PK_ERROR_unsuitable_entity    the entity in 'topol' is not a face.


This function replaces 'topol' with a "new one", with identical topology
and geometry. The old 'topol' will be logged as deleted, the new one as
created, no 'topol' splitting or merging will occur and the new topol
will have a new tag 'new_topol'. The new topol does not have attributes
and does not belong to any group.