Command comparison: SM to ChIPS 4

relocate x y
angle 45   
dot
angle 0

relocate x y
angle 45   (for label)
putlabel 5 text
angle 0

add_point( x, y, "angle=45" )
add_label( x, y, text, "angle=45" )

axis xmin xmax dx_small dx_big gx gy glen ilabel iclock
   dx_small < 0  log  dx_small = 0 default
   ilabel = 0  no labels
            1  para axis
            2 perp axis
            3 no labels and no ticks

   iclock = 0 1 ticks perp
            2 3 ticks vert
            4 5 ticks hor
   (notation -8 8 -8 8)

ChIPS doesn't have a way to just draw a single axis with ticks, etc. The axis is tied to a coordinate system and drawn over the whole plot area.

For example, to draw a log X-axis with spacing 2 between the big ticks and 0.2 between the little ticks, starting at global coordinate gx, gy with length glen:

  gx2= gx + glen
  add_plotarea( gx, gy, gx2, 1.0 )
  add_axis( X_AXIS, 0, xmin, xmax, "majortick.interval=2.0
   minortick.mode=interval minortick.interval=0.2
   tickformat=%f" )
  log_scale(X_AXIS)

box
box i1 i2 i3 i4

There is no equivalent command.

connect x y

add_curve( x, y )

ctype blue

....( ..., "color=blue" )
e.g.  add_line( x1, y1, x2, y2, "color = blue" ) 

However, the add_curve command requires

add_curve( x, y, "line.color=blue" )

cursor x y

cursor = get_pick(0)

x = cursor[0]
y = cursor[1]

data myfile
read { x 1 y 3 z 12 }

file = read_file( "myfile" )
x = get_colvals( file, 0 )
y = get_colvals( file, 2 )
z = get_colvals( file, 11 )

Note that ChIPS is 0-based, so the columns are off by 1 from SM, and that you can also use the column name instead of the position in the get_colvals call.

label $date

from time import ctime
add_label( x, y, ctime())

dev x11
dev postfile myfile.eps

ChIPS plots to an X11 window by default. It remembers the plot you made, and the print_window command can be used to create a postscript (or jpg, etc) file of the plot.

If you just want to make a postscript file without displaying anything, switch off the ChIPS display:

set_preference( "window.display","false" )
(... plotting commands ...)
print_window( "myfile", "format=eps" )

dot

add_point( x, y, "style=cross" )

relocate x1 y1
draw x2 y2

add_line( x1, y1, x2, y2 )

erase

erase()

errorbar x y e iopt

The "errors" context defined in the setup file is used here.

To add vertical error bars:

add_curve( x, y, e, errors )

To plot horizontal error bars (with no vertical error bars) a list is passed to the command:

add_curve( x, y, [None,None,e,e], errors )

The values "[None,None,e,e]" are the vectors for up, down, left and right errors respectively.

expand 3

A factor of 12 is about right to convert between SM and ChIPS sizes, so 36 (12*3) is used:

add_point( x,y, "size=36")
add_label( x, y, "My label text", "size=36" )
add_axis( x, y, ...., "label.size=36 ticklabel.size=36" )

format xstring ystring

add_axis( ...., "tickformat=%f" )

SM accepts formats in Fortran or C style, but ChIPS accepts only C style: thus use "%6.2f" instead of "F6.2".

grid i j

add_axis( ..., "majorgrid.visible=true minorgrid.visible=true" )

hist x y

Draws in histogram style. (Do not confuse this with the get_hist macro which builds the histogram; this is a math operation which in ChIPS you'll have to do using the NumPy histogram function).

add_histogram( x, y )

relocate x y
label text

add_label( x, y, text )

limits xmin xmax ymin ymax

The limits may be set when the axis is drawn:

add_axis( X_AXIS, 0, xmin, xmax )
add_axis( Y_AXIS, 0, ymin, ymax )

The second parameter positions the axis.

To change the limits after the axes are in place:

limits( X_AXIS, xmin, xmax )

If we define global coords x=0 to 1, y = 0 to 1, they have to be converted to 0-32767 in SM:

define gx1 (int(32767*x1))
define gx2 (int(32767*x2))
define gy1 (int(32767*y1))
define gy2 (int(32767*y2))
location $gx1 $gx2 $gy1 $gy2

add_plotarea( gx1, gy1, gx2, gy2, "id=p1" )
...(plot commands)
current_plot("global")
... do something in global coords
current_plot("p2")
... do something in another plot area you've defined
current_plot("p1")
... back to the first plot area

Note the different order of the arguments. This defines a plot area p1; the current_plot call can be repeated to go back to that area after working in a different plot.

ltype 0

add_curve( x, y, "line.style=solid" )
add_curve( x, y, "line.style=1" )
add_line( x1, y1, x2, y2, "style=solid" )

The mapping between line types is

lweight 5

add_curve( x, y, "line.thickness=5")
add_line( x1, y1, x2, y2, "thickness=5" )

notation -8 8 -8 8

There is no direct equivalent; typical use cases can be handled by

add_axis( ...., "tickformat=%f")

points x y

The "points" context defined in the setup file is used here. It is a set of options defining the size, color, and type of points and "turning off" the line which would connect them.

add_curve( x, y, points)

ptype 4 3

add_point( ..., "style=square fill=true" )

or

points.symbol.style="square"   
points.symbol.fill="true"
add_curve( x, y, points )

Note that "ptype x", where x is a vector, is not supported in ChIPS.

The point styles are:

Pentagon and hexagon are not supported.

see LABEL

quit

quit

see DATA

relocate x y
dot
relocate x y
draw x2 y2

add_point( x, y )
add_line( x1, y1, x2, y2 )

shade n x y

add_region( ... , 
  "fill.color=red fill.style=solid edge.style=noline" )