Function t8_dtri_transform_face(const t8_dtri_t *, t8_dtri_t *, int, int, int)

Function Documentation

void t8_dtri_transform_face(const t8_dtri_t *trianglein, t8_dtri_t *triangle2, int orientation, int sign, int is_smaller_face)

Suppose we have two trees that share a common triangle f. Given a triangle e that is a subface of f in one of the trees and given the orientation of the tree connection, construct the face triangle of the respective tree neighbor that logically coincides with e but lies in the coordinate system of the neighbor tree.

Note

trianglein and triangle2 may point to the same element.

Parameters:
  • trianglein[in] The face triangle.

  • triangle2[inout] On return the face triangle triangle1 with respective to the coordinate system of the other tree.

  • orientation[in] The orientation of the tree-tree connection.

  • sign[in] Depending on the topological orientation of the two tree faces, either 0 (both faces have opposite orientation) or 1 (both faces have the same top. orientation). t8_eclass_face_orientation

  • is_smaller_face[in] Flag to declare whether triangle1 belongs to the smaller face. A face f of tree T is smaller than f’ of T’ if either the eclass of T is smaller or if the classes are equal and f<f’. The orientation is defined in relation to the smaller face.