dummybr
==============================================
Purpose
----------------
Creates a set of dummy (0/1) variables. The highest (rightmost) category is bounded on the right.
Format
----------------
.. function:: y = dummybr(x, v)
:param x: data that is to be broken up into dummy variables
:type x: Nx1 vector
:param v: specifies the :math:`K` breakpoints (these must be in ascending order) that determine the :math:`K` categories to be used. These categories should not overlap.
:type v: Kx1 vector
:return y: containing the :math:`K` dummy variables. Each row will have a maximum of one 1.
:rtype y: NxK matrix
Examples
----------------
::
// Set seed for repeatable random numbers
rndseed 135345;
// Create uniform random integers between 1 and 9
x = ceil(9*rndu(5, 1));
// Set the breakpoints
v = { 1, 5, 7 };
dm = dummybr(x, v);
The code above produces three dummies based upon the breakpoints in the vector *v*:
::
x <= 1
1 < x <= 5
5 < x <= 7
which look like:
::
0 1 0 2
0 0 0 9
dm = 0 1 0 x = 4
0 0 1 7
1 0 0 1
Remarks
-------
* Missings are deleted before the dummy variables are created.
* All categories are open on the left (i.e., do not contain their left
boundaries) and are closed on the right (i.e., do contain their right
boundaries). Thus, :math:`K` breakpoints are required to specify :math:`K` dummy
variables.
* The function :func:`dummy` is similar to :func:`dummybr`, but in that function the
highest category is unbounded on the right.
Source
------
datatran.src
.. seealso:: Functions :func:`dummydn`, :func:`dummy`, :func:`code`, :func:`recode`, :func:`reclassifyCuts`, :func:`substute`, :func:`rescale`, :func:`reclassify`