7.5 分散計算に関する関数

7.5.1 ox_launch, ox_launch_nox, ox_shutdown

ox_launch([host[,dir],command])

ox_launch_nox([host[,dir],command])

:: 遠隔プロセスの起動および通信を開始する.

ox_shutdown(id)

:: 遠隔プロセスを終了させ, 通信を終了する.

return

整数

host

文字列または 0

dir command

文字列

id

整数

• ox_launch() は, ホスト host 上でコマンド command を起動し, このプロセスと通信を開始する. 引数が 3 つの場合, host 上で, dir にある ‘ox_launch’ というサーバ起動用プログラムを立ち上げる. ‘ox_launch’ は command を起動する. host が 0 の時, Asir が動作している マシン上でコマンドを起動する. 無引数の場合, host は 0, dir は get_rootdir() で返されるディレクトリ, command は同じディレクトリの ‘ox_asir’ を意味する.
• host が 0, すなわちサーバを local に起動する場合には, dir を省略できる. この場合, dir は get_rootdir() で返される ディレクトリとなる.
• command が ‘/’ で始まる文字列の場合, 絶対パスと解釈される. それ以外の場合, dir からの相対パスと解釈される.
• UNIX 版においては, ox_launch() は, command の標準出力, 標準 エラー出力を表示するための ‘xterm’ を起動する. ox_launch_nox() は, X なしの環境の場合, あるいは ‘xterm’ を起動せずにサーバを立ち上げる場合に用いる. この場合, command の出力は ‘/dev/null’ に接続される. ox_launch() の場合でも, 環境変数 DISPLAY が設定されていない 場合には, ox_launch_nox() と同じ動作をする.
• 返される整数は通信のための識別子となる.
• Asir と通信するプロセスは同一のマシン上で動作している必要はない. ま た, 通信におけるバイトオーダは server, client 間での最初の negotiation で決まるため, 相手先のマシンとバイトオーダが異なっていても構わない.
• host にマシン名を指定する場合, 以下の準備が必要である. ここで, Asir の動いているホストを A, 通信相手のプロセス が起動されるホストを B とする.
  1. ホスト B の ‘~/.rhosts’ に, ホスト A のホスト 名を登録する.
  2. ‘ox_plot’ など, X とのコネクションも用いられる場合, Xserver に対し, 必要なホストを authorize させる. xhost で必要なホスト名を追加すればよい.
  3. command によっては, スタックを大量に使用する ものもあるため, ‘.cshrc’ でスタックサイズを大きめ (16MB 程度) に 指定しておくのが安全である. スタックサイズは limit stacksize 16m などと指定する.
• command が, X 上にウインドウを開ける場合, displayが指定されればその文字列を, 省略時には環境変数 DISPLAY の値を用いる.
• 環境変数 ASIR_RSH がセットされている場合, サーバの立ち上げプログラム として‘rsh’ の代わりにこの変数の値が用いられる. 例えば,

  % setenv ASIR_RSH "ssh -f -X -A "
  

  により, サーバの立ち上げに ‘ssh’ が用いられ, X11 の通信が forwarding される. 詳しくは ‘ssh’ のマニュアルを 参照.

• ox_shutdown() は識別子 id に対応する遠隔プロセス を終了させる.
• Asir が正常した場合には全ての入出力ストリームは自動的に閉じられ, 起動されているプロセスは全て終了するが, 異常終了した場合, 遠隔プロセス が終了しない場合もある. Asir が異常終了した場合, 遠隔プロセスを 起動したマシン上で ps などを起動して, もし Asir から起動 したプロセスが残っている場合, kill する必要がある.
• log 表示用 ‘xterm’ は ‘-name ox_term’ オプションで起動される. よって, ‘ox_term’ なるリソース名に対して ‘xterm’ のリソース設定 を行えば, log 用 ‘xterm’ の挙動のみを変えることができる. 例えば,

  ox_xterm*iconic:on
  ox_xterm*scrollBar:on
  ox_xterm*saveLines:1000
  

  により, icon で起動, scrollbar つき, scrollbar で参照できる行数 が最大 1000 行, という指定ができる.

