fields (version 10.3)

add.image: Adds an image to an existing plot.

Description

Adds an image to an existing plot. Simple arguments control the location and size.

Usage

add.image(xpos, ypos, z, adj.x = 0.5, adj.y = 0.5, 
image.width = 0.15, image.height = NULL, col = tim.colors(256), ...)

Arguments

xpos

X position of image in user coordinates

ypos

Y position of image in user coordinates

z

Matrix of intensities comprising the image.

adj.x

Location of image relative to x coordinate. Most common values are .5 (centered), 0 (right side of image at x) and 1 (left side of image at x). These are the same conventions that are used for adj in positioning text.

adj.y

Location of image relative to y coordinate. Same rules as adj.x

image.width

Width of image as a fraction of the plotting region in horizontal direction.

image.height

Height of image as a fraction of the plotting region in horizontal direction. If NULL height is scaled to make image pixels square.

col

Color table for image. Default is tim.colors.

…

Any other plotting arguments that are passed to the image function

See Also

image.plot, colorbar.plot, image, tim.colors

Examples

# NOT RUN {
plot( 1:10, 1:10, type="n")
data( lennon)

add.image( 5,4,lennon, col=grey( (0:256)/256))
# reference lines 
xline( 5, col=2)
yline( 4,col=2) 

#
# add lennon right in the corner beyond the plotting region
# 

par(new=TRUE, plt=c(0,1,0,1), mar=c(0,0,0,0), usr=c(0,1,0,1))
add.image( 0,0, lennon, adj.x=0, adj.y=0) 

# }

Run the code above in your browser using DataCamp Workspace