HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r2556:89b8a97da4fc

Example finalization and documentation...

Mika Salmela -

r2556:89b8a97da4fc

parent child

Context file:

r2556:89b8a97da4fc

Collapse all files

examples/boxplotchart/boxwhisk_data.txt created 644 +13 0

@@ -0,0 +1,13
	1	# BoxWhisk Inc share deviation in 2012
	2	Jan 25.74 25.28 25.86 26.05 26.64 28.47 28.30 29.22 29.72 27.50 25.62 25.50 25.15 26.47 27.41 25.78 24.82 24.89 24.88 24.60 23.85
	3	Feb 30.79 29.62 29.67 30.37 30.16 30.22 31.02 33.70 32.60 32.24 31.98 31.79 31.10 30.79 31.53 30.92 29.00 29.58 30.37 29.40 28.60
	4	Mar 29.64 29.34 30.13 30.43 31.75 30.77 30.72 31.52 32.12 33.75 33.51 33.69 32.83 32.47 32.41 32.39 32.78 31.08 29.46 31.58 31.39 31.41
	5	Apr 24.96 25.62 25.19 28.37 28.78 26.50 25.90 26.40 26.86 26.90 27.91 27.32 27.99 26.86 26.68 27.57 27.50 26.96 26.50
	6	May 21.85 21.08 22.98 22.61 22.45 21.73 21.71 23.27 22.14 19.65 22.95 21.23 23.17 24.26 24.17 21.97 22.53 25.49 25.51 26.46 26.65
	7	Jun 15.08 15.19 15.36 15.21 15.31 18.19 18.30 15.53 15.35 15.80 15.17 16.95 18.25 20.52 20.61 20.40 20.45 19.43 19.11 19.74
	8	Jul 17.75 18.24 17.57 16.53 15.98 16.06 16.64 17.69 17.91 19.00 19.03 19.14 19.10 17.86 19.12 19.53 19.43 19.30 19.03 19.76 18.79 18.33
	9	Aug 19.69 19.54 19.39 19.49 19.96 19.72 20.25 20.70 21.13 20.74 20.27 19.25 18.72 19.02 19.20 19.24 19.60 19.22 19.60 18.98 18.27 17.70 18.19
	10	Sep 19.35 19.82 19.96 20.96 20.75 21.55 21.68 22.19 22.14 22.48 22.45 21.74 21.97 21.18 20.66 20.54 19.89 19.39 19.26 19.86
	11	Oct 17.95 17.80 17.45 17.89 18.38 18.12 17.85 18.59 18.65 18.46 18.43 18.30 18.87 19.61 19.55 19.59 20.27 20.54 21.02 20.23 19.05 19.52 19.71
	12	Now 20.36 20.29 19.22 19.74 20.05 20.13 19.67 19.19 18.94 19.04 18.49 18.53 18.64 19.00 19.21 19.19 19.30 19.11 19.17 18.76 18.80 18.52
	13	Dec 22.95 22.19 22.15 21.42 21.39 21.65 22.39 20.86 20.48 20.70 20.94 20.82 19.25 21.21 19.63 20.55

doc/images/examples_boxplotchart.png binary modified 0 0

NO CONTENT: modified file, binary diff hidden

doc/src/examples-boxplotchart.qdoc +54 -16

