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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
|
How to migrate from guiqwt
--------------------------
This section describes the steps to migrate python code using guiqwt to plotpy.
Updating the imports
^^^^^^^^^^^^^^^^^^^^
The following table gives the equivalence between guiqwt and plotpy classes.
For most of them, the change in the module path is the only difference (only
the import statement have to be updated in your client code). For others, the
third column of this table gives more details about the changes that may be
required in your code.
.. csv-table:: Compatibility table
:file: guiqwt_to_plotpy.csv
Generic PlotWidgets
^^^^^^^^^^^^^^^^^^^
The Curve and Image plot widgets/dialogs/windows classes have been merged
into generic classes capable of handling both plot items types.
As a consequence :
* The ``CurvePlot`` and ``ImagePlot`` classes have been removed.
If you are using them in your code, you can replace them by the
:py:class:`.BasePlot` class which takes only one argument for configuration,
named `options` (a :py:class:`.BasePlotOptions` instance). Choosing between
curve and image plot is now done by setting the `type` attribute of the
plot options (that may be set to ``'curve'`` or ``'image'`` for example).
See also the `Minor changes to the BasePlot class`_ section.
* The ``CurveWidget`` and ``ImageWidget`` classes have been merged into the new
class :py:class:`.PlotWidget`. If you are using them in your code,
you can replace them by the :py:class:`.PlotWidget` class, which takes only one
argument for configuration, named `options` (a :py:class:`.PlotOptions` instance).
Choosing between curve and image plot is now done by setting the `type` attribute
of the plot options (that may be set to ``'curve'`` or ``'image'`` for example).
* The `CurveDialog` and `ImageDialog` classes have been merged into the new class
:py:class:`.PlotDialog`. If you are using them in your code, you may proceed
as for the ``CurveWidget`` and ``ImageWidget`` classes.
* The ``CurveWindow`` and ``ImageWindow`` classes have been merged into the new class
:py:class:`.PlotWindow`. If you are using them in your code, you may proceed
as for the ``CurveWidget`` and ``ImageWidget`` classes.
.. note::
Instead of setting the `type` plot option attribute to ``'curve'`` or ``'image'``,
as stated above, you may consider using the ``'auto'`` value or the
``'manual'`` value.
See demo script `tests/features/test_plot_types.py`.
Minor changes to the BasePlot class
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Some small changes of the :py:class:`.BasePlot` class related
to the `Generic PlotWidgets`_ may require some minor adaptation of your code:
* The :py:meth:`.BasePlot.del_all_items` method now has an
``except_grid`` keyword argument defaulting to ``True``. This functionality was
previously only present in child classes starting from ``CurvePlot``,
and has been merged into the parent class :py:class:`.BasePlot`.
As a consequence, if you used the :py:class:`.BasePlot` class
directly (without using ``CurvePlot`` or other child classes), you may want to
pass ``except_grid=False`` to your
:py:meth:`.BasePlot.del_all_items` calls.
* Some arguments were added to the constructor of the :py:class:`.BasePlot` class
(the arguments of the constructors of the old classes ``CurvePlot`` and
``ImagePlot`` have been merged): the new `type` of the plot
(see `Generic PlotWidgets`_), and the arguments of the ``ImagePlot``
constructor that the ``CurvePlot`` constructor missed : ``zlabel``, ``zunit``,
``yreverse``, ``aspect_ratio``, ``lock_aspect_ratio`` and ``force_colorbar_enabled``.
As a consequence, if you did not use keywords, but positional-only arguments when
instantiating a ``CurvePlot`` or ``ImagePlot``, you should adapt the new calls to the
:py:class:`.BasePlot` constructor to meet the new arguments list.
Renamed update_curve and update_image methods
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The ``update_image`` method of the classes `BaseImageParam`, `QuadGridParam`
and their subclasses has been renamed to ``update_item``.
The ``update_curve`` method of the classes `CurveParam`, `ErrorBarParam` and
their subclasses has also been renamed to ``update_item``.
This change allows to treat plot items parameters in a more generic way in client code.
Renamed PlotItems fields
^^^^^^^^^^^^^^^^^^^^^^^^
The ``imageparam`` and ``curveparam`` fields of all plot item classes have been
renamed to ``param``.
This change allows to treat curve and image plot items in a more generic way
in client code.
New features
^^^^^^^^^^^^
The following subsections present new features that may help you to simplify
you code using plotpy.
New method for thresholding image item LUTs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The method :py:meth:`plotpy.items.BaseImageItem.set_lut_threshold` has been
added. It allows to set the percentage of outliers to be clipped from the image
histogram values.
This method is available for all image items:
* :py:class:`.ImageItem`
* :py:class:`.XYImageItem`
* :py:class:`.MaskedImageItem`
* :py:class:`.TrImageItem`
New annotation tools registration methods
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Some new methods were added to class :py:class:`.PlotManager`:
* :py:meth:`.PlotManager.register_curve_annotation_tools`:
register all curve related annotation tools,
* :py:meth:`.PlotManager.register_image_annotation_tools`:
register all image related annotation tools,
* :py:meth:`.PlotManager.register_all_annotation_tools`:
register all annotation tools.
You may use those methods to simplify you code if you were previously registering
annotation tools one by one.
See demo script `tests/items/test_annotations.py`.
New contour features
~~~~~~~~~~~~~~~~~~~~
PlotPy integrates contour detection plot items, based on the contour detection
algorithm provided by the `scikit-image` library.
As a consequence, the applications that previously depended on `matplotlib` only for
contour detection can now drop this dependency.
See demo script `tests/items/test_contour.py`.
MaskedXYImages
~~~~~~~~~~~~~~
You can now use the :py:class:`.MaskedXYImageItem` to apply masks to XYImageItems
(only ImageItems where previously maskable with the class :py:class:`.MaskedImageItem`.
You can use the convenience methods :py:meth:`.PlotBuilder.maskedxyimage` to
help you build such items.
See demo script `tests/items/test_image_masked_xy.py`.
New options added to plot builder
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The ``PlotItemBuilder`` factory class has been renamed to :py:class:`.PlotBuilder`,
because it provides not only methods for creating plot items, but also methods
for creating ready-to-use plots.
New methods for creating ready-to-use plots have been added to the class:
* :py:meth:`.PlotBuilder.widget`
* :py:meth:`.PlotBuilder.dialog`
* :py:meth:`.PlotBuilder.window`
The method :py:meth:`.PlotBuilder.contours` has been added, in order to create
contour curves. It returns a list of :py:class:`plotpy.items.ContourItem` objects.
See demo script `tests/items/test_contour.py`.
The new keyword parameter ``alpha_function`` has been added to the methods
:py:meth:`.PlotBuilder.image`, :py:meth:`.PlotBuilder.xyimage`,
:py:meth:`.PlotBuilder.maskedimage`, :py:meth:`.PlotBuilder.maskedxyimage`,
:py:meth:`.PlotBuilder.trimage`, :py:meth:`.PlotBuilder.rgbimage`, and
:py:meth:`.PlotBuilder.quadgrid`. It allows to specify a function to
compute the alpha channel of the image from the data values. The supported
functions are:
* :py:attr:`plotpy.constants.LUTAlpha.NONE` (default)
* :py:attr:`plotpy.constants.LUTAlpha.CONSTANT`
* :py:attr:`plotpy.constants.LUTAlpha.LINEAR`
* :py:attr:`plotpy.constants.LUTAlpha.SIGMOID`
* :py:attr:`plotpy.constants.LUTAlpha.TANH`
* :py:attr:`plotpy.constants.LUTAlpha.STEP`
.. warning:: The ``alpha_mask`` parameter has been removed from the methods
:py:meth:`.PlotBuilder.image`, :py:meth:`.PlotBuilder.xyimage`,
:py:meth:`.PlotBuilder.maskedimage`, :py:meth:`.PlotBuilder.maskedxyimage`,
:py:meth:`.PlotBuilder.trimage`, :py:meth:`.PlotBuilder.rgbimage`, and
:py:meth:`.PlotBuilder.quadgrid`. If you were using it, you should
replace it by the new ``alpha_function`` parameter.
The new keyword parameter ``lut_range`` has been added to the methods
:py:meth:`.PlotBuilder.image`, :py:meth:`.PlotBuilder.xyimage`,
:py:meth:`.PlotBuilder.maskedimage`, :py:meth:`.PlotBuilder.maskedxyimage`,
and :py:meth:`.PlotBuilder.trimage`, so you can now avoid to make calls
to set_lut_range after the PlotItem is built.
See demo script `tests/features/test_builder.py`.
The method :py:meth:`.PlotBuilder.image` now accepts
optional ``x`` and ``y`` keyword arguments, to automatically create a
:py:class:`plotpy.items.XYImageItem` instead of a simple
:py:class:`plotpy.items.ImageItem` if needed.
See demo script `tests/features/test_builder.py`.
The method :py:meth:`.PlotBuilder.curve` now accepts
optional ``dx``, ``dy``, ``errorbarwidth``, ``errorbarcap``, ``errorbarmode``,
`errorbaralpha` keyword arguments, to automatically create a
:py:class:`plotpy.items.ErrorBarCurveItem` instead of a simple
:py:class:`plotpy.items.CurveItem` if needed.
See demo script `tests/features/test_builder.py`.
Transformation (translation, rotate, resize) of ImageItem
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Most ImageItem can now be selected, translated, rotated and resized.
Auto-scaling and shapes
~~~~~~~~~~~~~~~~~~~~~~~
Auto-scaling takes now into account visible shapes
(subclasses of :py:class:`.PolygonShape`).
See demo script `tests/features/test_autoscale_shapes.py`.
|
