map                   package:CTFS                   R Documentation

_P_l_o_t _o_f _t_h_e _S_p_a_t_i_a_l _L_o_c_a_t_i_o_n _o_f _T_r_e_e_s _o_f _a _S_p_e_c_i_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

     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)

_A_r_g_u_m_e_n_t_s:

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.

_D_e_t_a_i_l_s:

     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.

_V_a_l_u_e:

     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.

_A_u_t_h_o_r(_s):

     Rick Condit and Pamela Hall

_S_e_e _A_l_s_o:

     'maptopo', 'bcitopo.info',  'tst.bci90.spp', 'bcispp.info',
     'contour'

_E_x_a_m_p_l_e_s:

     ## 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)

