waterPMLコマンドにおけるスナップショットの設定ファイルの書式

• スナップショットは
  
  • 3辺が$x$, $y$, $z$軸に平行な直方体領域
  • 2辺が$x$, $y$軸に平行な長方形領域における地表面または水面
  での値を出力できる。
  The output of a snapshot can be defined in one of the following regions:
  
  • a rectangular-solid volume parallel to the $x$-, $y$-, and $z$-axes; or
  • the ground/water surface in a rectangular region parallel to the $x$- and $y$-axes.
  
  
• 1つの計算で複数の領域(直方体/地表面/水面)でのスナップショットを出力できる。
  Snapshots in multiple regions (rectangular-solid volumes or ground/water surfaces) can be included in the outputs of each computation.
  
  
• スナップショットの設定ファイルには 「newsnap 領域名」の形式の行を含める必要がある。 この行から次の「newsnap 領域名」の行の前までが 1つの領域(直方体/地表面/水面)に関する指定と見なされる。
  The configuration file of snapshots must consist of lines with “newsnap region name” format. Lines from this to the next “newsnap region name” are regarded as the configurations for a region (a rectangular-solid volume or a ground/water surface).
  
  
• 1つの領域に関する指定は1行につき1つのパラメータを パラメータ名とパラメータ値の組で与える。 パラメータ名とパラメータ値の区切りには半角空白1文字を用いる。 以下のパラメータが指定できる。 パラメータは自由な順番で指定でき、 相反する指定がなされた場合には後の指定が優先される。
  The configurations for a region are given as one parameter in each line with the name and value of the parameter separated by a space. The following parameters are available. The parameters can be specified in an arbitrary order. In case of conflicting parameter values, the latter value has a higher priority.
  
  

  パラメータ名 Parameter name	意味 Meaning	可能なパラメータ値 Allowed parameter values	デフォルト値 Default value
  snapname	スナップショットの名前。出力ファイル名の一部として用いられる。 The name of a snapshot, used as a part of the output file name.	ファイル名(ディレクトリパスを含む)として許容可能な文字列。 wholeとallは指定不可。 A string that is available for a file name (including a directory path) other than whole and all.	領域名 Region name
  xrange	出力に含める$x$座標の範囲。 The range of the $x$-coordinate included in the output.	下限[m]と上限[m]をカンマ(,)で区切って書く。 The lower and upper limits [m] separated by a comma (,).	省略不可 Cannot be omitted
  yrange	出力に含める$y$座標の範囲。 The range of the $y$-coordinate included in the output.	下限[m]と上限[m]をカンマ(,)で区切って書く。 The lower and upper limits [m] separated by a comma (,).	省略不可 Cannot be omitted
  zrange	出力に含める$z$座標の範囲。 The range of the $y$-coordinate included in the output.	ssurface 地表面直下でのスナップショットを出力する。 Output the snapshots immediately below the ground surface. wsurface 水面直下でのスナップショットを出力する。 水域が存在しない$(x,y)$においては出力する速度値を0とする。 Output the snapshots immediately below the water surface. For $(x,y)$ where a water-filled region is absent, zero is used for the output velocity values. wsurface 地表面と水面のうち、 より上方にある面の直下でのスナップショットを出力する。 Output the snapshots immediately below the upper one of the ground or water surface. $z$の下限,上限(数値[m]、カンマ区切り) Lower and upper limits of $z$ (numerical values [m]) separated by a comma (,) 下限・上限で指定される直方体領域でのスナップショットを出力する。 Output the snapshots within the rectangular-solid volume specified by the lower and upper limits.	省略不可 Cannot be omitted
  xinc	出力地点の$x$方向の間隔[m]。 The interval [m] of the outputs along the $x$-direction.	$\mathrm{\Delta }x$の自然数倍。 --snapshot_place=dの場合には奇数倍でなければならない。 A natural number multiple of $\mathrm{\Delta }x$; the multiple must be an odd number in case of --snapshot_place=d.	$\mathrm{\Delta }x$
  yinc	出力地点の$y$方向の間隔[m]。 The interval [m] of the outputs along the $y$-direction.	$\mathrm{\Delta }y$の自然数倍。 --snapshot_place=dの場合には奇数倍でなければならない。 A natural number multiple of $\mathrm{\Delta }y$; the multiple must be an odd number in case of --snapshot_place=d.	$\mathrm{\Delta }y$
  zinc	出力地点の$z$方向の間隔[m]。 The interval [m] of the outputs along the $z$-direction.	$\mathrm{\Delta }z$の自然数倍。 --snapshot_place=dの場合には奇数倍でなければならない。 A natural number multiple of $\mathrm{\Delta }z$; the multiple must be an odd number in case of --snapshot_place=d.	$\mathrm{\Delta }z$

  
  
• 異なる領域に対して同一の領域名やスナップショット名を用いてはならない。
  The region names or snapshot names for different regions must not be same.
  
  
• 空行、行内で#から後の部分、および最初のnewlakeよりも前の行は コメントとして無視される。
  Empty lines, parts after # in each line, and lines before the first newlake are ignored as comments.
  
  

例 (Example)