x2sys_initgmt - クラウドでオンライン

プログラム：

NAME

x2sys_init - 新しい x2sys トラック データベースを初期化します

SYNOPSIS

x2sys_init TAG デファイル [ c|f|g|e ] [ サフィックス ] [] [ d|g ] [ dx[/dy]] [ d|s単位 ] [
地域 ] [[レベル]] [ t|dギャップ ]

注意： オプションフラグと関連する引数の間にスペースを入れることはできません。

DESCRIPTION

x2sys_init これは、x2sys を使用したい人にとっての出発点です。のセットを初期化します
1 種類のトラック データに特有のデータベース。これらのデータとそれに関連する
データベース、および主要なパラメータには、x2sys TAG と呼ばれる短縮表記が与えられます。の
TAG は、ファイル形式、データが地理的かどうかなどの設定を追跡します。
そしてトラックインデックスのビニング解像度。ランニング x2sys_init の前提条件です
他の x2sys プログラムの実行 x2sys_binlist、粗生成物が作成されます。
各データ トラックがドメイン内のどこに行くのか、どの観測値が存在するのかを表現します。
利用可能;この情報は、への入力として機能します x2sys_put トラックデータを更新します
ベース。それから、 x2sys_get 内で利用可能なトラックとデータを見つけるために使用できます。
与えられた地域。そのトラックのリストを使用して、 x2sys_cross トラックを計算する
クロスオーバー、使用 x2sys_report クロスオーバー統計をレポートするか、 x2sys_list 引っ張り出す
厳選したクロスオーバー情報 x2sys_solve トラック固有の判断に使用できます
体系的な修正。これらの修正は次のように使用できます。 x2sys_datalist 抽出する
後続の作業で使用するためにデータ値を修正しました。走れるから x2sys_init フォーム しなければなりません
環境パラメータ X2SYS_HOME を書き込み権限のあるディレクトリに設定します。
ここで、x2sys は設定を追跡できます。

REQUIRED 議論

TAG このデータ型 x2sys TAG の一意の名前。

-Dデファイル
このデータ セットの定義ファイルのプレフィックス [詳細については、以下の定義ファイルを参照してください。
情報]。ファイルが現在のディレクトリにない場合はフルパスを指定します。

オプション 議論

-Cc|f|g|e
他のユーザーが必要に応じて、トラックに沿った距離を計算するための手順を選択します。
プログラム：

c デカルト距離 [デフォルト、ただし -G が設定されています]。

f 平らな地球の距離.

g 大圏距離 [デフォルトの場合] -G が設定されています]。

e 現在の GMT 楕円体上の測地線距離。

-Eサフィックス
これらのデータ ファイルのファイル拡張子 (サフィックス) を指定します。指定されていない場合は、
定義ファイルのプレフィックスをサフィックスとして使用します (「 -D).

-F 古いファイルが存在する場合は新しいファイルを強制的に作成します [古いタグの場合、デフォルトで中止されます]
ファイルが見つかりました]。

