下载指南 · TCIA

Ovarian-Bevacizumab-Response:253.8 GB 病理切片怎样获取

卵巢癌贝伐珠单抗疗效数据集 · 286 张 H&E 全切片 · 78 名患者 · CC BY 4.0

数据分两部分:三份小表格用 curl 直接下载;286 张切片约 253.8 GB,没有普通下载链接,只经 Aspera 分发。PathTrove 对 TCIA 的切片包统一用 Aspera 官方命令行工具 ascli 整包接收,不需要在网页上点击,可在服务器上运行。无需账号、审批或数据使用协议。

1. 下载什么

文件内容大小获取方式
病理切片286 个 SVS 文件;H&E,20×,0.5 µm/像素约 253.8 GBascli 命令行整包接收
new_CA125-data_20230207.xlsx每张切片的疗效标签(effective / invalid)与治疗前后 CA-12526 KBcurl 直接下载
Final-patient_list.xlsx每名患者的年龄、诊断、FIGO 分期、贝伐珠单抗用法,以及手术、复发和死亡日期18 KBcurl 直接下载
切片清单 CSV每张切片对应的患者编号,以及在线浏览用的编号18 KBcurl 直接下载

官方页面和论文仍写 288 张(有效 162、无效 126)。当前 Version 2 已移除 414056O.svs 与 414056P.svs,实为 286 张(有效 160、无效 126)。标签表的工作表名 Ovary.effective-162 也是旧计数。

2. 下载表格

mkdir -p ovarian_bev/metadata && cd ovarian_bev/metadata
curl -fSLO 'https://www.cancerimagingarchive.net/wp-content/uploads/new_CA125-data_20230207.xlsx'
curl -fSLO 'https://www.cancerimagingarchive.net/wp-content/uploads/Final-patient_list.xlsx'
curl -fSL -o manifest.csv \
  'https://pathdb.cancerimagingarchive.net/system/files/collectionmetadata/202405/Ovarian%20Bevacizumab%20Response_05-28-2024.csv'

三个文件应分别为 26,219、18,640、18,721 字节;切片清单有 286 行数据。

3. 下载切片

先安装 ascli 与传输引擎 ascp(需要 Ruby 3.1 或以上),再用 TCIA 页面给出的 Faspex 包链接接收整个包:

gem install aspera-cli
ascli conf ascp install

PKG='https://faspex.cancerimagingarchive.net/aspera/faspex/public/package?context=eyJyZXNvdXJjZSI6InBhY2thZ2VzIiwidHlwZSI6ImV4dGVybmFsX2Rvd25sb2FkX3BhY2thZ2UiLCJpZCI6Ijc0NCIsInBhc3Njb2RlIjoiMWZiZTNmMzgwNmY1MTEyNjBlODkxYjk0MWVjYzdkZTY2MGQwZGNkYSIsInBhY2thZ2VfaWQiOiI3NDQiLCJlbWFpbCI6ImhlbHBAY2FuY2VyaW1hZ2luZ2FyY2hpdmUubmV0In0='
ascli faspex5 packages receive --url="$PKG" \
  --to-folder=./ovarian_bev/slides \
  --http-options=@json:'{"ssl_options":["IGNORE_UNEXPECTED_EOF"]}' \
  --ts=@json:'{"target_rate_kbps":5000,"min_rate_kbps":100}'
  1. 只能整包接收。在命令后追加子目录会返回服务器 500 错误。
  2. 必须带 --ts。Faspex 下发的默认传输参数最小速率为 0,传输会一直停在 0 字节;改为最小 100 kbps 后恢复。
  3. IGNORE_UNEXPECTED_EOF 用于兼容偶发的 TLS 握手中断。
  4. 中断后重跑同一条命令即续传。未完成的文件以 *.partial 和 *.aspera-ckpt 保留,完成后自动改名;不要清空目录重来。

启动后约 100 秒才开始有数据,这段时间看到 0 字节属正常。PathTrove 在中国大陆网络实测 TCIA 的 Aspera 传输约 0.35–0.9 MB/s,按此估算整包需要 3–8 天;传输走 UDP 33001 端口,需在防火墙放行。预留至少 260 GB 空间。

这套命令已在 TCIA 的 AML-Cytomorphology(97 个文件与官方 MD5 全部一致)、CMB-GEC、SLN-Breast 与 DLBCL-Morphology 包上实测下载到真实图像。本数据集的切片包(Faspex 包 744)尚未用它实测;包链接取自 TCIA 官方页面。

4. 表格与切片的对应

5. 下载后检查

cd ovarian_bev/slides
md5sum -c *.sums                       # 包内若附官方 MD5 清单,逐文件核对
find . -iname '*.svs' | wc -l          # 应为 286
du -sh .                               # 约 253.8 GB

TCIA 的 Faspex 包根目录通常附官方 MD5 清单(*.sums),本包是否附带要在接收后确认。没有时,以文件数、总大小和 openslide 能否打开为准。

6. 接入实验

划分 JSON 含 265 张切片、73 名患者的标签与按患者划分(训练 51 人 / 验证 11 人 / 测试 11 人),另有 21 张存在疑问的切片单列、暂不纳入。实验准备包附核对脚本,解压后运行:

python verify_images.py --images ovarian_bev/slides

脚本逐一核对清单中的文件是否存在、有无重名、文件头是否为 SVS/TIFF。通过后按 split 读取图像与标签。

