AFNI HISTORY
level 3 and higher
The levels of importance go from 1 to 5, with meanings:
1 - users would not care
2 - of little importance, though some users might care
3 - fairly important
4 - a big change or new program
5 - IMPORTANT: we expect users to know
generated via the command : afni_history -html -reverse -min_level 3
---- log of AFNI updates (most recent first) ----
17 Nov 2009, ZS Saad, suma, level 3 (MAJOR), type 2 (NEW_OPT)
SUMA now handles labeled datatets in a special manner
An example of a labeled dataset would be FreeSurfer's annotation files.
If an annotation file is present in the spec file (@SUMA_Make_Spec_FS),
SUMA will display it as part of the background.
You can chose to display the labeled dataset in color, contours, or both.
Data from labeled datasets is now shown under the 'Lbl' field in the
surface controller's Xhair block.
19 Oct 2009, DR Glen, align_epi_anat.py, level 3 (MAJOR), type 2 (NEW_OPT)
New master options, dset1/2 terminology
New master_nnn_dxyz options to specify output resolution
dset1 and dset2 for non-EPI/anat alignment with lpa cost function
and turns off preprocessing steps
giant_move option turns off resampling and changes master options
Expanded help - including fuller description of edge method
Removed volume registration (motion correction) for anat2epi option
by default.
AFNI dataset views (+orig/+acpc/+tlrc) are maintained in output
depending on BASE, SOURCE or external dataset names for all output
06 Oct 2009, ZS Saad, suma, level 3 (MAJOR), type 4 (BUG_FIX)
More bug fixes related to ROI loading, and OSX's GLX problem
29 Sep 2009, RW Cox, afni, level 3 (MAJOR), type 5 (MODIFY)
InstaCalc is more-or-less ready
At least, I let Mike Beauchamp test it for his cunning plans.
24 Sep 2009, ZS Saad, suma, level 3 (MAJOR), type 4 (BUG_FIX)
Fixed crashes on OS X 10.5 caused by OS X's buggy GLX implementation
22 Jul 2009, RC Reynolds, realtime_reaceiver.py, level 3 (MAJOR), type 1 (NEW_PROG)
python replacement for serial helper
New 'data_choice' options can be added to compute_data_for_serial_port
for sending results of a different computation to the serial port.
16 Jul 2009, RC Reynolds, realtime_receiver.py, level 3 (MAJOR), type 1 (NEW_PROG)
replacement for serial_helper
17 Jun 2009, RC Reynolds, afni_proc.py, level 3 (MAJOR), type 2 (NEW_OPT)
version 2.0 : call e2a alignment and warp to standard space ready
- mask warped EPI by its extents (at volreg step)
- added -volreg_no_extent_mask, to block this masking
- added 'extents' to list of mask in -mask_apply
- change block dividers to more visual '===' with block names
20 May 2009, G Chen, 3dMEMA.R, level 4 (SUPER), type 1 (NEW_PROG)
Mixed-Effects Meta Analysis (MEMA)
This is an R program that runs group analysis in a truly random
mixed-effects sense by taking both beta and t-statistic as input
instead of beta value only in the conventional method. See more
details at http://afni.nimh.nih.gov/sscc/gangc/MEMA.html
19 May 2009, ZS Saad, @ROI_Corr_Mat, level 3 (MAJOR), type 1 (NEW_PROG)
A script to calculate correlation matrices between ROI time series
Calculates the correlation matrices between average time series from ROIs
defined in a mask volume. Script was written with Hang Joon Jo.
15 May 2009, RC Reynolds, afni_proc.py, level 3 (MAJOR), type 2 (NEW_OPT)
added -volreg_tlrc_warp option: can warp to standard space at volreg step
06 May 2009, RW Cox, afni, level 3 (MAJOR), type 2 (NEW_OPT)
First edition of InstaCorr!
Rough around the edges, but gnarly-ific to the level of the first
inaccessible cardinal!
09 Apr 2009, RC Reynolds, afni_proc.py, level 3 (MAJOR), type 2 (NEW_OPT)
'official' release with RETROICOR processing block: ricor
o added 'across-runs' ricor_regress_method
o added ricor information and usage to help (see 'RETROICOR NOTE')
o maintain unscaled shorts if they are input
o added -ricor_datum
19 Mar 2009, RC Reynolds, 1d_tool.py, level 3 (MAJOR), type 1 (NEW_PROG)
added lib_afni1D.py and 1d_tool.py
This is a library and tool for manipulating 1D files.
Many functions will still be added.
22 Dec 2008, G Chen, 3dICC.R, level 3 (MAJOR), type 1 (NEW_PROG)
IntraClass Correlation (ICC)
This is an R program that calculates ICC on 3D volume data based on a
two- or three-way random-effects ANOVA scheme. See more details at
http://afni.nimh.nih.gov/sscc/gangc/ICC
16 Dec 2008, G Chen, 3dGC.R, level 3 (MAJOR), type 1 (NEW_PROG)
Bivariate Granger causality analysis
This is an R program that runs Granger causality analysis with a
seed region versus the rest of the brain. See more details at
http://afni.nimh.nih.gov/sscc/gangc/3dGC
13 Dec 2008, ZS Saad, afni-matlab, level 3 (MAJOR), type 1 (NEW_PROG)
RetroTS creates regressors for cardiac, respiratory, and RVT filtering
RetroTS.m and accompanying functions create slice-based regressors
for regressing out the effects of cardiac, respiratory, and RVT effects
from FMRI time series. The regressors generated are meant to be used
with 3dREMLfit.
02 Dec 2008, ZS Saad, SpharmReco, level 3 (MAJOR), type 1 (NEW_PROG)
Reconstructs data from spherical harmonics decomposition.
See SpharmDeco -help and the demo script @Spharm.examples
for details.
02 Dec 2008, ZS Saad, SpharmDeco, level 3 (MAJOR), type 1 (NEW_PROG)
Performs spherical harmonics decomposition.
This program performs spherical harmonics decomposition
for surfaces' geometry and/or surface-based data
See SpharmReco -help and the demo script @Spharm.examples
for details.
02 Dec 2008, ZS Saad, @Spharm.examples, level 3 (MAJOR), type 1 (NEW_PROG)
A script to demonstrate the usage of SpharmDeco and SpharmReco
02 Dec 2008, ZS Saad, @NoisySkullStrip, level 3 (MAJOR), type 1 (NEW_PROG)
A script to improve skull stripping in noisy of heavily shaded data
01 Dec 2008, RC Reynolds, timing_tool.py, level 3 (MAJOR), type 1 (NEW_PROG)
a tool for manipulating and evaluating stimulus timing files
This is useful for getting statistics on rest timing.
21 Nov 2008, ZS Saad, @fast_roi, level 3 (MAJOR), type 1 (NEW_PROG)
Creates Atlas-based ROIs in original space for real-time experiments
24 Oct 2008, RC Reynolds, xmat_tool.py, level 4 (SUPER), type 1 (NEW_PROG)
program to inspect a .xmat.1D X-matrix, possibly against a time series
This is a Graphical tool for plotting a design matrix, reviewing
condition numbers or the correlation matrix, and fitting to a 1D
time series.
09 Oct 2008, G Chen, 1dGC.R, level 4 (SUPER), type 1 (NEW_PROG)
Multivariate Granger causality analysis
This is an R program that runs Granger causality analysis among a few
pre-select regions. See more details at
http://afni.nimh.nih.gov/sscc/gangc/1dGC
29 Sep 2008, RC Reynolds, 3dmatmult, level 3 (MAJOR), type 1 (NEW_PROG)
program to multiply AFNI datasets slice-by-slice as matrices
29 Aug 2008, ZS Saad, ExamineXmatR, level 3 (MAJOR), type 1 (NEW_PROG)
An interactive tool to examine a design matrix
28 Aug 2008, RW Cox, 3dAllineate, level 3 (MAJOR), type 5 (MODIFY)
A number of changes to improve robustness.
* Don't smooth noise added to source image outside of the mask
* Reduce default smoothing level for -lpc in coarse pass
* Increase number of points used for matching in the coarse pass
* More refinements of the twobest results in the coarse pass
* Refinements (-num_rtb option) of the twobest results in the fine pass
All this adds CPU time, but seems to make the program more reliably
convergent. Also:
* Restored operation of the -check option, to restart the optimization
at the final solution with other methods, to see what results they
give compared to the original method.
21 Aug 2008, RW Cox, 3dREMLfit, level 4 (SUPER), type 1 (NEW_PROG)
Program to mimic 3dDeconvolve, but with serial correlations
Uses ARMA(1,1) model of noise, separately for each voxel.
10 Jul 2008, RC Reynolds, plug_realtime, level 3 (MAJOR), type 5 (MODIFY)
receive oblique transform matrix via new OBLIQUE_XFORM interface
10 Jul 2008, RC Reynolds, Dimon, level 3 (MAJOR), type 5 (MODIFY)
if the data is oblique, pass the transformation matrix to plug_realtime
27 Jun 2008, RC Reynolds, gen_epi_review.py, level 3 (MAJOR), type 1 (NEW_PROG)
generate afni/drive_afni script to review initial EPI data
This program was written to be called from the afni_proc.py output script.
11 Jun 2008, DR Glen, align_epi_anat.py, level 3 (MAJOR), type 5 (MODIFY)
Obliquity handling in alignment, more grid options
09 May 2008, ZS Saad, 3dROIstats, level 3 (MAJOR), type 2 (NEW_OPT)
Added option -1Dformat to output results in 1D format
08 May 2008, ZS Saad, 3dsvm, level 3 (MAJOR), type 4 (BUG_FIX)
Fixed memory corruption caused by improper declaration of combName
07 May 2008, RC Reynolds, make_random_timing.py, level 3 (MAJOR), type 1 (NEW_PROG)
generate random stimulus timing files
This generates random timing files suitable for use in 3dDeconvolve.
The timing is not restricted to a TR grid, though that is possible.
Consider use with '3dDeconvolve -nodata'.
07 Apr 2008, DR Glen, align_epi_anat.py, level 4 (SUPER), type 1 (NEW_PROG)
Alignment of EPI and Anatomical datasets
Aligns anat and EPI data. Alignment is in either direction of anat to
epi or epi to anat. Transformations are combined where possible as
from time series registration and talairach transformations. Multiple
child epi datasets may be aligned at the same time.
10 Mar 2008, RC Reynolds, SUMA_SurfMeasures, level 3 (MAJOR), type 4 (BUG_FIX)
averages did not include nodes lost to -cmask
Noticed by M Beauchamp.
05 Mar 2008, ZS Saad, suma-general, level 3 (MAJOR), type 0 (GENERAL)
Support for GIFTI surface format writing
GIFTI writing can now be done with SUMA programs.
For example, see options -o_gii and -xml* in ConvertSurface program.
29 Feb 2008, G Chen, 3dICA.R, level 4 (SUPER), type 1 (NEW_PROG)
Independent component analysis
This is an R program that runs independent component analysis. It
takes one dataset that presumably has already been properly
pre-processed.already been properly pre-processed. See more details at
http://afni.nimh.nih.gov/sscc/gangc/ica.html
28 Feb 2008, ZS Saad, suma-general, level 3 (MAJOR), type 3 (NEW_ENV)
Support for GIFTI surface format reading
27 Feb 2008, ZS Saad, suma, level 3 (MAJOR), type 0 (GENERAL)
Addition of p and q values under threshold bar
Use BHelp on p and q text in suma to get more info.
27 Feb 2008, RW Cox, 3dTfitter, level 3 (MAJOR), type 2 (NEW_OPT)
add deconvolution via the '-FALTUNG' option
Unlike 3dDeconvolve, this deconvolution is to find the input time
series, given the impulse response function.
27 Feb 2008, RC Reynolds, afni_history, level 4 (SUPER), type 1 (NEW_PROG)
program to display the history of AFNI updates
This will be used to create a web page of AFNI updates.
Please see 'afni_history -help' for more details.
25 Feb 2008, RC Reynolds, plug_vol2surf, level 3 (MAJOR), type 4 (BUG_FIX)
fixed application of cluster for sending data to suma
Previously, clustering was only applied when the Olay and Thr sub-bricks
were the same.
21 Feb 2008, RC Reynolds, GIFTI, level 4 (SUPER), type 0 (GENERAL)
AFNI programs can now read and write GIFTI datasets
GIFTI datasets are for data in the surface domain, with file suffix .gii.
Support must be requested at compile time, and it requires libexpat.
Please see http://www.nitrc.org/projects/gifti for many details.
16 Feb 2008, RW Cox, 3dTfitter, level 4 (SUPER), type 1 (NEW_PROG)
new program = linear fits to voxel time series
Uses L1 or L2 regression, with optional constraints to fit each voxel
time series as a sum of basis time series, which can be 1D files or
3D+time datasets. Basis time series that are 1D time series are
the same for all input voxels. Basis time series that are 3D+time
datasets are different for each voxel.
Differences from 3dDeconvolve:
* Basis time series can vary across voxels.
* Fit coefficients can be found with L1 or L2 error functions, and
can be constrained to be positive or negative.
* 3dTfitter does not compute goodness-of-fit statistics.
14 Feb 2008, ZS Saad, suma, level 3 (MAJOR), type 0 (GENERAL)
Graphing of dset content with 'g'
A graph of the column content at a node can be plotted
This would be the surface equivalent to AFNI's graphing function.
See suma's interactive help 'ctrl+h' for more info.
06 Feb 2008, ZS Saad, SurfDist, level 3 (MAJOR), type 1 (NEW_PROG)
Program to calculate geodesic internodal distances
23 Jan 2008, RW Cox, Miscellaneous, level 3 (MAJOR), type 2 (NEW_OPT)
Older History stuff
* FDR thresh-vs-z(q) curve generation and storage in datasets.
* Display FDR q in AFNI pval label.
* Generate FDR curves automatically in 3dDeconvolve, and with
'-addFDR' option in 3drefit.
12 Jan 2008, ZS Saad, suma, level 3 (MAJOR), type 0 (GENERAL)
Scroll lists for I T and B selectors in suma
Right click on pulldown menu titles to get
a scroll list instead. This makes selecting from
a long list of options, or columns, much easier.
Right click on 'I' to the left of suma's Intensity Selection
button for an illustration.
28 Dec 2007, RC Reynolds, gifti_tool, level 3 (MAJOR), type 1 (NEW_PROG)
program to read and write GIFTI datasets
20 Dec 2007, RW Cox, Miscellaneous, level 3 (MAJOR), type 2 (NEW_OPT)
Older History stuff
* Clusterize reporting window.
19 Dec 2007, ZS Saad, suma-general, level 3 (MAJOR), type 0 (GENERAL)
Use of '[i]' to select node index from surface dset
Square bracket '[]' selection works for surface-based
datasets much like it does for volume-based ones.
In addition, one can use '[i]' to select the indices
of nodes for which data are defined in a particular
surface-based dataset.
For more information, see 'SUMA dataset input options:'
section in the output of ConvertDset -help .
03 Dec 2007, RC Reynolds, GIFTI, level 3 (MAJOR), type 0 (GENERAL)
initial release of gifti I/O C API
20 Nov 2007, RW Cox, 3dTsort, level 3 (MAJOR), type 1 (NEW_PROG)
new program = sorts voxel data along the time axis
This might be useful for sorting the -stim_time_IM beta weights
output be 3dDeconvolve. Perhaps for something else, too?
26 Sep 2007, ZS Saad, SurfFWHM, level 4 (SUPER), type 1 (NEW_PROG)
Program to estimate FWHM of data on surface
26 Sep 2007, ZS Saad, SurfSmooth, level 3 (MAJOR), type 5 (MODIFY)
Big changes to data smoothing functions
* HEAT_07 method does controlled blurring, with options
to blur 'to' a particular FWHM. No guessing needed for
iterative kernel bandwidth or number of iterations.
* HEAT_05 method improved to reduce numerical precision
problems.
20 Sep 2007, G Chen, 3dLME.R, level 4 (SUPER), type 1 (NEW_PROG)
An R program for linear mixed-effects analysis at group level in AFNI
See more details at http://afni.nimh.nih.gov/sscc/gangc/lme.html
31 Aug 2007, RC Reynolds, DECONFLICT, level 3 (MAJOR), type 5 (MODIFY)
modified default behavior of programs from deconflict to no overwrite
See AFNI_DECONFLICT in README.environment.
20 Aug 2007, RW Cox, Miscellaneous, level 3 (MAJOR), type 2 (NEW_OPT)
Older History stuff
* First version of '-lpc' Local Pearson Correlation cost function in
3dAllineate.c, with rhombic dodecahedra as the default building bloks.
30 Jul 2007, RC Reynolds, regression_tests, level 3 (MAJOR), type 0 (GENERAL)
added setup for regression testing to NIFTI package
This can be used as a template for testing any command-line programs.
26 Jun 2007, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* Boxed plots in afni_graph.[ch]. Probably a can of worms.
12 Mar 2007, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* New program 3dSynthesize.c.
09 Mar 2007, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* First test of -stim_times_AM? looks good.
* MCW_discard_events() for Button4/5 ScrollWheel actions.
17 Jan 2007, G Chen, 1dSEM, level 4 (SUPER), type 1 (NEW_PROG)
Path analysis (or structural equation modeling) at group level.
See more details on: http://afni.nimh.nih.gov/sscc/gangc/PathAna.html
15 Jan 2007, ZS Saad, suma, level 3 (MAJOR), type 0 (GENERAL)
Allow replacement of pre-loaded DO and Dsets
When a dataset is reloaded, it replaces the one
already loaded in suma.
20 Dec 2006, RC Reynolds, afni_proc.py, level 4 (SUPER), type 1 (NEW_PROG)
program to write complete single subject FMRI processing script
15 Nov 2006, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* New program 3dBlurToFWHM.c.
31 Oct 2006, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* New program 3dFWHMx -- does all sub-bricks.
22 Oct 2006, RC Reynolds, model_demri_3, level 3 (MAJOR), type 1 (NEW_PROG)
NLfim model for Dynamic Enhanced MRI
21 Sep 2006, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* Put 3dAllineate into the distribution. But is not finished.
* Modified plug_nlfit.c to allow AFNI_NLFIM_METHOD to select optimizer.
20 Sep 2006, ZS Saad, DriveSuma, level 3 (MAJOR), type 1 (NEW_PROG)
Program to control SUMA from the command line
03 Aug 2006, RC Reynolds, NI_SURF_DSET, level 4 (SUPER), type 0 (GENERAL)
added a new surface dataset format, with read/write ability in AFNI
25 Jan 2006, RC Reynolds, model_michaelis_menton, level 3 (MAJOR), type 1 (NEW_PROG)
NLfim model function for ethanol studies
02 Dec 2005, RC Reynolds, ANOVA, level 5 (SUPERDUPER), type 5 (MODIFY)
changed variance computations in 3dANOVA programs to not assume sphericity
For details, see http://afni.nimh.nih.gov/sscc/gangc/ANOVA_Mod.html .
01 Dec 2005, G Chen, 3dANOVA3, level 3 (MAJOR), type 2 (NEW_OPT)
New options to run 2nd-order general linear contrasts in 3dANOVA3.
See more details on: http://afni.nimh.nih.gov/sscc/gangc/ANOVA_Mod.html
11 Oct 2005, RC Reynolds, 3dmaxima, level 3 (MAJOR), type 1 (NEW_PROG)
command-line version of maxima plugin
23 Sep 2005, G Chen, 3dANOVA2 and 3dANOVA3, level 4 (SUPER), type 4 (BUG_FIX)
Significant modifications in 3dANOVA2 and 3dANOVA3
The changes were made to avoid statistics inflation for general linear
contrasts when coefficients don't add up to 0. See more details at
http://afni.nimh.nih.gov/sscc/gangc/ANOVA_Mod.html
15 Aug 2005, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* From now on, unless AFNI_ALLOW_MILLISECONDS is set to YES, AFNI programs
will
convert MSEC time unit datasets to SEC on input and output.
05 Jul 2005, RC Reynolds, Dimon, level 4 (SUPER), type 1 (NEW_PROG)
program to monitor real-time acquisition of DICOM images
25 Apr 2005, RC Reynolds, NIFTI, level 4 (SUPER), type 0 (GENERAL)
AFNI can read and write NIFTI datasets (effort with Bob and Rich)
06 Apr 2005, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* Added '.nii' output feature to THD_writedset() function, and did
a few other similar things hither and yon.
07 Jan 2005, RC Reynolds, nifti_tool, level 4 (SUPER), type 1 (NEW_PROG)
program to directly manipulate or compare NIFTI dataset headers
07 Jan 2005, RC Reynolds, NIFTI, level 4 (SUPER), type 0 (GENERAL)
initial release of NIFTI library
30 Nov 2004, RW Cox, Miscellaneous, level 3 (MAJOR), type 0 (GENERAL)
Older History stuff
* First version of 3dWarpDrive released.
* 3dcalc now prints a warning if outputing a byte-valued dataset when the
calculated results had some negative values.
04 Oct 2004, RC Reynolds, vol2surf, level 4 (SUPER), type 0 (GENERAL)
added vol2surf interface for real-time mapping from afni to suma
27 Jul 2004, G Chen, PathAna, level 4 (SUPER), type 1 (NEW_PROG)
A Matlab package that runs group analysis of up to 5-way ANOVA
This package adopts the conventional ANOVA approach to handling gorup
analysis. And it requires Statistics Toolbox other than the basic Matlab.
See more details on: http://afni.nimh.nih.gov/sscc/gangc
27 Jul 2004, G Chen, IndiAna, level 4 (SUPER), type 1 (NEW_PROG)
A Matlab package for individual subject analysis
See more details at http://afni.nimh.nih.gov/sscc/gangc
31 Mar 2004, RC Reynolds, serial_helper, level 3 (MAJOR), type 1 (NEW_PROG)
program to pass realtime registration params from TCP to serial port
01 Dec 2003, RC Reynolds, SurfMeasures, level 3 (MAJOR), type 1 (NEW_PROG)
program to compute various measures over surfaces
05 Aug 2003, RC Reynolds, 3dVol2Surf, level 4 (SUPER), type 1 (NEW_PROG)
program to map data from the volume to domain to the surface domain
29 May 2003, RC Reynolds, 3dSurf2Vol, level 4 (SUPER), type 1 (NEW_PROG)
program to map data from the surface domain to the volume domain
15 Jan 2003, RC Reynolds, Imon, level 3 (MAJOR), type 2 (NEW_OPT)
added connection to the realtime plugin in afni
27 Nov 2002, RC Reynolds, Imon, level 4 (SUPER), type 1 (NEW_PROG)
program to monitor GE I-files as they are written to the scanner
01 Oct 2002, RC Reynolds, file_tool, level 4 (SUPER), type 1 (NEW_PROG)
program to perform generic manipulations of binary files
06 Jun 2002, RC Reynolds, @SUMA_Make_Spec_FS, level 3 (MAJOR), type 1 (NEW_PROG)
script to import FreeSurfer surfaces into SUMA
21 May 2002, RC Reynolds, 3dresample, level 4 (SUPER), type 1 (NEW_PROG)
program to change a dataset orientation and/or grid spacing
08 Mar 2002, RC Reynolds, plug_crender, level 4 (SUPER), type 1 (NEW_PROG)
added rendering plugin to afni
16 Jan 2001, RW Cox, AFNI-general, level 5 (SUPERDUPER), type 0 (GENERAL)
Older History stuff
===========================================================
== All changes from this date onwards were made at the NIH ==
===========================================================
24 Jul 1996, RW Cox, Miscellaneous, level 5 (SUPERDUPER), type 0 (GENERAL)
Oldest History stuff
AFNI was created in summer 1994 (altho some parts date to the 1980s).
However, no log was made of changes until this date in 1996.
auto-generated by afni_history on Nov 24 2009