-Gd|g 地理座標を選択します。追加 d 日付変更線での不連続性 (
経度は -180 から + 180 まで）または g グリニッジでの不連続性のため (
経度は 0 ～ 360 [デフォルト])。指定されていない場合、データは次のとおりであると想定されます。
デカルト座標。

-Idx[/dy]
x_inc [およびオプションで y_inc] はグリッド間隔です。 追加 m 分または c
地理データの秒を示します。これらの間隔は、使用されるビニングを指します
トラック ビン インデックス データベース内。

-Nd|s単位
他のプログラムから要求された場合に、距離と速度に使用される単位を設定します。追加
d 距離または s 速度については、必要な 単位 as c (デカルト ユーザーディスト
または userdist/usertime)、 e (メートルまたはメートル/秒)、 f (フィートまたはフィート/秒)、 k (km または km/時)、 m
(マイルまたはマイル/時)、 n (海里またはノット) または u (測量フィートまたは測量
フィート/秒)。 [デフォルトは -NDK -Nse (km と m/s) の場合 -G 設定され、 -NDC 　 -Nsc
それ以外の場合 (デカルト単位)]。

-NS[単位]西/東/南/北[/ズミン/zmax][NS]
西, 東, 南, 北 関心領域を指定すると、指定できます
それらは小数度または[+-] dd：mm [：ss.xxx] [W | E | S | N]形式です。 追加する r 低い場合
w / e / s / nの代わりに、左右のマップ​​座標が表示されます。 二つ
速記 -Rg 　 -Rd グローバルドメインの略（経度で0/360および-180 / + 180
それぞれ、緯度で-90 / + 90）。 または、グリッドを作成する場合は、
Rコデロン/ラット/nx/nyここで、 コード L、C、Rの2文字の組み合わせです（左の場合、
中央、または右）およびT、M、B（上、中央、または下）。 たとえば、左下のBL。
これは、長方形領域のどのポイントが LON/ラット 座標参照
to、およびグリッドの寸法 nx 　 ny を介してグリッド間隔で -I 作成に使用されます
対応する地域。 または、既存のグリッドファイルの名前を指定します
と -R 設定（および該当する場合はグリッド間隔）がグリッドからコピーされます。
使い方 -R単位 選択したものと互換性のある投影（デカルト）座標を期待します -J
逆に投影して、実際の長方形の地理的領域を決定します。 にとって
透視図 （-p）、オプションで/を追加ズミン/zmax。 透視図の場合
(-p）、z範囲（ズミン, zmax）を追加して、XNUMX次元を示すことができます。 この
を使用する場合にのみ実行する必要があります -Jz オプション、のみを使用する場合ではありません -p オプションを選択します。
後者の場合、平面の斜視図がプロットされます。
寸法。 デカルト データの場合は、 xmin/xmax/ymin/ymax. このオプションは、
指定されたドメイン内にある COE の統計。

-V [レベル] （もっと ...）
詳細レベル[c]を選択します。

-Wt|dギャップ
与える t or d 対応する最大時間ギャップを追加します (ユーザー単位、これは
通常は秒 [無限])、または距離 (単位については「ギャップ [無限]」を参照)
クロスオーバーの両側の 2 つのデータ ポイント間で許可されます。もし
これらの制限を超えると、データ ギャップが想定され、COE は決定されません。

-^ or ただ -
コマンドの構文に関する短いメッセージを出力してから終了します（注：Windowsの場合）
ただ使う -).

-+ or ただ +
任意の説明を含む広範な使用法（ヘルプ）メッセージを印刷します
モジュール固有のオプション（GMT共通オプションは除く）が終了します。

-? or いいえ 引数
オプションの説明を含む完全な使用法（ヘルプ）メッセージを印刷してから、
終了します。

- バージョン
GMTバージョンを印刷して終了します。

--show-datadir
GMT共有ディレクトリへのフルパスを出力して終了します。

定義 ファイル

これらの *.def ファイルにはデータ ファイル形式に関する情報が含まれており、次の 2 つのセクションがあります。
(1) ヘッダー情報と (2) 列情報。すべてのヘッダー情報は
最初の列の文字 # の直後に大文字のディレクティブが続きます。もし
ディレクティブは空白で区切られた引数を取ります。末尾に # を追加することもできます
コメント。次の 5 つのディレクティブが認識されます。

ASCII データ ファイルが ASCII 形式であることを示します。

BINARY データ ファイルがネイティブ バイナリ ファイルであると記載されています。

NETCDF データ ファイルは COARDS 準拠の 1-D netCDF ファイルであると記載されています。

スキップ 整数の引数を取ります。これはスキップする行数です(読み取り時)。
ASCII ファイル）またはスキップするバイト数（ネイティブ バイナリ ファイルを読み取る場合）。使用されていない
netCDF ファイルを使用します。

ジオ これらのファイルが地理データ セットであり、周期性があることを示します。
x- 座標 (経度)。あるいは、次を使用します。 -G.

マルチセグ 各トラックが GMT セグメント ヘッダーで区切られた複数のセグメントで構成されていることを意味します
(または、使用します -m システム TAG を定義するとき)。 netCDF ファイルでは使用されません。

列情報は、列が表示される順序で列ごとに 1 行で構成されます。
データファイル。各列に次の 7 つの属性を指定する必要があります。

名 type NaN NaNプロキシ 階段 オフセット oformat

名 列変数の名前です。特別な機能を使用することが期待されます
名 LON （または x デカルト座標の場合)、および ラット （または y) 2 つの必要な座標列、および
時間 オプションの時刻データが存在する場合。

