ucs-print - ASCII-format UCS data set for viewing and printing


  ucs-print [-i] [-p <lines>] [-d <digits>] data.ds.gz

  ucs-print [-o <file>] [-ps [-2] [-l]] [-p <lines>] [-d <digits>] data.ds.gz

  ucs-print [<options>] '*' 'am.%.pv' FROM data.ds.gz


Format data set as ASCII table for inclusion in text files, on-line viewing (in a terminal window, with --interactive option), and printing (in PostScript format, with --postscript option). The ucs-print utility automatically adjusts column widths and chooses an appropriate format for floating-point numbers. Boolean attributes are displayed as yes and no, while missing values are shown as NA.

In the first forms of the command (used in the first two examples above), all variables are displayed (which usually results in a very wide table). The name of the data set may be omitted, in which case data is read from STDIN.

In the second form, variables can be selected with a whitespace-separated list of UCS wildcard patterns (see the ucsexp manpage) or by explicitly specifying the variable names. This feature can also be used to re-order the columns or display a variable in multiple columns. The FROM clause is mandatory in this mode, but data can be read from STDIN by using - as the name of the data set.

Note that there may be some delay while the data set is read into memory and analysed, especially without the --pagesize option.



The code used to determine the screen height in --interactive mode may not work on some platforms. It has only been tested under Linux so far. If you are using the bash shell, you might try export LINES before running the ucs-print tool.


Copyright 2004 Stefan Evert.

This software is provided AS IS and the author makes no warranty as to its use and performance. You may use the software, redistribute and modify it under the same terms as Perl itself.