@@ -1,38 +1,76
1	/*!	1	/*!
2	\example examples/boxplotchart	2	\example examples/boxplotchart
3	\title Box and Whiskers Example	3	\title Box and Whiskers Example
4	\subtitle	4	\subtitle
5		5
6	The example shows how to create a box-and-whiskers chart.	6	The example shows how to create a box-and-whiskers chart. It also shows how to read the non-continuous data from the file,
		7	arrange it and find medians needed for box-and-whiskers plotting.
7		8
8	\image examples_barchart.png	9	\image examples_boxplotchart.png
9		10
10	Introduction here	11	To show the share deviation of two companies we start by creating two QBoxPlotSeries to handle monthly data.
11		12
12	\snippet ../examples/barchart/main.cpp 1	13	\snippet ../examples/boxplotchart/main.cpp 1
13		14
14	Ykk�skohta	15	QFile class is used to open a text file where the non-continuous data is kept. The BoxDataReader is an auxiliary class for
		16	reading the text file and finding the extreme and median values from the data. The BoxDataReader is explained in more detail later.
		17	The method readBox reads the values and sets them to the QBoxSet item which the method returns for the caller. The returned QBoxSet
		18	item is added to the series.
15		19
16	\snippet ../examples/barchart/main.cpp 2	20	\snippet ../examples/boxplotchart/main.cpp 2
17		21
18	Kakkoskohta	22	In this section a second file is opened for reading the data for the second company.
19		23
20	\snippet ../examples/barchart/main.cpp 3	24	\snippet ../examples/boxplotchart/main.cpp 3
21		25
22	Kolmoskohta	26	In this code snippet a new QChart instance is created and previously created series are added to it. Also title is defined and
		27	animation is set to be SeriesAnimation.
23		28
24	\snippet ../examples/barchart/main.cpp 4	29	\snippet ../examples/boxplotchart/main.cpp 4
25		30
26	Neloskohta	31	Here we ask chart to create default axes for our presentation. We also set range for vertical axis by querying the pointer
		32	for the axis from the chart and then setting the min and max for that axis.
27		33
28	\snippet ../examples/barchart/main.cpp 5	34	\snippet ../examples/boxplotchart/main.cpp 5
29		35
30	Tarkista numerointi. Finally we add the chart onto a view. We also turn on the antialiasing for the chartView.	36	In this section we set legends visible and place them at the bottom of the chart.
31		37
32	\snippet ../examples/barchart/main.cpp 6	38	\snippet ../examples/boxplotchart/main.cpp 6
33		39
34	Tarkista numerointi. Chart is ready to be shown. We set the chart to be central widget of the window.	40	Finally we add the chart onto a view. We also turn on the antialiasing for the chartView.
		41
		42	\snippet ../examples/boxplotchart/main.cpp 7
		43
		44	The chart is ready to be shown. We set the chart to be central widget of the window.
35	We also set the size for the chart window and show it.	45	We also set the size for the chart window and show it.
36		46
37	\snippet ../examples/barchart/main.cpp 7	47	\snippet ../examples/boxplotchart/main.cpp 8
		48
		49	Here the method readBox is explained in detail. Firstly a line is read from the file and lines starting with # are rejected
		50	since they are considered as comment lines.
		51
		52	\snippet ../examples/boxplotchart/boxdatareader.cpp 1
		53
		54	On the file the data is arranged as number, space, number, space and so on. On this snippet the line is split into single number strings which
		55	are stored on QStringList.
		56
		57	\snippet ../examples/boxplotchart/boxdatareader.cpp 2
		58
		59	The sortedList will hold the numbers in continuous order and in this code segment we show how to do it. First the sortedList is cleared and numbers
		60	are read from the strList and stored into sortedList in double format. The qSort method arranges the sortedList into continuous order
		61	starting from the smallest.
		62
		63	\snippet ../examples/boxplotchart/boxdatareader.cpp 3
		64
		65	Here is a code sample how to select extremes and medians from the continuous data. Firstly a new QBoxSet is created.
		66	Lower and upper extremes are simple to select; they are just first and last items on the sortedList. For medians we use a helper
		67	method findMedian which is explained later. For the median from the upper half we need to adjust the begin number if
		68	amount of the numbers is even or uneven. The end number for lower half comes naturally from int rounding.
		69
		70	\snippet ../examples/boxplotchart/boxdatareader.cpp 4
		71
		72	Here's the code sample for the method findMedian. If the amount of numbers is uneven we select the number from
		73	the middle. For even amount numbers we take two numbers from the middle and calculate the mean value.
		74
		75	\snippet ../examples/boxplotchart/boxdatareader.cpp 5
38	*/	76	*/