type 常に a 数値の ASCII 表現の場合は、バイナリ ファイルの場合は、
の中から選ぶ c 符号付き半角文字の場合（-1、+127）、 u 符号なしバイト (0 ～ 255) の場合、 h の
符号付き 2 バイト整数 (-32768、+32767)、 i 符号付き 4 バイト整数の場合
(-2,147,483,648,+2,147,483,647)、 f 4バイト浮動小数点の場合、および d 8バイトdoubleの場合
精度の浮動小数点。 netCDF の場合は、単に使用します d netCDF が自動的に処理するため
読み取り中の型変換。

NaN 特定の値 (-9999 など) が NAN に置き換えられる場合は Y、それ以外の場合は N です。

NaNプロキシ は特別な値です (-9999 など)。

階段 読み取り後にデータを乗算するために使用されます。

オフセット スケーリングされたデータに追加するために使用されます。

oformat この列の値を出力するために使用される C スタイルのフォーマット文字列です。

- を与えると、 oformat その場合、代わりに GMT のフォーマット機構が使用されます (つまり、
FORMAT_FLOAT_OUT、FORMAT_GEO_MAP、FORMAT_DATE_MAP、FORMAT_CLOCK_MAP)。一部のファイル形式
すでに定義ファイルが事前に作成されています。これらには、mgd77 (プレーン ASCII MGD77 データの場合) が含まれます。
ファイル)、mgd77+ (拡張 MGD77+ netCDF ファイル用)、gmt (古い mgg サプリメント バイナリ用)
ファイル)、xy (プレーン ASCII x、y テーブルの場合)、xyz (同じ、z 列が 1 つある)、geo (プレーンの場合)
ASCII 経度、緯度ファイル)、および geoz (同じ、Z 列が 1 つ)。

例

大量のトラック データ ファイルのセットがある場合は、x2sys ツールを使用してそれらを整理できます。
ここでは手順の概要を説明します。トラック データ ファイル形式が次のように構成されていると仮定します。
テキスト情報を含む 2 つのヘッダー レコードと、それに続く任意の数の同一フォーマットのレコード
6 つの列 (lat、lon、time、obs1、obs2、obs3) を持つデータ レコード。そのファイルは次のように呼ばれます。
*.trk。これを「ライン」形式と呼びます。まず、line.def ファイルを作成します。

┌───────┬───────┬─────┬───────┬── ────┬───┬─────┐
│# 定義 │ │ │ │ │ │
│ファイル │ │ │ │ │ │
│行形式 │ │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# スキップ 2 │ # スキップ 2 │ │ │ │ │ │
│ │ ヘッダー │ │ │ │ │
│ │ 記録 │ │ │ │ │
━───────┴───────┴─────┴───────┴── ────┴───┴─────┘

