PK_ERROR_code_t  PK_TOPOL_make_general_body
(
--- received arguments ---
int               n_topols,     --- number of topologies (> 0)
const PK_TOPOL_t  topols[],     --- array of topologies

--- returned arguments ---
PK_BODY_t  *const body,         --- general body
PK_TOPOL_t        copy_topols[] --- corresponding copy topologies
)


This function creates a general body from a set of topologies.


The geometry, topology and associated data of the topols are copied into a
new general body.  If the new body requires additional regions and shells to
make it valid, then these are created.  Each member of topols must be a
region, face, edge or vertex, which may occur in any combination and in any
order.  All the given topols must belong to the same body which may be of any
type.

The new general body will be returned in body.  The array copy_topols is
the same length as topols and each member of copy_topols will be the copy
of the corresponding member of topols.