doc/src/examples.qdoc +32 -25

             /*!
                 \page examples.html
                 \title QtCommercial Charts Examples
                 \keyword Examples
                 \raw HTML
                 <div class="qchart">
                 <table>
                     <tr>
                         <td><a href="examples-areachart.html">Area Chart</a></td>
                         <td><a href="examples-barchart.html">Bar Chart</a></td>
                     </tr>
                     <tr>
                         <td><a href="examples-areachart.html"><img src="images/examples_areachart.png" width="300" alt="Area Chart" /></a></td>
                         <td><a href="examples-barchart.html"><img src="images/examples_barchart.png" width="300" alt="Bar Chart" /></a></td>
                     </tr>
                     <tr>
                         <td><a href="examples-barmodelmapper.html">Bar Chart from Model</a></td>
-                        <td><a href="examples-customchart.html">Custom Chart</a></td>
+                        <td><a href="examples-boxplotchart.html">Box-and-whiskers Chart</a></td>
                     </tr>
                     <tr>
                         <td><a href="examples-barmodelmapper.html"><img src="images/examples_barmodelmapper.png" width="300" alt="Bar Chart from Model" /></a></td>
-                        <td><a href="examples-customchart.html"><img src="images/examples_customchart.png" width="300" alt="Custom Chart" /></a></td>
+                        <td><a href="examples-boxplotchart.html"><img src="images/examples_boxplotchart.png" width="300" alt="Bar Chart from Model" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-customchart.html">Custom Chart</a></td>
                         <td><a href="examples-datetimeaxis.html">DateTimeAxis Example</a></td>
-                        <td><a href="examples-donutbreakdown.html">Donut Breakdown Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-customchart.html"><img src="images/examples_customchart.png" width="300" alt="Custom Chart" /></a></td>
                         <td><a href="examples-datetimeaxis.html"><img src="images/examples_datetimeaxis.png" width="300" alt="DateTimeAxis Example" /></a></td>
-                        <td><a href="examples-donutbreakdown.html"><img src="images/examples_donutbreakdown.png" width="300" alt="Donut Breakdown Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-donutbreakdown.html">Donut Breakdown Chart</a></td>
                         <td><a href="examples-donutchart.html">Donut Chart</a></td>
-                        <td><a href="examples-horizontalbarchart.html">Horizontal Bar Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-donutbreakdown.html"><img src="images/examples_donutbreakdown.png" width="300" alt="Donut Breakdown Chart" /></a></td>
                         <td><a href="examples-donutchart.html"><img src="images/examples_donutchart.png" width="300" alt="Donut Chart" /></a></td>
-                        <td><a href="examples-horizontalbarchart.html"><img src="images/examples_horizontalbarchart.png" width="300" alt="Horizontal Bar Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-horizontalbarchart.html">Horizontal Bar Chart</a></td>
                         <td><a href="examples-horizontalpercentbarchart.html">Horizontal Percent Bar Chart</a></td>
-                        <td><a href="examples-horizontalstackedbarchart.html">Horizontal Stacked Bar Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-horizontalbarchart.html"><img src="images/examples_horizontalbarchart.png" width="300" alt="Horizontal Bar Chart" /></a></td>
                         <td><a href="examples-horizontalpercentbarchart.html"><img src="images/examples_horizontalpercentbarchart.png" width="300" alt="Horizontal Percent Bar Chart" /></a></td>
-                        <td><a href="examples-horizontalstackedbarchart.html"><img src="images/examples_horizontalstackedbarchart.png" width="300" alt="Horizontal Stacked Bar Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-horizontalstackedbarchart.html">Horizontal Stacked Bar Chart</a></td>
                         <td><a href="examples-legend.html">Legend</a></td>
-                        <td><a href="examples-legendmarkers.html">Legend Markers</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-horizontalstackedbarchart.html"><img src="images/examples_horizontalstackedbarchart.png" width="300" alt="Horizontal Stacked Bar Chart" /></a></td>
                         <td><a href="examples-legend.html"><img src="images/examples_legend_detach.png" width="300" alt="Legend" /></a></td>
-                        <td><a href="examples-legendmarkers.html"><img src="images/examples_legendmarkers.png" width="300" alt="Legend Markers" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-legendmarkers.html">Legend Markers</a></td>
                         <td><a href="examples-lineandbar.html">Line and Barchart</a></td>
-                        <td><a href="examples-linechart.html">Line Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-legendmarkers.html"><img src="images/examples_legendmarkers.png" width="300" alt="Legend Markers" /></a></td>
                         <td><a href="examples-lineandbar.html"><img src="images/examples_lineandbar.png" width="300" alt="Line and Barchart" /></a></td>
-                        <td><a href="examples-linechart.html"><img src="images/examples_linechart.png" width="300" alt="Line Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-linechart.html">Line Chart</a></td>
                         <td><a href="examples-logvalueaxis.html">Logarithmic axis</a></td>
-                        <td><a href="examples-modeldata.html">Model Data</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-linechart.html"><img src="images/examples_linechart.png" width="300" alt="Line Chart" /></a></td>
                         <td><a href="examples-logvalueaxis.html"><img src="images/examples_logvalueaxis.png" width="300" alt="Logarythmix axis" /></a></td>
-                        <td><a href="examples-modeldata.html"><img src="images/examples_modeldata.png" width="300" alt="Model Data" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-modeldata.html">Model Data</a></td>
                         <td><a href="examples-multiaxis.html">Multiple axes</a></td>
-                        <td><a href="examples-percentbarchart.html">Percent Bar Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-modeldata.html"><img src="images/examples_modeldata.png" width="300" alt="Model Data" /></a></td>
                         <td><a href="examples-multiaxis.html"><img src="images/examples_multiaxis.png" width="300" alt="Multiple axes" /></a></td>
-                        <td><a href="examples-percentbarchart.html"><img src="images/examples_percentbarchart.png" width="300" alt="Percent Bar Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-percentbarchart.html">Percent Bar Chart</a></td>
                         <td><a href="examples-piechart.html">Pie Chart</a></td>
-                        <td><a href="examples-piechartdrilldown.html">Pie Chart Drilldown</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-percentbarchart.html"><img src="images/examples_percentbarchart.png" width="300" alt="Percent Bar Chart" /></a></td>
                         <td><a href="examples-piechart.html"><img src="images/examples_piechart.png" width="300" alt="Pie Chart" /></a></td>
-                        <td><a href="examples-piechartdrilldown.html"><img src="images/examples_piechartdrill2.png" width="300" alt="Pie Chart Drilldown" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-piechartdrilldown.html">Pie Chart Drilldown</a></td>
                         <td><a href="examples-polarchart.html">Polar chart</a></td>
-                        <td><a href="examples-scatterchart.html">Scatter chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-piechartdrilldown.html"><img src="images/examples_piechartdrill2.png" width="300" alt="Pie Chart Drilldown" /></a></td>
                         <td><a href="examples-polarchart.html"><img src="images/examples_polarchart.png" width="300" alt="Polar chart" /></a></td>
-                        <td><a href="examples-scatterchart.html"><img src="images/examples_scatterchart.png" width="300" alt="Scatter chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-scatterchart.html">Scatter chart</a></td>
                         <td><a href="examples-scatterinteractions.html">Scatter Interactions</a></td>
-                        <td><a href="examples-splinechart.html">Spline Chart</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-scatterchart.html"><img src="images/examples_scatterchart.png" width="300" alt="Scatter chart" /></a></td>
                         <td><a href="examples-scatterinteractions.html"><img src="images/examples_scatterinteractions.png" width="300" alt="Scatter Interactions" /></a></td>
-                        <td><a href="examples-splinechart.html"><img src="images/examples_splinechart.png" width="300" alt="Spline Chart" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-splinechart.html">Spline Chart</a></td>
                         <td><a href="examples-stackedbarchart.html">Stacked Bar Chart</a></td>
-                        <td><a href="examples-stackedbarchartdrilldown.html">Stacked Bar Chart Drilldown</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-splinechart.html"><img src="images/examples_splinechart.png" width="300" alt="Spline Chart" /></a></td>
                         <td><a href="examples-stackedbarchart.html"><img src="images/examples_stackedbarchart.png" width="300" alt="Stacked Bar Chart" /></a></td>
-                        <td><a href="examples-stackedbarchartdrilldown.html"><img src="images/examples_stackedbarchartdrilldown1.png" width="300" alt="Stacked Bar Chart Drilldown" /></a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-stackedbarchartdrilldown.html">Stacked Bar Chart Drilldown</a></td>
                         <td><a href="examples-temperaturerecords.html">Temperature Records</a></td>
-                        <td><a href="examples-zoomlinechart.html">Zoom Line</a></td>
                     </tr>
                     <tr>
+                        <td><a href="examples-stackedbarchartdrilldown.html"><img src="images/examples_stackedbarchartdrilldown1.png" width="300" alt="Stacked Bar Chart Drilldown" /></a></td>
                         <td><a href="examples-temperaturerecords.html"><img src="images/examples_temperaturerecords.png" width="300" alt="Temperature Records" /></a></td>
+                    </tr>
+                    <tr>
+                        <td><a href="examples-zoomlinechart.html">Zoom Line</a></td>
+                    </tr>
+                    <tr>
                         <td><a href="examples-zoomlinechart.html"><img src="images/examples_zoomlinechart1.png" width="300" alt="Zoom Line" /></a></td>
                     </tr>
                 </table>
                 </div>
                 \endraw
             */

