naginterfaces.library.contab.binary_​service

naginterfaces.library.contab.binary_service(x)

binary_service is a service function which may be used prior to calling binary() to calculate the frequency distribution of a set of dichotomous score patterns.

For full information please refer to the NAG Library document for g11sb

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/g11/g11sbf.html

Parameters

xbool, array-like, shape $(n,\text{ip})$

$x[\text{i}-1,\text{j}-1]$ must be set equal to $True$ if $x_{\text{i}\text{j}}=1$, and $False$ if $x_{\text{i}\text{j}}=0$, for $\text{j}=1,2,\dots ,p$, for $\text{i}=1,2,\dots ,n$.

Returns

nsint

The number of different score patterns, $s$.

xbool, ndarray, shape $(n,\text{ip})$

The first $s$ rows of $x$ contain the $s$ different score patterns.

irlint, ndarray, shape $\left(n\right)$

The frequency with which the $\text{l}$th row of $x$ occurs, for $\text{l}=1,2,\dots ,s$.

Raises

NagValueError

(errno $1$)

On entry, $n=⟨value⟩$.

Constraint: $n\ge 7$.

(errno $1$)

On entry, $\text{ip}=⟨value⟩$.

Constraint: $\text{ip}\ge 3$.

Notes

When each of $n$ individuals responds to each of $p$ dichotomous variables the data assumes the form of the matrix $X$ defined below

$$\begin{array}{c}X=\left[\begin{array}{cccc}{x}_{11}& x_{12}& \dots & x_{1p}\\ x_{21}& x_{22}& \dots & x_{2p}\\ ⋮& ⋮& & ⋮\\ x_{n1}& x_{n2}& \dots & x_{np}\end{array}\right]=\left[\begin{array}{c}{\underset{–}{x}}_1\\ {\underset{–}{x}}_2\\ ⋮\\ {\underset{–}{x}}_n\end{array}\right]\text{,}\end{array}$$

where the $x$ take the value of $0$ or $1$ and ${\underset{–}{x}}_{\text{l}}=(x_{\text{l}1},x_{\text{l}2},\dots ,x_{\text{l}p})$, for $\text{l}=1,2,\dots ,n$, denotes the score pattern of the $l$th individual. binary_service calculates the number of different score patterns, $s$, and the frequency with which each occurs. This information can then be passed to binary().