1README for SciPlot Widget, version 1.3 2Robert W. McMullen <rwmcm@orion.ae.utexas.edu> 320 Feb 1996 4 5 6OVERVIEW 7 8The SciPlot Widget is a widget capable of plotting cartesian or polar graphs, 9including logarithmic axes in cartesian plots. The widget is subclassed 10directly from the Core widget class, which means that it does not depend upon 11any other widget set. It may be freely used with Athena, Motif, or the 12Open Look/Xview widget sets. (There is optional Motif support that causes 13the widget to be subclassed from XmPrimitive. See the man page.) 14 15Features provided in the widget include automatic scaling, legend drawing, 16axis labeling, PostScript output, multiple plotted lines, color support, user 17font specification, dashed lines, symbols drawn at points, logarithmic scales 18on one or both axes in cartesian plots, and degrees or radians as angles in 19polar plots. 20 21 22SOURCE LOCATION 23 24Source code for the SciPlot Widget is available via anonymous ftp on 25ftp.x.org in /contrib/widgets as SciPlot-?.?.tar.gz. I have also set up 26the Offical SciPlot Web Site (tm) at 27http://www.ae.utexas.edu/~rwmcm/SciPlot.html that should always include the 28latest patchlevel update. 29 30 31REQUIREMENTS 32 33The SciPlot code requires X11R4 or later and a C compiler. The code was 34designed using ANSI C, but compiles fine with a non-ANSI compiler as long as 35the compiler understands new-style function prototypes. 36 37 38DEMO PROGRAMS 39 40Shipped with the source code distribution are two demo programs 41that show some of the features of the SciPlot widget. NOTE! The demo 42programs require Motif, but the SciPlot widget itself does not. 43 44The demo programs will build with LessTif version 0.4 or later! 45 46The program "sciplot" uses x/y data from a text file and pops up a plot 47on the screen. The other program "realtime" shows the new quick updating 48feature of the widget, making the widget better suited for realtime display 49purposes. 50 51If you have the program imake installed, you may use the supplied Imakefile 52to generate a Makefile. Otherwise, copy the file Makefile.noImake to Makefile, 53and edit that to conform to your system. Actually, other than specifying the 54C compiler to use, the Makefile should require little customization. 55 56To generate the Makefile, type: 57 58 xmkmf 59 60To compile both demo programs, type: 61 62 make 63 64See the HTML documentation for more information on using the demo programs, 65but a quick start for each of the programs would be: 66 67 sciplot data.txt 68 69 realtime 70 71 72 73USING THE WIDGET 74 75Instructions on how to use the SciPlot widget in your own code is documented in 76the manual page (SciPlot.man) included with the source code. The documentation 77is now provided in HTML format, and the manual page is generated from the 78HTML code. 79 80 81IMPROVEMENTS/PATCHES/BUG REPORTS 82 83If you make improvements in this widget (or, YIKES!, if you find bugs) 84please let me know at rwmcm@orion.ae.utexas.edu, or through the SciPlot 85Widget home page at http://www.ae.utexas.edu/~rwmcm/SciPlot.html 86 87 88ADVERTISEMENT FOR THE LESSTIF PROJECT 89 90I decided to use the Motif toolkit for the demo programs for two reasons. 91First, most of the requests that I get (for all my widgets) are "how do 92you use this with Motif?", so I decided to help all the Motif users out by 93supplying these more complete demos. 94 95And second, (plug, plug) I am now a core team member of the LessTif project. 96Although Lesstif cannot quite deal with the complicated demo programs at 97the time of this writing, it is quickly developing. Check the site 98http://www.hungry.com/products/lesstif/ for more information. 99 100AUTHOR 101 102Robert W. McMullen <rwmcm@orion.ae.utexas.edu> 103 104See the copyright notice for licensing restrictions. Note that the GNU 105_LIBRARY_ General Public Licesce is not the same as the standard GPL. 106 107Patches, improvements, suggestions, and bug reports are welcome at the above 108e-mail address. I will periodically post patches and improvements to 109ftp.x.org and the SciPlot web page at 110http://www.ae.utexas.edu/~rwmcm/SciPlot.html 111 112 113 114THANKS 115 116Thanks to the following people for providing fixes and suggestions: 117 118Todd Smith <mtsmith@vision1.engr.utk.edu> 119Walter Underwood <wunder@msd.hpl.hp.com> 120Michael Katzmann <michael%vk2bea@secondsource.com> 121John Moyer <jrm@questconsult.com> 122Mike Kienenberger <FXMLK@aurora.alaska.edu> 123Glenn Golden <gdg@big.att.com> 124<SATCHELL%CCF.dnet@hermes.dra.hmg.gb> 125 126 127COPYRIGHT 128 129Copyright (c) 1996 Robert W. McMullen 130 131Portions of the SciPlot Widget source code, as marked, are: 132 Copyright (c) 1993 Alan Richardson (mppa3@syma.sussex.ac.uk) 133 134This library is free software; you can redistribute it and/or 135modify it under the terms of the GNU Library General Public 136License as published by the Free Software Foundation; either 137version 2 of the License, or (at your option) any later version. 138 139This library is distributed in the hope that it will be useful, 140but WITHOUT ANY WARRANTY; without even the implied warranty of 141MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 142Library General Public License for more details. 143 144You should have received a copy of the GNU Library General Public 145License along with this library; if not, write to the Free 146Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 147