Documentation of the Plplot Plotting Software I
Total Page:16
File Type:pdf, Size:1020Kb
Documentation of the PLplot plotting software i Documentation of the PLplot plotting software Documentation of the PLplot plotting software ii Copyright © 1994 Maurice J. LeBrun, Geoffrey Furnish Copyright © 2000-2005 Rafael Laboissière Copyright © 2000-2016 Alan W. Irwin Copyright © 2001-2003 Joao Cardoso Copyright © 2004 Andrew Roach Copyright © 2004-2013 Andrew Ross Copyright © 2004-2016 Arjen Markus Copyright © 2005 Thomas J. Duck Copyright © 2005-2010 Hazen Babcock Copyright © 2008 Werner Smekal Copyright © 2008-2016 Jerry Bauck Copyright © 2009-2014 Hezekiah M. Carty Copyright © 2014-2015 Phil Rosenberg Copyright © 2015 Jim Dishaw Redistribution and use in source (XML DocBook) and “compiled” forms (HTML, PDF, PostScript, DVI, TeXinfo and so forth) with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code (XML DocBook) must retain the above copyright notice, this list of conditions and the following disclaimer as the first lines of this file unmodified. 2. Redistributions in compiled form (transformed to other DTDs, converted to HTML, PDF, PostScript, and other formats) must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Important: THIS DOCUMENTATION IS PROVIDED BY THE PLPLOT PROJECT “AS IS” AND ANY EXPRESS OR IM- PLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE PLPLOT PROJECT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Release version: 5.15.0 Release date: 2019-06-01 Documentation of the PLplot plotting software iii COLLABORATORS TITLE : Documentation of the PLplot plotting soft- ware ACTION NAME DATE SIGNATURE WRITTEN BY Maurice J. LeBrun June 1, 2019 and Geoffrey Furnish REVISION HISTORY NUMBER DATE DESCRIPTION NAME Documentation of the PLplot plotting software iv Contents I Introduction 1 1 Introduction 2 1.1 The PLplot plotting software . 2 1.2 Feature Summary . 3 1.2.1 Cross Platform . 3 1.2.2 Language Bindings . 3 1.2.3 Output File Formats . 3 1.2.4 Interactive Platforms . 4 1.3 Obtaining Access to PLplot . 4 1.4 Configure, build, and install PLplot from source . 4 1.5 PLplot Copyright Licensing . 5 1.6 Credits . 5 II Programming 6 2 Simple Use of PLplot 7 2.1 Plotting a Simple Graph . 7 2.2 Initializing PLplot . 7 2.3 Defining Plot Scales and Axes . 8 2.4 Labelling the Graph . 8 2.5 Drawing the Graph . 8 2.5.1 Drawing Points . 8 2.5.2 Drawing Lines or Curves . 8 2.5.3 Writing Text on a Graph . 9 2.5.4 Area Fills . 9 2.5.5 More Complex Graphs . 9 2.6 Finishing Up . 9 2.7 In Case of Error . 9 Documentation of the PLplot plotting software v 3 Advanced Use of PLplot 10 3.1 Command Line Arguments . 10 3.2 Devices ........................................................ 11 3.2.1 Driver Functions . 11 3.2.2 Family File Output . 13 3.2.3 Specifying the Output Device . 14 3.3 Adding FreeType Library Support to Bitmap Drivers . 15 3.4 View Surfaces, (Sub-)Pages, Viewports and Windows . 15 3.4.1 Defining the Viewport . 15 3.4.2 Defining the Window . 16 3.4.3 Annotating the Viewport . 16 3.4.4 Setting up a Standard Window . 17 3.5 Setting Line Attributes . 17 3.6 Setting the Area Fill Pattern . 17 3.7 Setting Color . 17 3.7.1 Color Map0 . 18 3.7.2 Color Map1 . 18 3.8 Setting Character Attributes . 19 3.8.1 Hershey font system . 19 3.8.2 Unicode font system . 20 3.8.2.1 The ps device driver . 20 3.8.2.2 The gd and wingcc device drivers . 20 3.8.2.3 The svg device driver . 21 3.8.2.4 The psttf, cairo, qt, and wxwidgets device drivers . 22 3.8.3 FCI . 22 3.8.4 Escape sequences in text . 22 3.8.5 Character size adjustment . 24 3.9 Three-dimensional Plots . 24 3.9.1 Surface Plots . 24 3.9.2 Contour Plots . 24 3.9.3 Shade plots . 25 3.9.4 Image plots . 25 3.9.5 Vector plots . 25 3.10 Legends and color bars . 25 4 Deploying programs that use PLplot 26 Documentation of the PLplot plotting software vi 5 Drivers which implement file devices 29 5.1 Theqtdriver...................................................... 29 5.2 Thecairodriver .................................................... 29 5.3 Thesvgdriver..................................................... 29 5.4 The ps driver . 29 5.5 The psttf driver . 30 5.6 The pdf driver . 30 5.7 Thegddriver ..................................................... 30 5.8 The pstex driver . 31 6 Drivers which implement interactive devices 32 6.1 Theqtdriver...................................................... 32 6.2 Thecairodriver .................................................... 32 6.3 The xwin driver . 32 6.4 The tk driver . 33 6.5 Theaqtdriver ..................................................... 33 6.6 The wxwidgets driver . 33 6.6.1.