QuPath 0.7 для Mac: arm64 или Intel — руководство по исследованиям 2026

Открытие CZI завершается ошибкой или проект ведёт себя иначе после переноса на Apple Silicon.

Самое быстрое решение: начните с arm64 на Apple Silicon, но сохраните Intel через Rosetta, если хотя бы один рабочий формат зависит от неподдерживаемой в arm64 цепочки Bio-Formats. При сложных форматах установите обе версии изолированно и переносите проект только после проверки реального задания.

Кому нужен этот разбор

Эта статья предназначена для аспирантов по патологии и биомедицине, которым нужно недорого просматривать и размечать полноразмерные изображения на Mac или удалённой macOS-системе.

Она также полезна специалистам лабораторий с несколькими форматами микроскопических файлов и техническим сотрудникам, которым требуется воспроизводимая среда QuPath на удалённом Mac.

Последнее обновление: 5 сентября 2026 года. Сведения о версии, пакетах macOS и ограничениях Bio-Formats сверены с официальным сайтом QuPath, документацией по установке и релизом QuPath 0.7.0.

Почему выбор QuPath 0.7 для Mac нельзя сводить только к чипу

На Mac с Apple Silicon логично сначала проверять arm64. Эта сборка соответствует архитектуре компьютера и является естественной отправной точкой. Однако официальный установочный документ помечает пакет Apple Silicon как beta и отдельно описывает границы поддержки файлов через Bio-Formats. Поэтому название процессора не является достаточным критерием.

На практике есть три маршрута:

arm64 — если все рабочие форматы, расширения и скрипты проходят проверку;
Intel — если критически важный формат или инструмент работает только в Intel-среде;
две версии — если в одном проекте смешаны обычные изображения, сложные контейнеры, старые расширения или разные требования участников.

Intel-сборка может запускаться на Apple Silicon через Rosetta. Документация Apple о Rosetta объясняет, что этот слой нужен для запуска приложений, собранных под Intel. Он не превращает Intel-версию в arm64 и не устраняет ограничения самого приложения. Поэтому результаты теста нужно записывать вместе с точным названием запущенной версии.

Проверьте это до сравнения:

Откройте папку «Программы».
Переименуйте приложения явно: QuPath-0.7-arm64 и QuPath-0.7-Intel.
Запускайте только одну версию за раз.
Зафиксируйте архитектуру в журнале испытаний.
Не открывайте один и тот же проект из двух процессов одновременно.

Так вы не перепутаете скорость запуска, состояние расширений и результаты скрипта.

Проверка форматов: первый критерий остановки

Apple Silicon и Intel: почему CZI может вести себя по-разному

Сначала составьте список файлов, которые действительно используются в лаборатории. Укажите производителя сканера, расширение, тип сжатия, наличие пирамидальных уровней, каналов и метаданных. Обычный TIFF не может заменить контрольный образец CZI, OME-TIFF или другого формата, который поступает от конкретного сканера.

Официальное описание форматов QuPath нужно использовать как основу, но не как замену проверке ваших файлов. Важна не только возможность открыть контейнер. Нужно проверить, что после чтения доступны нужные уровни масштаба, каналы, сведения о сканировании и координаты объектов.

В отдельных случаях JPEG-XR-сжатые CZI могут зависеть от пути чтения, который не поддерживается arm64-сборкой так же, как Intel-сборкой. Это не означает, что любой CZI требует Intel. Это означает, что конкретный файл с конкретным сжатием нельзя исключать из теста.

Если arm64 не открывает критически важный образ, останавливайте переход на одну arm64-версию. Не пытайтесь компенсировать проблему более быстрым интернетом или настройкой VNC: ошибка чтения возникает на стороне QuPath и библиотек формата.

Как проверить Bio-Formats без ложного вывода

Для каждого представительного файла выполните одинаковую последовательность:

открыть изображение с чистого запуска QuPath;
приблизить и отдалить изображение через несколько уровней;
проверить отображение каналов;
прочитать основные метаданные;
выделить небольшой участок;
закрыть файл и открыть его повторно;
сохранить результат или проект в отдельную тестовую папку.

Критерий «прошло» должен быть бинарным. Если изображение открылось, но отсутствует канал, неверно отображается масштаб или теряются метаданные, формат не считается совместимым для рабочей миграции.

Важно: форумная жалоба или отдельная запись в GitHub Issue — это только линия для проверки. Она не доказывает, что все CZI, все версии сжатия или все компьютеры будут вести себя одинаково.

