`cowpatch.base_elements`

Module Contents

Classes

patch

fundamental object of cowpatch, encapsulates plot objects and

class cowpatch.base_elements.patch(*args, grobs=None)[source]

fundamental object of cowpatch, encapsulates plot objects and can be told how to present them

Parameters

*args (plot objects and patches) – all non-named parameters are expected to be plot objects or lower-level cow.patch objects.
grobs (list) – list of plot objects and patches. Either \*args is empty or grobs is None.

Notes

Guiding arangement:

In combination with cow.layout one can define arrangement of plots and lower-level arangements.

For example,

>>> vis_obj = cow.patch(g1,g2,g3)
>>> vis_obj += cow.layout(design = np.array([[0,1],
...                                          [2,2]]))
>>> vis_obj.show()

See the Layout guide for more detailed examples of functionality.

Nesting:

One can nest cow.patch objects within other cow.patch objects. For example,

>>> vis_obj2 = cow.patch(g4, vis_obj)
>>> vis_obj2 += cow.layout(nrow = 1)
>>> vis_obj2.show()

Examples

>>> # Necessary libraries for example
>>> import numpy as np
>>> import cowpatch as cow
>>> import plotnine as p9
>>> import plotnine.data as p9_data

>>> g0 = p9.ggplot(p9_data.mpg) +\
...     p9.geom_bar(p9.aes(x="hwy")) +\
...     p9.labs(title = 'Plot 0')
>>> g1 = p9.ggplot(p9_data.mpg) +\
...     p9.geom_point(p9.aes(x="hwy", y = "displ")) +\
...     p9.labs(title = 'Plot 1')
>>> g2 = p9.ggplot(p9_data.mpg) +\
...     p9.geom_point(p9.aes(x="hwy", y = "displ", color="class")) +\
...     p9.labs(title = 'Plot 2')
>>> g3 = p9.ggplot(p9_data.mpg[p9_data.mpg["class"].isin(["compact",
...                                                      "suv",
...                                                      "pickup"])]) +\
...     p9.geom_histogram(p9.aes(x="hwy"),bins=10) +\
...     p9.facet_wrap("class")

>>> # Basic example:
>>> vis_obj = cow.patch(g0,g1,g2)
>>> vis_obj += cow.layout(design = np.array([[0,1],
...                                          [2,2]]))
>>> vis_obj.show()

>>> # Nesting example:
>>> vis_obj2 = cow.patch(g3, vis_obj)
>>> vis_obj2 += cow.layout(nrow = 1)
>>> vis_obj2.show()

cowpatch.base_elements

Module Contents

Classes

`cowpatch.base_elements`