CUBE_GRID
Grid of Points Inside a Cube in 3D

CUBE_GRID is a C++ library which generates a grid of points over the interior of a cube in 3D.

The 3D cube is the set of points (X(1),X(2),X(3)) such that:

         A(I) <= X(I) <= B(I)
       

For each dimension I, a set of parameters is input:

• NS(I), the number of points along the I-th coordinate direction;
• A(I), B(I), the left and right endpoints of the I-th coordinate.
• C(I), one of 5 choices for centering the grid in the I-th coordinate.

The centering options allow the user to control the centering of the equally spaced points. This is easiest to illustrate if we look at a 1 dimensional case and assume A = 0 and B = 1. Then, using NS = 4, the centering options will produce 4 equally spaced points as follows:

• 1: 0, 1/3, 2/3, 1 (include endpoints)
• 2: 1/5, 2/5, 3/5, 4/5 (do not include endpoints)
• 3: 0, 1/4, 2/4, 3/4 (do not include right endpoint)
• 4: 1/4, 2/4, 3/4, 1 (do not include left endpoint)
• 5: 1/8, 3/8, 5/8, 7/8 (half spacing at the ends)

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

CUBE_GRID is available in a C version and a C++ version and a FORTRAN77 version and a FORTRAN90 version and a MATLAB version and a Python version.

Related Data and Programs:

BALL_GRID, a C++ library which computes a grid of points over the interior of a ball in 3D.

CIRCLE_ARC_GRID, a C++ program which computes a grid of points over the length of a circular arc in 2D;

DISK_GRID, a C++ library which computes a grid of points over the interior of a disk in 2D.

ELLIPSE_GRID, a C++ library which computes a grid of points over the interior of an ellipse in 2D.

ELLIPSOID_GRID, a C++ library which computes a grid of points over the interior of an ellipsoid in 3D.

HYPERCUBE_GRID, a C++ library which computes a grid of points over the interior of a hypercube in M dimensions.

LINE_GRID, a C++ library which computes a grid of points over the interior of a line segment in 1D.

POLYGON_GRID, a C++ library which generates a grid of points over the interior of a polygon in 2D.

PYRAMID_GRID, a C++ library which computes a grid of points over the interior of the unit pyramid in 3D.

SIMPLEX_GRID, a C++ library which generates a grid of points over the interior of a simplex in M dimensions.

SPHERE_FIBONACCI_GRID, a C++ library which uses a Fibonacci spiral to create a grid of points on the surface of the unit sphere in 3D.

SPHERE_GRID, a C++ library which provides a number of ways of generating grids of points, or of points and lines, or of points and lines and faces, on the surface of the unit sphere in 3D.

SPHERE_LLQ_GRID, a C++ library which uses longitudes and latitudes to create grids of points, lines, and quadrilaterals on the surface of the unit sphere in 3D.

SPHERE_LLT_GRID, a C++ library which uses longitudes and latitudes to create grids of points, lines, and triangles on the surface of the unit sphere in 3D.

SQUARE_GRID, a C++ library which computes a grid of points over the interior of a square in 2D.

TETRAHEDRON_GRID, a C++ library which computes a grid of points over the interior of a tetrahedron in 3D.

TRIANGLE_GRID, a C++ library which computes a grid of points over the interior of a triangle in 2D.

WEDGE_GRID, a C++ library which computes a grid of points over the interior of the unit wedge in 3D.

Source Code:

• cube_grid.cpp, the source code.
• cube_grid.hpp, the include file.
• cube_grid.sh, BASH commands to compile the source code.

Examples and Tests:

• cube_grid_prb.cpp, a sample calling program.
• cube_grid_prb.sh, BASH commands to compile and run the sample program.
• cube_grid_prb_output.txt, the output file.

List of Routines:

• CUBE_GRID: grid points over the interior of a cube in 3D.
• R8MAT_TRANSPOSE_PRINT prints an R8MAT, transposed.
• R8MAT_TRANSPOSE_PRINT_SOME prints some of an R8MAT, transposed.
• R8VEC_DIRECT_PRODUCT creates a direct product of R8VEC's.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the C++ source codes.