# Basic guide to question creation with Wiris Quizzes

#### Wiris Quizzes 3 documentation

This documentation page has been updated to the latest Wiris Quizzes version. You can find the same information for the previous versions 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 .

Here you can provide the correct answer to the question.

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Test this question* section. We can check that all the correct answers the student may provide are indeed correct.

Once you have finished testing the question, go back to the home page and click so changes are saved and Wiris Quizzes Studio window closes.

*Math editor embedded*or

*Math editor in popup*on the

*Input options*section.

#### 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 .

Here you can provide the correct answer to the question.

#### Configure the evaluation properties

Go to the *Validation options* section and select the *Simplified* option under *Simplification > General*:

#### Preview the question and save the changes

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

Once you have finished testing the question, go back to the home page and click so changes are saved and Wiris Quizzes Studio window closes.

*Math editor embedded*or

*Math editor in popup*on the

*Input options*section.

#### 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 *Define random variables and functions* section. As you can see, CalcMe is now the default option to generate the question's algorithm and, unless you are working with a previously created question, you can't use Wiris CAS (the old calculator) anymore. 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 `a`

, `b`

, `c`

, `d`

(the name of the variables is important, as we will see later on). Let us write the algorithm using the code editor (*Ctrl + Shift + B*).

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

Now the answer 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.

*Test the question*section, so it is very important for either the

*Math editor embedded*or

*Math editor in popup*option to be selected.

#### Make sure it all works

Finally, go to the *Test the question* section 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.

*Test this question*section: . 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.

#### Save the changes and assign full grade

Once you have finished testing the question, go back to the home page and click 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`

. Remember 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 .

#### Write 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 . We will provide, for instance, as the correct answer.

#### Enable units of measure

Go to the *Input options* section and check the units of measure and prefixes in which you are interested under *Input syntax*. In this case, you have to select, at least, `m`

(for the unit meters) and `c`

(for the prefix centi).

Note that now both `c`

(centi) and `m`

(meters) are colored blue because they are selected as explained above 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 *Test this question* section. 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.

#### 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.

#### Create random numbers

Second, we will write the algorithm. Go to *Define random variables and functions* section. 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

Now the answer is not a number, 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 `#`

. Therefore, we will write `#sol`

in the correct answer field.

#### Enable units of measure

Go to the *Input options* section and check the units of measure and prefixes in which you are interested under *Input syntax*. In this case, you have to select, at least, `m`

(for the unit meters) and `c`

(for the prefix centi).

#### Preview the question and save the changes

It is always a good practice, even with simple questions, to test how they behave using the *Test this question* section. 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.

#### 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.

#### Create random numbers

To write the algorithm, go to *Define random variables and functions* section. 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

Go back to the home page 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.

`cm`

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

.

#### Enable units of measure

Go to the *Input options* section and check the units of measure and prefixes in which you are interested under *Input syntax*. In this case, you have to select, at least, `m`

(for the unit meters) and `c`

(for the prefix centi).

Note that now both `c`

(centi) and `m`

(meters) are colored blue because they are selected as explained above so that they are understood as a metric prefix and a unit, respectively.

#### 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, go back to the home page and click 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* editor is empty. Provide as correct answer the variable `sol`

as before but now do not write the units.

Save the changes by clicking .

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.

#### Write the correct answers

Open Wiris Quizzes Studio by clicking , then the *Define random variables and functions* section. 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 the *Correct answer* section and write both subquestions in different lines.

Then, you need to select *Grade answer boxes separately* in the *Input options* section to not evaluate the whole content as a single value. 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.

#### 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.

#### Preview the question

It is always a good practice, even with simple questions, to test how they behave using the *Test this question* section. 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 options* section and modify the tolerance field so it becomes *2 decimal places*, as in the animation below.

#### Save the question and assign full grade

Click 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 *Define random variables and functions* section 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 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

#### New

From this moment on, it's possible to customize the size of your plotter graphs in the question's statement. Make your plotter more visible by using the following commands:- #yourplottername_desiredsize
- #yourplottername_desiredwidth_desiredheight

For example, if we want to display our plotter with a custom size of 800px per 600px, we need to use the syntax `#plotter1_800_600`

on the question statement.

#### 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 the *Correct answer* section and write the correct answer.

#### Store the student answer

Next, go to the *Random variables and functions* section 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 *Test this question* section. 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 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.