Class ParaGraph
- All Implemented Interfaces:
DoubleClickHandler
,HasAllDragAndDropHandlers
,HasAllFocusHandlers
,HasAllGestureHandlers
,HasAllKeyHandlers
,HasAllMouseHandlers
,HasAllTouchHandlers
,HasBlurHandlers
,HasClickHandlers
,HasContextMenuHandlers
,HasDoubleClickHandlers
,HasDragEndHandlers
,HasDragEnterHandlers
,HasDragHandlers
,HasDragLeaveHandlers
,HasDragOverHandlers
,HasDragStartHandlers
,HasDropHandlers
,HasFocusHandlers
,HasGestureChangeHandlers
,HasGestureEndHandlers
,HasGestureStartHandlers
,HasKeyDownHandlers
,HasKeyPressHandlers
,HasKeyUpHandlers
,HasMouseDownHandlers
,HasMouseMoveHandlers
,HasMouseOutHandlers
,HasMouseOverHandlers
,HasMouseUpHandlers
,HasMouseWheelHandlers
,HasTouchCancelHandlers
,HasTouchEndHandlers
,HasTouchMoveHandlers
,HasTouchStartHandlers
,MouseDownHandler
,MouseMoveHandler
,MouseOutHandler
,MouseUpHandler
,MouseWheelHandler
,TouchEndHandler
,TouchMoveHandler
,TouchStartHandler
,HasAttachHandlers
,EventHandler
,HasHandlers
,EventListener
,AcceptsOneWidget
,Focusable
,HasFocus
,HasOneWidget
,HasVisibility
,HasWidgets
,HasWidgets.ForIsWidget
,IsWidget
,RequiresResize
,SourcesClickEvents
,SourcesFocusEvents
,SourcesKeyboardEvents
,SourcesMouseEvents
,SourcesMouseWheelEvents
,Iterable<Widget>
,AbstractGraph.HasTrajectory
,AbstractGraph.Shifter
,AbstractGraph.Shifting
,AbstractGraph.Zoomer
,AbstractGraph.Zooming
,ContextMenu.Listener
,ContextMenu.Provider
,Tooltip.Provider
The graph is backed by a RingBuffer
to store the trajectory. The
buffer is updated by calling addData(double, double[], boolean)
. It
is interactive and allows the user to zoom and shift the view. The user can
set the initial state by double-clicking on the graph. The graph can be
exported in PNG or SVG graphics formats or the trajectory data as CSV.
The graph provides fine grained configurations for mapping the data to the phase plane, for tooltips, for markers as well as for the style of the graph.
- Author:
- Christoph Hauert
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionclass
Default mapping of data to the phase plane or phase plane projections.Nested classes/interfaces inherited from class AbstractGraph
AbstractGraph.Controller, AbstractGraph.GraphStyle, AbstractGraph.HasTrajectory, AbstractGraph.MyContext2d, AbstractGraph.Shifter, AbstractGraph.Shifting, AbstractGraph.ZoomCommand, AbstractGraph.Zoomer, AbstractGraph.Zooming
Nested classes/interfaces inherited from class UIObject
UIObject.DebugIdImpl, UIObject.DebugIdImplEnabled
Nested classes/interfaces inherited from interface HasWidgets
HasWidgets.ForIsWidget
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate ContextMenuItem
The context menu item to autoscale the axis.private double
Threshold for storing new data point in buffer.private ContextMenuItem
The context menu item to clear the canvas.(package private) double[]
The starting point of the most recent trajectory.(package private) HasPhase2D.Data2Phase
The map for converting data to phase plane coordinates.private static double
The minimum distance between two subsequent points in pixels.private boolean
The flag to indicate whether painting is already scheduled.Fields inherited from class AbstractGraph
bounds, buffer, canvas, colors, contextMenu, controller, DEFAULT_BUFFER_SIZE, doubleClickHandler, element, g, hasMessage, hasZoom, isActive, leftMouseButton, logger, markerColors, markers, MIN_BUFFER_SIZE, MIN_MSEC_BETWEEN_UPDATES, module, mouseDownHandler, mouseMoveHandler, mouseOutHandler, mouseUpHandler, mouseWheelHandler, mouseX, mouseY, PIHALF, pinchDist, pinchX, pinchY, scale, shifter, style, tooltip, tooltipProvider, touchEndHandler, touchEndTime, touchMoveHandler, touchStartHandler, updatetime, viewCorner, wrapper, zoomer, zoomFactor, zoomInertiaTimer, zoomInMenu, zoomOutMenu, zoomResetMenu
Fields inherited from class UIObject
DEBUG_ID_PREFIX
Fields inherited from interface AbstractGraph.Zooming
ZOOM_INCR, ZOOM_MAX
-
Constructor Summary
ConstructorsConstructorDescriptionParaGraph
(AbstractGraph.Controller controller, Module module) Create new parametric graph formodule
running incontroller
. -
Method Summary
Modifier and TypeMethodDescriptionvoid
activate()
Perform necessary preparations to show the graph in the GUI.void
addData
(double t, double[] data, boolean force) Add data to the graph.void
Automatically adjust the range of both axes to fit the data in the buffer.void
calcBounds
(int width, int height) Calculate bounds of drawing area.private double
distSq
(double[] vec, double[] buf) Helper method to calculate the distance squared between two vectors.void
Export the graphical contextctx
.void
exportTrajectory
(StringBuilder export) Export the trajectory of the graph toexport
.getMap()
Get the map for converting data to phase plane coordinates.getTooltipAt
(int x, int y) Get the tooltip information for the location with coordinates(x, y)
.private boolean
inside
(double x, double y) Check if point (in user coordinates but not yet scaled to axis) lies inside of phase plane.void
onDoubleClick
(DoubleClickEvent event) void
onTouchStart
(TouchStartEvent event) boolean
paint
(boolean force) Draw the graph.private void
paintPara
(boolean withMarkers) Paint the trajectory in the phase plane.void
populateContextMenuAt
(ContextMenu menu, int x, int y) Populate context menumenu
in listening widget at (relative) position(x,y)
.private void
processInitXY
(double x, double y) Helper method to convert screen coordinates into an initial configuration and set the controller's initial state.protected void
Schedule painting of the graph.void
Set the map for converting data to phase plane coordinates.Methods inherited from class AbstractGraph
addContextMenuHandler, autoscale, calcBounds, clearCanvas, clearGraph, clearHistory, clearMessage, contains, convertToScaledCoordinates, convertToScaledCoordinates, deactivate, displayMessage, doUpdate, drawFrame, drawFrame, fill, fillCircle, fillRect, fillTextVertical, getBuffer, getModule, getStyle, hasHistory, hasMessage, init, onMouseDown, onMouseMove, onMouseOut, onMouseUp, onMouseWheel, onResize, onTouchEnd, onTouchMove, paint, prependTime2Data, reset, resetTransforms, setBufferCapacity, setColors, setFont, setMarkers, setMarkers, setStrokeStyleAt, setTooltipProvider, shift, stroke, strokeCircle, strokeLine, strokeRect, zoom, zoom, zoom, zoom
Methods inherited from class FocusPanel
addBlurHandler, addClickHandler, addClickListener, addDoubleClickHandler, addDragEndHandler, addDragEnterHandler, addDragHandler, addDragLeaveHandler, addDragOverHandler, addDragStartHandler, addDropHandler, addFocusHandler, addFocusListener, addGestureChangeHandler, addGestureEndHandler, addGestureStartHandler, addKeyboardListener, addKeyDownHandler, addKeyPressHandler, addKeyUpHandler, addMouseDownHandler, addMouseListener, addMouseMoveHandler, addMouseOutHandler, addMouseOverHandler, addMouseUpHandler, addMouseWheelHandler, addMouseWheelListener, addTouchCancelHandler, addTouchEndHandler, addTouchMoveHandler, addTouchStartHandler, getTabIndex, removeClickListener, removeFocusListener, removeKeyboardListener, removeMouseListener, removeMouseWheelListener, setAccessKey, setFocus, setTabIndex
Methods inherited from class SimplePanel
add, getContainerElement, getWidget, iterator, remove, setWidget, setWidget
Methods inherited from class Panel
add, adopt, clear, doAttachChildren, doDetachChildren, orphan, remove
Methods inherited from class Widget
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, fireEvent, getHandlerCount, getLayoutData, getParent, isAttached, isOrWasAttached, onAttach, onBrowserEvent, onDetach, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
Methods inherited from class UIObject
addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, resolvePotentialElement, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString
Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface AbstractGraph.Shifter
shift
Methods inherited from interface AbstractGraph.Zoomer
zoom
Methods inherited from interface AbstractGraph.Zooming
zoom, zoom
Methods inherited from interface ContextMenu.Listener
getAbsoluteLeft, getAbsoluteTop
Methods inherited from interface HasHandlers
fireEvent
Methods inherited from interface HasTouchCancelHandlers
addTouchCancelHandler
Methods inherited from interface HasTouchEndHandlers
addTouchEndHandler
Methods inherited from interface HasTouchMoveHandlers
addTouchMoveHandler
Methods inherited from interface HasTouchStartHandlers
addTouchStartHandler
Methods inherited from interface Iterable
forEach, spliterator
Methods inherited from interface MouseDownHandler
onMouseDown
Methods inherited from interface MouseMoveHandler
onMouseMove
Methods inherited from interface MouseOutHandler
onMouseOut
Methods inherited from interface MouseUpHandler
onMouseUp
Methods inherited from interface MouseWheelHandler
onMouseWheel
Methods inherited from interface TouchEndHandler
onTouchEnd
Methods inherited from interface TouchMoveHandler
onTouchMove
-
Field Details
-
init
double[] initThe starting point of the most recent trajectory. -
map
The map for converting data to phase plane coordinates. -
bufferThreshold
private double bufferThresholdThreshold for storing new data point in buffer. Roughly corresponds to the squared distance between two points that are at least a pixel apart. -
MIN_PIXELS
private static double MIN_PIXELSThe minimum distance between two subsequent points in pixels. -
paintScheduled
private boolean paintScheduledThe flag to indicate whether painting is already scheduled. Subsequent requests are ignored. -
clearMenu
The context menu item to clear the canvas. -
autoscaleMenu
The context menu item to autoscale the axis.
-
-
Constructor Details
-
ParaGraph
Create new parametric graph formodule
running incontroller
.- Parameters:
controller
- the controller of this graphmodule
- the module backing the graph
-
-
Method Details
-
activate
public void activate()Description copied from class:AbstractGraph
Perform necessary preparations to show the graph in the GUI. Attaches mouse and touch handlers for graphs that implementAbstractGraph.Zooming
orAbstractGraph.Shifting
interfaces.- Overrides:
activate
in classAbstractGraph<double[]>
- See Also:
-
setMap
Set the map for converting data to phase plane coordinates.- Parameters:
map
- the conversion map
-
getMap
Get the map for converting data to phase plane coordinates.- Returns:
- the conversion map
-
addData
public void addData(double t, double[] data, boolean force) Add data to the graph. The timet
is prepended to the data as the first element.- Parameters:
t
- the time of the datadata
- the data to addforce
-true
to force adding the data- Implementation Notes:
- The data array is cloned and the time prepended before adding it to the buffer.
- In order to conserve memory the data is added only if the
distance between
the new data point and the last point in the buffer is larger
than threshold
bufferThreshold
, unlessforce == true
.
-
distSq
private double distSq(double[] vec, double[] buf) Helper method to calculate the distance squared between two vectors.- Parameters:
vec
- the first vectorbuf
- the second vector- Returns:
- the squared distance
-
paint
public boolean paint(boolean force) Description copied from class:AbstractGraph
Draw the graph. For re-drawing the graph, setforce
totrue
.- Overrides:
paint
in classAbstractGraph<double[]>
- Parameters:
force
-true
to force re-drawing of graph- Returns:
true
if painting skipped
-
paintPara
private void paintPara(boolean withMarkers) Paint the trajectory in the phase plane. IfwithMarkers
istrue
the start and end points of the trajectory are marked with green and red circles, respectively.- Parameters:
withMarkers
-true
to mark start and end points
-
calcBounds
public void calcBounds(int width, int height) Description copied from class:AbstractGraph
Calculate bounds of drawing area.- Overrides:
calcBounds
in classAbstractGraph<double[]>
- Parameters:
width
- the width of the drawing areaheight
- the height of the drawing area
-
autoscale
public void autoscale()Automatically adjust the range of both axes to fit the data in the buffer. -
schedulePaint
protected void schedulePaint()Schedule painting of the graph. If painting is already scheduled, subsequent requests are ignored.- See Also:
-
export
Description copied from class:AbstractGraph
Export the graphical contextctx
.- Specified by:
export
in classAbstractGraph<double[]>
- Parameters:
ctx
- the graphical context to export
-
onDoubleClick
- Specified by:
onDoubleClick
in interfaceDoubleClickHandler
-
processInitXY
private void processInitXY(double x, double y) Helper method to convert screen coordinates into an initial configuration and set the controller's initial state.- Parameters:
x
- thex
-coordinate on screeny
- they
-coordinate on screen
-
onTouchStart
Description copied from class:AbstractGraph
The graph reacts to different kinds of touches: short touches or taps (
<250
msec) and long touches (>250
msec). Long touches trigger different actions depending on the number of fingers:- Single finger
- Initiate shifting the view
- Two fingers
- Initiate pinching zoom.
- Specified by:
onTouchStart
in interfaceTouchStartHandler
- Overrides:
onTouchStart
in classAbstractGraph<double[]>
- See Also:
-
getTooltipAt
Description copied from interface:Tooltip.Provider
Get the tooltip information for the location with coordinates(x, y)
. The returned string may include HTML elements for formatting.- Specified by:
getTooltipAt
in interfaceTooltip.Provider
- Parameters:
x
- thex
-coordinate for the tooltipy
- they
-coordinate for the tooltip- Returns:
- the (formatted) string with the tooltip info
-
inside
private boolean inside(double x, double y) Check if point (in user coordinates but not yet scaled to axis) lies inside of phase plane.- Parameters:
x
-x
-coordinate of pointy
-y
-coordinate of point- Returns:
true
if inside
-
populateContextMenuAt
Description copied from class:AbstractGraph
Populate context menumenu
in listening widget at (relative) position(x,y)
.Adds buffer size menu and queries the controller to add further functionality.
- Specified by:
populateContextMenuAt
in interfaceContextMenu.Provider
- Overrides:
populateContextMenuAt
in classAbstractGraph<double[]>
- Parameters:
menu
- context menu entries are added herex
- horizontal coordinate (relative to listening widget)y
- horizontal coordinate (relative to listening widget)- See Also:
-
exportTrajectory
Description copied from interface:AbstractGraph.HasTrajectory
Export the trajectory of the graph toexport
.- Specified by:
exportTrajectory
in interfaceAbstractGraph.HasTrajectory
- Parameters:
export
- the string builder to export the trajectory
-