The ScatterPlot command generates a scatter plot for the specified data. Optionally, one can fit a curve or apply lowess smoothing to the data.

The first parameter, X, is the first data sample - given as a Vector or list.

The second parameter, Y, is the second data sample - given as a Vector or list.

If Y is not given, then X is plotted by itself, with every entry in it being given an associated y-value of 1.

Note that X and Y must have the same number of elements.

The options argument can contain one or more of the options shown below. All unrecognized options will be passed to the plots[display] command. See plot[options] for details.

bandwidth=realcons

This option is used to control the bandwidth of the lowess smoothing algorithm, when lowess fitting is enabled. The value of this option is the fraction of points used to define a neighborhood. If n is the number of points in the data sample passed to ScatterPlot, then the condition bandwidth*n>degree must be true.  The default value is .

color=name, list, or range

This option specifies colors for the individual data sets. When a list of colors is given, each of the scatters will be colored with the corresponding color in the list. If a range of colors is given, the colors will be generated by selecting an appropriate number of equally-spaced points in the corresponding hue range.

degree=posint

The degree of the polynomial used in lowess smoothing, when lowess fitting is enabled. If n is the number of points in the data sample passed to ScatterPlot, then the condition bandwidth*n>degree must be true. The default value is .

fit=list

One can specify a curve to be fitted into the data points. The value of this option is the list of arguments to be passed to the NonlinearFit command.

jitter=truefalse

This option is for one dimensional data only. This option causes all points in X to be assigned a random y-value in the range of [0, 1). This allows a better visual representation of the density of one dimensional data. The default for this option in false.  Note that if Y is specified, this option is ignored.

lowess=truefalse

Tells whether lowess smoothing should be applied to the scatter plot. The smoothing behavior is modified by the options bandwidth, degree and robust; see these options for more details. The default value is false.

robust=truefalse

This option tells whether the data weights in the lowess fitting should be adjusted for robustness. The default value is false.

xerrors=Vector or [Vector, Vector]

This options specifies errors along the x-axis. The array of errors must have the same number of elements. To specify right errors and left errors separately, use the list of two vectors.

yerrors=Vector or [Vector, Vector]

Similar to the xerrors option, see above.