本ライブラリはrbdclのラッパーとして作成され、rbdclよりもより使いやすい 描画ライブラリとなっている。rbdclとの違いのひとつにパラメタのセット方法が 挙げられる。本ライブラリではパラメタを描画メソッドのキーワード引数として セットできる。詳しくはパラメタの取り扱いについてを参照のこと。
DCLオンラインマニュアルのページ
<URL:http://www.gfd-dennou.org/arch/dcl/dcl-f77doc/rc1/ >
モジュール構成は以下の通りである。メソッド一覧は本ライブラリの構成を参照のこと。
NumRu
AdvancedDCL
Axis おまかせで軸を描く。(USPACK)
本ライブラリは既にインストールされているものとする。(インストール方法はINSTALL、INSTALL.jp(日本語)を参照)
使用するには
require 'advanceddcl'
とすればよい。
また、
include NumRu::AdvancedDCL
とすることにより、NumRu::AdvancedDCL::Contour.xxx の NumRu::AdvancedDCL の部分が省略でき、Contour.xxx などで各モジュールが扱えるようになる。
図形を描くためには, まずディスプレイやプリンタなど デバイス の準備をする必要がある. その準備をする操作を「オープン」という. そして, 最後に描画を終了する時の操作を「クローズ」という. すべての図形は, デバイスをオープンしてからクローズするまでの間に 描かれなければならない. 地球流体電脳ライブラリでは, 一度に1つのデバイスをオープンすることがで きる. 同時に2つ以上のデバイスをオープンすることはできないが, オープン時にいくつかのデバイスの中の1つを選択できる.
デバイスに出力される図形が複数ページにわたることがあるが, 地球流体電脳ライブラリでは, ページという言葉の代わりにフレームという言葉を使う. これは, デバイスによってはページという概念のないもの (例えば, 巻物のような長い紙に出力するようなデバイス) があったり, 後述のように物理的な1ページの中に複数のフレームを設定することもあるので, 物理的なページと区別するためである.
グラフィックを使うプログラムの形態は次のようになる.
Dev.open("X") ! デバイス"X"をオープン
Frame.new ! フレームを用意
・・・・・・・・ ! １ページ目の描画プログラム
Frame.new ! 改ページ
・・・・・・・・ ! ２ページ目の描画プログラム
・
・
・
Dev.close !デバイスのクローズ
本ライブラリで使用する座標系には 4 つのレベルがある. それぞれのレベルには上位レベルから順に U, V, R, W という記号が付けられ, 「U座標系」, 「V座標系」, 「R座標系」, 「W座標系」というように呼ばれる (図 1.3 参照). この U, V, R, W という文字は, それぞれ次のような名前に由来するが, これらの名前が長いので, 以後は単に 「U座標系」などの用語を使うことにする (さらに UC などとも略記する).
レファレンスマニュアルの引数の説明でも, U座標系の座標値は (UX,UY) というように, 座標系を表す文字をつけて記述してある. (正規直角座標系を N 座標系でなく R 座標系と呼ぶのは, 実変数に関する FORTRAN の規則による.)
座標系と変換関数との関係
2次元座標 3次元座標
ユーザ座標 UC UC3
| |
(TC) | 正規化変換
| |
仮想直角座標 VC-----------VC3
| | 透視変換
正規直角座標 RC-------------
| ワークステーション変換
装置座標 WC
最も上位の U座標系は普通のX-Y座標から地図投影座標まで多くの座標系を含む. その一つ下位のV座標系には2次元, 3次元のそれぞれ1つずつの直角座標系が定義されており, 多様なU系の座標はすべてこの2種類の座標系に変換される. この変換のことを「正規化変換」 と呼ぶ.
一方, 最も下位の座標系である W 座標系はデバイス固有の座標系で, デバイスによって異なる. これを統一するために, その一つ上位に R 座標系を定義して, すべてこの R 座標系を経由して W座標系に変換される. この変換を「ワークステーション変換」と呼ぶ. R座標系は2次元の直角座標系で, x軸, y軸 ともに定義域は[0,1] である.
これらの上位2つと下位2つの座標系を結ぶ V座標系から R 座標系への変換は 「透視変換」 と呼ばれる. 透視変換はその名の通り, 透視図法すなわち遠近法による変換で, 基本的に3次元のV座標系から 2次元のR座標系への変換である. 2次元のV座標系は, 一旦, 3次元のV座標系に割り付けられてから透視変換される. この時2次元のV座標系を割り付ける位置は, 3次元座標の x軸, y軸 または z軸に垂直な任意の平面にとることができる. これにより, 2次元的に描いた1枚の図を斜めから眺めたような描写が可能になる.
初期状態では, 2次元V座標系からの透視変換は恒等変換となっているため, 2次元の座標系を普通に使う限り, 透視変換を意識する必要はないが, あとで透視変換を使いたくなることも考えて, V座標系とR座標系は使い分けておいた方が良い. すなわち, 座標軸などの「図に付随した情報」は, 透視図法で図とともに変換すべき情報なので V 座標系で描画し, ページ数やパラメタの数値などのように「紙に付随した情報」は R 座標系で描画すべきである.
なお, 地図座標系の正規化変換は, 座標の「回転」と「投影」の2段階で行なわれ, その中間の座標 (U座標系を回転した座標) を T 座標 (Terrestrial coordinate) という. T 座標はx軸の定義域が [-180, 180], y軸の定義域が[-90, 90]の座標系で, この座標系から各地図投影の定義式に従って変換される. 任意の経線を中央経線としたり, 横軸法や斜軸法の投影をするためには投影の前に回転操作が必要となる.
T座標系は正規化変換の際の一時的な作業座標系であるので, これを意識しなければならないことは少いが, 地図座標のクリッピングだけは U座標系ではなくT座標系で行なわれるので, この座標系を意識する必要がある.
2次元のU座標系には次のような種類があり, ユーザーはその中から関数番号で指定する (略号, または名称から関数番号を返す関数も用意されている). 各座標系は, その種類によって正規化変換に必要なパラメータが異なる.
直角直線座標系
番号 略号 名 称 1 U-U UNI-UNI 直角一様座標 2 U-L UNI-LOG 片対数座標 3 L-U LOG-UNI 片対数座標 4 L-L LOG-LOG 対数座標
直交曲線座標系
番号 略号 名 称 5 POL POLAR 極座標 6 BPL BIPOLAR 双曲線座標 7 ELP ELLIPTIC 楕円座標 (未実装)
地図投影座標系
番号 略号 名 称 10 CYL CYLINDRICAL 正距円筒図法 11 MER MERCATOR メルカトール図法 12 MWD MOLLWEIDE モルワイデ図法 13 HMR HAMMER ハンメル図法 14 EK6 ECKERT 6 エッケルト第6図法 15 KTD KITADA 北田楕円図法 20 CON CONICAL 正距円錐図法 21 COA CONICAL EQ.AREA ランベルト正積円錐図法 22 COC CONICAL CONFORMAL ランベルト正角円錐図法 23 BON BONNE ボンヌ図法 30 OTG ORTHOGRAPHIC 正射図法 31 PST POLAR STEREO ポーラーステレオ図法 32 AZM AZIMUTHAL 正距方位図法 33 AZA AZIMUTHAL EQ.AREA ランベルト正積方位図法
ユーザー定義座標系
番号 略号 名 称 99 USR USER ユーザー定義関数
ユーザー定義座標系はユーザーが必要な変換関数を用意するものである.
地球流体電脳ライブラリでは地図投座標も普通のU座標系の 一つとして扱われる. 地図投影法には実にさまざまな種類があり, すべてを解説するためには1冊の本が必要であるが, ここでは地球流体電脳ライブラリを利用するために知っておくべき基本的事柄 を解説する. なお, 地図学の詳しい解説は 野村 正七 著 「地図投影法」 などを参考にさ れたい (ただし, この本は絶版).
地図投影法は基本的に「球面を何らかの方法で2次元平面に投影する」方法で ある. 実際の地球は完全な球面ではなく回転楕円体に近いので, 厳密な地図投影を行なうためには回転楕円体の表面を平面に投影しなければならない. しかし, 本ライブラリでは回転楕円体からの投影ではなく, 球面からの投影のみをサポートする. なお, 投影された図形は投影法によっては3次元的な雰囲気を持つが, 地図投影座標はあくまでも2次元座標であることに注意されたい.
地図投影の多くの図法では幾何学的な方法で球面から平面に投影される. その際の平面の形状によって次のようにいくつかの図法に分類される.
これらの円筒や円錐の軸, または方位図法における接点からの垂線が 地球の自転軸と一致するものを正軸法, 直交するものを横軸法, 斜めに交わるものを斜軸法と呼ぶ. 一般に, 円筒図法は全球の表示に向いており, 円錐図法は中緯度の表示に向いている.
地図投影では球面を平面に投影するため, どうしてもひずみが生じてしまう. そこで, 多くの図法では 面積 または 角度 のどちらかが 保存されるように工夫されている. 原理的に, この二つを同時に保存するような投影は不可能である. この様な保存性に関する性質によって次のように分類される.
本ライブラリでは以下のような地図投影がサポートされる.
円筒図法
番号 図法 正積 正角 正距 10 正距円筒図法 × × 経線 11 メルカトール図法 × ○ × 12 モルワイデ図法 ○ × × 13 ハンメル図法 ○ × × 14 エッケルト第6図法 ○ × × 15 北田楕円図法 ○ × ×
円錐図法
番号 図法 正積 正角 正距 20 正距円錐図法 × × 経線 21 ランベルト正積円錐図法 ○ × × 22 ランベルト正角円錐図法 × ○ × 23 ボンヌ図法 ○ × ×
方位図法
番号 図法 正積 正角 正距 30 正射図法 × × × 31 ポーラーステレオ図法 × ○ × 32 正距方位図法 × × 方位線 33 ランベルト正積方位図法 ○ × ×
ハンメル図法は地図学上, ランベルト正積方位図法の変種として方位図法に分類されるが, その形状や用途はむしろ円筒図法に近いので, ここでは便宜的に円筒図法に分類する. これらの図法すべてについて, 正軸法, 横軸方, 斜軸法が可能である.
なお, 普通の地図投影法には含まれないが, 正射図法の変形として人工衛星から眺めたような投影法 (Satellite View) もサポートされている. 普通の正射図法は地球儀を無限遠から眺めたような投影になっているが, これを有限の位置から眺めたような投影に変形したものである.
上記のU座標を2次元V座標に変換する 正規化変換に必要なパラメータには以下のものがある. これらは Fig により 一つずつ設定/参照できる.
ビューポートを指定するパラメタは, すべての変換に共通で必須である. ビューポートとは, 通常座標軸が描かれる矩形の枠である. クリッピングをするように指定すると, この枠からはみ出した部分は 描画されない. ビューポートを指定するには, その左下と右上の角のVCにおける座標値 を指定する. これらのパラメータは Figのviewport によって 設定/参照できる.
ウインドウは直角直線座標系を設定するのに必要なパラメタである. これは, ビューポートに対応する座標値を UC の値で指定する.
地図投影座標系の場合には, GRPH1 の範囲ではこの情報を必要としないが, GRPH2 のパッケージが「注目している緯度経度範囲」という意味で 参照する場合がある. この場合には, 一般にビューポートとウインドウは一致しない. これらのパラメータは FigのWindow によって 設定/参照できる.
直交曲線座標系および地図投影変換の場合の, 相似変換 (拡大縮小と原点移動) のパラメタ. 直交曲線座標系の関数は MATH1/CTRLIB, 地図投影座標系の関数は MATH1/MAPLIB の関数によって 定義されている. GRPH1 では, これらの関数が返す値に, SIMFAC を掛けて VC の値に変換し, 原点をビューポートの中心から (VXOFF, VYOFF) 平行移動した位置に 設定する. これらのパラメータは Figのsimtrans によって 設定/参照できる.
地図投影変換は常に経度範囲 [-180潤・!-- MATH: $[-180^\circ , 180^\circ ]$ -->,180潤・!-- MATH: $[-180^\circ , 180^\circ ]$ -->] 緯度範囲 [-90潤・!-- MATH: $[-180^\circ , 180^\circ ]$ -->,90潤・!-- MATH: $[-180^\circ , 180^\circ ]$ -->] に対して行なわれるので, 任意の視点からの投影を行なうためには, 地図投影を行なう前に緯度経度座標を回転させておく必要がある. (PLX, PLY) は投影座標 (TC) の極をおく経度・緯度(UC)を 指定し, PLROT は投影座標の極の回りの回転角を指定する.
これらのパラメタと, 一般に3次元の回転角を指定するのに使われる 「オイラーの角(θ,φ,ψ)」 との関係は, θ=π/2-PLY, φ=PLX, ψ=PLROT である. (オイラーの角の意味については, 数学辞典などを参照のこと.)
これらのパラメータは Figのmapangle によって 設定/参照できる.
実際の操作としては, UC と TC (投影座標) が一致している状態を初期状態として, (1) 北極を中心として TC を φ 回転させる. (経度 PLX の経線を中央経線とする) (2) TC の北極を中央経線の方向に θ回転させる. (経度・緯度 (PLX, PLY) の地点を, TC の北極とする)
TC から VC への変換は上記の相似変換パラメタによって 決められる. その際地図投影のタイプによって VC 原点に投影される TC の 値が異なる.
図 法 原点に投影される TC * 円筒図法 (0, 0) * 方位図法 (90, 0) * 円錐図法 円錐の頂点
原点に投影されるこれら TC の値は, オイラーの角を (0,0,0) と したとき, すなわち (PLX,PLY,PLROT)=(λ,90.,0) と した場合に対応する.
通常の円筒図法や円錐図法 (正軸法) で, 経度λの経線を中央経線とするには, (PLX,PLY)=(λ,90.,0) とする.
方位図法において, 経度・緯度 (λ,φ) を中心とした 地図を描くには, (PLX,PLY)=(λ,φ) とし, 必要に応じて PLROT を指定する PLROT=0 の時, 必ずUCの南極が原点の下になる.
横軸法の円筒図法などでは, (PLX,PLY)として赤道上の点を 指定する. PLROT=0 の時, UCの南極が中央経線上に投影される. 例えば, 北極海, 大西洋, 南極環海を一つながりの海として 横軸法で表すには, (PLX, PLY, PLROT) = (60.,0.,-90.) とする.
円錐図法の投影では上記のパラメタ以外に, 標準緯度が必要である. ランベルト正角円錐図法は標準緯線が二つあるので, STLAT2 も指定しなければならないが, その他の円錐図法は STLAT1 の値のみを使う. これらのパラメータは Fig によって 設定/参照できる.
正射図法は本来, 無限遠から地球を眺めたような投影法であるが, オプションとして有限の位置にいる衛星から眺めたような投影 (Satellite View) が可能である. 正射図法でこのオプションを選択するには, RSAT を 1 以上の値に設定する. RSAT は, 地球半径を 1 とした時の「衛星の軌道半径」である. これらのパラメータは Fig によって 設定/参照できる.
U座標系で描画するためには, Frame.new を呼んだ後でかつ描画をはじめる前に 変換関数を決めるパラメータを指定しておかなければならない. 指定すべきパラメータは座標系によって異なるが, 主要なパラメタはすべて Fig によって管理されている.
具体的に変換パラメタを設定するには Frame.new のあとで次のように コーディングする.
直角座標系
Fig.viewport=[VXMIN, VXMAX, VYMIN, VYMAX] Fig.window=[UXMIN, UXMAX, UYMIN, UYMAX] Fig.transnum=ITR
直交座標系
Fig.viewport=[VXMIN, VXMAX, VYMIN, VYMAX] Fig.simtrans=[SIMFAC, XOFF, YOFF] Fig.transnum=ITR
地図座標系
Fig.viewport=[VXMIN, VXMAX, VYMIN, VYMAX] Fig.simtrans=[SIMFAC, XOFF, YOFF] Fig.mapangle=[PLX, PLY, PLROT] Fig.transnum=ITR
円錐投影の場合は, これ以外に SGRSET によって標準緯線の緯度 (STLAT1, STLAT2) を与えておく必要がある.
これらのパラメタはどのような順番で指定しても構わない. 変換関数名または略号を指定して, 変換関数番号を返す関数も用意されている.
3次元のユーザー座標系 (UC) は次のような種類があり, ユーザーはその中から関数番号によって 1 つを選択する.
番号
3 次元座標系は2 次元座標系と異なり対数軸のしていは関数番号ではなく, 対数スイッチ (後述) によって指定する.
上記の3次元U座標を3次元V座標に変換する正規化変換に必要なパラメータには以下のものがある. これらは Fig により一つずつ設定/参照できる.
直角直線座標 (ITR=1) の変換に必要なパラメタで, ウィンドのパラメタと共に指定する.2次元のビューポートと異なり クリッピングの範囲とは関係がない. これらのパラメータは Figのviewport3d によって 設定/参照できる.
ITR=1 の時, ビューポートに対応する座標値を UC の値で指定する. これらのパラメータは Figのwindow3d によって 設定/参照できる.
ITR=1 の時, それぞれの軸を対数にしたいときに, true にする. これらのパラメータは Figのlog3d によって 設定/参照できる.
円筒座標と球座標の時に指定する 相似変換 (拡大縮小と原点移動) のパラメタ. 座標原点を(VXORG3, VYORG3, VZORG3) に設定する. これらのパラメータは Figのoriginによって 設定/参照できる.
3次元のU座標系で描画するためには, 2次元座標系と同様 Frame.new を呼んだ後でかつ描画をはじめる前に 変換関数を決めるパラメータを指定しておかなければならない. 3次元のパラメタは2次元のパラメタとは独立である.
主要なパラメタはすべて Fig によって管理されている.
具体的に変換パラメタを設定するには Frame.new のあとで次のように コーディングする.
直角座標系
Fig.viewport3d=[VXMIN3, VXMAX3, VYMIN3, VYMAX3, VZMIN3, VZMAX3] Fig.window3d=[UXMIN3, UXMAX3, UYMIN3, UYMAX3, UZMIN3, UZMAX3] Fig.transnum3d=ITR3
円筒座標, 球座標
Fig.origin=[SFAC3, VXORG3, VYORG3, VZORG3] Fig.transnum3d=ITR3
透視変換とは, 任意の視点から3次元空間を眺めて遠近感を出す変換である. 電能ライブラリにおいては, 3次元V座標系から2次元R座標系への変換を指す.
一般に, この変換では3次元空間上の平行線は投影された2次元平面上では平行にならない. 視点を無限遠に持っていけば, 平行線は平行線に投影されるが, そのように投影された図形はかえって不自然に感じられる.
透視変換を行なうには, 「視点」 と「焦点中心」を設定しなければならない. 視点とは読んで字の通り3次元空間を眺める位置であり, カメラのレンズの位置であると思えば良い. これに対して, 焦点中心はカメラのフィルム上の焦点ではなく, 注目している点, すなわち視点から「見つめる点」である. この視点と焦点中心を結ぶ線が「視線」 である. 透視変換によって 3次元図形の各点は, その点と視点を結ぶ線が 「投影面」と交わる点に投影される. 地球流体電脳ライブラリでは, 投影面は焦点中心を通り, 視線に垂直な面である.
2次元座標系の場合, 2次元のV座標系を3次元のV座標系の1平面に割り付けることで, 透視変換が可能になる. この際に割り付けることができる平面は, 3次元 X, Y, Z 座標軸のいずれかに垂直な平面であり, 斜めの面に割り付けることはできない. (斜めに見るには視点を動かせば良い)
3次元空間上での視点. この位置にカメラを構えていると思えば良い.
3次元空間内で視線を向ける目標点. カメラを向ける被写体の位置と思えば良い. なお, 焦点中心を通り, 視線(視点と焦点中心を結ぶ線)に垂直な面が 投影面となる. すなわち, 3次元空間上の点(X,Y,Z) は, その点と視点を通る線が 投影面と交わる点に投影される.
視点からこの角度で見える投影面上の長さが, 正規直角座標系の単位長さとなる.
Z 軸の傾き. カメラの光軸回りの傾きに相当する. この角度が0 の時, 3次元空間のZ軸は正規直角座標のY軸に並行にな る. 視線がZ 軸と平行な場合には, Y 軸が基準になる.
正規直角座標系に投影された焦点中心の位置を, 中心からの位置で指定する. 通常この値は (0,0) で良い.
2次元平面を3次元空間のどこに位置付けるか指定する. IXC3, IYC3 はそれぞれ2次元平面のX座標, Y座標に対応する 3次元座標を (1,2,3) の数字で指定するもので, 数字はそれぞれ X座標, Y座標, Z座標に対応する. これらの数値に負の値を指定すると, 正負を逆に割り当てる. SEC3 は残りの座標の座標値である.
透視変換のパラメタも Frame.new を呼んだ後でかつ描画をはじめる前に 変換関数を決めるパラメータを指定しておく. 透視変換のパラメタは, 2次元およおよび3次元正規化変換と独立である.
主要なパラメタはすべて Fig によって管理されている.具体的に変換パラメタを設定するには Frame.new のあとで次のように コーディングする.
Fig.eyepoint=[XEYE3, YEYE3, ZEYE3] Fig.objpoint=[XOBJ3, YOBJ3, ZOBJ3]
そのほかのパラメタは必要に応じて SGpSETで指定する.
なお, 2次元平面を3次元平面に割り付けるには,
Fig.plane=[IXC3, IYC3, SEC3]
を呼ぶ. これにより, 2次元平面上の描画ルーチンを 3次元空間内の平面上で使うことができるようになる
図形を構成する基本要素を出力プリミティブという. GRPH1 の出力プリミティブには次のものがある.
このほか, 補助的に次のプリミティブがある.
これら6つのプリミティブのうち, トーンプリミティブ以外の5つはすべて線分で構成される. 線分にはラインインデクスとラインタイプ呼ばれる属性がある. また, トーンには, トーンパターン番号という属性がある. これらの属性は, 以下のように定義されている.
扱われる座標系には曲線座標系も含まれるので, 線分やトーンの境界を指定する座標点の間を直線でつなぐと不都合が起こる場合がある. そこで, 座標点の間をいくつかに分割して, 補間する機能がある. さらに, すべてのプリミティブはある境界でのクリッピングの対象となる.
描かれる線分の太さと色はラインインデクスと呼ばれる 3桁の整数(nnm)で指定される. 線の太さと色のうちどちらか一方しか変えられないような デバイスに出力する場合でも, ラインインデクスの異なる2本の線が識別できるようにするため, ラインインデクスは次のような規則にしたがって太さと色に対応づけられる.
線の太さと色が両方変えられるようなシステムでは, 上位2桁(nn=0- 99)が色番号, 下位1桁(m=0- 9)が線の太さを表す. 色番号は, 1から5 までは標準的に
と決められているが, それより大きな番号に関しては colormap ファイルの定義による. またm: 1(細) → 9(太)となっている. 線の太さだけが変えられるような出力装置では, m=0のときに限ってnnをmとして読みかえる. また, 線の色だけがかえられるような出力装置では, nn=0のときに限ってmをnnとして読みかえる. したがって線の太さと色を明示したいとき以外は, 1桁のラインインデクスを指定しておけば, とりあえず装置に固有な方法によって線分は識別可能となる.
ラインタイプとは, 実線, 破線などの線種である. 1から4までの番号にはあらかじめ以下のタイプが決められている.
その他の0以外の整数は下位Nビット (Nは Plotのnbits で決まる値. 初期値は16; 2.4.4節参照) のビットパターンを用いて線種が設定される. たとえばN=16でITYPE = Z'0000F0F0' (16進定数)のとき, '4bits ON 4bits OFF 4bits ON 4bits OFF' のような破線が設定される. 1ビット当たりの長さは Plotのbitlen が決める.
トーンパターン番号には色の情報と, パターンの情報が両方含まれており, 下位3桁がパターン番号, それより上位の桁は色を指定する. 色を指定しない (3桁の番号だけ指定) 場合は, フォアグラウンド (色番号1) と解釈される.
パターン番号の最上位桁は, パターンの種類をあらわす.
2桁めは, ドットの大きさや斜線の太さを0から5の間で指定する. 値が大きくなるにつれてドットは大きくなり斜線は太くなる. 最下位桁はドットや斜線の密度を0から5の間で指定する. 値が大きくなるにつれてドットや斜線の密度があがる. ただし0のときは何も描かれない.
パターン番号として999を指定するとべたぬりとなる.
カラーの端末やカラーのプリンターでは, 色を指定したべた塗りによる塗りわけがしばしばおこなわれる. このプログラムをカラーがサポートされない環境で実行しても, それなりな見わけがつくようにドットによる塗りわけとして表現するようなオプションも用意されている.
これらの組合せ以外の整数値はパターンが定義されていない.
補間機能には次の2つがある.
地図投影関数の場合には, TC において特異点は必ず極になっているので, 大円補間を指定することにより, 特異点付近での線分がより適切に描けるよう になる. この機能に関する Fig のパラメタは以下の通り.
クリッピングは次の場所で行なわれる.
それぞれのクリッピングは, その座標系の座標軸に平行な線で囲まれる矩形領 域に対して行なわれる. したがって, 地図投影の際に極を移動する回転を行なうと, TC におけるクリッピング境界はは経緯線に一致しなくなる.
この機能に関する Fig のパラメタは以下の通り.
LCLIP (L) ビューポートでのクリッピングを 行なうかどうか指定するフラグ (省略値 .FALSE.).
ビューポートにおけるクリッピングは Figのlclip によって ON/OFF できるが, 他のクリッピングは常におこなうようになっている. 正射図法で TC におけるクリッピング境界を省略値のまま使うと, 裏側の線分なども描くことになる. 表側だけを描くためには'TYMIN' を 0 にする.
地球流体電脳ライブラリのトーンは通常 (クリッピングされなければ) 指定された境界線が交わっていても, その図形の内側が塗りつぶされる. 正確には, ソフトフィルは Even Odd Rule にしたがって塗りつぶしが行われ, ハードフィルは機種依存であるが, できるだけソフトフィルに近い規則で塗りつぶされる様になっている.
旧バージョンではハードフィルはクリッピングの対象になっていなかったが, DCL ver.5 からハードフィルもソフト的にクリッピング できるようになった. すなわち, トーンのクリッピングはハードウェアが行うのではなく, 指定された領域とクリッピング範囲が重なる部分を指定する境界点を生成して, そのデータをトーンルーチンに渡すようになっている. このクリップされた境界線を求めるアルゴリズムは, 境界線の向きが決まっていることを前提としている. ここで, 境界線の向きとは境界線を指定する点列を, 時計回りに指定するか, 反時計回りに指定するかということを言う. このアルゴリズムは旧来のトーンの塗りつぶし規則と整合性が悪いが, 地図上 (T 座標系) では境界線の向きがわからないと内側と外側を判断することができない.
具体的にはトーンをクリッピングする手順は次のようになる.
IRMODE=0 の時, 反時計回り; IRMODE=1 の時, 時計回り に接続する.
したがって, 境界線が交わるような図形を塗りつぶす時に, クリッピングを行うのは危険である. クリッピングを行う時は, 安全のために 境界線の向きを決めて, 小さな単純な図形にする様にしていただきたい.
なお, 図形の外側を塗りつぶしたい時には, その図形が確実にクリッピングされるように領域を2分割し, クリッピング領域 (ビューポート) を設定しなおして, 2度トーンルーチンを呼ぶ.
R座標系はx軸, y軸ともに0 から 1の値をとり, 描画範囲は 1:1 の縦横比を持つ. これに対して, 実際のデバイスの縦横比はいろいろである. 描画範囲とデバイスの縦横比が一致しない時には, 通常 Frame.new が呼ばれた段階で, デバイスの中央に描画範囲が最大内接するように ワークステーション変換が設定される.
しかし, デバイスの描画領域をいっぱいに使いたかったり, 逆に, 図の回りに適当なマージンをとりたい場合もある. そのような時には, Frame を使う. Frame は基本的にワークステーション変換を設定するもので, 描画範囲の縦横比を変える以外に, マージンにタイトルなどの文字列を書いたり 1枚の紙に複数のフレームを並べたりする機能がある. この様な機能をレイアウト機能と呼ぶ.
このレイアウト機能を使うには, デバイスをオープンした後で Frame.new を呼ぶ前に, 適切な設定を行なう. 例えば,
Dev.open
Frame.div('S', 4, 3) ! 1ページを４×３に分割する
Frame.new
・・・・・・・・
Frame.new
・・・・・・・・
Dev.close
とすることで, 1ページに12枚のフレームを設定することができる
次に本ライブラリの構成及び各モジュールのメソッドを示す。
NumRu::AdvancedDCL
Axis.yax 現在設定されている正規化変換に対して 適当な目盛とラベル間隔を計算し, 指定された場所に座標軸を一本描く.
AdvancedDCLにおけるパ ラメタはDCLで言うところの内部変数である。また、パラメタ設定の機能を持 つサブルーチンのパラメタ化を行い、パラメタとして扱うことが可能である。
パラメタの設定、参照はset、getメソッドを用いて行う。(モジュール名). set( (パラメタ名), 値 ) でパラメタを設定し、(モジュール名).get( (パラ メタ名) ) でパラメタを参照する。また、set、get の代りに (モジュール名). (パラメタ名)= 、 (モジュール名).(パラメタ名) を用いても同じである。以 上まとめると次のようになる。
パラメタ名lineindexの場合、
上の場合、1と2は同じでありパラメタlineindexを3に設定する。また、3と4も同じ意味で現在のlineindexを参照する。
また、setメソッドの引数valにnilを指定した場合、もしくはresetメソッドを 用いることによりパラメタ値をリセットすることが可能である。この場合値は 全てDCLのデフォルト値(ない場合はnilに)設定される。
更に、AdvancedDCLではパラメタ設定方法としてテンポラリパラメタとしての パラメタ設定もサポートしている。その方法は描画メソッドのキーワード引 数として用いるものであり以下のように用いる。Plot.draw(x, y, {"lineindex"=>3})ここで設定されたlineindex=3というパラメタはプロット を行うときのみ有効となり、描画が終わると元に戻る。
AdvancedDCLにおいてパラメタは各モジュール毎にまとめられたものをParameter オブジェクトとしている。すなわち、各モジュールが１つのパラメタオブジェクト を持つことになる。また、各モジュールはそれとは別tempパラメタ用の パラメタオブジェクトをもっている。パラメタオブジェクトはパラメタクラスの オブジェクトであり、パラメタクラスは以下の内部変数を持っている。
具体的には、
valueは長さlenのArrayでなければならず、中身もklassクラスでなければならない。 * Array : [len1, [ len2, Class]] valueは長さlen1のArrayでなければならず、その中身は長さlen2のArray、さらにその中身はklassクラスでなければならない。
set_call_pattern : set関数の呼び出し方(引数の与え方)
パターンはsetと同じである。ただし、パターン3はない。
Commonモジュールは、共通パ ラメタを管理するモジュールである。全体パラメタとはDCL(rbdcl)全体に影響 を及ぼすパラメタでありCommonモジュールで管理される。また、DCL(rbdcl)に は同様の機能を持つパラメタが幾つか存在するが、それらのパラメタを同時に 設定するのがCommonモジュールの持つ役割である。Commonパラメタlineindex を例に挙げると、Common.lineindex= でPlotやBoxなどのlineindexを同時に変 更可能である。ただし、あらかじめPlot.lineindex= などで個々のパラメタを 設定している場合はそちらが優先となる。
パラメタ名 パラメタの型（モジュール名）
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
折れ線のラインインデクスを指定する.
折れ線のラインタイプを指定する.
major lineのラインインデクス
minor lineのラインインデクス
Box、Bar、Gap、Errorにおいて、描画メソッドの引数x1, y1 または x2, y2 に RUNDEF を指定すると, パラメタ uref の値が指定されたものとみなす. uref の初期値は 0 である.
内部領域を塗るトーンパターンを指定する. ここで設定する番号は Gap.tone,Bar.tone,Box.tone で使われる.
MarkやThreeDでマーカーを描くとき,何個に1個の割合で描くかを指定する(初期値は1;すべてマーカーを描く.Mark.drawがバッファリングする最大個数50以下でなければならない).
Mark.draw、ThreeD.markなどで描くマーカータイプを設定する.(初期値は1)
Mark.draw、ThreeD.markなどで描くマーカーのラインインデクスを設定する. (初期値は1)
Mark.draw、ThreeD.markなどで描くマーカーの大きさを設定する. (初期値は0.01)
枠のラインタイプを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
枠のラインインデクスを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
独立変数の定義域を指定する. (注)現在、DCLにおいては利用されていない。
グラフの下部マージンに書くメッセージの位置を決める内部変数. -1 から +1 までの実数値をとりうる. -1 のとき左よせ, 0 のときセンタリング, +1 のとき右よせする(初期値は 0 ).
コンターレベルを自動的に生成するとき,この内部変数を参照して約 nlev 本のコンターレベルを生成する(初期値は12).
minor line を major line の間に何本引くかを指定する. すなわち icycle で参照する値に1本の割合で major line を引き, 残りは minor line を引く(初期値は2).
なお、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Common.frtypeでパラメタfrtypeの参照が、Common.frtype=でパラメタfrtypeの変更ができる。
Common.set(key, val)
パラメタの設定を行う。
引数
使用例
Common.set("frindex", 3) # 枠のラインインデクスを3に設定するCommon.get(key)
パラメタを参照する。
引数
使用例
Common.get("frindex") #枠のラインインデクスを参照するCommon.help_params
Commonで設定可能なパラメタを参照する。
引数 なし
備考
Common.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Devモジュールはデバイス関連のモジュールであり、また全体パラメタの管理も行う。 全体パラメタとはDCL(rbdcl)全体に影響を及ぼすパラメタである。
Dev の機能には「基本機能」と「拡張機能」があり, 基本機能はすべてのデバイスにおいて実現される (と仮定している) が, 拡張機能はデバイスによって実現できないものもある.
基本機能
拡張機能
上位ルーチンは拡張機能が使えない場合があることを想定して, コーディングされなければならない. これらの機能が使えるかどうかは, Dev を通して取得できる.
線の太さと色はデバイスの能力によって切替えられる. また, ハードフィルのできないデバイスでは, ソフトフィルによる網かけに自動的に変更する.
イメージ表示機能とポインティング機能に関しては代替処置がないので, これらの機能を使う時には注意が必要である.
なお, Dev の管理するパラメタは, デバイスのオープン時にすべて読み込まれて, その後は参照されないので, Devのパラメタは Dev.openの前に設定しなければならない.
パラメタ名 パラメタの型 対応するDCLパッケージ
全ての出力装置に共通なパラメタ
Dev が実現している出力装置の数、標準ライブラリにおける値は3(X,PS,Tek)である。
オープンする装置番号。１から maxwnu の間の値を指定する。（初期値は１）。
ワークステーション名。標準ライブラリにおける値は、wsname01 = X (Xサーバー),wsname02 = PS (ポストスクリプト), wsname03 = Tek (テクトロ端末)となっている。
Xサーバ(X)及びポストスクリプト(PS)に共通なパラメタ
イメージウィンドウの横方向のサイズ（省略値は９００）
イメージウィンドウの縦方向のサイズ（省略値は６５０）．Xでは、iwidth, iheight のウィンドウがオープンされる。PSでは、縦横比が iheight : iwidth の描画領域が最大描画領域に最大内接するように用意されている。
Xサーバに関するパラメタ
ウィンドウの位置を示すX座標。（省略値はー９９９）。
ウィンドウの位置を示すY座標。（省略値はー９９９）。 (iposx, iposy)=(-999,-999)のときユーザーがマウスで指定する。
改ページのタイミングで一時停止するかどうかを指定する。trueなら一時停止する； false なら一時停止しない。（省略値は true）
デバイスをオープンするタイミングで一時停止するかどうかを指定する。true なら一時停止する； false なら一時停止しない。（省略値は false）
デバイスをクローズするタイミングで一時停止をするかどうかを指定する。true なら一時停止する； false なら一時停止しない。（省略値は true）
Xのダンプファイル（xwd）を作成するかどうかを指定する。true なら作成する； false なら作成しない。（省略値は false）
裏画面で描画するかどうかを指定する。true なら裏画面で描画する；false なら裏画面で描画しない。（省略値は false ）
一時停止しているときに、キーボードからの指定を有効にするかどうかを指定する。 true なら有効にする； false なら有効にしない。（省略値は true）
ビットマップを収めたファイル名。標準ライブラリにおける値は'bitmap'。
ポストスクリプト(PS)に関するパラメタ
カラー対応したPSファイルを出力するかどうかを指定する。true ならカラー用のPSファイルを出力する；false ならモノクロ用のPSファイルを出力する。（省略値は true）
出力ファイルを１ページごとに分割して出力するかどうかを指定する。true なら分割する； false なら分割しない。（省略値は false）
作成された出力ファイルをプリンターに直接出力するかどうかを指定する。true ならプリンターに直接出力する；false なら出力しない。（省略値は false）
lprint を true としたときに用いられるプリントコマンドを指定する。（省略値は'lpr'）
テクトロ端末(Tek)に関するパラメタ
改ページのタイミングで一時停止するかどうかを指定する。trueなら一時停止する； false なら一時停止しない。（省略値は true）
テクトロ画面のうちコンソール部分の１行の長さわ指定する。（省略値は２１）
AdvancedDCL全体のパラメタ
フォントファイル名. 標準ライブラリにおける値は、font1 = 'font1u', font2 = 'font2u'.
出力ファイル名（省略値は'dcl'）。この値が'*'あ
るいは空白のとき、現在実行中のプログラム名が用いられる。Xのダンプファ イル名、PSの複数ページ出力のためのファイル名として用いられるとき、この 名前に'_nnn' （nnnはページ番号）をつけたものとなる。さらにXのダンプファ イル名の場合は'.xwd'のサフィックスがつく；PSファイル名の場合は'.ps'の サフィックスがつく。
タイトル名（省略値は'*'）。
この値が'*'あるいは空白のとき、DCLVNM（DCL の MISC1/MISKLIB 参照）が返 すバージョン名となる。Xの場合、このタイトル名はウインドウのタイトル名 として用いられる；PSの場合、タイトル名はコメント部分のCreater部分に書 かれる。
カラーマップを収めたファイル名。標準ライブラリにおける値は'colormap'。
カラー番号を
トーンパターン番号に読み替えるためのファイル名。標準ライブラリにおける 値は'cl2tnmap'.
出力する最大メッセージ数 (初期値は20).
出力するメッセージレベル. 0以下ならすべてのレベルのメッセージを出力
する; 1なら警告, エラーメッセージを出力する; 2以上ならエラーメッセージ だけ出力する (初期値は0).
一行に出力するメッセージの 最大文字数(初期値は78). メッセージを出力する
際, 各行の第一カラムにはブランクを書き出すので, 実際の一行の長さは nlnsize+1 である.
実数値を比較するとき, 誤差を含めた判断をするかどうかを指定する (第8,9,
10,11章参照). trueなら誤差を含めた判断をする; falseなら誤差を含めた判断を しない (初期値は false).
誤差を含めた判断をするときの相対誤差の基準値. システム依存(備考参照).
誤差を含めた判断をするとき, 相対誤差の基準値にかけるスケーリングファ
クター (初期値は1.0). repsl×rfact が相対誤差として用いられる.
とする. この10倍という値には任意性があるが計算結果の精度の目安 として安 全率を10倍としたものである. 実数表現の相対誤差は内部表現の形から 論理的 にもとめることができるが, 実際に実数の仮数部の最下位 bit を on/off する ことでも求めることができる. 1語の中の仮数部の位置はシステムによるが,1語 の最下位 bit が仮数部の最下位 bit であることが多い.
レーム系の大型計算機とUNIX系の計算機とでは 次の値をとることが多い.
メインフレーム系 UNIX系
0.95E-5 1.2E-6
これらのパラメタはメソッドとして用いることができる。すなわち、Dev.iwidth でパラメタ iwidth の参照が、Dev.iwidth= でパラメタ iwidth の変更ができる。
Dev.open(device="X", rot=false)
図形出力装置をオープンする(初期化処理をおこなう).
引数
備考
Dev.close
図形出力装置をクローズする(終了処理をおこなう).
引数 なし
備考
Dev.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Dev.set("iwidth", 1000) # イメージウィンドウの横方向のサイズを1000に設定Dev.get(key)
パラメタを参照する。
引数
使用例
Dev.get("iwidth") # イメージウィンドウの横方向のサイズを参照する。Dev.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Dev.reset("iwidth") # イメージウィンドウの横方向のサイズを初期値に戻すDev.help_params
Devで設定可能なパラメタを参照する。
引数 なし
備考
Dev.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Pageモジュールは図のデザインに関するモジュールである。
第1レベル目のマージンに描く文字列とコーナーマークのラインインデクス(初期 値は1).
コーナーマークを描くかどうかを指定する. true ならコーナーマークを描く; false なら描かない(初期値は true).
位は第1レベル目の長辺を1とする.
(タイトル)を描く第1レベル目のマージンの定義をする. true のときマージン の幅を第1レベル目のフレーム幅いっぱいにとる; false のとき横方向のマー ジンを取った残りの部分をマージンの幅とする(初期値は false).
(Float) <SGPACK>第1レベル目のマージンに描く文字列の左右にとるすきまの 和を文字高を単位として指定する(初期値は1.0).
1レベル目のマージンに描く文字列の上下にとるすきまの和を文字高を単位と して指定する(初期値は1.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、 Page.indexでパラメタindexの参照が、Page.index=でパラメタindexの変 更ができる。
Page.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Fig.set("index", 3) # インデクスを3に設定するPage.get(key)
パラメタを参照する。
引数
使用例
Page.get("index") # インデクスを参照するPage.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Page.reset("index") # インデクスを初期値に戻すPage.help_params
Pageで設定可能なパラメタを参照する。
引数 なし
備考
Page.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Page.size(csize)
A系列およびB系列の紙の大きさで, 第1レベル目のフレームを再設定する.
引数
備考
フレームの大きさはA系列またはB系列(A4,B5など)で指定する. フレームの向きは,
とする. また 'A'utoとすると DCL(rbdcl) の SLINIT で指定された最大作図範囲の 縦・横比を見て, 横長なら 'Y'oko, 縦長なら 'T'ate として割り付ける. たとえばA4の大きさで横長のフレームを設定するには 'A4Y'と指定する.
Page.form(dxa, dya)
縦横の長さを実長で指定して, 第1レベル目のフレームを再設定する.
引数
備考
Page.settitle(title, cside, px, py, ht, nt)
1レベル目のトップマージンまたはボトムマージンに描く文字列を設定する.
引数
title (String) : 描く文字列．次の予約変数があってそのつど相当する文字列に置き換えられる．
'#PAGE':ページ数．アラビア文字で２文字分のスペースをとる． '#DATE':プログラムを実行したときの日付．YY/MM/DD（YY:年,MM:月,DD:日）のフォーマットで表現する． '#TIME':プログラムを実行したときの時刻．HH:MM:SS（HH:時,MM:分,SS:秒）のフォーマットで表現する．
px, py (Float) : マージン内における文字列の位置を−1.0から＋1.0までの実数値で指定する．pxについては，
-1.0:左よせ 0.0:中央あわせ +1.0:右よせ
pyについては，
-1.0:下よせ 0.0:中央あわせ +1.0:上よせ
備考
設定した文字列を無効にしたいときは
Page.deltitle(nt)
とすると第nt番目の設定が無効になる.
Page.deltitle
Frame.settitleで設定した文字列を無効にする。
引数
なし
備考
なし
Page.pwvr(index)
最大作画領域の枠を描く.
引数
備考
Frameモジュールは図を描く枠に関するモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
Frame.new で設定するワークステーションビューポートを作画可能な範囲いっぱいにとるかどうかを指定する. true のときいっぱいにとる； false のとき正方形にとる（初期値は false ）
また、これらのパラメタはメソッドとして用いることができる。すなわち、Frame.lfull でパラメタ lfull の参照が、Frame.lfull= でパラメタ lfull の変更ができる。
Frame.new
新しい作画領域を設定するとともに, 新しい図を描くために必要な初期化をする.
引数
なし
備考
Frame.div(cform, ix, iy)
フレームの分割をおこない, 次のレベルのフレームを定義する.
引数
備考
Frame.mgn(xl, xr, yb, yt)
今のレベルのフレームすべてについて指定したマージンをとる.
引数
備考
Frame.rat(rx, ry)
今のレベルのフレームすべてについて, 縦横比を指定してフレームが最大内接するようにマージンをとる.
引数
備考
Frame.pvpr(index)
ビューポートの枠を描く.
引数
備考
Frame.pwwr(index)
ワークステーションウインドウの枠を描く.
引数
備考
Frame.pvpc(index, rc)
ビューポートのコーナーマークを描く.
引数
備考
Frame.pwwc(index, rc)
ワークステーションウインドウのコーナーマークを描く.
引数
備考
Frame.pwwc(index, rc)
最大作画領域のコーナーマークを描く.
引数
備考
Frame.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Frame.set("lfull", true) # フレームを作画可能範囲一杯にとるよう設定する。Frame.get(key)
パラメタを参照する。
引数
使用例
Frame.get("lfull") # フレームを作画可能範囲一杯にとるかどうか参照する。Frame.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Frame.reset("lfull") # lfull を初期値に戻すFrame.help_params
Frameで設定可能なパラメタを参照する。
引数 なし
備考
Frame.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ xラメタを陽にsyncできるためのメソッドである。
Figモジュールは各種変換に関するモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
地図投影の極の設定.
相似変換の設定.
正規化変換の変換関数番号を指定する.
3次元図における正規化変換の変換関数番号を指定する.
正規化変換のためのビューポートを設定する.
3次元図における正規化変換のためのビューポートを設定する.
ウインドウの設定.
3次元図におけるウインドウの設定.
２次元透視変換の指定. l2to3 が true なら2次元平面を3次元空間に割り付ける; false ならV座標とR座標を同一のものとして扱う.(初期値は false ).
視点の設定.
焦点の設定.
2次元平面の割付.
地図投影におけるクリッピング境界を設定する。
スケーリングファクターと原点の設定.
対数軸の設定.
投影面の「接点」を指定する. contactpoint=[uxc, uyc, rot] のとき、
円形のウィンドウを設定する.
標準緯度(初期値は0.0, 0.0).
ビューポートでのクリッピングのフラグ(初期値は false ).
単位系の指定. ldeg が true なら度を単位とする; false ならラジアンを単位とする(初期値は true).
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Float(n)などという表記は中身がFloatである長さ n の配列であることを意味し、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Fig.windowでパラメタwindowの参照が、Fig.window=でパラメタwindowの変更ができる。
Fig.new
新しい図を描くために必要な初期化をする.
引数
なし
備考
Fig.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Fig.set("window", [0.0, 1.0, 0.0, 1.0]) # ウィンドウを[0.0, 1.0, 0.0, 1.0]に設定するFig.get(key)
パラメタを参照する。
引数
使用例
Fig.get("window") # ウィンドウを参照するFig.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Fig.reset("window") # ウィンドウを初期値に戻すFig.help_params
Figで設定可能なパラメタを参照する。
引数 なし
備考
Fig.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Fig.inclpoint(xincl, yincl)
ウインドウ範囲に含めたいデータを指定する.
引数
備考
Fig.included_range
Fig.inclpointにより設定されているウィンドウ範囲を参照する。
引数
なし
備考
Fig.sname2lname(sname)
変換関数の略称から名称を求める．
引数
使用例
Fig.sname2lname('MER') #メルカトル図法の略称'MER'から名称'MERCATOR'を得る。Fig.sname2trn(sname)
変換関数の略称から変換関数番号を求める．
引数
使用例
Fig.sname2trn('MER') #メルカトル図法の略称'MER'から変換関数番号11を得る。Fig.lname2sname(lname)
変換関数の名称から略称を求める．
引数
使用例
Fig.lname2sname('MERCATOR') #メルカトル図法の名称'MERCATOR'から略称'MER'を得る。Fig.lname2trn(lname)
変換関数の名称から変換関数番号を求める．
引数
使用例
Fig.lname2trn('MERCATOR') #メルカトル図法の名称'MERCATOR'から変換関数番号11を得る。Fig.trn2sname(num)
変換関数番号から略称を求める．
引数
使用例
Fig.trn2sname(11) #メルカトル図法の変換関数番号11から略称'MER'を得る。
Fig.trn2lname(num)
変換関数番号から名称を求める．
引数
使用例
Fig.trn2lname(11) #メルカトル図法の変換関数番号11から名称'MERCATOR'を得る。
Axisモジュールは自動で軸を描くためのモジュールである。
Axis, Axis::Lin, Axis::Log を使うためには, あらかじめ変換関数番号が 1〜4 (直角直線座標系)の正規化変換が設定されていなければならない ( 本ライブラリの基本構造 参照). たとえば
Fig.viewport=[VXMIN,VXMAX,VYMIN,VYMAX] Fig.window=[UXMIN,UXMAX,UYMIN,UYMAX] Fig.transnum=ITR
が呼んであるとする. このとき Axis::Lin は次の場所に座標軸を設定できる.
X軸については
'B'ottom - (UXMIN, UYMIN)と (UXMAX, UYMIN)を結ぶ線 'T'op - (UXMIN, UYMAX)と (UXMAX, UYMAX)を結ぶ線 'U'ser - (UXMIN, UYUSER)と (UXMAX, UYUSER)を結ぶ線
Y軸については
'L'eft - (UXMIN, UYMIN)と (UXMIN, UYMAX)を結ぶ線 'R'ight - (UXMAX, UYMIN)と (UXMAX, UYMAX)を結ぶ線 'U'ser - (UXUSER, UYMIN)と (UXUSER, UYMAX)を結ぶ線
X軸に関する'B', 'T', 'U', Y軸に関する'L', 'R', 'U'は, 座標軸の構成要素(次節参照)を作画する場所を示すためのパラメーター(CSIDE)として用いられる. UXUSER, UYUSERはパラメタ uxuser, uyuser を設定して初めて有効となる(初期値は不定). 座標軸を設定できるこれらの場所は, X軸については Axis::Lin.xsaxs によって Y方向に平行移動することができる; Y軸については Axis::Lin.ysaxs によって X方向に平行移動することができる.
Axis::Lin が作画する座標軸の構成要素には次のものがある (カッコ内はその構成要素を描くサブルーチン名).
ラベル
それぞれの構成要素は次のような属性を持っている.
軸を示す線分については
a. 線分のラインインデクス <ISLCT>
目盛については
a. 目盛の長さ <ISLCT> b. 目盛を描く線のラインインデクス <ISLCT>
ラベルについては
a. 文字の高さ <ISLCT> b. 文字列の回転角 <CSIDE> c. 文字列のセンタリングオプション <CSIDE> d. 文字列を描く線のラインインデクス <ISLCT>
タイトルについては
a. 文字の高さ <ISLCT> b. 文字列の回転角 <CSIDE> c. 文字列のセンタリングオプション <引き数> d. 文字列を描く線のラインインデクス <ISLCT>
これらの属性の指定方法および <ISLCT>, <CSIDE>, <引き数>の 意味については次節で述べる.
座標軸の設定を'U'ser以外でおこなった場合, ラベルとタイトルは常にウインドウの外側に向かって描かれる. 'U'serで設定をおこなった場合, ラベルとタイトルを軸のどちら側に書くかは 内部変数'IFLAG'が決める.
Axis::Lin の各サブルーチンにはISLCT, CSIDEという2つの引き数がある. この2つの引き数およびその他の引き数が各構成要素の属性を決める.
ISLCTは0,1,2の値をとりうる. 3.3節で述べた 属性のうち<ISLCT>とあるものは,この引き数によって定まるパラメタを参照して決まる. ISLCT=0,1,2の具体的な意味は,
たとえば, 軸を示す線分のラインインデクスについては, ISLCT=0,1,2それぞれについて indext0, indext1, indext2 というパラメタがあって(初期値は順に, 不定, 1, 3) これを参照して属性が決まる. 以下では以上の表現をまとめて次のように略記する. -- 「パラメタ index(i) で指定してある値を参照してラインインデクスの属性が決まる(初期値は, 不定, 1, 3)」. これらのパラメタは Axis::Lin.get, Axis::Lin.set によって 参照/変更できる.
前節で述べた属性は具体的に次のように決まる.
軸を示す線分については
a. 線分のラインインデクス <ISLCT> パラメタ indext(i)で指定してあるラインインデクスを用いて線分を描く (初期値は, 不定, 1, 3).
目盛については
a. 目盛の長さ <ISLCT>
パラメタ rsizet(i)で指定してある長さ(単位はV座標系)の目盛を描く (初期値は, 不定, 0.007, 0.014).
b. 目盛を描く線のラインインデクス <ISLCT>
パラメタ indext(i)で指定してあるラインインデクスを用いて目盛を描く (初期値は, 不定, 1, 3). (注:目盛を描く向きはパラメタ inner が決める. inner が正のとき内側に向かって目盛を描く; 負のとき外側に向かって目盛を描く(初期値は+1). )
ラベルについては
a. 文字の高さ <ISLCT>
パラメタ rsizel(i) で指定してある高さ(単位はV座標系)の文字を描く (初期値は, 不定, 0.021, 0.028).
b. 文字列の回転角 <CSIDE>
パラメタ irotl(zs) で指定してある回転角オプションを使ってラベルを描く(初期値は, 0, 0, 0, 0, 0, 0). 回転角オプションとは,ラベルを描くときの回転角を90度が 1単位の整数値で指定するものである. (たとえば90度のとき1, -90度のとき-1と指定する.)
c. 文字列のセンタリングオプション <CSIDE>
パラメタ icent(zs) で指定してあるセンタリングオプションを使ってラベルを描く(初期値は, 0, 0, 0, +1, +1, +1). センタリングオプションとは, ラベルを描くときに左よせ(-1)するか, センタリング(0)するか, 右よせ(+1)するかを指定するものである.
d. 文字列を描く線のラインインデクス <ISLCT>
パラメタ indexl(i) で指定してあるラインインデクスを用いて文字を描く (初期値は, 不定, 3, 3).
タイトルについては
a. 文字の高さ <ISLCT>
パラメタ rsizec(i) で指定してある高さ(単位はV座標系)の文字を描く (初期値は, 不定, 0.028, 0.035).
b. 文字列の回転角 <CSIDE>
パラメタ irotc(zs) で指定してある回転角オプションを使ってラベルを描く(初期値は, 0, 0, 0, +1, +1, +1). 回転角オプションとは, タイトルを描くときの回転角を90度が 1単位の整数値で指定するものである. (たとえば90度のとき1, -90度のとき-1と指定する. )
c. 文字列のセンタリングオプション <引き数>
引き数で指定してあるセンタリングオプションを 使ってタイトルを描く. センタリングオプションとは, ラベルを描くときに左よせ(-1)するか, センタリング(0)するか, 右よせ(+1)するかを指定するものである.
d. 文字列を描く線のラインインデクス <ISLCT>
パラメタ indexl(i) で指定してあるラインインデクスを用いて文字を描く (初期値は, 不定, 3, 3).
パラメタ名 パラメタの型 対応するDCLパッケージ
USINITで自動的にパラメータを リセットすることを指定する変数. 初期値は1.
USINITは通常 Frame.newから呼ばれる.
TRUEの時, X軸の左右を逆にする.
TRUEの時, Y軸の上下を逆にする.
TRUEの時, X軸とY軸のラベル間隔及び 文字間隔を同じにする.
マージンの幅. 単位は文字幅. (9.524)
X座標のファクター値 (999.)
Y座標のファクター値 (999.)
一様X座標のオフセット値 (999.)
一様Y座標のオフセット値 (999.)
一様X座標の目盛の間隔 (999.)
一様Y座標の目盛の間隔 (999.)
一様X座標のラベルの間隔 (999.)
一様Y座標のラベルの間隔 (999.)
一様座標の目盛間隔の目安 (2).これらの値に文字幅 ( rsize1) を掛けた幅よりも 小さな間隔で, 切りのよい値をdutとして設定する.
一様X座標のラベルの最大桁数 (4)
一様Y座標のラベルの最大桁数 (4).ラベルの桁数がこれらの値よりも大きくなるとき, uoff, ufac を設定して これらの桁数以内におさまるように試みる.
ラベルが座標軸と平行な場合の, ラベル間の最小空白数. (一様座標) (1)
ラベルが座標軸と直角な場合の, ラベル間の最小空白数. (一様座標) (2)
対数X座標のラベル形式 (999)
対数Y座標のラベル形式 (999)
対数X座標の一桁の間の目盛の数 (999)
対数Y座標の一桁の間の目盛の数 (999)
対数X座標のタイプ (999)
対数Y座標のタイプ (999)
X軸のサブラベルが水平方向の場合, mxdgtsxで指定された文字数のラベルの範囲を 越えないようにサブラベルを描く.
Y軸のサブラベルが垂直方向の場合, mxdgtsyで指定された文字数のラベルの範囲を 越えないようにサブラベルを描く.
サブラベルを他方の軸のラベル領域に まで描かないことを指定する. これが TRUEの時には mxdgtsx/mxdgtsy の指定は無視される.
X軸のサブラベルのオフセット値.
Y軸のサブラベルのオフセット値.
Fig.inclpoint で設定された x 座標の最大最小値.
Fig.inclpoint で設定された y 座標の最大最小値.
X軸のタイトル (32文字以内)
Y軸のタイトル (32文字以内)
X軸のラベルのフォーマット (注1)
Y軸のラベルのフォーマット (注1)
X軸を書く位置. 'T'(Top), 'B'(Bottom), 'U'(User) のうち 2文字まで指定できる. 2つの位置のうち最初に指定した位置に サブラベルとタイトルが書かれる. (注2)
Yを描く位置. 'R'(Right), 'L'(Left), 'U'(User) のうち 2文字まで指定できる. 2つの位置のうち最初に指定した位置に サブラベルとタイトルが書かれる. (注2)
X軸のサブラベルを書く位置 'R' または 'L'
Y軸のサブラベルを書く位置 'T' または 'B'
X軸のサブラベルに書く単位 (32文字以内)
Y軸のサブラベルに書く単位 (32文字以内)
Y軸のサブラベルに書く単位 (32文字以内)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(TRUE)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(FALSE)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(TRUE)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(TRUE)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(FALSE)
ラベルを描くかどうかを指定する内部変数;TRUEなら描く, FALSEなら描かない(TRUE)
目盛の長さを指定する内部変数(単位はV座標系)(不定)
目盛の長さを指定する内部変数(単位はV座標系)(0.007)
目盛の長さを指定する内部変数(単位はV座標系)(0.014)
ラベルの文字の高さを指定する内部変数(単位はV座標系)(不定)
ラベルの文字の高さを指定する内部変数(単位はV座標系)(0.021)
ラベルの文字の高さを指定する内部変数(単位はV座標系)(0.028)
タイトルの文字の高さを指定する内部変数(単位はV座標系)(不定)
タイトルの文字の高さを指定する内部変数(単位はV座標系)(0.028)
タイトルの文字の高さを指定する内部変数(単位はV座標系)(0.035)
Y軸の作画ルーチンにおいて場所を示すパラメーターとして'U'serを指定したときに用いられるX座標値(初期値は不定).
X軸の作画ルーチンにおいて場所を示すパラメーターとして'U'serを指定したときに用いられるY座標値(初期値は不定).
ラベルの文字列の回転角を指定するパラメタ; 回転角は90度を単位とする整数値で指定する(初期値は, 0, 0, 0, 0, 0, 0). DCL manual 3.4, 3.8.3節参照.
タイトルの文字列の回転角を指定するパラメタ; 回転角は90度を単位とする整数値で指定する(初期値は, 0, 0, 0, +1, +1, +1). DCL manual 3.4, 3.8.5節参照.
ラベルの文字列のセンタリングオプションを指定するパラメタ; -1のとき左よせ, 0のときセンタリング,+1のとき右よせする(初期値は, 0, 0, 0, +1, +1, +1). DCL manual 3.4, 3.8.3節参照.
座標軸および目盛を描く線分のラインインデクスを指定するパラメタ(初期値は, 不定, 1, 3). DCL manual 3.4, 3.8.2節参照.
ラベルおよびタイトルの文字を描く線分のラインインデクスを指定するパラメタ(初期値は, 不定, 3, 3). DCL manual 3.4, 3.8.3節参照.
座標系をリニアオフセットするかどうかを指定するパラメタ. true ならリニアオフセットする; false ならしない(初期値は false). DCL manual 3.6節参照.
loffset が true のとき,X軸のオフセット値を指定するパラメタ(初期値は0.0). DCL manual 3.6節参照.
loffset が true のとき,Y軸のオフセット値を指定するパラメタ(初期値は0.0). DCL manual 3.6節参照.
loffset が true のとき,X軸のファクター値を指定するパラメタ(初期値は1.0). DCL manual 3.6節参照.
loffset が true のとき,Y軸のファクター値を指定するパラメタ(初期値は1.0). DCL manual 3.6節参照.
1つ前に描いた座標軸の構成要素からどれだけ離してラベルを描くかを指定するパラメタ(初期値は0.7; 単位は今描こうとしているラベルの高さを1とする).
座標軸のオフセット量を内部的に決める時に用いるパラメタ(初期値は1.5; 単位はパラメタ rsizec2 の大きさを1とする).
座標軸の設定を'U'serでおこなった場合,ラベルとタイトルを軸のどちら側に描くかを指定するパラメタ. iflag が正のときラベルは Axis::Lin.xplbl については上側, Axis::Lin.yplbl については右側に描かれる.負のときはその逆である. (初期値は-1). DCL manual 3.8.3節参照.
ラベルを描く場所に関するオプションを指定するパラメタ. lbtwn が true なら間に描く; false ならその場所に描く(初期値は false). DCL manual 3.8.3節参照.
ラベルを間に描くとき( lbtwn が true のとき),さらにその位置を詳しく指定する. -1.0のとき左よせ, 0.0のときセンタリング, +1.0のとき右よせする(初期値は0.0).
タイトルを描こうとして, 文字幅がビューポートの幅を越えてしまうようなとき,タイトルを描くかどうかを指定する. true なら描かない, false なら描く(初期値は false).
lbound が true でタイトルを描くスペースがないとき,エラーメッセージを出力するかどうかを指定する. true なら出力する, false なら出力しない(初期値は true).
目盛を内側に向かって打つか,外側に向かって打つかを指定するパラメタ. inner が正のとき内側に向かって目盛を打つ; 負のとき外側に向かって目盛を打つ(初期値は+1).
値が不定であることを示すパラメタ(初期値は-999).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Axis.iresetでパラメタiresetの参照が、Axis.ireset=でパラメタiresetの変更ができる。
Axis.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Axis.set("cxttl", "xtitle") # X軸のタイトルを"xtitle"に設定Axis.get(key)
パラメタを参照する。
引数
使用例
Axis.get("cxttl") #X軸のタイトルを参照する。Axis.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Axis.reset("cxttl") # X軸のタイトルを初期値に戻すAxis.help_params
Axisで設定可能なパラメタを参照する。
引数 なし
備考
Axis.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Axis.zfact(rfact)
パラメタ 'rsize(i)', 'rsize(i)', 'rsizec(i)' (i=1,2) をすべて何倍かする.
引数
備考
Axis.title(cxttl, cxunit, cyttl, cyunit)
Axis.drawで書く座標軸のタイトル及び サブラベルの中の単位を指定する.
引数
備考
Axis.xpttl(cside, islct, cttl, px, temp=nil)
タイトルを描く.
引数
備考
Axis.ypttl(cside, islct, cttl, py, temp=nil)
タイトルを描く.
引数
備考
Axis.xmttl(cside, cttl, px, temp=nil)
大きめのタイトルを描く.
引数
備考
Axis.ymttl(cside, cttl, py, temp=nil)
大きめのタイトルを描く.
引数
備考
Axis.xsttl(cside, cttl, px, temp=nil)
小さめのタイトルを描く.
引数
備考
Axis.ysttl(cside, cttl, py, temp=nil)
小さめのタイトルを描く.
引数
備考
Axis.draw(x=nil, y=nil, temp=nil)
デフォルトの座標軸を描く. タイトルが指定されていればタイトルも書く.
引数
備考
Axis.xax(cside, x=nil, y=nil, temp=nil)
現在設定されている正規化変換に対して 適当な目盛とラベル間隔を計算し, 指定された場所に座標軸を一本描く.
引数
備考
Axis.yax(cside, x=nil, y=nil, temp=nil)
現在設定されている正規化変換に対して 適当な目盛とラベル間隔を計算し, 指定された場所に座標軸を一本描く.
引数
備考
Axis::Linモジュールは直交座標系の座標軸をプロットするためのモジュールである. したがって, 変換関数番号(Figのtransnum)としては 1〜4 (直角直線座標系)の正規化変換に対してのみ使用できる. それ以外の変換関数番号を指定しても動作は保証されない.
Y軸の作画ルーチンにおいて場所を示すパラメーターとして'U'serを指定したときに用いられるX座標値(初期値は不定). 詳しくはDCL manual 3.2節参照.
X軸の作画ルーチンにおいて場所を示すパラメーターとして'U'serを指定したときに用いられるY座標値(初期値は不定). 詳しくは DCL manual 3.2節参照.
ラベルを描くかどうかを指定するパラメタ; true なら描く, false なら描かない(初期値は, true, false, true, true, false, true). DCL manual 3.6.3, 3.6.2, 3.6.1節参照.
ラベルの文字列の回転角を指定するパラメタ; 回転角は90度を単位とする整数値で指定する(初期値は, 0, 0, 0, 0, 0, 0). DCL manual 3.4, 3.8.3節参照.
タイトルの文字列の回転角を指定するパラメタ; 回転角は90度を単位とする整数値で指定する(初期値は, 0, 0, 0, +1, +1, +1). DCL manual 3.4, 3.8.5節参照.
ラベルの文字列のセンタリングオプションを指定するパラメタ; -1のとき左よせ, 0のときセンタリング,+1のとき右よせする(初期値は, 0, 0, 0, +1, +1, +1). DCL manual 3.4, 3.8.3節参照.
座標軸および目盛を描く線分のラインインデクスを指定するパラメタ(初期値は, 不定, 1, 3). DCL manual 3.4, 3.8.2節参照.
ラベルおよびタイトルの文字を描く線分のラインインデクスを指定するパラメタ(初期値は, 不定, 3, 3). DCL manual 3.4, 3.8.3節参照.
目盛の長さを指定するパラメタ(単位はV座標系;初期値は, 不定, 0.007, 0.014). DCL manual 3.4, 3.8.2節参照.
ラベルの文字の高さを指定するパラメタ(単位はV座標系;初期値は, 不定, 0.021, 0.028). DCL manual 3.4, 3.8.3節参照.
タイトルの文字の高さを指定するパラメタ(単位はV座標系;初期値は, 不定, 0.028, 0.035). 3.4, 3.8.5節参照.
タイトルの文字の高さを指定するパラメタ(単位はV座標系;初期値は, 不定, 0.028, 0.035). DCL manual 3.4, 3.8.5節参照.
座標系をリニアオフセットするかどうかを指定するパラメタ. true ならリニアオフセットする; false ならしない(初期値は false). DCL manual 3.6節参照.
loffset が true のとき,X軸のオフセット値を指定するパラメタ(初期値は0.0). DCL manual 3.6節参照.
loffset が true のとき,Y軸のオフセット値を指定するパラメタ(初期値は0.0). DCL manual 3.6節参照.
loffset が true のとき,X軸のファクター値を指定するパラメタ(初期値は1.0). DCL manual 3.6節参照.
loffset が true のとき,Y軸のファクター値を指定するパラメタ(初期値は1.0). DCL manual 3.6節参照.
1つ前に描いた座標軸の構成要素からどれだけ離してラベルを描くかを指定するパラメタ(初期値は0.7; 単位は今描こうとしているラベルの高さを1とする).
座標軸のオフセット量を内部的に決める時に用いるパラメタ(初期値は1.5; 単位はパラメタ rsizec2 の大きさを1とする).
座標軸の設定を'U'serでおこなった場合,ラベルとタイトルを軸のどちら側に描くかを指定するパラメタ. iflag が正のときラベルは Axis::Lin.xplbl については上側, Axis::Lin.yplbl については右側に描かれる.負のときはその逆である. (初期値は-1). DCL manual 3.8.3節参照.
ラベルを描く場所に関するオプションを指定するパラメタ. lbtwn が true なら間に描く; false ならその場所に描く(初期値は false). DCL manual 3.8.3節参照.
ラベルを間に描くとき( lbtwn が true のとき),さらにその位置を詳しく指定する. -1.0のとき左よせ, 0.0のときセンタリング, +1.0のとき右よせする(初期値は0.0).
タイトルを描こうとして, 文字幅がビューポートの幅を越えてしまうようなとき,タイトルを描くかどうかを指定する. true なら描かない, false なら描く(初期値は false).
lbound が true でタイトルを描くスペースがないとき,エラーメッセージを出力するかどうかを指定する. true なら出力する, false なら出力しない(初期値は true).
目盛を内側に向かって打つか,外側に向かって打つかを指定するパラメタ. inner が正のとき内側に向かって目盛を打つ; 負のとき外側に向かって目盛を打つ(初期値は+1).
値が不定であることを示すパラメタ(初期値は-999).
X軸のラベルフォーマットを設定する。値は長さ16以下の文字型変数. たとえば値として '(F6.1)'のように指定する. 初期値は固有のオプションである'B' (有効数字3ケタで文字化し, 小数点以下に続く後方の0は取り除く; さらに小数点が最下位ならそれも取り除く). また、自動的に文字を左詰めする. つまり実数値1.2を文字化するために'(F4.1)'としても '(F8.1)'としても返す値はどちらも'1.2'である.
Y軸のラベルフォーマットを設定する。値は長さ16以下の文字型変数. たとえば値として '(F6.1)'のように指定する.
最後に描いたラベルやタイトルの軸からの距離を保持しているパラメタ(初期値は, 0, 0, 0, 0, 0, 0). DCL manual 3.8.1節参照.
座標軸を本来描く場所からどれだけ平行移動して描くかを指定するパラメタ(初期値は, 0, 0, 0, 0, 0, 0). DCL manual 3.8.1節参照.
また、これらのパラメタはメソッドとして用いることができる。すなわち、Axis::Lin.labelxb でパラメタ labelxb の参照が、Axis::Lin.labelxb=でパラメタ labelxb の変更ができる。
Axis::Lin.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Axis::Lin.set("labelxb", false) # X-bottom にラベルを描かないように設定Axis::Lin.get(key)
パラメタを参照する。
引数
使用例
Axis::Lin.get("labelxb") #X-bottom にラベルを描くかどうかを参照する。Axis::Lin.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Axis::Lin.reset("labelxb") # labelxb を初期値に戻すAxis::Lin.help_params
Axis::Linで設定可能なパラメタを参照する。
引数 なし
備考
Axis::Lin.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず,
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Axis::Lin.zfact(rfact)
パラメタ 'rsize(i)', 'rsize(i)', 'rsizec(i)' (i=1,2) をすべて何倍かする.
引数
備考
Axis::Lin.xaxdv(cside, dx1, dx2, x=nil, y=nil, temp=nil)
目盛とラベルを描く間隔を指定してX座標軸を描く.
引数
備考
Axis::Lin.yaxdv(cside, dy1, dy2, x=nil, y=nil, temp=nil)
目盛とラベルを描く間隔を指定してX座標軸を描く.
引数
備考
Axis::Lin.xaxlb(cside, ux1, ux2, ch, x=nil, y=nil, temp=nil)
目盛とラベルを描く場所を指定してX座標軸を描く. 描くラベルも指定する.
引数
備考
Axis::Lin.yaxlb(cside, uy1, uy2, ch, x=nil, y=nil, temp=nil)
目盛とラベルを描く場所を指定してY座標軸を描く. 描くラベルも指定する.
引数
備考
Axis::Lin.xpaxs(cside, islct, x=nil, y=nil, temp=nil)
軸を示す線分を描く.
引数
備考
座標軸は, 本来描くべき場所から平行移動した場所に描くことができる (DCL manual 3.2節参照). この移動量は, 描く場所に依存するパラメタ rofg(zs) が管理する (初期値はすべて0). この値はX/Y軸それぞれについて, メソッド
Axis::Lin.xsaxz(cside, roffx) / Axis::Lin.ysaxz(cside, roffy)
によって設定できる. またオフセット量を内部的に決定するルーチン
Axis::Lin.uxsaxs(cside) / Axis::Lin.ysaxs(cside)
によっても設定できる. オフセット量はパラメタ pad2 にもとづいて計算される.
Axis::Lin.ypaxs(cside, islct, x=nil, y=nil, temp=nil)
軸を示す線分を描く.
引数
備考
座標軸は, 本来描くべき場所から平行移動した場所に描くことができる (DCL manual 3.2節参照). この移動量は, 描く場所に依存するパラメタ rofg(zs) が管理する (初期値はすべて0). この値はX/Y軸それぞれについて, メソッド
Axis::Lin.xsaxz(cside, roffx) / Axis::Lin.ysaxz(cside, roffy)
によって設定できる. またオフセット量を内部的に決定するルーチン
Axis::Lin.uxsaxs(cside) / Axis::Lin.ysaxs(cside)
によっても設定できる. オフセット量はパラメタ pad2 にもとづいて計算される.
Axis::Lin.xplbl(cside, islct, ux, ch, x=nil, y=nil, temp=nil)
文字列で指定したラベルを描く.
引数
備考
このパッケージでは次の2通りのラベルの描きかたがある. Axis::Lin.xplbl/yplblそれぞれについて
2つの方法のどちらを選ぶかはパラメタ lbtwn が決める. lbtwn が true なら間に描く; false ならその場所に描く(初期値は false). ただし, ラベルを間に描くように指定していても, ラベルが2点の間隔より 大きいときラベルは描かれない. またメッセージも出力されない.
Axis::Lin.yplbl(cside, islct, uy, ch, x=nil, y=nil, temp=nil)
文字列で指定したラベルを描く.
引数
備考
このパッケージでは次の2通りのラベルの描きかたがある. Axis::Lin.xplbl/yplblそれぞれについて
2つの方法のどちらを選ぶかはパラメタ lbtwn が決める. lbtwn が true なら間に描く; false ならその場所に描く(初期値は false). ただし, ラベルを間に描くように指定していても, ラベルが2点の間隔より 大きいときラベルは描かれない. またメッセージも出力されない.
Axis::Lin.xpnum(cside, islct, ux, x=nil, y=nil, temp=nil)
数値で指定したラベルを描く.
引数
備考
Axis::Lin.ypnum(cside, islct, uy, x=nil, y=nil, temp=nil)
数値で指定したラベルを描く.
引数
備考
Axis::Lin.xptmk(cside, islct, ux, x=nil, y=nil, temp=nil)
目盛を描く.
引数
備考
Axis::Lin.yptmk(cside, islct, ux, x=nil, y=nil, temp=nil)
目盛を描く.
引数
備考
Axis::Lin.xpttl(cside, islct, cttl, px, temp=nil)
タイトルを描く.
引数
備考
Axis::Lin.ypttl(cside, islct, cttl, py, temp=nil)
タイトルを描く.
引数
備考
Axis::Lin.xmttl(cside, cttl, px, temp=nil)
大きめのタイトルを描く.
引数
備考
Axis::Lin.ymttl(cside, cttl, py, temp=nil)
大きめのタイトルを描く.
引数
備考
Axis::Lin.xsttl(cside, cttl, px, temp=nil)
小さめのタイトルを描く.
引数
備考
Axis::Lin.ysttl(cside, cttl, py, temp=nil)
小さめのタイトルを描く.
引数
備考
Axis::Logモジュールは対数軸を描くためのモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
X軸に関する2・10nという形のラベルで, '・'の位置に使う文字番号.DCL文字番号(DCL 「GRPH1」のマニュアル参照)で指定する.初期値は195 (・).
Y軸に関する2・10nという形のラベルで, '・'の位置に使う文字番号.DCL文字番号(DCL 「GRPH1」のマニュアル参照)で指定する.初期値は195 (・).
X軸に関するラベルのフォーマットを指定する.1から4の整数値が指定できる(初期値は1).それぞれの意味は次項で説明.
Y軸に関するラベルのフォーマットを指定する.1から4の整数値が指定できる(初期値は1).
: 全てのラベルに指数部を付ける.
例 1・103 2・103 5・103 1・104
ただし, Text が管理するパラメタ lcntl が false のときには・10n のかわりにEnと表現する.
: 10n 以外のラベルには指数部を付けない.
例 103 2 5 104
: DCL(rbdcl)サブルーチン CHVAL(DCL 「MISC1」のマニュアルFMTLIB 参照)を使って全てのラベルを文字化する.
例 1000 2000 5000 10000
: 10nのラベルのみ CHVAL を使う.そのほかは2を指定したときと同じ.
例 1000 2 5 10000
パラメタ ixtype / iytypeが 3 または 4 のときに使用する フォーマットを設定する.
また、これらのパラメタはメソッドとして用いることができる。すなわち、Axis::Log.ixtype でパラメタ ixtype の参照が、Axis::Log.ixtype= でパラメタ ixtype の変更ができる。
Axis::Log.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Axis.set("ixtype", 4) # X軸に関するラベルのフォーマットを 4 に設定Axis::Log.get(key)
パラメタを参照する。
引数
使用例
Axis.get("ixtype") #X軸に関するラベルのフォーマットを参照する。Axis::Log.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Axis::Log.reset("ixtype") # X軸に関するラベルのフォーマットを初期値に戻すAxis::Log.help_params
Axis::Logで設定可能なパラメタを参照する。
引数 なし
備考
Axis::Log.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Axis::Log.xlabelset(value)
ラベルを描く位置を指定する.
引数
備考
ラベルを描く位置は, X/Y軸についてメソッド
Axis::Log.xlabelget / ylabelget
で参照することができる.
Axis::Log.ylabelset(value)
ラベルを描く位置を指定する.
引数
考
ラベルを描く位置は, X/Y軸についてメソッド
Axis::Log.xlabelget / ylabelget
で参照することができる.
Axis::Log.xlabelget
ラベルを描く位置を得る。
引数
なし
備考
Axis::Log.ylabelget
ラベルを描く位置を得る。
引数
なし
備考
Axis::Log.xdraw(cside, nlabel, nticks, x=nil, y=nil, temp=nil)
対数座標軸を描く.
引数
nlabel (Fixnum) : 1桁の範囲に描くラベルの数. 1 から 4までの整数値を指定する.
備考
Axis::Log.ydraw(cside, nlabel, nticks, x=nil, y=nil, temp=nil)
対数座標軸を描く.
引数
nlabel (Fixnum) : 1桁の範囲に描くラベルの数. 1 から 4 までの整数値を指定する.
備考
Dateaxisモジュールは日付軸を描くためのモジュールである。 作画しようとする座標軸については, 日数を単位として正規化変換が設定してなければならない. また座標軸の作画は, ユーザー座標系(UC)において0に相当する位置からおこなわれる. したがって, たとえば1月1日から1月31日まで31日分をビューポートいっぱいに割り当てたいときは,ウインドウの両端値を(0, 30)と指定する.
以下でサブルーチンに共通してあらわれる引数 CSIDE, JD0, NDについて説明する.
パラメタ名 パラメタの型 対応するDCLパッケージ
Dateaxis.xady, Dateaxis.yady を使うとき,何日ごとに目盛と日付を描くかを指定する. nday が不定なら0, 1, 2, 5, 10, 15の中から適当な値が選ばれる(0以下のときは軸を描くだけで目盛と日付は描かない);陽に与えられていればその値を使う(初期値は不定). これは DCL の関数 'NUCDAY'が決める.
Dateaxis.xamn, Dateaxis.yamn を使うとき,月名を何文字描くかを指定する. ncharが不定なら0, 1, 2, 3, 9の中から適当な値が選ばれる( 0 のときは軸を描くだけで目盛と月名は描かない);陽に与えられていればその値を使う(初期値は不定).これは DCL の関数 'NUCCHR' が決める.
Dateaxis.xady, Dateaxis.yady で描く月名の2文字目以下を小文字にするかどうかを指定する. true なら小文字にする; false なら大文字のままにする(初期値は false).
値が不定であることを示す内部変数(初期値は -999).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Dateaxis.nday でパラメタ nday の参照が、 Dateaxis.nday= でパラメタ nday の変更ができる。
Dateaxis.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Dateaxis.set("nday", 15) # nday を 15 に設定Dateaxis.get(key)
パラメタを参照する。
引数
使用例
Dateaxis.get("nday") # nday を参照する。Dateaxis.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Dateaxis.reset("nday") # nday を初期値に戻すDateaxis.help_params
Dateaxisで設定可能なパラメタを参照する。
引数 なし
備考
Dateaxis.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Dateaxis.xdraw(cside, jd0, nd, x=nil, y=nil, temp=nil)
日・月・年に関する座標軸を描く.
引数
備考
Dateaxis.ydraw(cside, jd0, nd, x=nil, y=nil, temp=nil)
日・月・年に関する座標軸を描く.
引数
備考
Dateaxis.xady(cside, jd0, nd, x=nil, y=nil, temp=nil)
日に関する座標軸を描く.
引数
備考
Dateaxis.yady(cside, jd0, nd, x=nil, y=nil, temp=nil)
日に関する座標軸を描く.
引数
備考
Dateaxis.xamn(cside, jd0, nd, x=nil, y=nil, temp=nil)
月に関する座標軸を描く.
引数
備考
Dateaxis.yamn(cside, jd0, nd, x=nil, y=nil, temp=nil)
月に関する座標軸を描く.
引数
備考
Dateaxis.xayr(cside, jd0, nd, x=nil, y=nil, temp=nil)
年に関する座標軸を描く.
引数
備考
Dateaxis.yayr(cside, jd0, nd, x=nil, y=nil, temp=nil)
年に関する座標軸を描く.
引数
備考
Plotモジュールは直交座標系でプロット図を描くためのモジュールである。 したがって, 変換関数番号としてはITR=1〜4(直角直線座標系)の 正規化変換に対してのみ使用できる. それ以外の変換関数番号を指定しても動作は保証されない.
Plot, Mark, Bar, Box, Gap, Errbarのメソッド群は, 変数の数によって次の4つのタイプに分類される.
独立変数の数 従属変数の数
TYPE 1 N N TYPE 2 N N×2 TYPE 3 N+1 N TYPE 4 N+1 N×2
ここで, 独立変数として指定する配列の数は常に1つで, その長さがN または N+1 である. 従属変数は1つの配列の長さは常に N であるが, 2つの配列を指定するもの(N×2)がある.
TYPE 3 と TYPE 4 のルーチンはこのパッケージでは「箱グラフ」と 呼んでいる. これは, 指定した独立変数の「位置」にある幅の棒を描く棒グラフに対して, 指定した独立変数の「区間」を埋める箱を描くものである. この中の Box.xdraw, Box.ydraw は階段状のグラフを描くものである.
Plot, Mark, Bar, Box, Gap, Errbarのメソッド群は, 独立変数または従属変数に未定義値 (RUNDEF) を指定することができる. この値が指定された時の解釈は次の通り.
パラメタ UREF (初期値=0) の値が指定されたものとみなす. ただし, 従属変数に RUNDEF が指定できるのは, 2つの従属変数をもつTYPE2, TYPE4 のルーチンのみである.
従属変数の未定義値は, 棒グラフのように 棒の上下の位置を指定するようなサブルーチンで, 常に座標軸から指定された位置までの棒を描くような場合を想定している.
パラメタ名 パラメタの型 対応するDCLパッケージ
ポリラインプリミティブの描く折れ線のラインタイプをビットパターンで設定するとき,下位何ビットを使うかを指定する（初期値は１６）.
ポリラインプリミティブの描く折れ線のラインタイプをビットパターンで設定するとき,１ビットがVC上でどれだけの長さに相当するかを指定する（初期値は0.003）.
SZPACKの下位ルーチンが破線等のパターンで線を引くとき,pen-up moveの後のパターンのサイクルについて指定する（初期値は1）．
ポリラインプリミティブで折れ線を描くとき,ラベルつき折れ線とするかどうかを指定する.TRUEのときラベルつき折れ線とする；FALSEのときラベルなし折れ線とする（初期値はFALSE）．以下はこのラベルつき線分に関するパラメーターである.
ラベルとして付ける文字列を一定の回転角で描くか,あるいは線分に沿って描くかを指定する.TRUEのとき一定の回転角で描く；FALSEのとき線分に沿って描く（初期値はFALSE）．
ラベルとして付ける文字列を一定の回転角で描くとき（'LROT'が.TRUE.のとき）の回転角を指定する（単位は度；初期値は０）.
文字列を書くための空白域の幅を全文字幅を単位としてどれだけとるかを指定する係数（初期値は1.25）
1サイクルあたり,線分部分の長さを文字高を単位として何文字分とるかを指定する係数（初期値は30.0）
ラベルつき折れ線を描くにあたって，線分部分を1単位としてどれだけ進んだところから描き始めるかを指定する（初期値は0.5）．
ラベルとして各文字列のラインインデクスを指定する（初期値は0）．値が0のとき,線分部分を書くために現在設定されているラインインデクスと同じ値をとる．
折れ線の終りが文字列を描くべき空白部分であるときそこを線分で結ぶためのバッファリングをすうかどうかを指定する.TRUEのときバッファリングをする；FALSEのときバッファリングしない（初期値はTRUE）
バッファリングをするときその長さを指定する（初期値は20）．
バッファリングをした内容を書き出した後,ラベルつき折れ線のサイクルの位置を指定する．0と1の間の値を指定すること.（初期値は0.99）
折れ線のなす角が大きなところではラベルを書かないことを指定する.正確には,文字を書くべきスペースが次のパラメーター'rcurv'の係数以下のときラベルを書かない.TRUEのときラベルを書かない；FALSEのときラベルを書く（初期値はTRUE）
lcurvがTRUEで，ラベルを書くべきスペースがこの係数以下のときラベルを書かない.（初期値は1.0）
折れ線の ラインインデクスを設定する(初期値は1).lineindexは1以上でなければならない. ただしlineindexが0のとき, メッセージは出力されるがなにもしない.
折れ線のラインタイプを設定する(初期値は1). linetypeが1のとき実線, 2のとき破線, 3のとき点線, 4のとき1点鎖線となる. その他の0以外の整数は下位Nビット (Nはパラメタnbitsで決まる値. 初期値は16)のビットパターンを用いて線種が設定される. たとえばN=16で itype = Z'0000F0F0' (16進定数)のとき, '4bits ON 4bits OFF 4bits ON 4bits OFF' のような破線が設定される. 1ビット当たりの長さはbitlenが決める.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Plot.nbitsでパラメタnbitsの参照が、Plot.nbits=でパラメタnbitsの変更ができる。
Plot.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Axis.set("lineindex", 3) #ラインインデクスを3にする。Plot.get(key)
パラメタを参照する。
引数
使用例
Plot.get("lineindex") #ラインインデクスを参照する。Plot.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Plot.reset("lineindex") # ラインインデクスを初期値に戻すPlot.help_params
Plotで設定可能なパラメタを参照する。
引数 なし
備考
Plot.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Plot.draw(x, y, temp=nil)
U座標系で折れ線を描く。
引数
備考
Plot.vdraw(x, y, temp=nil)
V座標系で折れ線を描く.
引数
備考
Plot.rdraw(x, y, temp=nil)
R座標系で折れ線を描く.
引数
備考
Plot.setlabel(label)
ラベルつき折れ線を描くとき, その文字列を指定する.
引数
備考
Plot.nplc
設定されている文字列の最後の文字の文字番号を1つ増やす.
引数 なし
備考
Contourモジュールは等高線図を描くためのモジュールである。 等高線はU座標系で作画されるので, すべての正規化変換に対応している. このモジュールでは, 等高線図を描くだけで座標軸などの外枠は描かない.
Contour においてユーザーが使用するメソッドとしては以下のようなものがある.
作画メソッド
コンターレベルに関するメソッド
その他のメソッド
格子点座標に関しては、作画メソッドに格子点情報(座標値として)を与えると自動的に設定してくれる.
2次元データをとにかくコンタリングしたい(quick look)というときには, 単に Contour.draw を呼ぶだけでよい. このときは, 現在設定されているウインドウいっぱいに 等間隔の格子点を設定し, コンターレベルも自動的に生成する.
もしも格子点が不等間隔の場合は, 格子点の座標値を描画メソッドの引数として指定すればよい.
またコンターレベルをあらかじめ指定したいときは, Contour.draw を呼ぶ前に Contour.gcla または Contour.gclb を呼べばよい. ただしこの場合は, 等間隔のコンターレベルしか生成されない. もしも, 不等間隔のコンターレベルを指定したい場合や, 特定のコンターレベルを追加したい場合は, Contour.sclv で1本1本のコンターレベルを生成してやればよい. (1本のコンターレベルを無効にするには Contour.dclv を呼べばよい; すべてのコンターレベルを無効にするには Contour.iclv を呼べばよい. )
パラメタ名 パラメタの型 対応するDCLパッケージ
major line のラインインデクス(初期値は3).
minor line のラインインデクス(初期値は1).
major line にラベルをつけるかどうかの指定をする. true ならつける; false ならつけない(初期値は true ).
負のコンターラインを異なるラインタイプで描くかどうかを指定する. true のとき負のコンターラインをパラメタ idash の参照するラインタイプで描く; false のときすべてのコンターラインをパラメタ isolid の参照するラインタイプで描く(初期値は true ).
ldash が true のとき,負のコンターレベルに使うラインタイプ(初期値は3:破線).
ldash が true のとき0以上のコンターレベルに,または ldash が false のときすべてのコンターレベルに使うラインタイプ(初期値は1:実線).
minor line を major line の間に何本引くかを指定する. すなわち icycle で参照する値に1本の割合で major line を引き, 残りは minor line を引く(初期値は2).
コンターレベルを自動的に生成するとき,この内部変数を参照して約 nlev 本のコンターレベルを生成する(初期値は12).
コンターラベルの文字高(単位はV座標系;初期値は不定).この内部変数が不定のとき Axis の管理するパラメタ rsizel1を参照する( Axis 参照).
グラフの下部マージンにメッセージを書くかどうかを指定する. true なら書く; false なら書かない(初期値は true ).
グラフの下部マージンに書くメッセージの文字高(単位はV座標系;初期値は不定).この内部変数が不定のとき Axis の管理するパラメタ rsizel1 を参照する(3.7節参照).
グラフの下部マージンに書くメッセージの位置を決める内部変数. -1 から +1 までの実数値をとりうる. -1 のとき左よせ, 0 のときセンタリング, +1 のとき右よせする(初期値は 0 ).
コンターラベルのフォーマットを指定する(長さは16文字以下). たとえばコンターラベルをすべて整数型にしたいとき
Contour.labelfmt = '(I8)'
とすればよい (文字は左詰めされるのでラベルが8文字以下なら, たとえば '(I12)' でも効果は同じ). 初期値はDCL(rbdcl)のサブルーチンCHVAL (「MISC1」のマニュアルFMTLIB参照)が解釈するオプション'D' (有効数字3ケタでほぼ4-5文字の表現)である.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Contour.xttl でパラメタ xttl の参照が、Contour.xttl= でパラメタ xttl の変更ができる。
Contour.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Contour.set("xttl", -1) # メッセージを左寄せにする。Contour.get(key)
パラメタを参照する。
引数
使用例
Contour.get("xttl") # メッセージの位置を参照する。Contour.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Contour.reset("xttl") # メッセージの位置を初期値に戻すContour.help_params
Contourで設定可能なパラメタを参照する。
引数 なし
備考
Contour.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Contour.gcla(max, min, dx)
Contour.draw で使うコンターレベル値を 最小値・最大値および きざみ値またはおよそのレベル数で設定する.
引数
備考
Contour.gclb(z, dx)
Contour.draw で使うコンターレベル値を格子点値を与える配列ときざみ値またはおよそのレベル数で設定する.
引数
備考
Contour.sclv(zlev, index, itype, clv, hl)
コンターラインの属性をすべて指定して1本のコンターレベルを設定する.
引数
備考
現在設定されているコンターレベルの属性は
Contour.levelget
によって参照できる.
Contour.dclv(zlev)
あるコンターレベルを削除する.
引数
備考
Contour.iclv
Contour.gcla, Contour.gclb, Contour.sclv で設定したコンターレベルを無効にする.
引数 なし
備考
Contour.intervalget(nlev)
DGCLA, UDGCLB, UDSCLVで設定したコンターレベルの 間隔を求める.
引数
備考
Contour.levelget
現在設定されているコンターレベルの属性を求める。
引数 なし
備考
Contour.draw(data, x=nil, y=nil, temp=nil)
2次元等高線図を描く
引数
備考
コンターを引くレベルの値がContour.gcla, Contour.gclb または Contour.sclv によって設定されていない場合, 次のサブルーチンを内部で呼んで 約 nlev 本のコンターレベルを設定する.
Contour.gclb(z, -(nlev))
nlev は Contour の管理するパラメタ nlev が参照する値である(初期値は12).
コンタリングの前にすべての格子点値のチェックをおこなう. 次の2つの場合コンタリングはおこなわずその旨メッセージが出力される. さらにパラメタ lmsg が true のときグラフの下部マージンにもメッセージを書く. false のときメッセージを書かない (初期値は true ).2つの場合とは:
Toneモジュールはカラートーン(モノクロも)を貼るためのモジュールである。 ぬりわけはU座標系でおこなわれるので, すべての正規化変換に対応している.
このパッケージでは, ぬりわけをおこなうだけで 等値線そのものや座標軸の外枠などは描かない.
Tone においてユーザーが使用するサブルーチンとしては以下のようなものがある.
作画メソッド
その他のメソッド
格子点座標に関しては、作画メソッドに格子点情報(座標値として)を与えると自動的に設定してくれる.
2次元データをとにかくぬりわけたい(quick look)というときには, 単に Tone.draw を呼ぶだけでよい. このときは, 現在設定されているウインドウいっぱいに 等間隔の格子点を設定し, 負の領域に斜線のハッチをつける.
ぬりわけるレベル値の設定を Contour と同様にしておこないたいときは, Tone のパラメタ ltoneを true として Tone.draw を呼べば, Contour が自動的に生成するきざみ値で (厳密には Contour と同じアルゴリズムにもとづいてレベル値を設定し)ぬりわける. さらに, Contour.gcla に対応して Tone.gtla, Contour.gclb に対応して Tone.gtlb を呼べば コンターレベルとぬりわけるレベルの値が同一に設定される.
もしも格子点が不等間隔の場合は, 格子点の座標値を描画メソッドの引数として指定すればよい.
上に述べたように, ぬりわけるレベルをあらかじめ指定したいときは, Tone.drawを呼ぶ前に Tone.gtla または Tone.gtlb を呼べばよい. ただしこの場合は, 等間隔のトーンレベルしか生成されない. もしも, 不等間隔のトーンレベルとパターンを指定したい場合や, 特定のトーンレベルとパターンを追加したい場合は, Tone.stlv または Tone.stln を呼べばよい. (すべてのレベルを無効にするには Tone.itlv を呼べばよい. ) なお,ぬりわけは指定したレベルの順におこなう.
このモジュールが用いているトーンプリミティブは 出力装置の能力に応じてhard fillとsoft fillを切替えることができる. Tone が管理するパラメタ lsoftf が true のときはsoft fillをおこなう; false のとき hard fillをおこなう (初期値は true). ただし, hard fillを指定してもその能力がない場合は soft fillとなる.
また, 色を用いたべた塗り(下位3桁が999であるようなトーンパターン番号) による塗りわけをおこなうとき, 色番号をドットなどのパターン番号として読みかえることができる. Tone の管理するパラメタ lcl2tn が true のときは読みかえる; false のときは読みかえない (初期値は false). ただし, 色を用いた塗りわけができないような装置では, lcl2tn が false と設定されていても, パターン番号による読みかえをおこなおうとする.
すでに描かれた図形の上にsoft fillをおこなっても, トーンパターンが上書きされるだけで, それまでに描かれた図形が(べた塗りをしない限り)消えてしまうことはない. しかしながら, 出力装置によってはhard fillによるぬりわけによって先に描かれた図形が消えてしまうことがあるので,座標軸や等高線図と一緒にUEPACKを用いるときは 描く順番に注意すること.
パラメタ名 パラメタの型 対応するDCLパッケージ
ltone が true のとき用いる色番号の下限値(初期値は15).
ltone が true のとき用いる色番号の上限値(初期値は94).
ltone が false のとき, 内部変数 rlev 以下の領域をぬるトーンパターン(初期値は1201:右上がりの斜線).
トーンレベルを自動的に生成するとき,この内部変数を参照して約 nlev 本のコンターレベルを生成する(初期値は12).
minor line を major line の間に何本引くかを指定する. すなわち icycle で参照する値に1本の割合で major line を引き, 残りは minor line を引く(初期値は2).
ぬりわけるトーンレベルをユーザーが指定しなかったとき, Tone.gtlb を使ってトーンレベルとトーンパターンを生成するかどうかを指定する. true なら Tone.gtlb をつかう; false なら rlev (下記)以下をぬるような設定をする(初期値は false).
ltone が false のとき, ぬりわける領域の境界値(初期値は0.0).ここで指定した値以下の領域をぬる.
トーンプリミティブで塗りつぶしをおこなうとき soft fill をおこなうか hard fill をおこなうかを指定する. true のときは soft fill をおこなう; false のときは hard fill をおこなう(初期値は false). ただし, hard fill を指定してもその能力がない場合は soft fillとなる.
色を用いたべた塗りによる塗りわけをおこなうとき, 色番号をドットなどのパターン番号として読みかえるかどうかを指定する. true のときは読みかえる; false のときは読みかえない(初期値は false).ただし, 色を用いた塗りわけができないような装置では, false と設定されていてもパターン番号による読みかえをおこなおうとする.
トーンプリミティブでドットパターンによる soft fill をおこなう場合,フィルエリアサブプリミティブの下位ルーチンを用い点線の集合として表現する.このとき点線のラインタイプはビットパターンで設定されるが,その1ビットが RC 上でどれだけの長さに相当するかを指定する(初期値は0.001).
トーンプリミティブで指定された閉領域がクリッピング境界にかかる時に, 境界線の向きを指定するパラメタ. 0 のとき反時計回り; 1 のとき時計回り. DCL manual 1.7.5節参照のこと.(初期値は0).
ltone が true のとき用いるパターン番号(初期値は999, べた塗り).
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Tone.nlev でパラメタ nlev の参照が、Tone.nlev= でパラメタ nlev の変更ができる。
Tone.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Tone.set("nlev", 10) # nlevの値を 10 に設定するTone.get(key)
パラメタを参照する。
引数
使用例
Tone.gox("nlev") # nlev の値を参照するTone.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Tone.reset("nlev") # nlev を初期値に戻すTone.help_params
Toneで設定可能なパラメタを参照する。
引数 なし
備考
Tone.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Tone.gtla(max, min, dx)
Tone.draw で使うトーンレベル値を 最小値・最大値および きざみ値またはおよそのレベル数で設定する.
引数
備考
Tone.gtlb(z, dx)
Tone.draw で使うコンターレベル値を格子点値を与える配列ときざみ値またはおよそのレベル数で設定する.
引数
備考
Tone.stlv(zlev, index, itype, clv, hl)
コンターラインの属性をすべて指定して1本のコンターレベルを設定する.
引数
備考
現在設定されているコンターレベルの属性は
Tone.levelget
によって参照できる.
Tone.stln(tlevn, ipatn)
ぬりわけるレベルとパターンを配列で複数レベル指定する.
引数
備考
Tone.itlv
Tone.stlv または Tone.stln で設定したトーンレベルを無効にする.
引数
なし
備考
Tone.levelget
現在設定されているコンターレベルの属性を求める。
引数 なし
備考
Tone.draw(data, x=nil, y=nil, temp=nil)
トーンによる2次元等値線図のぬりわけをおこなう.
引数
備考
ぬりわけをおこなうレベルの値が Tone.gtla, Tone.gtlb, Tone.stlv または Tone.stln によって設定されていない場合, 次のようにぬりわけるレベル値とトーンパターンを設定する. Tone の管理するパラメタ ltone が true のとき,
Tone.gtlb(data,-(nlev))
を呼んで約 nlev 本のトーンレベルを設定する。nlev はパラメタ nlev が参照する値である (初期値は12); パラメタ ltone が false のとき, パラメタ rlev が参照する値以下の領域をパラメタ ipat が参照する値のトーンパターンでぬりわける (rlev, ipat の初期値はそれぞれ 0.0, 1201:右上がりの斜線). なお ltone の初期値は false である.
ぬりわけをおこなう前にすべての格子点値のチェックをおこなう. 次の2つの場合ぬりわけはおこなわずその旨メッセージが出力される. 2つの場合とは:
Tone.mosaic(data, x=nil, y=nil, temp=nil)
2次元等値線図をモザイク状に描く.
引数
備考
ぬりわけをおこなうレベルの値が Tone.gtla, Tone.gtlb, Tone.stlv または Tone.stln によって設定されていない場合, 次のようにぬりわけるレベル値とトーンパターンを設定する. Tone の管理するパラメタ ltone が true のとき,
Tone.gtlb(data,-(nlev))
を呼んで約 nlev 本のトーンレベルを設定する。nlev はパラメタ nlev が参照する値である (初期値は12); パラメタ ltone が false のとき, パラメタ rlev が参照する値以下の領域をパラメタ ipat が参照する値のトーンパターンでぬりわける (rlev, ipat の初期値はそれぞれ 0.0, 1201:右上がりの斜線). なお ltone の初期値は false である.
ぬりわけをおこなう前にすべての格子点値のチェックをおこなう. 次の2つの場合ぬりわけはおこなわずその旨メッセージが出力される. 2つの場合とは:
Tone.imdraw(data, x=nil, y=nil, temp=nil)
イメージデータ描画機能を使って, 2次元等値線図のぬりわけをおこなう.
引数 引数
備考
Tone.fill(upx, upy, temp=nil)
多角形閉領域をぬりつぶす.
引数
備考
Tone.vfill(vpx, vpy, temp=nil)
V座標系で多角形閉領域をぬりつぶす.
引数
備考
Tone.rfill(rpx, rpy, temp=nil)
R座標系で多角形閉領域をぬりつぶす.
引数
備考
Vectorモジュールは2次元ベクトル場を描くためのモジュールである。 現在のところ, ベクトルの長さのスケーリング等をV座標系でおこない, ベクトルをV座標系で描いているため, 直角直線座標系 (変換関数番号ITR=1〜4)にしか対応していない.
このモジュールにおいて, ベクトルは Arrow をもちいて描かれる. なおこのパッケージでは, ベクトル場を描くだけで座標軸などの外枠は描かない.
Vector においてユーザーが使用するサブルーチンとしては以下のようなものがある.
作画メソッド
その他のメソッド
格子点座標に関しては、作画メソッドに格子点情報(座標値として)を与えると自動的に設定してくれる.
2次元格子点上で与えられたベクトルデータをとにかく描きたい (quick look)というときには, 単に Vector.draw を呼ぶだけでよい. このときは, 現在設定されているウインドウいっぱいに 等間隔の格子点を設定し, ベクトルの長さも自動的スケーリングされる.
ももしも格子点が不等間隔の場合は, 格子点の座標値を描画メソッドの引数として指定すればよい.
またパラメタを設定してやることによって ベクトルのスケーリングファクターを変えたり, ユニットベクトルを描いたりすることができる.
パラメタ名 パラメタの型 対応するDCLパッケージ
ベクトルを描く線分のラインインデクス.および lmissp , lsmall が true のときに描くマーカーのラインインデクス(初期値は3 ).
ベクトルの始点を格子点に対してどこにとるか指定する. +1 ならベクトルの終点が格子点と一致するように描く; 0 ならベクトルの中点が格子点と一致するように描く; -1 ならベクトルの始点が格子点と一致するように描く(初期値は0).
欠損値処理をおこなうとき, その格子点に描くマーカーのマーカータイプ(初期値は5).
内部変数'LSMALL'がのとき,その格子点に描くマーカーのマーカータイプ(初期値は1).
ユニットベクトルにつけるタイトルのラインインデクス(初期値は3).
設定されている, ユニットベクトルにつけるタイトルの数.ユーザーは値を設定してはいけない.
X方向のユニットベクトルにつけるタイトルの回転角(単位は度;初期値は0).
Y方向のユニットベクトルにつけるタイトルの回転角(単位は度;初期値は90).タイトルの長さが1のときに限って iutyro は90以外の値をとることが許される.
内部的にスケーリングファクターを決めるとき(lnrmal が true のとき) X方向とY方向のスケーリングファクターを同じにするかどうかを指定する. true なら同じにする(初期値は true).
欠損値ベクトルのとき,その格子点にマーカーを描くかどうか(欠損値処理をおこなうかどうか)を指定する. true なら描く; false なら描かない(初期値は false).
グラフの下部マージンにスケーリングファクターなどのタイトルを書くかどうかを指定する. true なら書く; false なら書かない(初期値は true).
内部的にスケーリングファクターを決めるかどうかを指定する. true のとき内部的に決める; false のときパラメタ xfact1 , yfact1 を参照する(初期値は true).
ベクトルの大きさが内部変数 rsmall で決まる値以下のとき欠損値処理と同じように,その格子点にマーカーを描くかどうか指定する. true なら描く; falseなら描かない(初期値は false).
ユニットベクトルを描くときグラフの下部マージンにユニットベクトルの単位を書くかどうかを指定する. true なら書く; false なら書かない(初期値は true).
ユニットベクトルを描くかどうかを指定する. true なら描く; false なら描かない(初期値は false).
lmissp, lsmall が true のときに描くマーカーのマーカーサイズ(初期値は0.01).
グラフの下部マージンに書くタイトルの文字高(単位はV座標系;初期値は不定).このパラメタが不定のとき Axis の管理するパラメタ rsizel1 を参照する(DCL manual 3.7節参照).
ユニットベクトルにつけるタイトルの文字高(単位はV座標系;初期値は不定).このパラメタが不定のとき Axis の管理するパラメタ rsizel1 を参照する(DCL manual 3.7節参照).
パラメタ lsmall が参照するベクトルの大きさのしきい値(初期値は0.001).
値が不定であることを示す内部変数(初期値は-999.0).
X方向のユニットベクトルの長さ(単位は次元量;初期値は不定).
Y方向のユニットベクトルの長さ(単位は次元量;初期値は不定).
ユニットベクトルの始点のX座標(単位はV座標系;初期値は不定).
X方向のユニットベクトルの長さ(単位はV座標系;初期値は0.05).
vxuloc, vyuloc が陽に指定されていないとき,ユニットベクトルをビューポートの右下隅からX方向にどれだけ離すかを与えるオフセット値(単位はV座標系;初期値は0.02).
ユニットベクトルの始点のY座標(単位はV座標系;初期値は不定).
Y方向のユニットベクトルの長さ(単位はV座標系;初期値は0.05).
vxuloc, vyuloc が陽に指定されていないとき,ユニットベクトルをビューポートの右下隅からY方向にどれだけ離すかを与えるオフセット値(単位はV座標系;初期値は0.0).
lnrmal が false のときに参照するX方向のスケーリングファクター(初期値は1.0).
実際に用いられるX方向のスケーリングファクター(初期値は不定).ユーザーが指定しても意味がない.
グラフの下部マージンに書くタイトルの位置を決める内部変数. -1 から +1 までの実数値をとりうる. -1 のとき左よせ, 0 のときセンタリング, +1 のとき右よせする(初期値は0).
lnrmal が false のときに参照するY方向のスケーリングファクター(初期値は1.0).
実際に用いられるY方向のスケーリングファクター(初期値は不定).ユーザーが指定しても意味がない.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Vector.xttl でパラメタ xttl の参照が、Vector.xttl= でパラメタ xttl の変更ができる。
Vector.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Vector.set("xttl", -1) # メッセージを左寄せにする。Vector.get(key)
パラメタを参照する。
引数
使用例
Vector.get("xttl") # メッセージの位置を参照する。Vector.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Vector.reset("xttl") # メッセージの位置を初期値に戻すVector.help_params
Vectorで設定可能なパラメタを参照する。
引数 なし
備考
Vector.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Vector.uvtitle(cside, cttl)
ユニットベクトルにつけるタイトルを設定する.
引数
備考
Vector.draw(u, v, x=nil, y=nil, temp=nil)
2次元ベクトル場を描く.
引数
備考
作画をおこなう前にすべてのベクトル値のチェックをおこなう. 次の2つの場合作画はおこなわずその旨メッセージが出力される. さらにパラメタ lmsg が true のときグラフの下部マージンにもメッセージを書く; false のときメッセージを書かない (初期値は true). 2つの場合とは:
Mapモジュールは地図情報(海岸線や緯度経度線)を描くためのモジュールである。
Map においてユーザーが使用するサブルーチンとしては以下のようなものがある.
描画メソッド
コントロールルーチン
Mapモジュールの描画メソッドは内部で DCLのサブルーチン UMPFIT を呼んでいる。 地図投影に必要なパラメータがすべて設定されているとき, UMPFIT はなにもしない. いっぽう, 地図投影に必要なパラメータが1つでも設定されていないとき, UMPFIT はすでに設定された情報から, 適切なパラメタを決定しようと試みる. UMPFIT の動作は大きく分けて以下の2段階からなる.
すなわち, まず地図投影の中心となるべき点を定め, 後は拡大／縮小および平行移動で必要な範囲を図に収める.
この地図投影の中心となるべき点のことをパッケージでは「接点」と呼ぶ. 円筒図法および円錐図法においては, 球と投影面は線で接しているが, この接線と中央経線の交点を「接点」とする. 方位図法における「接点」は地図投影の極と同義である. これは地図学上の正確な言葉ではないが, 通常もっとも歪みの少ない中心となるべき点を表わす全ての図法共通の用語 として「接点」という言葉を使うことにする.
UMPFIT の第一段階は, この「接点」を求めることである. このために使われる情報の優先順位は以下の通りである.
優先順位の高い情報が指定されていれば, それ以下の情報は無視される.
第二段階の描画範囲決定は, Fig.circlewindow= による円形ウィンドウ, Fig.window= による矩形ウィンドウ, Fig.inclpoint= によって指定された点, 全てが描画範囲に入るように行なわれ, これらの間に優先順位はない. これらの描画範囲を決定する情報が指定されていなかった場合は, 全球が指定されたものと見なす. ただし, Map.set によってパラメタ lglobe が true に設定された場合は, ウィンドウなどの情報は全て無視され全球が描画される. このとき, 無限遠を含む以下の図法に関してはT座標系の次の範囲を「全球」 と見なす.
なお, ビューポートのパラメタVXMIN, VXMAX, VYMIN, VYMAXの一部または全部が指定されていなかった場合には, まず, 最大描画範囲に指定された範囲が最大内接するようにスケーリングされ, さらに指定された範囲が描画できる最小のビューポートを設定する. Map では同じ結果を得る複数のコーディングが可能であるが, 標準的な使用法を以下に示す.
矩形ウィンド (円錐図法)
Frame.new Fig.transnum=20 Fig.window=[UXMIN, UXMAX, UYMIN, UYMAX]
円形ウィンド (方位図法)
Frame.new Fig.transnum=31 Fig.circlewindow=[UXC, UYC, R]
UXC, UYC は地図の中心になる緯度経度で, この点を中心に 半径R (角度) の範囲が描画される.
全球 (円筒図法)
Frame.new Fig.transnum=12 Fig.contactpoint=[UXC, 0., 0.] Map.lglobe=true
UXC は中央経線となる経度.
全球 (横軸法)
Frame.new Fig.transnum=12 Fig.contactpoint=[UXC, UYC, 90.] Map.lglobe=true
パラメタ名 パラメタの型 対応するDCLパッケージ
Map.grid が描く緯度線・経度線の major line のラインインデクス(初期値は3).
Map.grid が描く度線・経度線の minor line のラインインデクス(初期値は1).
Map.grid が緯度線・経度線を描くとき major line を描くかどうかを指定する. true なら描く; false なら描かない(初期値は true).
Map.grid が緯度線・経度線を描くとき minor line を描くかどうかを指定する. true なら描く; false なら描かない(初期値は true).
Map.grid が描く緯度線・経度線の major line のラインタイプ(初期値は 1).
Map.grid が描く緯度線・経度線の minor line のラインタイプ(初期値は3).
Map.grid が描く緯度線・経度線の major line の間隔(単位は度; 初期値は30.0).
Map.grid が描く緯度線・経度線の minor line の間隔(単位は度; 初期値は10.0).
Map.grid が描く経度線の major line を極からどれだけはいったところから描くかを指定する.(単位は度; 初期値は0.0).
Map.grid が描く経度線の minor line を極からどれだけはいったところから描くかを指定する.(単位は度; 初期値は0.0).
Map.limb が描く地図境界線のラインインデクス(初期値は3).
Map.limb が描く地図境界線を描くときいくつぐらいの線分に分割して描くかを設定する(初期値は300).
海岸線などの地図情報を描く線分のラインインデクス(初期値は1).
海岸線などの地図情報を描く線分のラインタイプ(初期値は1).
全球を描くようにするかどうかを指定する. true なら全球を描く; false なら全球を描かない(初期値は false).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Map.indexmj でパラメタ indexmj の参照が、Map.indexmj= でパラメタ indexmj の変更ができる。
Map.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Map.set("indexmj", 5) # majorラインのインデクスを5にする。Map.get(key)
パラメタを参照する。
引数
使用例
Map.get("indexmj") # majorラインのインデクスを参照する。Map.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Map.reset("indexmj") # majorラインのインデクスを初期値に戻すMap.help_params
Mapで設定可能なパラメタを参照する。
引数 なし
備考
Map.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Map.draw(temp=nil)
地図の境界線 (縁) と緯度線, 経度線を描く.
引数
備考
Map.grid(temp=nil)
緯度線・経度線を描く.
引数
備考
Map.limb(temp=nil)
地図の境界線 (縁) を描く.
引数
備考
Map.open(file, temp=nil)
各種地図情報を描く.
引数
備考
現在のところ次のような地図情報ファイルが用意されている.
Textモジュールは図中にテキストを貼るためのモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
フォント番号(初期値は1).
テキストプリミティブで文字を描くとき,制御文字('ISUP','ISUB','IRST'参照)を有効とするかどうかを指定する. true のときは有効とする; falseのときは有効としない(初期値は false).
上付および下付添え字の標準文字高に対する比率(初期値は0.7).
上付および下付添え字の中心を標準文字の中心からどれだけはなすかを標準文字高に対する比率で指定する(初期値は0.3).
上付添え字のモードの始まりをしめす制御文字の文字番号.初期値は124;これは'|'に対応する.
下付添え字のモードの始まりをしめす制御文字の文字番号.初期値は95;これは'_'に対応する.
上付および下付添え字のモードの終わりをしめす制御文字の文字番号.初期値は34;これは'"'に対応する.
Text.draw, Text.vdraw, Text.rdraw で描く文字の高さをV座標系における単位で指定する(初期値は0.05).
文字列の傾きを度の単位で与える (初期値は0).
Text.draw, Text.vdraw, Text.rdraw で描く文字列の センタリングオプションを設定する.-1, 0 +1のいずれかを指定する.( -1 : 左あわせ, 0 : 中央あわせ, +1 : 右あわせ)
Text.draw, Text.vdraw, Text.rdraw で描く文字の ラインインデクスを設定する(1.7節参照;初期値は1).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Text.charindex でパラメタ charindex の参照が、Text.charindex=でパラメタcharindexの変更ができる。
Text.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Text.set("charindex", 3) #文字のラインインデクスを3にする。Text.get(key)
パラメタを参照する。
引数
使用例
Text.get("charindex") #文字のラインインデクスを参照する。Text.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Text.reset("charindex") # 文字のラインインデクスを初期値に戻すText.help_params
Textで設定可能なパラメタを参照する。
引数 なし
備考
Text.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Text.draw(ux, uy, chars, x=nil, y=nil, temp=nil)
文字列を描く.
引数
備考
Text.vdraw(ux, uy, chars, x=nil, y=nil, temp=nil)
V座標系で文字列を描く.
引数
備考
Text.rdraw(ux, uy, chars, x=nil, y=nil, temp=nil)
R座標系で文字列を描く.
引数
備考
Text.spchar(number)
DCL文字番号に対応する文字を返す.
引数
備考
Arrowモジュールは単一の矢じり付き線分を描くためのモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
矢じり部分の線分を本体部分の線分の長さに比例させて描くかどうかを指定する.TRUEなら比例させて描く; FALSEならパラメタconstで指定してある一定値で,地図投影のときはパラメタconstmで指定してある一定値で描く(初期値はTRUE).
地図投影のとき, 矢じり部分の線分も地図にへばりついたように描くかどうかを指定する.TRUEなら地図上で描く; FALSEならVCで描く(初期値はTRUE).
lpropが TRUE(比例させて描く)のときに用いる比例定数(初期値は0.33).
lpropがFALSE(一定値で描く)のときに用いる一定値(単位はVC;初期値は0.01).
lpropがFALSE(一定値で描く)でかつ地図投影のときに用いる一定値(単位は度;初期値は5.0).
矢じり部分の線分と本体部分の線分のなす角(単位は度;初期値は20.0).
矢じり部分を定義する三角形の領域を塗りつぶすかどうかを指定する.TRUEなら塗りつぶす;FALSEなら塗りつぶさない(初期値はFALSE).
矢じり部分を定義する三角形の領域を塗りつぶす)のときのトーンパターン(初期値は999).3桁以下のとき, カラーインデクスは軸の部分について指定されているものを用いる.
線分の ラインタイプを設定する. arrowtypeは0以外でなければならない. ただしarrowtypeが0のとき, メッセージは出力されるがなにもしない.
線分の ラインインデクスを設定する. lineindexは1以上でなければならない. ただしlineindexが0のとき, メッセージは出力されるがなにもしない.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Arrow.lpropでパラメタlpropの参照が、Arrow.lprop=でパラメタlpropの変更ができる。
Arrow.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Axis.set("arrowindex", 3) # アローインデクスを3に設定Arrow.get(key)
パラメタを参照する。
引数
使用例
Axis.get("arrowindex") # アローインデクスを参照するArrow.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Arrow.reset("arrowindex") # アローインデクスを初期値に戻すArrow.help_params
Arrowで設定可能なパラメタを参照する。
引数 なし
備考
Arrow.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Arrow.draw(x1, y1, x2, y2, temp=nil)
U座標系で矢じり付き線分を描く。
引数
備考
Arrow.vdraw(x1, y1, x2, y2, temp=nil)
V座標系で矢じり付き線分を描く。
引数
備考
Arrow.rdraw(x1, y1, x2, y2, temp=nil)
R座標系で矢じり付き線分を描く。
引数
備考
Markモジュールはマーカーを描くためのモジュールである。概要はAdvancedDCL::Plotと同じ.
パラメタ名 パラメタの型 対応するDCLパッケージ
ポリマーカープリミティブが描くマーカーの大きさを調整する係数(初期値は2.0).ポリマーカープリミティブはテキストプリミティブを用いてマーカーを描く.このとき, 描くマーカーは標準的な文字高に比べて小さい(DCL manual フォントテーブル8.1.2,8.1.3節参照).この内部変数はマーカーが標準的な文字高を持つようにするため使われる拡大係数である.
ポリマーカープリミティブでマーカーを描くとき,何個に1個の割合で描くかを指定する(初期値は1;すべてマーカーを描く. Mark.draw がバッファリングする最大個数50以下でなければならない).
Mark.draw, Mark.vdraw, Mark.rdraw で描くマーカータイプを設定する. marktype が 1 のとき'.', 2 のとき'+', 3 のとき'*', 4 のとき'o'のように, DCL文字番号(DCL manual 2.12節および 8.1.2, 8.1.3節の フォントテーブル参照)に対応する文字を描く. たとえば marktype = 152のとき, 'α'を描く.
Mark.draw, Mark.vdraw, Mark.rdraw で描くマーカーの ラインインデクスを設定する. markindex は1以上でなければならない. ただし markindex が0のとき, メッセージは出力されるがなにもしない. markindex の妥当性はこのルーチンでチェックされず, Mark.draw, Mark.vdraw, Mark.rdraw を呼んだときにチェックされる.
Mark.draw, Mark.vdraw, Mark.rdraw で描くマーカーの大きさを設定する. V-座標系における単位で指定する(初期値は0.01). marksize は0より大きくなければならない. ただし marksize が0のとき, メッセージは出力されるがなにもしない. marksize の妥当性はこのルーチンでチェックされず, Mark.draw, Mark.vdraw, Mark.rdraw を呼んだときにチェックされる.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
また、これらのパラメタはメソッドとして用いることができる。すなわち、Mark.nbitsでパラメタnbitsの参照が、Mark.nbits=でパラメタnbitsの変更ができる。
Mark.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Mark.set("markindex", 3) #マーカーインデクスを3にする。Mark.get(key)
パラメタを参照する。
引数
使用例
Mark.get("markindex") #マーカーインデクスを参照する。Mark.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Mark.reset("markindex") # マーカーインデクスを初期値に戻すMark.help_params
Markで設定可能なパラメタを参照する。
引数 なし
備考
Mark.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Mark.draw(x, y, temp=nil)
マーカー列を描く.
引数
備考
Mark.vdraw(x, y, temp=nil)
V座標系でマーカー列を描く.
引数
備考
Mark.rdraw(x, y, temp=nil)
R座標系でマーカー列を描く.
引数
備考
ThreeDモジュールは3D図を描くためのモジュールである。
パラメタ名 パラメタの型 対応するDCLパッケージ
ThreeD.plot, ThreeD.vplot で描く折れ線の ラインインデクスを設定する.
ポリマーカープリミティブでマーカーを描くとき,何個に1個の割合で描くかを指定する(初期値は1;すべてマーカーを描く. ThreeD.mark がバッファリングする最大個数50以下でなければならない).
ThreeD.mark, ThreeD.vmark で描くマーカータイプを設定する. marktype が 1 のとき'.', 2 のとき'+', 3 のとき'*', 4 のとき'o'のように, DCL文字番号(DCL manual 2.12節および 8.1.2, 8.1.3節の フォントテーブル参照)に対応する文字を描く. たとえば marktype = 152のとき, 'α'を描く.
ThreeD.mark, ThreeD.vmark で描くマーカーの ラインインデクスを設定する. markindex は1以上でなければならない. ただし markindex が0のとき, メッセージは出力されるがなにもしない. markindex の妥当性はこのルーチンでチェックされず, ThreeD.mark, ThreeD.vmark を呼んだときにチェックされる.
ThreeD.mark, ThreeD.vmark で描くマーカーの大きさを設定する. V-座標系における単位で指定する(初期値は0.01). marksize は0より大きくなければならない. ただし marksize が0のとき, メッセージは出力されるがなにもしない. marksize の妥当性はこのルーチンでチェックされず, ThreeD.mark, ThreeD.vmark を呼んだときにチェックされる.
SCTNU, SCTNV で用いるトーンパターン番号を設定する. tpat = [itpat1, itpat2]のとき、itpat1, itpat2はそれぞれ表と裏のトーンパターン番号(初期値は1)である. DCL manual 8.1.4- 8.1.10節参照.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Fixnum(2)などという表記は中身がFixnumの長さ2の配列であることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、ThreeD.nbitsでパラメタnbitsの参照が、ThreeD.nbits=でパラメタnbitsの変更ができる。
ThreeD.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
ThreeD.set("markindex", 3) # 3次元マーカーインデクスを3にする。ThreeD.get(key)
パラメタを参照する。
引数
使用例
ThreeD.get("markindex") # 3次元マーカーインデクスを参照する。ThreeD.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
ThreeD.reset("markwindex") # 3次元マーカーインデクスを初期値に戻すThreeD.help_params
ThreeDで設定可能なパラメタを参照する。
引数 なし
備考
ThreeD.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
ThreeD.plot(x, y, z, temp=nil)
折れ線を描く.
引数
備考
ThreeD.vplot(x, y, z, temp=nil)
V座標系で折れ線を描く.
引数
備考
ThreeD.mark(x, y, z, temp=nil)
マーカー列を描く.
引数
備考
ThreeD.vmark(x, y, z, temp=nil)
V座標系でマーカー列を描く.
引数
備考
ThreeD.tone(x, y, z, temp=nil)
三角形閉領域をぬりつぶす.
引数
ThreeD.vtone(x, y, z, temp=nil)
V座標系で三角形閉領域をぬりつぶす.
引数
Barモジュールは棒グラフを描くためのモジュールである。概要はAdvancedDCL::Plotと同じ.
パラメタ名 パラメタの型 対応するDCLパッケージ
枠のラインタイプを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
枠のラインインデクスを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
棒グラフの横巾を指定する.
折れ線のラインインデクスを指定する.
折れ線のラインタイプを指定する。
独立変数の定義域を指定する.
Bar.(x,y)frm,Bar.(x,y)tone,Bar.(x,y)lineの引数X1, Y1 または X2, Y2 に RUNDEF を指定すると, パラメタ uref の値が指定されたものとみなす. uref の初期値は 0 である.
内部領域を塗るトーンパターンを指定する. ここで設定する番号は Gap.tone,Bar.tone,Box.tone で使われる.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Bar.frtypeでパラメタfrtypeの参照が、Bar.frtype=でパラメタfrtypeの変更ができる。
Bar.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Bar.set("frindex", 3) # 枠のラインインデクスを3に設定するBar.get(key)
パラメタを参照する。
引数
使用例
Bar.get("frindex") #枠のラインインデクスを参照するBar.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Bar.reset("frindex") # 枠のラインインデクスを初期値に戻すBar.help_params
Barで設定可能なパラメタを参照する。
引数 なし
備考
Bar.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Bar.yfrm(x1, x2, y, temp=nil)
Yを独立変数とする棒グラフの枠を描く.
引数
備考
Bar.xfrm(x, y1, y2, temp=nil)
Xを独立変数とする棒グラフの枠を描く.
引数
備考
Bar.ytone(x1, x2, y, temp=nil)
棒グラフの内部領域を塗る.
引数
備考
Bar.xtone(x, y1, y2, temp=nil)
棒グラフの内部領域を塗る.
引数
備考
Bar.yline(xd, y, temp=nil)
棒グラフを線で結ぶ.
引数
備考
Bar.xline(x, yd, temp=nil)
棒グラフを線で結ぶ.
引数
備考
Boxモジュールは箱グラフを描くためのモジュールである。概要はAdvancedDCL::Plotと同じ.
パラメタ名 パラメタの型 対応するDCLパッケージ
枠のラインタイプを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
枠のラインインデクスを指定する. 設定する属性は Bar.frame,Box.frame で使われる.
折れ線のラインインデクスを指定する.
折れ線のラインタイプを指定する。
独立変数の定義域を指定する.
Box.(x,y)frm, Box.(x,y)tone, Box.(x,y)lineの引数x1, y1 または x2, y2 に RUNDEF を指定すると, パラメタ uref の値が指定されたものとみなす. uref の初期値は 0 である.
内部領域を塗るトーンパターンを指定する. ここで設定する番号は Gap.tone,Bar.tone,Box.tone で使われる.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Box.frtypeでパラメタfrtypeの参照が、Box.frtype=でパラメタfrtypeの変更ができる。
Box.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Box.set("frindex", 3) # 枠のラインインデクスを3に設定するBox.get(key)
パラメタを参照する。
引数
使用例
Box.get("frindex") #枠のラインインデクスを参照するArrow.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Box.reset("frindex") # 枠のラインインデクスを初期値に戻すBox.help_params
Boxで設定可能なパラメタを参照する。
引数 なし
備考
Box.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Box.yfrm(x1, x2, y, temp=nil)
Yを独立変数とする箱グラフの枠を描く.
引数
備考
Box.xfrm(x, y1, y2, temp=nil)
Xを独立変数とする箱グラフの枠を描く.
引数
備考
Box.ytone(x1, x2, y, temp=nil)
箱グラフの内部領域を塗る.
引数
備考
Box.xtone(x, y1, y2, temp=nil)
箱グラフの内部領域を塗る.
引数
備考
Box.yline(xd, y, temp=nil)
箱グラフを線で結ぶ.
引数
備考
Box.xline(x, yd, temp=nil)
箱グラフを線で結ぶ.
引数
備考
Gapモジュールは線と線の間を塗るためのモジュールである。概要はAdvancedDCL::Plotと同じ.
パラメタ名 パラメタの型 対応するDCLパッケージ
独立変数の定義域を指定する.
Gap.(x,y)tone の引数 X1, Y1 または X2, Y2 に RUNDEF を指定すると, パラメタ uref の値が指定されたものとみなす. uref の初期値は 0 である.
内部領域を塗るトーンパターンを指定する. ここで設定する番号は Gap.tone,Bar.tone,Box.tone で使われる.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Gap.tpatでパラメタ tpat の参照が、Gap.tpat= でパラメタ tpat の変更ができる。
Gap.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Gap.set("tpat", [299, 499]) # トーンパターンを[299, 499]に設定するGap.get(key)
パラメタを参照する。
引数
使用例
Gap.get("tpat") #トーンパターンを参照するGap.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Gap.reset("tpat") # トーンパターンを初期値に戻すGap.help_params
Gapで設定可能なパラメタを参照する。
引数 なし
備考
Gap.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Gap.ytone(x1, x2, y, temp=nil)
2本の折れ線の間をトーンパターンで塗る.
引数
備考
Gap.xtone(x, y1, y2, temp=nil)
2本の折れ線の間をトーンパターンで塗る.
引数
備考
Errbarモジュールはエラーバーを描くためのモジュールである。概要はAdvancedDCL::Plotと同じ.
パラメタ名 パラメタの型 対応するDCLパッケージ
エラーバーのラインタイプ.
エラーバーのラインインデクス.
エラーバーの横幅.
独立変数の定義域を指定する.
Box.(x,y)frm, Box.(x,y)tone, Box.(x,y)lineの引数x1, y1 または x2, y2 に RUNDEF を指定すると, パラメタ uref の値が指定されたものとみなす. uref の初期値は 0 である.
不定であることを示す整数型の値(初期値は-999)
不定であることを示す実数型の値(初期値は-999.0)
欠損値処理をおこなうか どうかを指定する. true ならおこなう, false ならおこなわない (初期値は false).
欠損値処理をおこなうときの整数型の欠損値を指定する (初期値は999).
欠損値処理をおこなうときの実数型の欠損値を指定する (初期値は999.0).
なお、Array[2, Float]などという表記は中身がFloat型の配列である長さ２のArrayであることを意味している。
また、これらのパラメタはメソッドとして用いることができる。すなわち、Errbar.errbartype でパラメタ errbartype の参照が、Errbar.errbartype= でパラメタ errbartype の変更ができる。
Errbar.set(key, val)
パラメタの設定を行う。valにnilを指定すると値をDCLにおける初期値に戻す。
引数
使用例
Errbar.set("errbarindex", 3) # エラーバーのラインインデクスを3に設定するErrbar.get(key)
パラメタを参照する。
引数
使用例
Errbar.get("errbarindex") # エラーバーのラインインデクスを参照するErrbar.reset(key, val)
パラメタをDCLにおける初期値に戻す。
引数
使用例
Errbar.reset("errbarindex") # エラーバーのラインインデクスを初期値に戻すErrbar.help_params
Errbarで設定可能なパラメタを参照する。
引数 なし
備考
Errbar.sync
現在、設定されているパラメタをDCLに反映させる。
引数
なし
備考
AdvancedDCLにおいてはsetメソッドのみではパラメタはDCLに反映されず、
パラメタをsyncさせるメソッドを内部で呼んでいる。このメソッドはユーザがパ ラメタを陽にsyncできるためのメソッドである。
Errbar.ydraw(x1, x2, y, temp=nil)
Yを独立変数とするエラーバー描く.
引数
備考
Errbar.xdraw(x, y1, y2, temp=nil)
Xを独立変数とするエラーバー描く.
引数
備考