File: find.man

package info (click to toggle)
scilab 2.4-1
  • links: PTS
  • area: non-free
  • in suites: potato, slink
  • size: 55,196 kB
  • ctags: 38,019
  • sloc: ansic: 231,970; fortran: 148,976; tcl: 7,099; makefile: 4,585; sh: 2,978; csh: 154; cpp: 101; asm: 39; sed: 5
file content (41 lines) | stat: -rw-r--r-- 1,000 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
.TH find 1 "April 1993" "Scilab Group" "Scilab Function"
.so ../sci.an
.SH NAME
find - find indices of  boolean vector or matrix true elements
.SH CALLING SEQUENCE
.nf
[ii]=find(x)
[ir,ic]=find(x)
.fi
.SH PARAMETERS
.TP
x 
: a boolean vector or a boolean matrix or a "standard" matrix
.TP
ii, ir, ic
: integer vectors of indices or empty matrices
.SH DESCRIPTION
If \fVx\fR is a boolean matrix,
.LP
\fVii=find(x)\fR returns the vector
of indices \fVi\fR for which \fVx(i)\fR is "true". If no true element
found find returns an empty matrix.
.LP
\fV[ir,ic]=find(x)\fR returns two vectors of indices \fVir\fR (for rows) and \fVic\fR (for columns)
such that \fVx(il(n),ic(n))\fR is "true". If no true element
found find returns  empty matrices in \fVir\fR and \fVic\fR.
.LP
if \fVx\fR is standard matrix \fVfind(x)\fR is interpreted as
\fVfind(x<>0)\fR
.LP
\fVfind([])\fR returns \fV[]\fR
.SH EXAMPLE
.nf
A=rand(1,20);
w=find(A<0.5);
A(w)
w=find(A>100);
.fi
.SH SEE ALSO
boolean, extraction, insertion