Skip to content
This repository

A R package for producing graphics output as PGF/TikZ code for use in TeX documents.

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 R
Octocat-spinner-32 inst
Octocat-spinner-32 man
Octocat-spinner-32 src
Octocat-spinner-32 tests
Octocat-spinner-32 .Rbuildignore
Octocat-spinner-32 CHANGELOG.md
Octocat-spinner-32 DESCRIPTION
Octocat-spinner-32 Makefile
Octocat-spinner-32 NAMESPACE
Octocat-spinner-32 README.md
Octocat-spinner-32 RELEASE_PROCEEDURE
Octocat-spinner-32 TODO Update of prerelease version of 0.5.0
Octocat-spinner-32 updateVersion.sh
README.md

tikzDevice


Description

The tikzDevice package provides a graphics device for R that enables direct output of graphics in a LaTeX-friendly way. Plotting commands issued by R functions are transformed into LaTeX code blocks. These blocks are interpreted with the help of TikZ-- a graphics library for TeX and friends written by Till Tantau.

The tikzDevice supports three main modes of output:

  • Figure chunks: placed in .tex files and suitable for inclusion in LaTeX documents via the \input{} command.

  • Stand alone figures: Complete LaTeX documents containing figure code that can be compiled into stand-alone images. Pages are cropped to the size of the figure using the LaTeX preview package.

  • Console output: TikZ code is returned directly to the R console as a character vector for further manipulation.

Beta Notice

The tikzDevice is currently flagged as a beta work. The package is reasonably stable and has been used by the authors to produce graphics for academic publications for over a year. The reason for beta status is that there are several open design issues- two of which are:

  • Providing support for UTF8 text.

  • Supporting TeX variants other than LaTeX.

Resolving these issues may require changes to the tikzDevice that break backwards compatibility with previous versions. The beta flag is a reminder that such changes may occur- although we will strive to avoid them if possible.

The beta flag will be removed upon release of version 1.0. At this time the tikzDevice will switch to semantic versioning and changes that break backwards compatibility will happen rarely and will incur a major release.

Obtaining the Package

Stable versions of the tikzDevice may be downloaded from CRAN:

install.packages( 'tikzDevice' )

Development builds may be obtained from R-Forge:

install.packages( 'tikzDevice',
  repos='http://r-forge.r-project.net' )

Bleeding-edge source code is available from GitHub:

git clone git://github.com/Sharpie/RTikZDevice.git

Reporting Bugs and Getting Help

The tikzDevice has a dedicated mailing list courtesy of R-Forge. The mailing list is the easiest way to get answers for questions related to usage:

tikzdevice-bugs @at@ lists.r-forge.r-project.org

The mailing list may also be accessed through Google Groups:

https://groups.google.com/forum/#!forum/tikzdevice

Primary development takes place on GitHub. Bugs and feature requests may be made by opening issues at the primary repository:

https://github.com/Sharpie/RTikZDevice/issues

Adventurous users are encouraged to fork the repository and contribute to the development of the package!

Latest Changes

See the CHANGELOG for changes that occurred in previous releases


Version: 0.6.1


Bug Fixes

  • Fixed a bug where tikz was not applying background color to the plot canvas.

  • Fixed a Vignette bug caused by an incorrect merge that was breaking the CRAN build.

Something went wrong with that request. Please try again.