autogalaxy.plot.Figure#

class Figure[source]#

Bases: AbstractMatWrap

An abstract base class for wrapping matplotlib plotting methods.

Classes are used to wrap matplotlib so that the data structures in the autoarray.structures package can be plotted in standardized withs. This exploits how these structures have specific formats, units, properties etc. This allows us to make a simple API for plotting structures, for example to plot an Array2D structure:

import autoarray as aa import autoarray.plot as aplt

arr = aa.Array2D.no_mask(values=[[1.0, 1.0], [2.0, 2.0]], pixel_scales=2.0) aplt.Array2D(values=arr)

The wrapped Mat objects make it simple to customize how matplotlib visualizes this data structure, for example we can customize the figure size and colormap using the Figure and Cmap objects.

figure = aplt.Figure(figsize=(7,7), aspect=”square”) cmap = aplt.Cmap(cmap=”jet”, vmin=1.0, vmax=2.0)

plotter = aplt.MatPlot2D(figure=figure, cmap=cmap)

aplt.Array2D(values=arr, plotter=plotter)

The Plotter object is detailed in the autoarray.plot.plotter package.

The matplotlib wrapper objects in ths module also use configuration files to choose their default settings. For example, in autoarray.config.visualize.mat_base.Figure.ini you will note the section:

figure: figsize=(7, 7)

subplot: figsize=auto

This specifies that when a data structure (like the Array2D above) is plotted, the figsize will always be (7,7) when a single figure is plotted and it will be chosen automatically if a subplot is plotted. This allows one to customize the matplotlib settings of every plot in a project.

Methods

aspect_for_subplot_from

aspect_from

Returns the aspect ratio of the figure from the 2D shape of a data structure.

close

Wraps the Matplotlib method 'plt.close' for closing a figure.

open

Wraps the Matplotlib method 'plt.figure' for opening a figure.

vmax_from

The vmax of a plot, for example the maximum value of the colormap and colorbar.

vmin_from

The vmin of a plot, for example the minimum value of the colormap and colorbar.

Attributes

config_category

config_dict

Creates a config dict of valid inputs of the method plt.figure from the object's config_dict.

config_folder

log10_max_value

log10_min_value

property config_dict#

Creates a config dict of valid inputs of the method plt.figure from the object’s config_dict.

aspect_from(shape_native)[source]#

Returns the aspect ratio of the figure from the 2D shape of a data structure.

This is used to ensure that rectangular arrays are plotted as square figures on sub-plots.

Parameters:

shape_native (Tuple[int, int]) – The two dimensional shape of an Array2D that is to be plotted.

Return type:

Union[float, str]

open()[source]#

Wraps the Matplotlib method ‘plt.figure’ for opening a figure.

close()[source]#

Wraps the Matplotlib method ‘plt.close’ for closing a figure.