ee40598789cfaa2767d6af180938ddd1540e3ee7
[scilab.git] / scilab / modules / statistics / help / en_US / data_missing_values / nanmin.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2000 - INRIA - Carlos Klimann
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="nanmin">
17     <refnamediv>
18         <refname>nanmin</refname>
19         <refpurpose>min  (ignoring Nan's) </refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Syntax</title>
23         <synopsis>[m,index]=nanmin(x)
24             [m,index]=nanmin(x,'r')
25             [m,index]=nanmin(x,'c')
26         </synopsis>
27     </refsynopsisdiv>
28     <refsection>
29         <title>Arguments</title>
30         <variablelist>
31             <varlistentry>
32                 <term>x</term>
33                 <listitem>
34                     <para>real or complex vector or matrix</para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>Description</title>
41         <para>
42             This function gives for a real or a numerical matrix <literal>x</literal>
43             his largest element <literal>   m</literal> (but ignoring the
44             NANs).
45         </para>
46         <para>
47             For    <literal> x</literal>,   a  numerical   vector  or matrix,
48             <literal> m=nanmin(x) </literal>  returns in scalar  <literal> m</literal> the largest
49             element of <literal> x</literal> (ignoring  the  NANs). The form
50             <literal>[m,index] =nanmin(x,orient) </literal> gives  in addition of  the
51             value of the largest  element of <literal>  x</literal> (ignoring  the
52             NANs) in scalar  <literal> m</literal>, the index  of  this element in
53             <literal> x</literal>, as a 2-vector.
54         </para>
55         <para>
56             <literal>m=nanmin(x,'r') </literal> gives in the 1xsize(x,2) matrix
57             <literal>m</literal> the largest elements  (ignoring  the NANs) of  each
58             column  of     <literal>    x</literal>.     If  the  form
59             <literal> [m,index]=nanmin(x,'r') </literal> is  used, the  elements of the
60             1xsize(x,2) matrix  index are  the indexes of  the largest
61             elements (ignoring the NANs)  of each column  of x  in the
62             corresponding column.
63         </para>
64         <para>
65             m=nanmin(x,'c')  gives  in  the size(x,2)x1  matrix  m the
66             largest elements (ignoring the NANs) of each row of x.  If
67             the form  [m,index]=nanmin(x,'c') is used, the elements of
68             the size(x,2)x1   matrix  index are   the  indexes  of the
69             largest elements  (ignoring the NANs) of  each row of x in
70             the corresponding row.
71         </para>
72         <para>
73             In Labostat, NAN values stand for missing values in tables.
74         </para>
75     </refsection>
76     <refsection>
77         <title>Examples</title>
78         <programlisting role="example"><![CDATA[
79 x=[0.2113249 %nan 0.6653811;0.7560439 0.3303271 0.6283918]
80 m=nanmin(x)
81 m=nanmin(x,'r')
82 m=nanmin(x,'c')
83  ]]></programlisting>
84     </refsection>
85     <refsection>
86         <title>Bibliography</title>
87         <para>
88             Wonacott, T.H. &amp; Wonacott, R.J.; Introductory Statistics, fifth edition, J.Wiley &amp; Sons, 1990.
89         </para>
90     </refsection>
91 </refentry>