Add smart linewidth clamping for large datasets

Implement automatic line width optimization to prevent 10x rendering
slowdown on large signal datasets (>10,000 points by default).

- Add sig_linewidth_perfs_threshold config option
- Modify CurveStyles.apply_style() to accept data_size parameter
- Auto-clamp linewidth to 1.0 when dataset exceeds threshold
- Update settings UI and documentation

Qt's raster engine exhibits significant slowdown with thick lines
(width > 1.0) on large datasets. This transparent optimization
maintains user flexibility for small datasets while ensuring good
performance for large ones.

Author: PierreRaybaut

CHANGELOG.md

@@ -6,6 +6,13 @@ See DataLab [roadmap page](https://datalab-platform.com/en/contributing/roadmap.
 
 💥 New features and enhancements:
 
+* **Signal rendering performance optimization**: Added smart linewidth clamping for large datasets
+  * New setting: "Line width performance threshold" (default: 1,000 points) in Signals visualization settings
+  * For signals with more points than the threshold, line width is automatically limited to 1.0 to prevent 10x rendering slowdown
+  * For smaller signals, the configured default line width applies normally (user-configurable)
+  * Performance optimization is transparent - no warnings, just automatic adjustment based on dataset size
+  * Addresses Qt raster engine limitation where thick lines (width > 1.0) cause significant rendering performance degradation on large datasets
+
 * **New "Create" menu**: Separated object creation functionality into dedicated menu between "File" and "Edit" menus
   * The "Create" menu now contains all signal and image creation actions previously in "File > New [...]"
   * Provides clearer organization by separating creation from file operations (open/save)

datalab/adapters_plotpy/objects/signal.py

@@ -10,7 +10,7 @@
 from __future__ import annotations
 
 from contextlib import contextmanager
-from typing import TYPE_CHECKING, Generator
+from typing import Generator
 
 import numpy as np
 from guidata.dataset import restore_dataset, update_dataset
@@ -23,9 +23,6 @@
 )
 from datalab.config import Conf
 
-if TYPE_CHECKING:
-    from plotpy.styles import CurveParam
-
 
 class CurveStyles:
     """Object to manage curve styles"""
@@ -58,17 +55,22 @@ def style_generator() -> Generator[tuple[str, str], None, None]:
                 for color in CurveStyles.COLORS:
                     yield (color, linestyle)
 
-    def apply_style(self, param: CurveParam) -> None:
-        """Apply style to curve"""
+    def apply_style(self, item: CurveItem) -> None:
+        """Apply style to curve
+
+        Args:
+            item: curve item
+        """
         if self.__suspend:
             # Suspend mode: always apply the first style
             color, linestyle = CurveStyles.COLORS[0], CurveStyles.LINESTYLES[0]
         else:
             color, linestyle = next(self.curve_style)
-        param.line.color = color
-        param.line.style = linestyle
-        param.line.width = Conf.view.sig_line_width.get(1.25)
-        param.symbol.marker = "NoSymbol"
+        item.param.line.color = color
+        item.param.line.style = linestyle
+        item.param.symbol.marker = "NoSymbol"
+        # Note: line width is set separately via apply_line_width()
+        # to ensure it's always recalculated based on current data size and settings
 
     def reset_styles(self) -> None:
         """Reset styles"""
@@ -95,6 +97,28 @@ def suspend(self) -> Generator[None, None, None]:
 CURVESTYLES = CurveStyles()  # This is the unique instance of the CurveStyles class
 
 
+def apply_line_width(item: CurveItem) -> None:
+    """Apply line width to curve item with smart clamping for large datasets
+
+    Args:
+        item: curve item
+    """
+    # Get data size
+    data_size = item.get_data()[0].size
+
+    # Get configured line width
+    line_width = Conf.view.sig_linewidth.get()
+
+    # For large datasets, clamp linewidth to 1.0 for performance
+    # (thick lines cause ~10x rendering slowdown due to Qt raster engine)
+    threshold = Conf.view.sig_linewidth_perfs_threshold.get()
+    if data_size > threshold and line_width > 1.0:
+        line_width = 1.0
+
+    # Apply the line width
+    item.param.line.width = line_width
+
+
 def apply_downsampling(item: CurveItem, do_not_update: bool = False) -> None:
     """Apply downsampling to curve item
 
@@ -177,8 +201,11 @@ def make_item(self, update_from: CurveItem | None = None) -> CurveItem:
                 else:  # x, y, dx, dy error bar signal with x error
                     dy = np.zeros_like(y) if dy is None else dy
                     item = make.merror(x.real, y.real, dx.real, dy.real, label=o.title)
-            CURVESTYLES.apply_style(item.param)
+            # Apply style (without linewidth, will be set separately)
+            CURVESTYLES.apply_style(item)
             apply_downsampling(item, do_not_update=True)
+            # Apply linewidth with smart clamping based on actual data size
+            apply_line_width(item)
         else:
             raise RuntimeError("data not supported")
         if update_from is None:
@@ -221,6 +248,8 @@ def update_item(self, item: CurveItem, data_changed: bool = True) -> None:
                 item.set_data(x.real, y.real, dx.real, dy.real)
         item.param.label = o.title
         apply_downsampling(item)
+        # Reapply linewidth with smart clamping (data size may have changed)
+        apply_line_width(item)
         self.update_plot_item_parameters(item)
 
     def add_label_with_title(self, title: str | None = None) -> None:

datalab/config.py

@@ -269,7 +269,8 @@ class ViewSection(conf.Section, metaclass=conf.SectionMeta):
     auto_refresh = conf.Option()
     show_first_only = conf.Option()  # Show only first selected item
     show_contrast = conf.Option()
-    sig_line_width = conf.Option()
+    sig_linewidth = conf.Option()
+    sig_linewidth_perfs_threshold = conf.Option()
     sig_antialiasing = conf.Option()
     sig_autodownsampling = conf.Option()
     sig_autodownsampling_maxpoints = conf.Option()
@@ -442,7 +443,8 @@ def initialize():
     tb_pos = Conf.view.plot_toolbar_position.get("left")
     assert tb_pos in ("top", "bottom", "left", "right")
     Conf.view.ignore_title_insertion_msg.get(False)
-    Conf.view.sig_line_width.get(1.25)
+    Conf.view.sig_linewidth.get(1.0)
+    Conf.view.sig_linewidth_perfs_threshold.get(1000)
     Conf.view.sig_autodownsampling.get(True)
     Conf.view.sig_autodownsampling_maxpoints.get(100000)
     Conf.view.sig_autoscale_margin_percent.get(2.0)

datalab/gui/main.py

@@ -2000,7 +2000,7 @@ def __edit_settings(self) -> None:
                     widget = dock.widget()
                     if isinstance(widget, DockablePlotWidget):
                         widget.update_toolbar_position()
-            if option.startswith("sig_autodownsampling"):
+            if option.startswith(("sig_autodownsampling", "sig_linewidth")):
                 refresh_signal_panel = True
             if option == "sig_autoscale_margin_percent":
                 # Update signal plot widget autoscale margin

datalab/gui/settings.py

@@ -321,12 +321,24 @@ class ViewSettings(gds.DataSet):
 
     g1 = gds.BeginGroup(_("Signals")).set_prop("display", icon="signal.svg")
     _prop_ads = gds.ValueProp(False)
-    sig_line_width = gds.FloatItem(
+    sig_linewidth = gds.FloatItem(
         _("Default line width"),
-        default=1.25,
+        default=1.0,
         min=0.1,
         help=_("Default line width for curves representing signals"),
     )
+    sig_linewidth_perfs_threshold = gds.IntItem(
+        _("Performance threshold"),
+        default=1000,
+        min=100,
+        help=_(
+            "Number of points threshold for line width limitation.\n"
+            "For signals with more than this number of points, "
+            "line width is automatically limited to 1.0 for performance reasons.\n\n"
+            "That's because the Qt raster engine experiences significant rendering "
+            "slowdowns with thick lines on large datasets."
+        ),
+    )
     sig_autodownsampling = gds.BoolItem(
         "",
         _("Use auto downsampling"),

datalab/locale/fr/LC_MESSAGES/datalab.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  datalab\n"
 "Report-Msgid-Bugs-To: p.raybaut@codra.fr\n"
-"POT-Creation-Date: 2025-11-14 18:51+0100\n"
+"POT-Creation-Date: 2025-11-15 17:20+0100\n"
 "PO-Revision-Date: 2025-05-22 15:46+0200\n"
 "Last-Translator: Christophe Debonnel <c.debonnel@codra.fr>\n"
 "Language: fr\n"
@@ -1274,12 +1274,6 @@ msgstr "1 objet source n'existe plus."
 msgid "%d source objects no longer exist"
 msgstr "%d objets source n'existent plus."
 
-msgid "Show results obtained from previous analysis"
-msgstr "Afficher les résultats obtenus avec des analyses réalisées précédemment"
-
-msgid "Open a dialog to edit annotations"
-msgstr "Ouvrir une boîte de dialogue pour éditer les annotations"
-
 msgid "No result currently available for this object."
 msgstr "Aucun résultat disponible pour le moment."
 
@@ -2375,6 +2369,20 @@ msgstr "Épaisseur par défaut"
 msgid "Default line width for curves representing signals"
 msgstr "Épaisseur de trait par défaut pour les courbes représentant des signaux"
 
+msgid "Performance threshold"
+msgstr "Seuil de performance"
+
+msgid ""
+"Number of points threshold for line width limitation.\n"
+"For signals with more than this number of points, line width is automatically limited to 1.0 for performance reasons.\n"
+"\n"
+"That's because the Qt raster engine experiences significant rendering slowdowns with thick lines on large datasets."
+msgstr ""
+"Seuil du nombre de points pour la limitation de l'épaisseur de trait.\n"
+"Pour les signaux comportant plus de ce nombre de points, l'épaisseur de trait est automatiquement limitée à 1,0 pour des raisons de performance.\n"
+"\n"
+"Cela est dû au fait que le moteur de rendu Qt subit des ralentissements importants lors du rendu de lignes épaisses sur de grands ensembles de données."
+
 msgid "Use auto downsampling"
 msgstr "Utiliser l'auto-sous-échantillonnage"
 
@@ -3287,4 +3295,3 @@ msgstr "Merci de sélectionner le fichier à importer."
 
 msgid "Example Wizard"
 msgstr "Assistant exemple"
-

doc/features/common/settings.rst

@@ -168,7 +168,16 @@ The Signals sub-tab contains settings specific to signal visualizations:
 
 **Default line width**
     Default line width for curves representing signals. This setting affects all signal
-    visualizations unless overridden individually.
+    visualizations unless overridden individually. Note: for signals exceeding the line
+    width performance threshold (see below), the line width is automatically clamped to
+    1.0 for optimal rendering performance.
+
+**Line width performance threshold**
+    For signals with more than this number of points (default: 1,000), line width is
+    automatically limited to 1.0 for performance reasons. This prevents the ~10x rendering
+    slowdown caused by Qt's raster engine when drawing thick lines (width > 1.0) on large
+    datasets. For smaller signals, the configured default line width applies normally.
+    This optimization is transparent and requires no user intervention.
 
 **Use auto downsampling**
     Enable automatic downsampling for large signals to improve performance and

doc/locale/fr/LC_MESSAGES/changelog.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: DataLab \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 10:57+0100\n"
+"POT-Creation-Date: 2025-11-15 17:19+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: fr\n"
@@ -30,6 +30,24 @@ msgstr "DataLab Version 1.0.0"
 msgid "💥 New features and enhancements:"
 msgstr "💥 Nouvelles fonctionnalités et améliorations :"
 
+msgid "**Signal rendering performance optimization**: Added smart linewidth clamping for large datasets"
+msgstr "**Optimisation des performances de rendu des signaux** : Ajout d'un plafonnement intelligent de l'épaisseur de trait pour les grands ensembles de données"
+
+msgid "New setting: \"Line width performance threshold\" (default: 1,000 points) in Signals visualization settings"
+msgstr "Nouveau paramètre : « Seuil de performance de l'épaisseur de trait » (par défaut : 1 000 points) dans les paramètres de visualisation des signaux"
+
+msgid "For signals with more points than the threshold, line width is automatically limited to 1.0 to prevent 10x rendering slowdown"
+msgstr "Pour les signaux comportant plus de points que le seuil, l'épaisseur de trait est automatiquement limitée à 1,0 pour éviter un ralentissement du rendu par un facteur 10"
+
+msgid "For smaller signals, the configured default line width applies normally (user-configurable)"
+msgstr "Pour les signaux plus petits, l'épaisseur de trait par défaut configurée s'applique normalement (configurable par l'utilisateur)"
+
+msgid "Performance optimization is transparent - no warnings, just automatic adjustment based on dataset size"
+msgstr "L'optimisation des performances est transparente - pas d'avertissements, juste un ajustement automatique basé sur la taille de l'ensemble de données"
+
+msgid "Addresses Qt raster engine limitation where thick lines (width > 1.0) cause significant rendering performance degradation on large datasets"
+msgstr "Traite la limitation du moteur raster Qt où les lignes épaisses (largeur > 1,0) entraînent une dégradation significative des performances de rendu sur de grands ensembles de données"
+
 msgid "**New \"Create\" menu**: Separated object creation functionality into dedicated menu between \"File\" and \"Edit\" menus"
 msgstr "**Nouveau menu \"Création\"** : Fonctionnalité de création d'objets séparée dans un menu dédié entre les menus \"Fichier\" et \"Édition\""
 

doc/locale/fr/LC_MESSAGES/features/common/settings.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: DataLab \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-12 16:10+0100\n"
+"POT-Creation-Date: 2025-11-15 17:19+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: fr\n"
@@ -241,8 +241,14 @@ msgstr "Préférences de visualisation - Sous-onglet Signaux"
 msgid "**Default line width**"
 msgstr "**Épaisseur par défaut**"
 
-msgid "Default line width for curves representing signals. This setting affects all signal visualizations unless overridden individually."
-msgstr "Épaisseur de ligne par défaut pour les courbes représentant des signaux. Ce paramètre affecte toutes les visualisations de signaux, sauf si elles sont remplacées individuellement."
+msgid "Default line width for curves representing signals. This setting affects all signal visualizations unless overridden individually. Note: for signals exceeding the line width performance threshold (see below), the line width is automatically clamped to 1.0 for optimal rendering performance."
+msgstr "Épaisseur de trait par défaut pour les courbes représentant les signaux. Ce paramètre affecte toutes les visualisations de signaux, sauf si elles sont remplacées individuellement. Remarque : pour les signaux dépassant le seuil de performance de l'épaisseur de trait (voir ci-dessous), l'épaisseur de trait est automatiquement plafonnée à 1,0 pour des performances de rendu optimales."
+
+msgid "**Line width performance threshold**"
+msgstr "**Seuil de performance de l'épaisseur de trait**"
+
+msgid "For signals with more than this number of points (default: 1,000), line width is automatically limited to 1.0 for performance reasons. This prevents the ~10x rendering slowdown caused by Qt's raster engine when drawing thick lines (width > 1.0) on large datasets. For smaller signals, the configured default line width applies normally. This optimization is transparent and requires no user intervention."
+msgstr "Pour les signaux comportant plus de ce nombre de points (par défaut : 1 000), l'épaisseur de trait est automatiquement limitée à 1,0 pour des raisons de performance. Cela évite le ralentissement du rendu d'environ 10x causé par le moteur raster de Qt lors du dessin de lignes épaisses (largeur > 1,0) sur de grands ensembles de données. Pour les signaux plus petits, l'épaisseur de trait par défaut configurée s'applique normalement. Cette optimisation est transparente et ne nécessite aucune intervention de l'utilisateur."
 
 msgid "**Use auto downsampling**"
 msgstr "**Utiliser le sous-échantillonnage automatique**"