Add files via upload

Author: damianosmichaelides

DESCRIPTION

@@ -0,0 +1,28 @@
+Package: hassediagram
+Type: Package
+Title: Hasse diagram of the layout structure and restricted layout structure
+Version: 1.0
+Date: 2025-04-01
+Authors@R: 
+    c(person(given = "Damianos", family = "Michaelides", role = c("aut", "cre"), email = 	"[email protected]"),
+      person(given = "Simon", family = "Bate", role = c("aut"), email = 	"[email protected]"),
+      person(given = "Marion", family = "Chatfield", role = "aut"))
+Maintainer: Damianos Michaelides <[email protected]> and Simon Bate <[email protected]>
+Description: Returns a Hasse diagram of the 'layout structure' 
+	     or the 'restricted layout structure' of an experimental 
+	     design. 
+License: GPL-2
+Encoding: UTF-8
+URL: https://github.com/GSK-Biostatistics/hassediagram
+BugReports: https://github.com/GSK-Biostatistics/hassediagram/issues
+Imports: igraph, methods, MASS, grDevices, graphics, stats
+Depends: R (>= 3.5.0)
+Suggests: 
+    dae,
+    knitr,
+    rmarkdown,
+    jsonlite,
+    kableExtra
+LazyData: true
+RoxygenNote: 7.3.2
+VignetteBuilder: knitr

R/analytical.R

@@ -0,0 +1,27 @@
+#' A cross-nested design for an analytical method investigation
+#'
+#' The reliability of an analytical method was assessed in an experiment consisting of three batches of material, analysed by four analysts, two at each site. Within each site, there were two chromatographic systems and two columns. For each batch/analyst/system/column combination, two preparations (dissolved samples) were made. From each preparation, two injections were performed.
+#'
+#' @format A data frame of 192 observations on 8 variables/factors:
+#' \describe{
+#'   \item{Site}{Categoric factor with levels 1 and 2.}
+#'   \item{Analyst}{Categoric factor with levels 1-4.}
+#'   \item{Run}{Categoric factor with levels 1-16.}
+#'   \item{Prep}{Categoric factor with levels 1-96.}
+#'   \item{Injection}{Categoric factor with levels 1-192.}
+#'   \item{System}{Categoric factor with levels 1-4.}
+#'   \item{Column}{Categoric factor with levels 1-4.}
+#'   \item{Batch}{Categoric factor with levels 1-3.}
+#' }
+#'
+#' @source Bate, S.T. and Chatfield, M.J. (2016). "Identifying the Structure of the Experimental Design". *Journal of Quality Technology* 48, pp. 343-364.
+#'
+#' @examples
+#' data("analytical")
+#' analytical
+#'
+#' @keywords datasets
+#' @name analytical
+#' @docType data
+#' @usage data(analytical)
+NULL

R/concrete.R

@@ -0,0 +1,25 @@
+#' A fractional factorial design for investigating asphalt concrete production
+#'
+#' This is fractional factorial design given in Anderson and McLean (1974) p.256 from an experiment to investigate the effect of controllable variables/factors on the quality of asphalt concrete production.
+#'
+#' @format A half fraction factorial design of 16 runs on 6 variables/factors. The 6 variables/factors, each at two levels, included in the design are:
+#' \describe{
+#'   \item{Aggregate gradation (AG)}{Categoric factor with levels being fine and coarse.}
+#'   \item{Compaction temperature (CoT)}{Numeric factor with low 250 and high 300.}
+#'   \item{Asphalt content (AC)}{Numeric factor with low 5 and high 7.}
+#'   \item{Curing condition (CC)}{Categoric factor with levels wrapped and unwrapped.}
+#'   \item{Curing temperature (CuT)}{Numeric factor with low 45 and high 72.}
+#'   \item{Run}{Categoric factor with levels 1-16.}
+#' }
+#'
+#' @source Anderson, V.L. and McLean, R.A. (1974). *Design of Experiments.* Marcel Dekker Inc.: New York.
+#'
+#' @examples
+#' data("concrete")
+#' concrete
+#'
+#' @keywords datasets
+#' @name concrete
+#' @docType data
+#' @usage data(concrete)
+NULL

R/dental.R

@@ -0,0 +1,24 @@
+#' A crossover design for a dental study
+#'
+#' This is a crossover design (Study H) given in Newcombe et al. (1995) to study the effects of CHX rinses on 4 day plaque regrowth. The study consisted of 24 patients assessed over 3 treatment periods. The purpose of the study was to compare 2 CHX rinses with saline. The design is based on pairs of Latin squares balanced for carry over.
+#'
+#' @format A crossover design of 72 runs on 5 variables/factors. The 5 variables/factors included in the design are:
+#' \describe{
+#'   \item{Sequence}{Categoric factor with levels 1-6.}
+#'   \item{Subject}{Categoric factor with levels 1-32.}
+#'   \item{Period}{Categoric factor with levels 1-3.}
+#'   \item{Treatment}{Categoric factor with levels CHX1, CHX2 and Saline.}
+#'   \item{Observation}{Categoric factor with levels 1-72.}
+#' }
+#'
+#' @source Newcombe, R.G., Addy, M. and McKeown, S. (1995). "Residual effect of chlorhexidine gluconate in 4-day plaque regrowth crossover trials, and its implications for study design". *Journal of Periodontal Research*, 30, 5, pp. 319-324.
+#'
+#' @examples
+#' data("dental")
+#' dental
+#'
+#' @keywords datasets
+#' @name dental
+#' @docType data
+#' @usage data(dental)
+NULL

R/hassediagram.R

@@ -0,0 +1,44 @@
+#' @encoding UTF-8
+#' @title Hasse diagram of the layout structure and restricted layout structure
+#'
+#' @description
+#' Returns a Hasse diagram of the 'layout structure' or the 'restricted layout structure' 
+#' of an experimental design.
+#'
+#' @details
+#' The package consists of three main functions: \code{\link[hassediagram]{hasselayout}}, 
+#' \code{\link[hassediagram]{itemlist}}, and \code{\link[hassediagram]{hasserls}}. 
+#' The first function generates the Hasse diagram of the layout structure of an experimental design. 
+#' The latter two functions are used together to generate the Hasse diagram of the restricted layout 
+#' structure of an experimental design.
+#'
+#' @author
+#' Damianos Michaelides (Maintainer) <[email protected]>  
+#' Simon Bate <[email protected]>  
+#' Marion Chatfield  
+#'
+#' @seealso
+#' For dataset details, see:
+#' - \code{\link{concrete}}
+#' - \code{\link{dental}}
+#' - \code{\link{human}}
+#' - \code{\link{analytical}}
+#'
+#' @references
+#' Bate, S.T. and Chatfield, M.J. (2016a), Identifying the structure of the experimental design.  
+#' Journal of Quality Technology, 48, 343-364.
+#'
+#' Bate, S.T. and Chatfield, M.J. (2016b), Using the structure of the experimental design and  
+#' the randomization to construct a mixed model. Journal of Quality Technology, 48, 365-387.
+#'
+#' Box, G.E.P., Hunter, J.S., and Hunter, W.G., (1978), Statistics for Experimenters.  
+#' New York, Wiley.
+#'
+#' Joshi, D.D. (1987), Linear Estimation and Design of Experiments. Wiley Eastern, New Delhi.
+#'
+#' Williams, E.R., Matheson, A.C. and Harwood, C.E. (2002), Experimental design and analysis  
+#' for tree improvement. 2nd edition. CSIRO, Melbourne, Australia.
+#'
+#' @name hassediagram
+#' @keywords internal
+"_PACKAGE"