These examples illustrate how to use the igpp.docgen tool with table data.

Table data is arranged as records composed of fields. Each field contains a value. A table can contain any number of records and the number and order of fields in each record is the same. Each field can have a name so that it can referenced.

igpp.docgen supports delimited tables where each field is delineated by a field delimiter. The default delimiter is a comma (,). Other delimiters can be used. When they are it must be specified on command-line with the "-s" option.

When igpp.docgen parses a table it looks for the first non-commented line and uses that to determine the names for each field and how many fields should be in record.

igpp.docgen also supports comments in a table file. Any line beginning with "#" is considered a comment. The content of all comments are assigned to the "description" attribute of the generated velocity context.

Example Uses

With Known Structure
Using tables with known structures, create a simple XML document showing using the contents of table with a known structure.
Adaptive to Structure
Using tables with any structure, create a VOTable to match the CSV table.
Lookup Values
Find one or more values that span or fall between two other values.