WorksheetFunction.Growth(Object, Object, Object, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Calculates predicted exponential growth by using existing data. Growth returns the y-values for a series of new x-values that you specify by using existing x-values and y-values. You can also use the Growth worksheet function to fit an exponential curve to existing x-values and y-values.

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

Public Function Growth (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

New_x's - new x-values for which you want Growth to return corresponding y-values.

Arg4: Object

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

Returns

Object

Remarks

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.

If any of the numbers in known_y's is 0 or negative, Growth returns the #NUM! error value.

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 vector (that is, a range with a height of one row or a width of one column).

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.

New_x's must include a column (or row) for each independent variable, just as known_x's does. So, if known_y's is in a single column, known_x's and new_x's must have the same number of columns. If known_y's is in a single row, known_x's and new_x's must have the same number of rows.

If new_x's is omitted, it is assumed to be the same as known_x's.

If both known_x's and new_x's are omitted, they are 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 adjusted so that y = m^x.

Formulas that return arrays must be entered as array formulas after selecting the correct number of cells.

When entering an array constant for an argument such as known_x's, use commas to separate values in the same row and semicolons to separate rows.

Applies to