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

SNT pages: aggregate media in common directory/retire old files #359

Merged
merged 1 commit into from
Jan 14, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions _pages/plugins/sholl-analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,16 @@ nav-links:
url: /plugins/snt/index
- title: Analysis
url: /plugins/snt/analysis
- title: Contributing
url: /plugins/snt/contribute
- title: Extending
url: /plugins/snt/extending
- title: FAQ
url: /plugins/snt/faq
- title: Shortcuts
- title: Hotkeys
url: /plugins/snt/key-shortcuts
- title: Machine Learning
url: /plugins/snt/machine-learning
- title: Manual
url: /plugins/snt/manual
- title: Metrics
Expand All @@ -30,8 +34,12 @@ nav-links:
url: /plugins/snt/screencasts
- title: Scripting
url: /plugins/snt/scripting
- title: Walk‑throughs
- title: Sholl
url: /plugins/snt/sholl
- title: Strahler
url: /plugins/snt/strahler
- title: Walkthroughs
url: /plugins/snt/walkthroughs
---

This page has moved [here](/plugins/snt/sholl-analysis).
This page has moved [here](/plugins/snt/sholl).
2 changes: 1 addition & 1 deletion _pages/plugins/snt/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,4 +82,4 @@ SNT's documentation is extensive. Please use the navigation bar on top of the pa
## References

[^1]: {% include citation id='plugins/snt' %}
[^2]: {% include citation id='plugins/sholl-analysis' %}
[^2]: {% include citation id='plugins/snt/sholl' %}
14 changes: 7 additions & 7 deletions _pages/plugins/snt/sholl.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,13 +41,13 @@ After [installing SNT](/plugins/snt/#installation), Sholl commands can be access
{% include gallery align="center" content=
"
/media/plugins/snt/sholl-analysis-outputs.png | Overview of outputs: Linear and log-log profile (Sholl decay calculation), detailed and summary tables. ‘Traditional’ plots are obtained by disabling curve-fitting altogether
/media/plugins/bitmapsholl-ca1mask.png | [Skeletonized](/plugins/skeletonize3d) hippocampal CA1 cell[^8] in which apical and basal dendrites have been analyzed [separately](#ca1-cell-plot) and [color coded](#output-options) according to their Sholl profile. Warmer hues indicate higher number of Intersections (*N*). [Critical radius](#critical-radius) (*r<sub>c</sub>*) and [Mean value](#mean-value-of-function) (*N<sub>av</sub>*) are indicated.
/media/plugins/bitmapsholl-ca1compartment.png | Linear plot for the same CA1 cell[^8]. Using the soma as center, image was sampled twice using [hemishells](#hemishells) in order to segregate apical from basal dendrites. For clarity, distances for basal branches were assigned negative values and arbor overlaid (in green) over the profile.
/media/plugins/combineshollprofiles.png | *Combine Sholl Profiles...* aggregates individual profiles into a single plot, obtaining the average profile for groups of cells [[use case](https://forum.image.sc/t/sholl-merging-profiles-with-different-radii/54144/13)]
/media/plugins/snt/bitmapsholl-ca1mask.png | [Skeletonized](/plugins/skeletonize3d) hippocampal CA1 cell[^8] in which apical and basal dendrites have been analyzed [separately](#ca1-cell-plot) and [color coded](#output-options) according to their Sholl profile. Warmer hues indicate higher number of Intersections (*N*). [Critical radius](#critical-radius) (*r<sub>c</sub>*) and [Mean value](#mean-value-of-function) (*N<sub>av</sub>*) are indicated.
/media/plugins/snt/bitmapsholl-ca1compartment.png | Linear plot for the same CA1 cell[^8]. Using the soma as center, image was sampled twice using [hemishells](#hemishells) in order to segregate apical from basal dendrites. For clarity, distances for basal branches were assigned negative values and arbor overlaid (in green) over the profile.
/media/plugins/snt/combineshollprofiles.png | *Combine Sholl Profiles...* aggregates individual profiles into a single plot, obtaining the average profile for groups of cells [[use case](https://forum.image.sc/t/sholl-merging-profiles-with-different-radii/54144/13)]
/media/plugins/snt/sholl-group-statistics.png | Statistics for [groups of cells](/plugins/snt/analysis#comparing-reconstructions) [[use case](https://forum.image.sc/t/sholl-analysis-with-snt-one-graph-for-two-groups/82471/2)]
/media/plugins/animatedpolyfit.gif | Sampled data can be fitted to polynomials of varying degree (animation created using [BAR](/plugins/bar))
/media/plugins/snt/animatedpolyfit.gif | Sampled data can be fitted to polynomials of varying degree (animation created using [BAR](/plugins/bar))
/media/plugins/snt/sholl-convex-hull.png | Scripting allows for arbitrary focal points, in this case the centroid of the neuron's convex hull (*Convex Hull as Center* template script)
/media/plugins/shollresultasrois.png | Intersection points and sampling shells can be retrieved as ROIs. Intersection points are placed at edges of detected clusters of foreground pixels, not their center.
/media/plugins/snt/shollresultasrois.png | Intersection points and sampling shells can be retrieved as ROIs. Intersection points are placed at edges of detected clusters of foreground pixels, not their center.
/media/plugins/snt/sholl-rasterized-shells.png | Using Sholl to measure the distribution of image objects (_Sholl Rasterize Shells_ template script) [[use case](https://forum.image.sc/t/measuring-distribution-of-object-diameters-in-different-stripes-using-sholl-plugin/51087)]
/media/plugins/snt/snt-sholl-integrate-density-profiles.png | Not only neurons: Integrated-density profiles can be used to obtain radial maps of fluorescent markers.
"
Expand All @@ -74,7 +74,7 @@ The center of analysis can be specified using one of three possibilities:

3. Multipoint selection:A Multi-point selection (multipoint counter) in which the first point marks the center of analysis while the remaining points mark (count) the number of primary branches required for the calculation of [ramification indices](#schoenen-sampled)). Suitable for cases in which [inference from starting radius](#primary-branches) is not effective.

{% include img align="center" name="sholl plots" src="/media/plugins/shollanalysisstartuprois.png" %}
{% include img align="center" name="sholl plots" src="/media/plugins/snt/shollanalysisstartuprois.png" %}

Three types of ROIs expected by the plugin when analyzing images directly. <b>Left</b>: Line defining center of analysis (focal point), hemisphere restriction and ending radius. <b>Middle</b>: Single point defining center of analysis. <b>Right</b>: Multi-point selection in which the first point defines the focal point while the remaining points (2 to 5) serve as counters for primary neurites.

Expand Down Expand Up @@ -249,7 +249,7 @@ Detailed control over polynomial fitting is controlled by the options in the *Op

# Sholl Plots

{% include img align="center" name="sholl plots" src="/media/plugins/shollplots.png" %}
{% include img align="center" name="sholl plots" src="/media/plugins/snt/shollplots.png" %}

***Linear*, *Linear-norm*, *Semi-log* and *Log-log* profiles for the ddaC cell ({% include bc path='File|Open Samples|ddaC Neuron'%}), version 3.0**. Most of the retrieved [metrics](#metrics-based-on-fitted-data) are automatically highlighted by the plugin. *Linear profile*: [Mean value](#mean-value-of-function) (horizontal grid line) and [Centroid](#centroid) (colored mark). Logarithmic profiles: The [Sholl regression coefficient](#sholl-decay) (also known as Sholl decay) can be retrieved by linear regression using either the full range of data (blue line) or data within percentiles 10–90 (red line). For this particular cell type, the Semi-log method is more [informative](#dratio) when compared to the Log-log method.

Expand Down
12 changes: 6 additions & 6 deletions _pages/plugins/snt/strahler.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,11 @@ doi: 10.1038/s41592-021-01105-7
There are several entry points to Strahler Analysis in SNT. You can find those in the _Neuroanatomy Shortcuts_ panel ({% include bc path='Plugins|Neuroanatomy|'%} or "SNT" icon in Fiji's toolbar):
<br/>
<ol>
<li><i>Strahler Analysis (Image)...</i> Direct parsing of skeletonized images, bypassing tracing</li>
<li><i>Strahler Analysis (Tracings)...</i> Parsing of traced structures</li>
<li><i>Strahler Analysis (Image)...</i> Direct parsing of skeletonized images, bypassing tracing (described on this page)</li>
<li><i>Strahler Analysis (Tracings)...</i> Parsing of traced structures (described in
<a href="/plugins/snt/analysis#strahler-analysis">Analysis › Strahler (Tracings)</a>)</li>
<li><i>Strahler Analysis Scripts</i> Batch processing of files</li>
</ol>
This documentation page is mainly focused on _Strahler Analysis (Image)..._.
{% endcapture %}
{% include notice icon="info" content=strahler %}

Expand All @@ -29,7 +29,7 @@ While _Strahler Analysis (Image)..._ remains a functional workflow, you may find
{% endcapture %}
{% include notice icon="warning" background-color="#fffbeb" content=strahler %}

{% include img align="right" src="/media/plugins/strahler-classification-example.png" caption="Strahler classification"%}
{% include img align="right" src="/media/plugins/snt/strahler-classification-example.png" caption="Strahler classification"%}
Strahler numbering is a numerical procedure that summarizes the branching complexity of mathematical trees. It is described in detail [here](./analysis#strahler-analysis).

## Description
Expand All @@ -47,7 +47,7 @@ Strahler numbering is a numerical procedure that summarizes the branching comple
**Infer root end-points from rectangular ROI**: This option is only available when a rectangular ROI is present. It is described in [root detection](#root-detection).

<span id="strahler-animation">
{% include img align="right" width="300" name="Strahler Analysis by iterative elimination of end-point branches" src="/media/plugins/strahleranimation.gif" caption="Direct analysis of images occurs through progressive pruning of terminal branches, *iterative tree simplification*, a method that requires detecting all terminal branches (i.e., branches that contain an end-point) and all the degree-one paths leading to them." %}
{% include img align="right" width="300" name="Strahler Analysis by iterative elimination of end-point branches" src="/media/plugins/snt/strahleranimation.gif" caption="Direct analysis of images occurs through progressive pruning of terminal branches, *iterative tree simplification*, a method that requires detecting all terminal branches (i.e., branches that contain an end-point) and all the degree-one paths leading to them." %}

**Ignore single-point arbors (Isolated pixels)** Elimination of end-point branches may give rise to single point arbors. Such 'debris' have 1 end-point but no slab branches or junctions. When this option is selected, single-point arbors will be discarded on each iteration. If deselected, the total number of end-points may be overestimated.

Expand All @@ -66,7 +66,7 @@ Strahler numbering is a numerical procedure that summarizes the branching comple

## Root Detection

{% include img align="right" width="600px" src="/media/plugins/strahler-rootprotection.png" caption="**Left**: Arbor with rectangular ROI containing root. **Middle**: Analysis ignores ROI. Root-branch is interpreted as any other terminal-branch and the resulting classification is inaccurate. **Right**: Analysis takes ROI into account and infers that the end-point contained by the ROI is the root of the structure. Root branch is excluded from the iteration and the classification is accurate." %}
{% include img align="right" width="600px" src="/media/plugins/snt/strahler-rootprotection.png" caption="**Left**: Arbor with rectangular ROI containing root. **Middle**: Analysis ignores ROI. Root-branch is interpreted as any other terminal-branch and the resulting classification is inaccurate. **Right**: Analysis takes ROI into account and infers that the end-point contained by the ROI is the root of the structure. Root branch is excluded from the iteration and the classification is accurate." %}

The problem with undiscriminated elimination of terminal branches is that a root-branch containing an end-point is always eliminated on the first iteration step. In order to protect root branches from elimination, *Strahler Analysis* needs to know where root branches are located. Root-detection is implemented by means of a rectangular ROI containing the root branch and by activating the *Infer root end-points from rectangular ROI* option. Here is an example:

Expand Down
15 changes: 11 additions & 4 deletions _pages/plugins/strahler-analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
title: SNT › Strahler Analysis (From Images)
categories: [Skeleton,Analysis,Neuroanatomy]
tags: strahler,plugin,arbor,neuron,morphometry,dendrite
update-site: Neuroanatomy
artifact: org.morphonets:SNT
forum-tag: strahler-analysis
icon: /media/icons/snt.png
Expand All @@ -12,12 +11,16 @@ nav-links:
url: /plugins/snt/index
- title: Analysis
url: /plugins/snt/analysis
- title: Contributing
url: /plugins/snt/contribute
- title: Extending
url: /plugins/snt/extending
- title: FAQ
url: /plugins/snt/faq
- title: Shortcuts
- title: Hotkeys
url: /plugins/snt/key-shortcuts
- title: Machine Learning
url: /plugins/snt/machine-learning
- title: Manual
url: /plugins/snt/manual
- title: Metrics
Expand All @@ -30,8 +33,12 @@ nav-links:
url: /plugins/snt/screencasts
- title: Scripting
url: /plugins/snt/scripting
- title: Walk‑throughs
url: /plugins/snt/Walkthroughs
- title: Sholl
url: /plugins/snt/sholl
- title: Strahler
url: /plugins/snt/strahler
- title: Walkthroughs
url: /plugins/snt/walkthroughs
---


Expand Down
File renamed without changes
Loading