clear_plot

Context: plots

Synopsis

Delete the contents of the plotting area.

Syntax

clear_plot()
clear_plot(id)

Description

The function arguments.

Argument	Description
id	A ChipsId structure identifying the item, or a string containing the name of the object.

The clear_plot command deletes all contents of the specified plot(s) - axes, curves, contours, histograms, and plot titles. The border axes which define the edge of the plot area are not removed.

Examples

Example 1

chips> add_curve(range (10), range (10))
chips> add_histogram([1,2,3], [4,5,6], 'id="my hist"')
chips> add_label(1,8, 'Curve and Histogram')
chips> add_label(.1,.9, 'New Curve')
chips> clear_plot()

Create a number of objects, then clear the plot area.

Example 2

chips> split(3,3,.1,.1)
chips> current_plot('all')
chips> add_contour([1,4,5,2],2,2)
chips> clear_plot('plot5')

Create a 3 by 3 grid of plot areas and add the contour to all of them. The center plot area ("plot5") is cleared by the clear_plot command.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.