ページ発生しうるエラー · 29 / 29

発生しうるエラーと対処法

QuantCraft IDE で遭遇しうる一般的なエラーと、その解決方法です。このページは、さらに多くの問題が文書化されるにつれて拡充されます。パッケージのインストール全般については、依存関係を参照してください。

エラー索引

パッケージのインストール: 「a file it ships is in use」
パッケージのインストール: 「pip metadata is missing」/「broken install」
バックテスト: 「User script must define callable: …」
バックテスト: 「No bars in the selected date range after warmup filter …」
バックテスト: 「A screener symbol source needs an explicit start and end date …」
Debug Test: 「Debug test doesn't support a Screener symbol source …」

パッケージのインストール: 「a file it ships is in use」

表示される内容

IDE Packages からのパッケージのインストールが、次のメッセージで失敗します。

Package install failed (polars): Could not install 'polars' — a file it ships is in use
(a compiled extension like this is loaded by the editor's background workers, so pip
can't replace it). Quit QuantCraft to release the file, reopen it, and install again.
Pinning an exact version that is already installed avoids the overwrite.

その裏では、pip が IDE の Python 環境内のコンパイル済み拡張(_polars_runtime.pyd のような .pyd、.so、.dll ファイル)で、Windows では [WinError 5] Access is denied、macOS / Linux では [Errno 13] Permission denied に遭遇しています。

発生する理由

一部のパッケージ(polars、numpy、pyarrow などのネイティブライブラリ)には、パッケージのインポート時にメモリへ読み込まれるコンパイル済み拡張が含まれています。IDE のバックグラウンドワーカーは、オートコンプリートや解析のためにインストール済みパッケージをインポートし、そのファイルを読み込みます。現在読み込まれているファイルは上書きできないため、pip がインストールやアップグレード中にそれを置き換えようとすると、オペレーティングシステムがブロックします。

そのため、最新バージョンをインストールするときは発生しますが(pip が読み込み済みのファイルを上書きする必要があるため)、すでにインストール済みのバージョンを固定する場合は発生しません(pip は変更するものがないと判断し、そのファイルを完全にスキップするため)。

対処方法

QuantCraft を完全に終了します — ファイルを開いたままにしているバックグラウンドの Python ワーカーが終了します。
QuantCraft を再度開きます。
パッケージをもう一度インストールします。できれば、それをインポートするスクリプトを開いたり実行したりする前に行ってください。

ヒント:

パッケージがすでにインストールされていて動作している場合、再インストールは不要なことがよくあります。
すでにインストール済みの正確なバージョンを固定する(例: polars==1.41.2)と、上書きを避けられ、再起動なしで成功します。

パッケージのインストール: 「pip metadata is missing」/「broken install」

表示される内容

Could not install 'somepkg' (pip metadata is missing). Try installing again to force a
clean copy, or quit QuantCraft, delete the ide-venv folder, and restart the app.

または Could not install 'somepkg' (broken install).

発生する理由

以前のインストールまたはアンインストールが中断され、パッケージが中途半端にインストールされた状態になったため、pip がどのファイルを所有しているかの記録を見つけられません。

対処方法

IDE Packages からパッケージをもう一度インストールします。通常、これでクリーンなコピーが強制されます。
それでも失敗する場合は、QuantCraft を終了し、メッセージに表示されている ide-venv フォルダを削除して、再起動します。アプリが環境を再作成します。その後、追加のパッケージを再インストールしてください。

バックテスト: 「User script must define callable: …」

戦略ファイルに必須のコールバック(on_init、on_bar、on_tick、on_finish)のいずれかが欠けているか、関数になっていません。Test ボタンは on_init / on_bar / on_finish のみを確認するため、on_tick の欠落が通常の原因です。不要な場合は次を追加してください。

def on_tick(bar_index, tick_in_bar, price, bar, symbol=None):
    pass

戦略のライフサイクルを参照してください。

バックテスト: 「No bars in the selected date range after warmup filter …」

開始日/終了日の範囲に、クロック銘柄のローソク足がありません。たとえば、週末のみの範囲、銘柄の取引開始前の日付、利用可能なデータを超える範囲などです。日付の範囲を広げるか、銘柄を確認してください。QuantCraft(B2)フィードでは、代わりに No AAPL bars (d) between … Available range is … to … と表示され、有効な範囲が分かります。OHLCV とバーデータを参照してください。

バックテスト: 「A screener symbol source needs an explicit start and end date …」

Symbol source が Screener のバックテストは、バーを読み込む前に日付範囲からリバランスのスケジュールを決定するため、両方の日付が必要です。Simulation タブで Start と End を設定してください。スクリーナーを参照してください。

Debug Test: 「Debug test doesn't support a Screener symbol source …」

Debug Test は固定の銘柄リストを実行します。Symbol source を Selected symbols に切り替え、スクリーンが返したティッカーのうち 1 つか 2 つを選んで、それらでデバッグしてください。デバッグを参照してください。

読了 2 分編集を提案 ↗