examples/boxplotchart/acme_data.txt ~~examples/boxplotchart/stock_data.txt~~ renamed 0 0

	1	NO CONTENT: file renamed from examples/boxplotchart/stock_data.txt to examples/boxplotchart/acme_data.txt			NO CONTENT: file renamed from examples/boxplotchart/stock_data.txt to examples/boxplotchart/acme_data.txt

NO CONTENT: file renamed from examples/boxplotchart/stock_data.txt to examples/boxplotchart/acme_data.txt

examples/boxplotchart/boxdatareader.cpp +18 -6

             /****************************************************************************
             **
             ** Copyright (C) 2013 Digia Plc
             ** All rights reserved.
             ** For any questions to Digia, please use contact form at http://qt.digia.com
             **
             ** This file is part of the Qt Commercial Charts Add-on.
             **
             ** $QT_BEGIN_LICENSE$
             ** Licensees holding valid Qt Commercial licenses may use this file in
             ** accordance with the Qt Commercial License Agreement provided with the
             ** Software or, alternatively, in accordance with the terms contained in
             ** a written agreement between you and Digia.
             **
             ** If you have questions regarding the use of this file, please use
             ** contact form at http://qt.digia.com
             ** $QT_END_LICENSE$
             **
             ****************************************************************************/
             #include "boxdatareader.h"
             BoxDataReader::BoxDataReader(QIODevice *device) :
                 QTextStream(device)
             {
             }
