名前

概要

記述

このプログラムは、GRASSの開始時に使用する。 それはコマンドラインの引数を構文解析し、ユーザーのためにGRASSを初期設定する。 GRASSプログラムは具体的な環境を必要とするので、いかなる他のGRASSプログラムの実行を可能にする前に、このプログラムが起動されなければならない。 コマンドライン引数はオプションで、要求されたユーザインターフェースと作業するマップセットを示す方法をユーザに提供する。

機能

GRASSプログラムは、要求されたユーザーインターフェイスとマップセットを保存する。 そのために、次回GRASSをユーザが実行するとき、grass5（オプションなしで）とタイプすれば、ユーザーインターフェイスとマップセットを前の設定でGRASSを起動する。

もしグラフィカル・ユーザ・インタフェース（例えば Tcl／Tk）を指定するならば、grass5プログラムは指定したシステムが存在するか、そしてうまくアクセスできるかを確認しようとする。 もしこれらのチェックのうちのいくつかが失敗すると、grass5は自動的にテキストユーザーインターフェイスモードに切り替える。

オプション

すべてのコマンドラインオプションはオプションである。

フラグ:

-

ロケーション環境変数の使用をGRASSに開始させる（下を参照）

-h -help --help

簡単な用法メッセージの表示

-text

テキスト・ベースのユーザーインターフェイスを使用することを示す

-tcltk

Tcl/Tkベースのグラフィカル・ユーザ・インタフェースを使用することを示す

-v --version

GRASSのバージョンを表示する

パラメータ:

GISDBASE

初期のデータベースディレクトリの完全なパス（例えば／usr／ローカル／grassData）

LOCATION_NAME

初期のLocationディレクトリにおけるGISDBASEのサブディレクトリの位置

MAPSET

初期のmapsetディレクトリにおけるLOCATION_NAMEのサブディレクトリの位置

ノート

以下のうちの1つを指定しなければならない

MAPSET
LOCATION_NAME/MAPSET
GISDBASE/LOCATION_NAME/MAPSET

環境変数

ユーザーインターフェイス環境変数

grass5プログラムは、GRASSが使用するユーザーインターフェイスのタイプを示すGRASS_GUIと呼ばれる環境変数の存在をチェックする。 もし grass5が動かされる時にこの変数が設定されていないならば、それが作成され、次回のGRASS実行のために$HOME／.grassrc5ファイルに保存される。

使用されるユーザーインターフェイスのgrass5での定義には優先順位がある。 高い優先から低いものへの階層は次の通りである。

ユーザーは、自分の環境変数設定をGRASSの次の起動時に使われる$HOME／.grassrc5ファイルに追加できる（実施された環境変数のリスト）。

先行するインタフェース

コマンドライン引数
環境変数GRASS_GUI
$HOME／.grassrc5において設定した変数
デフォルト値-tcltk

Tcl/Tk環境変数

Tcl/Tkグラフィカル・ユーザ・インタフェースの使用を選択すると、以下の環境変数は、システムデフォルトtclshと希望するコマンドを無効にするために用いられる。 変数の記述の例については、次に示されたセクションを参照のこと。

GRASS_TCLSH

tclshを上書き消去するために用いる

GRASS_WISH

wishを上書き消去するために用いる

GRASSTcl/Tk環境変数の使用例

もしTcl/Tk8.0がインストールされたシステムに、$HOME/bin以下にTcl/Tk8.3バイナリの個人的なバージョンをインストールしようとするならば。 Tcl/Tk 8.3バイナリを代わりに使わせるために、上記の変数を使用できる。

GRASS_TCLSH = $HOME/bin/tclsh8.3
GRASS_WISH = $HOME/bin/wish8.3

特別なローカルGRASSモジュールへのアドオンパス

GRASS_ADDON_PATH=/usr/mytools
GRASS_ADDON_PATH=/usr/mytools:/usr/local/othertools

この例では標準のGRASSパス環境に追加する。

位置環境変数

GRASSが使う位置とmapsetを設定するために使用できる記述オプションの概要とオプションセクション。 これらの値はまた、環境変数に設定できる。 しかし、コマンドラインのロケーションとマップセット変数はこれらの環境変数を上書きするだろう。 使用可能な変数は次の通りである：

ロケーション

マップセットへの完全なパス（例えば /usr/local/grassData/spearfish/PERMANENT）。 この環境変数は、GISDBASE、LOCATION_NAME、およびMAPSET変数を上書きする。

GISDBASE

完全な初期のデータベースディレクトリ（例えば /usr/local/grassData）

LOCATION_NAME

