fields (version 16.2)

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

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)