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

プログラム：

NAME

mgd77manage - MGD77+ ファイルの内容を管理する

SYNOPSIS

mgd77管理 NGDC-id [[+]a|c|d|D|e|E|g|i|n|t|TFileInfo ] [ f|g|e ] [ 略語1,略語2、...）
] [ 空の ] [] [ 略語/名/単位/t/階段/オフセット/コメント ] [ 単位 ] [ 地域 ] [[レベル]
] [ -bi] [ -du] [ -n]

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

DESCRIPTION

mgd77管理 MGD77+ netCDF ファイルで追加のカスタム列を維持することを扱います。 あなたはできる
XNUMX つまたは複数の列を削除する、新しい列を追加する、既存の列を新しい列で更新する
データ、またはエラー修正情報 (*.e77 ファイル) を提供します。 新しいデータはテーブルから取得される場合があります
(ASCII でない限り -bi が使用されている)、既存の列と特定の理論に基づいている
または、グリッドをサンプリングして取得することもできます (GMT グリッドまたは
Sandwell/Smith メルカトル *.img グリッド) トラックに沿って。 新しいデータは
指定されたタイプの追加データ列の形式の MGD77+ ファイル。 データファイルは
変更; 新しいファイルは作成されません。 大きな問題については、DISCUSSION セクションを参照してください。
を参照してください。

REQUIRED 議論

NGDC-id
次の XNUMX 種類の指定子のうち XNUMX つ以上を指定できます。

1. 8 文字の NGDC ID (例: 01010083、JA010010 など)。

2. 2文字各代理店からのすべてのクルーズを返すコード。

3. 4文字これらのクルーズからのすべてのクルーズを返すコード
血管。

4. = 、 どこNGDC ID を XNUMX 行に XNUMX つずつ持つテーブルです。

5. 何も指定しない場合は、データベース内のすべてのクルーズが返されます。

(mgd77info を参照) -L 代理店および船舶コードの場合）。 拡張子「.mgd77」または「.nc」
必要に応じて自動的に追加されます (使用 -I 特定のファイルタイプを無視します)。
Cruise ファイルは、最初に現在のディレクトリで検索され、次に全体で検索されます。
にリストされているディレクトリ $MGD77_HOME/mgd77_paths.txt [場合 $MGD77_HOME 設定されていません
デフォルトは $ GMT_SHAREDIR/mgd77]。

オプション 議論

-A[+]a|c|d|D|e|E|g|i|n|t|TFileInfo
新しいデータ列を追加します。 同じ略称の既存の列がすでに存在する場合
ファイルに存在する場合、ファイルの更新を臆病に拒否します。 指定する -A+
この抵抗を克服します (ただし、既存の列をアップグレードできない場合があります
最初に削除せずに; その場合は警告されます)。 列のソース コードを選択してください
間で a, c, d, D, e, g, i, n, tまたは T; 各選択肢の詳細な説明
次のとおりです。

a 追加する単一列テーブルのファイル名を追加します。 ファイルは同じ番号でなければなりません
行の MGD77+ ファイルとして。 ファイルが指定されていない場合は、代わりに stdin から読み取ります。

c 修正のための既存のデータまたは数式から派生する新しい列を作成する
および参照フィールド。 追加 c から差し引かれたカーター補正について
修正されていない深さ、 g IGF 重力参照フィールド (別名「通常の重力」) の場合、
m IGRF 全磁場基準磁場の場合、および r 再計算された磁気
anomaly (1 または 2 を追加して、使用する合計フィールド列を指定します [1])。 重力用
パラメータ重力理論式に基づいて参照フィールドを選択します
クルーズの MGD77 ヘッダーのコード。 これが設定されていないか無効な場合、デフォルトで
IGF 1980. 目的のコードを追加することで、この動作を無効にすることができます: 1 =
Heiskanen 1924、2 = International 1930、3 = IGF1967、または 4 = IGF1980。

