# plot_gaussian_ellipses¶

menpo.visualize.plot_gaussian_ellipses(covariances, means, n_std=2, render_colour_bar=True, colour_bar_label='Normalized Standard Deviation', colour_map='jet', figure_id=None, new_figure=False, image_view=True, line_colour='r', line_style='-', line_width=1.0, render_markers=True, marker_edge_colour='k', marker_face_colour='k', marker_edge_width=1.0, marker_size=5, marker_style='o', render_axes=False, axes_font_name='sans-serif', axes_font_size=10, axes_font_style='normal', axes_font_weight='normal', crop_proportion=0.1, figure_size=(7, 7))[source]

Method that renders the Gaussian ellipses that correspond to a set of covariance matrices and mean vectors. Naturally, this only works for 2-dimensional random variables.

Parameters: covariances (list of (2, 2) ndarray) – The covariance matrices that correspond to each ellipse. means (list of (2, ) ndarray) – The mean vectors that correspond to each ellipse. n_std (float, optional) – This defines the size of the ellipses in terms of number of standard deviations. render_colour_bar (bool, optional) – If True, then the ellipses will be coloured based on their normalized standard deviations and a colour bar will also appear on the side. If False, then all the ellipses will have the same colour. colour_bar_label (str, optional) – The title of the colour bar. It only applies if render_colour_bar is True. colour_map (str, optional) – A valid Matplotlib colour map. For more info, please refer to matplotlib.cm. figure_id (object, optional) – The id of the figure to be used. new_figure (bool, optional) – If True, a new figure is created. image_view (bool, optional) – If True the ellipses will be rendered in the image coordinates system. line_colour (See Below, optional) – The colour of the lines of the ellipses. Example options: {r, g, b, c, m, k, w} or (3, ) ndarray  line_style ({-, --, -., :}, optional) – The style of the lines of the ellipses. line_width (float, optional) – The width of the lines of the ellipses. render_markers (bool, optional) – If True, the centers of the ellipses will be rendered. marker_style (See Below, optional) – The style of the centers of the ellipses. Example options {., ,, o, v, ^, <, >, +, x, D, d, s, p, *, h, H, 1, 2, 3, 4, 8}  marker_size (int, optional) – The size of the centers of the ellipses in points. marker_face_colour (See Below, optional) – The face (filling) colour of the centers of the ellipses. Example options {r, g, b, c, m, k, w} or (3, ) ndarray  marker_edge_colour (See Below, optional) – The edge colour of the centers of the ellipses. Example options {r, g, b, c, m, k, w} or (3, ) ndarray  marker_edge_width (float, optional) – The edge width of the centers of the ellipses. render_axes (bool, optional) – If True, the axes will be rendered. axes_font_name (See Below, optional) – The font of the axes. Example options {serif, sans-serif, cursive, fantasy, monospace}  axes_font_size (int, optional) – The font size of the axes. axes_font_style ({normal, italic, oblique}, optional) – The font style of the axes. axes_font_weight (See Below, optional) – The font weight of the axes. Example options {ultralight, light, normal, regular, book, medium, roman, semibold,demibold, demi, bold, heavy, extra bold, black}  crop_proportion (float, optional) – The proportion to be left around the centers’ pointcloud. figure_size ((float, float) tuple or None optional) – The size of the figure in inches.