Chemistry Formula Image

Description

In the Chemistry Formula Image question type, students can input complex chemistry formulas on an image, using response boxes.

Figure 1 - Chemistry 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 chemistry 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. Image alternative text appears if an image cannot be displayed on a page, and the Text on hover is displayed when the cursor hovers over an image.

Figure 3 - Image Cloze Chemistry question basic parameters.

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

You can then position the response boxes on the image. In order to add more response boxes click on +Add above the image. Response boxes will pop up on the image. Drag response boxes and position them on the image as required. See example in Figure 4.

Figure 4 - Positioning response containers on the image.

Each response container 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. See below breakdown of attributes available:

  • Formula template - You can enter complex chemistry expressions and response boxes here. The Template is a LaTeX area. Chemistry expressions can be added with the LaTeX Keypad. You must enter {{response}} to indicate response boxes within a container. 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 a Response 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 scoring method and enter the correct response in the Value field. In this example, we have two response containers and the student response should be the same as that in the validation area for both containers. In this case, set validation for Equation Value 1 and select equivLiteral as a scoring method, then enter the correct response in the Value field. See example in Figure 5.

    Figure 5 - Validation settings for Image Cloze Chemistry question with two response containers.

  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 chemistry 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 correct but is also given in certain measurement units. In this case, add another method called isUnit. Click the +Add button below the first scoring method to add 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 - Chemistry Formula Image with multiple response boxes.

Source
{
    "instant_feedback": true,
    "image": {
        "src": "\/\/assets.learnosity.com\/organisations\/1\/h20.jpeg",
        "title": "Water molecule"
    },
    "is_math": true,
    "response_positions": [
        {
            "x": 41.03,
            "y": 17.84
        },
        {
            "x": 14.29,
            "y": 56.76
        },
        {
            "x": 72.53,
            "y": 50.27
        },
        {
            "x": 45.42,
            "y": 75.68
        }
    ],
    "stimulus": "<p>Label the water molecule with the correct elements and then enter the full chemical formula.<\/p>\n",
    "symbols": [
        "chemistry",
        "qwerty"
    ],
    "type": "imageclozechemistry",
    "ui_style": {
        "type": "block-keyboard"
    },
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivLiteral",
                        "value": "O",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false,
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "H",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "H",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "H_2O",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ]
            ]
        }
    }
}


Example 2 - Chemistry Formula Image question with multiple response boxes.

HintThe formula for Acetic Acid is C2H4O2


Source
{
    "instant_feedback": true,
    "image": {
        "src": "\/\/assets.learnosity.com\/organisations\/1\/aceticacid-final2.png"
    },
    "is_math": true,
    "response_positions": [
        {
            "x": 27.81,
            "y": 0
        },
        {
            "x": 60.31,
            "y": 3.25
        },
        {
            "x": 63.75,
            "y": 61.04
        },
        {
            "x": 82.5,
            "y": 60.39
        },
        {
            "x": 28.44,
            "y": 70.78
        }
    ],
    "stimulus": "Enter the missing molecules in this structural formula for Acetic Acid.",
    "symbols": [
        "chemistry",
        "qwerty"
    ],
    "type": "imageclozechemistry",
    "ui_style": {
        "type": "block-keyboard"
    },
    "validation": {
        "scoring_type": "partialMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivLiteral",
                        "value": "H",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "O",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "O",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "H",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "H",
                        "options": {
                            "ignoreOrder": false
                        }
                    }
                ]
            ]
        }
    }
}


Example 3 - Chemistry Formula Image question with extended response box size.

HintThe formula for Sulfuric Acid is H2SO4


Source
{
    "instant_feedback": true,
    "image": {
        "scale": false,
        "src": "\/\/assets.learnosity.com\/organisations\/1\/Sulfuric-acid_2015731121458.png",
        "title": "Sulfuric Acid molecule"
    },
    "is_math": true,
    "response_container": {
        "height": "40px",
        "template": "",
        "width": "100px"
    },
    "response_positions": [
        {
            "x": 48.73,
            "y": 13.88
        }
    ],
    "stimulus": "<strong>Enter the formula for Sulfuric Acid.<\/strong>",
    "symbols": [
        "chemistry",
        "qwerty"
    ],
    "type": "imageclozechemistry",
    "ui_style": {
        "type": "block-keyboard"
    },
    "validation": {
        "scoring_type": "exactMatch",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivLiteral",
                        "value": "H_2SO_4",
                        "options": {
                            "allowDecimal": false,
                            "inverseResult": false,
                            "ignoreOrder": false
                        }
                    }
                ]
            ]
        }
    }
}


Example 4 - Chemistry Formula Image question with two response boxes.

HintThe formula for caffeine is C8H10N4O2


Source
{
    "instant_feedback": true,
    "image": {
        "alt": "Caffeine Molecule",
        "scale": false,
        "src": "\/\/assets.learnosity.com\/organisations\/130\/caffeine_201621616915.jpg",
        "title": "Caffeine Molecule"
    },
    "is_math": true,
    "response_container": {
        "height": "40px",
        "template": "",
        "width": "50px"
    },
    "response_containers": [],
    "response_positions": [
        {
            "x": 40.33,
            "y": 85.15
        },
        {
            "x": 40.51,
            "y": -3.3
        }
    ],
    "stimulus": "<p>Enter the missing molecules in this structural formula for caffeine.<\/p>\n",
    "symbols": [
        "chemistry",
        "qwerty"
    ],
    "type": "imageclozechemistry",
    "ui_style": {
        "type": "block-keyboard"
    },
    "validation": {
        "scoring_type": "partialMatchV2",
        "valid_response": {
            "score": 1,
            "value": [
                [
                    {
                        "method": "equivLiteral",
                        "value": "CH_3",
                        "options": {
                            "ignoreOrder": false,
                            "inverseResult": false
                        }
                    }
                ],
                [
                    {
                        "method": "equivLiteral",
                        "value": "O",
                        "options": {
                            "ignoreOrder": false,
                            "inverseResult": false
                        }
                    }
                ]
            ]
        }
    }
}