[219] ox_launch();
0
[220] ox_rpc(0,"fctr",x^10-y^10);      
0
[221] ox_pop_local(0);
[[1,1],[x^4+y*x^3+y^2*x^2+y^3*x+y^4,1],
[x^4-y*x^3+y^2*x^2-y^3*x+y^4,1],[x-y,1],[x+y,1]]
[222] ox_shutdown(0);    
0

参照

ox_rpc, ox_cmo_rpc, ox_execute_string, ox_pop_cmo, ox_pop_local, ifplot, conplot, plot, polarplot, plotover

7.5.2 ox_launch_generic

ox_launch_generic(host,launch,server,use_unix,use_ssh,use_x,conn_to_serv)

:: 遠隔プロセスの起動および通信を開始する.

return

整数

host

文字列または 0

launcher server

文字列

use_unix use_ssh use_x conn_to_serv

整数

• ox_launch_generic() は, ホスト host 上で, コントロールプロセス launch および サーバプロセス server を起動する. その他の引数は, 使用する protocol の種類, X の使用/不使用, rsh/ssh によるプロセス起動, connect 方法の指定などを行うスイッチである.
• host が 0 の場合, Asir が動作しているマシン上に, launch, server を立ち上げる. この場合, use_unix の値にかかわらず, UNIX internal protocol が用いられる.
• use_unix が 1 の場合, UNIX internal protocol を用いる. 0 の場合, Internet protocol を用いる.
• use_ssh が 1 の場合, ‘ssh’ (Secure Shell) によりコントロール, サーバプロセスを立ち上げる. ‘ssh-agent’ などを利用していな場合, パスワードの入力が必要となる. 相手先で ‘sshd’ が動いていない場合, 自動的に ‘rsh’ が用いられるが, パスワードが必要となる場合には, その場で起動に失敗する.
• use_x が 1 の場合, X 上での動作を仮定し, 設定されている DISPLAY変 数を用いて, log 表示用 ‘xterm’ のもとで server が起動され る. DISPLAY 変数がセットされていない場合には, 自動的に X なしの設定とな る. DISPLAY が不適切にセットされている場合には, コントロール, サーバがハ ングするので要注意である.
• conn_to_serv が 1 の場合, Asir (client) が生成したポートに 対し, client が bind,listen し, 起動されたプロセスが connect する. conn_to_serv が 0 の場合, 起動されたプロセスが bind, listen し, client が connect する.

[342] LIB=get_rootdir();
/export/home/noro/ca/Kobe/build/OpenXM/lib/asir
[343] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",0,0,0,0);
1
[344] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",1,0,0,0);
2
[345] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",1,1,0,0);
3
[346] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",1,1,1,0);
4
[347] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",1,1,1,1);
5
[348] ox_launch_generic(0,LIB+"/ox_launch",LIB+"/ox_asir",1,1,0,1);
6

参照

ox_launch, ox_launch_nox, ox_shutdown, ox_launch_generic

7.5.3 generate_port, try_bind_listen, try_connect, try_accept, register_server

generate_port([use_unix])

:: port の生成

try_bind_listen(port)

:: port に対して bind, listen

try_connect(host,port)

:: port に対して connect

try_accept(socket,port)

:: connect 要求を accept

register_server(control_socket,control_port,server_socket,server_port)

:: connection の成立した control socket, server socket の登録

return

generate_port() のみ整数または文字列. その他は整数.

use_unix

0 または 1

host

文字列

port control_port server_port

整数または文字列

socket control_socket server_socket

整数

