HYPERCUBE_GRID
Grid of Points Inside a Hypercube in M Dimensions

HYPERCUBE_GRID is a Python library which generates a grid of points over the interior of a hypercube in M dimensions.

The M-dimensional hypercube is the set of points (X(1),X(2),...,X(M)) 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:

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

Related Data and Programs:

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

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

CUBE_GRID, a Python library which computes a grid of points over the interior of a cube in 3D.

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

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

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

HYPERCUBE_MONTE_CARLO, a Python library which applies a Monte Carlo method to estimate the integral of a function over the interior of the unit hypercube in M dimensions;

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

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

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

SIMPLEX_GRID, a Python library which generates a regular grid of points over the interior of an arbitrary simplex in M dimensions.

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

SPHERE_LLQ_GRID, a Python 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 Python 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 Python library which computes a grid of points over the interior of a square in 2D.

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

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

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

Source Code:

• hypercube_grid_points.m, grid points over the interior of a hypercube in M-dimensions.
• r8mat_print.py, prints an R8MAT.
• r8mat_print_some.py, prints some of an R8MAT.
• r8mat_write.py, writes an R8MAT to a file.
• r8vec_direct_product.py, computes the M-dimensional direct product of M 1-dimensional vectors.
• timestamp.py, prints the current YMDHMS date as a time stamp.

Examples and Tests:

• hypercube_grid_test.py, calls all the tests.
• hypercube_grid_test.sh, runs all the tests.
• hypercube_grid_test.txt, the output file.
• hypercube_grid_points_test01.xyz, a sample set of grid points written to a file.
• hypercube_grid_points_test02.xyz, a sample set of grid points written to a file.
• hypercube_grid_points_test03.xyz, a sample set of grid points written to a file.

You can go up one level to the Python source codes.