.-
help for ^fpplot^                                            (STB-25: sg26.3)
.-

Plot a fractional polynomial (FP) function
------------------------------------------

	^fpplot^ [^,^ ^fr^om(^#^)^ ^to^(^#^)^ ^ob^s^(^#^)^ ^gen^erate^(^xvar yhat^)^ ^nog^raph ^sca^le
			graph_options ]


                        -- OR --


	^fpplot^ [^,^ ^fr^om(^#^)^ ^to^(^#^)^ ^ob^s^(^#^)^ ^gen^erate^(^xvar yhat^)^ ^nog^raph ^sca^le
			^coe^ffs^(^coeffs^)^ ^cons^tant^(^#^)^ ^exp^x^(^#^)^ graph_options ]


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

^fpplot^ supplements ^fpgraph^ by providing a smooth plot of either a fitted or an
arbitrary FP function.


Options
-------

^from()^ and ^to()^ define the limits of the domain of the FP.  If ^fp^ has been
    used, the minimum and maximum of X are used as the limits.

^obs(^#^)^ is the number of equally-spaced values to be used.  ^#^ must be between
    2 and 500.  The default is 100.

^powers()^ specifes the powers of the FP function.  In the first syntax, the
    powers stored by a previous command will be used.

^coeffs()^ specifies the coefficients, excluding the constant.  In the first
    syntax, the coefficients stored by a previous command will be used.

^constant()^ specifies the constant.  In the first syntax, the constant stored by
    a previous command will be used.

^expx(^#^)^ transforms X to exp(-^#^ * X) before calculating the FP function.  In the
    first syntax, the value stored by a previous command will be used.

^generate()^ adds to new variables to the data: ^xvar^, containing the values of ^X^;
    and ^yhat^, containing the values of the calculated FP function.  If
    ^obs()^ exceeds the original number of observations, the data set is
    enlarged.

^scale^ linearly maps the FP function to the range [0,1].  This option is useful
    if several plots are to be superimposed.

^nograph^ suppresses the plot.

^graph_options^ refers to any of the options of the ^graph, twoway^ command.


Also see
--------

    STB:  STB-21: sg26,  STB-22: sg26.1,  STB-25: sg26.3
On-line:  help for @fp@ and @fpgraph@.