QuPath 0.7を起動しても、手元のCZIや全切片画像だけ開けない。あるいはarm64版を選んだ後に、既存の拡張機能やスクリプトが動かない。
今週は、Apple Silicon Macならまずarm64版を試し、代表的な切片形式で失敗したらIntel版をRosetta経由で残してください。形式や研究メンバーの環境が複雑なら、arm64とIntelを分離して使うのが安全です。移行前に実データで回帰確認を終えるまで、片方だけに統一しないでください。
01対象になる研究者
病理学・生物医学分野の研究生で、低コストに全切片画像を閲覧・注釈付けしたい人に向いています。Macを持たず、遠隔のmacOS環境でQuPath 0.7を使いたい場合も対象です。
また、複数の顕微鏡形式を扱う画像解析担当者や、研究室向けに再現可能な環境を用意する技術支援担当者にも役立ちます。単にアプリを起動できるかではなく、読み込み、拡大縮小、注釈、バッチ処理、成果物の回収まで確認する記事です。
最後に確認できた公式情報では、QuPath公式サイトはv0.7.0を安定版として掲載し、macOS向けにIntel版とApple Silicon版を提供しています。Apple Silicon用パッケージはbeta表記で、安定版インストール文書にもBio-Formats関連の対応範囲が記載されています。公式サイトの配布状況と公式リリースページを基準に判断してください。
最終確認日：2026年9月5日。情報はQuPath公式サイト、v0.7.0リリースページ、安定版インストール文書を照合しています。公式のLatest表示、Apple Silicon版のbeta表記、形式対応の説明が変わった場合は、再確認が必要です。
02形式互換性の判定
Apple Silicon版を止める条件
Apple Silicon Macがあるからといって、arm64版を長期採用できるとは限りません。最初に調べるべきなのはCPUではなく、研究室にあるスライドの出所、拡張子、圧縮方式、読み込みバックエンドです。
通常のTIFFだけで判断すると危険です。実際に使うCZI、SVS、OME-TIFFなどを代表サンプルとして揃え、QuPath公式の画像形式説明と照合してください。形式名が同じでも、圧縮方式や内部メタデータの違いで挙動が変わる場合があります。
Apple Silicon版のBio-Formats経路には公式に制限が示されています。そのため、JPEG-XR圧縮を含むCZIなど、研究室固有のファイルがarm64版で読み込めない可能性があります。ここは一般論で済ませず、対象ファイルで判定してください。
Apple Silicon Macではarm64版とIntel版のどちらを先に試すべきですか。
まずarm64版を試します。ただし、代表的な切片で読み込み、ピラミッド階層の切り替え、チャンネル表示、倍率情報や対物情報などのメタデータ確認が一つでも失敗したら、Intel版を検証します。arm64版を使えることより、研究データを欠落なく扱えることを優先してください。
実データの合否基準
次の順番で同じファイルを確認します。
- ファイルを開き、エラーや空画像にならないこと。
- 全体表示から局所拡大へ移動し、画面が正しく更新されること。
- 複数チャンネルを表示し、色や順序が研究上の期待と一致すること。
- スケール、ピクセルサイズ、画像階層などのメタデータを確認すること。
- 注釈を保存し、再度開いたときに位置と形状が保たれること。
- 画像解析の測定列やオブジェクト情報が欠落しないこと。
どれか一つでも主要工程に失敗したら、arm64版単独運用は保留です。対応形式の確認が目的なら、QuPath安定版のインストール文書も併読してください。
QuPath arm64版で一部のCZI切片を開けない理由は何ですか。
CZIという拡張子だけでなく、圧縮方式とBio-Formatsを通じた読み込み経路が関係するためです。特にJPEG-XR圧縮など、Apple Silicon版で制限対象になり得る構成では、ファイル自体が壊れていなくても読み込みに失敗することがあります。別形式へ変換する前に、Intel版で同じ原本を確認してください。
03アーキテクチャと実行条件
Apple Silicon上では、Intel版をRosettaで実行できます。RosettaはIntel向けアプリをApple Silicon上で動かすためのmacOS機能です。必要になった場合の導入条件や動作は、AppleのRosetta公式説明で確認できます。
ただし、アプリ名だけを見ていると、どちらのバイナリで測定したのか分からなくなります。QuPathのアプリ情報でアーキテクチャを確認し、arm64版とIntel版を別フォルダに置いてください。プロジェクト、拡張機能、設定ファイルを同じ場所で共有すると、再現条件を崩す原因になります。
QuPath Intel版をApple Siliconで使う場合、Rosettaは必要ですか。
Intel向けアプリをApple Silicon Macで動かす場合は、Rosetta経由の実行になります。macOSからインストールを求められたときは、研究室の管理ポリシーに従って導入してください。Rosettaで動くことと、すべての拡張機能や形式が正常に動くことは別なので、必ず実データで確認します。
04拡張機能とバッチ処理
QuPath本体が起動しても、研究プロジェクトを移行できるとは限りません。課題で使う拡張機能、Groovyスクリプト、モデルファイル、外部コマンドを一覧化し、arm64版とIntel版で読み込み状態を確認します。
深層学習を使う場合は、モデル形式や推論経路も別に検証します。QuPathのDJL関連文書を参照し、モデルが読み込めるかだけでなく、同じ入力に対して測定列と出力オブジェクトが期待どおり生成されるかを見てください。GPU対応を前提に処理時間を判断する場合は、公式GPU説明の対象範囲も確認します。
arm64版とIntel版を同時にインストールできますか。
分離したアプリ名、設定場所、プロジェクト複製を用意すれば、両方を検証用に保持できます。ただし、同一プロジェクトを直接交互に編集する運用は避けてください。読み込み結果、拡張機能、保存形式を比較する際は、原本を読み取り専用で保管し、作業用コピーを版ごとに作成します。
最小のバッチ確認では、代表画像を開く、対象領域を指定する、測定を実行する、結果を書き出す、という流れを使います。コマンドライン実行を組み込む場合は、QuPath公式コマンドライン文書の引数と実行条件に合わせてください。
05遠隔操作と再現性
遠隔Macで試す場合、QuPathの計算性能と画面転送の滑らかさを分けて評価します。VNCの表示遅延だけで「arm64版は遅い」と結論づけてはいけません。ホスト側の画像読み込み、操作側への画面転送、保存先への書き込みは別の要因です。
検証には同じ遠隔Mac、同じ画像コピー、同じ操作順序を使います。初回起動、全体表示からの連続ズーム、領域注釈、検出プレビュー、プロジェクト切り替え、結果の書き出しを両方で実行してください。画面が止まった場合は、アプリの処理待ちなのか、VNCの更新遅延なのかを切り分けます。
研究データを扱う場合は、実データをそのまま外部環境へ置かないでください。学校や研究機関の承認、脱識別化、アカウント権限、保存期間、ログアウト手順を確認します。研究用途であることだけを理由に、臨床診断上の利用や規制要件を満たすとは判断できません。
遠隔環境を短期間だけ用意するなら、VpsMeshのMacレンタル案内で接続方式と利用条件を確認し、脱識別化したサンプルで先に検証してください。
06今週の受け入れチェック
次の項目をすべて実行し、結果をarm64版、Intel版ごとに記録します。
- [ ] 研究室で使う代表的な切片形式と圧縮方式を一覧化する。
- [ ] 原本を読み取り専用で保存し、版ごとの作業コピーを作る。
- [ ] 全体表示、局所ズーム、チャンネル表示、メタデータ読み込みを確認する。
- [ ] QuPath拡張機能、Groovyスクリプト、モデルファイルの読み込み状態を確認する。
- [ ] 最小のバッチ処理を実行し、測定列と出力オブジェクトを比較する。
- [ ] 遠隔接続の切断と再接続後に、プロジェクトと結果を回収できるか確認する。
- [ ] arm64版とIntel版のどちらで処理したかをログに残す。
- [ ] 主要形式が片方でしか動かない場合、単一版への移行を停止する。
全形式とツールチェーンが通過した場合はarm64版を基本にできます。重要な形式だけIntel版で通る場合は、Intel版を残します。形式、拡張機能、共同研究者の環境が分かれる場合は、両方を隔離して使う方が移行事故を抑えられます。
07研究環境の選び方
長期的に同じ高負荷処理を続け、物理ストレージや専用周辺機器が必要なら、研究費で管理できる実機の方が適しています。一方、購入前の互換性確認、学期中だけの解析、共同研究先の形式検証では、短期の遠隔Macで先に合否を出す方が無駄を抑えやすいです。
実験室にMacがなくても、まず脱識別化した全切片画像と常用スクリプトを用意し、arm64版とIntel版を同じ条件で試してください。検証後に長期レンタル、研究室での実機導入、両バージョンの維持を選べば、CPU名だけで環境を固定する失敗を避けられます。
LinuxやWindows中心の設備だけで進める場合、macOS固有の読み込み経路、Rosetta実行、QuPath拡張機能の組み合わせを事前に確認できません。購入前の短期検証なら、VpsMeshのように遠隔の実機Macへ接続して試す方が、別のOS上で推測するより判断材料を得やすいです。必要ならApple Silicon向けMacの利用条件も確認し、実際の研究ワークフローが通った場合だけ長期運用へ進めてください。