Пять шагов для контрольного набора

Соберите копии, а не оригиналы лабораторного архива.
Выберите по одному файлу каждого реально используемого типа.
Запишите расширение, сжатие, размер и источник файла в журнале.
Повторите операцию в arm64 и Intel-среде.
Сохраните скриншоты ошибок и экспортированные результаты рядом с журналом.

Размеры файлов и время операций записывайте как данные вашего эксперимента. Не подменяйте их усреднёнными значениями из чужих проектов.

Производительность нужно оценивать по рабочей операции

Быстрый запуск приложения сам по себе не решает задачу патоморфолога. Важнее, как ведут себя панорамирование полноразмерного среза, выделение области, предварительный просмотр детекции и переключение проектов.

Сравнивать нужно на одном удалённом Mac, с одной копией изображения и одинаковым сетевым маршрутом. Если arm64 тестируется через одну сессию VNC, а Intel — через другую, задержка экрана может быть ошибочно принята за разницу архитектур.

Порядок сравнения:

Запустите arm64 и дождитесь полной готовности проекта.
Откройте один и тот же контрольный срез.
Выполните одинаковые действия масштабирования и перемещения.
Создайте тестовую разметку в отдельной копии.
Запустите предварительный анализ на ограниченной области.
Переключитесь на второй проект.
Повторите последовательность в Intel-сборке.
Запишите не только время, но и сбои, зависания, артефакты отображения и необходимость повторного запуска.

Не используйте неподтверждённые обещания вроде «arm64 быстрее в несколько раз». Официальная документация QuPath по GPU описывает поддержку графических вычислений, но наличие GPU не превращает любую операцию просмотра или анализа в одинаково ускоренную. Сначала определите, какая именно часть вашего процесса использует вычисления, а какая зависит от декодирования файла, памяти и передачи изображения по сети.

Расширения, скрипты и проекты: проверка переносимости

QuPath arm64 и x64 можно ли держать одновременно

Да, две версии можно использовать параллельно, если вы разводите каталоги приложения, тестовые проекты и настройки. Не открывайте один проект на запись из обеих версий. Для сравнения создайте две копии проекта с понятными именами.

Проверьте отдельно:

список расширений и их состояние после запуска;
версии Groovy-скриптов;
модели и конфигурационные файлы;
внешние команды, вызываемые из сценариев;
названия измерений и столбцов в экспортируемой таблице;
наличие созданных объектов после повторного открытия проекта.

Руководство QuPath по командной строке пригодится, если пакетная обработка запускается без постоянного ручного управления интерфейсом. Для моделей машинного обучения отдельно сверяйте требования расширений и загрузчиков: документация QuPath по DJL не заменяет тест конкретной модели в вашей среде.

Минимальный тест скрипта должен:

открыть контрольное изображение;
создать хотя бы один измеряемый объект;
выполнить одну нужную операцию анализа;
сохранить результат;
вывести ожидаемые столбцы;
завершиться без ручного исправления путей.

Если arm64 запускает скрипт, но меняет структуру результата, переход нельзя считать завершённым. Сравнивайте не только факт запуска, но и итоговый CSV, проект и набор объектов.

Удалённый Mac: отделяйте чтение данных от качества экрана

В удалённой среде есть два разных процесса. Первый — чтение и анализ изображения на хосте. Второй — передача кадров интерфейса через VNC или веб-консоль. Низкая плавность курсора не доказывает, что QuPath медленно обрабатывает изображение.

Для удалённого рабочего процесса проверьте:

доступ приложения к каталогу проекта;
права чтения исходных файлов;
права записи результатов;
отключение и повторное подключение сессии;
экспорт небольшой контрольной области;
передачу результата на локальный компьютер;
отсутствие путаницы между временным каталогом и постоянным хранилищем.

Во время испытания используйте обезличенные образцы. Для ограниченных патологических данных заранее согласуйте с университетом правила доступа, место хранения, журналирование и удаление временных копий. Исследовательская цель сама по себе не является разрешением на загрузку клинических данных в удалённую среду.

Если лаборатории нужен временный стенд, полезно заранее изучить варианты аренды Mac для исследовательской работы. Это не отменяет внутреннего согласования данных. Зато позволяет проверить реальный интерфейс, расширения и скрипты до покупки оборудования.

Контрольный список перед окончательным выбором

