.. _ahelp_3dproject:
*********
3dproject
*********
.. contents:: :local:

.. codeblock:: none
Projection along cardinal axes from a 3D dataset
Usage: 3dproject [editing options]
[summaxamaxsmax] [output root] [nsize] [mirror]
[RL {all  x1 x2}] [AP {all  y1 y2}] [IS {all  z1 z2}]
[ALL] dataset
Program to produce orthogonal projections from a 3D dataset.
sum ==> Add the dataset voxels along the projection direction
max ==> Take the maximum of the voxels [the default is sum]
amax ==> Take the absolute maximum of the voxels
smax ==> Take the signed maximum of the voxels; for example,
max ==> 7 and 2 go to 2 as the projected value
amax ==> 7 and 2 go to 7 as the projected value
smax ==> 7 and 2 go to 7 as the projected value
first x ==> Take the first value greater than x
nsize ==> Scale the output images up to 'normal' sizes
(e.g., 64x64, 128x128, or 256x256)
This option only applies to byte or short datasets.
mirror ==> The radiologists' and AFNI convention is to display
axial and coronal images with the subject's left on
the right of the image; the use of this option will
mirror the axial and coronal projections so that
left is left and right is right.
output root ==> Output projections will named
root.sag, root.cor, and root.axi
[the default root is 'proj']
RL all ==> Project in the RighttoLeft direction along
all the data (produces root.sag)
RL x1 x2 ==> Project in the RighttoLeft direction from
xcoordinate x1 to x2 (mm)
[negative x is Right, positive x is Left]
[OR, you may use something like RL 10R 20L
to project from x=10 mm to x=+20 mm ]
AP all ==> Project in the AnteriortoPosterior direction along
all the data (produces root.cor)
AP y1 y2 ==> Project in the AnteriortoPosterior direction from
ycoordinate y1 to y2 (mm)
[negative y is Anterior, positive y is Posterior]
[OR, you may use something like AP 10A 20P
to project from y=10 mm to y=+20 mm ]
IS all ==> Project in the InferiortoSuperior direction along
all the data (produces root.axi)
IS y1 y2 ==> Project in the InferiortoSuperior direction from
zcoordinate z1 to z2 (mm)
[negative z is Inferior, positive z is Superior]
[OR, you may use something like IS 10I 20S
to project from z=10 mm to z=+20 mm ]
ALL ==> Equivalent to 'RL all AP all IS all'
* NOTE that a projection direction will not be used if the bounds aren't
given for that direction; thus, at least one of RL, AP, or IS must
be used, or nothing will be computed!
* NOTE that in the directions transverse to the projection direction,
all the data is used; that is, 'RL 5 5' will produce a full sagittal
image summed over a 10 mm slice, irrespective of the IS or AP extents.
* NOTE that the [editing options] are the same as in 3dmerge.
In particular, the '1thtoin' option can be used to project the
threshold data (if available).
INPUT DATASET NAMES

This program accepts datasets that are modified on input according to the
following schemes:
'r1+orig[3..5]' {subbrick selector}
'r1+orig<100..200>' {subrange selector}
'r1+orig[3..5]<100..200>' {both selectors}
'3dcalc( a r1+orig b r2+orig expr 0.5*(a+b) )' {calculation}
For the gruesome details, see the output of 'afni help'.
++ Compile date = Feb 26 2020 {AFNI_20.0.18:linux_ubuntu_16_64}