Programming Project #1 - Step 2


Step 2: Label the user study data.

Before you can use the data, you must label it so that you can test the accuracy of your recognizer. (NOTE: This part of the project can be done on any computer. You do not need to go to the computer lab or use a pen-based computer.)
  1. Download your assigned data subset below, and then extract it on your computer. After you extract the file, locate the file with your name on it and extract that. That directory will be your assigned data files to label.

  2. Download the labeler file and run the file. When you first run the file, it will download the labeler (100 MB). For people with slower internet connections, it might take a few minutes.

  3. After the labeler is running, you will see a graphical user interface (GUI) window appear. This is where you will begin labeling the data. For each of the data files, you will click the Load button to load the data file into the application.

  4. Now to label the data. There are two ways to select the strokes. (Note: If you made a mistake in labeling the stroke(s), be sure to un-label first and then label it correctly.)

    • Click and drag: lasso select, a stroke has to be totally contained in the lasso (imagine a closed polygon by connecting the end to the start).

    • Click on a stroke: toggle that stroke's selection.
      • If you miss, no problem.
      • If you miss twice in a row, the selection is cleared (i.e., double-click on empty space to clear the selection).
      • If you want to mix the 2, do lasso select first, because it creates a set based on the lasso; it doesn't add to the current set.
      • Clicking on a stroke toggles that stroke (so add if it's not in, remove if it is).

  5. Once the selected strokes are displayed in bright red.

    • Any other strokes that are also part of a shape including some of the selected strokes are shown with thicker lines.
    • If you select part of a truss, it's easy to see that you haven't selected all of it.

  6. Once you're happy with your selection, right click (pen button + click). Pick a label and then it's labeled.

    • The "unlabeled" option can be used to remove a group. For example, if you select 75% of a truss and click "unlabeled", nothing will happen. You have to select the whole shape to remove it.
    • Similarly, if you select a whole truss and 1 stroke from a force and click "unlabeled", nothing will happen.
    • If you select 2 strokes and label them, then decide that a 3rd stroke should be part of the shape, no problem. Just select the 2 strokes you labeled and the 3rd stroke and select the same label. (more generally, if a subset of the selected strokes come from one shape and the same label is selected, the other strokes are added to that shape).
    • If you select all the strokes from a shape (X) and some extras, and then select a label different from X's, it will create a new shape containing all the extras and X. X won't be broken up, it will be a hierarchically contained shape.

  7. About labeling the non-trusses:

    • To label an axis, students should first label the x, then the y, then each of the arrows individually, then the whole axis. (the specific order of the first 3 doesn't matter).
    • The supports should just be one shape, don't separate the triangle from the lines, etc.
    • The fixed and pinned rotate only support is the triangle over lines, the roller support is the circle over the horizontal line over the slanted lines.
    • They have to make sure to save. The application isn't very smart: it will save over a file without prompting, it won't ask you if you want to save before it loads a new file, etc.

  8. After you finish labeling a data file, save it and move on to the next data file to label. If you encounter a data file that is bad (e.g., blank or garbage sketches), then rename that file by adding the word " (bad)" at the end of the file.

  9. After you you finish labeling your subset of data files, e-mail Paul those files.