triangulation_mask, a MATLAB code which reads the nodes and triangles that define a triangulation, calls a user routine which determines whether each triangle is to be preserved or discarded ("masked") from the triangulation, and writes out new node and triangle files that define the masked triangulation.
The input file prefix_nodes.txt contains the node information for the triangulation. Each data line contains the X and Y coordinates of a single node.
The input file prefix_elements.txt contains the triangle information for the triangulation. Each line contains the indices of 3 or 6 nodes that form a triangle.
One motivation for creating this program is as follows. Suppose we have a set of points that lie on the boundary or inside of a non-convex region. If we naively call an unconstrained Delaunay triangulation routine, such as TABLE_DELAUNAY, then because the region is not convex, it is possible to create triangles which lie outside the region.
An easy way to correct this problem is to call a user routine and pass it the indices and coordinates of each triangle. The user can then decide to drop any triangle whose centroid, say, lies outside the region.
Other masking criteria might drop triangles that are too small, or that have too small an angle, or that lie inside some interior hole. These choices are entirely up to the user.
In the following discussion, the user masking routine is called "triangle_mask", but the actual name is arbitrary. The actual name is passed as the third argument into the program. It must be preceded by an "@" sign, so that MATLAB knows that this is the name of a function (technically, a MATLAB "function handle").
The user masking routine has the form:
function mask = triangle_mask ( dim_num, triangle_order, nodes, coord )with arguments:
The command to invoke the program has the form:
triangulation_mask ( 'prefix_file', @'triangle_mask' )where prefix is the common filename prefix:
The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.
triangulation_mask is available in a C++ version and a FORTRAN90 version and a MATLAB version.
triangulation, a MATLAB code which carries out various operations on order 3 ("linear") or order 6 ("quadratic") triangulations.
triangulation_boundary_edges, a MATLAB code which reads data defining a triangulation, determines which edges lie on the boundary, organizes them into connected components, and writes this information to a file.
triangulation_boundary_nodes, a MATLAB code which reads data defining a triangulation, determines which nodes lie on the boundary, and writes their coordinates to a file.
triangulation_corner, a MATLAB code which patches triangulations so that no triangle has two sides on the boundary.
triangulation_delaunay_discrepancy, a MATLAB code which measures the amount by which a triangulation fails the local delaunay test;
triangulation_display, a MATLAB code which displays the nodes and elements of a triangulation on the MATLAB graphics screen;
triangulation_histogram, a MATLAB code which computes histograms of data over a triangulation.
triangulation_l2q, a MATLAB code which reads data defining a 3-node triangulation and generates midside nodes and writes out the corresponding 6-node triangulation.
triangulation_order3, a directory which contains a description and examples of order 3 triangulations.
triangulation_order6, a directory which contains a description and examples of order 6 triangulations.
triangulation_orient, a MATLAB code which reads data defining a triangulation, makes sure that every triangle has positive orientation, and if not, writes a corrected triangle file.
triangulation_plot, a MATLAB code which reads data defining a triangulation and creates a postscript image of the nodes and triangles.
triangulation_q2l, a MATLAB code which reads data defining a 6-node triangulation, and subdivides each triangle into 4 3-node triangles, writing the resulting triangulation to a file.
triangulation_quad, a MATLAB code which estimates the integral of a function over a triangulated region.
triangulation_quality, a MATLAB code which reads data defining a triangulation and computes a number of quality measures.
triangulation_rcm, a MATLAB code which reads data defining a triangulation, determines an ordering of the nodes that will reduce the bandwidth of the adjacency matrix, and writes the new triangulation information to a file.
triangulation_refine, a MATLAB code which reads data defining a triangulation, replaces each triangle by four congruent smaller ones, and writes the new triangulation information to a file.
triangulation_triangle_neighbors, a MATLAB code which reads data defining a triangulation, determines the neighboring triangles of each triangle, and writes that information to a file.