# How do I create a mathematical question?

The mathematics questions in Cirrus are based on the *open *type questions of Sowiso. We advise to make the questions in Sowiso and upload them to Cirrus.

## Making a question

- Navigate from the library to the screen for the selecting the questiontype.
- Select
**Mathematical question**.

- Fill in the title of the question.
- Fill in the question.
- Fill in how many points can be received from this question.

You can use LaTeX in the textfields, see LaTeX in Cirrus for more information.

- Fill in the description of the solution. This is the description the student sees, not the solution that Cirrus uses to determine whether a student answer is correct.
- Fill in
**pre**- and**post****input**. This is text that is displayed right before or right after the input area (*for example: x=... or ... meter*). - Under
**Solution**you fill in the right answer(s).- Under
**Evaluation Type**you choose how the answer of the student is compared to the answer definition. - Under
**Definition**you define the solution. Cirrus uses Maxima to compare the definitions. - Under
**Answer fields**you determine the answer field to which the solution rule applies. - Click on
**Add Solution**if you want to add a solution rule.

- Under
- Click on
**Save**.

After saving you can select how many input fields there are (in other words how many parts the correct answer consists of). For each input field a separate pre- and post input can be defined, as well as a solution definition.

The evaluation type and the definition are used to determine whether the answer of the student was correct. For more information on the evaluation types visit the Cirrus website or the Sowiso manual.

### Variables

Navigate to the **Variables **tab (second tab).

- Click on
**Add variable**to add a new variable. Each variable gets a unique id assigned by Cirrus. For exampel`$a`

. You can call this in every possible field. If a variable self- or circle refers you will get an error message. - Use php or
**maxima**- You can write php code immediately in the definition field.
- For php some restrictions apply. See the Sowiso manual for more information.
- To compute maxima code you will need to call the Maxima environment first, for example with
`sw_maxima().`

- Choose the numbers of decimals your variable uses (not required).
- Save the variable definitions.

The specified number of decimals only determines the amount of decimal numbers displayed. Not the amount of numbers stored. Consider this when defining the answer.

The error messages of Cirrus are very limited and concise, those of Sowiso more elaborate and insightful. We therefore advice you to create the exercises in Sowiso. If you would like to receive example exercises, contact ICT in Education.

#### Negative Feedback

- Navigate to
**Negative Feedback**(third tab).

- Define the answer to which the negative feedback applies. You define this the same way as the solution definition.
- Use
**Priority**to determine the order in which the feedback rules are evaluated. Cirrus considers the lowest integers first. Two feedback rules may not share the same priority. - Determine the
**Answer fields**to which the feedback rule applies. - Choose the correct
**Evaluation type**. You define this the same way as the solution definition. - Check the
**Test usage**box to let the feedback rule influence the students grade. Give the percentage (as a multiple of 10) that the student still gets for this answer field if the feedback rule applies.

Cirrus checks the Negative feedback if the student has provided a false answer. You can use this to give the student points if the wrong answer satisfies certain conditions. If the answer satisfies no negative feedback rule the student gets zero points.

##### Positive feedback

Navigate to **Positive feedback** (fourth tab).

You define positive feedback exactly the same as negative feedback.

Cirrus compares the answer of the student with the positive feedback if the students answer was correct. You can use this to withdraw points under certain conditions. If the answer does not satisfy any positive feedback rule the student gets full points.

If a feedback rule is applied, this does not change the way the students see their result in the perusal. The amount of allocated points is the only way to check whether the feedback rule was correctly applied.

##### Question Set

Navigate to **Question set** (fifth tab).

You use question sets to ask multiple questions using the same variables.

- Click
**Add**to add a question.- Make this question the same way as before. All the variables from the previous exercise are saved and use the same name as before.

- Save the question set.
- Preview the question set to make sure all the variables remained the same.

##### LaTeX in Cirrus

It is possible to use LaTeX in almost all textfields in Cirrus.

- You open the LaTeX math environment with a
`#`

or a`\(`

for inline TeX and`\[`

for centered TeX on a new line. - You close the math environment using
`#`

,`\)`

or`\]`

respectively.

Cirrus has some macros in use. These are the same as the ones in SOWISO. You can find a list in the SOWISO manual.

All the usual AMSmath and AMSsymbols are supported.

One of the more useful examples of a SOWISO macro is `\lineqs{a\cdot x+b\cdot y &=& 0 \cr d\cdot x + e \cdot y &=& f \cdot z \cr} .`

Cirrus and Sowiso use Mathjax to display LaTeX.

##### Advanced options

The candidates can use the workout box to clarify their provided answer. These notes will be stored and can be viewed during the marking process.

Select **Allow workout box for candidates** to allow candidates to have the possibility to argue or calculate their answer.

While compiling the exam you have the option to allow the workoutbox for all questions, none or the selected questions. Please discuss your preferences with the faculty coordinator.