• これらの関数は, 遠隔プロセスと通信を成立させるためのプリミティブである.
• generate_port() は通信のための port を生成する. 無引数あるいは 引数が 0 の場合, Internet domain の socket のための port 番号, それ 以外の場合には, UNIX domain (host-internal protocol) のための, ファイル名 を生成する. port 番号は random に生成されるが, その port が使用中でない 保証はない.
• try_bind_listen() は, 与えられた port に対し, その protocol に 対応した socket を生成し, bind, listen する. 成功した場合, socket 識別子を返す. 失敗した場合, -1 が返る.
• try_connect() は, ホスト host の port port に対し connect を試みる. 成功した場合, socket 識別子を返す. 失敗した場合 -1 が返る.
• try_accept() は, socket に対する connect 要求を accept し, 新たに生成された socket を返す. 失敗した場合 -1 が返る. いずれの場合にも, socket は自動的に close される. 引数 port は, socket の protocol を判別するために与える.
• register_server() は, control, server それぞれの socket を 一組にして, server list に登録し, ox_push_cmo() などで用いる プロセス識別子を返す.
• 遠隔プロセスの起動は, shell() または手動で行う.

[340] CPort=generate_port();
39896
[341] SPort=generate_port();
37222
[342] CSocket=try_bind_listen(CPort);
3
[343] SSocket=try_bind_listen(SPort);
5

/*
ここで, ox_launch を起動 :
%  ox_launch "127.1" 0 39716 37043 ox_asir "shio:0"
*/

[344] CSocket=try_accept(CSocket,CPort);
6
[345] SSocket=try_accept(SSocket,SPort);  
3
[346] register_server(CSocket,CPort,SSocket,SPort);
0

参照

ox_launch, ox_launch_nox, ox_shutdown, ox_launch_generic, shell, ox_push_cmo, ox_push_local

7.5.4 ‘ox_asir’

‘ox_asir’ は, Asir のほぼ全ての機能を OpenXM サーバ として提供する. ‘ox_asir’ は, ox_launch または ox_launch_nox で 起動する. 後者は X 環境を用いない場合のために用意されている.

[5] ox_launch();
0

[5] ox_launch_nox("127.0.0.1","/usr/local/lib/asir",
"/usr/local/lib/asir/ox_asir");
0

[7] RemoteLibDir = "/usr/local/lib/asir/"$
[8] Machines = ["sumire","rokkaku","genkotsu","shinpuku"];
[sumire,rokkaku,genkotsu,shinpuku]
[9] Servers = map(ox_launch,Machines,RemoteLibDir,
RemoteLibDir+"ox_asir");
[0,1,2,3]

参照

ox_launch, ox_launch_nox, ox_shutdown

7.5.5 ox_rpc, ox_cmo_rpc, ox_execute_string

ox_rpc(number,"func",arg0,...)

ox_cmo_rpc(number,"func",arg0,...)

ox_execute_string(number,"command",...)

:: プロセスの函数呼び出し

return

0

number

数 (プロセス識別子)

func

函数名

command

文字列

arg0 ...

任意 (引数)

• 識別子 number のプロセスの函数を呼び出す.
• 函数の計算終了を待たず, 直ちに 0 を返す.
• ox_rpc() は, サーバが ‘ox_asir’ の場合のみ用いることができる. それ以外の場合は, ox_cmo_rpc() を用いる.
• 函数が返す値は ox_pop_local(), ox_pop_cmo() により取り出す.
• サーバが ‘ox_asir’ 以外のもの (例えば Kan サーバ ‘ox_sm1’など) の場合には, Open_XM プロトコルでサポートされているデータのみを 送ることができる.
• ox_execute_string は, 送った文字列 command をサーバが自らの ユーザ言語パーザで解析し, 評価した結果をサーバのスタックに置くように 指示する.

[234] ox_cmo_rpc(0,"dp_ht",dp_ptod((x+y)^10,[x,y]));
0
[235] ox_pop_cmo(0);
(1)*<<10,0>>
[236] ox_execute_string(0,"12345 % 678;");
0
[237] ox_pop_cmo(0);
141

参照

ox_pop_cmo, ox_pop_local

7.5.6 ox_reset,ox_intr,register_handler

ox_reset(number)

:: プロセスのリセット

