Jupyter ノートブックコードセルの実行とデバッグ
ノートブックツールバーのアイコン、コードセルのコンテキストメニューと構造ツールウィンドウのコマンド、およびガターの実行アイコンを使用して、さまざまな方法でノートブックセルのコードを実行できます。
コードセルを実行する
ショートカットとツールバーオプションを使用してコードセルを実行する
次のスマートショートカットを使用して、コードセルをすばやく実行します。
Ctrl+Enter : 現在のセルを実行します。
Shift+Enter : 現在のセルを実行し、その下のセルを選択します。
実行が完了すると、セルは編集モードのままになるため、必要に応じて変更したり、実験を続けることができます。
編集モード中に、Ctrl+Home を押すとキャレットがセルの先頭に移動し、Ctrl+End を押すとキャレットがセルの末尾に移動します。
ノートブックのすべてのコードセルを実行するには、ノートブックツールバーの
をクリックするか、Ctrl+Alt+Shift+Enter を押します。コマンドモード中に、Ctrl+Home を押すとノートブックの最初のセルにフォーカスし、Ctrl+End を押すとノートブックの最後のセルにフォーカスします。
構造ツールウィンドウを使用してコードセルを実行する
単一の
Pythonセルを実行するには、構造ツールウィンドウでそのセルを右クリックし、
セルを実行するを選択します。
Markdown セクション内のすべてのセルを実行するには、構造ツールウィンドウで
Markdownセルを右クリックし、 実行セクションを選択します。
セル実行期間
セルの実行期間に関する情報は、セルの左下隅に表示されます。
この領域にマウスを置くと、セルの実行が完了した日時が表示されます。
エラーが発生した場合は、トレースバックノードを展開して、完全なエラーメッセージを表示します。
サーバーを停止して サーバーまたはカーネルを変更する場合、実行結果は現在のサーバーセッションに対してのみ有効であるため、依存関係を持つすべてのセルを再度実行する必要があります。
変数を表示する
Jupyter コンソール
この機能は、ローカルカーネルとリモートカーネルの両方でデフォルトで有効になっています。リモートカーネルで無効にするには、カーネルに移動し、サポートライブラリをリモート Jupyter にアップロードチェックボックスをオフにしてください。
ノートブックを実行すると、Jupyter コンソールの変数タブで変数をプレビューできます。
デフォルトでは、変数は非同期にロードされます。ローディングポリシーを変更するには、変数タブで 
をクリックし、変数ロードポリシーを選択して、利用可能なモードの 1 つを選択します。詳しくは変数の管理ポリシーのロードを参照してください。
配列として表示、データフレームとして表示、イメージとして表示、またはシリーズとして表示をクリックすると、対応するツールウィンドウにデータが表示されます。詳細については、出力の操作を参照してください。
Jupyter 変数ツールウィンドウ
Jupyter 変数ツールウィンドウは、セルを実行するたびに表示されます。このウィンドウを恒久的に非表示にしたい場合は、に移動し、実行時に変数ツールウィンドウを表示するチェックボックスをオフにしてください。
データビジョン
エディター内で変数を直接プレビューするには、に移動し、インライン値を表示チェックボックスが有効になっていることを確認します。
ノートブックセルを実行します。変数の値は、その用途の横に表示されます。
変数をクリックすると、ポップアップに詳細情報が表示されます。
リファレンスドキュメントのプレビュー
PyCharm を使用すると、特定の変数、型、または引数に関するリファレンスドキュメントをいつでもすばやくプレビューできます。
特定のコードセルの要素の参照情報を表示するには、ターゲットコードセル内にキャレットを置き、
? <type/variable/argument>と入力します。（この例では、plt.scatterのドキュメントをプレビューします）。コード要素はコードセル内でアクセスできる必要があります。セルを実行。イントロスペクションタブが Jupyter ツールウィンドウに開きます。
イントロスペクションタブでリファレンスドキュメントをプレビューします。
Jupyter ノートブックのデバッグコード
PyCharm は、ローカルカーネルとリモート Jupyter サーバーカーネルの両方に Jupyter Notebook デバッガーを提供します。
選択したセルにブレークポイントを設定し、ノートブックのツールバーで
をクリックします。または、セルを右クリックしてコンテキストメニューからを選択することもできます。Jupyter Notebook デバッガーツールウィンドウが開きます。
ステップツールバーボタンを使用して、次に停止する行を選択します。
デバッグは単一のコードセル内で実行されます。ただし、コードセルがすでにデバッグされているセルから関数を呼び出す場合は、そのセルにステップインできます。関連するブレークポイントも機能します。関数を含むセルは、実行されるだけでなく、デバッグされる必要があることに注意してください。
同様に、同じプロジェクト内にある Python ファイルから呼び出される関数にステップインすることもできます。
セルの実行を完了するためのデバッグ手順に進みます。
ステップアクション
項目 | ツールチップとショートカット | 説明 |
|---|---|---|
デバッガーツールバーで使用可能なアクション。 | ||
| ステップオーバー F8 | このボタンをクリックすると、現在のメソッドまたはファイルの次の行までプログラムが実行され、現在の実行ポイントで参照されているメソッド (存在する場合) はスキップされます。現在の行がメソッドの最後の行である場合、その行までの実行ステップはこのメソッドの直後に実行されます。 |
| ステップイン F7 | デバッガーを現在の実行ポイントで呼び出されたメソッドにステップインさせるには、このボタンをクリックします。 |
| 自分のコードにステップイン Alt+Shift+F7 | このボタンをクリックすると、ライブラリソースへのステップをスキップし、自分のコードに集中できます。 |
| ステップアウト Shift+F8 | このボタンをクリックすると、デバッガーが現在のメソッドから抜け出し、直後に実行される行に移動します。 |
デバッガーツールバーの | ||
| 強制ステップオーバー Alt+Shift+F8 | 現在のコード行をステップオーバーし、ハイライトされた行にメソッド呼び出しが含まれている場合でも、次の行に移動します。呼び出されたメソッドにブレークポイントがある場合、それらは無視されます。 |
| 強制ステップイン Alt+Shift+F7 | このメソッドをスキップする場合でも、現在の実行ポイントで呼び出されたメソッドにデバッガーをステップインさせるには、このボタンをクリックします。 |
| スマートステップイン Shift+F7 | 1 行に複数のメソッド呼び出しがあり、どのメソッドを入力するかを具体的に指定したい場合は、スマートステップインが役立ちます。この機能を使用すると、関心のあるメソッド呼び出しを選択できます。 |
| カーソル位置まで実行 Alt+F9 | このボタンをクリックすると、プログラムの実行が再開され、実行ポイントがエディターの現在のキャレット位置の行に到達するまで一時停止します。ブレークポイントは必要ありません。実際には、キャレットの現在の行に一時的なブレークポイントが設定されており、プログラムの実行が一時停止されると削除されます。キャレットがすでに実行された行に配置されている場合は、以前のブレークポイントにロールバックする方法がないため、プログラムはさらに実行するために再開されます。このアクションは、メソッドシーケンスの深いところまでステップインし、一度に複数のメソッドからステップアウトする必要がある場合に特に便利です。 指定された行に移動する前に実行する必要がある行にブレークポイントが設定されている場合、デバッガーは最初に検出されたブレークポイントで一時停止します。 |
| カーソル位置まで強制実行 Ctrl+Alt+F9 | キャレットの位置に達するまで実行を継続します。途中のブレークポイントはすべて無視されます。 |
| 実行ポイントの表示 Alt+F10 | このボタンをクリックすると、エディターで現在の実行ポイントがハイライトされ、対応するスタックフレームがフレームペインに表示されます。 |
| 式の評価 Alt+F8 | このボタンをクリックして、式を評価します。 |
をクリックすると、追加のステップアクションを利用できます。
関連ページ：
Jupyter ノートブックのサポート
PyCharm で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを編集、実行、デバッグし、ストリームデータ、イメージ、その他のメディアを含む実行出力を調べることができます。PyCharm での Notebook のサポートは次のとおりです。コーディング支援: エラーと構文のハイライト。コード補完。行コメントを作成する機能。、Python コンソールで IPython コマンドを実行する機能。専用 Jupyter Notebook デバッガー。Jupyter ノートブ...
Jupyter ノートブックサーバーの管理
PyCharm では、次のサーバータイプを使用してコードセルを実行できます。デフォルトサーバー – 現在のプロジェクトのために PyCharm によって自動的に起動される Jupyter サーバー。PyCharm を閉じると終了します。外部サーバー – URL とトークンを指定して接続する Jupyter サーバーであればどれでも使用できます。ローカルマシンでもリモートマシンでも実行できます。外部 Jupyter サーバーを追加へまたは、プロジェクトディレクトリを右クリックし、コンテキストメニューか...
変数の管理ポリシーのロード
PyCharm のデバッグモデルでは、変数の値をロードするための 3 つのポリシーが提供されています。同期: 変数はまとめてロードされます。非同期: 変数は別々にロードされます。オンデマンド: 変数はユーザーの要求に応じてロードされます。デフォルトでは、変数は非同期にロードされます。ロードポリシーを変更するには、デバッグツールダイアログボックスのツールバーでクリックし、に移動して、リストからターゲットポリシーを選択します。ロードポリシーの変更は、デバッグプロセスを再実行した後に有効になることに...
出力の操作
コードセルを実行すると、その出力が以下に示されます。結果を保存したり、出力をクリアしたりできます。セルの出力を展開したり折りたたんだりすることで、ノートブックの長さを管理できます。セル出力を展開または折りたたむセル出力の横にあるガター内のセルハンドルをクリックします。出力セルのスクロールを無効にする出力セルを右クリックします。出力のスクロールオプションを無効にします。行数を制限せずに出力全体が表示されます。プロットを操作する：プロットをイメージとして保存する出力を右クリックし、コンテキストメニ
ブレークポイント
ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類：PyChar
中断されたプログラムを調べる
デバッガーセッションが開始されると、デバッグツールウィンドウが表示され、次のいずれかが発生するまでプログラムが正常に実行されます。ブレークポイントがヒットしました、プログラムを手動で一時停止する、その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。フレームを調べる：プログラムの状態はフレームで表されます。プログラムが一時停止すると、現在のフレームスタックがデバッグツールウィンドウのフレームタブに表示されます。フレームはアクティ