Last data update: 2014.03.03

R: Scalebar for Projected Maps
ScalebarR Documentation

Scalebar for Projected Maps

Description

Scalebar adds a distance scalebar onto a projected map. It is not appropriate for geographic projections.

Usage

Scalebar(x, y, distance, unit = "km", scale = 1, t.cex = 0.8)

Arguments

x

the x-axis position for the lower left corner of the bar

y

the x-axis position for the lower left corner of the bar

distance

the distance for which the scale bar should represent

unit

the units to report as the scaling

scale

the scaling factor to rescale the distance to a different unit. e.g., if your map is in m and want the scalebar to be in km, use a scale of 0.01

t.cex

the scaling of the font size to be used for the scalebar

Value

nothing is returned, simply a scalebar is added to a plot.

Author(s)

Jeremy VanDerWal jjvanderwal@gmail.com

Examples

#create a simple object of class 'asc'
tasc = as.asc(matrix(1:50,nr=50,nc=50)); print(tasc)

#plot the image
image(tasc,axes=FALSE,ann=FALSE)

#add a distance scalebar
Scalebar(x=5,y=5,distance=20) #show values in km
Scalebar(x=5,y=10,distance=20,unit='m',scale=1000) #show values in meters

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(SDMTools)
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/SDMTools/Scalebar.Rd_%03d_medium.png", width=480, height=480)
> ### Name: Scalebar
> ### Title: Scalebar for Projected Maps
> ### Aliases: Scalebar
> 
> ### ** Examples
> 
> #create a simple object of class 'asc'
> tasc = as.asc(matrix(1:50,nr=50,nc=50)); print(tasc)
Raster map of class "asc":
Cell size:  1 
Number of rows:  50 
Number of columns:  50 
Type:  numeric 
> 
> #plot the image
> image(tasc,axes=FALSE,ann=FALSE)
> 
> #add a distance scalebar
> Scalebar(x=5,y=5,distance=20) #show values in km
> Scalebar(x=5,y=10,distance=20,unit='m',scale=1000) #show values in meters
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>