merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / scalc / 01 / 04060107.xhp
blob01450cead8d9e8637dcc663de9615ff612ea37a5
1 <?xml version="1.0" encoding="UTF-8"?>
2 <helpdocument version="1.0">
4 <!--
5 ***********************************************************************
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
11 * OpenOffice.org - a multi-platform office productivity suite
13 * $RCSfile: 04060107.xhp,v $
14 * $Revision: 1.17.4.2 $
16 * This file is part of OpenOffice.org.
18 * OpenOffice.org is free software: you can redistribute it and/or modify
19 * it under the terms of the GNU Lesser General Public License version 3
20 * only, as published by the Free Software Foundation.
22 * OpenOffice.org is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU Lesser General Public License version 3 for more details
26 * (a copy is included in the LICENSE file that accompanied this code).
28 * You should have received a copy of the GNU Lesser General Public License
29 * version 3 along with OpenOffice.org. If not, see
30 * <http://www.openoffice.org/license.html>
31 * for a copy of the LGPLv3 License.
33 ************************************************************************
34 -->
37 <meta>
38 <topic id="textscalc0104060107xml" indexer="include">
39 <title id="tit" xml-lang="en-US">Array Functions</title>
40 <filename>/text/scalc/01/04060107.xhp</filename>
41 </topic>
42 </meta>
43 <body>
44 <bookmark xml-lang="en-US" branch="index" id="bm_id3147273"><bookmark_value>matrices; functions</bookmark_value>
45 <bookmark_value>Function Wizard; arrays</bookmark_value>
46 <bookmark_value>array formulas</bookmark_value>
47 <bookmark_value>inline array constants</bookmark_value>
48 <bookmark_value>formulas;arrays</bookmark_value>
49 <bookmark_value>functions;array functions</bookmark_value>
50 <bookmark_value>editing; array formulas</bookmark_value>
51 <bookmark_value>copying; array formulas</bookmark_value>
52 <bookmark_value>adjusting array ranges</bookmark_value>
53 <bookmark_value>calculating;conditional calculations</bookmark_value>
54 <bookmark_value>matrices; calculations</bookmark_value>
55 <bookmark_value>conditional calculations with arrays</bookmark_value>
56 <bookmark_value>implicit array handling</bookmark_value>
57 <bookmark_value>forced array handling</bookmark_value>
58 </bookmark><comment>mw deleted "creating;"</comment>
59 <paragraph role="heading" id="hd_id3147273" xml-lang="en-US" level="1" l10n="U" oldref="1">Array Functions</paragraph>
60 <paragraph role="paragraph" id="par_id3154744" xml-lang="en-US" l10n="U" oldref="2"><variable id="matrixtext">This category contains the array functions.
61 </variable></paragraph>
62 <paragraph role="heading" id="hd_id3146084" xml-lang="en-US" level="2" l10n="U" oldref="257">What is an Array?</paragraph>
63 <paragraph role="paragraph" id="par_id3154298" xml-lang="en-US" l10n="U" oldref="258"><variable id="wasmatrix">An array is a linked range of cells on a spreadsheet containing values.
64 </variable> A square range of 3 rows and 3 columns is a 3 x 3 array:</paragraph>
65 <table id="tbl_id3151168">
66 <tablerow>
67 <tablecell>
68 </tablecell>
69 <tablecell>
70 <paragraph role="paragraph" id="par_id3154692" xml-lang="en-US" l10n="U" oldref="260">A</paragraph>
71 </tablecell>
72 <tablecell>
73 <paragraph role="paragraph" id="par_id3150117" xml-lang="en-US" l10n="U" oldref="261">B</paragraph>
74 </tablecell>
75 <tablecell>
76 <paragraph role="paragraph" id="par_id3155325" xml-lang="en-US" l10n="U" oldref="262">C</paragraph>
77 </tablecell>
78 </tablerow>
79 <tablerow>
80 <tablecell>
81 <paragraph role="paragraph" id="par_id3153104" xml-lang="en-US" l10n="U" oldref="263">1</paragraph>
82 </tablecell>
83 <tablecell>
84 <paragraph role="paragraph" id="par_id3146996" xml-lang="en-US" l10n="U" oldref="264">
85 <item type="input">7</item>
86 </paragraph>
87 </tablecell>
88 <tablecell>
89 <paragraph role="paragraph" id="par_id3150529" xml-lang="en-US" l10n="U" oldref="265">
90 <item type="input">31</item>
91 </paragraph>
92 </tablecell>
93 <tablecell>
94 <paragraph role="paragraph" id="par_id3148831" xml-lang="en-US" l10n="U" oldref="266">
95 <item type="input">33</item>
96 </paragraph>
97 </tablecell>
98 </tablerow>
99 <tablerow>
100 <tablecell>
101 <paragraph role="paragraph" id="par_id3148943" xml-lang="en-US" l10n="U" oldref="267">2</paragraph>
102 </tablecell>
103 <tablecell>
104 <paragraph role="paragraph" id="par_id3149771" xml-lang="en-US" l10n="U" oldref="268">
105 <item type="input">95</item>
106 </paragraph>
107 </tablecell>
108 <tablecell>
109 <paragraph role="paragraph" id="par_id3158407" xml-lang="en-US" l10n="U" oldref="269">
110 <item type="input">17</item>
111 </paragraph>
112 </tablecell>
113 <tablecell>
114 <paragraph role="paragraph" id="par_id3148806" xml-lang="en-US" l10n="U" oldref="270">
115 <item type="input">2</item>
116 </paragraph>
117 </tablecell>
118 </tablerow>
119 <tablerow>
120 <tablecell>
121 <paragraph role="paragraph" id="par_id3154904" xml-lang="en-US" l10n="U" oldref="271">3</paragraph>
122 </tablecell>
123 <tablecell>
124 <paragraph role="paragraph" id="par_id3150779" xml-lang="en-US" l10n="U" oldref="272">
125 <item type="input">5</item>
126 </paragraph>
127 </tablecell>
128 <tablecell>
129 <paragraph role="paragraph" id="par_id3148449" xml-lang="en-US" l10n="U" oldref="273">
130 <item type="input">10</item>
131 </paragraph>
132 </tablecell>
133 <tablecell>
134 <paragraph role="paragraph" id="par_id3147238" xml-lang="en-US" l10n="U" oldref="274">
135 <item type="input">50</item>
136 </paragraph>
137 </tablecell>
138 </tablerow>
139 </table>
141 <paragraph role="paragraph" id="par_id3153583" xml-lang="en-US" l10n="U" oldref="277">The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells.</paragraph>
142 <paragraph role="heading" id="hd_id3148474" xml-lang="en-US" level="2" l10n="U" oldref="275">What is an array formula?</paragraph>
143 <paragraph role="paragraph" id="par_id3155355" xml-lang="en-US" l10n="U" oldref="276">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>
144 <paragraph role="paragraph" id="par_id3151052" xml-lang="en-US" l10n="U" oldref="278">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>
145 <paragraph role="paragraph" id="par_id3158432" xml-lang="en-US" l10n="U" oldref="279">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">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+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.</paragraph>
146 <paragraph role="paragraph" id="par_id3149156" xml-lang="en-US" l10n="U" oldref="280">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 (&amp;) and comparisons (=, &lt;&gt;, &lt;, &gt;, &lt;=, &gt;=). 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>
147 <paragraph role="paragraph" id="par_id3166456" xml-lang="en-US" l10n="CHG" oldref="326">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>
148 <paragraph role="heading" id="hd_id3150713" xml-lang="en-US" level="3" l10n="U" oldref="281">When do you use array formulas?</paragraph>
149 <paragraph role="paragraph" id="par_id3149787" xml-lang="en-US" l10n="U" oldref="282">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>
150 <paragraph role="paragraph" id="par_id3149798" xml-lang="en-US" l10n="U" oldref="283">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>
151 <paragraph role="heading" id="hd_id3155588" xml-lang="en-US" level="2" l10n="U" oldref="284">Using Array Formulas in $[officename] Calc</paragraph>
152 <paragraph role="paragraph" id="par_id3152876" xml-lang="en-US" l10n="U" oldref="285">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>
153 <paragraph role="heading" id="hd_id3151271" xml-lang="en-US" level="3" l10n="U" oldref="313">Creating Array Formulas</paragraph>
154 <section id="somatrixformel">
155 <paragraph role="paragraph" id="par_id3149102" xml-lang="en-US" l10n="U" oldref="314">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>
156 <paragraph role="paragraph" id="par_id3153392" xml-lang="en-US" l10n="U" oldref="4">If you enter the array formula directly into the cell, you must use the key combination Shift+<switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Enter instead of the Enter key. Only then does the formula become an array formula.</paragraph>
157 <paragraph role="note" id="par_id3151120" xml-lang="en-US" l10n="U" oldref="315">Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces.</paragraph>
158 </section>
159 <paragraph role="paragraph" id="par_id3154342" xml-lang="en-US" l10n="U" oldref="5">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.</paragraph>
160 <paragraph role="heading" id="hd_id8834803" xml-lang="en-US" level="3" l10n="NEW">Using Inline Array Constants in Formulas</paragraph>
161 <paragraph role="paragraph" id="par_id985747" xml-lang="en-US" l10n="NEW">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>
162 <paragraph role="paragraph" id="par_id936613" xml-lang="en-US" l10n="NEW">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>
163 <paragraph role="paragraph" id="par_id1877498" xml-lang="en-US" l10n="NEW">Arrays can not be nested.</paragraph>
164 <paragraph role="paragraph" id="par_id4262520" xml-lang="en-US" l10n="NEW">
165 <emph>Examples:</emph>
166 </paragraph>
167 <paragraph role="code" id="par_id9387493" xml-lang="en-US" l10n="NEW">={1;2;3}</paragraph>
168 <paragraph role="paragraph" id="par_id8207037" xml-lang="en-US" l10n="NEW">An array with one row consisting of the three numbers 1, 2, and 3.</paragraph>
169 <paragraph role="paragraph" id="par_id6757103" xml-lang="en-US" l10n="NEW">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">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter.</paragraph>
170 <paragraph role="code" id="par_id8868068" xml-lang="en-US" l10n="NEW">={1;2;3|4;5;6}</paragraph>
171 <paragraph role="paragraph" id="par_id6626483" xml-lang="en-US" l10n="NEW">An array with two rows and three values in each row.</paragraph>
172 <paragraph role="code" id="par_id5262916" xml-lang="en-US" l10n="NEW">={0;1;2|FALSE;TRUE;"two"}</paragraph>
173 <paragraph role="paragraph" id="par_id1623889" xml-lang="en-US" l10n="NEW">A mixed data array.</paragraph>
174 <paragraph role="code" id="par_id7781914" xml-lang="en-US" l10n="NEW">=SIN({1;2;3})</paragraph>
175 <paragraph role="paragraph" id="par_id300912" xml-lang="en-US" l10n="NEW">Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3.</paragraph>
176 <paragraph role="heading" id="hd_id3148660" xml-lang="en-US" level="3" l10n="U" oldref="316">Editing Array Formulas</paragraph>
177 <list type="ordered">
178 <listitem>
179 <paragraph role="listitem" id="par_id3149241" xml-lang="en-US" l10n="U" oldref="317">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">Command </caseinline><defaultinline>Ctrl </defaultinline></switchinline>+ /, where / is the Division key on the numeric keypad.</paragraph>
180 </listitem>
181 <listitem>
182 <paragraph role="listitem" id="par_id3143274" xml-lang="en-US" l10n="U" oldref="318">Either press F2 or position the cursor in the input line. Both of these actions let you edit the formula.</paragraph>
183 </listitem>
184 <listitem>
185 <paragraph role="listitem" id="par_id3154798" xml-lang="en-US" l10n="U" oldref="319">After you have made changes, press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter.</paragraph>
186 </listitem>
187 </list>
188 <paragraph role="tip" id="par_id3150628" xml-lang="en-US" l10n="U" oldref="334">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.</paragraph>
189 <paragraph role="heading" id="hd_id3145608" xml-lang="en-US" level="3" l10n="U" oldref="320">Copying Array Formulas</paragraph>
190 <list type="ordered">
191 <listitem>
192 <paragraph role="listitem" id="par_id3149585" xml-lang="en-US" l10n="U" oldref="321">Select the cell range or array containing the array formula.</paragraph>
193 </listitem>
194 <listitem>
195 <paragraph role="listitem" id="par_id3154619" xml-lang="en-US" l10n="U" oldref="322">Either press F2 or position the cursor in the input line.</paragraph>
196 </listitem>
197 <listitem>
198 <paragraph role="listitem" id="par_id3150994" xml-lang="en-US" l10n="U" oldref="323">Copy the formula into the input line by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+C.</paragraph>
199 </listitem>
200 <listitem>
201 <paragraph role="listitem" id="par_id3146787" xml-lang="en-US" l10n="U" oldref="324">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.</paragraph>
202 </listitem>
203 <listitem>
204 <paragraph role="listitem" id="par_id3154419" xml-lang="en-US" l10n="U" oldref="325">Paste the formula by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+V in the selected space and confirm it by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter. The selected range now contains the array formula.</paragraph>
205 </listitem>
206 </list>
207 <paragraph role="heading" id="hd_id3154834" xml-lang="en-US" level="3" l10n="U" oldref="328">Adjusting an Array Range</paragraph>
208 <paragraph role="paragraph" id="par_id3148679" xml-lang="en-US" l10n="U" oldref="329">If you want to edit the output array, do the following:</paragraph>
209 <list type="ordered">
210 <listitem>
211 <paragraph role="listitem" id="par_id3151102" xml-lang="en-US" l10n="U" oldref="330">Select the cell range or array containing the array formula.</paragraph>
212 </listitem>
213 <listitem>
214 <paragraph role="listitem" id="par_id3147096" xml-lang="en-US" l10n="U" oldref="331">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>
215 </listitem>
216 </list>
217 <paragraph role="note" id="par_id3150974" xml-lang="en-US" l10n="U" oldref="332">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.</paragraph>
218 <paragraph role="paragraph" id="par_id3146080" xml-lang="en-US" l10n="U" oldref="333">By holding down the <switchinline select="sys"><caseinline select="MAC">Command </caseinline><defaultinline>Ctrl </defaultinline></switchinline>key, you can create a copy of the array formula in the given range.</paragraph>
219 <paragraph role="heading" id="par_idN10D47" xml-lang="en-US" level="3" l10n="NEW">Conditional Array Calculations</paragraph>
220 <paragraph role="paragraph" id="par_idN10D4B" xml-lang="en-US" l10n="NEW">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>
221 <paragraph role="paragraph" id="par_idN10D4E" xml-lang="en-US" l10n="NEW">In the following example, the &gt;0 test of the {=IF(A1:A3&gt;0;"yes";"no")} formula is applied to each cell in the range A1:A3 and the result is copied to the corresponding cell.</paragraph>
222 <table id="tbl_id2511673">
223 <tablerow>
224 <tablecell>
225 </tablecell>
226 <tablecell>
227 <paragraph role="tablehead" id="par_idN10D65" xml-lang="en-US" l10n="NEW">A</paragraph>
228 </tablecell>
229 <tablecell>
230 <paragraph role="tablehead" id="par_idN10D6B" xml-lang="en-US" l10n="NEW">B (formula)</paragraph>
231 </tablecell>
232 <tablecell>
233 <paragraph role="tablehead" id="par_idN10B75" xml-lang="en-US" l10n="NEW">B (result)</paragraph>
234 </tablecell>
235 </tablerow>
236 <tablerow>
237 <tablecell>
238 <paragraph role="tablehead" id="par_idN10D79" xml-lang="en-US" l10n="NEW">1</paragraph>
239 </tablecell>
240 <tablecell>
241 <paragraph role="paragraph" id="par_idN10D80" xml-lang="en-US" l10n="NEW">1</paragraph>
242 </tablecell>
243 <tablecell>
244 <paragraph role="paragraph" id="par_idN10D86" xml-lang="en-US" l10n="NEW">{=IF(A1:A3&gt;0;"yes";"no")}</paragraph>
245 </tablecell>
246 <tablecell>
247 <paragraph role="tablecontent" id="par_idN10D8C" xml-lang="en-US" l10n="NEW">yes</paragraph>
248 </tablecell>
249 </tablerow>
250 <tablerow>
251 <tablecell>
252 <paragraph role="tablehead" id="par_idN10D94" xml-lang="en-US" l10n="NEW">2</paragraph>
253 </tablecell>
254 <tablecell>
255 <paragraph role="paragraph" id="par_idN10D9B" xml-lang="en-US" l10n="NEW">0</paragraph>
256 </tablecell>
257 <tablecell>
258 <paragraph role="paragraph" id="par_idN10DA1" xml-lang="en-US" l10n="NEW">{=IF(A1:A3&gt;0;"yes";"no")}</paragraph>
259 </tablecell>
260 <tablecell>
261 <paragraph role="tablecontent" id="par_idN10DA7" xml-lang="en-US" l10n="NEW">no</paragraph>
262 </tablecell>
263 </tablerow>
264 <tablerow>
265 <tablecell>
266 <paragraph role="tablehead" id="par_idN10DAF" xml-lang="en-US" l10n="NEW">3</paragraph>
267 </tablecell>
268 <tablecell>
269 <paragraph role="paragraph" id="par_idN10DB6" xml-lang="en-US" l10n="NEW">1</paragraph>
270 </tablecell>
271 <tablecell>
272 <paragraph role="paragraph" id="par_idN10DBC" xml-lang="en-US" l10n="NEW">{=IF(A1:A3&gt;0;"yes";"no")}</paragraph>
273 </tablecell>
274 <tablecell>
275 <paragraph role="tablecontent" id="par_idN10DC2" xml-lang="en-US" l10n="NEW">yes</paragraph>
276 </tablecell>
277 </tablerow>
278 </table>
280 <paragraph role="paragraph" id="par_idN10DD0" xml-lang="en-US" l10n="NEW">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>
281 <table id="tbl_id7380291">
282 <tablerow>
283 <tablecell>
284 </tablecell>
285 <tablecell>
286 <paragraph role="tablehead" id="par_idN10DE2" xml-lang="en-US" l10n="NEW">A</paragraph>
287 </tablecell>
288 <tablecell>
289 <paragraph role="tablehead" id="par_idN10DE8" xml-lang="en-US" l10n="NEW">B (formula)</paragraph>
290 </tablecell>
291 <tablecell>
292 <paragraph role="tablehead" id="par_idN10DEE" xml-lang="en-US" l10n="NEW">B (result)</paragraph>
293 </tablecell>
294 <tablecell>
295 <paragraph role="tablehead" id="par_idN10DF4" xml-lang="en-US" l10n="NEW">C (forced array formula)</paragraph>
296 </tablecell>
297 <tablecell>
298 <paragraph role="tablehead" id="par_idN10DFA" xml-lang="en-US" l10n="NEW">C (result)</paragraph>
299 </tablecell>
300 </tablerow>
301 <tablerow>
302 <tablecell>
303 <paragraph role="tablehead" id="par_idN10E02" xml-lang="en-US" l10n="NEW">1</paragraph>
304 </tablecell>
305 <tablecell>
306 <paragraph role="tablecontent" id="par_idN10E09" xml-lang="en-US" l10n="NEW">1</paragraph>
307 </tablecell>
308 <tablecell>
309 <paragraph role="tablecontent" id="par_idN10E0F" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph>
310 </tablecell>
311 <tablecell>
312 <paragraph role="tablecontent" id="par_idN10E17" xml-lang="en-US" l10n="NEW">2</paragraph>
313 </tablecell>
314 <tablecell>
315 <paragraph role="tablecontent" id="par_idN10E1D" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph>
316 </tablecell>
317 <tablecell>
318 <paragraph role="tablecontent" id="par_idN10E25" xml-lang="en-US" l10n="NEW">5</paragraph>
319 </tablecell>
320 </tablerow>
321 <tablerow>
322 <tablecell>
323 <paragraph role="tablehead" id="par_idN10E2D" xml-lang="en-US" l10n="NEW">2</paragraph>
324 </tablecell>
325 <tablecell>
326 <paragraph role="tablecontent" id="par_idN10E34" xml-lang="en-US" l10n="NEW">2</paragraph>
327 </tablecell>
328 <tablecell>
329 <paragraph role="tablecontent" id="par_idN10E3A" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph>
330 </tablecell>
331 <tablecell>
332 <paragraph role="tablecontent" id="par_idN10E42" xml-lang="en-US" l10n="NEW">3</paragraph>
333 </tablecell>
334 <tablecell>
335 <paragraph role="tablecontent" id="par_idN10E48" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph>
336 </tablecell>
337 <tablecell>
338 <paragraph role="tablecontent" id="par_idN10E50" xml-lang="en-US" l10n="NEW">5</paragraph>
339 </tablecell>
340 </tablerow>
341 <tablerow>
342 <tablecell>
343 <paragraph role="tablehead" id="par_idN10E58" xml-lang="en-US" l10n="NEW">3</paragraph>
344 </tablecell>
345 <tablecell>
346 </tablecell>
347 <tablecell>
348 <paragraph role="tablecontent" id="par_idN10E63" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph>
349 </tablecell>
350 <tablecell>
351 <paragraph role="tablecontent" id="par_idN10E6A" xml-lang="en-US" l10n="NEW">#VALUE!</paragraph>
352 </tablecell>
353 <tablecell>
354 <paragraph role="tablecontent" id="par_idN10E70" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph>
355 </tablecell>
356 <tablecell>
357 <paragraph role="tablecontent" id="par_idN10E78" xml-lang="en-US" l10n="NEW">5</paragraph>
358 </tablecell>
359 </tablerow>
360 </table>
362 <sort>
363 <section id="Section14">
364 <bookmark xml-lang="en-US" branch="index" id="bm_id3158446"><bookmark_value>MUNIT function</bookmark_value>
365 </bookmark>
366 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_EINHEITSMATRIX" id="bm_id3151317" localize="false"/>
367 <paragraph role="heading" id="hd_id3158446" xml-lang="en-US" level="2" l10n="U" oldref="12">MUNIT</paragraph>
368 <paragraph role="paragraph" id="par_id3154121" xml-lang="en-US" l10n="U" oldref="13"><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>
369 <paragraph role="heading" id="hd_id3155123" xml-lang="en-US" level="3" l10n="U" oldref="14">Syntax</paragraph>
370 <paragraph role="code" id="par_id3156271" xml-lang="en-US" l10n="U" oldref="15">MUNIT(Dimensions)</paragraph>
371 <paragraph role="paragraph" id="par_id3159390" xml-lang="en-US" l10n="U" oldref="16">
372 <emph>Dimensions</emph> refers to the size of the array unit.</paragraph>
373 <paragraph role="note" id="par_idN10C9B" xml-lang="en-US" l10n="NEW">You can find a general introduction to Array functions at the top of this page.</paragraph>
374 <paragraph role="heading" id="hd_id3156162" xml-lang="en-US" level="3" l10n="U" oldref="17">Example</paragraph>
375 <paragraph role="paragraph" id="par_id3150949" xml-lang="en-US" l10n="U" oldref="18">Select a square range within the spreadsheet, for example, from A1 to E5.</paragraph>
376 <paragraph role="paragraph" id="par_id3151260" xml-lang="en-US" l10n="U" oldref="19">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>
377 <paragraph role="paragraph" id="par_id3150403" xml-lang="en-US" l10n="U" oldref="20">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">Shift+Command+Enter</caseinline><defaultinline>Shift+Ctrl+Enter</defaultinline></switchinline>.</paragraph>
378 <paragraph role="paragraph" id="par_id3156143" xml-lang="en-US" l10n="U" oldref="21">You now see a unit array with a range of A1:E5.</paragraph>
379 <paragraph role="paragraph" id="par_idN10FA7" xml-lang="en-US" l10n="NEW">
380 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
381 </paragraph>
382 </section>
383 <section id="Section13">
384 <bookmark xml-lang="en-US" branch="index" id="bm_id3159084"><bookmark_value>FREQUENCY function</bookmark_value>
385 </bookmark>
386 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_HAEUFIGKEIT" id="bm_id3153883" localize="false"/>
387 <paragraph role="heading" id="hd_id3159084" xml-lang="en-US" level="2" l10n="U" oldref="22">FREQUENCY</paragraph>
388 <paragraph role="paragraph" id="par_id3145777" xml-lang="en-US" l10n="CHG" oldref="23"><ahelp hid="HID_FUNC_HAEUFIGKEIT">Indicates the frequency distribution in a one-column-array.</ahelp> The function counts the number of values in the Data array that are within the values given by the Classes array.</paragraph>
389 <paragraph role="heading" id="hd_id3153347" xml-lang="en-US" level="3" l10n="U" oldref="24">Syntax</paragraph>
390 <paragraph role="code" id="par_id3155498" xml-lang="en-US" l10n="U" oldref="25">FREQUENCY(Data; Classes)</paragraph>
391 <paragraph role="paragraph" id="par_id3154352" xml-lang="en-US" l10n="CHG" oldref="26">
392 <emph>Data</emph> represents the reference to the values to be counted.</paragraph>
393 <paragraph role="paragraph" id="par_id3148402" xml-lang="en-US" l10n="CHG" oldref="27">
394 <emph>Classes</emph> represents the array of the limit values.</paragraph>
395 <paragraph role="note" id="par_idN10D71" xml-lang="en-US" l10n="NEW">You can find a general introduction to Array functions at the top of this page.</paragraph>
396 <paragraph role="heading" id="hd_id3148981" xml-lang="en-US" level="3" l10n="U" oldref="28">Example</paragraph>
397 <paragraph role="paragraph" id="par_id3155904" xml-lang="en-US" l10n="CHG" oldref="219">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, "&gt;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>
398 <table id="tbl_id3150680">
399 <tablerow>
400 <tablecell>
401 </tablecell>
402 <tablecell>
403 <paragraph role="paragraph" id="par_id3155869" xml-lang="en-US" l10n="U" oldref="220">
404 <emph>A</emph>
405 </paragraph>
406 </tablecell>
407 <tablecell>
408 <paragraph role="paragraph" id="par_id3149328" xml-lang="en-US" l10n="U" oldref="221">
409 <emph>B</emph>
410 </paragraph>
411 </tablecell>
412 <tablecell>
413 <paragraph role="paragraph" id="par_id3152467" xml-lang="en-US" l10n="U" oldref="222">
414 <emph>C</emph>
415 </paragraph>
416 </tablecell>
417 </tablerow>
418 <tablerow>
419 <tablecell>
420 <paragraph role="paragraph" id="par_id3154528" xml-lang="en-US" l10n="U" oldref="223">
421 <emph>1</emph>
422 </paragraph>
423 </tablecell>
424 <tablecell>
425 <paragraph role="paragraph" id="par_id3149744" xml-lang="en-US" l10n="U" oldref="224">12</paragraph>
426 </tablecell>
427 <tablecell>
428 <paragraph role="paragraph" id="par_id3147309" xml-lang="en-US" l10n="U" oldref="225">5</paragraph>
429 </tablecell>
430 <tablecell>
431 <paragraph role="paragraph" id="par_id3154199" xml-lang="en-US" l10n="U" oldref="226">1</paragraph>
432 </tablecell>
433 </tablerow>
434 <tablerow>
435 <tablecell>
436 <paragraph role="paragraph" id="par_id3159218" xml-lang="en-US" l10n="U" oldref="227">
437 <emph>2</emph>
438 </paragraph>
439 </tablecell>
440 <tablecell>
441 <paragraph role="paragraph" id="par_id3153263" xml-lang="en-US" l10n="U" oldref="228">8</paragraph>
442 </tablecell>
443 <tablecell>
444 <paragraph role="paragraph" id="par_id3156201" xml-lang="en-US" l10n="U" oldref="229">10</paragraph>
445 </tablecell>
446 <tablecell>
447 <paragraph role="paragraph" id="par_id3147552" xml-lang="en-US" l10n="U" oldref="230">3</paragraph>
448 </tablecell>
449 </tablerow>
450 <tablerow>
451 <tablecell>
452 <paragraph role="paragraph" id="par_id3149174" xml-lang="en-US" l10n="U" oldref="231">
453 <emph>3</emph>
454 </paragraph>
455 </tablecell>
456 <tablecell>
457 <paragraph role="paragraph" id="par_id3151201" xml-lang="en-US" l10n="U" oldref="232">24</paragraph>
458 </tablecell>
459 <tablecell>
460 <paragraph role="paragraph" id="par_id3150245" xml-lang="en-US" l10n="U" oldref="233">15</paragraph>
461 </tablecell>
462 <tablecell>
463 <paragraph role="paragraph" id="par_id3159194" xml-lang="en-US" l10n="U" oldref="234">2</paragraph>
464 </tablecell>
465 </tablerow>
466 <tablerow>
467 <tablecell>
468 <paragraph role="paragraph" id="par_id3146925" xml-lang="en-US" l10n="U" oldref="235">
469 <emph>4</emph>
470 </paragraph>
471 </tablecell>
472 <tablecell>
473 <paragraph role="paragraph" id="par_id3154128" xml-lang="en-US" l10n="U" oldref="236">11</paragraph>
474 </tablecell>
475 <tablecell>
476 <paragraph role="paragraph" id="par_id3151067" xml-lang="en-US" l10n="U" oldref="237">20</paragraph>
477 </tablecell>
478 <tablecell>
479 <paragraph role="paragraph" id="par_id3156033" xml-lang="en-US" l10n="U" oldref="238">3</paragraph>
480 </tablecell>
481 </tablerow>
482 <tablerow>
483 <tablecell>
484 <paragraph role="paragraph" id="par_id3149298" xml-lang="en-US" l10n="U" oldref="239">
485 <emph>5</emph>
486 </paragraph>
487 </tablecell>
488 <tablecell>
489 <paragraph role="paragraph" id="par_id3151382" xml-lang="en-US" l10n="U" oldref="240">5</paragraph>
490 </tablecell>
491 <tablecell>
492 <paragraph role="paragraph" id="par_id3155141" xml-lang="en-US" l10n="U" oldref="241">25</paragraph>
493 </tablecell>
494 <tablecell>
495 <paragraph role="paragraph" id="par_id3145213" xml-lang="en-US" l10n="U" oldref="242">1</paragraph>
496 </tablecell>
497 </tablerow>
498 <tablerow>
499 <tablecell>
500 <paragraph role="paragraph" id="par_id3145268" xml-lang="en-US" l10n="U" oldref="243">
501 <emph>6</emph>
502 </paragraph>
503 </tablecell>
504 <tablecell>
505 <paragraph role="paragraph" id="par_id3163724" xml-lang="en-US" l10n="U" oldref="244">20</paragraph>
506 </tablecell>
507 <tablecell>
508 <paragraph role="paragraph" id="par_id3147132" xml-lang="en-US" l10n="U" oldref="245">&gt;25</paragraph>
509 </tablecell>
510 <tablecell>
511 <paragraph role="paragraph" id="par_id3148903" xml-lang="en-US" l10n="U" oldref="246">1</paragraph>
512 </tablecell>
513 </tablerow>
514 <tablerow>
515 <tablecell>
516 <paragraph role="paragraph" id="par_id3151007" xml-lang="en-US" l10n="U" oldref="247">
517 <emph>7</emph>
518 </paragraph>
519 </tablecell>
520 <tablecell>
521 <paragraph role="paragraph" id="par_id3153294" xml-lang="en-US" l10n="U" oldref="248">16</paragraph>
522 </tablecell>
523 <tablecell>
524 </tablecell>
525 <tablecell>
526 </tablecell>
527 </tablerow>
528 <tablerow>
529 <tablecell>
530 <paragraph role="paragraph" id="par_id3147284" xml-lang="en-US" l10n="U" oldref="249">
531 <emph>8</emph>
532 </paragraph>
533 </tablecell>
534 <tablecell>
535 <paragraph role="paragraph" id="par_id3154914" xml-lang="en-US" l10n="U" oldref="250">9</paragraph>
536 </tablecell>
537 <tablecell>
538 </tablecell>
539 <tablecell>
540 </tablecell>
541 </tablerow>
542 <tablerow>
543 <tablecell>
544 <paragraph role="paragraph" id="par_id3154218" xml-lang="en-US" l10n="U" oldref="251">
545 <emph>9</emph>
546 </paragraph>
547 </tablecell>
548 <tablecell>
549 <paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="252">7</paragraph>
550 </tablecell>
551 <tablecell>
552 </tablecell>
553 <tablecell>
554 </tablecell>
555 </tablerow>
556 <tablerow>
557 <tablecell>
558 <paragraph role="paragraph" id="par_id3149045" xml-lang="en-US" l10n="U" oldref="253">
559 <emph>10</emph>
560 </paragraph>
561 </tablecell>
562 <tablecell>
563 <paragraph role="paragraph" id="par_id3155799" xml-lang="en-US" l10n="U" oldref="254">16</paragraph>
564 </tablecell>
565 <tablecell>
566 </tablecell>
567 <tablecell>
568 </tablecell>
569 </tablerow>
570 <tablerow>
571 <tablecell>
572 <paragraph role="paragraph" id="par_id3155076" xml-lang="en-US" l10n="U" oldref="255">
573 <emph>11</emph>
574 </paragraph>
575 </tablecell>
576 <tablecell>
577 <paragraph role="paragraph" id="par_id3150217" xml-lang="en-US" l10n="U" oldref="256">33</paragraph>
578 </tablecell>
579 <tablecell>
580 </tablecell>
581 <tablecell>
582 </tablecell>
583 </tablerow>
584 </table>
586 <paragraph role="paragraph" id="par_id3150312" xml-lang="en-US" l10n="CHG" oldref="29">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>
587 <paragraph role="paragraph" id="par_idN11269" xml-lang="en-US" l10n="NEW">
588 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
589 </paragraph>
590 </section>
591 <section id="Section12">
592 <bookmark xml-lang="en-US" branch="index" id="bm_id3151030"><bookmark_value>MDETERM function</bookmark_value>
593 <bookmark_value>determinants</bookmark_value>
594 </bookmark>
595 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_MDET" id="bm_id3154057" localize="false"/>
596 <paragraph role="heading" id="hd_id3151030" xml-lang="en-US" level="2" l10n="U" oldref="31">MDETERM</paragraph>
597 <paragraph role="paragraph" id="par_id3154073" xml-lang="en-US" l10n="U" oldref="32"><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>
598 <paragraph role="heading" id="hd_id3156366" xml-lang="en-US" level="3" l10n="U" oldref="33">Syntax</paragraph>
599 <paragraph role="code" id="par_id3156380" xml-lang="en-US" l10n="U" oldref="34">MDETERM(Array)</paragraph>
600 <paragraph role="paragraph" id="par_id3150290" xml-lang="en-US" l10n="U" oldref="35">
601 <emph>Array</emph> represents a square array in which the determinants are defined.</paragraph>
602 <paragraph role="note" id="par_idN11035" xml-lang="en-US" l10n="NEW">You can find a general introduction to using Array functions on top of this page.</paragraph>
603 <paragraph role="paragraph" id="par_idN11333" xml-lang="en-US" l10n="NEW">
604 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
605 </paragraph>
606 </section>
607 <section id="Section11">
608 <bookmark xml-lang="en-US" branch="index" id="bm_id3151348"><bookmark_value>MINVERSE function</bookmark_value>
609 <bookmark_value>inverse arrays</bookmark_value>
610 </bookmark>
611 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_MINV" id="bm_id3151360" localize="false"/>
612 <paragraph role="heading" id="hd_id3151348" xml-lang="en-US" level="2" l10n="U" oldref="39">MINVERSE</paragraph>
613 <paragraph role="paragraph" id="par_id3145569" xml-lang="en-US" l10n="U" oldref="40"><ahelp hid="HID_FUNC_MINV">Returns the inverse array.</ahelp></paragraph>
614 <paragraph role="heading" id="hd_id3156072" xml-lang="en-US" level="3" l10n="U" oldref="41">Syntax</paragraph>
615 <paragraph role="code" id="par_id3156085" xml-lang="en-US" l10n="U" oldref="42">MINVERSE(Array)</paragraph>
616 <paragraph role="paragraph" id="par_id3157849" xml-lang="en-US" l10n="U" oldref="43">
617 <emph>Array</emph> represents a square array that is to be inverted.</paragraph>
618 <paragraph role="paragraph" id="par_idN113EE" xml-lang="en-US" l10n="NEW">
619 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
620 </paragraph>
621 <paragraph role="heading" id="hd_id3157868" xml-lang="en-US" level="3" l10n="U" oldref="44">Example</paragraph>
622 <paragraph role="paragraph" id="par_id3149638" xml-lang="en-US" l10n="U" oldref="45">Select a square range and select MINVERSE. Select the output array, select the <emph>Array</emph> field and click <emph>OK</emph>.</paragraph>
623 </section>
624 <section id="Section10">
625 <bookmark xml-lang="en-US" branch="index" id="bm_id3148546"><bookmark_value>MMULT function</bookmark_value>
626 </bookmark>
627 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_MMULT" id="bm_id3148501" localize="false"/>
628 <paragraph role="heading" id="hd_id3148546" xml-lang="en-US" level="2" l10n="U" oldref="47">MMULT</paragraph>
629 <paragraph role="paragraph" id="par_id3148518" xml-lang="en-US" l10n="U" oldref="48"><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>
630 <paragraph role="heading" id="hd_id3146767" xml-lang="en-US" level="3" l10n="U" oldref="49">Syntax</paragraph>
631 <paragraph role="code" id="par_id3150798" xml-lang="en-US" l10n="U" oldref="50">MMULT(Array; Array)</paragraph>
632 <paragraph role="paragraph" id="par_id3150812" xml-lang="en-US" l10n="U" oldref="51">
633 <emph>Array</emph> at first place represents the first array used in the array product.</paragraph>
634 <paragraph role="paragraph" id="par_id3152553" xml-lang="en-US" l10n="U" oldref="52">
635 <emph>Array</emph> at second place represents the second array with the same number of rows.</paragraph>
636 <paragraph role="note" id="par_idN114C3" xml-lang="en-US" l10n="NEW">
637 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
638 </paragraph>
639 <paragraph role="heading" id="hd_id3152574" xml-lang="en-US" level="3" l10n="U" oldref="53">Example</paragraph>
640 <paragraph role="paragraph" id="par_id3146826" xml-lang="en-US" l10n="U" oldref="54">Select a square range. Choose the MMULT function. Select the first <emph>Array</emph>, then select the second <emph>Array</emph>. Using <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>
641 </section>
642 <section id="Section9">
643 <bookmark xml-lang="en-US" branch="index" id="bm_id3154970"><bookmark_value>TRANSPOSE function</bookmark_value>
644 </bookmark>
645 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_MTRANS" id="bm_id3154982" localize="false"/>
646 <paragraph role="heading" id="hd_id3154970" xml-lang="en-US" level="2" l10n="U" oldref="56">TRANSPOSE</paragraph>
647 <paragraph role="paragraph" id="par_id3155276" xml-lang="en-US" l10n="U" oldref="57"><ahelp hid="HID_FUNC_MTRANS">Transposes the rows and columns of an array.</ahelp></paragraph>
648 <paragraph role="heading" id="hd_id3155294" xml-lang="en-US" level="3" l10n="U" oldref="58">Syntax</paragraph>
649 <paragraph role="code" id="par_id3153843" xml-lang="en-US" l10n="U" oldref="59">TRANSPOSE(Array)</paragraph>
650 <paragraph role="paragraph" id="par_id3153857" xml-lang="en-US" l10n="U" oldref="60">
651 <emph>Array</emph> represents the array in the spreadsheet that is to be transposed.</paragraph>
652 <paragraph role="paragraph" id="par_idN115A5" xml-lang="en-US" l10n="NEW">
653 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
654 </paragraph>
655 <paragraph role="heading" id="hd_id3159352" xml-lang="en-US" level="3" l10n="U" oldref="61">Example</paragraph>
656 <paragraph role="paragraph" id="par_id3159366" xml-lang="en-US" l10n="U" oldref="62">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">Shift+Command+Enter</caseinline><defaultinline>Shift+Ctrl+Enter</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>
657 </section>
658 <section id="Section8">
659 <bookmark xml-lang="en-US" branch="index" id="bm_id3109846"><bookmark_value>LINEST function</bookmark_value>
660 </bookmark>
661 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_RGP" id="bm_id3144716" localize="false"/>
662 <paragraph role="heading" id="hd_id3109846" xml-lang="en-US" level="2" l10n="U" oldref="64">LINEST</paragraph>
663 <paragraph role="paragraph" id="par_id3144733" xml-lang="en-US" l10n="CHG" oldref="65"><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 http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)</comment></paragraph>
664 <paragraph role="heading" id="hd_id3152825" xml-lang="en-US" level="3" l10n="U" oldref="66">Syntax</paragraph>
665 <paragraph role="code" id="par_id3152839" xml-lang="en-US" l10n="U" oldref="67">LINEST(data_Y; data_X; linearType; stats)</paragraph>
666 <paragraph role="paragraph" id="par_id3152853" xml-lang="en-US" l10n="U" oldref="68">
667 <emph>data_Y</emph> is a single row or column range specifying the y coordinates in a set of data points.</paragraph>
668 <paragraph role="paragraph" id="par_id3154428" xml-lang="en-US" l10n="U" oldref="69">
669 <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>
670 <paragraph role="paragraph" id="par_id0811200804502119" xml-lang="en-US" l10n="NEW">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>
671 <paragraph role="paragraph" id="par_id3154448" xml-lang="en-US" l10n="U" oldref="70"> 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>
672 <paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="71">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>
673 <paragraph role="paragraph" id="par_id0811200804502261" xml-lang="en-US" l10n="NEW">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">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Return rather than just Return).</paragraph>
674 <paragraph role="paragraph" id="par_idN11416" xml-lang="en-US" l10n="NEW">
675 <embedvar href="text/scalc/00/00000004.xhp#optional"/>
676 </paragraph>
677 <paragraph role="paragraph" id="par_idN116C6" xml-lang="en-US" l10n="NEW">
678 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
679 </paragraph>
680 <paragraph role="heading" id="hd_id3154162" xml-lang="en-US" level="3" l10n="U" oldref="72">Example</paragraph>
681 <paragraph role="paragraph" id="par_id3154176" xml-lang="en-US" l10n="U" oldref="73">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>
682 <paragraph role="paragraph" id="par_id3155468" xml-lang="en-US" l10n="U" oldref="74">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>
683 <paragraph role="heading" id="hd_id3155491" xml-lang="en-US" level="3" l10n="U" oldref="75">Other LINEST Results:</paragraph>
684 <paragraph role="paragraph" id="par_id3159291" xml-lang="en-US" l10n="U" oldref="76">Examine the following examples:</paragraph>
685 <table id="tbl_id3159305">
686 <tablerow>
687 <tablecell>
688 </tablecell>
689 <tablecell>
690 <paragraph role="paragraph" id="par_id3157922" xml-lang="en-US" l10n="U" oldref="77">A</paragraph>
691 </tablecell>
692 <tablecell>
693 <paragraph role="paragraph" id="par_id3157945" xml-lang="en-US" l10n="U" oldref="78">B</paragraph>
694 </tablecell>
695 <tablecell>
696 <paragraph role="paragraph" id="par_id3152486" xml-lang="en-US" l10n="U" oldref="79">C</paragraph>
697 </tablecell>
698 <tablecell>
699 <paragraph role="paragraph" id="par_id3152509" xml-lang="en-US" l10n="U" oldref="80">D</paragraph>
700 </tablecell>
701 <tablecell>
702 <paragraph role="paragraph" id="par_id3152532" xml-lang="en-US" l10n="U" oldref="81">E</paragraph>
703 </tablecell>
704 <tablecell>
705 <paragraph role="paragraph" id="par_id3153431" xml-lang="en-US" l10n="U" oldref="82">F</paragraph>
706 </tablecell>
707 <tablecell>
708 <paragraph role="paragraph" id="par_id3153454" xml-lang="en-US" l10n="U" oldref="83">G</paragraph>
709 </tablecell>
710 </tablerow>
711 <tablerow>
712 <tablecell>
713 <paragraph role="paragraph" id="par_id3154995" xml-lang="en-US" l10n="U" oldref="84">
714 <emph>1</emph>
715 </paragraph>
716 </tablecell>
717 <tablecell>
718 <paragraph role="paragraph" id="par_id3155021" xml-lang="en-US" l10n="U" oldref="85">
719 <item type="input">x1</item>
720 </paragraph>
721 </tablecell>
722 <tablecell>
723 <paragraph role="paragraph" id="par_id3155044" xml-lang="en-US" l10n="U" oldref="86">
724 <item type="input">x2</item>
725 </paragraph>
726 </tablecell>
727 <tablecell>
728 <paragraph role="paragraph" id="par_id3163734" xml-lang="en-US" l10n="U" oldref="87">
729 <item type="input">y</item>
730 </paragraph>
731 </tablecell>
732 <tablecell>
733 </tablecell>
734 <tablecell>
735 <paragraph role="paragraph" id="par_id3163766" xml-lang="en-US" l10n="U" oldref="88">
736 <item type="input">LIN</item>
737 <item type="input">EST value</item>
738 </paragraph>
739 </tablecell>
740 <tablecell>
741 </tablecell>
742 <tablecell>
743 </tablecell>
744 </tablerow>
745 <tablerow>
746 <tablecell>
747 <paragraph role="paragraph" id="par_id3145686" xml-lang="en-US" l10n="U" oldref="89">
748 <emph>2</emph>
749 </paragraph>
750 </tablecell>
751 <tablecell>
752 <paragraph role="paragraph" id="par_id3145713" xml-lang="en-US" l10n="U" oldref="90">
753 <item type="input">4</item>
754 </paragraph>
755 </tablecell>
756 <tablecell>
757 <paragraph role="paragraph" id="par_id3145736" xml-lang="en-US" l10n="U" oldref="91">
758 <item type="input">7</item>
759 </paragraph>
760 </tablecell>
761 <tablecell>
762 <paragraph role="paragraph" id="par_id3159427" xml-lang="en-US" l10n="U" oldref="92">
763 <item type="input">100</item>
764 </paragraph>
765 </tablecell>
766 <tablecell>
767 </tablecell>
768 <tablecell>
769 <paragraph role="paragraph" id="par_id3159460" xml-lang="en-US" l10n="U" oldref="93">
770 <item type="input">4,17</item>
771 </paragraph>
772 </tablecell>
773 <tablecell>
774 <paragraph role="paragraph" id="par_id3159483" xml-lang="en-US" l10n="U" oldref="94">-<item type="input">3,48</item>
775 </paragraph>
776 </tablecell>
777 <tablecell>
778 <paragraph role="paragraph" id="par_id3152381" xml-lang="en-US" l10n="U" oldref="95">
779 <item type="input">82,33</item>
780 </paragraph>
781 </tablecell>
782 </tablerow>
783 <tablerow>
784 <tablecell>
785 <paragraph role="paragraph" id="par_id3152408" xml-lang="en-US" l10n="U" oldref="96">
786 <emph>3</emph>
787 </paragraph>
788 </tablecell>
789 <tablecell>
790 <paragraph role="paragraph" id="par_id3152435" xml-lang="en-US" l10n="U" oldref="97">
791 <item type="input">5</item>
792 </paragraph>
793 </tablecell>
794 <tablecell>
795 <paragraph role="paragraph" id="par_id3152458" xml-lang="en-US" l10n="U" oldref="98">
796 <item type="input">9</item>
797 </paragraph>
798 </tablecell>
799 <tablecell>
800 <paragraph role="paragraph" id="par_id3155652" xml-lang="en-US" l10n="U" oldref="99">
801 <item type="input">105</item>
802 </paragraph>
803 </tablecell>
804 <tablecell>
805 </tablecell>
806 <tablecell>
807 <paragraph role="paragraph" id="par_id3155684" xml-lang="en-US" l10n="U" oldref="100">
808 <item type="input">5,46</item>
809 </paragraph>
810 </tablecell>
811 <tablecell>
812 <paragraph role="paragraph" id="par_id3155707" xml-lang="en-US" l10n="U" oldref="101">
813 <item type="input">10,96</item>
814 </paragraph>
815 </tablecell>
816 <tablecell>
817 <paragraph role="paragraph" id="par_id3155730" xml-lang="en-US" l10n="U" oldref="102">
818 <item type="input">9,35</item>
819 </paragraph>
820 </tablecell>
821 </tablerow>
822 <tablerow>
823 <tablecell>
824 <paragraph role="paragraph" id="par_id3159506" xml-lang="en-US" l10n="U" oldref="103">
825 <emph>4</emph>
826 </paragraph>
827 </tablecell>
828 <tablecell>
829 <paragraph role="paragraph" id="par_id3159533" xml-lang="en-US" l10n="U" oldref="104">
830 <item type="input">6</item>
831 </paragraph>
832 </tablecell>
833 <tablecell>
834 <paragraph role="paragraph" id="par_id3159556" xml-lang="en-US" l10n="U" oldref="105">
835 <item type="input">11</item>
836 </paragraph>
837 </tablecell>
838 <tablecell>
839 <paragraph role="paragraph" id="par_id3159579" xml-lang="en-US" l10n="U" oldref="106">
840 <item type="input">104</item>
841 </paragraph>
842 </tablecell>
843 <tablecell>
844 </tablecell>
845 <tablecell>
846 <paragraph role="paragraph" id="par_id3159611" xml-lang="en-US" l10n="U" oldref="107">
847 <item type="input">0,87</item>
848 </paragraph>
849 </tablecell>
850 <tablecell>
851 <paragraph role="paragraph" id="par_id3152606" xml-lang="en-US" l10n="U" oldref="108">
852 <item type="input">5,06</item>
853 </paragraph>
854 </tablecell>
855 <tablecell>
856 <paragraph role="paragraph" id="par_id3152629" xml-lang="en-US" l10n="U" oldref="109">
857 <item type="input">#NA</item>
858 </paragraph>
859 </tablecell>
860 </tablerow>
861 <tablerow>
862 <tablecell>
863 <paragraph role="paragraph" id="par_id3152655" xml-lang="en-US" l10n="U" oldref="110">
864 <emph>5</emph>
865 </paragraph>
866 </tablecell>
867 <tablecell>
868 <paragraph role="paragraph" id="par_id3152682" xml-lang="en-US" l10n="U" oldref="111">
869 <item type="input">7</item>
870 </paragraph>
871 </tablecell>
872 <tablecell>
873 <paragraph role="paragraph" id="par_id3152705" xml-lang="en-US" l10n="U" oldref="112">
874 <item type="input">12</item>
875 </paragraph>
876 </tablecell>
877 <tablecell>
878 <paragraph role="paragraph" id="par_id3152728" xml-lang="en-US" l10n="U" oldref="113">
879 <item type="input">108</item>
880 </paragraph>
881 </tablecell>
882 <tablecell>
883 </tablecell>
884 <tablecell>
885 <paragraph role="paragraph" id="par_id3144352" xml-lang="en-US" l10n="U" oldref="114">
886 <item type="input">13,21</item>
887 </paragraph>
888 </tablecell>
889 <tablecell>
890 <paragraph role="paragraph" id="par_id3144375" xml-lang="en-US" l10n="U" oldref="115">
891 <item type="input">4</item>
892 </paragraph>
893 </tablecell>
894 <tablecell>
895 <paragraph role="paragraph" id="par_id3144398" xml-lang="en-US" l10n="U" oldref="116">
896 <item type="input">#NA</item>
897 </paragraph>
898 </tablecell>
899 </tablerow>
900 <tablerow>
901 <tablecell>
902 <paragraph role="paragraph" id="par_id3144425" xml-lang="en-US" l10n="U" oldref="117">
903 <emph>6</emph>
904 </paragraph>
905 </tablecell>
906 <tablecell>
907 <paragraph role="paragraph" id="par_id3144452" xml-lang="en-US" l10n="U" oldref="118">
908 <item type="input">8</item>
909 </paragraph>
910 </tablecell>
911 <tablecell>
912 <paragraph role="paragraph" id="par_id3144475" xml-lang="en-US" l10n="U" oldref="119">
913 <item type="input">15</item>
914 </paragraph>
915 </tablecell>
916 <tablecell>
917 <paragraph role="paragraph" id="par_id3144498" xml-lang="en-US" l10n="U" oldref="120">
918 <item type="input">111</item>
919 </paragraph>
920 </tablecell>
921 <tablecell>
922 </tablecell>
923 <tablecell>
924 <paragraph role="paragraph" id="par_id3158233" xml-lang="en-US" l10n="U" oldref="121">
925 <item type="input">675,45</item>
926 </paragraph>
927 </tablecell>
928 <tablecell>
929 <paragraph role="paragraph" id="par_id3158256" xml-lang="en-US" l10n="U" oldref="122">
930 <item type="input">102,26</item>
931 </paragraph>
932 </tablecell>
933 <tablecell>
934 <paragraph role="paragraph" id="par_id3158279" xml-lang="en-US" l10n="U" oldref="123">
935 <item type="input">#NA</item>
936 </paragraph>
937 </tablecell>
938 </tablerow>
939 <tablerow>
940 <tablecell>
941 <paragraph role="paragraph" id="par_id3158306" xml-lang="en-US" l10n="U" oldref="124">
942 <emph>7</emph>
943 </paragraph>
944 </tablecell>
945 <tablecell>
946 <paragraph role="paragraph" id="par_id3158333" xml-lang="en-US" l10n="U" oldref="125">
947 <item type="input">9</item>
948 </paragraph>
949 </tablecell>
950 <tablecell>
951 <paragraph role="paragraph" id="par_id3158356" xml-lang="en-US" l10n="U" oldref="126">
952 <item type="input">17</item>
953 </paragraph>
954 </tablecell>
955 <tablecell>
956 <paragraph role="paragraph" id="par_id3158379" xml-lang="en-US" l10n="U" oldref="127">
957 <item type="input">120</item>
958 </paragraph>
959 </tablecell>
960 <tablecell>
961 </tablecell>
962 <tablecell>
963 </tablecell>
964 <tablecell>
965 </tablecell>
966 <tablecell>
967 </tablecell>
968 </tablerow>
969 <tablerow>
970 <tablecell>
971 <paragraph role="paragraph" id="par_id3144560" xml-lang="en-US" l10n="U" oldref="128">
972 <emph>8</emph>
973 </paragraph>
974 </tablecell>
975 <tablecell>
976 <paragraph role="paragraph" id="par_id3144586" xml-lang="en-US" l10n="U" oldref="129">
977 <item type="input">10</item>
978 </paragraph>
979 </tablecell>
980 <tablecell>
981 <paragraph role="paragraph" id="par_id3144609" xml-lang="en-US" l10n="U" oldref="130">
982 <item type="input">19</item>
983 </paragraph>
984 </tablecell>
985 <tablecell>
986 <paragraph role="paragraph" id="par_id3144632" xml-lang="en-US" l10n="U" oldref="131">
987 <item type="input">133</item>
988 </paragraph>
989 </tablecell>
990 <tablecell>
991 </tablecell>
992 <tablecell>
993 </tablecell>
994 <tablecell>
995 </tablecell>
996 <tablecell>
997 </tablecell>
998 </tablerow>
999 </table>
1001 <paragraph role="paragraph" id="par_id3144687" xml-lang="en-US" l10n="U" oldref="132">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>
1002 <paragraph role="paragraph" id="par_id3158020" xml-lang="en-US" l10n="U" oldref="133">
1003 <emph>data_Y</emph> is C2:C8</paragraph>
1004 <paragraph role="paragraph" id="par_id3158039" xml-lang="en-US" l10n="U" oldref="134">
1005 <emph>data_X</emph> is A2:B8</paragraph>
1006 <paragraph role="paragraph" id="par_id3158058" xml-lang="en-US" l10n="U" oldref="135">
1007 <emph>linearType</emph> and <emph>stats</emph> are both set to 1.</paragraph>
1008 <paragraph role="paragraph" id="par_id3158084" xml-lang="en-US" l10n="U" oldref="136">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>
1009 <paragraph role="paragraph" id="par_id3158106" xml-lang="en-US" l10n="U" oldref="137">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>
1010 </paragraph>
1011 <paragraph role="paragraph" id="par_id3158128" xml-lang="en-US" l10n="U" oldref="138">
1012 <emph>This represents the calculated LINEST values:</emph>
1013 </paragraph>
1014 <bookmark xml-lang="en-US" branch="index" id="bm_id3158146"><bookmark_value>slopes, see also regression lines</bookmark_value>
1015 <bookmark_value>regression lines;LINEST function</bookmark_value>
1016 </bookmark><comment>mw made "regression lines" a two level entry</comment>
1017 <paragraph role="paragraph" id="par_id3158146" xml-lang="en-US" l10n="U" oldref="139">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>
1018 <paragraph role="paragraph" id="par_id3158184" xml-lang="en-US" l10n="U" oldref="140">G2: Intersection b with the y axis.</paragraph>
1019 <bookmark xml-lang="en-US" branch="index" id="bm_id3158204"><bookmark_value>standard errors;array functions</bookmark_value>
1020 </bookmark><comment>MW changed "standard errors"</comment>
1021 <paragraph role="paragraph" id="par_id3158204" xml-lang="en-US" l10n="U" oldref="141">E3 and F3: The standard error of the slope value.</paragraph>
1022 <paragraph role="paragraph" id="par_id3145845" xml-lang="en-US" l10n="U" oldref="142">G3: The standard error of the intercept</paragraph>
1023 <bookmark xml-lang="en-US" branch="index" id="bm_id3145859"><bookmark_value>RSQ calculations</bookmark_value>
1024 </bookmark>
1025 <paragraph role="paragraph" id="par_id3145859" xml-lang="en-US" l10n="U" oldref="143">E4: RSQ</paragraph>
1026 <paragraph role="paragraph" id="par_id3145880" xml-lang="en-US" l10n="U" oldref="144">F4: The standard error of the regression calculated for the Y value.</paragraph>
1027 <paragraph role="paragraph" id="par_id3145894" xml-lang="en-US" l10n="U" oldref="145">E5: The F value from the variance analysis.</paragraph>
1028 <paragraph role="paragraph" id="par_id3145915" xml-lang="en-US" l10n="U" oldref="146">F5: The degrees of freedom from the variance analysis.</paragraph>
1029 <paragraph role="paragraph" id="par_id3145937" xml-lang="en-US" l10n="U" oldref="147">E6: The sum of the squared deviation of the estimated Y values from their linear mean.</paragraph>
1030 <paragraph role="paragraph" id="par_id3145952" xml-lang="en-US" l10n="U" oldref="148">F6: The sum of the squared deviation of the estimated Y value from the given Y values.</paragraph>
1031 <paragraph role="paragraph" id="par_idN11B04" xml-lang="en-US" l10n="NEW">
1032 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1033 </paragraph>
1034 </section>
1035 <section id="Section7">
1036 <bookmark xml-lang="en-US" branch="index" id="bm_id1596728"><bookmark_value>LOGEST function</bookmark_value>
1037 </bookmark>
1038 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_RKP" id="bm_id3146020" localize="false"/>
1039 <paragraph role="heading" id="hd_id3146009" xml-lang="en-US" level="2" l10n="U" oldref="150">LOGEST</paragraph>
1040 <paragraph role="paragraph" id="par_id3146037" xml-lang="en-US" l10n="U" oldref="151"><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&amp;product=xl2003
1041 for bug #i31051#</comment></paragraph>
1042 <paragraph role="heading" id="hd_id3146056" xml-lang="en-US" level="3" l10n="U" oldref="152">Syntax</paragraph>
1043 <paragraph role="code" id="par_id3163123" xml-lang="en-US" l10n="U" oldref="153">LOGEST(DataY; DataX; FunctionType; Stats)</paragraph>
1044 <paragraph role="paragraph" id="par_id3163137" xml-lang="en-US" l10n="U" oldref="154">
1045 <emph>DataY</emph> represents the Y Data array.</paragraph>
1046 <paragraph role="paragraph" id="par_id3163155" xml-lang="en-US" l10n="U" oldref="155">
1047 <emph>DataX</emph> (optional) represents the X Data array.</paragraph>
1048 <paragraph role="paragraph" id="par_id3163174" xml-lang="en-US" l10n="U" oldref="156">
1049 <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>
1050 <paragraph role="paragraph" id="par_id3163196" xml-lang="en-US" l10n="U" oldref="157">
1051 <emph>Stats</emph> (optional). If Stats=0, only the regression coefficient is calculated.</paragraph>
1052 <paragraph role="paragraph" id="par_idN118F7" xml-lang="en-US" l10n="NEW">
1053 <embedvar href="text/scalc/00/00000004.xhp#optional"/>
1054 </paragraph>
1055 <paragraph role="paragraph" id="par_idN11BC3" xml-lang="en-US" l10n="NEW">
1056 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1057 </paragraph>
1058 <paragraph role="heading" id="hd_id3163216" xml-lang="en-US" level="3" l10n="U" oldref="158">Example</paragraph>
1059 <paragraph role="paragraph" id="par_id3163230" xml-lang="en-US" l10n="CHG" oldref="159">See LINEST. However, no square sum will be returned.</paragraph>
1060 </section>
1061 <section id="Section6">
1062 <bookmark xml-lang="en-US" branch="index" id="bm_id3163286"><bookmark_value>SUMPRODUCT function</bookmark_value>
1063 <bookmark_value>scalar products</bookmark_value>
1064 <bookmark_value>dot products</bookmark_value>
1065 <bookmark_value>inner products</bookmark_value>
1066 </bookmark>
1067 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SUMMENPRODUKT" id="bm_id3163297" localize="false"/>
1068 <paragraph role="heading" id="hd_id3163286" xml-lang="en-US" level="2" l10n="U" oldref="161">SUMPRODUCT</paragraph>
1069 <paragraph role="paragraph" id="par_id3163314" xml-lang="en-US" l10n="U" oldref="162"><ahelp hid="HID_FUNC_SUMMENPRODUKT">Multiplies corresponding elements in the given arrays, and returns the sum of those products.</ahelp></paragraph>
1070 <paragraph role="heading" id="hd_id3163334" xml-lang="en-US" level="3" l10n="U" oldref="163">Syntax</paragraph>
1071 <paragraph role="code" id="par_id3163347" xml-lang="en-US" l10n="U" oldref="164">SUMPRODUCT(Array1; Array2...Array30)</paragraph>
1072 <paragraph role="paragraph" id="par_id3163362" xml-lang="en-US" l10n="CHG" oldref="165">
1073 <emph>Array1, Array2...Array30</emph> represent arrays whose corresponding elements are to be multiplied.</paragraph>
1074 <paragraph role="paragraph" id="par_idN11B19" xml-lang="en-US" l10n="NEW">At least one array must be part of the argument list. If only one array is given, all array elements are summed.</paragraph>
1075 <paragraph role="heading" id="par_idN11B1C" xml-lang="en-US" level="3" l10n="NEW">Example</paragraph>
1076 <table id="tbl_id6215704">
1077 <tablerow>
1078 <tablecell>
1079 </tablecell>
1080 <tablecell>
1081 <paragraph role="tablehead" id="par_idN11B2F" xml-lang="en-US" l10n="NEW">A</paragraph>
1082 </tablecell>
1083 <tablecell>
1084 <paragraph role="tablehead" id="par_idN11B35" xml-lang="en-US" l10n="NEW">B</paragraph>
1085 </tablecell>
1086 <tablecell>
1087 <paragraph role="tablehead" id="par_idN11B3B" xml-lang="en-US" l10n="NEW">C</paragraph>
1088 </tablecell>
1089 <tablecell>
1090 <paragraph role="tablehead" id="par_idN11B41" xml-lang="en-US" l10n="NEW">D</paragraph>
1091 </tablecell>
1092 </tablerow>
1093 <tablerow>
1094 <tablecell>
1095 <paragraph role="tablecontent" id="par_idN11B48" xml-lang="en-US" l10n="NEW">1</paragraph>
1096 </tablecell>
1097 <tablecell>
1098 <paragraph role="tablecontent" id="par_idN11B4E" xml-lang="en-US" l10n="NEW">
1099 <item type="input">2</item>
1100 </paragraph>
1101 </tablecell>
1102 <tablecell>
1103 <paragraph role="tablecontent" id="par_idN11B54" xml-lang="en-US" l10n="NEW">
1104 <item type="input">3</item>
1105 </paragraph>
1106 </tablecell>
1107 <tablecell>
1108 <paragraph role="tablecontent" id="par_idN11B5A" xml-lang="en-US" l10n="NEW">
1109 <item type="input">4</item>
1110 </paragraph>
1111 </tablecell>
1112 <tablecell>
1113 <paragraph role="tablecontent" id="par_idN11B60" xml-lang="en-US" l10n="NEW">
1114 <item type="input">5</item>
1115 </paragraph>
1116 </tablecell>
1117 </tablerow>
1118 <tablerow>
1119 <tablecell>
1120 <paragraph role="tablecontent" id="par_idN11B67" xml-lang="en-US" l10n="NEW">2</paragraph>
1121 </tablecell>
1122 <tablecell>
1123 <paragraph role="tablecontent" id="par_idN11B6D" xml-lang="en-US" l10n="NEW">
1124 <item type="input">6</item>
1125 </paragraph>
1126 </tablecell>
1127 <tablecell>
1128 <paragraph role="tablecontent" id="par_idN11B73" xml-lang="en-US" l10n="NEW">
1129 <item type="input">7</item>
1130 </paragraph>
1131 </tablecell>
1132 <tablecell>
1133 <paragraph role="tablecontent" id="par_idN11B79" xml-lang="en-US" l10n="NEW">
1134 <item type="input">8</item>
1135 </paragraph>
1136 </tablecell>
1137 <tablecell>
1138 <paragraph role="tablecontent" id="par_idN11B7F" xml-lang="en-US" l10n="NEW">
1139 <item type="input">9</item>
1140 </paragraph>
1141 </tablecell>
1142 </tablerow>
1143 <tablerow>
1144 <tablecell>
1145 <paragraph role="tablecontent" id="par_idN11B86" xml-lang="en-US" l10n="NEW">3</paragraph>
1146 </tablecell>
1147 <tablecell>
1148 <paragraph role="tablecontent" id="par_idN11B8C" xml-lang="en-US" l10n="NEW">
1149 <item type="input">10</item>
1150 </paragraph>
1151 </tablecell>
1152 <tablecell>
1153 <paragraph role="tablecontent" id="par_idN11B92" xml-lang="en-US" l10n="NEW">
1154 <item type="input">11</item>
1155 </paragraph>
1156 </tablecell>
1157 <tablecell>
1158 <paragraph role="tablecontent" id="par_idN11B98" xml-lang="en-US" l10n="NEW">
1159 <item type="input">12</item>
1160 </paragraph>
1161 </tablecell>
1162 <tablecell>
1163 <paragraph role="tablecontent" id="par_idN11B9E" xml-lang="en-US" l10n="NEW">
1164 <item type="input">13</item>
1165 </paragraph>
1166 </tablecell>
1167 </tablerow>
1168 </table>
1170 <paragraph role="paragraph" id="par_idN11BA1" xml-lang="en-US" l10n="NEW">
1171 <item type="input">=SUMPRODUCT(A1:B3;C1:D3)</item> returns 397.</paragraph>
1172 <paragraph role="paragraph" id="par_idN11BA4" xml-lang="en-US" l10n="NEW">Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3</paragraph>
1173 <paragraph role="paragraph" id="par_idN11BA7" xml-lang="en-US" l10n="NEW">You can use SUMPRODUCT to calculate the scalar product of two vectors.</paragraph>
1174 <paragraph role="note" id="par_idN11BBC" xml-lang="en-US" l10n="NEW">SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function.</paragraph>
1175 <paragraph role="paragraph" id="par_idN11C91" xml-lang="en-US" l10n="NEW">
1176 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1177 </paragraph>
1178 </section>
1179 <section id="Section5">
1180 <bookmark xml-lang="en-US" branch="index" id="bm_id3144842"><bookmark_value>SUMX2MY2 function</bookmark_value>
1181 </bookmark>
1182 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SUMMEX2MY2" id="bm_id3144854" localize="false"/>
1183 <paragraph role="heading" id="hd_id3144842" xml-lang="en-US" level="2" l10n="U" oldref="169">SUMX2MY2</paragraph>
1184 <paragraph role="paragraph" id="par_id3144871" xml-lang="en-US" l10n="U" oldref="170"><ahelp hid="HID_FUNC_SUMMEX2MY2">Returns the sum of the difference of squares of corresponding values in two arrays.</ahelp></paragraph>
1185 <paragraph role="heading" id="hd_id3144889" xml-lang="en-US" level="3" l10n="U" oldref="171">Syntax</paragraph>
1186 <paragraph role="code" id="par_id3144903" xml-lang="en-US" l10n="U" oldref="172">SUMX2MY2(ArrayX; ArrayY)</paragraph>
1187 <paragraph role="paragraph" id="par_id3144916" xml-lang="en-US" l10n="U" oldref="173">
1188 <emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph>
1189 <paragraph role="paragraph" id="par_id3144936" xml-lang="en-US" l10n="U" oldref="174">
1190 <emph>ArrayY</emph> represents the second array whose elements are to be squared and subtracted.</paragraph>
1191 <paragraph role="paragraph" id="par_idN11D6B" xml-lang="en-US" l10n="NEW">
1192 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1193 </paragraph>
1194 </section>
1195 <section id="Section4">
1196 <bookmark xml-lang="en-US" branch="index" id="bm_id3145026"><bookmark_value>SUMX2PY2 function</bookmark_value>
1197 </bookmark>
1198 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SUMMEX2PY2" id="bm_id3145038" localize="false"/>
1199 <paragraph role="heading" id="hd_id3145026" xml-lang="en-US" level="2" l10n="U" oldref="178">SUMX2PY2</paragraph>
1200 <paragraph role="paragraph" id="par_id3145055" xml-lang="en-US" l10n="U" oldref="179"><ahelp hid="HID_FUNC_SUMMEX2PY2">Returns the sum of the sum of squares of corresponding values in two arrays.</ahelp></paragraph>
1201 <paragraph role="heading" id="hd_id3163390" xml-lang="en-US" level="3" l10n="U" oldref="180">Syntax</paragraph>
1202 <paragraph role="code" id="par_id3163404" xml-lang="en-US" l10n="U" oldref="181">SUMX2PY2(ArrayX; ArrayY)</paragraph>
1203 <paragraph role="paragraph" id="par_id3163417" xml-lang="en-US" l10n="U" oldref="182">
1204 <emph>ArrayX</emph> represents the first array whose arguments are to be squared and added.</paragraph>
1205 <paragraph role="paragraph" id="par_id3163437" xml-lang="en-US" l10n="U" oldref="183">
1206 <emph>ArrayY</emph> represents the second array, whose elements are to be squared and added.</paragraph>
1207 <paragraph role="paragraph" id="par_idN11E45" xml-lang="en-US" l10n="NEW">
1208 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1209 </paragraph>
1210 </section>
1211 <section id="Section3">
1212 <bookmark xml-lang="en-US" branch="index" id="bm_id3163527"><bookmark_value>SUMXMY2 function</bookmark_value>
1213 </bookmark>
1214 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_SUMMEXMY2" id="bm_id3163539" localize="false"/>
1215 <paragraph role="heading" id="hd_id3163527" xml-lang="en-US" level="2" l10n="U" oldref="187">SUMXMY2</paragraph>
1216 <paragraph role="paragraph" id="par_id3163556" xml-lang="en-US" l10n="U" oldref="188"><ahelp hid="HID_FUNC_SUMMEXMY2">Adds the squares of the variance between corresponding values in two arrays.</ahelp></paragraph>
1217 <paragraph role="heading" id="hd_id3163574" xml-lang="en-US" level="3" l10n="U" oldref="189">Syntax</paragraph>
1218 <paragraph role="code" id="par_id3163588" xml-lang="en-US" l10n="U" oldref="190">SUMXMY2(ArrayX; ArrayY)</paragraph>
1219 <paragraph role="paragraph" id="par_id3163601" xml-lang="en-US" l10n="U" oldref="191">
1220 <emph>ArrayX</emph> represents the first array whose elements are to be subtracted and squared.</paragraph>
1221 <paragraph role="paragraph" id="par_id3163621" xml-lang="en-US" l10n="U" oldref="192">
1222 <emph>ArrayY</emph> represents the second array, whose elements are to be subtracted and squared.</paragraph>
1223 <paragraph role="paragraph" id="par_idN11F1F" xml-lang="en-US" l10n="NEW">
1224 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1225 </paragraph>
1226 </section>
1227 <section id="Section2">
1228 <bookmark xml-lang="en-US" branch="index" id="bm_id3166062"><bookmark_value>TREND function</bookmark_value>
1229 </bookmark>
1230 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_TREND" id="bm_id3166074" localize="false"/>
1231 <paragraph role="heading" id="hd_id3166062" xml-lang="en-US" level="2" l10n="U" oldref="196">TREND</paragraph>
1232 <paragraph role="paragraph" id="par_id3166091" xml-lang="en-US" l10n="U" oldref="197"><ahelp hid="HID_FUNC_TREND">Returns values along a linear trend.</ahelp></paragraph>
1233 <paragraph role="heading" id="hd_id3166109" xml-lang="en-US" level="3" l10n="U" oldref="198">Syntax</paragraph>
1234 <paragraph role="code" id="par_id3166122" xml-lang="en-US" l10n="U" oldref="199">TREND(DataY; DataX; NewDataX; LinearType)</paragraph>
1235 <paragraph role="paragraph" id="par_id3166137" xml-lang="en-US" l10n="U" oldref="200">
1236 <emph>DataY</emph> represents the Y Data array.</paragraph>
1237 <paragraph role="paragraph" id="par_id3166156" xml-lang="en-US" l10n="U" oldref="201">
1238 <emph>DataX</emph> (optional) represents the X Data array.</paragraph>
1239 <paragraph role="paragraph" id="par_id3166176" xml-lang="en-US" l10n="U" oldref="202">
1240 <emph>NewDataX</emph> (optional) represents the array of the X data, which are used for recalculating values.</paragraph>
1241 <paragraph role="paragraph" id="par_id3166196" xml-lang="en-US" l10n="U" oldref="203">
1242 <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 &lt;&gt; 0.</paragraph>
1243 <paragraph role="paragraph" id="par_idN11D2F" xml-lang="en-US" l10n="NEW">
1244 <embedvar href="text/scalc/00/00000004.xhp#optional"/>
1245 </paragraph>
1246 <paragraph role="paragraph" id="par_idN12019" xml-lang="en-US" l10n="NEW">
1247 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1248 </paragraph>
1249 <paragraph role="heading" id="hd_id3166231" xml-lang="en-US" level="3" l10n="U" oldref="204">Example</paragraph>
1250 <paragraph role="paragraph" id="par_id3166245" xml-lang="en-US" l10n="U" oldref="205">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>
1251 </section>
1252 <section id="Section1">
1253 <bookmark xml-lang="en-US" branch="index" id="bm_id3166317"><bookmark_value>GROWTH function</bookmark_value>
1254 <bookmark_value>exponential trends in arrays</bookmark_value>
1255 </bookmark>
1256 <bookmark xml-lang="en-US" branch="hid/HID_FUNC_VARIATION" id="bm_id3166329" localize="false"/>
1257 <paragraph role="heading" id="hd_id3166317" xml-lang="en-US" level="2" l10n="U" oldref="207">GROWTH</paragraph>
1258 <paragraph role="paragraph" id="par_id3166346" xml-lang="en-US" l10n="U" oldref="208"><ahelp hid="HID_FUNC_VARIATION">Calculates the points of an exponential trend in an array.</ahelp></paragraph>
1259 <paragraph role="heading" id="hd_id3166364" xml-lang="en-US" level="3" l10n="U" oldref="209">Syntax</paragraph>
1260 <paragraph role="code" id="par_id3166377" xml-lang="en-US" l10n="CHG" oldref="210">GROWTH(DataY; DataX; NewDataX; FunctionType)</paragraph>
1261 <paragraph role="paragraph" id="par_id3166392" xml-lang="en-US" l10n="U" oldref="211">
1262 <emph>DataY</emph> represents the Y Data array.</paragraph>
1263 <paragraph role="paragraph" id="par_id3166411" xml-lang="en-US" l10n="U" oldref="212">
1264 <emph>DataX</emph> (optional) represents the X Data array.</paragraph>
1265 <paragraph role="paragraph" id="par_id3173797" xml-lang="en-US" l10n="U" oldref="213">
1266 <emph>NewDataX</emph> (optional) represents the X data array, in which the values are recalculated.</paragraph>
1267 <paragraph role="paragraph" id="par_id3173817" xml-lang="en-US" l10n="U" oldref="214">
1268 <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>
1269 <paragraph role="paragraph" id="par_idN11DFD" xml-lang="en-US" l10n="NEW">
1270 <embedvar href="text/scalc/00/00000004.xhp#optional"/>
1271 </paragraph>
1272 <paragraph role="paragraph" id="par_idN12113" xml-lang="en-US" l10n="NEW">
1273 <embedvar href="text/scalc/00/00000004.xhp#moreontop"/>
1274 </paragraph>
1275 <paragraph role="heading" id="hd_id3173839" xml-lang="en-US" level="3" l10n="U" oldref="215">Example</paragraph>
1276 <paragraph role="paragraph" id="par_id3173852" xml-lang="en-US" l10n="U" oldref="216">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 DataY. Enter any other parameters, mark <emph>Array</emph> and click <emph>OK</emph>.</paragraph>
1277 </section>
1278 </sort>
1279 <section id="relatedtopics">
1280 <embed href="text/scalc/01/04060100.xhp#drking"/>
1281 </section>
1282 </body>
1283 </helpdocument>