ox_intr(number)

:: プロセスのに SIGINT 送付

register_handler(func)

:: プロセスのリセットのための関数登録

return

1

number

数 (プロセス識別子)

func

関数子または 0

• ox_reset() は, 識別子 number のプロセスをリセットし, コマン ド受け付け状態にする.
• そのプロセスが既に書き出した, あるいは現在書き出し中のデータがある場合, それを全部読み出し, 出力バッファを空にした時点で戻る.
• 子プロセスが RUN 状態の場合でも, 割り込みにより強制的に計算を終了させる.
• 分散計算を行う函数の先頭で, 使用するプロセスに対して実行する. あるいは 計算途中での強制中断に用いる.
• ox_intr() は, 識別子 number のプロセスをに対して SIGINT を送付する. SIGINT に対するプロセスの動作は 規定されていないが, ‘ox_asir’ の場合, ただちに debug mode に 入る. X 上で動作している場合, デバッグコマンド入力用のウィンドウが ポップアップする.
• register_handler() は, C-c などによる割り込みの際に, u を指定することで, 無引数ユーザ定義関数 func() が呼び出される ように設定する. この関数に, ox_reset() を呼び出させることで, 割り込みの際に自動的に OpenXM server のリセットを行うことができる.
• func に 0 を指定することで, 設定を解除できる.

[10] ox_launch();
0
[11] ox_rpc(0,"fctr",x^100-y^100);
0
[12] ox_reset(0); /* xterm のウィンドウには                             */
1                 /* usr1 : return to toplevel by SIGUSR1 が表示される. */

[340] Procs=[ox_launch(),ox_launch()];
[0,1]
[341] def reset() { extern Procs; map(ox_reset,Procs);}
[342] map(ox_rpc,Procs,"fctr",x^100-y^100);
[0,0]
[343] register_handler(reset);
1
[344] interrupt ?(q/t/c/d/u/w/?) u
Abort this computation? (y or n) y
Calling the registered exception handler...done.
return to toplevel

参照

ox_rpc, ox_cmo_rpc, ox_execute_string

7.5.7 ox_push_cmo, ox_push_local

ox_push_cmo(number,obj)

ox_push_local(number,obj)

:: obj を識別子 number のプロセスに送信

return

0

number

数(プロセス識別子)

obj

オブジェクト

• 識別子 number のプロセスに obj を送信する.
• ox_push_cmo は, Asir 以外の Open_XM サーバに送信 する際に用いる.
• ox_push_local は, ‘ox_asir’, ‘ox_plot’ に データを送る場合に用いることができる.
• バッファがいっぱいにならない限り, ただちに復帰する.

参照

ox_rpc, ox_cmo_rpc, ox_execute_string, ox_pop_cmo, ox_pop_local

7.5.8 ox_pop_cmo, ox_pop_local

ox_pop_local(number)

:: プロセス識別子 number からデータを受信する.

return

受信データ

number

数 (プロセス識別子)

• プロセス識別子 number のプロセスからデータを受信する.
• ox_pop_cmo は, Asir 以外の Open_XM サーバから受信 する際に用いる.
• ox_pop_local は, ‘ox_asir’, ‘ox_plot’ から データを受け取る場合に用いることができる.
• サーバが計算中の場合ブロックする. これを避けるためには, ox_push_cmd で SM_popCMO (262) または SM_popSerializedLocalObject (258) を送っておき, ox_select でプロセスが ready になっていることを確かめてから ox_get すればよい.

[341] ox_cmo_rpc(0,"fctr",x^2-1);
0
[342] ox_pop_cmo(0);
[[1,1],[x-1,1],[x+1,1]]
[343] ox_cmo_rpc(0,"newvect",3);
0
[344] ox_pop_cmo(0);
error([41,cannot convert to CMO object])
[345] ox_pop_local(0);
[ 0 0 0 ]

参照

ox_rpc, ox_cmo_rpc, ox_execute_string, ox_push_cmd, ox_sync, ox_select, ox_get

