|
1 | 1 | # Changelog |
2 | 2 |
|
3 | | -All notable changes to this project will be documented in this file. |
4 | | - |
5 | | -The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), |
6 | | -and this project uses [Calendar Versioning](https://calver.org/) with a `YYYY.minor.patch` scheme. |
7 | | -All dates in this file are given in the [UTC time zone](https://en.wikipedia.org/wiki/Coordinated_Universal_Time). |
8 | | - |
9 | | -## Unreleased |
10 | | - |
11 | | -### Removed |
12 | | - |
13 | | -- (Hardware controller) The old raspimjpeg-based imager has been fully deleted, having been deprecated in v2024.0.0-alpha.2. |
14 | | -- Support for deployment on ARMv7 (32-bit OSes) is removed, having been deprecated in PlanktoScope OS v2024.0.0-beta.0. |
15 | | - |
16 | | -### Fixed |
17 | | - |
18 | | -- (Hardware controller) The ISO value stored in dataset metadata now correctly matches the user-set ISO setting, instead of being a constant scaling of the image gain (which is calculated from the user-set ISO according to a camera model-specific scaling factor). This fixes a regression introduced with v2024.0.0-beta.2. |
19 | | -- (Hardware controller) Error handling of a failure to create a raw image dataset directory (e.g. because the directory already exists, due to a duplicate acquisition ID) now correctly terminates the attempted data acquisition run. |
20 | | - |
21 | | -## v2024.0.0 - 2024-12-25 |
22 | | - |
23 | | -### Fixed |
24 | | - |
25 | | -- (Segmenter) The segmenter now correctly sets the `img_rank` metadata field of the EcoTaxa export to `1`, instead of setting it to an incrementing index which makes exports un-importable by EcoTaxa for datasets with more than ~32,000 objects. |
26 | | - |
27 | | -## v2024.0.0-beta.3 - 2024-11-30 |
28 | | - |
29 | | -### Changed |
30 | | - |
31 | | -- (Hardware controller) The resolution of the camera preview stream has been reduced from 960x720 to 800x600 in an attempt to mitigate hard-to-reproduce preview stream latency problems. |
32 | | -- (Hardware controller) The bitrate of the camera preview stream has been reduced slightly from ~8 Mbps to ~7 Mbps. |
33 | | -- (Hardware controller) The framerate of the camera preview stream is now explicitly limited to 25 fps. |
34 | | - |
35 | | -### Fixed |
36 | | - |
37 | | -- (Breaking change; segmenter) The previously incorrect method for filtering segmented objects by size has now been corrected to filter object sizes by filled area rather than bounding box area, and directly using the mesh size as the threshold for equivalent spherical diameter (ESD) instead of calculating a fictional ESD. |
38 | | - |
39 | | -## v2024.0.0-beta.2 - 2024-08-19 |
40 | | - |
41 | | -### Changed |
42 | | - |
43 | | -- (Hardware controller) The default image gain used to initialize the camera module is now set to match a default equivalent ISO value of 150 across all camera sensor types, instead of being hard-coded to 1.0 (which corresponds to an ISO of around 40 or 50 depending on the camera sensor type). |
44 | | -- (Segmenter) Now the segmenter generates EcoTaxa export ZIP archives whose metadata files are not named `ecotaxa_export.tsv`, but instead are named `ecotaxa_{acquisition id}.tsv`, to enable more efficient bulk importing of those ZIP archives into EcoTaxa. |
45 | | - |
46 | | -## v2024.0.0-beta.1 - 2024-06-24 |
47 | | - |
48 | | -### Added |
49 | | - |
50 | | -- (Hardware controller) A default fairscope-latest hardware config file has been created as the default v2.6 hardware config file. |
51 | | - |
52 | | -### Changed |
53 | | - |
54 | | -- (Breaking change; hardware controller) The default planktoscopehat hardware config file has been rolled back from the default v2.6 hardware config file to the default v2.5 hardware config file. This reverts a change made in v2024.0.0-alpha.1. |
55 | | - |
56 | | -## v2024.0.0-beta.0 - 2024-06-07 |
57 | | - |
58 | | -(this release involves no changes from v2024.0.0-alpha.2; it's just a promotion of v204.0.0-alpha.2 to a beta pre-release) |
59 | | - |
60 | | -## v2024.0.0-alpha.2 - 2024-04-25 |
61 | | - |
62 | | -### Changed |
63 | | - |
64 | | -- (Breaking change; segmenter) Previously, the segmenter's default behavior was to subtract consecutive masks to try to mitigate image-processing issues with objects which get stuck to the flowcell during imaging. However, when different objects occupied the same space in consecutive frames, the subtraction behavior would subtract one object's mask from the mask of the other object in the following frame, which would produce clearly incorrect masks. This behavior is no longer enabled by default; in order to re-enable it, you should set the environment variable `SEGMENTER_PIPELINE_SUBTRACT_CONSECUTIVE_MASKS=true` when launching the segmenter. |
65 | | -- (Hardware controller) The image quality of frames in the camera preview stream for the picamera2-based imager is increased, and frames also have greater width and height. |
66 | | - |
67 | | -### Deprecated |
68 | | - |
69 | | -- (Hardware controller) The old raspimjpeg-based imager is deprecated and will be fully deleted in a subsequent release (potentially as early as v2024.1.0). |
70 | | - |
71 | | -### Fixed |
72 | | - |
73 | | -- (Hardware controller) The incorrect scaling factor for converting between ISO settings (in the MQTT API) and image gains is fixed. |
74 | | - |
75 | | -## v2024.0.0-alpha.1 - 2024-03-26 |
76 | | - |
77 | | -### Added |
78 | | - |
79 | | -- (Hardware controller) A new picamera2-based camera-management module (`camera`) is now available as an alternative to the camera-management part of the previous raspimjpeg-based image-acquisition-and-camera-management module. |
80 | | -- (Hardware controller) A new image-acquisition module (`imagernew`) is now available for use with the new picamera2-based `camera` module, as an alternative to the image-acquisition part of the previous raspimjpeg-based image-acquisition-and-camera-management module. |
81 | | - |
82 | | -### Changed |
83 | | - |
84 | | -- (Hardware controller) The new picamera2-based image-acquisition module (`imagernew`) is now used by default, instead of the previous raspimjpeg-based `imager` module. |
85 | | -- (Breaking change; segmenter) EcoTaxa export archive filenames are now saved as `ecotaxa_{acquisition id}.zip` instead of `ecotaxa_{project id}_{date}_{sample id}.zip`, which was long and redundant and (because many devices have incorrect system times) inappropriate for viewing files in a logically sorted order. |
86 | | -- (Breaking change; hardware controller) The version of the hardware controller for the PlanktoScope HAT has been moved from `control/pscopehat` to `control/planktoscopehat`. |
87 | | - |
88 | | -### Fixed |
89 | | - |
90 | | -- (Breaking change; hardware controller) Images acquired by the hardware controller using the newly-default `imagernew` image-acquisition module now have more unique filenames (which include an incrementing index and the date of image capture, rather than just the time of the image capture). |
91 | | -- (Hardware controller) The hardware controller using the newly-default `imagernew` image-acquisition module no longer crashes when invalid values are given for camera settings (e.g. null or non-numeric white balance gains). |
92 | | -- (Hardware controller) The pixel calibration values have been switched between the default v2.5 hardware config file and the default v2.6 hardware config file, so that each file has the correct pixel calibration. The default pscopehat hardware config file has also been updated to include the changes made to the default v2.6 hardware config file. |
93 | | -- (Breaking change; segmenter) The segmenter now runs as `root` (instead of `pi`) in the Docker container for it, so that it doesn't break on various actual & potential edge cases of files/directories being created with `root` ownership (rather than `pi` ownership) before being bind mounted into the container. |
94 | | - |
95 | | -## v2024.0.0-alpha.0 - 2024-02-06 |
96 | | - |
97 | | -### Added |
98 | | - |
99 | | -- (Segmenter) A Docker container image is now built for the segmenter, for amd64, arm64, and armv7. |
100 | | - |
101 | | -### Changed |
102 | | - |
103 | | -- (Breaking change) The machine name is now loaded from `/var/lib/planktoscope/machine-name`, rather than the previous location of `/home/pi/.local/etc/machine-name`. |
104 | | - |
105 | | -### Fixed |
106 | | - |
107 | | -- (Segmenter) An extraneous `export` directory should no longer be created by the segmenter under `/home/pi/PlanktoScope`. The correct directory is `/home/pi/data/export`. |
108 | | - |
109 | | -## v2023.9.0 - 2023-12-29 |
110 | | - |
111 | | -(this release involves no changes from v2023.9.0-beta.2; it's just a version bump) |
112 | | - |
113 | | -## v2023.9.0-beta.2 - 2023-12-02 |
114 | | - |
115 | | -### Added |
116 | | - |
117 | | -- A `hardware.json` file is now provided for the PlanktoScope v2.6 hardware. |
118 | | - |
119 | | -### Removed |
120 | | - |
121 | | -- Morphocut is no longer required by the segmenter as a Python package dependency. |
122 | | - |
123 | | -### Fixed |
124 | | - |
125 | | -- The default brightness of the illumination LED for the pscopehat version of the backend (for the custom PlanktoScope HAT) has been reduced; this a temporary workaround to a bug with raspimjpeg where saved images are overexposed even on the default brightness settings with minimum shutter speed and ISO, despite the brightness of raspimjpeg's camera preview looking reasonable (see https://github.com/PlanktoScope/PlanktoScope/issues/259 for details). |
126 | | - |
127 | | -## v2023.9.0-beta.1 - 2023-09-14 |
128 | | - |
129 | | -### Changed |
130 | | - |
131 | | -- The machine name has been switched to the new naming scheme provided by https://github.com/PlanktoScope/machine-name ; the machine name is loaded from a file (currently at `/home/pi/.local/etc/machine-name`, which must be automatically generaed by the host operating system) instead of being determined in Python. |
132 | | - |
133 | | -### Deprecated |
134 | | - |
135 | | -- The old "Baba"-based machine naming scheme should no longer be used. The `uuidName` module will be removed the next stable release (the stable release after v2023.9.0). |
136 | | - |
137 | | -### Fixed |
138 | | - |
139 | | -- All default settings for all hardware versions now include a default pixel size calibration of 0.75 um/pixel. Previously, the default settings for v2.1 and v2.3 were missing this setting, which would cause the segmenter to crash when processing datasets generated on PlanktoScopes using the v2.1 or v2.3 hardware settings. |
140 | | - |
141 | | -## v2023.9.0-beta.0 - 2023-09-02 |
142 | | - |
143 | | -### Changed |
144 | | - |
145 | | -- Split the Python backend into a hardware controller (of which there are two versions for the Adafruit HAT and the custom PlanktoScope HAT, respectively) and a data processing segmenter. These two components are run separately, and their dependencies are managed separately. |
146 | | -- Each component of the backend now saves its file logs to its respective folder in `/home/pi/device-backend`. |
147 | | - |
148 | | -### Fixed |
149 | | - |
150 | | -- The default `hardware.json` file for PlanktoScope v2.1 had incorrect keys for the white balance values; the keys have now been fixed. |
| 3 | +The changelog for this repository can be found [within github.com/PlanktoScope/PlanktoScope](https://github.com/PlanktoScope/PlanktoScope/blob/master/software/CHANGELOG.md). |
0 commit comments