diff options
Diffstat (limited to 'helpcontent2/source/text/scalc/01/04060107.xhp')
| -rw-r--r-- | helpcontent2/source/text/scalc/01/04060107.xhp | 1162 |
1 files changed, 1162 insertions, 0 deletions
diff --git a/helpcontent2/source/text/scalc/01/04060107.xhp b/helpcontent2/source/text/scalc/01/04060107.xhp new file mode 100644 index 000000000..86514c411 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060107.xhp @@ -0,0 +1,1162 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060107xml" indexer="include"> + <title id="tit" xml-lang="en-US">Array Functions</title> + <filename>/text/scalc/01/04060107.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147273"> +<bookmark_value>matrices; functions</bookmark_value> +<bookmark_value>Function Wizard; arrays</bookmark_value> +<bookmark_value>array formulas</bookmark_value> +<bookmark_value>inline array constants</bookmark_value> +<bookmark_value>formulas; arrays</bookmark_value> +<bookmark_value>functions; array functions</bookmark_value> +<bookmark_value>editing; array formulas</bookmark_value> +<bookmark_value>copying; array formulas</bookmark_value> +<bookmark_value>deleting; array formulas</bookmark_value> +<bookmark_value>adjusting array ranges</bookmark_value> +<bookmark_value>calculating; conditional calculations</bookmark_value> +<bookmark_value>matrices; calculations</bookmark_value> +<bookmark_value>conditional calculations with arrays</bookmark_value> +<bookmark_value>implicit array handling</bookmark_value> +<bookmark_value>forced array handling</bookmark_value> +</bookmark> +<comment>mw deleted "creating;"</comment> +<h1 id="hd_id3147273"><variable id="arrayfunctit"><link href="text/scalc/01/04060107.xhp" name="array functions">Array Functions</link></variable></h1> + <paragraph id="par_id3154744" role="paragraph" xml-lang="en-US"><variable id="matrixtext">This category contains the array functions.</variable></paragraph> +<h2 id="hd_id3146084">What is an Array?</h2> + <paragraph id="par_id3154298" role="paragraph" xml-lang="en-US"><variable id="wasmatrix">An array is a linked range of cells on a spreadsheet containing values.</variable> A square range of 3 rows and 3 columns is a 3 x 3 array:</paragraph> +<table id="tbl_id3151168"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3154692" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150117" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155325" role="tablehead" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153104" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3146996" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150529" role="paragraph" localize="false"><item type="input">31</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148831" role="paragraph" localize="false"><item type="input">33</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3148943" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149771" role="paragraph" localize="false"><item type="input">95</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158407" role="paragraph" localize="false"><item type="input">17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148806" role="paragraph" localize="false"><item type="input">2</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154904" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150779" role="paragraph" localize="false"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148449" role="paragraph" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147238" role="paragraph" localize="false"><item type="input">50</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3153583" role="paragraph" xml-lang="en-US">The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells.</paragraph> +<h2 id="hd_id3148474">What is an array formula?</h2> + <paragraph id="par_id3155355" role="paragraph" xml-lang="en-US">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.</paragraph> + <paragraph id="par_id3151052" role="paragraph" xml-lang="en-US">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.</paragraph> + <paragraph id="par_id3158432" role="paragraph" xml-lang="en-US">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 <item type="input">=10*A1:C3</item> and confirm this entry using the key combination <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>. 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.</paragraph> + <paragraph id="par_id3149156" role="paragraph" xml-lang="en-US">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.</paragraph> + <paragraph id="par_id3166456" role="paragraph" xml-lang="en-US">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 <item type="input">{=A1:A2=""}</item> and <item type="input">{=A1:A2=0}</item> will both return a 1 column 2 row array of cells containing TRUE.</paragraph> +<h3 id="hd_id3150713">When do you use array formulas?</h3> + <paragraph id="par_id3149787" role="paragraph" xml-lang="en-US">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 <link href="text/scalc/01/04060107.xhp" name="make the required change to the array formula">make the required change to the array formula</link>.</paragraph> + <paragraph id="par_id3149798" role="paragraph" xml-lang="en-US">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.</paragraph> +<h2 id="hd_id3155588">Using Array Formulas in $[officename] Calc</h2> + <paragraph id="par_id3152876" role="paragraph" xml-lang="en-US">You 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:</paragraph> +<h3 id="hd_id3151271">Creating Array Formulas</h3> +<section id="creating_array_formulas"> + <paragraph id="par_id3149102" role="paragraph" xml-lang="en-US">If you create an array formula using the <emph>Function Wizard</emph>, you must mark the <emph>Array</emph> 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.</paragraph> + <paragraph id="par_id3153392" role="paragraph" xml-lang="en-US">If you enter the array formula directly into the cell, you must use the key combination <emph>Shift + </emph><switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Enter</emph> instead of the <emph>Enter</emph> key. Only then does the formula become an array formula.</paragraph> + <note id="par_id3151120">Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces.</note> +</section> + <warning id="par_id3154342">The cells in a results array are automatically protected against changes. However, you can edit, delete or copy the array formula by selecting the entire array cell range.</warning> +<h3 id="hd_id8834803">Using Inline Array Constants in Formulas</h3> + <paragraph id="par_id985747" role="paragraph" xml-lang="en-US">Calc 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.</paragraph> + <paragraph id="par_id936613" role="paragraph" xml-lang="en-US">The column separator (separating elements in one row) and the row separator are language and locale dependent. But in this help content, the ';' semicolon and '|' pipe symbol are used to indicate the column and row separators, respectively. For example, in the English locale, the ',' comma is used as the column separator, while the ';' semicolon is used as the row separator.</paragraph> + <tip id="par_id936615">You can view and change the row and column separator in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - Calc - Formula - Separators</emph>.</tip> + <paragraph id="par_id1877498" role="paragraph" xml-lang="en-US">Arrays can not be nested.</paragraph> + <paragraph id="par_id4262520" role="paragraph" xml-lang="en-US"><emph>Examples:</emph></paragraph> + <paragraph id="par_id9387493" role="code" xml-lang="en-US">={1;2;3}</paragraph> + <paragraph id="par_id8207037" role="paragraph" xml-lang="en-US">An array with one row consisting of the three numbers 1, 2, and 3.</paragraph> + <paragraph id="par_id6757103" role="paragraph" xml-lang="en-US">To enter this array constant, you select three cells in a row, then you type the formula <item type="input">={1;2;3}</item> using the curly braces and the semicolons, then press <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>.</paragraph> + <paragraph id="par_id8868068" role="code" xml-lang="en-US">={1;2;3|4;5;6}</paragraph> + <paragraph id="par_id6626483" role="paragraph" xml-lang="en-US">An array with two rows and three values in each row.</paragraph> + <paragraph id="par_id5262916" role="code" xml-lang="en-US">={0;1;2|FALSE;TRUE;"two"}</paragraph> + <paragraph id="par_id1623889" role="paragraph" xml-lang="en-US">A mixed data array.</paragraph> + <paragraph id="par_id7781914" role="code" xml-lang="en-US">=SIN({1;2;3})</paragraph> + <paragraph id="par_id300912" role="paragraph" xml-lang="en-US">Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3.</paragraph> +<h3 id="hd_id3148660">Editing Array Formulas</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id3149241" role="listitem" xml-lang="en-US">Select the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> + <keycode>/</keycode>, where <keycode>/</keycode> is the division key on the numeric keypad.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3143274" role="listitem" xml-lang="en-US">Either press <emph>F2</emph> or position the cursor in the input line. Both of these actions let you edit the formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154798" role="listitem" xml-lang="en-US">After you have made changes, press <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>.</paragraph> + </listitem> +</list> + <tip id="par_id3150628">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.</tip> + +<h3 id="hd_id541633516074226">Deleting Array Formulae</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id681633516103267" role="listitem">Select the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> + <keycode>/</keycode>, where <keycode>/</keycode> is the division key on the numeric keypad.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id61633516164519" role="listitem">Press <keycode>Delete</keycode> to delete the array contents, including the array formula, or press <keycode>Backspace</keycode> and this brings up the <link href="text/scalc/01/02150000.xhp" name="delete contents">Delete Contents</link> dialog box. Select <emph>Formula</emph> or <emph>Delete All</emph> and click <emph>OK</emph>.</paragraph> + </listitem> +</list> + +<h3 id="hd_id3145608">Copying Array Formulas</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id3149585" role="listitem" xml-lang="en-US">Select the cell range or array containing the array formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154619" role="listitem" xml-lang="en-US">Either press <emph>F2</emph> or position the cursor in the input line.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3150994" role="listitem" xml-lang="en-US">Copy the formula into the input line by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + C</emph>.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3146787" role="listitem" xml-lang="en-US">Select a range of cells where you want to insert the array formula and either press <emph>F2</emph> or position the cursor in the input line.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154419" role="listitem" xml-lang="en-US">Paste the formula by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + V</emph> in the selected space and confirm it by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>. The selected range now contains the array formula.</paragraph> + </listitem> +</list> +<h3 id="hd_id3154834">Adjusting an Array Range</h3> + <paragraph id="par_id3148679" role="paragraph" xml-lang="en-US">If you want to edit the output array, do the following:</paragraph> +<list type="ordered"> + <listitem> + <paragraph id="par_id3151102" role="listitem" xml-lang="en-US">Select the cell range or array containing the array formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3147096" role="listitem" xml-lang="en-US">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.</paragraph> + </listitem> +</list> + <note id="par_id3150974">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.</note> + <paragraph id="par_id3146080" role="paragraph" xml-lang="en-US">By holding down the <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline> key, you can create a copy of the array formula in the given range.</paragraph> +<h3 id="par_idN10D47">Conditional Array Calculations</h3> + <paragraph id="par_idN10D4B" role="paragraph" xml-lang="en-US">A 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.</paragraph> + <paragraph id="par_idN10D4E" role="paragraph" xml-lang="en-US">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.</paragraph> +<table id="tbl_id2511673"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN10D65" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D6B" role="tablehead" xml-lang="en-US">B (formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10B75" role="tablehead" xml-lang="en-US">B (result)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10D79" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D80" role="paragraph" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D86" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D8C" role="tablecontent" xml-lang="en-US">yes</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10D94" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D9B" role="paragraph" localize="false">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DA1" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DA7" role="tablecontent" xml-lang="en-US">no</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10DAF" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DB6" role="paragraph" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DBC" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DC2" role="tablecontent" xml-lang="en-US">yes</paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_idN10DD0" role="paragraph" xml-lang="en-US">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:</paragraph> +<table id="tbl_id7380291"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN10DE2" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DE8" role="tablehead" xml-lang="en-US">B (formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DEE" role="tablehead" xml-lang="en-US">B (result)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DF4" role="tablehead" xml-lang="en-US">C (forced array formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DFA" role="tablehead" xml-lang="en-US">C (result)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E02" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E09" role="tablecontent" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E0F" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E17" role="tablecontent" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E1D" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E25" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E2D" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E34" role="tablecontent" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E3A" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E42" role="tablecontent" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E48" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E50" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E58" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN10E63" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E6A" role="tablecontent" xml-lang="en-US">#VALUE!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E70" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E78" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> +</table> +<sort order="asc" descendant="h2"> +<section id="Section14"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158446"> +<bookmark_value>MUNIT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EINHEITSMATRIX" id="bm_id3151317" localize="false"/> +<h2 id="hd_id3158446">MUNIT</h2> + <paragraph id="par_id3154121" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EINHEITSMATRIX">Returns the unitary square array of a certain size.</ahelp> The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156271" role="code" xml-lang="en-US">MUNIT(Dimensions)</paragraph> + <paragraph id="par_id3159390" role="paragraph" xml-lang="en-US"><emph>Dimensions</emph> refers to the size of the array unit.</paragraph> + <note id="par_idN10C9B">You can find a general introduction to Array functions at the top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3150949" role="paragraph" xml-lang="en-US">Select a square range within the spreadsheet, for example, from A1 to E5.</paragraph> + <paragraph id="par_id3151260" role="paragraph" xml-lang="en-US">Without deselecting the range, select the MUNIT function. Mark the <emph>Array</emph> check box. Enter the desired dimensions for the array unit, in this case <item type="input">5</item>, and click <emph>OK</emph>.</paragraph> + <paragraph id="par_id3150403" role="paragraph" xml-lang="en-US">You can also enter the <item type="input">=MUNIT(5)</item> formula in the last cell of the selected range (E5), and press <switchinline select="sys"><caseinline select="MAC"><item type="keycode">Shift + Command + Enter</item></caseinline><defaultinline><item type="keycode">Shift + Ctrl + Enter</item></defaultinline></switchinline>.</paragraph> + <paragraph id="par_id3156143" role="paragraph" xml-lang="en-US">You now see a unit array with a range of A1:E5.</paragraph> + <paragraph id="par_idN10FA7" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159084"> +<bookmark_value>FREQUENCY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HAEUFIGKEIT" id="bm_id3153883" localize="false"/> +<h2 id="hd_id3159084">FREQUENCY</h2> + <paragraph id="par_id3145777" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_HAEUFIGKEIT">Indicates the frequency distribution in a one-column-array.</ahelp> The function counts the number of values in the <emph>Data</emph> array that are within the values given by the <emph>Classes</emph> array.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3155498" role="code" xml-lang="en-US">FREQUENCY(Data; Classes)</paragraph> + <paragraph id="par_id3154352" role="paragraph" xml-lang="en-US"><emph>Data</emph> represents the reference to the values to be counted.</paragraph> + <paragraph id="par_id3148402" role="paragraph" xml-lang="en-US"><emph>Classes</emph> represents the array of the limit values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <note id="par_idN10D71">You can find a general introduction to Array functions at the top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3155904" role="paragraph" xml-lang="en-US">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.<comment>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.</comment></paragraph><comment>UFI: replace table by picture</comment> +<table id="tbl_id3150680"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3155869" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149328" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152467" role="tablehead" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154528" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149744" role="paragraph" localize="false">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147309" role="paragraph" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154199" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3159218" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153263" role="paragraph" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156201" role="paragraph" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147552" role="paragraph" localize="false">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149174" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151201" role="paragraph" localize="false">24</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150245" role="paragraph" localize="false">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159194" role="paragraph" localize="false">2</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3146925" role="tablehead" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154128" role="paragraph" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151067" role="paragraph" localize="false">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156033" role="paragraph" localize="false">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149298" role="tablehead" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151382" role="paragraph" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155141" role="paragraph" localize="false">25</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145213" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145268" role="tablehead" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3163724" role="paragraph" localize="false">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147132" role="paragraph" localize="false">>25</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148903" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3151007" role="tablehead" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153294" role="paragraph" localize="false">16</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3147284" role="tablehead" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154914" role="paragraph" localize="false">9</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154218" role="tablehead" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147226" role="paragraph" localize="false">7</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149045" role="tablehead" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155799" role="paragraph" localize="false">16</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3155076" role="tablehead" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150217" role="paragraph" localize="false">33</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3150312" role="paragraph" xml-lang="en-US">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 <emph>Function Wizard</emph>. Select the <emph>Data</emph> range in (A1:A11), and then the <emph>Classes</emph> range in which you entered the class limits (B1:B6). Select the <emph>Array</emph> check box and click <emph>OK</emph>. You will see the frequency count in the range C1:C6.</paragraph> + <paragraph id="par_idN11269" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151030"> +<bookmark_value>MDETERM function</bookmark_value> +<bookmark_value>determinants</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MDET" id="bm_id3154057" localize="false"/> +<h2 id="hd_id3151030">MDETERM</h2> + <paragraph id="par_id3154073" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MDET">Returns the array determinant of an array.</ahelp> This function returns a value in the current cell; it is not necessary to define a range for the results.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156380" role="code" xml-lang="en-US">MDETERM(Array)</paragraph> + <paragraph id="par_id3150290" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array in which the determinants are defined.</paragraph> + <note id="par_idN11635">You can find a general introduction to using Array functions on top of this page.</note> + <paragraph id="par_idN11333" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151348"> +<bookmark_value>MINVERSE function</bookmark_value> +<bookmark_value>inverse arrays</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINV" id="bm_id3151360" localize="false"/> +<h2 id="hd_id3151348">MINVERSE</h2> + <paragraph id="par_id3145569" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MINV">Returns the inverse array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156085" role="code" xml-lang="en-US">MINVERSE(Array)</paragraph> + <paragraph id="par_id3157849" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array that is to be inverted.</paragraph> + <paragraph id="par_idN113EE" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3149638" role="paragraph" xml-lang="en-US">Select a square range and select MINVERSE. Select the output array, select the <emph>Array</emph> field and click <emph>OK</emph>.</paragraph> +</section> +<section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148546"> +<bookmark_value>MMULT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MMULT" id="bm_id3148501" localize="false"/> +<h2 id="hd_id3148546">MMULT</h2> + <paragraph id="par_id3148518" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MMULT">Calculates the array product of two arrays.</ahelp> 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.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3150798" role="code" xml-lang="en-US">MMULT(Array 1; Array 2)</paragraph> + <paragraph id="par_id3150812" role="paragraph" xml-lang="en-US"><emph>Array 1</emph> represents the first array used in the array product.</paragraph> + <paragraph id="par_id3152553" role="paragraph" xml-lang="en-US"><emph>Array 2</emph> represents the second array with the same number of rows.</paragraph> + <note id="par_idN114C3" localize="false"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3146826" role="paragraph" xml-lang="en-US">Select a square range. Choose the MMULT function. Select <emph>Array 1</emph>, then select <emph>Array 2</emph>. Using the <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. Click <emph>OK</emph>. The output array will appear in the first selected range.</paragraph> +</section> +<section id="Section9"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154970"> +<bookmark_value>TRANSPOSE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MTRANS" id="bm_id3154982" localize="false"/> +<h2 id="hd_id3154970">TRANSPOSE</h2> + <paragraph id="par_id3155276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MTRANS">Transposes the rows and columns of an array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3153843" role="code" xml-lang="en-US">TRANSPOSE(Array)</paragraph> + <paragraph id="par_id3153857" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents the array in the spreadsheet that is to be transposed.</paragraph> + <note id="par_idN11035">You can find a general introduction to using Array functions on top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3159366" role="paragraph" xml-lang="en-US">In 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 <switchinline select="sys"><caseinline select="MAC"><emph>Shift + Command + Enter</emph></caseinline><defaultinline><emph>Shift + Ctrl + Enter</emph></defaultinline></switchinline>. Or, if you are using the <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. The transposed array appears in the selected target range and is protected automatically against changes.</paragraph> +<table id="tbl_id6215816"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN11B3G" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B46" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6C" role="tablehead" localize="false" xml-lang="en-US">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B52" role="tablehead" localize="false" xml-lang="en-US">D</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B69" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B8F" role="tableicontent" localize="false" xml-lang="en-US"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B35" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B1B" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B21" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B38" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B75" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B81" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B7H" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3168518" role="paragraph" xml-lang="en-US">The above table is 2 rows, 4 columns. In order to transpose it, you must select 4 rows, 2 columns. Assuming you want to transpose the above table to the range A7:B10 (4 rows, 2 columns) you must select the entire range and then enter the following:</paragraph> + <paragraph id="par_id3166145" role="code" xml-lang="en-US">TRANSPOSE(A1:D2)</paragraph> + <paragraph id="par_id3178518" role="paragraph" xml-lang="en-US">Then <emph>make sure to enter it as matrix formula with </emph><switchinline select="sys"><caseinline select="MAC"><emph>Shift + Command + Enter</emph></caseinline><defaultinline><emph>Shift + Ctrl + Enter</emph></defaultinline></switchinline>. The result will be as follows:</paragraph> +<table id="tbl_id6215816"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN21B2H" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B38" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B50" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B4G" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B57" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">6</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B70" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">7</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B70" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN31B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN31B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">8</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN51B70" role="tablehead" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN51B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN61B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> +</table> +</section> +<section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3109846"> +<bookmark_value>LINEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RGP" id="bm_id3144716" localize="false"/> +<h2 id="hd_id3109846">LINEST</h2> + <paragraph id="par_id3144733" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RGP">Returns a table of statistics for a straight line that best fits a data set.</ahelp><comment>changed based on https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)</comment></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3152839" role="code" xml-lang="en-US">LINEST(data_Y [; data_X [; linearType [; stats]]])</paragraph> + <paragraph id="par_id3152853" role="paragraph" xml-lang="en-US"><emph>data_Y</emph> is a single row or column range specifying the y coordinates in a set of data points.</paragraph> + <paragraph id="par_id3154428" role="paragraph" xml-lang="en-US"><emph>data_X</emph> is a corresponding single row or column range specifying the x coordinates. If <emph>data_X</emph> is omitted it defaults to <item type="literal">1, 2, 3, ..., n</item>. If there is more than one set of variables <emph>data_X</emph> may be a range with corresponding multiple rows or columns.</paragraph> + <paragraph id="par_id0811200804502119" role="paragraph" xml-lang="en-US">LINEST finds a straight line <item type="literal">y = a + bx</item> 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 <item type="literal">y = a + b1x1 + b2x2 ... + bnxn</item>.</paragraph> + <paragraph id="par_id3154448" role="paragraph" xml-lang="en-US">If <emph>linearType</emph> is FALSE the straight line found is forced to pass through the origin (the constant a is zero; y = bx). If omitted, <emph>linearType</emph> defaults to TRUE (the line is not forced through the origin).</paragraph> + <paragraph id="par_id3154142" role="paragraph" xml-lang="en-US">If <emph>stats</emph> is omitted or FALSE only the top line of the statistics table is returned. If TRUE the entire table is returned.</paragraph> + <paragraph id="par_id0811200804502261" role="paragraph" xml-lang="en-US">LINEST returns a table (array) of statistics as below and must be entered as an array formula (for example by using <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Return</emph> rather than just <emph>Return</emph>).</paragraph> + <paragraph id="par_idN11416" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN116C6" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3154176" role="paragraph" xml-lang="en-US">This 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 <emph>data_Y</emph>. If you want, you can enter other parameters. Select <emph>Array</emph> and click <emph>OK</emph>.</paragraph> + <paragraph id="par_id3155468" role="paragraph" xml-lang="en-US">The results returned by the system (if <emph>stats</emph> = 0), will at least show the slope of the regression line and its intersection with the Y axis. If <emph>stats</emph> does not equal 0, other results are to be displayed.</paragraph> +<h3 id="hd_id3155491">Other LINEST Results:</h3> + <paragraph id="par_id3159291" role="paragraph" xml-lang="en-US">Examine the following examples:</paragraph> +<table id="tbl_id3159305"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3157922" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3157945" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152486" role="tablehead" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152509" role="tablehead" localize="false">D</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152532" role="tablehead" localize="false">E</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153431" role="tablehead" localize="false">F</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153454" role="tablehead" localize="false">G</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154995" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155021" role="paragraph" xml-lang="en-US"><item type="input">x1</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155044" role="paragraph" xml-lang="en-US"><item type="input">x2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3163734" role="paragraph" xml-lang="en-US"><item type="input">y</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3163766" role="paragraph" xml-lang="en-US"><item type="input">LINEST value</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145686" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145713" role="paragraph" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145736" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159427" role="paragraph" localize="false"><item type="input">100</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3159460" role="paragraph" xml-lang="en-US"><item type="input">4,17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159483" role="paragraph" xml-lang="en-US">-<item type="input">3,48</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152381" role="paragraph" xml-lang="en-US"><item type="input">82,33</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3152408" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152435" role="paragraph" localize="false"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152458" role="paragraph" localize="false"><item type="input">9</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155652" role="paragraph" localize="false"><item type="input">105</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3155684" role="paragraph" xml-lang="en-US"><item type="input">5,46</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155707" role="paragraph" xml-lang="en-US"><item type="input">10,96</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155730" role="paragraph" xml-lang="en-US"><item type="input">9,35</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3159506" role="tablehead" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159533" role="paragraph" localize="false"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159556" role="paragraph" localize="false"><item type="input">11</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159579" role="paragraph" localize="false"><item type="input">104</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3159611" role="paragraph" xml-lang="en-US"><item type="input">0,87</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152606" role="paragraph" xml-lang="en-US"><item type="input">5,06</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152629" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3152655" role="tablehead" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152682" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152705" role="paragraph" localize="false"><item type="input">12</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152728" role="paragraph" localize="false"><item type="input">108</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3144352" role="paragraph" xml-lang="en-US"><item type="input">13,21</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144375" role="paragraph" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144398" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3144425" role="tablehead" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144452" role="paragraph" localize="false"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144475" role="paragraph" localize="false"><item type="input">15</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144498" role="paragraph" localize="false"><item type="input">111</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3158233" role="paragraph" xml-lang="en-US"><item type="input">675,45</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158256" role="paragraph" xml-lang="en-US"><item type="input">102,26</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158279" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3158306" role="tablehead" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158333" role="paragraph" localize="false"><item type="input">9</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158356" role="paragraph" localize="false"><item type="input">17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158379" role="paragraph" localize="false"><item type="input">120</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3144560" role="tablehead" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144586" role="paragraph" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144609" role="paragraph" localize="false"><item type="input">19</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144632" role="paragraph" localize="false"><item type="input">133</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3144687" role="paragraph" xml-lang="en-US">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 <emph>Function Wizard</emph>. For the LINEST function to work, you must have marked the <emph>Array</emph> check box in the <emph>Function Wizard</emph>. Next, select the following values in the spreadsheet (or enter them using the keyboard):</paragraph> + <paragraph id="par_id3158020" role="paragraph" xml-lang="en-US"><emph>data_Y</emph> is C2:C8</paragraph> + <paragraph id="par_id3158039" role="paragraph" xml-lang="en-US"><emph>data_X</emph> is A2:B8</paragraph> + <paragraph id="par_id3158058" role="paragraph" xml-lang="en-US"><emph>linearType</emph> and <emph>stats</emph> are both set to 1.</paragraph> + <paragraph id="par_id3158084" role="paragraph" xml-lang="en-US">As soon as you click <emph>OK</emph>, $[officename] Calc will fill the above example with the LINEST values as shown in the example.</paragraph> + <paragraph id="par_id3158106" role="paragraph" xml-lang="en-US">The formula in the <emph>Formula</emph> bar corresponds to each cell of the LINEST array <item type="input">{=LINEST(C2:C8;A2:B8;1;1)}</item>.</paragraph> + <paragraph id="par_id3158128" role="paragraph" xml-lang="en-US"><emph>This represents the calculated LINEST values:</emph></paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158146"> +<bookmark_value>slopes, see also regression lines</bookmark_value> +<bookmark_value>regression lines; LINEST function</bookmark_value> +</bookmark> +<comment>mw made "regression lines" a two level entry</comment> + <paragraph id="par_id3158146" role="paragraph" xml-lang="en-US">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.</paragraph> + <paragraph id="par_id3158184" role="paragraph" xml-lang="en-US">G2: Intersection b with the y axis.</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158204"> +<bookmark_value>standard errors; array functions</bookmark_value> +</bookmark> +<comment>MW changed "standard errors"</comment> + <paragraph id="par_id3158204" role="paragraph" xml-lang="en-US">E3 and F3: The standard error of the slope value.</paragraph> + <paragraph id="par_id3145845" role="paragraph" xml-lang="en-US">G3: The standard error of the intercept</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145859"> +<bookmark_value>RSQ calculations</bookmark_value> +</bookmark> + <paragraph id="par_id3145859" role="paragraph" xml-lang="en-US">E4: RSQ</paragraph> + <paragraph id="par_id3145880" role="paragraph" xml-lang="en-US">F4: The standard error of the regression calculated for the Y value.</paragraph> + <paragraph id="par_id3145894" role="paragraph" xml-lang="en-US">E5: The F value from the variance analysis.</paragraph> + <paragraph id="par_id3145915" role="paragraph" xml-lang="en-US">F5: The degrees of freedom from the variance analysis.</paragraph> + <paragraph id="par_id3145937" role="paragraph" xml-lang="en-US">E6: The sum of the squared deviation of the estimated Y values from their linear mean.</paragraph> + <paragraph id="par_id3145952" role="paragraph" xml-lang="en-US">F6: The sum of the squared deviation of the estimated Y value from the given Y values.</paragraph> + <paragraph id="par_idN11B04" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id1596728"> +<bookmark_value>LOGEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RKP" id="bm_id3146020" localize="false"/> +<h2 id="hd_id3146009">LOGEST</h2> + <paragraph id="par_id3146037" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RKP">This function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).</ahelp><comment>UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003 for bug #i31051#</comment></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163123" role="code" xml-lang="en-US">LOGEST(DataY [; DataX [; FunctionType [; Stats]]])</paragraph> + <paragraph id="par_id3163137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3163155" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3163174" role="paragraph" xml-lang="en-US"><emph>FunctionType</emph> (optional). If Function_Type = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.</paragraph> + <paragraph id="par_id3163196" role="paragraph" xml-lang="en-US"><emph>Stats</emph> (optional). If Stats=0, only the regression coefficient is calculated.</paragraph> + <paragraph id="par_idN118F7" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN11BC3" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3163230" role="paragraph" xml-lang="en-US">See LINEST. However, no square sum will be returned.</paragraph> +</section> +<section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163286"> +<bookmark_value>SUMPRODUCT function</bookmark_value> +<bookmark_value>scalar products</bookmark_value> +<bookmark_value>dot products</bookmark_value> +<bookmark_value>inner products</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMENPRODUKT" id="bm_id3163297" localize="false"/> +<h2 id="hd_id3163286">SUMPRODUCT</h2> + <paragraph id="par_id3163314" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMENPRODUKT">Multiplies corresponding elements in the given arrays, and returns the sum of those products.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163347" role="code" xml-lang="en-US">SUMPRODUCT(Array 1[; Array 2;][...;[Array 255]])</paragraph> + <paragraph id="par_id3163362" role="paragraph" xml-lang="en-US"><emph>Array 1[; Array 2;][...;[Array 255]]</emph> represent arrays whose corresponding elements are to be multiplied.</paragraph> + <paragraph id="par_idN11B19" role="paragraph" xml-lang="en-US">At least one array must be part of the argument list. If only one array is given, all array elements are summed. If more than one array is given, they must all be the same size.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<table id="tbl_id6215704"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN11B2F" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B35" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B3B" role="tablehead" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B41" role="tablehead" localize="false">D</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B48" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B4E" role="tablecontent" localize="false"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B54" role="tablecontent" localize="false"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B5A" role="tablecontent" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B60" role="tablecontent" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B67" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6D" role="tablecontent" localize="false"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B73" role="tablecontent" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B79" role="tablecontent" localize="false"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B7F" role="tablecontent" localize="false"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B86" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B8C" role="tablecontent" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B92" role="tablecontent" localize="false"><item type="input">11</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B98" role="tablecontent" localize="false"><item type="input">12</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B9E" role="tablecontent" localize="false"><item type="input">13</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_idN11BA1" role="paragraph" xml-lang="en-US"><item type="input">=SUMPRODUCT(A1:B3;C1:D3)</item> returns 397.</paragraph> + <paragraph id="par_idN11BA4" role="paragraph" xml-lang="en-US">Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3</paragraph> + <paragraph id="par_idN11BA7" role="paragraph" xml-lang="en-US">You can use SUMPRODUCT to calculate the scalar product of two vectors.</paragraph> + <note id="par_idN11BBC">SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function.</note> + <paragraph id="par_idN11C91" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144842"> +<bookmark_value>SUMX2MY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEX2MY2" id="bm_id3144854" localize="false"/> +<h2 id="hd_id3144842">SUMX2MY2</h2> + <paragraph id="par_id3144871" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2MY2">Returns the sum of the difference of squares of corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3144903" role="code" xml-lang="en-US">SUMX2MY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3144916" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> + <paragraph id="par_id3144936" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array whose elements are to be squared and subtracted.</paragraph> + <paragraph id="par_idN11D6B" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145026"> +<bookmark_value>SUMX2PY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEX2PY2" id="bm_id3145038" localize="false"/> +<h2 id="hd_id3145026">SUMX2PY2</h2> + <paragraph id="par_id3145055" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2PY2">Returns the sum of the sum of squares of corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163404" role="code" xml-lang="en-US">SUMX2PY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3163417" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> + <paragraph id="par_id3163437" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be squared and added.</paragraph> + <paragraph id="par_idN11E45" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163527"> +<bookmark_value>SUMXMY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEXMY2" id="bm_id3163539" localize="false"/> +<h2 id="hd_id3163527">SUMXMY2</h2> + <paragraph id="par_id3163556" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEXMY2">Adds the squares of the variance between corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163588" role="code" xml-lang="en-US">SUMXMY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3163601" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be subtracted and squared.</paragraph> + <paragraph id="par_id3163621" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be subtracted and squared.</paragraph> + <paragraph id="par_idN11F1F" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> +</section> +<section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166062"> +<bookmark_value>TREND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TREND" id="bm_id3166074" localize="false"/> +<h2 id="hd_id3166062">TREND</h2> + <paragraph id="par_id3166091" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TREND">Returns values along a linear trend.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3166122" role="code" xml-lang="en-US">TREND(DataY [; DataX [; NewDataX [; LinearType]]])</paragraph> + <paragraph id="par_id3166137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3166156" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3166176" role="paragraph" xml-lang="en-US"><emph>NewDataX</emph> (optional) represents the array of the X data, which are used for recalculating values.</paragraph> + <paragraph id="par_id3166196" role="paragraph" xml-lang="en-US"><emph>LinearType</emph> (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.</paragraph> + <paragraph id="par_idN11D2F" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN12019" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3166245" role="paragraph" xml-lang="en-US">Select 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 <emph>Array</emph> field, click <emph>OK</emph>. The trend data calculated from the output data is displayed.</paragraph> +</section> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166317"> +<bookmark_value>GROWTH function</bookmark_value> +<bookmark_value>exponential trends in arrays</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATION" id="bm_id3166329" localize="false"/> +<h2 id="hd_id3166317">GROWTH</h2> + <paragraph id="par_id3166346" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VARIATION">Calculates the points of an exponential trend in an array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3166377" role="code" xml-lang="en-US">GROWTH(DataY [; [ DataX ] [; [ NewDataX ] [; FunctionType ] ] ])</paragraph> + <paragraph id="par_id3166392" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3166411" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3173797" role="paragraph" xml-lang="en-US"><emph>NewDataX</emph> (optional) represents the X data array, in which the values are recalculated.</paragraph> + <paragraph id="par_id3173817" role="paragraph" xml-lang="en-US"><emph>FunctionType</emph> (optional). If FunctionType = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.</paragraph> + <paragraph id="par_idN11DFD" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN12113" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3173852" role="paragraph" xml-lang="en-US">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 <emph>DataY</emph>. Enter any other parameters, mark <emph>Array</emph> and click <emph>OK</emph>.</paragraph> +</section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> |