Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse

Direc­tory tex-archive/macros/latex/contrib/datatool

LaTeX Bundle : datatool v2.22 

Last Modified : 2014-06-10

Author        : Nicola Talbot

Package FAQ   : http://www.dickimaw-books.com/faqs/datatoolfaq.html

This bundle consists of the packages: datatool.sty, 
datatool-base.sty, datatool-fp.sty, datatool-pgfmath.sty,
databar.sty, databib.sty, datapie.sty dataplot.sty, datagidx.sty
person.sty.

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.

datatool-base.sty:

 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 or pgfmath packages 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.

datatool-fp.sty:
 Provides an interface with fp.sty

datatool-pgfmath.sty:
 Provides an interface with pgfmath.sty

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.

databib.sty:

 Provides commands to convert a BibTeX database into a datatool
 database.

datagidx.sty:

 Provides a way of indexing or creating glossaries/lists of acronyms
 that uses TeX to do the sorting and collating instead of using an
 external indexing application, such as xindy or makeindex.

person.sty:

 Provides commands to display a person's name and pronoun in an
 order of service style document to provide consistency, or in mail
 merging to eliminate the cumbersome use of ``he/she'' etc.

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

REQUIRED PACKAGES:

The datatool.sty and datatool-base.sty packages requires the following packages/files:

xkeyval
ifthen
xfor
substr (at least 2009/10/20)
etex
etoolbox
amsmath

The datatool-fp package requires fp.sty
The datatool-pgfmath package requires pgfmath.sty

The datapie.sty, dataplot.sty and databar.sty packages 
additionally require the tikz/pgf bundle.

*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/license/lppl1.3 for the details of that license.

http://www.dickimaw-books.com/

Direc­to­ries

Name Notes
samples

Files

Name Size Date Notes
CHANGES 10783 2014-06-10 12:59
INSTALL 1776 2014-06-10 12:59
README 3575 2014-06-10 12:59
datatool-code.pdf 922877 2014-06-10 12:59
datatool-user.pdf 605320 2014-06-10 12:59
datatool-user.tex 386135 2014-06-10 12:59
datatool.dtx 794360 2014-06-10 12:59
datatool.ins 2244 2014-06-10 12:59

Down­load the con­tents of this pack­age in one zip archive (2.5M).

data­tool – Tools to load and ma­nip­u­late data

The tools com­prise six pack­ages:

  • data­tool.sty: databases may be cre­ated us­ing LaTeX com­mands or by im­port­ing ex­ter­nal files; they may be sorted nu­mer­i­cally or al­pha­bet­i­cally; repet­i­tive op­er­a­tions (such as mail merg­ing) may be per­formed on each row of a database, sub­ject to con­di­tions to ex­clude par­tic­u­lar rows; com­mands are pro­vided to ex­am­ine database el­e­ments, and to con­vert for­mats (for ex­am­ple, to con­vert a nu­meric el­e­ment to a for­mat com­pat­i­ble with the fp pack­age;
  • dat­apie.sty: a database may be rep­re­sented as a pie chart; flex­i­ble op­tions al­low colour­ing of the chart, and an­no­ta­tion hooks are avail­able;
  • dat­a­plot.sty: a database may be rep­re­sented as a 2-di­men­sional scat­ter or line plot; flex­i­ble op­tions con­trol of the plot's over­all ap­pear­ance, and of leg­ends and other ex­tra in­for­ma­tion;
  • databar.sty: a database may be rep­re­sented as a bar chart; over­all ap­pear­ance, colour­ing and an­no­ta­tion are con­trol­lable;
  • datagidx.sty: pro­vides a way of in­dex­ing or cre­at­ing glos­saries/lists of acronyms that uses TeX to do the sort­ing and col­lat­ing in­stead of us­ing an ex­ter­nal in­dex­ing ap­pli­ca­tion, such as xindy or makein­dex;
  • databib.sty: a bib­li­og­ra­phy may be loaded into a data­tool database, and ma­nip­u­lated there be­fore be­ing printed (this per­mits a LaTeX-based route to print­ing bib­li­ogra­phies in for­mats for which no BibTeX style is avail­able); and
  • per­son.sty: pro­vides sup­port for dis­play­ing a per­son’s name and pro­noun in a doc­u­ment, thus avoid­ing cum­ber­some use of “he/she”, etc.
The draw­ing pack­ages make use of PGF/TikZ for their out­put.

The bun­dle su­per­sedes and re­places the au­thor’s csv­tools bun­dle.

Pack­age De­tailsdata­tool
Ver­sion2.22
Li­censeThe LaTeX Project Public Li­cense
Copy­right2009,2013,2014 Ni­cola Tal­bot
Main­tainerNi­cola Tal­bot
TDS archivedatatool.tds.zip
Con­tained inTeXlive as data­tool
MikTeX as data­tool
Topics ma­nip­u­late data within TeX
vi­su­al­i­sa­tion of data sets
im­port­ing data into doc­u­ments
Guest Book Sitemap Contact