0.7.1

Release Notes

This is a bug fix release in the 0.7 series. The primary API change is improved handling of Path objects.

CHANGES

• FIX: Path validation (#342)
• FIX: Ensure consistent entities at all levels (#326)
• FIX: Edge case where a resampled column was too-long-by-one (#365)
• FIX: Use BIDS metadata for TR over nii header (#357)
• FIX: Add check for run_info to be a list, pass run_info in correct position. (#353)
• FIX: If sampling_rate is 'auto', set to first rate of DenseRunVariables (#351)
• FIX: Get the absolute path of the test data directory (#347)
• FIX: Update reports to be 0.7-compatible (#341)
• ENH: Rename sr variable to more intuitive interval (#366)
• ENH: Support pathlib.Path and other str-castable types (#307)
• MNT: Updates link to derivative config file in notebook (#344)
• MNT: Add bids-validator dependency (#363)
• MNT: Require pandas >= 0.23.0 (#348)
• MNT: Bump grabbit version (#338)
• CI: Ignore OSX Python 3.5 failures (#372)
• CI: Build with Python 3.7 on Travis, deploy on 3.6 (#337)

0.7.0

Release notes

This is a major, API-breaking release. It introduces a large number of new features, bug fixes, and improvements.

API-BREAKING CHANGES:

• A number of entities (or keywords) have been renamed to align more closely with the BIDS specification documents:
  • 'type' becomes 'suffix'
  • 'modality' becomes 'datatype'
  • 'acq' is removed (use 'acquisition')
  • 'mod' becomes 'modality'
• The following directories are no longer indexed by default: derivatives/, code/, stimuli/, models/, sourcedata/. They must be explicitly included using the 'include' initialization argument.
• The grabbids module has been renamed to layout and BIDSLayout.py and BIDSvalidator.py are now layout.py and validation.py, respectively.
• The BIDS validator is now enabled by default at layout initialization (i.e., validate=True)
• The exclude initialization argument has been removed.
• BIDSLayout.parse_entities utility has been removed (use the more flexible parse_file_entities).
• Calls to .get() now return BIDSFile objects, rather than namedtuples, by default (#281). The BIDSFile API has been tweaked to ensure backwards incompatibility in nearly all cases.
• Naming conventions throughout the codebase have been updated to ensure consistency with the BIDS specs. This is most salient in the analysis module, where snake_case has been replaced with CamelCase throughout.

NEW FEATURES:

• File metadata (i.e., in JSON sidecars) is now searchable by default, and behaves just like native BIDS entities (e.g., metadata keys can be passed as arguments to .get() calls)
• A new BIDSFile wrapper provides easy access to .metadata and .image
• HRF convolution is now supported via bundling of nistats' hemodynamic_models module; convolution is handled via the convolve_HRF transformation.
• Named config paths that customize how projects are processed can be added at run-time (#313)
• Preliminary support for BIDS-Derivatives RC1 (mainly core keywords)

MINOR IMPROVEMENTS AND BUG FIXES:

• Specifying 'derivatives' in a path specification now automatically includes 'bids' (#246)
• Zenodo DOIs are now minted with new releases (#308)
• Variable loading via load_variables can now be done incrementally
• Expanded and improved path-building via layout.build_path()
• get_collections no longer breaks when merge=True and the list is empty (#202)
• Layout initialization no longer fails when validate=True (#222)
• The auto_contrasts field in the modeling tools now complies with the BIDS-Model spec (#234)
• Printing a BIDSFile now provides more useful information, including path (#298)
• Resample design matrix to 1/TR by default (#309)
• Fix the Sum transformation
• Ensure that resampling works properly when a sampling rate is passed to get_design_matrix (#297)
• Propagate derivative entities into top-level dynamic getters (#306)
• Deprecated get_header call in nibabel removed (#300)
• Fix bug in entity indexing for BIDSVariableCollection (#319)
• Exclude modules with heavy dependencies from root namespace for performance reasons (#321)
• Fix bug that caused in-place updating of input selectors in Analysis objects (#323)
• Add a DropNA transformation (#325)
• Add a get_tr() method to BIDSLayout (#327)
• Add entity hints when calling get() with a target argument (#328)
• Improved test coverage

0.6.5

Release Notes

This release includes a number of documentation improvements, BIDS-MEG support, as well as some bug fixes.

CHANGES

• FIX: Do not drop rows of NaNs (#217) @adelavega
• FIX: Declare run as having integer type (#236) @effigies
• ENH: MEG support (#229) @jasmainak
• REF: rename grabbids to layout, closes #228 (#230) @ltirrell
• DOC: add .get_collection examples to tutorial (#219) @Shotgunosine
• DOC: Fix link in README to point to documentation (#223) @KirstieJane
• DOC: Add binder link for tutorial (#225) @KirstieJane
• MAINT: Restore "analysis" installation extra (#218) @yarikoptic
• MAINT: Do not import tests in __init__.py (#226) @tyarkoni

0.6.4

Bugfix release (see #211 for details).

0.6.3

Fixed author email in setup.py

0.6.2

Merge pull request #201 from INCF/minor-improvements

Minor improvements

0.6.0

This is an API-breaking release that implements a new BIDSLayout initialization pattern.

0.5.1

Hotfix release:

• Includes data files omitted from 0.5.0 release.
• Improves testing of installation.

0.5.0 (bidsy brontosaurus)

This is a major release that includes several new variable-loading, analysis construction, and report generation modules.

0.4.2

• fix for parsing "type" suffixes