graphinglib.MultiFigure#

class graphinglib.MultiFigure(**kwargs)[source]#

This class implements the “canvas” on which multiple plots are displayed.

The canvas consists of a grid of a specified size on which the Figure objects are displayed.

Warning

The MultiFigure is deprecated in favor of the SmartFigure.

Parameters:
num_rows, num_colsint

Number of rows and columns for the grid. These parameters determine the the number of “squares” on which a plot can be placed.

Note

Note that a single plot can span multiple squares. See add_SubFigure().

sizetuple[float, float]

Overall size of the multifigure. Figure size is in inches; typical width is 4 to 12 and typical height is 3 to 8. Default depends on the figure_style configuration.

titlestr, optional

General title of the figure.

reference_labelsbool

Whether or not to add reference labels to the SubFigures. Defaults to True.

Note

The reference labels are in the form of “a)”, “b)”, etc. and are used to refer to a particular SubFigure in a caption accompanying the MultiFigure.

reflabel_locstr

Location of the reference labels of the SubFigures. Values are "inside" and "outside". Defaults to "outside".

figure_stylestr

The figure style to use for the figure. Default can be set using gl.set_default_style().

Methods

__init__(num_rows, num_cols[, size, title, ...])

This class implements the "canvas" on which multiple plots are displayed.

add_figure(figure, row_start, col_start, ...)

Adds a Figure to a MultiFigure.

copy()

Returns a deep copy of the MultiFigure object.

copy_with(**kwargs)

Returns a deep copy of the MultiFigure with specified attributes overridden.

from_grid(figures, dimensions[, size, ...])

Creates a MultiFigure with the specified Figure objects in a grid configuration.

from_row(figures[, size, title, ...])

Creates a MultiFigure with the specified Figure objects in a horizontal configuration.

from_stack(figures[, size, title, ...])

Creates a MultiFigure with the specified Figure objects in a vertical configuration.

save(file_name[, general_legend, ...])

Saves the MultiFigure to a file.

set_rc_params([rc_params_dict, reset])

Customize the visual style of the MultiFigure.

set_visual_params([reset, ...])

Customize the visual style of the Figure.

show([general_legend, legend_loc, legend_cols])

Displays the MultiFigure.