def plot_data_dict(data_dict, plots = None, mode = 'static', hang = True, figure = None, size = None, **plot_preference_kwargs):
"""
Make a plot of data in the format defined in data_dict
:param data_dict: dict<str: plottable_data>
:param plots: Optionally, a dict of <key: IPlot> identifying the plot objects to use (keys should
be the same as those in data_dict).
:return: The plots (same ones you provided if you provided them)
"""
assert mode in ('live', 'static')
if isinstance(data_dict, list):
assert all(len(d) == 2 for d in data_dict), "You can provide data as a list of 2 tuples of (plot_name, plot_data)"
data_dict = OrderedDict(data_dict)
if plots is None:
plots = {k: get_plot_from_data(v, mode = mode, **plot_preference_kwargs) for k, v in data_dict.items()}
if figure is None:
if size is not None:
from pylab import rcParams
rcParams['figure.figsize'] = size
figure = plt.figure()
n_rows, n_cols = vector_length_to_tile_dims(len(data_dict))
for i, (k, v) in enumerate(data_dict.items()):
plt.subplot(n_rows, n_cols, i + 1)
plots[k].update(v)
plots[k].plot()
plt.title(k, fontdict = {'fontsize': 8})
oldhang = plt.isinteractive()
plt.interactive(not hang)
plt.show()
plt.interactive(oldhang)
return figure, plots
def dbplot(data,
name=None,
plot_type=None,
axis=None,
plot_mode='live',
draw_now=True,
hang=False,
title=None,
fig=None,
xlabel=None,
ylabel=None,
draw_every=None,
layout=None,
legend=None,
grid=False,
wait_for_display_sec=0,
cornertext=None):
"""
Plot arbitrary data and continue execution. This program tries to figure out what type of plot to use.
:param data: Any data. Hopefully, we at dbplot will be able to figure out a plot for it.
:param name: A name uniquely identifying this plot.
:param plot_type: A specialized constructor to be used the first time when plotting. You can also pass
certain string to give hints as to what kind of plot you want (can resolve cases where the given data could be
plotted in multiple ways):
'line': Plots a line plot
'img': An image plot
'colour': A colour image plot
'pic': A picture (no scale bars, axis labels, etc).
:param axis: A string identifying which axis to plot on. By default, it is the same as "name". Only use this
argument if you indend to make multiple dbplots share the same axis.
:param plot_mode: Influences how the data should be used to choose the plot type:
'live': Best for 'live' plots that you intend to update as new data arrives
'static': Best for 'static' plots, that you do not intend to update
'image': Try to represent the plot as an image
:param draw_now: Draw the plot now (you may choose false if you're going to add another plot immediately after and
don't want have to draw this one again.
:param hang: Hang on the plot (wait for it to be closed before continuing)
:param title: Title of the plot (will default to name if not included)
:param fig: Name of the figure - use this when you want to create multiple figures.
:param grid: Turn the grid on
:param wait_for_display_sec: In server mode, you can choose to wait maximally wait_for_display_sec seconds before this
call returns. In case plotting is finished earlier, the call returns earlier. Setting wait_for_display_sec to a negative number will cause the call to block until the plot has been displayed.
"""
if is_server_plotting_on():
# Redirect the function call to the plotting server. The flag gets turned on in a configuration file. It is
# turned off when this file is run ON the plotting server, from the first line in plotting_server.py
arg_locals = locals().copy()
from artemis.remote.plotting.plotting_client import dbplot_remotely
dbplot_remotely(arg_locals=arg_locals)
return
if isinstance(fig, plt.Figure):
assert None not in _DBPLOT_FIGURES, "If you pass a figure, you can only do it on the first call to dbplot (for now)"
_DBPLOT_FIGURES[None] = _PlotWindow(figure=fig,
subplots=OrderedDict(),
axes={})
fig = None
elif fig not in _DBPLOT_FIGURES or not plt.fignum_exists(
_DBPLOT_FIGURES[fig].figure.number
): # Second condition handles closed figures.
_DBPLOT_FIGURES[fig] = _PlotWindow(figure=_make_dbplot_figure(),
subplots=OrderedDict(),
axes={})
if fig is not None:
_DBPLOT_FIGURES[fig].figure.canvas.set_window_title(fig)
suplot_dict = _DBPLOT_FIGURES[fig].subplots
if axis is None:
axis = name
if name not in suplot_dict:
if isinstance(plot_type, str):
plot = PLOT_CONSTRUCTORS[plot_type]()
elif plot_type is None:
plot = get_plot_from_data(data, mode=plot_mode)
else:
assert hasattr(plot_type, "__call__")
plot = plot_type()
if isinstance(axis, SubplotSpec):
axis = plt.subplot(axis)
if isinstance(axis, Axes):
ax = axis
ax_name = str(axis)
elif isinstance(axis, string_types) or axis is None:
ax = select_subplot(
axis,
fig=_DBPLOT_FIGURES[fig].figure,
layout=_default_layout if layout is None else layout)
ax_name = axis
# ax.set_title(axis)
else:
raise Exception(
"Axis specifier must be a string, an Axis object, or a SubplotSpec object. Not {}"
.format(axis))
if ax_name not in _DBPLOT_FIGURES[fig].axes:
ax.set_title(name)
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(axis=ax,
plot_object=plot)
_DBPLOT_FIGURES[fig].axes[ax_name] = ax
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(
axis=_DBPLOT_FIGURES[fig].axes[ax_name], plot_object=plot)
plt.sca(_DBPLOT_FIGURES[fig].axes[ax_name])
if xlabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_xlabel(xlabel)
if ylabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_ylabel(ylabel)
if draw_every is not None:
_draw_counters[fig, name] = -1
if grid:
plt.grid()
# Update the relevant data and plot it. TODO: Add option for plotting update interval
plot = _DBPLOT_FIGURES[fig].subplots[name].plot_object
plot.update(data)
plot.plot()
if cornertext is not None:
if not hasattr(_DBPLOT_FIGURES[fig].figure, '__cornertext'):
_DBPLOT_FIGURES[fig].figure.__cornertext = next(
iter(_DBPLOT_FIGURES[fig].subplots.values())).axis.annotate(
cornertext,
xy=(0, 0),
xytext=(0.01, 0.98),
textcoords='figure fraction')
else:
_DBPLOT_FIGURES[fig].figure.__cornertext.set_text(cornertext)
if title is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_title(title)
if legend is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.legend(legend,
loc='best',
framealpha=0.5)
if draw_now and not _hold_plots:
if draw_every is not None:
_draw_counters[fig, name] += 1
if _draw_counters[fig, name] % draw_every != 0:
return _DBPLOT_FIGURES[fig].subplots[name].axis
if hang:
plt.figure(_DBPLOT_FIGURES[fig].figure.number)
plt.show()
else:
redraw_figure(_DBPLOT_FIGURES[fig].figure)
return _DBPLOT_FIGURES[fig].subplots[name].axis
def dbplot(data,
name=None,
plot_type=None,
axis=None,
plot_mode='live',
draw_now=True,
hang=False,
title=None,
fig=None,
xlabel=None,
ylabel=None,
draw_every=None,
layout=None,
legend=None,
grid=False,
wait_for_display_sec=0,
cornertext=None,
reset_color_cycle=False):
"""
Plot arbitrary data and continue execution. This program tries to figure out what type of plot to use.
:param data: Any data. Hopefully, we at dbplot will be able to figure out a plot for it.
:param name: A name uniquely identifying this plot.
:param Union[Callable[[],LinePlot],str,Tuple[Callable, Dict]] plot_type : A specialized constructor to be used the
first time when plotting. Several predefined constructors are defined in the DBPlotTypes class - you can pass
those. For back-compatibility you can also pass a string matching the name of one of the fields in the DBPlotTypes
class.
DBPlotTypes.LINE: Plots a line plot
DBPlotTypes.IMG: An image plot
DBPlotTypes.COLOUR: A colour image plot
DBPlotTypes.PIC: A picture (no scale bars, axis labels, etc)
You can also, pass a tuple of (constructor, keyword_args) where keyword args is a dict of arcuments to the plot
constructor.
:param axis: A string identifying which axis to plot on. By default, it is the same as "name". Only use this
argument if you indend to make multiple dbplots share the same axis.
:param plot_mode: Influences how the data should be used to choose the plot type:
'live': Best for 'live' plots that you intend to update as new data arrives
'static': Best for 'static' plots, that you do not intend to update
'image': Try to represent the plot as an image
:param draw_now: Draw the plot now (you may choose false if you're going to add another plot immediately after and
don't want have to draw this one again.
:param hang: Hang on the plot (wait for it to be closed before continuing)
:param title: Title of the plot (will default to name if not included)
:param fig: Name of the figure - use this when you want to create multiple figures.
:param grid: Turn the grid on
:param wait_for_display_sec: In server mode, you can choose to wait maximally wait_for_display_sec seconds before this
call returns. In case plotting is finished earlier, the call returns earlier. Setting wait_for_display_sec to a negative number will cause the call to block until the plot has been displayed.
"""
if is_server_plotting_on():
# Redirect the function call to the plotting server. The flag gets turned on in a configuration file. It is
# turned off when this file is run ON the plotting server, from the first line in plotting_server.py
arg_locals = locals().copy()
from artemis.remote.plotting.plotting_client import dbplot_remotely
dbplot_remotely(arg_locals=arg_locals)
return
if data.__class__.__module__ == 'torch' and data.__class__.__name__ == 'Tensor':
data = data.detach().cpu().numpy()
plot_object = _get_dbplot_plot_object(fig) # type: _PlotWindow
suplot_dict = plot_object.subplots
if axis is None:
axis = name
if name not in suplot_dict: # Initialize new axis
if isinstance(plot_type, str):
plot = DBPlotTypes.from_string(plot_type)()
elif isinstance(plot_type, tuple):
assert len(plot_type) == 2 and isinstance(
plot_type[0], str
) and isinstance(
plot_type[1], dict
), 'If you specify a tuple for plot_type, we expect (name, arg_dict). Got: {}'.format(
plot_type)
plot_type_name, plot_type_args = plot_type
if isinstance(plot_type_name, str):
plot = DBPlotTypes.from_string(plot_type_name)(
**plot_type_args)
elif callable(plot_type_name):
plot = plot_type_name(**plot_type_args)
else:
raise Exception(
'The first argument of the plot type tuple must be a plot type name or a callable plot type constructor.'
)
elif plot_type is None:
plot = get_plot_from_data(data, mode=plot_mode)
else:
assert hasattr(plot_type, "__call__")
plot = plot_type()
if isinstance(axis, SubplotSpec):
axis = plt.subplot(axis)
if isinstance(axis, Axes):
ax = axis
ax_name = str(axis)
elif isinstance(axis, string_types) or axis is None:
ax = select_subplot(
axis,
fig=plot_object.figure,
layout=_default_layout if layout is None else layout)
ax_name = axis
# ax.set_title(axis)
else:
raise Exception(
"Axis specifier must be a string, an Axis object, or a SubplotSpec object. Not {}"
.format(axis))
if ax_name not in plot_object.axes:
ax.set_title(name)
plot_object.subplots[name] = _Subplot(axis=ax, plot_object=plot)
plot_object.axes[ax_name] = ax
plot_object.subplots[name] = _Subplot(axis=plot_object.axes[ax_name],
plot_object=plot)
plt.sca(plot_object.axes[ax_name])
if xlabel is not None:
plot_object.subplots[name].axis.set_xlabel(xlabel)
if ylabel is not None:
plot_object.subplots[name].axis.set_ylabel(ylabel)
if draw_every is not None:
_draw_counters[fig, name] = Checkpoints(draw_every)
if grid:
plt.grid()
plot = plot_object.subplots[name].plot_object
if reset_color_cycle:
use_dbplot_axis(axis, fig=fig, clear=False).set_color_cycle(None)
plot.update(data)
# Update Labels...
if cornertext is not None:
if not hasattr(plot_object.figure, '__cornertext'):
plot_object.figure.__cornertext = next(
iter(plot_object.subplots.values())).axis.annotate(
cornertext,
xy=(0, 0),
xytext=(0.01, 0.98),
textcoords='figure fraction')
else:
plot_object.figure.__cornertext.set_text(cornertext)
if title is not None:
plot_object.subplots[name].axis.set_title(title)
if legend is not None:
plot_object.subplots[name].axis.legend(legend,
loc='best',
framealpha=0.5)
if draw_now and not _hold_plots and (draw_every is None or (
(fig, name) not in _draw_counters) or _draw_counters[fig, name]()):
plot.plot()
display_figure(plot_object.figure, hang=hang)
return plot_object.subplots[name].axis
def dbplot(data,
name=None,
plot_type=None,
axis=None,
plot_mode='live',
draw_now=True,
hang=False,
title=None,
fig=None,
xlabel=None,
ylabel=None,
draw_every=None,
layout=None,
legend=None,
grid=False,
wait_for_display_sec=0):
"""
Plot arbitrary data. This program tries to figure out what type of plot to use.
:param data: Any data. Hopefully, we at dbplot will be able to figure out a plot for it.
:param name: A name uniquely identifying this plot.
:param plot_type: A specialized constructor to be used the first time when plotting. You can also pass
certain string to give hints as to what kind of plot you want (can resolve cases where the given data could be
plotted in multiple ways):
'line': Plots a line plot
'img': An image plot
'colour': A colour image plot
'pic': A picture (no scale bars, axis labels, etc).
:param axis: A string identifying which axis to plot on. By default, it is the same as "name". Only use this
argument if you indend to make multiple dbplots share the same axis.
:param plot_mode: Influences how the data should be used to choose the plot type:
'live': Best for 'live' plots that you intend to update as new data arrives
'static': Best for 'static' plots, that you do not intend to update
'image': Try to represent the plot as an image
:param draw_now: Draw the plot now (you may choose false if you're going to add another plot immediately after and
don't want have to draw this one again.
:param hang: Hang on the plot (wait for it to be closed before continuing)
:param title: Title of the plot (will default to name if not included)
:param fig: Name of the figure - use this when you want to create multiple figures.
:param grid: Turn the grid on
:param wait_for_display_sec: In server mode, you can choose to wait maximally wait_for_display_sec seconds before this call returns. In case plotting
is finished earlier, the call returns earlier. Setting wait_for_display_sec to a negative number will cause the call to block until the plot has been displayed.
"""
if is_server_plotting_on():
# Redirect the function call to the plotting server. The flag gets turned on in a configuration file. It is
# turned off when this file is run ON the plotting server, from the first line in plotting_server.py
arg_locals = locals().copy()
from artemis.remote.plotting.plotting_client import dbplot_remotetly
dbplot_remotetly(arg_locals=arg_locals)
return
if isinstance(fig, plt.Figure):
assert None not in _DBPLOT_FIGURES, "If you pass a figure, you can only do it on the first call to dbplot (for now)"
_DBPLOT_FIGURES[None] = fig
fig = None
elif fig not in _DBPLOT_FIGURES:
_DBPLOT_FIGURES[fig] = _PlotWindow(figure=_make_dbplot_figure(),
subplots=OrderedDict(),
axes={})
if fig is not None:
_DBPLOT_FIGURES[fig].figure.canvas.set_window_title(fig)
suplot_dict = _DBPLOT_FIGURES[fig].subplots
if axis is None:
axis = name
if name not in suplot_dict:
if isinstance(plot_type, str):
plot = {
'line':
LinePlot,
'thick-line':
lambda: LinePlot(plot_kwargs={'linewidth': 3}),
'pos_line':
lambda: LinePlot(y_bounds=(0, None), y_bound_extend=(0, 0.05)),
# 'pos_line': lambda: LinePlot(y_bounds=(0, None)),
'bar':
BarPlot,
'img':
ImagePlot,
'colour':
lambda: ImagePlot(is_colour_data=True),
'equal_aspect':
lambda: ImagePlot(aspect='equal'),
'image_history':
lambda: MovingImagePlot(),
'fixed_line_history':
lambda: MovingPointPlot(buffer_len=100),
'pic':
lambda: ImagePlot(show_clims=False, aspect='equal'),
'notice':
lambda: TextPlot(max_history=1,
horizontal_alignment='center',
vertical_alignment='center',
size='x-large'),
'cost':
lambda: MovingPointPlot(y_bounds=(0, None),
y_bound_extend=(0, 0.05)),
'percent':
lambda: MovingPointPlot(y_bounds=(0, 100)),
'trajectory':
lambda: Moving2DPointPlot(axes_update_mode='expand'),
'trajectory+':
lambda: Moving2DPointPlot(axes_update_mode='expand',
x_bounds=(0, None),
y_bounds=(0, None)),
'histogram':
lambda: HistogramPlot(edges=np.linspace(-5, 5, 20)),
'cumhist':
lambda: CumulativeLineHistogram(edges=np.linspace(-5, 5, 20)),
}[plot_type]()
elif plot_type is None:
plot = get_plot_from_data(data, mode=plot_mode)
else:
assert hasattr(plot_type, "__call__")
plot = plot_type()
if isinstance(axis, SubplotSpec):
axis = plt.subplot(axis)
if isinstance(axis, Axes):
ax = axis
ax_name = str(axis)
elif isinstance(axis, basestring) or axis is None:
ax = select_subplot(
axis,
fig=_DBPLOT_FIGURES[fig].figure,
layout=_default_layout if layout is None else layout)
ax_name = axis
# ax.set_title(axis)
else:
raise Exception(
"Axis specifier must be a string, an Axis object, or a SubplotSpec object. Not {}"
.format(axis))
if ax_name not in _DBPLOT_FIGURES[fig].axes:
ax.set_title(name)
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(axis=ax,
plot_object=plot)
_DBPLOT_FIGURES[fig].axes[ax_name] = ax
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(
axis=_DBPLOT_FIGURES[fig].axes[ax_name], plot_object=plot)
plt.sca(_DBPLOT_FIGURES[fig].axes[ax_name])
if xlabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_xlabel(xlabel)
if ylabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_ylabel(ylabel)
if draw_every is not None:
_draw_counters[fig, name] = -1
if grid:
plt.grid()
# Update the relevant data and plot it. TODO: Add option for plotting update interval
plot = _DBPLOT_FIGURES[fig].subplots[name].plot_object
plot.update(data)
plot.plot()
if title is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_title(title)
if legend is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.legend(legend,
loc='best',
framealpha=0.5)
if draw_now and not _hold_plots:
if draw_every is not None:
_draw_counters[fig, name] += 1
if _draw_counters[fig, name] % draw_every != 0:
return _DBPLOT_FIGURES[fig].subplots[name].axis
if hang:
plt.figure(_DBPLOT_FIGURES[fig].figure.number)
plt.show()
else:
redraw_figure(_DBPLOT_FIGURES[fig].figure)
return _DBPLOT_FIGURES[fig].subplots[name].axis
def dbplot(data, name = None, plot_type = None, axis=None, plot_mode = 'live', draw_now = True, hang = False, title=None,
fig = None, xlabel = None, ylabel = None, draw_every = None, layout=None, legend=None, grid=False,
wait_for_display_sec=0, cornertext = None, reset_color_cycle = False):
"""
Plot arbitrary data and continue execution. This program tries to figure out what type of plot to use.
:param data: Any data. Hopefully, we at dbplot will be able to figure out a plot for it.
:param name: A name uniquely identifying this plot.
:param plot_type: A specialized constructor to be used the first time when plotting. You can also pass
certain string to give hints as to what kind of plot you want (can resolve cases where the given data could be
plotted in multiple ways):
'line': Plots a line plot
'img': An image plot
'colour': A colour image plot
'pic': A picture (no scale bars, axis labels, etc).
:param axis: A string identifying which axis to plot on. By default, it is the same as "name". Only use this
argument if you indend to make multiple dbplots share the same axis.
:param plot_mode: Influences how the data should be used to choose the plot type:
'live': Best for 'live' plots that you intend to update as new data arrives
'static': Best for 'static' plots, that you do not intend to update
'image': Try to represent the plot as an image
:param draw_now: Draw the plot now (you may choose false if you're going to add another plot immediately after and
don't want have to draw this one again.
:param hang: Hang on the plot (wait for it to be closed before continuing)
:param title: Title of the plot (will default to name if not included)
:param fig: Name of the figure - use this when you want to create multiple figures.
:param grid: Turn the grid on
:param wait_for_display_sec: In server mode, you can choose to wait maximally wait_for_display_sec seconds before this
call returns. In case plotting is finished earlier, the call returns earlier. Setting wait_for_display_sec to a negative number will cause the call to block until the plot has been displayed.
"""
if is_server_plotting_on():
# Redirect the function call to the plotting server. The flag gets turned on in a configuration file. It is
# turned off when this file is run ON the plotting server, from the first line in plotting_server.py
arg_locals = locals().copy()
from artemis.remote.plotting.plotting_client import dbplot_remotely
dbplot_remotely(arg_locals=arg_locals)
return
if isinstance(fig, plt.Figure):
assert None not in _DBPLOT_FIGURES, "If you pass a figure, you can only do it on the first call to dbplot (for now)"
_DBPLOT_FIGURES[None] = _PlotWindow(figure=fig, subplots=OrderedDict(), axes={})
fig = None
elif fig not in _DBPLOT_FIGURES or not plt.fignum_exists(_DBPLOT_FIGURES[fig].figure.number): # Second condition handles closed figures.
_DBPLOT_FIGURES[fig] = _PlotWindow(figure = _make_dbplot_figure(), subplots=OrderedDict(), axes = {})
if fig is not None:
_DBPLOT_FIGURES[fig].figure.canvas.set_window_title(fig)
suplot_dict = _DBPLOT_FIGURES[fig].subplots
if axis is None:
axis=name
if name not in suplot_dict: # Initialize new axis
if isinstance(plot_type, str):
plot = PLOT_CONSTRUCTORS[plot_type]()
elif isinstance(plot_type, tuple):
assert len(plot_type)==2 and isinstance(plot_type[0], str) and isinstance(plot_type[1], dict), 'If you specify a tuple for plot_type, we expect (name, arg_dict). Got: {}'.format(plot_type)
plot_type_name, plot_type_args = plot_type
plot = PLOT_CONSTRUCTORS[plot_type_name](**plot_type_args)
elif plot_type is None:
plot = get_plot_from_data(data, mode=plot_mode)
else:
assert hasattr(plot_type, "__call__")
plot = plot_type()
if isinstance(axis, SubplotSpec):
axis = plt.subplot(axis)
if isinstance(axis, Axes):
ax = axis
ax_name = str(axis)
elif isinstance(axis, string_types) or axis is None:
ax = select_subplot(axis, fig=_DBPLOT_FIGURES[fig].figure, layout=_default_layout if layout is None else layout)
ax_name = axis
# ax.set_title(axis)
else:
raise Exception("Axis specifier must be a string, an Axis object, or a SubplotSpec object. Not {}".format(axis))
if ax_name not in _DBPLOT_FIGURES[fig].axes:
ax.set_title(name)
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(axis=ax, plot_object=plot)
_DBPLOT_FIGURES[fig].axes[ax_name] = ax
_DBPLOT_FIGURES[fig].subplots[name] = _Subplot(axis=_DBPLOT_FIGURES[fig].axes[ax_name], plot_object=plot)
plt.sca(_DBPLOT_FIGURES[fig].axes[ax_name])
if xlabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_xlabel(xlabel)
if ylabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_ylabel(ylabel)
if draw_every is not None:
_draw_counters[fig, name] = Checkpoints(draw_every)
if grid:
plt.grid()
plot = _DBPLOT_FIGURES[fig].subplots[name].plot_object
if reset_color_cycle:
get_dbplot_axis(axis_name=axis, fig=fig).set_color_cycle(None)
plot.update(data)
# Update Labels...
if cornertext is not None:
if not hasattr(_DBPLOT_FIGURES[fig].figure, '__cornertext'):
_DBPLOT_FIGURES[fig].figure.__cornertext = next(iter(_DBPLOT_FIGURES[fig].subplots.values())).axis.annotate(cornertext, xy=(0, 0), xytext=(0.01, 0.98), textcoords='figure fraction')
else:
_DBPLOT_FIGURES[fig].figure.__cornertext.set_text(cornertext)
if title is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_title(title)
if legend is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.legend(legend, loc='best', framealpha=0.5)
if draw_now and not _hold_plots and (draw_every is None or ((fig, name) not in _draw_counters) or _draw_counters[fig, name]()):
plot.plot()
if hang:
plt.figure(_DBPLOT_FIGURES[fig].figure.number)
plt.show()
else:
redraw_figure(_DBPLOT_FIGURES[fig].figure)
return _DBPLOT_FIGURES[fig].subplots[name].axis
def _get_plots_from_first_data(self, first_data):
# first_data = dict(first_data)
return {k: pb.plot if isinstance(pb, LivePlot) else get_plot_from_data(first_data[k], mode = 'live') for k, pb in self._live_plots.items()}
def _get_plots_from_first_data(self, first_data):
return {k: get_plot_from_data(v, mode = self._plot_mode, **self._plot_preference_kwargs)
if k not in self._plot_types else self._plot_types[k] for k, v in first_data.items()}
def dbplot(data,
name=None,
plot_type=None,
plot_mode='live',
draw_now=True,
hang=False,
title=None,
fig=None,
xlabel=None,
ylabel=None,
draw_every=None,
legend=None,
plot_constructor=None):
"""
Plot arbitrary data. This program tries to figure out what type of plot to use.
:param data: Any data. Hopefully, we at dbplot will be able to figure out a plot for it.
:param name: A name uniquely identifying this plot.
:param plot_type: A specialized constructor to be used the first time when plotting. You can also pass
certain string to give hints as to what kind of plot you want (can resolve cases where the given data could be
plotted in multiple ways):
'line': Plots a line plot
'img': An image plot
'colour': A colour image plot
'pic': A picture (no scale bars, axis labels, etc).
:param plot_mode: Influences how the data should be used to choose the plot type:
'live': Best for 'live' plots that you intend to update as new data arrives
'static': Best for 'static' plots, that you do not intend to update
'image': Try to represent the plot as an image
:param draw_now: Draw the plot now (you may choose false if you're going to add another plot immediately after and
don't want have to draw this one again.
:param hang: Hang on the plot (wait for it to be closed before continuing)
:param title: Title of the plot (will default to name if not included)
:param fig: Name of the figure - use this when you want to create multiple figures.
"""
if isinstance(fig, plt.Figure):
assert None not in _DBPLOT_FIGURES, "If you pass a figure, you can only do it on the first call to dbplot (for now)"
_DBPLOT_FIGURES[None] = fig
fig = None
elif fig not in _DBPLOT_FIGURES:
_DBPLOT_FIGURES[fig] = _PlotWindow(figure=_make_dbplot_figure(),
subplots=OrderedDict())
if name is not None:
_DBPLOT_FIGURES[fig].figure.canvas.set_window_title(fig)
suplot_dict = _DBPLOT_FIGURES[fig].subplots
if name not in suplot_dict:
if plot_constructor is not None:
print "Warning: The 'plot_constructor' argument to dbplot is deprecated. Use plot_type instead"
assert plot_type is None
plot_type = plot_constructor
if isinstance(plot_type, str):
plot = {
'line':
LinePlot,
'pos_line':
lambda: LinePlot(y_bounds=(0, None), y_bound_extend=(0, 0.05)),
# 'pos_line': lambda: LinePlot(y_bounds=(0, None)),
'img':
ImagePlot,
'colour':
lambda: ImagePlot(is_colour_data=True),
'equal_aspect':
lambda: ImagePlot(aspect='equal'),
'image_history':
lambda: MovingImagePlot(),
'pic':
lambda: ImagePlot(show_clims=False, aspect='equal'),
'notice':
lambda: TextPlot(max_history=1,
horizontal_alignment='center',
vertical_alignment='center',
size='x-large'),
'cost':
lambda: MovingPointPlot(y_bounds=(0, None),
y_bound_extend=(0, 0.05)),
'percent':
lambda: MovingPointPlot(y_bounds=(0, 100)),
'trajectory':
lambda: Moving2DPointPlot(),
'histogram':
lambda: HistogramPlot(edges=np.linspace(-5, 5, 20)),
'cumhist':
lambda: CumulativeLineHistogram(edges=np.linspace(-5, 5, 20)),
}[plot_type]()
elif plot_type is None:
plot = get_plot_from_data(data, mode=plot_mode)
else:
assert hasattr(plot_type, "__call__")
plot = plot_type()
_extend_subplots(
fig=fig, subplot_name=name,
plot_object=plot) # This guarantees that the new plot will exist
if xlabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_xlabel(xlabel)
if ylabel is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_ylabel(ylabel)
if draw_every is not None:
_draw_counters[fig, name] = -1
# Update the relevant data and plot it. TODO: Add option for plotting update interval
plot = _DBPLOT_FIGURES[fig].subplots[name].plot_object
plot.update(data)
plot.plot()
if title is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.set_title(title)
if legend is not None:
_DBPLOT_FIGURES[fig].subplots[name].axis.legend(legend)
if draw_now and not _hold_plots:
if draw_every is not None:
_draw_counters[fig, name] += 1
if _draw_counters[fig, name] % draw_every != 0:
return _DBPLOT_FIGURES[fig].subplots[name].axis
if hang:
plt.figure(_DBPLOT_FIGURES[fig].figure.number)
plt.show()
else:
redraw_figure(_DBPLOT_FIGURES[fig].figure)
return _DBPLOT_FIGURES[fig].subplots[name].axis
