Jupyter ノートブックのサポート
PyCharm で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを編集、実行、デバッグし、ストリームデータ、イメージ、その他のメディアを含む実行出力を調べることができます。
PyCharm での Notebook のサポートは次のとおりです。
コーディング支援:
Python コンソールで IPython(英語) コマンドを実行する機能。
Jupyter ノートブックを使った基本操作のためのショートカット。
.ipynb ファイルを認識し、
アイコンでマークする機能。Jupyter プロジェクトテンプレート。
Jupyter 固有の AI 機能。
始める前に
Jupyter Notebook のすべての機能が正常に動作するには、設定 | プラグインページの「インストール済み」タブで Markdown プラグインが有効になっていることを確認してください。詳細については、プラグインのマッピングを参照してください。
クイックスタート
PyCharm で Jupyter ノートブックの使用を開始するには:
Jupyter プロジェクトを作成します。
.ipynb ファイルを開くか作成します。
追加および編集ソースセル
いずれかのコードセルを実行して、Jupyter サーバーを起動します。
ユーザーインターフェースに慣れる
Jupyter ノートブックツールバー
Jupyter ノートブックツールバーを使用すると、ノートブックのすべての基本操作にすばやくアクセスできます。
アクションを追加、削除、並べ替えることでツールバーをカスタマイズできます。
ノートブックツールバーの
詳細をクリックします。以下のいずれか 1 つを実行します:
ツールバーのカスタマイズを選択し、リストからアクションを選択します。ツールバーに追加されます。
を選択すると、追加のアクションを追加または削除できるダイアログが開きます。詳細については、メニューおよびツールバーを参照してください。
項目 | 説明 |
|---|---|
下のコードセル | 選択したセルにコードセルを追加します。 |
セルを上に移動 | 現在のセルを上に移動します。 |
セルを下に移動 | 現在のセルを下に移動します。 |
セルを実行して下を選択 | このセルを実行し、下のセルを選択します。下にセルがない場合は、PyCharm によって作成されます。 |
すべて実行 | ノートブックのすべてのセルを実行します。 |
カーネルを再起動 | このアイコンをクリックして、現在実行中のカーネルを再起動します。 |
すべての出力をクリア | ノートブック内のすべての出力をクリアします。 |
Gist を作成 | Gist を作成ダイアログを開きます。 |
| このウィジェットをクリックすると、最後に実行されたセルに移動します。 |
| 現在使用されている Jupyter サーバーを表示します。このウィジェットをクリックして を選択すると、別のローカルサーバーまたはリモート Jupyter サーバーがセットアップされます。 |
Jupyter コンソールを開く | Jupyter ツールウィンドウの Jupyter コンソールタブを開きます。このボタンは、現在のノートブックに対して Jupyter サーバーを起動すると有効になります。 |
追加アクション | |
セルタイプセレクター | 選択したセルの種類を表示します。クリックして別の種類を選択し、それに応じてセルを変換します。 |
セルを削除 | 現在のセルを削除します。 |
セルのデバッグ | 選択したセルのデバッグを開始します。 |
上のセルを選択 | 上のセルを選択します。 |
下のセルを選択 | 下のセルを選択します。 |
ブラウザーでノートブックを開く | 現在のノートブックをブラウザーで開きます。 |
セル
セルには、コードまたは Markdown テキストのいずれかが含まれます。コードセルを実行すると、コード実行の結果であるセル出力を表示できます。
各セルには独自のツールバーが含まれており、重要なアクションにすばやくアクセスできます。
セルツールバーは次の要素で構成されます。
ツールバーで直接実行できるアクション。
コンテキストメニューの追加アクション。コンテキストメニューを開くには、セルツールバーの
をクリックします。
ツールバーとコンテキストメニューで使用できるアクションは、セルの種類によって異なります。
項目 | 説明 |
|---|---|
ツールバーアクション | |
| コードの提案や改善について AI による支援を受けられます。 |
| セル内のコードをデバッグします。 |
| 現在のセルを削除します。 |
コンテキストメニューのオプション | |
セルの上を実行 | 現在のセルの上のセルを実行します。 |
セル以下を実行 | 現在のセルとその下のセルを実行します。 |
セルを上に移動 | 現在のセルを上に移動します。 |
セルを下に移動 | 現在のセルを下に移動します。 |
上のセルをマージ | 現在のセルを上のセルと結合します。 |
下のセルをマージ | 現在のセルをその下のセルと結合します。 |
セルの分割 | キャレット位置でセルを 2 つに分割します。 |
下のセルを複製 | 現在のセルを複製し、そのコピーを下に挿入します。 |
セルをコピー | セルをコピーしてクリップボードに追加します。 |
セルを切り取る | セルを削除してクリップボードに追加します。 |
セルを Markdown に変換する | 現在のセルのタイプを Markdown に変更します。 |
セルを SQL に変換する | 現在のセルのタイプを SQL に変更します。 |
セルタグを追加 | セルを整理または管理するにはタグを追加します。 |
出力のクリア | セルの出力をクリアします。 |
AI 編集セル 項目 | 説明 |
|---|---|
ツールバーアクション | |
| コードの提案や改善について AI による支援を受けられます。 |
| 編集モードに切り替えます。 |
| Markdown セクション内のすべてのセルを実行します。 |
| 現在のセルを削除します。 |
コンテキストメニューのオプション | |
セルタグを追加 | セルを整理または管理するにはタグを追加します。 |
下のセルを複製 | 現在のセルを複製し、そのコピーを下に挿入します。 |
セルを上に移動 | 現在のセルを上に移動します。 |
セルを下に移動 | 現在のセルを 1 つ下に移動します。 |
セルをコピー | セルをコピーしてクリップボードに追加します。 |
セルを切り取る | セルを削除してクリップボードに追加します。 |
編集 項目 | 説明 |
|---|---|
ツールバーアクション | |
| コードの提案や改善について AI による支援を受けられます。 |
| セル内のコードをデバッグします。 |
| 現在のセルを削除します。 |
コンテキストメニューのオプション | |
セルの上を実行 | 現在のセルの上のセルを実行します。 |
セル以下を実行 | 現在のセルとその下のセルを実行します。 |
セルを上に移動 | 現在のセルを上に移動します。 |
セルを下に移動 | 現在のセルを下に移動します。 |
上のセルをマージ | 現在のセルを上のセルと結合します。 |
下のセルをマージ | 現在のセルをその下のセルと結合します。 |
セルの分割 | キャレット位置でセルを 2 つに分割します。 |
下のセルを複製 | 現在のセルを複製し、そのコピーを下に挿入します。 |
セルをコピー | セルをコピーしてクリップボードに追加します。 |
セルを切り取る | セルを削除してクリップボードに追加します。 |
セルを Markdown に変換する | 現在のセルのタイプを Markdown に変更します。 |
セルタグを追加 | セルを整理または管理するにはタグを追加します。 |
出力のクリア | セルの出力をクリアします。 |
セルツールバーをカスタマイズする
Ctrl+Alt+S を押して設定を開き、を選択します。
または、ツールバーの
をクリックし、セルツールバーのカスタマイズを選択します。Jupyter セルツールバーをカスタマイズするでアクションを追加または削除します。
詳細は、メニューおよびツールバーを参照してください。
変更を適用してウィンドウを閉じるには OK をクリックし、ウィンドウを開いたままにするには適用をクリックします。
Jupyter ツールウィンドウ
Jupyter サーバーのいずれかを起動すると、Jupyter ツールウィンドウが表示されます。このウィンドウのサーバータブには、Jupyter サーバーの現在の状態と、ブラウザーで表示されるノートブックへのリンクが表示されます。
また、実行中のサーバー（
）を停止したり、停止したサーバー（
）を起動したりするためのコントロールも提供されます。
Jupyter コンソール
Jupyter コンソールでは以下のコマンドを実行できます:
ノートブックツールバーの
Jupyter コンソールを開くをクリックします。このボタンは、現在のノートブックの Jupyter サーバーを起動すると有効になります。ノートブックファイルごとに 1 つのコンソールを開くことができます。コマンドまたは一連のコマンドを入力し、コンソールツールバーの
を押します。
変数タブは、実行されたセルの変数値に関する詳細なレポートを提供します。このタブは、Jupyter コンソールを起動すると自動的に開きます。
Jupyter 変数ツールウィンドウ
Jupyter 変数ツールウィンドウは、セルを実行するたびに表示されます。このウィンドウを恒久的に非表示にしたい場合は、に移動し、実行時に変数ツールウィンドウを表示するチェックボックスをオフにしてください。
Jupyter 変数ツールウィンドウでは、変数の値を表示したり、変数のリストを管理したりできます。
コードセルを再実行せずに変数のリストをリフレッシュするには、
変数のリフレッシュをクリックします。
変数を名前または型で並べ替えるには、
並べ替えをクリックし、リストから必要なオプションを選択します。
構造ツールウィンドウ
.ipynb ファイルの場合、Markdown セルと Python セルの両方を構造ツールウィンドウに表示できます。
Markdownセルは、見出しテキストをラベルとして使用して表示されます。構造ビューには、見出しを含むMarkdownセルのみが含まれます。デフォルトでは、構造ツールウィンドウ内の Markdown 見出しのみに番号が付けられます。
番号設定を構成するには、ツールウィンドウのツールバーで
をクリックし、次に見出し番号を表示をクリックします。構造ツールウィンドウに
Pythonセルを表示するには、ツールウィンドウのツールバーで をクリックし、次に Python セルを表示をクリックします。以下のいずれかのオプションを選択できます。すべて : すべてのコードセルを表示します。
コメント付き: コメントで始まるコードセルのみを表示します。コメントはセルラベルとして使用されます。
なし : コードセルを表示しません。
構造ツールウィンドウは、コードセルのクラス、関数、その他の要素を表示します。
関連ページ：
コードインスペクション
PyCharm には、プロジェクト内の異常なコードを検出して修正する一連のコードインスペクションがあります。IDE は、さまざまな問題を見つけてハイライトし、デッドコードを見つけ、考えられるバグやスペルの問題を見つけ、全体的なコード構造を改善することができます。インスペクションは、すべてのプロジェクトファイルまたは特定のスコープでのみ（たとえば、本番コードまたは変更されたファイルでのみ）コードをスキャンできます。すべてのインスペクションには、問題がコードに影響を与える可能性がある程度の重大度レベ...
コード補完
基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。候補にはライブテンプレートも含まれます。補完機能は英語以外のキーボードレイアウトでも利用できます。基本補完を呼び出すデフォルトでは、PyCharm は入力時に自動的にコード補完ポップアップを表示します。あるいは、を押すか、メインメニューからを選択することもできます。基本コード補完を 2 回呼び出すと、依存関...
ソースコードの操作
コードを使用する場合、PyCharm は作業にストレスがないことを保証します。追加、選択、コピー、移動、編集、折りたたみ、出現箇所の検索、コードの保存に役立つさまざまなショートカットと機能を提供します。エディター内のナビゲーションについては、エディターの基本を参照してください。アクションの検索使用したいアクションのショートカットを覚えていない場合は、を押して名前でアクションを見つけてください。同じダイアログを使用してクラス、ファイル、シンボルを見つけることができます。詳しくは、名前でターゲット...
Jupyter ノートブックコードセルの実行とデバッグ
ノートブックツールバーのアイコン、コードセルのコンテキストメニューと構造ツールウィンドウのコマンド、およびガターの実行アイコンを使用して、さまざまな方法でノートブックセルのコードを実行できます。コードセルを実行する：ショートカットとツールバーオプションを使用してコードセルを実行する次のスマートショートカットを使用して、コードセルをすばやく実行します。現在のセルを実行します。現在のセルを実行し、その下のセルを選択します。実行が完了すると、セルは編集モードのままになるため、必要に応じて変更
Jupyter ノートブックの作成と編集
Jupyter プロジェクトを作成するに移動します。Jupyter プロジェクトテンプレートを選択します。プロジェクトの場所を選択します。ロケーションフィールドでクリックし、プロジェクトのディレクトリを指定します。プロジェクト名は、指定されたパスのフォルダー名から自動的に取得されます。プロジェクトを Git バージョン管理下に置くには、Git リポジトリの作成を選択します。PyCharm でファイルをプロジェクトに追加する場合は、シンプルな Jupyter ノートブックを作成するを選択します。こ...
Jupyter ノートブックの AI Assistant
利用可能: PyCharm Professional および DataSpellPyCharm および DataSpell の Jupyter 固有の AI 機能を使用して、Jupyter セルとデータフレームを説明したり、新しいセルを作成したり、視覚化を生成したり、セルを編集したり、コード内のエラーを修正したりします。AI で説明：Jupyter セルを説明する Jupyter ノートブックを開き、次のいずれかを実行します。セルを右クリックしてコンテキストメニューを開きます。を押します。、AI...