# Events

Events are [object types](../../object-link-types/object-types-overview/index.md) or [timeline geometries](#timeline-geometries) that include temporal information about a specific point or period of time; most commonly this means an event object has timestamp properties that mark the start and end of the time period. Event objects render as icons on the map canvas as well as within the timeline panel at the bottom of the screen as timeline geometries, both of which you can style to help users better understand objects' events in relation to time.

Review the table below to learn more about the distinctions between event objects and timeline geometries.

<table>
    <thead>
        <tr>
            <th>Feature behavior or configuration</th>
            <th>Event object</th>
            <th>Timeline geometry</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>Rendering configuration prerequisites</td>
            <td>Configured in Ontology Manager, event objects contain start and end timestamp properties.</td>
            <td>Configured in a map's <b>Layers</b> panel, timeline geometries require an object to have at least one timestamp property depending on the geometry's shape. Any object with at least one timestamp property can render on a map's timeline.</td>
        </tr>
        <tr>
            <td>Map canvas effects</td>
            <td>Used for opacity-based styling.</td>
            <td>No effects. Will only add layers to a map's timeline.</td>
        </tr>
        <tr>
            <td>Map timeline effects</td>
            <td>Foundry automatically displays event objects on a map's timeline.</td>
            <td>Foundry displays objects with timestamp properties as timeline geometries once configured in the map's <b>Layers</b> panel. Event objects will override default timeline styling.</td>
        </tr>
        <tr>
            <td>Timeline styling options</td>
            <td>No timeline styling options. Event objects contain a bar displaying the object's color.</td>
            <td>Multiple timeline styling options available, such as those for shape and custom coloring.</td>
        </tr>
        <tr>
            <td>Display behavior with multiple timeline layers</td>
            <td>Event objects only show the event time periods configured in Ontology Manager.</td>
            <td>You can configure multiple timeline geometry layers in the <b>Layers</b> panel of your map based on the timestamp properties on your object.</td>
        </tr>
    </tbody>
</table>

[Learn more about configuring events in the Ontology.](../integrate-objects/index.md#event-objects)

## Event objects

Event objects are [object types](../../object-link-types/object-types-overview/index.md) that include temporal information about a specific point or period of time. Most commonly this means an event object has timestamp properties that mark the start and end of the time period. [Learn more about configuring events in the Ontology.](../integrate-objects/index.md#event-objects)

Once you [add event objects to your map as a layer](../add-to-map/index.md), you can apply custom styles, explore their linked events, and view event time periods in the [timeline](../timeline/index.md).

![Timeline geometry example where a user can see the time properties of the event object 'Earthquakes' on the timeline, noting there is no additional timeline geometry.](../../../assets/ba9479a63998427866488bad37e37ddab60f526c8f6d424d143630437effc3f0.webp)

Event objects automatically populate an event layer in the timeline and can be styled by adding a timeline geometry with the same start and end time as the event object's start and end time. There are additional display options available in the **Style** section of the left panel:

* **Shape:** Uses a start and end time property to draw a bar by default. An object type's start and end time are configured in [Ontology Manager's **Capabilities** tab.](../integrate-objects/index.md#event-objects)
* **Color:** Select **Color** to shade your event object's icons using a **Fixed color**, **Function**, **Property**, or **Linked sensor**.

If you add a timeline geometry in the **Layers** panel, it will override this event layer's appearance in the timeline. However, the event's start and end time can still be used for opacity-based styling on the map.

### Use event objects for styling

You can style event objects on your map so they are only visible when the current [time selection](../time-overview/index.md#selected-time-and-time-range) overlaps with the time period of the event. Use this to make your map responsive over time and show only the event objects that are currently relevant. [Learn more about using event objects for styling.](../visualize-objects/index.md#opacity-styling)

<video class="archive-animation" src="../../../assets/31e33b02c295a991749b4bb88d99573634ad2aac9b0802b5353d379c56d78ea4.mp4" controls="" muted="" playsinline="" preload="none" data-archive-animation="" aria-label="Styling events by time." poster="../../../assets/3e52c18162d174ea824eb8b659b9020e0c8575e18c0337f1a1cf6fb721b31293.webp" data-archive-loop-count="65535" width="1400" height="664"></video>

### Linked events

A linked event is an event object linked to another object. On the map, you can view those linked events by selecting the object and opening the **Events** tab. If the currently selected time lies between the start and end times of an event, the event will appear in the **Active events** section. Otherwise, the event is considered inactive and can be shown by using the **Show inactive events** option.

![The Events tab is displayed.](../../../assets/7477dd9f38822ccd367ac2eeed72fe7e944adbb939f584edb1abf809c99f12d6.webp)

When the linked events are of a [geospatial object type](../integrate-objects/index.md) click **+** to add them to your map:

![Add to map button.](../../../assets/fc0560de2908eea1f420061d39776a9a98f44c7e4d5996ce4c89c195e7bf1a1b.webp)

Each event has corresponding actions you may take:

* Set the selected time window to match the time endpoints of the event with the ![Magnifying glass icon.](../../../assets/32779ee3db12d0b70963741e29c5fecec93c8d14df51668620b4c176d2335eca.webp) icon.
* Open the event in Object Explorer with the ![Open in button.](../../../assets/7e228aca5b24df425876a11df9c8136f2aea8e42e2c595fd4db38ed223d04437.webp) icon.

#### Show on series panel \[Planned deprecation]

Right-click on an object and select **Open linked events** to open and add linked events to the [series panel](../series-panel/index.md). Analyze your time series data in the context of important periods of time, and adjust the time selection so the map reflects a time of interest.

![Add events to series panel.](../../../assets/b150fdd37462ea6448a7511ca041a43c4cfa3900335b869d3fba745e6411215a.webp)

#### Show counts in labels

If you enable labels for a layer, a count of active events also displays in the label for each object. Hover over the active event count to view the active events:

![View events from label.](../../../assets/5091115de52b5628edfd1e5b82e39ca6c0871479d3e576ee1dd77c24d19f6006.webp)

## Timeline geometries

Defined by an event object's paired timestamp properties, timeline geometries render as event layers in a map's timeline and can be styled by an object property. Timeline geometries offer additional custom style options when compared to event objects rendered as a map layer.

[Learn more about adding and configuring timeline geometries on your map.](../visualize-timeline/index.md)