Add support for background images in ANDOR SIF files

Fix #178

Author: PierreRaybaut

CHANGELOG.md

@@ -6,6 +6,9 @@ See DataLab [roadmap page](https://datalab-platform.com/en/contributing/roadmap.
 
 💥 New features and enhancements:
 
+* ANDOR SIF Images:
+  * Added support for background images in ANDOR SIF files
+  * This closes [Issue #178](https://github.com/DataLab-Platform/DataLab/issues/178) - Add support for ANDOR SIF files with background image
 * Array editor (results, signal and image data, ...):
   * New "Copy all" button in the array editor dialog box, to copy all the data in the clipboard, including row and column headers
   * New "Export" button in the array editor dialog box, to export the data in a CSV file, including row and column headers

cdl/core/io/image/funcs.py

@@ -226,6 +226,30 @@ def read_all(self) -> np.ndarray:
             sif_file.seek(self.m_offset)
             block = sif_file.read(self.width * self.height * self.stacksize * 4)
             data = np.frombuffer(block, dtype=np.float32)
+            # If there is a background image, it will be stored just after the signal
+            # data. The background image is the same size as the signal data.
+            # To read the background image, we need to search for the next line starting
+            # with "Counts" and read the data from there.
+            while True:
+                line = sif_file.readline()
+                if not line:
+                    break
+                if line.startswith(b"Counts"):
+                    # Data starts 4 lines after the "Counts" line
+                    for _ in range(4):
+                        line = sif_file.readline()
+                    # Read the background image data
+                    background_data = sif_file.read(self.width * self.height * 4)
+                    background = np.frombuffer(background_data, dtype=np.float32)
+                    # Check if the background data is the same size as the signal data
+                    if background.size != data.size:
+                        # This is not a background image: not supported format
+                        break
+                    # Add the background data to the signal data, as an additional frame
+                    data = np.concatenate((data, background))
+                    # Update the stack size to include the background image
+                    self.stacksize += 1
+                    break
         return data.reshape(self.stacksize, self.height, self.width)
 
 

doc/locale/fr/LC_MESSAGES/contributing/changelog.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: DataLab \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-04-26 11:17+0200\n"
+"POT-Creation-Date: 2025-04-26 15:46+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: fr\n"
@@ -30,6 +30,15 @@ msgstr "DataLab Version 0.20.0"
 msgid "💥 New features and enhancements:"
 msgstr "💥 Nouvelles fonctionnalités et améliorations :"
 
+msgid "ANDOR SIF Images:"
+msgstr "Images ANDOR SIF :"
+
+msgid "Added support for background images in ANDOR SIF files"
+msgstr "Ajout de la prise en charge des images de fond dans les fichiers ANDOR SIF"
+
+msgid "This closes [Issue #178](https://github.com/DataLab-Platform/DataLab/issues/178) - Add support for ANDOR SIF files with background image"
+msgstr "Ceci clotûre le ticket [Issue #178](https://github.com/DataLab-Platform/DataLab/issues/178) - Ajout de la prise en charge des fichiers ANDOR SIF avec image de fond"
+
 msgid "Array editor (results, signal and image data, ...):"
 msgstr "Éditeur de tableau (résultats, données de signal et d'image, ...)"
 
@@ -45,7 +54,8 @@ msgstr "Nouvelle fonctionnalité \"Coller\" dans la boîte de dialogue de l'édi
 msgid "The features above require guidata v3.9.0 or later"
 msgstr "Les fonctionnalités ci-dessus nécessitent guidata v3.9.0 ou une version ultérieure"
 
-msgid "This closes [Issue #174](https://github.com/DataLab-Platform/DataLab/issues/174), [Issue #175](https://github.com/DataLab-Platform/DataLab/issues/175) et [Issue #176](https://github.com/DataLab-Platform/DataLab/issues/176)"
+#, fuzzy
+msgid "This closes [Issue #174](https://github.com/DataLab-Platform/DataLab/issues/174), [Issue #175](https://github.com/DataLab-Platform/DataLab/issues/175) and [Issue #176](https://github.com/DataLab-Platform/DataLab/issues/176)"
 msgstr "Ceci clotûre les tickets [Issue #174](https://github.com/DataLab-Platform/DataLab/issues/174), [Issue #175](https://github.com/DataLab-Platform/DataLab/issues/175) et [Issue #176](https://github.com/DataLab-Platform/DataLab/issues/176)"
 
 msgid "Fourier analysis features (\"Processing\" menu):"