1rbox(1) General Commands Manual rbox(1)
2
6 rbox - generate point distributions for qhull
7
9 Command "rbox" (w/o arguments) lists the options.
10
12 rbox generates random or regular points according to the options given,
13 and outputs the points to stdout. The points are generated in a cube,
14 unless 's' or 'k' option is given. The format of the output is the
15 following: first line contains the dimension and a comment, second line
16 contains the number of points, and the following lines contain the
17 points, one point per line. Points are represented by their coordinate
18 values.
19
21 rbox 10
22 10 random points in the unit cube centered at the origin.
23 rbox 10 s D2
25 10 random points on a 2‐d circle.
26 rbox 100 W0
28 100 random points on the surface of a cube.
29 rbox 1000 s D4
31 1000 random points on a 4‐d sphere.
32 rbox c D5 O0.5
34 a 5‐d hypercube with one corner at the origin.
35 rbox d D10
37 a 10‐d diamond.
38 rbox x 1000 r W0
40 100 random points on the surface of a fixed simplex
41 rbox y D12
43 a 12‐d simplex.
44 rbox l 10
46 10 random points along a spiral
47 rbox l 10 r
49 10 regular points along a spiral plus two end points
50 rbox 1000 L10000 D4 s
52 1000 random points on the surface of a narrow lens.
53 rbox c G2 d G3
55 a cube with coordinates +2/-2 and a diamond with coordinates
56 +3/-3.
57 rbox 64 M3,4 z
59 a rotated, {0,1,2,3} x {0,1,2,3} x {0,1,2,3} lattice (Mesh) of
60 integer points. 'rbox 64 M1,0' is orthogonal.
61 rbox P0 P0 P0 P0 P0
63 5 copies of the origin in 3-d. Try 'rbox P0 P0 P0 P0 P0 | qhull
64 QJ'.
65 r 100 s Z1 G0.1
67 two cospherical 100-gons plus another cospherical point.
68 100 s Z1
70 a cone of points.
71 100 s Z1e-7
73 a narrow cone of points with many precision errors.
74
76 n number of points
77 Dn dimension n‐d (default 3‐d)
79 Bn bounding box coordinates (default 0.5)
81 l spiral distribution, available only in 3‐d
83 Ln lens distribution of radius n. May be used with 's', 'r', 'G',
85 and 'W'.
86 Mn,m,r lattice (Mesh) rotated by {[n,-m,0], [m,n,0], [0,0,r], ...}.
88 Use 'Mm,n' for a rigid rotation with r = sqrt(n^2+m^2). 'M1,0'
89 is an orthogonal lattice. For example, '27 M1,0' is {0,1,2} x
90 {0,1,2} x {0,1,2}. '27 M3,4 z' is a rotated integer lattice.
91 s cospherical points randomly generated in a cube and projected to
93 the unit sphere
94 x simplicial distribution. It is fixed for option 'r'. May be
96 used with 'W'.
97 y simplicial distribution plus a simplex. Both 'x' and 'y' gener‐
99 ate the same points.
100 Wn restrict points to distance n of the surface of a sphere or a
102 cube
103 c add a unit cube to the output
105 c Gm add a cube with all combinations of +m and -m to the output
107 d add a unit diamond to the output.
109 d Gm add a diamond made of 0, +m and -m to the output
111 Cn,r,m add n nearly coincident points within radius r of m points
113 Pn,m,r add point [n,m,r] to the output first. Pad coordinates with
115 0.0.
116 n Remove the command line from the first line of output.
118 On offset the data by adding n to each coordinate.
120 t use time in seconds as the random number seed (default is com‐
122 mand line).
123 tn set the random number seed to n.
125 z generate integer coordinates. Use 'Bn' to change the range.
127 The default is 'B1e6' for six‐digit coordinates. In R^4, seven‐
128 digit coordinates will overflow hyperplane normalization.
129 Zn s restrict points to a disk about the z+ axis and the sphere
131 (default Z1.0). Includes the opposite pole. 'Z1e-6' generates
132 degenerate points under single precision.
133 Zn Gm s
135 same as Zn with an empty center (default G0.5).
136 r s D2 generate a regular polygon
138 r s Z1 G0.1
140 generate a regular cone
141
143 Some combinations of arguments generate odd results.
144 Report bugs to qhull_bug@qhull.org, other correspondence to
146 qhull@qhull.org
147
149 qhull(1)
150
152 C. Bradford Barber
153 bradb@shore.net
154Geometry Center August 10, 1998 rbox(1)