d 最初の列が距離を保持する XNUMX 列のテーブルのファイル名を追加します
トラックに沿って、データ値を保持する XNUMX 番目の列。 ファイルが指定されていない場合は、読み取ります
代わりに標準入力から。 MGD77+ ファイルで距離が一致するレコードは、
新しい値が割り当てられました。 他の距離では、それらを NaN に設定します。 あるいは、与える
大文字 D 代わりに、すべてのレコード距離で列を補間します。
見る -N 距離単位の選択 -C 距離を選択するため
計算されます。

e から e77 エラー/修正ログが見つかることを期待しています mgd77スニッファー 名前で
NGDC_ID.e77 は現在のディレクトリまたは $MGD77_HOME/E77 にあります。 このファイルは検査されます
ヘッダー値を変更するために使用され、体系的な
特定の列 (スケールやオフセットなど) の補正、特定の
異常は観測から再計算する必要があります (たとえば、次の値から mag を再計算します)。
mtf1 および最新の IGRF)、および特別な列を追加または更新します。 フラグ 保持できる
標準 MGD0 データ セットの各データ フィールドのビットフラグ (1 = 良好、77 = 不良)。
見つかった固定補正項 (フィールドを 0.1 または 10 でスケーリングする必要があるなど)
ソース機関が間違った単位を使用したため) への属性として書き込まれます。
netCDF MGD77+ ファイルで、データが読み取られるときに適用されます。 mgd77リスト. エフェメラル
クロスオーバー分析によって決定されたような修正はデータに保持されません
ファイルですが、修正テーブルに存在します (を参照してください)。 mgd77リスト 詳細については）。 デフォルトでは、
e77 ファイルの各ヘッダー行の最初の文字 (?、Y、または N) は、
対応する調整を適用する必要があるかどうかを確認します。 もしあれば
未決定の設定が見つかった場合 (ii, ?)、中止し、変更を行いません。 それだけ
Y とマークされたレコードが処理されます。 追加することで、この動作をオーバーライドできます
またはそれ以上の修飾子 -あい コマンド： h すべてのヘッダー修正を無視します。 f 意志
すべての固定されたシステマティック トレンド修正を無視し、 n, v, s ビットフラグを無視します
それぞれ、ナビゲーション、データ値、およびデータ勾配に関係します。 使用する -A+e 〜へ
ファイル内の既存の E77 修正を新しい値に置き換えます。 最後に、e77
E77 ファイルが検証されていない場合、修正は適用されません。 使用する -AE 〜へ
検証ステータスを無視します。

