Annotation

The following tutorial explains how to annotate your data in BikePed Portal, using our annotation tool.

Accessing the Annotation Tool

Suppose your organization is the Portland Bureau of Transportation, and you want to make an annotation regarding a sensor on the Tilikum Crossing Bridge:

Fig. 1. Click on "Annotations"
Fig. 2. Select your organization
Fig. 3. Select state
Fig. 4. Select segment area
Fig. 5. Select flow detector

This last selection will bring you to Review Mode.

Review Mode

Fig. 6. Review mode

When you adjust the time interval, data resolution will also be adjusted, as follows:

  • 1 day or 1 month time interval –> raw data (15 minute aggregates)
  • 1 year –> 1-day aggregates
  • All –> 1-month aggregates
Fig. 7. Smaller graph showing long-term data fluctuations

Adding an Annotation

To make a new annotation, click on the annotation icon:

Fig. 8. New annotation: step 1

Then follow the instructions in the right sidebar:

Fig. 9. New annotation: step 2
Fig. 10. New annotation: step 3

In the window, you can enter more detailed information. The current annotation categories are:

  • Construction near or at site
  • Data Correction (see Correction Factor)
  • Event (e.g. parade, race, festival, etc.)
  • Maintenance on hardware (battery replacement)
  • Maintence on hardware (other)
  • Malfunction
  • Outside forces affection device (e.g. insects, animals, vegetation interference)
  • Severe weather
Fig. 11. New annotation: step 4

Your annotation will now show up in the right sidebar.

Fig. 12. Actions to perform on an annotation

Viewing Multiple Annotations

Fig. 13. Click Zoom --> All to see all your annotations

Each color refers to a different category of annotation, providing a quick visual shorthand to assess which types of anomaly were the most prevalent during particular periods of time.

Fig. 14. Mouse over color strip for information about annotation
Fig. 15. Getting annotation list into right sidebar

Entering Bulk Annotations

You may want to enter an annotation for an event that applies to multiple detectors. For this, you will use Bulk Mode. Bulk Mode can be accessed by following the steps above in Accessing the Annotation Tool until you reach the step Select segment area of interest.

Fig. 16. Click the annotation icon to access bulk mode window
Fig. 17. Bulk mode annotation window

Note that the default bulk mode date/time setting will be the day you make the annotation, from 12:00 AM to 11:59 PM.