title: "Patterns 'stripe', 'wave', 'crosshatch', 'weave' - Parameters and Examples"

output:

rmarkdown::html_vignette:

toc: true

vignette: >

```{r, include = FALSE}

```{r setup}

* The 'stripe' pattern draws a set of (horizontal) **straight** lines.

* The 'wave' pattern draws a set of (horizontal) **wavy** lines.

* The 'crosshatch' pattern draws a set of vertical lines on top of a set of horizontal lines.

* The 'weave' pattern draws a set of vertical lines interlaced with a set of horizontal lines.

* For more info on these patterns see their `{gridpattern}` documentation:

* [`help("grid.pattern_stripe", package = "gridpattern")`](https://trevorldavis.com/R/gridpattern/dev/reference/grid.pattern_stripe.html)

* [`help("grid.pattern_wave", package = "gridpattern")`](https://trevorldavis.com/R/gridpattern/dev/reference/grid.pattern_wave.html)

* [`help("grid.pattern_crosshatch", package = "gridpattern")`](https://trevorldavis.com/R/gridpattern/dev/reference/grid.pattern_crosshatch.html)

* [`help("grid.pattern_weave", package = "gridpattern")`](https://trevorldavis.com/R/gridpattern/dev/reference/grid.pattern_weave.html)

| aesthetic | description | default | possible values |

|--------------------------|-----------------------------------------------|-----------|-----------------------------------|

| pattern\_colour | Stroke colour | 'grey20' | colour |

| pattern\_fill | Fill colour | 'grey80' | colour |

| pattern\_angle | Rotation angle | 30 | angle in degrees |

| pattern\_density | Approx. fraction of area the pattern fills | 0.2 | value in range [0, 1] (fraction) |

| pattern\_spacing | Spacing between repetitions of pattern | 0.05 | value in `pattern_units` grid units |

| pattern\_xoffset | Shift pattern along x axis | 0 | value in `pattern_units` grid units |

| pattern\_yoffset | Shift pattern along y axis | 0 | value in `pattern_units` grid units |

| pattern\_units | Pattern grid unit | 'snpc' | `grid::unit()` unit i.e. 'snpc', 'cm', and 'inches' |

| pattern\_alpha | Alpha | NA | value in range [0, 1] or NA |

| pattern\_linetype | Stroke linetype | 1 | linetype |

| pattern\_size | Stroke linewidth | 1 | linewidth |

| pattern\_type | Pattern type | NA | See [wave](https://trevorldavis.com/R/gridpattern/dev/reference/grid.pattern\_wave.html) and [weave](https://trevorldavis.com/R/gridpattern/dev/reference/pattern\_weave.html) pattern documentation |

| pattern\_subtype | Pattern subtype | NA | See [weave](https://trevorldavis.com/R/gridpattern/dev/reference/pattern\_weave.html) pattern documentation |

| pattern\_frequency | Frequency | 0.1 | Frequency of waves in 'wave' pattern |

There are also a number of parameters for extra control of legend sizing and

aspect ratio adjustments. See the 'Pattern Parameters - Common' for more

information.

Standard data for all the example plots

```{r vanilla, fig.cap="", fig.alt="A plot using vanilla ggplot2"}

* Use `ggpattern::geom_col_pattern()` instead of `ggplot2::geom_col()`.

* Set `pattern = 'stripe'`

* Default legends in `ggplot2` are usually too small to show off an example of

the pattern, so it will usually be necessary to increase the key size.

```{r ggpattern, fig.cap="", fig.alt="A plot using ggpattern with a patterned geom"}

* Often we'll want to mix patterns.

To get the legend right we'll often want to set them with a pattern scale function

like 'pattern_scale_manual()' instead of simply setting them with the 'pattern' aesthetic.

* Here we'll use the 'stripe' pattern and 'wave' pattern.

* The 'wave' pattern supports two subtypes: 'triangle' waves (default) have a zig-zag appearance

whereas 'sine' waves have a curvy appearance.

```{r mixing, fig.cap="", fig.alt="A plot with both a 'stripe' pattern and a 'wave' pattern."}

The aesthetic `pattern_density` roughly corresponds to the fraction of the filled

area which should be covered by the pattern.

In the following plot the density of striping is increased to 50% of the fill area.

```{r density, fig.cap="", fig.alt="A plot with the density of striping increased to 50% of fill area"}

The 'weave' pattern supports a rich set of weave types and subtypes including irregular 'matt', 'twill' (including 'herringbone' and 'zigzag' variations), and 'satin' weaves . See the [weave](https://trevorldavis.com/R/gridpattern/dev/reference/pattern_weave.html) pattern documentation for more information.

```{r weave, fig.cap="", fig.alt="A plot with 'plain', 'twill', 'satin' weave patterns"}

```{r density2, fig.cap="", fig.alt="Example plot from using the density aesthetic as a mapped aesthetic."}

`scale_pattern_density_manual()` can be used to manually control how the variable

is mapped to the density.

```{r density3, fig.cap="", fig.alt="Example plot from using the density aesthetic as a mapped aesthetic with manual scale."}

```{r spacing, fig.cap="", fig.alt="Example plot from using the spacing aesthetic as a mapped aesthetic."}

```{r fill, fig.cap="", fig.alt="Example plot from using the fill aesthetic as a mapped aesthetic."}