README
¶
gchart -- gio canvas charting command
Gallery of chart types
Introduction
gchart makes charts using data read from a file or standard input.
The data format is tab-separated [name, value] fields with optional comments that serve as the chart's title.
An optional third field specifying a color is used by the pie and lego chart types.
For example:
# Sample Data
one 10
two 20
three 30
four 40
five 50
six 60
seven 70
eight 80
nine 90
ten 100
Chart types
area chart
opts="-zero=f -h 600 -xlabel=10 -yrange -1,1,0.25 -yfmt=%0.2f -grid"
gchart $opts -area sin.d
bar chart
gchart $opts -bar sin.d
line chart
gchart $opts -line sin.d
scatter chart
gchart $opts -scatter sin.d
Chart types may be combined, for example scatter, line and area charts may be used together.
gchart $opts -area -bar -line -scatter sin.d
dotchart
./gchart -dot -scatter -dotsize 1 -w 600 -h 600 data.d &
horizontal bar chart
gchart -hbar -ls 5 -barwidth 1.2 -textsize 3 -w 600 -h 600 data.d
horizontal word chart
./gchart $opts -wbar data.d &
lego chart
opts="-left 30 -w 600 -h 600"
gchart $opts -dotsize 5 -lego pop.d
pie chart
gchart $opts -top 75 -left 15 -piesize 30 -pie browser.d
Options
Command line options determine the behavior of gchart. Note that you must specify at least one chart type.
The unit for some of the options (left, right, top, bottom, barwidth, dotsize, linewidth, ls, piesize, textsize, ty) refer to the percentage of the canvas.
When specifying colors, you may use named colors ("red"), RGB ("rgb(128,0,0"), or HSV ("hsv(0,100,0)"). Opacities range from 0 (invisible) to 100 (fully opaque).
Value and data formats follow the Go fmt-package conventions. For example -yfmt="%.2f" for a floating point values with 2 decimal places.
The options are:
gchart [options] file...
Options Default Description
.....................................................................
-area false make an area chart
-bar false make a bar chart
-dot false make a dot chart
-hbar false make a horizontal bar chart
-wbar false make a horizontal word bar chart
-lego false make a lego chart
-line false make a line chart
-pie false make a pie chart
-scatter false make a scatter chart
.....................................................................
-color "lightsteelblue" data color
-labelcolor "rgb(100,100,100)" label color
-valuecolor "rgb(128,0,0)" value color
-opacity 40 opacity for area and wbar charts
-frame 0 frame opacity
-font "" specify font file (\"\": default)
.....................................................................
-h 1000 canvas height
-w 1000 canvas width
-left 20 chart left
-top 80 chart top
-bottom 20 chart bottom
-right 80 chart right
.....................................................................
-barwidth 0.5 bar width
-dotsize 0.5 bar width
-linewidth 0.25 line width
-ls 2 line spacing
-piesize 20 pie chart radius
-textsize 1.5 text size
.....................................................................
-chartitle "" chart title
-ty 5 title position relative to the top
-xlabel 1 x-xaxis label interval (0: no labels)
-yfmt "%v" yaxis format
-vfmt "" value format ("": no values)
-yrange "" y axis range (min,max,step)
.....................................................................
-grid false show y axis grid
-title false show the title
-zero true zero minumum
......................................................................
Documentation
Source Files