summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/datatool/README
blob: 34e1b34558a555219c9ad4511514622f45bb9307 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
LaTeX Bundle : datatool v1.0 (datatool.sty, datapie.sty, dataplot.sty, databar.sty)

Last Modified : 23 July 2007

Author        : Nicola Talbot

datatool.sty:

 Databases can be created using LaTeX commands or loaded
 from external ASCII files, such as comma or tab separated
 variable files.

 Databases can be sorted numerically or alphabetically
 (descending or ascending.)

 Repetitive operations can be performed on each row of
 data in a database (such as mail merging.) Conditions
 can be imposed to exclude rows.

 Commands are provided to determine if an argument is
 an integer, a real number, currency or a string.
 (Scientific notation is currently not supported.)

 Locale dependent number settings are supported 
 (such as a comma as a decimal character and full stop as 
 a number group character.)

 Commands are provided to convert between locale dependent
 numbers/currency and the standard decimal format required 
 by the fp package enabling fixed point arithmetic to be 
 performed on elements of the database.

 Strings can be tested to determine if they are all upper
 or all lower case.

 Names can be converted to initials using \DTLinitials.

datapie.sty:

 A database defined by datatool.sty can be converted into a 
 pie chart.

 Segments can be separated from the rest of the chart to make
 them stand out.

 Colour/grey scale options.

 Predefined segment colours can be changed.

 Hooks provided to annotate chart.

dataplot.sty:

 A database defined by datatool.sty may be plotted as a 2D
 scatter or line plot

 Settings provided to govern the appearance of the chart.
 (e.g. show/hide axes, legend, grid, major/minor tick marks.)

 Hooks provided to add extra information to the plot

databar.sty:

 A database defined by datatool.sty can be converted into a 
 bar chart.

 Colour/grey scale options.

 Predefined bar colours can be changed.

 Horizontal or vertical formats provided.

 Hooks provided to annotate chart.

*The datatool bundle replaces the csvtools bundle which is now obsolete.*

The datatool.sty package requires the following packages/files:

xkeyval
xfor
fp
substr
compare.tex

The datapie.sty, dataplot.sty and databar.sty packages requires 
the tikz/pgf package.

*Remember to refresh TeX's database*

The package and documentation source code is also supplied as a
dtx and ins file located in texmf/source.

This material is subject to the LaTeX Project Public License. 
See  http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html for the details of that license.

http://theoval.cmp.uea.ac.uk/~nlct/