7.5.9 ox_push_cmd, ox_sync

ox_push_cmd(number,command)

:: プロセス識別子 number のプロセスにコマンド command を送信する.

ox_sync(number)

:: プロセス識別子 number のプロセスに OX_SYNC_BALL を送信する.

return

0

number

数 (プロセス識別子)

command

数 (コマンド識別子)

• 識別子 number のプロセスにコマンドまたは OX_SYNC_BALL を送信する.
• Open_XM において送受信データは OX_DATA, OX_COMMAND, OX_SYNC_BALLの 3 種類に分かれる. 通常, コマンドは何らかの操作に 付随して暗黙のうちに送信されるが, これをユーザが個別に送りたい場合に 用いられる.
• OX_SYNC_BALL は ox_reset による計算中断, 復帰の際に送受信される が, これを個別に送りたい場合に用いる. なお, 通常状態では OX_SYNC_BALL は無視される.

[3] ox_rpc(0,"fctr",x^100-y^100);
0
[4] ox_push_cmd(0,258);
0
[5] ox_select([0]);
[0]
[6] ox_get(0);
[[1,1],[x^2+y^2,1],[x^4-y*x^3+y^2*x^2-y^3*x+y^4,1],...]

参照

ox_rpc, ox_cmo_rpc, ox_execute_string, ox_reset,ox_intr,register_handler

7.5.10 ox_get

ox_get(number)

:: プロセス識別子 number のプロセスからデータを受信する.

return

受信データ

number

数(プロセス識別子)

• プロセス識別子 number のプロセスからデータを受信する. 既に ストリーム上にデータがあることを仮定している.
• ox_push_cmd と組み合わせて用いる.
• ox_pop_cmo, ox_pop_local は, ox_push_cmd と ox_get の組み合わせで実現されている.

[11] ox_push_cmo(0,123);
0
[12] ox_push_cmd(0,262); /* 262=OX_popCMO */
0
[13] ox_get(0);
123

参照

ox_pop_cmo, ox_pop_local, ox_push_cmd, ox_sync

7.5.11 ox_pops

ox_pops(number[,nitem])

:: プロセス識別子 number のプロセスのスタックからデータを取り除く.

return

0

number

数 (プロセス識別子)

nitem

自然数

• プロセス識別子 number のプロセスのスタックからデータを取り除く. nitem が指定されている場合は nitem 個, 指定のない場合は 1 個取り除く.

[69] for(I=1;I<=10;I++)ox_push_cmo(0,I);
[70] ox_pops(0,4);  
0
[71] ox_pop_cmo(0);
6

参照

ox_pop_cmo, ox_pop_local

7.5.12 ox_select

ox_select(nlist[,timeout])

:: 読み出し可能なプロセスの識別子を返す.

return

リスト

nlist

数 (子プロセス識別子) のリスト

timeout

数

• 識別子リスト nlist のプロセスのうち既に出力を返している プロセスの識別子リストを返す.
• 全てのプロセスが RUN 状態のとき, いずれかのプロセスの終了を待つ. 但し, timeout が指定されている場合, timeout 秒だけ待つ.
• ox_push_cmd() で SM_popCMO あるいは SM_popSerializedLocalObject を送っておき, ox_select() で ready 状態のプロセスを調べてox_get() することで, ox_pop_local(), ox_pop_cmo()で待ち状態に入るのを防ぐことが できる.

ox_launch();
0
[220] ox_launch();
1
[221] ox_launch();
2
[222] ox_rpc(2,"fctr",x^500-y^500);
0
[223] ox_rpc(1,"fctr",x^100-y^100);
0
[224] ox_rpc(0,"fctr",x^10-y^10);  
0
[225] P=[0,1,2];
[0,1,2]
[226] map(ox_push_cmd,P,258);
[0,0,0]
[227] ox_select(P);
[0]
[228] ox_get(0);   
[[1,1],[x^4+y*x^3+y^2*x^2+y^3*x+y^4,1],
[x^4-y*x^3+y^2*x^2-y^3*x+y^4,1],[x-y,1],[x+y,1]]

