File: getting_started.rst

package info (click to toggle)
python-sigima 1.1.1-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 25,608 kB
  • sloc: python: 35,251; makefile: 3
file content (66 lines) | stat: -rw-r--r-- 2,311 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.. _getting_started:

Getting Started
===============

This page provides a quick introduction to get you started with Sigima through practical examples.

Interactive Notebook
--------------------

The best way to start learning Sigima is through an interactive Jupyter notebook. This example demonstrates image processing with Regions of Interest (ROI) and uses the matplotlib backend for web-friendly visualization.

:download:`Download simple_example.ipynb <../simple_example.ipynb>`

.. toctree::
   :maxdepth: 1

   ../simple_example

What This Example Shows
^^^^^^^^^^^^^^^^^^^^^^^^

The notebook demonstrates:

* Creating image objects from NumPy arrays
* Defining Regions of Interest (ROI) for selective processing
* Applying Gaussian filtering to images
* Visualizing results with matplotlib backend (web-friendly, no Qt required)
* Using the new visualization backend selection feature introduced in Sigima V1.1

Key Concepts
^^^^^^^^^^^^

**Object-Oriented Approach**
   Sigima wraps NumPy arrays in rich objects (``SignalObj``, ``ImageObj``) that carry metadata, units, and ROI information.

**Region of Interest (ROI)**
   Process only specific areas of your data by defining ROIs. The example shows a circular ROI applied to an image.

**Backend Flexibility**
   Choose between PlotPy (Qt-based, interactive) or Matplotlib (web-friendly) backends for visualization, making Sigima suitable for both desktop applications and web-based workflows.

Remote Control Example
----------------------

Sigima also enables remote control of DataLab sessions from external scripts or notebooks. This is useful for automation, batch processing, or integrating DataLab into larger workflows.

:download:`Download remote_example.ipynb <../remote_example.ipynb>`

.. toctree::
   :maxdepth: 1

   ../remote_example

This notebook demonstrates:

* Connecting to a running DataLab instance using ``SimpleRemoteProxy``
* Adding signals and images to DataLab from external Python code
* Controlling DataLab programmatically without GUI interaction

Next Steps
----------

* Explore the :ref:`features` page for a complete overview of available operations
* Check out the :ref:`API documentation <api>` for detailed function references
* Browse the :doc:`gallery of examples </auto_examples/index>` for more use cases