1PCV(1) Picviz Documentation PCV(1)
2
6 pcv - Picviz console veritable tool
7
9 pcv -Toutput_plugin [-Rrender_plugin] [options] file.pcv ['filter']
10
12 pcv allows to compile PCV files into a plugin choosen format, such as
13 svg, csv, png or other.
14 -Tplugin Replace 'plugin' with a output plugin name. See plugin section
16 -Rplugin Replace 'plugin' with a render plugin name. See plugin section
18 options can be either one or several among:
20 -A argument Provides arguments to the render and output plugin
22 -a Displays all text along with lines
24 -d Activates debug mode
26 -Ln Draw text every n line
28 -l Skip learning mode
30 -o file Output to the given file instead of stdout
32 -p file Use given file to store PID
34 -r...(rrr) Increases image height and width
36 -s socket.name Create the socket.name and listen to it (for real-time
38 capabilities)
39 -t template Use the given template when listening to a socket
41 -Warg Use Picviz with a special keyword. See keywords section
43 The filter parameter is explained in the filter section below.
45
47 Plugins are located with ld, search path can be overridden with
48 PICVIZ_PLUGINS_PATH environment variable.
49 Output
51 Output data in the wanted file format. Available plugins are:
52 svg
54 plplot
56 csv
58 sdl
60 pngcairo
62 debug
64 Render
66 Modify data rendering. Available plugins are:
67 heatline: possible arguments (-A): virus
69 debug
71
73 Keywords are special parameters given to picviz to use a library along
74 with parsing and rendering. This is deactivated by default because it
75 makes the program slow, but it may be very usefull in certain cases.
76 Following keywords are accepted:
78 pcre: activates pcre pattern matching for filtering (pcv -Tsvg -Wpcre
80 file.pcv 'show value = ".*foo.*" on axis 1')
81
83 pcv allows filtering to choose data you want to see displayed. When the
84 pcv language parser is called, a Pcv Image Filter (PIF) is applied. It
85 allows to filter either before any data is calculated (data filter),
86 once calculated and before adding the line to the image (pre line
87 filter) or, once other lines have been added and ask for specific
88 removales (post line filter).
89 Relations
91 Filter relation can be either:
92 = equal
94 != not equal
96 < less than
98 > greater than
100 <= less or equal
102 >= greater or equal
104 Selecting plot value
106 plot: Will select the value, as plotted by the engine. Accepted values
107 can be the y position on the axis or the relative percentage.
108 'show plot > 100 on axis 3': will display only lines which have their
110 plot on the axis 3 greater than 100 can be called like this:
111 Example: pcv -Tsvg file.pcv 'show plot > 100 on axis 3'
113 By default, the image height is 500 pixels, so this filter is
115 equivalent than > 100:
116 'show plot > 20% on axis 3'.
118 It is possible to filter using multi-criterion values:
120 'show plot > 20% on axis 3 and plot < 42 on axis 5'
122 Pattern matching
124 Values can be selected, either with their original text string, or by
125 using pattern matching. By default, pattern matching is not activated.
126 Pattern matching activated is done with -Wpcre argument. To filter
128 values with [0-9][aA].*, you can type:
129 pcv -Tsvg file.pcv -Wpcre 'show value = "[0-9][aA].*" on axis 1'.
131 Note that with string comparisons (with value), only the equal (=)
133 relation is accepted.
134
136 pcv -Tsvg file.pcv
137 pcv -Tpngcairo file.pcv -rrrr -a > file.png
139 pcv -Tpngcairo -Rheatline -Avirus file.pcv > file.svg
141 pcv -Tpngcairo -s local.sock -t file.pcv -o file.png ''
143
145 If you are sure you are not dealing with a feature, you can report BUGS
146 using the trac ticketing system available at
147 http://www.wallinfire.net/picviz.
148
150 Man page written by Sebastien Tricaud toady gscore org.
151perl v5.10.0 2008-12-21 PCV(1)