参照

ox_pop_cmo, ox_pop_local, ox_push_cmd, ox_sync, ox_get

7.5.13 ox_flush

ox_flush(id)

:: 送信バッファの強制 flush

return

1

id

子プロセス識別子

• 通常はバッチモードは off であり, データ, コマンド送信ごとに 送信バッファは flush される.
• バッチモードは "ctrl" コマンドの "ox_batch" スイッチ で on/off できる.
• 細かいデータを多数送る場合に, ctrl("ox_batch",1) でバッチモードを on にすると, バッファがいっぱいになった場合にのみ flush されるため, overhead が小さくなる場合がある. ただしこの場合には, 最後に ox_flush(id) を実行して, バッファを強制的に flush する必要が ある.
• ox_pop_cmo, ox_pop_local のように, コマンド送信後 ただちにデータ待ちに入る関数がハングしないよう, これらの関数の内部では 強制 flush が実行されている.

[340] ox_launch_nox();
0
[341] cputime(1);
0
7e-05sec + gc : 4.8e-05sec(0.000119sec)
[342] for(I=0;I<10000;I++)ox_push_cmo(0,I);
0.232sec + gc : 0.006821sec(0.6878sec)
[343] ctrl("ox_batch",1);
1
4.5e-05sec(3.302e-05sec)
[344] for(I=0;I<10000;I++)ox_push_cmo(0,I); ox_flush(0);
0.08063sec + gc : 0.06388sec(0.4408sec)
[345] 1
9.6e-05sec(0.01317sec)

参照

ox_pop_cmo, ox_pop_local, ctrl

7.5.14 ox_get_serverinfo

ox_get_serverinfo([id])

:: server の Mathcap, 動作中のプロセス識別子の取得

return

リスト

id

子プロセス識別子

• 引数 id があるとき, プロセス識別子 id のプロセスの Mathcap をリストとして返す.
• 引数なしのとき, 現在動作中のプロセス識別子およびその Mathcap から なるペアを, リストとして返す.

[343] ox_get_serverinfo(0);
[[199909080,Ox_system=ox_sm1.plain,Version=2.991118,HOSTTYPE=FreeBSD],
[262,263,264,265,266,268,269,272,273,275,276],
[[514],[2130706434,1,2,4,5,17,19,20,22,23,24,25,26,30,31,60,61,27,
33,40,16,34]]]
[344] ox_get_serverinfo(); 
[[0,[[199909080,Ox_system=ox_sm1.plain,Version=2.991118,
HOSTTYPE=FreeBSD],
[262,263,264,265,266,268,269,272,273,275,276],
[[514],[2130706434,1,2,4,5,17,19,20,22,23,24,25,26,30,31,60,61,27,33,
40,16,34]]]],
[1,[[199901160,ox_asir],
[276,275,258,262,263,266,267,268,274,269,272,265,264,273,300,270,271],
[[514,2144202544],
[1,2,3,4,5,2130706433,2130706434,17,19,20,21,22,24,25,26,31,27,33,60],
[0,1]]]]]

参照

Mathcap.

7.5.15 ifplot, conplot, plot, polarplot, plotover

ifplot(func [,geometry] [,xrange] [,yrange] [,id] [,name])

:: 2 変数関数の実数上での零点を表示する.

conplot(func [,geometry] [,xrange] [,yrange] [,zrange] [,id] [,name])

:: 2 変数関数の実数上での等高線を表示する.

plot(func [,geometry] [,xrange] [,id] [,name])

:: 1 変数関数のグラフを表示する.

polarplot(func [,geometry] [,thetarange] [,id] [,name])

:: 極形式で与えられた曲線を表示する.

plotover(func,id,number)

:: すでに存在しているウィンドウへ描画する.

return

整数

func

多項式

geometry xrange yrange zrange

リスト

id number

整数

name

文字列

