Statistics - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Statistics and Data Analysis : Statistics Package : Regression : Statistics/PowerFit

Statistics

  

PowerFit

  

fit a power function to data

 

Calling Sequence

Parameters

Description

Options

Examples

Compatibility

Calling Sequence

PowerFit(X, Y, v, options)

PowerFit(XY, v, options)

Parameters

X

-

Vector; values of independent variable

Y

-

Vector; values of dependent variable

XY

-

Matrix; values of independent and dependent variables

v

-

name; (optional) independent variable name

options

-

(optional) equation(s) of the form option=value where option is one of output, summarize, svdtolerance or weights; specify options for the PowerFit command

Description

• 

The PowerFit command fits a function of the form y=axb to data by performing a least-squares fit using the transformed model function lny=a0+blnx, where a0 is lna.  The new function is linear in the model parameters, a0 and b.  Given k data points, where each point is a pair of numerical values for x,y, the PowerFit command finds a0 and b such that the sum of the k residuals squared is minimized.  The ith residual is the value lnya0blnx at the ith data point.

• 

In the first calling sequence, the first parameter X is a Vector containing the k values of the independent variable x, and the second parameter Y is a Vector containing the k values of the dependent variable y.  The entries of X and Y must evaluate to positive numbers. In the second calling sequence, the first parameter XY is a Matrix with two columns, where the first column corresponds to X and the second column to Y. For X, Y, and XY, one can also use lists or Arrays; for details, see the Input Forms help page.

• 

If the third parameter v is provided, then the PowerFit command returns the model function in variable v with the computed values of a and b.  Otherwise, a Vector containing values of a and b is returned.

• 

The PowerFit command calls the Statistics[LinearFit] command to fit the given data to the linearized model.  Additional options accepted by the LinearFit command, such as weights=W where W is a Vector of weights,  may be provided to PowerFit. However, it is important to note that these options, including the output option for obtaining additional results, apply to the transformed model.  More information about the underlying linear regression solver is available on the LinearFit help page.

Options

  

The options argument can contain one or more of the options shown below.  These options are described in more detail on the Statistics/Regression/Options help page.

• 

output = name or string -- Specify the form of the solution.  The output option can take as a value the name solutionmodule, or one of the following names (or a list of these names): AtkinsonTstatistic, confidenceintervals, CookDstatistic, degreesoffreedom, externallystandardizedresiduals, internallystandardizedresiduals, leastsquaresfunction, leverages, parametervalues, parametervector, residuals, residualmeansquare, residualstandarddeviation, residualsumofsquares, rsquared, rsquaredadjusted, standarderrors, tprobability, tvalue, variancecovariancematrix. For more information, see the Statistics/Regression/Solution help page.

• 

summarize = identical( true, false, embed ) -- Display a summary of the regression model

• 

svdtolerance = realcons(nonnegative) -- Set the tolerance that determines whether a singular-value decomposition is performed.

• 

weights = Vector -- Provide weights for the data points.

Examples

withStatistics:

Fit a power function to the provided data.

XVector1,2,3,4,5,6,datatype=float:

YVector2,5.6,8.2,20.5,40.0,95.0,datatype=float:

PowerFitX,Y,v

1.47957778799590v2.04167436679388

(1)

Return a summary of the regression:

lsPowerFitX,Y,v,summarize=true:

Summary:
----------------
Model: 1.4795778*v^2.04167436679388
----------------
Coefficients:
              Estimate  Std. Error  t-value  P(>|t|)
Parameter 1    0.3918    0.3470      1.1290   0.3220
Parameter 2    2.0417    0.2771      7.3684   0.0018
----------------
R-squared: 0.9314, Adjusted R-squared: 0.9142

ls

1.47957778799590v2.04167436679388

(2)

Use the weights option to assign a weight to each data point.  Because the v parameter is not provided, a Vector containing the computed model parameters is returned.

WVector1,1,1,2,5,5,datatype=float:

PowerFitX,Y,weights=W

1.241887294043932.24962642912626

(3)

Compatibility

• 

The XY parameter was introduced in Maple 15.

• 

For more information on Maple 15 changes, see Updates in Maple 15.

• 

The Statistics[PowerFit] command was updated in Maple 2016.

• 

The summarize option was introduced in Maple 2016.

• 

For more information on Maple 2016 changes, see Updates in Maple 2016.

See Also

CurveFitting

Statistics

Statistics/Regression

Statistics/Regression/InputForms

Statistics/Regression/Options

Statistics/Regression/Solution

Statistics[LinearFit]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam