Function t8_forest_get_coarse_tree_ext

Function Documentation

t8_ctree_t t8_forest_get_coarse_tree_ext(t8_forest_t forest, t8_locidx_t ltreeid, t8_locidx_t **face_neigh, int8_t **ttf)

Given the local id of a tree in a forest, return the coarse tree of the cmesh that corresponds to this tree, also return the neighbor information of the tree.

Parameters:
  • forest[in] The forest.

  • ltreeid[in] The local id of a tree in the forest.

  • face_neigh[out] If not NULL a pointer to the trees face_neighbor array is stored here on return.

  • ttf[out] If not NULL a pointer to the trees tree_to_face array is stored here on return.

Returns:

The coarse tree that matches the forest tree with local id ltreeid.