Labeling

The Labeling Module is used to create questions in which maps, diagrams, or other images are labeled.

Getting Started

  1. To insert the Labeling Module in to the Question Text section, click the labeling button in the Question Type Palette. The symbol on this button is two circles.

  1. Once inserted into the Question text section, the module will always appear as a map with labels, as exemplified in the screenshot below:

  1. To open the Labeling Module editor, double click on the module.

The Labeling Module Editor consists of three tabs: Question tab, in which authors set up the question; the Answer tab, in which authors set the question’s answer; and the Feedback tab, in which authors can write feedback for the student depending on how the student labels the image.

The Labeling Module Editor also has a Save button, which you can use to save your work and exit the module, and a Cancel button, which will allow you to exit the module without saving.

Please note that the system will not allow you to save the module unless an answer has been programmed into the Answer tab. Also, once you hit the Save button, the module will close.

Setting Up the Question

To set up the question, do the following:

  1. Add to the module the image file that will be labeled by clicking the Image icon, which is located at the bottom left of the Image section.

  1. Clicking this will open up the Image Upload Window, pictured below, which allows you to access all of the images uploaded to the image folder associated with your account:

  1. Select the image you want to use in the Items List. 

i. Upload the image you would like to include in the Item list by clicking on the “Choose File” button at the top of the window. Once you select the image from your computer, click on the “Upload” button in the top right corner to upload it to your SW5 folder.

ii. Select a previously uploaded image from your folder by clicking on the appropriate thumbnail.

iii. You can rename or delete images that are uploaded to your folder using the “Rename” and “Delete” buttons at the top right corner of the window.

iv. You can only access images that are uploaded to the folder associated with your account. You cannot access images that are uploaded by another user.

  1. Double click on the image you would like to insert into the Item List. This will close the Image Upload Window and will take you back to the Question tab. Your image will be in the image section of the Question tab.

  1. Create your labels. Click on the editable text field directly to the left of the lettered targets. When you do this, a Text Formatting Palette will appear above the label you want to edit.

  1. From left to right, the Text Formatting Palette allows you to do the following:

i.Insert images

ii.Bold text

iii.Italicize text

iv.Underline Text

v.Insert a subscript

vi.Insert a superscript

vii.Insert an algorithm

viii.Insert an equation

ix.Insert special characters

x.Remove formatting

  1. Add labels by clicking the + button.
  1. Subtract labels by clicking on the minus button next to the label you want to delete.

  1. Add targets to the image by dragging the circle next to “Add Targets” directly to the image. Repeat until you inserted all the targets you need.

  1. Note that the target will be placed wherever the arrow is pointing on the image; it will not be placed where the dragged target appears to be.’
  1. You may add more or less targets than labels. Both targets and labels can be created as “distractors.”
  1. Edit a target’s placement and placement by clicking and dragging it to the desired location.
  1. Remove all targets by clicking on the Undo button (button with an open circle with an arrow), located next to the Image Upload button.
  1. Currently, you cannot remove individual targets.

Defining the Answer

When all targets are placed, you can build the correct answer in the Answer tab. Do this by dragging the letter corresponding to the label onto the desired target.

 

Things to keep in mind when setting the correct answer:

  1. As labels are placed onto the image, they will be greyed out. This ultimately means that a user can only use a label once when labeling an image.
  1. Targets cannot accommodate more than one label.  
  1. To remove all labels from the image, use the Undo Button.
  1. To swap out individual labels in the event of a mistake, a user must drag the desired label to the desired target. Any label that is already on that target will then return to the label column on the right, and can be placed on another target.
  1. Once the Answer tab is set, you can then successfully save the module. Saving the module will close the editor.

Creating Feedback

Smartwork5 determines whether a student’s answer is correct or not by recognizing the pattern you specify in the Answer tab. If a student matches the pattern in the Answer tab, the system recognizes the answer as correct. If the student fails to match that pattern, the system recognizes the answer as incorrect.

The Feedback section allows you to write Feedback that the student sees when she triggers these correct and incorrect patterns.

Text Editor

Each Feedback tab contains a text editor, which allows you to add text and other multimedia to the feedback.

Important Note: Copying and pasting text from a Word Document into Smartwork5 could insert formatting that will corrupt the module. Please enter the text directly into the Text Editor, or copy and paste from a plain text document. 

The Media Palette allows you to insert multimedia into the Feedback tab.

From left to right, the Media Palette allows you to do the following:

  • Insert chemical equations
  • Insert symbolic (math) equations
  • Insert algorithmic variables
  • Insert image files
  • Insert music files
  • Insert video files
  • Insert hyperlinks
  • Remove the hyperlinks

The Text Formatting Palette allows you to format the text in answers, as well as add special characters.

 

