[1.0.0] - 2025-07-11
This marks the official first stable release of the mobgap package.
This means that all core algorithms are stable and have been validated against the old Matlab implementations.
To learn more about this release, check out our short blogpost on the release:
https://mobgap.readthedocs.io/en/latest/blog/20250708_1_0.html
Changed
- When loading reference data using the Mobilise-D Matlab format, the handling of duplicated ICs and LR labels has been
updated.
Namely, we moved the processing of duplicated ICs to a WB level. This means duplicated ICs across WB are not removed
or deduplicated anymore.
Further, we actually drop duplicated ICs also from the IC array.
We decided that this is the best behavior given how this data is usually used.
The reason for that is, that they are cases where, due to the way the INDIP processes the data, WBs exist where one
WB ends with the same IC the next WB starts, basically creating WBs without break between them.
While we generally consider this a bug in the INDIP processing, it is something that is out of scope to fix in
existing data.
Hence, we are excepting this as a plausible case and don't fix it. - Fixed multiple edgecases where unexpected errors were thrown when data sequences were too short or empty.
Algorithms now correctly return empty results instead of throwing an error. - Introduced a calculation of raw number of initial contacts per WB into the WBA. This parameter is now calculated by
default in all pipelines and also aggregated by the MobiliseDAggregator. - The aggregated parameters of MobiliseDAggregator are renamed based on new Mobilise-D internal consensus:
walkdur_all_sumis now provided in minutes instead of hours. The alternative name is changed to
total_walking_duration_min*_maxare all renamed to*_p90to reflect that they are the 90th percentile of the values and not really the
maximum.steps_all_sumis renamed towbsteps_all_sumto reflect that it is not the sum of all steps, but only considers
initial contacts within valid WBs. The new preferred alternative name is renamed to
wb_all__n_raw_initial_contacts__sumto signal even further that we are counting raw ICs and not really steps.