Scroll to navigation

rbox(1) General Commands Manual rbox(1)


rbox - generate point distributions for qhull


Command "rbox" (w/o arguments) lists the options.


rbox generates random or regular points according to the options given, and outputs the points to stdout. The points are generated in a cube, unless 's' or 'k' option is given. The format of the output is the following: first line contains the dimension and a comment, second line contains the number of points, and the following lines contain the points, one point per line. Points are represented by their coordinate values.


10 random points in the unit cube centered at the origin.
10 random points on a 2‐d circle.
100 random points on the surface of a cube.
1000 random points on a 4‐d sphere.
a 5‐d hypercube with one corner at the origin.
a 10‐d diamond.
100 random points on the surface of a fixed simplex
a 12‐d simplex.
10 random points along a spiral
10 regular points along a spiral plus two end points
1000 random points on the surface of a narrow lens.
a cube with coordinates +2/-2 and a diamond with coordinates +3/-3.
a rotated, {0,1,2,3} x {0,1,2,3} x {0,1,2,3} lattice (Mesh) of integer points. 'rbox 64 M1,0' is orthogonal.
5 copies of the origin in 3-d. Try 'rbox P0 P0 P0 P0 P0 | qhull QJ'.
two cospherical 100-gons plus another cospherical point.
100 s Z1
a cone of points.
100 s Z1e-7
a narrow cone of points with many precision errors.


number of points
dimension n‐d (default 3‐d)
bounding box coordinates (default 0.5)
spiral distribution, available only in 3‐d
lens distribution of radius n. May be used with 's', 'r', 'G', and 'W'.
lattice (Mesh) rotated by {[n,-m,0], [m,n,0], [0,0,r], ...}. Use 'Mm,n' for a rigid rotation with r = sqrt(n^2+m^2). 'M1,0' is an orthogonal lattice. For example, '27 M1,0' is {0,1,2} x {0,1,2} x {0,1,2}. '27 M3,4 z' is a rotated integer lattice.
cospherical points randomly generated in a cube and projected to the unit sphere
simplicial distribution. It is fixed for option 'r'. May be used with 'W'.
simplicial distribution plus a simplex. Both 'x' and 'y' generate the same points.
restrict points to distance n of the surface of a sphere or a cube
add a unit cube to the output
c Gm
add a cube with all combinations of +m and -m to the output
add a unit diamond to the output.
d Gm
add a diamond made of 0, +m and -m to the output
add n nearly coincident points within radius r of m points
add point [n,m,r] to the output first. Pad coordinates with 0.0.
Remove the command line from the first line of output.
offset the data by adding n to each coordinate.
use time in seconds as the random number seed (default is command line).
set the random number seed to n.
generate integer coordinates. Use 'Bn' to change the range. The default is 'B1e6' for six‐digit coordinates. In R^4, seven‐digit coordinates will overflow hyperplane normalization.
restrict points to a disk about the z+ axis and the sphere (default Z1.0). Includes the opposite pole. 'Z1e-6' generates degenerate points under single precision.
same as Zn with an empty center (default G0.5).
generate a regular polygon
generate a regular cone


Some combinations of arguments generate odd results.

Report bugs to, other correspondence to




C. Bradford Barber

August 10, 1998 Geometry Center