+            void BoxDataReader::readFile(QIODevice *device)
+            {
+                QTextStream::setDevice(device);
+            }
             QBoxSet *BoxDataReader::readBox()
             {
+                //! [1]
                 QString line = readLine();
                 if (line.startsWith("#"))
                     return 0;
+                //! [1]
+                //! [2]
                 QStringList strList = line.split(" ", QString::SkipEmptyParts);
-                sortedList.clear();
+                //! [2]
+                //! [3]
+                sortedList.clear();
                 for (int i = 1; i < strList.count(); i++)
                     sortedList.append(strList.at(i).toDouble());
                 qSort(sortedList.begin(), sortedList.end());
+                //! [3]
                 int count = sortedList.count();
+                //! [4]
                 QBoxSet *box = new QBoxSet(strList.first());
                 box->setValue(QBoxSet::LowerExtreme, sortedList.first());
                 box->setValue(QBoxSet::UpperExtreme, sortedList.last());
                 box->setValue(QBoxSet::Median, findMedian(0, count));
                 box->setValue(QBoxSet::LowerQuartile, findMedian(0, count / 2));
-                if (count % 2)
+                box->setValue(QBoxSet::UpperQuartile, findMedian(count / 2 + (count % 2), count));
-                    box->setValue(QBoxSet::UpperQuartile, findMedian(count / 2 + 1, count));
+                //! [4]
-                else // even amount of numbers
-                    box->setValue(QBoxSet::UpperQuartile, findMedian(count / 2, count));
                 return box;
             }
             qreal BoxDataReader::findMedian(int begin, int end)
             {
+                //! [5]
                 int count = end - begin;
                 if (count % 2) {
-                    return sortedList.at(int(count/2) + begin);
+                    return sortedList.at(count / 2 + begin);
                 } else {
                     qreal right = sortedList.at(count / 2 + begin);
                     qreal left = sortedList.at(count / 2 - 1 + begin);
                     return (right + left) / 2.0;
                 }
+                //! [5]
             }

examples/boxplotchart/boxdatareader.h +1 0

             /****************************************************************************
             **
             ** Copyright (C) 2013 Digia Plc
             ** All rights reserved.
             ** For any questions to Digia, please use contact form at http://qt.digia.com
             **
             ** This file is part of the Qt Commercial Charts Add-on.
             **
             ** $QT_BEGIN_LICENSE$
             ** Licensees holding valid Qt Commercial licenses may use this file in
             ** accordance with the Qt Commercial License Agreement provided with the
             ** Software or, alternatively, in accordance with the terms contained in
             ** a written agreement between you and Digia.
             **
             ** If you have questions regarding the use of this file, please use
             ** contact form at http://qt.digia.com
             ** $QT_END_LICENSE$
             **
             ****************************************************************************/
             #ifndef BOXDATAREADER_H
             #define BOXDATAREADER_H
             #include <QTextStream>
             #include <QBoxSet>
             QTCOMMERCIALCHART_USE_NAMESPACE
             class BoxDataReader : public QTextStream
             {
             public:
                 explicit BoxDataReader(QIODevice *device);
                 QBoxSet *readBox();
+                void readFile(QIODevice *device);
             protected:
                 qreal findMedian(int begin, int end);
             private:
                 QList<qreal> sortedList;
             };
             #endif // BOXDATAREADER_H

examples/boxplotchart/boxplotdata.qrc +2 -1

             <RCC>
                 <qresource prefix="/">
-                    <file alias="stock">stock_data.txt</file>
+                    <file alias="acme">acme_data.txt</file>
+                    <file alias="boxwhisk">boxwhisk_data.txt</file>
                 </qresource>
             </RCC>

