make_ellipsoid_dataコマンドマニュアル

(The documentation of make_ellipsoid_data command)

Last Update: 2024/2/1

◆機能・用途(Purpose)

グラフ上にプロットするための楕円の座標を表すテキストデータを作成する。
Create a text data that represents the coordinates of an ellipsoid that is to be plotted on a graph.

◆ソースコード(Source code)

$YMAEDA_OPENTOOL_DIR/general/src/make_ellipsoid_data.c

◆使用方法(Usage)

コマンドライン引数でパラメータを指定する。パラメータの一覧を下表に示す。
Specify parameters by command-line arguments. The table below shows a list of parameters.

●「-」から始まらない引数 (Arguments not beginning with “-”)

このコマンドでは「-」から始まらない引数は存在しない。
This command does not have arguments not beginning with “-”.

●1つの「-」から始まる引数 (Arguments beginning with a single “-”)

このコマンドでは1つの「-」から始まる引数は存在しない。
This command does not have arguments beginning with a single “-”.

●「--パラメータ名=パラメータ値」の形式の引数 (Arguments of a form “--Parameter name=Parameter Value”)

「--パラメータ名=パラメータ値」の形式の引数は自由な順番で指定できる。「-」から始まらない引数の間に挿入しても良い。相反する指定がなされた場合には後の指定が優先される。デフォルト値を持つパラメータは省略できる。
Arguments of a form “--Parameter name=Parameter Value” can be placed in an arbitrary order. They can even be inserted between arguments not beginning with “-”. In case of conflicting options being specified, the latter option has a higher priority. Parameters that have default values can be omitted.

パラメータ名 Parameter name	意味 Meaning	可能なパラメータ値 Allowed parameter values	デフォルト値 Default value
center	楕円の中心点の座標$(x_c,y_c)$。 The coordinate, $(x_c,y_c)$, of the center of the ellipsoid.	$x$座標と$y$座標をカンマ(,)で区切って並べた文字列。 A string composed of the $x$- and $y$-coordinates separated by a comma.	0.0,0.0
longer_radius	楕円の長軸半径$a$。 The longer radius, $a$, of the ellipsoid.	正の実数。 A positive real number.	1.0
shorter_radius	楕円の短軸半径$b$。 The shorter radius, $b$, of the ellipsoid.	$a$以下の正の実数。 A positive real number less than or equal to $a$.	$0.5a$
longer_axis_direction	楕円の長軸の方向$\phi$($x$軸から反時計回り、°)。 The direction, $\phi$, of the longer axis of the ellipsoid (counterclockwise from the $x$-axis, °).	0.0以上360.0未満の実数。 A real number greater than or equal to 0.0 and less than 360.0.	0.0
angle_interval	計算する円周上の点の角度刻み$\Delta\theta$(°)。 The angle interval, $\Delta\theta$ (°), of the points to draw the ellipsoid.	360.0の整数($\geq 2$)分の1となる正の実数。 A positive real number that is an integer ($\geq 2$) divisor of 360.0.	1.0

◆動作(Behaviour)

座標 $x=x_c+X\cos\phi-Y\sin\phi$, $y=y_c+X\sin\phi+Y\cos\phi$, $X=a\cos(n\Delta\theta)$, $Y=b\sin(n\Delta\theta)$ ($n=0,1,2,\cdots,N)$を計算する。但し$N\Delta\theta=2\pi$とする。結果を標準出力に第1列を$x$、第2列を$y$ (タブ区切り)で表示する。
Compute the coordinates $x=x_c+X\cos\phi-Y\sin\phi$ and $y=y_c+X\sin\phi+Y\cos\phi$ for $n=0,1,2,\cdots,N$, where $X=a\cos(n\Delta\theta)$ and $Y=b\sin(n\Delta\theta)$. Display the results into the standard output as the $x$ and $y$ values in the 1st and 2nd columns, respectively, separated by a tab.

◆使用例(Example)

make_ellipsoid_data --center=1.0,3.0 --longer_radius=2.0 --shorter_radius=1.5 | gmt plot -R-5/5/-5/5 -JX5/5 -Bxa1 -Bya1 -BWSen -Xa2 -Ya2 -W1,0/0/0

この例では(1,3)を中心とする長軸半径2(水平方向)、短軸半径1.5(鉛直方向)の楕円を Generic Mapping Tools (GMT) を用いてプロットする。
In this example, an ellipsoid with a longer radius of 2 and a shorter radius of 1.5 centered at (1,3) is plotted using Generic Mapping Tools (GMT).

make_ellipsoid_dataコマンド マニュアル