目录
全局设置 setConfigOptions()
PyQtGraph的辅助函数
数据显示函数 Simple Data Display Functions
颜色、画笔和笔刷 Color,Pen,and Brush Functions
Data Slicing 暂用不上
Coordinate Transformation 暂用不上
SI Unit Conversion Functions 暂用不上
Image Preparation Function 暂用不上
Mesh Generation Functions 暂用不上
Miscellaneous Functions 暂用不上
Legacy Color Helper Functions 暂用不上
pyqtgraph的图形控件 PyQtGraph's Graphic Items
PlotDataItem
PlotItem
ImageItem
ViewBox
GraphicsLayout
GrahpicsWidget
GraphicsItem
GraphicsScene
全局设置 setConfigOptions()
Global Configuration Options — pyqtgraph 0.13.3 documentation
项 | 数据类型 | 默认值 | 取值说明 |
leftButtonPan | bool | True | If True, dragging the left mouse button over a ViewBox causes the view to be panned. If False, then dragging the left mouse button draws a rectangle that the ViewBox will zoom to. 【True:鼠标左键拖拽图形,整个图形拽着一起移动;False:鼠标左键绘制一个矩形区域,ViewBox将放大这个矩形区域的内容】 |
foreground | See mkColor() | 'd' | Default foreground color for text, lines, axes, etc. 【文本、线条、坐标轴等前景色】 |
background | See mkColor() | 'k' | Default background for GraphicsView. 【GraphicView的背景色】 |
antialias | bool | False | Enabling antialiasing causes lines to be drawn with smooth edges at the cost of reduced performance. 【启用抗锯齿使线条平滑,但会降低性能,默认不启用】 |
imageAxisOrder | str | 'col-major' | For ‘row-major’, image data is expected in the standard row-major (row, col) order. For ‘col-major’, image data is expected in reversed column-major (col, row) order. The default is ‘col-major’ for backward compatibility, but this may change in the future. 【图形排列顺序规则,row-major 以行为主,也就是先把行填充完再整下一行;col-major以列为主,一列填充万再下一列。注:个人理解,没用过,取默认值】 |
editorCommand | str or None | None | Command used to invoke code editor from ConsoleWidget. 【用于从ConsoleWidget调用代码编辑器的命令。注:个人理解,没用过,取默认值】 |
exitCleanup | bool | True | Attempt to work around some exit crash bugs in PyQt and PySide. 【PyQt或PySide出现bug崩溃时,尝试解决】 |
useOpenGL | bool | False | Enable OpenGL in GraphicsView. 【是否在GraphicsView中调用OpenGL,默认不调用】 |
useCupy | bool | False | Use cupy to perform calculations on the GPU. Only currently applies to ImageItem and its associated functions. 【使用cupy在GPU上执行计算。当前仅适用于ImageItem及其关联函数】 |
useNumba | bool | False | Use numba acceleration where implemented. 【在实施时使用numba加速。】 |
enableExperimental | bool | False | Enable experimental features (the curious can search for this key in the code). In combination with useOpenGL, this makes PlotCurveItem use PyOpenGL for curve drawing. 【启用实验功能(好奇的人可以在代码中搜索这个键)。结合使用OpenGL,这使得PlotCurveItem使用PyOpenGL绘制曲线。】 |
crashWarning | bool | False | If True, print warnings about situations that may result in a crash. |
segmentedLineMode | str | 'auto' | For ‘on’, lines are always plotted in segments. For ‘off’, lines are never plotted in segments. For ‘auto’, whether lines are plotted in segments is automatically decided based on pen poperties and whether anti-aliasing is enabled. 【开启的话,线条总是以线段的形式绘制。关闭的话,就总是绘制直线,不会绘制线段。‘auto’,根据笔的弹出度以及是否启用了抗锯齿来自动决定是否以线段的形式绘制线】 |
PyQtGraph的辅助函数
PyQtGraph’s Helper Functions — pyqtgraph 0.13.3 documentation
数据显示函数 Simple Data Display Functions
pyqtgraph.plot(*args,**kargs)
创建并返回 PlotWidget 接收 title 参数作为窗体标题,其他参数参看 PlotItem.plot()
pyqtgraph.image(*args,**kargs)
创建并返回 ImageView ,该控件用于显示2D或3D的图片数据。接收 title 参数作为窗体标题,其他参数参看 ImageView.setImage()
pyqtgraph.dbg(*args,**kargs)
创建一个控制台窗口并开始监视异常。
颜色、画笔和笔刷 Color,Pen,and Brush Functions
Qt设计了QColor QPen QBrush用来绘制和填充颜色,有时候用起来不是很方便。PyQtGraph提供mkColor(),mkPen(),mkBrush()来实现这些功能,很多时候颜色、画笔、笔刷已经作为参数内嵌在控件中,使用过程中只要设置参数就可以。
例如:
pg.plot(xdata,ydata,pen='r')
pg.plot(xdata,ydata,pen=pg.mkPen('r'))
pg.plot(xdata,ydata,pen=QPen(QColor(255,0,0)))
pyqtgraph.mkColor(*args)
参数类型
‘c’ | r,g,b,c,m,y,k,w |
R,G,B,[A] | 0-255的整数 |
(R,G,B,[A]) | 0-255的整数 |
float | 灰度,0.0-1.0 |
int | see intColor() |
(int,hues) | see intColor() |
"#RGB" | |
'#RGBA" | |
"#RRGGBB" | |
"#RRGGBBAA" | |
QColor | QColor实例 |
pyqtgraph.mkPen(*args,**kargs)
例如
mkPen(color)
mkPen(color,width=2)
mkPen(cosmetic=False,width=4.5,color='r')
mkPen({'color':'#FF0',width:2})
mkPen(None) # (no pen)
pyqtgraph.mkBrush(*args,**kwds)
默认构建的都是实体填充的笔刷,接受mkColor()的颜色参数。
mkBrush(None)返回一个不可见的笔刷
pyqtgraph.hsvColor(hue,sat=1.0,val=1.0,alpha=1.0)
HSVa的值设置的颜色(参数都是0.0-1.0)
pyqtgraph.intColor(index,hues=9,values=1,maxValue=255,minValue=150,maxHue=360,minHue=0,sat=255,alpha=255)
通过一个简单的索引值创建颜色。程序内部预设了一个颜色列表。
。。。【平时用不上的就不写了,想看的小伙伴自行前往官网】
Data Slicing 暂用不上
用不上,以后有用上再行补充
Coordinate Transformation 暂用不上
用不上,以后有用上再行补充
SI Unit Conversion Functions 暂用不上
Image Preparation Function 暂用不上
Mesh Generation Functions 暂用不上
Miscellaneous Functions 暂用不上
Legacy Color Helper Functions 暂用不上
pyqtgraph的图形控件 PyQtGraph's Graphic Items
Since pyqtgraph relies on Qt’s GraphicsView framework, most of its graphics functionality is implemented as QGraphicsItem subclasses. This has two important consequences: 1) virtually anything you want to draw can be easily accomplished using the functionality provided by Qt. 2) Many of pyqtgraph’s GraphicsItem classes can be used in any normal QGraphicsScene.
【由于pyqtgraph依赖Qt的GraphicsView框架,因此它的大部分图形功能都是作为QGraphicsItem子类实现的。基于以上有以下两点好处:
1)使用Qt提供的功能,几乎可以轻松地完成想要绘制的内容。
2)pyqtgraph的许多GraphicsItem类可以在任何普通的QGraphicsScene中使用】
PlotDataItem
PlotDataItem — pyqtgraph 0.13.3 documentation
class pyqtgrap.PlotDataItem(*args,**kargs)
基类:GraphicsObject
PlotDataItem provides a unified interface for displaying plot curves, scatter plots, or both. It also contains methods to transform or decimate the original data before it is displayed
【PlotDataItem提供了用于显示绘制曲线、散点图或者两者的统一界面。它还包含在显示原始数据之前对其进行转换或抽取的方法。】
pyqtgraph.plot()和PlotItem.plot()创建的都是PlotDataItem的实例。
如果很明确就是要创建折线或散点图,可以使用PlotCurveItem或ScatterPlotItem
信号:
sigPlotChanged(self) | 控件中数据更新触发该信号 |
sigClicked(self,ev) | 点击控件,触发 |
sigPointsClicked(self,points,ev) | 图形中的点被点击,将返回当前鼠标所在位置的点列表 |
sigPointsHovered(self,points,ev) | 鼠标悬浮在某一个点上,将返回当前鼠标所在位置的点列表 |
创建方法:
PlotDataItem(x,y) | x,y:array_like coordination values 列表 |
PlotDataItem(y) | 只有y轴数据,x会自动生成序列 |
PlotDataItem(x=x,y=y) | |
PlotDataItem(ndarray(N,2)) | |
PlotDataItem(recarray) | numpy record array with dtype=[('x',float),('y',float),...] |
PlotDataItem(list-of-dicts) | [{'x':x,'y':..},...] |
PlotDataItem(dict-of-lists) | {'x':[....],'y':[...],...} |
线条样式设置:
connect 值说明
‘all’:连接所有的点
'pairs':只与相邻的点相连
'finite': 如果数据列表中有为空的数据,线条在对应位置断开不画线
PlotItem
PlotItem — pyqtgraph 0.13.3 documentation
class pyqtgraph.PlotItem
基类:GraphicsWidget
这个类相当于是 ViewBox + axes。
主要功能:
1 管理ViewBox、AxisItems 和 LabelItems的位置
2 创建和管理一系列的PlotDataItems在ViewBox里显示
3 使用常用的显示和分析选项实现上下文菜单
ImageItem
ImageItem — pyqtgraph 0.13.3 documentation
ViewBox
ViewBox — pyqtgraph 0.13.3 documentation
基类:GraphicsWidget
GraphicsLayout
GraphicsLayout — pyqtgraph 0.13.3 documentation
GrahpicsWidget
GraphicsWidget — pyqtgraph 0.13.3 documentation
基类:GraphicsItem
GraphicsItem
GraphicsItem — pyqtgraph 0.13.3 documentation
基类:object
GraphicsScene
GraphicsScene — pyqtgraph 0.13.3 documentation