examples/boxplotchart/main.cpp +38 -19

             /****************************************************************************
             **
             ** Copyright (C) 2013 Digia Plc
             ** All rights reserved.
             ** For any questions to Digia, please use contact form at http://qt.digia.com
             **
             ** This file is part of the Qt Commercial Charts Add-on.
             **
             ** $QT_BEGIN_LICENSE$
             ** Licensees holding valid Qt Commercial licenses may use this file in
             ** accordance with the Qt Commercial License Agreement provided with the
             ** Software or, alternatively, in accordance with the terms contained in
             ** a written agreement between you and Digia.
             **
             ** If you have questions regarding the use of this file, please use
             ** contact form at http://qt.digia.com
             ** $QT_END_LICENSE$
             **
             ****************************************************************************/
             #include <QApplication>
             #include <QMainWindow>
             #include <QChartView>
             #include <QBoxPlotSeries>
             #include <QBoxSet>
             #include <QLegend>
             #include <QBarCategoryAxis>
             #include "boxdatareader.h"
             QTCOMMERCIALCHART_USE_NAMESPACE
             int main(int argc, char *argv[])
             {
                 QApplication a(argc, argv);
+                //! [1]
+                QBoxPlotSeries *acmeSeries = new QBoxPlotSeries();
+                acmeSeries->setName("Acme Ltd");
+                QBoxPlotSeries *boxWhiskSeries = new QBoxPlotSeries();
+                boxWhiskSeries->setName("BoxWhisk Inc");
                 //! [1]
                 //! [2]
-                QBoxPlotSeries *series = new QBoxPlotSeries();
+                QFile acmeData(":acme");
-                series->setName("Acme Ltd");
+                if (!acmeData.open(QIODevice::ReadOnly | QIODevice::Text))
+                    return 1;
+                BoxDataReader dataReader(&acmeData);
+                while (!dataReader.atEnd()) {
+                    QBoxSet *set = dataReader.readBox();
+                    if (set)
+                        acmeSeries->append(set);
+                }
                 //! [2]
-                QFile stockData(":stock");
+                //! [3]
-                if (!stockData.open(QIODevice::ReadOnly | QIODevice::Text))
+                QFile boxwhiskData(":boxwhisk");
+                if (!boxwhiskData.open(QIODevice::ReadOnly | QIODevice::Text))
                     return 1;
-                BoxDataReader dataReader(&stockData);
+                dataReader.readFile(&boxwhiskData);
                 while (!dataReader.atEnd()) {
                     QBoxSet *set = dataReader.readBox();
                     if (set)
-                        series->append(set);
+                        boxWhiskSeries->append(set);
                 }
                 //! [3]
+                //! [4]
                 QChart *chart = new QChart();
-                chart->addSeries(series);
+                chart->addSeries(acmeSeries);
-                chart->setTitle("Acme's share deviation in 2012");
+                chart->addSeries(boxWhiskSeries);
+                chart->setTitle("Acme Ltd and BoxWhisk Inc share deviation in 2012");
                 chart->setAnimationOptions(QChart::SeriesAnimations);
-            //![3]
                 //! [4]
+                //! [5]
                 chart->createDefaultAxes();
                 chart->axisY()->setMin(15.0);
-            //![4]
+                chart->axisY()->setMax(34.0);
                 //! [5]
+                //! [6]
                 chart->legend()->setVisible(true);
                 chart->legend()->setAlignment(Qt::AlignBottom);
-            //![5]
                 //! [6]
+                //! [7]
                 QChartView *chartView = new QChartView(chart);
                 chartView->setRenderHint(QPainter::Antialiasing);
-            //![6]
                 //! [7]
+                //! [8]
                 QMainWindow window;
                 window.setCentralWidget(chartView);
-                window.resize(600, 400);
+                window.resize(800, 600);
                 window.show();
-            //![7]
+                //! [8]
                 return a.exec();
             }

