tracktable.render.clock module

Draw a digital clock on a Matplotlib figure

tracktable.render.clock.digital_clock(time, formatter, position, **kwargs)[source]

Add a digital clock (a string representation of time) to the image at a user-specified location

XXX: This function may go away since it doesn’t provide any useful enhancement over just adding a text actor ourselves.

tracktable.render.clock.draw_analog_clock_on_map(time, offset=None, center=(0.5, 0.5), radius=0.05, axes=None, use_short_side_for_radius=True, long_hand_radius=0.9, short_hand_radius=0.5, tickmarks=True, tickmark_length=0.25, color='white', linewidth=1, zorder=4, label=None, label_placement='top', label_kwargs={})[source]

Draw an analog clock on a Matplotlib figure.

NOTE: THIS INTERFACE IS SUBJECT TO CHANGE. LOTS OF CHANGE.

Parameters

  • time (datetime.datetime) – Time to display

  • offset (datetime.timedelta) – Offset for local time zone. This will be added to the ‘time’ argument to determine the time that will actually be displayed.

  • center (2-tuple in [0,1] * [0, 1]) – image-space center of clock

  • radius (float in [0, 1]) – Radius of clock face

  • axes (matplotlib.axes.Axes) – axes to render into

  • use_short_side_for_radius (boolean) – Clock radius will be calculated relative to short side of figure

  • long_hand_radius (float in [0, 1]) – Radius of minute hand relative to radius of clock face

  • short_hand_radius (float in [0,1]) – Radius of hour hand relative to radius of clock face

  • tickmarks (boolean) – Whether or not to place tickmarks at every hour around the clock face

  • tickmark_length (float in [0,1]) – Length of tickmarks relative to clock face radius

  • color (colorspec) – Color for clock face and hands

  • linewidth (float) – Thickness (in points) of lines drawn

  • zorder (integer) – Ordering of clock in image element stack (higher values are on top)

  • label (string) – Label text to display near clock

  • label_placement (string) – One of ‘top’, ‘bottom’. Determines where label will be rendered relative to clock face

  • label_kwargs (dict) – Arguments to be passed to Matplotlib text renderer for label

Side Effects:
The clock actors will be added to the ‘axes’ argument or (if no

axes are supplied) to the current Matplotlib axes.

Returns

A list of Matplotlib artists added to the figure.