drplot                 package:drfit                 R Documentation

_P_l_o_t _d_o_s_e-_r_e_s_p_o_n_s_e _m_o_d_e_l_s

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

     Produce graphics of dose-response data and dose-response
     relationships  either combined or separately, for one or more
     substances.

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

       drplot(drresults, data, dtype, alpha, path, fileprefix, overlay,
         postscript, color, datacolors, fitcolors)

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

drresults: A data frame as returned from 'drfit'. 

    data: A data frame as returned from 'drdata'.  If data is to be
          plotted, the data frame has to contain at least a factor
          called "substance", a vector called "unit" containing the
          unit used for the dose, a column "response" with the response
          values of the test system normalized between 0 and 1, a
          column "dose" with the numeric dose values and a factor
          called "dosefactor" containing the dose as a factor. If
          plotting of the data is  not required, data can be set to
          FALSE. 

   dtype: A string describing if the raw data should be plotted
          ("raw"), or  an error bar should be constructed from the
          standard deviations of the responses at each dose level
          ("std", default value) or from the confidence intervals
          ("conf"). Of course, dtype only makes a difference, if a
          valid data object has been referenced. 

   alpha: The confidence level, defaulting to 0.95, only used if dtype
          "conf" has been chosen. 

    path: The path where graphic files should be put if any are
          produced. Defaults to "./" i.e. the current working directory
          of R. 

fileprefix: A string which will form the beginning of each filename, if
          graphic files are  created. Defaults to "drplot". 

 overlay: If TRUE, all output will be put into one graph, otherwise a
          separate graph will be created for each substance. In the
          latter case, on-screen display (postscript=FALSE) only works
          correctly for data plots. Dose-response models will all be
          put into the last graph in this case. 

postscript: If TRUE, (a) postscript graph(s) will be created.
          Otherwise, graphics will be displayed with a screen graphics
          device. 

   color: If TRUE, a sensible selection of colors will be attempted. If
          false, everything will be drawn in black 

datacolors: This is a vector of colors, defaulting to 1:8, used for
          plotting the data. 

fitcolors: Here you can specify a palette for the colors of the
          dose-response fits. The  default value is "default", which
          produces the default palette, if the  number of fits to be
          plotted is 8 or less. Otherwise, rainbow colors  will be
          plotted. Unless there is more than one fit per substance to
          be plotted, or the number of fits is larger than 8, the
          fitcolors will match the datacolors. 

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

 results: You will get plots of data and/or the fitted dose-response
          curves, on the screen and/or as postscript files, depending
          on the parameters. 

_N_o_t_e:

     Turn off the colors if you don't like them and don't want to
     fiddle with them. Treatment of legends is quite bad. Be sure all
     devices are closed (e.g. by calling 'dev.off()') before calling
     'drplot' again.

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

     Johannes Ranke  jranke@uni-bremen.de  <URL:
     http://www.uft.uni-bremen.de/chemie/ranke>

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

     data(antifoul)
     r <- drfit(antifoul)
     ## Not run: drplot(r,antifoul)

