Skip to content

Commit e453cee

Browse files
committed
Refactor documentation generation: remove unused processor methods CSV files and update related commands
1 parent 2ac6749 commit e453cee

7 files changed

Lines changed: 2 additions & 364 deletions

File tree

.vscode/tasks.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -289,7 +289,7 @@
289289
},
290290
{
291291
"label": "🛠️ Generate doc assets",
292-
"command": "${command:python.interpreterPath} -m guidata.utils.genreqs all && ${command:python.interpreterPath} doc/update_validation_status.py && ${command:python.interpreterPath} doc/update_processor_methods.py",
292+
"command": "${command:python.interpreterPath} -m guidata.utils.genreqs all && ${command:python.interpreterPath} doc/update_validation_status.py",
293293
"options": {
294294
"cwd": "${workspaceFolder}",
295295
"statusbar": {

datalab/proxy.py

Lines changed: 0 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,6 @@
4848
4949
.. autofunction:: proxy_context
5050
51-
.. _processor_methods:
52-
5351
Calling processor methods using proxy objects
5452
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
5553
@@ -71,54 +69,6 @@
7169
p = sigima.params.MovingAverageParam.create(n=30)
7270
proxy.calc("moving_average", p)
7371
74-
2. Directly calling the processor method from the proxy object:
75-
76-
.. code-block:: python
77-
78-
# Call a method without parameter
79-
proxy.compute_average()
80-
81-
# Call a method with parameters
82-
p = sigima.params.MovingAverageParam.create(n=30)
83-
proxy.compute_moving_average(p)
84-
85-
.. warning::
86-
87-
The `compute_{name}` methods are not statically defined in the proxy classes (and
88-
not even dynamically). They are nevertheless available through the proxy objects
89-
thanks to the magic method :meth:`__getattr__` which forwards the call to the
90-
:meth:`calc` method. However, this means that the methods are not listed in the
91-
proxy classes documentation, and they are not available in the auto-completion
92-
feature of your IDE.
93-
94-
Number of compute methods
95-
*************************
96-
97-
.. csv-table:: Number of compute methods
98-
:file: ../doc/processor_methods_nb.csv
99-
:header: Signal, Image, Total
100-
101-
Signal processing
102-
*****************
103-
104-
The following table lists the signal processor methods - it is automatically
105-
generated from the source code:
106-
107-
.. csv-table:: Signal processor methods
108-
:file: ../doc/processor_methods_signal.csv
109-
:header: Compute method, Description
110-
:widths: 40, 60
111-
112-
Image processing
113-
****************
114-
115-
The following table lists the image processor methods - it is automatically
116-
generated from the source code:
117-
118-
.. csv-table:: Image processor methods
119-
:file: ../doc/processor_methods_image.csv
120-
:header: Compute method, Description
121-
:widths: 40, 60
12272
"""
12373

12474
from __future__ import annotations
@@ -150,11 +100,6 @@ class RemoteProxy(RemoteClient):
150100
ValueError: Invalid timeout (must be >= 0.0)
151101
ValueError: Invalid number of retries (must be >= 1)
152102
153-
.. note::
154-
155-
The proxy object also allows to access DataLab computing methods exposed by
156-
the processor classes (see :ref:`processor_methods`).
157-
158103
Examples:
159104
Here is a simple example of how to use RemoteProxy in a Python script
160105
or in a Jupyter notebook:
@@ -192,11 +137,6 @@ class LocalProxy(BaseProxy):
192137
193138
Args:
194139
datalab (DLMainWindow): DLMainWindow instance.
195-
196-
.. note::
197-
198-
The proxy object also allows to access DataLab computing methods exposed by
199-
the processor classes (see :ref:`processor_methods`).
200140
"""
201141

202142
def add_signal(

doc/locale/fr/LC_MESSAGES/api/proxy.po

Lines changed: 1 addition & 197 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: DataLab \n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2025-07-08 15:38+0200\n"
11+
"POT-Creation-Date: 2025-07-08 17:54+0200\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language: fr\n"
@@ -55,9 +55,6 @@ msgstr ""
5555
msgid "Invalid number of retries (must be >= 1)"
5656
msgstr ""
5757

58-
msgid "The proxy object also allows to access DataLab computing methods exposed by the processor classes (see :ref:`processor_methods`)."
59-
msgstr ""
60-
6158
msgid "Examples"
6259
msgstr ""
6360

@@ -484,196 +481,3 @@ msgstr ""
484481
msgid "To run a computation feature associated to a processor, you can use the :meth:`calc` method of the proxy object:"
485482
msgstr ""
486483

487-
msgid "Directly calling the processor method from the proxy object:"
488-
msgstr ""
489-
490-
#, python-brace-format
491-
msgid "The `compute_{name}` methods are not statically defined in the proxy classes (and not even dynamically). They are nevertheless available through the proxy objects thanks to the magic method :meth:`__getattr__` which forwards the call to the :meth:`calc` method. However, this means that the methods are not listed in the proxy classes documentation, and they are not available in the auto-completion feature of your IDE."
492-
msgstr ""
493-
494-
msgid "Number of compute methods"
495-
msgstr ""
496-
497-
msgid "Signal"
498-
msgstr ""
499-
500-
msgid "Image"
501-
msgstr ""
502-
503-
msgid "Total"
504-
msgstr ""
505-
506-
msgid "11"
507-
msgstr ""
508-
509-
msgid "14"
510-
msgstr ""
511-
512-
msgid "25"
513-
msgstr ""
514-
515-
msgid "Signal processing"
516-
msgstr ""
517-
518-
msgid "The following table lists the signal processor methods - it is automatically generated from the source code:"
519-
msgstr ""
520-
521-
msgid "Signal processor methods"
522-
msgstr ""
523-
524-
msgid "Compute method"
525-
msgstr ""
526-
527-
msgid "Description"
528-
msgstr ""
529-
530-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_all_stability`"
531-
msgstr ""
532-
533-
msgid "Compute all stability analysis features"
534-
msgstr ""
535-
536-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_fit`"
537-
msgstr ""
538-
539-
msgid "Compute fitting curve using an interactive dialog"
540-
msgstr ""
541-
542-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_full_width_at_y`"
543-
msgstr ""
544-
545-
msgid "Compute full width at a given y"
546-
msgstr ""
547-
548-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_multigaussianfit`"
549-
msgstr ""
550-
551-
msgid "Compute multi-Gaussian fitting curve using an interactive dialog"
552-
msgstr ""
553-
554-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_multiple_1_to_1`"
555-
msgstr ""
556-
557-
msgid "Generic processing method: 1 object in → n objects out"
558-
msgstr ""
559-
560-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_offset_correction`"
561-
msgstr ""
562-
563-
msgid "Compute offset correction"
564-
msgstr ""
565-
566-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_peak_detection`"
567-
msgstr ""
568-
569-
msgid "Detect peaks from data"
570-
msgstr ""
571-
572-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_polyfit`"
573-
msgstr ""
574-
575-
msgid "Compute polynomial fitting curve"
576-
msgstr ""
577-
578-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_roi_extraction`"
579-
msgstr ""
580-
581-
msgid "Extract Region Of Interest (ROI) from data"
582-
msgstr ""
583-
584-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_x_at_y`"
585-
msgstr ""
586-
587-
msgid "Compute x at y with :py:func:`sigima.proc.signal.x_at_y`"
588-
msgstr ""
589-
590-
msgid ":py:func:`~datalab.gui.processor.signal.SignalProcessor.compute_y_at_x`"
591-
msgstr ""
592-
593-
msgid "Compute y at x with :py:func:`sigima.proc.signal.y_at_x`"
594-
msgstr ""
595-
596-
msgid "Image processing"
597-
msgstr ""
598-
599-
msgid "The following table lists the image processor methods - it is automatically generated from the source code:"
600-
msgstr ""
601-
602-
msgid "Image processor methods"
603-
msgstr ""
604-
605-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_all_denoise`"
606-
msgstr ""
607-
608-
msgid "Compute all denoising filters"
609-
msgstr ""
610-
611-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_all_edges`"
612-
msgstr ""
613-
614-
msgid "Compute all edges filters"
615-
msgstr ""
616-
617-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_all_morphology`"
618-
msgstr ""
619-
620-
msgid "Compute all morphology filters"
621-
msgstr ""
622-
623-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_all_threshold`"
624-
msgstr ""
625-
626-
msgid "Compute all threshold algorithms"
627-
msgstr ""
628-
629-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_average_profile`"
630-
msgstr ""
631-
632-
msgid "Compute average profile"
633-
msgstr ""
634-
635-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_binning`"
636-
msgstr ""
637-
638-
msgid "Binning image with :py:func:`sigima.proc.image.binning`"
639-
msgstr ""
640-
641-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_line_profile`"
642-
msgstr ""
643-
644-
msgid "Compute profile along a vertical or horizontal line"
645-
msgstr ""
646-
647-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_multiple_1_to_1`"
648-
msgstr ""
649-
650-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_offset_correction`"
651-
msgstr ""
652-
653-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_peak_detection`"
654-
msgstr ""
655-
656-
msgid "Compute 2D peak detection"
657-
msgstr ""
658-
659-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_radial_profile`"
660-
msgstr ""
661-
662-
msgid "Compute radial profile"
663-
msgstr ""
664-
665-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_resize`"
666-
msgstr ""
667-
668-
msgid "Resize image with :py:func:`sigima.proc.image.resize`"
669-
msgstr ""
670-
671-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_roi_extraction`"
672-
msgstr ""
673-
674-
msgid ":py:func:`~datalab.gui.processor.image.ImageProcessor.compute_segment_profile`"
675-
msgstr ""
676-
677-
msgid "Compute profile along a segment"
678-
msgstr ""
679-

doc/processor_methods_image.csv

Lines changed: 0 additions & 14 deletions
This file was deleted.

doc/processor_methods_nb.csv

Lines changed: 0 additions & 1 deletion
This file was deleted.

doc/processor_methods_signal.csv

Lines changed: 0 additions & 11 deletions
This file was deleted.

0 commit comments

Comments
 (0)