来源

表格的链接与大小经实测;切片包大小取自官方页面。

Download guide · TCIA

Ovarian-Bevacizumab-Response: how to get 253.8 GB of pathology slides

Ovarian cancer bevacizumab response dataset · 286 H&E whole-slide images · 78 patients · CC BY 4.0

The data comes in two parts: three small tables download directly with curl; the 286 slides, about 253.8 GB, have no ordinary download link and are distributed only via Aspera. PathTrove receives TCIA slide packages whole with ascli, the official Aspera command-line tool; nothing needs clicking in a browser, so it runs on a server. No account, approval or data use agreement is needed.

1. What to download

FileContentsSizeHow to get it
Pathology slides286 SVS files; H&E, 20×, 0.5 µm/pixelAbout 253.8 GBWhole package via the ascli command line
new_CA125-data_20230207.xlsxResponse label per slide (effective / invalid) and CA-125 before and after treatment26 KBDirect download with curl
Final-patient_list.xlsxPer patient: age, diagnosis, FIGO stage, bevacizumab regimen, and dates of surgery, recurrence and death18 KBDirect download with curl
Slide manifest CSVPatient ID of each slide, and the ID used for online viewing18 KBDirect download with curl

The official page and the paper still say 288 slides (162 effective, 126 invalid). The current Version 2 removed 414056O.svs and 414056P.svs, leaving 286 (160 effective, 126 invalid). The label sheet name Ovary.effective-162 is also the old count.

2. Download the tables

mkdir -p ovarian_bev/metadata && cd ovarian_bev/metadata
curl -fSLO 'https://www.cancerimagingarchive.net/wp-content/uploads/new_CA125-data_20230207.xlsx'
curl -fSLO 'https://www.cancerimagingarchive.net/wp-content/uploads/Final-patient_list.xlsx'
curl -fSL -o manifest.csv \
  'https://pathdb.cancerimagingarchive.net/system/files/collectionmetadata/202405/Ovarian%20Bevacizumab%20Response_05-28-2024.csv'

The three files should be 26,219, 18,640 and 18,721 bytes; the slide manifest has 286 data rows.

3. Download the slides

First install ascli and the transfer engine ascp (Ruby 3.1 or later is required), then receive the whole package with the Faspex package link from the TCIA page:

gem install aspera-cli
ascli conf ascp install

PKG='https://faspex.cancerimagingarchive.net/aspera/faspex/public/package?context=eyJyZXNvdXJjZSI6InBhY2thZ2VzIiwidHlwZSI6ImV4dGVybmFsX2Rvd25sb2FkX3BhY2thZ2UiLCJpZCI6Ijc0NCIsInBhc3Njb2RlIjoiMWZiZTNmMzgwNmY1MTEyNjBlODkxYjk0MWVjYzdkZTY2MGQwZGNkYSIsInBhY2thZ2VfaWQiOiI3NDQiLCJlbWFpbCI6ImhlbHBAY2FuY2VyaW1hZ2luZ2FyY2hpdmUubmV0In0='
ascli faspex5 packages receive --url="$PKG" \
  --to-folder=./ovarian_bev/slides \
  --http-options=@json:'{"ssl_options":["IGNORE_UNEXPECTED_EOF"]}' \
  --ts=@json:'{"target_rate_kbps":5000,"min_rate_kbps":100}'
  1. Only the whole package can be received. Appending a subdirectory to the command returns a server 500 error.
  2. --ts is required. The default transfer settings sent by Faspex set the minimum rate to 0, and the transfer stays at 0 bytes; setting the minimum to 100 kbps fixes it.
  3. IGNORE_UNEXPECTED_EOF tolerates occasional interrupted TLS handshakes.
  4. To resume after an interruption, rerun the same command. Unfinished files are kept as *.partial and *.aspera-ckpt and renamed automatically when complete; do not empty the folder and start over.

Data starts arriving about 100 seconds after launch; seeing 0 bytes during that time is normal. PathTrove measured TCIA Aspera transfers from mainland China at about 0.35–0.9 MB/s, which puts the whole package at 3–8 days. The transfer uses UDP port 33001, which must be open in the firewall. Reserve at least 260 GB of disk space.

These commands have been tested on the TCIA AML-Cytomorphology (all 97 files match the official MD5), CMB-GEC, SLN-Breast and DLBCL-Morphology packages, downloading real images. The slide package of this dataset (Faspex package 744) has not yet been tested with them; the package link is taken from the official TCIA page.

4. Matching tables to slides

5. Check after download

cd ovarian_bev/slides
md5sum -c *.sums                       # if the package includes official MD5 lists, check every file
find . -iname '*.svs' | wc -l          # should be 286
du -sh .                               # about 253.8 GB

TCIA Faspex packages usually include official MD5 lists (*.sums) in the root folder; whether this package does must be confirmed after receiving it. If not, rely on the file count, the total size and whether openslide can open each file.

6. Use in experiments

The split JSON contains labels and a patient-level split for 265 slides from 73 patients (51 train / 11 validation / 11 test patients); another 21 questionable slides are listed separately and excluded for now. The preparation package includes a check script; after unzipping, run:

python verify_images.py --images ovarian_bev/slides

The script checks each file in the list: whether it exists, whether names are duplicated, and whether the file header is SVS/TIFF. Once it passes, read images and labels by split.

Sources

Table links and sizes were tested; the slide package size is taken from the official page.