"Matlab-like"
Plotting library for Scilab
The Plotlib is distributed under the GNU General Public License
|
Don't forget to checkout the homepage of the XMLlab project, at
|
Here is the archive for Plotlib version 0.21.
You must use it with scilab >= 4.1.2 (previous versions are not supported)
Linux/Unix users : plotlib021.tgz
Windows users : plotlib021.zip
These files and older version can also be found here. The Plotlib help files are there.
Please don't forget to leave an evaluation of the plotlib at the Scilab's Contribution Page.
Version 0.21 (Wen May 27 23:35:00 CEST 2009) Second draft with english help files in xml. For Scilab < 5 the old plain text help files are used. Version 0.2 First draft of the plotlib working with the new graphics and Scilab 5 Version 0.198 Idem with the Pos driver. Version 0.197 Improvements to allow the complete use of the plotlib with the GIF and PPM driver. Be aware that with theses drivers there is no multi-window manadgement. The recommended version of Scilab is Scilab 4.1. Version 0.196 (Mon Apr 24 17:38:30 CEST 2006) Slight changes for Scilab 4.0 compatibility. Version 0.195 (Wed Jun 8 14:44:06 CEST 2005) 'ticksX','on|off|none'
'ticksY','on|off|none'
in
2d plots : used to turn on or off the ticks and ticks labels on X
and/or Y axis.
Version 0.194 (Mon May 23 16:32:25 CEST 2005)
Added a new function :
bar
: draws vertical bargraph. Type help bar to see usage and examples.
Changed the plotlib0nnn-install folder to "plotlib"
(will keep this for future versions also). The version number can be
found as usual in the file macros/VERSION.
Version 0.193 (Thu Apr 21 09:41:53 CEST 2005)
Fixed a problem with font size
calculation by the function
xstringl with Helvetica font under
windows. Update of the
README file to explain the new location of
the .scilab
startup file since Scilab-3.1-rc1.
Version 0.192 (Mon Mar 14
18:13:17 CET 2005)
Implemented some changes initially
devoted to the future
0.2 release. The plotlib still uses the Old
graphics
mode for *performance* reasons.
1-Better
legends
labels remain centered when resizing the window,
and
spacing is better computed).
2-A new low level function for
better Matlab compatibility
fill(X,Y,C)
draw some 2D
polygons arranged in columns : i'th polygon
has coordinates
X(:,i),Y(:,i) and color(s) C(i) or C(:,i)
if each vertex has a
color (to do e.g. interpolated shading).
3-New properties
related to shading (2D and 3D)
You can now use the following
properties/values :
'facecolor','flat'
'facecolor','interp'
->
changes the shading type but does not change the
edgecolor. You
can now have interpolated shading+edges
(type trisurfl for an
example).
* The 'shading','interp' property/value pair
is still valid
and is equivalent to
'facecolor','interp','edgecolor','none'
* The
'shading','faceted' property/value pair is still valid
and
is equivalent to
'facecolor','flat'
* The 'shading','flat' property/value pair is still valid
and is equivalent to
'facecolor','flat','edgecolor','none'
4-Other properties
related to shading (3D)
For macros :
surf,trisurf,surfl,trisurfl
'backfacecolor',[r,g,b] -> the
backfaces are painted with color [r,g,b]
'backfacecolor','none'
-> the backfaces have the same color as the
front
faces
'backfaceculling','yes|no' -> backfaces are|are
not painted
For macros :
surfl,trisurfl
'backfacelighting','lit' -> equivalent to
'backfacecolor','none'
'backfacelighting','unlit' -> equivalent
to 'backfacecolor',[r,g,b]
where [r,g,b] is the "mean"
color of the RGB colormap.
5-Other changes
New 'jet'
value for the colormap property/function
"colormap
jet"
Version 0.19 (May 18 10:00:00 EST 2004)
Slight
modifications to fit the new version of Scilab (3.0RC1).
Version 0.18 (Mon Nov 10 10:13:31 EST 2003)
Bugs fixes (see the BUGS file).
Version 0.18b1 (Thu Mar 6 15:14:18 EST 2003)
New installation system, with
the two scilab scripts
builder.sce/loader.sce (see the README
file).
Version 0.17 (Thu Jul 18 16:11:46 CEST 2002)
MAJOR ISSUES
- Bug fixes :
Behaviour of legends and
labels when zooming was
really strange. Now everything remains
OK, after a
rewrite of some functions (process2DPrelim.sci,
processLegend.sci, processColorbar.sci, ...).
Colorbars were drawn only
after a window redraw event
(Windows version bug).
- New property for figures : the margin (relative length). Eg
figure('margin',0) defines no
margin and the "plot box" occupies
all its (sub)window.
Issue a
--> fig('margin',0);plot()
to figure out how this
property can be used. The default margin
is 0.1. The maximum
value is obviously 0.5.
- New value for the property
'axis' : now with 'axis','off' no
surrounding box is drawn (use
'axis','box' for this). This can be
usefull when you are using a
zero margin (see above)
MINOR ISSUES
The state of 0.17 is no longer
"beta". I didn't write the documentation
anyway, but
somebody did it better than I could have done myself. This
documentation is at the URL :
http://www.engineering.usu.edu/cee/faculty/gurro/Scilab.html
Version 0.17b3 (Wed Feb 20 17:02:16 CET 2002)
This version fixes a few bugs,
but I don't remember everything
I did, but the following problems
are fixed :
- problems of plots getting
outside the plot box when zooming.
- problems when exporting
figures with subplots to eps in color (only
the last plot was
visible on the eps file, because Scilab-2.6 now
takes into
account the background color in eps exports).
Version 0.17b2 (not diffused)
Version 0.17b1 (Thu Mar 15 15:57:47 CET 2001)
This version uses many of the
new features of Scilab 2.6.
The state will remain 'beta' until
the documentation
will be ready...
MAJOR ISSUES
- New colorbar positions (left, right, top, bottom (or bot))
- plot(x,f) where f is a
function with the syntax y=f(x)
or [x,y]=f(t);
- New values for the
color/marker string in 2D plots :
the strings '--' and '-.',
which can be combinated with
other usuals characters, allow to
make respectively dahsed
and dash-dot curves. Same behavior for
plot3 (curves in 3D).
- New 'axis' property values
in 3D functions (plot3,mesh, surf, ...) :
* 'equal
(isometric plot)
* 'vis3d' (isometric/non expanded
plot)
* 'box' (only the box without captions)
*
'trihedral' (only the 3 small x/y/z axis)
- New allowed values for the 'view' property. When you specify
'view',V
if V is a 2
x N matrix, then the graph is being represented
successively for the view points V(:,i), i=1:N.
- New 'axis' property values
in 2D plot functions (plot, pcolor, tripcolor)
* 'left' (the y axis is displayed on the left)
* 'right'
(the y axis is displayed on the right)
* 'center' (the x
and y axis cross at the center of the plot box)
* 'origin'
(the x and y axis cross at the (0,0) point)
- New property for 2D plots
'grid', with the possible values
* 'on' or 'off'
*
a 3-vector giving the color in RGB coordinates.
- Support of list arguments in plot, mesh, ... Example :
-->
myOptions=list('background',[0 0 1],'axis','equal');
-->
t=0:10; plot(t,sin(t),myOptions)
the list is expanded while the
argument list is parsed, so
that the above line is equivalent to
--> t=0:10; plot(t,sin(t),'background',[0 0 1],'axis','equal')
MINOR ISSUES
- Now the 'xlabel', 'ylabel'
and 'title' can be used as properties
in 2D plot functions. The
'title' property can be used in 3D
functions also.
- The font size used for tick
labeling and labels now depends on
the window size (it already
depended on the subplot state).
Version 0.16 (2000/12/17)
bug fixes
Essentially bug fixes
(installation under Windows
and pb with colormaps, see the BUGS
file)
Version 0.15 (2000/7/7) new
functions + man pages
New functions :
- pcolor() and tripcolor() :
pseudo-color 2D
plot of rectangular or non-rectangular or
triangulation-based
patches. These new function will support
interpolated shading
with the next version of Scilab
- whitebg() : to set the
default color scheme of figures. This
function existed for a
while, but was not documented in the
man pages (now it is).
- caxis() : to set the color scale of pseudocolor plots
- colormap() : to set the
colormap of pseudocolor plots. Was
mentionned in the man list but
the man page was absent (this
has been fixed)
various Improvements :
- the man pages for
trimesh/trisurf/trisurfl has been
improved. Now calls like
trimesh() produce a demo plot,
where the data are loaded from the
file
SCI/macros/plotlib/tridem.dat
- A few bugs fixes
Version 0.14 (2000/5/18)
automated installation
Automated installation via
script
files.
Version 0.13 (04/05/2000)
support for interpolated shading
- Added the property "hidden"
for the mesh macro
The possible values are 'on' and 'off'. This
allows to do fast wire frame
rendering
- Added support for the modified version of plot3d1 (interpolated shading)
In the macros surf, surfl,
trisurf,
the property 'shading' can now take the value 'interp'.
If your version
of plot3d1 does not support interpolated shading
then an error message is
given (should it be a warning ?).
To allow interpolated shading
in plot3d1, you need to recompile scilab by
patching some files :
SCI/interf/matdes.f
SCI/routines/graphics/Plo3d.c
SCI/routines/graphics/Rec.c
SCI/routines/graphics/RecLoad.c
SCI/routines/graphics/RecSave.c
The patched/enhanced files can be find at the URL
http://www.dma.utc.fr/~mottelet/plotlib-related/patches
All the added code is
driver-independent and so
the modifications apply for any driver
(X11, Pos,
Xfig, GIF, ...). For those who are familiar with
the
source, all the modification are quoted and
well commented (to
find the modified stuff, look
for the string "polpoth"
-that's my nickname- in
the above mentioned files).
The code is not optimal, but
the rendering
speed is more than correct, compared to what could
have been done with a sci macro.
Version 0.12 (04/02/2000) support for triangular mesh
- Added 3 new functions, for
plotting surfaces based on a triangulation : trimesh,
trisurf and
trisurfl. The syntax is like in Matlab, and all the property/value
settings are the same as for mesh, surf and surfl.
Version 0.11 (01/13/2000)
- I added 'xlabel', 'ylabel ' and 'zlabel' properties for surf, mesh, surf and plot3d.
Version 0.1 (10/14/99) : a bunch of new stuff
- Many rewriting and bug
fixes, a big effort on documentation (help .cat files). Now
each
function is in a separate .sci file. The new release makes use of
global variables
so you have to upgrade to scilab 2.5
- New functions (now some help can be obtained for all functions)
legend() (for 2D plots)
xlabel(), ylabel(), title()
3D enhanced functions :
plot3(), mesh(), surf(), surfl()
with the classical Matlab
syntax, and with the possibility of giving
the surface values by
a function (type help mesh).
'colorbar' (a property name for the above functions)
colormap()
to change the colormap of 3D
plots.
Version 0.05 (04/22/99) : new functions
- I have added some functions to make plots with a log scale
semilogx()
semilogy()
loglog()
The syntax is the same as the function plot() i.e. try the commands
w=logspace(-1,2,500);
s=%i*w;
g=1../(s+1); g2=1../s;
loglog(w,abs(g),w,abs(g2))
- I have also added the function
gcf()
which returns the number of the current active window.
Version 0.04 (03/30/99) : new functions
- I have added a hold() function. Can be used with the arguments `on' or 'off' like this
hold on
hold off
or without arguments
hold()
in this case the hold state toggles between on and off.
- xlabel(string)
Puts a label below the X -
axis. You may wonder why I did not do something
for the Y - axis
: the problem is that the angle modifications which are posssible
in
the xstring macro affect *each* character, and not the whole string !
The result
is unreadable (to me). Until now, I dit not find a
solution.
- axis()
This function in only callable without arguments. The call
vect=axis()
returns the current axis limits with the Matlab convention i.e.
vect=[xmin xmax ymin ymax]
Version 0.03 (03/24/99) : some crucial ameliorations (printing)
- The printing problem has
been fixed. Now printing and exporting in
b/w mode produces
correct results.
- Pretty axis graduations is
now the default mode. It can be deactivated
by an 'axis','tight'
clause in a plot command.
- New markers 't' for trefoil and 'f' for filled diamond
- New functions :
- delete()
or delete(win) for properly deleting a window.
- title(string) to add a title to the graph.
Version 0.02 (03/23/99) :
many bug corrections and ameliorations.
- Matlab look and feel with a
``fancy frame'' around the plot.
- No need to call initCmap() any
more at startup. New colors are added
automatically with
the scilab command ``addcolor()''. Anyway you still
have
to call graphinit() once at startup (see below)
- New syntax for graphinit :
graphinit()
graphinit('whitebg')
graphinit('blackbg')
The choice 'whitebg' or
'blackbg' determines the default background/foreground
combination,
black/white for 'blackbg' and white/black for 'whitebg'. The switch
can be done later with the functions whitebg() and blackbg()
- New functions (with call example)
fig() : creates/activates a
window
fig('background',[0 0 1],'foreground',[1 1 0])
fig('colormap','hot')
fig('colormap',[0 0 0;1 1 1])
fig(winNum)
fig(winNum, 'background',[0 0 1],'foreground',[1
1 0])
Properties can be changed
after window creation
Version 0.01 (03/19/99) :
initial release
Don't expect all this to work
if you don't call graphinit()
once at the beginning of your
session. You have also to call
initCmap() each time you
create a new window in order to get
the correct colors when
you specify it in plot() call.
Like in matlab the function
plot() can accept any number of input arguments. The
usual way is
to use pairs or triples. Here is an example session :
graphinit()
initCmap()
t=linspace(0,2*%pi);
plot(t,cos(t),t, sin(t))
plot(t,cos(t),'r',t,sin(t))
: red line for the cos
plot(t,cos(t),'ro',t,sin(t),'y^-') :
red dots for the cos and yellow
triangles + solid line for the sin
plot(t,[cos(t);sin(t)])
: color cycling is like in matlab
plot(cos(t),sin(t),'axis','equal')
: example of property/value setting
plot(cos(t),sin(t),'axis',[0
1 0 1]) : another example the axis vector is
[xmin xmax ymin ymax]
plot(t,cos(t),'3r') :
red line, set the linewidth to 3.
Linewidth up to 9 are allowed.
You can also experiment the subplot() function :
subplot(2,1,1);
plot(t,cos(t))
subplot(2,1,2); plot(t,sin(t))
You can also use the
clf() function to properly clear a graphic
window.
I have made a big effort
to produce explicit error messages when the function
detects
something wrong in the argument list, so don't be affraid to test
any combination of couple, triples and property/value pairs
that seems
correct. Feel free to report me any bugs and/or
sugggestion
////////////////////////////////////////////////////////////////////////////////
//
// available markers // available colors (in cycling order)
//
//
// 'o' circle // 'y'
yellow
// '+' plus
// 'm' magenta
// '*' star
// 'c' cyan
// 'd' diamond //
'b' blue
// '^' up triangle // 'g' green
// 'v'
down triangle // 'r' red
// '.' dot
// 'w' white
//
// 'k' black
//
//
////////////////////////////////////////////////////////////////////////////////