Difference between revisions of "SNT: FAQ"

(General)
(Add FAQs on the project history)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 +
[[Category:SNT]][[Category:Neuroanatomy]]
 
{{SNTNavBar}}
 
{{SNTNavBar}}
 
 
== Tracing ==
 
== Tracing ==
 
<ol>
 
<ol>
Line 33: Line 33:
 
== General ==
 
== General ==
 
<ol>
 
<ol>
 +
<li>
 +
<span id="citing"></span>'''How do I cite SNT'''?
 +
</li>
 +
<dl><dd>
 +
SNT is based on multiple publications. To cite SNT:
 +
* Ferreira T, et al. ('''2019''') (TBD)
 +
To reference other plugins that enhance SNT:
 +
* '''[[Sholl Analysis]]''': Ferreira T, Blackman A, Oyrer J, Jayabal A, Chung A, Watt A, Sjöström J, van Meyel D. ('''2014'''), [http://www.nature.com/nmeth/journal/v11/n10/full/nmeth.3125.html Neuronal morphometry directly from bitmap images], ''Nature Methods'' 11(10): 982–984
 +
* '''[[SNT: Tubular Geodesics|Tubular Geodesics]]''': Türetken E, Benmansour F, Fua P. [https://infoscience.epfl.ch/record/176222/files/turetken_et_al_2012.pdf?version=1 Automated Reconstruction of Tree Structures using Path Classifiers and Mixed Integer Programming]. <i>IEEE Conference on Computer Vision and Pattern Recognition</i>, Providence, Rhode Island, 2012.
 +
To cite the original Simple Neurite Tracer publication:
 +
* Longair MH, Baker DA, Armstrong JD. [http://bioinformatics.oxfordjournals.org/content/early/2011/07/04/bioinformatics.btr390.long Simple Neurite Tracer: Open Source software for reconstruction, visualization and analysis of neuronal processes]. <i>Bioinformatics</i> 2011
 +
</dd></dl>
 +
<li>
 +
<span id="snt"></span>'''What is the difference between SNT and Simple Neurite Tracer'''?
 +
</li>
 +
<dl><dd>
 +
Simple Neurite Tracer was the first Fiji plugin dedicated to visualization and reconstruction of neurons, developed by [[User:Mark|Mark Longair]] and [[#citing|published in 2011]], to become the single most cited open-source software for semi-automated 3D reconstructions. In the wake of ImageJ2 development, a new team of developers lead by [[User:Tiago|Tiago Ferreira]] took on the effort of modernizing its code base. The project quickly snowballed beyond the re-write of the software, and focused on establishing a complete framework for reconstruction, visualization, quantification and modelling of neuronal morphology. Several name changes were proposed for this "next-gen" Simple Neurite Tracer (''Not so Simple Neurite Tracer'', ''Smart Neurite Tracer'', to name a few), but in the end it was decided to adopt the acronym of the original software, as an homage to Mark's outstanding work. You can follow the entire history of the plugin on {{GitHub|org=fiji|repo=Simple_Neurite_Tracer|label=GitHub}}.
 +
</dd></dl>
 
<li>
 
<li>
 
<span id="swc"></span>'''What is a SWC file'''?
 
<span id="swc"></span>'''What is a SWC file'''?

Latest revision as of 11:10, 15 August 2019

Home Manual Walk-throughs Screencasts Shortcuts Analysis Rec. Viewer SciView Cx3D Scripting FAQ



Tracing

  1. Having to confirm indivual segments is too cumbersome for me. Is it possible to trace without interruption, by clicking in succession?
  2. Yes. Uncheck the Confirm temporary segments in the Options tab (Temporay Paths section).
  3. How can I browse voxel intensities around processes?
  4. Righ-click on the image canvas and select Pause SNT from the contextual menu. Voxel intensities will be reported in the ImageJ status bar.
  5. Is there a way to process one image after another in a fast way?
  6. Yes. Have a look at these detailed instructions.
  7. How can I import an image sequence into SNT?
  8. Loading of images that require input options is handled by ImageJ directly. To load a directory of images (e.g., one file per Z-slice), run File ▷ Import ▷ Image Sequence and select the first file in the sequence, adjusting any needed parameters in the subsequent dialog prompt. Once the sequence is imported adjust voxel dimensions using Image ▷ Properties.... To save yourself from having to go through these steps again, you should save the imported stack as a single TIFF file using File ▷ Save As ▷ Tiff...


General

  1. How do I cite SNT?
  2. SNT is based on multiple publications. To cite SNT:
    • Ferreira T, et al. (2019) (TBD)
    To reference other plugins that enhance SNT: To cite the original Simple Neurite Tracer publication:
  3. What is the difference between SNT and Simple Neurite Tracer?
  4. Simple Neurite Tracer was the first Fiji plugin dedicated to visualization and reconstruction of neurons, developed by Mark Longair and published in 2011, to become the single most cited open-source software for semi-automated 3D reconstructions. In the wake of ImageJ2 development, a new team of developers lead by Tiago Ferreira took on the effort of modernizing its code base. The project quickly snowballed beyond the re-write of the software, and focused on establishing a complete framework for reconstruction, visualization, quantification and modelling of neuronal morphology. Several name changes were proposed for this "next-gen" Simple Neurite Tracer (Not so Simple Neurite Tracer, Smart Neurite Tracer, to name a few), but in the end it was decided to adopt the acronym of the original software, as an homage to Mark's outstanding work. You can follow the entire history of the plugin on GitHub.
  5. What is a SWC file?
  6. It is the most widely adopted format for encoding neuronal reconstructions, in which information is stored in plain text. It was first described by (Cannon et al., 1998) and since then became a somewhat loose lingua franca of a neuron's three dimensional structure. It is described in more detail here and here. SNT supports all known variants of the format including ESWC and SWC+. The extension stems from the last names of Stockley, Wheal, and Cole, who developed a neat computer system for reconstructing neuronal cells ( Stockley et al., 1993). Confusingly, it is also a deprecated file format used by Adobe.
  7. In which format should I save my tracings: TRACES or SWC?
  8. When tracing 4D or 5D images, TRACES is preferable because the channel and/or time frame associated with the data are stored. With simpler 2/3D images TRACES is also preferable to preserve Path Manager tags across restarts. Note that the Scripts ▶   provides a batch converter for TRACESSWC conversion. The following table summarizes the differences between the two formats:
    SWC TRACES
    No. reconstructions / file Only one. When multiple reconstructions exits, SNT splits them across multiple files appending unique suffixes to filenames Multiple reconstructions per file allowed
    Image metadata Only spatial calibration Stored. Including channel and frame of the traced structure
    Path Manager tags Not stored Stored
    Format Plain text XML or compressed XML (as per preferences)
    Presence Ubiquitous among reconstruction software Exlusive to SNT. But open and easily parsable
  9. How can I improve SNT documentation?
  10. Create an account on this wiki. Once you have created one, you can edit contents at will. Don't be shy. All changes are undoable!
Home Manual Walk-throughs Screencasts Shortcuts Analysis Rec. Viewer SciView Cx3D Scripting FAQ