Skip to content

Latest commit

 

History

History
389 lines (286 loc) · 13.1 KB

CHANGELOG.md

File metadata and controls

389 lines (286 loc) · 13.1 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog

[1.4.1] - 2023-07-12

Fixed:

  • PET: Updated entities list, remobved some nore more required json metadata
  • PET/ECAT: Degraded warning of non-decodable bytes string to debug
  • plugins/template: Fixed (finally) the import of classes in template

Changed:

  • bidsmap: Accepting non-bids modality with a warning
  • bidsmap: Runs loaded from template are now unchecked
  • README.md: liknks points to GitHub repo

[1.4.0.post4] - 2022-10-17

Fixed:

  • MRI/jsonNIFTY, PET/jsonNIFTY: fixed crash when trying to load generic json NIFTY file

[1.4.0.post3] - 2022-06-15

Fixed:

  • MRI/hmriNIFTY: removed requirement of presence of MrPhoenixProtocol

Changed:

  • Splitted bloated README

[1.4.0.post2] - 2022-05-06

Changed

  • Version naming schema for post-release fixes

Fixed

  • plugins: added __init__.py to tools so plugin tools will be properly installed

[1.4.0r1] - 2022-05-05

Removed

  • baseModule: removed spanning messages about testing files in scan folders

Fixed

  • bidsMeta: Fixed not reseted bidsSession list of subjects.tsv columns
  • plugins.tools: Fixed faulty import of baseModule

[1.4.0] - 2022-05-02

Changed

  • Rearranged imports to be importable as module
  • Moved version.txt and bidsversion.txt to bidsme sub-folder
  • Moved heuristics folder to bidsme directory

Added

  • bidsme now is installable with pip, and importable as module
  • setup.py scripts for setuptools
  • tools.info.reseterrors() function to reset error counters

Removed

  • tests directory, to be reintegrated later
  • reload participants definition warning

[1.3.6] - 2022-04-26

Changed

  • map: by default bidsme map will stop after first recording producing error/warnings. Added a CLI parameter --process-all to process all recordings in one go.
  • BaseModule: more explicit messages for testing validity of files at DEBUG level

Added

  • map: check for several files ending up with same bidsified name
  • Support for CT in PET data type

Fixed:

  • Small misprint that forbids the dump of DICOM header in PET
  • few adjustements in parcing DICOM header
  • map: checks for IntendedFor field wasn't running in multisession datasets
  • BidsSession: bug when sub_values not intended for participants.tsv are
  • EEG, *NIFTI: Fixed returnvalue for copyRawFile
  • PET: Updated recommended and required sidecar metadata checked for changes

[1.3.5r9] - 2022-03-04

Fixed

  • hmriNIFTI: fixed incorrect PhaseEncodingDirectionSign default value

[1.3.5r8] - 2021-11-22

Fixed

  • bug with option --skip-existin-session not working in preparation

[1.3.5r7] - 2021-10-27

Fixed

  • duplicated entries in participant.tsv wasn't saved in __duplicates.tsv

[1.3.5r6] - 2021-10-08

Fixed

  • NRI/hmriNIFTI: fixed error while retrieving afFree and adFree firlds when they are not defined in json file

[1.3.5r5] - 2021-08-18

Fixed

  • DICOM: fixed crash if patient age is not defined
  • DICOM: persons name is decoded correctly
  • DICOM: if DS or IS not defined, returned value is None

Added

  • MRI/DICOM and PET/DICOM: support for extentions .ima and .IMA
  • MRI/DICOM: MRAcquisitionType metafield
  • MRI: set of recommended fields for qMRI
  • DICOM: added exception if decoding a particular value from header produces an error

[1.3.5r4] - 2021-07-20

Fixed

  • MRI: misspell in the name of RepetitionTimeExcitation

[1.3.5r3] - 2021-06-16

Changed

  • participants.tsv table is managed using bidsMeta.BidsTable class

Fixed

  • MRI/NIFTI and PET/NIFTI: incorrect parameter for retrieveFormDict

[1.3.5r2] - 2021-03-10

Fixed

  • jsonNIFTI, hmriNIFTI: file parts parcing for compressed files

[1.3.5r1] - 2021-03-01

