地質調査総合センター研究資料集, no. 648
Open-file Report of Geological Survey of Japan, no. 648
2018年 1月
January, 2018

AMSS3: Software system for Aeromagnetic data processing,
Grid data manipulation, and Reduction and quantitative
interpretation of magnetic anomaly data (3)

Tadashi Nakatsuka and Shigeo Okuma


Contents:

  The authors have been engaged in the research on aeromagnetic survey, and developed various kinds of programs for data processing, analysis and interpretation. The outlines of them have already been reported on the scientific journals and at the scientific meetings. Their source codes are open to public through the GSJ Open-file Reports.
  This report is a fully-revised and expanded version for the previous GSJ Open-File Report no. 519, with adding newly developed programs (ANAMX) of higher sophisticated analysis methods such as 3D imaging interpretation of aeromagnetic anomaly data. Also, this report includes an update of Library Software (GSJ Open-File Report no. 518).

The contents of this open-file report (before Revision) can be accessed
through the Web Page of GSJ Open-File Report no.648.

Possible minor improvement after Latest Revision 2022-01 :
  The source of Library subprogram paintm/paintw "lib/pspaint.c" may be modified for better suppression of infinitesimal ambiguity noise effect on the output illustration, with applying the patch '@patch/lib_pspaint202306.patch'.
Revision 2022-01 (Latest) :
  Since NOV 2020, some minor improvements on 4 programs (DPAM: 'pltrk'; GDMP: 'plxsec', 'plmapl', 'plmapcl') were performed, and a library subprogram 'axis' was added.
  Then, cummulative source program updates were arranged into a set of patch files [Rev.2022-01]: 'anam_202201.patch', 'anamx_202201.patch', 'dpam_202201.patch', 'gdmp_202201.patch', 'lib_202201.patch', 'utils_202201.patch', and 'Tplate_202201.patch', all under @patch/ directory.
To apply these patches, it is easy to use the script prcedure '@patch/@@applypatch'. [The '@@applypatch' script assumes a standard case such that the ANAM group program sources are located in "/home/SHARE/anam/" directory. Then, store patch files and the script in "/home/SHARE/@patch/" directory, go into that @patch directry, and execute the '@@applypatch' script. However, if the situation is different, '@@applypatch' script must be modified properly.]
  In addition, the documantation for the programs were reconstructed to reflect the addition of new programs and the modified specifications, as follows.
    (1) Revised HTML documentation of overview (originally 'indexE.html') as 'AMSS3E.html', and its Japanese version 'AMSS3.html'.
    (2) Revised HTML documentations of DPAM, GDMP, ANAM, ANAMX program groups: 'dpamE.html', 'gdmpE.html', 'anamE.html', 'anamxE.html', and their Japanese version 'dpam.html', 'gdmp.html', 'anam.html', 'anamx.html'.
    (3) Revised HTML documentations of libgm Library, and (new) 'axis.c' subroutine: 'libgmE.html', 'libgm/libcE.html', 'libgm/axisE.html', and their Japanese version 'libgm.html', 'libgm/libc.html', 'libgm/axis.html'.
    [All the documents above are located under OF0648rDOC/ directory, and it is suggested that, in the storing directory, subdirectories '@patch', 'anam', 'anamx', 'data', 'dpam', 'gdmp', 'lib', 'Tplate', and 'utils' are defined as symbolic links to their source subdirectories (/home/SHARE/@patch, etc.), for refering convenience.]

