Array Functions/text/scalc/01/04060107.xhpmatrices; functionsFunction Wizard; arraysarray formulasinline array constantsformulas;arraysfunctions;array functionsediting; array formulascopying; array formulasadjusting array rangescalculating;conditional calculationsmatrices; calculationsconditional calculations with arraysimplicit array handlingforced array handlingmw deleted "creating;"Array FunctionsThis category contains the array functions.
What is an Array?An array is a linked range of cells on a spreadsheet containing values.
A square range of 3 rows and 3 columns is a 3 x 3 array:
ABC173133295172351050
The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells.What is an array formula?A formula in which the individual values in a cell range are evaluated is referred to as an array formula. The difference between an array formula and other formulas is that the array formula deals with several values simultaneously instead of just one.Not only can an array formula process several values, but it can also return several values. The results of an array formula is also an array.To multiply the values in the individual cells by 10 in the above array, you do not need to apply a formula to each individual cell or value. Instead you just need to use a single array formula. Select a range of 3 x 3 cells on another part of the spreadsheet, enter the formula =10*A1:C3 and confirm this entry using the key combination CommandCtrl+Shift+Enter. The result is a 3 x 3 array in which the individual values in the cell range (A1:C3) are multiplied by a factor of 10.In addition to multiplication, you can also use other operators on the reference range (an array). With $[officename] Calc, you can add (+), subtract (-), multiply (*), divide (/), use exponents (^), concatenation (&) and comparisons (=, <>, <, >, <=, >=). The operators can be used on each individual value in the cell range and return the result as an array if the array formula was entered.Comparison operators in an array formula treat empty cells in the same way as in a normal formula, that is, either as zero or as an empty string. For example, if cells A1 and A2 are empty the array formulas {=A1:A2=""} and {=A1:A2=0} will both return a 1 column 2 row array of cells containing TRUE.When do you use array formulas?Use array formulas if you have to repeat calculations using different values. If you decide to change the calculation method later, you only have to update the array formula. To add an array formula, select the entire array range and then make the required change to the array formula.Array formulas are also a space saving option when several values must be calculated, since they are not very memory-intensive. In addition, arrays are an essential tool for carrying out complex calculations, because you can have several cell ranges included in your calculations. $[officename] has different math functions for arrays, such as the MMULT function for multiplying two arrays or the SUMPRODUCT function for calculating the scalar products of two arrays.Using Array Formulas in $[officename] CalcYou can also create a "normal" formula in which the reference range, such as parameters, indicate an array formula. The result is obtained from the intersection of the reference range and the rows or columns in which the formula is found. If there is no intersection or if the range at the intersection covers several rows or columns, a #VALUE! error message appears. The following example illustrates this concept:Creating Array FormulasIf you create an array formula using the Function Wizard, you must mark the Array check box each time so that the results are returned in an array. Otherwise, only the value in the upper-left cell of the array being calculated is returned.If you enter the array formula directly into the cell, you must use the key combination Shift+CommandCtrl+Enter instead of the Enter key. Only then does the formula become an array formula.Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces.The cells in a results array are automatically protected against changes. However, you can edit or copy the array formula by selecting the entire array cell range.Using Inline Array Constants in FormulasCalc supports inline matrix/array constants in formulas. An inline array is surrounded by curly braces '{' and '}'. Elements can be each a number (including negatives), a logical constant (TRUE, FALSE), or a literal string. Non-constant expressions are not allowed. Arrays can be entered with one or more rows, and one or more columns. All rows must consist of the same number of elements, all columns must consist of the same number of elements. The column separator (separating elements in one row) is the ';' semicolon. The row separator is a '|' pipe symbol. The separators are not language and locale dependent. Arrays can not be nested.Examples:={1;2;3}An array with one row consisting of the three numbers 1, 2, and 3.To enter this array constant, you select three cells in a row, then you type the formula ={1;2;3} using the curly braces and the semicolons, then press CommandCtrl+Shift+Enter.={1;2;3|4;5;6}An array with two rows and three values in each row.={0;1;2|FALSE;TRUE;"two"}A mixed data array.=SIN({1;2;3})Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3.Editing Array FormulasSelect the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press Command Ctrl + /, where / is the Division key on the numeric keypad.Either press F2 or position the cursor in the input line. Both of these actions let you edit the formula.After you have made changes, press CommandCtrl+Shift+Enter.You can format the separate parts of an array. For example, you can change the font color. Select a cell range and then change the attribute you want.Copying Array FormulasSelect the cell range or array containing the array formula.Either press F2 or position the cursor in the input line.Copy the formula into the input line by pressing CommandCtrl+C.Select a range of cells where you want to insert the array formula and either press F2 or position the cursor in the input line.Paste the formula by pressing CommandCtrl+V in the selected space and confirm it by pressing CommandCtrl+Shift+Enter. The selected range now contains the array formula.Adjusting an Array RangeIf you want to edit the output array, do the following:Select the cell range or array containing the array formula.Below the selection, to the right, you will see a small icon with which you can zoom in or out on the range using your mouse.When you adjust the array range, the array formula will not automatically be adjusted. You are only changing the range in which the result will appear.By holding down the Command Ctrl key, you can create a copy of the array formula in the given range.Conditional Array CalculationsA conditional array calculation is an array or matrix formula that includes an IF() or CHOOSE() function. The condition argument in the formula is an area reference or a matrix result.In the following example, the >0 test of the {=IF(A1:A3>0;"yes";"no")} formula is applied to each cell in the range A1:A3 and the result is copied to the corresponding cell.
AB (formula)B (result)11{=IF(A1:A3>0;"yes";"no")}yes20{=IF(A1:A3>0;"yes";"no")}no31{=IF(A1:A3>0;"yes";"no")}yes
The following functions provide forced array handling: CORREL, COVAR, FORECAST, FTEST, INTERCEPT, MDETERM, MINVERSE, MMULT, MODE, PEARSON, PROB, RSQ, SLOPE, STEYX, SUMPRODUCT, SUMX2MY2, SUMX2PY2, SUMXMY2, TTEST. If you use area references as arguments when you call one of these functions, the functions behave as array functions. The following table provides an example of forced array handling:
AB (formula)B (result)C (forced array formula)C (result)11=A1:A2+12=SUMPRODUCT(A1:A2+1)522=A1:A2+13=SUMPRODUCT(A1:A2+1)53=A1:A2+1#VALUE!=SUMPRODUCT(A1:A2+1)5
MUNIT functionMUNITReturns the unitary square array of a certain size. The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0.SyntaxMUNIT(Dimensions)Dimensions refers to the size of the array unit.You can find a general introduction to Array functions at the top of this page.ExampleSelect a square range within the spreadsheet, for example, from A1 to E5.Without deselecting the range, select the MUNIT function. Mark the Array check box. Enter the desired dimensions for the array unit, in this case 5, and click OK.You can also enter the =Munit(5) formula in the last cell of the selected range (E5), and press Shift+Command+EnterShift+Ctrl+Enter.You now see a unit array with a range of A1:E5.FREQUENCY functionFREQUENCYIndicates the frequency distribution in a one-column-array. The function counts the number of values in the Data array that are within the values given by the Classes array.SyntaxFREQUENCY(Data; Classes)Data represents the reference to the values to be counted.Classes represents the array of the limit values.You can find a general introduction to Array functions at the top of this page.ExampleIn the following table, column A lists unsorted measurement values. Column B contains the upper limit you entered for the classes into which you want to divide the data in column A. According to the limit entered in B1, the FREQUENCY function returns the number of measured values less than or equal to 5. As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 and less than or equal to 10. The text you entered in B6, ">25", is only for reference purposes.i77461: replace old text: As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 or greater than or equal to 10.UFI: replace table by picture
Select a single column range in which to enter the frequency according to the class limits. You must select one field more than the class ceiling. In this example, select the range C1:C6. Call up the FREQUENCY function in the Function Wizard. Select the Data range in (A1:A11), and then the Classes range in which you entered the class limits (B1:B6). Select the Array check box and click OK. You will see the frequency count in the range C1:C6.MDETERM functiondeterminantsMDETERMReturns the array determinant of an array. This function returns a value in the current cell; it is not necessary to define a range for the results.SyntaxMDETERM(Array)Array represents a square array in which the determinants are defined.You can find a general introduction to using Array functions on top of this page.MINVERSE functioninverse arraysMINVERSEReturns the inverse array.SyntaxMINVERSE(Array)Array represents a square array that is to be inverted.ExampleSelect a square range and select MINVERSE. Select the output array, select the Array field and click OK.MMULT functionMMULTCalculates the array product of two arrays. The number of columns for array 1 must match the number of rows for array 2. The square array has an equal number of rows and columns.SyntaxMMULT(Array; Array)Array at first place represents the first array used in the array product.Array at second place represents the second array with the same number of rows.ExampleSelect a square range. Choose the MMULT function. Select the first Array, then select the second Array. Using Function Wizard, mark the Array check box. Click OK. The output array will appear in the first selected range.TRANSPOSE functionTRANSPOSETransposes the rows and columns of an array.SyntaxTRANSPOSE(Array)Array represents the array in the spreadsheet that is to be transposed.ExampleIn the spreadsheet, select the range in which the transposed array can appear. If the original array has n rows and m columns, your selected range must have at least m rows and n columns. Then enter the formula directly, select the original array and press Shift+Command+EnterShift+Ctrl+Enter. Or, if you are using the Function Wizard, mark the Array check box. The transposed array appears in the selected target range and is protected automatically against changes.LINEST functionLINESTReturns a table of statistics for a straight line that best fits a data set.changed based on http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)SyntaxLINEST(data_Y; data_X; linearType; stats)data_Y is a single row or column range specifying the y coordinates in a set of data points.data_X is a corresponding single row or column range specifying the x coordinates. If data_X is omitted it defaults to 1, 2, 3, ..., n. If there is more than one set of variables data_X may be a range with corresponding multiple rows or columns.LINEST finds a straight line y = a + bx that best fits the data, using linear regression (the "least squares" method). With more than one set of variables the straight line is of the form y = a + b1x1 + b2x2 ... + bnxn. iflinearType is FALSE the straight line found is forced to pass through the origin (the constant a is zero; y = bx). If omitted, linearType defaults to TRUE (the line is not forced through the origin).ifstats is omitted or FALSE only the top line of the statistics table is returned. If TRUE the entire table is returned.LINEST returns a table (array) of statistics as below and must be entered as an array formula (for example by using CommandCtrl+Shift+Return rather than just Return).ExampleThis function returns an array and is handled in the same way as the other array functions. Select a range for the answers and then the function. Select data_Y. If you want, you can enter other parameters. Select Array and click OK.The results returned by the system (if stats = 0), will at least show the slope of the regression line and its intersection with the Y axis. If stats does not equal 0, other results are to be displayed.Other LINEST Results:Examine the following examples:
Column A contains several X1 values, column B several X2 values and column C the Y values. You have already entered these values in your spreadsheet. You have now set up E2:G6 in the spreadsheet and activated the Function Wizard. For the LINEST function to work, you must have marked the Array check box in the Function Wizard. Next, select the following values in the spreadsheet (or enter them using the keyboard):data_Y is C2:C8data_X is A2:B8linearType and stats are both set to 1.As soon as you click OK, $[officename] Calc will fill the above example with the LINEST values as shown in the example.The formula in the Formula Bar corresponds to each cell of the LINEST array {=LINEST(C2:C8;A2:B8;1;1)}This represents the calculated LINEST values:slopes, see also regression linesregression lines;LINEST functionmw made "regression lines" a two level entryE2 and F2: Slope m of the regression line y=b+m*x for the x1 and x2 values. The values are given in reverse order; that is, the slope for x2 in E2 and the slope for x1 in F2.G2: Intersection b with the y axis.standard errors;array functionsMW changed "standard errors"E3 and F3: The standard error of the slope value.G3: The standard error of the interceptRSQ calculationsE4: RSQF4: The standard error of the regression calculated for the Y value.E5: The F value from the variance analysis.F5: The degrees of freedom from the variance analysis.E6: The sum of the squared deviation of the estimated Y values from their linear mean.F6: The sum of the squared deviation of the estimated Y value from the given Y values.LOGEST functionLOGESTThis function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003
for bug #i31051#SyntaxLOGEST(DataY; DataX; FunctionType; Stats)DataY represents the Y Data array.DataX (optional) represents the X Data array.FunctionType (optional). If Function_Type = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.Stats (optional). If Stats=0, only the regression coefficient is calculated.ExampleSee LINEST. However, no square sum will be returned.SUMPRODUCT functionscalar productsdot productsinner productsSUMPRODUCTMultiplies corresponding elements in the given arrays, and returns the sum of those products.SyntaxSUMPRODUCT(Array1; Array2...Array30)Array1, Array2...Array30 represent arrays whose corresponding elements are to be multiplied.At least one array must be part of the argument list. If only one array is given, all array elements are summed.Example
ABCD1234526789310111213
=SUMPRODUCT(A1:B3;C1:D3) returns 397.Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3You can use SUMPRODUCT to calculate the scalar product of two vectors.SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function.SUMX2MY2 functionSUMX2MY2Returns the sum of the difference of squares of corresponding values in two arrays.SyntaxSUMX2MY2(ArrayX; ArrayY)ArrayX represents the first array whose elements are to be squared and added.ArrayY represents the second array whose elements are to be squared and subtracted.SUMX2PY2 functionSUMX2PY2Returns the sum of the sum of squares of corresponding values in two arrays.SyntaxSUMX2PY2(ArrayX; ArrayY)ArrayX represents the first array whose arguments are to be squared and added.ArrayY represents the second array, whose elements are to be squared and added.SUMXMY2 functionSUMXMY2Adds the squares of the variance between corresponding values in two arrays.SyntaxSUMXMY2(ArrayX; ArrayY)ArrayX represents the first array whose elements are to be subtracted and squared.ArrayY represents the second array, whose elements are to be subtracted and squared.TREND functionTRENDReturns values along a linear trend.SyntaxTREND(DataY; DataX; NewDataX; LinearType)DataY represents the Y Data array.DataX (optional) represents the X Data array.NewDataX (optional) represents the array of the X data, which are used for recalculating values.LinearType(Optional). If LinearType = 0, then lines will be calculated through the zero point. Otherwise, offset lines will also be calculated. The default is LinearType <> 0.ExampleSelect a spreadsheet range in which the trend data will appear. Select the function. Enter the output data or select it with the mouse. Mark the Array field. click OK. The trend data calculated from the output data is displayed.GROWTH functionexponential trends in arraysGROWTHCalculates the points of an exponential trend in an array.SyntaxGROWTH(DataY; DataX; NewDataX; FunctionType)DataY represents the Y Data array.DataX (optional) represents the X Data array.NewDataX (optional) represents the X data array, in which the values are recalculated.FunctionType(optional). If FunctionType = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.ExampleThis function returns an array and is handled in the same way as the other array functions. Select a range where you want the answers to appear and select the function. Select DataY. Enter any other parameters, mark Array and click OK.