diff --git a/helpcontent2/source/text/scalc/01/04060107.xhp b/helpcontent2/source/text/scalc/01/04060107.xhp index 483eadcad6..914f7d538e 100644 --- a/helpcontent2/source/text/scalc/01/04060107.xhp +++ b/helpcontent2/source/text/scalc/01/04060107.xhp @@ -1,14 +1,15 @@ + - - + + + Array Functions /text/scalc/01/04060107.xhp - -Sun Microsystems, Inc. -UFI: sorted, added note text to every syntax description, added spec "Conditional Array Calculation and Specific Array Handling" -dedr: reviewed, fixed #i31269# -UFI: someone deleted the example table, so most examples became meaningless -> I deleted those examples - matrices; functions @@ -63,8 +59,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> conditional calculations with arrays implicit array handling forced array handling -mw deleted "creating;" -Array Functions +mw deleted "creating;"Array Functions This category contains the array functions. What is an Array? @@ -72,8 +67,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> A square range of 3 rows and 3 columns is a 3 x 3 array: - - + A @@ -127,7 +121,6 @@ UFI: someone deleted the example table, so most examples became meaningless ->
- 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. @@ -201,8 +194,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 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. - - + A @@ -256,12 +248,10 @@ UFI: someone deleted the example table, so most examples became meaningless ->
- 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: - - + A @@ -322,8 +312,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 3 - - + =A1:A2+1 @@ -338,13 +327,11 @@ UFI: someone deleted the example table, so most examples became meaningless ->
-
MUNIT function - -MUNIT +MUNIT Returns 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. Syntax MUNIT(Dimensions) @@ -364,8 +351,7 @@ UFI: someone deleted the example table, so most examples became meaningless ->
FREQUENCY function - -FREQUENCY +FREQUENCY Indicates 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. Syntax FREQUENCY(Data; Classes) @@ -375,11 +361,9 @@ UFI: someone deleted the example table, so most examples became meaningless -> Classes represents the array of the limit values. You can find a general introduction to Array functions at the top of this page. Example -In 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 or greater than or equal to 10. The text you entered in B6, ">25", is only for reference purposes. - +In 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
- - + A @@ -501,10 +485,8 @@ UFI: someone deleted the example table, so most examples became meaningless -> 16 - - - - + + @@ -515,10 +497,8 @@ UFI: someone deleted the example table, so most examples became meaningless -> 9 - - - - + + @@ -529,10 +509,8 @@ UFI: someone deleted the example table, so most examples became meaningless -> 7 - - - - + + @@ -543,10 +521,8 @@ UFI: someone deleted the example table, so most examples became meaningless -> 16 - - - - + + @@ -557,14 +533,11 @@ UFI: someone deleted the example table, so most examples became meaningless -> 33 - - - - + +
- -Select a single column range in which to enter the frequency for values that are greater than the upper class limit. 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. +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. @@ -573,8 +546,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> MDETERM function determinants - -MDETERM +MDETERM Returns 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. Syntax MDETERM(array) @@ -589,8 +561,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> MINVERSE function inverse arrays - -MINVERSE +MINVERSE Returns the inverse array. Syntax MINVERSE(array) @@ -605,8 +576,7 @@ UFI: someone deleted the example table, so most examples became meaningless ->
MMULT function - -MMULT +MMULT Calculates 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. Syntax MMULT(array; array) @@ -623,8 +593,7 @@ UFI: someone deleted the example table, so most examples became meaningless ->
TRANSPOSE function - -TRANSPOSE +TRANSPOSE Transposes the rows and columns of an array. Syntax TRANSPOSE(array) @@ -640,8 +609,7 @@ UFI: someone deleted the example table, so most examples became meaningless ->
LINEST function - -LINEST +LINEST Returns the parameters of a linear trend. Syntax LINEST(Data_Y; Data_X; Linear_Type; Stats) @@ -666,8 +634,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> Examine the following examples: - - + A @@ -705,15 +672,12 @@ UFI: someone deleted the example table, so most examples became meaningless -> y - - + LINEST value - - - - + + @@ -730,8 +694,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 100 - - + 4,17 @@ -757,8 +720,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 105 - - + 5,46 @@ -784,8 +746,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 104 - - + 0,87 @@ -811,8 +772,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 108 - - + 13,21 @@ -838,8 +798,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> 111 - - + 675,45 @@ -865,14 +824,10 @@ UFI: someone deleted the example table, so most examples became meaningless -> 120 - - - - - - - - + + + + @@ -889,17 +844,12 @@ UFI: someone deleted the example table, so most examples became meaningless -> 133 - - - - - - - - + + + +
- 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:C8 @@ -918,8 +868,7 @@ UFI: someone deleted the example table, so most examples became meaningless -> E2 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 functions -MW changed "standard errors" -E3 and F3: The standard error of the slope value. +MW changed "standard errors"E3 and F3: The standard error of the slope value. G3: The standard error of the intercept RSQ calculations @@ -936,8 +885,7 @@ UFI: someone deleted the example table, so most examples became meaningless ->
LOGEST function - -LOGEST +LOGEST This 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# Syntax @@ -965,8 +913,7 @@ for bug #i31051# dot products inner products - -SUMPRODUCT +SUMPRODUCT Multiplies corresponding elements in the given arrays, and returns the sum of those products. Syntax SUMPRODUCT(Array 1; Array 2...Array 30) @@ -976,8 +923,7 @@ for bug #i31051# Example - - + A @@ -1043,7 +989,6 @@ for bug #i31051#
- =SUMPRODUCT(A1:B3;C1:D3) returns 397. Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3 You can use SUMPRODUCT to calculate the scalar product of two vectors. @@ -1055,8 +1000,7 @@ for bug #i31051#
SUMX2MY2 function - -SUMX2MY2 +SUMX2MY2 Returns the sum of the difference of squares of corresponding values in two arrays. Syntax SUMX2MY2(array X; array Y) @@ -1071,8 +1015,7 @@ for bug #i31051#
SUMX2PY2 function - -SUMX2PY2 +SUMX2PY2 Returns the sum of the sum of squares of corresponding values in two arrays. Syntax SUMX2PY2(Array X; Array Y) @@ -1087,8 +1030,7 @@ for bug #i31051#
SUMXMY2 function - -SUMXMY2 +SUMXMY2 Adds the squares of the variance between corresponding values in two arrays. Syntax SUMXMY2(Array X; Array Y) @@ -1103,8 +1045,7 @@ for bug #i31051#
TREND function - -TREND +TREND Returns values along a linear trend. Syntax TREND(Data_Y; Data_X; New Data_X; Linear_Type) @@ -1129,8 +1070,7 @@ for bug #i31051# GROWTH function exponential trends in arrays - -GROWTH +GROWTH Calculates the points of an exponential trend in an array. Syntax GROWTH(Data_Y;Data_X; New_Data_X; Function_type) @@ -1151,6 +1091,5 @@ for bug #i31051# Example This 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 Data_Y. Enter any other parameters, mark Array and click OK.
- - +