│# GEO │ # データは │ │ │ │ │
│ │ 地理的 │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│#名前 │ タイプ │ NaN │ NaN-proxy │ スケール │ オフセット │ oformat │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│緯度 │ a │ N │ 0 │ 1 │ 0 │ %9.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│lon │ a │ N │ 0 │ 1 │ 0 │ %10.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│時間 │ a │ N │ 0 │ 1 │ 0 │ %7.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs1 │ a │ N │ 0 │ 1 │ 0 │ %7.2f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs2 │ a │ N │ 0 │ 1 │ 0 │ %7.2f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs3 │ a │ N │ 0 │ 1 │ 0 │ %7.2f │
━───────┴───────┴─────┴───────┴── ────┴───┴─────┘

次に、これらのライン トラックのデータベースを含む TAG と TAG ディレクトリを作成します。
ファイル。これらに地理データが含まれており、データを追跡したいと仮定します。
1 x 1 度の解像度での分布、測地線に沿って計算された km 単位の距離
そして、ノットで与えられた速度で、私たちは走ることができます

gmt x2sys_init LINE -V -G -Dline -Rg -Ce -Ndk -NsN -I1/1 -Etrk

ここでは、x2sys タグとして LINE を選択しました。 x2sys ツールがあなたの行を読み取ろうとするとき
データ ファイルの場合、最初に現在のディレクトリを調べ、次にファイルを調べます。
TAG_paths.txt を参照して、調査する追加ディレクトリのリストを参照してください。したがって、そのようなものを作成します
ファイル (ここでは LINE_paths.txt) を作成し、そこにデータ ディレクトリへのフル パスを貼り付けます。全て
TAG関連ファイル（定義ファイル、タグファイル、トラックデータベース作成）が作成されます。
が指すディレクトリにあることが期待されます $X2SYS_HOME/TAG （私たちの場合には
$X2SYS_HOME/ライン）。への引数に注意してください -D *.def の場合はフルパスを含める必要があります
ファイルが現在のディレクトリにありません。 x2sys_init このファイルを
$X2SYS_HOME/TAG 他のすべての x2sys ツールがそれを見つけることが期待されるディレクトリ。

創造する tbf ファイル：
(空の) TAG データベースが初期化されたら、2 つのステップを実行します。
それらを設定するプロセス。まずは走ります x2sys_binlist すべてのトラック ファイルに
1 つ (または複数) のマルチセグメント トラック bin-index ファイル (tbf) を作成します。これらには以下が含まれます
1 x 1 度のビン (またはその他のブロックサイズ) に関する情報。 -I) 各トラック
が訪問し、どの観測 (あなたの場合は obs1、obs2、obs3) が実際に訪問したのか
(すべてのトラックで 3 種類の観測がすべて行われるわけではありません)。のために
たとえば、トラックがファイルtracks.lisにリストされている場合は、次のコマンドを実行できます。

gmt x2sys_binlist -V -TLINE :tracks.lis >tracks.tbf

更新 index データ ベース：
次に、トラックの bin-index ファイルが次の場所に供給されます。 x2sys_put を挿入します
情報を TAG データベースに保存します。

gmt x2sys_put -V -TLINEtracks.tbf

検索 の データ：
今すぐご利用いただけます x2sys_get 特定のサブ領域内のすべてのトラックを検索します。
オプションで、特定の組み合わせを持つトラックに検索を制限します。
観測可能なもの。たとえば、obs1 と obs3 の両方を含むすべてのトラックを検索するには、
指定された領域、実行

gmt x2sys_get -V -TLINE -R20/40/-40/-20 -Fobs1,obs3 >tracks.tbf

MGD77[+] or GMT：
MGD77 ファイル用の定義ファイルがすでに存在します (標準 ASCII と拡張の両方)
netCDF ベースの MGD77+ ファイル) および mgg によって操作される古い *.gmt ファイル
サプリメント。これらのデータセットの場合、 -C 　 -N デフォルトで大圏になります
km単位で距離を計算し、m/s単位で速度を計算します。の定義ファイルもあります
プレーン x,y[,z] トラックと lon,lat[,z] トラック。新しいトラック データベースの使用を開始するには
NGDC からの MGD77 データを使用して試してください