Changed

  • bidsify: Allow conflicting values for participants.tsv. These values will be reported in __duplicated.tsv and must be merged manually with participants.tsv
  • baseModule: Set index before loading file. If loading crashes, now it should report correct file

Added

  • hMRI: test for CSASeriesHeaderInfo, CSAImageHeaderInfo and MrPhoenixProtocol in Siemens files. Should detect corrupted files before processing them

[1.3.5] - 2021-02-11

Added

  • Extra try/catch to protect running main loop, should stop crashes in case of corrupt data

Fixed

  • baseModule: Bidsified file is compressed only if he wasn't compressed before, the correct extention .gz is added to scans.tsv content
  • mapper: IntendedFor fields are checked from subject folder, the widecar characters are disallowed

Changed

  • MPM parameters updated

[1.3.4] - 2020-12-29

Added

  • MRI: RepititionTimeExitation json field for all modalities
  • hmriNIFTI: Support of zipped (.nii.gz) data files
  • baseModule:isValidFile incorporates the file extention check before calling _isValidFile. The list of valid extentions must be given in _file_extentions static variable in subclass
  • bidsmap: Introduced models, that allows to choose different set of entities and json fields for given modality

Changed

  • baseModule: moved zip field to switches dictionary
  • baseModule: renamed and inverted isBidsValid to exportHeader and moved it to switches
  • Moved BidsSession and bidsMeta to bidsMeta folder, should remove conflict with bids package

[1.3.3] - 2020-11-19

Changed

  • baseModule: testAuxiliary no longer prodices warning if unable to retrieve asked field
  • Improved bidsmap template

[1.3.2] - 2020-11-15

Added

  • base:getField: can have multiple prefixes, that are executed from right to left
  • mapper.py:implemented check for IntendedFor JSON fields. If during map bidsified file exists, mapper checks if all files in IntendedFor also exist

Changed

  • MRI:hmriNIFTI: B1FAValues vector is no longer sorted

[1.3.1r3] - 2020-11-11

Fixed

  • mapper.py: subject demographics are now copied into sub_values dictionary
  • hmriNIFTI: field B1mapNominalFAValues are now calculated correctly

[1.3.1r2] - 2020-11-02

Fixed

  • Bug when SequenceEndEP called without outfolder parameter in bidsification step
  • Several flake8 issues

[1.3.1r1] - 2020-10-22

Fixed

  • Fixed mandatory requirement for mne module

[1.3.1] - 2020-10-08

Added

  • plugins/tools/General: ExtractBval function to extract bval/vec from DWI recording
  • plugin/tools/General: storeSource function that allows store prepared data into bidsified folder
  • plugins/tools/Nibabel: Convert3Dto4D function to merge 3D nii files into 4D

[1.3.0] - 2020-09-28

Fixed

  • Removed miliseconds in acqTime output, as BIDS requires

Added

  • EEG/EDF implementation using mne interface. Channels and events incorporated
  • EEG/BV implementation using mne interface.
  • map: map sanity checking, detecting duplicated provenance an examples
  • bidsmap: warning if bids value is not string, and forcefull convertion into string
  • baseModule: New public boolean switch zip, which is set to False by default. If in plugin (in RecordingEP or in SequenceEP) is set to True, then data file will be zipped during bidsification (provided is zipping is implemented for given type)
  • plugins: tools to use in pligins. To import use import plugins.tools.General.<toolname>

[1.2.1] - 2020-08-18

Changed

  • Reloading participant template now produce warning instead of raising exception, this should allow multiple execution in same session

Fixed

  • _formats:dummy Fixed conditional imports

[1.2.0] - 2020-08-07

Added

  • baseModule: added a dummy class that's loads instead of format subclass if dependancy module is not loaded
  • PET: new module for PET images
  • PET: DICOM file format
  • PET: ECAT file format
  • BaseModule: custom attributes, that can be set by recording.custom[<name>], and accessed from bidsmap using <<custom:name>>

Changed

  • baseModule: moved pure virtual methodes to Module/abstract.py, abstractmethode are now declared using ABC module
  • baseModule: acquisition time is now stored in _acqTime attribute, so it can be directly set by setAcqTime(datetime) function. The value from header is retrieved via _getAcqTime virtual function
  • DICOM: when exporting header, if AcquisitionDateTime field is not defined it is exported using the current recording acquisition time
  • DICOM: common dicom operations (DataElement transformation, tag search etc.) are moved to _dicom_common.py
  • selector: dictionary of aviable classes is now ordered
  • bidsmeNIFTI: changed the way the header is written
  • header is automatically created if isBidsValid is set to false
  • pyDicom is an optional dependency

