Math Formula Image

Description

The Math Formula question allows students to easily enter complex math formula as a response on an image, with advanced validation capabilities using math specific scoring methods. Click here to see some worked examples of our Math Formula Question.

Figure 1. Math Formula Image question example.



Create a Question


Enter the question stem into the Compose question area. You may want to use our Math Editor in order to insert a mathematical expression in the stimulus. For this click inside the Compose Question text area and select Math Editor from the Rich Text Editor panel (see Figure 2).

Figure 2 - Rich Text Editor panel with Math Editor button.

Then upload the image to be used for the question in the Add image field. You can either upload the image or paste image URL. For information about image requirements visit our Images page. The Image alternative text appears if an image cannot be displayed on a page, and the Text on hover is displayed over the image, when the cursor hovers over it.

Figure 3 - Image Cloze Math question basic parameters.

The uploaded image preview will be shown below in the Response Positions section.

Drag and position the response boxes on the image as desired. To add more response boxes click on +Add above the image. See example in Figure 4.

Figure 4 - Positioning response containers on the image.

Each response box added on the image will have a number label. You can add multiple response boxes within one container and define specific dimensions for each container individually. For this you will need to configure the Edit individual response containers section. This can be found below the uploaded image. Below is a breakdown of the attributes available:

  • Template - You can enter complex math equations and response boxes here. The Template is a LaTeX area. Math expressions can be added using the LaTeX Keypad. You can add multiple response boxes here.
  • Width and Height - You can enter container width and height in pixels, i.e. 60px and 30px, in order to change standard dimensions.

Follow these steps in order to configure validation:

  1. Insert a value in the Point(s) box to define a mark for the question. The default value is set to 1.
  2. In the Correct tab below you will see Equation Values submenu. There will be as many submenus as you have response containers on the image. Each submenu will be named Response 1, Response 2 etc. depending on the number of response containers. Here you set validation separately for each container.
  3. Under each submenu select a scoring method, and enter the correct response in the Value field. In this example we only have one response container and the students response should be exactly the same as in the validation area. In this case, validation is only set for Equation Value 1 and select equivLiteral as a scoring method. Then enter the correct response in the Value field. Remember that everything that has been entered into the Template area must be entered into the Value area.

    Figure 5 - Validation settings for Image Cloze Math question with one response container.

  4. Each scoring method has additional options that allows authors to set more precise validation conditions. A breakdown of all options associated with certain scoring methods can also be found in our Formula tutorials. When you select a scoring method all extra options will be displayed below the menu.
  5. Some more complex math questions will need a second scoring method applied. You can combine several scoring methods to set more strict validation rules. For instance, you may want the system to accept a response that is not only symbolically equivalent but also is presented in factorised form. In this case, you would need to add another method called isFactorised. Click on the +Add button to create a new scoring method.

More Options

Additional formatting options can be found under More Options:

Scoring

Unscored/Practice usage - Removes all scoring from the question.

Penalty point(s) - The value entered here will be deducted from the student for an incorrect answer.

Minimum score if attempted - Set attempt marks for the question.

Check answer button - Show or hide the Check answer button from the student.

Check answer attempts - The value entered here refers to how many times the student can use the Check answer button, before it is disabled.


Layout

Transparent background - If this is enabled, the background of the response area will match the colour of the rest of the background area.

Response minimum width (px) - Enter, in pixels, the minimum width of the response area.

Template font scale - Scales the font relative to the question's font size. The default value is 150%.

Response container (global) and Edit invidiual response containers - Configure the Width and the Height, in pixels, for either all response containers, or for specified response containers.


Keypad

Type - Select from a Floating keypad, a Block keypad, a Block on focus keypad, or no keypad.

Show keypad hints - Enable or disable hints on the keypad, such as keyboard shortcuts and symbol group titles that are shown on the top left corner of the keypad when hovering over a symbol group key.

Number pad - Customise the number pad in this section.

Symbols - Select what symbol groups will be shown to the student, or create custom symbol groups.


Text blocks

Use this option when you want to define a list of custom units (such as g, kg, cm, oz, etc.) that will not be rendered as LaTeX.

Example 1 - Math Formula Image question with 1 response box.

Hint Try inserting √29.


Source
{
    "image": {
        "src": "\/\/assets.learnosity.com\/organisations\/1\/rightangledtriangle.png"
    },
    "instant_feedback": true,
    "is_math": true,
    "response_positions": [
        {
            "x": 55.47,
            "y": 24.11
        }
    ],
    "stimulus": "<p>Find the hypotenuse of this triangle&nbsp;using the formula&nbsp;\\(a^2+b^2=c^2\\)<\/p>\n\n<p>&nbsp;<\/p>\n",
    "type": "imageclozeformula",
    "ui_style": {
        "type": "block-keyboard"
    },
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivSymbolic",
                        "value": "\\sqrt{29}",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false
                        }
                    }
                ]
            ]
        }
    }
}


Example 2 - Math Formula Image question with 2 response boxes.

Hint "21" and "39" are good answers.


Source
{
    "instant_feedback": true,
    "image": {
        "src": "\/\/assets.learnosity.com\/organisations\/1\/Screen Shot 2014-09-04 at 13.21.41_201494132948.png"
    },
    "is_math": true,
    "response_container": {
        "template": ""
    },
    "response_positions": [
        {
            "x": 46.09,
            "y": 35.14
        },
        {
            "x": 84.37,
            "y": 35.14
        }
    ],
    "stimulus": "<p>What unknown number complete the pattern on the number line?<br \/>\nEnter one answer in each response box.<\/p>\n",
    "text_blocks": [],
    "type": "imageclozeformula",
    "ui_style": {
        "response_font_scale": "normal",
        "type": "block-on-focus-keyboard"
    },
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivLiteral",
                        "value": "21",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false,
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivSymbolic",
                        "value": "39",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false
                        }
                    }
                ]
            ]
        }
    }
}


Example 3 - Math Formula Image with 1 response box.

Hint The perimeter is the length of the outline of a shape.


Source
{
    "instant_feedback": true,
    "image": {
        "src": "\/\/assets.learnosity.com\/organisations\/1\/trapecio_2015730124110.png"
    },
    "is_math": true,
    "response_containers": [
        {
            "template": "{{response}}",
            "width": "60px",
            "height": "40px"
        }
    ],
    "response_positions": [
        {
            "x": 31.28,
            "y": 75.17
        }
    ],
    "stimulus": "<h4>Find the perimeter of the trapezoid.<\/h4>\n",
    "type": "imageclozeformula",
    "ui_style": {
        "type": "block-on-focus-keyboard"
    },
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivSymbolic",
                        "value": "28",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false,
                            "ignoreOrder": false
                        }
                    }
                ]
            ]
        }
    }
}