-
Notifications
You must be signed in to change notification settings - Fork 1k
Add tutorial: Where to start with bioimage analysis in Galaxy #6603
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
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit
GTN Lint
🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 348 in f050a38
| | **{% tool [CellProfiler](https://usegalaxy.eu/root?tool_id=interactive_tool_cellprofiler) %}** | High-content screening & automation | Allows you to build a complex multi-step "pipeline" and run it on thousands of images consistently. | |
🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 381 in f050a38
| * **{% tool [QuPath IT](https://usegalaxy.eu/root?tool_id=interactive_tool_qupath) %}:** The gold standard for digital pathology. Use this for large tissue sections and to access **StarDist** segmentation. |
🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 382 in f050a38
| * **{% tool [Ilastik IT](https://usegalaxy.eu/root?tool_id=interactive_tool_ilastik) %}:** Best for "training by example"—manually paint a few cells to teach the computer how to segment the rest based on texture. |
🚫 [GTN Lint] <GTN:009> reported by reviewdog 🐶
This tool identifier looks incorrect, it doesn't have the right number of segments.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 383 in f050a38
| * **{% tool [Cellpose IT](https://usegalaxy.eu/root?tool_id=interactive_tool_cellpose) %}:** & **{% tool [Cellprofiler IT](https://usegalaxy.eu/root?tool_id=interactive_tool_cellprofiler) %}:** Useful for building and fine-tuning your parameters visually before running a massive batch job. |
🚫 [GTN Lint] <GTN:033> reported by reviewdog 🐶
The icon (param-conditional) could not be found, please add it to _config.yml.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 223 in f050a38
| > - {% icon param-conditional %} *"Type of image data to process"*: `2-D image data (or series thereof)` |
🚫 [GTN Lint] <GTN:033> reported by reviewdog 🐶
The icon (param-conditional) could not be found, please add it to _config.yml.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 225 in f050a38
| > - {% icon param-conditional %} *"Filter type"*: `Median` |
🚫 [GTN Lint] <GTN:033> reported by reviewdog 🐶
The icon (param-conditional) could not be found, please add it to _config.yml.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 246 in f050a38
| > - {% icon param-conditional %} *"Thresholding method"*: `Globally adaptive / Otsu` |
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 49 in f050a38
| **(To be add: image showing simple workflow 1. Raw image-Pixels, 2. Numerical Grid for intensities, 3. Data extraction, 4. Final Data)** |
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 64 in f050a38
| **(Add Pete B's Image from his book)** |
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 126 in f050a38
| **(Add example images of how two images that look the same to the human eye have different data)** |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 152 in f050a38
| ### Why use the Bio-Formats tool suite? |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 208 in f050a38
| ### Stage A: Pre-processing (cleaning) |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 339 in f050a38
| #### A. Standard tools (single images, high-performance & batch) |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 427 in f050a38
| ### 1. The "JPG" trap |
🚫 [GTN Lint] <GTN:046> reported by reviewdog 🐶
Please do not include an # Introduction section, it is unnecessary here, just start directly into your text. The first paragraph that is seen by our infrastructure will automatically be shown in a few places as an abstract.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Lines 1 to 2 in f050a38
| --- | |
| layout: tutorial_hands_on |
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit
GTN Lint
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 49 in 6128c35
| **(To be add: image showing simple workflow 1. Raw image-Pixels, 2. Numerical Grid for intensities, 3. Data extraction, 4. Final Data)** |
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 64 in 6128c35
| **(Add Pete B's Image from his book)** |
This looks like a heading, but isn't. Please use proper semantic headings where possible. You should check the heading level of this suggestion, rather than accepting the change as-is.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 126 in 6128c35
| **(Add example images of how two images that look the same to the human eye have different data)** |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 152 in 6128c35
| ### Why use the Bio-Formats tool suite? |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 208 in 6128c35
| ### Stage A: Pre-processing (cleaning) |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 339 in 6128c35
| #### A. Standard tools (single images, high-performance & batch) |
🚫 [GTN Lint] <GTN:028> reported by reviewdog 🐶
You have skipped a heading level, please correct this.
Listing of Heading Levels
# Introduction
# 1. Know your data (the “digital anatomy” of an image)
## Pixels and voxels
### Bit depth (the range)
### Spatial calibration (the size)
## The 5 dimensions (5D)
## Bit depth: why it matters for science
# 2. How to get your images into Galaxy
### Why use the Bio-Formats tool suite?
# 3. Before you begin: diagnose your data
# 4. The lifecycle of an analysis pipeline
### Stage A: Pre-processing (cleaning)
### Stage B: Segmentation (Defining objects)
### Stage B.2: The Region of Interest (ROI)
### Stage C: Post-processing (Refining)
### Stage D: Quantification (Extracting numbers)
### Stage E: Validation (The sanity check)
# 4. Finding your workflow: modality and tools
## The decision tree: your logical roadmap
## The Galaxy imaging toolbox
#### A. Standard tools (single images, high-performance & batch)
#### B. Interactive tools (Visual exploration)
### Identifying your modality
### Practice: applying the roadmap
# 6. Common pitfalls to avoid
### 1. The “JPG” trap
### 2. The “merged image” mistake
### 3. Ignoring Saturation
# Conclusion
# 7. Glossary of Bioimage Terms
# 8. Next Steps: Choose your Tutorial
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Line 427 in 6128c35
| ### 1. The "JPG" trap |
🚫 [GTN Lint] <GTN:046> reported by reviewdog 🐶
Please do not include an # Introduction section, it is unnecessary here, just start directly into your text. The first paragraph that is seen by our infrastructure will automatically be shown in a few places as an abstract.
training-material/topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Lines 1 to 2 in 6128c35
| --- | |
| layout: tutorial_hands_on |
…rial.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Updated tutorial content for clarity and structure.
kostrykin
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very cool, @dianichj! 🚀🪐
A few comments for Section 1 inside.
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
kostrykin
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Another iteration of Section 1 comments :)
| * A 2D grayscale image is a **matrix** (2D array): rows × columns | ||
| * A 2D color image is a **3D array**: rows × columns × channels (RGB) | ||
| * A 3D volume is a **3D array**: X × Y × Z | ||
| * A multi-dimensional hyperstack is a **tensor**: a multi-dimensional array (e.g., X × Y × Z × C × T) | ||
|
|
||
| Every point in that array—the **pixel** (2D) or **voxel** (3D)—is a data point representing the number of photons or the signal intensity detected at that specific coordinate. Understanding your "digital anatomy" means knowing exactly how those numbers were recorded, how they are organized across dimensions, how they are spaced and oriented in 3D space, and what the limitations of the employed imaging technique are (e.g., due to over/undersaturation that leads to clipped intensities). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Need to be a bit careful here, because you introduce RGB images as 3D, but then you say that 3D data uses voxels. Of course, this is not true for 2D RGB images. Maybe do something like:
| * A 2D grayscale image is a **matrix** (2D array): rows × columns | |
| * A 2D color image is a **3D array**: rows × columns × channels (RGB) | |
| * A 3D volume is a **3D array**: X × Y × Z | |
| * A multi-dimensional hyperstack is a **tensor**: a multi-dimensional array (e.g., X × Y × Z × C × T) | |
| Every point in that array—the **pixel** (2D) or **voxel** (3D)—is a data point representing the number of photons or the signal intensity detected at that specific coordinate. Understanding your "digital anatomy" means knowing exactly how those numbers were recorded, how they are organized across dimensions, how they are spaced and oriented in 3D space, and what the limitations of the employed imaging technique are (e.g., due to over/undersaturation that leads to clipped intensities). | |
| * A **2D grayscale image** is a **2D array** (matrix): rows × columns | |
| * A **2D color image** is a **3D array** (tensor): rows × columns × channels (RGB) | |
| * A **3D grayscale image (volume)** is a **3D array**: X × Y × Z | |
| * A **3D color image (volume)** is a **4D array**: X × Y × Z × C | |
| * A multi-dimensional hyperstack is a **tensor**: a multi-dimensional array (e.g., X × Y × Z × C × T) | |
| Every point in that array—the **pixel** (2D) or **voxel** (3D)—is a data point representing the number of photons or the signal intensity detected at that specific coordinate. Understanding your "digital anatomy" means knowing exactly how those numbers were recorded, how they are organized across dimensions, how they are spaced and oriented in 3D space, and what the limitations of the employed imaging technique are (e.g., due to over/undersaturation that leads to clipped intensities). |
But actually, instead of the enumeration, I think it would be clearer if there was a small table like:
| Image data | Technical representation | Example |
|---|---|---|
| 2D grayscale image | 2D array (matrix) | rows × columns |
| 2D color image | 3D array (tensor) | rows × columns × channels (RGB) |
| 3D grayscale image (volume) | 3D array (tensor) | slices × rows × columns |
| 3D color image (volume) | 4D array (tensor) | slices × rows × columns × channels (RGB) |
| … | … | … |
…and then mention in a brief sentence that ≥4D images are generally called hyperstacks.
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
| * In **8-bit**, with only 256 possible values, stretching creates more pronounced "gaps" in your histogram (quantization artifacts), potentially making your data distribution appear discontinuous. | ||
| * In **16-bit integer**, with 65,536 possible values, the same stretching operation creates smaller relative gaps. While quantization artifacts still occur, they are far less severe and less likely to impact downstream quantitative analysis ({% cite Cromey2010 %}). | ||
|
|
||
| The key difference is not whether artifacts appear, but their **magnitude relative to your data range**. Think of it this way: spreading 256 values across a wider range creates larger "jumps" between adjacent intensity levels than spreading 65,536 values across the same range. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| The key difference is not whether artifacts appear, but their **magnitude relative to your data range**. Think of it this way: spreading 256 values across a wider range creates larger "jumps" between adjacent intensity levels than spreading 65,536 values across the same range. | |
| The key difference is not whether artifacts appear, but their **magnitude in relation to your data range**. Think of it this way: spreading 256 values across a wider range creates larger "holes" between adjacent intensity levels than spreading 65,536 values across the same range. |
| * **8-bit:** $2^{8} = 256$ discrete levels ($0–255$). While this looks fine to our eyes, it is often too "coarse" for thorough quantitative analysis. | ||
| * **16-bit:** $2^{16} = 65,536$ discrete levels ($0–65,535$). This is the **scientific gold standard for acquisition** because it allows you to detect subtle differences in image intensities that would be lost (e.g., due to rounding) when using an 8-bit representation (e.g., {% cite Haase2022 %}). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It would be good to also briefly mention 32-bit integers. I think the exact numbers are not that important. The tutorial is going to serve as an introductory text, not as a technical reference sheet, right? Such details can still be researched by the readers on their own, when required. Of course, you can still include those numbers, if you want, but I think you don't need to.
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
| * **The Basics:** [Introduction to Image Analysis]({% link topics/imaging/tutorials/imaging-introduction/tutorial.md %}) – A deeper dive into the fundamental concepts of digital images. | ||
|
|
||
| * **Fluorescence & Screening:** [HeLa Cell Screen Analysis]({% link topics/imaging/tutorials/hela-screen-analysis/tutorial.md %}) – Learn to process high-throughput screens using classical techniques. | ||
|
|
||
| * **Time-Lapse & Events:** [Detection of MitoFlashes]({% link topics/imaging/tutorials/detection-of-mitoflashes/tutorial.md %}) – Track transient biological events over time. | ||
|
|
||
| * **Classical Segmentation:** [Voronoi-based Segmentation]({% link topics/imaging/tutorials/voronoi-segmentation/tutorial.md %}) – A powerful approach for partitioning cells when they are touching but have clear centers. | ||
|
|
||
| * **Advanced AI:** [Imaging using Bioimage Zoo Models]({% link topics/imaging/tutorials/process-image-bioimageio/tutorial.md %}) – Use pre-trained deep learning models for complex segmentation tasks. | ||
|
|
||
| * **Automated Pipelines:** [CellProfiler in Galaxy]({% link topics/imaging/tutorials/tutorial-CP/tutorial.md %}) – Master the use of CellProfiler modules to build end-to-end automated workflows. | ||
|
|
||
| * **Tracking:** [Object Tracking using CellProfiler]({% link topics/imaging/tutorials/object-tracking-using-cell-profiler/tutorial.md %}) – Move from static images to following individual objects through time and space. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Some cosmetics: {% icon level %} looks like 🎓
Seems to be kind of a good practice to use these when linking to other tutorials: https://training.galaxyproject.org/training-material/topics/single-cell/tutorials/scrna-case_alevin/tutorial.html#warning-for-the-bench-scientists-and-biologists
Full list of GTN icons is available here: https://training.galaxyproject.org/training-material/topics/contributing/tutorials/create-new-tutorial-content/tutorial.html#icons
| * **The Basics:** [Introduction to Image Analysis]({% link topics/imaging/tutorials/imaging-introduction/tutorial.md %}) – A deeper dive into the fundamental concepts of digital images. | |
| * **Fluorescence & Screening:** [HeLa Cell Screen Analysis]({% link topics/imaging/tutorials/hela-screen-analysis/tutorial.md %}) – Learn to process high-throughput screens using classical techniques. | |
| * **Time-Lapse & Events:** [Detection of MitoFlashes]({% link topics/imaging/tutorials/detection-of-mitoflashes/tutorial.md %}) – Track transient biological events over time. | |
| * **Classical Segmentation:** [Voronoi-based Segmentation]({% link topics/imaging/tutorials/voronoi-segmentation/tutorial.md %}) – A powerful approach for partitioning cells when they are touching but have clear centers. | |
| * **Advanced AI:** [Imaging using Bioimage Zoo Models]({% link topics/imaging/tutorials/process-image-bioimageio/tutorial.md %}) – Use pre-trained deep learning models for complex segmentation tasks. | |
| * **Automated Pipelines:** [CellProfiler in Galaxy]({% link topics/imaging/tutorials/tutorial-CP/tutorial.md %}) – Master the use of CellProfiler modules to build end-to-end automated workflows. | |
| * **Tracking:** [Object Tracking using CellProfiler]({% link topics/imaging/tutorials/object-tracking-using-cell-profiler/tutorial.md %}) – Move from static images to following individual objects through time and space. | |
| * **The Basics:** {% icon level %} [Introduction to Image Analysis]({% link topics/imaging/tutorials/imaging-introduction/tutorial.md %}) – A deeper dive into the fundamental concepts of digital images. | |
| * **Fluorescence & Screening:** {% icon level %} [HeLa Cell Screen Analysis]({% link topics/imaging/tutorials/hela-screen-analysis/tutorial.md %}) – Learn to process high-throughput screens using classical techniques. | |
| * **Time-Lapse & Events:** {% icon level %} [Detection of MitoFlashes]({% link topics/imaging/tutorials/detection-of-mitoflashes/tutorial.md %}) – Track transient biological events over time. | |
| * **Classical Segmentation:** {% icon level %} [Voronoi-based Segmentation]({% link topics/imaging/tutorials/voronoi-segmentation/tutorial.md %}) – A powerful approach for partitioning cells when they are touching but have clear centers. | |
| * **Advanced AI:** {% icon level %} [Imaging using Bioimage Zoo Models]({% link topics/imaging/tutorials/process-image-bioimageio/tutorial.md %}) – Use pre-trained deep learning models for complex segmentation tasks. | |
| * **Automated Pipelines:** {% icon level %} [CellProfiler in Galaxy]({% link topics/imaging/tutorials/tutorial-CP/tutorial.md %}) – Master the use of CellProfiler modules to build end-to-end automated workflows. | |
| * **Tracking:** {% icon level %} [Object Tracking using CellProfiler]({% link topics/imaging/tutorials/object-tracking-using-cell-profiler/tutorial.md %}) – Move from static images to following individual objects through time and space. |
| Galaxy is built to handle the complexity of biological data. However, microscopy images often come in "vendor-specific" formats. Your entry point into Galaxy depends on how your data was saved: | ||
|
|
||
| * **Standard Formats (.tiff, .png):** Use the standard Galaxy **Upload** tool. | ||
| * **Proprietary Formats (.czi, .nd2, .lif):** These formats "wrap" image data and metadata together. While you can often export TIFFs from your microscope software, using the **{% tool [Convert image format with Bioformats](toolshed.g2.bx.psu.edu/repos/imgteam/bfconvert/ip_convertimage/6.7.0+galaxy3) %}** tool allows Galaxy to "unlock" and standardize the metadata hidden inside these files ({% cite Moore2021 %}). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would also mention ome.tiff here as an open file format including metadata, and if you cite Moore et al. here, it would be good to mention OME-zarr already here, altough it is explained in more detail below.
|
|
||
| * **Standard Formats (.tiff, .png):** Use the standard Galaxy **Upload** tool. | ||
| * **Proprietary Formats (.czi, .nd2, .lif):** These formats "wrap" image data and metadata together. While you can often export TIFFs from your microscope software, using the **{% tool [Convert image format with Bioformats](toolshed.g2.bx.psu.edu/repos/imgteam/bfconvert/ip_convertimage/6.7.0+galaxy3) %}** tool allows Galaxy to "unlock" and standardize the metadata hidden inside these files ({% cite Moore2021 %}). | ||
| * **OMERO Integration:** If your institution uses an **OMERO server**, you can import images directly via the **Remote Files** section in the upload tool. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe reference the tutorial on OMERO here?
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
| - **What is the biological subject?** (Individual cells, complex tissues, or subcellular structures?) | ||
| - **What is the file format?** (Standard formats like .tif and .png, or proprietary vendor formats like .czi, .nd2, or .lif?) | ||
| - **Where is the data stored?** (A local drive, an OMERO server, a public repository, or a remote URL?) | ||
|
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would add that here one would also need to think what you need to quantify.
Then, define your quantitative goals:
- **What do you want to measure?** (Cell count? Nuclear size? Protein intensity? Colocalization? Movement over time?)
- **What level of detail do you need?** (Measurements per object, summary statistics across many objects, or maps of where things are located?)
- **What comparison will you make?** (Differences between conditions, changes across time, or descriptive characterization?)
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
topics/imaging/tutorials/where-to-start-bioimaging-galaxy/tutorial.md
Outdated
Show resolved
Hide resolved
| * **Label Images:** A "smart map" where every individual ROI has its own unique integer ID ({% cite Tosi2021 %}). | ||
|
|
||
| > <comment-title>ROIs in interactive vs. automated tools</comment-title> | ||
| > In interactive tools like **QuPath**, you often draw ROIs by hand with a mouse. In automated Galaxy workflows, we use algorithms like **Cellpose** to "draw" thousands of ROIs instantly and reproducibly ({% cite Stringer2021 %}). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"you can draw ROIs" ; I would say Qupath often also uses automatic ROI creation
|
@dianichj Very nice tutorial! |
Thanks a lot @maartenpaul ! Very useful comments, I will try to address them all today. |
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
…rial.md Co-authored-by: Leonid Kostrykin <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
…rial.md Co-authored-by: Maarten Paul <[email protected]>
Co-authored-by: Leonid Kostrykin <[email protected]>
Summary
Hi everyone! 👋 This PR adds a tutorial for the GTN Imaging section: “Where to start with bioimage analysis in Galaxy.” It’s intended to be the foundational “compass” tutorial—a bridge for newcomers to move from viewing images as "pictures" to treating them as quantitative data. It complements the existing intro and emphasizes FAIR-by-design principles within Galaxy.
Linked to issue: #36
What’s included
Supporting Files
tutorial.bib: Might need a few more citations or formatting tweaks.data-library.yaml: Still needs the example datasets configuration.faqs/index.md&workflows/index.md: Basic structures are in place.Status: Work in Progress 🧪
This is a functional draft, but still needs some love:
Review Focus 🔍
I’d love to get your thoughts on:
Checklist
data-library.yaml.Thanks a lot for your time and feedback! I'm really looking forward to your ideas and collaboration to make this better. 🚀
@beatrizserrano
@kostrykin
@rmassei