ワークブック

Code Workbook で操作する主なリソースはワークブックです。ワークブックを使用して Foundry からデータセットをインポートし、次のような目的で入力データセットを加工します。

• 外部ソースからインポートした生データをクレンジングして結合し、他のユーザー向けに整備したデータセットを作成します。
• 処理済みのデータソースを分析して、有用なインサイトを導き出します。
• モデルを学習させて適用し、予測分析を行います。
• パラメーター化された可視化を作成して、レポートに表示します。

グラフ

ワークブックのインターフェースの中核となるコンポーネントはグラフです。グラフは、ワークブック内の論理的なステップを通じてデータがどのように流れ、出力を生成するかを表します。

入力データセットは、ワークブック内でソースデータとして使用するために、Foundry の他の場所からインポートされます。入力データセット以外のグラフ内のノードは、それぞれトランスフォームを表します。トランスフォームは、出力としてデータフレームまたはモデルを返し、場合によっては可視化を表示できるロジックです。トランスフォームは、派生データセットとして保存できます。トランスフォームを派生データセットとして保存すると、そのトランスフォームの実行時に結果が Foundry に自動的に書き込まれるため、この Code Workbook の外部で使用したり、他のユーザーと簡単に共有したりできます。

Code Workbook では、3種類のトランスフォームを利用できます。

• コードトランスフォームでは、入力を処理して結果を返すコードを記述できます。
• Template トランスフォームは、データ加工コードに対するフォームベースのインターフェースを提供し、コードの再利用と共有を簡単にします。
• 手動入力トランスフォームでは、ユーザーがノードにデータを入力できます。

グラフ内を移動する

グラフ内の任意のトランスフォームをクリックすると、インターフェースの下部にロジックパネルが開きます。このパネルで、トランスフォームのロジックを表示および編集し、トランスフォームの出力を表示できます。Windows では Ctrl+クリック、macOS では Cmd+クリックで、グラフ内の複数のトランスフォームを選択できます。

大きなワークブック内の移動には、グラフの左下にあるズームオプションを使用できます。このオプションには、すべてのトランスフォームが表示されるようにグラフの表示倍率を調整するフィットさせるボタンがあります。

トランスフォームを操作する

トランスフォームを操作する主な方法は、コンテキストメニューを使用することです。グラフ内の各トランスフォームの右上にある省略記号（...）をクリックするか、グラフまたはサイドバー内のトランスフォームを右クリックすると、このメニューが開きます。

このメニューには、新しい下流のトランスフォームの追加、このデータセットに関連付けられたトランスフォームの実行、ワークブックからのこのトランスフォームの削除など、便利なアクションが用意されています。データセットとして保存されているトランスフォームでは、アクション… を選択すると、そのデータセットに関連付けられた通常の Foundry アクションにアクセスできます。

複数のトランスフォームを選択した場合（Windows では Ctrl+クリック、macOS では Cmd+クリックを使用）、グラフの任意の場所を右クリックすると、選択したすべてのトランスフォームのコンテキストメニューが開きます。これは、複数の入力を持つ新しいトランスフォームを追加する場合や、複数のトランスフォームを同時に実行する場合に便利です。

ワークブック内のデータセット名にカーソルを合わせると、Foundry 内のデータセットのフルパスを示すツールチップが表示されます。

パス

ワークブックの上部でパス表示に切り替えることができます。パス表示は、ワークブック内で直線的に開発を進められる別のモードです。パス表示は、1個のデータセットを掘り下げ、順番にデータ加工のステップを実行するワークフローに適しています。

パスは、ワークブックにインポートしたデータセット、またはワークブック内で作成したトランスフォームから開始できます。パス表示では、左側のサイドバーを使用してパス間を移動します。

パス表示で作成したすべてのトランスフォームは、グラフにも保存されます。パスノードからグラフに移動するには、パスノードのグラフでトランスフォームを開くアイコン（）をクリックします。

グラフ内では、ノード間のエッジにある注釈を見て、どのノードがパスの一部であるかを確認できます。注釈にカーソルを合わせると、元のパスが開きます。

ノードのパスアイコンをクリックして、そのノードを元のパスで開くこともできます。

全画面エディター

1個のトランスフォームに集中し、全画面モードで操作したい場合があります。グラフまたはパス表示で、対象のノードの展開ボタン（）をクリックすると、全画面エディターで表示されます。

全画面モードでは、ドッキング操作またはドラッグアンドドロップでタブを並べ替え、2個のタブを同時に表示できます。

全画面エディターを終了してグラフまたはパスに戻るには、Esc キーを使用するか、折りたたみボタン（）を選択します。

ペイン

Code Workbook には、内容、グローバルコード、コンソールの3個のインターフェースペインがあり、グラフ、パス表示、全画面エディターからいつでも利用できます。

内容

インターフェースの左側にある内容バーをクリックすると、ワークブックの内容ペインが開きます。

グラフモードでは、内容ペインにグラフ内のすべてのトランスフォームのリストが表示され、ワークブック全体を把握できます。デフォルトでは、このトランスフォームのリストはトポロジカル順に並べ替えられ、入力データセットが上部に、最も下流のトランスフォームが下部に表示されます。リスト内の各トランスフォームの横にはズームボタンがあり、クリックするとそのトランスフォームを中心にグラフが表示されます。スペースバーを使用して、選択したトランスフォームを拡大することもできます。保存したデータセットを編集をクリックすると、データセットとして保存するトランスフォームを変更できます。どのトランスフォームも保存しないようにすることもできます。

パス表示では、内容ペインにワークブック内のすべてのトランスフォームのミニグラフが表示され、ノード間をすばやく移動できます。

グローバルコード

ワークブックのインターフェースの右側にあるグローバルコードペインを使用して、ワークブック全体の同じ言語のすべてのコードトランスフォームで利用できるコード（変数や関数など）を定義します。たとえば、グローバルコードを使用して、複数のトランスフォームで使用する定数や、繰り返し使用したいヘルパー関数を定義できます。グローバルコードの使用方法について詳しくはこちら。

コンソール

ワークブックの右側にあるコンソールは、REPL（読み取り・評価・出力ループ）を提供し、グラフ上の任意のデータセットをすばやくアドホックに分析できます。ワークブックの各言語でのコンソールの使用方法について詳しくはこちら。

コンソールの下にある変数ペインを使用して、コンソール内の対象トランスフォームの入力データ型を設定します。

コンソールコマンドがデータフレームを返す場合、+ グラフに追加ボタンを使用して、そのコンソールコマンドをトランスフォームに変換できます。これにより、コンソールでロジックを試してから、繰り返し実行できるトランスフォームに昇格させることができます。

Windows では Ctrl+Shift+Enter、macOS では Cmd+Shift+Enter のキーボードショートカットを使用して、トランスフォームからコンソールにコードを直接送信できます。