View Source: Help/PloticusPlugin

The **Ploticus** [[Help:WikiPlugin|plugin]] passes all its arguments to the Ploticus binary and displays the result as PNG, GIF, EPS, SVG or SVGZ. Ploticus is a free, GPL, non-interactive software package for producing plots, charts, and graphics from data. See http://ploticus.sourceforge.net/doc/welcome.html Ploticus uses a cache expire date of days. == Usage == {{{ <<Ploticus device||=png [ploticus options...] multiline ploticus script ... >> }}} or without any script: (not tested) {{{ <<Ploticus -prefab vbars data=myfile.dat delim=tab y=1 clickmapurl="http://mywiki.url/wiki/?pagename=@2" clickmaplabel="@3" -csmap >> }}} TODO: ~PloticusSql - create intermediate data from SQL. Similar to [[Help:SqlResultPlugin|SqlResult]] plugin, just in graphic form. For example to produce nice looking pagehit statistics or ratings statistics. Ploticus has its own sql support within #getproc data, but this would expose security information. == Arguments == {| class="bordered" |- ! Argument ! Description ! Default value |- | **device** | gif, png, jpeg, svg, svgz, eps. Any -T parameter supported by Ploticus. | png |- | **data** | optionally add data by <!plugin-list !> pagelist plugins. See [[Help:WikiPlugin]] | |- | **alt** | alt text for the image | |- | **~-prefab** | use the given prefab script (may need PLOTICUS_PREFABS) | |- | **~-csmap** | If a clickable map should be produced (not yet tested) passed to Ploticus as -csmap -mapfile $tempfile.map | |- | **help** | Show a help screen | |} All other arguments are used as source to Ploticus. == Known Problems == For Windows you need either a gd library with GIF support or a Ploticus with PNG support. This comes only with the Cygwin build so far. == Optional Configuration == config.ini: PLOTICUS_EXE = pl.exe (on Windows) PLOTICUS_EXE = /usr/local/bin/pl (elsewhere) prefabs need the environment variable PLOTICUS_PREFABS. Default: /usr/share/ploticus. Maybe also set by the config variable PLOTICUS_PREFABS. See also [[Help:WikiPluginCached]] options in config.ini. == Examples == Sample Pie Chart: {{{ <<Ploticus device||=png alt="Sample Pie Chart" #proc page #if @DEVICE in gif,png scale: 0.7 #endif // specify data using {proc getdata} #proc getdata data: Brazil 22 Columbia 17 "Costa Rica" 22 Guatemala 3 Honduras 12 Mexico 14 Nicaragua 28 Belize 9 United\nStates 21 Canada 8 // render the pie graph using {proc pie} #proc pie firstslice: 90 explode: .2 0 0 0 0 .2 0 datafield: 2 labelfield: 1 labelmode: line+label center: 4 4 radius: 2 colors: yellow pink pink pink pink yellow pink labelfarout: 1.05 >> }}} == Author == * [[Help:Reini Urban|Reini Urban]] == See Also == * [[Help:GraphVizPlugin]] <noinclude> ---- [[PhpWikiDocumentation]] [[CategoryWikiPlugin]] </noinclude>