# Basic guide to question creation with Wiris Quizzes

#### Wiris Quizzes 4 documentation

This documentation page has also been updated to the latest Wiris Quizzes version. You can find the same information for Wiris Quizzes 4 here.## Sum of two fractions

#### Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one for this example of adding 2 fractions is *Short answer* because we expect the student to answer with just the result.

#### Write the statement

Second, we will write the statement of the problem. Let us ask the students to sum and . Fractions can be written with MathType.

#### Write the correct answer

Third, open Wiris Quizzes Studio by clicking .

Go to *Correct answer* tab and provide the correct answer to the question. Make sure *MathType embedded* or *MathType in popup* is selected, so that students can write the fraction properly.

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Preview* tab. We can check that all the correct answer the student may provide are indeed correct.

*MathType embedded*or

*MathType in popup*on the

*Correct answer*tab.

Once you have finished testing the question, click `OK` so changes are saved and Wiris Quizzes Studio window closes.

#### Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking *Save and continue editing*. This way, we will save the question, but we will be left on the same page.

#### Student view

Now, we should be able to preview the question. Click *Preview*.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

Note we're not requiring the answer to be simplified. We'll look at how to do that in the next exercise.

## Sum of two fractions: simplified answer

#### Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one here is *Short answer* because we expect the student to answer with just the result.

#### Write the statement

Second, we have to write the statement of the problem. Let us ask the students to sum and . Fractions can be written with MathType.

#### Write the correct answer

Third, open Wiris Quizzes Studio by clicking on .

Go to *Correct answer* tab and provide the correct answer to the question. Make sure *MathType embedded* or *MathType in popup* is selected.

#### Configure the evaluation properties

Go to *Validation* tab and select the *is simplified* option under *Additional properties*:

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Preview* tab. We can check that all the correct answers the student may provides are indeed correct. Note that if the answer is not simplified, the question is marked incorrect.

*MathType embedded*or

*MathType in popup*on the

*Correct answer*tab.

Once you have finished testing the question, click `OK` so changes are saved and Wiris Quizzes Studio window closes.

#### Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking on *Save and continue editing*. This way, we will save the question, but we will be left on the same page.

#### Student view

Now, we should be able to preview the question. Click *Preview*.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

## Sum of two random fractions

#### Select the question type

First, we need to select which type of question we will use. Just as in the examples above, the best of the possible options is *Short answer* because we expect the student to answer with just the result.

#### Create random numbers

Before writing the statement, let us write the algorithm of the question. Open Wiris Quizzes Studio by clicking .

Go to *Variables* tab. As you can see, CalcMe is now the default option to generate the question's algorithm, open it by clicking *Edit algorithm*. If you used to use Wiris CAS, it's a good moment to migrate to CalcMe (you can see how here) even though you can still use it by clicking *Use Wiris CAS*.

What you see is CalcMe:

The `random`

command allows us to retrieve a random number in a given interval. We need four random numbers: two numerators and two denominators; that we will call `num1`

, `num2`

, `den1`

, `den2`

(the name of the variables is important, as we will see later on). Let us write the code

Now we have four random numbers between 1 and 9 (both included). We will also compute the sum of the fractions they define and store the result in a variable

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

#### Write the correct answer

*Correct answer*tab and write the correct answer. Now it is not a number, it is a variable that we called

`sol`

. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign `#`

. Therefore, we will write `#sol`

in the correct answer field.
Recall the student will see the same MathType editor as we do in the *Correct answer* or *Preview* tab, so it is very important for either the *MathType embedded* or *MathType in popup* option to be selected.

#### Make sure it all works

Finally, go to *Preview* tab and try some possible answers: check everything works as expected. Although the correct answer provided is simplified, if no additional property is selected, any answer mathematically equal to the correct one will be correct.

*Preview*tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

The view we have on this tab is the same as the students will have. Therefore, they will see the same MathType editor we see, so it is important we select *MathType embedded* or *MathType in popup* on the *Correct answer* tab.

#### Save the changes and assign full grade

Once you have finished testing the question, click `OK` so changes are saved and Wiris Quizzes Studio window closes.

Assign the full grade to the correct answer.

#### Write the statement

Now we proceed to write the statement of the problem. Recall that our numerators and denominators were stored in variables called `num1`

, `num2`

, `den1`

, `den2`

. In the same way as in Correct answer tab, we have to write the name of the variables preceded by the pound sign `#`

. Fractions can be written with MathType.

Finally, save the question by clicking *Save and continue editing* so the question is saved but we still viewing the editing page.

