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
Figureobjects are displayed.Warning
The
MultiFigureis deprecated in favor of theSmartFigure.- 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
4to12and typical height is3to8. Default depends on thefigure_styleconfiguration.- 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
Figureto aMultiFigure.copy()Returns a deep copy of the
MultiFigureobject.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
Figureobjects in a grid configuration.from_row(figures[, size, title, ...])Creates a MultiFigure with the specified
Figureobjects in a horizontal configuration.from_stack(figures[, size, title, ...])Creates a MultiFigure with the specified
Figureobjects in a vertical configuration.save(file_name[, general_legend, ...])Saves the
MultiFigureto 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.