sdaps-class

Table Of Contents

sdapslayout package

This package provides a set of more complex layouting options on top of the sdapsarray package. The following environments are provided:

• choicearray

• rangearray

The rangearray is not quite as powerful, as it does not expose some of the sdapsarray options to the user. Note that much more complex custom layouts can be created directly with sdapsarray.

Warning

The documentation here is currently incomplete! Pleases refer to the sdapsclassic choicegroup and markgroup documentation!

\begin{choicearray} [kwargs]

\end{choicearray}

The following optional keyword parameters can be passed to the environment. These keyword parameters default to the values provided in the SDAPS context and can for example be modified globally for the document.

Keyword Arguments

• align – named alignment group, set to a common name to align multiple environments to each other

• noalign – disable alignment (same as setting align to an empty value)

• horizontal – set horizontal mode where each question is one row (default)

• layouter – set the sdapsarray layouter (e.g. rotated for rotated column headers)

• angle – set the angle of the column headers when in rotated mode

• vertical – set vertical mode where each question is one column

• type – the question type “multichoice” or “singlechoice”

• multichoice – switch to multichoice “Choice” question mode

• singlechoice – switch to singlechoice “Option” question mode

The choicearray environment represents a tabular layout for a set of multiple choice questions which have the same possible answers. A new header is created in the metadata to group the questions.

Warning

The header is currently not shown in the PDF and it cannot contain fragile content due to implementation constraints! This is an issue with the class which will be fixed. The exact final behaviour is not yet specified.

Example LaTeX codeResult

\begin{choicearray}[layouter=rotated]
  \choice{Choice 1}
  \choice{Choice 2}
  \question{Question one}
  \question{Question two}
\end{choicearray}

Example of a choicearray environment

Example LaTeX codeResult

\begin{choicearray}[layouter=rotated,vertical]
  \choice{Choice 1}
  \choice{Choice 2}
  \question{Question one}
  \question{Question two}
\end{choicearray}

Example of a vertical choicearray environment

Todo

Right now all arguments can be overriden, this should not be the case. It would be correct if the variable name is loaded from the kwargs, and then the defaults for align and horizontal/vertical should be applied

Inside the environment you need to first define all possible answers with choice macro and each question using the question macro.

\begin{optionarray} [kwargs]

\end{optionarray}

Identical to choicearray with the singlechoice keyword arguemnt set by default.

\begin{rangearray} [kwargs]

\end{rangearray}

Keyword Arguments

• align – named alignment group, set to a common name to align multiple environments to each other

• count – the number of choices in the scale (default: 5)

• other – whether to show an alternative answer outside of the scale

• layouter – set the sdapsarray layouter (unlikely to be useful in this case)

The rangearray environment is used for a scale with lower/upper labels plus optionally a further checkmark outside of the range.

Each question is added using the \range macro.

\range [kwargs] {question} {lower} {upper} {other}

Arguments

• question – The question text.

• lower – The text for the lower end label.

• upper – The text for the upper end label.

• upper – The text for the alternative choice (only valid if other is passed to the environmet.

Keyword Arguments

• var – Variable name for this question (to be appended to context).

• text – A replacement text for the metadata, if set fragile content is permitted inside the text argument.

• upper – A replacement text for the metadata, if set fragile content is permitted inside the upper argument.

• lower – A replacement text for the metadata, if set fragile content is permitted inside the lower argument.

• other – A replacement text for the metadata, if set fragile content is permitted inside the other argument.

Example LaTeX codeResult

\begin{rangearray}[count=7,other]
  \range{Question one}{lower}{upper}{other}
  \range{Question two}{bad}{good}{unsure}
\end{rangearray}

\begin{rangearray}
  \range{Question three}{lower}{upper}
  \range{Question four}{bad}{good}
\end{rangearray}

Example of a rangearray environment

arrow_back

Previous

sdapsclassic class

arrow_forward

Next

sdapspdf package