初期のLocationディレクトリにおけるGISDBASEのサブディレクトリの位置

MAPSET

初期のマップセットディレクトリにおけるLOCATION_NAMEのサブディレクトリの位置

使用する特定のマップセットを用いるこれらの変数を使用できる各種の方法がある。 以下はいくつかの可能な例である。

例1

環境変数は次の通り定義される：

LOCATION = /usr/local/grassData/spearfish/PERMANENT
GISDBASE = /usr/local/grassData
LOCATION_NAME = spearfish
MAPSET = PERMANENT

以下のコマンドによってGRASSを始めなさい：

grass5 -

GRASSは、LOCATION変数が他の変数を上書きするのでLOCATIONにより定義されたマップセットで始まる。

例2

環境変数は次の通り定義される：

GISDBASE = /usr/local/grassData
LOCATION_NAME = spearfish
MAPSET = PERMANENT

以下のコマンドによってGRASSを始めなさい：

grass5 -

GRASSは、GISDBASE/LOCATION_NAME/MAPSETにより定義されたマップセットで始まる。

例3

環境変数は次の通り定義される：

LOCATION = /usr/local/grassData/spearfish/PERMANENT
GISDBASE = /usr/local/grassData
LOCATION_NAME = spearfish
MAPSET = PERMANENT

以下のコマンドによってGRASSを始めなさい：

grass5 /usr/home/grass/data/thailand/forests

GRASSは、環境変数を/home/grass/data/thailand/forestsで上書きしてマップセットとして始まる。

例4

環境変数は次の通り定義される：

LOCATION = /usr/local/grassData/spearfish/PERMANENT
GISDBASE = /usr/local/grassData
LOCATION_NAME = spearfish
MAPSET = PERMANENT

以下のコマンドによってGRASSを始めなさい：

grass5 swamps

GRASSは、環境変数MAPSETを上書きしたmapsetのためのコマンドライン引数からGISDBASE/LOCATION_NAME/swampsにより定義されたmapsetで始まる。

例5

環境変数は次の通り定義される：

LOCATION = /usr/local/grassData/spearfish/PERMANENT
GISDBASE = /usr/local/grassData
LOCATION_NAME = spearfish
MAPSET = PERMANENT

以下のコマンドによってGRASSを始めなさい：

grass5 thailand/forests

GRASSは、環境変数LOCATION_NAME and MAPSETを上書きされたロケーションとマップセットによるコマンドライン引数からGISDBASE/thailand/forestsによって定義されたmapsetで始まる。

ノート

これらの変数を、使うUNIXシェルのために必要な適切な方法を使うようにする必要があることに注意しなさい。

例

以下は、GRASSの開始についてのいくつかの例である

grass5

GRASSをデフォルトユーザーインターフェイスを使い起動する。 ユーザーは、適切なロケーションとマップセットを選ぶために促される。

grass5 -tcltk

GRASSをTcl/Tkベースのユーザーインターフェイスを使うよう起動する。 ユーザーは、適切なロケーションとマップセットを選択することを促される。

grass5 -text

GRASSをテキスト・ベースのユーザーインターフェイスを使うよう起動する。 ユーザーは適切なロケーションとマップセットを選択するために促される。

grass5 -tcltk -

GRASSを、Tcl/Tkベースのユーザーインターフェイスを使い、ロケーションとマップセットを環境変数から得て起動する。

他の例

より一層の例のための位置環境変数セクションを見なさい。

バグと警告

もしTcl/Tkインタフェースを使いGRASSを起動させるならば、あなたは$PATH変数の中にwishコマンドを含まなければならない。 すなわち、wish8.3のようなものではなくコマンドはwishと名付けられなければならない。 デフォルトでは、Tcl/Tkインストールではwishコマンドは作成されない。 従って、システム管理者はwishプログラムに適切なリンクを作成しなければならない。

例えば、Tcl/Tk8.3プログラムが/usr/local/binにインストールされているとしよう。 そして、システム管理者は/usr/local/binディレクトリに行き、GRASSによって使用のためのTcl/Tkを適切にインストールするために、コマンドln -s wish8.3 wishとln -s tclsh8.3 tclshを動かすべきである。

さらに、もしTcl/Tkの複数のバージョンをインストールさせるならば、GRASSによって使いたいバージョンが$PATH変数の中にある最初のバージョンであることを確かめなさい。 GRASSは、それがwishの中で最初のバージョンを見つけるまで、$PATH変数を検索する。

ファイル

参照

作者

Last changed: $Date: 2002/03/01 00:08:31 $

翻訳者

Last changed: $Date: 2003/04/21 01:48:00 $