データ整形:ワークシートの分割
行/列または参照列の値でワークシートを分割します
必要なOriginのバージョン: Origin 8.6 以降
部分ワークシートの分割、参照列による分割、結果シート名の事前設定は2017b以上が必要です。
値と条件の両方に従う参照列による分割は2021が必要です。
1. wsplit mode:=row row:=5;
2. wsplit mode:=label label:=L keep:=1;
3. wsplit mode:=ref ref:=[Book1]Sheet1!A name:=<[<%N_%V>]>;
4. wsplit mode:=ref ref:=[Book1]Sheet1!D refmode:=change turnpoint:=pregroup refsort:=desc;
スクリプトからXファンクションにアクセスする場合、追加のオプションスイッチについてのページを参照してください。
表示 名 |
変数 名 |
I/O と データ型 |
デフォルト 値 |
説明 |
---|---|---|---|---|
入力ワークシート | iw |
入力 Worksheet |
|
分割する範囲を指定します。ワークシート全体または列範囲です。 |
分割モード | mode |
入力 int |
|
入力ワークシートの分割方法を指定します。
オプションリスト:
|
列数 | col |
入力 int |
|
分割モードを列番号によるにしたときに有効です。指定したn 行ごとに新しいワークシートを作成します。 |
行数 | row |
入力 int |
|
分割モードを行の数によるにしたとき有効です。指定したn 行ごとに新しいワークシートを作成します。 |
列ラベル | label |
入力 string |
|
分割モードを列ラベルによるにしたときに有効です。ラベル行文字を使用してラベル行を指定します。 各列ラベル行を示す文字についてはColumn Label Row Charactersを参照してください。 |
参照列 | ref |
入力 Range |
|
分割モードを参照列にしたとき有効です。グループ化変数を含む列を指定します(複数選択可)。 |
分割 | refmode |
入力 int |
|
選択した参照列に従ってワークシート行を分割する方法を指定します。 このコントロールは参照列ボックスで1つの参照列を選んでいる場合にのみ有効になります。 オプションリスト:
|
許容値 | tol |
入力 double |
|
分割モードを参照列に、かつ分割を値による/値の変更によるにしたときに有効です。数値が変化するかどうかを判断するときに考慮される許容誤差を指定します。 |
各曲点を含める | turnpoint |
入力 int |
|
分割で方向変更によるを選んだ際に、前のグループか次のグループどちらに曲点を含めるのかを指定します。
オプションリスト:
|
結果内に参照列を保持 | keepref |
入力 int |
|
分割結果に参照列データを出力します。 |
参照列による結果を並べ替え | refsort |
入力 int |
|
結果内に参照列を保持をチェックしたときに、参照列の対応する値に従って、結果列をソートするかどうかを指定します。このチェックボックスは、分割コントロールを方向変更によるまたは方向リセットによるにしたときにのみ使用できます。
オプションリスト:
|
欠損値を除外 | missing |
入力 int |
|
空のセルや欠損値("--")を含むセルを出力から除外します。 |
列の数式を結果にコピーする | copyform |
入力 int |
|
元のワークシートに列の数式がある場合、式をどう扱うか設定します。
オプションリスト:
|
ショートネームを維持 | sn |
入力 int |
|
新しいワークシートに分割した後、列のショートネームを保持するかどうかを指定します。
Note Origin 2017から、列のショートネームは、アルファベット順に制限されます。初期設定ではこれは編集出来ません。ショートネームを維持オプションはGUIでは非表示です。(ページ下部のノートをご覧ください)スクリプトユーザは、@SSGの値に関らず、 |
最初のN列を保持する | fixcol |
入力 int |
|
分割モードを列番号によるまたは列ラベルによるにしたときに有効です。ソースワークシートの最初のn列を指定して、分割された全ての結果シートにおいても保持されるようにします。これらの最初のn列は、列番号によるまたは列ラベルによるから除外されます。 |
元のワークシートの維持 | keep |
入力 int |
|
元のワークシートをそのまま残します。チェックを付けないと元のワークシートは削除されます。 |
スパークラインを表示する | sparkline |
入力 int |
|
出力ワークシートの列のスパークラインを表示します。 |
出力ワークシート | owp |
出力 WorksheetPage |
|
出力ワークシートを指定します。 |
結果シート名事前設定 | name |
入力 string |
|
%N = あればロングネームなければショートネーム 変数は組み合わせ可能で、任意テキストを含めることもできます(%N=%V など)。単一、組み合わせ、任意テキストとの組み合わせのどの場合も、次のサンプルのように変数は保護されます。 wsplit mode:=ref ref:=[Book1]Sheet1!A name:=<[<%N_%V>]>; |
このXファンクションは、指定された方法でワークシートの複数列を複数のワークシートに分割します。