Debian Codegraph @

SciPlot.html

raw
1 <html><head><title>SciPlot Widget Web Page</title></head><body>
2 <h1><a name="top">SciPlot Widget <img src=SciPlotTitle.gif></a></h1>
3
4 <p>A full-featured GTK4 widget to display 2D data in a graph.
5 It is intended to display scientific data, and can format the data in polar or
6 cartesian plots (log axes available for cartesian plots).
7
8 <ul>
9 <li><a href="#current">Current Version</a>
10 <li><a href="#screen">Screen Shots</a>
11 <li><a href="#overview">Overview</a>
12 <li><a href="#feat">Features</a>
13 <li><a href="#reqs">Requirements</a>
14 <li><a href="#history">History</a>
15 <li><a href="#note">Author's Note</a>
16 <li><a href="#thanks">Thanks</a>
17 <li><a href="#copyright">Copyright</a>
18 </ul>
19
20 <ul>
21 <li><a href="SciPlotProg.html">Programmer's Documentation</a>
22 <li><a href="SciPlotDemo.html">Demo Program Information</a>
23 </ul>
24
25 <p><hr><h2><a name="current">Current Version</a></h2>
26 <p>The current version is 1.37, a GTK4/Cairo/Pango port of the original
27 X11/Xt widget. Source is available from the
28 <a href="https://github.com/barak/sciplot">repository</a>.
29
30 <p><hr><h2><a name="screen">Screen Shots</a></h2>
31
32 <img src=SciPlotExample.gif alt="A few images showing the format and capabilities of the SciPlot widget.">
33
34 <p><hr><h2><a name="overview">Overview</a></h2>
35
36 <p>The SciPlot Widget is a GTK4 widget capable of plotting cartesian or polar
37 graphs, including logarithmic axes in cartesian plots. It is implemented as a
38 GObject subclass of <tt>GtkWidget</tt> and draws using the Cairo 2D graphics
39 library with Pango for text layout.
40
41 <p>Features provided in the widget include automatic scaling, legend drawing,
42 axis labeling, PostScript output, multiple plotted lines, color support, user
43 font specification, dashed lines, symbols drawn at points, logarithmic scales
44 on one or both axes in cartesian plots, and degrees or radians as angles in
45 polar plots.
46
47 <p><hr><h2><a name="feat">Features</a></h2>
48 <p>Features provided in the widget include the following:
49
50 <ul>
51 <li>Cartesian or Polar plots
52 <li>Automatic or manual axis scales
53 <li>Logarithmic scales for cartesian plots
54 <li>Degrees or radians for polar angles
55 <li>Axis labeling
56 <li>Legend drawing
57 <li>Multiple lines per plot
58 <li>Noncontinuous (broken) line segments
59 <li>Various symbols and line styles
60 <li>Color support
61 <li>User font selection
62 <li>PostScript (EPS) output
63 <li>Real-time streaming updates (<tt>sciplot-realtime</tt> reads from stdin)
64 <li>Vertical or horizontal y axis label numbers
65 </ul>
66
67 <p>See the
68 <a href="SciPlotDemo.html">demo program information</a>
69 page for compilation instructions and sample programs.
70
71 <p><hr><h2><a name="reqs">Requirements</a></h2>
72
73 <p>The SciPlot widget requires GTK4 (4.0 or later), Cairo (with PostScript
74 support), and Pango/pangocairo. Build uses autoconf/automake and
75 <tt>pkg-config</tt>. A C99 compiler is required.
76
77 <p><hr><h2><a name="history">History</a></h2>
78
79 <p>The SciPlot widget was originally written by Rob McMullen in 1994 as an
80 X11/Xt widget, developed on an IBM RS/6000 running AIX 3.2.4 and X11R5.
81 It was widely used with Athena, Motif, and other Xt-based widget sets.
82
83 <p>In 2026, the widget was ported to GTK4/Cairo/Pango by Barak A. Pearlmutter
84 as part of the Debian package maintenance. The X11/Xt widget infrastructure
85 was replaced by a GObject-based GTK4 widget subclass. Drawing is now
86 performed via Cairo in the <tt>snapshot()</tt> virtual method using a retained
87 display list. Font metrics and text rendering use Pango. Vertical text
88 rendering, which previously used an X11 pixmap rotation technique, now uses
89 <tt>cairo_rotate()</tt>. PostScript output uses Cairo's PS surface rather than
90 manual PS generation. The Motif-based utility dialogs were rewritten using
91 GTK4 widgets.
92
93 <p>The first X11 plotting widget that Rob McMullen encountered was the libXG
94 package written by Sundar Narasimhan
95 <tt>&lt;[email protected]&gt;</tt>, which inspired the original SciPlot design.
96
97 <p><hr><h2><a name="note">Author's Note</a></h2>
98
99 <p>This widget is supplied as free software under the GNU Library General
100 Public Licence. If you use this widget, please include mention of the SciPlot
101 widget in your documentation and retain the copyright notice.
102
103 <p>The original author can be reached at
104 <tt>&lt;[email protected]&gt;</tt>.
105 The Debian package is maintained by
106 <tt>&lt;[email protected]&gt;</tt>.
107
108 <p><hr><h2><a name="thanks">Thanks</a></h2>
109
110 <p>Thanks to the following people for providing fixes and suggestions to the
111 original X11 version:
112
113 <ul>
114 <li>Todd Smith <tt>&lt;[email protected]&gt;</tt>
115 <li>Walter Underwood <tt>&lt;[email protected]&gt;</tt>
116 <li>Michael Katzmann <tt>&lt;michael%[email protected]&gt;</tt>
117 <li>John Moyer <tt>&lt;[email protected]&gt;</tt>
118 <li>Mike Kienenberger <tt>&lt;[email protected]&gt;</tt>
119 <li>Glenn Golden <tt>&lt;[email protected]&gt;</tt>
120 <li><tt>&lt;SATCHELL%[email protected]&gt;</tt>
121 <li>Derrick Bass <tt>&lt;[email protected]&gt;</tt>
122 <li>Santeri Paavolainen <tt>&lt;[email protected]&gt;</tt>
123 <li>Nicolas EERTMANS <tt>&lt;[email protected]&gt;</tt>
124 <li>Carlos Baumann <tt>&lt;[email protected]&gt;</tt>
125 </ul>
126
127 <p><hr><h2><a name="copyright">Copyright</a></h2>
128
129 <p>Copyright (c) 1996 Robert W. McMullen<br>
130 Copyright (c) 2026 Barak A. Pearlmutter (GTK4/Cairo port)
131
132 <p><h6><small>
133 This library is free software; you can redistribute it and/or
134 modify it under the terms of the GNU Library General Public
135 License as published by the Free Software Foundation; either
136 version 2 of the License, or (at your option) any later version.
137 </small></h6>
138
139 <p><h6><small>
140 This library is distributed in the hope that it will be useful,
141 but WITHOUT ANY WARRANTY; without even the implied warranty of
142 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
143 Library General Public License for more details.
144 </small></h6>
145
146 <p><h6><small>
147 You should have received a copy of the GNU Library General Public
148 License along with this library; if not, write to the Free
149 Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
150 </small></h6>
151
152 <hr>
153
154 <br> <a href=SciPlot.html>SciPlot</a> :
155 <a href=SciPlotProg.html>Programmer's Reference</a> |
156 <a href=SciPlotDemo.html>Demo Programs</a>
157 <br><hr>Originally by <a href="mailto:[email protected]">Rob McMullen</a>.
158 GTK4 port by <a href="mailto:[email protected]">Barak A. Pearlmutter</a>.
159 Updated: 2 Jun 2026<br></body></html>