PyPI - tmapslide - Versions diffs - 0.2.0__tar.gz → 0.2.1__tar.gz - Mend

tmapslide 0.2.0tar.gz → 0.2.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

tmapslide-0.2.1/PKG-INFO ADDED Viewed

@@ -0,0 +1,188 @@
+Metadata-Version: 2.5
+Name: tmapslide
+Version: 0.2.1
+Summary: Pure Python UNIC TMAP whole-slide image reader with OpenSlide-compatible API
+Project-URL: Homepage, https://github.com/yifanfeng97/tmapslide
+Project-URL: Documentation, https://github.com/yifanfeng97/tmapslide#readme
+Project-URL: Repository, https://github.com/yifanfeng97/tmapslide
+Project-URL: Issues, https://github.com/yifanfeng97/tmapslide/issues
+Author-email: Yifan Feng <evanfeng97@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: digital-pathology,openslide,pathology,tmap,tmapslide,unic,whole-slide-image,wsi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Requires-Python: >=3.10
+Requires-Dist: pillow>=9.0.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+<div align="center">
+<img src="docs/hero.jpg" alt="TmapSlide — UNIC TMAP whole-slide images in pure Python" width="800" style="max-width: 100%;">
+<br/>
+**TmapSlide**
+**Pure Python reader for UNIC TMAP whole-slide images — no SDK, no native deps.**
+*以纯 Python 读取联影 TMAP 全切片图像，开箱即用*
+<p align="center">
+  <a href="https://pypi.org/project/tmapslide/">
+    <img src="https://img.shields.io/pypi/v/tmapslide?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=3776ab" alt="PyPI Version">
+  </a>
+  <a href="https://pypi.org/project/tmapslide/">
+    <img src="https://img.shields.io/pypi/dm/tmapslide?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=3776ab" alt="PyPI Downloads">
+  </a>
+  <a href="https://python.org">
+    <img src="https://img.shields.io/badge/python-3.10%2B-3776ab?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e" alt="Python Version">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-06b6d4?style=for-the-badge&logo=openaccess&logoColor=white&labelColor=1a1a2e" alt="License">
+  </a>
+  <a href="https://github.com/yifanfeng97/tmapslide/actions/workflows/test.yml">
+    <img src="https://img.shields.io/github/actions/yifanfeng97/tmapslide/test.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&labelColor=1a1a2e&label=tests" alt="Tests">
+  </a>
+  <a href="https://github.com/yifanfeng97/tmapslide/stargazers">
+    <img src="https://img.shields.io/github/stars/yifanfeng97/tmapslide?style=for-the-badge&logo=github&labelColor=1a1a2e&color=facc15" alt="GitHub Stars">
+  </a>
+</p>
+[📖 English](#-quick-start) · [中文说明](#-中文说明)
+</div>
+## ⚡ Quick Start
+**1. Install:**
+```bash
+pip install tmapslide
+```
+**2. Read a slide:**
+```python
+import tmapslide
+slide = tmapslide.OpenSlide("sample.TMAP")
+print(slide.dimensions)          # (71424, 72704)
+print(slide.level_count)         # 10
+print(slide.level_downsamples)   # (1.0, 2.0, 4.0, ...)
+region = slide.read_region((512, 512), 0, (1024, 1024))  # RGBA PIL image
+thumb = slide.get_thumbnail((512, 512))
+macro = slide.associated_images["macro"]
+```
+## ✨ Features
+- **Pure Python** — no vendor SDK, no native dependencies; only Pillow
+- **OpenSlide-compatible API** — drop-in for code written against
+  `openslide` / `kfbslide`: `read_region`, `get_thumbnail`, `dimensions`,
+  `level_count`, `level_dimensions`, `level_downsamples`, `properties`,
+  `associated_images`
+- **Both known TMAP variants** — `TMAP06` (3-level pyramid) and
+  `TMAP07` (up to 10 levels)
+- **Fork-safe file handles** — safe with PyTorch `DataLoader` workers
+- **LRU decoded-tile cache** — fast repeated reads
+- **Thread-safe reads** — concurrent `read_region` from worker threads
+## 🏎️ Performance
+Benchmark vs [ASlide](https://github.com/MrPeterJin/ASlide)'s pure-Python
+TMAP backend (median of 5 runs, same files, same machine):
+| Scenario | TMAP07 | TMAP06 |
+|---|---|---|
+| Open slide | **281 ms** vs 43 ms ⚠️ | **101 ms** vs 224 ms (2.2×) |
+| Cold 1024² region @L0 | **4.1 ms** vs 15.7 ms (3.8×) | **2.6 ms** vs 14.8 ms (5.6×) |
+| Random 512² region @L0 | **1.1 ms** vs 5.7 ms (5.3×) | **0.9 ms** vs 6.3 ms (6.7×) |
+| Warm 512² region ×50 | **42 ms** vs 217 ms (5.1×) | **54 ms** vs 408 ms (7.6×) |
+> ASlide's TMAP backend re-decodes every tile on every call; tmapslide adds
+> an LRU decoded-tile cache and per-tile culling, so warm reads and random
+> access are several times faster.
+## 📖 API
+### `tmapslide.OpenSlide(filename)`
+| Member | Description |
+| --- | --- |
+| `dimensions` | `(width, height)` at level 0 |
+| `level_count` | number of pyramid levels |
+| `level_dimensions` | `(w, h)` per level |
+| `level_downsamples` | downsample factor per level |
+| `properties` | read-only metadata mapping (`openslide.vendor=unic`, `tmap.*`) |
+| `associated_images` | lazy mapping, typically `macro` / `label` / `thumbnail` |
+| `read_region(loc, level, size)` | `PIL.Image` (RGBA) of the region |
+| `get_thumbnail(size)` | thumbnail from the lowest resolution level |
+| `get_best_level_for_downsample(ds)` | best level for a downsample factor |
+| `close()` / context manager | release resources |
+### `tmapslide.open_slide(filename)`
+Alias of `OpenSlide(filename)`.
+## 📦 Supported Formats
+| Format | Extension | Vendor | Backend |
+| --- | --- | --- | --- |
+| TMAP 06 | `.TMAP` | UNIC (United Imaging) | Pure Python |
+| TMAP 07 | `.TMAP` | UNIC (United Imaging) | Pure Python |
+## 🧪 Testing
+Tests run against real TMAP samples when the `scce_external_center` data
+directory (or `TAPSLIDE_TEST_DATA`) is present next to the repo; synthetic
+fixtures keep the core parser covered everywhere else.
+```bash
+pip install -e .[dev]
+pytest
+```
+## 📄 Format Notes (reverse-engineered)
+TMAP is an undocumented proprietary format. This reader is built from
+binary analysis of real scanner output, cross-validated against
+[ASlide](https://github.com/MrPeterJin/ASlide). Both variants store plain
+JPEG tiles with a small binary header and index tables; there is no
+encryption.
+- TMAP06 stores 3 pyramid levels (40x / 10x / 2.5x); TMAP07 stores up to
+  10 levels (40x down to 0.078x, halving each level).
+- TMAP06 level-2 previews come from pre-rendered `ShrinkTile` entries and
+  are JPEG-compressed at that scale.
+- `iter_tiles()` exposes the stored tile grid directly — useful for
+  tile-based ML pipelines.
+## 📄 License
+[MIT](LICENSE)
+## 🙏 Acknowledgments
+- [kfbslide](https://github.com/yifanfeng97/kfbslide) — the KFB reader this
+  project is modelled after
+- [OpenSlide](https://openslide.org/) — the API this library mimics
+- [ASlide](https://github.com/MrPeterJin/ASlide) — its independent
+  reverse-engineering of the TMAP06 layer/block structures (from decompiled
+  vendor SDK) was used to cross-validate this implementation. tmapslide is
+  an independent MIT-licensed implementation and ships no ASlide code

tmapslide-0.2.1/README.md ADDED Viewed

@@ -0,0 +1,157 @@
+<div align="center">
+<img src="docs/hero.jpg" alt="TmapSlide — UNIC TMAP whole-slide images in pure Python" width="800" style="max-width: 100%;">
+<br/>
+**TmapSlide**
+**Pure Python reader for UNIC TMAP whole-slide images — no SDK, no native deps.**
+*以纯 Python 读取联影 TMAP 全切片图像，开箱即用*
+<p align="center">
+  <a href="https://pypi.org/project/tmapslide/">
+    <img src="https://img.shields.io/pypi/v/tmapslide?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=3776ab" alt="PyPI Version">
+  </a>
+  <a href="https://pypi.org/project/tmapslide/">
+    <img src="https://img.shields.io/pypi/dm/tmapslide?style=for-the-badge&logo=pypi&logoColor=white&labelColor=1a1a2e&color=3776ab" alt="PyPI Downloads">
+  </a>
+  <a href="https://python.org">
+    <img src="https://img.shields.io/badge/python-3.10%2B-3776ab?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a2e" alt="Python Version">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-06b6d4?style=for-the-badge&logo=openaccess&logoColor=white&labelColor=1a1a2e" alt="License">
+  </a>
+  <a href="https://github.com/yifanfeng97/tmapslide/actions/workflows/test.yml">
+    <img src="https://img.shields.io/github/actions/yifanfeng97/tmapslide/test.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&labelColor=1a1a2e&label=tests" alt="Tests">
+  </a>
+  <a href="https://github.com/yifanfeng97/tmapslide/stargazers">
+    <img src="https://img.shields.io/github/stars/yifanfeng97/tmapslide?style=for-the-badge&logo=github&labelColor=1a1a2e&color=facc15" alt="GitHub Stars">
+  </a>
+</p>
+[📖 English](#-quick-start) · [中文说明](#-中文说明)
+</div>
+## ⚡ Quick Start
+**1. Install:**
+```bash
+pip install tmapslide
+```
+**2. Read a slide:**
+```python
+import tmapslide
+slide = tmapslide.OpenSlide("sample.TMAP")
+print(slide.dimensions)          # (71424, 72704)
+print(slide.level_count)         # 10
+print(slide.level_downsamples)   # (1.0, 2.0, 4.0, ...)
+region = slide.read_region((512, 512), 0, (1024, 1024))  # RGBA PIL image
+thumb = slide.get_thumbnail((512, 512))
+macro = slide.associated_images["macro"]
+```
+## ✨ Features
+- **Pure Python** — no vendor SDK, no native dependencies; only Pillow
+- **OpenSlide-compatible API** — drop-in for code written against
+  `openslide` / `kfbslide`: `read_region`, `get_thumbnail`, `dimensions`,
+  `level_count`, `level_dimensions`, `level_downsamples`, `properties`,
+  `associated_images`
+- **Both known TMAP variants** — `TMAP06` (3-level pyramid) and
+  `TMAP07` (up to 10 levels)
+- **Fork-safe file handles** — safe with PyTorch `DataLoader` workers
+- **LRU decoded-tile cache** — fast repeated reads
+- **Thread-safe reads** — concurrent `read_region` from worker threads
+## 🏎️ Performance
+Benchmark vs [ASlide](https://github.com/MrPeterJin/ASlide)'s pure-Python
+TMAP backend (median of 5 runs, same files, same machine):
+| Scenario | TMAP07 | TMAP06 |
+|---|---|---|
+| Open slide | **281 ms** vs 43 ms ⚠️ | **101 ms** vs 224 ms (2.2×) |
+| Cold 1024² region @L0 | **4.1 ms** vs 15.7 ms (3.8×) | **2.6 ms** vs 14.8 ms (5.6×) |
+| Random 512² region @L0 | **1.1 ms** vs 5.7 ms (5.3×) | **0.9 ms** vs 6.3 ms (6.7×) |
+| Warm 512² region ×50 | **42 ms** vs 217 ms (5.1×) | **54 ms** vs 408 ms (7.6×) |
+> ASlide's TMAP backend re-decodes every tile on every call; tmapslide adds
+> an LRU decoded-tile cache and per-tile culling, so warm reads and random
+> access are several times faster.
+## 📖 API
+### `tmapslide.OpenSlide(filename)`
+| Member | Description |
+| --- | --- |
+| `dimensions` | `(width, height)` at level 0 |
+| `level_count` | number of pyramid levels |
+| `level_dimensions` | `(w, h)` per level |
+| `level_downsamples` | downsample factor per level |
+| `properties` | read-only metadata mapping (`openslide.vendor=unic`, `tmap.*`) |
+| `associated_images` | lazy mapping, typically `macro` / `label` / `thumbnail` |
+| `read_region(loc, level, size)` | `PIL.Image` (RGBA) of the region |
+| `get_thumbnail(size)` | thumbnail from the lowest resolution level |
+| `get_best_level_for_downsample(ds)` | best level for a downsample factor |
+| `close()` / context manager | release resources |
+### `tmapslide.open_slide(filename)`
+Alias of `OpenSlide(filename)`.
+## 📦 Supported Formats
+| Format | Extension | Vendor | Backend |
+| --- | --- | --- | --- |
+| TMAP 06 | `.TMAP` | UNIC (United Imaging) | Pure Python |
+| TMAP 07 | `.TMAP` | UNIC (United Imaging) | Pure Python |
+## 🧪 Testing
+Tests run against real TMAP samples when the `scce_external_center` data
+directory (or `TAPSLIDE_TEST_DATA`) is present next to the repo; synthetic
+fixtures keep the core parser covered everywhere else.
+```bash
+pip install -e .[dev]
+pytest
+```
+## 📄 Format Notes (reverse-engineered)
+TMAP is an undocumented proprietary format. This reader is built from
+binary analysis of real scanner output, cross-validated against
+[ASlide](https://github.com/MrPeterJin/ASlide). Both variants store plain
+JPEG tiles with a small binary header and index tables; there is no
+encryption.
+- TMAP06 stores 3 pyramid levels (40x / 10x / 2.5x); TMAP07 stores up to
+  10 levels (40x down to 0.078x, halving each level).
+- TMAP06 level-2 previews come from pre-rendered `ShrinkTile` entries and
+  are JPEG-compressed at that scale.
+- `iter_tiles()` exposes the stored tile grid directly — useful for
+  tile-based ML pipelines.
+## 📄 License
+[MIT](LICENSE)
+## 🙏 Acknowledgments
+- [kfbslide](https://github.com/yifanfeng97/kfbslide) — the KFB reader this
+  project is modelled after
+- [OpenSlide](https://openslide.org/) — the API this library mimics
+- [ASlide](https://github.com/MrPeterJin/ASlide) — its independent
+  reverse-engineering of the TMAP06 layer/block structures (from decompiled
+  vendor SDK) was used to cross-validate this implementation. tmapslide is
+  an independent MIT-licensed implementation and ships no ASlide code

{tmapslide-0.2.0 → tmapslide-0.2.1}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 [project]
 name = "tmapslide"
-version = "0.2.0"
+version = "0.2.1"
 description = "Pure Python UNIC TMAP whole-slide image reader with OpenSlide-compatible API"
 readme = "README.md"
 license = "MIT"

{tmapslide-0.2.0 → tmapslide-0.2.1}/src/tmapslide/__init__.py RENAMED Viewed

@@ -20,7 +20,7 @@ from ._exceptions import (
 )
 from ._slide import OpenSlide, TmapSlide, open_slide
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 # Standard OpenSlide property name constants
 PROPERTY_NAME_VENDOR = "openslide.vendor"

{tmapslide-0.2.0 → tmapslide-0.2.1}/src/tmapslide/_slide.py RENAMED Viewed

@@ -408,6 +408,7 @@ class OpenSlide:
         props = info.properties
         img_w = int(props.get("tmap.img_width", 2448))
         img_h = int(props.get("tmap.img_height", 2048))
+        tile_img_w, tile_img_h = info.__dict__.get("_tile_jpeg_size", (612, 512))
         fh = self._ensure_open_handle()
         # clamp level to what we can render
@@ -487,25 +488,47 @@ class OpenSlide:
             n_x, n_y = blk["n_x"], blk["n_y"]
             if n_x + img_w < x0_l0 or n_x > x0_l0 + w0 or n_y + img_h < y0_l0 or n_y > y0_l0 + h0:
                 continue
+            jw, jh = info.__dict__.get("_tile_jpeg_size", (tile_img_w, tile_img_h))
             for layer_no, col, row, off, length in blk["tiles"]:
                 if layer_no != level:
                     continue
-                tile_img = self._get_cached_tile(off, length)
                 if layer_no > 0:
                     # one tile covers the whole block
                     tile_x0, tile_y0 = n_x, n_y
                     cover_w, cover_h = img_w, img_h
                 else:
-                    tile_x0 = n_x + col * tile_img.width
-                    tile_y0 = n_y + row * tile_img.height
-                    cover_w, cover_h = tile_img.width, tile_img.height
+                    tile_x0 = n_x + col * jw
+                    tile_y0 = n_y + row * jh
+                    cover_w, cover_h = jw, jh
+                # cull tiles that miss the region BEFORE decoding
+                if (
+                    tile_x0 + cover_w <= x0_l0
+                    or tile_x0 >= x0_l0 + w0
+                    or tile_y0 + cover_h <= y0_l0
+                    or tile_y0 >= y0_l0 + h0
+                ):
+                    continue
+                tile_img = self._get_cached_tile(off, length)
                 paste_scaled(tile_img, tile_x0, tile_y0, cover_w, cover_h)
         return out
     def get_thumbnail(self, size: Tuple[int, int]) -> Image.Image:
-        """Get a thumbnail image no larger than `size`."""
+        """Get a thumbnail image no larger than `size`.
+        Prefers the stored thumbnail associated image when the file
+        provides one; otherwise renders the lowest-resolution level.
+        """
         self._check_open()
-        # Prefer the lowest-resolution pyramid level.
+        names = set()
+        try:
+            names = set(self.associated_images)
+        except Exception:
+            names = set()
+        if "thumbnail" in names:
+            thumb = self.associated_images["thumbnail"].convert("RGB")
+            thumb.thumbnail(size, Image.LANCZOS)
+            return thumb
+        # Fall back to the lowest-resolution pyramid level.
         level = self.level_count - 1
         dims = self.level_dimensions[level]
         region = self.read_region((0, 0), level, dims)

tmapslide-0.2.0/PKG-INFO DELETED Viewed

@@ -1,142 +0,0 @@
-Metadata-Version: 2.5
-Name: tmapslide
-Version: 0.2.0
-Summary: Pure Python UNIC TMAP whole-slide image reader with OpenSlide-compatible API
-Project-URL: Homepage, https://github.com/yifanfeng97/tmapslide
-Project-URL: Documentation, https://github.com/yifanfeng97/tmapslide#readme
-Project-URL: Repository, https://github.com/yifanfeng97/tmapslide
-Project-URL: Issues, https://github.com/yifanfeng97/tmapslide/issues
-Author-email: Yifan Feng <evanfeng97@gmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: digital-pathology,openslide,pathology,tmap,tmapslide,unic,whole-slide-image,wsi
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Scientific/Engineering :: Image Processing
-Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
-Requires-Python: >=3.10
-Requires-Dist: pillow>=9.0.0
-Provides-Extra: dev
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff; extra == 'dev'
-Description-Content-Type: text/markdown
-# TmapSlide
-![tmapslide — TMAP whole-slide images in pure Python](docs/hero.jpg)
-Pure Python reader for **UNIC TMAP** whole-slide images (WSI) with an
-[OpenSlide](https://openslide.org/)-compatible API — the companion library to
-[kfbslide](https://github.com/yifanfeng97/kfbslide) (KFB format).
-```python
-import tmapslide
-slide = tmapslide.OpenSlide("sample.TMAP")
-print(slide.dimensions)          # (71424, 72704)
-print(slide.level_count)         # 10
-print(slide.level_downsamples)   # (1.0, 2.0, 4.0, ...)
-region = slide.read_region((512, 512), 0, (1024, 1024))  # RGBA PIL image
-thumb = slide.get_thumbnail((512, 512))
-macro = slide.associated_images["macro"]
-```
-## Features
-- **Pure Python** — no vendor SDK, no native dependencies; only Pillow.
-- **OpenSlide-compatible API** — drop-in for code written against
-  `openslide`/`kfbslide`: `read_region`, `get_thumbnail`, `dimensions`,
-  `level_count`, `level_dimensions`, `level_downsamples`, `properties`,
-  `associated_images`.
-- **Both known TMAP variants**: `TMAP06` (single pixel level, 612x512
-  overlapping tiles) and `TMAP07` (full pyramid, up to 10 levels, 256x256
-  tiles).
-- **Fork-safe file handles** — safe to use from PyTorch `DataLoader` workers.
-- LRU tile cache for fast repeated reads.
-## Installation
-```bash
-pip install tmapslide
-# or from source
-pip install git+https://github.com/yifanfeng97/tmapslide.git
-```
-## Supported formats
-| Format  | Extension | Vendor             | Backend     |
-| ------- | --------- | ------------------ | ----------- |
-| TMAP 06 | `.TMAP`   | UNIC (United Imaging) | Pure Python |
-| TMAP 07 | `.TMAP`   | UNIC (United Imaging) | Pure Python |
-## API
-### `tmapslide.OpenSlide(filename)`
-| Member                | Description                                        |
-| --------------------- | -------------------------------------------------- |
-| `dimensions`          | `(width, height)` at level 0                       |
-| `level_count`         | number of pyramid levels                           |
-| `level_dimensions`    | `(w, h)` per level                                 |
-| `level_downsamples`   | downsample factor per level                        |
-| `properties`          | read-only metadata mapping (`openslide.vendor=unic`, `tmap.*`) |
-| `associated_images`   | lazy mapping, typically `macro` / `label`          |
-| `read_region(loc, level, size)` | `PIL.Image` (RGBA) of the region         |
-| `get_thumbnail(size)`  | thumbnail from the lowest resolution level        |
-| `get_best_level_for_downsample(ds)` | best level for a downsample factor   |
-| `close()` / context manager | release resources                            |
-### `tmapslide.open_slide(filename)`
-Alias of `OpenSlide(filename)`.
-## Format notes (reverse-engineered)
-TMAP is an undocumented proprietary format. This reader is built from
-binary analysis of real scanner output, cross-validated against
-[ASlide](https://github.com/MrPeterJin/ASlide). In short: both variants
-store plain JPEG tiles with a small binary header and index tables; there
-is no encryption.
-- TMAP06 stores 3 pyramid levels (40x / 10x / 2.5x); TMAP07 stores up to
-  10 levels (40x down to 0.078x, halving each level).
-- TMAP06 level-2 previews come from pre-rendered `ShrinkTile` entries and
-  are JPEG-compressed at that scale (slightly softer than downsampling
-  level 0 yourself).
-- `iter_tiles()` exposes the stored tile grid directly, useful for
-  tile-based ML pipelines.
-## Testing
-Tests run against real TMAP samples when the `scce_external_center` data
-directory (or `TAPSLIDE_TEST_DATA`) is present next to the repo, and are
-skipped otherwise.
-```bash
-pip install -e .[dev]
-pytest
-```
-## License
-MIT — see [LICENSE](LICENSE).
-## Acknowledgments
-- [kfbslide](https://github.com/yifanfeng97/kfbslide) — the KFB reader this
-  project is modelled after.
-- [OpenSlide](https://openslide.org/) — the API this library mimics.
-- [ASlide](https://github.com/MrPeterJin/ASlide) — its independent
-  reverse-engineering of the TMAP06 layer/block structures (from decompiled
-  vendor SDK) was used to cross-validate this implementation. tmapslide is
-  an independent MIT-licensed implementation and ships no ASlide code.

tmapslide-0.2.0/README.md DELETED Viewed

@@ -1,111 +0,0 @@
-# TmapSlide
-![tmapslide — TMAP whole-slide images in pure Python](docs/hero.jpg)
-Pure Python reader for **UNIC TMAP** whole-slide images (WSI) with an
-[OpenSlide](https://openslide.org/)-compatible API — the companion library to
-[kfbslide](https://github.com/yifanfeng97/kfbslide) (KFB format).
-```python
-import tmapslide
-slide = tmapslide.OpenSlide("sample.TMAP")
-print(slide.dimensions)          # (71424, 72704)
-print(slide.level_count)         # 10
-print(slide.level_downsamples)   # (1.0, 2.0, 4.0, ...)
-region = slide.read_region((512, 512), 0, (1024, 1024))  # RGBA PIL image
-thumb = slide.get_thumbnail((512, 512))
-macro = slide.associated_images["macro"]
-```
-## Features
-- **Pure Python** — no vendor SDK, no native dependencies; only Pillow.
-- **OpenSlide-compatible API** — drop-in for code written against
-  `openslide`/`kfbslide`: `read_region`, `get_thumbnail`, `dimensions`,
-  `level_count`, `level_dimensions`, `level_downsamples`, `properties`,
-  `associated_images`.
-- **Both known TMAP variants**: `TMAP06` (single pixel level, 612x512
-  overlapping tiles) and `TMAP07` (full pyramid, up to 10 levels, 256x256
-  tiles).
-- **Fork-safe file handles** — safe to use from PyTorch `DataLoader` workers.
-- LRU tile cache for fast repeated reads.
-## Installation
-```bash
-pip install tmapslide
-# or from source
-pip install git+https://github.com/yifanfeng97/tmapslide.git
-```
-## Supported formats
-| Format  | Extension | Vendor             | Backend     |
-| ------- | --------- | ------------------ | ----------- |
-| TMAP 06 | `.TMAP`   | UNIC (United Imaging) | Pure Python |
-| TMAP 07 | `.TMAP`   | UNIC (United Imaging) | Pure Python |
-## API
-### `tmapslide.OpenSlide(filename)`
-| Member                | Description                                        |
-| --------------------- | -------------------------------------------------- |
-| `dimensions`          | `(width, height)` at level 0                       |
-| `level_count`         | number of pyramid levels                           |
-| `level_dimensions`    | `(w, h)` per level                                 |
-| `level_downsamples`   | downsample factor per level                        |
-| `properties`          | read-only metadata mapping (`openslide.vendor=unic`, `tmap.*`) |
-| `associated_images`   | lazy mapping, typically `macro` / `label`          |
-| `read_region(loc, level, size)` | `PIL.Image` (RGBA) of the region         |
-| `get_thumbnail(size)`  | thumbnail from the lowest resolution level        |
-| `get_best_level_for_downsample(ds)` | best level for a downsample factor   |
-| `close()` / context manager | release resources                            |
-### `tmapslide.open_slide(filename)`
-Alias of `OpenSlide(filename)`.
-## Format notes (reverse-engineered)
-TMAP is an undocumented proprietary format. This reader is built from
-binary analysis of real scanner output, cross-validated against
-[ASlide](https://github.com/MrPeterJin/ASlide). In short: both variants
-store plain JPEG tiles with a small binary header and index tables; there
-is no encryption.
-- TMAP06 stores 3 pyramid levels (40x / 10x / 2.5x); TMAP07 stores up to
-  10 levels (40x down to 0.078x, halving each level).
-- TMAP06 level-2 previews come from pre-rendered `ShrinkTile` entries and
-  are JPEG-compressed at that scale (slightly softer than downsampling
-  level 0 yourself).
-- `iter_tiles()` exposes the stored tile grid directly, useful for
-  tile-based ML pipelines.
-## Testing
-Tests run against real TMAP samples when the `scce_external_center` data
-directory (or `TAPSLIDE_TEST_DATA`) is present next to the repo, and are
-skipped otherwise.
-```bash
-pip install -e .[dev]
-pytest
-```
-## License
-MIT — see [LICENSE](LICENSE).
-## Acknowledgments
-- [kfbslide](https://github.com/yifanfeng97/kfbslide) — the KFB reader this
-  project is modelled after.
-- [OpenSlide](https://openslide.org/) — the API this library mimics.
-- [ASlide](https://github.com/MrPeterJin/ASlide) — its independent
-  reverse-engineering of the TMAP06 layer/block structures (from decompiled
-  vendor SDK) was used to cross-validate this implementation. tmapslide is
-  an independent MIT-licensed implementation and ships no ASlide code.