• ifplot() は, 2 変数関数 func の実数上での零点の グラフの表示を行う. conplot() は, 同様の引数に対し, 等高線の表示を行う. plot() は 1 変数関数のグラフの表示を行う. polarplot() は 極形式 r=f(theta) で表された曲線のグラフの表示を行う.
• これらは OpenXM サーバとして実現されている. UNIX 上では ‘ox_plot’ が, Windows 上では ‘engine’ がこれらの機能 を提供しており, これらは Asir の標準ライブラリディレクトリにある. アクティブな ‘ox_plot’ の id が id として指定された場合, そのサーバが用いられる. id の指定がない場合には, 起動されて いるサーバのうち, ‘ox_plot’ があればそのサーバが用いられる. ‘ox_plot’ が起動されていない場合には, ox_launch_nox() が自動的に実行されて, ‘ox_plot’ が 立ち上がり, それが用いられる.
• 引数の内, func は必須である. その他の引数はオプションである. オプションの形式およびそのデフォルト値 (カッコ内) は次の通り.

  geometry

  ウィンドウのサイズをドット単位で [x,y] で指定する. ([300,300]. )

  xrange yrange

  変数の範囲の指定で, [v,vmin,vmax] で指定する. (いずれの変数も [v,-2,2].) この指定がない場合, func に含まれる変数の内変数順序の上の変数 が ‘x’, 下の変数が ‘y’ として扱われる. これを避けるためには xrange, yrange を指定する. また, func が 1 変数の 場合, これらの指定は必須となる.

  zrange

  conplot() の場合のみ指定できる. 形式は [v,vmin,vmax [,step ]] で, step が指定され た場合には, 等高線の間隔が (vmax-vmin)/step となる. ([z,-2,2,16].)

  id

  遠隔プロセスの番号, すなわち ox_launch() が返した番号を指定する. (一番最近に作られ, かつアクティブなプロセスに対応する番号.)

  name

  ウィンドウの名前. (Plot.) 生成されたウィンドウのタイトルは name:n/m となる. これは, プロセス番号 n のプロセスの, m 番のウィンドウを意味する. この番号は, plotover() で用いられる.

• 一つのプロセス上で描画できるウィンドウの数は最大 128 個である.
• plotover() は, 指定したウィンドウ上に, 引数である 2 変数多項式の 零点を上書きする.
• 描画終了後のウィンドウ上で, マウスの左ボタンを押しながらのドラッグ で範囲を指定しボタンを離すと新たなウィンドウが生成され, 指定した 範囲が拡大して表示される. ドラッグは左上から右下へと行う. ドラッグを始めた後キャンセルする場合は, マウスポインタを始点の上か 左に持っていってボタンを離せばよい. 新しいウインドウの形は, 指定 領域と相似で, 最大辺が, 元のウィンドウの最大辺と一致するように 定められる. 以下で説明する precise が on の場合, 選択した領域が同一 window 上で書き直される.
• ウィンドウ内で右ボタンを押すと, その点の座標がウィンドウの下部に表示される.
• conplot() で生成したウィンドウにおいて, ウィンドウの右側のマーカを 中ボタンでドラッグすると, 対応する等高線の色が変わり, 右上の ウィンドウに対応するレベルが表示される.
• UNIX 版ではいくつかのボタンにより いくつかの設定変更, 操作ができる. UNIX 版では次のボタンがある.

  quit

  window を破壊する. 計算を中断する場合, ox_reset() を用いる.

  wide (トグル)

  現在の表示部分を縦横各 10 倍した領域を表示する. 現在表示されている範囲は この表示において中央部に長方形で示される. この表示で範囲指定を行うと, その範囲が新しいウィンドウに描画される.

  precise (トグル)

  選択領域を, 整数演算により, より正確に再描画する. これは, func が 有理数係数の 2 変数多項式の場合にのみ有効である. このモードでは Sturm 列 と二分法により, 区間内の零点の個数を正確に求めていくもので, デフォルトの 計算法よりも正確な描画が期待できる. ただし, 描画時間は余計にかかる場合が 多い. この説明から明らかなように, この機能は有理数係数の多項式の描画に対 してのみ有効である. ((x^2+y^2-1)^2 の描画で試してみよ.)

  formula

  対応する式を表示する.

  noaxis (トグル)

  座標軸を消す.