Update history:
  [JUL 2018] Recommended updates shown in the section 4 of GSJ Open-file Report no. 655 (http://www.gsj.jp/data/openfile/no0655/indexE.html#sec4) [Rev.2018-07].
  [OCT 2018] Bug fixes on 4 programs, update0648-2E.html.
  [DEC 2019] Minor improvements on 20 programs and bug fix on 4 programs. update0648-3E.html.
  [DEC 2019] Cumulative updates are combined into a set of 7 patch files [Rev.2019-12]: anam_201912.patch, anamx_201912.patch, dpam_201912.patch, gdmp_201912.patch, lib_201912.patch, utils_201912.patch, and Tplate_201912.patch .
  [DEC 2019]   IGRF-13 coefficients (Dec 2019 New; to be stored in data/IGRFCOEF/igrf13.coef) became available at OF0648rDOC/igrf13.coef .
  [NOV 2020] Recently recognized minor bugs (ANAM: 'plamag', 'plamagc'; ANAMX: 'nimgs', 'eimgd', 'eimga') were fixed, and some improvements (ANAM: 'galtf', 'galts', 'calmas') and addition of new programs (ANAM: 'cdeql'; GDMP: 'gflat', 'plxsec') were performed.
  [NOV 2020]   Cumulative updates were combined into a set of 7 patch files [Rev.2020-11]: anam_202011.patch, anamx_202011.patch, dpam_202011.patch, gdmp_202011.patch, lib_202011.patch, utils_202011.patch, and Tplate_202011.patch .

内容紹介:

 著者らは,永年にわたり空中磁気探査の研究に従事し, その中でデータ処理・解析の各種プログラムを開発してきました. それらの多くは,すでに概要を学会誌や学術講演会で発表済みですが, 本研究資料集においてそれらのソースプログラムを公開しています.
 この資料は,同名の研究資料集 no.519 の増補全面改訂版であり, より高度な処理である磁気異常の3Dイメージング解析・拡張交点コントロール解析 のソフトウェア(ANAMX) が,新たに加わっています. また,同研究資料集シリーズの no.518 (ライブラリソフト) の更新版を 含んでいます.

この研究資料集のCD-ROMに収められた内容(改訂前)は,
地調研究資料集 no.648 のWebページ から閲覧できます.

最新改訂版 2022-01 以後の小さな改良点:
  ライブラリ サブプログラム paintm/paintw のソース "lib/pspaint.c" は '@patch/lib_pspaint2306.patch' のパッチを当てることにより,変数値の分解能以下の不確定性に起因する 作画での見かけノイズをより少なくできる可能性があります.
2022-01 改訂版 (最新) :
 2020年11月以降には,若干の動作改良の更新を,DPAM内 'pltrk' と GDMP内 'plxsec', 'plmapl', 'plmapcl' の 4プログラムに対して実施し,ほかに, 'axis.c' サブルーチンの libgmライブラリへの追加を行いました.
 そして, これまでの累積的な更新を@patch/ 配下の 7パッチファイル 'anam_202201.patch', 'anamx_202201.patch', 'dpam_202201.patch', 'gdmp_202201.patch', 'lib_202201.patch', 'utils_202201.patch', and 'Tplate_202201.patch' に整理し, [Rev.2022-01]として公開します.
 このパッチを適用するには, '@patch/@@applypatch' に示したスクリプト を使用するのが効果的です. [ANAM群のソースプログラムが "/home/SHARE/anam/" ディレクトリに存在するような 標準的な場合であれば,パッチファイル群, '@@applypatch' スクリプトを "/home/SHARE/@patch/" ディレクトリに保存し,その @patch ディレクトリに 入って,'@@applypatch' スクリプトを実行します.そうでない場合は,スクリプト の内容も正しく設定し直す必要があります.]
  加えて,この改訂版では,これまでのプログラムの追加やごく一部の プログラムでの動作仕様に変更のあった点について更新した説明書を, OF0648rDOC/ 配下に,下記のように 用意してあります.
  (1) 概要説明 (元の 'index.html' ファイル) の更新版 'AMSS3.html', と その英語版 'AMSS3E.html'
  (2) DPAM, GDMP, ANAM, ANAMX の各プログラム群の説明書: 'dpam.html', 'gdmp.html', 'anam.html', 'anamx.html' と その英語版 'dpamE.html', 'gdmpE.html', 'anamE.html', 'anamxE.html'
  (3) 新規のサブプログラム 'axis.c' を含む libgmライブラリ の説明書と 機能概要一覧 'libgm.html', 'libgm/libc.html', 'libgm/axis.html' とその英語版 'libgmE.html', 'libgm/libcE.html', 'libgm/axisE.html'.
 [なお,これらのファイルを収容するディレクトリには,サブディレクトリ '@patch', 'anam', 'anamx', 'data', 'dpam', 'gdmp', 'lib', 'Tplate', 'utils' を 対応するソースコードを収容するサブディレクトリへのシンボリックリンクとして 作成しておくと,コード等の参照の上で好都合です.]

更新履歴:
 [JUL 2018] 地調研究資料集 no. 655の第4節 (望ましい更新) (http://www.gsj.jp/data/openfile/no0655/index.html#sec4) [Rev.2018-07].
 [OCT 2018] 4プログラムのバグ修正. update0648-2.html.
 [DEC 2019] 20プログラムの若干の動作改良と 4プログラムのバグ修正. update0648-3.html
 [DEC 2019] これまでの累積的なプログラム更新を 7パッチファイル [Rev.2019-12] anam_201912.patch, anamx_201912.patch, dpam_201912.patch, gdmp_201912.patch, lib_201912.patch, utils_201912.patch, Tplate_201912.patch に整理.
 [DEC 2019] 第13世代のIGRF係数が確定され係数データが利用可能となり, OF0648rDOC/igrf13.coef から 取得できる.
 [NOV 2020] 最近判明したバグの修正 (ANAMプログラム 'plamag', 'pllamagc' と ANAMXプログラム 'nimgs', eimgd', 'eimga'), 一部プログラムの動作改良 (ANAMプログラム 'galtf', 'galts', 'calmas') および 新規プログラム (ANAMプログラム 'cdeql', GDMPプログラム 'gflat', 'plxsec') の追加を行った.
 [NOV 2020]   ここまでの累積的なプログラム更新を 7パッチファイル [Rev.2020-12]: anam_202011.patch, anamx_202011.patch, dpam_202011.patch, gdmp_202011.patch, lib_202011.patch, utils_202011.patch, Tplate_202011.patch に整理.

頁数: 127, CD-ROM:1
受理日: 2018年 1月 16日

Bibliographic Reference:
Nakatsuka, T. and Okuma, S.(2018) AMSS3: Software system for aeromagnetic data processing, grid data manipulation, and reduction and quantitative interpretation of magnetic anomaly data (3). GSJ Open-File Report, no. 648, 127p. + 1 CD-ROM, Geol. Surv. Japan, AIST.