Data Directory Structure#
For batch processing (i.e., whole brain / multiple channels processing)
YW001_reg/
├── raw/ (optional) -- (1)
│
├── zproj/ -- (2)
│ └── YW001_g*_s*_{channel}.tif
│
├── roi/ -- (3)
│ └── YW001_g*_s*_{channel}.roi
│
├── roi_cpose/ -- (3')
│ └── YW001_g*_s*_{channel}.roi
│
├── resize/ (src for the allenccf)
│ ├── YW001_g*_s*_resize.tif -- (4)
│ │
│ └── processed/
│ ├── YW001_g*_s*_resize_processed.tif -- (5)
│ └── transformations/
│ ├── YW001_g*_s*_resize_processed_transformed.tif -- (6)
│ │
│ ├── YW001_g*_s*_resize_processed_transform_data.mat -- (7)
│ │
│ └── labelled_regions/
│ ├── {*channel}_roitable.csv -- (8)
│ └── parsed_data/
│ └── parsed_csv_merge.csv -- (9)
│
├── resize_overlap/* (optional) -- (10)
└── output_files/ (for generated figures or analysis outputs)
Placeholders#
g*: Index of glass slide.s*: Index of Slice .{channel}: Channel name (e.g.,r,g,b,o(overlap)).
Reference (1)–(10)#
raw/ — Raw confocal data (e.g.,
.lsm,.czi, or.tiff). (optional)zproj/ — Z-projection stacks. Must be RGB and saved per channel (
r,g,b,o).
3. roi/ — ROI files after ImageJ selection (.roi).
3’. roi_cpose/ — ROI files from the Cellpose pipeline (dev).
4. resize/ → *_resize.tif — Merged ROI, scaled RGB image for registration. Typically use blue (DAPI) as reference.
5. processed/ → *_resize_processed.tif — Contrast-adjusted and/or rotated image.
6. transformations/ → *_transformed.tif — Image after applying the transformation.
7. transformations/ → *_transform_data.mat — Transformation matrix/data for each slice.
8. labelled_regions/ → {*channel}_roitable.csv — AllenCCF output (per ROI).
9. labelled_regions/parsed_data/ → parsed_csv_merge.csv — Parsed & classified CSV for visualization.
10. resize_overlap/ — If overlap channels exist, mirror the same structure as r/g channels. Use the same transformation matrix. (optional)
Note
For (4): If channel count is limited, save overlap channels to a separate pseudo-color file, then apply the same transformation matrix during registration.
Ensure the DAPI (blue) channel is used as the registration reference unless otherwise specified.
Maintain consistent filename patterns to keep downstream parsing robust.