【组件介绍】FITKPlotWindow

一、组件简介

二维图表组件FITKPlotWindow基于Qwt开发，是用于直观二维数据的组件。目前的二维图表组件支持四种类型的图表，分别为标准直角坐标图、柱状图、频谱图和极坐标图。该组件的数据渲染效果示例如下：

二、主要接口

组件中针对不同的数据渲染方式各有差异，但遵循相同的类组织结构，对于每种图表的生成，均通过下面四个类实现核心的业务功能：

图表窗口类: 主要用于创建窗口，其包含一个图表属性类指针和一个数据管理类指针，分别用于设定窗口属性和管理数据。

图表属性类: 主要用于指定图表的固有属性( 例如轴标题等)，并包含与界面表现形式相关的所有接口。

数据属性类：主要用于创建图表数据并设计数据样式（例如曲线颜色、线型，柱状图颜色等）。

数据管理类: 主要用于添加数据或删除数据。

具体相关类如下：

类名
FITKXYPlotWindow	标准直角坐标图的图表窗口类
FITKXYPlotProperty	标准直角坐标图的图表属性类
FITKXYCurveDrawProp	标准直角坐标图的数据属性类
FITKXYCurveDrawManager	标准直角坐标图的数据管理类
FITKBarChartWindow	柱状图的图表窗口类
FITKBarChartProperty	柱状图的图表属性类
FITKBarChartDrawProp	柱状图的数据属性类
FITKBarChartDrawManager	柱状图的数据管理类
FITKSpectrogramWindow	频谱图的图表窗口类
FITKSpectrogramProperty	频谱图的图表属性类
FITKSpectrogramDrawPro	频谱图的数据属性类
FITKSpectrogramManager	频谱图的数据管理类
FITKPolarPlotWindow	极坐标图的图表窗口类
FITKPolarPlotProperty	极坐标图的图表属性类
FITKPolarCurveDrawProp	极坐标图的数据属性类
FITKPolarCurveDrawManager	极坐标图的数据管理类

三、使用过程（以直角坐标图为例）

创建图表一般包含以下四步：

创建图表窗口
设置图表属性
构造图表专有数据对象，并设置数据到专有数据对象
将专有数据对象添加到图表

0.组件加载

我们将通过图表窗口接口类FITKPlotWindowsInterface来创建图表窗口，在使用图表窗口接口类之前，需要提前将图表窗口接口类添加到组件工厂，添加代码如下：

1.  QList<AppFrame::FITKComponentInterface *> 
2.                               ComponentFactory::createComponents()
3.  {
4.     // 自定义组件列表
5.		QList<AppFrame::FITKComponentInterface *> componentList;
6.		//****创建的其他组件********
7.		// …………
8.		//二维图表窗口接口
9.		componentList << new Plot:: FITKPlotWindowsInterface;
10.
11. 	return componentList;
12. }

1.创建直角坐标窗口

1.  //获取二维图表窗口接口
2.  Plot::FITKPlotWindowsInterface* PlotWindows = FITKAPP->getComponents()->getComponentTByName<Plot::FITKPlotWindowsInterface>("FITKPlotWindowsInterface");
3.  //创建图表窗口（直角坐标图的类型为0）
4.  Plot::FITKXYPlotWindow *plotWidget = 
dynamic_cast<Plot::FITKXYPlotWindow*>(PlotWindows->getWidget(0));//add plotWidget to a window

创建窗口后还要将plotWidget添加到自己需要的窗口位置

2.设置窗口属性

1.//设置窗口标题
2.plotWidget->getPlotProperty()->setTitle("Title ");
3.//设置XY轴名称
4.plotWidget->getPlotProperty()->setAxisName("Redu","Time");
5.//将图例挪动到窗口右侧
6.plotWidget->getPlotProperty()->setLegendPlace(1);

还有其它设置窗口的成员方法，具体方法可以到每种图表的窗口属性类中查看。

3.添加绘图数据

添加数据时，首先要先创建一个对应图表类型的数据属性类对象，直角坐标图的数据属性类为FITKXYCurveDrawProp，这里我们使用该类来创建曲线数据对象CurveData，然后给CurveData设置数据及样式，代码如下：

1.//创建数据属性对象
2.Plot::FITKXYCurveDrawProp* CurveData = new Plot::FITKXYCurveDrawProp();
3.//设置曲线颜色
4.CurveData->setColor(QColor(255,0,0));
5.//设置x轴坐标和y轴坐标
6.QVector<double> xData {10,20,30,40,50,60};
7.QVector<double> yData {10,20,35,40,45,60};
8.//添加 曲线名称“sd”，xData:x轴坐标,yData:y轴坐标，xy轴坐标个数要一致
9.//如果添加失败， setData()会返回false
10.CurveData->setData("sd", xData, yData);

最后别忘了更新窗口画面，代码如下

1.//获取曲线管理器并添加曲线到图表窗口
2.plotWidget->getCurveManager()->appendGraphObj(CurveData);
3.//更新画布
4.plotWidget->updataCanvas();

此时窗口如下：

四、应用效果

该组件主要用于后处理，二维数据可视化，以及求解过程的残差监控。组件应用效果如下：