Referencecolumn (for matrix)

<column> (in a matrix)

A column of cells within a `<spreadsheet>`

<column> is a Math component that defines the individual column entries of a <matrix>. Inside a <matrix>, the entries of each <column> are math values (rather than the <cell> children used in a <spreadsheet>).

Attributes and Properties

Attributes for <column>

Other (5)

text. Column number where this column is placed (1-based).

textList. Symbols treated as function names when parsing.

parseScientificNotation

boolean. Whether to parse expressions like 1e3 as scientific notation.

reference. References whose names should be treated as function symbols when parsing.

boolean. Whether multi-character symbols are split into a product of variables.

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 <column name="c">

Other (5)
$c.colNum

text. Column number where this column is placed (1-based).

$c.disabled

boolean. Whether this component is disabled and cannot be interacted with.

$c.fixed

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

$c.fixLocation

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

$c.hidden

boolean. Whether this component is hidden from the rendered output.

Common to all components (4)
$c.doenetML

text. The DoenetML source code that produced this component.

$c.hide

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

$c.isResponse

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

$c.styleNumber

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

Examples

Example: Defining a <matrix> with <column> components

One method for defining a <matrix> in Doenet is to nest <column> components inside the opening and closing tags. Individual columns can be accessed using index notation with the columns property of the <matrix>.

Example: A <column> with symbolic math

Since a <column> is a Math Component, some of the general attributes of a <math> also work inside a <column>, such as functionSymbols. To use other <math> attributes (such as simplify), you can nest individual <math> components within a <column>.

Attribute Examples

Attribute Example: functionSymbols

The functionSymbols attribute designates special characters or strings that are to be considered functions. By default, only the characters ff and gg are considered function symbols when employed within a Math Component.

Attribute Example: splitSymbols

By default, letters placed adjacent to one another in a <math> component are separated by Doenet for computations, so xyz is interpreted as x⋅y⋅zx \cdot y \cdot z, rather than a single variable composed of three letters. To override this default behavior, set the splitSymbols attribute to false.

Since a <column> is a type of Math Component, it follows this convention, with the exception that spaces between individual entries in a <column> are considered distinct entries (similar to the entries in a <mathList>, while in a general <math>, a space represents implied multiplication.)

Attribute Example: referencesAreFunctionSymbols

The referencesAreFunctionSymbols attribute designates special characters or strings that are to be considered functions, when they are references from another component by name. In this case, the symbolic function letters are selected at random from a list of 6 possibilities.

Note that, even though f and g are default function symbols when written directly, in this example they are referenced values and therefore we need to tell Doenet that they represent functions.

Property Examples

Property Example: columns

Technically speaking, the columns property belongs to the parent <matrix>, rather than the <column>. The information is repeated here, however, because it is a useful way of accessing individual columns and entries.

collectcolumn (for table)