-
Notifications
You must be signed in to change notification settings - Fork 0
Home
This Mod for Spotfire® can be used to display a list of events in chronological order. The main purpose is to communicate time-related information, over time, either for analysis or to visually present a story or view of history.
- From this repository Releases section, locate and download the .mod file.
- Drag the .mod file into an analysis in Spotfire® Analyst.
For information on how to use and share visualizations mods, read the Spotfire® documentation.
- From this repository Releases section, locate and download the source code.
- Build the project in your preferred code editor. Microsoft Visual Studio Code is highly recommended.
- Open an analysis in Spotfire® and select Tools > Development > Create visualization mod from the menubar to connect to the project.
For information on how to get started with visualization mod development, read the Spotfire® documentation.
Every mod handles missing, corrupted and/or inconsistent data in different ways. It is advised to always review how the data is visualized.
The timeline can be used to visualize any dataset that contains dates and descriptions. In order to make it work properly a data table with at least two columns is required:
- One date hierarchy. A column with actual dates works best, but any combination of categorical columns are supported. This determines the timeline.
- One description column. This determines what is written in the cards.
Optionally a third categorical column could be used to color the cards.
Let's say we have data about some world events:
| Date | Event | Impact |
|---|---|---|
| 02/11/2022 | Something happened | Medium |
| 02/14/2022 | Something else happened | Low |
| 03/08/2022 | Something worse happened | Low |
A basic timeline can be configured to show these events over time by creating a Timeline with the following settings:
- Time = Date: Year.Month.Day
- Event = Event
Optionally you could also color the cards by another color, E.g.
- Color By = Impact
The time segments will be determined by the hierarchy on the time axis.
In the Spotfire Desktop the timeline will default to show the filtered range, meaning that it will include days regardless of whether or not there is an event for that day. This behavior can be changed in the time axis settings.
In the Spotfire Web Client the timeline will show all filtered values, meaning that it will skip days for which there is no event.
The number of cards will be determined by the expression on the event axis and the color axis if categorical color is used.
The visualization will respond to changes in the Spotfire canvas style. Label fonts, sizes and the color of lines are determined by visualization canvas settings. The size of cards and time segments will adjust to the selected font size.
Clicking on an event will mark that event in the timeline and in all other visualizations that uses the same marking. Clicking or dragging in the empty space between events will clear the marking. You can mark several events by Ctrl-clicking on them.
Clicking and dragging allow you to select multiple events.
Clicking on a time segment will mark all events within that time segment. E.g. If your timeline shows Year > Month > Day, you can mark all events within a year by clicking on the year segment or for a particular month by clicking on month segments. You can mark several time segments by Ctrl-clicking on them.
If the timeline is configured to use a date hierarchy you can decide what level of the hierarchy to show by dragging the hierarchy slider.
If the timeline is wider than the visualization area a scrollbar will be displayed at the bottom of the visualization.
The visualization will scroll right automatically if you double click on it while holding down ctrl on Windows and the command key on Mac. Clicking anywhere will stop the automatic scrolling.
Copyright (c) 2023 Cloud Software Group, Inc. All Rights Reserved.