WorksheetFunction.LogEst(Object, Object, Object, Object) Method

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

In regression analysis, calculates an exponential curve that fits your data and returns an array of values that describes the curve. Because this function returns an array of values, it must be entered as an array formula.

public object LogEst (object Arg1, object Arg2, object Arg3, object Arg4);

Public Function LogEst (Arg1 As Object, Optional Arg2 As Object, Optional Arg3 As Object, Optional Arg4 As Object) As Object

Parameters

Arg1

Object

Known_y's - the set of y-values you already know in the relationship y = b*m^x.

Arg2

Object

Known_x's - an optional set of x-values that you may already know in the relationship y = b*m^x.

Arg3

Object

Const - a logical value specifying whether to force the constant b to equal 1.

Arg4

Object

Stats - a logical value specifying whether to return additional regression statistics.

Returns

Object

Remarks

The equation for the curve is:

y = b*m^x or

y = (b*(m1^x1)*(m2^x2)*_) (if there are multiple x-values)

where the dependent y-value is a function of the independent x-values. The m-values are bases corresponding to each exponent x-value, and b is a constant value. Note that y, x, and m can be vectors. The array that LogEst returns is {mn,mn-1,...,m1,b}.

If the array known_y's is in a single column, then each column of known_x's is interpreted as a separate variable.

If the array known_y's is in a single row, then each row of known_x's is interpreted as a separate variable.

The array known_x's can include one or more sets of variables. If only one variable is used, known_y's and known_x's can be ranges of any shape, as long as they have equal dimensions. If more than one variable is used, known_y's must be a range of cells with a height of one row or a width of one column (which is also known as a vector).

If known_x's is omitted, it is assumed to be the array {1,2,3,...} that is the same size as known_y's.

If const is true or omitted, b is calculated normally.

If const is false, b is set equal to 1, and the m-values are fitted to y = m^x.

If stats is true, LogEst returns the additional regression statistics, so the returned array is {mn,mn-1,...,m1,b;sen,sen-1,...,se1,seb;r 2,sey; F,df;ssreg,ssresid}.

If stats is false or omitted, LogEst returns only the m-coefficients and the constant b.

For more information about additional regression statistics, see LinEst(Object, Object, Object, Object).

The more a plot of your data resembles an exponential curve, the better the calculated line will fit your data. Like LinEst(Object, Object, Object, Object), LogEst returns an array of values that describes a relationship among the values, but LinEst(Object, Object, Object, Object) fits a straight line to your data; LogEst fits an exponential curve. For more information, see LinEst(Object, Object, Object, Object).

When you have only one independent x-variable, you can obtain y-intercept (b) values directly by using the following formula:

Y-intercept (b):

INDEX(LOGEST(known_y's,known_x's),2)

You can use the y = b*m^x equation to predict future values of y, but Microsoft Excel provides the Growth(Object, Object, Object, Object) function to do this for you. For more information, see Growth(Object, Object, Object, Object).

Formulas that return arrays must be entered as array formulas.

When entering an array constant such as known_x's as an argument, use commas to separate values in the same row and semicolons to separate rows. Separator characters may be different depending on your locale setting in Regional and Language Options in Control Panel.

You should note that the y-values predicted by the regression equation may not be valid if they are outside the range of y-values you used to determine the equation.