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, ctype, path,
          fileprefix, overlay, xlim, ylim, xlab, ylab, postscript, pdf, png, bw,
          pointsize, colors, ltys, devoff, lpos)

_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'. 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.  

   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"). If you don't want to see the data, set it to
          "none". 

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

   ctype: This argument decides if horizontal lines are drawn to show
          the scatter of  the control values (dose = 0), if there are
          more than three of them. Defaults to "none", further allowed
          values are "std" and "conf" for displaying the standard
          deviation of the controls or the confidence interval for the
          mean of the controls. 

    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.  

    xlim: The plot limits (min,max) on the dose axis. 

    ylim: The plot limits (min,max) on the response axis. 

    xlab: The axis title for the x axis. Defaults to "Concentration in"
          'unit'. 

    ylab: The axis title for the y axis. Defaults to "Normalized
          response". 

postscript: If TRUE, (a) postscript graph(s) will be created.
          Otherwise, and if  the pdf and png arguments are also FALSE,
          graphics will be displayed with a screen graphics device. 

     pdf: If TRUE, (a) pdf graph(s) will be created. Otherwise, and if 
          the postscript, and png arguments are also FALSE, graphics
          will be displayed with a screen graphics device. 

     png: If TRUE, (a) png graph(s) will be created. Otherwise, and if
          the postscript and pdf arguments are also FALSE, graphics
          will be displayed with a screen graphics device. 

      bw: A boolean deciding if the plots will be black and white or
          not. Default  is TRUE. 

pointsize: The pointsize used for pdf, png and postscript graphics. 

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

    ltys: This is a vector of line types for the dose-response models,
          defaulting to 1:8. 

    lpos: An optional argument defaulting to "topright" specifying the
          position of the legend by being passed to the legend
          function. See the help for the legend function for all
          possiblities.

  devoff: If set to FALSE, the device will not be closed after creation
          of an overlay pdf, png or postscript graph, so texts and
          other elements can be added. 

_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/pdf/png files,
          depending on the parameters. 

_N_o_t_e:

     There is a demo for each dataset that can be accessed by
     'demo(dataset)'

_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)

