Skip to content

Latest commit

 

History

History
266 lines (173 loc) · 5.61 KB

label.rst

File metadata and controls

266 lines (173 loc) · 5.61 KB

Labels

You can specify x labels and y labels, depending on the graph type:

x_labels

chart = pygal.Line() chart.x_labels = 'Red', 'Blue', 'Green' chart.add('line', [.0002, .0005, .00035])

It is possible for dual charts to define a custom scale:

chart = pygal.XY() chart.x_labels = (.00012, .00024, .00048, .00096) chart.add('line', [(.0002, 10), (.0005, 20), (.00035, 15)])

And in this case it is possible to set text labels in place of values:

chart = pygal.XY() chart.x_labels = ({ 'label': 'Twelve', 'value': .00012 }, { 'label': 'Twenty four', 'value': .00024 }, { 'label': 'Forty eight', 'value': .00048 }, { 'label': 'Ninety six', 'value': .00096}) chart.add('line', [(.0002, 10), (.0005, 20), (.00035, 15)])

y_labels

chart = pygal.Line() chart.y_labels = .0001, .0003, .0004, .00045, .0005 chart.add('line', [.0002, .0005, .00035])

It is now possible to add text to labels values:

chart = pygal.Line() chart.y_labels = [ {'label': 'One', 'value': .0001}, {'label': 'Three', 'value': .0003}, {'label': 'Four', 'value': .0004}, {'label': 'Four and a half', 'value': .00045}, {'label': 'Five', 'value': .0005}] chart.add('line', [.0002, .0005, .00035])

show_x_labels

Set this to False to deactivate x labels:

chart = pygal.Line(show_x_labels=False) chart.x_labels = 'Red', 'Blue', 'Green' chart.add('line', [.0002, .0005, .00035])

show_y_labels

Set this to False to deactivate y labels:

chart = pygal.Line(show_y_labels=False) chart.x_labels = 'Red', 'Blue', 'Green' chart.add('line', [.0002, .0005, .00035])

Allow label rotation (in degrees) to avoid axis cluttering:

chart = pygal.Line() chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

x_label_rotation

chart = pygal.Line(x_label_rotation=20) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

y_label_rotation

chart = pygal.Line(y_label_rotation=20) chart.add('line', [0, .0002, .0005, .00035])

You can alter major minor behaviour of axes thanks to Arjen Stolk

x_labels_major

chart = pygal.Line(x_label_rotation=20) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.x_labels_major = ['This is the first point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

x_labels_major_every

chart = pygal.Line(x_label_rotation=20, x_labels_major_every=3) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

x_labels_major_count

chart = pygal.Line(x_label_rotation=20, x_labels_major_count=3) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

show_minor_x_labels

chart = pygal.Line(x_label_rotation=20, show_minor_x_labels=False) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.x_labels_major = ['This is the first point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

y_labels_major

chart = pygal.Line(y_label_rotation=-20) chart.y_labels_major = [] chart.add('line', [0, .0002, .0005, .00035])

chart = pygal.Line() chart.y_labels_major = [.0001, .0004] chart.add('line', [0, .0002, .0005, .00035])

y_labels_major_every

chart = pygal.Line(y_label_rotation=20, y_labels_major_every=3) chart.add('line', [0, .0002, .0005, .00035])

y_labels_major_count

chart = pygal.Line(y_labels_major_count=3) chart.add('line', [0, .0002, .0005, .00035])

show_minor_y_labels

chart = pygal.Line(y_labels_major_every=2, show_minor_y_labels=False) chart.add('line', [0, .0002, .0005, .00035])

truncate_label

By default long labels are automatically truncated at reasonable length to fit in the graph.

You can override that by setting truncation length with truncate_label.

chart = pygal.Line(truncate_label=17) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])

or disable it by setting this to -1

chart = pygal.Line(truncate_label=-1) chart.x_labels = [ 'This is the first point !', 'This is the second point !', 'This is the third point !', 'This is the fourth point !'] chart.add('line', [0, .0002, .0005, .00035])