g MGD77+ ファイルで指定されたトラックに沿って GMT 地理 (経度、緯度) グリッドをサンプリングします
バイキュービック補間を使用します (ただし、 -n）。 GMT グリッド ファイルの名前を追加します。

i MGD77+ によって指定されたトラックに沿って Sandwell/Smith Mercator *.img グリッドをサンプリングします。
バイキュービック補間を使用したファイル (ただし、 -n）。 img グリッド ファイル名を追加し、
コンマ区切りのデータ スケール (通常は 1 または 0.1)、IMG ファイル モードが続きます
(0-3)、オプションで img グリッドの最大緯度 [80.738]。 モードは、
以下: (0) 制約コードのない Img ファイル、すべてのポイントでデータを返す、(1)
制約がコード化された Img ファイル、すべてのポイントでデータを返す、(2) を含む Img ファイル
制約がコード化され、制約されたポイントでのみデータを返し、他の場所では NaN を返します。
(3) 制約がコード化された Img ファイル。制約で 1 を返し、それ以外では 0 を返します。

n レコードを保持する最初の列を持つ XNUMX 列のテーブルのファイル名を追加します
number (0 から nrows - 1) と、データ値を保持する XNUMX 番目の列。 ファイルがない場合
代わりに標準入力から読み取るとします。 内のレコード番号が一致するレコード
MGD77+ ファイルには新しい値が割り当てられます。 他のレコードでは、それらを NaN に設定しました。

t 最初の列に絶対値を保持する XNUMX 列のテーブルのファイル名を追加します
トラックに沿った時間と、データ値を保持する XNUMX 番目の列。 ファイルが指定されていない場合
代わりに stdin から読み取ります。 MGD77+ ファイル内の時刻が一致するレコードは、
新しい値が割り当てられました。 それ以外の場合は、それらを NaN に設定します。 あるいは、与える
大文字 T 代わりに、すべての記録時間で列を補間します。

-Cf|g|e
XNUMX 文字のコードを追加して、沿線距離の手順を選択します
使用時の計算 -広告|D （参照してください -N 距離単位の選択用):

f 平らな地球の距離.

g 大圏距離 [デフォルト]。

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

-D略語1,略語2、...）
削除したい列の省略形のカンマ区切りのリストを指定します
MGD77+ ファイル。 このオプションを使用して、置き換える列を削除しないでください
新しいデータで (使用 -A+ 代わりは）。 netCDF から変数を削除できないため
削除する列を含まない新しいファイルを作成する必要があります。 ファイルが完成したら
正常に作成され、古いファイルの名前を一時的に変更し、新しいファイル名を次のように変更します
古いファイル名を削除し、最後に名前が変更された古いファイルを削除します。

-E空の
空の文字列値を埋めるために繰り返される単一の文字を指定します。
"9" は "99999..." [9] のような文字列になります。

-F 強制モード。 このモードがアクティブな場合は、削除または置換することもできます
標準の MGD77 カラム セット。 あなたは自分が何をしているのかをよく知っています！

-I略語/名/単位/ t /階段/オフセット/コメント
ファイル情報に加えて、ファイルに関する追加情報を指定する必要があります。
余分な列。 短い（16文字以内、小文字、数字、
またはアンダースコアのみ) 選択したデータの略語、よりわかりやすい名前、
データ単位、データ型 1 文字コード (byte、 sホルト、 fロート、 int、 d倍、または
text) netCDF ファイルに保存するために使用する必要があるスケールとオフセット
データに適用して、選択したストレージによって暗示された範囲内に収まるようにします
タイプ、およびこれらのデータが表すものに関する一般的なコメント (< 128 文字)。
注: テキスト データ タイプが選択されている場合、 -A 議論
テキストデータを参照してください。 さらに、補間に関する議論はそうではありません
適用され、NaN 値は「文字列なし」の値になります (を参照してください)。 -E これが何であるか）。
XNUMX つ以上の単語を含む用語を引用符で囲みます (例: "Corrected Depth")。

-N単位 距離単位を追加します (UNITS を参照)。 [デフォルトは -Nk (km)]。 次の場合にのみ関連
-Ag|i 選択されています。

-NS[単位]xmin/xmax/イミン/ワイマックス[r] （もっと ...）
関心領域を指定します。 次の場合にのみ関連 -Ag|i 選択されています。

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

-bi [ncols][NS] （もっと ...）
ネイティブ バイナリ入力を選択します。 これは、1 列または 2 列の入力データ ファイルに適用されます。
の一部で指定されている -A オプション。 バイナリ入力オプションのみが利用可能です
数値データ列用。

-duデータなし （もっと ...）
等しい入力列を置き換えます データなし NaNで。

-n[b|c|l|n][+a][+bBC][+c][+tしきい値] （もっと ...）
グリッドの補間モードを選択します。

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

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

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

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

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

単位

マップ距離の単位については、 単位 d アーク度の場合、 m アーク分、および s アーク用
XNUMX番目、または e メーターの場合[デフォルト]、 f 足用、 k kmの場合、 M 法定マイルの場合、 n 航海用
マイル、そして u 米国の測量フィート用。 デフォルトでは、球形を使用してそのような距離を計算します
大円での近似。 プリペンド - 距離まで（または単位が距離ではない
与えられた）「地球平面説」の計算を実行する（より速いが正確ではない）または前に追加する + 〜へ
正確な測地線計算を実行します（低速ですが、より正確です）。

結果 OF GRID リサンプリング

グリッドのリサンプルまたはサンプリングでは、さまざまなアルゴリズムが使用されます (「 -n）につながる可能性があります
リサンプリングされた値に歪みや予期せぬ結果が生じる可能性があります。 期待される効果の一つ
スプラインを使用したリサンプリングの傾向は、新しいリサンプリング値がわずかに超える傾向です。
元のグリッドのグローバル最小/最大制限。 これが受け入れられない場合は、強制することができます
リサンプリングされた値のクリッピングにより、入力の最小値/最大値を超えないようにします。
追加 +c あなたへ -n オプションを選択します。

例

Geosat/ERS-1 重力バージョン 11.2 をクルーズの追加データ列として追加するには
01010047.nc および 01010008.nc、値を mGal*10 として 2 バイトの短整数に格納して、試してください。

gmt mgd77manage 01010047 01010008 -Ai10/1/grav.11.2.img \
-Isatgrav/"Geosat/ERS-1 重力"/"mGal"/s/10/0/"Sandwell/Smith バージョン 11.2" -V

フィルタリングされたバージョンの磁気を、float 型の追加データ列として追加するには
01010047.nc を巡航し、MGD77+ で指定された時間にフィルター処理されたデータを補間します。
ファイル、試してください

gmt mgd77manage 01010047 -ATmymag.tm -Ifiltmag/"中間波長 \
磁気残差"/"nTesla"/f/1/0/"アイソクロンを探すのに便利" -V

既存の余分な列 satfaa、coastdist、および satvgg をすべての MGD77+ ファイルから削除するには、
試します

gmt mgd77manage =allmgd77.lis -Dsatfaa,coastdist,satvgg -V

すべての MGD4+ ファイルで、正しい IGRF 参照フィールドを持つ 77 バイトの float 列を作成するには、
試します

gmt mgd77manage =allmgd77.lis -Acm -Iigrf/"IGRF リファレンス \
field"/"nTesla"/f/1/0/"10 ～ 1990 年の IGRF バージョン 2010" -V

考察

1. 前文

mgd77 サプリメントは、(1) の限られた機能を改善する試みです。
既存の mgg サプリメント、(2) Scripps の gmt+ サプリメントからのいくつかのアイデアを組み込む
追加のデータ列を許可し、(3) 海を管理するための新しい機能を追加する
アーキテクチャに依存しない CF-1.0 に保存された地球物理学的トラックライン データと
COARDS 準拠の netCDF ファイル形式。 以下は、基本的なアイデアと手順の一部です。
ファイルを維持するために必要です。

2. 概要

私たちの出発点は、CD-ROM 上の NGDC から配布された MGD77 ASCII データ ファイルです。
DVD-ROM、および FTP 経由。 Geodas を使用してファイルをローカルにインストールし、「Carter」を選択します。
双方向の移動時間を使用して深さの列を埋める「修正された深さ」オプション
twt が存在する場合は Carter テーブル。 この手順により、約 5000 個の個別のクルーズ ファイルが得られます。
これらを選択した XNUMX つ以上のサブディレクトリに配置し、これらのサブディレクトリを一覧表示します (XNUMX つの
行ごとに) ファイル mgd77_paths.txt に追加し、そのファイルを が指すディレクトリに配置します。
$MGD77_HOME; 設定されていない場合、この変数のデフォルトは $ GMT_SHAREDIR/mgd77.

3. 変換

次を使用して、ASCII MGD77 ファイルを新しい netCDF MGD77+ 形式に変換します。 mgd77変換.
通常、変換するすべてのクルーズのリストを作成します (ありまたはなし)
拡張子)、次に実行します
mgd77convert =cruises.lis -Fa -Tc -V -Lwe+ > log.txt

詳細設定により、変換中に見つかったすべての問題が確実に解決されます。
報告。 新しい *.nc ファイルは、XNUMX つまたは複数の個別のサブディレクトリに配置することもできます。
これらは mgd77_paths.txt ファイルにもリストされている必要があります。 を配置することをお勧めします。
*.mgd77 ディレクトリの前に *.nc ファイルがあるディレクトリ。 あとで制限したいとき
特定の拡張子のファイルを検索するには、 -I オプションを選択します。

4. 追加 新製品 コラム

mgd77管理 *.nc ファイルにデータ列を追加できます。 これらは
テキスト文字列を含むすべてのものですが、最も可能性が高いのは、
提供されたグリッドまたはフィルター処理または操作された既存の列から追跡する
特定の目的のために。 この形式では、このような追加の列を最大 32 個までサポートします。 この男を参照してください
列の追加方法のページ。 後でこれらの列の一部を削除するか、
特定の列に関連付けられたデータを更新します。 などのデータ抽出ツール mgd77リスト
標準 MGD77 列 (ナビゲーション、時間、および通常の列) の混合を抽出するために使用できます。
物理観測) とカスタム列。