#### Student view

Now, we should be able to preview the question. Click *Preview*.

A new window will show up with the question shown as the student will see it. Here we can test the behavior of the question again.

Every time we preview the question, the numbers in the statement will be different.

## Area of a rectangle

#### Select the question type

Let's select which type of question we will use. As above, the best of the possible options here is *Short answer* because we expect the student to answer with just the result.

#### Write the statement

Second, let us write the statement of the problem. We will ask the students, for instance, to compute the area of a rectangle with base and height .

#### Choose Quantity mode

Open Wiris Quizzes Studio by clicking and go to *Validation* tab.

*Allowed input*field, the

*General*mode is selected by default. This mode is useful for most of the questions, but there are two modes more. We will use

*Text*mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is

*Quantity*.

#### Provide the Correct answer

Wiris Quizzes is capable of automatically grading the answer written by the student once we provide the correct answer. It will not only compare if the answer is the same, but it will also check if the answers are mathematically equal. In our example, it will grade as correct both and , for instance.

We will provide as the correct answer. Make sure *MathType embedded* or *MathType in popup* is selected, otherwise the students will not be able to write the square. The student will see the same MathType editor as we do in the *Correct answer* or *Preview* tab.

`c`

(centi) and `m`

(meters) are colored blue because *Quantity*mode is selected so that they are understood as a metric prefix and a unit, respectively.

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Preview* tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see that if the students forget to write the units, they will get zero points.

`OK` so changes are saved and Wiris Quizzes Studio window closes.

#### Assign full grade and save the question

Finally, we must assign the full grade to the correct answer and save the question by clicking *Save and continue editing*. This way, we will save the question, but we will be left on the same page.

#### Student view

Now, we should be able to preview the question. Click *Preview*.

A new window will show up with the question shown as the student will see it. Here, we can test the behavior of the question again.

## Area of a random rectangle

#### Select the question type

First, we need to select which type of question we will use. Among all the possible options, the best one here is *Short answer* because we expect the student to answer with just the result.

#### Choose Quantity mode

Before writing the statement, let us write the algorithm of the question. Open Wiris Quizzes Studio by clicking and go to *Validation* tab.

*Allowed input*field, the

*General*mode is selected by default. This mode is useful for most of the questions, but there are two modes more. We will use

*Text*mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is

*Quantity*.

#### Create random numbers

Third, we will write the algorithm. Go to *Variables* tab. What you see is CalcMe:

The `random`

command allows us to retrieve a random number in a given interval. We need two random numbers: one for the rectangle's base and one for the height. We will name these `b`

and `h`

, respectively. The name of the variables is important, as we've seen in previous examples. We will also compute the product of the quantities and store the result in a variable. Let's write the code.

*Units of measure tab*. See the very very basic guide of CalcMe for more information.

Now we have two random units whose magnitude is between 1 and 9, inclusive. We will also compute the product of the quantities and store the result in a variable.

Note the solution has the proper units, and it changes every time we execute the algorithm. That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

#### Write the correct answer

*Correct answer*tab and write the correct answer. It is not a number yet; it is a variable we named

`sol`

. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign `#`

.
Recall the student will see the same MathType editor as we do in the *Correct answer* or *Preview* tab, so it is very important for either the *MathType embedded* or *MathType in popup* option to be selected.

`s`

and `l`

are in blue because they are understood as units (seconds and liters, respectively) and *Quantity*mode is selected. However, since they are preceded by

`#`

, they are understood as part of a variable's name rather than as a unit.

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Preview* tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see that if the students forget to write the units, they will get zero points.

*Preview*tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

`OK` so changes are saved and Wiris Quizzes Studio window closes.

#### Assign full grade

Assign the full grade to the correct answer.

#### Write the statement

`b`

and `h`

, respectively. Therefore, as for the correct answer, we have to write the name of the variables preceded by the pound symbol `#`

.

Finally, save the question by clicking *Save changes and continue editing*.

#### Student view

Now, we should be able to preview the question. Click *Preview*.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.

Every time we preview the question, the numbers in the statement will be different.

## Penalization for forgetting the units

- Students will get 100% of the score if they write the area of the rectangle with the correct units.
- Students will get 50% of the score if they write the area of the rectangle without units.

#### Select the question type

First, we need to select which type of question we will use. As above, the best of the possible options for this question is *Short answer* because we expect the student to answer with just the result.

#### Choose Quantity mode

