NAME

Calculate Generic


VERSION

0.03


SYNOPSIS

        perl gus_calc_generic.pl --fm /foo/bar/input.txt --to /foo/bar/output.txt


DESCRIPTION

Reads in a pure ASCII *.CSV, comma-delimited text file representing a table of acceptance ranges and data sets. Format of input table must be of a kind similar to the example/development-test DATA embeded herein just beneath the __END__ statement.

Output is yet another pure ASCII, comma-delimited text file reporting on the passage or failure of each included data set against each included acceptance range. Cumulative (row-wise) passage or failure is indicated rightmost of each row. Individual (column-wise) failures are separately indicated within each.

General intent is that data normally entered into columns by hand onto printed forms may be easily transcribed into plain ASCII text documents, and then fed to this script. Obtained will be a report easily embeded in any document without need of linking to yet another (spreadsheet, etc) document for simple presentation.

Such format is especially handy for inclusion in XML and word processor documents. Alternately, the resulting *.CSV file may instead be opened directly as a spreadsheets, if desired.

STAND-ALONE TEST

You may run this program by itself as a self-test of the program. It will read in default DATA from the end-of-script (below the __END__ line) as its input. Likewise, you may study said end-of-script example data to configure your own pre-report source data.


INPUT CRITERIA

The embeded examle DATA are so configured as to make usage self-evident. The rules are simple.

1. Matrix must be rectangular, columns delilmited by commas, rows by newlines.

2. First line must provide a UNIQUE title for each column.

3. One or more test sets must be provided. Each test set provides a name for itself in the 0th (far left) column, and an acceptance range in each subsequent column.

4. One or more data sets must be provided. Each data set provides a name for itself in the 0th (far left) column, and an acceptance range in each subsequent column.


BUGS AND LIMITATIONS

None discovered by author as yet.


AUTHOR

Gan Uesli Starling <gan@starling.us>


LICENSE AND COPYRIGHT

Copyright (c) 2007 by Gan Uesli Starling. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.