Scatter plots

class sage.plot.scatter_plot.ScatterPlot(xdata, ydata, options)[source]

Bases: GraphicPrimitive

Scatter plot graphics primitive.

Input consists of two lists/arrays of the same length, whose values give the horizontal and vertical coordinates of each point in the scatter plot. Options may be passed in dictionary format.

EXAMPLES:

sage: from sage.plot.scatter_plot import ScatterPlot
sage: ScatterPlot([0,1,2], [3.5,2,5.1], {'facecolor':'white', 'marker':'s'})
Scatter plot graphics primitive on 3 data points
>>> from sage.all import *
>>> from sage.plot.scatter_plot import ScatterPlot
>>> ScatterPlot([Integer(0),Integer(1),Integer(2)], [RealNumber('3.5'),Integer(2),RealNumber('5.1')], {'facecolor':'white', 'marker':'s'})
Scatter plot graphics primitive on 3 data points
get_minmax_data()[source]

Return a dictionary with the bounding box data.

EXAMPLES:

sage: s = scatter_plot([[0,1],[2,4],[3.2,6]])
sage: d = s.get_minmax_data()
sage: d['xmin']
...0.0...
sage: d['ymin']
...1.0...
>>> from sage.all import *
>>> s = scatter_plot([[Integer(0),Integer(1)],[Integer(2),Integer(4)],[RealNumber('3.2'),Integer(6)]])
>>> d = s.get_minmax_data()
>>> d['xmin']
...0.0...
>>> d['ymin']
...1.0...
sage.plot.scatter_plot.scatter_plot(datalist, alpha=1, markersize=50, marker='o', zorder=5, facecolor='#fec7b8', edgecolor='black', clip=True, aspect_ratio='automatic', **options)[source]

Return a Graphics object of a scatter plot containing all points in the datalist. Type scatter_plot.options to see all available plotting options.

INPUT:

  • datalist – list of tuples (x,y)

  • alpha – (default: 1)

  • markersize – (default: 50)

  • marker – the style of the markers (default: 'o'); see the documentation of plot() for the full list of markers

  • facecolor – (default: '#fec7b8')

  • edgecolor – (default: 'black')

  • zorder – (default: 5)

EXAMPLES:

sage: scatter_plot([[0,1],[2,2],[4.3,1.1]], marker='s')
Graphics object consisting of 1 graphics primitive
>>> from sage.all import *
>>> scatter_plot([[Integer(0),Integer(1)],[Integer(2),Integer(2)],[RealNumber('4.3'),RealNumber('1.1')]], marker='s')
Graphics object consisting of 1 graphics primitive
../../_images/scatter_plot-1.svg

Extra options will get passed on to show(), as long as they are valid:

sage: scatter_plot([(0, 0), (1, 1)], markersize=100, facecolor='green', ymax=100)
Graphics object consisting of 1 graphics primitive
sage: scatter_plot([(0, 0), (1, 1)], markersize=100, facecolor='green').show(ymax=100) # These are equivalent
>>> from sage.all import *
>>> scatter_plot([(Integer(0), Integer(0)), (Integer(1), Integer(1))], markersize=Integer(100), facecolor='green', ymax=Integer(100))
Graphics object consisting of 1 graphics primitive
>>> scatter_plot([(Integer(0), Integer(0)), (Integer(1), Integer(1))], markersize=Integer(100), facecolor='green').show(ymax=Integer(100)) # These are equivalent
../../_images/scatter_plot-2.svg