Before writing the statement, let's write the algorithm of the question. Open Wiris Quizzes Studio by clicking and then the *Validation* tab.

*Allowed input*field, the

*General*mode is selected by default. This mode is useful for most of the questions, but there are two additional modes. We will use

*Text*mode when the student has to write simple text as an answer. Since we will be dealing with units (centimeters, in this case), the best mode here is

*Quantity*.

#### Create random numbers

To write the algorithm, go to the *Variables* tab. What you see is CalcMe:

The `random`

command allows us to retrieve a random number in a given interval. We need two random numbers: one for the rectangle's base and one for the height. We will name these `b`

and `h`

, respectively. The name of the variables is important, as we've seen in previous examples. We will also compute the product of the quantities and store the result in a variable. Let's write the code.

Note the solution changes every time we execute the algorithm.

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

#### Write the correct answer

Click the *Correct answer* tab and write the correct answer. It is not a number yet; it is a variable we named `sol`

. In order to write a variable anywhere outside CalcMe, we must precede the name of the variable with the pound sign `#`

. Since the variable does not have units, we'll include them here.

Recall the student will see the same MathType editor as we do in the *Correct answer* or *Preview* tab, so it is very important for either the *MathType embedded* or *MathType in popup* option to be selected.

#### units

Note`s`

and `l`

are in blue because they are understood as units (seconds and liters, respectively) and *Quantity*mode is selected. However, since they are preceded by

`#`

, they are understood as part of the variable's name.
Centimeters `c`

and `m`

are colored blue for the same reason. The space between the variable's name and `cm`

is important, otherwise, it would be understood as a variable called `solcm`

.

#### Preview the question and save the changes

It's always a good practice, even with simple questions, to test how they behave using the *Preview* tab. We can check that all the correct answers the student may provide are indeed correct. Moreover, we can see if the students forget to write the units, they will get zero points.

*Preview*tab: . This button appears because our algorithm deals with randomness. Every time we click this button, the algorithm will be re-executed and the random numbers will change.

Once you have finished testing the question, click `OK` so changes are saved and the Wiris Quizzes Studio window closes.

#### Assign full grade

Assign the full grade to the correct answer. Note the answer has units.

#### Write the statement

We have to write the statement of the problem. Recall we have stored the base length and height in two variables called `b`

and `h`

, respectively. Therefore, as for the correct answer, we have to write the name of the variables preceded by the pound symbol `#`

. Now we have to include the units in the statement since the variables are just numbers, not quantities.

Finally, save the question by clicking *Save and continue editing*.

#### Penalization to those who forget the units

Until now, this question behaves exactly the same as the previous one. Therefore, let us add the penalization to those students who forget to write the units.

Click *Blank for another choice*, so a new possible answer shows

Open Wiris Quizzes Studio in *Answer 2*:

Notice everything is the same as before except that now the *Correct answer* tab is empty. Provide as correct answer the variable `sol`

as before but now do not write the units.

Save the changes by clicking `OK`.

Assign the 50% of the score to the second answer, so the *Answers* field looks like

*Answer 1*, the student will get 100% of the score. If instead, the answer matches the criteria of

*Answer 2*, the student gets 50% of the score. If the answer matches neither the criteria for

*Answer 1*nor

*Answer 2*, the student gets no credit.

#### Save the changes and preview the question

Finally, save the changes

and preview the question.

A new window will show up with the question shown as the student will see it. Then we can test the behavior of the question again.

Every time we preview the question, the numbers that will appear will be different.

## Convert grams to number of moles and particles

#### Select the question type

First, we need to select which type of question we will use. There are several possible options, and once again the best one for this example is *Short answer*, because we expect the student to answer with just the result.

#### Write the statement

Now let's write the statement of the problem. We will ask the students to convert of ammonia, , to number of moles and particles.

#### Compute the correct answers

Open Wiris Quizzes Studio by clicking , then the *Variables* tab. What you see is CalcMe:

We will use two variables to store the solutions to the two questions.

#### Provide both correct answers

In this example actually, we are asking two questions: the number of moles and the number of particles. How do we do this?

Go to *Correct answer* tab and modify it so it looks like the image below. It is very important that *MathType in popup* is selected, so the students are able to write the correct answers properly. Recall that the student will see the same MathType editor as we do in the *Correct answer* or *Preview tab*.

#### Compound answer

Note we have selected*Compound answer*. This option allows us to ask for multiple answers in a single question, so that is very useful when both subquestions are related. Everything on the left-hand side of the equal sign will be part of the statement, and on the right-hand side a box will appear so the students are able to answer.

