Skip to content

Commit b191746

Browse files
Copilotakhanf
andauthored
docs: fix otsu+k3i2 description and regqc path
Agent-Logs-Url: https://github.com/khanlab/SPIMquant/sessions/8c18a135-2cee-4627-a6fc-0c70d8b49319 Co-authored-by: akhanf <11492701+akhanf@users.noreply.github.com>
1 parent 58297b1 commit b191746

2 files changed

Lines changed: 7 additions & 5 deletions

File tree

docs/howto/segmentation.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -60,12 +60,14 @@ stain_defaults:
6060
6161
**Limitations:** Sensitive to residual intensity non-uniformities and to between-subject intensity variation. May require manual threshold tuning per dataset.
6262
63-
### Otsu + k-means (`seg_method: otsu+k3i2`)
63+
### Multi-Otsu (`seg_method: otsu+k3i2`)
6464

65-
A two-step unsupervised method that adapts to the intensity distribution of each image:
65+
An unsupervised thresholding method that adapts to the intensity distribution of each image.
6666

67-
1. **Multi-Otsu thresholding** — Otsu's method is extended to find *N* thresholds that minimise within-class variance, splitting the histogram into background, low-signal, and high-signal classes.
68-
2. **k-means refinement** — 3-class k-means clustering (`k=3`) is applied to the voxels that fall in the intermediate class identified by Otsu, further separating ambiguous voxels. The result assigned class index `i=2` (the highest-intensity class) is kept as positive.
67+
The method string encodes two parameters: `k` — the number of Otsu classes, and `i` — the threshold index to use for the binary classification. For `otsu+k3i2`:
68+
69+
1. **Multi-Otsu thresholding** — Otsu's method is extended to find `k-1` thresholds that minimise within-class variance, splitting the histogram into `k` classes. With `k=3` the image is divided into background, low-signal, and high-signal classes (2 thresholds).
70+
2. **Binary classification** — the threshold at index `i` (1-based) is applied to produce the final binary mask. With `i=2` this selects the second (higher) threshold, classifying only the brightest voxels as positive.
6971

7072
**Config key:**
7173

docs/workflow_overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -189,7 +189,7 @@ All outputs follow BIDS-derivative naming conventions. The table below lists th
189189
| Path pattern | Content | Stage |
190190
|---|---|---|
191191
| `sub-*/micr/*_space-{tpl}_SPIM.nii.gz` | Subject brain warped to template | 6 |
192-
| `sub-*/micr/*_regqc.html` | Registration QC report | 10 |
192+
| `sub-*/xfm/*_regqc.html` | Registration QC report | 10 |
193193
| `sub-*/micr/*_desc-brain_mask.nii.gz` | Brain mask | 3 |
194194
| `sub-*/parc/*_from-{tpl}_dseg.nii.gz` | Atlas parcellation in subject space | 6 |
195195
| `sub-*/seg/*_desc-*_mask.ome.zarr` | Full-resolution segmentation mask | 7 |

0 commit comments

Comments
 (0)