Debian Codegraph @

doc/release_notes/release_0.16.md

raw
1 # Version 0.16 #
2
3 ## DataLab Version 0.16.4 (2024-07-09) ##
4
5 This is a minor maintenance release.
6
7 đŸ› ī¸ Bug fixes:
8
9 * Requires PlotPy v2.4.1 or later to fix the following issues related to the contrast adjustment feature:
10 * A regression was introduced in an earlier version of PlotPy: levels histogram was no longer removed from contrast adjustment panel when the associated image was removed from the plot
11 * This is now fixed: when an image is removed, the histogram is removed as well and the contrast panel is refreshed (which was not the case even before the regression)
12 * Ignore `AssertionError` in *config_unit_test.py* when executing test suite on WSL
13
14 📚 Documentation:
15
16 * Fix class reference in `Wrap11Func` documentation
17
18 ## DataLab Version 0.16.3 (2024-07-03) ##
19
20 đŸ› ī¸ Bug fixes:
21
22 * Fixed [Issue #84](https://github.com/DataLab-Platform/DataLab/issues/84) - Build issues with V0.16.1: `signal` name conflict, ...
23 * This issue was intended to be fixed in version 0.16.2, but the fix was not complete
24 * Thanks to [@rolandmas](https://github.com/rolandmas) for reporting the issue and for the help in investigating the problem and testing the fix
25 * Fixed [Issue #85](https://github.com/DataLab-Platform/DataLab/issues/85) - Test data paths may be added multiple times to `datalab.utils.tests.TST_PATH`
26 * This issue is related to [Issue #84](https://github.com/DataLab-Platform/DataLab/issues/84)
27 * Adding the test data paths multiple times to `datalab.utils.tests.TST_PATH` was causing the test data to be loaded multiple times, which lead to some tests failing (a simple workaround was added to V0.16.2: this issue is now fixed)
28 * Thanks again to [@rolandmas](https://github.com/rolandmas) for reporting the issue in the context of the Debian packaging
29 * Fixed [Issue #86](https://github.com/DataLab-Platform/DataLab/issues/86) - Average of N integer images overflows data type
30 * Fixed [Issue #87](https://github.com/DataLab-Platform/DataLab/issues/87) - Image average profile extraction: `AttributeError` when trying to edit profile parameters
31 * Fixed [Issue #88](https://github.com/DataLab-Platform/DataLab/issues/88) - Image segment profile: point coordinates inversion
32
33 ## DataLab Version 0.16.2 (2024-07-01) ##
34
35 This release requires PlotPy v2.4.0 or later, which brings the following bug fixes and new features:
36
37 * New constrast adjustment features and bug fixes:
38 * New layout: the vertical toolbar (which was constrained in a small area on the right side of the panel) is now a horizontal toolbar at the top of the panel, beside the title
39 * New "Set range" button: allows the user to set manually the minimum and maximum values of the histogram range
40 * Fixed histogram update issues when no image was currently selected (even if the an image was displayed and was selected before)
41 * Histogram range was not updated when either the minimum or maximum value was set using the "Minimum value" or "Maximum value" buttons (which have been renamed to "Min." and "Max." in this release)
42 * Histogram range was not updated when the "Set full range" button was clicked, or when the LUT range was modified using the "Scales / LUT range" form in "Properties" group box
43
44 * Image view context menu: new "Reverse X axis" feature
45
46 â„šī¸ Minor new features and enhancements:
47
48 * Image file types:
49 * Added native support for reading .SPE, .GEL, .NDPI and .REC image files
50 * Added support for any `imageio`-supported file format through configuration file (entry `imageio_formats` may be customized to complement the default list of supported formats: see [documentation](https://datalab-platform.com/en/features/image/menu_file.html#open-image) for more details)
51
52 đŸ› ī¸ Bug fixes:
53
54 * Image Fourier analysis:
55 * Fixed logarithmic scale for the magnitude spectrum (computing dB instead of natural logarithm)
56 * Fixed PSD computation with logarithmic scale (computing dB instead of natural logarithm)
57 * Updated the documentation to explicitly mention that the logarithmic scale is in dB
58
59 * Fixed [Issue #82](https://github.com/DataLab-Platform/DataLab/issues/82) - Macros are not renamed in DataLab after exporting them to Python scripts
60
61 * `ResultProperties` object can now be added to `SignalObj` or `ImageObj` metadata even outside a Qt event loop (because the label item is no longer created right away)
62
63 * Progress bar is now automatically closed as expected when an error occurrs during a long operation (e.g. when opening a file)
64
65 * Difference, division...: dialog box for the second operand selection was allowing to select a group (only a signal or an image should be selected)
66
67 * When doing an operation which involves an object (signal or image) with higher order number than the current object (e.g. when subtracting an image with an image from a group below the current image), the resulting object's title now correctly refers to the order numbers of the objects involved in the operation (e.g., to continue with the subtraction example mentioned above, the resulting object's title was previously referring to the order number before the insertion of the resulting image)
68
69 * Added support for additional test data folder thanks to the `DATALAB_DATA` environment variable (useful for testing purposes, and especially in the context of Debian packaging)
70
71 ## DataLab Version 0.16.1 (2024-06-21) ##
72
73 Since version 0.16.0, many validation functions have been added to the test suite. The percentage of validated compute functions has increased from 37% to 84% in this release.
74
75 NumPy 2.0 support has been added with this release.
76
77 â„šī¸ Minor new features and enhancements:
78
79 * Signal and image moving average and median filters:
80 * Added "Mode" parameter to choose the mode of the filter (e.g. "reflect", "constant", "nearest", "mirror", "wrap")
81 * The default mode is "reflect" for moving average and "nearest" for moving median
82 * This allows to handle edge effects when filtering signals and images
83
84 đŸ› ī¸ Bug fixes:
85
86 * Fixed Canny edge detection to return binary image as `uint8` instead of `bool` (for consistency with other image processing features)
87
88 * Fixed Image normalization: lower bound was wrongly set for `maximum` method
89
90 * Fixed `ValueError` when computing PSD with logarithmic scale
91
92 * Fixed Signal derivative algorithm: now using `numpy.gradient` instead of a custom implementation
93
94 * Fixed SciPy's `cumtrapz` deprecation: use `cumulative_trapezoid` instead
95
96 * Curve selection now shows the individual points of the curve (before, only the curve line width was broadened)
97
98 * Windows installer: add support for unstable releases (e.g., 0.16.1.dev0), thus allowing to easily install the latest development version of DataLab on Windows
99
100 * Fixed [Issue #81](https://github.com/DataLab-Platform/DataLab/issues/81) - When opening files, show progress dialog only if necessary
101
102 * Fixed [Issue #80](https://github.com/DataLab-Platform/DataLab/issues/80) - Plotting results: support for two use cases
103 * The features of the "Analysis" menu produce *results* (scalars): blob detection (circle coordinates), 2D peak detection (point coordinates), etc. Depending on the feature, result tables are displayed in the "Results" dialog box, and the results are also stored in the signal or image metadata: each line of the result table is an individual result, and each column is a property of the result - some results may consist only of a single individual result (e.g., image centroid or curve FHWM), while others may consist of multiple individual results (e.g., blob detection, contour detection, etc.).
104 * Before this change, the "Plot results" feature only supported plotting the first individual result of a result table, as a function of the index (of the signal or image objects) or any of the columns of the result table. This was not sufficient for some use cases, where the user wanted to plot multiple individual results of a result table.
105 * Now, the "Plot results" feature supports two use cases:
106 * "One curve per result title": Plotting the first individual result of a result table, as before
107 * "One curve per object (or ROI) and per result title": Plotting all individual results of a result table, as a function of the index (of the signal or image objects) or any of the columns of the result table
108 * The selection of the use case is done in the "Plot results" dialog box
109 * The default use case is "One curve per result title" if the result table has only one line, and "One curve per object (or ROI) and per result title" otherwise
110
111 ## DataLab Version 0.16.0 (2024-06-13) ##
112
113 đŸ’Ĩ New features and enhancements:
114
115 * Major user interface overhaul:
116 * The menu bar and toolbars have been reorganized to make the application more intuitive and easier to use
117 * Operations and processing features have been regrouped in submenus
118 * All visualization-related actions are now grouped in the plot view vertical toolbar
119 * Clarified the "Annotations" management (new buttons, toolbar action...)
120
121 * New validation process for signal and image features:
122 * Before this release, DataLab's validation process was exclusively done from the programmer's point of view, by writing unit tests and integration tests, thus ensuring that the code was working as expected (i.e. that no exception was raised and that the behavior was correct)
123 * With this release, a new validation process has been introduced, from the user's point of view, by adding new validation functions (marked with the `@pytest.mark.validation` decorator) in the test suite
124 * A new "Validation" section in the documentation explains how validation is done and contains a list of all validation functions with the statistics of the validation process (generated from the test suite)
125 * The validation process is a work in progress and will be improved in future versions
126
127 * "Properties" group box:
128 * Added "Scales" tab, to show and set the plot scales:
129 * X, Y for signals
130 * X, Y, Z (LUT range) for images
131
132 * View options:
133 * New "Show first only" option in the "View" menu, to show only the first curve (or image) when multiple curves (or images) are displayed in the plot view
134 * New (movable) label for FWHM computations, additional to the existing segment annotation
135
136 * I/O features:
137 * Added support for reading and writing .MAT files (MATLAB format)
138 * Create a new group when opening a file containing multiple signals or images (e.g. CSV file with multiple curves)
139
140 * Add support for binary images
141 * Signal ROI extraction: added new dialog box to manually edit the ROI lower and upper bounds after defining the ROI graphically
142
143 â„šī¸ New **Signal** operations, processing and analysis features:
144
145 | Menu | Submenu |Features |
146 |-------------|--------------|---------------------------------------------------------|
147 | New | New signal | Exponential, pulse, polynomial, custom (manual input) |
148 | Operations | | Exponential, Square root, Power |
149 | Operations | Operations with a constant | +, -, *, / |
150 | Processing | Axis Transformation | Reverse X-axis |
151 | Processing | Level Adjustment | Offset correction |
152 | Processing | Fourier analysis | Power spectrum, Phase spectrum, Magnitude spectrum, Power spectral density |
153 | Processing | Frequency filters | Low-pass, High-pass, Band-pass, Band-stop |
154 | Processing | | Windowing (Hanning, Hamming, Blackman, Blackman-Harris, Nuttall, Flat-top...) |
155 | Processing | Fit | Linear fit, Sinusoidal fit, Exponential fit, CDF fit |
156 | Analysis | | FWHM (Zero-crossing method), X value @ min/max, Sampling period/frequency, Dynamic parameters (ENOB, SNR, SINAD, THD, SFDR), -3dB bandwidth, Contrast |
157
158 â„šī¸ New **Image** operations, processing and analysis features:
159
160 | Menu | Submenu |Features |
161 |-------------|--------------|---------------------------------------------------------|
162 | Operations | | Exponential |
163 | Operations | Intensity profiles | Profile along a segment |
164 | Operations | Operations with a constant | +, -, *, / |
165 | Processing | Level Adjustment | Normalization, Clipping, Offset correction |
166 | Processing | Fourier analysis | Power spectrum, Phase spectrum, Magnitude spectrum, Power spectral density |
167 | Processing | Thresholding | Parametric, ISODATA, Li, Mean, Minimum, Otsu, Triangle, Yen |
168
169 đŸ› ī¸ Bug fixes:
170
171 * Fixed a performance issue due to an unnecessary refresh of the plot view when adding a new signal or image
172 * Fixed [Issue #77](https://github.com/DataLab-Platform/DataLab/issues/77) - Intensity profiles: unable to accept dialog the second time
173 * Fixed [Issue #75](https://github.com/DataLab-Platform/DataLab/issues/75) - View in a new window: curve anti-aliasing is not enabled by default
174 * Annotations visibility is now correctly saved and restored:
175 * Before this release, when modifying the annotations visibility in the separate plot view, the visibility was not saved and restored when reopening the plot view
176 * This has been [fixed upstream](https://github.com/PlotPyStack/PlotPy/commit/03faaa42e5d6d4016ea8c99334c29d46a5963467) in PlotPy (v2.3.3)