We have two choices regarding the grading: either the whole question is correct if all the subquestions are correct or the whole mark is the sum of the distributed grades for each subquestion. Here, for instance, we distribute the grade equally: 50% for the first one and 50% for the second one.

#### Preview the question

It is always a good practice, even with simple questions, to test how they behave using the Preview tab. We can make sure the whole grade is a combination of each subquestion's grade.

#### Change the tolerance

Until now, we were using the default tolerance setting: 0.1 percent error. In this question we want to count as correct an answer if it is correct to two correct decimal places.

Go to *Validation* tab and modify the tolerance field so it becomes *2 decimal places*, as in the animation below.

#### Save the question and assign full grade

Click `OK` so changes are saved and Wiris Quizzes Studio window closes.

Next, assign the full grade to the correct answer.

#### Preview the question

Save the question by clicking *Save changes and continue editing*.

Click *Preview*.

Note that if the student's answer does not have two correct decimal places, the question is not completely correct.

## Match the plot

#### Select the question type

First, we will select which type of question we will use. Until now, we have been using *Short answer*, but now we will choose *Multiple choice* since we want the student to choose the correct choice among all the possibilities that we will give.

#### Construct the plot

For instance, we will show the plot of and then students will have to choose from some possibilities. Let us then create the plot of . Open Wiris Quizzes Studio by clicking , then go to *Variables* tab and open CalcMe.

We directly write and click on *Plot*. Pay attention that the graph appears in the first plotter `plotter1`

.

That is all we have to do regarding the algorithm. Click the arrow on the upper left corner to go back to Wiris Quizzes Studio.

Click `OK` so changes are saved and Wiris Quizzes Studio window closes.

#### Create the possible answers

On the *Answers* section, create for instance three different choices , and and assign 100% of the grade to correct one.

It is possible to specify some feedback for each choice. Feedback is what appears once the student has answered the question. We can write *Congratulations!* for those who answer correctly and *Your answer is not correct, that is a parabola!* for those who fail.

#### Write the statement

Finally, let us write the statement of the problem. Recall that the graph of the function was plotted in the first plotter *plotter1*, so it will be our variable. Then we need to precede by `#`

the name of the variable, in this case `plotter1`

. The statement will look like

#### Label of the options and shuffling

We have almost finished, but small details are missing. We should specify that only one answer is correct, whether we want to shuffle the choices or not (so that the order in which the choices appear is different for each student), and which label is used for each choice.

#### Save and preview the question

We have finished with the creation of the question. Now, save the question by clicking *Save and continue editing*.

Click *Preview*.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.

## Roots of a polynomial

#### Select the question type

We'll select which type of question we will use. Most of the examples on this page use *Short answer*. Since we expect the student to answer this question with just the result, *Short answer* is the best of all the possible options for this one as well.

#### Write the statement

Now let's write the statement of the problem. We will ask the students to write a monic polynomial of degree two with roots 2 and -3.

#### Compute the correct answers

Open Wiris Quizzes Studio by clicking , then go to *Correct answer* tab and write the correct answer.

#### Store the student answer

Next, go to *Variables* tab and open CalcMe

The student's answer is stored in a parameter called `answer`

. Therefore, in order to work with it, we have to define this parameter. As we want to compare the correct answer and the student's answer, we have to plot both of them. The code to do so looks like:

The default value for the parameter answer is zero, that why the red plot is always zero. Don't worry; it will look nicer with the answer from the student.

#### Preview the question

It is always a good practice, even with simple questions, to test how they behave using the *Preview* tab. Once again, the order is not important. The plot will appear in the preview of the whole question.

If the student answers with the polynomial in expanded form, it will be graded as correct since it will be mathematically equal to the correct answer we have provided.

#### Save the question and assign full grade

Click `OK` so changes are saved and Wiris Quizzes Studio window closes.

Next, assign the full grade to the correct answer.

#### Add the feedback

*General feedback*field. Everything we write here will be shown to the students once they answer. Therefore, for instance, we can write here all the steps they have to carry out when solving a problem or to compare their answer with the correct one, as we will do here.

Recall the graph of the correct answer is blue and the one stored in the parameter answer (the student's answer) is red. The plot is stored in a variable called `plotter1`

, so we will include it on the feedback preceded with the pound symbol `#`

.

#### Preview the question

Save the question by clicking *Save and continue editing*.

Click *Preview*.

A new window will show up with the question shown as the student will see it. Then, we can test the behavior of the question again.