Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/chips/ahelp/clear_plot.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.11 ChIPS v1

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.

See Also

limits
get_plot_range
plots
add_plot, adjust_grid_gaps, adjust_grid_xrelsize, adjust_grid_xrelsizes, adjust_grid_yrelsize, adjust_grid_yrelsizes, current_plot, delete_plot, display_plot, get_plot, grid_objects, hide_plot, move_plot, reposition_plot, set_data_aspect_ratio, set_plot, set_plot_aspect_ratio, split, strip_chart, swap_object_positions