w2xyz

メニュー情報

ワークシート：XYZ形式に変換

概要

ワークシートデータをXYZ形式に変換

追加の情報

必要なOriginのバージョン：Origin8.0 SR3以上。Origin8.5.1 SR0で更新。

コマンドラインでの使用法

1. w2xyz iw:=[book1]sheet1! format:=xcol xlabel:=row1 ycol:=1;

2. w2xyz format:=xcol xlabel:=param param:=P ycol:=1;

3. w2xyz -r 2 range:=rng format:=ycol ylabel:=sel1 xcol:=sel1 trim:=1;

Xファンクションの実行オプション

スクリプトからXファンクションにアクセスする場合、追加のオプションスイッチについてのページを参照してください。

変数

表示名	変数名	I/O とデータ型	デフォルト値	説明
変換範囲	range	入力 int	0	変換範囲オプションリスト： wks:ワークシート全体 0 = ワークシート全体を選択します。 rng:指定された範囲 1 = 指定された範囲を使用します。
入力ワークシート	iw	入力 Worksheet	<active>	変換するデータのある入力ワークシートを指定します。
入力	irng	入力 Range	<active>	変換する入力範囲を指定します。
データフォーマット	format	入力 int	2	ソースデータのフォーマットを指定します。オプションリスト： xcol:列にわたるX Xの値が横方向にあります。 ycol:列にわたるY Yの値が横方向にあります。 noxy:XとYがありませんワークシートにX値やY値がない場合、このオプションを使用します。列および行のインデックスを出力XY値として使用します。
X値の位置	xlabel	入力 int	0	X値の位置を指定します。データフォーマットが列にわたるXのとき利用可能です。オプションリスト： none:なしワークシートにX値がありません。列番号がX値になります。 row1:最初のデータ行最初の行にあるデータがX値になります。 param:列ラベル列ラベル行でX値を指定します。 sel1:選択中の最初のデータ行最初データ行でX値を指定します。変換範囲が指定された範囲、かつ、データフォーマットが列にわたるXまたは列にわたるYの時利用できます。
Y値の位置	ylabel	入力 int	0	Y値の位置を指定します。データフォーマットが列にわたるXのとき利用可能です。オプションリスト： none:なしワークシートにY値がありません。列番号がY値になります。 row1:最初のデータ行最初の行にあるデータがY値になります。 param:列ラベル列ラベル行でY値を指定します。 sel1:選択中の最初のデータ行最初データ行でY値を指定します。変換範囲が指定された範囲、かつ、データフォーマットが列にわたるXまたは列にわたるYの時利用できます。
列ラベル	param	入力 string		X値の位置またはY値の位置で列ラベルを選択した場合に有効です。ラベル行を表す文字を使ってXまたはY座標として使用するラベル行を指定します。各列ラベル行を示す文字についてはColumn Label Row Charactersを参照してください。
最初の列のX値	xcol	入力 int	0	第1列にX値があるかどうか指定します。データフォーマットが列にわたるXのとき利用可能です。
最初の列のY値	ycol	入力 int	0	第1列にY値があるかどうか指定します。データフォーマットが列にわたるXのとき利用可能です。
欠損値の削除	trim	入力 int	0	欠損セルまたは列を削除するか指定します。XYZへの変換時に座標が欠損している場合、このオプションを使用するとデータポイントが除外されます。 0 = 偽 1 = 真
出力	oz	出力 XYZRange	[<input>]<new>!(<new>,<new>,<new>)	出力XYZ範囲のための3列を指定します。異なるワークシート、ワークブックにある3列を指定可能です。出力表記のシンタックスを参照してください。

説明

このXファンクションは、行列のように並んだワークシートデータ（XY座標が最初の行と列にある表形式のデータ、仮想行列）をXYZ形式に変換するとき使います。X座標は最初の行に配置され、Y座標は最初の列に配置されます。あるいは、その逆もあります。等間隔でないX、Y座標でも問題ありません。XY座標が含まれていない場合は、列と行のインデックスが使用されます。Z値は数値またはテキスト（カテゴリデータも）です。

サンプル

一番上の行にX座標値、一番左にある列にY座標値が入っているソースデータを使います。

XYZ形式に変換するには、ワークシートをアクティブにして、メニューからワークシート：XYZ形式に変換を選択するか、コマンドウィンドウでw2xyz -d;を実行して、Xファンクションw2xyzのダイアログを開きます。
ダイアログの変換オプションで、データフォーマットとして列にわたるXを選択します。X値の位置を、最初のデータ行とし、第1列にY値にチェックを付けます。
OKボタンをクリックして変換を実行します。次のような結果ワークシートが出力されます。