Write Excel

(RapidMiner Studio Core)

概要

この演算子は、ExcelスプレッドシートファイルにExampleSetを書き込みます。

詳細

Write Excelオペレータは、Microsoft ExcelスプレッドシートファイルにExampleSetを書き込むために使用できます。この演算子は、Excel 95、97、2000、XP、2003以降のバージョンで読み取り可能なExcelファイルを作成します。 ExampleSetの欠落データ値は、Excelファイルの空のセルで示されます。結果のExcelファイルの最初の行には、入力ExampleSetの属性の名前があります。 Write Excelオペレータによって書き込まれたファイルは、Read Excelオペレーターを使用してRapidMinerにロードできます。複数の入力ExampleSetを指定できます。これにより、複数のシートを持つ1つのExcelファイルが作成されます。デフォルトでは、シートには、対応するExampleSetのソースに基づいて名前が付けられます。シート名は、オプションでシート名パラメータを使用して指定できます。

入力

input
この入力ポートには、ExampleSetまたはExampleSetのコレクションが必要です。指定されたExampleSetsは、結果のExcelファイルのシートになります。 Write Excelオペレータには、複数の入力を含めることができます。 1つの入力が接続されると、別の入力ポート（使用可能な場合）を受け入れる準備ができた別の入力ポートが使用可能になります。入力の順序は、結果のExcelファイルで同じままです。

出力

file
作成されたExcelファイルは、「Write File」などのファイル入力ポートを持つ他の演算子で使用できるファイルオブジェクトとして提供されます。

through
対応する入力ポートで提供されたExampleSetまたはExampleSetsのコレクションは、この出力ポートを通じて変更なしで配信されます。これは通常、プロセスのさらなる演算子で同じExampleSetを再利用するために使用されます

パラメータ

excel_file
Excelファイルのパスはここで指定されます。ファイルの選択ボタンを使用して選択できます。
レンジ：string

file_format
ユーザーは、結果のExcelシートにxlsまたはxlsx形式を使用するかどうかを指定できます。
レンジ：selection

sheet_names
シート名はオプションでここで指定できます。指定された最初のシート名は、最初の入力などに対応します。指定されていないシート名は、デフォルトでExampleSetのソースの名前になります。
9.3.0未満の互換性レベル：最初のシート名は、シート名パラメータから取得されます。上記のように、追加のシート名をここで指定できます。
レンジ：enumeration

sheet_name
ユーザーはここで最初のExcelシートの名前を指定できます。このパラメータは、xlsxファイル形式でのみ表示されます。このパラメータは古く、9.3.0以降のバージョンでは削除されました。
レンジ：string

date_format
これはエキスパートパラメータです。さらに、ファイル形式xlsxのみで表示されます。形式の日付を保存する必要があります。
レンジ：string

number_format
これはエキスパートパラメータです。さらに、ファイル形式xlsxのみで表示されます。フォーマット番号を保存する必要があります。
レンジ：string

encoding
これはエキスパートパラメータです。さらに、ファイル形式xlsのみで表示されます。さまざまなオプションがあります。ユーザーはそれらのいずれかを選択できます。
レンジ：selection

チュートリアルプロセス

複数のデータセットを1つのExcelファイルに書き込む
Retrieveオペレータを使用して、複数のデータセットがロードされます。 Write Excelオペレータは、データセットを入力として受け取り、それらを個別のシートとして1つのExcelファイルに書き込みます。最初の2つのシート名は、シート名パラメータによって指定されます。指定されたシート名は、Excelがシート名に課す制限を尊重する必要があることに注意してください。これらは一意で、31文字以下である必要があります。残りのシート名は明示的に指定されていないため、これらのシートには、対応するサンプルセットのソースに基づいて名前が付けられます。

excelファイルパラメータは、次のパスで提供されます： ‘％{tempdir} / Multiple data sets.xlsx’。したがって、「複数のデータセット」という名前のExcelファイルがコンピューターの一時フォルダーに作成されます。結果のExcelシートの最初の行には、対応するデータセットの属性の名前があることに注意してください。データセットのすべての欠損値は、Excelシートの空のセルで表されることにも注意してください。

Write Excelオペレータの入力ポートは、サンプルセットのコレクションを入力として処理できます。ループ演算子は、Irisデータセットを3回取得し、3つのデータセットをコレクションに保存し、それをWrite Excelオペレータに渡します。次に、オペレータは3つのデータセットをアンラップし、結果のExcelファイルに個別のシートとして書き込みます。 3つのデータセットはすべて同じソースを持つため、名前は一意ではありません。これを解決するため、Write Excelオペレータは、ファイルに書き込む前に名前にインデックスを自動的に追加します。