map {CTFS} | R Documentation |
This function provides nicely proportioned maps of species distributions within a plot and topographic contour lines if requested. More than one species can be plotted and will have different coloured symbols for ease of interpretation.
map(census.spp, spname, elevmat = NULL, plotdim = c(1000, 500), spp.info = NULL, maintitle = NULL, titlepos = "default", addlegend = TRUE, legpos = "default", clrs = "default", symb = "default", size = rep(-1, 3), dbhclass = c(10, 100, 300, 3000), ht = 6, wd = 9, plotside = 4.5, export = "no", bw = FALSE, topoint = 0) map1species(sppdata,plotdim=c(1000,500),sppclrs="black",symbol=16,size=rep(-1,3), dbhclass=c(10,100,300,3000),plotside=3,add=FALSE)
census.spp |
data file as a list with species as names |
sppdata |
data file as a dataframe of a single species |
spname |
a species name code in quotes or a vector of names |
elevmat |
matrix of elevation data, preferably at 5 x 5 m scale,
see bcitopo.info |
plotdim |
vector of 2 numbers, maximum x, y dimensions of plot in m |
spp.info |
name of dataframe that contains each
species and information about it, used to print Latin species name on
plot for legend, see bcispp.info |
maintitle |
character string, main title for plot |
titlepos |
a vector of 2 numbers, position of title on plot in relation to plotdim |
addlegend |
logical, TRUE = add legend with color for each species |
legpos |
position of legend on plot in relation to plotdim |
clrs |
colors for symbols when more than one species is plotted.
the defaults (8) are:
“blue ”, “red ”, “black ”,
“green ”, “yellow ”,
“lightblue ”, “orange ”, “pink ”.
If bw is TRUE, then the colors
range from black to light grey |
sppclrs |
a single color for mapping 1 species, use for
map1species only |
symb |
symbol shapes when more than one species is plotted, default is a circle, 16 |
symbol |
default for mapping 1 species, a circle |
size |
symbol size based on tree dbh and based on number of
individuals of most abundant species when more than one species is
plotted, see dbhclass for size classes |
dbhclass |
range of dbh classes for symbol sizes |
ht |
height of graphics window, in inches |
wd |
width of graphics window, in inches |
plotside |
size of plot within the graphics window |
export |
character, indicating whether to plot to window or save as
file. Possible values are: “no ”, “bmp ”,
“jpg ”, “emf ”, “pdf ” |
bw |
logical, TRUE = use range of grey for symbols, FALSE = use colours |
topoint |
interval for contour lines |
add |
logical, must be set to FALSE for plotting 1 species when using
map1species . This variable is set to TRUE by map which
calls map1species for each species. |
This function provides nicely proportioned maps of species distributions
within a plot and topographic contour lines if requested. The dataset
input can be the entire site tree data (structured as a list of species)
or a list containing only the data frames of the species that are to be
plotted. The full Latin name can be easily added by specifying the file
containing them. The topographic data file MUST be in matrix format. In
most cases this would be the matrix component of the list
bcitopo.info
. Files of larger scale can also be used.
The user can alter most of the options that affect the size of the window, the symbols, their colours, their size (related to dbh of the tree), titles and position of titles and legends. Take care in manipulated these options as some combinations provide unexpected results. The same parameter settings may produce quite different looking plots on different machine OSs. The defaults work well on MSWindows (of more recent flavor) and MacOSX.
Any plot that can be created can also be exported as a graphics file.
Check the available options. For Windows, the preferred export format is
winmetafile (emf
) and for MaxOSX its pdf
. The files are
written to the current working directory. File names are created from
the species name. If many species are plotted then the file name is
multisppmap
. The file extension is appropriate for the type of
graphics file the user chooses.
If export=
“no
” then a map and all
information requested is plotted in the window. If the user choses to
export the file, then the same plot on the screen will be saved in a
file in the working directory in the format of the users choice. See
above for file name creation.
Rick Condit and Pamela Hall
maptopo
, bcitopo.info
,
tst.bci90.spp
, bcispp.info
, contour
## Not run: data(tst.bci90.spp) data(bcispp.info) data(bcitopo.info) # minimum needed map(tst.bci90.spp,"socrex") # much fancier plot map(tst.bci90.spp,names(tst.bci90.spp),elevmat=bcitopo.data$mat,spp.info=bcispp.info, maintitle="BCI test data set") # for different colour scheme, see colors in R help for more colors map(tst.bci90.spp,spname=names(tst.bci90.spp),clr=rainbow(length(names(tst.bci90.spp)))) # for export just add: map(tst.bci90.spp,names(tst.bci90.spp),elevmat=bcitopo.data$mat,spp.info=bcispp.info, maintitle="BCI test data set",export="pdf") ## End(Not run)