Ahelp: set_plot - ChIPS 4.1

Description

id - an optional ChipsId structure containing values to modify the currency state for the command or a string id to modify the specified plot.
values - a list containing attribute value pairs or a ChipsPlot object.

The set_plot command sets the specified attributes to the provided values. The modified plot becomes current. Multiple plots may be modified with a single command by setting the currency to "all".

There are several attributes that control the characteristics of plots. The set_plot command may be used to modify the attribute values of an existing plot at any time during a ChIPS session. See "ahelp attributes" and "ahelp setget" for more general information.

If multiple attributes are being set simultaneously and one of them fails, the entire command will fail and the plot will not be modified.

The attributes associated with plots are:

Attribute	Description	Options	Default
bottommargin	The distance, in Frame Normalized coordinates, between the bottom plot border and the bottom border of the frame containing the plot	Real values ranging from zero through one	0.15
corner.style	border corner style	miter\|bevel\|fill\|notch; see below for descriptions	miter
leftmargin	The distance, in Frame Normalized coordinates, between the left plot border and the left border of the frame containing the plot	Zero through one	0.15
rightmargin	The distance, in Frame Normalized coordinates, between the right plot border and the right border of the frame containing the plot	Real values ranging from zero through one	0.10
style	border style	open\|box\|closed; see below for descriptions	closed
title.angle	Angle at which the plot title is drawn	-360.0:360.0	0.0
title.color	Color of the plot title text string	name or hex; see the Color section of "ahelp chipsopt"	white
title.depth	Integer value indicating the depth of the plot title	see the Depth section of "ahelp chipsopt"	100
title.font	Plot title font	helvetica\|courier\|times\|greek; see the Font section of "ahelp chipsopt"	helvetica\|courier\|times
title.fontstyle	Specific attributes of the text string independent of size or font	normal\|bold\|italic\|bolditalic; see the Font Style section of "ahelp chipsopt"	normal
title.halign	Horizontal location of the string reference point of the plot title	auto\|base\|center\|left\|right\|top; see the Text Alignment section of "ahelp chipsopt"	center
title.size	Font size of the plot title	1:100	16
title.valign	Vertical location of the string reference point of the plot title	auto\|base\|center\|left\|right\|top; see the Text Alignment section of "ahelp chipsopt"	auto
title.xpos	X position, in Frame Normalized coordinates, of the reference point of the plot title	Real values ranging from zero through one	0.5
title.ypos	Y position, in Frame Normalized coordinates, of the reference point of the plot title	Real values ranging from zero through one	1.05
topmargin	The distance, in Frame Normalized coordinates, between the upper plot border and the upper border of the frame containing the plot	Real values ranging from zero through one	0.10

Plot Titles and Axis Labels

The plot title and axis labels are not controlled by an attribute of the set_plot command. They are specified with the set_plot_title, set_plot_xlabel, and set_plot_ylabel commands:

set_plot_title("Figure 1");
set_plot_xlabel("TIME (s)");
set_plot_ylabel("COUNT\\_RATE (count/s)");

The value is an alphanumeric string; Latex formatting is allowed. There are many attributes to customize the title via the set_plot command: position, depth, horizontal and vertical alignment, angle, color, size, font and fontstyle.

The set_axis command is used to change the color, font, size, and alignment of the labels: "ahelp set_axis"

Plot Borders

Plot borders have three styles: open, box, and closed.

open: a plot with no borders
box: a plot with four simple lines as borders
closed: a plot with four border lines and tick marks

The corners where two lines meet have four styles: miter, bevel, fill, and notch.

miter: the end of the axes meet at an angle to form the corner. The slope where the two faces join depends upon the thickness of the two lines
bevel: connect the outside corners of the two lines; miter the inside faces to the bevel
fill: outside corner with one line drawn over the other
notch: leave the corners open

Advanced Functions

The module of advanced ChIPS functions contains other commands for setting attribute values (refer to "ahelp chips" for information on loading the module):

set_plot_axisstyle
set_plot_bottommargin
set_plot_cornerstyle
set_plot_leftmargin
set_plot_rightmargin
set_plot_title_angle
set_plot_title_color
set_plot_title_depth
set_plot_title_font
set_plot_title_fontstyle
set_plot_title_halign
set_plot_title_size
set_plot_title_valign
set_plot_title_xpos
set_plot_title_ypos
set_plot_topmargin

set_plot

Synopsis

Syntax

Description

Customizing the Plot

Plot Titles and Axis Labels

Plot Borders

Advanced Functions

Example 1

Example 2

Example 3

Bugs

See Also