Overview

You can use the Event Timeline widget to show timestamped associations between entities over time, including the start/end times of long running associations.  This is useful for seeing the temporal analysis, as the event graph does not include time as a dimension.

About the Event Timeline

When associations are displayed on a timeline they are the same as those within the documents, except that scoring is different:

• Entity significance is not included.

• The association significance ("assoc_sig") is simply the Pythagorean significance of all documents in which the association is included.

• Where times are not included intrinsically in the association, they are filled in to span the time range of the documents including them.

The Event Timeline widget can display the following types of associations: Events, Facts, and Summaries.

"Events" and "Summaries" with the same time range (ie "time_start", "time_end" pair) are aggregated with the "doccount" used to store the sum.

For "Facts", the "time_start" and "time_end" are set to the newest and oldest dates in which the "Fact" occurs (ie. this may give some useful time range over which it is being discussed), with "doccount" counting all instances of the "Fact" within that time range.

Using the Widget

Viewing Event Data on the Timeline

You can expand each individual event on the timeline to view more detailed information.

To view event data

• From the Event Timeline widget, click on the plus sign of a particular event.  

Additional information is displayed, including Start date, End Date, Significance, Doc. Count etc.

Viewing Entity Links

You can view detailed information about the entities involved in an event.

To view entity links

1. From the event timeline, click on the plus sign.
2. Under Entity Links, click on one of the links.

The Entity links page loads, displaying related entities, activities, documents, and any important relationships.

Setting Time Decay Date

You can set the time decay date to be the central date in the visible time range.  For more information about Time decay date, see section Advanced Options.

To set the time decay date

1. From the widget panel click on the Set Time Decay Date button .
2. You are redirected to the Advanced Options screen, where the central date from the widget's visible time range is auto-populated for you.
3. Click on Save from "Advanced Settings," and this will save the setting and return you to the widget.  The widget is filtered accordingly.

For more information about Time decay date, see section Advanced Options.

Adding the Visible Time Range to Query

You can add the visible time range in the event timeline to filter the results of your query.

To add the visible time range

1. From the widget panel, click on the Add to Query button. 
2. You are redirected to the advanced query builder and the time range is added to the query string.