[Time Conductor] Time of Interest implementation

[charlesh88]

Issue to cover implementing the first version of the Time of Interest element (TOI) in the Time Conductor and views.

• Extends work done in [Time Conductor] Initial realtime/historical reconciliation #933.
• UI is here, starting on page 53.

Master task list

• TOI will visually manifest in plots and historic tables.
• TOI in real-time will allow manipulation of the offset position of "now". See UI, page 58.
• Date-sorted tables will scroll to bring the TOI into view at the time it is set.
• Tables not sorted by date will not display the TOI or support TOI scrolling.
• Panning the TC such that the TOI goes "out of view" to either side of the TC bounds will reset and disable the TOI, taking it "out of play". Views will all update accordingly.
• Changing the TC bounds via datetime inputs will reset the TOI and take it out of play.
• Views should support proportional placement of the TOI. For example, setting the TOI near the right edge of the TC (say about 10% of the total width of the TC time area) would also place the TOI in synced plots at the same proportion in the available view: near the right edge. Plots should not pan or zoom due to a TOI manipulation.
• Date-sorted tables would scroll in such a way as to approximate this as well.
• Setting the TOI does not cause unsynced elements to re-sync with the TC.
  • If the TOI would be in view with the unsynced element, then it should be displayed.
  • Re-syncing the element would cause the TOI to appear as expected in that element.
• Allow user to drag (or right-click at a position) to set the TOI element in views, such as plots and tables.
• Position TOI in new plots
• Pan TOI into view in plots
• Alt-click to set TOI in new plots
• Fix positioning issues in time conductor when using % left
• Fix label-to-left issues (may defer)
• Default sort order in tables
• Document code
• Fix code style issues
• Problems in tables with bounds changes. Does not display current TOI when TC is panned, zoomed, etc.
• Tests

Future

• Make TOI draggable. See [Time Conductor] Time of Interest implementation #1193 (comment)

Older notes

Notes from discussion with Andrew, 9/15/16

Initial version

• TOI element is only draggable in the Time Conductor (TC). Dragging/setting in individual views will be supported in a future version. TOI is placed via alt+click
• TOI will visually manifest in plots and historic tables.
• TOI in real-time will allow manipulation of the offset position of "now". See UI, page 58.
• Date-sorted tables will scroll to bring the TOI into view at the time it is set.
• Tables not sorted by date will not display the TOI or support TOI scrolling.
• Panning the TC such that the TOI goes "out of view" to either side of the TC bounds will reset and disable the TOI, taking it "out of play". Views will all update accordingly.
• Changing the TC bounds via datetime inputs will reset the TOI and take it out of play.
• Views should support proportional placement of the TOI. For example, setting the TOI near the right edge of the TC (say about 10% of the total width of the TC time area) would also place the TOI in synced plots at the same proportion in the available view: near the right edge. Plots should not pan or zoom due to a TOI manipulation.
• Date-sorted tables would scroll in such a way as to approximate this as well.
• Setting the TOI does not cause unsynced elements to re-sync with the TC.
  • If the TOI would be in view with the unsynced element, then it should be displayed.
  • Re-syncing the element would cause the TOI to appear as expected in that element.
• Dragging the TOI to the far right of the TC should result in a "snap to" action that takes the TOI out of play. This is achieved by dismissing the TOI via a button revealed on hover.

Future functionality

• Allow user to drag (or right-click at a position) to set the TOI element in views, such as plots and tables.
• Need to work out a lot of nuance, particularly around
  • Panning/marquee-zooming the TOI out of view.
  • Setting the TOI in an unsynced element - everything else re-syncs and the bounds of the TC are updated; may need a "Are you sure?" dialog on that action.

[charlesh88]

From discussion yesterday 9/15/16 Charles, Pete and Andrew:

• Much more utility with TOI setting in plots and tables directly, rather than via the TC. So let's go after that in the first implementation.
• Rather than docking the TOI line when not enabled, hovering in the plot area will display the time at the cursor position. Clicking will establish a TOI line at that position. A set TOI can be removed by clicking a close button. See more details and drawings in Plot v2 sketches.pdf.

[charlesh88]

@akhenry Just pushed some significant work on the TOI element in plots. Very much WIP at this point, I wouldn't integrate yet - there's a static TOI element sitting in the template right now. Markup in plot.html has some not insignificant mods, but nothing that messes us up if we need to turn off the TOI element. I'll pick this up Monday morning first thing.

[charlesh88]

From discussion with @akhenry 9/20/16:

• TOI in TC should behave same as design in plots:
  • As user moves cursor in visualization bar, TOI element follows cursor and displays datetime at the cursor position.
  • Single-click pins the TOI in position in the TC; user able to continue mousing around the data viz area as noted in the previous bullet.
  • Mousing over the pinned TOI element displays a "X" close control. Ideally, the pinned TOI also supports a contextual "Remove" menu ability.

Todo:

• Add TOI element to table view.
• Add hover and close-state TOI element to TC.
• Once Pete's plots are integrated into Open, apply markup/CSS changes in progress to those.