チュートリアル概要¶
このチュートリアルでは、Graphcal をステップごとに学びます。各ステップは前のステップの上に積み重なり、新しい概念を段階的に導入します。
作成するもの¶
このチュートリアルを終える頃には、次のようなエンジニアリング計算を作成できるようになります。
- リアクティブな DAG の中で入力パラメーターと計算ノードを定義する
- コンパイル時チェック付きの物理次元と単位を使う
- 代数的データ型でデータを整理する
dagブロックとincludeで再利用可能な計算を書く- プロジェクトを複数のファイルに分割する
- インデックス付きコレクションと集約を扱う
チュートリアルのステップ¶
| ステップ | トピック | 学ぶこと |
|---|---|---|
| ステップ 1 | Hello, Graphcal | パラメーター、ノード、定数、@ シジル、graphcal eval |
| ステップ 2 | 次元と単位 | 物理次元、単位、次元注釈、単位変換 |
| ステップ 3 | 代数的型 | コンストラクター、ペイロード、フィールドアクセス |
| ステップ 4 | DAG ブロック | dag ブロックによる再利用可能な計算、include、名前付き引数 |
| ステップ 5 | 複数ファイルプロジェクト | import 宣言、プロジェクトの構成 |
| ステップ 6 | インデックス付き値 | 有限インデックス、for 内包、集約、scan |
サンプルの実行¶
単一ファイルのステップはスタンドアロンのプレイグラウンドにリンクしているので、何もインストールせずに始められます。フルサイズのエディターはサンプルと共有可能なソース URL に対応しています。コンパイラーと評価器は WebAssembly でローカルに動作し、ソースをアップロードすることはありません。ステップ 5 は複数ファイルプロジェクトを扱うため、CLI が必要です。
Report を選択すると、パラメーターの操作欄、値、プロット、チェック、ソースの来歴を含む対話型 HTML レポートを表示できます。
操作欄には 36.0 km/h のように単位を明示した閉じた Graphcal 値を入力します。代数的なパラメーターではコンストラクターを選択して各フィールドを再帰的に編集でき、固定軸のインデックス付きパラメーターではすべての要素を編集できます。操作欄の変更はソースを書き換えません。
Auto run は既定で有効で、編集が短時間止まると完成したパラメーターを検査します。無効にすると、Apply を選ぶまで下書きを未適用のまま保持できます。Discard edits は受け付け済みのスナップショットを復元し、高度な完全値入力には Raw literal も利用できます。無効な入力には該当するフィールドまたは要素でエラーを表示し、最後に成功した計算結果を表示し続けます。
入力の構造に応じたアウトラインでは、スカラーと 1 フィールドのレコードを編集可能な行で表示し、大きな構造は必要に応じて展開できます。名前、パス、パラメーターの説明を検索し、よく使う入力を星印でピン留めすると、そのまま編集できます。⋯ メニューで適用や破棄を行う対象は、その行を含むパラメーター全体です。Advanced controls ではメタデータ、スライダー、完全値の入力を利用できます。デスクトップでは結果が独立してスクロールし、タブと出力のピン留めを使って必要な値を表示しながら編集できます。モバイルでは通常のページスクロールを使用し、入力欄を大きく表示します。上部に追従する Inputs と Results ボタンで、編集内容を保持したままセクション間を移動できます。幅の広い表やプロットはページ全体を広げず、専用領域内でスクロールできます。ピン留めはセッション内だけの設定で、共有リンクには含まれません。 Reset parameters はソースの既定値に戻します。ソースを編集すると、パラメーターの上書きはすべて解除されます。 Stop は評価を中止し、Run は最後に適用されたパラメーターで再実行します。
Share はソース、適用に成功したパラメーターのリテラル、選択中の表示をリンクに保存します。 Report から共有したリンクはレポート表示で開きますが、閲覧者が Run を押すまでレポートを生成しません。 処理待ち、拒否された入力、復元後まだ検証されていない上書きは、新しい共有リンクから除外され、その旨を表示します。 リンクには暗号化されていないソースとパラメーター値が含まれるため、秘密情報を共有しないでください。 URL の上限は引き続き 16 KiB です。リンクは現在公開されているコンパイラーを使用し、過去のコンパイラーや不変のレポートを保存するものではありません。
プロジェクトをローカルに保存したり、完全な CLI とエディターツールを使ったりするには、Graphcal をインストールして、サンプルを .gcl ファイルとして実行してください。
前提条件¶
ブラウザーで進める場合、JavaScript と WebAssembly が有効な最新のブラウザー以外に前提条件はありません。ローカルで開発する場合は、診断とインレイヒントのために Graphcal エディターサポートのあるテキストエディターを使用してください。
準備はできましたか？ステップ 1: Hello, Graphcal から始めるか、スタンドアロンのプレイグラウンドを開いてください。