nat: NeuroAnatomy Toolbox
An R package for the (3D) visualisation and analysis of biological image data, especially tracings of single neurons. nat is the core package of a wider suite of neuroanatomy tools introduced at http://jefferislab.github.io. nat (and its ancestors) have been used in a number of papers from our group including:
For the impatient ...
# install install.packages("nat") # use library(nat) # plot some test data (?kcs20 for details) # Drosophila Kenyon cells processed from raw data at http://flycircuit.tw head(kcs20) open3d() plot3d(kcs20, col=type) # get help ?nat
A confirmed stable version of nat can be installed from CRAN.
However, nat remains under quite active development, so if you will be using nat extensively, we generally recommend installing the latest development version directly from github using the devtools package.
# install devtools if required if (!requireNamespace("devtools")) install.packages("devtools") # then install nat devtools::install_github("jefferis/nat")
To get an idea of what nat can do:
- Skim through the Articles listed at http://jefferis.github.io/nat/
- Take a look at the R Markdown reports used to generate the figures for our NBLAST paper.
When you're ready to learn more:
- Read the overview package documentation
- Read the [Introduction to neurons](http://jefferis.github.io/nat/articles/neurons-intro.html article)
- Check out the thematically organised function reference documentation.
- Most help pages include examples.
- Try out sample code:
If you want some help using nat:
- For installation issues, see the Installation vignette
- Contact nat-user Google group - we normally respond promptly and you will also be helping future users.
If you think that you have found a bug:
- Install the development version of nat using devtools (see above) and see if that helps.
- Check the github issues and
- file a bug report if this seems to be a new problem
- comment on an existing bug report
Thanks for your interest in nat!