Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/osthomas/ggtikz
ggtikz: Add TikZ annotations with absolute data or relative plot coordinates to ggplots
https://github.com/osthomas/ggtikz
Last synced: 3 days ago
JSON representation
ggtikz: Add TikZ annotations with absolute data or relative plot coordinates to ggplots
- Host: GitHub
- URL: https://github.com/osthomas/ggtikz
- Owner: osthomas
- License: other
- Created: 2021-08-15T14:13:33.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-15T10:29:06.000Z (5 months ago)
- Last Synced: 2024-08-03T23:24:04.685Z (3 months ago)
- Language: R
- Size: 1.02 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
# Process .pdf generated by tikzDevice to .png
pdf2png <- function(path, options) {
if (!grepl(".pdf$", path)) return(path)
outpath <- gsub(".pdf", ".png", path)
texpath <- gsub(".pdf", ".tex", path)
img <- magick::image_read(path, density=300)
magick::image_write(img, outpath, format="png")
unlink(path)
unlink(texpath)
return(outpath)
}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
fig.width = 3,
fig.height = 3,
fig.show = "hold",
out.width="50%",
dev = "tikz",
external = TRUE,
fig.process = pdf2png
)
library(tikzDevice)
library(ggplot2)
library(ggtikz)
options(tikzLatexPackages = c(getOption("tikzLatexPackages"), "\\usetikzlibrary{calc}"))
```
# ggtikz
[](https://CRAN.R-project.org/package=ggtikz)
[](https://app.codecov.io/gh/osthomas/ggtikz)
[](https://github.com/osthomas/ggtikz/actions)
ggtikz allows you to annotate plots created using
[ggplot2](https://ggplot2.tidyverse.org/)
with arbitrary TikZ code when rendering
them with the [tikzDevice](https://CRAN.R-project.org/package=tikzDevice).
The annotations can be made using data coordinates, or with coordinates relative
to a specified panel or the whole plot.
Plots with multiple panels (via `facet_grid()` or `facet_wrap()`) are supported.
For a few examples, see the [examples vignette](https://github.com/osthomas/ggtikz/blob/devel/doc/examples.pdf).
## Installation
You can install the latest ggtikz release from CRAN with:
``` {r, eval = FALSE}
install.packages("ggtikz")
```
Or get the development version from GitHub:
``` {r, eval = FALSE}
# install.packages("devtools")
devtools::install_github("osthomas/ggtikz", ref = "devel")
```
## Basic Usage
1. Create a ggplot.
2. Add annotations with `ggtikz()`.
```{r basic-usage}
library(ggplot2)
library(ggtikz)
p <- ggplot(mtcars, aes(disp, mpg)) + geom_point() # 1.
## tikz("plot.tikz")
ggtikz(p,
"\\fill[red] (0.5,0.5) circle (5mm);",
xy = "panel", panelx = 1, panely = 1)
## dev.off()
## Render with LaTeX ...
```
## Advanced Usage
1. Create a ggplot.
2. Create a ggtikz canvas from the plot with `ggtikzCanvas()`.
3. Create ggtikz annotations with `ggtikzAnnotation()`.
4. Add the annotations to the canvas.
5. Draw the plot and the annotations using tikzDevice.
```{r advanced-usage}
library(ggplot2)
library(ggtikz)
p <- ggplot(mtcars, aes(disp, mpg)) + geom_point() # 1.
canvas <- ggtikzCanvas(p) # 2.
annot1 <- ggtikzAnnotation( # 3.
"
\\draw (0,0) -- (1,1);
\\draw (0,1) -- (1,0);
\\fill[red] (0.5,0.5) circle (5mm);
",
xy = "panel", panelx = 1, panely = 1
)
annot2 <- ggtikzAnnotation( # 3.
"\\draw[<-] (400,20) -- ++(0,3) node[at end, anchor=south] {(400,20)};",
xy = "data", panelx = 1, panely = 1
)
## tikz("plot.tikz")
p # 4. + 5.
canvas + annot1 + annot2
## dev.off()
## Render with LaTeX ...
```