QXYSeries

The QXYSeries class is a base class for line, spline, and scatter series. More

Inheritance diagram of PySide6.QtCharts.QXYSeries

Inherited by: QScatterSeries, QLineSeries, QSplineSeries

Synopsis

Functions

Virtual functions

Signals

Detailed Description

QXYSeries supports displaying best fit line on a chart. Best fit line is a line through a chart that expresses the relationship between points.

class PySide6.QtCharts.QXYSeries
PySide6.QtCharts.QXYSeries.append(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.append(points)
Parameters

points

PySide6.QtCharts.QXYSeries.append(x, y)
Parameters
  • x – float

  • y – float

Adds the data point with the coordinates x and y to the series.

PySide6.QtCharts.QXYSeries.appendNp(x, y)
Parameters
  • xPyArrayObject

  • yPyArrayObject

Adds the list of data points specified by two one-dimensional, equally sized numpy arrays representing the x, y values, respectively.

PySide6.QtCharts.QXYSeries.at(index)
Parameters

index – int

Return type

PySide6.QtCore.QPointF

Returns the data point at the position specified by index in the internal series of points.

PySide6.QtCharts.QXYSeries.bestFitLineColor()
Return type

PySide6.QtGui.QColor

This property holds The color of best fit line..

PySide6.QtCharts.QXYSeries.bestFitLineColorChanged(color)
Parameters

colorPySide6.QtGui.QColor

PySide6.QtCharts.QXYSeries.bestFitLineEquation(ok)
Parameters

ok – bool

Return type

Returns a pair of numbers where the first number is a slope factor and the second number is intercept of a linear function for a best fit line.

Those factors are calculated using Least Squares Method based on points passed to the series.

Parameter ok is used to report a failure by setting its value to false and to report a success by setting its value to true.

PySide6.QtCharts.QXYSeries.bestFitLinePen()
Return type

PySide6.QtGui.QPen

PySide6.QtCharts.QXYSeries.bestFitLinePenChanged(pen)
Parameters

penPySide6.QtGui.QPen

PySide6.QtCharts.QXYSeries.bestFitLineVisibilityChanged(visible)
Parameters

visible – bool

PySide6.QtCharts.QXYSeries.bestFitLineVisible()
Return type

bool

This property holds The visibility of the best fit line..

This property is false by default.

PySide6.QtCharts.QXYSeries.brush()
Return type

PySide6.QtGui.QBrush

Returns the brush used to fill the data points for the series.

See also

setBrush()

PySide6.QtCharts.QXYSeries.clear()

Removes all points from the series.

See also

pointsRemoved()

PySide6.QtCharts.QXYSeries.clearPointConfiguration(index)
Parameters

index – int

Removes the configuration of a point located at index and restores the default look derived from the series’ settings.

Note

It doesn’t affect the configuration of other points.

See also

clearPointsConfiguration() setPointConfiguration()

PySide6.QtCharts.QXYSeries.clearPointsConfiguration()

Removes the configuration of all points in the series and restores the default look derived from the series’ settings.

See also

setPointConfiguration()

PySide6.QtCharts.QXYSeries.clicked(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.color()
Return type

PySide6.QtGui.QColor

This property holds The color of the series..

This is the line (pen) color in case of QLineSeries or QSplineSeries and the fill (brush) color in case of QScatterSeries or QAreaSeries .

See also

pen() brush()

PySide6.QtCharts.QXYSeries.colorBy(sourceData[, gradient=QLinearGradient()])
Parameters

Sets the points’ color according to a passed list of values. Values from sourceData are sorted and mapped to the gradient.

If the series has a QColorAxis attached, then a gradient from the axis is going to be used.

See also

setPointConfiguration() pointConfiguration() QColorAxis

PySide6.QtCharts.QXYSeries.colorChanged(color)
Parameters

colorPySide6.QtGui.QColor

PySide6.QtCharts.QXYSeries.count()
Return type

int

Returns the number of data points in a series.

PySide6.QtCharts.QXYSeries.deselectAllPoints()

Deselects all points in the series.

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.deselectPoint(index)
Parameters

index – int

Deselects point at given index.

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.deselectPoints(indexes)
Parameters

indexes

Marks multiple points passed in a indexes list as deselected.

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.doubleClicked(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.hovered(point, state)
Parameters
PySide6.QtCharts.QXYSeries.insert(index, point)
Parameters

Inserts the data point point in the series at the position specified by index.

See also

pointAdded()

PySide6.QtCharts.QXYSeries.isPointSelected(index)
Parameters

index – int

Return type

bool

Returns true if point at given index is among selected points and false otherwise.

Note

Selected points are drawn using the selected color if it was specified.

PySide6.QtCharts.QXYSeries.lightMarker()
Return type

PySide6.QtGui.QImage

Gets the image used for drawing markers on each point of the series.

The default value is QImage(), meaning no light marker will be painted.

The light markers visualize the data points of this series and as such are an alternative to setPointsVisible (true). Both features can be enabled independently from each other.

Unlike the elements of QScatterSeries the light markers are not represented by QGraphicsItem , but are just painted (no objects created). However, the mouse-event-signals of QXYSeries behave the same way, meaning that you’ll get the exact domain value of the point if you click/press/hover the light marker. You’ll still get the in between domain value if you click on the line. The light markers are above the line in terms of painting as well as events.

See also

setLightMarker()

PySide6.QtCharts.QXYSeries.lightMarkerChanged(lightMarker)
Parameters

lightMarkerPySide6.QtGui.QImage

PySide6.QtCharts.QXYSeries.markerSize()
Return type

float

Gets the size of the marker used to render points in the series.

The default size depends on the specific QXYSeries type. QScatterSeries has a default of 15.0 QLineSeries has a default of the series pen size * 1.5

See also

setMarkerSize() markerSize

PySide6.QtCharts.QXYSeries.markerSizeChanged(size)
Parameters

size – float

PySide6.QtCharts.QXYSeries.__lshift__(points)
Parameters

points

Return type

PySide6.QtCharts.QXYSeries

PySide6.QtCharts.QXYSeries.__lshift__(point)
Parameters

pointPySide6.QtCore.QPointF

Return type

PySide6.QtCharts.QXYSeries

PySide6.QtCharts.QXYSeries.pen()
Return type

PySide6.QtGui.QPen

Returns the pen used to draw the outline of the data points for the series.

See also

setPen()

PySide6.QtCharts.QXYSeries.penChanged(pen)
Parameters

penPySide6.QtGui.QPen

PySide6.QtCharts.QXYSeries.pointAdded(index)
Parameters

index – int

PySide6.QtCharts.QXYSeries.pointLabelsClipping()
Return type

bool

This property holds The clipping for data point labels..

This property is true by default. The labels on the edge of the plot area are cut when clipping is enabled.

PySide6.QtCharts.QXYSeries.pointLabelsClippingChanged(clipping)
Parameters

clipping – bool

PySide6.QtCharts.QXYSeries.pointLabelsColor()
Return type

PySide6.QtGui.QColor

This property holds The color used for data point labels. By default, the color is the color of the brush defined in theme for labels..

PySide6.QtCharts.QXYSeries.pointLabelsColorChanged(color)
Parameters

colorPySide6.QtGui.QColor

PySide6.QtCharts.QXYSeries.pointLabelsFont()
Return type

PySide6.QtGui.QFont

This property holds The font used for data point labels..

PySide6.QtCharts.QXYSeries.pointLabelsFontChanged(font)
Parameters

fontPySide6.QtGui.QFont

PySide6.QtCharts.QXYSeries.pointLabelsFormat()
Return type

str

This property holds The format used for showing labels with data points..

QXYSeries supports the following format tags:

@xPoint

The x-coordinate of the data point.

@yPoint

The y-coordinate of the data point.

For example, the following usage of the format tags would produce labels that display the data point shown inside brackets separated by a comma (x, y):

series->setPointLabelsFormat("(@xPoint, @yPoint)");

By default, the labels’ format is set to @xPoint, @yPoint. The labels are shown on the plot area, and the labels on the edge of the plot area are cut. If the points are close to each other, the labels may overlap.

PySide6.QtCharts.QXYSeries.pointLabelsFormatChanged(format)
Parameters

format – str

PySide6.QtCharts.QXYSeries.pointLabelsVisibilityChanged(visible)
Parameters

visible – bool

PySide6.QtCharts.QXYSeries.pointLabelsVisible()
Return type

bool

This property holds The visibility of data point labels..

This property is false by default.

PySide6.QtCharts.QXYSeries.pointRemoved(index)
Parameters

index – int

PySide6.QtCharts.QXYSeries.pointReplaced(index)
Parameters

index – int

PySide6.QtCharts.QXYSeries.points()
Return type

Returns the points in the series.

PySide6.QtCharts.QXYSeries.pointsRemoved(index, count)
Parameters
  • index – int

  • count – int

PySide6.QtCharts.QXYSeries.pointsReplaced()
PySide6.QtCharts.QXYSeries.pointsVector()
Return type

Note

This function is deprecated.

Use points() instead. Returns the points in the series.

PySide6.QtCharts.QXYSeries.pointsVisible()
Return type

bool

This property holds Whether the data points are visible and should be drawn..

PySide6.QtCharts.QXYSeries.pressed(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.released(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.remove(point)
Parameters

pointPySide6.QtCore.QPointF

PySide6.QtCharts.QXYSeries.remove(index)
Parameters

index – int

Removes the point at the position specified by index from the series.

See also

pointRemoved()

PySide6.QtCharts.QXYSeries.remove(x, y)
Parameters
  • x – float

  • y – float

Removes the point that has the coordinates x and y from the series.

See also

pointRemoved()

PySide6.QtCharts.QXYSeries.removePoints(index, count)
Parameters
  • index – int

  • count – int

Removes the number of points specified by count from the series starting at the position specified by index.

See also

pointsRemoved()

PySide6.QtCharts.QXYSeries.replace(points)
Parameters

points

Replaces the current points with the points specified by points.

Note

This is much faster than replacing data points one by one, or first clearing all data, and then appending the new data. Emits pointsReplaced() when the points have been replaced.

See also

pointsReplaced()

PySide6.QtCharts.QXYSeries.replace(oldX, oldY, newX, newY)
Parameters
  • oldX – float

  • oldY – float

  • newX – float

  • newY – float

Replaces the point with the coordinates oldX and oldY with the point with the coordinates newX and newY. Does nothing if the old point does not exist.

See also

pointReplaced()

PySide6.QtCharts.QXYSeries.replace(index, newX, newY)
Parameters
  • index – int

  • newX – float

  • newY – float

Replaces the point at the position specified by index with the point that has the coordinates newX and newY.

See also

pointReplaced()

PySide6.QtCharts.QXYSeries.replace(index, newPoint)
Parameters
PySide6.QtCharts.QXYSeries.replace(oldPoint, newPoint)
Parameters
PySide6.QtCharts.QXYSeries.replaceNp(x, y)
Parameters
  • xPyArrayObject

  • yPyArrayObject

Replaces the current points with the points specified by two one-dimensional, equally sized numpy arrays representing the x, y values, respectively.

PySide6.QtCharts.QXYSeries.selectAllPoints()

Marks all points in the series as selected,

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.selectPoint(index)
Parameters

index – int

Marks point at index as selected.

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.selectPoints(indexes)
Parameters

indexes

Marks multiple points passed in a indexes list as selected.

Note

Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.selectedColor()
Return type

PySide6.QtGui.QColor

PySide6.QtCharts.QXYSeries.selectedColorChanged(color)
Parameters

colorPySide6.QtGui.QColor

PySide6.QtCharts.QXYSeries.selectedLightMarker()
Return type

PySide6.QtGui.QImage

Returns the image used for drawing markers on selected series’ points.

The default value is QImage(), meaning usual lightMarker() will be painted.

This is equivalent to selectedColor if you prefer light markers over normal points, but still want to distinguish selected points.

PySide6.QtCharts.QXYSeries.selectedLightMarkerChanged(selectedLightMarker)
Parameters

selectedLightMarkerPySide6.QtGui.QImage

PySide6.QtCharts.QXYSeries.selectedPoints()
Return type

Returns a list of points indexes marked as selected. Selected points are visible regardless of points visibility.

PySide6.QtCharts.QXYSeries.selectedPointsChanged()
PySide6.QtCharts.QXYSeries.setBestFitLineColor(color)
Parameters

colorPySide6.QtGui.QColor

This property holds The color of best fit line..

PySide6.QtCharts.QXYSeries.setBestFitLinePen(pen)
Parameters

penPySide6.QtGui.QPen

PySide6.QtCharts.QXYSeries.setBestFitLineVisible([visible=true])
Parameters

visible – bool

This property holds The visibility of the best fit line..

This property is false by default.

PySide6.QtCharts.QXYSeries.setBrush(brush)
Parameters

brushPySide6.QtGui.QBrush

Sets the brush used for drawing points on the chart to brush. If the brush is not defined, the brush from the chart theme setting is used.

See also

brush() setTheme()

PySide6.QtCharts.QXYSeries.setColor(color)
Parameters

colorPySide6.QtGui.QColor

This property holds The color of the series..

This is the line (pen) color in case of QLineSeries or QSplineSeries and the fill (brush) color in case of QScatterSeries or QAreaSeries .

See also

pen() brush()

PySide6.QtCharts.QXYSeries.setLightMarker(lightMarker)
Parameters

lightMarkerPySide6.QtGui.QImage

Sets the image used for drawing markers on each point of the series as the value of lightMarker.

The default value is a default-QImage() ( isNull() == true), meaning no light marker will be painted. You can reset back to default (disabled) by calling this function with a null QImage (QImage()).

The light markers visualize the data points of this series and as such are an alternative to setPointsVisible(true). If a light marker is set with this method, visible points as set with setPointsVisible(true) are not displayed.

Unlike the elements of QScatterSeries the light markers are not represented by QGraphicsItem , but are just painted (no objects created). However, the mouse-event-signals of QXYSeries behave the same way, meaning that you’ll get the exact domain value of the point if you click/press/hover the light marker. You’ll still get the in between domain value if you click on the line. The light markers are above the line in terms of painting as well as events.

See also

lightMarker()

PySide6.QtCharts.QXYSeries.setMarkerSize(size)
Parameters

size – float

Sets the size of the marker used to render points in the series.

The default size is 15.0.

See also

markerSize

PySide6.QtCharts.QXYSeries.setPen(pen)
Parameters

penPySide6.QtGui.QPen

Sets the pen used for drawing points on the chart to pen. If the pen is not defined, the pen from the chart theme is used.

See also

pen() setTheme()

PySide6.QtCharts.QXYSeries.setPointLabelsClipping([enabled=true])
Parameters

enabled – bool

This property holds The clipping for data point labels..

This property is true by default. The labels on the edge of the plot area are cut when clipping is enabled.

PySide6.QtCharts.QXYSeries.setPointLabelsColor(color)
Parameters

colorPySide6.QtGui.QColor

This property holds The color used for data point labels. By default, the color is the color of the brush defined in theme for labels..

PySide6.QtCharts.QXYSeries.setPointLabelsFont(font)
Parameters

fontPySide6.QtGui.QFont

This property holds The font used for data point labels..

PySide6.QtCharts.QXYSeries.setPointLabelsFormat(format)
Parameters

format – str

This property holds The format used for showing labels with data points..

QXYSeries supports the following format tags:

@xPoint

The x-coordinate of the data point.

@yPoint

The y-coordinate of the data point.

For example, the following usage of the format tags would produce labels that display the data point shown inside brackets separated by a comma (x, y):

series->setPointLabelsFormat("(@xPoint, @yPoint)");

By default, the labels’ format is set to @xPoint, @yPoint. The labels are shown on the plot area, and the labels on the edge of the plot area are cut. If the points are close to each other, the labels may overlap.

PySide6.QtCharts.QXYSeries.setPointLabelsVisible([visible=true])
Parameters

visible – bool

This property holds The visibility of data point labels..

This property is false by default.

PySide6.QtCharts.QXYSeries.setPointSelected(index, selected)
Parameters
  • index – int

  • selected – bool

Marks point at given index as either selected or deselected as specified by selected.

Note

Selected points are drawn using the selected color if it was specified. Emits QXYSeries::selectedPointsChanged

PySide6.QtCharts.QXYSeries.setPointsVisible([visible=true])
Parameters

visible – bool

This property holds Whether the data points are visible and should be drawn..

PySide6.QtCharts.QXYSeries.setSelectedColor(color)
Parameters

colorPySide6.QtGui.QColor

This property holds The color of the selected points..

This is the fill (brush) color of points marked as selected. If not specified, value of color is used as default.

See also

color

PySide6.QtCharts.QXYSeries.setSelectedLightMarker(selectedLightMarker)
Parameters

selectedLightMarkerPySide6.QtGui.QImage

Sets the image used for drawing markers on selected series’s points to selectedLightMarker.

The default value is QImage(), meaning usual lightMarker() will be painted.

This is an equivalent for selectedColor if you prefer light markers over normal points, but still want to distinguish selected points.

PySide6.QtCharts.QXYSeries.sizeBy(sourceData, minSize, maxSize)
Parameters
  • sourceData

  • minSize – float

  • maxSize – float

Sets the points’ sizes according to a passed list of values. Values from sourceData are sorted and mapped to a point size which is between minSize and maxSize.

Note

If sourceData length is smaller than number of points in the series, then size of the points at the end of the series will stay the same.

See also

setPointConfiguration() pointConfiguration()

PySide6.QtCharts.QXYSeries.toggleSelection(indexes)
Parameters

indexes

Changes selection state of points at given indexes to the opposite one. Makes

Note

Emits QXYSeries::selectedPointsChanged