delete_axis

Context: axes

Syntax

delete_axis()
delete_axis( [ChipsId] )
delete_axis( "axis_id" )
delete_axis( "all" )

Description

Depending on the argument, the delete_axis command deletes the current axis, the axis indicated in a ChipsId structure or by the axis_id, or all axes.

(no argument) - the current axis is deleted.
ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
axis_id - identification tag given to each object that is created; use this to delete a specific axis.
all - deletes all axes.

An axis cannot be deleted if it has any associated objects, such as a line or a curve. As shown in the examples, the associated object must be deleted before the axis may be removed.

Example 1

chips> add_curve([-23,4,15],[10,8,11])
chips> delete_curve()
chips> delete_axis()

Create a curve. Delete the curve, then delete the axes.

Example 2

chips> add_plot(.6, .6, .9, .9)
chips> add_curve([-4,0,4],[0,5,10])
chips> add_plot()
chips> x = np.arange(-4,4)
chips> add_curve(x, x**2)
chips> current_plot("plot1")
chips> delete_curve()
chips> id = ChipsId()
chips> id.axis = "ax1"
chips> delete_axis(id)

Two plots are created, each containing a curve, then the first plot is set as current. The id.axis command sets the axis value of the ChipsId structure to the x-axis of the first plot. The curve is deleted, then the axis is deleted.

Example 3

chips> id = ChipsId()
chips> add_plot(.6, .6, .9, .9)
chips> add_curve([-4,0,4],[0,5,10])
chips> add_plot()
chips> x = np.arange(-4,4)
chips> add_curve(x, x**2)
chips> current_plot("all")
chips> delete_curve("all")
chips> delete_axis("all")

Two plots are created and both made current. The curves are deleted, then the delete_axis command deletes all the axes.

Bugs

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