src/boxplotchart/qboxset.cpp 0 -9

             /****************************************************************************
             **
             ** Copyright (C) 2013 Digia Plc
             ** All rights reserved.
             ** For any questions to Digia, please use contact form at http://qt.digia.com
             **
             ** This file is part of the Qt Commercial Charts Add-on.
             **
             ** $QT_BEGIN_LICENSE$
             ** Licensees holding valid Qt Commercial licenses may use this file in
             ** accordance with the Qt Commercial License Agreement provided with the
             ** Software or, alternatively, in accordance with the terms contained in
             ** a written agreement between you and Digia.
             **
             ** If you have questions regarding the use of this file, please use
             ** contact form at http://qt.digia.com
             ** $QT_END_LICENSE$
             **
             ****************************************************************************/
             #include "qboxset.h"
             #include "qboxset_p.h"
             #include "charthelpers_p.h"
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
                 \class QBoxSet
                 \brief Building block for box-and-whiskers chart
                 QBoxSet represents one box-and-whiskers item. It takes five values to create a graphical representation
                 of range and three medians. There are two ways to give the values. The first one is with constructor
                 or stream operator (<<). The values have to be given in the following order: lower extreme,
                 lower quartile, median, upper quartile and upper extreme. The Second method is to create an empty QBoxSet instance and
                 give the values using setValue method.
                 \mainclass
                 \sa QBoxPlotSeries
             */
             /*!
                 \qmlclass BoxSet QBoxSet
                 BoxSet represents one box-and-whiskers item. It takes five values to create a graphical representation
                 of range and three medians. There are two ways to give the values. The first one is with constructor
                 or with append method. In these the values have to be given in the following order: lower extreme, lower quartile, median,
                 upper quartile and upper extre. The second method is to create an empty QBoxSet instance and give the values using
                 value specific methods.
                 \sa BoxPlotSeries
             */
             /*!
                 \enum QBoxSet::ValuePositions
                 \value LowerExtreme
                 \value LowerQuartile
                 \value Median
                 \value UpperQuartile
                 \value UpperExtreme
             */
             /*!
                 \qmlproperty string BoxSet::label
                 Defines the label of the boxSet.
             */
             /*!
                 \qmlproperty int BoxSet::count
                 The count of values on the box-and-whiskers set
             */
             /*!
                 \property QBoxSet::pen
                 \brief Defines the pen used by the box-and-whiskers set.
             */
             /*!
                 \property QBoxSet::brush
                 \brief Defines the brush used by the box-and-whiskers set.
             */
             /*!
                 \qmlmethod void BoxSet::setValue(int index, qreal value)
                 Sets a new \a value on the \a index position.
             */
             /*!
                 \fn void QBoxSet::clicked()
                 The signal is emitted if the user clicks with a mouse on top of box-and-whisker item.
             */
             /*!
                 \qmlsignal BoxSet::onClicked()
                 This signal is emitted when the user clicks with a mouse on top of box-and-whisker item.
             */
             /*!
                 \fn void QBoxSet::hovered(bool status)
                 The signal is emitted if mouse is hovered on top of box-and-whisker item.
                 Parameter \a status is true, if mouse entered on top of item, false if mouse left from top of item.
             */
             /*!
                 \qmlsignal BoxSet::onHovered(bool status)
                 The signal is emitted if mouse is hovered on top of box-and-whisker item.
                 Parameter \a status is true, if mouse entered on top of item, false if mouse left from top of item.
             */
             /*!
                 \fn void QBoxSet::penChanged()
                 This signal is emitted when the pen of the box-and-whisker item has changed.
                 \sa pen
             */
             /*!
                 \qmlsignal BoxSet::onPenChanged()
                 This signal is emitted when the pen of the box-and-whisker item has changed.
             */
             /*!
                 \fn void QBoxSet::brushChanged()
                 This signal is emitted when the brush of the box-and-whisker item has changed.
                 \sa brush
             */
             /*!
                 \qmlsignal BoxSet::onBrushChanged()
                 This signal is emitted when the brush of the box-and-whisker item has changed.
             */
             /*!
-                \fn void QBoxSet::colorChanged(QColor)
-                This signal is emitted when the fill (brush) color of the box-and-whisker item has changed to \a color.
-            */
-            /*!
-                \qmlsignal BoxSet::onColorChanged(QColor color)
-                This signal is emitted when the fill (brush) color of the box-and-whisker item has changed to \a color.
-            */
-            /*!
                 \fn void QBoxSet::valuesChanged()
                 This signal is emitted when multiple values have been changed on the box-and-whisker item.
                 \sa append()
             */
             /*!
                 \qmlsignal BoxSet::onChangedValues()
                 This signal is emitted when multiple values have been changed on the box-and-whisker item.
             */
             /*!
                 \fn void QBoxSet::valueChanged(int index)
                 This signal is emitted values the value in the box-and-whisker item has been modified.
                 Parameter \a index indicates the position of the modified value.
                 \sa at()
             */
             /*!
                 \qmlsignal BoxSet::onChangedValue(int index)
                 This signal is emitted values the value in the box-and-whisker item has been modified.
                 Parameter \a index indicates the position of the modified value.
             */
             /*!
                 \fn void QBoxSet::cleared()
                 This signal is emitted when all the values on the set are cleared to 0.
             */
             /*!
                 \qmlsignal BoxSet::onCleared()
                 This signal is emitted when all the values on the set are cleared to 0.
             */
             /*!
                 Constructs QBoxSet with optional \a label and parent of \a parent
             */
             QBoxSet::QBoxSet(const QString label, QObject *parent)
                 : QObject(parent),
                   d_ptr(new QBoxSetPrivate(label, this))
             {
             }
             /*!
                 Constructs QBoxSet with given ordered values. \a le for lower extreme, \a lq for lower quartile, \a m for median,
                 \a uq for upper quartile and \a ue for upper quartile. \a label and \a parent are optional.
              */
             QBoxSet::QBoxSet(const qreal le, const qreal lq, const qreal m, const qreal uq, const qreal ue, const QString label, QObject *parent)
                 : QObject(parent),
                   d_ptr(new QBoxSetPrivate(label, this))
             {
                 d_ptr->append(le);
                 d_ptr->append(lq);
                 d_ptr->append(m);
                 d_ptr->append(uq);
                 d_ptr->append(ue);
             }
             /*!
                 Destroys the boxset
             */
             QBoxSet::~QBoxSet()
             {
             }
             /*!
                 Appends new value \a value to the end of set.
             */
             void QBoxSet::append(const qreal value)
             {
                 if (d_ptr->append(value))
                     emit valueChanged(d_ptr->m_appendCount - 1);
             }
             /*!
                 Appends a list of reals to set. Works like append with single real value. The \a values in list
                 are appended to end of boxset.
                 \sa append()
             */
             void QBoxSet::append(const QList<qreal> &values)
             {
                 if (d_ptr->append(values))
                     emit valuesChanged();
             }
             /*!
                 Sets new \a label for set.
             */
             void QBoxSet::setLabel(const QString label)
             {
                 d_ptr->m_label = label;
             }
             /*!
                 Returns label of the set.
             */
             QString QBoxSet::label() const
             {
                 return d_ptr->m_label;
             }
             /*!
                 Convenience operator. Same as append, with real \a value.
                 \sa append()
             */
             QBoxSet &QBoxSet::operator << (const qreal &value)
             {
                 append(value);
                 return *this;
             }
             /*!
                 Sets a new \a value on the \a index position. For \a index ValuePositions can be used.
             */
             void QBoxSet::setValue(const int index, const qreal value)
             {
                 d_ptr->setValue(index, value);
                 emit valueChanged(index);
             }
             /*!
                 Sets all values on the set to 0.
              */
             void QBoxSet::clear()
             {
                 d_ptr->clear();
                 emit cleared();
             }
             /*!
                 Returns value of set indexed by \a index. For \a index ValuePositions can be used.
                 If the index is out of bounds 0.0 is returned.
             */
             qreal QBoxSet::at(const int index) const
             {
                 if (index < 0 || index >= 5)
                     return 0;
                 return d_ptr->m_values[index];
             }
             /*!
                 Returns value of set indexed by \a index. For \a index ValuePositions can be used.
                 If the index is out of bounds 0.0 is returned.
             */
             qreal QBoxSet::operator [](const int index) const
             {
                 return at(index);
             }
             /*!
                 Returns count of values appended to the set.
             */
             int QBoxSet::count() const
             {
                 return d_ptr->m_appendCount;
             }
             /*!
                 Sets pen for set. Boxes of this set are drawn using \a pen
             */
             void QBoxSet::setPen(const QPen &pen)
             {
                 if (d_ptr->m_pen != pen) {
                     d_ptr->m_pen = pen;
                     emit d_ptr->updatedBox();
                     emit penChanged();
                 }
             }
             /*!
                 Returns pen of the set.
             */
             QPen QBoxSet::pen() const
             {
                 return d_ptr->m_pen;
             }
             /*!
                 Sets brush for the set. Boxes of this set are drawn using \a brush
             */
             void QBoxSet::setBrush(const QBrush &brush)
             {
                 if (d_ptr->m_brush != brush) {
                     d_ptr->m_brush = brush;
                     emit d_ptr->updatedBox();
                     emit brushChanged();
                 }
             }
             /*!
                 Returns brush of the set.
             */
             QBrush QBoxSet::brush() const
             {
                 return d_ptr->m_brush;
             }
             ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
             QBoxSetPrivate::QBoxSetPrivate(const QString label, QBoxSet *parent) : QObject(parent),
                 q_ptr(parent),
                 m_label(label),
                 m_valuesCount(5),
                 m_appendCount(0),
                 m_pen(QPen(Qt::NoPen)),
                 m_brush(QBrush(Qt::NoBrush))
             {
                 m_values = new qreal[m_valuesCount];
             }
             QBoxSetPrivate::~QBoxSetPrivate()
             {
             }
             bool QBoxSetPrivate::append(qreal value)
             {
                 if (isValidValue(value) && m_appendCount < m_valuesCount) {
                     m_values[m_appendCount++] = value;
                     emit restructuredBox();
                     return true;
                 }
                 return false;
             }
             bool QBoxSetPrivate::append(QList<qreal> values)
             {
                 bool success = false;
                 for (int i = 0; i < values.count(); i++) {
                     if (isValidValue(values.at(i)) && m_appendCount < m_valuesCount) {
                         success = true;
                         m_values[m_appendCount++] = values.at(i);
                     }
                 }
                 if (success)
                     emit restructuredBox();
                 return success;
             }
             void QBoxSetPrivate::clear()
             {
                 m_appendCount = 0;
                 for (int i = 0; i < m_valuesCount; i++)
                      m_values[i] = 0.0;
                 emit restructuredBox();
             }
             void QBoxSetPrivate::setValue(const int index, const qreal value)
             {
                 if (index < m_valuesCount) {
                     m_values[index] = value;
                     emit updatedLayout();
                 }
             }
             qreal QBoxSetPrivate::value(const int index)
             {
                 if (index < 0 || index >= m_valuesCount)
                     return 0;
                 return m_values[index];
             }
             #include "moc_qboxset.cpp"
             #include "moc_qboxset_p.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

General Comments 0

Write
Preview

You need to be logged in to leave comments. Login now

No TODOs yet

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages