# Perform estimation on blockmodels for poisson probability distribution aith covariates With the provided network and blockmodel type, estimate number of groups, parameters and node membership, and impact vector of covariates ```r ## S4 method for signature 'new' BM_poisson_covariates( membership_type, adj, covariates, verbosity=6, autosave='', plotting=character(0), exploration_factor=1.5, exploration_direction=numeric(0), explore_min=4, explore_max=Inf, ncores=detectCores()) ``` ## Arguments - `membership_type`: The type of node membership, i.e. 'SBM', 'SBM_sym' or 'LBM' - `adj`: The adjacency matrix - `covariates`: Covariates matrix, or list of covariates matrices. Covariates matrix must have the same size than the adjacency matrix. - `verbosity`: The verbosity level, 0 means quiet. Level 1 display the phase of reinitialization. Level 2 display the level 1 and the ascending and descending phase for the number of groups. Level 3 display the level 2 and the number current number of groups which is estimated. Level 4 display the level 3 and the steps inside the estimation. Level 5 display the level 4, the current status of parallel running jobs and the current sub-step. Level 6 display level 5 and informations about ICL criteria found. Default is level 6. This parameter can be changed by accessing to the field $verbosity of the object. - `autosave`: If autosave != '', after each estimation, the model object is writed into file autosave . The model object is readable by the function readRDS . Use-it for long computation to allow restarting the estimation on system crash. You can use it to alanyze the partial results when the estimation is running. This parameter can be changed by accessing to the field $autosave of the object. - `plotting`: Control plot of ICL values while the estimation is running. If plotting==character(0) (the default), plots are done on screen, if plotting=='', no plot are done, if plotting is a filename, plots are done in this filename. This parameter can be changed by accessing the field $plotting of the object. - `exploration_factor`: Control the exploration of the number of groups. The exploration is stop when the number of groups reach exploration factor times the current maximum. By default 1.5. This parameter can be changed by accessing the field $exploration_factor of the object. - `explore_min`: Explore to the explore_min number of groups even if the exploration_factor rule is satisfied. By default 4. This parameter can be changed by accessing the field $explore_min of the object. - `explore_max`: Stop exploration after explore_max number of group in any case. By default Inf. This parameter can be changed by accessing the field $explore_max of the object. - `exploration_direction`: Only for LBM membership. Control the exploration direction for groups number. When provided, the exploring strategy is made to explore the provided group number. Must be a vector of two integer value representing the row group number and the column group number. - `ncores`: Number of parallel jobs to launch different EM intializations. By default detectCores(). This parameter can be changed by accessing the field $ncores of the object. This parameters is used only on Linux. Parallism is disabled on other plateform. (Not working on Windows, not tested on Mac OS, not tested on *BSD.) ## Examples ```r ## Not run: ## ## SBM ## ## generation of one SBM network npc <- 30 # nodes per class Q <- 3 # classes n <- npc * Q # nodes Z<-diag(Q)%x%matrix(1,npc,1) L<-70*matrix(runif(Q*Q),Q,Q) M_in_expectation_without_covariates<-Z%*%L%*%t(Z) Y1 <- matrix(runif(n*n),n,n) Y2 <- matrix(runif(n*n),n,n) M_in_expectation<-M_in_expectation_without_covariates*exp(4.2*Y1-1.2*Y2) M<-matrix( rpois( length(as.vector(M_in_expectation)), as.vector(M_in_expectation)) ,n,n) ## estimation my_model <- BM_poisson_covariates("SBM",M,list(Y1,Y2) ) my_model$estimate() which.max(my_model$ICL) ## ## SBM symmetric ## ## generation of one SBM_sym network, we re-use one produced for SBM npc <- 30 # nodes per class Q <- 3 # classes n <- npc * Q # nodes Z<-diag(Q)%x%matrix(1,npc,1) L<-70*matrix(runif(Q*Q),Q,Q) L[lower.tri(L)]<-t(L)[lower.tri(L)] M_in_expectation_without_covariates<-Z%*%L%*%t(Z) Y1 <- matrix(runif(n*n),n,n) Y2 <- matrix(runif(n*n),n,n) Y1[lower.tri(Y1)]<-t(Y1)[lower.tri(Y1)] Y2[lower.tri(Y2)]<-t(Y2)[lower.tri(Y2)] M_in_expectation<-M_in_expectation_without_covariates*exp(4.2*Y1-1.2*Y2) M<-matrix( rpois( length(as.vector(M_in_expectation)), as.vector(M_in_expectation)) ,n,n) M[lower.tri(M)]<-t(M)[lower.tri(M)] ## estimation my_model <- BM_poisson_covariates("SBM_sym",M,list(Y1,Y2) ) my_model$estimate() which.max(my_model$ICL) ## ## LBM ## ## generation of one LBM network npc <- c(50,40) # nodes per class Q <- c(2,3) # classes n <- npc * Q # nodes Z1<-diag(Q[1])%x%matrix(1,npc[1],1) Z2<-diag(Q[2])%x%matrix(1,npc[2],1) L<-70*matrix(runif(Q[1]*Q[2]),Q[1],Q[2]) M_in_expectation_without_covariates<-Z1%*%L%*%t(Z2) Y1 <- matrix(runif(n[1]*n[2]),n[1],n[2]) Y2 <- matrix(runif(n[1]*n[2]),n[1],n[2]) M_in_expectation<-M_in_expectation_without_covariates*exp(4.2*Y1-1.2*Y2) M<-matrix( rpois( length(as.vector(M_in_expectation)), as.vector(M_in_expectation)) ,n[1],n[2]) ## estimation my_model <- BM_poisson_covariates("LBM",M,list(Y1,Y2) ) my_model$estimate() which.max(my_model$ICL) ## End(Not run) ```

BM_poisson_covariates function