Skip to content

Commit 24cd72f

Browse files
committed
Update documentation
1 parent 8082750 commit 24cd72f

File tree

39 files changed

+2184
-362
lines changed

39 files changed

+2184
-362
lines changed

en/.doctrees/api/computation.doctree

50 KB
Binary file not shown.

en/.doctrees/api/proxy.doctree

144 KB
Binary file not shown.
214 KB
Binary file not shown.

en/.doctrees/environment.pickle

275 KB
Binary file not shown.
2.99 KB
Binary file not shown.

en/_modules/cdl/computation/image/threshold.html

Lines changed: 33 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -485,7 +485,7 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
485485

486486

487487
<div class="viewcode-block" id="ThresholdParam">
488-
<a class="viewcode-back" href="../../../../api/param.html#cdl.param.ThresholdParam">[docs]</a>
488+
<a class="viewcode-back" href="../../../../api/param.html#cdl.computation.image.threshold.ThresholdParam">[docs]</a>
489489
<span class="k">class</span> <span class="nc">ThresholdParam</span><span class="p">(</span><span class="n">gds</span><span class="o">.</span><span class="n">DataSet</span><span class="p">):</span>
490490
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Histogram threshold parameters&quot;&quot;&quot;</span>
491491

@@ -519,6 +519,8 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
519519

520520

521521

522+
<div class="viewcode-block" id="compute_threshold">
523+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold">[docs]</a>
522524
<span class="k">def</span> <span class="nf">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">,</span> <span class="n">p</span><span class="p">:</span> <span class="n">ThresholdParam</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
523525
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold.</span>
524526

@@ -544,9 +546,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
544546
<span class="n">dst</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="n">skimage</span><span class="o">.</span><span class="n">util</span><span class="o">.</span><span class="n">img_as_ubyte</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
545547
<span class="n">dst</span><span class="o">.</span><span class="n">zscalemin</span><span class="p">,</span> <span class="n">dst</span><span class="o">.</span><span class="n">zscalemax</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">255</span> <span class="c1"># LUT range</span>
546548
<span class="n">dst</span><span class="o">.</span><span class="n">metadata</span><span class="p">[</span><span class="s2">&quot;colormap&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;gray&quot;</span>
547-
<span class="k">return</span> <span class="n">dst</span>
549+
<span class="k">return</span> <span class="n">dst</span></div>
548550

549551

552+
553+
<div class="viewcode-block" id="compute_threshold_isodata">
554+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_isodata">[docs]</a>
550555
<span class="k">def</span> <span class="nf">compute_threshold_isodata</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
551556
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Isodata algorithm with default parameters.</span>
552557

@@ -556,9 +561,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
556561
<span class="sd"> Returns:</span>
557562
<span class="sd"> Output image object</span>
558563
<span class="sd"> &quot;&quot;&quot;</span>
559-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;isodata&quot;</span><span class="p">))</span>
564+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;isodata&quot;</span><span class="p">))</span></div>
565+
560566

561567

568+
<div class="viewcode-block" id="compute_threshold_li">
569+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_li">[docs]</a>
562570
<span class="k">def</span> <span class="nf">compute_threshold_li</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
563571
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Li algorithm with default parameters.</span>
564572

@@ -568,9 +576,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
568576
<span class="sd"> Returns:</span>
569577
<span class="sd"> Output image object</span>
570578
<span class="sd"> &quot;&quot;&quot;</span>
571-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;li&quot;</span><span class="p">))</span>
579+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;li&quot;</span><span class="p">))</span></div>
572580

573581

582+
583+
<div class="viewcode-block" id="compute_threshold_mean">
584+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_mean">[docs]</a>
574585
<span class="k">def</span> <span class="nf">compute_threshold_mean</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
575586
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Mean algorithm.</span>
576587

@@ -580,9 +591,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
580591
<span class="sd"> Returns:</span>
581592
<span class="sd"> Output image object</span>
582593
<span class="sd"> &quot;&quot;&quot;</span>
583-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;mean&quot;</span><span class="p">))</span>
594+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;mean&quot;</span><span class="p">))</span></div>
595+
584596

585597

598+
<div class="viewcode-block" id="compute_threshold_minimum">
599+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_minimum">[docs]</a>
586600
<span class="k">def</span> <span class="nf">compute_threshold_minimum</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
587601
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Minimum algorithm with default parameters.</span>
588602

@@ -592,9 +606,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
592606
<span class="sd"> Returns:</span>
593607
<span class="sd"> Output image object</span>
594608
<span class="sd"> &quot;&quot;&quot;</span>
595-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;minimum&quot;</span><span class="p">))</span>
609+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;minimum&quot;</span><span class="p">))</span></div>
596610

597611

612+
613+
<div class="viewcode-block" id="compute_threshold_otsu">
614+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_otsu">[docs]</a>
598615
<span class="k">def</span> <span class="nf">compute_threshold_otsu</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
599616
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Otsu algorithm with default parameters.</span>
600617

@@ -604,9 +621,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
604621
<span class="sd"> Returns:</span>
605622
<span class="sd"> Output image object</span>
606623
<span class="sd"> &quot;&quot;&quot;</span>
607-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;otsu&quot;</span><span class="p">))</span>
624+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;otsu&quot;</span><span class="p">))</span></div>
625+
608626

609627

628+
<div class="viewcode-block" id="compute_threshold_triangle">
629+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_triangle">[docs]</a>
610630
<span class="k">def</span> <span class="nf">compute_threshold_triangle</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
611631
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Triangle algorithm with default parameters.</span>
612632

@@ -616,9 +636,12 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
616636
<span class="sd"> Returns:</span>
617637
<span class="sd"> Output image object</span>
618638
<span class="sd"> &quot;&quot;&quot;</span>
619-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;triangle&quot;</span><span class="p">))</span>
639+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;triangle&quot;</span><span class="p">))</span></div>
620640

621641

642+
643+
<div class="viewcode-block" id="compute_threshold_yen">
644+
<a class="viewcode-back" href="../../../../api/computation.html#cdl.computation.image.threshold.compute_threshold_yen">[docs]</a>
622645
<span class="k">def</span> <span class="nf">compute_threshold_yen</span><span class="p">(</span><span class="n">src</span><span class="p">:</span> <span class="n">ImageObj</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ImageObj</span><span class="p">:</span>
623646
<span class="w"> </span><span class="sd">&quot;&quot;&quot;Compute the threshold using the Yen algorithm with default parameters.</span>
624647

@@ -628,7 +651,8 @@ <h1>Source code for cdl.computation.image.threshold</h1><div class="highlight"><
628651
<span class="sd"> Returns:</span>
629652
<span class="sd"> Output image object</span>
630653
<span class="sd"> &quot;&quot;&quot;</span>
631-
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;yen&quot;</span><span class="p">))</span>
654+
<span class="k">return</span> <span class="n">compute_threshold</span><span class="p">(</span><span class="n">src</span><span class="p">,</span> <span class="n">ThresholdParam</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">method</span><span class="o">=</span><span class="s2">&quot;yen&quot;</span><span class="p">))</span></div>
655+
632656
</pre></div>
633657

634658
</article>

en/_modules/cdl/proxy.html

Lines changed: 50 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -465,6 +465,9 @@ <h1>Source code for cdl.proxy</h1><div class="highlight"><pre>
465465
<span class="sd">The :mod:`cdl.proxy` module provides a way to access DataLab features from a proxy</span>
466466
<span class="sd">class.</span>
467467

468+
<span class="sd">The list of compute methods accessible from the proxy objects is available in the</span>
469+
<span class="sd">:ref:`processor_methods` section.</span>
470+
468471
<span class="sd">Remote proxy</span>
469472
<span class="sd">^^^^^^^^^^^^</span>
470473

@@ -505,6 +508,46 @@ <h1>Source code for cdl.proxy</h1><div class="highlight"><pre>
505508
<span class="sd"> between local and remote proxy, keeping the same code inside the context.</span>
506509

507510
<span class="sd">.. autofunction:: proxy_context</span>
511+
512+
<span class="sd">.. _processor_methods:</span>
513+
514+
<span class="sd">List of compute methods</span>
515+
<span class="sd">^^^^^^^^^^^^^^^^^^^^^^^</span>
516+
517+
<span class="sd">All the proxy objects provide access to the DataLab computing methods exposed by</span>
518+
<span class="sd">the processor classes:</span>
519+
520+
<span class="sd">- :class:`cdl.core.gui.processor.signal.SignalProcessor`</span>
521+
<span class="sd">- :class:`cdl.core.gui.processor.image.ImageProcessor`</span>
522+
523+
<span class="sd">Number of compute methods</span>
524+
<span class="sd">*************************</span>
525+
526+
<span class="sd">.. csv-table:: Number of compute methods</span>
527+
<span class="sd"> :file: ../doc/processor_methods_nb.csv</span>
528+
<span class="sd"> :header: Signal, Image, Total</span>
529+
530+
<span class="sd">Signal processing</span>
531+
<span class="sd">*****************</span>
532+
533+
<span class="sd">The following table lists the signal processor methods - it is automatically</span>
534+
<span class="sd">generated from the source code:</span>
535+
536+
<span class="sd">.. csv-table:: Signal processor methods</span>
537+
<span class="sd"> :file: ../doc/processor_methods_signal.csv</span>
538+
<span class="sd"> :header: Compute method, Description</span>
539+
<span class="sd"> :widths: 40, 60</span>
540+
541+
<span class="sd">Image processing</span>
542+
<span class="sd">****************</span>
543+
544+
<span class="sd">The following table lists the image processor methods - it is automatically</span>
545+
<span class="sd">generated from the source code:</span>
546+
547+
<span class="sd">.. csv-table:: Image processor methods</span>
548+
<span class="sd"> :file: ../doc/processor_methods_image.csv</span>
549+
<span class="sd"> :header: Compute method, Description</span>
550+
<span class="sd"> :widths: 40, 60</span>
508551
<span class="sd">&quot;&quot;&quot;</span>
509552

510553
<span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
@@ -540,9 +583,8 @@ <h1>Source code for cdl.proxy</h1><div class="highlight"><pre>
540583

541584
<span class="sd"> .. note::</span>
542585

543-
<span class="sd"> The proxy object also allows to access DataLab computing functions operating</span>
544-
<span class="sd"> on signals and images (</span>
545-
<span class="sd"> :mod:`cdl.computation`).</span>
586+
<span class="sd"> The proxy object also allows to access DataLab computing methods exposed by</span>
587+
<span class="sd"> the processor classes (see :ref:`processor_methods`).</span>
546588

547589
<span class="sd"> Examples:</span>
548590
<span class="sd"> Here is a simple example of how to use RemoteProxy in a Python script</span>
@@ -584,6 +626,11 @@ <h1>Source code for cdl.proxy</h1><div class="highlight"><pre>
584626

585627
<span class="sd"> Args:</span>
586628
<span class="sd"> cdl (CDLMainWindow): CDLMainWindow instance.</span>
629+
630+
<span class="sd"> .. note::</span>
631+
632+
<span class="sd"> The proxy object also allows to access DataLab computing methods exposed by</span>
633+
<span class="sd"> the processor classes (see :ref:`processor_methods`).</span>
587634
<span class="sd"> &quot;&quot;&quot;</span>
588635

589636
<div class="viewcode-block" id="LocalProxy.add_signal">

en/_sources/features/validation/status.rst.txt

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,21 @@ what we call scientific validation, see :ref:`scientific_validation`).
3939
Signal Compute Functions
4040
^^^^^^^^^^^^^^^^^^^^^^^^
4141

42+
The table below shows the validation status of signal compute functions in DataLab.
43+
It is automatically generated from the source code.
44+
4245
.. csv-table:: Validation status of signal compute functions
4346
:file: ../../validation_status_signal.csv
44-
:header: Function, Description, Test function
45-
:widths: 20, 40, 40
47+
:header: Compute function, Description, Test function
48+
:widths: 30, 40, 30
4649

4750
Image Compute Functions
4851
^^^^^^^^^^^^^^^^^^^^^^^
4952

53+
The table below shows the validation status of image compute functions in DataLab.
54+
It is automatically generated from the source code.
55+
5056
.. csv-table:: Validation status of image compute functions
5157
:file: ../../validation_status_image.csv
52-
:header: Function, Description, Test function
53-
:widths: 20, 40, 40
58+
:header: Compute function, Description, Test function
59+
:widths: 30, 40, 30

0 commit comments

Comments
 (0)