.-
help for ^gamplot^                                               (STB-42: sg79)
.-

Generalized Additive Models Plotter
-----------------------------------

	^gamplot^ xvar [xvar2] [^in^ range] [^if^ exp]
		[ ^, se(^#^)^ ^noconf^ ^nopres^ ^abs(^#^)^ graph_cmd_options ]
		  

Description
-----------

^gamplot^ plots the functions xvar following use of the ^gam^ command.  If xvar2
is specified the functions are plotted against this variable.


Options
-------

^se(^#^)^ determines how wide the standard error bands are.  The default is 0.95 
        which corresponds to 95% coverage (using assumptions of Normality).

^noconf^ suppress the plotting of the pointwise standard errors.

^nopres^ suppress the addition of partial residuals on the plot.

^abs(^#^)^ is the maximum permitted distance between the smooth function and 
        partial residual.  Any partial residuals which exceed this value will 
        not be plotted.  The user is made aware of this.  The default is 1e15.

graph_cmd_options are options appropriate to ^graph^.  The only options that
        cannot be used are ^sort^, ^symbol^, ^connect^ and ^pen^ as these are
        already being used.


Remarks on ^gamplot^
-----------------

^gamplot^ simply plots any smooth function, and the corresponding partial
residuals and standard error bars if requested.  Some points can be excluded
via the ^abs^ option.



Examples
--------

   . ^gam y x, df(x:4) family(binomial)^
   . ^gamplot x^


Authors
-------

        Patrick Royston
        Royal Postgraduate Medical School, UK
        email: proyston@@rpms.ac.uk

        Gareth Ambler
        Royal Postgraduate Medical School, UK
        email: gambler@@rpms.ac.uk


See also
--------

    STB:  STB-42 sg79
On-line:  help for @glm@, @gam@ (if installed)