.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH GBDUMMYFY "1" "August 2017" "gbdummyfy ver. 5.6" "User Commands"
.SH NAME
gbdummyfy \- Produce dummies from labels
.SH SYNOPSIS
.B gbdummyfy
[\fI\,options\/\fR]
.SH DESCRIPTION
This command reads from standard input a text file with space
separated columns. The entry in one column (the first by default) are
considered labels and expanded into a matrix of dummies , i.e. of 0
and 1 values. The number of columns of the matrix is equal to the
number of different labels. Each row contains '1' in the place of the
associated labels in the sorted list of labels, and '0' everywehere
else. Since in general one less dummy variable is required than the
number of labels, you can remove one column of dummies using the
option '\-d'.
.SH OPTIONS
.TP
\fB\-h\fR
print this help
.TP
\fB\-c\fR
set the column of labels (default 1)
.TP
\fB\-d\fR
which column to remove, counting from 1 (default none)
.TP
\fB\-v\fR
print the labels and associated positions to standard error
.SH EXAMPLES
.TP
echo "a 1\enb 2" | gbdummyfy
create a 4x3 marix with dummy values
relative to labels 'a' and 'b'
.PP
This program requires awk or gawk. Notice that it simply expands the
data adding new columns. When using the resulting the resulting matrix
in other utilities, the user should specify explicitly which dummies
variable to use and how.
.PP
A simple linear dependency can be automatically generated for 'gblreg'
by inserting the following expression in the functional specification
.PP
`seq 3 12 | sed 's/\e(.*\e)/\e+d\e1\e*x\e1/' | tr \-d '\en'`
.PP
and
.PP
`seq 3 12 | sed 's/\e(.*\e)/,\e1=0/' | tr \-d '\en'`
.PP
among the initial conditions. In this case there are 10 different values
for the dummy. They occupy column positions from 3 to 12 and their initial
value is zero.
.SH AUTHOR
Written by Giulio Bottazzi
.SH "REPORTING BUGS"
Report bugs to <gbutils@googlegroups.com>
.PP
.br
Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>
.SH COPYRIGHT
Copyright \(co 2009\-2015 Giulio Bottazzi
.PP
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
(version 2) as published by the Free Software Foundation.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.