AFNI HISTORY
level 2 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 2 -past_years 1
---- log of AFNI updates (most recent first) ----
04 Feb 2025, RC Reynolds, @update.afni.binaries, level 2 (MINOR), type 6 (ENHANCE)
allow direct updating of anyos_text* packages
03 Feb 2025, RC Reynolds, afni-general, level 2 (MINOR), type 4 (BUG_FIX)
fix partial TAXIS_FLOATS attributes, created by 3drefit -Tslices
Fill in missing zorg_sl, dz_sl, if they are zero and there are times.
Fix in thd_dsetdblk.c for AFNI attributes in AFNI dsets.
Fix in thd_initdblk.c for AFNI attributes in NIFTI dsets, though this
change could have accomplished AFNI dsets, too.
03 Feb 2025, RC Reynolds, 3dROIstats, level 2 (MINOR), type 2 (NEW_OPT)
add -float_format and -float_format_str, for floating point formatting
Requested by P Molfese.
31 Jan 2025, RC Reynolds, afni-general, level 2 (MINOR), type 4 (BUG_FIX)
when setting slice times in edt_dsetitems.c, prevent dz_sl == 0
This is required for (useful) display of timing in the afni GUI.
Thanks to @martinsingua (AFNI MB) for noting the issue.
31 Jan 2025, RC Reynolds, afni-general, level 2 (MINOR), type 6 (ENHANCE)
when writing NIFTI, allow for Siemens 2.5 ms timing resolution
The 2.5 ms resolution as reported by the revered D Glen.
31 Jan 2025, RC Reynolds, 1d_tool.py, level 2 (MINOR), type 2 (NEW_OPT)
add -show_slice_timing_resolution
This is to help evaluate Siemens 2.5 ms slice time resolution.
29 Jan 2025, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
suggest -combine_method OC_B over OC[_A] if only 2 echoes
29 Jan 2025, RC Reynolds, @extract_meica_ortvec, level 2 (MINOR), type 4 (BUG_FIX)
allow for empty accept or reject lists
Thanks to Avi (e0026902 on MB) for noting the problem.
28 Jan 2025, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add -tlrc_affine_warped_dsets : a pre-computed affine std space xform
Done for D Handwerker.
27 Jan 2025, RC Reynolds, afni_proc.py, level 2 (MINOR), type 4 (BUG_FIX)
fix -compare_opts display of fewer/more options applied
27 Jan 2025, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
w/DRG: invoke all tcsh scripts with env tcsh, rather than tcsh directly
To allow for other tcsh versions in the PATH, remove the direct path to
tcsh in the top execution lines, using env tcsh instead. This is mostly
to work around tcsh version 6.22.03 which breaks :h with an absolute
path.
This change applies to 180 files. Most changes are just to the top
execution line, but any 'tcsh -e' usage means additional checking for
$status failures.
There might still be some script generation changes to make, such as
to afni_procp.py.
23 Jan 2025, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
more checks for mac gcc, test rPkgsInstall
13 Jan 2025, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
updates for OS version, gcc and CLT SDK
08 Jan 2025, RC Reynolds, find_variance_lines.tcsh, level 2 (MINOR), type 2 (NEW_OPT)
add -thresh and -stdev_power; init min_cvox to 7
06 Jan 2025, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 2 (NEW_OPT)
warn user of ARM mac using macos_10.12_local
17 Dec 2024, RC Reynolds, afni_util.py, level 2 (MINOR), type 2 (NEW_OPT)
add a simple convolve function
17 Dec 2024, RC Reynolds, Makefile.linux_ubuntu_24_ARM, level 2 (MINOR), type 2 (NEW_OPT)
duplicate the 24_64 Makefile but with the ARM system name
10 Dec 2024, RC Reynolds, timing_tool.py, level 2 (MINOR), type 2 (NEW_OPT)
add -show_modulator_stats option, showing min,mean,max,stdev stats
06 Dec 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 5 (MODIFY)
subtract 1 from ricor QC vrat, for more a useful display
Previously output ratio of orig/ricor variances to view improvement.
Subtract 1 for better visualization, since the orig ratio must be > 1,
leaving the image as a more direct 'fractional improvement', say.
Or equivalently, call it (orig-ricor)/ricor.
17 Nov 2024, RC Reynolds, build_afni.py, level 2 (MINOR), type 2 (NEW_OPT)
add -make_flags option
11 Nov 2024, RC Reynolds, timing_tool.py, level 2 (MINOR), type 2 (NEW_OPT)
add -show_tr_offset_stats
This enhances -show_tr_stats, and might replace it.
A start to what was requested by Gang.
23 Oct 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add -volreg_no_volreg
Replace the 3dvolreg alignment transformation with the identity.
The B Feige option.
10 Oct 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 4 (BUG_FIX)
mask intersect inputs did not have views
Thanks to martinsingua on the MB for pointing out the problem.
04 Oct 2024, RC Reynolds, gen_group_command.py, level 3 (MAJOR), type 2 (NEW_OPT)
add -datatable 'command', to generate table for R stats programs
Use gen_group_command.py -command datatable to generate datatable files
for -dataTable options, for programs like 3dMVM, 3dLME, etc.
24 Sep 2024, RC Reynolds, 3dTsplit4D, level 2 (MINOR), type 4 (BUG_FIX)
fix confusion over auto-gzip BRIK name
19 Sep 2024, RC Reynolds, @update.afni.binaries, level 2 (MINOR), type 6 (ENHANCE)
allow use of build_afni.py for updating the current package
If build_afni.py was used to create the current package, then @uab
will also use it for updating (rather than downloading an official
package. One can also specify to use it via -build_afni.
16 Sep 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
if which Xvfb fails, check for its existence on disk
Also, include .login and report fewer homebrew link suggestions.
16 Sep 2024, RC Reynolds, afni-general, level 2 (MINOR), type 6 (ENHANCE)
apply LOCAL_CC_PATH in Makefile.macos_13_ARM and Makefile.macos_12_x86_64
13 Sep 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
in eispack C files, include math.h before f2c.h
This should generally have no effect, since the local f2c.h
includes math.h. However, if one is using cmake and the system
f2c for linking (rather than using afni/src/f2c), then the f2c.h
included with the eispack files will not have math.h.
So locally include math.h, just to be sure.
12 Sep 2024, RC Reynolds, build_afni.py, level 2 (MINOR), type 6 (ENHANCE)
add option -cc_path
Allow one to pass an alternate compiler if the relevant Makefile
uses LOCAL_CC_PATH. If this option is not used and the default
compiler does not exist, try to find the most recent similar version.
11 Sep 2024, P Taylor, gtkyd_check, level 2 (MINOR), type 7 (REMOVE)
Remove the *tcsh script* version of gtkyd_check.
This has now been superseded by a Python version of same name.
10 Sep 2024, P Taylor, gtkyd_check, level 3 (MAJOR), type 1 (NEW_PROG)
A *Python* version of previously-written tcsh script of same name.
Much faster way of checking/tabulating a glob of datasets for properties.
04 Sep 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 5 (MODIFY)
use uname -m for CPU, instead of platform.processor()
04 Sep 2024, RC Reynolds, OS_notes.macos_12_b_user.tcsh, level 2 (MINOR), type 6 (ENHANCE)
allow the script to be re-run with no effect
30 Aug 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
many updates to help examples; separate paths in compare_opts
- make example option order more consistent
- add examples: publish 3e ... 3j
- exclude 'noshow' examples from default help (currently 3e,f,g,h,j)
- separate differing paths in -compare_opts
05 Aug 2024, RC Reynolds, compute_ROI_stats.tcsh, level 2 (MINOR), type 5 (MODIFY)
if ALL_LT includes an ROI value of zero, remove it
05 Aug 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
add option -blip_warp_dset to input a pre-computed warp
For example, one can import the warp from epi_b0_correct.py.
23 Jul 2024, RC Reynolds, @chauffeur_afni, level 2 (MINOR), type 4 (BUG_FIX)
undo the the problematic -f change from 2024/04/26
The -f was added to tcsh to prevent biowulf from updating the PATH
when using whereami, as they have a different program with that name.
But -f means that on macs DYLD vars would not be set, crashing afni
when using the macos_10.12_local binaries.
25 Jun 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
deal with -Wimplicit-int, mostly from old f2c, needed for gcc-14
24 Jun 2024, RC Reynolds, build_afni.py, level 2 (MINOR), type 6 (ENHANCE)
when running 'make', warn if CC is set (which usually causes failure)
24 Jun 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
display CC; warn if CPU type differs between platform and uname
20 Jun 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
stop reporting assuming TR=1.0 warnings for now
Requested by P Taylor.
20 Jun 2024, RC Reynolds, Dimon, level 2 (MINOR), type 5 (MODIFY)
make -read_all the default
Basically for real-time sorting, this forces the initial processing
of all (found) images, rather than a limited subset. It allows for
proper sorting without requiring an initial alphabetical aspect.
14 Jun 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
AFNI.afnirc : use GZIP compression and turn off obliquity warnings
AFNI_COMPRESSOR : default to GZIP
AFNI_AUTOGZIP : comment out (was YES)
AFNI_NO_OBLIQUE_WARNING : default to YES
AFNI_ONE_OBLIQUE_WARNING : comment out (was YES)
11 Jun 2024, RC Reynolds, build_afni.py, level 2 (MINOR), type 2 (NEW_OPT)
backup directory removal; add -update_niivue option
Save only most recent backup directory, possibly plus 1 containing afni.
Add -update_niivue, and skip the operation on '-clean_root no'.
06 Jun 2024, RC Reynolds, rPkgsInstall, level 2 (MINOR), type 5 (MODIFY)
along with 3dMVM, handle not having afni in PATH
06 Jun 2024, RC Reynolds, Makefile.macos_13_ARM, level 2 (MINOR), type 2 (NEW_OPT)
add this Makefile (in src) for corresponding build machine
This is a ~dupe of other_builds/Makefile.macos_13_ARM_clang.
30 May 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 5 (MODIFY)
remove unimportant anat followers from example 'publish 3d'
30 May 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 4 (BUG_FIX)
fix volreg TSNR for ME: use eind -> fave_echo
Thanks to zhengchencai on MB for pointing out the problem.
25 May 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
add -bids_deriv option
This adds a call to P Taylor's map_ap_to_deriv.py program, to output a
BIDS derivative tree.
25 May 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
add -volreg_allin_warp option
This allows specific control over 3dAllineate -warp, using a default
of shift_rotate for rigid body registration.
24 May 2024, PD Lauren, suma, level 3 (MAJOR), type 2 (NEW_OPT)
add alpha thresholding
29 Apr 2024, RC Reynolds, afni-general, level 3 (MAJOR), type 5 (MODIFY)
change 'count' program and usage to 'count_afni'
Add count_afni to the distribution, modify scripts to use it, and
allow use of count_afni is sub-brick selection, e.g.,
dset'[count_afni 3 5]'
Note that 'count' is still allowed, for now.
26 Apr 2024, RC Reynolds, gen_ss_review_scripts.py, level 2 (MINOR), type 6 (ENHANCE)
-init_uvars_json will now pass through unknown uvars
This enables users to pass uvars through afni_proc.py to the APQC.
26 Apr 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
in any script calling whereami, invoke with 'tcsh -f' at top
This is a quick fix for biowulf usage, since there is a new whereami
in town (/usr/local/bin/whereami), and because they reset the PATH.
Modify: @Atlasize @MakeLabelTable @chauffeur_afni
compute_ROI_stats.tcsh gen_cluster_table
25 Apr 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
warn if tcsh version is 6.22.03 - it has $var:h bug
25 Apr 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add -uvar option to pass through AP uvars
24 Apr 2024, RC Reynolds, Dimon, level 2 (MINOR), type 2 (NEW_OPT)
add -sort_method geme_suid
22 Apr 2024, RC Reynolds, 3dmaskdump, level 2 (MINOR), type 4 (BUG_FIX)
singleton coordinates should round to the closest voxel center
Originally, box coordinates rounded to the nearest voxel, effectively
extending ranges by 1/2 voxel on each side. This was changed in 2021 to
be strict. But then singleton coordinates often hit no voxels, and the
help says one voxel should be found.
Now a singleton coordinate will round to the nearest center, while a ':'
separated range will be precise, as with the mixed use:
-xbox 5.4:11.3 -17.8:-4.1 11
Here, the '11' will be rounded to the closest center.
17 Apr 2024, RC Reynolds, afni-general, level 2 (MINOR), type 4 (BUG_FIX)
in THD_load_nifti(), need_copy might imply scale_data
Thanks to @liningpan on github for reporting this.
12 Apr 2024, RC Reynolds, 3dTsplit4D, level 2 (MINOR), type 2 (NEW_OPT)
add -label_prefix, to include labels in the output prefix
08 Apr 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add -anat_follower_erode_level, to specify the exact erosion level
The older -anat_follower_erode option implies only a single erosion.
This parameter is in voxels. As before, a single erosion includes the
18 NN2 neighbors, so all in a 3x3x3 box but the outer 8 corners.
See mask_tool -help for details.
Added for M. Byrne S. Haller.
07 Apr 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
the default warp vox dim will round up if very close
Particularly when coming from a NIFTI sform, voxel dimensions are often
computed. So while an "exact" dimension might be 3, the computed one
might come out as 2.99999. Scale dimensions by 1.0001 before truncation.
05 Apr 2024, RC Reynolds, gen_ss_review_scripts.py, level 2 (MINOR), type 6 (ENHANCE)
add reg_echo and echo_times; include echo_times in basic review script
29 Mar 2024, RC Reynolds, ap_run_simple_rest_me.tcsh, level 3 (MAJOR), type 1 (NEW_PROG)
run a quick afni_proc.py resting state analysis for QC on multi-echo data
29 Mar 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add 'none' as an option to -regress_apply_mot_types
This allows one to censor (or compute enorm) without motion regression.
Requested by e0046902 on NeuroStars.
29 Mar 2024, RC Reynolds, afni-general, level 2 (MINOR), type 5 (MODIFY)
NIFTI s/qform_code of 2 defaults to +orig, once again
Have an unset AFNI_NIFTI_VIEW default to 'orig' again.
This is how it was originally. It was changed at some point to
accommodate an influx of such data in MNI space. Now, revert to
having sform_code of 2 to default to orig space.
28 Mar 2024, RC Reynolds, suma-general, level 2 (MINOR), type 5 (MODIFY)
temporarily revert to 2023.1003 SUMA tree, while fixing some issues
Most of this will go back in, once the issues are resolved.
22 Mar 2024, RC Reynolds, 2dImReg, level 2 (MINOR), type 6 (ENHANCE)
add approx_equal() test for -basefile, as well
Done for josef_ling on MB.
21 Mar 2024, RC Reynolds, gen_ss_review_table.py, level 2 (MINOR), type 6 (ENHANCE)
allow 'column' label ANY, which expands to each non-initial label
21 Mar 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 2 (NEW_OPT)
add option -disp_abin
21 Mar 2024, P Taylor, gtkyd_check, level 2 (MINOR), type 1 (NEW_PROG)
Add new program to make summaries of data file properties.
Glob many datasets, get tables to compare for similarities/diffs.
20 Mar 2024, RC Reynolds, 2dImReg, level 2 (MINOR), type 6 (ENHANCE)
be more lenient, not requiring dx to be exactly equal to dy
Done for josef_ling on MB.
18 Mar 2024, RC Reynolds, afni_proc.py, level 3 (MAJOR), type 6 (ENHANCE)
auto-include APQC_atlas for compute_tsnr_stats, if appropriate
And add -regress_compute_auto_tsnr_stats.
15 Mar 2024, RC Reynolds, APMULTI_Demo2_realtime, level 2 (MINOR), type 6 (ENHANCE)
add rt.06.ME.OC.aves example, like 05 but with ROI averages
12 Mar 2024, RC Reynolds, SUMA, level 2 (MINOR), type 4 (BUG_FIX)
updates to SUMA_CreateDO.c, SUMA_Color.c, SUMA_driver.c
Some build machines need to adhere to the C99 standard.
11 Mar 2024, RC Reynolds, gen_ss_review_scripts.py, level 2 (MINOR), type 6 (ENHANCE)
add max_4095_warn_dset key and driver use
11 Mar 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 6 (ENHANCE)
add 4095_gcount warnings for input EPI
This will be automatically run after the outlier counts.
08 Mar 2024, RC Reynolds, 3dTto1D, level 2 (MINOR), type 6 (ENHANCE)
add 4095_gcount warning method; modify output
Zero out results if max is not exactly 4095.
05 Mar 2024, RC Reynolds, APMULTI_Demo2_realtime, level 2 (MINOR), type 6 (ENHANCE)
add Optimally Combined multi-echo demo, including use with afni_proc.py
04 Mar 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 2 (NEW_OPT)
add -disp_ver_afni (display contents of AFNI_version.txt)
01 Mar 2024, RC Reynolds, compute_ROI_stats.tcsh, level 2 (MINOR), type 2 (NEW_OPT)
add ability to pass ALL_LT via -rval_list (for all labeltable entries)
29 Feb 2024, RC Reynolds, afni_util.py, level 2 (MINOR), type 5 (MODIFY)
use raw straing format for some regular expressions
So python 3.12 has upgraded Deprecation Warnings to SyntaxWarnings,
making warnings pop up where they did not previously. Previously, one
would need to turn on deprecation warnings to see such things.
28 Feb 2024, RC Reynolds, module_test_lib.py, level 2 (MINOR), type 6 (ENHANCE)
python 3.12 has removed 'imp' importing library, use importlib
Add a new 312 function string for newest case.
22 Feb 2024, RC Reynolds, build_afni.py, level 2 (MINOR), type 6 (ENHANCE)
check for conda env vars on make build failure
22 Feb 2024, RC Reynolds, afni_system_check.py, level 2 (MINOR), type 6 (ENHANCE)
check for conda env vars
22 Feb 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 5 (MODIFY)
use more mask_epi_anat, and default: -regress_compute_tsnr_stats brain 1
21 Feb 2024, RC Reynolds, compute_ROI_stats.tcsh, level 2 (MINOR), type 5 (MODIFY)
modify labels and prep for Q column
15 Feb 2024, RC Reynolds, compute_ROI_stats.tcsh, level 3 (MAJOR), type 1 (NEW_PROG)
compute per-ROI region statstics over a given dataset
It is a little like 3dROIstats, but with needs specific to afni_proc.py.
15 Feb 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 2 (NEW_OPT)
add -regress_compute_tsnr_stats
This is intended to be added to P Taylor's APQC HTML report.
08 Feb 2024, RC Reynolds, afni_proc.py, level 2 (MINOR), type 5 (MODIFY)
in radcor: pass mask after any data scaling or in regress block
Scaled or errts data won't automask well.
Also, block radcor once in the surface domain.
07 Feb 2024, RC Reynolds, ap_run_simple_rest.tcsh, level 2 (MINOR), type 6 (ENHANCE)
add regress to -radial_correlate_blocks
Also, handle new DEFAULT example names, and pass using underscores.
05 Feb 2024, RC Reynolds, @FindAfniDsetPath, level 2 (MINOR), type 5 (MODIFY)
one change to allow spaces in dataset names
Spaces in the paths to templates/atlases or the abin is currently
not allowed. But we might slowly change that.
auto-generated by afni_history on Feb 4 2025