Skip to main content
ノートブックは、セルの表示順ではなく、変数の依存関係に従ってセルを実行します。セル B がセル A で定義された変数を読み取る場合、セル B はセル A に依存します。セル A はセル B の上流であり、セル B はセル A の下流です。 上流のセルが実行されると、ノートブックは下流のセルを再度実行して、出力が最新の値を反映するようにすることができます。セルが自動的に実行されるかどうかは、ノートブックの ランタイム設定 によって決まります。 ノートブックは、定義と参照をトラッキングすることで依存関係を決定します:
  • definition とは、セルが作成するグローバル名であり、変数、関数、クラス、またはインポートされた名などが該当します。
  • reference とは、セルが別のセルから読み取るグローバル名です。
詳細については、marimo の How marimo runs cells を参照してください。

古いセルと実行がブロックされたセル

Notebooks は各セルの状態をトラッキングし、実行が必要かどうかを判断します。主なセルの状態は 古い と 実行がブロックされている です。

古いセル

セルは、実行したことがない場合、または最新のコードや入力で実行していない場合に 古い 状態になります。セルが現在のコードと入力で実行された後は、古い状態ではなくなります。 セルは、以下のいずれかの状況で古い状態になります。
  • セルのコードを編集した場合。
  • 上流のセルが実行され、ノートブックが lazy モードを使用している場合。このモードでは、ノートブックは下流のセルを自動的に実行する代わりに、古い状態としてマークします。
  • セルが使用する Python モジュールが、lazy モジュール自動リロードが有効な状態で変更された場合。
古いセルを実行して出力を更新してください。上流のセルが古い状態の場合は、ノートブックがそれらを最初に実行します。すべての古いセルを一度に実行することもできます。

ブロックされたセル

セル自体または上流のセルのいずれかが無効になっている場合、そのセルはブロックされた状態です。ブロックされたセルは、入力が変わっても自動的には実行されません。 ブロックを解除するには、依存先の無効になっているセルを再び有効にします。すると、ノートブックは古い状態で出力の更新が必要な下流のセルを実行できます。手順については、セルを無効または有効にするを参照してください。

セルを削除する

セルを削除すると、そのセルで定義されたグローバル変数もノートブックから削除されます。削除された変数を参照するセルは、ランタイム設定に応じて、再実行、無効化、または古い状態としてマークされます。

各グローバル名は一度だけ定義します

各グローバル名は、1つのセルでのみ定義してください。2つのセルで同じグローバル名を定義すると、ノートブックは下流のセルに対する唯一の信頼できるソースを特定できません。この制限は、変数、関数、クラス、インポートしたパッケージ名に適用されます。 一時変数は、変数名にアンダースコア1つを接頭辞として付けることで、そのセルのローカル変数にできます。また、関数内で一時変数を定義することもできます。

セル間での変更を避ける

複数のセルで使用するオブジェクトは変更しないでください。Notebooksはオブジェクトの変更をトラッキングしないため、オブジェクトを変更しても、それに依存するセルは古い状態としてマークされません。 たとえば、あるセルで別のセルに定義されたデータフレームに列を追加したとします。そのデータフレームを参照するセルは自動的には再実行されません。ノートブックの状態の整合性を保つには、新しいオブジェクトを作成して新しい変数に割り当ててください。オブジェクトを変更する必要がある場合は、そのオブジェクトを定義したセル内で変更してください。 詳しくは、変数の変更は追跡されませんを参照してください。

変数と依存関係を確認する

変数を表示する

Variables explorer を使用すると、定義済みの変数とそのタイプ、宣言されている場所、参照されている場所を確認できます。
依存関係にあるノートブックのセル間を流れる変数
セルのシンボルやセル間の接続について詳しくは、以下を参照してください。

ミニマップでセル間の関係を表示する

Dependencies パネルを使用すると、セル間の関係を確認できます。
  1. サイドバーで Explore dependencies () を選択します。
  2. MINIMAP を選択します。

依存関係グラフを表示する

グラフ ビュー を使用すると、セルの依存関係を有向非巡回グラフ (DAG) として可視化できます。
  1. サイドバーで Explore dependencies () を選択します。
  2. GRAPH を選択します。
パンやズームを行ったり、ノードを並べ替えたりして、セル間の関係を確認できます。
最終更新日 2026年9月30日