This quick start guide shows you how to create a demo project with simulated data and explore Sora’s key features. This includes logging into Sora, creating a project, adding a layer, creating an annotator, and generating events. Additionally, you’ll learn how to use the event log and navigate through data in space and time. 

To connect Sora to a GNSS receiver, refer to the Sora Features article.


  1. Log into Sora
  2. Create a Project
  3. Add a Layer
  4. Create an Annotator
  5. Create an Event Generator
  6. Use the Event Log
  7. Navigate through Data in Space and Time

Log into Sora


To get started with Sora, create a Swift account at if you do not already have one.

Log into Sora using your Swift account at


Create a Project


Follow the steps below to create a new Sora project.

  1. Click the New Project button to create a new project.

    The New Project dialog box opens.

  2. Configure a bus demo project with a name and optional description by filling in the text fields as indicated in the figure below.

  3. Once you have filled out the fields as indicated above, click Create to create the project.

    The New Project dialog box closes and the main page reactivates.

    All projects including this newly-created one appear on the main page.

  4. Click the project.

    Clicking the project opens the Sora dashboard for the project. The Devices tab is selected by default.


Add a Layer


Follow the steps below to add a new layer to your project.

1. Download the Oakland city boundary map example

2. Click the Layers icon to activate the Layers tab, in order to add a map layer.

3. Click the + Add Layer button.

4. Upload the Oakland city boundary file to Sora to add it as a new layer.


Create an Annotator


Follow the steps below to create a an annotator for the project.

  1. Click the Annotations icon to activate the Annotator tab.

  2. Click the + Add Annotator button to create a new annotator.

    The Annotator Builder dialog box opens as shown in the figure below.

  3. Configure a geofence annotator by selecting the Oakland layer from the Layer drop-down list.

    The annotator display name and key name auto-populate.

  4. Click Create to confirm the configuration.

    The Annotator Builder dialog box closes and the main window reactivates.

  5. Hover your mouse over a bus to view the annotation and the device state in the tooltip.

    The annotator performs the geofence evaluation on each incoming device location and appends the in_Oakland Annotation Key, along with a true/false value to each device state. 


Create an Event Generator


Events enable the identification of specific conditions of interest and can be configured with specific triggers. 

Follow the steps below to create an Event Generator.

  1. Click the Events icon to activate the Events tab in the main page.

  2. Click the + Add Event Generator button on the Events tab to create a new event generator.

    The Event Generator Builder dialog box opens as shown in the figure below. In this Event Generation example, we will generate events when devices enter the Oakland city boundary, using the layer you created earlier. Note that the gif figure below depicts the rest of the steps in this procedure for your reference.

  3. Click the + Add Rule button.

  4. Select in_Oakland in the field drop-down list.

  5. Toggle the configurator from No to Yes to alter the ruleset.

  6. Click the + Add Rule button.

  7. Select in_Oakland again to add a second component to the ruleset.

  8. Modify the == rule by clicking on the drop-down list and select has changed.

  9. Confirm the Event Generator Name, or update it if you prefer something more specific than the autogenerated name.

  10. Click Create Event Generator to create the new Event Generator.

    This newly-created Event Generator now generates events when a device is inside the Oakland boundary and the in_Oakland data type changes from its previous state.
    Events are viewable on the map with a colored pin. Hover over an event to view the data associated with it.

Use the Event Log


The event log contains a list of events for the project, and enables you to jump to an event in space and time. Follow the steps below to use the Event Log.

  1. Click the Events icon to open the Events tab in the main page.

  2. Click View Log on the Events tab to display the event log.
  3. Click the Compass icon on the left of an event to move the map to the place and time of that event.



Sora includes a date picker and timeline to navigate through your data in time.

Click the Calendar icon on the left end of the timeline.

The date picker opens. The calendar days are color-coded by the quantity of data per day.
The timeline shows a histogram of data volume for the selected time. The ends of the timeline can be changed to narrow down the dashboard view to a specific time range.

Related Articles