Plot/Options

Plot options and their defaults are shown below.

The defaults are set whenever you use the 'reset' or 'new' commands and are defined in script

• ~system\classes\plot\plotdefs.ijs
• ~addons\graphics\plot\plotdefs.ijs (for J8)

To customize the defaults, create a script with the same name in your config directory, i.e. with name ~config\plotdefs.ijs, and enter any changed default options. Option values are stored as uppercase global variables. For example, to default to axes without frames or grids, enter the following into your plotdefs.ijs script:

AXES=: 1
FRAME=: 0
GRIDS=: 0

Options are specified by providing the option name followed by its argument. Several options can be given at one time, separated by semicolons. For example:

pd 'title My Graph;ycaption Weight (kg);color blue,red'

Multiple character strings can be specified for options of type c such as color,key, xlabel and xcaption, using commas or spaces to delimit them. If the strings contain spaces and/or commas, enclose them double quotes first. For example:

pd 'key wool,cotton,nylon'
pd 'key "wool blanket" "cotton buds"'
pd 'xlabel "Fri, 5 Jun","Sat, 6 Jun","Sun, 7 Jun","Mon, 8 Jun"

Titles and subtitles may take more than one line, with lines separated by the line break tag <br/>. For example:

pd 'title First line (of title)<br/>Second line'

For more examples of option syntax run the Plot Demo (Studio|Demos...|plot) and view the plot definitions (Options|View Definition).

Option	Type	Default	Description
aspect	n		ratio of graphics height to width (default 1 for pie or radar).
axes	b	0 0	if x,y axes are shown (default off since plot is framed)
axiscolor	color	BLACK	axis color
backcolor	color	WHITE	background color
bandcolor	colors		band color scheme, see Plot Colors
barwidth	n	0.75	width of bar in barchart (in range 0-1)
border	b	0	if a border is drawn
bordersize	n	8	size of border (isigraph units)
boxed	b	1	if drawn in a box (3D only)
captionfont	font	Arial 13 (windows)	font for x and y captions
clear	b	1	if clear the background before drawing plot
color	colors		plot colors, see Plot Colors
contourlevels	n	20	number of levels in contour plot
edgecolor	colors	BLACK	edge color (ellipse, pie, poly, rect)
edgesize	n	1	pen size of edges
forecolor	color	BLACK	foreground color (for axes, text)
frame	b	1	if plot is framed
framebackcolor	color	[#backcolor ]	background color of frame area
framestyle	n		in=inner, out=outer frame, default based on plot type
graphbackcolor	color	[#framecolor ]	background color of graph area
gridcolor	color	GRAY	grid line color
grids	b	1 1	if x, y grids are shown
guidesize	n	1	pen size of guides (axes and tic marks)
itemcolor	colors		item color scheme, see Plot Colors
key	c	[#none ]	key legend, see Plot Keys
keycolor	colors		key color scheme, see Plot Colors
keyfont	font	Arial 9	key font
keypos	c	lti	key position, see Plot Keys
keystyle	c	lbvt	key style, see Plot Keys
labelfont	font	Arial 9	font for labels
labels	b	1 1[1]	if x,y[,z] labels shown
markers	c		markers (diamond square circle triangle plus times)
markersize	n	1	marker size
mesh	b	1	if a mesh is drawn (3D only)
output	c	isi/gtk/pdf	output used by plot or pd 'show'
orientation	n	2	1=portrait, 2=landscape (printing only)
originxlabel	n	0	if show 0 label at axis intersection
penpattern		see plotdefs	patterns used by pen styles
pensize	n	1	pensize for lines, other than edges and guides
penstyle	n	0	index into penpattern
piepercent	n	0 [#none ]	set default pie labels as percentages
plotcaption	c	Plot	plot form caption
polar	b	0	if a polar plot, data is r;theta (2D only)
printmargin	v	1440	print margins in twips - left,top,right,bottom (default is 1 inch -- A twip is a "twentieth of a point". A point is approximately 1/72 of an inch and in computer systems a twip is considered to be exactly 1/1440 of an inch)
printwindow	v	0 0 1000 1000	print window, bottom left, top right
rtic	v	[#none ]	r tics (#major,#minor) (radar plot only)
rulecolor	color	BLACK	rule color
rulesize	n	1	rule size
separator	c		separator for char matrix entries
singtoler	n	10	singularity tolerance for function plots
subtitle	s	[#none ]	subtitle text
subtitlecolor	color	BLACK	subtitle color
subtitlefont	c	Arial 14	subtitle font
symbolcolor	colors	BLACK	symbol color
symbolfont	font	Symbol 9	symbol font used in point plots
symbols	c		symbols (square triangle inverted-triangle clubs diamonds hearts)
textcolor	color	BLACK	text color
textfont	c	Arial 13	font for output from text commands
ticmajor	n	12	size of major tic marks
ticminor	n	8	size of minor tic marks
tics	v	1 1[1]	if x,y[,z] tic marks shown
ticstyle	c	in	in=inner out=outer tics
title	s	[#none ]	title text
titlecolor	color	BLACK	title color
titlefont	c	Arial 15	title font
type	c	line	plot type (see Plot Types)
viewcenter		0 0 0	position of plot center (3D only)
viewpoint		1.6 _2.4 1.5	position of observer (3D only)
viewsize		1 1 0.5	relative sizes of viewbox
viewup		0 0 1	upwards direction (3D only)
visible	b	1	if plot is displayed
xcaption*	c	[#none ]	x caption (the text shown along the axis)
xgridpattern*		3 5	x grid pattern
xgroup*		[#none ]	x group (multiplot only)
xfuncres*	n	[#none ]	x resolution for function plots
xint*	n	[#none ]	position of x-intercept
xlabel*	c	[#none ]	x labels (one label per tic position)
xlog*	n	0	if log applied to x values
xrange*		[#none ]	range of x data - low,high
xtic*		[#none ]	x tic - (major interval),minor count
xticpos*		[#none ]	x tic positions

^*Options whose names begin with 'x' apply to the x-axis; similar options apply to the y and z axes.

Type	Description
b	boolean 0 or 1
c	character string
color[s]	color or color matrix - given by name or values
font	font specification
n	number
s	character string, or -delimited strings
v	numeric list