5. エラー ソース

エラーの修正方法について説明する前に、まずさまざまなクラスのエラーをリストします。
MGD77 データに関連付けられている: (1) 一部の情報の場合、ヘッダー レコード エラーが発生します。
ヘッダーのフィールドが MGD77 仕様に準拠していないか、必要な情報が正しくありません。
不足しています。 mgd77変換 拡張詳細設定が
選択されました。 これらのエラーは通常、データには影響せず、代わりに
メタデータ (2)。 特定のデータ列が、
MGD77 仕様が正しくエンコードされていません。 これは通常、データがオフになることを意味します
10 や 0.1 などの定数係数によって、または場合によっては 1.8288 に変換されます。
尋からメートルへ. (3) 計測器を記録した際に未知の系統誤差が発生する
体系的であると思われる導入された信号に続くデータまたは処理
トラックに沿った時間、緯度、進行方向、またはその他の用語の組み合わせの関数
物理的または論理的な説明があります。 これらの用語は、データによって解決される場合があります
トラックに沿った調査やトラック全体の調査などの分析手法。
データに適用すると、これらの不要な信号が除去されます。
最適な方法。 これらの修正条件は、新しいデータが考慮されるときに変更される可能性があるためです。
そのような修正は一時的なものと見なされます。 (4) 個人データ
データのポイントまたはシーケンスは、可能な範囲外であるなどのルールに違反する場合があります。
他の方法で正気を侵害します。 さらに、有効範囲内にある可能性のある点のシーケンス
範囲によって、不合理なデータ勾配が生じる場合があります。 各ポイントのステータス
これにより、GOOD または BAD のビットフラグが生成されます。 私たちのポリシーは
エラーソース1、2、および4は、情報をメタデータとして提供することによって修正されます
関連する *.nc ファイルでは、エラー ソース 3 の修正 (それらは
常に改善されます) は、別の修正リストに保持されます。

