shape/0000755000175100001440000000000012426421270011370 5ustar hornikusersshape/inst/0000755000175100001440000000000012425114206012342 5ustar hornikusersshape/inst/doc/0000755000175100001440000000000012425114330013105 5ustar hornikusersshape/inst/doc/shape.Rnw0000644000175100001440000003361312425114330014703 0ustar hornikusers\documentclass[article,nojss]{jss} \DeclareGraphicsExtensions{.pdf,.eps} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Add-on packages and fonts \usepackage{amsmath} \usepackage{xspace} \usepackage{verbatim} \usepackage[english]{babel} %\usepackage{mathptmx} %\usepackage{helvet} \usepackage[T1]{fontenc} \usepackage[latin1]{inputenc} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands. \newcommand{\di}{\textbf{\textsf{diagram}}\xspace} \title{\proglang{R} Package \pkg{shape}: functions for plotting graphical shapes, colors...} \Plaintitle{R Package shape: functions for plotting graphical shapes, colors...} \Keywords{graphics, shapes, colors, R} \Plainkeywords{graphics, shapes, colors, R} \author{Karline Soetaert\\ Royal Netherlands Institute of Sea Research\\ Yerseke, The Netherlands } \Plainauthor{Karline Soetaert} \Abstract{This document describes how to use the \pkg{shape} package for plotting graphical shapes. Together with R-package \pkg{diagram} \citep{diagram} this package has been written to produce the figures of the book \citep{Soetaertbook} } %% The address of (at least) one author should be given %% in the following format: \Address{ Karline Soetaert\\ Royal Netherlands Institute of Sea Research (NIOZ)\\ 4401 NT Yerseke, Netherlands E-mail: \email{karline.soetaert@nioz.nl}\\ URL: \url{http://www.nioz.nl}\\ } %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% R/Sweave specific LaTeX commands. %% need no \usepackage{Sweave} %\VignetteIndexEntry{shape: functions for plotting graphical shapes} %\VignetteKeywords{graphics, shapes, colors} %\VignettePackage{shape} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Begin of the document \begin{document} \SweaveOpts{engine=R,eps=FALSE} \SweaveOpts{keep.source=TRUE} <>= library("shape") options(prompt = "> ") options(width=90) @ \maketitle \section{Introduction} This vignette is the Sweave application of parts of demo \code{colorshapes} in package \pkg{shape} \citep{shape}. \section{colors} Although one can find similar functions in other packages (including the R base package \citep{R2008}), \pkg{shape} includes ways to generate color schemes; \begin{itemize} \item \code{intpalette} creates transitions between several colors; \item \code{shadepalette} creates a gradient between two colors, useful for shading (see below). \item \code{drapecol} drapes colors over a \code{persp} plot; \end{itemize} by default the red-blue-yellow (matlab-type) colors are used. The code below demonstrates these functions (Figure \ref{fig:s1}) <>= par(mfrow = c(2, 2)) image(matrix(nrow = 1, ncol = 50, data = 1:50), main = "intpalette", col = intpalette(c("red", "blue", "yellow", "green", "black"), numcol = 50)) # shadepalette(n = 10, "white", "black") # image(matrix(nrow = 1, ncol = 50, data = 1:50), col = shadepalette(50, "red", "blue"), main = "shadepalette") # par(mar = c(0, 0, 0, 0)) persp(volcano, theta = 135, phi = 30, col = drapecol(volcano), main = "drapecol", border = NA) @ \begin{figure} \begin{center} <>= <> @ \end{center} \caption{Use of \code{intpalette}, \code{shadepalette} and \code{drapecol}} \label{fig:s1} \end{figure} \section{Rotating} Function \code{rotatexy} rotates graphical shapes; it can be used to generate strangely-colored shapes (Figure \ref{fig:s2}). <>= par(mfrow = c(2, 2), mar = c(3, 3, 3, 3)) # # rotating points on a line # xy <- matrix(ncol = 2, data = c(1:5, rep(1, 5))) plot(xy, xlim = c(-6, 6), ylim = c(-6, 6), type = "b", pch = 16, main = "rotatexy", col = 1) for (i in 1:5) points(rotatexy(xy, mid = c(0, 0), angle = 60*i), col = i+1, type = "b", pch = 16) points(0, 0, cex = 2, pch = 22, bg = "black") legend("topright", legend = 60*(0:5), col = 1:6, pch = 16, title = "angle") legend("topleft", legend = "midpoint", pt.bg = "black", pt.cex = 2, pch = 22, box.lty = 0) # # rotating lines.. # x <- seq(0, 2*pi, pi/20) y <- sin(x) cols <- intpalette(c("blue", "green", "yellow", "red"), n = 125) cols <- c(cols, rev(cols)) plot(x, y, type = "l", ylim = c(-3, 3), main = "rotatexy", col = cols[1], lwd = 2, xlim = c(-1, 7)) for (i in 2:250) lines(rotatexy(cbind(x, y), angle = 0.72*i), col = cols[i], lwd = 2) # # x <- seq(0, 2*pi, pi/20) y <- sin(x*2) cols <- intpalette(c("red", "yellow", "black"), n = 125) cols <- c(cols, rev(cols)) plot(x, y, type = "l", ylim = c(-4, 5), main = "rotatexy, asp = TRUE", col = cols[1], lwd = 2, xlim = c(-1, 7)) for (i in 2:250) lines(rotatexy(cbind(x, y), angle = 0.72*i, asp = TRUE), col = cols[i], lwd = 2) # # rotating points # cols <- femmecol(500) plot(x, y, xlim = c(-1, 1), ylim = c(-1, 1), main = "rotatexy", col = cols[1], type = "n") for (i in 2:500) { xy <- rotatexy(c(0, 1), angle = 0.72*i, mid = c(0, 0)) points(xy[1], xy[2], col = cols[i], pch = ".", cex = 2) } @ \begin{figure} \begin{center} <>= <> @ \end{center} \caption{Four examples of \code{rotatexy}} \label{fig:s2} \end{figure} \section{ellipses} If a suitable shading color is used, function \code{filledellipse} creates spheres, ellipses, donuts with 3-D appearance (Figure \ref{fig:s3}). <>= par(mfrow = c(2, 2), mar = c(2, 2, 2, 2)) emptyplot(c(-1, 1)) col <- c(rev(greycol(n = 30)), greycol(30)) filledellipse(rx1 = 1, rx2 = 0.5, dr = 0.1, col = col) title("filledellipse") # emptyplot(c(-1, 1), c(-1, 1)) filledellipse(col = col, dr = 0.1) title("filledellipse") # color <-gray(seq(1, 0.3, length.out = 30)) emptyplot(xlim = c(-2, 2), ylim = c(-2, 2), col = color[length(color)]) filledellipse(rx1 = 2, ry1 = 0.4, col = color, angle = 45, dr = 0.1) filledellipse(rx1 = 2, ry1 = 0.4, col = color, angle = -45, dr = 0.1) filledellipse(rx1 = 2, ry1 = 0.4, col = color, angle = 0, dr = 0.1) filledellipse(rx1 = 2, ry1 = 0.4, col = color, angle = 90, dr = 0.1) title("filledellipse") # emptyplot(main = "getellipse") col <-femmecol(90) for (i in seq(0, 180, by = 2)) lines(getellipse(0.5, 0.25, mid = c(0.5, 0.5), angle = i, dr = 0.1), type = "l", col = col[(i/2)+1], lwd = 2) @ \begin{figure} \begin{center} <>= <> @ \end{center} \caption{Use of \code{filledellipse}, and \code{getellipse}} \label{fig:s3} \end{figure} \section{Cylinders, rectangles, multigonals} The code below draws cylinders, rectangles and multigonals (Figure \ref{fig:s4}). <>= par(mfrow = c(2, 2), mar = c(2, 2, 2, 2)) # # simple cylinders emptyplot(c(-1.2, 1.2), c(-1, 1), main = "filledcylinder") col <- c(rev(greycol(n = 20)), greycol(n = 20)) col2 <- shadepalette("red", "blue", n = 20) col3 <- shadepalette("yellow", "black", n = 20) filledcylinder(rx = 0., ry = 0.2, len = 0.25, angle = 0, col = col, mid = c(-1, 0), dr = 0.1) filledcylinder(rx = 0.0, ry = 0.2, angle = 90, col = col, mid = c(-0.5, 0), dr = 0.1) filledcylinder(rx = 0.1, ry = 0.2, angle = 90, col = c(col2, rev(col2)), mid = c(0.45, 0), topcol = col2[10], dr = 0.1) filledcylinder(rx = 0.05, ry = 0.2, angle = 90, col = c(col3, rev(col3)), mid = c(0.9, 0), topcol = col3[10], dr = 0.1) filledcylinder(rx = 0.1, ry = 0.2, angle = 90, col = "white", lcol = "black", lcolint = "grey", dr = 0.1) # # more complex cylinders emptyplot(c(-1, 1), c(-1, 1), main = "filledcylinder") col <- shadepalette("blue", "black", n = 20) col2 <- shadepalette("red", "black", n = 20) col3 <- shadepalette("yellow", "black", n = 20) filledcylinder(rx = 0.025, ry = 0.2, angle = 90, col = c(col2, rev(col2)), dr = 0.1, mid = c(-0.8, 0), topcol = col2[10], delt = -1., lcol = "black") filledcylinder(rx = 0.1, ry = 0.2, angle = 00, col = c(col, rev(col)), dr = 0.1, mid = c(0.0, 0.0), topcol = col, delt = -1.2, lcol = "black") filledcylinder(rx = 0.075, ry = 0.2, angle = 90, col = c(col3, rev(col3)), dr = 0.1, mid = c(0.8, 0), topcol = col3[10], delt = 0.0, lcol = "black") # # rectangles color <- shadepalette(grey(0.3), "blue", n = 20) emptyplot(c(-1, 1), main = "filledrectangle") filledrectangle(wx = 0.5, wy = 0.5, col = color, mid = c(0, 0), angle = 0) filledrectangle(wx = 0.5, wy = 0.5, col = color, mid = c(0.5, 0.5), angle = 90) filledrectangle(wx = 0.5, wy = 0.5, col = color, mid = c(-0.5, -0.5), angle = -90) filledrectangle(wx = 0.5, wy = 0.5, col = color, mid = c(0.5, -0.5), angle = 180) filledrectangle(wx = 0.5, wy = 0.5, col = color, mid = c(-0.5, 0.5), angle = 270) # # multigonal color <- shadepalette(grey(0.3), "blue", n = 20) emptyplot(c(-1, 1)) filledmultigonal(rx = 0.25, ry = 0.25, col = shadepalette(grey(0.3), "blue", n = 20), nr = 3, mid = c(0, 0), angle = 0) filledmultigonal(rx = 0.25, ry = 0.25, col = shadepalette(grey(0.3), "darkgreen", n = 20), nr = 4, mid = c(0.5, 0.5), angle = 90) filledmultigonal(rx = 0.25, ry = 0.25, col = shadepalette(grey(0.3), "orange", n = 20), nr = 5, mid = c(-0.5, -0.5), angle = -90) filledmultigonal(rx = 0.25, ry = 0.25, col = "black", nr = 6, mid = c(0.5, -0.5), angle = 180) filledmultigonal(rx = 0.25, ry = 0.25, col = "white", lcol = "black", nr = 7, mid = c(-0.5, 0.5), angle = 270) title("filledmultigonal") @ \begin{figure} \begin{center} <