[ ] Составлен список всех форматов, которые используются в текущем проекте.
[ ] Для каждого формата подготовлена обезличенная контрольная копия.
[ ] Открытие, масштабирование, каналы и метаданные проверены в arm64.
[ ] Та же последовательность повторена в Intel-версии через Rosetta.
[ ] В журнале указано точное имя и архитектура приложения.
[ ] Рабочие расширения проверены в обеих средах.
[ ] Представительный Groovy-скрипт выполнил минимальную пакетную задачу.
[ ] Старый проект проверен только на копии.
[ ] Экспортированные измерения сопоставлены по именам и значениям.
[ ] Проверены отключение, повторное подключение и возврат результатов.
[ ] Для ограниченных данных согласованы обезличивание и права доступа.
[ ] Определено условие остановки миграции на arm64.

Три маршрута для проекта QuPath 0.7

Ниже приведены не обещания производительности, а рабочая схема принятия решения. Она помогает связать результат проверки с конкретным действием.

Результат проверки	Подходящая архитектура	Следующий шаг
Все форматы, расширения и скрипты проходят	arm64	Зафиксировать версию и сохранить журнал
Ключевой формат или инструмент проходит только в Intel	Intel через Rosetta	Изолировать Intel-среду и не менять проект без регрессии
Форматы и участники проекта неоднородны	arm64 + Intel	Разделить каталоги, проекты и правила запуска
Неясно, где возникает ошибка	Обе версии временно	Повторить тест на одном файле и одной операции

Отдельно учитывайте цену ошибки. Если проект содержит сотни разметок и пакетный экспорт, неудачный перенос может стоить больше, чем короткая проверка двух сборок. Если же вы работаете только с одним гарантированно совместимым форматом, двойная установка может оказаться лишней.

Объект проверки	Что записать	Условие прохождения
Файл	Формат, сжатие, источник	Открывается без предупреждения, влияющего на результат
Масштаб	Панорамирование и уровни увеличения	Нет пропусков, зависаний и неверной геометрии
Каналы	Названия и отображение	Каналы соответствуют исходному файлу
Метаданные	Ключевые сведения о сканировании	Данные доступны после повторного открытия
Скрипт	Команда, вход и выход	Результат совпадает по структуре
Проект	Копия старой работы	Объекты и измерения сохраняются
Удалённый доступ	Обрыв и повторный вход	Работа продолжается без повреждения результата

Для краткого испытания выбирайте среду, где вы получаете полный доступ к macOS, а не только к отдельному приложению. Описание удалённого Mac для исследовательских задач поможет оценить формат доступа, прежде чем переносить рабочие данные.

Ситуация	Решение	Что не следует делать
Один простой формат и новые расширения	Начать с arm64	Сразу удалять Intel до завершения проверки
JPEG-XR CZI или неизвестная цепочка чтения	Сначала сравнить arm64 и Intel	Делать вывод по обычному TIFF
Старый проект и пакетные скрипты	Использовать две изолированные среды	Перезаписывать исходный проект
Удалённый тест перед закупкой	Взять короткий доступ к удалённому Mac	Оценивать QuPath только по плавности VNC
Долгая стабильная нагрузка	Сравнить аренду с собственным Mac	Игнорировать хранение и правила доступа

Итог: arm64, Intel или две версии

Для Apple Silicon начинайте с arm64, но принимайте окончательное решение только после проверки настоящих файлов, расширений и скриптов. Intel через Rosetta остаётся рабочим резервом, если критичная цепочка Bio-Formats или старый инструмент не проходит на arm64. При неоднородных форматах и совместной работе безопаснее держать две версии изолированно.

Перед долгосрочной закупкой или постоянным развёртыванием подготовьте обезличенный набор срезов и сценарий пакетной обработки. Короткая проверка на удалённом Mac позволит сравнить arm64 и Intel в тех же действиях, которые вы выполняете в лаборатории. После успешной регрессии можно решать, нужна ли постоянная аренда, собственный компьютер или двойная конфигурация.

Покупка Mac оправдана, если нагрузка постоянная, данные нельзя выносить из инфраструктуры университета или требуются физические устройства и локальные накопители. Но временная установка на Linux или Windows не решает проблему macOS-совместимости, а обычный облачный сервер не заменяет реальную Mac-среду. Для разовой проверки форматов, подготовки статьи или миграции проекта аренда VpsMesh обычно практичнее: вы получаете доступ к полноценной macOS-системе без преждевременной покупки оборудования и можете сначала подтвердить, какая архитектура действительно проходит ваш QuPath-процесс.