6. 検索 エラー

　 mgd77スニッファー は、オリジナルの完全なトラックに沿ったサニティ チェックを行うツールです。
MGD77 ASCII ファイルに変換され、対応する *.e77 エラー ログが生成されます。 見つかったすべての問題は、
エラー ログにエンコードされ、必要に応じて、推奨される修正条件が示されます。 アン
アナリストは、提案された修正が実際に有効であることを確認することができます (私たちが望んでいるのは
本当に明白なユニット エラーを修正する)、これらのエラー ログを編集し、そのような修正用語を変更します。
関連するコード キーを変更してアクティブ化します ( mgd77スニッファー 詳細については）。
mgd77管理 これらのエラー ログを取り込み、(1) 指定された不正なヘッダー レコードを修正できます。
ログの提案、(2) 読み取り時に使用するスケール/オフセット補正用語を挿入
特定の列、および (3) 見つかったビットフラグを挿入します。 後で見つけた場合は、この手順を再実行してください
すべての E77 設定またはフラグが最新の E77 ログに基づいて再作成されるため、その他の問題。

7. エラー 訂正

抽出プログラム mgd77リスト データの修正をオンザフライで適用できます。
要求されます。 まず、BAD ビットフラグを持つデータが抑制されます。 第二に、固定のデータ
体系的な修正項は、それに応じて修正されます。 第三に、一時的なデータ
修正条件には、これらの修正が適用されます (修正テーブルが提供されている場合)。
これらのすべての手順には、関連するメタデータの存在が必要であり、すべてを却下することができます
ユーザーによって。 さらに、ユーザーは独自のビットフラグを別のデータ列として追加し、
つかいます mgd77リストの論理テストを使用して、どのデータを出力から除外するかをさらに決定します。

CREDITS

IGRF の計算は、英国の Susan Macmillan によって書かれた Fortran プログラムに基づいています。
Joaquim Luis によって f2c を介して C に翻訳され、によって GMT スタイルに適応された Geological Survey
ポール・ウェッセル。

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