WorksheetFunction.Growth Method
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.
Namespace: Microsoft.Office.Interop.Excel
Assembly: Microsoft.Office.Interop.Excel (in Microsoft.Office.Interop.Excel.dll)
Syntax
'Declaration
Function Growth ( _
Arg1 As Object, _
Arg2 As Object, _
Arg3 As Object, _
Arg4 As Object _
) As Object
'Usage
Dim instance As WorksheetFunction
Dim Arg1 As Object
Dim Arg2 As Object
Dim Arg3 As Object
Dim Arg4 As Object
Dim returnValue As Object
returnValue = instance.Growth(Arg1, Arg2, _
Arg3, Arg4)
Object Growth(
Object Arg1,
Object Arg2,
Object Arg3,
Object Arg4
)
Parameters
Arg1
Type: System.ObjectKnown_y's - the set of y-values you already know in the relationship y = b*m^x.
Arg2
Type: System.ObjectKnown_x's - an optional set of x-values that you may already know in the relationship y = b*m^x.
Arg3
Type: System.ObjectNew_x's - new x-values for which you want Growth to return corresponding y-values.
Arg4
Type: System.ObjectConst - a logical value specifying whether to force the constant b to equal 1.
Return Value
Type: System.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.