=================================================================== RCS file: /home/cvs/OpenXM/src/asir-contrib/packages/doc/gtt_ekn/gtt_ekn-ja.texi,v retrieving revision 1.4 retrieving revision 1.5 diff -u -p -r1.4 -r1.5 --- OpenXM/src/asir-contrib/packages/doc/gtt_ekn/gtt_ekn-ja.texi 2017/03/03 09:00:26 1.4 +++ OpenXM/src/asir-contrib/packages/doc/gtt_ekn/gtt_ekn-ja.texi 2017/03/03 12:02:32 1.5 @@ -1,4 +1,4 @@ -%% $OpenXM: OpenXM/src/asir-contrib/packages/doc/gtt_ekn/gtt_ekn-ja.texi,v 1.3 2016/03/28 23:14:54 takayama Exp $ +%% $OpenXM: OpenXM/src/asir-contrib/packages/doc/gtt_ekn/gtt_ekn-ja.texi,v 1.4 2017/03/03 09:00:26 takayama Exp $ %% ptex -kanji euc gtt_ekn.texi (.texi までつける. platex でなく ptex) %% 以下コメントは @comment で始める. \input texinfo 以降は普通の tex 命令は使えない. \input texinfo @@ -111,6 +111,7 @@ gtt_ekn/test-t1.rr * gtt_ekn.expectation:: * gtt_ekn.setup:: * gtt_ekn.upAlpha:: +* gtt_ekn.cmle:: @end menu @node 超幾何関数E(k,n),,, 2元分割表HGMの関数 @@ -657,6 +658,7 @@ ChangeLog @item 上記のoption を指定しなかった場合次のデフォルト値が用いられる. nps=1. nprm=10. fgp=0. @item option report=1を与えると現在の環境の報告のみを行う. setup(|report=1)の別名としてreport関数を使用することもできる. @item option subprogs=[file1,file2,...] により分散計算の子供プロセスにロードすべきファイル file1, file2, ... を指定する. default は subprogs=["gtt_ekn/childprocess.rr"] である. +@item gtt_ekn.set_debug_mode(Mode) で Ekn_debug の値を設定する. @end itemize @comment --- @example〜@end example は実行例の表示 --- @@ -762,6 +764,67 @@ ChangeLog @end itemize +@comment ********************************************************** +@comment --- ◯◯◯◯ の説明 +@comment --- 個々の関数の説明の開始 --- +@comment --- section 名を正確に --- +@node gtt_ekn.cmle,,, 超幾何関数E(k,n) +@subsection @code{gtt_ekn.cmle} +@comment --- 索引用キーワード +@findex gtt_ekn.cmle + +@table @t +@item gtt_ekn.cmle(@var{u}) u を観測データとするとき, P(U=u | row sum, column sum = these of U) を最大化する, 各セルの確率の近似値を求める. +:: +@end table + +@comment --- 引数の簡単な説明 --- 以下まだ書いてない. +@table @var +@item u 観測データ(分割表) +@item return セルの確率(分割表形式) +@end table + +@comment --- ここで関数の詳しい説明 --- +@comment --- @itemize〜@end itemize は箇条書き --- +@comment --- @bullet は黒点付き --- +@itemize @bullet +@item u を観測データとするとき, P(U=u | row sum, column sum = these of U) を最大化する, 各セルの確率の近似値を求める. +@item optional parameter で algorithm の振る舞い(たとえば有理数を近似して, 分母分子が小さい有理数にする, gradient descent の step幅)を調整すべきだが, これは作業中. 2017.03.03 +@end itemize + +@comment --- @example〜@end example は実行例の表示 --- +例: 2 x 4 分割表. +@example +U=[[1,1,2,3],[1,3,1,1]]; +gtt_ekn.cmle(U); + [[ 1 1 2 3 ] + [ 1 3 1 1 ],[[7,6],[2,4,3,4]], // Data, row sum, column sum + [ 1 67147/183792 120403/64148 48801/17869 ] // probability obtained. + [ 1 1 1 1 ]] +@end example + +例: 上の例は次の関数に. +@example +gtt_ekn.cmle_test3(); +@end example + +@comment --- 参照(リンク)を書く --- +@table @t +@item 参照 +@ref{gtt_ekn.expectation} +@end table + +@comment --- ChangeLog を書く. ソースコードの位置. 変更日時 など CVSサーバを見るため +@noindent +ChangeLog +@itemize @bullet +@item gtt_ekn/mle.rr に本体がある. +@item gtt_ekn.rr の cmle 関数は wrapper. +@end itemize +@comment end cmle. + + + @node modular計算,,, 2元分割表HGMの関数 @chapter modular計算 @@ -883,6 +946,57 @@ ChangeLog @contents @bye @comment --- おまじない終り --- + + +@comment テンプレート. start_of_template. +@comment ********************************************************** +@comment --- ◯◯◯◯ の説明 +@comment --- 個々の関数の説明の開始 --- +@comment --- section 名を正確に --- +@node gtt_ekn.hoge,,, 超幾何関数E(k,n) +@subsection @code{gtt_ekn.hoge} +@comment --- 索引用キーワード +@findex gtt_ekn.hoge + +@table @t +@item gtt_ekn.hoge(@var{i}) +:: +@end table + +@comment --- 引数の簡単な説明 --- 以下まだ書いてない. +@table @var +@item i hage +@item return +@end table + +@comment --- ここで関数の詳しい説明 --- +@comment --- @itemize〜@end itemize は箇条書き --- +@comment --- @bullet は黒点付き --- +@itemize @bullet +@item 説明. +@end itemize + +@comment --- @example〜@end example は実行例の表示 --- +例: +@example +[2221] gtt_ekn.hoge([[1,4],[2,3]]); +@end example + + +@comment --- 参照(リンク)を書く --- +@table @t +@item 参照 +@ref{gtt_ekn.nc} +@ref{gtt_ekn.gmvector} +@end table + +@comment --- ChangeLog を書く. ソースコードの位置. 変更日時 など CVSサーバを見るため +@noindent +ChangeLog +@itemize @bullet +@item +@end itemize +@comment end_of_template // 2 x m 分割表において似た機能を有する関数の利用例を参考までに記載する;