RandomTools Flavor: nonzero
describe a flavor of a random nonzero rational number
Calling Sequence
Parameters
Description
Examples
nonzero
nonzero(opts)
opts
-
equation(s) of the form option = value where option is one of range, character, or denominator; specify options for the random nonzero rational number
The flavor nonzero describes a random nonzero rational number in a particular range.
To describe a flavor of a random nonzero rational number, use either nonzero or nonzero(opts) (where opts is described following) as the argument to RandomTools[Generate] or as part of a structured flavor.
By default, the flavor nonzero describes a random nonzero rational number in the range , exclusive, with a denominator that is a factor of .
You can modify the properties of a random nonzero rational number by using the nonzero(opts) form of this flavor. The opts argument can contain one or more of the following equations.
range = a..b
This option specifies the range from which the random nonzero rational number is chosen. The left-hand endpoint a is a nonzero rational number and the right-hand endpoint b is a nonzero rational number.
If the left-hand endpoint of the range is greater than the right-hand endpoint, an exception is raised.
The default range is .
character = boundary conditions
This option specifies whether to include the endpoints of the range from which the random nonzero rational number is chosen. Six boundary definitions are valid: open, closed, open..open, open..closed, closed..open, and closed..closed. The default value for this option is open.
The definitions open and closed are abbreviations for open..open and closed..closed, respectively.
If the range option is used in conjunction with this option, and a value outside the boundary definition is returned, then the nonzero rational number closest to (but not touching) the range endpoint is chosen.
denominator = posint
This option specifies the positive integer to use as the denominator for the random nonzero rational number that is generated.
The default denominator for a nonzero flavor is related to . (It depends on whether the endpoints are open or closed and the length of the interval.) The default denominator is .
In the case of the closed interval , the denominator has only factors (, , , ) only two of which are under . Therefore, a result of cannot occur. Instead, you can specify a denominator that is highly composite. For example, .
See Also
convert/rational
rand
RandomTools
RandomTools[Generate]
type/posint
type/rational
Download Help Document