PyQt 使用QChartView绘制极坐标图（QPolarChart）详解

一、工程搭建

pyqt6QtCharts模块需要单独安装，只安装pyqt6是不包含图表功能的。

二、QPolarChart详解

QPolarChart是 PyQt6 中用于绘制极坐标图表的组件，继承自QChart。它支持在极坐标系中可视化数据，适用于展示周期性或方向性数据（如雷达图）。

1、核心特性

1. 坐标系
   • 角度轴（Angular Axis）：范围通常为[ 0 ∘ , 360 ∘ ) [0^\circ, 360^\circ)[0∘,360∘)
   • 径向轴（Radial Axis）：数值范围可自定义
2. 数据序列
   • 支持QLineSeries、QScatterSeries、QSplineSeries等
3. 交互功能
   • 缩放、平移、图例交互

2、属性与方法表格

3、关键功能说明

1. 设置坐标轴范围

   angular_axis=QValueAxis()angular_axis.setRange(0,360)# 角度范围radial_axis=QValueAxis()radial_axis.setRange(0,100)# 径向范围chart.setAngularAxis(angular_axis)chart.setRadialAxis(radial_axis)

2. 添加数据序列

   series=QLineSeries()series.append(30,50)# (角度, 径向值)series.append(90,70)chart.addSeries(series)

3. 主题与样式

   chart.setTheme(QChart.ChartThemeBlueIcy)chart.legend().setVisible(True)

4、完整示例代码

importsysfromPyQt6.QtWidgetsimportQApplication,QMainWindow,QVBoxLayout,QWidgetfromPyQt6.QtChartsimport(QChart,QChartView,QPolarChart,QLineSeries,QValueAxis,QCategoryAxis)fromPyQt6.QtGuiimportQPainter,QColor,QFont,QPenfromPyQt6.QtCoreimportQtfromPyQt6.QtWidgetsimportQApplication,QMainWindowfromPyQt6.QtChartsimportQChartView,QPolarChart,QValueAxis,QLineSeries app=QApplication([])window=QMainWindow()# 创建极坐标图表chart=QPolarChart()chart.setTitle("雷达图示例")# 设置坐标轴angular_axis=QValueAxis()angular_axis.setRange(0,360)radial_axis=QValueAxis()radial_axis.setRange(0,100)chart.addAxis(angular_axis,QPolarChart.PolarOrientation.PolarOrientationRadial)chart.addAxis(radial_axis,QPolarChart.PolarOrientation.PolarOrientationAngular)# 添加数据series=QLineSeries()series.append(0,30)series.append(90,80)series.append(180,60)series.append(270,40)series.append(360,30)chart.addSeries(series)series.attachAxis(angular_axis)series.attachAxis(radial_axis)# 显示图表chart_view=QChartView(chart)window.setCentralWidget(chart_view)window.resize(800,600)window.show()app.exec()

5、注意事项

1. 角度单位默认为度（非弧度）
2. 径向轴支持负值（如− 100 -100−100至100 100100）
3. 多序列时需确保坐标轴范围覆盖所有数据

三、代码示例

1、示例代码

importsysfromPyQt6.QtWidgetsimportQApplication,QMainWindow,QVBoxLayout,QWidgetfromPyQt6.QtChartsimport(QChart,QChartView,QPolarChart,QLineSeries,QValueAxis,QCategoryAxis)fromPyQt6.QtGuiimportQPainter,QColor,QFont,QPenfromPyQt6.QtCoreimportQtclassPolarChartWindow(QMainWindow):def__init__(self):super().__init__()self.setWindowTitle("PyQt6 极坐标图（雷达图）示例")self.resize(900,700)# 布局central_widget=QWidget()self.setCentralWidget(central_widget)layout=QVBoxLayout(central_widget)layout.setContentsMargins(20,20,20,20)# ========================# 极坐标图表（核心）# ========================chart=QPolarChart()chart.setTitle("多维度能力评估 - 极坐标雷达图")chart.setTitleFont(QFont("Microsoft YaHei",14,QFont.Weight.Bold))chart.setAnimationOptions(QChart.AnimationOption.SeriesAnimations)chart.legend().setVisible(True)chart.legend().setAlignment(Qt.AlignmentFlag.AlignBottom)# ========================# 数据系列 A# ========================series1=QLineSeries()series1.setName("产品A")data1=[(0,8),(45,9),(90,7),(135,6),(180,8),(225,9),(270,7),(315,6),(360,8)]forpindata1:series1.append(p[0],p[1])pen1=QPen(QColor("#2E86AB"))pen1.setWidth(3)series1.setPen(pen1)series1.setBrush(QColor(46,134,171,70))# ========================# 数据系列 B# ========================series2=QLineSeries()series2.setName("产品B")data2=[(0,6),(45,7),(90,9),(135,8),(180,5),(225,6),(270,8),(315,9),(360,6)]forpindata2:series2.append(p[0],p[1])pen2=QPen(QColor("#F24236"))pen2.setWidth(3)series2.setPen(pen2)series2.setBrush(QColor(242,66,54,70))chart.addSeries(series1)chart.addSeries(series2)# ========================# 坐标轴（PyQt6 正确用法！）# ========================# 径向轴（半径）axis_r=QValueAxis()axis_r.setRange(0,10)axis_r.setTickCount(6)axis_r.setLabelFormat("%.0f")# 角度轴（环形方向）axis_a=QCategoryAxis()labels=["能力","速度","稳定性","续航","散热","颜值","手感","音质"]fori,nameinenumerate(labels):axis_a.append(name,i*45)axis_a.setRange(0,360)# ✅ PyQt6 正确绑定极坐标轴（无任何枚举错误）chart.addAxis(axis_r,QPolarChart.PolarOrientation.PolarOrientationRadial)chart.addAxis(axis_a,QPolarChart.PolarOrientation.PolarOrientationAngular)series1.attachAxis(axis_r)series1.attachAxis(axis_a)series2.attachAxis(axis_r)series2.attachAxis(axis_a)# ========================# 图表视图# ========================chart_view=QChartView(chart)chart_view.setRenderHint(QPainter.RenderHint.Antialiasing)layout.addWidget(chart_view)if__name__=="__main__":app=QApplication(sys.argv)window=PolarChartWindow()window.show()sys.exit(app.exec())

2、效果展示