Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add annotation naming scheme #21

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

add annotation naming scheme #21

wants to merge 2 commits into from

Conversation

jssyq
Copy link

@jssyq jssyq commented Oct 4, 2024

No description provided.

@@ -139,6 +139,20 @@ This directory contains microscopy data files [as described in detail in the BID

In this example the data include images (`.tif`) and metadata (`.json`) from multiple brain sections. For each section there is a blockface photo (`_photo`) and a histological stain (`_stain`). Sections from Ken1 and Ken2 were either processed with a Nissl stain and imaged under brightfield microscopy (`_BF`), or processed for the fluorescent tracer Lucifer Yellow (`LY`) and imaged under darkfield microscopy (`_DF`). Additional sections from Ken2 were processed for the fluorescent tracer Fluoro-Ruby (`FR`) and imaged under darkfield microscopy (`_DF`).


#### high-res histology annotation
Copy link
Member

@kabilar kabilar Oct 15, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @jssyq. Do we also want to have a sidecar <matches>.tsv file or top-level dseg.tsv that specifies how the integer values of the segmentations map to custom labels? For example, in our case the labels could correspond to the different injection sites (or however we name the Segments in Webknossos).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

BIDS spec on custom labels.

dataset name + _suffix
when annotating discrete segmentations, use _dseg as the suffix.

When there are multiple annotators working on the same dataset, each annotation file is distinguish by adding a _desc-[label] entity before the suffix, where [label] is replaced by the annotator's initials.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When there are multiple annotators working on the same dataset, each annotation file is distinguish by adding a _desc-[label] entity before the suffix, where [label] is replaced by the annotator's initials.
When there are multiple annotators working on the same dataset, each annotation file is distinguish by adding a `_desc-[label]` entity before the suffix, where `[label]` is replaced by the annotator's initials.


When there are multiple annotators working on the same dataset, each annotation file is distinguish by adding a _desc-[label] entity before the suffix, where [label] is replaced by the annotator's initials.

For example, an annotator with an initial JS would name the annotation file as sub-MR243_sample-slice0000slice0004_stain-LY_DF_desc-JS_dseg
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For example, an annotator with an initial JS would name the annotation file as sub-MR243_sample-slice0000slice0004_stain-LY_DF_desc-JS_dseg
For example, an annotator with an initial JS would name the annotation file as follows:
`sub-MR243_sample-slice0000slice0004_stain-LY_DF_desc-JS_dseg.ome.zarr`

Comment on lines +146 to +148
All annotation files use the following naming scheme:
dataset name + _suffix
when annotating discrete segmentations, use _dseg as the suffix.
Copy link
Member

@kabilar kabilar Oct 15, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
All annotation files use the following naming scheme:
dataset name + _suffix
when annotating discrete segmentations, use _dseg as the suffix.
All annotation files use the following naming scheme:
`<dataset-name>_suffix.ome.zarr`
When annotating discrete segmentations, use `_dseg` as the suffix (see the [BIDS spec on discrete segmentations](https://bids-specification.readthedocs.io/en/stable/derivatives/imaging.html#discrete-segmentations)).

Comment on lines +146 to +148
All annotation files use the following naming scheme:
dataset name + _suffix
when annotating discrete segmentations, use _dseg as the suffix.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will we know ahead of time which datasets will have multiple annotators? If not, perhaps we should always add the annotator's initials to the file name?

Copy link
Member

@kabilar kabilar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you, @jssyq. I have a few suggestions above.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants