NAME¶
atlaslabeler - query stereotaxic atlases
SYNOPSIS¶
atlaslabeler [
OPTIONS] [
input_file.nii.gz]
OPTIONS¶
- --version
- show program's version number and exit
- -v VERBOSE, --verbose=VERBOSE,
--verbosity= VERBOSE
- Verbosity level of output
- -h, --help, --sos
- Show this help message and exit
- -a ATLASFILE,
--atlas-file=ATLASFILE
- Atlas file to use. Overrides --atlas-path and
--atlas
- --atlas-path=ATLASPATH
- Path to the atlas files. '%(name)s' will be replaced with
the atlas name. See -A. Defaults depend on the atlas family.
- -A ATLASNAME, --atlas=ATLASNAME
- Atlas to use. Choices: HarvardOxford-Subcortical, Juelich,
JHU-tracts, HarvardOxford-Cortical, MNI, talairach, Thalamus,
talairach-dist
- -i INPUTCOORDFILE,
--input-coordinates-file=INPUTCOORDFILE
- Fetch coordinates from ASCII file
- -o OUTPUTFILE,
--output-file=OUTPUTFILE
- Output file. Otherwise standard output
- -d MAXDISTANCE,
--max-distance=MAXDISTANCE
- When working with reference/distance atlases, what maximal
distance to use to look for the voxel of interest
- -T TRANSFORMATIONFILE,
--transformation-file=TRANSFORMATIONFILE
- First transformation to apply to the data. Usually should
be subject -> standard(MNI) transformation
- -s, --summary
- Either to create a summary instead of dumping voxels. Use
multiple -s for greater verbose summary
- --ss=SORTSUMMARYBY,
--sort-summary-by=SORTSUMMARYBY
- How to sort summary entries. a-p sorts anteriorposterior
order
- --dumpmap-file=DUMPMAPFILE
- If original data is given as image file, dump indexes per
each treholded voxels into provided here output file
- -l LEVELS, --levels=LEVELS
- Indexes of levels which to print, or based on which to
create a summary (for a summary levels=4 is default). To get listing of
known for the atlas levels, use '-l list'
- --mni2tal=MNI2TALTRANSFORMATION
- Choose between available transformations from mni 2
talairach space
- --thr=LOWERTHRESHOLD,
--lthr=LOWERTHRESHOLD,
--lower-threshold=LOWERTHRESHOLD
- Lower threshold for voxels to output
- --uthr=UPPERTHRESHOLD,
--upper-threshold= UPPERTHRESHOLD
- Upper threshold for voxels to output
- --abbr, --abbreviated-labels
- Manipulate with abbreviations for labels instead of full
names, if the atlas has such
- -c, --tc, --show-target-coord
- Show target coordinates
- --tv, --show-target-voxel
- Show target coordinates
- --rc, --show-referenced-coord
- Show referenced coordinates/distance in case if we are
working with reference atlas
- -C, --oc, --show-orig-coord
- Show original coordinates
- -V, --show-values
- Show values
- -I INPUTSPACE,
--input-space=INPUTSPACE
- Space in which input volume/coordinates provided in. For
instance Talairach/MNI
- -F, --forbid-direct-mapping
- If volume is provided it first tries to do direct mapping
voxel-2-voxel if there is no transformation file given. This option
forbids such behavior and does coordinates mapping anyway.
- -t, --talairach
- Coordinates are in talairach space (1x1x1mm), otherwise
assumes in mni space (2x2x2mm). Shortcut for '-I Talairach'
- -H, --half-voxel-correction
- Adjust coord by 0.5mm after transformation to Tal space.
Please use -H to turn such adjustment off
- -r, --relative-to-origin
- Coords are relative to the origin standard form ie in
spatial units (mm), otherwise the default assumes raw voxel
dimensions
- --input-line-format=INPUTLINEFORMAT
- Format of the input lines (if ASCII input is provided)
- -R REFERENCELEVEL,
--reference=REFERENCELEVEL
- Which level to reference in the case of reference
atlas
- --prob-thr=PROBTHR
- At what probability (in %) to threshold in probabilistic
atlases (e.g. FSL)
- --prob-strategy=PROBSTRATEGY
- What strategy to use for reporting. 'max' would report
single area (above threshold) with maximal probabilitity
EXAMPLES¶
bin/atlaslabeler
-s -A talairach-dist
-d 10
-R
Closest\ Gray
-l Structure,Brodmann\ area
-cC mask.nii.gz
produces a summary per each structure and brodmann area, for each voxel looking
within 10mm radius for the closest gray matter voxel.