Veusz Documentation Release 3.0 Jeremy Sanders Jun 09, 2018 CONTENTS 1 Introduction 3 1.1 Veusz...................................................3 1.2 Installation................................................3 1.3 Getting started..............................................3 1.4 Terminology...............................................3 1.4.1 Widget.............................................3 1.4.2 Settings: properties and formatting...............................6 1.4.3 Datasets.............................................7 1.4.4 Text...............................................7 1.4.5 Measurements..........................................8 1.4.6 Color theme...........................................8 1.4.7 Axis numeric scales.......................................8 1.4.8 Three dimensional (3D) plots..................................9 1.5 The main window............................................ 10 1.6 My first plot............................................... 11 2 Reading data 13 2.1 Standard text import........................................... 13 2.1.1 Data types in text import.................................... 14 2.1.2 Descriptors........................................... 14 2.1.3 Descriptor examples...................................... 15 2.2 CSV files................................................. 15 2.3 HDF5 files................................................ 16 2.3.1 Error bars............................................ 16 2.3.2 Slices.............................................. 16 2.3.3 2D data ranges......................................... 16 2.3.4 Dates.............................................. 16 2.4 2D text or CSV format.......................................... 17 2.5 FITS files................................................. 17 2.6 Reading other data formats........................................ 18 3 Manipulating datasets 21 3.1 Using dataset plugins........................................... 21 3.2 Using expressions to create new datasets................................ 21 3.3 Linking datasets to expressions..................................... 22 3.4 Splitting data............................................... 22 3.5 Defining new constants or functions................................... 22 3.6 Dataset plugins.............................................. 23 4 Capturing data 25 i 5 Veusz command line and embedding interface (API) 27 5.1 Introduction............................................... 27 5.2 Commands and API........................................... 27 5.2.1 Action.............................................. 27 5.2.2 Add............................................... 27 5.2.3 AddCustom........................................... 28 5.2.4 AddImportPath......................................... 28 5.2.5 CloneWidget.......................................... 28 5.2.6 Close.............................................. 28 5.2.7 CreateHistogram........................................ 28 5.2.8 DatasetPlugin.......................................... 29 5.2.9 EnableToolbar.......................................... 29 5.2.10 Export.............................................. 29 5.2.11 FilterDatasets.......................................... 29 5.2.12 ForceUpdate.......................................... 29 5.2.13 Get............................................... 30 5.2.14 GetChildren........................................... 30 5.2.15 GetClick............................................. 30 5.2.16 GetColormap.......................................... 30 5.2.17 GetData............................................. 30 5.2.18 GetDataType.......................................... 30 5.2.19 GetDatasets........................................... 31 5.2.20 GPL............................................... 31 5.2.21 ImportFile............................................ 31 5.2.22 ImportFile2D.......................................... 31 5.2.23 ImportFileCSV......................................... 32 5.2.24 ImportFileFITS......................................... 32 5.2.25 ImportFileHDF5........................................ 33 5.2.26 ImportFileND.......................................... 34 5.2.27 ImportFilePlugin........................................ 34 5.2.28 ImportFITSFile......................................... 34 5.2.29 ImportString.......................................... 35 5.2.30 ImportString2D......................................... 35 5.2.31 ImportStringND......................................... 35 5.2.32 IsClosed............................................. 35 5.2.33 List............................................... 36 5.2.34 Load............................................... 36 5.2.35 MoveToPage.......................................... 36 5.2.36 ReloadData........................................... 36 5.2.37 Rename............................................. 36 5.2.38 Remove............................................. 36 5.2.39 ResizeWindow......................................... 36 5.2.40 Save............................................... 37 5.2.41 Set................................................ 37 5.2.42 SetAntiAliasing......................................... 37 5.2.43 SetData............................................. 37 5.2.44 SetDataExpression....................................... 37 5.2.45 SetDataND........................................... 37 5.2.46 SetDataRange.......................................... 38 5.2.47 SetData2D............................................ 38 5.2.48 SetData2DExpression...................................... 38 5.2.49 SetData2DExpressionXYZ................................... 38 5.2.50 SetData2DXYFunc....................................... 38 5.2.51 SetDataDateTime........................................ 38 ii 5.2.52 SetDataText........................................... 39 5.2.53 SetToReference......................................... 39 5.2.54 SetUpdateInterval........................................ 39 5.2.55 SetVerbose........................................... 39 5.2.56 StartSecondView........................................ 39 5.2.57 TagDatasets........................................... 39 5.2.58 To................................................ 40 5.2.59 Quit............................................... 40 5.2.60 WaitForClose.......................................... 40 5.2.61 Zoom.............................................. 40 5.3 Security.................................................. 40 5.4 Using Veusz from other programs.................................... 40 5.4.1 Non-Qt Python programs.................................... 40 5.4.2 Older path-based interface................................... 41 5.4.3 New-style object interface................................... 42 5.4.4 Translating old to new style................................... 44 6 Indices and tables 47 iii iv Veusz Documentation, Release 3.0 Jeremy Sanders Copyright 2018 This document is licensed under the GNU General Public License, version 2 or greater. Please see the file COPYING for details, or see http://www.gnu.org/licenses/gpl-2.0.html. This is the documentation for Veusz. Veusz is a multiplatform scientific plotting package with a graphical user inter- face. Contents: CONTENTS 1 Veusz Documentation, Release 3.0 2 CONTENTS CHAPTER ONE INTRODUCTION 1.1 Veusz Veusz is a 2D and 3D scientific plotting package. It is designed to be easy to use, easily extensible, but powerful. The program features a graphical user interface (GUI), which works under Unix/Linux, Windows or Mac OS. It can also be easily scripted (the saved file formats are similar to Python scripts) or used as module inside Python. Veusz reads data from a number of different types of data file, it can be manually entered, or constructed from other datasets. In Veusz the document is built in an object-oriented fashion, where a document is built up by a number of widgets in a hierarchy. For example, multiple function or xy widgets can be placed inside a graph widget, and many graphs can be placed in a grid widget. The program also supports a variety of 3D plots, including 3D point and surface plots. The program produces vector rather than rastered 3D output. Veusz can be extended by the user easily by adding plugins. Support for different data file types can be added with import plugins. Dataset plugins automate the manipulation of datasets. Tools plugins automate the manipulation of the document. 1.2 Installation Please go to the website of Veusz to learn more about the program. Links to binaries, distribution packages and the source package can be found in downloads. For source installation, please see the package INSTALL. 1.3 Getting started Veusz includes a built-in tutorial which starts the first time the program is run. You can rerun it later from the Help menu. It also includes many examples, to show how certain kinds of plots are produced. For more help and link to a video tutorial, see help. 1.4 Terminology Here we define some terminology for future use. 1.4.1 Widget A document and its graphs are built up from widgets. These widgets can often by placed within each other, depending on the type of the widget. A widget has children (those widgets placed within it) and its parent. The widgets have 3 Veusz Documentation, Release 3.0 a number of different settings which modify their behaviour. These settings are divided into properties, which affect what is plotted and how it is plotted. These would include the dataset being plotted or whether an axis is logarithmic. There