evomap.printer
Contents
evomap.printer
#
Functions to draw maps.
Module Contents#
Functions#
|
|
|
Set default aesthetic styles here. |
|
Style the axes of a map. |
|
|
|
Draw a shepard diagram of input dissimilarities vs map distances. |
|
Draw a sequence of static maps next to each other. Can use the same |
|
Fit an attribute to the map and display the resultant vector. |
|
Fit multiple attributes and display their vectors in the map. |
|
|
|
Draw the trajectories of selected objects. |
Attributes#
- evomap.printer.DEFAULT_BUBBLE_SIZE = 25#
- evomap.printer.DEFAULT_FONT_SIZE = 10#
- evomap.printer.title_fontdict_large#
- evomap.printer.title_fontdict#
- evomap.printer.text_fontdict#
- evomap.printer.axis_label_fontdict#
- evomap.printer.style_axes(ax, show_axes, show_box, show_grid, axes_at_origin)[source]#
Style the axes of a map.
- evomap.printer.draw_map(X, label=None, color=None, size=None, inclusions=None, zoom_on_cluster=None, highlighted_labels=None, show_box=True, show_grid=False, show_axes=False, axes_at_origin=False, show_legend=False, cmap=None, filename=None, ax=None, fig_size=None, title=None, rotate_labels=0, scatter_kws={}, fontdict=None, rcparams=None)[source]#
- evomap.printer.draw_shepard_diagram(X, D, ax=None, show_grid=False, show_rank_correlation=True)[source]#
Draw a shepard diagram of input dissimilarities vs map distances.
- Parameters
X (np.ndarray of shape (n_samples, n_dims)) – configuration of objects on the map
D (np.ndarray of shape (n_samples, n_samples)) – Dissimilarity matrix
ax (Axes, optional) – Axes to draw the shepard diagram on, by default None
show_grid (bool, optional) – If true, grid lines will be drawn, by default False
show_rank_correlation (bool, optional) – If true, the Spearman rank correlation coefficient will be displayed below the plot, by default True
- evomap.printer.draw_map_sequence(X_t, color_t=None, incl_t=None, n_cols=4, time_labels=[], show_axes=False, **kwargs)[source]#
Draw a sequence of static maps next to each other. Can use the same arguments as the ‘draw_map’ function as dictionary.
- Parameters
Y_ts (list of ndarrays, each of shape (n_samples, d)) – Sequence of map coordinates.
c_ts (list of ndarray, each of shape (n_samples,), optional) – Sequence of cluster assignments used for coloring (int), by default None If the cluster assignments are constant, one can simply provide a single array as kwarg.
n_cols (int, optional) – Max. number of maps shown in one row, by default 4
map_kws (dict, optional) – Additional arguments for the ‘draw_map’ function, by default None
time_labels (list of str, optional) – When given, use these labels as title strings
- evomap.printer.fit_attribute(coords, attribute_label, attribute_values, map)[source]#
Fit an attribute to the map and display the resultant vector.
To do so, regress the attribute value on map coordinates and use the coefficients as arrow coordinates.
- Parameters
coords (ndarray of shape (n_samples, n_dims)) – Map coordinates.
attribute_label (string) – Attribute label (displayed next to vector).
attribute_values (ndarray of shape (n_samples,)) – Attribute values for each sample.
map (matplotlib.figure) – Figure containing the map (i.e., output of draw_map function)
- Returns
Figure containing the map with property vector added.
- Return type
matplotlib.figure
- evomap.printer.fit_attributes(map_coords, df_attributes, map)[source]#
Fit multiple attributes and display their vectors in the map.
- Parameters
map_coords (ndarray of shape (n_samples, n_dims)) – Map coordinates.
df_attributes (pd.DataFrame) – Dataframe containing the attributes. Each column is expected to correspond to one attribute. Make sure to label colums and that the number of rows equals n_samples.
map (matplotlib.figure) – Figure containing the map (i.e., output of draw_map function)
- Returns
Figure containing the map with property vectors added.
- Return type
matplotlib.figure
- evomap.printer.draw_dynamic_map(X_t, color_t=None, size_t=None, incl_t=None, show_arrows=False, show_last_positions_only=False, time_labels=None, transparency_start=0.1, transparency_end=0.4, transparency_final=1.0, **kwargs)[source]#
- evomap.printer.draw_trajectories(Y_ts, labels, selected_labels=None, title=None, show_axes=False, show_box=True, show_grid=False, axes_at_origin=False, annotate_periods=True, period_labels=None, ax=None, fig_size=None)[source]#
Draw the trajectories of selected objects.
- Parameters
Y_ts (list of ndarrays, each of shape (n_samples, d)) – Sequence of map coordinates.
labels (ndarray of shape (n_samples,)) – Object labels (str)
selected_labels (ndarray of shape (n_selected,), optional) – Selected object labels (str), by default None
title (str, optional) – Figure title, by default None
annotate_periods (bool, optional) – If true, labels for each period are shown next to each pair of map coordinates, by default True
period_labels (ndarray of shape (n_periods,), optional) – Period labels (str), by default None
ax (matplotlib.axes.Axes, optional) – Pre-existing axes for the plot, by default None
figsize (tuple, optional) – Figure size, by default (12,12)