<selectFromSequence>
<selectFromSequence> is a Math
component that randomly selects values from a user-defined sequence of numbers, math expressions, or letters. Selections generate variants of the document.
Attributes and Properties
Attributes for <selectFromSequence>
Highlighted (6)
asListboolean. Default value: true. Whether to render the items separated by commas (true) or with no separator (false).
_componentWithSelectableType. The first value in the sequence.
lengthinteger. The number of values in the sequence.
math. The increment between successive values in the sequence.
_componentWithSelectableType. The last value in the sequence. Used together with from to determine length when length is not specified.
keyword. The kind of values in the sequence.
| Value | Description |
|---|---|
number | A sequence of numeric values. |
math | A sequence of math expressions (allows symbolic from/to/step). |
letters | A sequence of letters (single-letter or multi-letter labels). |
Number display (5)
avoidScientificNotationAdded in 0.7.16boolean. Default value: false. Whether to render numbers in full decimal form rather than scientific notation.
displayDecimalsinteger. Default value: 2. Number of decimal places to display when rendering this number.
displayDigitsinteger. Default value: 3. Number of significant digits to display when rendering this number.
displaySmallAsZeronumber. Default value: 1e-14. Threshold below which numbers are displayed as zero.
padZerosboolean. Default value: false. Whether to pad displayed numbers with trailing zeros to fill the requested digits/decimals.
Other (6)
coprimeboolean. Default value: false. Require the selected numbers to be pairwise coprime (numbers only).
_componentListWithSelectableType. Values to exclude from the sequence.
_componentListOfListsWithSelectableType. Lists of value combinations to exclude from the selection.
integer. Default value: 1. How many values to select from the sequence.
sortAdded in 0.7.14keyword. Whether and how to sort the selected values.
| Value | Description |
|---|---|
unsorted (default) | Preserve the random selection order. |
increasing | Sort the selected values in increasing order. |
decreasing | Sort the selected values in decreasing order. |
boolean. Default value: false. Whether the same value can be selected more than once.
Common to all components (9)
copyreference. Create an independent copy of another component by reference. Enter a references a $name.
disabledboolean. Default value: false. Whether this component is disabled and cannot be interacted with.
extendreference. Extend another component by reference, inheriting its children and attributes. Enter a reference as $name.
fixedboolean. Default value: false. Whether this component's value is fixed and cannot be modified.
fixLocationboolean. Default value: false. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).
hideboolean. Default value: false. Whether to hide this component from the rendered output.
isResponseboolean. Default value: false. Whether this component is treated as a response for the purposes of assessment.
nametext. The name used to reference this component from elsewhere in the document.
styleNumberinteger. Default value: 1. The style number used to select this component's visual styling from the available style definitions.
Properties for <selectFromSequence name="s">
Number display (5)
$s.avoidScientificNotationIn developmentboolean. Whether to render numbers in full decimal form rather than scientific notation.
$s.displayDecimalsIn developmentinteger. Number of decimal places to display when rendering this number.
$s.displayDigitsIn developmentinteger. Number of significant digits to display when rendering this number.
$s.displaySmallAsZeroIn developmentnumber. Threshold below which numbers are displayed as zero.
$s.padZerosIn developmentboolean. Whether to pad displayed numbers with trailing zeros to fill the requested digits/decimals.
Other (4)
$s.coprimeboolean. Require the selected numbers to be pairwise coprime (numbers only).
$s.numToSelectinteger. How many values to select from the sequence.
$s.sortAdded in 0.7.14text. Whether and how to sort the selected values.
$s.withReplacementboolean. Whether the same value can be selected more than once.
Common to all components (8)
$s.disabledIn developmentboolean. Whether this component is disabled and cannot be interacted with.
$s.doenetMLtext. The DoenetML source code that produced this component.
$s.fixedIn developmentboolean. Whether this component's value is fixed and cannot be modified.
$s.fixLocationIn developmentboolean. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).
$s.hideboolean. Whether to hide this component from the rendered output.
$s.isResponseboolean. Whether this component is treated as a response for the purposes of assessment.
$s.styleNumberinteger. The style number used to select this component's visual styling from the available style definitions.
Examples
Example: Default <selectFromSequence>
The default <selectFromSequence> has a sequence range from to .
Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.
Example: Generate multiple selections
Three numbers are selected between -5 and 5 (stepping in increments of 0.5). Individual selections can be accessed using array notation.
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 between -5 and 5 (stepping in increments of 0.5). 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 numToSelect attribute allows for selection of multiple values within the range of a
single <selectFromSequence> component. Multiple selections are made without replacement, unless
the withReplacement attribute is also specified.
Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.
Attribute Example: sort
The sort attribute determines how selected results are sorted. It accepts three values:
"unsorted"(default) - results are in the order they were selected"increasing"- results are sorted in increasing order"decreasing"- results are sorted in decreasing order
Alternatively, sort and sort="true" are equivalent to sort="increasing", and sort="false" is equivalent to sort="unsorted".
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 from and to attributes specify the endpoints of the selection interval.
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 step attribute specifies the size of each increment in the sequence. The default step is
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 exclude attribute specifies values to exclude in the selection.
Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.
Attribute Example: withReplacement
If selection with replacement is the desired behavior, use the withReplacement 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: excludeCombinations
The excludeCombinations attribute can be used to exclude unfavorable combinations of
parameters. In this example, the exclusions have been designed to prevent the condition
that the coefficients in the expression result in a sum of .
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
The type attribute takes either letters or number as a text input. If unspecified,
the default type is number.
Select a new page variant from the pulldown menu at the top of the editor to see different variants of the document.