examples/bargraphs/minimal.txt

   1 Minimal bar-graph example
   2
   3 For a minimal bar plot you have set an bar axis in the graph constructor and
   4 provide Xname column data (X stands for the bar axis to be used). ... Here, we
   5 just use column 0 which is automatically filled by `graph.data.file` with the
   6 line number of the corresponding entry. Furthermore, you need to specify the
   7 graph style, since the default graph styles `symbol` and `function` (depending on
   8 the data type) are not appropriate for bar graphs.
   9
  10 Note that bar graphs differ from other xy-graphs in that they use ''discrete
  11 axes'' for one graph dimension. However, the only affected components of this
  12 fundamental change are one of the axes, which needs to be come a discrete one,
  13 i.e. a bar axis, and the usage of appropriate graph styles.
  14
  15 ! A bar graph is fundamentally different from a graph with a histogram style in
  16 its usage of a ''discrete axis'' in one graph dimension. A histogram instead is
  17 created using ''continuous axes'' in all graph dimensions and just drawing the
  18 data in a specific bar-graph-like presentation. In particular, the discreteness
  19 of the bar axis is reflected in the naming of its column name: instead of the
  20 continuous "X" it expects an "Xname" (where X stands for the bar axis used) as
  21 mentioned above.
  22
  23 ! As all axes and graph dimensions in the PyX graph system are treated equally
  24 all you need to modify to get bar graph with horizontal bars is to assign the
  25 bar axis to the y-axis in the graph constructor and change the names of the
  26 data columns to `yname` and `x`.
  27
  28 !! By using the bar style you implicitly also select a different positioning
  29 style, namepy `barpos`. This positioning style handles a single-nested axes
  30 with sub-axis values of the range going from 0 to 1.