PyQtGraph - 图像视图的自动范围

PyQtGraph是一个开源的Python图形库，用于在科学和工程中可视化数据。它提供了一系列可定制的图表，包括2D和3D的线图、散点图、图像图、曲面图等。

在PyQtGraph中，图像视图是其中一个重要的组件，它能够显示2D或3D的图像，并提供了一些常见的交互功能，比如缩放、旋转、平移等等。同时，图像视图也支持自动范围的设置，本文将着重介绍这一功能。

设置自动范围

在PyQtGraph中，我们可以使用autoRange()方法来设置视图的自动范围。该方法的定义如下：

def autoRange(self, items=None, padding=None, itemsList=None)

• items（可选参数）：指定哪些图像组件的范围需要自动调整，如设置为None，则默认为视图中所有的组件。该参数可以是一个图像组件，也可以是一个包含多个图像组件的列表或元组。
• padding（可选参数）：用于确定自动调整后的范围大小，如果设置为None，则使用默认值。默认情况下，padding的值为0.05。
• itemsList（可选参数）：用于指定特定图像类型的范围是否需要自动调整。如果不指定，则默认为所有类型的图像组件。

我们来举个例子，假设我们有一个图像视图，其中包含了三个平面图像（x-y、x-z、y-z）。那么我们可以通过下面的代码来设置它们的自动范围：

import pyqtgraph as pg

# 创建图像视图
view = pg.GraphicsView()
layout=pg.GraphicsLayout()
view.setCentralItem(layout)

# 创建平面图像
img_xy = pg.ImageItem(np.random.rand(10, 10))
img_xz = pg.ImageItem(np.random.rand(10, 20))
img_yz = pg.ImageItem(np.random.rand(20, 10))

# 将图像添加到视图中
view.addItem(img_xy)
view.addItem(img_xz)
view.addItem(img_yz)

# 设置自动范围
view.autoRange()

在上面的代码中，我们使用autoRange()方法来自动调整视图中所有的图像组件。

如果我们想要只自动调整某些图像组件的范围，可以将这些图像组件作为items参数传递给autoRange()方法：

view.autoRange(items=[img_xy, img_xz])

通过这种方式，autoRange()方法将只自动调整xy平面图像和xz平面图像的范围，而不会调整yz平面图像的范围。

总结

通过上面的介绍，我们了解了如何在PyQtGraph中设置图像视图的自动范围。autoRange()方法可以帮助我们自动调整图像组件的范围大小，从而更好地展示数据特征。同时，通过控制items参数，我们可以很灵活地指定需要自动调整的图像组件，从而满足我们不同的需求。