Fixed

  • PET:ECAT Magic string test now "MATRIX" instead of "MATRIX72"
  • PET:ECAT frames headers are now exported into json
  • PET:ECAT FramesStart and Duration are now in s instead of ms
  • baseModule: fixed copyRawFile function to return correct path to copied file
  • baseModule: fixed access values from participants and scans tables
  • prepare: session.getPath returns correct session path is run with no-session option

[1.1.2] - 2020-05-22

Added

  • DICOM: unittests

Changed

  • MRI: renamed MRI classes to DICOM, hmriNIFTI, bidsmeNIFTI, jsonNIFTI and NIFTI
  • MRI: moved json fields definitions to separate file _<ClassName>
  • MRI: streamlined json metafields loading
  • folder recording will no longer automatically fail isValidFile
  • scans.tsv show acqTime with microseconds

Fixed

  • DICOM: empty value for Time and DateTime fields
  • baseModule: virtual dump function returned exception instead of raising it
  • prepare: fixed manual setting for path in series

[1.1.1] - 2020-05-15

Fixed

  • prepare: now directories in folder with data files will no longer crash, but still produce warning
  • map: in case of multiple checked runs, now the first one is used to set up modality and labels
  • map: bug where 0 or '' values to check are not retained for bidsmap file
  • bug during attribute checking where retrieved attribute was cleaned

Added

  • Modules: common.py file with often used functions for modules implementations
  • common.py: action_value function that apply a given action to value, used for transformation of metadata from headers
  • common.py: retrieveFormDict function that implements search of value from path in standard dictionary
  • unittests for common.py

Changed

  • meta-fileds are not longer checked for pre-defined value if present in bidsmap

[1.1.0] - 2020-05-10

Fixed

  • MRI: fixed misspell in FlipAngle metafield
  • Hidden files wasn't skipped prpoerly
  • MRI: fixed order of entities for anat modality
  • map: crash if <<bids:xxx>> used if corresponding entity not set

Added

  • MRI: headNIFTI -- NIFTI file format with bidsme-extracted DICOM-header

Changed

  • map: unknown.yaml file now replicates standard bidsmap.yaml structure with the only modality __unknown__. Copiyng directly from unknown.yaml, and filling attributes, bids and suffix should now suffice for bidsmap
  • map: If bids section is empty for matched run, it will be filled by predefined entities, provide the modality is defined in Bids standard

[1.0.3] - 2020-05-05

Fixed

  • participants.tsv wasn't filled in preparation step

Changed

  • map, process and bidsify looks for given bidsmap file first in order: in destination code folder, local folder, and user configuration folder
  • in bidsmap Options dictionary is removed, and version entry is replaced by __bids__, that refers to version of BIDS and no more to version of software, the bidsignore is dropped

[1.0.2] - 2020-04-30

Added

  • Map attributes now accepts dynamic fields, if corresponding attribute is included in brackets

Changed

  • EEG:BrainVision: removed PatientId, SessionId and RecordingNumber from attributes
  • EEG:BrainVision: functions getSubId and getSesId returns None
  • If subject Id and session Id is set to None, the corresponding values are extracted from file name, assumming it is formatted following BIDS (fields sub and ses respectively)
  • If map attributes dictionary is empty, it will match all recordings
  • If map attribute is not found in recording, it will fail match
  • If map attribute is None then it will match all values
  • BidsSession: BidsSession class can be initialized with subject and session values. If these values are set, corresponding attributes will be locked
  • Preparation: if subject or session values are None, they are calculated for each recording in serie

Fixed

  • EEG:BrainVision: fixed _loadFile function name
  • EEG:BrainVision: added acq to template map
  • EEG:BrainVision: Fixed TaskName and SamplingFrequency json fields

[1.0.1] - 2020-04-20

Changed

  • Reimplementation of required, recommended and optional metadata JSON fields
  • added acq to eeg modality (present in BIDS 1.2.0)

Added

  • ieeg and meg modalities to EEG module

[1.0.0] - 2020-04-08

Added

  • Gitlab CI