ReferenceselectRandomNumbers

<selectRandomNumbers/>

Selects a fixed set of random numbers to create document variants

<selectRandomNumbers/> is a Math component that generates document variants by selecting random numbers from a specified range of values, from a normal distribution around a specified mean, or from one of the discrete count distributions (hypergeometric, binomial, and Poisson).

Attributes and Properties

Attributes for <selectRandomNumbers>

Other (20)
asList

boolean. Default value: true. Whether to render the items separated by commas (true) or with no separator (false).

avoidScientificNotation

Whether to render numbers in full decimal form rather than scientific notation.

displayDecimals

Number of decimal places to display when rendering this number.

displayDigits

Number of significant digits to display when rendering this number.

displaySmallAsZero

Threshold below which numbers are displayed as zero.

numberList. Values to exclude from the sample space.

number. Lower bound of the sampling range.

mean

number. Mean of the sampling distribution (Gaussian or Poisson). Defaults to 0 for Gaussian and 1 for Poisson.

numDraws

number. Number of items drawn without replacement to form each sample (hypergeometric).

numSuccesses

number. Number of successes in the population drawn from (hypergeometric).

integer. Default value: 1. How many random numbers to select.

numTotal

number. Size of the population drawn from (hypergeometric).

numTrials

number. Default value: 1. Number of independent trials making up each sample (binomial).

padZeros

Whether to pad displayed numbers with trailing zeros to fill the requested digits/decimals.

probability

number. Default value: 0.5. Probability that each trial succeeds (binomial).

standardDeviation

number. Default value: 1. Standard deviation of the sampling distribution (Gaussian).

number. Default value: 1. Step size between samples for the discrete-uniform distribution.

number. Upper bound of the sampling range.

type

keyword. Distribution from which to sample.

ValueDescription
uniform (default)Continuous uniform distribution over [from, to].
discreteUniformDiscrete uniform distribution over integers in [from, to].
gaussianNormal (Gaussian) distribution with the specified mean and standard deviation.
hypergeometricNumber of successes when drawing numDraws items without replacement from a population of numTotal items containing numSuccesses successes.
binomialNumber of successes in numTrials independent trials that each succeed with the given probability.
poissonPoisson distribution with the specified mean (which defaults to 1).
variance

number. Default value: 1. Variance of the sampling distribution (Gaussian).

Common to all components (9)
copy

reference. Create an independent copy of another component by reference. Enter a references a $name.

disabled

boolean. Default value: false. Whether this component is disabled and cannot be interacted with.

extend

reference. Extend another component by reference, inheriting its children and attributes. Enter a reference as $name.

fixed

boolean. Default value: false. Whether this component's value is fixed and cannot be modified.

fixLocation

boolean. Default value: false. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

hide

boolean. Default value: false. Whether to hide this component from the rendered output.

isResponse

boolean. Default value: false. Whether this component is treated as a response for the purposes of assessment.

name

text. The name used to reference this component from elsewhere in the document.

styleNumber

integer. Default value: 1. The style number used to select this component's visual styling from the available style definitions.

Properties for <selectRandomNumbers name="s">

Other (13)
$s.from

number. Lower bound of the sampling range.

$s.mean

number. Mean of the sampling distribution.

$s.numDraws

number. Number of items drawn without replacement to form each sample (hypergeometric).

$s.numSuccesses

number. Number of successes in the population drawn from (hypergeometric).

$s.numToSelect

integer. How many random numbers to select.

$s.numTotal

number. Size of the population drawn from (hypergeometric).

$s.numTrials

number. Number of independent trials making up each sample (binomial).

$s.probability

number. Probability that each trial succeeds (binomial).

$s.standardDeviation

number. Standard deviation of the sampling distribution.

$s.step

number. Step size between sample values (for discrete distributions).

$s.to

number. Upper bound of the sampling range.

$s.type

text. Distribution from which to sample.

$s.variance

number. Variance of the sampling distribution.

Common to all components (4)
$s.doenetML

text. The DoenetML source code that produced this component.

$s.hide

boolean. Whether to hide this component from the rendered output.

$s.isResponse

boolean. Whether this component is treated as a response for the purposes of assessment.

$s.styleNumber

integer. The style number used to select this component's visual styling from the available style definitions.

Examples

Example: Default <selectRandomNumbers/>

Without any attributes specified, the default selection type is uniform, and the default interval is [0,1)[0, 1).

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Example: Assign descriptive names to selections

Three numbers are selected. Selections can be assigned more descriptive names by defining individual components which reference the selected values.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.

Attribute Examples

Attribute Example: numToSelect

The <selectRandomNumbers/> component is used with the numToSelect attribute to select multiple random values in the default interval [0,1)[0,1). The default type is uniform.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: from, to

The <selectRandomNumbers/> component is used with the from and the to attributes to modify the default selection interval. The default type is uniform.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: type = “discreteUniform”

The type attribute of the <selectRandomNumbers/> component is specified as discreteUniform. The discreteUniform selection generates values from an evenly spaced range defined by the attributes to, from, and step. If left unspecified, the default step is 1.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: exclude

The type attribute of the <selectRandomNumbers/> component is specified as discreteUniform. Values can be excluded from the specified range used with this type using the exclude attribute.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: step

The type attribute of the <selectRandomNumbers/> component is specified as discreteUniform. The discreteUniform selection generates values from an evenly spaced range defined by the attributes to, from, and step. If left unspecified, the default step is 1.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: type = “gaussian”

The type attribute of the <selectRandomNumbers/> component is specified as gaussian. The gaussian selection generates standard normal variables (mean 0, variance 1). Alternatively, the mean as well as the variance or the standardDeviation attributes may be defined.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: gaussian with mean and variance

The type attribute of the <selectRandomNumbers/> component is specified as gaussian. The gaussian selection generates standard normal variables (mean 0, variance 1). In this example, the mean and the variance are defined with attributes.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: gaussian with mean and standardDeviation

The type attribute of the <selectRandomNumbers/> component is specified as gaussian. The gaussian selection generates standard normal variables (mean 0, variance 1). In this example, the mean and the standardDeviation are defined with attributes.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: type = “hypergeometric”

The hypergeometric type counts the successes obtained when drawing numDraws items without replacement from a population of numTotal items containing numSuccesses successes. It is the without-replacement counterpart of the binomial type.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: type = “binomial”

The binomial type counts the successes in numTrials independent trials that each succeed with the given probability. If unspecified, numTrials is 1 and probability is 0.5.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.


Attribute Example: type = “poisson”

The poisson type is determined entirely by its mean, which also equals its variance. Unlike the gaussian type, whose mean defaults to 0, the mean of a poisson distribution defaults to 1, since a Poisson distribution with mean 0 always returns 0.

Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.

Limits on the discrete distributions

The three discrete distributions — hypergeometric, binomial, and poisson — draw their values one item, trial, or event at a time, so very large parameters would take a long time and leave the page unresponsive while they ran. Parameters that would need more than ten million draws for a single value are therefore treated as unusable, giving NaN values and statistics along with a warning explaining what to change. The limit is far above the populations, trial counts, and rates that arise in practice; it is there so that mistyping an extra digit reports a problem instead of freezing the activity. An order of magnitude below that, from a million draws per value, the values are still selected as asked, but a warning notes that selection may be slow. Note that both figures apply to each value individually — a large numToSelect still takes proportionally longer.

hypergeometric also has no defaults to fall back on. If any of numTotal, numSuccesses, or numDraws is omitted, or they do not describe a population, every value is NaN, as are the reported mean, variance, and standardDeviation.