This backend is based on the 2D graphics package Grace (available at http://plasma-gate.weizmann.ac.il/Grace). The connection with Python is handled by the grace_np.py module written by Michael Haggerty. This module is available in the pygrace module by Mike McKerns (see http://www.its.caltech.edu/~mmckerns/software.html). Only curve plotting is currently available. However, histograms and pie charts might be added in the future. The Grace backend can be used by
python somefile.py –SCITOOLS_easyviz_backend grace
or one can specify the backend in the SciTools configuration file scitools.cfg under the [easyviz] section
[easyviz] backend = grace
and then
from scitools.std import *
or if just easyviz is needed
from scitools.easyviz import *
REQUIREMENTS:
Grace pygrace
Known issues:
To be able to store a copy of a plot with the hardcopy command, one must disable safe mode with the -nosafe option when running Grace. One can do this by adding the following line to GraceProcess.__init__ in grace_np.py (e.g. at line 130):
cmd = cmd + (‘-nosafe’,)
PDF output does not seem to work (at least on my configuration).
Tip:
One way to create axes at arbitrary positions is to use the axes command together with the viewport optional argument. In the Grace backend this argument should be given as the list [xmin,ymin,xmax,ymax] where (xmin,ymin) is the lower-left corner and (xmax,ymax) is the upper-right corner. An example is provided next.
>>> x = seq(-3,3,0.1)
>>> subplot(2,2,3)
>>> plot(x,x**2,'ro:2',x,8*sin(2*pi*x),'g',x,x**3,'mx')
[<scitools.easyviz.common.Line object at 0xb15645ac>]
>>> subplot(2,2,4)
>>> plot(x,x**3,'r+',title='subplot(2,2,4)')
[<scitools.easyviz.common.Line object at 0xb31596ac>]
>>> ax = axes(viewport=[0.1, 0.55, 0.9, 0.9])
>>> plot(ax,x,cos(x),'bd--',axis=[-2,4,-1,2]')
Bases: scitools.easyviz.common.BaseClass
Methods
autumn([m]) | Shades of red and yellow color map. |
axes(*args, **kwargs) | Create axes in specified positions. |
axis(*args, **kwargs) | Choose the axis limits and appearance. |
bar(*args, **kwargs) | Draw a bar graph. |
bone([m]) | Gray-scale with a tinge of blue color map. |
box(*args) | Display a box around the boundaries of the current axis. |
brighten(*args) | Brighten or darken the color map. |
camdolly(*args) | Dolly camera. |
camlight(*args, **kwargs) | Create or set position of a light. |
camlookat(*args) | Move camera and target to view specified objects. |
campos(*args) | Camera position. |
camproj(*args) | Camera projection. |
camroll(*args) | Roll camera. |
camtarget(*args) | Camera target. |
camup(*args) | Camera up vector. |
camva(*args) | Camera view angle. |
camzoom(*args) | Zoom camera. |
caxis(*args) | Set the limits for the color axis. |
cla(*args) | Clear the current axis. |
clabel(*args) | Control labeling of contours. |
clf() | Clear the current figure. |
close(*args) | Close figure. |
closefig([num]) | Close figure window. |
closefigs() | Close all figure windows. |
colorbar(*args) | Display a color bar. |
colorcube([m]) | Enhanced color-cube color map. |
colormap(*args) | Specify colormap. |
coneplot(*args, **kwargs) | Draw a 3D cone plot. |
contour(*args, **kwargs) | Draw a 2D contour plot. |
contour3(*args, **kwargs) | Draw 3D contour plot. |
contourf(*args, **kwargs) | Draw filled contour plot. |
contourslice(*args, **kwargs) | Draw contour lines in slice planes. |
cool([m]) | Shades of cyan and magenta color map. |
copper([m]) | Linear copper-tone color map. |
daspect(*args) | Change the data aspect ratio. |
figure(*args, **kwargs) | Create a new figure or switch between figures and return Figure object. |
fill(*args, **kwargs) | Draw filled 2D polygons. |
fill3() | Draw filled 3D polygons. |
flag([m]) | Alternating red, white, blue, and black color map. |
gca() | Return the current axis in the current figure. |
gcf() | Return current figure. |
getp(*args) | Get object properties or an attribute in this backend instance. |
gray([m]) | Linear gray-scale color map. |
grid(*args) | Toggle the display of grid lines. |
hardcopy(filename, **kwargs) | Save a hardcopy of the current figure to file (with the given filename). |
hidden(*args) | Toggle hidden line removal in the current axis. |
hold(*args) | Change the hold state of the current axis. |
hot([m]) | Black-red-yellow-white color map. |
hsv([m]) | Hue-saturation-value color map. |
init() | Initialize internal data structures. |
ishold() | Return the hold state (True if hold is on, and False if it is off). |
isocaps(*args, **kwargs) | Draw isosurface end caps. |
isosurface(*args, **kwargs) | Draw isosurfaces from 3D scalar fields. |
jet([m]) | Variant of hsv. |
legend(*args, **kwargs) | Add legend(s) to the current plot. |
light(**kwargs) | Add a light to the current axis. |
lines([m]) | Color map with the line colors. |
loglog(*args, **kwargs) | Draw a loglog plot with logarithmic scaling on x- and y-axis. |
m1(*args) | Add a label to the z-axis. |
m2(filename, **kwargs) | Save a hardcopy of the current figure to file (with the given filename). |
material(*args) | Set the material reflectance mode. |
mesh(*args, **kwargs) | Draw a 3D mesh surface. |
meshc(*args, **kwargs) | Draw a mesh with a contour plot beneath. |
openfig([filename]) | Load figures saved in a file (with the given filename). |
pcolor(*args, **kwargs) | Draw a 2D pseudocolor plot. |
pink([m]) | Pastel shades of pink color map. |
plot(*args, **kwargs) | Draw line and scatter plots. |
plot3(*args, **kwargs) | Draw lines and points in 3D space. |
prism([m]) | Prism color map. |
quiver(*args, **kwargs) | Draw arrows from a 2D vector field. |
quiver3(*args, **kwargs) | Draw velocity vectors in 3D space. |
savefig([filename]) | Save all current figures to a file (with the given filename). |
semilogx(*args, **kwargs) | Draw a semilog plot with logarithmic scaling on x-axis. |
semilogy(*args, **kwargs) | Draw a semilog plot with logarithmic scaling on y-axis. |
setp(*args, **kwargs) | Set object properties or attributes in this backend instance. |
shading(*args) | Control the color shading of surfaces. |
show() | Redraw the current figure. |
slice_(*args, **kwargs) | Draw volumetric slice plot. |
spring([m]) | Shades of magenta and yellow color map. |
stem(*args, **kwargs) | Draw a stem plot. |
streamline(*args, **kwargs) | Draw streamlines from 2D or 3D vector data. |
streamribbon(*args, **kwargs) | Draw stream ribbons from 3D vector data. |
streamslice(*args, **kwargs) | Draw streamlines in axis aligned slice planes. |
streamtube(*args, **kwargs) | Draw stream tubes from 3D vector data. |
subplot(*args, **kwargs) | Create axes in tiled positions. |
summer([m]) | Shades of green and yellow color map. |
surf(*args, **kwargs) | Draw a 3D solid surface. |
surfc(*args, **kwargs) | Draw a solid surface with contours beneath. |
surfl(*args, **kwargs) | 3D shaded surface with lighting. |
title(*args) | Add title to the current plot. |
vga([m]) | Windows colormap for 16 colors. |
view(*args) | Specify viewpoint. |
white([m]) | All white color map. |
winter([m]) | Shades of blue and green color map. |
xlabel(*args) | Add a label to the x-axis. |
xlim(*args) | Set or get limits on x axis. |
ylabel(*args) | Add a label to the y-axis. |
ylim(*args) | Set or get limits on y axis. |
zlabel(*args) | Add a label to the z-axis. |
zlim(*args) | Set or get limits on z axis. |
Create a new figure or switch between figures and return Figure object. num is the figure number of the new or existing figure.
Save a hardcopy of the current figure to file (with the given filename). The file format (image type) is determined from the extension of the filename. If any changes have been made by working directly on the backend instance, set the keyword argument replot to False to stop Easyviz from replotting the current figure and destroying those changes.
Supported extensions in the Grace backend:
‘.ps’ (PostScript) ‘.eps’ (Encapsualted PostScript) ‘.pdf’ (Portable Document Format) ‘.agr’ (Grace file format) ‘.jpg’ (Joint Photographic Experts Group) ‘.png’ (Portable Network Graphics) ‘.pnm’ (Portable Any Map) ‘.svg’ (Scalable Vector Graphics) ‘.gmf’ (Graphics Meta File) ‘.mif’ (Maker Interchange Format)
Optional arguments:
Add a label to the z-axis.
Calling:
zlabel(s)
adds the text given in s beside the z-axis on the current axis.
Calling:
zlabel(ax, ...)
adds the zlabel to the Axis object ax instead of the current axis.
Save a hardcopy of the current figure to file (with the given filename). The file format (image type) is determined from the extension of the filename. If any changes have been made by working directly on the backend instance, set the keyword argument replot to False to stop Easyviz from replotting the current figure and destroying those changes.
Supported extensions in the Grace backend:
‘.ps’ (PostScript) ‘.eps’ (Encapsualted PostScript) ‘.pdf’ (Portable Document Format) ‘.agr’ (Grace file format) ‘.jpg’ (Joint Photographic Experts Group) ‘.png’ (Portable Network Graphics) ‘.pnm’ (Portable Any Map) ‘.svg’ (Scalable Vector Graphics) ‘.gmf’ (Graphics Meta File) ‘.mif’ (Maker Interchange Format)
Optional arguments: