R/data.R

In ISMtools: Interpretive Structural Modelling Analysis Tools

#' Example ISM Data: Project Risk Factors
#'
#' A dataset containing an adjacency matrix representing relationships between
#' project risk factors. This example is useful for demonstrating ISM analysis
#' workflow.
#'
#' @format A 7x7 numeric matrix with row and column names F1 through F7,
#'   representing the following risk factors:
#' \describe{
#'   \item{F1}{Budget Constraints - financial limitations}
#'   \item{F2}{Resource Shortage - insufficient human or material resources}
#'   \item{F3}{Technical Complexity - challenging technical requirements}
#'   \item{F4}{Poor Communication - inadequate information flow}
#'   \item{F5}{Schedule Pressure - tight deadlines}
#'   \item{F6}{Quality Issues - defects and quality problems}
#'   \item{F7}{Project Failure - ultimate negative outcome}
#' }
#'
#' The matrix values indicate direct influence relationships:
#' \itemize{
#'   \item 1: Factor in row directly influences factor in column
#'   \item 0: No direct influence
#' }
#'
#' The relationships encoded are:
#' \itemize{
#'   \item F1 (Budget) -> F2 (Resource), F5 (Schedule)
#'   \item F2 (Resource) -> F3 (Technical), F6 (Quality)
#'   \item F3 (Technical) -> F6 (Quality)
#'   \item F4 (Communication) -> F2, F3, F6
#'   \item F5 (Schedule) -> F4 (Communication), F6 (Quality)
#'   \item F6 (Quality) -> F7 (Failure)
#' }
#'
#' @source Hypothetical example for demonstration purposes, based on common
#'   project management risk factor relationships.
#'
#' @seealso \code{\link{compute_reachability}}, \code{\link{level_partitioning}},
#'   \code{\link{micmac_analysis}}
#'
#' @examples
#' # Load the example data
#' data(ism_example)
#'
#' # View the adjacency matrix
#' print(ism_example)
#'
#' # Compute reachability matrix
#' reach <- compute_reachability(ism_example)
#' print(reach)
#'
#' # Perform level partitioning
#' levels <- level_partitioning(reach)
#' print(levels)
#'
#' # MICMAC analysis
#' micmac <- micmac_analysis(reach)
#' print(micmac)
#'
#' @docType data
#' @keywords datasets
#' @name ism_example
#' @usage data(ism_example)
"ism_example"