Chúng tôi đã mở 792 tệp tiêu bản thật và công bố mọi kết quả

Bài kiểm thử này thực sự chứng minh điều gì?

Rằng một tệp có tên cụ thể, từ một máy quét có tên cụ thể, với kích thước thật, mở được trong bản phát hành và đưa điểm ảnh lên màn hình. Không hơn và không kém. Một danh sách định dạng được hỗ trợ tuyên bố một khả năng; bài này đo lường khả năng đó. Nếu cách bố trí dữ liệu của một hãng làm bộ giải mã bó tay, tệp đó sẽ xuất hiện trong bảng thất bại kèm thông báo lỗi mà người dùng sẽ thấy, chứ không bị bỏ đi thành một dòng thiếu.

Đây là bài kiểm thử do chính nhà phát triển thực hiện — chúng tôi viết phần mềm và chúng tôi chạy bài kiểm thử. Điều khiến nó vẫn đáng đọc là bạn có thể tự kiểm chứng: các bộ dữ liệu đều công khai, trình chạy kiểm thử nằm trong kho mã desktop của chúng tôi, và kết quả thô theo từng tệp có ngay trên trang này.

Các tệp được kiểm thử như thế nào

Mỗi tệp được giao cho một tiến trình con dùng một lần; tiến trình này dựng đúng bộ nạp mà ứng dụng dựng, đọc kích thước ảnh, giải mã một mặt phẳng và chuyển đổi nó qua đúng đường hiển thị Qt mà trình xem dùng. Một tệp hỏng làm sập một codec gốc chỉ giết tiến trình con đó; tiến trình giám sát ghi lại tệp nào đang được xử lý và tiếp tục. Thiết kế đó là lý do một bài kiểm thử trên các bản quét hàng gigabyte của các hãng có thể chạy xong, và là lý do "sập" là hạng mục mà bảng này có thể trung thực báo cáo là bằng không.

• Trình chạy: slidescope-desktop/scripts/publish_format_benchmark.py — một lệnh duy nhất, trong kho mã desktop của SlideScope, chạy cả ba lượt và ghi ra đúng tệp JSON mà trang này hiển thị: python scripts/publish_format_benchmark.py --dataset <corpus> --output format-benchmark.json
• Bộ dữ liệu: bộ dữ liệu tham chiếu công khai của Open Microscopy Environment, các tiêu bản kiểm thử do OpenSlide công bố, dữ liệu kiểm thử của thư viện czitools và nd2, và các mẫu của hãng mà chúng tôi đã đối chiếu sha256 với nhà công bố.
• Phạm vi: định dạng ảnh toàn tiêu bản và định dạng hiển vi của các hãng. Các tệp TIFF đơn mặt phẳng rời rạc từ các kho dữ liệu lớn của hãng không được tính — chúng không cho biết điều gì mà một tệp TIFF WSI dạng kim tự tháp không cho biết rõ hơn.
• Ghi lại cho từng tệp: định dạng được nhận diện, bộ nạp, các chiều T/Z/C/Y/X đã giải mã, kiểu điểm ảnh, kích thước hiển thị, và khi thất bại thì loại ngoại lệ cùng thông báo hiển thị cho người dùng.

Định dạng ảnh toàn tiêu bản

Đây là các định dạng của máy quét — những tệp đến từ thiết bị Aperio, Hamamatsu, 3DHISTECH, Leica, Ventana, Akoya hoặc Agilent và thường xuyên lên tới vài gigabyte.

Định dạng hiển vi và hình ảnh y khoa

Các định dạng thu nhận đa chiều, nơi câu hỏi đáng quan tâm không phải là kích thước tệp mà là bao nhiêu kênh, mặt phẳng Z và thời điểm còn nguyên vẹn khi lên tới màn hình.

Mọi tệp không mở được, và lý do

25 trong số 792 tệp không mở được, và đó không phải một câu chuyện mà là hai. 9 tệp là giới hạn thực sự: một ảnh thật mà hiện tại chúng tôi không đọc được. 16 tệp còn lại vốn không chứa ảnh nào ngay từ đầu, nên từ chối là câu trả lời đúng. Gộp hai nhóm làm một sẽ là tô vẽ cho chúng tôi — số thất bại trung thực của lần chạy này là 9, không phải 25.

Giới hạn thực sự: 9 tệp chúng tôi không đọc được

Tất cả các tệp này đều nguyên vẹn — checksum khớp với nhà công bố — nên đây là giới hạn của bộ giải mã và của cách bố trí dữ liệu theo từng hãng, không phải mẫu bị hỏng. Chúng được giữ vĩnh viễn trong bộ dữ liệu để kiểm thử hồi quy, nhờ đó chúng tôi sẽ biết ngay ngày một tệp trong số đó bắt đầu mở được.

Quy luật nằm ở cách bố trí dữ liệu của hãng, không phải ở phương thức chụp. NDPI huỳnh quang và MIRAX huỳnh quang đều mở bình thường; chính các biến thể cấu trúc cụ thể — một SCN không có ảnh chính xác định được, một BIF có thuộc tính hướng không như dự kiến, một tệp chứa "Imaris Classic" từ thời trước HDF5 — mới là thứ các backend từ chối. Mỗi thông báo nêu rõ nguyên nhân thay vì gọi tệp là hỏng, vì trong mọi trường hợp này, tệp vẫn ổn còn chúng tôi thì chưa.

Không phải thất bại: 16 đối tượng không chứa ảnh

DICOM là định dạng tài liệu không kém gì định dạng ảnh. DICOMDIR là chỉ mục của một đĩa; presentation state ghi lại cách ai đó từng chỉnh cửa sổ cho một ca chụp; các đối tượng khác chứa báo cáo hoặc số đo. Không đối tượng nào chứa điểm ảnh. Một trình xem có mở chúng ra cũng chẳng có gì để hiển thị, nên SlideScope từ chối kèm lời giải thích — đó là hành vi đúng, được tính riêng để không làm phồng cột nào.

