v1.1.1

Release date: 3 October 2022

Toolbox related

• New function to support refining brain mask before background field removal step
• Official support mritools (including ROMEO and CLEAR-SWI) v3.5.5
• ‘ROMEO_HOME’ is now renamed to ‘MRITOOLS_HOME’ in SpecifyToolboxesDirectory.m
• Add GPU compatibility for NDI

Bug fix

• Fixed bug for full pipeline application and phase unwrapping standalone application used different bipolar readout correction implementations
• Fixed bug for NDI when weight was used instead of weight^2

v1.1.0

Release date: 22 September 2022

GUI related

• Experimental support to export phase image from real|imaginary images (could be useful for GE data)

Toolbox related

• Better compatibility with ROMEO, including loading config file with ROMEO parameter back to GUI
• New implementation of bipolar readout phase offset correction (no phase unwrapping is required) and provide the estimated phase offset map as output
• New implementation of incorporating relative residual map into the weighting map when the "Exclude voxels using reisdual" box is checked with "weighting map" option

Bug fix

• Several minor bugs fixed

Backend related (advanced user)

• New backend architecture for SWI/SMWI. Now new SWI or SMWI methods can be added to SEPIA usinf the add-on feature similar to other methods

v1.0.1

Release date: 4 Aug 2022

Toolbox related

• Updated function performing phase conversion from arbitary DICOM values to radian (could result in minor numerical differences compared to previous versions if the input phase NIfTI not in radian)

Bug fix

• Fixed bug when phase NIfTI is in wrapped range with non-unity rescale slope (e.g. from Philips' scanners)
• Several other minor bugs fixed

v1.0.0

Release date: 25 Feb 2022

GUI related

• New utility tool for managing external dependencies

Toolbox related

• Support ROMEO as total field computation and phase unwrapping method
• Support MRI susceptibility calculation methods for QSM dipole field inversion
• Support FANSI v3.0 (note that the algorithm parameters are adapted for this version)
• Improve BIDS compartibility with SEPIA
• Update output filenames in accordance with BIDS format
• Improve the comparability of weighting maps across different datasets and methods
• GUI supports on managing toolbox dependencies

Bug fix

• Improve the robustness of measuring a reference phase point for B0 computation

Backend related (advanced user)

• New architecture for easier integration of new echo combination methods
• New data loading method to reduce memory usage during processing

v0.8.1.1

Bug fix

• Fixed bug when using single-echo dataset
• Fixed bug when input phase data in unit of radian with single datatype

v0.8.1

Toolbox related

• Log file and error message file are now paired (last 15 digits in the extension) instead of sorting in simple numerical order
• Log file and error message file are now generated in both GUI and command-based operations (when using sepiaIO)
• When running SEPIA, the current directory will temporaily move to the output directory to avoid overwriting temporary files if multiple processings happen simultaneously
• A SEPIA pipeline configuration file will be automatically generated using sepiaIO is the output directory does not have any existing configuration file. This would be useful to look up the pipeline used to produce the results when using command-based operation

Bug fix

• Bug fix when running FANSI (see here)
• Bug fix when getting B0 direction from Sagittal or Coronal acquisition (see here)
• Bug fix when running QSM standalone with magnitude image for regularisation (see here)
• Bug fix when running MEDI with zeropadding option is not equal to zero

Backend related (advanced user)

• Improved readiility of how the data are loaded in SEPIA, which could make better BIDS compartibility in the future

v0.8.0

GUI related

• New layout for input/output panel for data selection
• New pipeline configuration file (sepia_config.m), log file (run_sepia.log) and error message file (run_sepia.error)
• New feature to load parameters in a pipeline configuration file (sepia_config.m) to the GUI
• New option to save unwrapped echo phase
• New option to exlcude unreliable voxels
• New option to select reference tissue for QSM normalisation/referencing
• New option to remove residual B1 field in local field using spherical harmonic function with adjustable order of the fitting

Toolbox related

• Support the lastest version of MEDI toolbox (Jan 15, 2020)
• Support extra brain extraction (FSL's BET) parameters from MEDI toolbox
• New 'percentage' option for MEDI+0 algorithm
• Support the lastest version of FANSI toolbox (commit dc68c306)
• New option to use weak harmonic regularisation <https://onlinelibrary.wiley.com/doi/full/10.1002/mrm.27483)>_ with FANSI

Backend related (advanced user)

• Support developers adding a third-party method as an addon
• Introduce tutorial scripts to guide developers on how to adding third-party method in SEPIA
• Introduce functions to simplify the workflow of creating new method panel
• The order of removal of residual B1 field and mask erosion is interchanged to produce better a fitting result

Bug fix

• Bug fix: running SEPIA without parrallel computing toolbox
• Bug fix: running MEDI toolbox nonlinear fit echo phase combination with 2 echoes
• Bug fix: running MEDI method in SEPIA
• Bug fix: running single echo data with exclusion of unreliable voxels option enabled

Please update the MEDI toolbox (Jan 15, 2020) and FANSI toolbox (commit dc68c306) to the lastest version for the best performance.