RyoMurakami/OpenH-RF-eSAF-raw

1---2pretty_name: "OpenH-RF eSAF — Raw Source Data Archive"3license: cc-by-4.04tags:5  - ultrasound6  - rf7  - openh-rf8  - provenance9  - raw-data10---11 12# OpenH-RF eSAF — Raw Source Data Archive13 14**This is a provenance/reproducibility archive — not itself the OpenH-RF15submission.** The submitted dataset (195 zea-format `.hdf5` acquisitions + data card16+ reconstruction pipeline) is at17**<https://huggingface.co/datasets/RyoMurakami/OpenH-RF-eSAF>**. This archive18preserves the raw, upstream acquisition/simulation outputs that were converted into19that packaged submission — released under the same **CC BY 4.0** license (see20`LICENSE`).21 22Code and full documentation for how this raw data was collected and processed23live in the GitHub repo `RyoMurakami-MedRobo/OpenH-RF-eSAF`24(`experiment/`, `sim/`, `matlab/saf/`).25 26## What's here27 28| File | Contents |29|---|---|30| `raw/experiment_10mm.zip` | Raw Verasonics per-line channel-RF capture (`RFdata_line*.mat`, one file per acquired line) for the 10 mm nominal-depth measured phantom scan, plus `acq_meta.mat`, `acq_log.mat`, `EncoderInfo/` (motor angle log), and working QC files from this scan folder (depth-identification figures, intermediate eSAF `.mat`/`.png`). This is the data **before** time-tag frame-to-angle synchronization and before centre-plane-wave extraction — i.e. upstream of `experiment/sync_channel_rf.m`, which produces the packaged single-plane-wave-per-angle raw channel data delivered in the public submission as `data/experiment__acq_exp_10mm.hdf5`. |31| `raw/experiment_20mm.zip` / `_30mm` / `_40mm` / `_45mm` | Same, for the 20/30/40/45 mm nominal-depth measured scans (source: `20260617/scan_data_JP_US_Angle_3D_<depth>mm/` on lab storage). |32| `raw/sim_dataset_out.zip` | Per-case MATLAB `.mat` + reference `.png` for all 190 simulated (probe × target) cases from `sim/batch_sim_probe_target.m`: raw per-element channel RF, the in-plane DAS beamformed result, full metadata, and the eSAF-reconstructed output (`safrot_backproj`), plus the `dataset_overview_r4.png` FWHM-vs-depth summary. This is the MATLAB-side counterpart of the zea `.hdf5` files delivered in the public submission. |33 34## Why this archive exists35 36The public submission ships the already-converted, packaged zea `.hdf5` format37(raw channel RF + scan metadata + paired SAF-volume label) needed by OpenH-RF. This38archive preserves the raw, upstream acquisition/simulation outputs that were39converted into that packaged form, in case of a need to re-derive, re-verify, or40re-process from source (different frame-to-angle sync window, different plane-wave41selection, alternate SAF parameters, etc.) beyond what the packaged form supports.42 43## Reproducing the packaged data from this archive44 451. Simulated: `sim/mat_to_zea.py` or `sim/sim_dataset_to_zea.py` converts the46   `sim_dataset_out/<probe>/<target>.mat` files here into the zea `data/*.hdf5`47   format in the public submission.482. Measured: `experiment/sync_channel_rf.m` reads the raw per-line `RFdata_line*.mat`49   + `EncoderInfo/` here, performs time-tag frame→angle synchronization and50   centre-plane-wave extraction, and writes the packaged channel-RF used by51   `sim/sim_dataset_to_zea.py` to produce `data/experiment__acq_exp_<depth>mm.hdf5`.52 53## Known caveats54 55- Not all raw acquisitions collected during this project are archived here — only56  the ones that back the 5 measured acquisitions actually delivered in the public57  submission (10/20/30/40/45 mm). Earlier troubleshooting captures (50–130 mm and58  several re-acquisition variants used to diagnose a depth-dependent eSAF focus59  issue) are not included; they remain on lab storage if needed later.60- Zips use standard DEFLATE compression (`zip -9`); raw ultrasound RF data61  compresses modestly (~45–55% of original size), not dramatically — it isn't62  incompressible, but don't expect an order-of-magnitude reduction.63