gmt x2sys_init MGD77 -V -Dmgd77 -Emgd77 -Rd -Gd -Nsn -I1/1 -Wt900 -Wd5

ここで、データギャップを示すために 15 分 (900 秒) または 5 km のしきい値を選択しました。
そして速度としてノットを選択します。他の手順も同様です。

バイナリ ファイル：
あなたのラインファイルが実際には128バイトのバイナリファイルであると仮定してみましょう。
ヘッダー構造 (スキップされる) に続いてデータ レコードとその場所 LON, ラット,
時間 は倍精度数値ですが、2 つの観測値は XNUMX バイトの整数です
これに 0.1 を掛ける必要があります。最終的に、最初の 32768 つの観測値は -XNUMX になる可能性があります。
これは、利用可能なデータがないことを意味します。必要なのは別の line.def だけです
ファイル：

┌───────┬───────┬─────┬───────┬── ────┬───┬─────┐
│# 定義 │ │ │ │ │ │
│ファイル │ │ │ │ │ │
│バイナリライン │ │ │ │ │ │
│形式 │ │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# BINARY │ # ファイルは │ │ │ │ │
│ │ 今はバイナリ │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# スキップ 128 │ # スキップ 128 │ │ │ │ │ │
│ │ バイト │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# GEO │ # データは │ │ │ │ │
│ │ 地理的 │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│#名前 │ タイプ │ NaN │ NaN-proxy │ スケール │ オフセット │ oformat │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│lon │ d │ N │ 0 │ 1 │ 0 │ %10.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│緯度 │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│時間 │ d │ N │ 0 │ 1 │ 0 │ %7.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs1 │ h │ Y │ -32768 │ 0.1 │ 0 │ %6.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs2 │ h │ Y │ -32768 │ 0.1 │ 0 │ %6.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs3 │ h │ N │ 0 │ 0.1 │ 0 │ %6.1f │
━───────┴───────┴─────┴───────┴── ────┴───┴─────┘

残りの手順は同じです。

コード 1-D netCDF ファイル：
最後に、行ファイルが実際に次の netCDF ファイルであると仮定します。
データ列の名前が指定された COARDS 規則 LON, ラット, 時間, 観測者1, 観測者2, 観測者3.
必要なのは、別の line.def ファイルだけです。

┌───────┬───────┬─────┬───────┬── ────┬───┬─────┐
│# 定義 │ │ │ │ │ │
│ファイル │ │ │ │ │ │
│netCDF │ │ │ │ │ │
│COARDSライン │ │ │ │ │ │
│形式 │ │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# NETCDF │ # ファイルは │ │ │ │ │
│ │ 今は netCDF │ │ │ │ │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│# GEO │ # データは │ │ │ │ │
│ │ 地理的 │ │ │ │ │
━───────┴───────┴─────┴───────┴── ────┴───┴─────┘

│#名前 │ タイプ │ NaN │ NaN-proxy │ スケール │ オフセット │ oformat │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│lon │ d │ N │ 0 │ 1 │ 0 │ %10.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│緯度 │ d │ N │ 0 │ 1 │ 0 │ %9.5f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│時間 │ d │ N │ 0 │ 1 │ 0 │ %7.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs1 │ d │ N │ 0 │ 1 │ 0 │ %6.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs2 │ d │ N │ 0 │ 1 │ 0 │ %6.1f │
§───────┼───────┼─────┼───────┼── ────┼───┼─────┤
│obs3 │ d │ N │ 0 │ 1 │ 0 │ %6.1f │
━───────┴───────┴─────┴───────┴── ────┴───┴─────┘

これらの問題は通常は処理されるため、スケーリングまたは NAN プロキシは使用しないことに注意してください。
netCDF 形式の説明の内部で。

onworks.net サービスを使用して x2sys_initgmt をオンラインで使用する