Core API

The core module contains the fundamental classes for creating ggplot-style visualizations.

ggplot

class ggviews.core.ggplot(data=None, mapping=None)

Bases: object

Main ggplot class for creating grammar of graphics plots

This is the entry point for all ggplot-style visualizations. Use method chaining to build up your plot layer by layer.

Parameters:

• data – pandas DataFrame containing the data to plot

• mapping – aes object defining default aesthetic mappings

Example

ggplot(df, aes(x=’x’, y=’y’)).geom_point()

__add__(other)

Add layers, themes, scales etc using + operator

coord_equal(**kwargs)

Apply equal aspect ratio coordinate system

coord_fixed(ratio=1, **kwargs)

Apply fixed aspect ratio coordinate system

coord_flip(**kwargs)

Apply coordinate flip

coord_trans(x='identity', y='identity', **kwargs)

Apply coordinate transformation

facet_grid(facets, **kwargs)

Apply facet grid

facet_wrap(facets, **kwargs)

Apply facet wrap

geom_area(mapping=None, **kwargs)

Add area plot to the plot

geom_bar(mapping=None, **kwargs)

Add bars to the plot

geom_boxplot(mapping=None, **kwargs)

Add box plots to the plot

geom_density(mapping=None, **kwargs)

Add density plots to the plot

geom_errorbar(mapping=None, **kwargs)

Add error bars to the plot

geom_histogram(mapping=None, **kwargs)

Add histogram to the plot

geom_label(mapping=None, **kwargs)

Add text labels with background to the plot

geom_line(mapping=None, **kwargs)

Add lines to the plot

geom_map(mapping=None, **kwargs)

Add geographic map to the plot

geom_point(mapping=None, **kwargs)

Add points to the plot

geom_raster(mapping=None, **kwargs)

Add raster/image tiles to the plot

geom_ribbon(mapping=None, **kwargs)

Add ribbon plot to the plot

geom_smooth(mapping=None, **kwargs)

Add smoothed line to the plot

geom_text(mapping=None, **kwargs)

Add text annotations to the plot

geom_tile(mapping=None, **kwargs)

Add rectangular tiles to the plot

geom_violin(mapping=None, **kwargs)

Add violin plot to the plot

labs(title=None, x=None, y=None, **kwargs)

Add labels to the plot

scale_color_brewer(**kwargs)

Add ColorBrewer color scale (American spelling)

scale_color_continuous(**kwargs)

Apply continuous color scale

scale_color_discrete(**kwargs)

Apply discrete color scale

scale_color_manual(**kwargs)

Apply manual color scale

scale_color_viridis_c(**kwargs)

Apply continuous viridis color scale (American spelling)

scale_color_viridis_d(**kwargs)

Apply discrete viridis color scale (American spelling)

scale_colour_brewer(**kwargs)

Add ColorBrewer color scale

scale_colour_fill_viridis_d(**kwargs)

Apply discrete viridis fill scale (British spelling)

scale_colour_viridis_c(**kwargs)

Apply continuous viridis color scale

scale_colour_viridis_d(**kwargs)

Apply discrete viridis color scale

scale_fill_brewer(**kwargs)

Add ColorBrewer fill scale

scale_fill_viridis_c(**kwargs)

Apply continuous viridis fill scale

scale_fill_viridis_d(**kwargs)

Apply discrete viridis fill scale

show()

Display the plot

theme(**kwargs)

Apply advanced theme with element-level control

theme_bw(**kwargs)

Apply black and white theme

theme_classic(**kwargs)

Apply classic theme

theme_dark(**kwargs)

Apply dark theme

theme_minimal(**kwargs)

Apply minimal theme

xlim(*args)

Set x-axis limits

ylim(*args)

Set y-axis limits

aes (Aesthetics)

class ggviews.core.aes(x=None, y=None, color=None, colour=None, size=None, alpha=None, shape=None, fill=None, linetype=None, **kwargs)

Bases: object

Aesthetic mappings for ggplot

Maps data variables to visual properties like x, y, color, size, etc.

Parameters:

• x – Variable for x-axis

• y – Variable for y-axis

• color – Variable for color mapping

• colour – Alias for color (British spelling)

• size – Variable for size mapping

• alpha – Variable for alpha/transparency mapping

• shape – Variable for shape mapping

• fill – Variable for fill color mapping

• linetype – Variable for line type mapping

• **kwargs – Additional aesthetic mappings

Utility Functions

Utility functions for ggviews

This module contains helper functions and utilities used throughout ggviews.

class ggviews.utils.UtilityLayer(**kwargs)

Bases: object

Base class for utility layers like labs, xlim, ylim

ggviews.utils.c(*args)

Combine values into a list (R-style c() function)

Parameters:

*args – Values to combine

Returns:

Combined values

Return type:

list

Example

c(1, 2, 3) # Returns [1, 2, 3] c(‘a’, ‘b’, ‘c’) # Returns [‘a’, ‘b’, ‘c’]

class ggviews.utils.coord_flip

Bases: UtilityLayer

Flip the coordinate system

Swaps the x and y axes. Useful for creating horizontal bar charts from vertical ones.

Example

ggplot(df, aes(x=’category’, y=’value’)).geom_bar() + coord_flip()

ggviews.utils.cut(x, breaks, labels=None)

Cut continuous variable into discrete bins

Parameters:

• x – Continuous values to cut

• breaks – Break points or number of breaks

• labels – Labels for the bins

Returns:

Binned values

Return type:

pandas.Categorical

Example

cut(df[‘age’], breaks=5) cut(df[‘score’], breaks=[0, 50, 80, 100], labels=[‘Low’, ‘Medium’, ‘High’])

ggviews.utils.expand_limits(**kwargs)

Expand the plot limits to include additional values

Parameters:

• x – Expand x-axis to include these values

• y – Expand y-axis to include these values

• **kwargs – Additional limits to expand

Example

expand_limits(x=0, y=c(0, 100))

ggviews.utils.guide_colorbar(title=None, **kwargs)

Create a colorbar guide

Parameters:

• title – Colorbar title

• **kwargs – Additional colorbar parameters

Example

guides(color=guide_colorbar(title=’Value’))

ggviews.utils.guide_legend(title=None, **kwargs)

Create a legend guide

Parameters:

• title – Legend title

• **kwargs – Additional legend parameters

Example

guides(color=guide_legend(title=’Species’))

ggviews.utils.guides(**kwargs)

Control legend guides

Parameters:

• color – Control color legend (‘legend’, ‘colorbar’, None)

• colour – Alias for color

• fill – Control fill legend

• size – Control size legend

• alpha – Control alpha legend

• **kwargs – Additional guide specifications

Example

guides(color=’none’) # Remove color legend guides(fill=guide_legend(title=’Species’))

class ggviews.utils.labs(title=None, subtitle=None, caption=None, x=None, y=None, color=None, colour=None, fill=None, size=None, alpha=None, **kwargs)

Bases: UtilityLayer

Add labels to plots

Sets axis labels, plot title, subtitle, and caption.

Parameters:

• title – Plot title

• subtitle – Plot subtitle

• caption – Plot caption

• x – X-axis label

• y – Y-axis label

• color – Legend title for color aesthetic

• colour – Alias for color (British spelling)

• fill – Legend title for fill aesthetic

• size – Legend title for size aesthetic

• alpha – Legend title for alpha aesthetic

• **kwargs – Additional label mappings

Example

labs(title=”My Plot”, x=”Height”, y=”Weight”, color=”Species”)

ggviews.utils.rep(x, times)

Repeat elements

Parameters:

• x – Value or list to repeat

• times – Number of times to repeat

Returns:

Repeated values

Return type:

list

Example

rep(‘a’, 3) # [‘a’, ‘a’, ‘a’] rep([1, 2], 2) # [1, 2, 1, 2]

ggviews.utils.seq(start, stop, step=1)

Generate a sequence of numbers

Parameters:

• start – Starting value

• stop – Ending value (inclusive)

• step – Step size

Returns:

Sequence of numbers

Return type:

list

Example

seq(1, 10) # [1, 2, 3, …, 10] seq(0, 1, 0.1) # [0, 0.1, 0.2, …, 1.0]

class ggviews.utils.xlim(*args)

Bases: UtilityLayer

Set x-axis limits

Parameters:

*args – Either (min, max) or a single list/tuple of (min, max)

Examples

xlim(0, 100) xlim([0, 100]) xlim((0, 100))

class ggviews.utils.ylim(*args)

Bases: UtilityLayer

Set y-axis limits

Parameters:

*args – Either (min, max) or a single list/tuple of (min, max)

Examples

ylim(0, 100) ylim([0, 100]) ylim((0, 100))