limits

limits([ChipsId,] dimension, min, max)
limits([ChipsId,] dimension, object, ChipsId)
limits([ChipsId,] object, id)

Description

• ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
• dimension - operate on axis in X dimension (X_AXIS), Y dimension (Y_AXIS), or both (XY_AXIS).
• min - the minimum value for the axis range; "AUTO" tells ChIPS to determine the minimum
• max - the maximum value for the axis range; "AUTO" tells ChIPS to determine the maximum
• object - if snapping to an object, which object should be used (e.g. chips_curve, chips_contour, chips_histogram).
• id - the string id of the object to use for the snap.

The limits command sets the axes ranges for the x and/or y dimensions of the current plot. There are three ways to specify the limit values:

• user inputs the minimum and/or maximum values
• the keyword "AUTO" or string "auto" is used for the min and/or max, telling ChIPS to calculate that value based on the data
• set the limits to match a particular curve, contour, or histogram that exists in the figure

If the minimum value is greater than the maximum value, ChIPS automatically transposes them.

When the limits of an axis are changed, any axes that are bound to that axis are also changed, including plot border axes; see "ahelp bind_axes" for more information. The automin and automax properties of the modified axis are disabled as well when it is altered by a limits command. Reenable the automin and automax properties of the axis so that it will automatically rescale when new objects are added; see "ahelp set_axis" for more information.

The pick_limits call ("ahelp pick_limits") allows you to change the limits of a plot interactively.

chips> limits(XY_AXIS, AUTO, 100)

chips> split(2,1,0.1)
chips> add_curve([1,7,9],[2,3,1])
chips> current_plot("plot2")
chips> add_curve([5,10,15],[25,50,55])
chips> limits(X_AXIS, 5, 10)
chips> current_plot("plot1")
chips> limits(X_AXIS, 5, 10)

chips> add_curve([40,50,60], [50,40,60], "line.color=red")
chips> add_curve([50,60,70], [50,60,70]," line.color=gold")
chips> limits(chips_curve, "crv1")
chips> limits(Y_AXIS, chips_curve, "crv2")

chips> limits(X_AXIS, 4, 10)
chips> set_axis(["automin", True, "automax", True])
chips> add_curve([-23,4,15], [10,8,11])