Skip to content

Commit afe25b3

Browse files
authored
Merge pull request #440 from imagej/sntv5122
Sntv5122
2 parents a4f1e95 + ce42f1c commit afe25b3

5 files changed

Lines changed: 73 additions & 57 deletions

File tree

‎_pages/plugins/snt/big-data.md‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,11 +25,11 @@ The following operations are currently supported:
2525
| Manual and semi-automated tracing | Supported (experimental)<sup>1</sup> | Multi-dimensional images have not been thoroughly tested |
2626
| Automated tracing | Supported (experimental) | See [Auto-tracing](./auto-tracing#grayscale-images)<sup>1,2</sup> |
2727
| Tracing along way-points | Supported | |
28-
| [Path optimization](./manual#refinefit-) | Supported | |
28+
| [Path optimization](./manual#refinefit-) | Supported | See [Re-trace With A*](./manual#re-trace-with-a) |
2929
| 3D Visualization: Interactive re-slicing browser | Supported via [BigDataViewer](./manual#big-data-viewer) | |
3030
| 3D Visualization: Interactive volume viewer | Supported via [BigVolumeViewer](./manual#big-volume-viewer) and [sciview](./manual#sciview) | Includes [Slab View](#slab-view) for restricting rendering to a thin, adjustable region of the volume |
31-
| Stream-specific workflows | Supported (experimental) | [Materialized crops](./snt-stream#materialized-crops), [channel unmixing](./snt-stream#channel-unmixing), and [Quick Connect](./snt-stream#editing): see [SNT Stream](./snt-stream) |
32-
| Multidimensional operations | Limited support | Tracing handles one active channel/frame at a time for performance reasons. Commands that require exposing all channels/frames to be available at once [may not be supported](#limitations-and-idiosyncrasies) |
31+
| Stream-specific workflows | Supported (experimental) | [Materialized crops](./snt-stream#materialized-crops), [channel unmixing](./snt-stream#channel-unmixing), and [Quick Connect](./snt-stream#editing) |
32+
| Multidimensional operations | Limited support | Tracing handles one active channel/frame at a time for performance reasons. Commands that require exposing all channels/frames to be available at once may require [data crops](#limitations-and-idiosyncrasies) |
3333

3434
<sup>1</sup>For collaborative tracing, please use [HortaCloud](https://hortacloud.org/): This is SNT's development team recommended tool for tracing Terabyte-size datasets in a collaborative environment
3535

@@ -56,7 +56,7 @@ Choose _Big Data..._ from the [Shortcuts Window](./manual#snt-commands). In the
5656
|---|---|---|
5757
| **Display** | 3D volume rendering | Interactive reslicing |
5858
| **Hardware** | Discrete graphics card recommended | No GPU needed |
59-
| **[Slab View](#slab-view)** | Available | N/A |
59+
| **[Slab view](#slab-view)** | Available | N/A |
6060
| **[Channel unmixing](./snt-stream#channel-unmixing)** | Computed per slab | Live |
6161

6262
Choose BVV for sparsely labeled data, modern hardware, and a fast disk or network connection. Choose BDV for dense, feature-rich images, modest hardware, or slow connections.
@@ -65,14 +65,14 @@ Choose _Big Data..._ from the [Shortcuts Window](./manual#snt-commands). In the
6565

6666
- **Load Remote Demo**: Pre-fills all fields with a remote demo (marmoset neurons, OME-Zarr, with autotracings and soma markers, using BVV with tracing enabled)
6767

68-
All inputs can be local paths or remote URLs (including http and s3 links). Only _Main volume_ is mandatory.
6968

70-
{% include notice icon="info" content="**[SNT Stream](./snt-stream) remains experimental**." %}
69+
70+
{% include notice icon="info" content="**All inputs can be local paths or remote URLs. Only _Main volume_ is mandatory**." %}
7171

7272

7373
## Limitations and Idiosyncrasies
7474

75-
- **One channel/frame at a time**: for performance reasons, one channel/frame is streamed for tracing at once. Commands that require all channels/frames available simultaneously (e.g., [Multispectral Refinement](./manual#multispectral-refinement)) are not supported
75+
- **One channel/frame at a time**: for performance reasons, one channel/frame is streamed for tracing at once. Commands that require all channels/frames available simultaneously (e.g., [Multispectral Refinement](./manual#multispectral-refinement)) require [materialized regions](./manual#materialize-regions).
7676
- **Fixed search algorithm**: the A* search algorithm is used for interactive tracing; the alternate NBA*/Fast Marching options available for in-core images may not be offered in Stream mode
7777
- **Cached image statistics**: Access to cost-function tuning and [image-statistics options](./manual#algorithm-settings) remains available. However, since _Compute Now For Whole Image_ scans the entire streamed dataset once, it can be _slow_ depending on dataset size and network/disk speed. Use _Compute Real-Time_ (the default) instead: It recalculates local statistics as you trace new regions.
7878
- **3D Scene recentering on click**: whether/how the view recenters as you place tracing points is configurable from the toolbar's options menu (_Never_ / _Adaptive_ / _Always_). _Adaptive_ is the recommended default for streamed data: it skips recentering for clicks that already land close to the focal plane, and briefly gates subsequent clicks after a recenter fires, giving tile streaming time to catch up
@@ -96,13 +96,13 @@ Slab View switches itself off if the view no longer intersects the slab, and whe
9696
[Big volume viewer](./manual#big-volume-viewer) and [Big data viewer](./manual#big-data-viewer) are at the core of Big-data support. Standard formats (TIFF, and anything readable via [Bio-Formats](/formats/bio-formats)) are loaded as regular in-memory volumes, with an option to downsample automatically if a volume exceeds the GPU's 3D texture limits.
9797
Imaris (.ims) files are supported via an automatically generated BDV-XML sidecar written next to the original file.
9898

99-
For genuinely large datasets, BDV XML/HDF5, N5, and OME-Zarr/OME-NGFF containers are opened virtually: data is streamed from disk in blocks as needed. N5 and Zarr containers are read directly, with no XML sidecar required. Remote data can be also be loaded using URLs.
99+
For genuinely large datasets, BDV XML/HDF5, N5, and OME-Zarr containers are opened virtually: data is streamed from disk in blocks as needed. N5 and Zarr containers are read directly, with no XML sidecar required. Remote data can be also be loaded using URLs.
100100

101-
### Non-pyramidal and oversized volumes
101+
### Non-pyramidal and Oversized Volumes
102102

103103
BVV's 3D renderer requires a multi-resolution pyramid, and a single GPU texture has size limits. If the _Main volume_ does not satisfy these and BVV is chosen, SNT prompts you for how to proceed:
104104

105-
- **Non-pyramidal N5/Zarr**: Choose _Build Pyramid_ to have SNT compute the coarser levels on demand (volumes that fit in memory are first copied locally, which may take a while for remote datasets)
105+
- **Non-pyramidal Zarr/N5**: Choose _Build Pyramid_ to have SNT compute the coarser levels on demand (volumes that fit in memory are first copied locally, which may take a while for remote datasets)
106106
- **Image too large for a single GPU texture**: This happens when a dimension exceeds the 3D texture limit of your graphics card, or when the volume has too many voxels per channel. You can choose between:
107107
- _Downsample_: Shrinks the image so that it fits. Opens quickly, but fine detail is lost
108108
- _Load at full resolution_: Loads every voxel into memory as a tiled pyramid. Requires substantial memory, and is a rendering only: it cannot be used for tracing

‎_pages/plugins/snt/key-shortcuts.md‎

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ update-site: Neuroanatomy
1313

1414
{% include snt-modes %}
1515
{% capture version%}
16-
**This page was last revised for [version 5.0.13](https://github.com/morphonets/SNT/releases)**.
16+
**This page was last revised for [version 5.0.21](https://github.com/morphonets/SNT/releases)**.
1717
{% endcapture %}
1818
{% include notice icon="snt" content=version %}
1919

@@ -32,13 +32,12 @@ The [Command Palette](manual#command-palette) ({% include key keys='ctlcmd|Shift
3232
{% capture legend %}
3333
Unless marked, shortcuts work in all tracing canvases: the classic XY/ZY/XZ views and [SNT Stream](./snt-stream) (BDV/BVV). Marked shortcuts are limited to one of them:
3434

35-
| {{ crop }} | Requires an image loaded as an ImagePlus: the classic canvas, or a _materialized crop_ in [Stream Mode](./snt-stream) |
36-
| {{ stream }} |Stream Mode only |
35+
{{ crop }} → Requires an image fully loaded into memory: A traditional image or a [materialized regions](./manual#materialized-regions) in Stream mode<br>
36+
{{ stream }} → Stream Mode only
3737

38-
In Stream Mode, BDV/BVV's own shortcuts are retained unless noted otherwise. The full list of active shortcuts can be accessed from the options drop-down menu of the _Scene Controls_ widget of BDV/BVV.
39-
The [Legacy 3D Viewer](#legacy-3d-viewer) does not support most of the shortcuts listed here.
38+
In Stream Mode, BDV/BVV's own shortcuts are retained unless noted otherwise.
4039
{% endcapture %}
41-
{% include notice icon="info" content=legend %}
40+
{% include notice icon="snt-stream" content=legend %}
4241

4342

4443
### Interactive Prompt

0 commit comments

Comments
 (0)