From left to right, the Text Formatting Palette allows you to do the following:

  • Bold text
  • Italicize text
  • Underline text
  • Insert subscripts
  • Insert superscripts
  • Insert math formulas *This button is being phased out. To insert math equations, use the symbolic equation editor.
  • Insert special characters
  • Remove any formatting applied to the text

Furthermore, the Feedback Formatting Palette allows you to do the following:

  • Insert tables
  • Insert line breaks
  • Edit text in full screen mode

Correct and Default Feedback

The Feedback tab will initially have a tab for Correct feedback, which a student sees whenever she matches the pattern in the Answer tab. It will also have a tab for Default feedback, which a student will see whenever she creates an unspecific pattern that does not correspond to what is in the Answer tab. Default feedback will trap for all incorrect answers unless otherwise specified in a Specific feedback tab, which will be discussed in the next sections.

To set Correct feedback, do the following:

  1. Type up what you want the student to see when she correctly matches all the labels to their proper targets. Add any multimedia you see fit using the palettes in the text editor.

  1. Save the question.
  1. Go to preview mode in the Question Editor. Check that the Feedback is working correctly by recreating the correct answer in the preview window.

You should see the feedback you wrote in the correct feedback tab:

To set Default feedback, do the following:

  1. Type up what you want the student to see when she places the labels on the incorrect targets.

  1. Save the question.
  1. Go to preview mode in the Question Editor. Check that the Feedback is working correctly by recreating a pattern that is NOT correct in the preview window.

You should see the Feedback you created in the Default Feedback tab:

Creating Specific Incorrect Feedback

You can create feedback for specific incorrect answers by using the Specific Incorrect Feedback tabs.

When creating specific incorrect patterns, you can either use all of the labels and targets, or only use some of the labels and targets. Feedback that only uses some of the items/targets can trigger Cascading Feedback, which will be discussed in the next section.

To set specific incorrect feedback using all of targets/labels, do the following:

  1. Click on the tab with the plus sign to add a Specific Incorrect feedback tab.

 

  1. Create the specific incorrect pattern by placing all of the labels on all of the targets.
  1. Type up what you want the student to see when she triggers this specific incorrect pattern.

  1. Save the question.
  1. Go to preview mode in the Question Editor. Check that the Feedback is working correctly by recreating the specific incorrect pattern in the preview window.

You should see the Feedback you created in the Specific Incorrect Feedback tab:

Cascading Incorrect Feedback

Winking

In addition to creating incorrect feedback for patterns that use all of the targets and labels, users can create incorrect feedback for patterns that only use some of the labels and targets.  

Unlike the Answer tab, each target in the Specific Feedback tab has little eyes. These indicate whether or not the system should ignore what a student places on the target. This is called Winking.

To tell the system to ignore what a student places on a target, authors should click on the eye so that a slash goes through the eye icon. This tells the system to focus entirely on targets that are not winked.

In the example below, the author wants the system to focus on the fact that Scotland and Northern Ireland are switched. In order to do this, the user must “wink” out the targets for Wales and England. 

 

Winking out these targets means it does not matter whether a student places England and Wales on their correct targets, or if she switches England and Wales. As long as Scotland and Northern Ireland are switched, she will see the incorrect feedback.

A few things to keep in mind about Winking:

  1. If a target is not winked and the author does not place a label on the target, the system will recognize that target as blank. This means a student must leave the target blank in order to trigger that particular feedback.
  1. When creating specific incorrect feedback, labels cannot be placed on targets that have been winked out.
  1. In addition to removing all labels on the screen, the Revert button will “unwink” all targets. In doing this, the Revert button occasionally “whites out” the eyes that are on the targets; however, the eyes return once the author clicks on the targets.

Cascading Feedback

Because Winking allows the system to recognize incorrect patterns that use fewer than all of the targets/labels, the system allows authors to layer feedback if the student triggers multiple incorrect patterns. This is called Cascading Feedback.

The goal of Cascading Feedback is to minimize the number of attempts a student must make in order to arrive at the correct answer.

Cascading Feedback cannot be turned off.

To create Cascading Feedback, do the following:

  1. On a Specific Feedback tab, create a pattern using one or more targets/labels. For simplicity’s sake, this example will only use two targets and labels. Be sure to wink out the targets that are not being used in this pattern.

  1. After saving the module, go to preview mode in the Question Mode. Make sure that your feedback is working correctly by recreating the incorrect pattern in the preview window.

  1. Go back to the Module Editor and create another incorrect pattern with feedback. Be sure to wink out all of the targets you want the system to ignore.

  1. After saving the module, go to preview in the Question Mode. Make sure that the feedback is working correctly by recreating the incorrect pattern in the preview window.

  1. Refresh the preview mode and recreate the two patterns you just created at once. The system will display both sets of feedback.