--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2013 - Scilab Enterprises
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution. The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="cross" xml:lang="ja">
+
+ <refnamediv>
+
+ <refname>cross</refname>
+
+ <refpurpose>ベクトル外積</refpurpose>
+
+ </refnamediv>
+
+ <refsynopsisdiv>
+
+ <title>呼び出し手順</title>
+
+ <synopsis>C = cross(A,B)</synopsis>
+
+ </refsynopsisdiv>
+
+ <refsection>
+
+ <title>引数</title>
+
+ <variablelist>
+
+ <varlistentry>
+
+ <term>A</term>
+
+ <listitem>
+
+ <para>実数, 複素数, 多項式または3行N列または1行3列の論理値行列.</para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>B</term>
+
+ <listitem>
+
+ <para>
+
+ 実数, 複素数, 多項式またはAと同じ大きさの論理値行列.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>C</term>
+
+ <listitem>
+
+ <para>
+
+ 実数, 複素数, 多項式またはA及びBと同じ大きさの論理値行列.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ </variablelist>
+
+ </refsection>
+
+ <refsection>
+
+ <title>説明</title>
+
+ <para>
+
+ <function>cross</function> は以下のような
+
+ <varname>A</varname> 及び <varname>B</varname>の外積を返します:
+
+ <para>
+
+ <latex>
+
+ \begin{eqnarray}
+
+ C = A \wedge B
+
+ \end{eqnarray}
+
+ </latex>
+
+ </para>
+
+ </para>
+
+ <para>
+
+ <varname>A</varname> 及び <varname>B</varname> は,
+
+ 通常の行列または疎行列とすることができます.
+
+ しかし,分数行列はサポートされていません.
+
+ 論理値行列の場合,
+
+ <function>cross</function> は%t (または %f)を
+
+ 1 (または 0), '&' (または '|') を
+
+ '*' (または '+') として計算します.
+
+ </para>
+
+ <para>
+
+ 最後に, <varname>A</varname> 及び <varname>B</varname> が
+
+ 3行N列行列の場合, 列毎に計算が行われます.
+
+ </para>
+
+ </refsection>
+
+ <refsection>
+
+ <title>例</title>
+
+ <programlisting role="example"><![CDATA[
+A=[1;2;3];
+B=[2;3;4];
+cross(A,B) // 予測値: [-1;2;-1]
+A=[%i,2,1+%i];
+B=[1,%i,2+%i];
+cross(A,B) // 予測値: [5+%i,2-%i,-3]
+A=[%t;%f;%t];
+B=[%t;%f;%f];
+cross(A,B) // 予測値: [0;1;0]
+ ]]></programlisting>
+
+ </refsection>
+
+ <refsection>
+
+ <title>履歴</title>
+
+ <revhistory>
+
+ <revision>
+
+ <revnumber>5.5.0</revnumber>
+
+ <revremark>関数 cross が導入されました.</revremark>
+
+ </revision>
+
+ </revhistory>
+
+ </refsection>
+
+</refentry>
+
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2013 - Scilab Enterprises - Charlotte HECQUET
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution. The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="num2cell" xml:lang="ja">
+
+ <refnamediv>
+
+ <refname>num2cell</refname>
+
+ <refpurpose>配列をセル配列に変換する</refpurpose>
+
+ </refnamediv>
+
+ <refsynopsisdiv>
+
+ <title>呼び出し手順</title>
+
+ <synopsis>
+
+ y=num2cell(x [,dims])
+
+ </synopsis>
+
+ </refsynopsisdiv>
+
+ <refsection>
+
+ <title>引数</title>
+
+ <variablelist>
+
+ <varlistentry>
+
+ <term>x</term>
+
+ <listitem>
+
+ <para>実数, 整数, 論理値または文字列行列
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>dims</term>
+
+ <listitem>
+
+ <para>正の整数のスカラーまたはベクトル
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>y</term>
+
+ <listitem>
+
+ <para>セル
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ </variablelist>
+
+ </refsection>
+
+ <refsection>
+
+ <title>説明</title>
+
+ <para>
+
+ <function>num2cell</function> は,
+
+ 実数, 整数, 論理値または文字列行列 <varname>x</varname> をセルに変換します.
+
+ <varname>dims</varname>が指定されない場合,
+
+ <varname>y</varname> は <varname>x</varname>と同じ大きさとなります.
+
+ </para>
+
+ <para>
+
+ しかし,<varname>dims</varname> が指定された場合,
+
+ <varname>dims</varname>で指定された
+
+ <varname>x</varname> の次元は1に減らされます.
+
+ 更に, <varname>y</varname> の要素の次元は,
+
+ その数値が<varname>dims</varname> 次元ベクトルである
+
+ <varname>x</varname> の大きさの次元に等しくなります.
+
+ </para>
+
+ <para>
+
+ 例えば,
+
+ size(<varname>x</varname>)=[2 3 4 5 6] および
+
+ <varname>dims</varname>=[2 4]の場合,
+
+ size(<varname>y</varname>)= [2 1 4 1 6] となります,
+
+ 2番目および4番目の要素の大きさは1に減らされます.
+
+ そして, size(<varname>y</varname>(i))= [1 3 1 5 1]
+
+ は 2番目と4番目の次元の大きさが
+
+ <varname>x</varname>の2番目及び4番目の大きさに等しいことを意味します.
+
+ </para>
+
+ </refsection>
+
+ <refsection>
+
+ <title>例</title>
+
+ <programlisting role="example">
+
+ A=[1 2; 3 4]
+
+ num2cell(A)
+
+ M = hypermat([2 3 2 2],1:24)
+
+ c=num2cell(M,[1 2])
+
+ size(c)
+
+ size(c(1).entries)
+
+
+
+ A=["a", "b"; "c" "d"]
+
+ num2cell(A)
+
+ </programlisting>
+
+ </refsection>
+
+ <refsection role="see also">
+
+ <title>参照</title>
+
+ <simplelist type="inline">
+
+ <member>
+
+ <link linkend="cell">cell</link>
+
+ </member>
+
+ <member>
+
+ <link linkend="cell2mat">cell2mat</link>
+
+ </member>
+
+ </simplelist>
+
+ </refsection>
+
+</refentry>
+
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) 2013 - Samuel GOUGEON
+ * Copyright (C) 2009 - Université du Maine - Samuel GOUGEON
+ *
+ * This file must be used under the terms of the CeCILL.
+ * This source file is licensed as described in the file COPYING, which
+ * you should have received as part of this distribution. The terms
+ * are also available at
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+ *
+ -->
+
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="members" xml:lang="ja">
+
+ <refnamediv>
+
+ <refname>members</refname>
+
+ <refpurpose>
+
+ 配列の各要素または他の配列の行または列を数える(及び位置を調べる)
+
+ </refpurpose>
+
+ </refnamediv>
+
+ <refsynopsisdiv>
+
+ <title>呼び出し手順</title>
+
+ <synopsis>
+
+ [nb [,loc]] = members(N, H)
+
+ [nb [,loc]] = members(N, H, "last")
+
+ [nb [,loc]] = members(N, H, "rows"|"cols")
+
+ [nb [,loc]] = members(N, H, "rows"|"cols", "last")
+
+ [nb [,loc]] = members(N, H, "rows"|"cols", "shuffle")
+
+ [nb [,loc]] = members(N, H, "rows"|"cols", "shuffle", "last")
+
+ </synopsis>
+
+ </refsynopsisdiv>
+
+ <refsection>
+
+ <title>引数</title>
+
+ <variablelist>
+
+ <varlistentry>
+
+ <term>N</term>
+
+ <listitem>
+
+ <para>
+
+ Needles: 論理値, 整数エンコードされた数値, 実数または複素数の10進数, 多項式またはテキストの行列またはハイパー行列.
+
+ "rows"または"cols"モードでは,
+
+ ハイパー行列は指定できません.
+
+ 指定した値(または行または列)は<literal>N</literal>の中に
+
+ 複数回配置することができます.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>H</term>
+
+ <listitem>
+
+ <para>
+
+ Haystack:
+
+ <literal>N</literal>と同じデータ型の行列またはハイパー行列.
+
+ "rows" または "cols" モードの場合, ハイパー行列は指定できません.
+
+ <literal>N</literal> および <literal>H</literal>
+
+ はそれぞれ同じ列または行の数を有する必要があります.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>オプション:</term>
+
+ <listitem>
+
+ <para>以下の1から3個のオプションを順を問わず指定可能です:
+
+ <variablelist>
+
+ <varlistentry>
+
+ <term>"last"</term>
+
+ <listitem>
+
+ <para>
+
+ <literal>N</literal>から
+
+ needlesの<literal>H</literal>の位置を<literal>loc</literal>で
+
+ 検索した場合,
+
+ デフォルトで<literal>H</literal>の中でそれぞれが最初に現れる位置が返されます.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>"rows", "cols"</term>
+
+ <listitem>
+
+ <para>
+
+ デフォルトで, <literal>N</literal>の各要素<literal>N(i, j, ...)</literal>
+
+ は <literal>H</literal>の中で検索する際のneedleとみなされます.
+
+ <literal>"rows"</literal> が検索された場合,
+
+ <literal>N</literal>の各行はneedleとみなされ, 全体として,
+
+ <literal>H</literal>の行で検索が行われます.
+
+
+
+ <literal>"cols"</literal> が使用された場合,
+
+ <literal>"cols"</literal>が
+
+ <literal>N</literal> 及び <literal>H</literal>の列に適用されます.
+
+
+
+ <literal>"cols"</literal> を使用した場合,
+
+ <literal>N</literal> 及び <literal>H</literal> の列数と同じ部分に
+
+ 適用されます.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>"shuffle"</term>
+
+ <listitem>
+
+ <para>
+
+ <literal>"rows"</literal>または<literal>"cols"</literal> モードの場合,
+
+ 行/列の要素のデフォルトの順序が考慮されます: 例えば,<literal>N</literal>
+
+ の <literal>[ 7 3 5 ]</literal> は,
+
+ <literal>H</literal>の<literal>[3 5 7]</literal>にマッチしません.
+
+ <literal>"shuffle"</literal> が指定された場合,
+
+
+
+ 例えば<literal>[3 5 7]</literal>の交換は
+
+ <literal>N</literal>の<literal>[3 5 7]</literal>行に一致すると
+
+ みなされます.
+
+ このオプションは多項式の場合,無視されます.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ </variablelist>
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>nb</term>
+
+ <listitem>
+
+ <para>
+
+ 通常モードの場合: <literal>nb(i, j, ...)</literal> は(実数として)
+
+ <literal>H</literal>における<literal>N(i, j, ...)</literal>の出現回数
+
+ を表します.
+
+ <literal>nb</literal> および <literal>N</literal> は同じ形式です.
+
+ <literal>H</literal> が空の場合, ゼロ行列が返されます.
+
+ <literal>N</literal> が空の場合, 空の行列 <literal>[]</literal> が返されます.
+
+ </para>
+
+ <para>
+
+ <literal>"rows"</literal> または <literal>"cols"</literal> モードの場合:
+
+ <literal>nb</literal> は <literal>N</literal> が有する行/列と同じ数の要素を
+
+ 有する実数の行です.
+
+ <literal>nb(i)</literal> は,<literal>H(., :)</literal> の中で
+
+ <literal>N(i, :)</literal> が生じた数
+
+ (または<literal>H(:, .)</literal>の中で<literal>N(:, i)</literal>)を返します.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ <varlistentry>
+
+ <term>loc</term>
+
+ <listitem>
+
+ <para>
+
+ 通常のモードの場合:
+
+ <literal>loc</literal> および<literal>N</literal> は同じ形式を有します.
+
+ <literal>loc(i, j, ...)</literal> は,
+
+ <literal>N(i, j, ...)</literal> がある場所として
+
+ <literal>H</literal>に最小の線形化された添字を返します.
+
+ <literal>"last"</literal>フラグが使用された場合,
+
+ 替りに最大の線形化された添字の最大値が返されます.
+
+ <literal>H</literal>の中に <literal>N(i, j, ...)</literal>が見つかれない場合,
+
+ <literal>loc(i, j, ...)</literal> は <literal>0</literal>に設定されます.
+
+ </para>
+
+ <para>
+
+ <literal>"rows"</literal> または <literal>"cols"</literal> モードの場合:
+
+ <literal>loc</literal> は<literal>N</literal>が有する行及び列と同じ
+
+ 数の要素を有する実数の行です.
+
+ <literal>loc(i)</literal> は,
+
+ <literal>N(i, :)</literal>に一致する最初の
+
+ 行<literal>H(loc(i), :)</literal>の添字
+
+ (または <literal>N(:, i)</literal>に一致する最初の列
+
+ <literal>H(:, loc(i))</literal> の添字)を返します.
+
+ <literal>"shuffle"</literal>フラグが追加で指定された場合,
+
+ 行/列に基づく要素の順番は考慮されません.
+
+ </para>
+
+ </listitem>
+
+ </varlistentry>
+
+ </variablelist>
+
+ </refsection>
+
+ <refsection>
+
+ <title>説明</title>
+
+ <para>
+
+ <literal>nb = members(N, H [,"rows"|"cols"])</literal>
+
+ は各要素または<literal>H</literal>の中にある
+
+ <literal>N</literal>の行または列の発生回数を返します.
+
+ 要素が見つからない場合, 0 が返されます.
+
+
+
+ <literal>N(i,j,...)</literal>が現れる最初(デフォルト)または
+
+ <literal>"last"</literal>(最後)の<literal>H</literal>の
+
+ 添字を,
+
+ 2番目のオプションの出力<literal>loc</literal>により
+
+ 取得できます.
+
+ <literal>"rows"</literal> または <literal>"cols"</literal>
+
+ の一致するものを探す場合,
+
+ オプション<literal>"shuffle"</literal>を使用することにより,
+
+ 一致の際の要素の順番を無視することができます.
+
+ </para>
+
+ <para>
+
+ 値 <literal>%inf</literal> および <literal>-%inf</literal>
+
+ を<literal>N</literal>の中および<literal>H</literal>の中で
+
+ 使用することができます.
+
+ ノーマルモードでは,
+
+ <literal>%nan</literal>が<literal>N</literal>の中では
+
+ サポートされますが,<literal>H</literal>の中ではサポートされません.
+
+ <literal>"rows"</literal> または <literal>"cols"</literal> モードの場合,
+
+ <literal>%nan</literal> はどこでもサポートされます.
+
+ </para>
+
+ <para>
+
+ 通常の要素毎のモードの場合, members(..) は,
+
+ 論理値,
+
+ 整数エンコードされた数値(8-16-32ビット長の符号ありまたは無し)
+
+ および実数を高速に処理するために
+
+ <link linkend="dsearch">dsearch(..)</link> を使用します.
+
+ 複素数, テキスト, 多項式の場合,
+
+ より低速でよりメモリ消費が多いアルゴリズムが使用されます.
+
+ これらのデータ型についてより高い性能を得たい場合,
+
+ より大きな<literal>N</literal>または<literal>H</literal>の場合,
+
+ ユーザは
+
+ <link linkend="stacksize">stacksize(..)</link>を増加させることになります.
+
+ 計算時間が長い場合, 進行状況の棒グラフが表示されます.
+
+ </para>
+
+ </refsection>
+
+ <refsection>
+
+ <title>例</title>
+
+ <programlisting role="example"><![CDATA[
+N = [1 8 4 5 2 1];
+H = [9 7 4 2 1 4];
+
+[nb, loc] = members(N, H, "last")
+// nb = [1 0 2 0 1 1] を返す: 例えば, Hの中に4が2回現れる.
+// そして loc = [5 0 6 0 4 5]: 4が最後に現れるのはHの6番目の位置
+
+[nb, loc] = members(N, H)
+// loc = [5 0 3 0 4 5]を返す: 4が最初に現れるのはHの3番目の位置
+
+// ハイパー行列の場合. 前記の N 及び Hを利用:
+N = matrix(N, [3 1 2]);
+H = matrix(H, [3 1 2]);
+[nb, loc] = members(N, H, "last")
+
+// 整数の場合:
+N = int8(grand(3, 2, "uin", -5, 5));
+H = int8(grand(4, 4, "uin", -5, 5));
+[nb, loc] = members(N, H)
+
+// 多項式の場合 (複素数の係数を指定可能):
+z = %z;
+N = [z (1-z)^2 ; -4 %i*z ];
+H = [2 %i*z -z 3-z z z^3 z];
+[nb, loc] = members(N, H)
+
+// テキストの場合:
+N = [ "Hi" "Hu" "Allo"];
+H = [ "Hello" "Bonjour" "Allo"
+ "Holà" "Allo" "Hallo"
+ "Hi" "Hé" "Salud" ];
+[nb, loc] = members(N, H, "last")
+
+// 行の場合:
+ H = [
+ 3 3 0
+ 4 1 0
+ 2 0 3
+ 0 1 4
+ 3 4 3
+ 0 4 1
+ 3 1 0
+ ];
+ N = [
+ 1 2 3
+ 0 1 4
+ 3 0 3
+ 4 1 0
+ 2 0 2
+ ];
+ N, H
+ [nb, loc] = members(N, H, "rows")
+ [nb, loc] = members(N, H, "rows","last")
+ [nb, loc] = members(N, H, "rows","shuffle") // [4 1 0], [0 1 4] 及び [0 4 1] は同一とみなされる
+
+// 列の場合: 定義済みの N 及び H を利用:
+ N = N.', H = H.'
+ [nb, loc] = members(N, H, "cols", "shuffle")
+
+]]></programlisting>
+
+ </refsection>
+
+ <refsection role="see also">
+
+ <title>参照</title>
+
+ <simplelist type="inline">
+
+ <member>
+
+ <link linkend="dsearch">dsearch</link>
+
+ </member>
+
+ <member>
+
+ <link linkend="intersect">intersect</link>
+
+ </member>
+
+ <member>
+
+ <link linkend="find">find</link>
+
+ </member>
+
+ <member>
+
+ <link linkend="vectorfind">vectorfind</link>
+
+ </member>
+
+ </simplelist>
+
+ </refsection>
+
+ <refsection>
+
+ <title>履歴</title>
+
+ <revhistory>
+
+ <revision>
+
+ <revnumber>5.5.0</revnumber>
+
+ <revremark>members() 関数が導入されました.</revremark>
+
+ </revision>
+
+ </revhistory>
+
+ </refsection>
+
+</refentry>
+
projects / scilab.git / commitdiff