Nêu tên đầy đủ để không có gì bị giấu sau một hạng mục: DICOMDIR, PS_0026, PS_0108, PS_0128, PS_0154, PS_0181, XX_0027, XX_0109, XX_0155, XX_0182, XX_0183.

Trường hợp SlideScope mở được tệp nhưng hiển thị sai

Đây là kiểu thất bại quan trọng nhất và là loại mà các bảng định dạng không bao giờ thừa nhận, vì vậy đây là trường hợp của chúng tôi.

Một bản quét Akoya .qptiff đa kênh — tệp tham chiếu bảy màu Vectra — mở ra mà không báo lỗi gì cả. Tệp chứa năm trang huỳnh quang đơn kênh độ phân giải đầy đủ (DAPI, FITC, CY3, Texas Red, CY5) ở kích thước 34.560 × 24.960 trên tổng cộng 33 trang, được xác nhận độc lập bằng tifffile. SlideScope chuyển mọi tệp .qptiff cho backend OpenSlide, vốn là trình đọc trường sáng, nên nó báo cáo một kênh và trả về một lát RGB. Không truy cập được các kênh huỳnh quang và các nút điều khiển kênh không có gì để hiển thị.

Không có gì cảnh báo bạn. Các bản quét QPTIFF H&E trường sáng trong cùng bộ dữ liệu mở hoàn hảo, và chính vì thế mà lỗi này không bị phát hiện.

Đã khắc phục trong SlideScope 1.8.48 (18 tháng 9 năm 2026): backend giờ được chọn theo từng tệp, không theo phần mở rộng. Bản quét đa kênh được chuyển cho trình đọc trả về đủ năm kênh; QPTIFF trường sáng vẫn dùng OpenSlide với khả năng đọc theo ô ở độ phân giải đầy đủ. Sự đánh đổi được nêu rõ thay vì giấu đi: QPTIFF đa kênh được hiển thị ở độ phân giải giảm, và bảng thông tin chi tiết của tệp có ghi rõ điều đó. Lần chạy trên trang này đã phản ánh bản sửa — dòng QPTIFF liệt kê cả hai bộ nạp và năm kênh.

Lần chạy này chứng minh việc mở được tệp. Độ chính xác của điểm ảnh là một câu hỏi riêng, và chúng tôi kiểm thử nó riêng: một lượt quét thứ hai giải mã cùng các mặt phẳng đó qua thư viện nền và so sánh với những gì bộ nạp trả về. Đó là cách trường hợp QPTIFF bị phát hiện.

Những gì SlideScope từ chối mở

Không có trình đọc dự phòng chung chung, và cách một trình xem xử lý tệp mà nó không được xây dựng để đọc cũng quan trọng không kém những tệp mà nó được xây dựng để đọc. Chúng tôi lấy tệp thật nhỏ nhất của mỗi phần mở rộng không được hỗ trợ trong bộ dữ liệu tham chiếu — 93 tệp — và chạy từng tệp qua bộ tạo bộ nạp của bản phát hành.

Cả 93/93 tệp đều bị từ chối kèm thông báo rõ ràng. Không tệp nào gây sập. Không tệp nào bị mở dở dang thành thứ trông giống ảnh nhưng thực ra không phải. Danh sách bao gồm các định dạng mà người dùng rất có thể sẽ thử — .jpg, .lof, .nii, .oib, .oir, .png, .psd, .raw, .vsi — vào thời điểm chạy, danh sách này có cả .png và .jpg, vốn bị từ chối kèm thông báo thay vì bị đoán bừa.

Kể từ lần chạy này: SlideScope 1.10.0 (16 tháng 10 năm 2026) mở thêm 18 định dạng, trong đó có một số định dạng bị từ chối ở đây: Olympus .vsi, .oib và .oir, Leica .lof và .xlef, Hamamatsu .ndpis, cùng PNG, JPEG và các ảnh thông dụng khác. Các con số trên trang này là kết quả đo của lần chạy ngày 18 tháng 9; các định dạng được bổ sung trong 1.10.0 không nằm trong lần chạy đó. SlideScope 1.20.0 mở thêm năm định dạng mà lần chạy này chưa kiểm thử: Philips .isyntax, KFBio .kfb, ICS/IDS, Gatan .dm3 và .dm4, và Olympus .sis. Xem tài liệu tham chiếu về khả năng tương thích tệp để biết danh sách hiện hành.

Những gì bài kiểm thử này không cho bạn biết

• Có hai định dạng hoàn toàn không có tệp thật nào để kiểm thử. Không có mẫu .vmu hay .svslide công khai nào — OpenSlide không công bố cả hai — nên các bộ nạp đó chỉ được thử bằng các trường hợp biên tổng hợp. Chúng tôi không tuyên bố đã kiểm thử hỗ trợ cho chúng.
• Đây không phải bài kiểm thử tốc độ. Thời gian đến điểm ảnh đầu tiên phụ thuộc vào ổ đĩa của bạn, và các lần chạy này đều chạy trên máy cục bộ.
• Đây không phải một cuộc kiểm định độ chính xác ngoài lượt so sánh điểm ảnh được mô tả ở trên, và cũng không phải thẩm định lâm sàng. SlideScope dành cho nghiên cứu, giáo dục và xem xét — không dùng để chẩn đoán.
• Đây là một ảnh chụp tại một thời điểm. Thực hiện ngày 2026-09-18 với bản phát hành hiện hành vào ngày đó. Việc nâng cấp bộ giải mã có thể làm các con số này thay đổi theo cả hai chiều.