DEFM: Discrete Exponential Family Model (DEFM)

In defm: Estimation and Simulation of Multi-Binary Response Models

Discrete Exponential Family Model (DEFM)

Description

Discrete Exponential Family Models (DEFMs) are models from the exponential family that deal with discrete data. Here, we deal with binary arrays which can be used to represent, among other things, networks and multinomial binary Markov processes.

Discrete Exponential Family Models (DEFMs) are models from the exponential family that deal with discrete data. Here, we deal with binary arrays which can be used to represent, among other things, networks and multinomial binary Markov processes.

Usage

init_defm(m)

print_stats(m, i = 0L)

nterms_defm(m)

nrow_defm(m)

ncol_defm_y(m)

ncol_defm_x(m)

nobs_defm(m)

morder_defm(m)

new_defm(id, Y, X, order = 1)

Arguments

m	An object of class DEFM.
i	An integer scalar indicating which set of statistics to print (see details.)
id	Integer vector of length n. Observation ids, for example, person id.
Y	0/1 matrix of responses of n_y columns and n rows.
X	Numeric matrix of covariates of size n_x by n.
order	Integer. Order of the markov process, by default, 1.

Details

The print_stats function prints the supportset of the ith type of array in the model.

Value

An external pointer of class DEFM.

• nterms_defm returns the number of terms in the model.

• nrow_defm returns the number of rows in the model.

• ncol_defm_y returns the number of output variables in the model.

• ncol_defm_x returns the number of covariates in the model.

• nobs_defm returns the number of observations (events) in the model.

• morder_defm returns the order of the Markov process.

An external pointer of class DEFM.

References

Vega Yon, G. G., Pugh, M. J., & Valente, T. W. (2022). Discrete Exponential-Family Models for Multivariate Binary Outcomes (arXiv:2211.00627). arXiv. https://arxiv.org/abs/2211.00627

See Also

defm_mle() for maximum likelihood estimation and loglike_defm() for the log-likelihood function.

Examples

# Loading Valente's SNS data
data(valentesnsList)

mymodel <- new_defm(
  id = valentesnsList$id,
  Y = valentesnsList$Y,
  X = valentesnsList$X,
  order = 1
)

# Adding the intercept terms and a motif from tobacco to mj
term_defm_logit_intercept(mymodel)
term_defm_transition_formula(mymodel, "{y1, 0y2} > {y1, y2}")

# Initialize the model
init_defm(mymodel)

# Fitting the MLE

defm documentation built on Sept. 8, 2023, 6:06 p.m.