• ‘ox_plot’ が起動されるマシンによっては, スタックを大量に使用する ものもあるため, ‘.cshrc’ でスタックサイズを大きめ (16MB 程度) に 指定しておくのが安全である. スタックサイズは limit stacksize 16m などと指定する.
• X では、ウインドウの各部分について resource により 色付けや、ボタンの形を変えることができる。 resource の指定の仕方は以下の通り。（デフォルトを示しておく） plot*form*shapeStyle は、rectangle, oval, ellipse, roundedRectangle が、指定できる。

  plot*background:white
  plot*form*shapeStyle:rectangle
  plot*form*background:white
  plot*form*quit*background:white
  plot*form*wide*background:white
  plot*form*precise*background:white
  plot*form*formula*background:white
  plot*form*noaxis*background:white
  plot*form*xcoord*background:white
  plot*form*ycoord*background:white
  plot*form*level*background:white
  plot*form*xdone*background:white
  plot*form*ydone*background:white
  

参照

ox_launch, ox_launch_nox, ox_shutdown, ox_reset,ox_intr,register_handler

7.5.16 open_canvas, clear_canvas, draw_obj, draw_string

open_canvas(id[,geometry])

:: 描画用ウィンドウ (キャンバス) を生成する.

clear_canvas(id,index)

:: キャンバスをクリアする.

draw_obj(id,index,pointorsegment [,color])

:: キャンバス上に点または線分を描画する.

draw_string(id,index,[x,y],string [,color])

:: キャンバス上に文字列を描画する.

return

0

id index color x y

整数

pointorsegment

リスト

string

文字列

• これらは OpenXM サーバ ‘ox_plot’ (Windows 上では ‘engine’) により提供される.
• open_canvas は, 描画用のウィンドウ(キャンバス)を生成する. geometry によりウィンドウのサイズを pixel 単位で [x,y] で指定する. default size は [300,300]. キャンバスの識別子として, 整数値を OpenXM サーバのスタックに push する. この識別子は draw_obj の呼び出しに必要であり, ox_pop_cmo に より取り出して保持する必要がある.
• clear_canvas は, サーバ id id, キャンバス id index で指定されるキャンバスをクリアする.
• draw_obj は, サーバ id id, キャンバス id index で指定されるキャンバスに点または線分を描画する. pointorsegment が [x,y] の場合点の座標, [x,y,u,v] の場合 [x,y], [u,v] を結ぶ線分を表すと見なされる. キャンバスの座標は, 左上隅を原点として横方向に 第一座標, 縦方向に第二座標をとる. 値は pixel 単位で指定する. color の指定がある場合, color/65536 mod 256, color/256 mod 256, color mod 256 をそれぞれ Red, Green, Blue の値 (最大 255) とみなす.
• draw_string は, サーバ id id, キャンバス id index で指定されるキャンバスに文字列を描画する. 位置は [x,y] により指定する.

[182] Id=ox_launch_nox(0,"ox_plot");
0
[183] open_canvas(Id);
0
[184] Ind=ox_pop_cmo(Id);
0
[185] draw_obj(Id,Ind,[100,100]);
0
[186] draw_obj(Id,Ind,[200,200],0xffff);
0
[187] draw_obj(Id,Ind,[10,10,50,50],0xff00ff);
0
[187] draw_string(Id,Ind,[100,50],"hello",0xffff00);
0
[189] clear_canvas(Id,Ind);
0

参照

ox_launch, ox_launch_nox, ox_shutdown, ox_reset,ox_intr,register_handler, ox_pop_cmo, ox_pop_local.

この文書は12月 21, 2024にtexi2html 5.0を用いて生成されました。