PyCharm 2024.1 ヘルプ

Jupyter ノートブックサーバーの管理

PyCharm では、以下を使用してコードセルを実行できます。

  • 管理対象サーバー – 現在のプロジェクトのために PyCharm によって自動的に起動される Jupyter サーバー。PyCharm を閉じると終了します。

  • 構成済みサーバー – URL とトークンを指定して接続する Jupyter サーバー。

ローカル Jupyter サーバーを起動する

  • Jupyter サーバーを実行するには、任意のコードセルを実行するだけです。セルの実行を開始すると、PyCharm は、使用可能なポート (デフォルトでは 8888 ポート) を使用して、ローカルホスト上で Jupyter サーバーを起動します。Jupyter サーバーツールウィンドウに切り替えて、サーバーの構成の詳細をプレビューできます。

Jupyter server is running. Jupyter tool window

サーバーが起動されると、Jupyter ツールバーのサーバーのリストに管理対象サーバーとして表示されます。カーネルのリストには、自動作成されたサーバーカーネルも表示されます。このカーネルは、プロジェクト用に構成された Python インタープリターに基づいています。

Jupyter notebook toolbar; Managed server is connected

Jupyter サーバーに接続する

  1. ツール | Jupyter 接続を追加に移動します。

  2. 新しい Jupyter 接続ダイアログで、接続タイプを選択します。

    • ローカル Jupyter サーバーを開始する : ワークスペースに接続されるローカルディレクトリで Jupyter サーバーを実行します。

    • URL を使用して Jupyter サーバーに接続する : リモート Jupyter サーバーへの接続を確立します。ターゲット URL には、サーバー名またはそのアドレス、およびアクセストークン(英語)が含まれている必要があります。

    Add a remote connection to a Jupyter server

    接続が確立されると、サーバーとその構造がワークスペースツールウィンドウに表示されます。

    Remote Jupyter server in the Project tool window

Jupyter サーバーを停止する

  • 実行中のサーバーを停止するには、Jupyter サーバーツールウィンドウに切り替えて、the Stop button アイコンをクリックします。サーバーログウィンドウでステータスをプレビューします。

Stopping the server

サーバーをシャットダウンすると、現在のセッションは終了します。次回 Run server icon アイコンを使用してサーバーを起動すると、以前のすべてのセッションとすべてのノートブックの実行結果が失われます。

カーネルを再起動する

  • サーバー全体をシャットダウンしたり、他のノートブックに影響を与えたりすることなく、計算をリフレッシュしたい場合があります。現在実行中のカーネルを再起動するには、Jupyter ノートブックツールバーKernels をクリックします。その後、サーバーログウィンドウでカーネルのステータスを表示できます。

    Restarting the current kernel

特定の Jupyter サーバーでノートブックコードセルを実行できます。

管理対象サーバーを起動すると、デフォルトで現在の Python インタープリターと自動的に選択されたポートが使用されます。ただし、PyCharm インスタンスで使用可能な他のインタープリターを選択して、代替ポートを指定できます。URL とトークンがわかっている場合は、構成済みのサーバーに接続することもできます。

Jupyter サーバーを構成する

  1. Jupyter ノートブックツールバーの Jupyter サーバーのリストから Jupyter サーバーの構成を選択します。

    Configure a Jupyter server
  2. 管理サーバーを使用を選択します。デフォルトでは、サーバーは現在の Python インタープリターを使用します。必要に応じて、リストから他の利用可能なインタープリターを選択できます。

    Select an interpreter for the managed server
  3. コマンドライン引数フィールドを使用してサーバー設定を設定します。

  4. 環境変数を設定し、値を割り当てます。

    Create environment variables and assign values
  5. OK をクリックして変更を適用してダイアログを閉じるか、適用をクリックしてダイアログを開いたままにします。

  6. 任意のコードセルを実行して管理対象サーバーを実行します。

設定済みの Jupyter サーバーに接続する

  1. Jupyter ノートブックツールバーの Jupyter サーバーのリストから Jupyter サーバーの構成を選択します。

    Configure a Jupyter server
  2. 構成済みサーバーを選択し、サーバーのパスを指定します。これには、サーバーの名前またはアドレス、およびアクセストークンが含まれている必要があります。

    Configure a Jupyter server. Settings dialog
  3. OK をクリックして変更を適用してダイアログを閉じるか、適用をクリックしてダイアログを開いたままにします。

  4. 接続が確立されると、サーバーとその構造がワークスペースツールウィンドウに表示されます。

構成されたサーバーのカーネル不一致エラーを解決する

  • 次の警告が表示される場合は、新しく構成されたサーバーのカーネルが現在の Python インタープリターと一致していません。例: インストールされているパッケージの異なるセットがある場合があります。

    Warning requesting to register interpreter as a kernel

    対応するリンクをクリックすることにより、Python インタープリターを構成済みサーバーのカーネルとして登録できます。その後、構成済みサーバーのカーネルのリストで確認できます。

    Two kernels are registered for the configured server

関連ページ:

Jupyter ノートブックコードセルの実行とデバッグ

ノートブックセルのコードは、ノートブックツールバーとセルツールバーのアイコン、コードセルのコンテキストメニュー (コードセルを右クリックして開きます) のコマンド、およびメインメニューの実行コマンドを使用して、さまざまな方法で実行できます。ローカルノートブックを使用する場合、事前に Jupyter サーバーを起動する必要はありません。セルを実行するだけでサーバーが起動します。コードセルを実行する:次のスマートショートカットを使用して、コードセルをすばやく実行します。現在のセルを実行します。...

Python インタープリターを構成する

PyCharm の Python インタープリター:PyCharm で Python コードを操作するには、少なくとも 1 つの Python インタープリターを構成する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。Virtualenv、pipenv、Poetry、conda 仮想環境を作成することもできます。仮想環境は、基本インタープリターとインストールされたパッケージで構成されます。PyCharm Professional では、SSH、Vagr...

Jupyter ノートブックのサポート

PyCharm で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを簡単に編集、実行、デバッグし、ストリームデータ、イメージ、その他のメディアを含む実行出力を確認できます。PyCharm のノートブックサポートは以下を含みます: コーディング支援: エラーと構文のハイライト。コード補完。行コメントを作成する機能。、セルを実行し、実行結果をプレビューする機能。専用 Jupyter Notebook デバッガー。Jupyter ノートブックを使った基本操作のためのショー...

出力の操作

コードセルを実行すると、その出力が以下に示されます。結果を保存したり、出力をクリアしたりできます。セルの出力を展開したり折りたたんだりすることで、ノートブックの長さを管理できます。セル出力を展開または折りたたむセルカウンターの横にある矢印をクリックします。プロットの操作:プロットをイメージとして保存する出力を右クリックし、コンテキストメニューから名前を付けて保存を選択します。ダーク UI テーマを使用している場合、グラフの色はデフォルトで読みやすくなるように調整されます。この動作を変更するには...

対話的なウィジェットを使用する

PyCharm は、ノートブックカーネルで実行される Python コードとブラウザーで実行される JavaScript の間の統合を提供する対話型ウィジェットをサポートします。インタラクティブウィジェットの種類と詳細については、「Jupyter ウィジェットのドキュメント」を参照してください。Jupyter ノートブックにウィジェットコードを追加する:対話的なウィジェットをノートブックに追加するには、まずコードセルを追加します。Alt + Shift + A(Windows) または⌥⇧ A...