Plotter

// plot array [1, 6, 2, -5, 2].plot; (0..100).normalize(0, 8pi).sin.plot; // nested arrays { (0..100).normalize(0, 15.0.rand).sin }.dup(3).plot; { { (0..17).normalize(0, 15.0.rand).sin }.dup(4) }.dup(3).plot; // UGen functions { SinOsc.ar([700, 357]) * SinOsc.ar([400, 476]) * 0.2 }.plot; // Buffer { var b = Buffer.read(s, Platform.resourceDir +/+ "sounds/SinedPink.aiff"); s.sync; b.plot }.fork(AppClock); // Env Env.perc(0.4, 0.6).plot;

{ |x| sin(x) }.plotGraph(300, 0, 2*pi); { |x| sin(1/x) * x }.plotGraph(from: 0.0001, to: 0.2);

Arguments:

Discussion:

Open given plotter in a new window or within a given composite view.

See the Embedding in another View or GUI example.

Arguments:

Get/Set the style of data display. This can be an array of different modes for multi-channel data. Available modes:

Arguments:

Returns:

Discussion:

Set or get the colors of your data plot.

Arguments:

Returns:

If true, plotter displays channels overlaid on a single plot. (keyboard shortcut: s)a = { (0..30).scramble }.dup(2).plot; a.superpose = true; a.refresh;

Get/set the label for the x-axes. Can be a String or an Array of Strings, or nil to remove the label. See Axis labels example below.

Get/set the label for the y-axes. Can be a String or an Array of Strings, or nil to remove the label. See Axis labels example below.

Get/set whether the corresponding ControlSpec: -units are displayed as labels. The state of -unitLocation determines whether the units are shown as axis labels or appended to the tick labels.

Arguments:

Discussion:

When enabling showUnits, axis or tick labels will only be updated to show the units when the axisLabelX/Y or grid labelAppendString properties are nil, empty, or were previously set to show the spec units — i.e. showUnits won't overwrite a label that has been explicitly set.

See Unit labels example below.

Get/set the label type on which the Spec ControlSpec: -units are shown.

See the Discussion in -showUnits about the interraction with pre-existing labels at the location, and Unit labels example below.

Arguments:

Set properties of all plot views. Defaults are taken from GUI.skins.at(\plot);

Arguments:

Discussion:

Example:( a = { (0..30).scramble }.dup(2).plot; a.setProperties( \fontColor, Color.yellow, \plotColor, Color.magenta, \backgroundColor, Color.black, \gridColorX, Color.green, \gridColorY, Color.green, \labelX, "Frames", \labelFontColor, Color.magenta ); a.refresh; ); GUI.skins.at(\plot); // defaults

Returns:

Set one or more properties of the DrawGridX or DrawGridY used by all Plots.

Arguments:

Discussion:

This is a convenience method to set the grid properties for all Plots to the same values. An Example:( var plotter = [10, 34, 167].collect({ |freq| 101.collect{|i| sin((i/1000) * 2pi * freq)} }).plot; plotter.setGridProperties(\x, \labelAnchor, \topLeft, \labelAlign, \left, \labelOffset, 1 @ 5, \labelAppendString, " samp" ).setGridProperties(\y, \labelAnchor, \right, \labelAlign, \right, \labelOffset, -5 @ 0, \constrainLabelExtents, false ) )

To set the properties of grids on each Plot separately, iterate over the plots:( var plotter, labelAnchors; plotter = [10, 34, 167].collect({ |freq| 101.collect{|i| sin((i/1000) * 2pi * freq)} }).plot; labelAnchors = [\topLeft, \top, \bottomLeft]; plotter.plots.do{ |plot, i| plot.drawGrid.x .labelAnchor_(labelAnchors[i]) .constrainLabelExtents_(true); }; plotter.updatePlotBounds; )

Get the value of a grid property. See -setGridProperties for a list of available properties.

Arguments:

Discussion:

As a convenience method, getGridProperty assumes that properties across all Plots are the same (as would be the case if set by -setGridProperties) so returns a single value. Alternatively, properties from individual plot grids can be collected by iterating over the plots:( // inspect the \labelAnchor of each DrawGridX var plotter = [10, 34, 167].collect({ |freq| 101.collect{|i| sin((i/1000) * 2pi * freq)} }).plot; plotter.plots.collect({ |plot| plot.drawGrid.x.labelAnchor }).postln; )

Set whether a Rect is drawn around the boundary of the grid. Setting to false disables any bounding grid lines (including "base" lines).

Arguments:

Discussion:

In some cases, the GridLines of the grid will not fall on the minimum or maximum of it's spec's range. Using -drawGridBaseLines or -drawGridBoundingRect will give the appearance of grid lines at the lower end ("base") of the grid, or at both ends of the grid, respectively.

Set whether a line is drawn at the lower extent of the grid axes. Setting to false disables any bounding grid lines (including a bounding Rect). See also the Discussion in -drawGridBoundingRect.

Arguments:

Set or get the spec for the y-axis (codomain).a = { (40..3000).scramble }.dup(2).plot; a.specs = \freq.asSpec;

See also the Explicit domain and axis specs example below.

Set or get the spec for the x-axis (domain).a = { (40..300).scramble }.dup(2).plot; a.domainSpecs = \freq.asSpec;

See also the Explicit domain and axis specs example below.

Discussion:

When setting your Plotter -value, the default domainSpecs is a linear spec in the range [0, value.size-1] (i.e. the indices of the values). Therefore, your values are displayed as evenly sampled between the minval and maxval, unless you have explicitly set the -domain values.

If a new -value is set, you will need to update your domainSpecs.

Set/get the x-axis positions of your data points. The size of the domainArray must equal the size of your -value array, i.e. a domain value specified for each data point.( var data, domain, plot; domain = 25.collect({rrand(0, 50)}).sort; data = domain.linlin(0, 50, 0, 1); plot = data.plot.plotMode_(\points); plot.domainSpecs_([0, 50].asSpec); plot.domain_(domain); )

See also the Explicit domain and axis specs example below.

Discussion:

Domain values are mapped into the range of the -domainSpecs, so need not be evenly distributed. If -domain is set to nil, your values are displayed as evenly sampled between the minval and maxval of the -domainSpecs.

Currently, for multichannel data plots, it's assumed that all channels of data share a single -domain. I.e. domainArray must be an Array of rank 1.

If a new -value is set, you will need to update your -domain.

Set the minimum number of pixels between data points (default: 1)// Changing plot resolution (x-axis) p = 5000.collect({ |i| sinPi(i * 0.0025) }).plot; p.resolution_(5).refresh; // 5px p.resolution_(10).refresh; p.resolution_(50).refresh; // undersampled p.resolution_(1).refresh; // default

Return or set the data values. Data may be numerical arrays of up to 3 dimensions.a = [1, 4, 2, 7, 4].dup(2).plot; a.value;

Set the data values, with additional arguments determining how the plot is updated.

Arguments:

If true, specs are derived from new data (using min and max values) automatically. Default: true.

Reference to the current internal data (with shape up to depth of 3).

If the edit mode is set to true, the data may be edited via cursor.a = (0..20).plot; a.editMode = true; // now edit the data by clicking into the plot.. a.value; // the updated values

Supply a function which is evaluated when editing data. The function is called with the arguments: plotter, plotIndex, index, val, x, y.

Discussion:

Example:( a = { (0..10).scramble.normalize }.dup(2).plot; a.editMode = true; a.editFunc = { |...args| args.postln }; ) // using plotter as a control interface ( a = { (0..10).scramble.normalize(300, 400) }.dup.plot; a.specs = \freq; a.plotMode = \bars; a.editMode = true; x = { var phase = SinOsc.ar(\rate.kr(a.value[1])); SinOsc.ar(\freq.kr(a.value[0]), phase).mean * 0.1 }.play; a.editFunc = { |plotter, plotIndex, i, val| x.setn(\freq, a.value[0]); x.setn(\rate, a.value[1]); }; a.parent.onClose = { x.release }; )

Returns: