README 4.28 KB
Newer Older
1
Veusz 1.21.1
2
------------
3 4
http://home.gna.org/veusz/

5 6 7 8
Veusz is a scientific plotting package.  It is designed to produce
publication-ready Postscript, PDF or SVG output. Graphs are built-up
by combining plotting widgets. The user interface aims to be simple,
consistent and powerful.
9

10 11
Veusz provides GUI, Python module, command line, scripting, DBUS and
SAMP interfaces to its plotting facilities. It also allows for
12
manipulation and editing of datasets. Data can be captured from
13 14
external sources such as Internet sockets or other programs.

15 16
Changes in 1.21.1
 * Add swap option on keys, swapping symbol and text
17

18 19 20 21 22 23 24 25 26 27 28 29
Bug fixes
 * Fix missing labels if colorbar out of plot
 * Preserve tags when reloading datasets
 * Handle nan/inf/-inf when as value in UI
 * Remove dependence on pyqtconfig in build system
 * Handle errors properly in 2D CSV read
 * Do not crash if selecting siblings of document widget
 * Fix accidental modification of data by line widget
 * Improve PDF bounding box rounding to prevent chopping near edge
 * Fix function plotter in embedding
 * Fix astropy version checking
 * Fix crash for error bar in CSV with blank previous column
30 31

Features of package:
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
 Plotting features:
  * X-Y plots (with errorbars)
  * Line and function plots
  * Contour plots
  * Images (with colour mappings and colorbars)
  * Stepped plots (for histograms)
  * Bar graphs
  * Vector field plots
  * Box plots
  * Polar plots
  * Ternary plots
  * Plotting dates
  * Fitting functions to data
  * Stacked plots and arrays of plots
  * Nested plots
  * Plot keys
  * Plot labels
  * Shapes and arrows on plots
  * LaTeX-like formatting for text
  * Multiple axes
  * Axes with steps in axis scale (broken axes)
  * Axis scales using functional forms
  * Plotting functions of datasets
 Input and output:
  * EPS/PDF/PNG/SVG/EMF export
  * Dataset creation/manipulation
  * Embed Veusz within other programs
  * Text, HDF5, CSV, FITS, NPY/NPZ, QDP, binary and user-plugin importing
  * Data can be captured from external sources
 Extending:
  * Use as a Python module
  * User defined functions, constants and can import external Python functions
  * Plugin interface to allow user to write or load code to
     - import data using new formats
     - make new datasets, optionally linked to existing datasets
     - arbitrarily manipulate the document
  * Scripting interface
  * Control with DBUS and SAMP
 Other features:
  * Data picker
  * Interactive tutorial
  * Multithreaded rendering
74 75

Requirements for source install:
76
 Python 2.x (2.6 or greater required) or 3.x (3.3 or greater required)
77
   http://www.python.org/
78 79 80
 Qt >= 4.6 (free edition)
   http://www.trolltech.com/products/qt/
 PyQt >= 4.5 (SIP is required to be installed first)
81 82
   http://www.riverbankcomputing.co.uk/software/pyqt/
   http://www.riverbankcomputing.co.uk/software/sip/
83 84 85
 numpy >= 1.0
   http://numpy.scipy.org/

86 87 88 89
Optional requirements:
 h5py (optional for HDF5 support)
   http://www.h5py.org/
 astropy >= 0.2 or PyFITS >= 1.1 (optional for FITS import)
90
   http://www.stsci.edu/resources/software_hardware/pyfits
91
   http://www.astropy.org/
92 93
 pyemf >= 2.0.0 (optional for EMF export)
   http://pyemf.sourceforge.net/
94 95
 PyMinuit >= 1.1.2 (optional improved fitting)
   http://code.google.com/p/pyminuit/
96 97
 dbus-python, for dbus interface
   http://dbus.freedesktop.org/doc/dbus-python/
98 99 100 101 102 103 104 105
 astropy (optional for VO table import)
   http://www.astropy.org/
 SAMPy (optional for SAMP support)
   http://pypi.python.org/pypi/sampy/

Veusz is Copyright (C) 2003-2014 Jeremy Sanders <jeremy@jeremysanders.net>
 and contributors.
It is licenced under the GPL (version 2 or greater).
106 107 108 109

For documentation on using Veusz, see the "Documents" directory. The
manual is in PDF, HTML and text format (generated from docbook). The
examples are also useful documentation. Please also see and contribute
110
to the Veusz wiki: https://github.com/jeremysanders/veusz/wiki
111 112 113

Issues with the current version:

114 115
  * Due to a bug in the Qt XML processing, some MathML elements
    containing purely white space (e.g. thin space) will give an error.
116

117
If you enjoy using Veusz, we would love to hear from you. Please join
118 119 120 121 122
the mailing lists at

https://gna.org/mail/?group=veusz

to discuss new features or if you'd like to contribute code. The
123 124
latest code can always be found in the Git repository
at https://github.com/jeremysanders/veusz.git.