Plot aesthetics

Gurita tries to use sensible default values for parameters that control the appearance of output plots. However, these can be overridden by optional command line arguments.

Each plot command accepts a -h/--help argument that will cause Gurita to display more information about how to control the visual appearance of the output.

Arguments

Argument	Description	Reference
`--width`	width of the plot in cm	width
`--height`	height of the plot in cm	height
`--title`	plot title	title
`--xlabel`	X axis label	X axis label
`--ylabel`	Y axis label	Y axis label
`--plotstyle {darkgrid,whitegrid,dark,white,ticks}`	Change the aesthetic style of the plot	plot style
`--context {paper,notebook,talk,poster}`	Change the aesthetic context of the plot	plot context
`--nolegend`	Do not display a plot legend	no legend
`--nxtl` `--noxticklabels`	Turn off Y axis tick labels	no X axis tick labels
`--nytl` `--noyticklabels`	Turn off X axis tick labels	no Y axis tick labels
`--rxtl` `--rotxticklabels`	Rotate tick labels on the X axis by angle	rotate X tick labels
`--rytl` `--rotyticklabels`	Rotate tick labels on the Y axis by angle	rotate Y tick labels

Width

Set the width of the plot in cm. By default plots are 20cm wide.

--width SIZE

Example:

gurita box --width 40 ...

Height

Set the height of the plot in cm. By default plots are 20cm high.

--height SIZE

Example:

gurita box --height 10 ...

Title

Set the title text of the plot. By default plots do not have a title text.

--title TEXT

Example:

gurita box --title "An example plot title" ...

X axis label

Set the label of the X axis. The default X axis label depends on the type of plot. In many cases it is derived from the input data.

--xlabel STR

Example:

gurita box --xlabel "An example X axis label" ...

Y axis label

Set the label of the Y axis. The default Y axis label depends on the type of plot. In many cases it is derived from the input data.

--ylabel STR

Example:

gurita box --ylabel "An example Y axis label" ...

Style

Set the visual style of the plot. By default the darkgrid style is used.

--plotstyle {darkgrid,whitegrid,dark,white,ticks}

Example:

gurita box --plotstyle whitegrid ...

Context

Set the visual context for the plot. By default the notebook context is used.

Contexts are a convenient way to adjust various visualisation parameters to suit different common scenarios where plots are displayed. For example, the poster context will use larger text sizes for labels for easier reading at a distance.

--context {paper,notebook,talk,poster}

Example:

gurita box --context poster ...

No legend

Many plots display a legend either on top of the plot or next to the plot. This argument turns the legend off so it won’t be displayed.

--nolegend

Example:

gurita box --nolegend ...

Turn off X axis tick labels

By default the X axis will show data labels next to axis tick marks (note that not all plots have tick marks). This arugment turns off tick labels so that they won’t be displayed.

--nxtl, --noxticklabels

Example:

gurita box --noxticklabels ...

Turn off Y axis tick labels

By default the Y axis will show data labels next to axis tick marks (note that not all plots have tick marks). This arugment turns off tick labels so that they won’t be displayed.

--nytl, --noyticklabels

Example:

gurita box --noyticklabels ...

Rotate tick labels on the X axis

Adjust the angle in degrees that tick labels are displayed on the X axis (note that not all plots have tick labales). This can be useful when the default tick labels overlap each other.

--rxtl, --rotxticklabels

Example:

gurita box --rotxticklabels 90 ...

Rotate tick labels on the Y axis

Adjust the angle in degrees that tick labels are displayed on the X axis (note that not all plots have tick labales). This can be useful when the default tick labels overlap each other.

--rytl, --rotyticklabels

Example:

gurita box --rotyticklabels 90 ...