From 9579bd8c3dafec94d45a04853925a9a662f99745 Mon Sep 17 00:00:00 2001 From: Julien Chiquet Date: Tue, 30 Jan 2024 08:00:45 +0100 Subject: [PATCH] updating doc with markdown syntax in place of LaTeX, source of errors --- R/estimate.R | 75 ++++++++++++---------------- R/fungusTreeNetwork.R | 13 +++-- R/multipartiteEcologicalNetwork.R | 12 ++--- R/plotAlluvial.R | 12 ++--- R/plotMyMatrix.R | 19 ++++--- R/plotMyMultipartiteMatrix.R | 21 ++++---- R/plotMyMultiplexMatrix.R | 21 ++++---- man/estimateBipartiteSBM.Rd | 12 ----- man/estimateMultipartiteSBM.Rd | 12 ++--- man/estimateMultiplexSBM.Rd | 24 ++++----- man/estimateSimpleSBM.Rd | 16 +++--- man/fungusTreeNetwork.Rd | 12 ++--- man/multipartiteEcologicalNetwork.Rd | 9 ++-- man/plotAlluvial.Rd | 10 ++-- man/plotMyMatrix.Rd | 16 +++--- man/plotMyMultipartiteMatrix.Rd | 18 +++---- man/plotMyMultiplexMatrix.Rd | 18 +++---- 17 files changed, 143 insertions(+), 177 deletions(-) diff --git a/R/estimate.R b/R/estimate.R index be9cb7f8..74c7c770 100644 --- a/R/estimate.R +++ b/R/estimate.R @@ -11,16 +11,15 @@ #' @param estimOptions a list of parameters controlling the inference algorithm and model selection. See details. #' #' @details The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters -#' \itemize{ -#' \item{"nbCores"}{integer for number of cores used. Default is 2} -#' \item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -#' \item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE} -#' \item{"exploreFactor"}{control the exploration of the number of groups} -#' \item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details.} -#' \item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details.} -#' \item{"nbBlocksRange"}{minimal and maximal number or blocks explored} -#' \item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}} -#' } +#' * "nbCores integer for number of cores used. Default is 2 +#' * "verbosity" integer for verbosity (0, 1). Default is 1 +#' * "plot" boolean, should the ICL by dynamically plotted or not. Default is TRUE +#' * "exploreFactor" control the exploration of the number of groups +#' * "exploreMin" explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. +#' * "exploreMax" Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. +#' * "nbBlocksRange" minimal and maximal number or blocks explored +#' * "fast" logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE} +#' #' @return a list with the estimated parameters. See details... #' #' @examples @@ -131,16 +130,8 @@ estimateSimpleSBM <- function(netMat, #' @param covariates a list of matrices with same dimension as mat describing covariates at the edge level. No covariate per Default. #' @param estimOptions a list of parameters controlling the inference algorithm and model selection. See details. #' -#' @details The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters -#' \itemize{ -#' \item{"nbCores"}{integer for number of cores used. Default is 2} -#' \item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -#' \item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE} -#' \item{"exploreFactor"}{control the exploration of the number of groups} -#' \item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details.} -#' \item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details.} -#' \item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}} -#' } +#' @inheritSection estimateSimpleSBM details +#' #' @return a list with the estimated parameters. See details... #' #' @examples @@ -231,14 +222,13 @@ estimateBipartiteSBM <- function(netMat, #' @param listSBM list of networks that were defined by the \code{defineSBM} function #' @param estimOptions options for the inference procedure #' @details The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters -#' \itemize{ -#' \item{"nbCores"}{integer for number of cores used. Default is 2} -#' \item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -#' \item{"nbBlocksRange"}{List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10)} -#' \item{"initBM"}{Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE} -#' \item{"maxiterVEM"}{Number of max. number of iterations in the VEM. Default value = 100} -#' \item{"maxiterVE"}{Number of max. number of iterations in the VE. Default value = 100} -#'} +#' * "nbCores" integer for number of cores used. Default is 2 +#' * "verbosity" integer for verbosity (0, 1). Default is 1 +#' * "nbBlocksRange" List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10) +#' * "initBM" Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE +#' * "maxiterVEM" Number of max. number of iterations in the VEM. Default value = 100 +#' * "maxiterVE" Number of max. number of iterations in the VE. Default value = 100 +#' #' @return a MultipartiteSBM_fit object with the estimated parameters and the blocks in each Functional Group #' @export #' @@ -304,22 +294,19 @@ estimateMultipartiteSBM <- function(listSBM, #' @param dependent logical parameter indicating whether the networks in the multiplex structure are dependent beyond the latent variables, #' @param estimOptions options for the inference procedure #' @details The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters -#' \itemize{ -#' \item{"nbCores"}{integer for number of cores used. Default is 2} -#' \item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -#' \item{"nbBlocksRange"}{List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10)} -#' \item{"initBM"}{Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE} -#' \item{"maxiterVEM"}{Number of max. number of iterations in the VEM. Default value = 100} -#' \item{"maxiterVE"}{Number of max. number of iterations in the VE. Default value = 100} -#' \item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE. For dependent networks} -#' \item{"exploreFactor"}{control the exploration of the number of groups. For dependent networks} -#' \item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. For dependent networks} -#' \item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. For dependent networks} -#' \item{"nbBlocksRange"}{minimal and maximal number or blocks explored. For dependent networks} -#' \item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}. For dependent networks} - - -#'} +#' * "nbCores" integer for number of cores used. Default is 2 +#' * "verbosity" integer for verbosity (0, 1). Default is 1 +#' * "nbBlocksRange" List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10) +#' * "initBM" Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE +#' * "maxiterVEM" Number of max. number of iterations in the VEM. Default value = 100 +#' * "maxiterVE" Number of max. number of iterations in the VE. Default value = 100 +#' * "plot" boolean, should the ICL by dynamically plotted or not. Default is TRUE. For dependent networks +#' * "exploreFactor" control the exploration of the number of groups. For dependent networks +#' * "exploreMin" explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. For dependent networks +#' * "exploreMax" Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. For dependent networks +#' * "nbBlocksRange" minimal and maximal number or blocks explored. For dependent networks +#' * "fast" logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}. For dependent networks +#' #' @return a MultiplexSBM_fit object with the estimated parameters and the blocks #' @export #' diff --git a/R/fungusTreeNetwork.R b/R/fungusTreeNetwork.R index 3934b227..6fa86245 100644 --- a/R/fungusTreeNetwork.R +++ b/R/fungusTreeNetwork.R @@ -3,12 +3,11 @@ #' This data set provides information about $154$ fungi sampled on $51$ tree species. #' #' @format A list with the following entries: -#' \describe{ -#' \item{fungi_list}{list of the fungus species names} -#' \item{tree_list}{list of the tree species names} -#' \item{fungus_tree}{binary fungus-tree interactions} -#' \item{tree_tree}{weighted tree-tree interactions (number of common fungal species two tree species host) } -#' \item{covar_tree}{covariates associated to pairs of trees (namely genetic, taxonomic and geographic distances)} -#' } +#' * fungi_list list of the fungus species names +#' * tree_list list of the tree species names +#' * fungus_tree binary fungus-tree interactions +#' * tree_tree weighted tree-tree interactions (number of common fungal species two tree species host) +#' * covar_tree covariates associated to pairs of trees (namely genetic, taxonomic and geographic distances) +#' #' @source Vacher, Corinne, Dominique Piou, and Marie-Laure Desprez-Loustau. "Architecture of an antagonistic tree/fungus network: the asymmetric influence of past evolutionary history." PloS one 3.3 (2008): e1740. "fungusTreeNetwork" diff --git a/R/multipartiteEcologicalNetwork.R b/R/multipartiteEcologicalNetwork.R index 8763267c..b2a3781a 100644 --- a/R/multipartiteEcologicalNetwork.R +++ b/R/multipartiteEcologicalNetwork.R @@ -3,11 +3,9 @@ #' Multipartite network of mutualistic interactions between plants and pollinators, plants and birds and plants and ants. #' #' @format A list a 3 binary incidence matrices -#' \describe{ -#' \item{Inc_plant_ant}{Interactions between plants (rows) and ants (cols). Matrix with 141 rows and 30 columns} -#' \item{Inc_plant_bird}{Interactions between plants (rows) and birds (cols). Matrix with141 rows and 46 columns} -#' \item{Inc_plant_flovis}{Interactions between plants (rows) and pollinators (cols). Matrix with 141 rows and 173 columns} -#' ... -#' } -#' @source Dataset compiled and conducted at Centro de Investigaciones Costeras La Mancha (CICOLMA), located on the central coast of the Gulf of Mexico, Veracruz, Mexico. \url{https://royalsocietypublishing.org/doi/full/10.1098/rspb.2016.1564} \url{https://github.com/lucaspdmedeiros/multi-network_core_removal/tree/master/data} +#' * Inc_plant_ant Interactions between plants (rows) and ants (cols). Matrix with 141 rows and 30 columns +#' * Inc_plant_bird Interactions between plants (rows) and birds (cols). Matrix with141 rows and 46 columns +#' * Inc_plant_flovis Interactions between plants (rows) and pollinators (cols). Matrix with 141 rows and 173 columns +#' +#' @source Dataset compiled and conducted at Centro de Investigaciones Costeras La Mancha (CICOLMA), located on the central coast of the Gulf of Mexico, Veracruz, Mexico. \url{https://royalsocietypublishing.org/doi/full/10.1098/rspb.2016.1564} \url{https://github.com/lucaspdmedeiros/multi-network_core_removal/tree/master/data} "multipartiteEcologicalNetwork" diff --git a/R/plotAlluvial.R b/R/plotAlluvial.R index 1fa9e9bf..3c3eeb1a 100644 --- a/R/plotAlluvial.R +++ b/R/plotAlluvial.R @@ -4,13 +4,11 @@ #' @param plotOptions : a list containing the options for Alluvial plots #' @details The list of parameters \code{plotOptions} provides the following options -#' \itemize{ -#' \item{"curvy"}{numeric, controls the curvature of the alluvial. Default value = 0.3} -#' \item{"alpha}{numeric, vector of transparency of the stripes. Default value = 0.8} -#' \item{"gap.width"}{numeric, relative width of inter-category gaps. Default value = 0.1} -#' \item{"col"}{vector of colors of the stripes. Default value = "darkolivegreen3"} -#' \item{"border"}{vector of border colors for the stripes. Default is white} -#' } +#' * "curvy" numeric, controls the curvature of the alluvial. Default value = 0.3 +#' * "alpha numeric, vector of transparency of the stripes. Default value = 0.8 +#' * "gap.width" numeric, relative width of inter-category gaps. Default value = 0.1 +#' * "col" vector of colors of the stripes. Default value = "darkolivegreen3" +#' * "border" vector of border colors for the stripes. Default is white #' #' @return display the alluvial plot, returns the plotOptions as a list #' @export diff --git a/R/plotMyMatrix.R b/R/plotMyMatrix.R index f3b91c96..1b92c708 100644 --- a/R/plotMyMatrix.R +++ b/R/plotMyMatrix.R @@ -5,16 +5,15 @@ #' @param clustering : a list of length 2 specifying a clustering on row and col #' @param plotOptions : a list providing options. See details below. #' @details The list of parameters \code{plotOptions} for the matrix plot is -#' \itemize{ -#' \item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -#' \item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -#' \item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -#' \item{"rowNames": }{Set true if the rownames must be plotted. Default value is FALSE} -#' \item{"colNames": }{Set true if the colNames must be plotted. Default value is FALSE} -#' \item{"line.color": }{Chain of character. The color of the lines to separate groups if a clustering is provided. Default value is red} -#' \item{"line.width": }{Numeric. Width of the lines to separate groups. Default value is NULL, automatically chosen} -#' \item{"title": }{Chain of character. Title of the plot. Default value is NULL} -#' } +#' * "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +#' * "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +#' * "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +#' * "rowNames": Set true if the rownames must be plotted. Default value is FALSE +#' * "colNames": Set true if the colNames must be plotted. Default value is FALSE +#' * "line.color": Chain of character. The color of the lines to separate groups if a clustering is provided. Default value is red +#' * "line.width": Numeric. Width of the lines to separate groups. Default value is NULL, automatically chosen +#' * "title": Chain of character. Title of the plot. Default value is NULL +#' #' @return a ggplot object corresponding to the plot #' @export #' diff --git a/R/plotMyMultipartiteMatrix.R b/R/plotMyMultipartiteMatrix.R index f5ec1956..183ff5a3 100644 --- a/R/plotMyMultipartiteMatrix.R +++ b/R/plotMyMultipartiteMatrix.R @@ -4,17 +4,16 @@ #' @param memberships : a list of length equal to the number of Functional Groups providing the clusterings inside each group. #' @param plotOptions : a list containing the options. See details. #' @details plotOptions is a list containing the following items -#' \itemize{ -#' \item{"normalized":}{Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE} -#' \item{"compact":}{Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view} -#' \item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -#' \item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -#' \item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -#' \item{"nodeNames": }{Set true if the node Names must be plotted. Default value is FALSE} -#' \item{"line.color":}{The color of the lines to separate groups. Default value is red} -#' \item{"line.width":}{Width of the lines to separate groups. Default value is NULL, automatically chosen} -#' \item{"title": }{Title of the plot. Default value is NULL} -#' } +#' * "normalized": Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE +#' * "compact": Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view +#' * "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +#' * "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +#' * "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +#' * "nodeNames": Set true if the node Names must be plotted. Default value is FALSE +#' * "line.color": The color of the lines to separate groups. Default value is red +#' * "line.width": Width of the lines to separate groups. Default value is NULL, automatically chosen +#' * "title": Title of the plot. Default value is NULL +#' #' @return a ggplot object corresponding to the plot #' @export #' diff --git a/R/plotMyMultiplexMatrix.R b/R/plotMyMultiplexMatrix.R index c03db1cf..67affdf0 100644 --- a/R/plotMyMultiplexMatrix.R +++ b/R/plotMyMultiplexMatrix.R @@ -4,17 +4,16 @@ #' @param memberships : a list of length equal to the number of Functional Groups providing the clusterings inside each group. #' @param plotOptions : a list containing the options. See details. #' @details plotOptions is a list containing the following items -#' \itemize{ -#' \item{"normalized":}{Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE} -#' \item{"compact":}{Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view} -#' \item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -#' \item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -#' \item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -#' \item{"nodeNames": }{Set true if the node Names must be plotted. Default value is FALSE} -#' \item{"line.color":}{The color of the lines to separate groups. Default value is red} -#' \item{"line.width":}{Width of the lines to separate groups. Default value is NULL, automatically chosen} -#' \item{"title": }{Title of the plot. Default value is NULL} -#' } +#' * "normalized": Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE +#' * "compact": Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view +#' * "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +#' * "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +#' * "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +#' * "nodeNames": Set true if the node Names must be plotted. Default value is FALSE +#' * "line.color": The color of the lines to separate groups. Default value is red +#' * "line.width": Width of the lines to separate groups. Default value is NULL, automatically chosen +#' * "title": Title of the plot. Default value is NULL +#' #' @return a ggplot object corresponding to the plot #' @export #' diff --git a/man/estimateBipartiteSBM.Rd b/man/estimateBipartiteSBM.Rd index 23685875..3b177786 100644 --- a/man/estimateBipartiteSBM.Rd +++ b/man/estimateBipartiteSBM.Rd @@ -30,18 +30,6 @@ a list with the estimated parameters. See details... This function performs variational inference of bipartite Stochastic Block Models, with various model for the distribution of the edges: Bernoulli, Poisson, or Gaussian models. } -\details{ -The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters -\itemize{ -\item{"nbCores"}{integer for number of cores used. Default is 2} -\item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -\item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE} -\item{"exploreFactor"}{control the exploration of the number of groups} -\item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details.} -\item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details.} -\item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}} -} -} \examples{ ### ======================================= ### BIPARTITE BINARY SBM (Bernoulli model) diff --git a/man/estimateMultipartiteSBM.Rd b/man/estimateMultipartiteSBM.Rd index 6345e2e5..c20bfbb6 100644 --- a/man/estimateMultipartiteSBM.Rd +++ b/man/estimateMultipartiteSBM.Rd @@ -20,12 +20,12 @@ Estimation for multipartite SBM \details{ The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters \itemize{ -\item{"nbCores"}{integer for number of cores used. Default is 2} -\item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -\item{"nbBlocksRange"}{List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10)} -\item{"initBM"}{Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE} -\item{"maxiterVEM"}{Number of max. number of iterations in the VEM. Default value = 100} -\item{"maxiterVE"}{Number of max. number of iterations in the VE. Default value = 100} +\item "nbCores" integer for number of cores used. Default is 2 +\item "verbosity" integer for verbosity (0, 1). Default is 1 +\item "nbBlocksRange" List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10) +\item "initBM" Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE +\item "maxiterVEM" Number of max. number of iterations in the VEM. Default value = 100 +\item "maxiterVE" Number of max. number of iterations in the VE. Default value = 100 } } \examples{ diff --git a/man/estimateMultiplexSBM.Rd b/man/estimateMultiplexSBM.Rd index 0c958e97..dfb3ce3f 100644 --- a/man/estimateMultiplexSBM.Rd +++ b/man/estimateMultiplexSBM.Rd @@ -22,18 +22,18 @@ Estimation for Multiplex SBM \details{ The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters \itemize{ -\item{"nbCores"}{integer for number of cores used. Default is 2} -\item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -\item{"nbBlocksRange"}{List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10)} -\item{"initBM"}{Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE} -\item{"maxiterVEM"}{Number of max. number of iterations in the VEM. Default value = 100} -\item{"maxiterVE"}{Number of max. number of iterations in the VE. Default value = 100} -\item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE. For dependent networks} -\item{"exploreFactor"}{control the exploration of the number of groups. For dependent networks} -\item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. For dependent networks} -\item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. For dependent networks} -\item{"nbBlocksRange"}{minimal and maximal number or blocks explored. For dependent networks} -\item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}. For dependent networks} +\item "nbCores" integer for number of cores used. Default is 2 +\item "verbosity" integer for verbosity (0, 1). Default is 1 +\item "nbBlocksRange" List of length the number of functional groups, each element supplying the minimal and maximal number of blocks to be explored. The names of the list must be the names of the functional groups. Default value is from 1 to 10) +\item "initBM" Boolean. True if using simple and bipartite SBM as initialisations. Default value = TRUE +\item "maxiterVEM" Number of max. number of iterations in the VEM. Default value = 100 +\item "maxiterVE" Number of max. number of iterations in the VE. Default value = 100 +\item "plot" boolean, should the ICL by dynamically plotted or not. Default is TRUE. For dependent networks +\item "exploreFactor" control the exploration of the number of groups. For dependent networks +\item "exploreMin" explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. For dependent networks +\item "exploreMax" Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. For dependent networks +\item "nbBlocksRange" minimal and maximal number or blocks explored. For dependent networks +\item "fast" logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}. For dependent networks } } \examples{ diff --git a/man/estimateSimpleSBM.Rd b/man/estimateSimpleSBM.Rd index af7cc702..c9e4b62c 100644 --- a/man/estimateSimpleSBM.Rd +++ b/man/estimateSimpleSBM.Rd @@ -36,14 +36,14 @@ for the distribution of the edges: Bernoulli, Poisson, or Gaussian models. \details{ The list of parameters \code{estimOptions} essentially tunes the optimization process and the variational EM algorithm, with the following parameters \itemize{ -\item{"nbCores"}{integer for number of cores used. Default is 2} -\item{"verbosity"}{integer for verbosity (0, 1). Default is 1} -\item{"plot"}{boolean, should the ICL by dynamically plotted or not. Default is TRUE} -\item{"exploreFactor"}{control the exploration of the number of groups} -\item{"exploreMin"}{explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details.} -\item{"exploreMax"}{Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details.} -\item{"nbBlocksRange"}{minimal and maximal number or blocks explored} -\item{"fast"}{logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE}} +\item "nbCores integer for number of cores used. Default is 2 +\item "verbosity" integer for verbosity (0, 1). Default is 1 +\item "plot" boolean, should the ICL by dynamically plotted or not. Default is TRUE +\item "exploreFactor" control the exploration of the number of groups +\item "exploreMin" explore at least until exploreMin even if the exploration factor rule is achieved. Default 4. See the package blockmodels for details. +\item "exploreMax" Stop exploration at exploreMax even if the exploration factor rule is not achieved. Default Inf. See the package blockmodels for details. +\item "nbBlocksRange" minimal and maximal number or blocks explored +\item "fast" logical: should approximation be used for Bernoulli model with covariates. Default to \code{TRUE} } } \examples{ diff --git a/man/fungusTreeNetwork.Rd b/man/fungusTreeNetwork.Rd index e9723f2e..7c3d3abd 100644 --- a/man/fungusTreeNetwork.Rd +++ b/man/fungusTreeNetwork.Rd @@ -6,12 +6,12 @@ \title{fungus-tree interaction network} \format{ A list with the following entries: -\describe{ -\item{fungi_list}{list of the fungus species names} -\item{tree_list}{list of the tree species names} -\item{fungus_tree}{binary fungus-tree interactions} -\item{tree_tree}{weighted tree-tree interactions (number of common fungal species two tree species host) } -\item{covar_tree}{covariates associated to pairs of trees (namely genetic, taxonomic and geographic distances)} +\itemize{ +\item fungi_list list of the fungus species names +\item tree_list list of the tree species names +\item fungus_tree binary fungus-tree interactions +\item tree_tree weighted tree-tree interactions (number of common fungal species two tree species host) +\item covar_tree covariates associated to pairs of trees (namely genetic, taxonomic and geographic distances) } } \source{ diff --git a/man/multipartiteEcologicalNetwork.Rd b/man/multipartiteEcologicalNetwork.Rd index 53f18bf5..ea6e5717 100644 --- a/man/multipartiteEcologicalNetwork.Rd +++ b/man/multipartiteEcologicalNetwork.Rd @@ -6,11 +6,10 @@ \title{Ecological multipartite interaction network} \format{ A list a 3 binary incidence matrices -\describe{ -\item{Inc_plant_ant}{Interactions between plants (rows) and ants (cols). Matrix with 141 rows and 30 columns} -\item{Inc_plant_bird}{Interactions between plants (rows) and birds (cols). Matrix with141 rows and 46 columns} -\item{Inc_plant_flovis}{Interactions between plants (rows) and pollinators (cols). Matrix with 141 rows and 173 columns} -... +\itemize{ +\item Inc_plant_ant Interactions between plants (rows) and ants (cols). Matrix with 141 rows and 30 columns +\item Inc_plant_bird Interactions between plants (rows) and birds (cols). Matrix with141 rows and 46 columns +\item Inc_plant_flovis Interactions between plants (rows) and pollinators (cols). Matrix with 141 rows and 173 columns } } \source{ diff --git a/man/plotAlluvial.Rd b/man/plotAlluvial.Rd index e0602fdb..f2c24e94 100644 --- a/man/plotAlluvial.Rd +++ b/man/plotAlluvial.Rd @@ -20,11 +20,11 @@ Plot an alluvial plot between clusterings \details{ The list of parameters \code{plotOptions} provides the following options \itemize{ -\item{"curvy"}{numeric, controls the curvature of the alluvial. Default value = 0.3} -\item{"alpha}{numeric, vector of transparency of the stripes. Default value = 0.8} -\item{"gap.width"}{numeric, relative width of inter-category gaps. Default value = 0.1} -\item{"col"}{vector of colors of the stripes. Default value = "darkolivegreen3"} -\item{"border"}{vector of border colors for the stripes. Default is white} +\item "curvy" numeric, controls the curvature of the alluvial. Default value = 0.3 +\item "alpha numeric, vector of transparency of the stripes. Default value = 0.8 +\item "gap.width" numeric, relative width of inter-category gaps. Default value = 0.1 +\item "col" vector of colors of the stripes. Default value = "darkolivegreen3" +\item "border" vector of border colors for the stripes. Default is white } } \examples{ diff --git a/man/plotMyMatrix.Rd b/man/plotMyMatrix.Rd index 298d66da..1dcc67c3 100644 --- a/man/plotMyMatrix.Rd +++ b/man/plotMyMatrix.Rd @@ -29,14 +29,14 @@ Plot an adjacency or incidence Matrix \details{ The list of parameters \code{plotOptions} for the matrix plot is \itemize{ -\item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -\item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -\item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -\item{"rowNames": }{Set true if the rownames must be plotted. Default value is FALSE} -\item{"colNames": }{Set true if the colNames must be plotted. Default value is FALSE} -\item{"line.color": }{Chain of character. The color of the lines to separate groups if a clustering is provided. Default value is red} -\item{"line.width": }{Numeric. Width of the lines to separate groups. Default value is NULL, automatically chosen} -\item{"title": }{Chain of character. Title of the plot. Default value is NULL} +\item "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +\item "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +\item "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +\item "rowNames": Set true if the rownames must be plotted. Default value is FALSE +\item "colNames": Set true if the colNames must be plotted. Default value is FALSE +\item "line.color": Chain of character. The color of the lines to separate groups if a clustering is provided. Default value is red +\item "line.width": Numeric. Width of the lines to separate groups. Default value is NULL, automatically chosen +\item "title": Chain of character. Title of the plot. Default value is NULL } } \examples{ diff --git a/man/plotMyMultipartiteMatrix.Rd b/man/plotMyMultipartiteMatrix.Rd index 2338861d..3d41dde3 100644 --- a/man/plotMyMultipartiteMatrix.Rd +++ b/man/plotMyMultipartiteMatrix.Rd @@ -22,15 +22,15 @@ Plot the matrices corresponding to a Multipartite Network \details{ plotOptions is a list containing the following items \itemize{ -\item{"normalized":}{Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE} -\item{"compact":}{Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view} -\item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -\item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -\item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -\item{"nodeNames": }{Set true if the node Names must be plotted. Default value is FALSE} -\item{"line.color":}{The color of the lines to separate groups. Default value is red} -\item{"line.width":}{Width of the lines to separate groups. Default value is NULL, automatically chosen} -\item{"title": }{Title of the plot. Default value is NULL} +\item "normalized": Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE +\item "compact": Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view +\item "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +\item "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +\item "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +\item "nodeNames": Set true if the node Names must be plotted. Default value is FALSE +\item "line.color": The color of the lines to separate groups. Default value is red +\item "line.width": Width of the lines to separate groups. Default value is NULL, automatically chosen +\item "title": Title of the plot. Default value is NULL } } \examples{ diff --git a/man/plotMyMultiplexMatrix.Rd b/man/plotMyMultiplexMatrix.Rd index be06da09..d765170c 100644 --- a/man/plotMyMultiplexMatrix.Rd +++ b/man/plotMyMultiplexMatrix.Rd @@ -22,15 +22,15 @@ Plot the matrices corresponding to a Multiplex Network \details{ plotOptions is a list containing the following items \itemize{ -\item{"normalized":}{Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE} -\item{"compact":}{Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view} -\item{"legend": }{Boolean. Set TRUE if you want to see the legend. Default value is FALSE} -\item{"legend.title": }{Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE} -\item{"legend.position": }{Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom'} -\item{"nodeNames": }{Set true if the node Names must be plotted. Default value is FALSE} -\item{"line.color":}{The color of the lines to separate groups. Default value is red} -\item{"line.width":}{Width of the lines to separate groups. Default value is NULL, automatically chosen} -\item{"title": }{Title of the plot. Default value is NULL} +\item "normalized": Boolean. TRUE if the various matrices are presented in the same scale (between O and 1). FALSE otherwise. Default value FALSE +\item "compact": Boolean. Default value is TRUE if you ask for the matrices to be transposed to have a more compact view +\item "legend": Boolean. Set TRUE if you want to see the legend. Default value is FALSE +\item "legend.title": Boolean. Set TRUE if you want to print the title of the legend. Default value is FALSE +\item "legend.position": Position of the legend. Possible values are 'bottom', 'top','left,'right'. Default value is 'bottom' +\item "nodeNames": Set true if the node Names must be plotted. Default value is FALSE +\item "line.color": The color of the lines to separate groups. Default value is red +\item "line.width": Width of the lines to separate groups. Default value is NULL, automatically chosen +\item "title": Title of the plot. Default value is NULL } } \examples{