diff --git a/.circleci/config.yml b/.circleci/config.yml index a59ed99d..ec6d40e9 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -22,7 +22,7 @@ jobs: sudo apt-get install -y r-base-core cmake - run: command: | - sudo apt-get install -y libxml2-dev + sudo apt-get install -y libxml2-dev libuv1-dev - run: command: | echo "options(Ncpus=4)" >> ~/.Rprofile diff --git a/.github/workflows/dsBase_test_suite.yaml b/.github/workflows/dsBase_test_suite.yaml index 8f03b10f..bea80e31 100755 --- a/.github/workflows/dsBase_test_suite.yaml +++ b/.github/workflows/dsBase_test_suite.yaml @@ -15,7 +15,6 @@ on: push: schedule: - cron: '0 0 * * 0' # Weekly - - cron: '0 1 * * *' # Nightly jobs: dsBase_test_suite: @@ -153,19 +152,22 @@ jobs: echo "branch:${{ env.BRANCH_NAME }}" > ${{ env.WORKFLOW_ID }}.txt echo "os:$(lsb_release -ds)" >> ${{ env.WORKFLOW_ID }}.txt echo "R:$(R --version | head -n1)" >> ${{ env.WORKFLOW_ID }}.txt + Rscript --vanilla -e 'sessionInfo()' >> session_info_${{ env.WORKFLOW_ID }}.txt working-directory: dsBase/logs - name: Parse results from testthat and covr run: | - Rscript --verbose --vanilla ../testStatus/source/parse_test_report.R logs/ + Rscript --verbose --vanilla ../testStatus/source/parse_test_report.R logs/ logs/ https://github.com/datashield/${{ env.PROJECT_NAME }}/blob/${{ env.BRANCH_NAME }} '[^-:.]+' '(?<=::)[^:]+(?=::)' working-directory: dsBase + env: + PROJECT_NAME: ${{ env.PROJECT_NAME }} + BRANCH_NAME: ${{ env.BRANCH_NAME }} - name: Render report run: | cd testStatus mkdir -p new/logs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/${{ env.WORKFLOW_ID }}/ - mkdir -p new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/${{ env.WORKFLOW_ID }}/ mkdir -p new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/latest/ # Copy logs to new logs directory location @@ -173,8 +175,7 @@ jobs: cp -rv ../${{ env.PROJECT_NAME }}/logs/${{ env.WORKFLOW_ID }}.txt new/logs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/${{ env.WORKFLOW_ID }}/ R -e 'input_dir <- file.path("../new/logs", Sys.getenv("PROJECT_NAME"), Sys.getenv("BRANCH_NAME"), Sys.getenv("WORKFLOW_ID")); quarto::quarto_render("source/test_report.qmd", execute_params = list(input_dir = input_dir))' - mv source/test_report.html new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/${{ env.WORKFLOW_ID }}/index.html - cp -r new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/${{ env.WORKFLOW_ID }}/* new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/latest + mv source/test_report.html new/docs/${{ env.PROJECT_NAME }}/${{ env.BRANCH_NAME }}/latest/index.html env: PROJECT_NAME: ${{ env.PROJECT_NAME }} diff --git a/DESCRIPTION b/DESCRIPTION index 52c47835..aa62b700 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -59,12 +59,15 @@ Authors@R: c(person(given = "Paul", comment = c(ORCID = "0009-0003-2419-1964"))) License: GPL-3 Depends: - R (>= 4.0.0) + R (>= 4.1.0) Imports: RANN, stringr, lme4, dplyr, + tibble, + purrr, + tidyselect, reshape2, polycor (>= 0.8), splines, diff --git a/NAMESPACE b/NAMESPACE index 21bac77d..e4fd38c9 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -42,7 +42,12 @@ export(elsplineDS) export(expDS) export(extractQuantilesDS1) export(extractQuantilesDS2) +export(fixClassDS) +export(fixColsDS) +export(fixLevelsDS) export(gamlssDS) +export(getAllLevelsDS) +export(getClassAllColsDS) export(getWGSRDS) export(glmDS1) export(glmDS2) @@ -84,6 +89,7 @@ export(matrixDimnamesDS) export(matrixInvertDS) export(matrixMultDS) export(matrixTransposeDS) +export(mdPatternDS) export(meanDS) export(meanSdGpDS) export(mergeDS) @@ -140,7 +146,17 @@ import(dplyr) import(gamlss) import(gamlss.dist) import(mice) +importFrom(dplyr,"%>%") +importFrom(dplyr,across) +importFrom(dplyr,mutate) +importFrom(dplyr,select) importFrom(gamlss.dist,pST3) importFrom(gamlss.dist,qST3) importFrom(glue,glue) importFrom(glue,glue_collapse) +importFrom(purrr,imap) +importFrom(purrr,map) +importFrom(purrr,set_names) +importFrom(tibble,as_tibble) +importFrom(tidyselect,all_of) +importFrom(tidyselect,peek_vars) diff --git a/R/glmSLMADS.assign.R b/R/glmSLMADS.assign.R index 275e1f47..68fe6929 100644 --- a/R/glmSLMADS.assign.R +++ b/R/glmSLMADS.assign.R @@ -18,40 +18,25 @@ #' @export glmSLMADS.assign <- function(formula, family, offsetName, weightsName, dataName){ -############################################################# -#MODULE 1: CAPTURE THE nfilter SETTINGS # -thr <- dsBase::listDisclosureSettingsDS() # -nfilter.tab <- as.numeric(thr$nfilter.tab) # -nfilter.glm <- as.numeric(thr$nfilter.glm) # -#nfilter.subset<-as.numeric(thr$nfilter.subset) # -#nfilter.string<-as.numeric(thr$nfilter.string) # -############################################################# + # Convert transmitable text for special link variance combinations back to full representation + if(family=="quasigamma.link_log") + {family<-"quasi(link=log,variance=mu^2)"} -######################################## -############ -#Convert transmitable text for special link variance combinations back to full representation -if(family=="quasigamma.link_log") -{family<-"quasi(link=log,variance=mu^2)"} + if(family=="Gamma.link_log") + {family<-"Gamma(link=log)"} -if(family=="Gamma.link_log") -{family<-"Gamma(link=log)"} -############# + # Correctly name offset, weights and data objects in function call + # (to allow glmPredict to work correctly later) + calltext <- paste0("mg<-glm(formula,family=",family,",offset=", + offsetName,",weights=",weightsName,",data=", dataName,",x=TRUE)") -#Activate family object (this may not be necessary as character string may already be OK -#but just checking -final.family.object<-eval(parse(text=family)) + eval(parse(text=calltext)) + # update the call object to include the actual formula + mg$call$formula <- formula -#Correctly name offset, weights and data objects in function call -#(to allow glmPredict to work correctly later) -calltext<-paste0("mg<-glm(formula,family=",family,",offset=", - offsetName,",weights=",weightsName,",data=", dataName,",x=TRUE)") - -eval(parse(text=calltext)) - -return(mg) + return(mg) } - # ASSIGN FUNCTION # glmSLMADS.assign diff --git a/R/mdPatternDS.R b/R/mdPatternDS.R new file mode 100644 index 00000000..0f817034 --- /dev/null +++ b/R/mdPatternDS.R @@ -0,0 +1,121 @@ +#' +#' @title Missing data pattern with disclosure control +#' @description This function is a serverside aggregate function that computes the +#' missing data pattern using mice::md.pattern and applies disclosure control to +#' prevent revealing small cell counts. +#' @details This function calls the mice::md.pattern function to generate a matrix +#' showing the missing data patterns in the input data. To ensure disclosure control, +#' any pattern counts that are below the threshold (nfilter.tab, default=3) are +#' suppressed. +#' +#' \strong{Suppression Method:} +#' +#' When a pattern count is below threshold: +#' - Row name is changed to "suppressed()" where N is the threshold +#' - All pattern values in that row are set to NA +#' - Summary row is also set to NA (prevents back-calculation) +#' +#' \strong{Output Matrix Structure:} +#' +#' - Rows represent different missing data patterns (plus a summary row at the bottom) +#' - Row names contain pattern counts (or "suppressed()" for invalid patterns) +#' - Columns show 1 if variable is observed, 0 if missing +#' - Last column shows total number of missing values per pattern +#' - Last row shows total number of missing values per variable +#' +#' \strong{Note for Pooling:} +#' +#' When this function is called from ds.mdPattern with type='combine', suppressed +#' patterns are excluded from pooling to prevent disclosure through subtraction. +#' This means pooled counts may underestimate the true total when patterns are +#' suppressed in some studies. +#' +#' @param x a character string specifying the name of a data frame or matrix +#' containing the data to analyze for missing patterns. +#' @return A list containing: +#' \item{pattern}{The missing data pattern matrix with disclosure control applied} +#' \item{valid}{Logical indicating if all patterns meet disclosure requirements} +#' \item{message}{A message describing the validity status} +#' @author Xavier Escribà montagut for DataSHIELD Development Team +#' @import mice +#' @export +#' +mdPatternDS <- function(x){ + + ############################################################# + # MODULE 1: CAPTURE THE nfilter SETTINGS + thr <- dsBase::listDisclosureSettingsDS() + nfilter.tab <- as.numeric(thr$nfilter.tab) + ############################################################# + + # Parse the input data name with error handling + x.val <- tryCatch( + { + eval(parse(text=x), envir = parent.frame()) + }, + error = function(e) { + stop(paste0("Object '", x, "' does not exist on the server"), call. = FALSE) + } + ) + + # Check object class + typ <- class(x.val) + + # Check that input is a data frame or matrix + if(!("data.frame" %in% typ || "matrix" %in% typ)){ + stop(paste0("The input object must be of type 'data.frame' or 'matrix'. Current type: ", + paste(typ, collapse = ", ")), call. = FALSE) + } + + # Use x.val for further processing + x <- x.val + + # Call mice::md.pattern with plot=FALSE + pattern <- mice::md.pattern(x, plot = FALSE) + + # Apply disclosure control + # Pattern counts are stored in row names (except last row which is empty/summary) + # The last row contains variable-level missing counts + + validity <- "valid" + n_patterns <- nrow(pattern) - 1 # exclude the summary row + + if(n_patterns > 0){ + # Check pattern counts (stored in row names, excluding last row) + pattern_counts <- as.numeric(rownames(pattern)[1:n_patterns]) + + # Find patterns with counts below threshold + invalid_idx <- which(pattern_counts > 0 & pattern_counts < nfilter.tab) + + if(length(invalid_idx) > 0){ + validity <- "invalid" + + # For invalid patterns, suppress by: + # - Setting row name to "suppressed" + # - Setting all pattern values to NA + rnames <- rownames(pattern) + for(idx in invalid_idx){ + rnames[idx] <- paste0("suppressed(<", nfilter.tab, ")") + pattern[idx, ] <- NA + } + rownames(pattern) <- rnames + + # Also need to recalculate the last row (summary) if patterns were suppressed + # Set to NA to avoid disclosures + pattern[nrow(pattern), seq_len(ncol(pattern))] <- NA + } + } + + # Return the pattern with validity information + return(list( + pattern = pattern, + valid = (validity == "valid"), + message = ifelse(validity == "valid", + "Valid: all pattern counts meet disclosure requirements", + paste0("Invalid: some pattern counts below threshold (", + nfilter.tab, ") have been suppressed")) + )) +} + +#AGGREGATE FUNCTION +# mdPatternDS diff --git a/R/standardiseDfDS.R b/R/standardiseDfDS.R new file mode 100644 index 00000000..24e3eecf --- /dev/null +++ b/R/standardiseDfDS.R @@ -0,0 +1,133 @@ +#' Get the Class of All Columns in a Data Frame +#' @param df.name A string representing the name of the data frame. +#' @return A tibble with the class of each column in the data frame. +#' @importFrom dplyr %>% +#' @importFrom tibble as_tibble +#' @importFrom purrr map +#' @export +getClassAllColsDS <- function(df.name){ + dsBase::checkPermissivePrivacyControlLevel(c('permissive', 'banana', 'carrot')) + + df.name <- eval(parse(text = df.name), envir = parent.frame()) + all_classes <- map(df.name, class) %>% as_tibble() + return(all_classes) +} + +#' Change Class of Target Variables in a Data Frame +#' @param df.name A string representing the name of the data frame. +#' @param target_vars A character vector specifying the columns to be modified. +#' @param target_class A character vector specifying the new classes for each column (1 = factor, +#' 2 = integer, 3 = numeric, 4 = character, 5 = logical). +#' @return A modified data frame with the specified columns converted to the target classes. +#' @importFrom dplyr mutate across +#' @importFrom tidyselect all_of +#' @export +fixClassDS <- function(df.name, target_vars, target_class) { + dsBase::checkPermissivePrivacyControlLevel(c('permissive', 'banana', 'carrot')) + + df <- eval(parse(text = df.name), envir = parent.frame()) + df_transformed <- df %>% + mutate( + across(all_of(target_vars), + ~ .convertClass(.x, target_class[which(target_vars == cur_column())]))) + return(df_transformed) +} + +#' Convert a Vector to a Specified Class +#' @param x The vector to be converted. +#' @param class_name A string indicating the target class (1 = factor, 2 = integer, 3 = numeric, +#' 4 = character, 5 = logical). +#' @return The converted vector. +#' @noRd +.convertClass <- function(target_var, target_class_code) { + switch(target_class_code, + "1" = as.factor(target_var), + "2" = as.integer(target_var), + "3" = as.numeric(target_var), + "4" = as.character(target_var), + "5" = as.logical(target_var) + ) +} + +#' Add Missing Columns with NA Values +#' @param .data A string representing the name of the data frame. +#' @param cols A character vector specifying the columns to be added if missing. +#' @return A modified data frame with missing columns added and filled with NA. +#' @importFrom dplyr mutate select +#' @importFrom tidyselect peek_vars +#' @importFrom purrr set_names +#' @export +fixColsDS <- function(.data, cols) { + dsBase::checkPermissivePrivacyControlLevel(c('permissive', 'banana', 'carrot')) + + .data <- eval(parse(text = .data), envir = parent.frame()) + missing <- setdiff(cols, colnames(.data)) + out <- .data %>% + mutate(!!!set_names(rep(list(NA), length(missing)), missing)) %>% + select(sort(peek_vars())) + return(out) +} + +#' Retrieve Factor Levels for Specific Columns +#' @param df.name A string representing the name of the data frame. +#' @param factor_vars A character vector specifying the factor columns. +#' @return A list of factor levels for the specified columns. +#' @importFrom tidyselect all_of +#' @importFrom purrr map imap +#' @export +getAllLevelsDS <- function(df.name, factor_vars) { + dsBase::checkPermissivePrivacyControlLevel(c('permissive', 'banana', 'carrot')) + + df <- eval(parse(text = df.name), envir = parent.frame()) + factor_vars_split <- strsplit(factor_vars, ",\\s*")[[1]] + levels <- purrr::map(df[factor_vars_split], base::levels) + + disclosure_check <- imap(levels, function(lvls, var) { + .checkLevelsDisclosure(df = df, var = var, levels = lvls) + }) + + failed_vars <- names(disclosure_check)[unlist(disclosure_check)] + + if(length(failed_vars) > 0) { + stop("Based on the value of nfilter.levels.density, these factor variables", " {", failed_vars, "} ", "have too many levels compared to the length of the variable. Please reduce the numnber of levels or change the variable type and try again") + } else { + return(levels) + } +} + +#' Check variable levels against disclosure thresholds +#' +#' Internal helper function to verify whether the number of levels in a variable +#' exceeds the allowed density threshold defined by `dsBase::listDisclosureSettingsDS()`. +#' +#' @param df A data frame containing the variable. +#' @param var Character string. Name of the variable to check. +#' @param levels Character vector. Levels of the variable. +#' +#' @return Logical. `TRUE` if the check fails (i.e., disclosure threshold is violated), +#' otherwise `FALSE`. +#' +#' @keywords internal +#' @noRd +.checkLevelsDisclosure <- function(df, var, levels) { + thr <- dsBase::listDisclosureSettingsDS() + nfilter.levels.density <- as.numeric(thr$nfilter.levels.density) + n_levels <- length(levels) + length_var <- length(df[[var]]) + fail <- (length_var * nfilter.levels.density) < n_levels + return(fail) +} + +#' Set Factor Levels for Specific Columns in a Data Frame +#' @param df.name A string representing the name of the data frame to modify. +#' @param vars A character vector specifying the columns to be modified. +#' @param levels A named list where each element contains the levels for the corresponding factor variable. +#' @return A modified data frame with the specified columns converted to factors with the provided levels. +#' @export +fixLevelsDS <- function(df.name, vars, levels) { + dsBase::checkPermissivePrivacyControlLevel(c('permissive', 'banana', 'carrot')) + + df.name <- eval(parse(text = df.name), envir = parent.frame()) + out <- df.name %>% + mutate(across(all_of(vars), ~factor(., levels = levels[[dplyr::cur_column()]]))) +} diff --git a/README.md b/README.md index bf9c1ada..fc5911ab 100644 --- a/README.md +++ b/README.md @@ -23,8 +23,8 @@ And the development version from install.packages("remotes") remotes::install_github("datashield/dsBase", "") -# Install v6.3.4 with the following -remotes::install_github("datashield/dsBase", "6.3.4") +# Install v6.3.6 with the following +remotes::install_github("datashield/dsBase", "6.3.6") ``` For a full list of development branches, checkout https://github.com/datashield/dsBase/branches diff --git a/_pkgdown.yml b/_pkgdown.yml index 4c98f6e5..4dc66bb0 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -1,3 +1,4 @@ template: + bootstrap: 5 params: bootswatch: simplex diff --git a/azure-pipelines.yml b/azure-pipelines.yml index a0e6a96c..7eb3e47e 100644 --- a/azure-pipelines.yml +++ b/azure-pipelines.yml @@ -27,6 +27,7 @@ variables: branchName: $(Build.SourceBranchName) test_filter: '*' _r_check_system_clock_: 0 + PERF_PROFILE: 'azure-pipeline' @@ -46,17 +47,18 @@ resources: # When and under what condition to run the pipeline. schedules: - cron: "0 0 * * 0" - displayName: Weekly build - master + displayName: Weekly build - latest release branches: include: - - master - - 6.3.0 + - 6.3.4 always: true - cron: "0 1 * * *" - displayName: Nightly build - v6.3.1-dev + displayName: Nightly build - development branchs branches: include: - - v6.3.1-dev + - v6.3.5-dev + - v6.4.0-dev + - v7.0.0-dev always: true jobs: @@ -188,6 +190,7 @@ jobs: # testthat::testpackage uses a MultiReporter, comprised of a ProgressReporter and JunitReporter # R output and messages are redirected by sink() to test_console_output.txt # junit reporter output is to test_results.xml + sudo R -q -e ' library(covr); write.csv( @@ -250,7 +253,6 @@ jobs: echo 'branch:'$(branchName) >> $(datetime).txt echo 'os:'$(lsb_release -ds) >> $(datetime).txt echo 'R:'$(R --version | head -n 1) >> $(datetime).txt - echo 'opal:'$(opal system --opal localhost:8080 --user administrator --password "datashield_test&" --version) >> $(datetime).txt workingDirectory: $(Pipeline.Workspace)/logs displayName: 'Write versions to file' diff --git a/docs/404.html b/docs/404.html index bd9ca2cd..17940f30 100644 --- a/docs/404.html +++ b/docs/404.html @@ -4,90 +4,70 @@ - + Page not found (404) • dsBase - - - - - - - + + + + + - - - -
-
-
-

Page not found (404)

+
Content not found. Please use links in the navbar. -
- - - +
- -
-

-

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

+
+

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

-
-

-

Site built with pkgdown 2.1.3.

+
+

Site built with pkgdown 2.2.0.

-
+
- diff --git a/docs/404.md b/docs/404.md new file mode 100644 index 00000000..5107f896 --- /dev/null +++ b/docs/404.md @@ -0,0 +1,3 @@ +Content not found. Please use links in the navbar. + +# Page not found (404) diff --git a/docs/LICENSE.html b/docs/LICENSE.html index f075675a..5c5d210e 100644 --- a/docs/LICENSE.html +++ b/docs/LICENSE.html @@ -1,40 +1,33 @@ -NA • dsBase +NA • dsBase + Skip to contents -
-
-
-
+
+
+
+
+

NA

+
@@ -245,26 +238,18 @@

NA

The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read https://www.gnu.org/licenses/why-not-lgpl.html.

-
- - - -
- +
-
-

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

+
+

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

-
-

Site built with pkgdown 2.1.3.

+
+

Site built with pkgdown 2.2.0.

-
- +
diff --git a/docs/LICENSE.md b/docs/LICENSE.md new file mode 100644 index 00000000..918fff13 --- /dev/null +++ b/docs/LICENSE.md @@ -0,0 +1,694 @@ +# NA + +``` R + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 +``` + +Copyright (C) 2007 Free Software Foundation, Inc.  +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. + +``` R + Preamble +``` + +The GNU General Public License is a free, copyleft license for software +and other kinds of works. + +The licenses for most software and other practical works are designed to +take away your freedom to share and change the works. By contrast, the +GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program–to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + +When we speak of free software, we are referring to freedom, not price. +Our General Public Licenses are designed to make sure that you have the +freedom to distribute copies of free software (and charge for them if +you wish), that you receive source code or can get it if you want it, +that you can change the software or use pieces of it in new free +programs, and that you know you can do these things. + +To protect your rights, we need to prevent others from denying you these +rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + +For example, if you distribute copies of such a program, whether gratis +or for a fee, you must pass on to the recipients the same freedoms that +you received. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + +Developers that use the GNU GPL protect your rights with two steps: (1) +assert copyright on the software, and (2) offer you this License giving +you legal permission to copy, distribute and/or modify it. + +For the developers’ and authors’ protection, the GPL clearly explains +that there is no warranty for this free software. For both users’ and +authors’ sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + +Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of protecting +users’ freedom to change the software. The systematic pattern of such +abuse occurs in the area of products for individuals to use, which is +precisely where it is most unacceptable. Therefore, we have designed +this version of the GPL to prohibit the practice for those products. If +such problems arise substantially in other domains, we stand ready to +extend this provision to those domains in future versions of the GPL, as +needed to protect the freedom of users. + +Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + +The precise terms and conditions for copying, distribution and +modification follow. + +``` R + TERMS AND CONDITIONS +``` + +0. Definitions. + +“This License” refers to version 3 of the GNU General Public License. + +“Copyright” also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + +“The Program” refers to any copyrightable work licensed under this +License. Each licensee is addressed as “you”. “Licensees” and +“recipients” may be individuals or organizations. + +To “modify” a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a “modified version” of the +earlier work or a work “based on” the earlier work. + +A “covered work” means either the unmodified Program or a work based on +the Program. + +To “propagate” a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + +To “convey” a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + +An interactive user interface displays “Appropriate Legal Notices” to +the extent that it includes a convenient and prominently visible feature +that (1) displays an appropriate copyright notice, and (2) tells the +user that there is no warranty for the work (except to the extent that +warranties are provided), that licensees may convey the work under this +License, and how to view a copy of this License. If the interface +presents a list of user commands or options, such as a menu, a prominent +item in the list meets this criterion. + +1. Source Code. + +The “source code” for a work means the preferred form of the work for +making modifications to it. “Object code” means any non-source form of a +work. + +A “Standard Interface” means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that is +widely used among developers working in that language. + +The “System Libraries” of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that Major +Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A “Major +Component”, in this context, means a major essential component (kernel, +window system, and so on) of the specific operating system (if any) on +which the executable work runs, or a compiler used to produce the work, +or an object code interpreter used to run it. + +The “Corresponding Source” for a work in object code form means all the +source code needed to generate, install, and (for an executable work) +run the object code and to modify the work, including scripts to control +those activities. However, it does not include the work’s System +Libraries, or general-purpose tools or generally available free programs +which are used unmodified in performing those activities but which are +not part of the work. For example, Corresponding Source includes +interface definition files associated with source files for the work, +and the source code for shared libraries and dynamically linked +subprograms that the work is specifically designed to require, such as +by intimate data communication or control flow between those subprograms +and other parts of the work. + +The Corresponding Source need not include anything that users can +regenerate automatically from other parts of the Corresponding Source. + +The Corresponding Source for a work in source code form is that same +work. + +2. Basic Permissions. + +All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + +You may make, run and propagate covered works that you do not convey, +without conditions so long as your license otherwise remains in force. +You may convey covered works to others for the sole purpose of having +them make modifications exclusively for you, or provide you with +facilities for running those works, provided that you comply with the +terms of this License in conveying all material for which you do not +control copyright. Those thus making or running the covered works for +you must do so exclusively on your behalf, under your direction and +control, on terms that prohibit them from making any copies of your +copyrighted material outside their relationship with you. + +Conveying under any other circumstances is permitted solely under the +conditions stated below. Sublicensing is not allowed; section 10 makes +it unnecessary. + +3. Protecting Users’ Legal Rights From Anti-Circumvention Law. + +No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article 11 +of the WIPO copyright treaty adopted on 20 December 1996, or similar +laws prohibiting or restricting circumvention of such measures. + +When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to the +covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work’s +users, your or third parties’ legal rights to forbid circumvention of +technological measures. + +4. Conveying Verbatim Copies. + +You may convey verbatim copies of the Program’s source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; keep +intact all notices stating that this License and any non-permissive +terms added in accord with section 7 apply to the code; keep intact all +notices of the absence of any warranty; and give all recipients a copy +of this License along with the Program. + +You may charge any price or no price for each copy that you convey, and +you may offer support or warranty protection for a fee. + +5. Conveying Modified Source Versions. + +You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the terms +of section 4, provided that you also meet all of these conditions: + +``` R +a) The work must carry prominent notices stating that you modified +it, and giving a relevant date. + +b) The work must carry prominent notices stating that it is +released under this License and any conditions added under section +7. This requirement modifies the requirement in section 4 to +"keep intact all notices". + +c) You must license the entire work, as a whole, under this +License to anyone who comes into possession of a copy. This +License will therefore apply, along with any applicable section 7 +additional terms, to the whole of the work, and all its parts, +regardless of how they are packaged. This License gives no +permission to license the work in any other way, but it does not +invalidate such permission if you have separately received it. + +d) If the work has interactive user interfaces, each must display +Appropriate Legal Notices; however, if the Program has interactive +interfaces that do not display Appropriate Legal Notices, your +work need not make them do so. +``` + +A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, and +which are not combined with it such as to form a larger program, in or +on a volume of a storage or distribution medium, is called an +“aggregate” if the compilation and its resulting copyright are not used +to limit the access or legal rights of the compilation’s users beyond +what the individual works permit. Inclusion of a covered work in an +aggregate does not cause this License to apply to the other parts of the +aggregate. + +6. Conveying Non-Source Forms. + +You may convey a covered work in object code form under the terms of +sections 4 and 5, provided that you also convey the machine-readable +Corresponding Source under the terms of this License, in one of these +ways: + +``` R +a) Convey the object code in, or embodied in, a physical product +(including a physical distribution medium), accompanied by the +Corresponding Source fixed on a durable physical medium +customarily used for software interchange. + +b) Convey the object code in, or embodied in, a physical product +(including a physical distribution medium), accompanied by a +written offer, valid for at least three years and valid for as +long as you offer spare parts or customer support for that product +model, to give anyone who possesses the object code either (1) a +copy of the Corresponding Source for all the software in the +product that is covered by this License, on a durable physical +medium customarily used for software interchange, for a price no +more than your reasonable cost of physically performing this +conveying of source, or (2) access to copy the +Corresponding Source from a network server at no charge. + +c) Convey individual copies of the object code with a copy of the +written offer to provide the Corresponding Source. This +alternative is allowed only occasionally and noncommercially, and +only if you received the object code with such an offer, in accord +with subsection 6b. + +d) Convey the object code by offering access from a designated +place (gratis or for a charge), and offer equivalent access to the +Corresponding Source in the same way through the same place at no +further charge. You need not require recipients to copy the +Corresponding Source along with the object code. If the place to +copy the object code is a network server, the Corresponding Source +may be on a different server (operated by you or a third party) +that supports equivalent copying facilities, provided you maintain +clear directions next to the object code saying where to find the +Corresponding Source. Regardless of what server hosts the +Corresponding Source, you remain obligated to ensure that it is +available for as long as needed to satisfy these requirements. + +e) Convey the object code using peer-to-peer transmission, provided +you inform other peers where the object code and Corresponding +Source of the work are being offered to the general public at no +charge under subsection 6d. +``` + +A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be included +in conveying the object code work. + +A “User Product” is either (1) a “consumer product”, which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for +incorporation into a dwelling. In determining whether a product is a +consumer product, doubtful cases shall be resolved in favor of coverage. +For a particular product received by a particular user, “normally used” +refers to a typical or common use of that class of product, regardless +of the status of the particular user or of the way in which the +particular user actually uses, or expects or is expected to use, the +product. A product is a consumer product regardless of whether the +product has substantial commercial, industrial or non-consumer uses, +unless such uses represent the only significant mode of use of the +product. + +“Installation Information” for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product +from a modified version of its Corresponding Source. The information +must suffice to ensure that the continued functioning of the modified +object code is in no case prevented or interfered with solely because +modification has been made. + +If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied by +the Installation Information. But this requirement does not apply if +neither you nor any third party retains the ability to install modified +object code on the User Product (for example, the work has been +installed in ROM). + +The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + +Corresponding Source conveyed, and Installation Information provided, in +accord with this section must be in a format that is publicly documented +(and with an implementation available to the public in source code +form), and must require no special password or key for unpacking, +reading or copying. + +7. Additional Terms. + +“Additional permissions” are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by this +License without regard to the additional permissions. + +When you convey a copy of a covered work, you may at your option remove +any additional permissions from that copy, or from any part of it. +(Additional permissions may be written to require their own removal in +certain cases when you modify the work.) You may place additional +permissions on material, added by you to a covered work, for which you +have or can give appropriate copyright permission. + +Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders +of that material) supplement the terms of this License with terms: + +``` R +a) Disclaiming warranty or limiting liability differently from the +terms of sections 15 and 16 of this License; or + +b) Requiring preservation of specified reasonable legal notices or +author attributions in that material or in the Appropriate Legal +Notices displayed by works containing it; or + +c) Prohibiting misrepresentation of the origin of that material, or +requiring that modified versions of such material be marked in +reasonable ways as different from the original version; or + +d) Limiting the use for publicity purposes of names of licensors or +authors of the material; or + +e) Declining to grant rights under trademark law for use of some +trade names, trademarks, or service marks; or + +f) Requiring indemnification of licensors and authors of that +material by anyone who conveys the material (or modified versions of +it) with contractual assumptions of liability to the recipient, for +any liability that these contractual assumptions directly impose on +those licensors and authors. +``` + +All other non-permissive additional terms are considered “further +restrictions” within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains a +further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms of +that license document, provided that the further restriction does not +survive such relicensing or conveying. + +If you add terms to a covered work in accord with this section, you must +place, in the relevant source files, a statement of the additional terms +that apply to those files, or a notice indicating where to find the +applicable terms. + +Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; the above +requirements apply either way. + +8. Termination. + +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + +However, if you cease all violation of this License, then your license +from a particular copyright holder is reinstated (a) provisionally, +unless and until the copyright holder explicitly and finally terminates +your license, and (b) permanently, if the copyright holder fails to +notify you of the violation by some reasonable means prior to 60 days +after the cessation. + +Moreover, your license from a particular copyright holder is reinstated +permanently if the copyright holder notifies you of the violation by +some reasonable means, this is the first time you have received notice +of violation of this License (for any work) from that copyright holder, +and you cure the violation prior to 30 days after your receipt of the +notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + +9. Acceptance Not Required for Having Copies. + +You are not required to accept this License in order to receive or run a +copy of the Program. Ancillary propagation of a covered work occurring +solely as a consequence of using peer-to-peer transmission to receive a +copy likewise does not require acceptance. However, nothing other than +this License grants you permission to propagate or modify any covered +work. These actions infringe copyright if you do not accept this +License. Therefore, by modifying or propagating a covered work, you +indicate your acceptance of this License to do so. + +10. Automatic Licensing of Downstream Recipients. + +Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + +An “entity transaction” is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered work +results from an entity transaction, each party to that transaction who +receives a copy of the work also receives whatever licenses to the work +the party’s predecessor in interest had or could give under the previous +paragraph, plus a right to possession of the Corresponding Source of the +work from the predecessor in interest, if the predecessor has it or can +get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may not +impose a license fee, royalty, or other charge for exercise of rights +granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that any +patent claim is infringed by making, using, selling, offering for sale, +or importing the Program or any portion of it. + +11. Patents. + +A “contributor” is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work +thus licensed is called the contributor’s “contributor version”. + +A contributor’s “essential patent claims” are all patent claims owned or +controlled by the contributor, whether already acquired or hereafter +acquired, that would be infringed by some manner, permitted by this +License, of making, using, or selling its contributor version, but do +not include claims that would be infringed only as a consequence of +further modification of the contributor version. For purposes of this +definition, “control” includes the right to grant patent sublicenses in +a manner consistent with the requirements of this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor’s essential patent claims, to make, +use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + +In the following three paragraphs, a “patent license” is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To “grant” such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + +If you convey a covered work, knowingly relying on a patent license, and +the Corresponding Source of the work is not available for anyone to +copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. “Knowingly relying” means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient’s use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify or +convey a specific copy of the covered work, then the patent license you +grant is automatically extended to all recipients of the covered work +and works based on it. + +A patent license is “discriminatory” if it does not include within the +scope of its coverage, prohibits the exercise of, or is conditioned on +the non-exercise of one or more of the rights that are specifically +granted under this License. You may not convey a covered work if you are +a party to an arrangement with a third party that is in the business of +distributing software, under which you make payment to the third party +based on the extent of your activity of conveying the work, and under +which the third party grants, to any of the parties who would receive +the covered work from you, a discriminatory patent license (a) in +connection with copies of the covered work conveyed by you (or copies +made from those copies), or (b) primarily for and in connection with +specific products or compilations that contain the covered work, unless +you entered into that arrangement, or that patent license was granted, +prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting any +implied license or other defenses to infringement that may otherwise be +available to you under applicable patent law. + +12. No Surrender of Others’ Freedom. + +If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not convey it at all. For example, if you agree to terms that +obligate you to collect a royalty for further conveying from those to +whom you convey the Program, the only way you could satisfy both those +terms and this License would be to refrain entirely from conveying the +Program. + +13. Use with the GNU Affero General Public License. + +Notwithstanding any other provision of this License, you have permission +to link or combine any covered work with a work licensed under version 3 +of the GNU Affero General Public License into a single combined work, +and to convey the resulting work. The terms of this License will +continue to apply to the part which is the covered work, but the special +requirements of the GNU Affero General Public License, section 13, +concerning interaction through a network will apply to the combination +as such. + +14. Revised Versions of this License. + +The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies that a certain numbered version of the GNU General Public +License “or any later version” applies to it, you have the option of +following the terms and conditions either of that numbered version or of +any later version published by the Free Software Foundation. If the +Program does not specify a version number of the GNU General Public +License, you may choose any version ever published by the Free Software +Foundation. + +If the Program specifies that a proxy can decide which future versions +of the GNU General Public License can be used, that proxy’s public +statement of acceptance of a version permanently authorizes you to +choose that version for the Program. + +Later license versions may give you additional or different permissions. +However, no additional obligations are imposed on any author or +copyright holder as a result of your choosing to follow a later version. + +15. Disclaimer of Warranty. + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT +WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF +THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +16. Limitation of Liability. + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR +CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES +ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT +NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES +SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE +WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN +ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. + +17. Interpretation of Sections 15 and 16. + +If the disclaimer of warranty and limitation of liability provided above +cannot be given local legal effect according to their terms, reviewing +courts shall apply local law that most closely approximates an absolute +waiver of all civil liability in connection with the Program, unless a +warranty or assumption of liability accompanies a copy of the Program in +return for a fee. + +``` R + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs +``` + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these +terms. + +To do so, attach the following notices to the program. It is safest to +attach them to the start of each source file to most effectively state +the exclusion of warranty; and each file should have at least the +“copyright” line and a pointer to where the full notice is found. + +``` R + +Copyright (C) + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +``` + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short notice +like this when it starts in an interactive mode: + +``` R + Copyright (C) +This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. +This is free software, and you are welcome to redistribute it +under certain conditions; type `show c' for details. +``` + +The hypothetical commands `show w' and`show c’ should show the +appropriate parts of the General Public License. Of course, your +program’s commands might be different; for a GUI interface, you would +use an “about box”. + +You should also get your employer (if you work as a programmer) or +school, if any, to sign a “copyright disclaimer” for the program, if +necessary. For more information on this, and how to apply and follow the +GNU GPL, see . + +The GNU General Public License does not permit incorporating your +program into proprietary programs. If your program is a subroutine +library, you may consider it more useful to permit linking proprietary +applications with the library. If this is what you want to do, use the +GNU Lesser General Public License instead of this License. But first, +please read . diff --git a/docs/authors.html b/docs/authors.html index 0b165dc3..dc47fb0e 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -1,43 +1,36 @@ -Authors and Citation • dsBase - - -
-
-
-
-
-

Authors and Citation

-
+
+
+
+
+ +

Authors and Citation

+
+
+

Authors

  • Paul Burton. Author. @@ -92,29 +85,26 @@

    Authors and Citation

-
-
-

Citation

- -
-
+
+

Citation

+

-

Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg A, Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye A, Escribà-Montagut X, Wheater S (????). +

Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg A, Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye A, Escribà-Montagut X, Wheater S (????). dsBase: 'DataSHIELD' Server Side Base Functions. -R package version 6.3.4. +R package version 6.3.6.9000.

- 
@Manual{,
+      
@Manual{,
   title = {dsBase: 'DataSHIELD' Server Side Base Functions},
   author = {Paul Burton and Rebecca Wilson and Olly Butters and Patricia Ryser-Welch and Alex Westerberg and Leire Abarrategui and Roberto Villegas-Diaz and Demetris Avraam and Yannick Marcon and Tom Bishop and Amadou Gaye and Xavier Escribà-Montagut and Stuart Wheater},
-  note = {R package version 6.3.4},
+  note = {R package version 6.3.6.9000},
 }

-    
Gaye A, Marcon Y, Isaeva J, LaFlamme P, Turner A, Jones E, Minion J, Boyd A, Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir I, Doiron D, Giepmans L, Wallace S, Budin-Ljøsne I, Schmidt C, Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry I, Peters A, Phillips C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier I, Harris J, Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014).
+      
Gaye A, Marcon Y, Isaeva J, LaFlamme P, Turner A, Jones E, Minion J, Boyd A, Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir I, Doiron D, Giepmans L, Wallace S, Budin-Ljøsne I, Schmidt C, Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry I, Peters A, Phillips C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier I, Harris J, Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014).
 “DataSHIELD: taking the analysis to the data, not the data to the analysis.”
 International Journal of Epidemiology, 43(6), 1929–1944.
 doi:10.1093/ije/dyu188.
 

-    
@Article{,
+      
@Article{,
   title = {{DataSHIELD: taking the analysis to the data, not the data to the analysis}},
   author = {Amadou Gaye and Yannick Marcon and Julia Isaeva and Philippe {LaFlamme} and Andrew Turner and Elinor M Jones and Joel Minion and Andrew W Boyd and Christopher J Newby and Marja-Liisa Nuotio and Rebecca Wilson and Oliver Butters and Barnaby Murtagh and Ipek Demir and Dany Doiron and Lisette Giepmans and Susan E Wallace and Isabelle Budin-Lj{\o}sne and Carsten O. Schmidt and Paolo Boffetta and Mathieu Boniol and Maria Bota and Kim W Carter and Nick {deKlerk} and Chris Dibben and Richard W Francis and Tero Hiekkalinna and Kristian Hveem and Kirsti Kval{\o}y and Sean Millar and Ivan J Perry and Annette Peters and Catherine M Phillips and Frank Popham and Gillian Raab and Eva Reischl and Nuala Sheehan and Melanie Waldenberger and Markus Perola and Edwin {{van den Heuvel}} and John Macleod and Bartha M Knoppers and Ronald P Stolk and Isabel Fortier and Jennifer R Harris and Bruce H R Woffenbuttel and Madeleine J Murtagh and Vincent Ferretti and Paul R Burton},
   journal = {International Journal of Epidemiology},
@@ -124,12 +114,12 @@ 
Citation

   pages = {1929--1944},
   doi = {10.1093/ije/dyu188},
 }

-    
Wilson R, Butters O, Avraam D, Baker J, Tedds J, Turner A, Murtagh M, Burton P (2017).
+      
Wilson R, Butters O, Avraam D, Baker J, Tedds J, Turner A, Murtagh M, Burton P (2017).
 “DataSHIELD – New Directions and Dimensions.”
 Data Science Journal, 16(21), 1–21.
 doi:10.5334/dsj-2017-021.
 

-    
@Article{,
+      
@Article{,
   title = {{DataSHIELD – New Directions and Dimensions}},
   author = {Rebecca C. Wilson and Oliver W. Butters and Demetris Avraam and James Baker and Jonathan A. Tedds and Andrew Turner and Madeleine Murtagh and Paul R. Burton},
   journal = {Data Science Journal},
@@ -139,12 +129,12 @@ 
Citation

   pages = {1--21},
   doi = {10.5334/dsj-2017-021},
 }

-    
Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan A, Murtagh M, Nestor M, Nybo Andersen A, Parker S, Pinot de Moira A, Schwarz F, Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024).
+      
Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan A, Murtagh M, Nestor M, Nybo Andersen A, Parker S, Pinot de Moira A, Schwarz F, Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024).
 “DataSHIELD: mitigating disclosure risk in a multi-site federated analysis platform.”
 Bioinformatics Advances, 5(1), 1–21.
 doi:10.1093/bioadv/vbaf046.
 

-    
@Article{,
+      
@Article{,
   title = {{DataSHIELD: mitigating disclosure risk in a multi-site federated analysis platform}},
   author = {Demetris Avraam and Rebecca C Wilson and Noemi {{Aguirre Chan}} and Soumya Banerjee and Tom R P Bishop and Olly Butters and Tim Cadman and Luise Cederkvist and Liesbeth Duijts and Xavier {{Escrib{\a`a} Montagut}} and Hugh Garner and Gon{\c c}alo {Gon{\c c}alves} and Juan R Gonz{\a'a}lez and Sido Haakma and Mette Hartlev and Jan Hasenauer and Manuel Huth and Eleanor Hyde and Vincent W V Jaddoe and Yannick Marcon and Michaela Th Mayrhofer and Fruzsina Molnar-Gabor and Andrei Scott Morgan and Madeleine Murtagh and Marc Nestor and Anne-Marie {{Nybo Andersen}} and Simon Parker and Angela {{Pinot de Moira}} and Florian Schwarz and Katrine Strandberg-Larsen and Morris A Swertz and Marieke Welten and Stuart Wheater and Paul R Burton},
   journal = {Bioinformatics Advances},
@@ -156,23 +146,21 @@ 
Citation

   editor = {Thomas Lengauer},
   publisher = {Oxford University Press (OUP)},
 }

+
-
- -
- +
-
-

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

+
+

Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

-
-

Site built with pkgdown 2.1.3.

+
+

Site built with pkgdown 2.2.0.

-
- +
diff --git a/docs/authors.md b/docs/authors.md new file mode 100644 index 00000000..42d050a5 --- /dev/null +++ b/docs/authors.md @@ -0,0 +1,108 @@ +# Authors and Citation + +## Authors + +- **Paul Burton**. Author. [](https://orcid.org/0000-0001-5799-9634) + +- **Rebecca Wilson**. Author. [](https://orcid.org/0000-0003-2294-593X) + +- **Olly Butters**. Author. [](https://orcid.org/0000-0003-0354-8461) + +- **Patricia Ryser-Welch**. Author. + [](https://orcid.org/0000-0002-0070-0264) + +- **Alex Westerberg**. Author. + +- **Leire Abarrategui**. Author. + +- **Roberto Villegas-Diaz**. Author. + [](https://orcid.org/0000-0001-5036-8661) + +- **Demetris Avraam**. Author. [](https://orcid.org/0000-0001-8908-2441) + +- **Yannick Marcon**. Author. [](https://orcid.org/0000-0003-0138-2023) + +- **Tom Bishop**. Author. + +- **Amadou Gaye**. Author. [](https://orcid.org/0000-0002-1180-2792) + +- **Xavier Escribà-Montagut**. Author. + [](https://orcid.org/0000-0003-2888-8948) + +- **Stuart Wheater**. Author, maintainer. + [](https://orcid.org/0009-0003-2419-1964) + +## Citation + +Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg A, Abarrategui +L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye A, +Escribà-Montagut X, Wheater S (????). *dsBase: 'DataSHIELD' Server Side +Base Functions*. R package version 6.3.6.9000. + + @Manual{, + title = {dsBase: 'DataSHIELD' Server Side Base Functions}, + author = {Paul Burton and Rebecca Wilson and Olly Butters and Patricia Ryser-Welch and Alex Westerberg and Leire Abarrategui and Roberto Villegas-Diaz and Demetris Avraam and Yannick Marcon and Tom Bishop and Amadou Gaye and Xavier Escribà-Montagut and Stuart Wheater}, + note = {R package version 6.3.6.9000}, + } + +Gaye A, Marcon Y, Isaeva J, LaFlamme P, Turner A, Jones E, Minion J, +Boyd A, Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir I, +Doiron D, Giepmans L, Wallace S, Budin-Ljøsne I, Schmidt C, Boffetta P, +Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, Hiekkalinna +T, Hveem K, Kvaløy K, Millar S, Perry I, Peters A, Phillips C, Popham F, +Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van den Heuvel +E, Macleod J, Knoppers B, Stolk R, Fortier I, Harris J, Woffenbuttel B, +Murtagh M, Ferretti V, Burton P (2014). “DataSHIELD: taking the analysis +to the data, not the data to the analysis.” *International Journal of +Epidemiology*, **43**(6), 1929–1944. +[doi:10.1093/ije/dyu188](https://doi.org/10.1093/ije/dyu188). + + @Article{, + title = {{DataSHIELD: taking the analysis to the data, not the data to the analysis}}, + author = {Amadou Gaye and Yannick Marcon and Julia Isaeva and Philippe {LaFlamme} and Andrew Turner and Elinor M Jones and Joel Minion and Andrew W Boyd and Christopher J Newby and Marja-Liisa Nuotio and Rebecca Wilson and Oliver Butters and Barnaby Murtagh and Ipek Demir and Dany Doiron and Lisette Giepmans and Susan E Wallace and Isabelle Budin-Lj{\o}sne and Carsten O. Schmidt and Paolo Boffetta and Mathieu Boniol and Maria Bota and Kim W Carter and Nick {deKlerk} and Chris Dibben and Richard W Francis and Tero Hiekkalinna and Kristian Hveem and Kirsti Kval{\o}y and Sean Millar and Ivan J Perry and Annette Peters and Catherine M Phillips and Frank Popham and Gillian Raab and Eva Reischl and Nuala Sheehan and Melanie Waldenberger and Markus Perola and Edwin {{van den Heuvel}} and John Macleod and Bartha M Knoppers and Ronald P Stolk and Isabel Fortier and Jennifer R Harris and Bruce H R Woffenbuttel and Madeleine J Murtagh and Vincent Ferretti and Paul R Burton}, + journal = {International Journal of Epidemiology}, + year = {2014}, + volume = {43}, + number = {6}, + pages = {1929--1944}, + doi = {10.1093/ije/dyu188}, + } + +Wilson R, Butters O, Avraam D, Baker J, Tedds J, Turner A, Murtagh M, +Burton P (2017). “DataSHIELD – New Directions and Dimensions.” *Data +Science Journal*, **16**(21), 1–21. +[doi:10.5334/dsj-2017-021](https://doi.org/10.5334/dsj-2017-021). + + @Article{, + title = {{DataSHIELD – New Directions and Dimensions}}, + author = {Rebecca C. Wilson and Oliver W. Butters and Demetris Avraam and James Baker and Jonathan A. Tedds and Andrew Turner and Madeleine Murtagh and Paul R. Burton}, + journal = {Data Science Journal}, + year = {2017}, + volume = {16}, + number = {21}, + pages = {1--21}, + doi = {10.5334/dsj-2017-021}, + } + +Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters O, +Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, +Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde +E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan A, Murtagh M, +Nestor M, Nybo Andersen A, Parker S, Pinot de Moira A, Schwarz F, +Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024). +“DataSHIELD: mitigating disclosure risk in a multi-site federated +analysis platform.” *Bioinformatics Advances*, **5**(1), 1–21. +[doi:10.1093/bioadv/vbaf046](https://doi.org/10.1093/bioadv/vbaf046). + + @Article{, + title = {{DataSHIELD: mitigating disclosure risk in a multi-site federated analysis platform}}, + author = {Demetris Avraam and Rebecca C Wilson and Noemi {{Aguirre Chan}} and Soumya Banerjee and Tom R P Bishop and Olly Butters and Tim Cadman and Luise Cederkvist and Liesbeth Duijts and Xavier {{Escrib{\a`a} Montagut}} and Hugh Garner and Gon{\c c}alo {Gon{\c c}alves} and Juan R Gonz{\a'a}lez and Sido Haakma and Mette Hartlev and Jan Hasenauer and Manuel Huth and Eleanor Hyde and Vincent W V Jaddoe and Yannick Marcon and Michaela Th Mayrhofer and Fruzsina Molnar-Gabor and Andrei Scott Morgan and Madeleine Murtagh and Marc Nestor and Anne-Marie {{Nybo Andersen}} and Simon Parker and Angela {{Pinot de Moira}} and Florian Schwarz and Katrine Strandberg-Larsen and Morris A Swertz and Marieke Welten and Stuart Wheater and Paul R Burton}, + journal = {Bioinformatics Advances}, + year = {2024}, + volume = {5}, + number = {1}, + pages = {1--21}, + doi = {10.1093/bioadv/vbaf046}, + editor = {Thomas Lengauer}, + publisher = {Oxford University Press (OUP)}, + } diff --git a/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js b/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js new file mode 100644 index 00000000..0b873693 --- /dev/null +++ b/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js @@ -0,0 +1,7 @@ +/*! + * Bootstrap v5.3.8 (https://getbootstrap.com/) + * Copyright 2011-2025 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors) + * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE) + */ +!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):(t="undefined"!=typeof globalThis?globalThis:t||self).bootstrap=e()}(this,function(){"use strict";const t=new Map,e={set(e,i,n){t.has(e)||t.set(e,new Map);const s=t.get(e);s.has(i)||0===s.size?s.set(i,n):console.error(`Bootstrap doesn't allow more than one instance per element. Bound instance: ${Array.from(s.keys())[0]}.`)},get:(e,i)=>t.has(e)&&t.get(e).get(i)||null,remove(e,i){if(!t.has(e))return;const n=t.get(e);n.delete(i),0===n.size&&t.delete(e)}},i="transitionend",n=t=>(t&&window.CSS&&window.CSS.escape&&(t=t.replace(/#([^\s"#']+)/g,(t,e)=>`#${CSS.escape(e)}`)),t),s=t=>null==t?`${t}`:Object.prototype.toString.call(t).match(/\s([a-z]+)/i)[1].toLowerCase(),o=t=>{t.dispatchEvent(new Event(i))},r=t=>!(!t||"object"!=typeof t)&&(void 0!==t.jquery&&(t=t[0]),void 0!==t.nodeType),a=t=>r(t)?t.jquery?t[0]:t:"string"==typeof t&&t.length>0?document.querySelector(n(t)):null,l=t=>{if(!r(t)||0===t.getClientRects().length)return!1;const e="visible"===getComputedStyle(t).getPropertyValue("visibility"),i=t.closest("details:not([open])");if(!i)return e;if(i!==t){const e=t.closest("summary");if(e&&e.parentNode!==i)return!1;if(null===e)return!1}return e},c=t=>!t||t.nodeType!==Node.ELEMENT_NODE||!!t.classList.contains("disabled")||(void 0!==t.disabled?t.disabled:t.hasAttribute("disabled")&&"false"!==t.getAttribute("disabled")),h=t=>{if(!document.documentElement.attachShadow)return null;if("function"==typeof t.getRootNode){const e=t.getRootNode();return e instanceof ShadowRoot?e:null}return t instanceof ShadowRoot?t:t.parentNode?h(t.parentNode):null},d=()=>{},u=t=>{t.offsetHeight},f=()=>window.jQuery&&!document.body.hasAttribute("data-bs-no-jquery")?window.jQuery:null,p=[],m=()=>"rtl"===document.documentElement.dir,g=t=>{var e;e=()=>{const e=f();if(e){const i=t.NAME,n=e.fn[i];e.fn[i]=t.jQueryInterface,e.fn[i].Constructor=t,e.fn[i].noConflict=()=>(e.fn[i]=n,t.jQueryInterface)}},"loading"===document.readyState?(p.length||document.addEventListener("DOMContentLoaded",()=>{for(const t of p)t()}),p.push(e)):e()},_=(t,e=[],i=t)=>"function"==typeof t?t.call(...e):i,b=(t,e,n=!0)=>{if(!n)return void _(t);const s=(t=>{if(!t)return 0;let{transitionDuration:e,transitionDelay:i}=window.getComputedStyle(t);const n=Number.parseFloat(e),s=Number.parseFloat(i);return n||s?(e=e.split(",")[0],i=i.split(",")[0],1e3*(Number.parseFloat(e)+Number.parseFloat(i))):0})(e)+5;let r=!1;const a=({target:n})=>{n===e&&(r=!0,e.removeEventListener(i,a),_(t))};e.addEventListener(i,a),setTimeout(()=>{r||o(e)},s)},v=(t,e,i,n)=>{const s=t.length;let o=t.indexOf(e);return-1===o?!i&&n?t[s-1]:t[0]:(o+=i?1:-1,n&&(o=(o+s)%s),t[Math.max(0,Math.min(o,s-1))])},y=/[^.]*(?=\..*)\.|.*/,w=/\..*/,A=/::\d+$/,E={};let T=1;const C={mouseenter:"mouseover",mouseleave:"mouseout"},O=new Set(["click","dblclick","mouseup","mousedown","contextmenu","mousewheel","DOMMouseScroll","mouseover","mouseout","mousemove","selectstart","selectend","keydown","keypress","keyup","orientationchange","touchstart","touchmove","touchend","touchcancel","pointerdown","pointermove","pointerup","pointerleave","pointercancel","gesturestart","gesturechange","gestureend","focus","blur","change","reset","select","submit","focusin","focusout","load","unload","beforeunload","resize","move","DOMContentLoaded","readystatechange","error","abort","scroll"]);function x(t,e){return e&&`${e}::${T++}`||t.uidEvent||T++}function k(t){const e=x(t);return t.uidEvent=e,E[e]=E[e]||{},E[e]}function L(t,e,i=null){return Object.values(t).find(t=>t.callable===e&&t.delegationSelector===i)}function S(t,e,i){const n="string"==typeof e,s=n?i:e||i;let o=N(t);return O.has(o)||(o=t),[n,s,o]}function D(t,e,i,n,s){if("string"!=typeof e||!t)return;let[o,r,a]=S(e,i,n);if(e in C){const t=t=>function(e){if(!e.relatedTarget||e.relatedTarget!==e.delegateTarget&&!e.delegateTarget.contains(e.relatedTarget))return t.call(this,e)};r=t(r)}const l=k(t),c=l[a]||(l[a]={}),h=L(c,r,o?i:null);if(h)return void(h.oneOff=h.oneOff&&s);const d=x(r,e.replace(y,"")),u=o?function(t,e,i){return function n(s){const o=t.querySelectorAll(e);for(let{target:r}=s;r&&r!==this;r=r.parentNode)for(const a of o)if(a===r)return j(s,{delegateTarget:r}),n.oneOff&&P.off(t,s.type,e,i),i.apply(r,[s])}}(t,i,r):function(t,e){return function i(n){return j(n,{delegateTarget:t}),i.oneOff&&P.off(t,n.type,e),e.apply(t,[n])}}(t,r);u.delegationSelector=o?i:null,u.callable=r,u.oneOff=s,u.uidEvent=d,c[d]=u,t.addEventListener(a,u,o)}function $(t,e,i,n,s){const o=L(e[i],n,s);o&&(t.removeEventListener(i,o,Boolean(s)),delete e[i][o.uidEvent])}function I(t,e,i,n){const s=e[i]||{};for(const[o,r]of Object.entries(s))o.includes(n)&&$(t,e,i,r.callable,r.delegationSelector)}function N(t){return t=t.replace(w,""),C[t]||t}const P={on(t,e,i,n){D(t,e,i,n,!1)},one(t,e,i,n){D(t,e,i,n,!0)},off(t,e,i,n){if("string"!=typeof e||!t)return;const[s,o,r]=S(e,i,n),a=r!==e,l=k(t),c=l[r]||{},h=e.startsWith(".");if(void 0===o){if(h)for(const i of Object.keys(l))I(t,l,i,e.slice(1));for(const[i,n]of Object.entries(c)){const s=i.replace(A,"");a&&!e.includes(s)||$(t,l,r,n.callable,n.delegationSelector)}}else{if(!Object.keys(c).length)return;$(t,l,r,o,s?i:null)}},trigger(t,e,i){if("string"!=typeof e||!t)return null;const n=f();let s=null,o=!0,r=!0,a=!1;e!==N(e)&&n&&(s=n.Event(e,i),n(t).trigger(s),o=!s.isPropagationStopped(),r=!s.isImmediatePropagationStopped(),a=s.isDefaultPrevented());const l=j(new Event(e,{bubbles:o,cancelable:!0}),i);return a&&l.preventDefault(),r&&t.dispatchEvent(l),l.defaultPrevented&&s&&s.preventDefault(),l}};function j(t,e={}){for(const[i,n]of Object.entries(e))try{t[i]=n}catch(e){Object.defineProperty(t,i,{configurable:!0,get:()=>n})}return t}function M(t){if("true"===t)return!0;if("false"===t)return!1;if(t===Number(t).toString())return Number(t);if(""===t||"null"===t)return null;if("string"!=typeof t)return t;try{return JSON.parse(decodeURIComponent(t))}catch(e){return t}}function F(t){return t.replace(/[A-Z]/g,t=>`-${t.toLowerCase()}`)}const H={setDataAttribute(t,e,i){t.setAttribute(`data-bs-${F(e)}`,i)},removeDataAttribute(t,e){t.removeAttribute(`data-bs-${F(e)}`)},getDataAttributes(t){if(!t)return{};const e={},i=Object.keys(t.dataset).filter(t=>t.startsWith("bs")&&!t.startsWith("bsConfig"));for(const n of i){let i=n.replace(/^bs/,"");i=i.charAt(0).toLowerCase()+i.slice(1),e[i]=M(t.dataset[n])}return e},getDataAttribute:(t,e)=>M(t.getAttribute(`data-bs-${F(e)}`))};class W{static get Default(){return{}}static get DefaultType(){return{}}static get NAME(){throw new Error('You have to implement the static method "NAME", for each component!')}_getConfig(t){return t=this._mergeConfigObj(t),t=this._configAfterMerge(t),this._typeCheckConfig(t),t}_configAfterMerge(t){return t}_mergeConfigObj(t,e){const i=r(e)?H.getDataAttribute(e,"config"):{};return{...this.constructor.Default,..."object"==typeof i?i:{},...r(e)?H.getDataAttributes(e):{},..."object"==typeof t?t:{}}}_typeCheckConfig(t,e=this.constructor.DefaultType){for(const[i,n]of Object.entries(e)){const e=t[i],o=r(e)?"element":s(e);if(!new RegExp(n).test(o))throw new TypeError(`${this.constructor.NAME.toUpperCase()}: Option "${i}" provided type "${o}" but expected type "${n}".`)}}}class B extends W{constructor(t,i){super(),(t=a(t))&&(this._element=t,this._config=this._getConfig(i),e.set(this._element,this.constructor.DATA_KEY,this))}dispose(){e.remove(this._element,this.constructor.DATA_KEY),P.off(this._element,this.constructor.EVENT_KEY);for(const t of Object.getOwnPropertyNames(this))this[t]=null}_queueCallback(t,e,i=!0){b(t,e,i)}_getConfig(t){return t=this._mergeConfigObj(t,this._element),t=this._configAfterMerge(t),this._typeCheckConfig(t),t}static getInstance(t){return e.get(a(t),this.DATA_KEY)}static getOrCreateInstance(t,e={}){return this.getInstance(t)||new this(t,"object"==typeof e?e:null)}static get VERSION(){return"5.3.8"}static get DATA_KEY(){return`bs.${this.NAME}`}static get EVENT_KEY(){return`.${this.DATA_KEY}`}static eventName(t){return`${t}${this.EVENT_KEY}`}}const z=t=>{let e=t.getAttribute("data-bs-target");if(!e||"#"===e){let i=t.getAttribute("href");if(!i||!i.includes("#")&&!i.startsWith("."))return null;i.includes("#")&&!i.startsWith("#")&&(i=`#${i.split("#")[1]}`),e=i&&"#"!==i?i.trim():null}return e?e.split(",").map(t=>n(t)).join(","):null},R={find:(t,e=document.documentElement)=>[].concat(...Element.prototype.querySelectorAll.call(e,t)),findOne:(t,e=document.documentElement)=>Element.prototype.querySelector.call(e,t),children:(t,e)=>[].concat(...t.children).filter(t=>t.matches(e)),parents(t,e){const i=[];let n=t.parentNode.closest(e);for(;n;)i.push(n),n=n.parentNode.closest(e);return i},prev(t,e){let i=t.previousElementSibling;for(;i;){if(i.matches(e))return[i];i=i.previousElementSibling}return[]},next(t,e){let i=t.nextElementSibling;for(;i;){if(i.matches(e))return[i];i=i.nextElementSibling}return[]},focusableChildren(t){const e=["a","button","input","textarea","select","details","[tabindex]",'[contenteditable="true"]'].map(t=>`${t}:not([tabindex^="-"])`).join(",");return this.find(e,t).filter(t=>!c(t)&&l(t))},getSelectorFromElement(t){const e=z(t);return e&&R.findOne(e)?e:null},getElementFromSelector(t){const e=z(t);return e?R.findOne(e):null},getMultipleElementsFromSelector(t){const e=z(t);return e?R.find(e):[]}},q=(t,e="hide")=>{const i=`click.dismiss${t.EVENT_KEY}`,n=t.NAME;P.on(document,i,`[data-bs-dismiss="${n}"]`,function(i){if(["A","AREA"].includes(this.tagName)&&i.preventDefault(),c(this))return;const s=R.getElementFromSelector(this)||this.closest(`.${n}`);t.getOrCreateInstance(s)[e]()})},V=".bs.alert",K=`close${V}`,Q=`closed${V}`;class X extends B{static get NAME(){return"alert"}close(){if(P.trigger(this._element,K).defaultPrevented)return;this._element.classList.remove("show");const t=this._element.classList.contains("fade");this._queueCallback(()=>this._destroyElement(),this._element,t)}_destroyElement(){this._element.remove(),P.trigger(this._element,Q),this.dispose()}static jQueryInterface(t){return this.each(function(){const e=X.getOrCreateInstance(this);if("string"==typeof t){if(void 0===e[t]||t.startsWith("_")||"constructor"===t)throw new TypeError(`No method named "${t}"`);e[t](this)}})}}q(X,"close"),g(X);const Y='[data-bs-toggle="button"]';class U extends B{static get NAME(){return"button"}toggle(){this._element.setAttribute("aria-pressed",this._element.classList.toggle("active"))}static jQueryInterface(t){return this.each(function(){const e=U.getOrCreateInstance(this);"toggle"===t&&e[t]()})}}P.on(document,"click.bs.button.data-api",Y,t=>{t.preventDefault();const e=t.target.closest(Y);U.getOrCreateInstance(e).toggle()}),g(U);const G=".bs.swipe",J=`touchstart${G}`,Z=`touchmove${G}`,tt=`touchend${G}`,et=`pointerdown${G}`,it=`pointerup${G}`,nt={endCallback:null,leftCallback:null,rightCallback:null},st={endCallback:"(function|null)",leftCallback:"(function|null)",rightCallback:"(function|null)"};class ot extends W{constructor(t,e){super(),this._element=t,t&&ot.isSupported()&&(this._config=this._getConfig(e),this._deltaX=0,this._supportPointerEvents=Boolean(window.PointerEvent),this._initEvents())}static get Default(){return nt}static get DefaultType(){return st}static get NAME(){return"swipe"}dispose(){P.off(this._element,G)}_start(t){this._supportPointerEvents?this._eventIsPointerPenTouch(t)&&(this._deltaX=t.clientX):this._deltaX=t.touches[0].clientX}_end(t){this._eventIsPointerPenTouch(t)&&(this._deltaX=t.clientX-this._deltaX),this._handleSwipe(),_(this._config.endCallback)}_move(t){this._deltaX=t.touches&&t.touches.length>1?0:t.touches[0].clientX-this._deltaX}_handleSwipe(){const t=Math.abs(this._deltaX);if(t<=40)return;const e=t/this._deltaX;this._deltaX=0,e&&_(e>0?this._config.rightCallback:this._config.leftCallback)}_initEvents(){this._supportPointerEvents?(P.on(this._element,et,t=>this._start(t)),P.on(this._element,it,t=>this._end(t)),this._element.classList.add("pointer-event")):(P.on(this._element,J,t=>this._start(t)),P.on(this._element,Z,t=>this._move(t)),P.on(this._element,tt,t=>this._end(t)))}_eventIsPointerPenTouch(t){return this._supportPointerEvents&&("pen"===t.pointerType||"touch"===t.pointerType)}static isSupported(){return"ontouchstart"in document.documentElement||navigator.maxTouchPoints>0}}const rt=".bs.carousel",at=".data-api",lt="ArrowLeft",ct="ArrowRight",ht="next",dt="prev",ut="left",ft="right",pt=`slide${rt}`,mt=`slid${rt}`,gt=`keydown${rt}`,_t=`mouseenter${rt}`,bt=`mouseleave${rt}`,vt=`dragstart${rt}`,yt=`load${rt}${at}`,wt=`click${rt}${at}`,At="carousel",Et="active",Tt=".active",Ct=".carousel-item",Ot=Tt+Ct,xt={[lt]:ft,[ct]:ut},kt={interval:5e3,keyboard:!0,pause:"hover",ride:!1,touch:!0,wrap:!0},Lt={interval:"(number|boolean)",keyboard:"boolean",pause:"(string|boolean)",ride:"(boolean|string)",touch:"boolean",wrap:"boolean"};class St extends B{constructor(t,e){super(t,e),this._interval=null,this._activeElement=null,this._isSliding=!1,this.touchTimeout=null,this._swipeHelper=null,this._indicatorsElement=R.findOne(".carousel-indicators",this._element),this._addEventListeners(),this._config.ride===At&&this.cycle()}static get Default(){return kt}static get DefaultType(){return Lt}static get NAME(){return"carousel"}next(){this._slide(ht)}nextWhenVisible(){!document.hidden&&l(this._element)&&this.next()}prev(){this._slide(dt)}pause(){this._isSliding&&o(this._element),this._clearInterval()}cycle(){this._clearInterval(),this._updateInterval(),this._interval=setInterval(()=>this.nextWhenVisible(),this._config.interval)}_maybeEnableCycle(){this._config.ride&&(this._isSliding?P.one(this._element,mt,()=>this.cycle()):this.cycle())}to(t){const e=this._getItems();if(t>e.length-1||t<0)return;if(this._isSliding)return void P.one(this._element,mt,()=>this.to(t));const i=this._getItemIndex(this._getActive());if(i===t)return;const n=t>i?ht:dt;this._slide(n,e[t])}dispose(){this._swipeHelper&&this._swipeHelper.dispose(),super.dispose()}_configAfterMerge(t){return t.defaultInterval=t.interval,t}_addEventListeners(){this._config.keyboard&&P.on(this._element,gt,t=>this._keydown(t)),"hover"===this._config.pause&&(P.on(this._element,_t,()=>this.pause()),P.on(this._element,bt,()=>this._maybeEnableCycle())),this._config.touch&&ot.isSupported()&&this._addTouchEventListeners()}_addTouchEventListeners(){for(const t of R.find(".carousel-item img",this._element))P.on(t,vt,t=>t.preventDefault());const t={leftCallback:()=>this._slide(this._directionToOrder(ut)),rightCallback:()=>this._slide(this._directionToOrder(ft)),endCallback:()=>{"hover"===this._config.pause&&(this.pause(),this.touchTimeout&&clearTimeout(this.touchTimeout),this.touchTimeout=setTimeout(()=>this._maybeEnableCycle(),500+this._config.interval))}};this._swipeHelper=new ot(this._element,t)}_keydown(t){if(/input|textarea/i.test(t.target.tagName))return;const e=xt[t.key];e&&(t.preventDefault(),this._slide(this._directionToOrder(e)))}_getItemIndex(t){return this._getItems().indexOf(t)}_setActiveIndicatorElement(t){if(!this._indicatorsElement)return;const e=R.findOne(Tt,this._indicatorsElement);e.classList.remove(Et),e.removeAttribute("aria-current");const i=R.findOne(`[data-bs-slide-to="${t}"]`,this._indicatorsElement);i&&(i.classList.add(Et),i.setAttribute("aria-current","true"))}_updateInterval(){const t=this._activeElement||this._getActive();if(!t)return;const e=Number.parseInt(t.getAttribute("data-bs-interval"),10);this._config.interval=e||this._config.defaultInterval}_slide(t,e=null){if(this._isSliding)return;const i=this._getActive(),n=t===ht,s=e||v(this._getItems(),i,n,this._config.wrap);if(s===i)return;const o=this._getItemIndex(s),r=e=>P.trigger(this._element,e,{relatedTarget:s,direction:this._orderToDirection(t),from:this._getItemIndex(i),to:o});if(r(pt).defaultPrevented)return;if(!i||!s)return;const a=Boolean(this._interval);this.pause(),this._isSliding=!0,this._setActiveIndicatorElement(o),this._activeElement=s;const l=n?"carousel-item-start":"carousel-item-end",c=n?"carousel-item-next":"carousel-item-prev";s.classList.add(c),u(s),i.classList.add(l),s.classList.add(l),this._queueCallback(()=>{s.classList.remove(l,c),s.classList.add(Et),i.classList.remove(Et,c,l),this._isSliding=!1,r(mt)},i,this._isAnimated()),a&&this.cycle()}_isAnimated(){return this._element.classList.contains("slide")}_getActive(){return R.findOne(Ot,this._element)}_getItems(){return R.find(Ct,this._element)}_clearInterval(){this._interval&&(clearInterval(this._interval),this._interval=null)}_directionToOrder(t){return m()?t===ut?dt:ht:t===ut?ht:dt}_orderToDirection(t){return m()?t===dt?ut:ft:t===dt?ft:ut}static jQueryInterface(t){return this.each(function(){const e=St.getOrCreateInstance(this,t);if("number"!=typeof t){if("string"==typeof t){if(void 0===e[t]||t.startsWith("_")||"constructor"===t)throw new TypeError(`No method named "${t}"`);e[t]()}}else e.to(t)})}}P.on(document,wt,"[data-bs-slide], [data-bs-slide-to]",function(t){const e=R.getElementFromSelector(this);if(!e||!e.classList.contains(At))return;t.preventDefault();const i=St.getOrCreateInstance(e),n=this.getAttribute("data-bs-slide-to");return n?(i.to(n),void i._maybeEnableCycle()):"next"===H.getDataAttribute(this,"slide")?(i.next(),void i._maybeEnableCycle()):(i.prev(),void i._maybeEnableCycle())}),P.on(window,yt,()=>{const t=R.find('[data-bs-ride="carousel"]');for(const e of t)St.getOrCreateInstance(e)}),g(St);const Dt=".bs.collapse",$t=`show${Dt}`,It=`shown${Dt}`,Nt=`hide${Dt}`,Pt=`hidden${Dt}`,jt=`click${Dt}.data-api`,Mt="show",Ft="collapse",Ht="collapsing",Wt=`:scope .${Ft} .${Ft}`,Bt='[data-bs-toggle="collapse"]',zt={parent:null,toggle:!0},Rt={parent:"(null|element)",toggle:"boolean"};class qt extends B{constructor(t,e){super(t,e),this._isTransitioning=!1,this._triggerArray=[];const i=R.find(Bt);for(const t of i){const e=R.getSelectorFromElement(t),i=R.find(e).filter(t=>t===this._element);null!==e&&i.length&&this._triggerArray.push(t)}this._initializeChildren(),this._config.parent||this._addAriaAndCollapsedClass(this._triggerArray,this._isShown()),this._config.toggle&&this.toggle()}static get Default(){return zt}static get DefaultType(){return Rt}static get NAME(){return"collapse"}toggle(){this._isShown()?this.hide():this.show()}show(){if(this._isTransitioning||this._isShown())return;let t=[];if(this._config.parent&&(t=this._getFirstLevelChildren(".collapse.show, .collapse.collapsing").filter(t=>t!==this._element).map(t=>qt.getOrCreateInstance(t,{toggle:!1}))),t.length&&t[0]._isTransitioning)return;if(P.trigger(this._element,$t).defaultPrevented)return;for(const e of t)e.hide();const e=this._getDimension();this._element.classList.remove(Ft),this._element.classList.add(Ht),this._element.style[e]=0,this._addAriaAndCollapsedClass(this._triggerArray,!0),this._isTransitioning=!0;const i=`scroll${e[0].toUpperCase()+e.slice(1)}`;this._queueCallback(()=>{this._isTransitioning=!1,this._element.classList.remove(Ht),this._element.classList.add(Ft,Mt),this._element.style[e]="",P.trigger(this._element,It)},this._element,!0),this._element.style[e]=`${this._element[i]}px`}hide(){if(this._isTransitioning||!this._isShown())return;if(P.trigger(this._element,Nt).defaultPrevented)return;const t=this._getDimension();this._element.style[t]=`${this._element.getBoundingClientRect()[t]}px`,u(this._element),this._element.classList.add(Ht),this._element.classList.remove(Ft,Mt);for(const t of this._triggerArray){const e=R.getElementFromSelector(t);e&&!this._isShown(e)&&this._addAriaAndCollapsedClass([t],!1)}this._isTransitioning=!0,this._element.style[t]="",this._queueCallback(()=>{this._isTransitioning=!1,this._element.classList.remove(Ht),this._element.classList.add(Ft),P.trigger(this._element,Pt)},this._element,!0)}_isShown(t=this._element){return t.classList.contains(Mt)}_configAfterMerge(t){return t.toggle=Boolean(t.toggle),t.parent=a(t.parent),t}_getDimension(){return this._element.classList.contains("collapse-horizontal")?"width":"height"}_initializeChildren(){if(!this._config.parent)return;const t=this._getFirstLevelChildren(Bt);for(const e of t){const t=R.getElementFromSelector(e);t&&this._addAriaAndCollapsedClass([e],this._isShown(t))}}_getFirstLevelChildren(t){const e=R.find(Wt,this._config.parent);return R.find(t,this._config.parent).filter(t=>!e.includes(t))}_addAriaAndCollapsedClass(t,e){if(t.length)for(const i of t)i.classList.toggle("collapsed",!e),i.setAttribute("aria-expanded",e)}static jQueryInterface(t){const e={};return"string"==typeof t&&/show|hide/.test(t)&&(e.toggle=!1),this.each(function(){const i=qt.getOrCreateInstance(this,e);if("string"==typeof t){if(void 0===i[t])throw new TypeError(`No method named "${t}"`);i[t]()}})}}P.on(document,jt,Bt,function(t){("A"===t.target.tagName||t.delegateTarget&&"A"===t.delegateTarget.tagName)&&t.preventDefault();for(const t of R.getMultipleElementsFromSelector(this))qt.getOrCreateInstance(t,{toggle:!1}).toggle()}),g(qt);var Vt="top",Kt="bottom",Qt="right",Xt="left",Yt="auto",Ut=[Vt,Kt,Qt,Xt],Gt="start",Jt="end",Zt="clippingParents",te="viewport",ee="popper",ie="reference",ne=Ut.reduce(function(t,e){return t.concat([e+"-"+Gt,e+"-"+Jt])},[]),se=[].concat(Ut,[Yt]).reduce(function(t,e){return t.concat([e,e+"-"+Gt,e+"-"+Jt])},[]),oe="beforeRead",re="read",ae="afterRead",le="beforeMain",ce="main",he="afterMain",de="beforeWrite",ue="write",fe="afterWrite",pe=[oe,re,ae,le,ce,he,de,ue,fe];function me(t){return t?(t.nodeName||"").toLowerCase():null}function ge(t){if(null==t)return window;if("[object Window]"!==t.toString()){var e=t.ownerDocument;return e&&e.defaultView||window}return t}function _e(t){return t instanceof ge(t).Element||t instanceof Element}function be(t){return t instanceof ge(t).HTMLElement||t instanceof HTMLElement}function ve(t){return"undefined"!=typeof ShadowRoot&&(t instanceof ge(t).ShadowRoot||t instanceof ShadowRoot)}const ye={name:"applyStyles",enabled:!0,phase:"write",fn:function(t){var e=t.state;Object.keys(e.elements).forEach(function(t){var i=e.styles[t]||{},n=e.attributes[t]||{},s=e.elements[t];be(s)&&me(s)&&(Object.assign(s.style,i),Object.keys(n).forEach(function(t){var e=n[t];!1===e?s.removeAttribute(t):s.setAttribute(t,!0===e?"":e)}))})},effect:function(t){var e=t.state,i={popper:{position:e.options.strategy,left:"0",top:"0",margin:"0"},arrow:{position:"absolute"},reference:{}};return Object.assign(e.elements.popper.style,i.popper),e.styles=i,e.elements.arrow&&Object.assign(e.elements.arrow.style,i.arrow),function(){Object.keys(e.elements).forEach(function(t){var n=e.elements[t],s=e.attributes[t]||{},o=Object.keys(e.styles.hasOwnProperty(t)?e.styles[t]:i[t]).reduce(function(t,e){return t[e]="",t},{});be(n)&&me(n)&&(Object.assign(n.style,o),Object.keys(s).forEach(function(t){n.removeAttribute(t)}))})}},requires:["computeStyles"]};function we(t){return t.split("-")[0]}var Ae=Math.max,Ee=Math.min,Te=Math.round;function Ce(){var t=navigator.userAgentData;return null!=t&&t.brands&&Array.isArray(t.brands)?t.brands.map(function(t){return t.brand+"/"+t.version}).join(" "):navigator.userAgent}function Oe(){return!/^((?!chrome|android).)*safari/i.test(Ce())}function xe(t,e,i){void 0===e&&(e=!1),void 0===i&&(i=!1);var n=t.getBoundingClientRect(),s=1,o=1;e&&be(t)&&(s=t.offsetWidth>0&&Te(n.width)/t.offsetWidth||1,o=t.offsetHeight>0&&Te(n.height)/t.offsetHeight||1);var r=(_e(t)?ge(t):window).visualViewport,a=!Oe()&&i,l=(n.left+(a&&r?r.offsetLeft:0))/s,c=(n.top+(a&&r?r.offsetTop:0))/o,h=n.width/s,d=n.height/o;return{width:h,height:d,top:c,right:l+h,bottom:c+d,left:l,x:l,y:c}}function ke(t){var e=xe(t),i=t.offsetWidth,n=t.offsetHeight;return Math.abs(e.width-i)<=1&&(i=e.width),Math.abs(e.height-n)<=1&&(n=e.height),{x:t.offsetLeft,y:t.offsetTop,width:i,height:n}}function Le(t,e){var i=e.getRootNode&&e.getRootNode();if(t.contains(e))return!0;if(i&&ve(i)){var n=e;do{if(n&&t.isSameNode(n))return!0;n=n.parentNode||n.host}while(n)}return!1}function Se(t){return ge(t).getComputedStyle(t)}function De(t){return["table","td","th"].indexOf(me(t))>=0}function $e(t){return((_e(t)?t.ownerDocument:t.document)||window.document).documentElement}function Ie(t){return"html"===me(t)?t:t.assignedSlot||t.parentNode||(ve(t)?t.host:null)||$e(t)}function Ne(t){return be(t)&&"fixed"!==Se(t).position?t.offsetParent:null}function Pe(t){for(var e=ge(t),i=Ne(t);i&&De(i)&&"static"===Se(i).position;)i=Ne(i);return i&&("html"===me(i)||"body"===me(i)&&"static"===Se(i).position)?e:i||function(t){var e=/firefox/i.test(Ce());if(/Trident/i.test(Ce())&&be(t)&&"fixed"===Se(t).position)return null;var i=Ie(t);for(ve(i)&&(i=i.host);be(i)&&["html","body"].indexOf(me(i))<0;){var n=Se(i);if("none"!==n.transform||"none"!==n.perspective||"paint"===n.contain||-1!==["transform","perspective"].indexOf(n.willChange)||e&&"filter"===n.willChange||e&&n.filter&&"none"!==n.filter)return i;i=i.parentNode}return null}(t)||e}function je(t){return["top","bottom"].indexOf(t)>=0?"x":"y"}function Me(t,e,i){return Ae(t,Ee(e,i))}function Fe(t){return Object.assign({},{top:0,right:0,bottom:0,left:0},t)}function He(t,e){return e.reduce(function(e,i){return e[i]=t,e},{})}const We={name:"arrow",enabled:!0,phase:"main",fn:function(t){var e,i=t.state,n=t.name,s=t.options,o=i.elements.arrow,r=i.modifiersData.popperOffsets,a=we(i.placement),l=je(a),c=[Xt,Qt].indexOf(a)>=0?"height":"width";if(o&&r){var h=function(t,e){return Fe("number"!=typeof(t="function"==typeof t?t(Object.assign({},e.rects,{placement:e.placement})):t)?t:He(t,Ut))}(s.padding,i),d=ke(o),u="y"===l?Vt:Xt,f="y"===l?Kt:Qt,p=i.rects.reference[c]+i.rects.reference[l]-r[l]-i.rects.popper[c],m=r[l]-i.rects.reference[l],g=Pe(o),_=g?"y"===l?g.clientHeight||0:g.clientWidth||0:0,b=p/2-m/2,v=h[u],y=_-d[c]-h[f],w=_/2-d[c]/2+b,A=Me(v,w,y),E=l;i.modifiersData[n]=((e={})[E]=A,e.centerOffset=A-w,e)}},effect:function(t){var e=t.state,i=t.options.element,n=void 0===i?"[data-popper-arrow]":i;null!=n&&("string"!=typeof n||(n=e.elements.popper.querySelector(n)))&&Le(e.elements.popper,n)&&(e.elements.arrow=n)},requires:["popperOffsets"],requiresIfExists:["preventOverflow"]};function Be(t){return t.split("-")[1]}var ze={top:"auto",right:"auto",bottom:"auto",left:"auto"};function Re(t){var e,i=t.popper,n=t.popperRect,s=t.placement,o=t.variation,r=t.offsets,a=t.position,l=t.gpuAcceleration,c=t.adaptive,h=t.roundOffsets,d=t.isFixed,u=r.x,f=void 0===u?0:u,p=r.y,m=void 0===p?0:p,g="function"==typeof h?h({x:f,y:m}):{x:f,y:m};f=g.x,m=g.y;var _=r.hasOwnProperty("x"),b=r.hasOwnProperty("y"),v=Xt,y=Vt,w=window;if(c){var A=Pe(i),E="clientHeight",T="clientWidth";A===ge(i)&&"static"!==Se(A=$e(i)).position&&"absolute"===a&&(E="scrollHeight",T="scrollWidth"),(s===Vt||(s===Xt||s===Qt)&&o===Jt)&&(y=Kt,m-=(d&&A===w&&w.visualViewport?w.visualViewport.height:A[E])-n.height,m*=l?1:-1),s!==Xt&&(s!==Vt&&s!==Kt||o!==Jt)||(v=Qt,f-=(d&&A===w&&w.visualViewport?w.visualViewport.width:A[T])-n.width,f*=l?1:-1)}var C,O=Object.assign({position:a},c&&ze),x=!0===h?function(t,e){var i=t.x,n=t.y,s=e.devicePixelRatio||1;return{x:Te(i*s)/s||0,y:Te(n*s)/s||0}}({x:f,y:m},ge(i)):{x:f,y:m};return f=x.x,m=x.y,l?Object.assign({},O,((C={})[y]=b?"0":"",C[v]=_?"0":"",C.transform=(w.devicePixelRatio||1)<=1?"translate("+f+"px, "+m+"px)":"translate3d("+f+"px, "+m+"px, 0)",C)):Object.assign({},O,((e={})[y]=b?m+"px":"",e[v]=_?f+"px":"",e.transform="",e))}const qe={name:"computeStyles",enabled:!0,phase:"beforeWrite",fn:function(t){var e=t.state,i=t.options,n=i.gpuAcceleration,s=void 0===n||n,o=i.adaptive,r=void 0===o||o,a=i.roundOffsets,l=void 0===a||a,c={placement:we(e.placement),variation:Be(e.placement),popper:e.elements.popper,popperRect:e.rects.popper,gpuAcceleration:s,isFixed:"fixed"===e.options.strategy};null!=e.modifiersData.popperOffsets&&(e.styles.popper=Object.assign({},e.styles.popper,Re(Object.assign({},c,{offsets:e.modifiersData.popperOffsets,position:e.options.strategy,adaptive:r,roundOffsets:l})))),null!=e.modifiersData.arrow&&(e.styles.arrow=Object.assign({},e.styles.arrow,Re(Object.assign({},c,{offsets:e.modifiersData.arrow,position:"absolute",adaptive:!1,roundOffsets:l})))),e.attributes.popper=Object.assign({},e.attributes.popper,{"data-popper-placement":e.placement})},data:{}};var Ve={passive:!0};const Ke={name:"eventListeners",enabled:!0,phase:"write",fn:function(){},effect:function(t){var e=t.state,i=t.instance,n=t.options,s=n.scroll,o=void 0===s||s,r=n.resize,a=void 0===r||r,l=ge(e.elements.popper),c=[].concat(e.scrollParents.reference,e.scrollParents.popper);return o&&c.forEach(function(t){t.addEventListener("scroll",i.update,Ve)}),a&&l.addEventListener("resize",i.update,Ve),function(){o&&c.forEach(function(t){t.removeEventListener("scroll",i.update,Ve)}),a&&l.removeEventListener("resize",i.update,Ve)}},data:{}};var Qe={left:"right",right:"left",bottom:"top",top:"bottom"};function Xe(t){return t.replace(/left|right|bottom|top/g,function(t){return Qe[t]})}var Ye={start:"end",end:"start"};function Ue(t){return t.replace(/start|end/g,function(t){return Ye[t]})}function Ge(t){var e=ge(t);return{scrollLeft:e.pageXOffset,scrollTop:e.pageYOffset}}function Je(t){return xe($e(t)).left+Ge(t).scrollLeft}function Ze(t){var e=Se(t),i=e.overflow,n=e.overflowX,s=e.overflowY;return/auto|scroll|overlay|hidden/.test(i+s+n)}function ti(t){return["html","body","#document"].indexOf(me(t))>=0?t.ownerDocument.body:be(t)&&Ze(t)?t:ti(Ie(t))}function ei(t,e){var i;void 0===e&&(e=[]);var n=ti(t),s=n===(null==(i=t.ownerDocument)?void 0:i.body),o=ge(n),r=s?[o].concat(o.visualViewport||[],Ze(n)?n:[]):n,a=e.concat(r);return s?a:a.concat(ei(Ie(r)))}function ii(t){return Object.assign({},t,{left:t.x,top:t.y,right:t.x+t.width,bottom:t.y+t.height})}function ni(t,e,i){return e===te?ii(function(t,e){var i=ge(t),n=$e(t),s=i.visualViewport,o=n.clientWidth,r=n.clientHeight,a=0,l=0;if(s){o=s.width,r=s.height;var c=Oe();(c||!c&&"fixed"===e)&&(a=s.offsetLeft,l=s.offsetTop)}return{width:o,height:r,x:a+Je(t),y:l}}(t,i)):_e(e)?function(t,e){var i=xe(t,!1,"fixed"===e);return i.top=i.top+t.clientTop,i.left=i.left+t.clientLeft,i.bottom=i.top+t.clientHeight,i.right=i.left+t.clientWidth,i.width=t.clientWidth,i.height=t.clientHeight,i.x=i.left,i.y=i.top,i}(e,i):ii(function(t){var e,i=$e(t),n=Ge(t),s=null==(e=t.ownerDocument)?void 0:e.body,o=Ae(i.scrollWidth,i.clientWidth,s?s.scrollWidth:0,s?s.clientWidth:0),r=Ae(i.scrollHeight,i.clientHeight,s?s.scrollHeight:0,s?s.clientHeight:0),a=-n.scrollLeft+Je(t),l=-n.scrollTop;return"rtl"===Se(s||i).direction&&(a+=Ae(i.clientWidth,s?s.clientWidth:0)-o),{width:o,height:r,x:a,y:l}}($e(t)))}function si(t){var e,i=t.reference,n=t.element,s=t.placement,o=s?we(s):null,r=s?Be(s):null,a=i.x+i.width/2-n.width/2,l=i.y+i.height/2-n.height/2;switch(o){case Vt:e={x:a,y:i.y-n.height};break;case Kt:e={x:a,y:i.y+i.height};break;case Qt:e={x:i.x+i.width,y:l};break;case Xt:e={x:i.x-n.width,y:l};break;default:e={x:i.x,y:i.y}}var c=o?je(o):null;if(null!=c){var h="y"===c?"height":"width";switch(r){case Gt:e[c]=e[c]-(i[h]/2-n[h]/2);break;case Jt:e[c]=e[c]+(i[h]/2-n[h]/2)}}return e}function oi(t,e){void 0===e&&(e={});var i=e,n=i.placement,s=void 0===n?t.placement:n,o=i.strategy,r=void 0===o?t.strategy:o,a=i.boundary,l=void 0===a?Zt:a,c=i.rootBoundary,h=void 0===c?te:c,d=i.elementContext,u=void 0===d?ee:d,f=i.altBoundary,p=void 0!==f&&f,m=i.padding,g=void 0===m?0:m,_=Fe("number"!=typeof g?g:He(g,Ut)),b=u===ee?ie:ee,v=t.rects.popper,y=t.elements[p?b:u],w=function(t,e,i,n){var s="clippingParents"===e?function(t){var e=ei(Ie(t)),i=["absolute","fixed"].indexOf(Se(t).position)>=0&&be(t)?Pe(t):t;return _e(i)?e.filter(function(t){return _e(t)&&Le(t,i)&&"body"!==me(t)}):[]}(t):[].concat(e),o=[].concat(s,[i]),r=o[0],a=o.reduce(function(e,i){var s=ni(t,i,n);return e.top=Ae(s.top,e.top),e.right=Ee(s.right,e.right),e.bottom=Ee(s.bottom,e.bottom),e.left=Ae(s.left,e.left),e},ni(t,r,n));return a.width=a.right-a.left,a.height=a.bottom-a.top,a.x=a.left,a.y=a.top,a}(_e(y)?y:y.contextElement||$e(t.elements.popper),l,h,r),A=xe(t.elements.reference),E=si({reference:A,element:v,placement:s}),T=ii(Object.assign({},v,E)),C=u===ee?T:A,O={top:w.top-C.top+_.top,bottom:C.bottom-w.bottom+_.bottom,left:w.left-C.left+_.left,right:C.right-w.right+_.right},x=t.modifiersData.offset;if(u===ee&&x){var k=x[s];Object.keys(O).forEach(function(t){var e=[Qt,Kt].indexOf(t)>=0?1:-1,i=[Vt,Kt].indexOf(t)>=0?"y":"x";O[t]+=k[i]*e})}return O}function ri(t,e){void 0===e&&(e={});var i=e,n=i.placement,s=i.boundary,o=i.rootBoundary,r=i.padding,a=i.flipVariations,l=i.allowedAutoPlacements,c=void 0===l?se:l,h=Be(n),d=h?a?ne:ne.filter(function(t){return Be(t)===h}):Ut,u=d.filter(function(t){return c.indexOf(t)>=0});0===u.length&&(u=d);var f=u.reduce(function(e,i){return e[i]=oi(t,{placement:i,boundary:s,rootBoundary:o,padding:r})[we(i)],e},{});return Object.keys(f).sort(function(t,e){return f[t]-f[e]})}const ai={name:"flip",enabled:!0,phase:"main",fn:function(t){var e=t.state,i=t.options,n=t.name;if(!e.modifiersData[n]._skip){for(var s=i.mainAxis,o=void 0===s||s,r=i.altAxis,a=void 0===r||r,l=i.fallbackPlacements,c=i.padding,h=i.boundary,d=i.rootBoundary,u=i.altBoundary,f=i.flipVariations,p=void 0===f||f,m=i.allowedAutoPlacements,g=e.options.placement,_=we(g),b=l||(_!==g&&p?function(t){if(we(t)===Yt)return[];var e=Xe(t);return[Ue(t),e,Ue(e)]}(g):[Xe(g)]),v=[g].concat(b).reduce(function(t,i){return t.concat(we(i)===Yt?ri(e,{placement:i,boundary:h,rootBoundary:d,padding:c,flipVariations:p,allowedAutoPlacements:m}):i)},[]),y=e.rects.reference,w=e.rects.popper,A=new Map,E=!0,T=v[0],C=0;C=0,S=L?"width":"height",D=oi(e,{placement:O,boundary:h,rootBoundary:d,altBoundary:u,padding:c}),$=L?k?Qt:Xt:k?Kt:Vt;y[S]>w[S]&&($=Xe($));var I=Xe($),N=[];if(o&&N.push(D[x]<=0),a&&N.push(D[$]<=0,D[I]<=0),N.every(function(t){return t})){T=O,E=!1;break}A.set(O,N)}if(E)for(var P=function(t){var e=v.find(function(e){var i=A.get(e);if(i)return i.slice(0,t).every(function(t){return t})});if(e)return T=e,"break"},j=p?3:1;j>0&&"break"!==P(j);j--);e.placement!==T&&(e.modifiersData[n]._skip=!0,e.placement=T,e.reset=!0)}},requiresIfExists:["offset"],data:{_skip:!1}};function li(t,e,i){return void 0===i&&(i={x:0,y:0}),{top:t.top-e.height-i.y,right:t.right-e.width+i.x,bottom:t.bottom-e.height+i.y,left:t.left-e.width-i.x}}function ci(t){return[Vt,Qt,Kt,Xt].some(function(e){return t[e]>=0})}const hi={name:"hide",enabled:!0,phase:"main",requiresIfExists:["preventOverflow"],fn:function(t){var e=t.state,i=t.name,n=e.rects.reference,s=e.rects.popper,o=e.modifiersData.preventOverflow,r=oi(e,{elementContext:"reference"}),a=oi(e,{altBoundary:!0}),l=li(r,n),c=li(a,s,o),h=ci(l),d=ci(c);e.modifiersData[i]={referenceClippingOffsets:l,popperEscapeOffsets:c,isReferenceHidden:h,hasPopperEscaped:d},e.attributes.popper=Object.assign({},e.attributes.popper,{"data-popper-reference-hidden":h,"data-popper-escaped":d})}},di={name:"offset",enabled:!0,phase:"main",requires:["popperOffsets"],fn:function(t){var e=t.state,i=t.options,n=t.name,s=i.offset,o=void 0===s?[0,0]:s,r=se.reduce(function(t,i){return t[i]=function(t,e,i){var n=we(t),s=[Xt,Vt].indexOf(n)>=0?-1:1,o="function"==typeof i?i(Object.assign({},e,{placement:t})):i,r=o[0],a=o[1];return r=r||0,a=(a||0)*s,[Xt,Qt].indexOf(n)>=0?{x:a,y:r}:{x:r,y:a}}(i,e.rects,o),t},{}),a=r[e.placement],l=a.x,c=a.y;null!=e.modifiersData.popperOffsets&&(e.modifiersData.popperOffsets.x+=l,e.modifiersData.popperOffsets.y+=c),e.modifiersData[n]=r}},ui={name:"popperOffsets",enabled:!0,phase:"read",fn:function(t){var e=t.state,i=t.name;e.modifiersData[i]=si({reference:e.rects.reference,element:e.rects.popper,placement:e.placement})},data:{}},fi={name:"preventOverflow",enabled:!0,phase:"main",fn:function(t){var e=t.state,i=t.options,n=t.name,s=i.mainAxis,o=void 0===s||s,r=i.altAxis,a=void 0!==r&&r,l=i.boundary,c=i.rootBoundary,h=i.altBoundary,d=i.padding,u=i.tether,f=void 0===u||u,p=i.tetherOffset,m=void 0===p?0:p,g=oi(e,{boundary:l,rootBoundary:c,padding:d,altBoundary:h}),_=we(e.placement),b=Be(e.placement),v=!b,y=je(_),w="x"===y?"y":"x",A=e.modifiersData.popperOffsets,E=e.rects.reference,T=e.rects.popper,C="function"==typeof m?m(Object.assign({},e.rects,{placement:e.placement})):m,O="number"==typeof C?{mainAxis:C,altAxis:C}:Object.assign({mainAxis:0,altAxis:0},C),x=e.modifiersData.offset?e.modifiersData.offset[e.placement]:null,k={x:0,y:0};if(A){if(o){var L,S="y"===y?Vt:Xt,D="y"===y?Kt:Qt,$="y"===y?"height":"width",I=A[y],N=I+g[S],P=I-g[D],j=f?-T[$]/2:0,M=b===Gt?E[$]:T[$],F=b===Gt?-T[$]:-E[$],H=e.elements.arrow,W=f&&H?ke(H):{width:0,height:0},B=e.modifiersData["arrow#persistent"]?e.modifiersData["arrow#persistent"].padding:{top:0,right:0,bottom:0,left:0},z=B[S],R=B[D],q=Me(0,E[$],W[$]),V=v?E[$]/2-j-q-z-O.mainAxis:M-q-z-O.mainAxis,K=v?-E[$]/2+j+q+R+O.mainAxis:F+q+R+O.mainAxis,Q=e.elements.arrow&&Pe(e.elements.arrow),X=Q?"y"===y?Q.clientTop||0:Q.clientLeft||0:0,Y=null!=(L=null==x?void 0:x[y])?L:0,U=I+K-Y,G=Me(f?Ee(N,I+V-Y-X):N,I,f?Ae(P,U):P);A[y]=G,k[y]=G-I}if(a){var J,Z="x"===y?Vt:Xt,tt="x"===y?Kt:Qt,et=A[w],it="y"===w?"height":"width",nt=et+g[Z],st=et-g[tt],ot=-1!==[Vt,Xt].indexOf(_),rt=null!=(J=null==x?void 0:x[w])?J:0,at=ot?nt:et-E[it]-T[it]-rt+O.altAxis,lt=ot?et+E[it]+T[it]-rt-O.altAxis:st,ct=f&&ot?function(t,e,i){var n=Me(t,e,i);return n>i?i:n}(at,et,lt):Me(f?at:nt,et,f?lt:st);A[w]=ct,k[w]=ct-et}e.modifiersData[n]=k}},requiresIfExists:["offset"]};function pi(t,e,i){void 0===i&&(i=!1);var n,s,o=be(e),r=be(e)&&function(t){var e=t.getBoundingClientRect(),i=Te(e.width)/t.offsetWidth||1,n=Te(e.height)/t.offsetHeight||1;return 1!==i||1!==n}(e),a=$e(e),l=xe(t,r,i),c={scrollLeft:0,scrollTop:0},h={x:0,y:0};return(o||!o&&!i)&&(("body"!==me(e)||Ze(a))&&(c=(n=e)!==ge(n)&&be(n)?{scrollLeft:(s=n).scrollLeft,scrollTop:s.scrollTop}:Ge(n)),be(e)?((h=xe(e,!0)).x+=e.clientLeft,h.y+=e.clientTop):a&&(h.x=Je(a))),{x:l.left+c.scrollLeft-h.x,y:l.top+c.scrollTop-h.y,width:l.width,height:l.height}}function mi(t){var e=new Map,i=new Set,n=[];function s(t){i.add(t.name),[].concat(t.requires||[],t.requiresIfExists||[]).forEach(function(t){if(!i.has(t)){var n=e.get(t);n&&s(n)}}),n.push(t)}return t.forEach(function(t){e.set(t.name,t)}),t.forEach(function(t){i.has(t.name)||s(t)}),n}var gi={placement:"bottom",modifiers:[],strategy:"absolute"};function _i(){for(var t=arguments.length,e=new Array(t),i=0;iNumber.parseInt(t,10)):"function"==typeof t?e=>t(e,this._element):t}_getPopperConfig(){const t={placement:this._getPlacement(),modifiers:[{name:"preventOverflow",options:{boundary:this._config.boundary}},{name:"offset",options:{offset:this._getOffset()}}]};return(this._inNavbar||"static"===this._config.display)&&(H.setDataAttribute(this._menu,"popper","static"),t.modifiers=[{name:"applyStyles",enabled:!1}]),{...t,..._(this._config.popperConfig,[void 0,t])}}_selectMenuItem({key:t,target:e}){const i=R.find(".dropdown-menu .dropdown-item:not(.disabled):not(:disabled)",this._menu).filter(t=>l(t));i.length&&v(i,e,t===xi,!i.includes(e)).focus()}static jQueryInterface(t){return this.each(function(){const e=Qi.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t])throw new TypeError(`No method named "${t}"`);e[t]()}})}static clearMenus(t){if(2===t.button||"keyup"===t.type&&"Tab"!==t.key)return;const e=R.find(Mi);for(const i of e){const e=Qi.getInstance(i);if(!e||!1===e._config.autoClose)continue;const n=t.composedPath(),s=n.includes(e._menu);if(n.includes(e._element)||"inside"===e._config.autoClose&&!s||"outside"===e._config.autoClose&&s)continue;if(e._menu.contains(t.target)&&("keyup"===t.type&&"Tab"===t.key||/input|select|option|textarea|form/i.test(t.target.tagName)))continue;const o={relatedTarget:e._element};"click"===t.type&&(o.clickEvent=t),e._completeHide(o)}}static dataApiKeydownHandler(t){const e=/input|textarea/i.test(t.target.tagName),i="Escape"===t.key,n=[Oi,xi].includes(t.key);if(!n&&!i)return;if(e&&!i)return;t.preventDefault();const s=this.matches(ji)?this:R.prev(this,ji)[0]||R.next(this,ji)[0]||R.findOne(ji,t.delegateTarget.parentNode),o=Qi.getOrCreateInstance(s);if(n)return t.stopPropagation(),o.show(),void o._selectMenuItem(t);o._isShown()&&(t.stopPropagation(),o.hide(),s.focus())}}P.on(document,Ii,ji,Qi.dataApiKeydownHandler),P.on(document,Ii,Fi,Qi.dataApiKeydownHandler),P.on(document,$i,Qi.clearMenus),P.on(document,Ni,Qi.clearMenus),P.on(document,$i,ji,function(t){t.preventDefault(),Qi.getOrCreateInstance(this).toggle()}),g(Qi);const Xi="backdrop",Yi="show",Ui=`mousedown.bs.${Xi}`,Gi={className:"modal-backdrop",clickCallback:null,isAnimated:!1,isVisible:!0,rootElement:"body"},Ji={className:"string",clickCallback:"(function|null)",isAnimated:"boolean",isVisible:"boolean",rootElement:"(element|string)"};class Zi extends W{constructor(t){super(),this._config=this._getConfig(t),this._isAppended=!1,this._element=null}static get Default(){return Gi}static get DefaultType(){return Ji}static get NAME(){return Xi}show(t){if(!this._config.isVisible)return void _(t);this._append();const e=this._getElement();this._config.isAnimated&&u(e),e.classList.add(Yi),this._emulateAnimation(()=>{_(t)})}hide(t){this._config.isVisible?(this._getElement().classList.remove(Yi),this._emulateAnimation(()=>{this.dispose(),_(t)})):_(t)}dispose(){this._isAppended&&(P.off(this._element,Ui),this._element.remove(),this._isAppended=!1)}_getElement(){if(!this._element){const t=document.createElement("div");t.className=this._config.className,this._config.isAnimated&&t.classList.add("fade"),this._element=t}return this._element}_configAfterMerge(t){return t.rootElement=a(t.rootElement),t}_append(){if(this._isAppended)return;const t=this._getElement();this._config.rootElement.append(t),P.on(t,Ui,()=>{_(this._config.clickCallback)}),this._isAppended=!0}_emulateAnimation(t){b(t,this._getElement(),this._config.isAnimated)}}const tn=".bs.focustrap",en=`focusin${tn}`,nn=`keydown.tab${tn}`,sn="backward",on={autofocus:!0,trapElement:null},rn={autofocus:"boolean",trapElement:"element"};class an extends W{constructor(t){super(),this._config=this._getConfig(t),this._isActive=!1,this._lastTabNavDirection=null}static get Default(){return on}static get DefaultType(){return rn}static get NAME(){return"focustrap"}activate(){this._isActive||(this._config.autofocus&&this._config.trapElement.focus(),P.off(document,tn),P.on(document,en,t=>this._handleFocusin(t)),P.on(document,nn,t=>this._handleKeydown(t)),this._isActive=!0)}deactivate(){this._isActive&&(this._isActive=!1,P.off(document,tn))}_handleFocusin(t){const{trapElement:e}=this._config;if(t.target===document||t.target===e||e.contains(t.target))return;const i=R.focusableChildren(e);0===i.length?e.focus():this._lastTabNavDirection===sn?i[i.length-1].focus():i[0].focus()}_handleKeydown(t){"Tab"===t.key&&(this._lastTabNavDirection=t.shiftKey?sn:"forward")}}const ln=".fixed-top, .fixed-bottom, .is-fixed, .sticky-top",cn=".sticky-top",hn="padding-right",dn="margin-right";class un{constructor(){this._element=document.body}getWidth(){const t=document.documentElement.clientWidth;return Math.abs(window.innerWidth-t)}hide(){const t=this.getWidth();this._disableOverFlow(),this._setElementAttributes(this._element,hn,e=>e+t),this._setElementAttributes(ln,hn,e=>e+t),this._setElementAttributes(cn,dn,e=>e-t)}reset(){this._resetElementAttributes(this._element,"overflow"),this._resetElementAttributes(this._element,hn),this._resetElementAttributes(ln,hn),this._resetElementAttributes(cn,dn)}isOverflowing(){return this.getWidth()>0}_disableOverFlow(){this._saveInitialAttribute(this._element,"overflow"),this._element.style.overflow="hidden"}_setElementAttributes(t,e,i){const n=this.getWidth();this._applyManipulationCallback(t,t=>{if(t!==this._element&&window.innerWidth>t.clientWidth+n)return;this._saveInitialAttribute(t,e);const s=window.getComputedStyle(t).getPropertyValue(e);t.style.setProperty(e,`${i(Number.parseFloat(s))}px`)})}_saveInitialAttribute(t,e){const i=t.style.getPropertyValue(e);i&&H.setDataAttribute(t,e,i)}_resetElementAttributes(t,e){this._applyManipulationCallback(t,t=>{const i=H.getDataAttribute(t,e);null!==i?(H.removeDataAttribute(t,e),t.style.setProperty(e,i)):t.style.removeProperty(e)})}_applyManipulationCallback(t,e){if(r(t))e(t);else for(const i of R.find(t,this._element))e(i)}}const fn=".bs.modal",pn=`hide${fn}`,mn=`hidePrevented${fn}`,gn=`hidden${fn}`,_n=`show${fn}`,bn=`shown${fn}`,vn=`resize${fn}`,yn=`click.dismiss${fn}`,wn=`mousedown.dismiss${fn}`,An=`keydown.dismiss${fn}`,En=`click${fn}.data-api`,Tn="modal-open",Cn="show",On="modal-static",xn={backdrop:!0,focus:!0,keyboard:!0},kn={backdrop:"(boolean|string)",focus:"boolean",keyboard:"boolean"};class Ln extends B{constructor(t,e){super(t,e),this._dialog=R.findOne(".modal-dialog",this._element),this._backdrop=this._initializeBackDrop(),this._focustrap=this._initializeFocusTrap(),this._isShown=!1,this._isTransitioning=!1,this._scrollBar=new un,this._addEventListeners()}static get Default(){return xn}static get DefaultType(){return kn}static get NAME(){return"modal"}toggle(t){return this._isShown?this.hide():this.show(t)}show(t){this._isShown||this._isTransitioning||P.trigger(this._element,_n,{relatedTarget:t}).defaultPrevented||(this._isShown=!0,this._isTransitioning=!0,this._scrollBar.hide(),document.body.classList.add(Tn),this._adjustDialog(),this._backdrop.show(()=>this._showElement(t)))}hide(){this._isShown&&!this._isTransitioning&&(P.trigger(this._element,pn).defaultPrevented||(this._isShown=!1,this._isTransitioning=!0,this._focustrap.deactivate(),this._element.classList.remove(Cn),this._queueCallback(()=>this._hideModal(),this._element,this._isAnimated())))}dispose(){P.off(window,fn),P.off(this._dialog,fn),this._backdrop.dispose(),this._focustrap.deactivate(),super.dispose()}handleUpdate(){this._adjustDialog()}_initializeBackDrop(){return new Zi({isVisible:Boolean(this._config.backdrop),isAnimated:this._isAnimated()})}_initializeFocusTrap(){return new an({trapElement:this._element})}_showElement(t){document.body.contains(this._element)||document.body.append(this._element),this._element.style.display="block",this._element.removeAttribute("aria-hidden"),this._element.setAttribute("aria-modal",!0),this._element.setAttribute("role","dialog"),this._element.scrollTop=0;const e=R.findOne(".modal-body",this._dialog);e&&(e.scrollTop=0),u(this._element),this._element.classList.add(Cn),this._queueCallback(()=>{this._config.focus&&this._focustrap.activate(),this._isTransitioning=!1,P.trigger(this._element,bn,{relatedTarget:t})},this._dialog,this._isAnimated())}_addEventListeners(){P.on(this._element,An,t=>{"Escape"===t.key&&(this._config.keyboard?this.hide():this._triggerBackdropTransition())}),P.on(window,vn,()=>{this._isShown&&!this._isTransitioning&&this._adjustDialog()}),P.on(this._element,wn,t=>{P.one(this._element,yn,e=>{this._element===t.target&&this._element===e.target&&("static"!==this._config.backdrop?this._config.backdrop&&this.hide():this._triggerBackdropTransition())})})}_hideModal(){this._element.style.display="none",this._element.setAttribute("aria-hidden",!0),this._element.removeAttribute("aria-modal"),this._element.removeAttribute("role"),this._isTransitioning=!1,this._backdrop.hide(()=>{document.body.classList.remove(Tn),this._resetAdjustments(),this._scrollBar.reset(),P.trigger(this._element,gn)})}_isAnimated(){return this._element.classList.contains("fade")}_triggerBackdropTransition(){if(P.trigger(this._element,mn).defaultPrevented)return;const t=this._element.scrollHeight>document.documentElement.clientHeight,e=this._element.style.overflowY;"hidden"===e||this._element.classList.contains(On)||(t||(this._element.style.overflowY="hidden"),this._element.classList.add(On),this._queueCallback(()=>{this._element.classList.remove(On),this._queueCallback(()=>{this._element.style.overflowY=e},this._dialog)},this._dialog),this._element.focus())}_adjustDialog(){const t=this._element.scrollHeight>document.documentElement.clientHeight,e=this._scrollBar.getWidth(),i=e>0;if(i&&!t){const t=m()?"paddingLeft":"paddingRight";this._element.style[t]=`${e}px`}if(!i&&t){const t=m()?"paddingRight":"paddingLeft";this._element.style[t]=`${e}px`}}_resetAdjustments(){this._element.style.paddingLeft="",this._element.style.paddingRight=""}static jQueryInterface(t,e){return this.each(function(){const i=Ln.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===i[t])throw new TypeError(`No method named "${t}"`);i[t](e)}})}}P.on(document,En,'[data-bs-toggle="modal"]',function(t){const e=R.getElementFromSelector(this);["A","AREA"].includes(this.tagName)&&t.preventDefault(),P.one(e,_n,t=>{t.defaultPrevented||P.one(e,gn,()=>{l(this)&&this.focus()})});const i=R.findOne(".modal.show");i&&Ln.getInstance(i).hide(),Ln.getOrCreateInstance(e).toggle(this)}),q(Ln),g(Ln);const Sn=".bs.offcanvas",Dn=".data-api",$n=`load${Sn}${Dn}`,In="show",Nn="showing",Pn="hiding",jn=".offcanvas.show",Mn=`show${Sn}`,Fn=`shown${Sn}`,Hn=`hide${Sn}`,Wn=`hidePrevented${Sn}`,Bn=`hidden${Sn}`,zn=`resize${Sn}`,Rn=`click${Sn}${Dn}`,qn=`keydown.dismiss${Sn}`,Vn={backdrop:!0,keyboard:!0,scroll:!1},Kn={backdrop:"(boolean|string)",keyboard:"boolean",scroll:"boolean"};class Qn extends B{constructor(t,e){super(t,e),this._isShown=!1,this._backdrop=this._initializeBackDrop(),this._focustrap=this._initializeFocusTrap(),this._addEventListeners()}static get Default(){return Vn}static get DefaultType(){return Kn}static get NAME(){return"offcanvas"}toggle(t){return this._isShown?this.hide():this.show(t)}show(t){this._isShown||P.trigger(this._element,Mn,{relatedTarget:t}).defaultPrevented||(this._isShown=!0,this._backdrop.show(),this._config.scroll||(new un).hide(),this._element.setAttribute("aria-modal",!0),this._element.setAttribute("role","dialog"),this._element.classList.add(Nn),this._queueCallback(()=>{this._config.scroll&&!this._config.backdrop||this._focustrap.activate(),this._element.classList.add(In),this._element.classList.remove(Nn),P.trigger(this._element,Fn,{relatedTarget:t})},this._element,!0))}hide(){this._isShown&&(P.trigger(this._element,Hn).defaultPrevented||(this._focustrap.deactivate(),this._element.blur(),this._isShown=!1,this._element.classList.add(Pn),this._backdrop.hide(),this._queueCallback(()=>{this._element.classList.remove(In,Pn),this._element.removeAttribute("aria-modal"),this._element.removeAttribute("role"),this._config.scroll||(new un).reset(),P.trigger(this._element,Bn)},this._element,!0)))}dispose(){this._backdrop.dispose(),this._focustrap.deactivate(),super.dispose()}_initializeBackDrop(){const t=Boolean(this._config.backdrop);return new Zi({className:"offcanvas-backdrop",isVisible:t,isAnimated:!0,rootElement:this._element.parentNode,clickCallback:t?()=>{"static"!==this._config.backdrop?this.hide():P.trigger(this._element,Wn)}:null})}_initializeFocusTrap(){return new an({trapElement:this._element})}_addEventListeners(){P.on(this._element,qn,t=>{"Escape"===t.key&&(this._config.keyboard?this.hide():P.trigger(this._element,Wn))})}static jQueryInterface(t){return this.each(function(){const e=Qn.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t]||t.startsWith("_")||"constructor"===t)throw new TypeError(`No method named "${t}"`);e[t](this)}})}}P.on(document,Rn,'[data-bs-toggle="offcanvas"]',function(t){const e=R.getElementFromSelector(this);if(["A","AREA"].includes(this.tagName)&&t.preventDefault(),c(this))return;P.one(e,Bn,()=>{l(this)&&this.focus()});const i=R.findOne(jn);i&&i!==e&&Qn.getInstance(i).hide(),Qn.getOrCreateInstance(e).toggle(this)}),P.on(window,$n,()=>{for(const t of R.find(jn))Qn.getOrCreateInstance(t).show()}),P.on(window,zn,()=>{for(const t of R.find("[aria-modal][class*=show][class*=offcanvas-]"))"fixed"!==getComputedStyle(t).position&&Qn.getOrCreateInstance(t).hide()}),q(Qn),g(Qn);const Xn={"*":["class","dir","id","lang","role",/^aria-[\w-]*$/i],a:["target","href","title","rel"],area:[],b:[],br:[],col:[],code:[],dd:[],div:[],dl:[],dt:[],em:[],hr:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],i:[],img:["src","srcset","alt","title","width","height"],li:[],ol:[],p:[],pre:[],s:[],small:[],span:[],sub:[],sup:[],strong:[],u:[],ul:[]},Yn=new Set(["background","cite","href","itemtype","longdesc","poster","src","xlink:href"]),Un=/^(?!javascript:)(?:[a-z0-9+.-]+:|[^&:/?#]*(?:[/?#]|$))/i,Gn=(t,e)=>{const i=t.nodeName.toLowerCase();return e.includes(i)?!Yn.has(i)||Boolean(Un.test(t.nodeValue)):e.filter(t=>t instanceof RegExp).some(t=>t.test(i))},Jn={allowList:Xn,content:{},extraClass:"",html:!1,sanitize:!0,sanitizeFn:null,template:"
"},Zn={allowList:"object",content:"object",extraClass:"(string|function)",html:"boolean",sanitize:"boolean",sanitizeFn:"(null|function)",template:"string"},ts={entry:"(string|element|function|null)",selector:"(string|element)"};class es extends W{constructor(t){super(),this._config=this._getConfig(t)}static get Default(){return Jn}static get DefaultType(){return Zn}static get NAME(){return"TemplateFactory"}getContent(){return Object.values(this._config.content).map(t=>this._resolvePossibleFunction(t)).filter(Boolean)}hasContent(){return this.getContent().length>0}changeContent(t){return this._checkContent(t),this._config.content={...this._config.content,...t},this}toHtml(){const t=document.createElement("div");t.innerHTML=this._maybeSanitize(this._config.template);for(const[e,i]of Object.entries(this._config.content))this._setContent(t,i,e);const e=t.children[0],i=this._resolvePossibleFunction(this._config.extraClass);return i&&e.classList.add(...i.split(" ")),e}_typeCheckConfig(t){super._typeCheckConfig(t),this._checkContent(t.content)}_checkContent(t){for(const[e,i]of Object.entries(t))super._typeCheckConfig({selector:e,entry:i},ts)}_setContent(t,e,i){const n=R.findOne(i,t);n&&((e=this._resolvePossibleFunction(e))?r(e)?this._putElementInTemplate(a(e),n):this._config.html?n.innerHTML=this._maybeSanitize(e):n.textContent=e:n.remove())}_maybeSanitize(t){return this._config.sanitize?function(t,e,i){if(!t.length)return t;if(i&&"function"==typeof i)return i(t);const n=(new window.DOMParser).parseFromString(t,"text/html"),s=[].concat(...n.body.querySelectorAll("*"));for(const t of s){const i=t.nodeName.toLowerCase();if(!Object.keys(e).includes(i)){t.remove();continue}const n=[].concat(...t.attributes),s=[].concat(e["*"]||[],e[i]||[]);for(const e of n)Gn(e,s)||t.removeAttribute(e.nodeName)}return n.body.innerHTML}(t,this._config.allowList,this._config.sanitizeFn):t}_resolvePossibleFunction(t){return _(t,[void 0,this])}_putElementInTemplate(t,e){if(this._config.html)return e.innerHTML="",void e.append(t);e.textContent=t.textContent}}const is=new Set(["sanitize","allowList","sanitizeFn"]),ns="fade",ss="show",os=".tooltip-inner",rs=".modal",as="hide.bs.modal",ls="hover",cs="focus",hs="click",ds={AUTO:"auto",TOP:"top",RIGHT:m()?"left":"right",BOTTOM:"bottom",LEFT:m()?"right":"left"},us={allowList:Xn,animation:!0,boundary:"clippingParents",container:!1,customClass:"",delay:0,fallbackPlacements:["top","right","bottom","left"],html:!1,offset:[0,6],placement:"top",popperConfig:null,sanitize:!0,sanitizeFn:null,selector:!1,template:'',title:"",trigger:"hover focus"},fs={allowList:"object",animation:"boolean",boundary:"(string|element)",container:"(string|element|boolean)",customClass:"(string|function)",delay:"(number|object)",fallbackPlacements:"array",html:"boolean",offset:"(array|string|function)",placement:"(string|function)",popperConfig:"(null|object|function)",sanitize:"boolean",sanitizeFn:"(null|function)",selector:"(string|boolean)",template:"string",title:"(string|element|function)",trigger:"string"};class ps extends B{constructor(t,e){if(void 0===Ai)throw new TypeError("Bootstrap's tooltips require Popper (https://popper.js.org/docs/v2/)");super(t,e),this._isEnabled=!0,this._timeout=0,this._isHovered=null,this._activeTrigger={},this._popper=null,this._templateFactory=null,this._newContent=null,this.tip=null,this._setListeners(),this._config.selector||this._fixTitle()}static get Default(){return us}static get DefaultType(){return fs}static get NAME(){return"tooltip"}enable(){this._isEnabled=!0}disable(){this._isEnabled=!1}toggleEnabled(){this._isEnabled=!this._isEnabled}toggle(){this._isEnabled&&(this._isShown()?this._leave():this._enter())}dispose(){clearTimeout(this._timeout),P.off(this._element.closest(rs),as,this._hideModalHandler),this._element.getAttribute("data-bs-original-title")&&this._element.setAttribute("title",this._element.getAttribute("data-bs-original-title")),this._disposePopper(),super.dispose()}show(){if("none"===this._element.style.display)throw new Error("Please use show on visible elements");if(!this._isWithContent()||!this._isEnabled)return;const t=P.trigger(this._element,this.constructor.eventName("show")),e=(h(this._element)||this._element.ownerDocument.documentElement).contains(this._element);if(t.defaultPrevented||!e)return;this._disposePopper();const i=this._getTipElement();this._element.setAttribute("aria-describedby",i.getAttribute("id"));const{container:n}=this._config;if(this._element.ownerDocument.documentElement.contains(this.tip)||(n.append(i),P.trigger(this._element,this.constructor.eventName("inserted"))),this._popper=this._createPopper(i),i.classList.add(ss),"ontouchstart"in document.documentElement)for(const t of[].concat(...document.body.children))P.on(t,"mouseover",d);this._queueCallback(()=>{P.trigger(this._element,this.constructor.eventName("shown")),!1===this._isHovered&&this._leave(),this._isHovered=!1},this.tip,this._isAnimated())}hide(){if(this._isShown()&&!P.trigger(this._element,this.constructor.eventName("hide")).defaultPrevented){if(this._getTipElement().classList.remove(ss),"ontouchstart"in document.documentElement)for(const t of[].concat(...document.body.children))P.off(t,"mouseover",d);this._activeTrigger[hs]=!1,this._activeTrigger[cs]=!1,this._activeTrigger[ls]=!1,this._isHovered=null,this._queueCallback(()=>{this._isWithActiveTrigger()||(this._isHovered||this._disposePopper(),this._element.removeAttribute("aria-describedby"),P.trigger(this._element,this.constructor.eventName("hidden")))},this.tip,this._isAnimated())}}update(){this._popper&&this._popper.update()}_isWithContent(){return Boolean(this._getTitle())}_getTipElement(){return this.tip||(this.tip=this._createTipElement(this._newContent||this._getContentForTemplate())),this.tip}_createTipElement(t){const e=this._getTemplateFactory(t).toHtml();if(!e)return null;e.classList.remove(ns,ss),e.classList.add(`bs-${this.constructor.NAME}-auto`);const i=(t=>{do{t+=Math.floor(1e6*Math.random())}while(document.getElementById(t));return t})(this.constructor.NAME).toString();return e.setAttribute("id",i),this._isAnimated()&&e.classList.add(ns),e}setContent(t){this._newContent=t,this._isShown()&&(this._disposePopper(),this.show())}_getTemplateFactory(t){return this._templateFactory?this._templateFactory.changeContent(t):this._templateFactory=new es({...this._config,content:t,extraClass:this._resolvePossibleFunction(this._config.customClass)}),this._templateFactory}_getContentForTemplate(){return{[os]:this._getTitle()}}_getTitle(){return this._resolvePossibleFunction(this._config.title)||this._element.getAttribute("data-bs-original-title")}_initializeOnDelegatedTarget(t){return this.constructor.getOrCreateInstance(t.delegateTarget,this._getDelegateConfig())}_isAnimated(){return this._config.animation||this.tip&&this.tip.classList.contains(ns)}_isShown(){return this.tip&&this.tip.classList.contains(ss)}_createPopper(t){const e=_(this._config.placement,[this,t,this._element]),i=ds[e.toUpperCase()];return wi(this._element,t,this._getPopperConfig(i))}_getOffset(){const{offset:t}=this._config;return"string"==typeof t?t.split(",").map(t=>Number.parseInt(t,10)):"function"==typeof t?e=>t(e,this._element):t}_resolvePossibleFunction(t){return _(t,[this._element,this._element])}_getPopperConfig(t){const e={placement:t,modifiers:[{name:"flip",options:{fallbackPlacements:this._config.fallbackPlacements}},{name:"offset",options:{offset:this._getOffset()}},{name:"preventOverflow",options:{boundary:this._config.boundary}},{name:"arrow",options:{element:`.${this.constructor.NAME}-arrow`}},{name:"preSetPlacement",enabled:!0,phase:"beforeMain",fn:t=>{this._getTipElement().setAttribute("data-popper-placement",t.state.placement)}}]};return{...e,..._(this._config.popperConfig,[void 0,e])}}_setListeners(){const t=this._config.trigger.split(" ");for(const e of t)if("click"===e)P.on(this._element,this.constructor.eventName("click"),this._config.selector,t=>{const e=this._initializeOnDelegatedTarget(t);e._activeTrigger[hs]=!(e._isShown()&&e._activeTrigger[hs]),e.toggle()});else if("manual"!==e){const t=e===ls?this.constructor.eventName("mouseenter"):this.constructor.eventName("focusin"),i=e===ls?this.constructor.eventName("mouseleave"):this.constructor.eventName("focusout");P.on(this._element,t,this._config.selector,t=>{const e=this._initializeOnDelegatedTarget(t);e._activeTrigger["focusin"===t.type?cs:ls]=!0,e._enter()}),P.on(this._element,i,this._config.selector,t=>{const e=this._initializeOnDelegatedTarget(t);e._activeTrigger["focusout"===t.type?cs:ls]=e._element.contains(t.relatedTarget),e._leave()})}this._hideModalHandler=()=>{this._element&&this.hide()},P.on(this._element.closest(rs),as,this._hideModalHandler)}_fixTitle(){const t=this._element.getAttribute("title");t&&(this._element.getAttribute("aria-label")||this._element.textContent.trim()||this._element.setAttribute("aria-label",t),this._element.setAttribute("data-bs-original-title",t),this._element.removeAttribute("title"))}_enter(){this._isShown()||this._isHovered?this._isHovered=!0:(this._isHovered=!0,this._setTimeout(()=>{this._isHovered&&this.show()},this._config.delay.show))}_leave(){this._isWithActiveTrigger()||(this._isHovered=!1,this._setTimeout(()=>{this._isHovered||this.hide()},this._config.delay.hide))}_setTimeout(t,e){clearTimeout(this._timeout),this._timeout=setTimeout(t,e)}_isWithActiveTrigger(){return Object.values(this._activeTrigger).includes(!0)}_getConfig(t){const e=H.getDataAttributes(this._element);for(const t of Object.keys(e))is.has(t)&&delete e[t];return t={...e,..."object"==typeof t&&t?t:{}},t=this._mergeConfigObj(t),t=this._configAfterMerge(t),this._typeCheckConfig(t),t}_configAfterMerge(t){return t.container=!1===t.container?document.body:a(t.container),"number"==typeof t.delay&&(t.delay={show:t.delay,hide:t.delay}),"number"==typeof t.title&&(t.title=t.title.toString()),"number"==typeof t.content&&(t.content=t.content.toString()),t}_getDelegateConfig(){const t={};for(const[e,i]of Object.entries(this._config))this.constructor.Default[e]!==i&&(t[e]=i);return t.selector=!1,t.trigger="manual",t}_disposePopper(){this._popper&&(this._popper.destroy(),this._popper=null),this.tip&&(this.tip.remove(),this.tip=null)}static jQueryInterface(t){return this.each(function(){const e=ps.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t])throw new TypeError(`No method named "${t}"`);e[t]()}})}}g(ps);const ms=".popover-header",gs=".popover-body",_s={...ps.Default,content:"",offset:[0,8],placement:"right",template:'',trigger:"click"},bs={...ps.DefaultType,content:"(null|string|element|function)"};class vs extends ps{static get Default(){return _s}static get DefaultType(){return bs}static get NAME(){return"popover"}_isWithContent(){return this._getTitle()||this._getContent()}_getContentForTemplate(){return{[ms]:this._getTitle(),[gs]:this._getContent()}}_getContent(){return this._resolvePossibleFunction(this._config.content)}static jQueryInterface(t){return this.each(function(){const e=vs.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t])throw new TypeError(`No method named "${t}"`);e[t]()}})}}g(vs);const ys=".bs.scrollspy",ws=`activate${ys}`,As=`click${ys}`,Es=`load${ys}.data-api`,Ts="active",Cs="[href]",Os=".nav-link",xs=`${Os}, .nav-item > ${Os}, .list-group-item`,ks={offset:null,rootMargin:"0px 0px -25%",smoothScroll:!1,target:null,threshold:[.1,.5,1]},Ls={offset:"(number|null)",rootMargin:"string",smoothScroll:"boolean",target:"element",threshold:"array"};class Ss extends B{constructor(t,e){super(t,e),this._targetLinks=new Map,this._observableSections=new Map,this._rootElement="visible"===getComputedStyle(this._element).overflowY?null:this._element,this._activeTarget=null,this._observer=null,this._previousScrollData={visibleEntryTop:0,parentScrollTop:0},this.refresh()}static get Default(){return ks}static get DefaultType(){return Ls}static get NAME(){return"scrollspy"}refresh(){this._initializeTargetsAndObservables(),this._maybeEnableSmoothScroll(),this._observer?this._observer.disconnect():this._observer=this._getNewObserver();for(const t of this._observableSections.values())this._observer.observe(t)}dispose(){this._observer.disconnect(),super.dispose()}_configAfterMerge(t){return t.target=a(t.target)||document.body,t.rootMargin=t.offset?`${t.offset}px 0px -30%`:t.rootMargin,"string"==typeof t.threshold&&(t.threshold=t.threshold.split(",").map(t=>Number.parseFloat(t))),t}_maybeEnableSmoothScroll(){this._config.smoothScroll&&(P.off(this._config.target,As),P.on(this._config.target,As,Cs,t=>{const e=this._observableSections.get(t.target.hash);if(e){t.preventDefault();const i=this._rootElement||window,n=e.offsetTop-this._element.offsetTop;if(i.scrollTo)return void i.scrollTo({top:n,behavior:"smooth"});i.scrollTop=n}}))}_getNewObserver(){const t={root:this._rootElement,threshold:this._config.threshold,rootMargin:this._config.rootMargin};return new IntersectionObserver(t=>this._observerCallback(t),t)}_observerCallback(t){const e=t=>this._targetLinks.get(`#${t.target.id}`),i=t=>{this._previousScrollData.visibleEntryTop=t.target.offsetTop,this._process(e(t))},n=(this._rootElement||document.documentElement).scrollTop,s=n>=this._previousScrollData.parentScrollTop;this._previousScrollData.parentScrollTop=n;for(const o of t){if(!o.isIntersecting){this._activeTarget=null,this._clearActiveClass(e(o));continue}const t=o.target.offsetTop>=this._previousScrollData.visibleEntryTop;if(s&&t){if(i(o),!n)return}else s||t||i(o)}}_initializeTargetsAndObservables(){this._targetLinks=new Map,this._observableSections=new Map;const t=R.find(Cs,this._config.target);for(const e of t){if(!e.hash||c(e))continue;const t=R.findOne(decodeURI(e.hash),this._element);l(t)&&(this._targetLinks.set(decodeURI(e.hash),e),this._observableSections.set(e.hash,t))}}_process(t){this._activeTarget!==t&&(this._clearActiveClass(this._config.target),this._activeTarget=t,t.classList.add(Ts),this._activateParents(t),P.trigger(this._element,ws,{relatedTarget:t}))}_activateParents(t){if(t.classList.contains("dropdown-item"))R.findOne(".dropdown-toggle",t.closest(".dropdown")).classList.add(Ts);else for(const e of R.parents(t,".nav, .list-group"))for(const t of R.prev(e,xs))t.classList.add(Ts)}_clearActiveClass(t){t.classList.remove(Ts);const e=R.find(`${Cs}.${Ts}`,t);for(const t of e)t.classList.remove(Ts)}static jQueryInterface(t){return this.each(function(){const e=Ss.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t]||t.startsWith("_")||"constructor"===t)throw new TypeError(`No method named "${t}"`);e[t]()}})}}P.on(window,Es,()=>{for(const t of R.find('[data-bs-spy="scroll"]'))Ss.getOrCreateInstance(t)}),g(Ss);const Ds=".bs.tab",$s=`hide${Ds}`,Is=`hidden${Ds}`,Ns=`show${Ds}`,Ps=`shown${Ds}`,js=`click${Ds}`,Ms=`keydown${Ds}`,Fs=`load${Ds}`,Hs="ArrowLeft",Ws="ArrowRight",Bs="ArrowUp",zs="ArrowDown",Rs="Home",qs="End",Vs="active",Ks="fade",Qs="show",Xs=".dropdown-toggle",Ys=`:not(${Xs})`,Us='[data-bs-toggle="tab"], [data-bs-toggle="pill"], [data-bs-toggle="list"]',Gs=`.nav-link${Ys}, .list-group-item${Ys}, [role="tab"]${Ys}, ${Us}`,Js=`.${Vs}[data-bs-toggle="tab"], .${Vs}[data-bs-toggle="pill"], .${Vs}[data-bs-toggle="list"]`;class Zs extends B{constructor(t){super(t),this._parent=this._element.closest('.list-group, .nav, [role="tablist"]'),this._parent&&(this._setInitialAttributes(this._parent,this._getChildren()),P.on(this._element,Ms,t=>this._keydown(t)))}static get NAME(){return"tab"}show(){const t=this._element;if(this._elemIsActive(t))return;const e=this._getActiveElem(),i=e?P.trigger(e,$s,{relatedTarget:t}):null;P.trigger(t,Ns,{relatedTarget:e}).defaultPrevented||i&&i.defaultPrevented||(this._deactivate(e,t),this._activate(t,e))}_activate(t,e){t&&(t.classList.add(Vs),this._activate(R.getElementFromSelector(t)),this._queueCallback(()=>{"tab"===t.getAttribute("role")?(t.removeAttribute("tabindex"),t.setAttribute("aria-selected",!0),this._toggleDropDown(t,!0),P.trigger(t,Ps,{relatedTarget:e})):t.classList.add(Qs)},t,t.classList.contains(Ks)))}_deactivate(t,e){t&&(t.classList.remove(Vs),t.blur(),this._deactivate(R.getElementFromSelector(t)),this._queueCallback(()=>{"tab"===t.getAttribute("role")?(t.setAttribute("aria-selected",!1),t.setAttribute("tabindex","-1"),this._toggleDropDown(t,!1),P.trigger(t,Is,{relatedTarget:e})):t.classList.remove(Qs)},t,t.classList.contains(Ks)))}_keydown(t){if(![Hs,Ws,Bs,zs,Rs,qs].includes(t.key))return;t.stopPropagation(),t.preventDefault();const e=this._getChildren().filter(t=>!c(t));let i;if([Rs,qs].includes(t.key))i=e[t.key===Rs?0:e.length-1];else{const n=[Ws,zs].includes(t.key);i=v(e,t.target,n,!0)}i&&(i.focus({preventScroll:!0}),Zs.getOrCreateInstance(i).show())}_getChildren(){return R.find(Gs,this._parent)}_getActiveElem(){return this._getChildren().find(t=>this._elemIsActive(t))||null}_setInitialAttributes(t,e){this._setAttributeIfNotExists(t,"role","tablist");for(const t of e)this._setInitialAttributesOnChild(t)}_setInitialAttributesOnChild(t){t=this._getInnerElement(t);const e=this._elemIsActive(t),i=this._getOuterElement(t);t.setAttribute("aria-selected",e),i!==t&&this._setAttributeIfNotExists(i,"role","presentation"),e||t.setAttribute("tabindex","-1"),this._setAttributeIfNotExists(t,"role","tab"),this._setInitialAttributesOnTargetPanel(t)}_setInitialAttributesOnTargetPanel(t){const e=R.getElementFromSelector(t);e&&(this._setAttributeIfNotExists(e,"role","tabpanel"),t.id&&this._setAttributeIfNotExists(e,"aria-labelledby",`${t.id}`))}_toggleDropDown(t,e){const i=this._getOuterElement(t);if(!i.classList.contains("dropdown"))return;const n=(t,n)=>{const s=R.findOne(t,i);s&&s.classList.toggle(n,e)};n(Xs,Vs),n(".dropdown-menu",Qs),i.setAttribute("aria-expanded",e)}_setAttributeIfNotExists(t,e,i){t.hasAttribute(e)||t.setAttribute(e,i)}_elemIsActive(t){return t.classList.contains(Vs)}_getInnerElement(t){return t.matches(Gs)?t:R.findOne(Gs,t)}_getOuterElement(t){return t.closest(".nav-item, .list-group-item")||t}static jQueryInterface(t){return this.each(function(){const e=Zs.getOrCreateInstance(this);if("string"==typeof t){if(void 0===e[t]||t.startsWith("_")||"constructor"===t)throw new TypeError(`No method named "${t}"`);e[t]()}})}}P.on(document,js,Us,function(t){["A","AREA"].includes(this.tagName)&&t.preventDefault(),c(this)||Zs.getOrCreateInstance(this).show()}),P.on(window,Fs,()=>{for(const t of R.find(Js))Zs.getOrCreateInstance(t)}),g(Zs);const to=".bs.toast",eo=`mouseover${to}`,io=`mouseout${to}`,no=`focusin${to}`,so=`focusout${to}`,oo=`hide${to}`,ro=`hidden${to}`,ao=`show${to}`,lo=`shown${to}`,co="hide",ho="show",uo="showing",fo={animation:"boolean",autohide:"boolean",delay:"number"},po={animation:!0,autohide:!0,delay:5e3};class mo extends B{constructor(t,e){super(t,e),this._timeout=null,this._hasMouseInteraction=!1,this._hasKeyboardInteraction=!1,this._setListeners()}static get Default(){return po}static get DefaultType(){return fo}static get NAME(){return"toast"}show(){P.trigger(this._element,ao).defaultPrevented||(this._clearTimeout(),this._config.animation&&this._element.classList.add("fade"),this._element.classList.remove(co),u(this._element),this._element.classList.add(ho,uo),this._queueCallback(()=>{this._element.classList.remove(uo),P.trigger(this._element,lo),this._maybeScheduleHide()},this._element,this._config.animation))}hide(){this.isShown()&&(P.trigger(this._element,oo).defaultPrevented||(this._element.classList.add(uo),this._queueCallback(()=>{this._element.classList.add(co),this._element.classList.remove(uo,ho),P.trigger(this._element,ro)},this._element,this._config.animation)))}dispose(){this._clearTimeout(),this.isShown()&&this._element.classList.remove(ho),super.dispose()}isShown(){return this._element.classList.contains(ho)}_maybeScheduleHide(){this._config.autohide&&(this._hasMouseInteraction||this._hasKeyboardInteraction||(this._timeout=setTimeout(()=>{this.hide()},this._config.delay)))}_onInteraction(t,e){switch(t.type){case"mouseover":case"mouseout":this._hasMouseInteraction=e;break;case"focusin":case"focusout":this._hasKeyboardInteraction=e}if(e)return void this._clearTimeout();const i=t.relatedTarget;this._element===i||this._element.contains(i)||this._maybeScheduleHide()}_setListeners(){P.on(this._element,eo,t=>this._onInteraction(t,!0)),P.on(this._element,io,t=>this._onInteraction(t,!1)),P.on(this._element,no,t=>this._onInteraction(t,!0)),P.on(this._element,so,t=>this._onInteraction(t,!1))}_clearTimeout(){clearTimeout(this._timeout),this._timeout=null}static jQueryInterface(t){return this.each(function(){const e=mo.getOrCreateInstance(this,t);if("string"==typeof t){if(void 0===e[t])throw new TypeError(`No method named "${t}"`);e[t](this)}})}}return q(mo),g(mo),{Alert:X,Button:U,Carousel:St,Collapse:qt,Dropdown:Qi,Modal:Ln,Offcanvas:Qn,Popover:vs,ScrollSpy:Ss,Tab:Zs,Toast:mo,Tooltip:ps}}); +//# sourceMappingURL=bootstrap.bundle.min.js.map \ No newline at end of file diff --git a/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js.map b/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js.map new file mode 100644 index 00000000..3e678d4c --- /dev/null +++ b/docs/deps/bootstrap-5.3.8/bootstrap.bundle.min.js.map @@ -0,0 +1 @@ +{"version":3,"names":["elementMap","Map","Data","set","element","key","instance","has","instanceMap","get","size","console","error","Array","from","keys","remove","delete","TRANSITION_END","parseSelector","selector","window","CSS","escape","replace","match","id","toType","object","Object","prototype","toString","call","toLowerCase","triggerTransitionEnd","dispatchEvent","Event","isElement","jquery","nodeType","getElement","length","document","querySelector","isVisible","getClientRects","elementIsVisible","getComputedStyle","getPropertyValue","closedDetails","closest","summary","parentNode","isDisabled","Node","ELEMENT_NODE","classList","contains","disabled","hasAttribute","getAttribute","findShadowRoot","documentElement","attachShadow","getRootNode","root","ShadowRoot","noop","reflow","offsetHeight","getjQuery","jQuery","body","DOMContentLoadedCallbacks","isRTL","dir","defineJQueryPlugin","plugin","callback","$","name","NAME","JQUERY_NO_CONFLICT","fn","jQueryInterface","Constructor","noConflict","readyState","addEventListener","push","execute","possibleCallback","args","defaultValue","executeAfterTransition","transitionElement","waitForTransition","emulatedDuration","transitionDuration","transitionDelay","floatTransitionDuration","Number","parseFloat","floatTransitionDelay","split","getTransitionDurationFromElement","called","handler","target","removeEventListener","setTimeout","getNextActiveElement","list","activeElement","shouldGetNext","isCycleAllowed","listLength","index","indexOf","Math","max","min","namespaceRegex","stripNameRegex","stripUidRegex","eventRegistry","uidEvent","customEvents","mouseenter","mouseleave","nativeEvents","Set","makeEventUid","uid","getElementEvents","findHandler","events","callable","delegationSelector","values","find","event","normalizeParameters","originalTypeEvent","delegationFunction","isDelegated","typeEvent","getTypeEvent","addHandler","oneOff","wrapFunction","relatedTarget","delegateTarget","this","handlers","previousFunction","domElements","querySelectorAll","domElement","hydrateObj","EventHandler","off","type","apply","bootstrapDelegationHandler","bootstrapHandler","removeHandler","Boolean","removeNamespacedHandlers","namespace","storeElementEvent","handlerKey","entries","includes","on","one","inNamespace","isNamespace","startsWith","elementEvent","slice","keyHandlers","trigger","jQueryEvent","bubbles","nativeDispatch","defaultPrevented","isPropagationStopped","isImmediatePropagationStopped","isDefaultPrevented","evt","cancelable","preventDefault","obj","meta","value","_unused","defineProperty","configurable","normalizeData","JSON","parse","decodeURIComponent","normalizeDataKey","chr","Manipulator","setDataAttribute","setAttribute","removeDataAttribute","removeAttribute","getDataAttributes","attributes","bsKeys","dataset","filter","pureKey","charAt","getDataAttribute","Config","Default","DefaultType","Error","_getConfig","config","_mergeConfigObj","_configAfterMerge","_typeCheckConfig","jsonConfig","constructor","configTypes","property","expectedTypes","valueType","RegExp","test","TypeError","toUpperCase","BaseComponent","super","_element","_config","DATA_KEY","dispose","EVENT_KEY","propertyName","getOwnPropertyNames","_queueCallback","isAnimated","getInstance","getOrCreateInstance","VERSION","eventName","getSelector","hrefAttribute","trim","map","sel","join","SelectorEngine","concat","Element","findOne","children","child","matches","parents","ancestor","prev","previous","previousElementSibling","next","nextElementSibling","focusableChildren","focusables","el","getSelectorFromElement","getElementFromSelector","getMultipleElementsFromSelector","enableDismissTrigger","component","method","clickEvent","tagName","EVENT_CLOSE","EVENT_CLOSED","Alert","close","_destroyElement","each","data","undefined","SELECTOR_DATA_TOGGLE","Button","toggle","button","EVENT_TOUCHSTART","EVENT_TOUCHMOVE","EVENT_TOUCHEND","EVENT_POINTERDOWN","EVENT_POINTERUP","endCallback","leftCallback","rightCallback","Swipe","isSupported","_deltaX","_supportPointerEvents","PointerEvent","_initEvents","_start","_eventIsPointerPenTouch","clientX","touches","_end","_handleSwipe","_move","absDeltaX","abs","direction","add","pointerType","navigator","maxTouchPoints","DATA_API_KEY","ARROW_LEFT_KEY","ARROW_RIGHT_KEY","ORDER_NEXT","ORDER_PREV","DIRECTION_LEFT","DIRECTION_RIGHT","EVENT_SLIDE","EVENT_SLID","EVENT_KEYDOWN","EVENT_MOUSEENTER","EVENT_MOUSELEAVE","EVENT_DRAG_START","EVENT_LOAD_DATA_API","EVENT_CLICK_DATA_API","CLASS_NAME_CAROUSEL","CLASS_NAME_ACTIVE","SELECTOR_ACTIVE","SELECTOR_ITEM","SELECTOR_ACTIVE_ITEM","KEY_TO_DIRECTION","ARROW_LEFT_KEY$1","ARROW_RIGHT_KEY$1","interval","keyboard","pause","ride","touch","wrap","Carousel","_interval","_activeElement","_isSliding","touchTimeout","_swipeHelper","_indicatorsElement","_addEventListeners","cycle","_slide","nextWhenVisible","hidden","_clearInterval","_updateInterval","setInterval","_maybeEnableCycle","to","items","_getItems","activeIndex","_getItemIndex","_getActive","order","defaultInterval","_keydown","_addTouchEventListeners","img","swipeConfig","_directionToOrder","endCallBack","clearTimeout","_setActiveIndicatorElement","activeIndicator","newActiveIndicator","elementInterval","parseInt","isNext","nextElement","nextElementIndex","triggerEvent","_orderToDirection","isCycling","directionalClassName","orderClassName","completeCallBack","_isAnimated","clearInterval","carousel","slideIndex","carousels","EVENT_SHOW","EVENT_SHOWN","EVENT_HIDE","EVENT_HIDDEN","CLASS_NAME_SHOW","CLASS_NAME_COLLAPSE","CLASS_NAME_COLLAPSING","CLASS_NAME_DEEPER_CHILDREN","parent","Collapse","_isTransitioning","_triggerArray","toggleList","elem","filterElement","foundElement","_initializeChildren","_addAriaAndCollapsedClass","_isShown","hide","show","activeChildren","_getFirstLevelChildren","activeInstance","dimension","_getDimension","style","scrollSize","complete","getBoundingClientRect","selected","triggerArray","isOpen","top","bottom","right","left","auto","basePlacements","start","end","clippingParents","viewport","popper","reference","variationPlacements","reduce","acc","placement","placements","beforeRead","read","afterRead","beforeMain","main","afterMain","beforeWrite","write","afterWrite","modifierPhases","getNodeName","nodeName","getWindow","node","ownerDocument","defaultView","isHTMLElement","HTMLElement","isShadowRoot","applyStyles$1","enabled","phase","_ref","state","elements","forEach","styles","assign","effect","_ref2","initialStyles","position","options","strategy","margin","arrow","hasOwnProperty","attribute","requires","getBasePlacement","round","getUAString","uaData","userAgentData","brands","isArray","item","brand","version","userAgent","isLayoutViewport","includeScale","isFixedStrategy","clientRect","scaleX","scaleY","offsetWidth","width","height","visualViewport","addVisualOffsets","x","offsetLeft","y","offsetTop","getLayoutRect","rootNode","isSameNode","host","isTableElement","getDocumentElement","getParentNode","assignedSlot","getTrueOffsetParent","offsetParent","getOffsetParent","isFirefox","currentNode","css","transform","perspective","contain","willChange","getContainingBlock","getMainAxisFromPlacement","within","mathMax","mathMin","mergePaddingObject","paddingObject","expandToHashMap","hashMap","arrow$1","_state$modifiersData$","arrowElement","popperOffsets","modifiersData","basePlacement","axis","len","padding","rects","toPaddingObject","arrowRect","minProp","maxProp","endDiff","startDiff","arrowOffsetParent","clientSize","clientHeight","clientWidth","centerToReference","center","offset","axisProp","centerOffset","_options$element","requiresIfExists","getVariation","unsetSides","mapToStyles","_Object$assign2","popperRect","variation","offsets","gpuAcceleration","adaptive","roundOffsets","isFixed","_offsets$x","_offsets$y","_ref3","hasX","hasY","sideX","sideY","win","heightProp","widthProp","_Object$assign","commonStyles","_ref4","dpr","devicePixelRatio","roundOffsetsByDPR","computeStyles$1","_ref5","_options$gpuAccelerat","_options$adaptive","_options$roundOffsets","passive","eventListeners","_options$scroll","scroll","_options$resize","resize","scrollParents","scrollParent","update","hash","getOppositePlacement","matched","getOppositeVariationPlacement","getWindowScroll","scrollLeft","pageXOffset","scrollTop","pageYOffset","getWindowScrollBarX","isScrollParent","_getComputedStyle","overflow","overflowX","overflowY","getScrollParent","listScrollParents","_element$ownerDocumen","isBody","updatedList","rectToClientRect","rect","getClientRectFromMixedType","clippingParent","html","layoutViewport","getViewportRect","clientTop","clientLeft","getInnerBoundingClientRect","winScroll","scrollWidth","scrollHeight","getDocumentRect","computeOffsets","commonX","commonY","mainAxis","detectOverflow","_options","_options$placement","_options$strategy","_options$boundary","boundary","_options$rootBoundary","rootBoundary","_options$elementConte","elementContext","_options$altBoundary","altBoundary","_options$padding","altContext","clippingClientRect","mainClippingParents","clipperElement","getClippingParents","firstClippingParent","clippingRect","accRect","getClippingRect","contextElement","referenceClientRect","popperClientRect","elementClientRect","overflowOffsets","offsetData","multiply","computeAutoPlacement","flipVariations","_options$allowedAutoP","allowedAutoPlacements","allPlacements","allowedPlacements","overflows","sort","a","b","flip$1","_skip","_options$mainAxis","checkMainAxis","_options$altAxis","altAxis","checkAltAxis","specifiedFallbackPlacements","fallbackPlacements","_options$flipVariatio","preferredPlacement","oppositePlacement","getExpandedFallbackPlacements","referenceRect","checksMap","makeFallbackChecks","firstFittingPlacement","i","_basePlacement","isStartVariation","isVertical","mainVariationSide","altVariationSide","checks","every","check","_loop","_i","fittingPlacement","reset","getSideOffsets","preventedOffsets","isAnySideFullyClipped","some","side","hide$1","preventOverflow","referenceOverflow","popperAltOverflow","referenceClippingOffsets","popperEscapeOffsets","isReferenceHidden","hasPopperEscaped","offset$1","_options$offset","invertDistance","skidding","distance","distanceAndSkiddingToXY","_data$state$placement","popperOffsets$1","preventOverflow$1","_options$tether","tether","_options$tetherOffset","tetherOffset","isBasePlacement","tetherOffsetValue","normalizedTetherOffsetValue","offsetModifierState","_offsetModifierState$","mainSide","altSide","additive","minLen","maxLen","arrowPaddingObject","arrowPaddingMin","arrowPaddingMax","arrowLen","minOffset","maxOffset","clientOffset","offsetModifierValue","tetherMax","preventedOffset","_offsetModifierState$2","_mainSide","_altSide","_offset","_len","_min","_max","isOriginSide","_offsetModifierValue","_tetherMin","_tetherMax","_preventedOffset","v","withinMaxClamp","getCompositeRect","elementOrVirtualElement","isOffsetParentAnElement","offsetParentIsScaled","isElementScaled","modifiers","visited","result","modifier","dep","depModifier","DEFAULT_OPTIONS","areValidElements","arguments","_key","popperGenerator","generatorOptions","_generatorOptions","_generatorOptions$def","defaultModifiers","_generatorOptions$def2","defaultOptions","pending","orderedModifiers","effectCleanupFns","isDestroyed","setOptions","setOptionsAction","cleanupModifierEffects","merged","orderModifiers","current","existing","m","_ref$options","cleanupFn","forceUpdate","_state$elements","_state$orderedModifie","_state$orderedModifie2","Promise","resolve","then","destroy","onFirstUpdate","createPopper","computeStyles","applyStyles","flip","ARROW_UP_KEY","ARROW_DOWN_KEY","EVENT_KEYDOWN_DATA_API","EVENT_KEYUP_DATA_API","SELECTOR_DATA_TOGGLE_SHOWN","SELECTOR_MENU","PLACEMENT_TOP","PLACEMENT_TOPEND","PLACEMENT_BOTTOM","PLACEMENT_BOTTOMEND","PLACEMENT_RIGHT","PLACEMENT_LEFT","autoClose","display","popperConfig","Dropdown","_popper","_parent","_menu","_inNavbar","_detectNavbar","_createPopper","focus","_completeHide","Popper","referenceElement","_getPopperConfig","_getPlacement","parentDropdown","isEnd","_getOffset","popperData","defaultBsPopperConfig","_selectMenuItem","clearMenus","openToggles","context","composedPath","isMenuTarget","dataApiKeydownHandler","isInput","isEscapeEvent","isUpOrDownEvent","getToggleButton","stopPropagation","EVENT_MOUSEDOWN","className","clickCallback","rootElement","Backdrop","_isAppended","_append","_getElement","_emulateAnimation","backdrop","createElement","append","EVENT_FOCUSIN","EVENT_KEYDOWN_TAB","TAB_NAV_BACKWARD","autofocus","trapElement","FocusTrap","_isActive","_lastTabNavDirection","activate","_handleFocusin","_handleKeydown","deactivate","shiftKey","SELECTOR_FIXED_CONTENT","SELECTOR_STICKY_CONTENT","PROPERTY_PADDING","PROPERTY_MARGIN","ScrollBarHelper","getWidth","documentWidth","innerWidth","_disableOverFlow","_setElementAttributes","calculatedValue","_resetElementAttributes","isOverflowing","_saveInitialAttribute","styleProperty","scrollbarWidth","_applyManipulationCallback","setProperty","actualValue","removeProperty","callBack","EVENT_HIDE_PREVENTED","EVENT_RESIZE","EVENT_CLICK_DISMISS","EVENT_MOUSEDOWN_DISMISS","EVENT_KEYDOWN_DISMISS","CLASS_NAME_OPEN","CLASS_NAME_STATIC","Modal","_dialog","_backdrop","_initializeBackDrop","_focustrap","_initializeFocusTrap","_scrollBar","_adjustDialog","_showElement","_hideModal","handleUpdate","modalBody","transitionComplete","_triggerBackdropTransition","event2","_resetAdjustments","isModalOverflowing","initialOverflowY","isBodyOverflowing","paddingLeft","paddingRight","showEvent","alreadyOpen","CLASS_NAME_SHOWING","CLASS_NAME_HIDING","OPEN_SELECTOR","Offcanvas","blur","completeCallback","DefaultAllowlist","area","br","col","code","dd","div","dl","dt","em","hr","h1","h2","h3","h4","h5","h6","li","ol","p","pre","s","small","span","sub","sup","strong","u","ul","uriAttributes","SAFE_URL_PATTERN","allowedAttribute","allowedAttributeList","attributeName","nodeValue","attributeRegex","regex","allowList","content","extraClass","sanitize","sanitizeFn","template","DefaultContentType","entry","TemplateFactory","getContent","_resolvePossibleFunction","hasContent","changeContent","_checkContent","toHtml","templateWrapper","innerHTML","_maybeSanitize","text","_setContent","arg","templateElement","_putElementInTemplate","textContent","unsafeHtml","sanitizeFunction","createdDocument","DOMParser","parseFromString","elementName","attributeList","allowedAttributes","sanitizeHtml","DISALLOWED_ATTRIBUTES","CLASS_NAME_FADE","SELECTOR_TOOLTIP_INNER","SELECTOR_MODAL","EVENT_MODAL_HIDE","TRIGGER_HOVER","TRIGGER_FOCUS","TRIGGER_CLICK","AttachmentMap","AUTO","TOP","RIGHT","BOTTOM","LEFT","animation","container","customClass","delay","title","Tooltip","_isEnabled","_timeout","_isHovered","_activeTrigger","_templateFactory","_newContent","tip","_setListeners","_fixTitle","enable","disable","toggleEnabled","_leave","_enter","_hideModalHandler","_disposePopper","_isWithContent","isInTheDom","_getTipElement","_isWithActiveTrigger","_getTitle","_createTipElement","_getContentForTemplate","_getTemplateFactory","tipId","prefix","floor","random","getElementById","getUID","setContent","_initializeOnDelegatedTarget","_getDelegateConfig","attachment","triggers","eventIn","eventOut","_setTimeout","timeout","dataAttributes","dataAttribute","SELECTOR_TITLE","SELECTOR_CONTENT","Popover","_getContent","EVENT_ACTIVATE","EVENT_CLICK","SELECTOR_TARGET_LINKS","SELECTOR_NAV_LINKS","SELECTOR_LINK_ITEMS","rootMargin","smoothScroll","threshold","ScrollSpy","_targetLinks","_observableSections","_rootElement","_activeTarget","_observer","_previousScrollData","visibleEntryTop","parentScrollTop","refresh","_initializeTargetsAndObservables","_maybeEnableSmoothScroll","disconnect","_getNewObserver","section","observe","observableSection","scrollTo","behavior","IntersectionObserver","_observerCallback","targetElement","_process","userScrollsDown","isIntersecting","_clearActiveClass","entryIsLowerThanPrevious","targetLinks","anchor","decodeURI","_activateParents","listGroup","activeNodes","spy","HOME_KEY","END_KEY","SELECTOR_DROPDOWN_TOGGLE","NOT_SELECTOR_DROPDOWN_TOGGLE","SELECTOR_INNER_ELEM","SELECTOR_DATA_TOGGLE_ACTIVE","Tab","_setInitialAttributes","_getChildren","innerElem","_elemIsActive","active","_getActiveElem","hideEvent","_deactivate","_activate","relatedElem","_toggleDropDown","nextActiveElement","preventScroll","_setAttributeIfNotExists","_setInitialAttributesOnChild","_getInnerElement","isActive","outerElem","_getOuterElement","_setInitialAttributesOnTargetPanel","open","EVENT_MOUSEOVER","EVENT_MOUSEOUT","EVENT_FOCUSOUT","CLASS_NAME_HIDE","autohide","Toast","_hasMouseInteraction","_hasKeyboardInteraction","_clearTimeout","_maybeScheduleHide","isShown","_onInteraction","isInteracting"],"sources":["../../js/src/dom/data.js","../../js/src/util/index.js","../../js/src/dom/event-handler.js","../../js/src/dom/manipulator.js","../../js/src/util/config.js","../../js/src/base-component.js","../../js/src/dom/selector-engine.js","../../js/src/util/component-functions.js","../../js/src/alert.js","../../js/src/button.js","../../js/src/util/swipe.js","../../js/src/carousel.js","../../js/src/collapse.js","../../node_modules/@popperjs/core/lib/enums.js","../../node_modules/@popperjs/core/lib/dom-utils/getNodeName.js","../../node_modules/@popperjs/core/lib/dom-utils/getWindow.js","../../node_modules/@popperjs/core/lib/dom-utils/instanceOf.js","../../node_modules/@popperjs/core/lib/modifiers/applyStyles.js","../../node_modules/@popperjs/core/lib/utils/getBasePlacement.js","../../node_modules/@popperjs/core/lib/utils/math.js","../../node_modules/@popperjs/core/lib/utils/userAgent.js","../../node_modules/@popperjs/core/lib/dom-utils/isLayoutViewport.js","../../node_modules/@popperjs/core/lib/dom-utils/getBoundingClientRect.js","../../node_modules/@popperjs/core/lib/dom-utils/getLayoutRect.js","../../node_modules/@popperjs/core/lib/dom-utils/contains.js","../../node_modules/@popperjs/core/lib/dom-utils/getComputedStyle.js","../../node_modules/@popperjs/core/lib/dom-utils/isTableElement.js","../../node_modules/@popperjs/core/lib/dom-utils/getDocumentElement.js","../../node_modules/@popperjs/core/lib/dom-utils/getParentNode.js","../../node_modules/@popperjs/core/lib/dom-utils/getOffsetParent.js","../../node_modules/@popperjs/core/lib/utils/getMainAxisFromPlacement.js","../../node_modules/@popperjs/core/lib/utils/within.js","../../node_modules/@popperjs/core/lib/utils/mergePaddingObject.js","../../node_modules/@popperjs/core/lib/utils/getFreshSideObject.js","../../node_modules/@popperjs/core/lib/utils/expandToHashMap.js","../../node_modules/@popperjs/core/lib/modifiers/arrow.js","../../node_modules/@popperjs/core/lib/utils/getVariation.js","../../node_modules/@popperjs/core/lib/modifiers/computeStyles.js","../../node_modules/@popperjs/core/lib/modifiers/eventListeners.js","../../node_modules/@popperjs/core/lib/utils/getOppositePlacement.js","../../node_modules/@popperjs/core/lib/utils/getOppositeVariationPlacement.js","../../node_modules/@popperjs/core/lib/dom-utils/getWindowScroll.js","../../node_modules/@popperjs/core/lib/dom-utils/getWindowScrollBarX.js","../../node_modules/@popperjs/core/lib/dom-utils/isScrollParent.js","../../node_modules/@popperjs/core/lib/dom-utils/getScrollParent.js","../../node_modules/@popperjs/core/lib/dom-utils/listScrollParents.js","../../node_modules/@popperjs/core/lib/utils/rectToClientRect.js","../../node_modules/@popperjs/core/lib/dom-utils/getClippingRect.js","../../node_modules/@popperjs/core/lib/dom-utils/getViewportRect.js","../../node_modules/@popperjs/core/lib/dom-utils/getDocumentRect.js","../../node_modules/@popperjs/core/lib/utils/computeOffsets.js","../../node_modules/@popperjs/core/lib/utils/detectOverflow.js","../../node_modules/@popperjs/core/lib/utils/computeAutoPlacement.js","../../node_modules/@popperjs/core/lib/modifiers/flip.js","../../node_modules/@popperjs/core/lib/modifiers/hide.js","../../node_modules/@popperjs/core/lib/modifiers/offset.js","../../node_modules/@popperjs/core/lib/modifiers/popperOffsets.js","../../node_modules/@popperjs/core/lib/modifiers/preventOverflow.js","../../node_modules/@popperjs/core/lib/utils/getAltAxis.js","../../node_modules/@popperjs/core/lib/dom-utils/getCompositeRect.js","../../node_modules/@popperjs/core/lib/dom-utils/getNodeScroll.js","../../node_modules/@popperjs/core/lib/dom-utils/getHTMLElementScroll.js","../../node_modules/@popperjs/core/lib/utils/orderModifiers.js","../../node_modules/@popperjs/core/lib/createPopper.js","../../node_modules/@popperjs/core/lib/utils/debounce.js","../../node_modules/@popperjs/core/lib/utils/mergeByName.js","../../node_modules/@popperjs/core/lib/popper-lite.js","../../node_modules/@popperjs/core/lib/popper.js","../../js/src/dropdown.js","../../js/src/util/backdrop.js","../../js/src/util/focustrap.js","../../js/src/util/scrollbar.js","../../js/src/modal.js","../../js/src/offcanvas.js","../../js/src/util/sanitizer.js","../../js/src/util/template-factory.js","../../js/src/tooltip.js","../../js/src/popover.js","../../js/src/scrollspy.js","../../js/src/tab.js","../../js/src/toast.js","../../js/index.umd.js"],"sourcesContent":["/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/data.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\n/**\n * Constants\n */\n\nconst elementMap = new Map()\n\nexport default {\n set(element, key, instance) {\n if (!elementMap.has(element)) {\n elementMap.set(element, new Map())\n }\n\n const instanceMap = elementMap.get(element)\n\n // make it clear we only want one instance per element\n // can be removed later when multiple key/instances are fine to be used\n if (!instanceMap.has(key) && instanceMap.size !== 0) {\n // eslint-disable-next-line no-console\n console.error(`Bootstrap doesn't allow more than one instance per element. Bound instance: ${Array.from(instanceMap.keys())[0]}.`)\n return\n }\n\n instanceMap.set(key, instance)\n },\n\n get(element, key) {\n if (elementMap.has(element)) {\n return elementMap.get(element).get(key) || null\n }\n\n return null\n },\n\n remove(element, key) {\n if (!elementMap.has(element)) {\n return\n }\n\n const instanceMap = elementMap.get(element)\n\n instanceMap.delete(key)\n\n // free up element references if there are no instances left for an element\n if (instanceMap.size === 0) {\n elementMap.delete(element)\n }\n }\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/index.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nconst MAX_UID = 1_000_000\nconst MILLISECONDS_MULTIPLIER = 1000\nconst TRANSITION_END = 'transitionend'\n\n/**\n * Properly escape IDs selectors to handle weird IDs\n * @param {string} selector\n * @returns {string}\n */\nconst parseSelector = selector => {\n if (selector && window.CSS && window.CSS.escape) {\n // document.querySelector needs escaping to handle IDs (html5+) containing for instance /\n selector = selector.replace(/#([^\\s\"#']+)/g, (match, id) => `#${CSS.escape(id)}`)\n }\n\n return selector\n}\n\n// Shout-out Angus Croll (https://goo.gl/pxwQGp)\nconst toType = object => {\n if (object === null || object === undefined) {\n return `${object}`\n }\n\n return Object.prototype.toString.call(object).match(/\\s([a-z]+)/i)[1].toLowerCase()\n}\n\n/**\n * Public Util API\n */\n\nconst getUID = prefix => {\n do {\n prefix += Math.floor(Math.random() * MAX_UID)\n } while (document.getElementById(prefix))\n\n return prefix\n}\n\nconst getTransitionDurationFromElement = element => {\n if (!element) {\n return 0\n }\n\n // Get transition-duration of the element\n let { transitionDuration, transitionDelay } = window.getComputedStyle(element)\n\n const floatTransitionDuration = Number.parseFloat(transitionDuration)\n const floatTransitionDelay = Number.parseFloat(transitionDelay)\n\n // Return 0 if element or transition duration is not found\n if (!floatTransitionDuration && !floatTransitionDelay) {\n return 0\n }\n\n // If multiple durations are defined, take the first\n transitionDuration = transitionDuration.split(',')[0]\n transitionDelay = transitionDelay.split(',')[0]\n\n return (Number.parseFloat(transitionDuration) + Number.parseFloat(transitionDelay)) * MILLISECONDS_MULTIPLIER\n}\n\nconst triggerTransitionEnd = element => {\n element.dispatchEvent(new Event(TRANSITION_END))\n}\n\nconst isElement = object => {\n if (!object || typeof object !== 'object') {\n return false\n }\n\n if (typeof object.jquery !== 'undefined') {\n object = object[0]\n }\n\n return typeof object.nodeType !== 'undefined'\n}\n\nconst getElement = object => {\n // it's a jQuery object or a node element\n if (isElement(object)) {\n return object.jquery ? object[0] : object\n }\n\n if (typeof object === 'string' && object.length > 0) {\n return document.querySelector(parseSelector(object))\n }\n\n return null\n}\n\nconst isVisible = element => {\n if (!isElement(element) || element.getClientRects().length === 0) {\n return false\n }\n\n const elementIsVisible = getComputedStyle(element).getPropertyValue('visibility') === 'visible'\n // Handle `details` element as its content may falsie appear visible when it is closed\n const closedDetails = element.closest('details:not([open])')\n\n if (!closedDetails) {\n return elementIsVisible\n }\n\n if (closedDetails !== element) {\n const summary = element.closest('summary')\n if (summary && summary.parentNode !== closedDetails) {\n return false\n }\n\n if (summary === null) {\n return false\n }\n }\n\n return elementIsVisible\n}\n\nconst isDisabled = element => {\n if (!element || element.nodeType !== Node.ELEMENT_NODE) {\n return true\n }\n\n if (element.classList.contains('disabled')) {\n return true\n }\n\n if (typeof element.disabled !== 'undefined') {\n return element.disabled\n }\n\n return element.hasAttribute('disabled') && element.getAttribute('disabled') !== 'false'\n}\n\nconst findShadowRoot = element => {\n if (!document.documentElement.attachShadow) {\n return null\n }\n\n // Can find the shadow root otherwise it'll return the document\n if (typeof element.getRootNode === 'function') {\n const root = element.getRootNode()\n return root instanceof ShadowRoot ? root : null\n }\n\n if (element instanceof ShadowRoot) {\n return element\n }\n\n // when we don't find a shadow root\n if (!element.parentNode) {\n return null\n }\n\n return findShadowRoot(element.parentNode)\n}\n\nconst noop = () => {}\n\n/**\n * Trick to restart an element's animation\n *\n * @param {HTMLElement} element\n * @return void\n *\n * @see https://www.harrytheo.com/blog/2021/02/restart-a-css-animation-with-javascript/#restarting-a-css-animation\n */\nconst reflow = element => {\n element.offsetHeight // eslint-disable-line no-unused-expressions\n}\n\nconst getjQuery = () => {\n if (window.jQuery && !document.body.hasAttribute('data-bs-no-jquery')) {\n return window.jQuery\n }\n\n return null\n}\n\nconst DOMContentLoadedCallbacks = []\n\nconst onDOMContentLoaded = callback => {\n if (document.readyState === 'loading') {\n // add listener on the first call when the document is in loading state\n if (!DOMContentLoadedCallbacks.length) {\n document.addEventListener('DOMContentLoaded', () => {\n for (const callback of DOMContentLoadedCallbacks) {\n callback()\n }\n })\n }\n\n DOMContentLoadedCallbacks.push(callback)\n } else {\n callback()\n }\n}\n\nconst isRTL = () => document.documentElement.dir === 'rtl'\n\nconst defineJQueryPlugin = plugin => {\n onDOMContentLoaded(() => {\n const $ = getjQuery()\n /* istanbul ignore if */\n if ($) {\n const name = plugin.NAME\n const JQUERY_NO_CONFLICT = $.fn[name]\n $.fn[name] = plugin.jQueryInterface\n $.fn[name].Constructor = plugin\n $.fn[name].noConflict = () => {\n $.fn[name] = JQUERY_NO_CONFLICT\n return plugin.jQueryInterface\n }\n }\n })\n}\n\nconst execute = (possibleCallback, args = [], defaultValue = possibleCallback) => {\n return typeof possibleCallback === 'function' ? possibleCallback.call(...args) : defaultValue\n}\n\nconst executeAfterTransition = (callback, transitionElement, waitForTransition = true) => {\n if (!waitForTransition) {\n execute(callback)\n return\n }\n\n const durationPadding = 5\n const emulatedDuration = getTransitionDurationFromElement(transitionElement) + durationPadding\n\n let called = false\n\n const handler = ({ target }) => {\n if (target !== transitionElement) {\n return\n }\n\n called = true\n transitionElement.removeEventListener(TRANSITION_END, handler)\n execute(callback)\n }\n\n transitionElement.addEventListener(TRANSITION_END, handler)\n setTimeout(() => {\n if (!called) {\n triggerTransitionEnd(transitionElement)\n }\n }, emulatedDuration)\n}\n\n/**\n * Return the previous/next element of a list.\n *\n * @param {array} list The list of elements\n * @param activeElement The active element\n * @param shouldGetNext Choose to get next or previous element\n * @param isCycleAllowed\n * @return {Element|elem} The proper element\n */\nconst getNextActiveElement = (list, activeElement, shouldGetNext, isCycleAllowed) => {\n const listLength = list.length\n let index = list.indexOf(activeElement)\n\n // if the element does not exist in the list return an element\n // depending on the direction and if cycle is allowed\n if (index === -1) {\n return !shouldGetNext && isCycleAllowed ? list[listLength - 1] : list[0]\n }\n\n index += shouldGetNext ? 1 : -1\n\n if (isCycleAllowed) {\n index = (index + listLength) % listLength\n }\n\n return list[Math.max(0, Math.min(index, listLength - 1))]\n}\n\nexport {\n defineJQueryPlugin,\n execute,\n executeAfterTransition,\n findShadowRoot,\n getElement,\n getjQuery,\n getNextActiveElement,\n getTransitionDurationFromElement,\n getUID,\n isDisabled,\n isElement,\n isRTL,\n isVisible,\n noop,\n onDOMContentLoaded,\n parseSelector,\n reflow,\n triggerTransitionEnd,\n toType\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/event-handler.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport { getjQuery } from '../util/index.js'\n\n/**\n * Constants\n */\n\nconst namespaceRegex = /[^.]*(?=\\..*)\\.|.*/\nconst stripNameRegex = /\\..*/\nconst stripUidRegex = /::\\d+$/\nconst eventRegistry = {} // Events storage\nlet uidEvent = 1\nconst customEvents = {\n mouseenter: 'mouseover',\n mouseleave: 'mouseout'\n}\n\nconst nativeEvents = new Set([\n 'click',\n 'dblclick',\n 'mouseup',\n 'mousedown',\n 'contextmenu',\n 'mousewheel',\n 'DOMMouseScroll',\n 'mouseover',\n 'mouseout',\n 'mousemove',\n 'selectstart',\n 'selectend',\n 'keydown',\n 'keypress',\n 'keyup',\n 'orientationchange',\n 'touchstart',\n 'touchmove',\n 'touchend',\n 'touchcancel',\n 'pointerdown',\n 'pointermove',\n 'pointerup',\n 'pointerleave',\n 'pointercancel',\n 'gesturestart',\n 'gesturechange',\n 'gestureend',\n 'focus',\n 'blur',\n 'change',\n 'reset',\n 'select',\n 'submit',\n 'focusin',\n 'focusout',\n 'load',\n 'unload',\n 'beforeunload',\n 'resize',\n 'move',\n 'DOMContentLoaded',\n 'readystatechange',\n 'error',\n 'abort',\n 'scroll'\n])\n\n/**\n * Private methods\n */\n\nfunction makeEventUid(element, uid) {\n return (uid && `${uid}::${uidEvent++}`) || element.uidEvent || uidEvent++\n}\n\nfunction getElementEvents(element) {\n const uid = makeEventUid(element)\n\n element.uidEvent = uid\n eventRegistry[uid] = eventRegistry[uid] || {}\n\n return eventRegistry[uid]\n}\n\nfunction bootstrapHandler(element, fn) {\n return function handler(event) {\n hydrateObj(event, { delegateTarget: element })\n\n if (handler.oneOff) {\n EventHandler.off(element, event.type, fn)\n }\n\n return fn.apply(element, [event])\n }\n}\n\nfunction bootstrapDelegationHandler(element, selector, fn) {\n return function handler(event) {\n const domElements = element.querySelectorAll(selector)\n\n for (let { target } = event; target && target !== this; target = target.parentNode) {\n for (const domElement of domElements) {\n if (domElement !== target) {\n continue\n }\n\n hydrateObj(event, { delegateTarget: target })\n\n if (handler.oneOff) {\n EventHandler.off(element, event.type, selector, fn)\n }\n\n return fn.apply(target, [event])\n }\n }\n }\n}\n\nfunction findHandler(events, callable, delegationSelector = null) {\n return Object.values(events)\n .find(event => event.callable === callable && event.delegationSelector === delegationSelector)\n}\n\nfunction normalizeParameters(originalTypeEvent, handler, delegationFunction) {\n const isDelegated = typeof handler === 'string'\n // TODO: tooltip passes `false` instead of selector, so we need to check\n const callable = isDelegated ? delegationFunction : (handler || delegationFunction)\n let typeEvent = getTypeEvent(originalTypeEvent)\n\n if (!nativeEvents.has(typeEvent)) {\n typeEvent = originalTypeEvent\n }\n\n return [isDelegated, callable, typeEvent]\n}\n\nfunction addHandler(element, originalTypeEvent, handler, delegationFunction, oneOff) {\n if (typeof originalTypeEvent !== 'string' || !element) {\n return\n }\n\n let [isDelegated, callable, typeEvent] = normalizeParameters(originalTypeEvent, handler, delegationFunction)\n\n // in case of mouseenter or mouseleave wrap the handler within a function that checks for its DOM position\n // this prevents the handler from being dispatched the same way as mouseover or mouseout does\n if (originalTypeEvent in customEvents) {\n const wrapFunction = fn => {\n return function (event) {\n if (!event.relatedTarget || (event.relatedTarget !== event.delegateTarget && !event.delegateTarget.contains(event.relatedTarget))) {\n return fn.call(this, event)\n }\n }\n }\n\n callable = wrapFunction(callable)\n }\n\n const events = getElementEvents(element)\n const handlers = events[typeEvent] || (events[typeEvent] = {})\n const previousFunction = findHandler(handlers, callable, isDelegated ? handler : null)\n\n if (previousFunction) {\n previousFunction.oneOff = previousFunction.oneOff && oneOff\n\n return\n }\n\n const uid = makeEventUid(callable, originalTypeEvent.replace(namespaceRegex, ''))\n const fn = isDelegated ?\n bootstrapDelegationHandler(element, handler, callable) :\n bootstrapHandler(element, callable)\n\n fn.delegationSelector = isDelegated ? handler : null\n fn.callable = callable\n fn.oneOff = oneOff\n fn.uidEvent = uid\n handlers[uid] = fn\n\n element.addEventListener(typeEvent, fn, isDelegated)\n}\n\nfunction removeHandler(element, events, typeEvent, handler, delegationSelector) {\n const fn = findHandler(events[typeEvent], handler, delegationSelector)\n\n if (!fn) {\n return\n }\n\n element.removeEventListener(typeEvent, fn, Boolean(delegationSelector))\n delete events[typeEvent][fn.uidEvent]\n}\n\nfunction removeNamespacedHandlers(element, events, typeEvent, namespace) {\n const storeElementEvent = events[typeEvent] || {}\n\n for (const [handlerKey, event] of Object.entries(storeElementEvent)) {\n if (handlerKey.includes(namespace)) {\n removeHandler(element, events, typeEvent, event.callable, event.delegationSelector)\n }\n }\n}\n\nfunction getTypeEvent(event) {\n // allow to get the native events from namespaced events ('click.bs.button' --> 'click')\n event = event.replace(stripNameRegex, '')\n return customEvents[event] || event\n}\n\nconst EventHandler = {\n on(element, event, handler, delegationFunction) {\n addHandler(element, event, handler, delegationFunction, false)\n },\n\n one(element, event, handler, delegationFunction) {\n addHandler(element, event, handler, delegationFunction, true)\n },\n\n off(element, originalTypeEvent, handler, delegationFunction) {\n if (typeof originalTypeEvent !== 'string' || !element) {\n return\n }\n\n const [isDelegated, callable, typeEvent] = normalizeParameters(originalTypeEvent, handler, delegationFunction)\n const inNamespace = typeEvent !== originalTypeEvent\n const events = getElementEvents(element)\n const storeElementEvent = events[typeEvent] || {}\n const isNamespace = originalTypeEvent.startsWith('.')\n\n if (typeof callable !== 'undefined') {\n // Simplest case: handler is passed, remove that listener ONLY.\n if (!Object.keys(storeElementEvent).length) {\n return\n }\n\n removeHandler(element, events, typeEvent, callable, isDelegated ? handler : null)\n return\n }\n\n if (isNamespace) {\n for (const elementEvent of Object.keys(events)) {\n removeNamespacedHandlers(element, events, elementEvent, originalTypeEvent.slice(1))\n }\n }\n\n for (const [keyHandlers, event] of Object.entries(storeElementEvent)) {\n const handlerKey = keyHandlers.replace(stripUidRegex, '')\n\n if (!inNamespace || originalTypeEvent.includes(handlerKey)) {\n removeHandler(element, events, typeEvent, event.callable, event.delegationSelector)\n }\n }\n },\n\n trigger(element, event, args) {\n if (typeof event !== 'string' || !element) {\n return null\n }\n\n const $ = getjQuery()\n const typeEvent = getTypeEvent(event)\n const inNamespace = event !== typeEvent\n\n let jQueryEvent = null\n let bubbles = true\n let nativeDispatch = true\n let defaultPrevented = false\n\n if (inNamespace && $) {\n jQueryEvent = $.Event(event, args)\n\n $(element).trigger(jQueryEvent)\n bubbles = !jQueryEvent.isPropagationStopped()\n nativeDispatch = !jQueryEvent.isImmediatePropagationStopped()\n defaultPrevented = jQueryEvent.isDefaultPrevented()\n }\n\n const evt = hydrateObj(new Event(event, { bubbles, cancelable: true }), args)\n\n if (defaultPrevented) {\n evt.preventDefault()\n }\n\n if (nativeDispatch) {\n element.dispatchEvent(evt)\n }\n\n if (evt.defaultPrevented && jQueryEvent) {\n jQueryEvent.preventDefault()\n }\n\n return evt\n }\n}\n\nfunction hydrateObj(obj, meta = {}) {\n for (const [key, value] of Object.entries(meta)) {\n try {\n obj[key] = value\n } catch {\n Object.defineProperty(obj, key, {\n configurable: true,\n get() {\n return value\n }\n })\n }\n }\n\n return obj\n}\n\nexport default EventHandler\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/manipulator.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nfunction normalizeData(value) {\n if (value === 'true') {\n return true\n }\n\n if (value === 'false') {\n return false\n }\n\n if (value === Number(value).toString()) {\n return Number(value)\n }\n\n if (value === '' || value === 'null') {\n return null\n }\n\n if (typeof value !== 'string') {\n return value\n }\n\n try {\n return JSON.parse(decodeURIComponent(value))\n } catch {\n return value\n }\n}\n\nfunction normalizeDataKey(key) {\n return key.replace(/[A-Z]/g, chr => `-${chr.toLowerCase()}`)\n}\n\nconst Manipulator = {\n setDataAttribute(element, key, value) {\n element.setAttribute(`data-bs-${normalizeDataKey(key)}`, value)\n },\n\n removeDataAttribute(element, key) {\n element.removeAttribute(`data-bs-${normalizeDataKey(key)}`)\n },\n\n getDataAttributes(element) {\n if (!element) {\n return {}\n }\n\n const attributes = {}\n const bsKeys = Object.keys(element.dataset).filter(key => key.startsWith('bs') && !key.startsWith('bsConfig'))\n\n for (const key of bsKeys) {\n let pureKey = key.replace(/^bs/, '')\n pureKey = pureKey.charAt(0).toLowerCase() + pureKey.slice(1)\n attributes[pureKey] = normalizeData(element.dataset[key])\n }\n\n return attributes\n },\n\n getDataAttribute(element, key) {\n return normalizeData(element.getAttribute(`data-bs-${normalizeDataKey(key)}`))\n }\n}\n\nexport default Manipulator\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/config.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Manipulator from '../dom/manipulator.js'\nimport { isElement, toType } from './index.js'\n\n/**\n * Class definition\n */\n\nclass Config {\n // Getters\n static get Default() {\n return {}\n }\n\n static get DefaultType() {\n return {}\n }\n\n static get NAME() {\n throw new Error('You have to implement the static method \"NAME\", for each component!')\n }\n\n _getConfig(config) {\n config = this._mergeConfigObj(config)\n config = this._configAfterMerge(config)\n this._typeCheckConfig(config)\n return config\n }\n\n _configAfterMerge(config) {\n return config\n }\n\n _mergeConfigObj(config, element) {\n const jsonConfig = isElement(element) ? Manipulator.getDataAttribute(element, 'config') : {} // try to parse\n\n return {\n ...this.constructor.Default,\n ...(typeof jsonConfig === 'object' ? jsonConfig : {}),\n ...(isElement(element) ? Manipulator.getDataAttributes(element) : {}),\n ...(typeof config === 'object' ? config : {})\n }\n }\n\n _typeCheckConfig(config, configTypes = this.constructor.DefaultType) {\n for (const [property, expectedTypes] of Object.entries(configTypes)) {\n const value = config[property]\n const valueType = isElement(value) ? 'element' : toType(value)\n\n if (!new RegExp(expectedTypes).test(valueType)) {\n throw new TypeError(\n `${this.constructor.NAME.toUpperCase()}: Option \"${property}\" provided type \"${valueType}\" but expected type \"${expectedTypes}\".`\n )\n }\n }\n }\n}\n\nexport default Config\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap base-component.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Data from './dom/data.js'\nimport EventHandler from './dom/event-handler.js'\nimport Config from './util/config.js'\nimport { executeAfterTransition, getElement } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst VERSION = '5.3.8'\n\n/**\n * Class definition\n */\n\nclass BaseComponent extends Config {\n constructor(element, config) {\n super()\n\n element = getElement(element)\n if (!element) {\n return\n }\n\n this._element = element\n this._config = this._getConfig(config)\n\n Data.set(this._element, this.constructor.DATA_KEY, this)\n }\n\n // Public\n dispose() {\n Data.remove(this._element, this.constructor.DATA_KEY)\n EventHandler.off(this._element, this.constructor.EVENT_KEY)\n\n for (const propertyName of Object.getOwnPropertyNames(this)) {\n this[propertyName] = null\n }\n }\n\n // Private\n _queueCallback(callback, element, isAnimated = true) {\n executeAfterTransition(callback, element, isAnimated)\n }\n\n _getConfig(config) {\n config = this._mergeConfigObj(config, this._element)\n config = this._configAfterMerge(config)\n this._typeCheckConfig(config)\n return config\n }\n\n // Static\n static getInstance(element) {\n return Data.get(getElement(element), this.DATA_KEY)\n }\n\n static getOrCreateInstance(element, config = {}) {\n return this.getInstance(element) || new this(element, typeof config === 'object' ? config : null)\n }\n\n static get VERSION() {\n return VERSION\n }\n\n static get DATA_KEY() {\n return `bs.${this.NAME}`\n }\n\n static get EVENT_KEY() {\n return `.${this.DATA_KEY}`\n }\n\n static eventName(name) {\n return `${name}${this.EVENT_KEY}`\n }\n}\n\nexport default BaseComponent\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap dom/selector-engine.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport { isDisabled, isVisible, parseSelector } from '../util/index.js'\n\nconst getSelector = element => {\n let selector = element.getAttribute('data-bs-target')\n\n if (!selector || selector === '#') {\n let hrefAttribute = element.getAttribute('href')\n\n // The only valid content that could double as a selector are IDs or classes,\n // so everything starting with `#` or `.`. If a \"real\" URL is used as the selector,\n // `document.querySelector` will rightfully complain it is invalid.\n // See https://github.com/twbs/bootstrap/issues/32273\n if (!hrefAttribute || (!hrefAttribute.includes('#') && !hrefAttribute.startsWith('.'))) {\n return null\n }\n\n // Just in case some CMS puts out a full URL with the anchor appended\n if (hrefAttribute.includes('#') && !hrefAttribute.startsWith('#')) {\n hrefAttribute = `#${hrefAttribute.split('#')[1]}`\n }\n\n selector = hrefAttribute && hrefAttribute !== '#' ? hrefAttribute.trim() : null\n }\n\n return selector ? selector.split(',').map(sel => parseSelector(sel)).join(',') : null\n}\n\nconst SelectorEngine = {\n find(selector, element = document.documentElement) {\n return [].concat(...Element.prototype.querySelectorAll.call(element, selector))\n },\n\n findOne(selector, element = document.documentElement) {\n return Element.prototype.querySelector.call(element, selector)\n },\n\n children(element, selector) {\n return [].concat(...element.children).filter(child => child.matches(selector))\n },\n\n parents(element, selector) {\n const parents = []\n let ancestor = element.parentNode.closest(selector)\n\n while (ancestor) {\n parents.push(ancestor)\n ancestor = ancestor.parentNode.closest(selector)\n }\n\n return parents\n },\n\n prev(element, selector) {\n let previous = element.previousElementSibling\n\n while (previous) {\n if (previous.matches(selector)) {\n return [previous]\n }\n\n previous = previous.previousElementSibling\n }\n\n return []\n },\n // TODO: this is now unused; remove later along with prev()\n next(element, selector) {\n let next = element.nextElementSibling\n\n while (next) {\n if (next.matches(selector)) {\n return [next]\n }\n\n next = next.nextElementSibling\n }\n\n return []\n },\n\n focusableChildren(element) {\n const focusables = [\n 'a',\n 'button',\n 'input',\n 'textarea',\n 'select',\n 'details',\n '[tabindex]',\n '[contenteditable=\"true\"]'\n ].map(selector => `${selector}:not([tabindex^=\"-\"])`).join(',')\n\n return this.find(focusables, element).filter(el => !isDisabled(el) && isVisible(el))\n },\n\n getSelectorFromElement(element) {\n const selector = getSelector(element)\n\n if (selector) {\n return SelectorEngine.findOne(selector) ? selector : null\n }\n\n return null\n },\n\n getElementFromSelector(element) {\n const selector = getSelector(element)\n\n return selector ? SelectorEngine.findOne(selector) : null\n },\n\n getMultipleElementsFromSelector(element) {\n const selector = getSelector(element)\n\n return selector ? SelectorEngine.find(selector) : []\n }\n}\n\nexport default SelectorEngine\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/component-functions.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport { isDisabled } from './index.js'\n\nconst enableDismissTrigger = (component, method = 'hide') => {\n const clickEvent = `click.dismiss${component.EVENT_KEY}`\n const name = component.NAME\n\n EventHandler.on(document, clickEvent, `[data-bs-dismiss=\"${name}\"]`, function (event) {\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n if (isDisabled(this)) {\n return\n }\n\n const target = SelectorEngine.getElementFromSelector(this) || this.closest(`.${name}`)\n const instance = component.getOrCreateInstance(target)\n\n // Method argument is left, for Alert and only, as it doesn't implement the 'hide' method\n instance[method]()\n })\n}\n\nexport {\n enableDismissTrigger\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap alert.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport { enableDismissTrigger } from './util/component-functions.js'\nimport { defineJQueryPlugin } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'alert'\nconst DATA_KEY = 'bs.alert'\nconst EVENT_KEY = `.${DATA_KEY}`\n\nconst EVENT_CLOSE = `close${EVENT_KEY}`\nconst EVENT_CLOSED = `closed${EVENT_KEY}`\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\n\n/**\n * Class definition\n */\n\nclass Alert extends BaseComponent {\n // Getters\n static get NAME() {\n return NAME\n }\n\n // Public\n close() {\n const closeEvent = EventHandler.trigger(this._element, EVENT_CLOSE)\n\n if (closeEvent.defaultPrevented) {\n return\n }\n\n this._element.classList.remove(CLASS_NAME_SHOW)\n\n const isAnimated = this._element.classList.contains(CLASS_NAME_FADE)\n this._queueCallback(() => this._destroyElement(), this._element, isAnimated)\n }\n\n // Private\n _destroyElement() {\n this._element.remove()\n EventHandler.trigger(this._element, EVENT_CLOSED)\n this.dispose()\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Alert.getOrCreateInstance(this)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (data[config] === undefined || config.startsWith('_') || config === 'constructor') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config](this)\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nenableDismissTrigger(Alert, 'close')\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Alert)\n\nexport default Alert\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap button.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport { defineJQueryPlugin } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'button'\nconst DATA_KEY = 'bs.button'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\n\nconst CLASS_NAME_ACTIVE = 'active'\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"button\"]'\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\n\n/**\n * Class definition\n */\n\nclass Button extends BaseComponent {\n // Getters\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle() {\n // Toggle class and sync the `aria-pressed` attribute with the return value of the `.toggle()` method\n this._element.setAttribute('aria-pressed', this._element.classList.toggle(CLASS_NAME_ACTIVE))\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Button.getOrCreateInstance(this)\n\n if (config === 'toggle') {\n data[config]()\n }\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, event => {\n event.preventDefault()\n\n const button = event.target.closest(SELECTOR_DATA_TOGGLE)\n const data = Button.getOrCreateInstance(button)\n\n data.toggle()\n})\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Button)\n\nexport default Button\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/swipe.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport Config from './config.js'\nimport { execute } from './index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'swipe'\nconst EVENT_KEY = '.bs.swipe'\nconst EVENT_TOUCHSTART = `touchstart${EVENT_KEY}`\nconst EVENT_TOUCHMOVE = `touchmove${EVENT_KEY}`\nconst EVENT_TOUCHEND = `touchend${EVENT_KEY}`\nconst EVENT_POINTERDOWN = `pointerdown${EVENT_KEY}`\nconst EVENT_POINTERUP = `pointerup${EVENT_KEY}`\nconst POINTER_TYPE_TOUCH = 'touch'\nconst POINTER_TYPE_PEN = 'pen'\nconst CLASS_NAME_POINTER_EVENT = 'pointer-event'\nconst SWIPE_THRESHOLD = 40\n\nconst Default = {\n endCallback: null,\n leftCallback: null,\n rightCallback: null\n}\n\nconst DefaultType = {\n endCallback: '(function|null)',\n leftCallback: '(function|null)',\n rightCallback: '(function|null)'\n}\n\n/**\n * Class definition\n */\n\nclass Swipe extends Config {\n constructor(element, config) {\n super()\n this._element = element\n\n if (!element || !Swipe.isSupported()) {\n return\n }\n\n this._config = this._getConfig(config)\n this._deltaX = 0\n this._supportPointerEvents = Boolean(window.PointerEvent)\n this._initEvents()\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n dispose() {\n EventHandler.off(this._element, EVENT_KEY)\n }\n\n // Private\n _start(event) {\n if (!this._supportPointerEvents) {\n this._deltaX = event.touches[0].clientX\n\n return\n }\n\n if (this._eventIsPointerPenTouch(event)) {\n this._deltaX = event.clientX\n }\n }\n\n _end(event) {\n if (this._eventIsPointerPenTouch(event)) {\n this._deltaX = event.clientX - this._deltaX\n }\n\n this._handleSwipe()\n execute(this._config.endCallback)\n }\n\n _move(event) {\n this._deltaX = event.touches && event.touches.length > 1 ?\n 0 :\n event.touches[0].clientX - this._deltaX\n }\n\n _handleSwipe() {\n const absDeltaX = Math.abs(this._deltaX)\n\n if (absDeltaX <= SWIPE_THRESHOLD) {\n return\n }\n\n const direction = absDeltaX / this._deltaX\n\n this._deltaX = 0\n\n if (!direction) {\n return\n }\n\n execute(direction > 0 ? this._config.rightCallback : this._config.leftCallback)\n }\n\n _initEvents() {\n if (this._supportPointerEvents) {\n EventHandler.on(this._element, EVENT_POINTERDOWN, event => this._start(event))\n EventHandler.on(this._element, EVENT_POINTERUP, event => this._end(event))\n\n this._element.classList.add(CLASS_NAME_POINTER_EVENT)\n } else {\n EventHandler.on(this._element, EVENT_TOUCHSTART, event => this._start(event))\n EventHandler.on(this._element, EVENT_TOUCHMOVE, event => this._move(event))\n EventHandler.on(this._element, EVENT_TOUCHEND, event => this._end(event))\n }\n }\n\n _eventIsPointerPenTouch(event) {\n return this._supportPointerEvents && (event.pointerType === POINTER_TYPE_PEN || event.pointerType === POINTER_TYPE_TOUCH)\n }\n\n // Static\n static isSupported() {\n return 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0\n }\n}\n\nexport default Swipe\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap carousel.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport Manipulator from './dom/manipulator.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport {\n defineJQueryPlugin,\n getNextActiveElement,\n isRTL,\n isVisible,\n reflow,\n triggerTransitionEnd\n} from './util/index.js'\nimport Swipe from './util/swipe.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'carousel'\nconst DATA_KEY = 'bs.carousel'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\n\nconst ARROW_LEFT_KEY = 'ArrowLeft'\nconst ARROW_RIGHT_KEY = 'ArrowRight'\nconst TOUCHEVENT_COMPAT_WAIT = 500 // Time for mouse compat events to fire after touch\n\nconst ORDER_NEXT = 'next'\nconst ORDER_PREV = 'prev'\nconst DIRECTION_LEFT = 'left'\nconst DIRECTION_RIGHT = 'right'\n\nconst EVENT_SLIDE = `slide${EVENT_KEY}`\nconst EVENT_SLID = `slid${EVENT_KEY}`\nconst EVENT_KEYDOWN = `keydown${EVENT_KEY}`\nconst EVENT_MOUSEENTER = `mouseenter${EVENT_KEY}`\nconst EVENT_MOUSELEAVE = `mouseleave${EVENT_KEY}`\nconst EVENT_DRAG_START = `dragstart${EVENT_KEY}`\nconst EVENT_LOAD_DATA_API = `load${EVENT_KEY}${DATA_API_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_CAROUSEL = 'carousel'\nconst CLASS_NAME_ACTIVE = 'active'\nconst CLASS_NAME_SLIDE = 'slide'\nconst CLASS_NAME_END = 'carousel-item-end'\nconst CLASS_NAME_START = 'carousel-item-start'\nconst CLASS_NAME_NEXT = 'carousel-item-next'\nconst CLASS_NAME_PREV = 'carousel-item-prev'\n\nconst SELECTOR_ACTIVE = '.active'\nconst SELECTOR_ITEM = '.carousel-item'\nconst SELECTOR_ACTIVE_ITEM = SELECTOR_ACTIVE + SELECTOR_ITEM\nconst SELECTOR_ITEM_IMG = '.carousel-item img'\nconst SELECTOR_INDICATORS = '.carousel-indicators'\nconst SELECTOR_DATA_SLIDE = '[data-bs-slide], [data-bs-slide-to]'\nconst SELECTOR_DATA_RIDE = '[data-bs-ride=\"carousel\"]'\n\nconst KEY_TO_DIRECTION = {\n [ARROW_LEFT_KEY]: DIRECTION_RIGHT,\n [ARROW_RIGHT_KEY]: DIRECTION_LEFT\n}\n\nconst Default = {\n interval: 5000,\n keyboard: true,\n pause: 'hover',\n ride: false,\n touch: true,\n wrap: true\n}\n\nconst DefaultType = {\n interval: '(number|boolean)', // TODO:v6 remove boolean support\n keyboard: 'boolean',\n pause: '(string|boolean)',\n ride: '(boolean|string)',\n touch: 'boolean',\n wrap: 'boolean'\n}\n\n/**\n * Class definition\n */\n\nclass Carousel extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._interval = null\n this._activeElement = null\n this._isSliding = false\n this.touchTimeout = null\n this._swipeHelper = null\n\n this._indicatorsElement = SelectorEngine.findOne(SELECTOR_INDICATORS, this._element)\n this._addEventListeners()\n\n if (this._config.ride === CLASS_NAME_CAROUSEL) {\n this.cycle()\n }\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n next() {\n this._slide(ORDER_NEXT)\n }\n\n nextWhenVisible() {\n // FIXME TODO use `document.visibilityState`\n // Don't call next when the page isn't visible\n // or the carousel or its parent isn't visible\n if (!document.hidden && isVisible(this._element)) {\n this.next()\n }\n }\n\n prev() {\n this._slide(ORDER_PREV)\n }\n\n pause() {\n if (this._isSliding) {\n triggerTransitionEnd(this._element)\n }\n\n this._clearInterval()\n }\n\n cycle() {\n this._clearInterval()\n this._updateInterval()\n\n this._interval = setInterval(() => this.nextWhenVisible(), this._config.interval)\n }\n\n _maybeEnableCycle() {\n if (!this._config.ride) {\n return\n }\n\n if (this._isSliding) {\n EventHandler.one(this._element, EVENT_SLID, () => this.cycle())\n return\n }\n\n this.cycle()\n }\n\n to(index) {\n const items = this._getItems()\n if (index > items.length - 1 || index < 0) {\n return\n }\n\n if (this._isSliding) {\n EventHandler.one(this._element, EVENT_SLID, () => this.to(index))\n return\n }\n\n const activeIndex = this._getItemIndex(this._getActive())\n if (activeIndex === index) {\n return\n }\n\n const order = index > activeIndex ? ORDER_NEXT : ORDER_PREV\n\n this._slide(order, items[index])\n }\n\n dispose() {\n if (this._swipeHelper) {\n this._swipeHelper.dispose()\n }\n\n super.dispose()\n }\n\n // Private\n _configAfterMerge(config) {\n config.defaultInterval = config.interval\n return config\n }\n\n _addEventListeners() {\n if (this._config.keyboard) {\n EventHandler.on(this._element, EVENT_KEYDOWN, event => this._keydown(event))\n }\n\n if (this._config.pause === 'hover') {\n EventHandler.on(this._element, EVENT_MOUSEENTER, () => this.pause())\n EventHandler.on(this._element, EVENT_MOUSELEAVE, () => this._maybeEnableCycle())\n }\n\n if (this._config.touch && Swipe.isSupported()) {\n this._addTouchEventListeners()\n }\n }\n\n _addTouchEventListeners() {\n for (const img of SelectorEngine.find(SELECTOR_ITEM_IMG, this._element)) {\n EventHandler.on(img, EVENT_DRAG_START, event => event.preventDefault())\n }\n\n const endCallBack = () => {\n if (this._config.pause !== 'hover') {\n return\n }\n\n // If it's a touch-enabled device, mouseenter/leave are fired as\n // part of the mouse compatibility events on first tap - the carousel\n // would stop cycling until user tapped out of it;\n // here, we listen for touchend, explicitly pause the carousel\n // (as if it's the second time we tap on it, mouseenter compat event\n // is NOT fired) and after a timeout (to allow for mouse compatibility\n // events to fire) we explicitly restart cycling\n\n this.pause()\n if (this.touchTimeout) {\n clearTimeout(this.touchTimeout)\n }\n\n this.touchTimeout = setTimeout(() => this._maybeEnableCycle(), TOUCHEVENT_COMPAT_WAIT + this._config.interval)\n }\n\n const swipeConfig = {\n leftCallback: () => this._slide(this._directionToOrder(DIRECTION_LEFT)),\n rightCallback: () => this._slide(this._directionToOrder(DIRECTION_RIGHT)),\n endCallback: endCallBack\n }\n\n this._swipeHelper = new Swipe(this._element, swipeConfig)\n }\n\n _keydown(event) {\n if (/input|textarea/i.test(event.target.tagName)) {\n return\n }\n\n const direction = KEY_TO_DIRECTION[event.key]\n if (direction) {\n event.preventDefault()\n this._slide(this._directionToOrder(direction))\n }\n }\n\n _getItemIndex(element) {\n return this._getItems().indexOf(element)\n }\n\n _setActiveIndicatorElement(index) {\n if (!this._indicatorsElement) {\n return\n }\n\n const activeIndicator = SelectorEngine.findOne(SELECTOR_ACTIVE, this._indicatorsElement)\n\n activeIndicator.classList.remove(CLASS_NAME_ACTIVE)\n activeIndicator.removeAttribute('aria-current')\n\n const newActiveIndicator = SelectorEngine.findOne(`[data-bs-slide-to=\"${index}\"]`, this._indicatorsElement)\n\n if (newActiveIndicator) {\n newActiveIndicator.classList.add(CLASS_NAME_ACTIVE)\n newActiveIndicator.setAttribute('aria-current', 'true')\n }\n }\n\n _updateInterval() {\n const element = this._activeElement || this._getActive()\n\n if (!element) {\n return\n }\n\n const elementInterval = Number.parseInt(element.getAttribute('data-bs-interval'), 10)\n\n this._config.interval = elementInterval || this._config.defaultInterval\n }\n\n _slide(order, element = null) {\n if (this._isSliding) {\n return\n }\n\n const activeElement = this._getActive()\n const isNext = order === ORDER_NEXT\n const nextElement = element || getNextActiveElement(this._getItems(), activeElement, isNext, this._config.wrap)\n\n if (nextElement === activeElement) {\n return\n }\n\n const nextElementIndex = this._getItemIndex(nextElement)\n\n const triggerEvent = eventName => {\n return EventHandler.trigger(this._element, eventName, {\n relatedTarget: nextElement,\n direction: this._orderToDirection(order),\n from: this._getItemIndex(activeElement),\n to: nextElementIndex\n })\n }\n\n const slideEvent = triggerEvent(EVENT_SLIDE)\n\n if (slideEvent.defaultPrevented) {\n return\n }\n\n if (!activeElement || !nextElement) {\n // Some weirdness is happening, so we bail\n // TODO: change tests that use empty divs to avoid this check\n return\n }\n\n const isCycling = Boolean(this._interval)\n this.pause()\n\n this._isSliding = true\n\n this._setActiveIndicatorElement(nextElementIndex)\n this._activeElement = nextElement\n\n const directionalClassName = isNext ? CLASS_NAME_START : CLASS_NAME_END\n const orderClassName = isNext ? CLASS_NAME_NEXT : CLASS_NAME_PREV\n\n nextElement.classList.add(orderClassName)\n\n reflow(nextElement)\n\n activeElement.classList.add(directionalClassName)\n nextElement.classList.add(directionalClassName)\n\n const completeCallBack = () => {\n nextElement.classList.remove(directionalClassName, orderClassName)\n nextElement.classList.add(CLASS_NAME_ACTIVE)\n\n activeElement.classList.remove(CLASS_NAME_ACTIVE, orderClassName, directionalClassName)\n\n this._isSliding = false\n\n triggerEvent(EVENT_SLID)\n }\n\n this._queueCallback(completeCallBack, activeElement, this._isAnimated())\n\n if (isCycling) {\n this.cycle()\n }\n }\n\n _isAnimated() {\n return this._element.classList.contains(CLASS_NAME_SLIDE)\n }\n\n _getActive() {\n return SelectorEngine.findOne(SELECTOR_ACTIVE_ITEM, this._element)\n }\n\n _getItems() {\n return SelectorEngine.find(SELECTOR_ITEM, this._element)\n }\n\n _clearInterval() {\n if (this._interval) {\n clearInterval(this._interval)\n this._interval = null\n }\n }\n\n _directionToOrder(direction) {\n if (isRTL()) {\n return direction === DIRECTION_LEFT ? ORDER_PREV : ORDER_NEXT\n }\n\n return direction === DIRECTION_LEFT ? ORDER_NEXT : ORDER_PREV\n }\n\n _orderToDirection(order) {\n if (isRTL()) {\n return order === ORDER_PREV ? DIRECTION_LEFT : DIRECTION_RIGHT\n }\n\n return order === ORDER_PREV ? DIRECTION_RIGHT : DIRECTION_LEFT\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Carousel.getOrCreateInstance(this, config)\n\n if (typeof config === 'number') {\n data.to(config)\n return\n }\n\n if (typeof config === 'string') {\n if (data[config] === undefined || config.startsWith('_') || config === 'constructor') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n }\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_SLIDE, function (event) {\n const target = SelectorEngine.getElementFromSelector(this)\n\n if (!target || !target.classList.contains(CLASS_NAME_CAROUSEL)) {\n return\n }\n\n event.preventDefault()\n\n const carousel = Carousel.getOrCreateInstance(target)\n const slideIndex = this.getAttribute('data-bs-slide-to')\n\n if (slideIndex) {\n carousel.to(slideIndex)\n carousel._maybeEnableCycle()\n return\n }\n\n if (Manipulator.getDataAttribute(this, 'slide') === 'next') {\n carousel.next()\n carousel._maybeEnableCycle()\n return\n }\n\n carousel.prev()\n carousel._maybeEnableCycle()\n})\n\nEventHandler.on(window, EVENT_LOAD_DATA_API, () => {\n const carousels = SelectorEngine.find(SELECTOR_DATA_RIDE)\n\n for (const carousel of carousels) {\n Carousel.getOrCreateInstance(carousel)\n }\n})\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Carousel)\n\nexport default Carousel\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap collapse.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport {\n defineJQueryPlugin,\n getElement,\n reflow\n} from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'collapse'\nconst DATA_KEY = 'bs.collapse'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\n\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_NAME_COLLAPSE = 'collapse'\nconst CLASS_NAME_COLLAPSING = 'collapsing'\nconst CLASS_NAME_COLLAPSED = 'collapsed'\nconst CLASS_NAME_DEEPER_CHILDREN = `:scope .${CLASS_NAME_COLLAPSE} .${CLASS_NAME_COLLAPSE}`\nconst CLASS_NAME_HORIZONTAL = 'collapse-horizontal'\n\nconst WIDTH = 'width'\nconst HEIGHT = 'height'\n\nconst SELECTOR_ACTIVES = '.collapse.show, .collapse.collapsing'\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"collapse\"]'\n\nconst Default = {\n parent: null,\n toggle: true\n}\n\nconst DefaultType = {\n parent: '(null|element)',\n toggle: 'boolean'\n}\n\n/**\n * Class definition\n */\n\nclass Collapse extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._isTransitioning = false\n this._triggerArray = []\n\n const toggleList = SelectorEngine.find(SELECTOR_DATA_TOGGLE)\n\n for (const elem of toggleList) {\n const selector = SelectorEngine.getSelectorFromElement(elem)\n const filterElement = SelectorEngine.find(selector)\n .filter(foundElement => foundElement === this._element)\n\n if (selector !== null && filterElement.length) {\n this._triggerArray.push(elem)\n }\n }\n\n this._initializeChildren()\n\n if (!this._config.parent) {\n this._addAriaAndCollapsedClass(this._triggerArray, this._isShown())\n }\n\n if (this._config.toggle) {\n this.toggle()\n }\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle() {\n if (this._isShown()) {\n this.hide()\n } else {\n this.show()\n }\n }\n\n show() {\n if (this._isTransitioning || this._isShown()) {\n return\n }\n\n let activeChildren = []\n\n // find active children\n if (this._config.parent) {\n activeChildren = this._getFirstLevelChildren(SELECTOR_ACTIVES)\n .filter(element => element !== this._element)\n .map(element => Collapse.getOrCreateInstance(element, { toggle: false }))\n }\n\n if (activeChildren.length && activeChildren[0]._isTransitioning) {\n return\n }\n\n const startEvent = EventHandler.trigger(this._element, EVENT_SHOW)\n if (startEvent.defaultPrevented) {\n return\n }\n\n for (const activeInstance of activeChildren) {\n activeInstance.hide()\n }\n\n const dimension = this._getDimension()\n\n this._element.classList.remove(CLASS_NAME_COLLAPSE)\n this._element.classList.add(CLASS_NAME_COLLAPSING)\n\n this._element.style[dimension] = 0\n\n this._addAriaAndCollapsedClass(this._triggerArray, true)\n this._isTransitioning = true\n\n const complete = () => {\n this._isTransitioning = false\n\n this._element.classList.remove(CLASS_NAME_COLLAPSING)\n this._element.classList.add(CLASS_NAME_COLLAPSE, CLASS_NAME_SHOW)\n\n this._element.style[dimension] = ''\n\n EventHandler.trigger(this._element, EVENT_SHOWN)\n }\n\n const capitalizedDimension = dimension[0].toUpperCase() + dimension.slice(1)\n const scrollSize = `scroll${capitalizedDimension}`\n\n this._queueCallback(complete, this._element, true)\n this._element.style[dimension] = `${this._element[scrollSize]}px`\n }\n\n hide() {\n if (this._isTransitioning || !this._isShown()) {\n return\n }\n\n const startEvent = EventHandler.trigger(this._element, EVENT_HIDE)\n if (startEvent.defaultPrevented) {\n return\n }\n\n const dimension = this._getDimension()\n\n this._element.style[dimension] = `${this._element.getBoundingClientRect()[dimension]}px`\n\n reflow(this._element)\n\n this._element.classList.add(CLASS_NAME_COLLAPSING)\n this._element.classList.remove(CLASS_NAME_COLLAPSE, CLASS_NAME_SHOW)\n\n for (const trigger of this._triggerArray) {\n const element = SelectorEngine.getElementFromSelector(trigger)\n\n if (element && !this._isShown(element)) {\n this._addAriaAndCollapsedClass([trigger], false)\n }\n }\n\n this._isTransitioning = true\n\n const complete = () => {\n this._isTransitioning = false\n this._element.classList.remove(CLASS_NAME_COLLAPSING)\n this._element.classList.add(CLASS_NAME_COLLAPSE)\n EventHandler.trigger(this._element, EVENT_HIDDEN)\n }\n\n this._element.style[dimension] = ''\n\n this._queueCallback(complete, this._element, true)\n }\n\n // Private\n _isShown(element = this._element) {\n return element.classList.contains(CLASS_NAME_SHOW)\n }\n\n _configAfterMerge(config) {\n config.toggle = Boolean(config.toggle) // Coerce string values\n config.parent = getElement(config.parent)\n return config\n }\n\n _getDimension() {\n return this._element.classList.contains(CLASS_NAME_HORIZONTAL) ? WIDTH : HEIGHT\n }\n\n _initializeChildren() {\n if (!this._config.parent) {\n return\n }\n\n const children = this._getFirstLevelChildren(SELECTOR_DATA_TOGGLE)\n\n for (const element of children) {\n const selected = SelectorEngine.getElementFromSelector(element)\n\n if (selected) {\n this._addAriaAndCollapsedClass([element], this._isShown(selected))\n }\n }\n }\n\n _getFirstLevelChildren(selector) {\n const children = SelectorEngine.find(CLASS_NAME_DEEPER_CHILDREN, this._config.parent)\n // remove children if greater depth\n return SelectorEngine.find(selector, this._config.parent).filter(element => !children.includes(element))\n }\n\n _addAriaAndCollapsedClass(triggerArray, isOpen) {\n if (!triggerArray.length) {\n return\n }\n\n for (const element of triggerArray) {\n element.classList.toggle(CLASS_NAME_COLLAPSED, !isOpen)\n element.setAttribute('aria-expanded', isOpen)\n }\n }\n\n // Static\n static jQueryInterface(config) {\n const _config = {}\n if (typeof config === 'string' && /show|hide/.test(config)) {\n _config.toggle = false\n }\n\n return this.each(function () {\n const data = Collapse.getOrCreateInstance(this, _config)\n\n if (typeof config === 'string') {\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n }\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n // preventDefault only for elements (which change the URL) not inside the collapsible element\n if (event.target.tagName === 'A' || (event.delegateTarget && event.delegateTarget.tagName === 'A')) {\n event.preventDefault()\n }\n\n for (const element of SelectorEngine.getMultipleElementsFromSelector(this)) {\n Collapse.getOrCreateInstance(element, { toggle: false }).toggle()\n }\n})\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Collapse)\n\nexport default Collapse\n","export var top = 'top';\nexport var bottom = 'bottom';\nexport var right = 'right';\nexport var left = 'left';\nexport var auto = 'auto';\nexport var basePlacements = [top, bottom, right, left];\nexport var start = 'start';\nexport var end = 'end';\nexport var clippingParents = 'clippingParents';\nexport var viewport = 'viewport';\nexport var popper = 'popper';\nexport var reference = 'reference';\nexport var variationPlacements = /*#__PURE__*/basePlacements.reduce(function (acc, placement) {\n return acc.concat([placement + \"-\" + start, placement + \"-\" + end]);\n}, []);\nexport var placements = /*#__PURE__*/[].concat(basePlacements, [auto]).reduce(function (acc, placement) {\n return acc.concat([placement, placement + \"-\" + start, placement + \"-\" + end]);\n}, []); // modifiers that need to read the DOM\n\nexport var beforeRead = 'beforeRead';\nexport var read = 'read';\nexport var afterRead = 'afterRead'; // pure-logic modifiers\n\nexport var beforeMain = 'beforeMain';\nexport var main = 'main';\nexport var afterMain = 'afterMain'; // modifier with the purpose to write to the DOM (or write into a framework state)\n\nexport var beforeWrite = 'beforeWrite';\nexport var write = 'write';\nexport var afterWrite = 'afterWrite';\nexport var modifierPhases = [beforeRead, read, afterRead, beforeMain, main, afterMain, beforeWrite, write, afterWrite];","export default function getNodeName(element) {\n return element ? (element.nodeName || '').toLowerCase() : null;\n}","export default function getWindow(node) {\n if (node == null) {\n return window;\n }\n\n if (node.toString() !== '[object Window]') {\n var ownerDocument = node.ownerDocument;\n return ownerDocument ? ownerDocument.defaultView || window : window;\n }\n\n return node;\n}","import getWindow from \"./getWindow.js\";\n\nfunction isElement(node) {\n var OwnElement = getWindow(node).Element;\n return node instanceof OwnElement || node instanceof Element;\n}\n\nfunction isHTMLElement(node) {\n var OwnElement = getWindow(node).HTMLElement;\n return node instanceof OwnElement || node instanceof HTMLElement;\n}\n\nfunction isShadowRoot(node) {\n // IE 11 has no ShadowRoot\n if (typeof ShadowRoot === 'undefined') {\n return false;\n }\n\n var OwnElement = getWindow(node).ShadowRoot;\n return node instanceof OwnElement || node instanceof ShadowRoot;\n}\n\nexport { isElement, isHTMLElement, isShadowRoot };","import getNodeName from \"../dom-utils/getNodeName.js\";\nimport { isHTMLElement } from \"../dom-utils/instanceOf.js\"; // This modifier takes the styles prepared by the `computeStyles` modifier\n// and applies them to the HTMLElements such as popper and arrow\n\nfunction applyStyles(_ref) {\n var state = _ref.state;\n Object.keys(state.elements).forEach(function (name) {\n var style = state.styles[name] || {};\n var attributes = state.attributes[name] || {};\n var element = state.elements[name]; // arrow is optional + virtual elements\n\n if (!isHTMLElement(element) || !getNodeName(element)) {\n return;\n } // Flow doesn't support to extend this property, but it's the most\n // effective way to apply styles to an HTMLElement\n // $FlowFixMe[cannot-write]\n\n\n Object.assign(element.style, style);\n Object.keys(attributes).forEach(function (name) {\n var value = attributes[name];\n\n if (value === false) {\n element.removeAttribute(name);\n } else {\n element.setAttribute(name, value === true ? '' : value);\n }\n });\n });\n}\n\nfunction effect(_ref2) {\n var state = _ref2.state;\n var initialStyles = {\n popper: {\n position: state.options.strategy,\n left: '0',\n top: '0',\n margin: '0'\n },\n arrow: {\n position: 'absolute'\n },\n reference: {}\n };\n Object.assign(state.elements.popper.style, initialStyles.popper);\n state.styles = initialStyles;\n\n if (state.elements.arrow) {\n Object.assign(state.elements.arrow.style, initialStyles.arrow);\n }\n\n return function () {\n Object.keys(state.elements).forEach(function (name) {\n var element = state.elements[name];\n var attributes = state.attributes[name] || {};\n var styleProperties = Object.keys(state.styles.hasOwnProperty(name) ? state.styles[name] : initialStyles[name]); // Set all values to an empty string to unset them\n\n var style = styleProperties.reduce(function (style, property) {\n style[property] = '';\n return style;\n }, {}); // arrow is optional + virtual elements\n\n if (!isHTMLElement(element) || !getNodeName(element)) {\n return;\n }\n\n Object.assign(element.style, style);\n Object.keys(attributes).forEach(function (attribute) {\n element.removeAttribute(attribute);\n });\n });\n };\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'applyStyles',\n enabled: true,\n phase: 'write',\n fn: applyStyles,\n effect: effect,\n requires: ['computeStyles']\n};","import { auto } from \"../enums.js\";\nexport default function getBasePlacement(placement) {\n return placement.split('-')[0];\n}","export var max = Math.max;\nexport var min = Math.min;\nexport var round = Math.round;","export default function getUAString() {\n var uaData = navigator.userAgentData;\n\n if (uaData != null && uaData.brands && Array.isArray(uaData.brands)) {\n return uaData.brands.map(function (item) {\n return item.brand + \"/\" + item.version;\n }).join(' ');\n }\n\n return navigator.userAgent;\n}","import getUAString from \"../utils/userAgent.js\";\nexport default function isLayoutViewport() {\n return !/^((?!chrome|android).)*safari/i.test(getUAString());\n}","import { isElement, isHTMLElement } from \"./instanceOf.js\";\nimport { round } from \"../utils/math.js\";\nimport getWindow from \"./getWindow.js\";\nimport isLayoutViewport from \"./isLayoutViewport.js\";\nexport default function getBoundingClientRect(element, includeScale, isFixedStrategy) {\n if (includeScale === void 0) {\n includeScale = false;\n }\n\n if (isFixedStrategy === void 0) {\n isFixedStrategy = false;\n }\n\n var clientRect = element.getBoundingClientRect();\n var scaleX = 1;\n var scaleY = 1;\n\n if (includeScale && isHTMLElement(element)) {\n scaleX = element.offsetWidth > 0 ? round(clientRect.width) / element.offsetWidth || 1 : 1;\n scaleY = element.offsetHeight > 0 ? round(clientRect.height) / element.offsetHeight || 1 : 1;\n }\n\n var _ref = isElement(element) ? getWindow(element) : window,\n visualViewport = _ref.visualViewport;\n\n var addVisualOffsets = !isLayoutViewport() && isFixedStrategy;\n var x = (clientRect.left + (addVisualOffsets && visualViewport ? visualViewport.offsetLeft : 0)) / scaleX;\n var y = (clientRect.top + (addVisualOffsets && visualViewport ? visualViewport.offsetTop : 0)) / scaleY;\n var width = clientRect.width / scaleX;\n var height = clientRect.height / scaleY;\n return {\n width: width,\n height: height,\n top: y,\n right: x + width,\n bottom: y + height,\n left: x,\n x: x,\n y: y\n };\n}","import getBoundingClientRect from \"./getBoundingClientRect.js\"; // Returns the layout rect of an element relative to its offsetParent. Layout\n// means it doesn't take into account transforms.\n\nexport default function getLayoutRect(element) {\n var clientRect = getBoundingClientRect(element); // Use the clientRect sizes if it's not been transformed.\n // Fixes https://github.com/popperjs/popper-core/issues/1223\n\n var width = element.offsetWidth;\n var height = element.offsetHeight;\n\n if (Math.abs(clientRect.width - width) <= 1) {\n width = clientRect.width;\n }\n\n if (Math.abs(clientRect.height - height) <= 1) {\n height = clientRect.height;\n }\n\n return {\n x: element.offsetLeft,\n y: element.offsetTop,\n width: width,\n height: height\n };\n}","import { isShadowRoot } from \"./instanceOf.js\";\nexport default function contains(parent, child) {\n var rootNode = child.getRootNode && child.getRootNode(); // First, attempt with faster native method\n\n if (parent.contains(child)) {\n return true;\n } // then fallback to custom implementation with Shadow DOM support\n else if (rootNode && isShadowRoot(rootNode)) {\n var next = child;\n\n do {\n if (next && parent.isSameNode(next)) {\n return true;\n } // $FlowFixMe[prop-missing]: need a better way to handle this...\n\n\n next = next.parentNode || next.host;\n } while (next);\n } // Give up, the result is false\n\n\n return false;\n}","import getWindow from \"./getWindow.js\";\nexport default function getComputedStyle(element) {\n return getWindow(element).getComputedStyle(element);\n}","import getNodeName from \"./getNodeName.js\";\nexport default function isTableElement(element) {\n return ['table', 'td', 'th'].indexOf(getNodeName(element)) >= 0;\n}","import { isElement } from \"./instanceOf.js\";\nexport default function getDocumentElement(element) {\n // $FlowFixMe[incompatible-return]: assume body is always available\n return ((isElement(element) ? element.ownerDocument : // $FlowFixMe[prop-missing]\n element.document) || window.document).documentElement;\n}","import getNodeName from \"./getNodeName.js\";\nimport getDocumentElement from \"./getDocumentElement.js\";\nimport { isShadowRoot } from \"./instanceOf.js\";\nexport default function getParentNode(element) {\n if (getNodeName(element) === 'html') {\n return element;\n }\n\n return (// this is a quicker (but less type safe) way to save quite some bytes from the bundle\n // $FlowFixMe[incompatible-return]\n // $FlowFixMe[prop-missing]\n element.assignedSlot || // step into the shadow DOM of the parent of a slotted node\n element.parentNode || ( // DOM Element detected\n isShadowRoot(element) ? element.host : null) || // ShadowRoot detected\n // $FlowFixMe[incompatible-call]: HTMLElement is a Node\n getDocumentElement(element) // fallback\n\n );\n}","import getWindow from \"./getWindow.js\";\nimport getNodeName from \"./getNodeName.js\";\nimport getComputedStyle from \"./getComputedStyle.js\";\nimport { isHTMLElement, isShadowRoot } from \"./instanceOf.js\";\nimport isTableElement from \"./isTableElement.js\";\nimport getParentNode from \"./getParentNode.js\";\nimport getUAString from \"../utils/userAgent.js\";\n\nfunction getTrueOffsetParent(element) {\n if (!isHTMLElement(element) || // https://github.com/popperjs/popper-core/issues/837\n getComputedStyle(element).position === 'fixed') {\n return null;\n }\n\n return element.offsetParent;\n} // `.offsetParent` reports `null` for fixed elements, while absolute elements\n// return the containing block\n\n\nfunction getContainingBlock(element) {\n var isFirefox = /firefox/i.test(getUAString());\n var isIE = /Trident/i.test(getUAString());\n\n if (isIE && isHTMLElement(element)) {\n // In IE 9, 10 and 11 fixed elements containing block is always established by the viewport\n var elementCss = getComputedStyle(element);\n\n if (elementCss.position === 'fixed') {\n return null;\n }\n }\n\n var currentNode = getParentNode(element);\n\n if (isShadowRoot(currentNode)) {\n currentNode = currentNode.host;\n }\n\n while (isHTMLElement(currentNode) && ['html', 'body'].indexOf(getNodeName(currentNode)) < 0) {\n var css = getComputedStyle(currentNode); // This is non-exhaustive but covers the most common CSS properties that\n // create a containing block.\n // https://developer.mozilla.org/en-US/docs/Web/CSS/Containing_block#identifying_the_containing_block\n\n if (css.transform !== 'none' || css.perspective !== 'none' || css.contain === 'paint' || ['transform', 'perspective'].indexOf(css.willChange) !== -1 || isFirefox && css.willChange === 'filter' || isFirefox && css.filter && css.filter !== 'none') {\n return currentNode;\n } else {\n currentNode = currentNode.parentNode;\n }\n }\n\n return null;\n} // Gets the closest ancestor positioned element. Handles some edge cases,\n// such as table ancestors and cross browser bugs.\n\n\nexport default function getOffsetParent(element) {\n var window = getWindow(element);\n var offsetParent = getTrueOffsetParent(element);\n\n while (offsetParent && isTableElement(offsetParent) && getComputedStyle(offsetParent).position === 'static') {\n offsetParent = getTrueOffsetParent(offsetParent);\n }\n\n if (offsetParent && (getNodeName(offsetParent) === 'html' || getNodeName(offsetParent) === 'body' && getComputedStyle(offsetParent).position === 'static')) {\n return window;\n }\n\n return offsetParent || getContainingBlock(element) || window;\n}","export default function getMainAxisFromPlacement(placement) {\n return ['top', 'bottom'].indexOf(placement) >= 0 ? 'x' : 'y';\n}","import { max as mathMax, min as mathMin } from \"./math.js\";\nexport function within(min, value, max) {\n return mathMax(min, mathMin(value, max));\n}\nexport function withinMaxClamp(min, value, max) {\n var v = within(min, value, max);\n return v > max ? max : v;\n}","import getFreshSideObject from \"./getFreshSideObject.js\";\nexport default function mergePaddingObject(paddingObject) {\n return Object.assign({}, getFreshSideObject(), paddingObject);\n}","export default function getFreshSideObject() {\n return {\n top: 0,\n right: 0,\n bottom: 0,\n left: 0\n };\n}","export default function expandToHashMap(value, keys) {\n return keys.reduce(function (hashMap, key) {\n hashMap[key] = value;\n return hashMap;\n }, {});\n}","import getBasePlacement from \"../utils/getBasePlacement.js\";\nimport getLayoutRect from \"../dom-utils/getLayoutRect.js\";\nimport contains from \"../dom-utils/contains.js\";\nimport getOffsetParent from \"../dom-utils/getOffsetParent.js\";\nimport getMainAxisFromPlacement from \"../utils/getMainAxisFromPlacement.js\";\nimport { within } from \"../utils/within.js\";\nimport mergePaddingObject from \"../utils/mergePaddingObject.js\";\nimport expandToHashMap from \"../utils/expandToHashMap.js\";\nimport { left, right, basePlacements, top, bottom } from \"../enums.js\"; // eslint-disable-next-line import/no-unused-modules\n\nvar toPaddingObject = function toPaddingObject(padding, state) {\n padding = typeof padding === 'function' ? padding(Object.assign({}, state.rects, {\n placement: state.placement\n })) : padding;\n return mergePaddingObject(typeof padding !== 'number' ? padding : expandToHashMap(padding, basePlacements));\n};\n\nfunction arrow(_ref) {\n var _state$modifiersData$;\n\n var state = _ref.state,\n name = _ref.name,\n options = _ref.options;\n var arrowElement = state.elements.arrow;\n var popperOffsets = state.modifiersData.popperOffsets;\n var basePlacement = getBasePlacement(state.placement);\n var axis = getMainAxisFromPlacement(basePlacement);\n var isVertical = [left, right].indexOf(basePlacement) >= 0;\n var len = isVertical ? 'height' : 'width';\n\n if (!arrowElement || !popperOffsets) {\n return;\n }\n\n var paddingObject = toPaddingObject(options.padding, state);\n var arrowRect = getLayoutRect(arrowElement);\n var minProp = axis === 'y' ? top : left;\n var maxProp = axis === 'y' ? bottom : right;\n var endDiff = state.rects.reference[len] + state.rects.reference[axis] - popperOffsets[axis] - state.rects.popper[len];\n var startDiff = popperOffsets[axis] - state.rects.reference[axis];\n var arrowOffsetParent = getOffsetParent(arrowElement);\n var clientSize = arrowOffsetParent ? axis === 'y' ? arrowOffsetParent.clientHeight || 0 : arrowOffsetParent.clientWidth || 0 : 0;\n var centerToReference = endDiff / 2 - startDiff / 2; // Make sure the arrow doesn't overflow the popper if the center point is\n // outside of the popper bounds\n\n var min = paddingObject[minProp];\n var max = clientSize - arrowRect[len] - paddingObject[maxProp];\n var center = clientSize / 2 - arrowRect[len] / 2 + centerToReference;\n var offset = within(min, center, max); // Prevents breaking syntax highlighting...\n\n var axisProp = axis;\n state.modifiersData[name] = (_state$modifiersData$ = {}, _state$modifiersData$[axisProp] = offset, _state$modifiersData$.centerOffset = offset - center, _state$modifiersData$);\n}\n\nfunction effect(_ref2) {\n var state = _ref2.state,\n options = _ref2.options;\n var _options$element = options.element,\n arrowElement = _options$element === void 0 ? '[data-popper-arrow]' : _options$element;\n\n if (arrowElement == null) {\n return;\n } // CSS selector\n\n\n if (typeof arrowElement === 'string') {\n arrowElement = state.elements.popper.querySelector(arrowElement);\n\n if (!arrowElement) {\n return;\n }\n }\n\n if (!contains(state.elements.popper, arrowElement)) {\n return;\n }\n\n state.elements.arrow = arrowElement;\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'arrow',\n enabled: true,\n phase: 'main',\n fn: arrow,\n effect: effect,\n requires: ['popperOffsets'],\n requiresIfExists: ['preventOverflow']\n};","export default function getVariation(placement) {\n return placement.split('-')[1];\n}","import { top, left, right, bottom, end } from \"../enums.js\";\nimport getOffsetParent from \"../dom-utils/getOffsetParent.js\";\nimport getWindow from \"../dom-utils/getWindow.js\";\nimport getDocumentElement from \"../dom-utils/getDocumentElement.js\";\nimport getComputedStyle from \"../dom-utils/getComputedStyle.js\";\nimport getBasePlacement from \"../utils/getBasePlacement.js\";\nimport getVariation from \"../utils/getVariation.js\";\nimport { round } from \"../utils/math.js\"; // eslint-disable-next-line import/no-unused-modules\n\nvar unsetSides = {\n top: 'auto',\n right: 'auto',\n bottom: 'auto',\n left: 'auto'\n}; // Round the offsets to the nearest suitable subpixel based on the DPR.\n// Zooming can change the DPR, but it seems to report a value that will\n// cleanly divide the values into the appropriate subpixels.\n\nfunction roundOffsetsByDPR(_ref, win) {\n var x = _ref.x,\n y = _ref.y;\n var dpr = win.devicePixelRatio || 1;\n return {\n x: round(x * dpr) / dpr || 0,\n y: round(y * dpr) / dpr || 0\n };\n}\n\nexport function mapToStyles(_ref2) {\n var _Object$assign2;\n\n var popper = _ref2.popper,\n popperRect = _ref2.popperRect,\n placement = _ref2.placement,\n variation = _ref2.variation,\n offsets = _ref2.offsets,\n position = _ref2.position,\n gpuAcceleration = _ref2.gpuAcceleration,\n adaptive = _ref2.adaptive,\n roundOffsets = _ref2.roundOffsets,\n isFixed = _ref2.isFixed;\n var _offsets$x = offsets.x,\n x = _offsets$x === void 0 ? 0 : _offsets$x,\n _offsets$y = offsets.y,\n y = _offsets$y === void 0 ? 0 : _offsets$y;\n\n var _ref3 = typeof roundOffsets === 'function' ? roundOffsets({\n x: x,\n y: y\n }) : {\n x: x,\n y: y\n };\n\n x = _ref3.x;\n y = _ref3.y;\n var hasX = offsets.hasOwnProperty('x');\n var hasY = offsets.hasOwnProperty('y');\n var sideX = left;\n var sideY = top;\n var win = window;\n\n if (adaptive) {\n var offsetParent = getOffsetParent(popper);\n var heightProp = 'clientHeight';\n var widthProp = 'clientWidth';\n\n if (offsetParent === getWindow(popper)) {\n offsetParent = getDocumentElement(popper);\n\n if (getComputedStyle(offsetParent).position !== 'static' && position === 'absolute') {\n heightProp = 'scrollHeight';\n widthProp = 'scrollWidth';\n }\n } // $FlowFixMe[incompatible-cast]: force type refinement, we compare offsetParent with window above, but Flow doesn't detect it\n\n\n offsetParent = offsetParent;\n\n if (placement === top || (placement === left || placement === right) && variation === end) {\n sideY = bottom;\n var offsetY = isFixed && offsetParent === win && win.visualViewport ? win.visualViewport.height : // $FlowFixMe[prop-missing]\n offsetParent[heightProp];\n y -= offsetY - popperRect.height;\n y *= gpuAcceleration ? 1 : -1;\n }\n\n if (placement === left || (placement === top || placement === bottom) && variation === end) {\n sideX = right;\n var offsetX = isFixed && offsetParent === win && win.visualViewport ? win.visualViewport.width : // $FlowFixMe[prop-missing]\n offsetParent[widthProp];\n x -= offsetX - popperRect.width;\n x *= gpuAcceleration ? 1 : -1;\n }\n }\n\n var commonStyles = Object.assign({\n position: position\n }, adaptive && unsetSides);\n\n var _ref4 = roundOffsets === true ? roundOffsetsByDPR({\n x: x,\n y: y\n }, getWindow(popper)) : {\n x: x,\n y: y\n };\n\n x = _ref4.x;\n y = _ref4.y;\n\n if (gpuAcceleration) {\n var _Object$assign;\n\n return Object.assign({}, commonStyles, (_Object$assign = {}, _Object$assign[sideY] = hasY ? '0' : '', _Object$assign[sideX] = hasX ? '0' : '', _Object$assign.transform = (win.devicePixelRatio || 1) <= 1 ? \"translate(\" + x + \"px, \" + y + \"px)\" : \"translate3d(\" + x + \"px, \" + y + \"px, 0)\", _Object$assign));\n }\n\n return Object.assign({}, commonStyles, (_Object$assign2 = {}, _Object$assign2[sideY] = hasY ? y + \"px\" : '', _Object$assign2[sideX] = hasX ? x + \"px\" : '', _Object$assign2.transform = '', _Object$assign2));\n}\n\nfunction computeStyles(_ref5) {\n var state = _ref5.state,\n options = _ref5.options;\n var _options$gpuAccelerat = options.gpuAcceleration,\n gpuAcceleration = _options$gpuAccelerat === void 0 ? true : _options$gpuAccelerat,\n _options$adaptive = options.adaptive,\n adaptive = _options$adaptive === void 0 ? true : _options$adaptive,\n _options$roundOffsets = options.roundOffsets,\n roundOffsets = _options$roundOffsets === void 0 ? true : _options$roundOffsets;\n var commonStyles = {\n placement: getBasePlacement(state.placement),\n variation: getVariation(state.placement),\n popper: state.elements.popper,\n popperRect: state.rects.popper,\n gpuAcceleration: gpuAcceleration,\n isFixed: state.options.strategy === 'fixed'\n };\n\n if (state.modifiersData.popperOffsets != null) {\n state.styles.popper = Object.assign({}, state.styles.popper, mapToStyles(Object.assign({}, commonStyles, {\n offsets: state.modifiersData.popperOffsets,\n position: state.options.strategy,\n adaptive: adaptive,\n roundOffsets: roundOffsets\n })));\n }\n\n if (state.modifiersData.arrow != null) {\n state.styles.arrow = Object.assign({}, state.styles.arrow, mapToStyles(Object.assign({}, commonStyles, {\n offsets: state.modifiersData.arrow,\n position: 'absolute',\n adaptive: false,\n roundOffsets: roundOffsets\n })));\n }\n\n state.attributes.popper = Object.assign({}, state.attributes.popper, {\n 'data-popper-placement': state.placement\n });\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'computeStyles',\n enabled: true,\n phase: 'beforeWrite',\n fn: computeStyles,\n data: {}\n};","import getWindow from \"../dom-utils/getWindow.js\"; // eslint-disable-next-line import/no-unused-modules\n\nvar passive = {\n passive: true\n};\n\nfunction effect(_ref) {\n var state = _ref.state,\n instance = _ref.instance,\n options = _ref.options;\n var _options$scroll = options.scroll,\n scroll = _options$scroll === void 0 ? true : _options$scroll,\n _options$resize = options.resize,\n resize = _options$resize === void 0 ? true : _options$resize;\n var window = getWindow(state.elements.popper);\n var scrollParents = [].concat(state.scrollParents.reference, state.scrollParents.popper);\n\n if (scroll) {\n scrollParents.forEach(function (scrollParent) {\n scrollParent.addEventListener('scroll', instance.update, passive);\n });\n }\n\n if (resize) {\n window.addEventListener('resize', instance.update, passive);\n }\n\n return function () {\n if (scroll) {\n scrollParents.forEach(function (scrollParent) {\n scrollParent.removeEventListener('scroll', instance.update, passive);\n });\n }\n\n if (resize) {\n window.removeEventListener('resize', instance.update, passive);\n }\n };\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'eventListeners',\n enabled: true,\n phase: 'write',\n fn: function fn() {},\n effect: effect,\n data: {}\n};","var hash = {\n left: 'right',\n right: 'left',\n bottom: 'top',\n top: 'bottom'\n};\nexport default function getOppositePlacement(placement) {\n return placement.replace(/left|right|bottom|top/g, function (matched) {\n return hash[matched];\n });\n}","var hash = {\n start: 'end',\n end: 'start'\n};\nexport default function getOppositeVariationPlacement(placement) {\n return placement.replace(/start|end/g, function (matched) {\n return hash[matched];\n });\n}","import getWindow from \"./getWindow.js\";\nexport default function getWindowScroll(node) {\n var win = getWindow(node);\n var scrollLeft = win.pageXOffset;\n var scrollTop = win.pageYOffset;\n return {\n scrollLeft: scrollLeft,\n scrollTop: scrollTop\n };\n}","import getBoundingClientRect from \"./getBoundingClientRect.js\";\nimport getDocumentElement from \"./getDocumentElement.js\";\nimport getWindowScroll from \"./getWindowScroll.js\";\nexport default function getWindowScrollBarX(element) {\n // If has a CSS width greater than the viewport, then this will be\n // incorrect for RTL.\n // Popper 1 is broken in this case and never had a bug report so let's assume\n // it's not an issue. I don't think anyone ever specifies width on \n // anyway.\n // Browsers where the left scrollbar doesn't cause an issue report `0` for\n // this (e.g. Edge 2019, IE11, Safari)\n return getBoundingClientRect(getDocumentElement(element)).left + getWindowScroll(element).scrollLeft;\n}","import getComputedStyle from \"./getComputedStyle.js\";\nexport default function isScrollParent(element) {\n // Firefox wants us to check `-x` and `-y` variations as well\n var _getComputedStyle = getComputedStyle(element),\n overflow = _getComputedStyle.overflow,\n overflowX = _getComputedStyle.overflowX,\n overflowY = _getComputedStyle.overflowY;\n\n return /auto|scroll|overlay|hidden/.test(overflow + overflowY + overflowX);\n}","import getParentNode from \"./getParentNode.js\";\nimport isScrollParent from \"./isScrollParent.js\";\nimport getNodeName from \"./getNodeName.js\";\nimport { isHTMLElement } from \"./instanceOf.js\";\nexport default function getScrollParent(node) {\n if (['html', 'body', '#document'].indexOf(getNodeName(node)) >= 0) {\n // $FlowFixMe[incompatible-return]: assume body is always available\n return node.ownerDocument.body;\n }\n\n if (isHTMLElement(node) && isScrollParent(node)) {\n return node;\n }\n\n return getScrollParent(getParentNode(node));\n}","import getScrollParent from \"./getScrollParent.js\";\nimport getParentNode from \"./getParentNode.js\";\nimport getWindow from \"./getWindow.js\";\nimport isScrollParent from \"./isScrollParent.js\";\n/*\ngiven a DOM element, return the list of all scroll parents, up the list of ancesors\nuntil we get to the top window object. This list is what we attach scroll listeners\nto, because if any of these parent elements scroll, we'll need to re-calculate the\nreference element's position.\n*/\n\nexport default function listScrollParents(element, list) {\n var _element$ownerDocumen;\n\n if (list === void 0) {\n list = [];\n }\n\n var scrollParent = getScrollParent(element);\n var isBody = scrollParent === ((_element$ownerDocumen = element.ownerDocument) == null ? void 0 : _element$ownerDocumen.body);\n var win = getWindow(scrollParent);\n var target = isBody ? [win].concat(win.visualViewport || [], isScrollParent(scrollParent) ? scrollParent : []) : scrollParent;\n var updatedList = list.concat(target);\n return isBody ? updatedList : // $FlowFixMe[incompatible-call]: isBody tells us target will be an HTMLElement here\n updatedList.concat(listScrollParents(getParentNode(target)));\n}","export default function rectToClientRect(rect) {\n return Object.assign({}, rect, {\n left: rect.x,\n top: rect.y,\n right: rect.x + rect.width,\n bottom: rect.y + rect.height\n });\n}","import { viewport } from \"../enums.js\";\nimport getViewportRect from \"./getViewportRect.js\";\nimport getDocumentRect from \"./getDocumentRect.js\";\nimport listScrollParents from \"./listScrollParents.js\";\nimport getOffsetParent from \"./getOffsetParent.js\";\nimport getDocumentElement from \"./getDocumentElement.js\";\nimport getComputedStyle from \"./getComputedStyle.js\";\nimport { isElement, isHTMLElement } from \"./instanceOf.js\";\nimport getBoundingClientRect from \"./getBoundingClientRect.js\";\nimport getParentNode from \"./getParentNode.js\";\nimport contains from \"./contains.js\";\nimport getNodeName from \"./getNodeName.js\";\nimport rectToClientRect from \"../utils/rectToClientRect.js\";\nimport { max, min } from \"../utils/math.js\";\n\nfunction getInnerBoundingClientRect(element, strategy) {\n var rect = getBoundingClientRect(element, false, strategy === 'fixed');\n rect.top = rect.top + element.clientTop;\n rect.left = rect.left + element.clientLeft;\n rect.bottom = rect.top + element.clientHeight;\n rect.right = rect.left + element.clientWidth;\n rect.width = element.clientWidth;\n rect.height = element.clientHeight;\n rect.x = rect.left;\n rect.y = rect.top;\n return rect;\n}\n\nfunction getClientRectFromMixedType(element, clippingParent, strategy) {\n return clippingParent === viewport ? rectToClientRect(getViewportRect(element, strategy)) : isElement(clippingParent) ? getInnerBoundingClientRect(clippingParent, strategy) : rectToClientRect(getDocumentRect(getDocumentElement(element)));\n} // A \"clipping parent\" is an overflowable container with the characteristic of\n// clipping (or hiding) overflowing elements with a position different from\n// `initial`\n\n\nfunction getClippingParents(element) {\n var clippingParents = listScrollParents(getParentNode(element));\n var canEscapeClipping = ['absolute', 'fixed'].indexOf(getComputedStyle(element).position) >= 0;\n var clipperElement = canEscapeClipping && isHTMLElement(element) ? getOffsetParent(element) : element;\n\n if (!isElement(clipperElement)) {\n return [];\n } // $FlowFixMe[incompatible-return]: https://github.com/facebook/flow/issues/1414\n\n\n return clippingParents.filter(function (clippingParent) {\n return isElement(clippingParent) && contains(clippingParent, clipperElement) && getNodeName(clippingParent) !== 'body';\n });\n} // Gets the maximum area that the element is visible in due to any number of\n// clipping parents\n\n\nexport default function getClippingRect(element, boundary, rootBoundary, strategy) {\n var mainClippingParents = boundary === 'clippingParents' ? getClippingParents(element) : [].concat(boundary);\n var clippingParents = [].concat(mainClippingParents, [rootBoundary]);\n var firstClippingParent = clippingParents[0];\n var clippingRect = clippingParents.reduce(function (accRect, clippingParent) {\n var rect = getClientRectFromMixedType(element, clippingParent, strategy);\n accRect.top = max(rect.top, accRect.top);\n accRect.right = min(rect.right, accRect.right);\n accRect.bottom = min(rect.bottom, accRect.bottom);\n accRect.left = max(rect.left, accRect.left);\n return accRect;\n }, getClientRectFromMixedType(element, firstClippingParent, strategy));\n clippingRect.width = clippingRect.right - clippingRect.left;\n clippingRect.height = clippingRect.bottom - clippingRect.top;\n clippingRect.x = clippingRect.left;\n clippingRect.y = clippingRect.top;\n return clippingRect;\n}","import getWindow from \"./getWindow.js\";\nimport getDocumentElement from \"./getDocumentElement.js\";\nimport getWindowScrollBarX from \"./getWindowScrollBarX.js\";\nimport isLayoutViewport from \"./isLayoutViewport.js\";\nexport default function getViewportRect(element, strategy) {\n var win = getWindow(element);\n var html = getDocumentElement(element);\n var visualViewport = win.visualViewport;\n var width = html.clientWidth;\n var height = html.clientHeight;\n var x = 0;\n var y = 0;\n\n if (visualViewport) {\n width = visualViewport.width;\n height = visualViewport.height;\n var layoutViewport = isLayoutViewport();\n\n if (layoutViewport || !layoutViewport && strategy === 'fixed') {\n x = visualViewport.offsetLeft;\n y = visualViewport.offsetTop;\n }\n }\n\n return {\n width: width,\n height: height,\n x: x + getWindowScrollBarX(element),\n y: y\n };\n}","import getDocumentElement from \"./getDocumentElement.js\";\nimport getComputedStyle from \"./getComputedStyle.js\";\nimport getWindowScrollBarX from \"./getWindowScrollBarX.js\";\nimport getWindowScroll from \"./getWindowScroll.js\";\nimport { max } from \"../utils/math.js\"; // Gets the entire size of the scrollable document area, even extending outside\n// of the `` and `` rect bounds if horizontally scrollable\n\nexport default function getDocumentRect(element) {\n var _element$ownerDocumen;\n\n var html = getDocumentElement(element);\n var winScroll = getWindowScroll(element);\n var body = (_element$ownerDocumen = element.ownerDocument) == null ? void 0 : _element$ownerDocumen.body;\n var width = max(html.scrollWidth, html.clientWidth, body ? body.scrollWidth : 0, body ? body.clientWidth : 0);\n var height = max(html.scrollHeight, html.clientHeight, body ? body.scrollHeight : 0, body ? body.clientHeight : 0);\n var x = -winScroll.scrollLeft + getWindowScrollBarX(element);\n var y = -winScroll.scrollTop;\n\n if (getComputedStyle(body || html).direction === 'rtl') {\n x += max(html.clientWidth, body ? body.clientWidth : 0) - width;\n }\n\n return {\n width: width,\n height: height,\n x: x,\n y: y\n };\n}","import getBasePlacement from \"./getBasePlacement.js\";\nimport getVariation from \"./getVariation.js\";\nimport getMainAxisFromPlacement from \"./getMainAxisFromPlacement.js\";\nimport { top, right, bottom, left, start, end } from \"../enums.js\";\nexport default function computeOffsets(_ref) {\n var reference = _ref.reference,\n element = _ref.element,\n placement = _ref.placement;\n var basePlacement = placement ? getBasePlacement(placement) : null;\n var variation = placement ? getVariation(placement) : null;\n var commonX = reference.x + reference.width / 2 - element.width / 2;\n var commonY = reference.y + reference.height / 2 - element.height / 2;\n var offsets;\n\n switch (basePlacement) {\n case top:\n offsets = {\n x: commonX,\n y: reference.y - element.height\n };\n break;\n\n case bottom:\n offsets = {\n x: commonX,\n y: reference.y + reference.height\n };\n break;\n\n case right:\n offsets = {\n x: reference.x + reference.width,\n y: commonY\n };\n break;\n\n case left:\n offsets = {\n x: reference.x - element.width,\n y: commonY\n };\n break;\n\n default:\n offsets = {\n x: reference.x,\n y: reference.y\n };\n }\n\n var mainAxis = basePlacement ? getMainAxisFromPlacement(basePlacement) : null;\n\n if (mainAxis != null) {\n var len = mainAxis === 'y' ? 'height' : 'width';\n\n switch (variation) {\n case start:\n offsets[mainAxis] = offsets[mainAxis] - (reference[len] / 2 - element[len] / 2);\n break;\n\n case end:\n offsets[mainAxis] = offsets[mainAxis] + (reference[len] / 2 - element[len] / 2);\n break;\n\n default:\n }\n }\n\n return offsets;\n}","import getClippingRect from \"../dom-utils/getClippingRect.js\";\nimport getDocumentElement from \"../dom-utils/getDocumentElement.js\";\nimport getBoundingClientRect from \"../dom-utils/getBoundingClientRect.js\";\nimport computeOffsets from \"./computeOffsets.js\";\nimport rectToClientRect from \"./rectToClientRect.js\";\nimport { clippingParents, reference, popper, bottom, top, right, basePlacements, viewport } from \"../enums.js\";\nimport { isElement } from \"../dom-utils/instanceOf.js\";\nimport mergePaddingObject from \"./mergePaddingObject.js\";\nimport expandToHashMap from \"./expandToHashMap.js\"; // eslint-disable-next-line import/no-unused-modules\n\nexport default function detectOverflow(state, options) {\n if (options === void 0) {\n options = {};\n }\n\n var _options = options,\n _options$placement = _options.placement,\n placement = _options$placement === void 0 ? state.placement : _options$placement,\n _options$strategy = _options.strategy,\n strategy = _options$strategy === void 0 ? state.strategy : _options$strategy,\n _options$boundary = _options.boundary,\n boundary = _options$boundary === void 0 ? clippingParents : _options$boundary,\n _options$rootBoundary = _options.rootBoundary,\n rootBoundary = _options$rootBoundary === void 0 ? viewport : _options$rootBoundary,\n _options$elementConte = _options.elementContext,\n elementContext = _options$elementConte === void 0 ? popper : _options$elementConte,\n _options$altBoundary = _options.altBoundary,\n altBoundary = _options$altBoundary === void 0 ? false : _options$altBoundary,\n _options$padding = _options.padding,\n padding = _options$padding === void 0 ? 0 : _options$padding;\n var paddingObject = mergePaddingObject(typeof padding !== 'number' ? padding : expandToHashMap(padding, basePlacements));\n var altContext = elementContext === popper ? reference : popper;\n var popperRect = state.rects.popper;\n var element = state.elements[altBoundary ? altContext : elementContext];\n var clippingClientRect = getClippingRect(isElement(element) ? element : element.contextElement || getDocumentElement(state.elements.popper), boundary, rootBoundary, strategy);\n var referenceClientRect = getBoundingClientRect(state.elements.reference);\n var popperOffsets = computeOffsets({\n reference: referenceClientRect,\n element: popperRect,\n strategy: 'absolute',\n placement: placement\n });\n var popperClientRect = rectToClientRect(Object.assign({}, popperRect, popperOffsets));\n var elementClientRect = elementContext === popper ? popperClientRect : referenceClientRect; // positive = overflowing the clipping rect\n // 0 or negative = within the clipping rect\n\n var overflowOffsets = {\n top: clippingClientRect.top - elementClientRect.top + paddingObject.top,\n bottom: elementClientRect.bottom - clippingClientRect.bottom + paddingObject.bottom,\n left: clippingClientRect.left - elementClientRect.left + paddingObject.left,\n right: elementClientRect.right - clippingClientRect.right + paddingObject.right\n };\n var offsetData = state.modifiersData.offset; // Offsets can be applied only to the popper element\n\n if (elementContext === popper && offsetData) {\n var offset = offsetData[placement];\n Object.keys(overflowOffsets).forEach(function (key) {\n var multiply = [right, bottom].indexOf(key) >= 0 ? 1 : -1;\n var axis = [top, bottom].indexOf(key) >= 0 ? 'y' : 'x';\n overflowOffsets[key] += offset[axis] * multiply;\n });\n }\n\n return overflowOffsets;\n}","import getVariation from \"./getVariation.js\";\nimport { variationPlacements, basePlacements, placements as allPlacements } from \"../enums.js\";\nimport detectOverflow from \"./detectOverflow.js\";\nimport getBasePlacement from \"./getBasePlacement.js\";\nexport default function computeAutoPlacement(state, options) {\n if (options === void 0) {\n options = {};\n }\n\n var _options = options,\n placement = _options.placement,\n boundary = _options.boundary,\n rootBoundary = _options.rootBoundary,\n padding = _options.padding,\n flipVariations = _options.flipVariations,\n _options$allowedAutoP = _options.allowedAutoPlacements,\n allowedAutoPlacements = _options$allowedAutoP === void 0 ? allPlacements : _options$allowedAutoP;\n var variation = getVariation(placement);\n var placements = variation ? flipVariations ? variationPlacements : variationPlacements.filter(function (placement) {\n return getVariation(placement) === variation;\n }) : basePlacements;\n var allowedPlacements = placements.filter(function (placement) {\n return allowedAutoPlacements.indexOf(placement) >= 0;\n });\n\n if (allowedPlacements.length === 0) {\n allowedPlacements = placements;\n } // $FlowFixMe[incompatible-type]: Flow seems to have problems with two array unions...\n\n\n var overflows = allowedPlacements.reduce(function (acc, placement) {\n acc[placement] = detectOverflow(state, {\n placement: placement,\n boundary: boundary,\n rootBoundary: rootBoundary,\n padding: padding\n })[getBasePlacement(placement)];\n return acc;\n }, {});\n return Object.keys(overflows).sort(function (a, b) {\n return overflows[a] - overflows[b];\n });\n}","import getOppositePlacement from \"../utils/getOppositePlacement.js\";\nimport getBasePlacement from \"../utils/getBasePlacement.js\";\nimport getOppositeVariationPlacement from \"../utils/getOppositeVariationPlacement.js\";\nimport detectOverflow from \"../utils/detectOverflow.js\";\nimport computeAutoPlacement from \"../utils/computeAutoPlacement.js\";\nimport { bottom, top, start, right, left, auto } from \"../enums.js\";\nimport getVariation from \"../utils/getVariation.js\"; // eslint-disable-next-line import/no-unused-modules\n\nfunction getExpandedFallbackPlacements(placement) {\n if (getBasePlacement(placement) === auto) {\n return [];\n }\n\n var oppositePlacement = getOppositePlacement(placement);\n return [getOppositeVariationPlacement(placement), oppositePlacement, getOppositeVariationPlacement(oppositePlacement)];\n}\n\nfunction flip(_ref) {\n var state = _ref.state,\n options = _ref.options,\n name = _ref.name;\n\n if (state.modifiersData[name]._skip) {\n return;\n }\n\n var _options$mainAxis = options.mainAxis,\n checkMainAxis = _options$mainAxis === void 0 ? true : _options$mainAxis,\n _options$altAxis = options.altAxis,\n checkAltAxis = _options$altAxis === void 0 ? true : _options$altAxis,\n specifiedFallbackPlacements = options.fallbackPlacements,\n padding = options.padding,\n boundary = options.boundary,\n rootBoundary = options.rootBoundary,\n altBoundary = options.altBoundary,\n _options$flipVariatio = options.flipVariations,\n flipVariations = _options$flipVariatio === void 0 ? true : _options$flipVariatio,\n allowedAutoPlacements = options.allowedAutoPlacements;\n var preferredPlacement = state.options.placement;\n var basePlacement = getBasePlacement(preferredPlacement);\n var isBasePlacement = basePlacement === preferredPlacement;\n var fallbackPlacements = specifiedFallbackPlacements || (isBasePlacement || !flipVariations ? [getOppositePlacement(preferredPlacement)] : getExpandedFallbackPlacements(preferredPlacement));\n var placements = [preferredPlacement].concat(fallbackPlacements).reduce(function (acc, placement) {\n return acc.concat(getBasePlacement(placement) === auto ? computeAutoPlacement(state, {\n placement: placement,\n boundary: boundary,\n rootBoundary: rootBoundary,\n padding: padding,\n flipVariations: flipVariations,\n allowedAutoPlacements: allowedAutoPlacements\n }) : placement);\n }, []);\n var referenceRect = state.rects.reference;\n var popperRect = state.rects.popper;\n var checksMap = new Map();\n var makeFallbackChecks = true;\n var firstFittingPlacement = placements[0];\n\n for (var i = 0; i < placements.length; i++) {\n var placement = placements[i];\n\n var _basePlacement = getBasePlacement(placement);\n\n var isStartVariation = getVariation(placement) === start;\n var isVertical = [top, bottom].indexOf(_basePlacement) >= 0;\n var len = isVertical ? 'width' : 'height';\n var overflow = detectOverflow(state, {\n placement: placement,\n boundary: boundary,\n rootBoundary: rootBoundary,\n altBoundary: altBoundary,\n padding: padding\n });\n var mainVariationSide = isVertical ? isStartVariation ? right : left : isStartVariation ? bottom : top;\n\n if (referenceRect[len] > popperRect[len]) {\n mainVariationSide = getOppositePlacement(mainVariationSide);\n }\n\n var altVariationSide = getOppositePlacement(mainVariationSide);\n var checks = [];\n\n if (checkMainAxis) {\n checks.push(overflow[_basePlacement] <= 0);\n }\n\n if (checkAltAxis) {\n checks.push(overflow[mainVariationSide] <= 0, overflow[altVariationSide] <= 0);\n }\n\n if (checks.every(function (check) {\n return check;\n })) {\n firstFittingPlacement = placement;\n makeFallbackChecks = false;\n break;\n }\n\n checksMap.set(placement, checks);\n }\n\n if (makeFallbackChecks) {\n // `2` may be desired in some cases – research later\n var numberOfChecks = flipVariations ? 3 : 1;\n\n var _loop = function _loop(_i) {\n var fittingPlacement = placements.find(function (placement) {\n var checks = checksMap.get(placement);\n\n if (checks) {\n return checks.slice(0, _i).every(function (check) {\n return check;\n });\n }\n });\n\n if (fittingPlacement) {\n firstFittingPlacement = fittingPlacement;\n return \"break\";\n }\n };\n\n for (var _i = numberOfChecks; _i > 0; _i--) {\n var _ret = _loop(_i);\n\n if (_ret === \"break\") break;\n }\n }\n\n if (state.placement !== firstFittingPlacement) {\n state.modifiersData[name]._skip = true;\n state.placement = firstFittingPlacement;\n state.reset = true;\n }\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'flip',\n enabled: true,\n phase: 'main',\n fn: flip,\n requiresIfExists: ['offset'],\n data: {\n _skip: false\n }\n};","import { top, bottom, left, right } from \"../enums.js\";\nimport detectOverflow from \"../utils/detectOverflow.js\";\n\nfunction getSideOffsets(overflow, rect, preventedOffsets) {\n if (preventedOffsets === void 0) {\n preventedOffsets = {\n x: 0,\n y: 0\n };\n }\n\n return {\n top: overflow.top - rect.height - preventedOffsets.y,\n right: overflow.right - rect.width + preventedOffsets.x,\n bottom: overflow.bottom - rect.height + preventedOffsets.y,\n left: overflow.left - rect.width - preventedOffsets.x\n };\n}\n\nfunction isAnySideFullyClipped(overflow) {\n return [top, right, bottom, left].some(function (side) {\n return overflow[side] >= 0;\n });\n}\n\nfunction hide(_ref) {\n var state = _ref.state,\n name = _ref.name;\n var referenceRect = state.rects.reference;\n var popperRect = state.rects.popper;\n var preventedOffsets = state.modifiersData.preventOverflow;\n var referenceOverflow = detectOverflow(state, {\n elementContext: 'reference'\n });\n var popperAltOverflow = detectOverflow(state, {\n altBoundary: true\n });\n var referenceClippingOffsets = getSideOffsets(referenceOverflow, referenceRect);\n var popperEscapeOffsets = getSideOffsets(popperAltOverflow, popperRect, preventedOffsets);\n var isReferenceHidden = isAnySideFullyClipped(referenceClippingOffsets);\n var hasPopperEscaped = isAnySideFullyClipped(popperEscapeOffsets);\n state.modifiersData[name] = {\n referenceClippingOffsets: referenceClippingOffsets,\n popperEscapeOffsets: popperEscapeOffsets,\n isReferenceHidden: isReferenceHidden,\n hasPopperEscaped: hasPopperEscaped\n };\n state.attributes.popper = Object.assign({}, state.attributes.popper, {\n 'data-popper-reference-hidden': isReferenceHidden,\n 'data-popper-escaped': hasPopperEscaped\n });\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'hide',\n enabled: true,\n phase: 'main',\n requiresIfExists: ['preventOverflow'],\n fn: hide\n};","import getBasePlacement from \"../utils/getBasePlacement.js\";\nimport { top, left, right, placements } from \"../enums.js\"; // eslint-disable-next-line import/no-unused-modules\n\nexport function distanceAndSkiddingToXY(placement, rects, offset) {\n var basePlacement = getBasePlacement(placement);\n var invertDistance = [left, top].indexOf(basePlacement) >= 0 ? -1 : 1;\n\n var _ref = typeof offset === 'function' ? offset(Object.assign({}, rects, {\n placement: placement\n })) : offset,\n skidding = _ref[0],\n distance = _ref[1];\n\n skidding = skidding || 0;\n distance = (distance || 0) * invertDistance;\n return [left, right].indexOf(basePlacement) >= 0 ? {\n x: distance,\n y: skidding\n } : {\n x: skidding,\n y: distance\n };\n}\n\nfunction offset(_ref2) {\n var state = _ref2.state,\n options = _ref2.options,\n name = _ref2.name;\n var _options$offset = options.offset,\n offset = _options$offset === void 0 ? [0, 0] : _options$offset;\n var data = placements.reduce(function (acc, placement) {\n acc[placement] = distanceAndSkiddingToXY(placement, state.rects, offset);\n return acc;\n }, {});\n var _data$state$placement = data[state.placement],\n x = _data$state$placement.x,\n y = _data$state$placement.y;\n\n if (state.modifiersData.popperOffsets != null) {\n state.modifiersData.popperOffsets.x += x;\n state.modifiersData.popperOffsets.y += y;\n }\n\n state.modifiersData[name] = data;\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'offset',\n enabled: true,\n phase: 'main',\n requires: ['popperOffsets'],\n fn: offset\n};","import computeOffsets from \"../utils/computeOffsets.js\";\n\nfunction popperOffsets(_ref) {\n var state = _ref.state,\n name = _ref.name;\n // Offsets are the actual position the popper needs to have to be\n // properly positioned near its reference element\n // This is the most basic placement, and will be adjusted by\n // the modifiers in the next step\n state.modifiersData[name] = computeOffsets({\n reference: state.rects.reference,\n element: state.rects.popper,\n strategy: 'absolute',\n placement: state.placement\n });\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'popperOffsets',\n enabled: true,\n phase: 'read',\n fn: popperOffsets,\n data: {}\n};","import { top, left, right, bottom, start } from \"../enums.js\";\nimport getBasePlacement from \"../utils/getBasePlacement.js\";\nimport getMainAxisFromPlacement from \"../utils/getMainAxisFromPlacement.js\";\nimport getAltAxis from \"../utils/getAltAxis.js\";\nimport { within, withinMaxClamp } from \"../utils/within.js\";\nimport getLayoutRect from \"../dom-utils/getLayoutRect.js\";\nimport getOffsetParent from \"../dom-utils/getOffsetParent.js\";\nimport detectOverflow from \"../utils/detectOverflow.js\";\nimport getVariation from \"../utils/getVariation.js\";\nimport getFreshSideObject from \"../utils/getFreshSideObject.js\";\nimport { min as mathMin, max as mathMax } from \"../utils/math.js\";\n\nfunction preventOverflow(_ref) {\n var state = _ref.state,\n options = _ref.options,\n name = _ref.name;\n var _options$mainAxis = options.mainAxis,\n checkMainAxis = _options$mainAxis === void 0 ? true : _options$mainAxis,\n _options$altAxis = options.altAxis,\n checkAltAxis = _options$altAxis === void 0 ? false : _options$altAxis,\n boundary = options.boundary,\n rootBoundary = options.rootBoundary,\n altBoundary = options.altBoundary,\n padding = options.padding,\n _options$tether = options.tether,\n tether = _options$tether === void 0 ? true : _options$tether,\n _options$tetherOffset = options.tetherOffset,\n tetherOffset = _options$tetherOffset === void 0 ? 0 : _options$tetherOffset;\n var overflow = detectOverflow(state, {\n boundary: boundary,\n rootBoundary: rootBoundary,\n padding: padding,\n altBoundary: altBoundary\n });\n var basePlacement = getBasePlacement(state.placement);\n var variation = getVariation(state.placement);\n var isBasePlacement = !variation;\n var mainAxis = getMainAxisFromPlacement(basePlacement);\n var altAxis = getAltAxis(mainAxis);\n var popperOffsets = state.modifiersData.popperOffsets;\n var referenceRect = state.rects.reference;\n var popperRect = state.rects.popper;\n var tetherOffsetValue = typeof tetherOffset === 'function' ? tetherOffset(Object.assign({}, state.rects, {\n placement: state.placement\n })) : tetherOffset;\n var normalizedTetherOffsetValue = typeof tetherOffsetValue === 'number' ? {\n mainAxis: tetherOffsetValue,\n altAxis: tetherOffsetValue\n } : Object.assign({\n mainAxis: 0,\n altAxis: 0\n }, tetherOffsetValue);\n var offsetModifierState = state.modifiersData.offset ? state.modifiersData.offset[state.placement] : null;\n var data = {\n x: 0,\n y: 0\n };\n\n if (!popperOffsets) {\n return;\n }\n\n if (checkMainAxis) {\n var _offsetModifierState$;\n\n var mainSide = mainAxis === 'y' ? top : left;\n var altSide = mainAxis === 'y' ? bottom : right;\n var len = mainAxis === 'y' ? 'height' : 'width';\n var offset = popperOffsets[mainAxis];\n var min = offset + overflow[mainSide];\n var max = offset - overflow[altSide];\n var additive = tether ? -popperRect[len] / 2 : 0;\n var minLen = variation === start ? referenceRect[len] : popperRect[len];\n var maxLen = variation === start ? -popperRect[len] : -referenceRect[len]; // We need to include the arrow in the calculation so the arrow doesn't go\n // outside the reference bounds\n\n var arrowElement = state.elements.arrow;\n var arrowRect = tether && arrowElement ? getLayoutRect(arrowElement) : {\n width: 0,\n height: 0\n };\n var arrowPaddingObject = state.modifiersData['arrow#persistent'] ? state.modifiersData['arrow#persistent'].padding : getFreshSideObject();\n var arrowPaddingMin = arrowPaddingObject[mainSide];\n var arrowPaddingMax = arrowPaddingObject[altSide]; // If the reference length is smaller than the arrow length, we don't want\n // to include its full size in the calculation. If the reference is small\n // and near the edge of a boundary, the popper can overflow even if the\n // reference is not overflowing as well (e.g. virtual elements with no\n // width or height)\n\n var arrowLen = within(0, referenceRect[len], arrowRect[len]);\n var minOffset = isBasePlacement ? referenceRect[len] / 2 - additive - arrowLen - arrowPaddingMin - normalizedTetherOffsetValue.mainAxis : minLen - arrowLen - arrowPaddingMin - normalizedTetherOffsetValue.mainAxis;\n var maxOffset = isBasePlacement ? -referenceRect[len] / 2 + additive + arrowLen + arrowPaddingMax + normalizedTetherOffsetValue.mainAxis : maxLen + arrowLen + arrowPaddingMax + normalizedTetherOffsetValue.mainAxis;\n var arrowOffsetParent = state.elements.arrow && getOffsetParent(state.elements.arrow);\n var clientOffset = arrowOffsetParent ? mainAxis === 'y' ? arrowOffsetParent.clientTop || 0 : arrowOffsetParent.clientLeft || 0 : 0;\n var offsetModifierValue = (_offsetModifierState$ = offsetModifierState == null ? void 0 : offsetModifierState[mainAxis]) != null ? _offsetModifierState$ : 0;\n var tetherMin = offset + minOffset - offsetModifierValue - clientOffset;\n var tetherMax = offset + maxOffset - offsetModifierValue;\n var preventedOffset = within(tether ? mathMin(min, tetherMin) : min, offset, tether ? mathMax(max, tetherMax) : max);\n popperOffsets[mainAxis] = preventedOffset;\n data[mainAxis] = preventedOffset - offset;\n }\n\n if (checkAltAxis) {\n var _offsetModifierState$2;\n\n var _mainSide = mainAxis === 'x' ? top : left;\n\n var _altSide = mainAxis === 'x' ? bottom : right;\n\n var _offset = popperOffsets[altAxis];\n\n var _len = altAxis === 'y' ? 'height' : 'width';\n\n var _min = _offset + overflow[_mainSide];\n\n var _max = _offset - overflow[_altSide];\n\n var isOriginSide = [top, left].indexOf(basePlacement) !== -1;\n\n var _offsetModifierValue = (_offsetModifierState$2 = offsetModifierState == null ? void 0 : offsetModifierState[altAxis]) != null ? _offsetModifierState$2 : 0;\n\n var _tetherMin = isOriginSide ? _min : _offset - referenceRect[_len] - popperRect[_len] - _offsetModifierValue + normalizedTetherOffsetValue.altAxis;\n\n var _tetherMax = isOriginSide ? _offset + referenceRect[_len] + popperRect[_len] - _offsetModifierValue - normalizedTetherOffsetValue.altAxis : _max;\n\n var _preventedOffset = tether && isOriginSide ? withinMaxClamp(_tetherMin, _offset, _tetherMax) : within(tether ? _tetherMin : _min, _offset, tether ? _tetherMax : _max);\n\n popperOffsets[altAxis] = _preventedOffset;\n data[altAxis] = _preventedOffset - _offset;\n }\n\n state.modifiersData[name] = data;\n} // eslint-disable-next-line import/no-unused-modules\n\n\nexport default {\n name: 'preventOverflow',\n enabled: true,\n phase: 'main',\n fn: preventOverflow,\n requiresIfExists: ['offset']\n};","export default function getAltAxis(axis) {\n return axis === 'x' ? 'y' : 'x';\n}","import getBoundingClientRect from \"./getBoundingClientRect.js\";\nimport getNodeScroll from \"./getNodeScroll.js\";\nimport getNodeName from \"./getNodeName.js\";\nimport { isHTMLElement } from \"./instanceOf.js\";\nimport getWindowScrollBarX from \"./getWindowScrollBarX.js\";\nimport getDocumentElement from \"./getDocumentElement.js\";\nimport isScrollParent from \"./isScrollParent.js\";\nimport { round } from \"../utils/math.js\";\n\nfunction isElementScaled(element) {\n var rect = element.getBoundingClientRect();\n var scaleX = round(rect.width) / element.offsetWidth || 1;\n var scaleY = round(rect.height) / element.offsetHeight || 1;\n return scaleX !== 1 || scaleY !== 1;\n} // Returns the composite rect of an element relative to its offsetParent.\n// Composite means it takes into account transforms as well as layout.\n\n\nexport default function getCompositeRect(elementOrVirtualElement, offsetParent, isFixed) {\n if (isFixed === void 0) {\n isFixed = false;\n }\n\n var isOffsetParentAnElement = isHTMLElement(offsetParent);\n var offsetParentIsScaled = isHTMLElement(offsetParent) && isElementScaled(offsetParent);\n var documentElement = getDocumentElement(offsetParent);\n var rect = getBoundingClientRect(elementOrVirtualElement, offsetParentIsScaled, isFixed);\n var scroll = {\n scrollLeft: 0,\n scrollTop: 0\n };\n var offsets = {\n x: 0,\n y: 0\n };\n\n if (isOffsetParentAnElement || !isOffsetParentAnElement && !isFixed) {\n if (getNodeName(offsetParent) !== 'body' || // https://github.com/popperjs/popper-core/issues/1078\n isScrollParent(documentElement)) {\n scroll = getNodeScroll(offsetParent);\n }\n\n if (isHTMLElement(offsetParent)) {\n offsets = getBoundingClientRect(offsetParent, true);\n offsets.x += offsetParent.clientLeft;\n offsets.y += offsetParent.clientTop;\n } else if (documentElement) {\n offsets.x = getWindowScrollBarX(documentElement);\n }\n }\n\n return {\n x: rect.left + scroll.scrollLeft - offsets.x,\n y: rect.top + scroll.scrollTop - offsets.y,\n width: rect.width,\n height: rect.height\n };\n}","import getWindowScroll from \"./getWindowScroll.js\";\nimport getWindow from \"./getWindow.js\";\nimport { isHTMLElement } from \"./instanceOf.js\";\nimport getHTMLElementScroll from \"./getHTMLElementScroll.js\";\nexport default function getNodeScroll(node) {\n if (node === getWindow(node) || !isHTMLElement(node)) {\n return getWindowScroll(node);\n } else {\n return getHTMLElementScroll(node);\n }\n}","export default function getHTMLElementScroll(element) {\n return {\n scrollLeft: element.scrollLeft,\n scrollTop: element.scrollTop\n };\n}","import { modifierPhases } from \"../enums.js\"; // source: https://stackoverflow.com/questions/49875255\n\nfunction order(modifiers) {\n var map = new Map();\n var visited = new Set();\n var result = [];\n modifiers.forEach(function (modifier) {\n map.set(modifier.name, modifier);\n }); // On visiting object, check for its dependencies and visit them recursively\n\n function sort(modifier) {\n visited.add(modifier.name);\n var requires = [].concat(modifier.requires || [], modifier.requiresIfExists || []);\n requires.forEach(function (dep) {\n if (!visited.has(dep)) {\n var depModifier = map.get(dep);\n\n if (depModifier) {\n sort(depModifier);\n }\n }\n });\n result.push(modifier);\n }\n\n modifiers.forEach(function (modifier) {\n if (!visited.has(modifier.name)) {\n // check for visited object\n sort(modifier);\n }\n });\n return result;\n}\n\nexport default function orderModifiers(modifiers) {\n // order based on dependencies\n var orderedModifiers = order(modifiers); // order based on phase\n\n return modifierPhases.reduce(function (acc, phase) {\n return acc.concat(orderedModifiers.filter(function (modifier) {\n return modifier.phase === phase;\n }));\n }, []);\n}","import getCompositeRect from \"./dom-utils/getCompositeRect.js\";\nimport getLayoutRect from \"./dom-utils/getLayoutRect.js\";\nimport listScrollParents from \"./dom-utils/listScrollParents.js\";\nimport getOffsetParent from \"./dom-utils/getOffsetParent.js\";\nimport orderModifiers from \"./utils/orderModifiers.js\";\nimport debounce from \"./utils/debounce.js\";\nimport mergeByName from \"./utils/mergeByName.js\";\nimport detectOverflow from \"./utils/detectOverflow.js\";\nimport { isElement } from \"./dom-utils/instanceOf.js\";\nvar DEFAULT_OPTIONS = {\n placement: 'bottom',\n modifiers: [],\n strategy: 'absolute'\n};\n\nfunction areValidElements() {\n for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {\n args[_key] = arguments[_key];\n }\n\n return !args.some(function (element) {\n return !(element && typeof element.getBoundingClientRect === 'function');\n });\n}\n\nexport function popperGenerator(generatorOptions) {\n if (generatorOptions === void 0) {\n generatorOptions = {};\n }\n\n var _generatorOptions = generatorOptions,\n _generatorOptions$def = _generatorOptions.defaultModifiers,\n defaultModifiers = _generatorOptions$def === void 0 ? [] : _generatorOptions$def,\n _generatorOptions$def2 = _generatorOptions.defaultOptions,\n defaultOptions = _generatorOptions$def2 === void 0 ? DEFAULT_OPTIONS : _generatorOptions$def2;\n return function createPopper(reference, popper, options) {\n if (options === void 0) {\n options = defaultOptions;\n }\n\n var state = {\n placement: 'bottom',\n orderedModifiers: [],\n options: Object.assign({}, DEFAULT_OPTIONS, defaultOptions),\n modifiersData: {},\n elements: {\n reference: reference,\n popper: popper\n },\n attributes: {},\n styles: {}\n };\n var effectCleanupFns = [];\n var isDestroyed = false;\n var instance = {\n state: state,\n setOptions: function setOptions(setOptionsAction) {\n var options = typeof setOptionsAction === 'function' ? setOptionsAction(state.options) : setOptionsAction;\n cleanupModifierEffects();\n state.options = Object.assign({}, defaultOptions, state.options, options);\n state.scrollParents = {\n reference: isElement(reference) ? listScrollParents(reference) : reference.contextElement ? listScrollParents(reference.contextElement) : [],\n popper: listScrollParents(popper)\n }; // Orders the modifiers based on their dependencies and `phase`\n // properties\n\n var orderedModifiers = orderModifiers(mergeByName([].concat(defaultModifiers, state.options.modifiers))); // Strip out disabled modifiers\n\n state.orderedModifiers = orderedModifiers.filter(function (m) {\n return m.enabled;\n });\n runModifierEffects();\n return instance.update();\n },\n // Sync update – it will always be executed, even if not necessary. This\n // is useful for low frequency updates where sync behavior simplifies the\n // logic.\n // For high frequency updates (e.g. `resize` and `scroll` events), always\n // prefer the async Popper#update method\n forceUpdate: function forceUpdate() {\n if (isDestroyed) {\n return;\n }\n\n var _state$elements = state.elements,\n reference = _state$elements.reference,\n popper = _state$elements.popper; // Don't proceed if `reference` or `popper` are not valid elements\n // anymore\n\n if (!areValidElements(reference, popper)) {\n return;\n } // Store the reference and popper rects to be read by modifiers\n\n\n state.rects = {\n reference: getCompositeRect(reference, getOffsetParent(popper), state.options.strategy === 'fixed'),\n popper: getLayoutRect(popper)\n }; // Modifiers have the ability to reset the current update cycle. The\n // most common use case for this is the `flip` modifier changing the\n // placement, which then needs to re-run all the modifiers, because the\n // logic was previously ran for the previous placement and is therefore\n // stale/incorrect\n\n state.reset = false;\n state.placement = state.options.placement; // On each update cycle, the `modifiersData` property for each modifier\n // is filled with the initial data specified by the modifier. This means\n // it doesn't persist and is fresh on each update.\n // To ensure persistent data, use `${name}#persistent`\n\n state.orderedModifiers.forEach(function (modifier) {\n return state.modifiersData[modifier.name] = Object.assign({}, modifier.data);\n });\n\n for (var index = 0; index < state.orderedModifiers.length; index++) {\n if (state.reset === true) {\n state.reset = false;\n index = -1;\n continue;\n }\n\n var _state$orderedModifie = state.orderedModifiers[index],\n fn = _state$orderedModifie.fn,\n _state$orderedModifie2 = _state$orderedModifie.options,\n _options = _state$orderedModifie2 === void 0 ? {} : _state$orderedModifie2,\n name = _state$orderedModifie.name;\n\n if (typeof fn === 'function') {\n state = fn({\n state: state,\n options: _options,\n name: name,\n instance: instance\n }) || state;\n }\n }\n },\n // Async and optimistically optimized update – it will not be executed if\n // not necessary (debounced to run at most once-per-tick)\n update: debounce(function () {\n return new Promise(function (resolve) {\n instance.forceUpdate();\n resolve(state);\n });\n }),\n destroy: function destroy() {\n cleanupModifierEffects();\n isDestroyed = true;\n }\n };\n\n if (!areValidElements(reference, popper)) {\n return instance;\n }\n\n instance.setOptions(options).then(function (state) {\n if (!isDestroyed && options.onFirstUpdate) {\n options.onFirstUpdate(state);\n }\n }); // Modifiers have the ability to execute arbitrary code before the first\n // update cycle runs. They will be executed in the same order as the update\n // cycle. This is useful when a modifier adds some persistent data that\n // other modifiers need to use, but the modifier is run after the dependent\n // one.\n\n function runModifierEffects() {\n state.orderedModifiers.forEach(function (_ref) {\n var name = _ref.name,\n _ref$options = _ref.options,\n options = _ref$options === void 0 ? {} : _ref$options,\n effect = _ref.effect;\n\n if (typeof effect === 'function') {\n var cleanupFn = effect({\n state: state,\n name: name,\n instance: instance,\n options: options\n });\n\n var noopFn = function noopFn() {};\n\n effectCleanupFns.push(cleanupFn || noopFn);\n }\n });\n }\n\n function cleanupModifierEffects() {\n effectCleanupFns.forEach(function (fn) {\n return fn();\n });\n effectCleanupFns = [];\n }\n\n return instance;\n };\n}\nexport var createPopper = /*#__PURE__*/popperGenerator(); // eslint-disable-next-line import/no-unused-modules\n\nexport { detectOverflow };","export default function debounce(fn) {\n var pending;\n return function () {\n if (!pending) {\n pending = new Promise(function (resolve) {\n Promise.resolve().then(function () {\n pending = undefined;\n resolve(fn());\n });\n });\n }\n\n return pending;\n };\n}","export default function mergeByName(modifiers) {\n var merged = modifiers.reduce(function (merged, current) {\n var existing = merged[current.name];\n merged[current.name] = existing ? Object.assign({}, existing, current, {\n options: Object.assign({}, existing.options, current.options),\n data: Object.assign({}, existing.data, current.data)\n }) : current;\n return merged;\n }, {}); // IE11 does not support Object.values\n\n return Object.keys(merged).map(function (key) {\n return merged[key];\n });\n}","import { popperGenerator, detectOverflow } from \"./createPopper.js\";\nimport eventListeners from \"./modifiers/eventListeners.js\";\nimport popperOffsets from \"./modifiers/popperOffsets.js\";\nimport computeStyles from \"./modifiers/computeStyles.js\";\nimport applyStyles from \"./modifiers/applyStyles.js\";\nvar defaultModifiers = [eventListeners, popperOffsets, computeStyles, applyStyles];\nvar createPopper = /*#__PURE__*/popperGenerator({\n defaultModifiers: defaultModifiers\n}); // eslint-disable-next-line import/no-unused-modules\n\nexport { createPopper, popperGenerator, defaultModifiers, detectOverflow };","import { popperGenerator, detectOverflow } from \"./createPopper.js\";\nimport eventListeners from \"./modifiers/eventListeners.js\";\nimport popperOffsets from \"./modifiers/popperOffsets.js\";\nimport computeStyles from \"./modifiers/computeStyles.js\";\nimport applyStyles from \"./modifiers/applyStyles.js\";\nimport offset from \"./modifiers/offset.js\";\nimport flip from \"./modifiers/flip.js\";\nimport preventOverflow from \"./modifiers/preventOverflow.js\";\nimport arrow from \"./modifiers/arrow.js\";\nimport hide from \"./modifiers/hide.js\";\nvar defaultModifiers = [eventListeners, popperOffsets, computeStyles, applyStyles, offset, flip, preventOverflow, arrow, hide];\nvar createPopper = /*#__PURE__*/popperGenerator({\n defaultModifiers: defaultModifiers\n}); // eslint-disable-next-line import/no-unused-modules\n\nexport { createPopper, popperGenerator, defaultModifiers, detectOverflow }; // eslint-disable-next-line import/no-unused-modules\n\nexport { createPopper as createPopperLite } from \"./popper-lite.js\"; // eslint-disable-next-line import/no-unused-modules\n\nexport * from \"./modifiers/index.js\";","/**\n * --------------------------------------------------------------------------\n * Bootstrap dropdown.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport * as Popper from '@popperjs/core'\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport Manipulator from './dom/manipulator.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport {\n defineJQueryPlugin,\n execute,\n getElement,\n getNextActiveElement,\n isDisabled,\n isElement,\n isRTL,\n isVisible,\n noop\n} from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'dropdown'\nconst DATA_KEY = 'bs.dropdown'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\n\nconst ESCAPE_KEY = 'Escape'\nconst TAB_KEY = 'Tab'\nconst ARROW_UP_KEY = 'ArrowUp'\nconst ARROW_DOWN_KEY = 'ArrowDown'\nconst RIGHT_MOUSE_BUTTON = 2 // MouseEvent.button value for the secondary button, usually the right button\n\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\nconst EVENT_KEYDOWN_DATA_API = `keydown${EVENT_KEY}${DATA_API_KEY}`\nconst EVENT_KEYUP_DATA_API = `keyup${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_NAME_DROPUP = 'dropup'\nconst CLASS_NAME_DROPEND = 'dropend'\nconst CLASS_NAME_DROPSTART = 'dropstart'\nconst CLASS_NAME_DROPUP_CENTER = 'dropup-center'\nconst CLASS_NAME_DROPDOWN_CENTER = 'dropdown-center'\n\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"dropdown\"]:not(.disabled):not(:disabled)'\nconst SELECTOR_DATA_TOGGLE_SHOWN = `${SELECTOR_DATA_TOGGLE}.${CLASS_NAME_SHOW}`\nconst SELECTOR_MENU = '.dropdown-menu'\nconst SELECTOR_NAVBAR = '.navbar'\nconst SELECTOR_NAVBAR_NAV = '.navbar-nav'\nconst SELECTOR_VISIBLE_ITEMS = '.dropdown-menu .dropdown-item:not(.disabled):not(:disabled)'\n\nconst PLACEMENT_TOP = isRTL() ? 'top-end' : 'top-start'\nconst PLACEMENT_TOPEND = isRTL() ? 'top-start' : 'top-end'\nconst PLACEMENT_BOTTOM = isRTL() ? 'bottom-end' : 'bottom-start'\nconst PLACEMENT_BOTTOMEND = isRTL() ? 'bottom-start' : 'bottom-end'\nconst PLACEMENT_RIGHT = isRTL() ? 'left-start' : 'right-start'\nconst PLACEMENT_LEFT = isRTL() ? 'right-start' : 'left-start'\nconst PLACEMENT_TOPCENTER = 'top'\nconst PLACEMENT_BOTTOMCENTER = 'bottom'\n\nconst Default = {\n autoClose: true,\n boundary: 'clippingParents',\n display: 'dynamic',\n offset: [0, 2],\n popperConfig: null,\n reference: 'toggle'\n}\n\nconst DefaultType = {\n autoClose: '(boolean|string)',\n boundary: '(string|element)',\n display: 'string',\n offset: '(array|string|function)',\n popperConfig: '(null|object|function)',\n reference: '(string|element|object)'\n}\n\n/**\n * Class definition\n */\n\nclass Dropdown extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._popper = null\n this._parent = this._element.parentNode // dropdown wrapper\n // TODO: v6 revert #37011 & change markup https://getbootstrap.com/docs/5.3/forms/input-group/\n this._menu = SelectorEngine.next(this._element, SELECTOR_MENU)[0] ||\n SelectorEngine.prev(this._element, SELECTOR_MENU)[0] ||\n SelectorEngine.findOne(SELECTOR_MENU, this._parent)\n this._inNavbar = this._detectNavbar()\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle() {\n return this._isShown() ? this.hide() : this.show()\n }\n\n show() {\n if (isDisabled(this._element) || this._isShown()) {\n return\n }\n\n const relatedTarget = {\n relatedTarget: this._element\n }\n\n const showEvent = EventHandler.trigger(this._element, EVENT_SHOW, relatedTarget)\n\n if (showEvent.defaultPrevented) {\n return\n }\n\n this._createPopper()\n\n // If this is a touch-enabled device we add extra\n // empty mouseover listeners to the body's immediate children;\n // only needed because of broken event delegation on iOS\n // https://www.quirksmode.org/blog/archives/2014/02/mouse_event_bub.html\n if ('ontouchstart' in document.documentElement && !this._parent.closest(SELECTOR_NAVBAR_NAV)) {\n for (const element of [].concat(...document.body.children)) {\n EventHandler.on(element, 'mouseover', noop)\n }\n }\n\n this._element.focus()\n this._element.setAttribute('aria-expanded', true)\n\n this._menu.classList.add(CLASS_NAME_SHOW)\n this._element.classList.add(CLASS_NAME_SHOW)\n EventHandler.trigger(this._element, EVENT_SHOWN, relatedTarget)\n }\n\n hide() {\n if (isDisabled(this._element) || !this._isShown()) {\n return\n }\n\n const relatedTarget = {\n relatedTarget: this._element\n }\n\n this._completeHide(relatedTarget)\n }\n\n dispose() {\n if (this._popper) {\n this._popper.destroy()\n }\n\n super.dispose()\n }\n\n update() {\n this._inNavbar = this._detectNavbar()\n if (this._popper) {\n this._popper.update()\n }\n }\n\n // Private\n _completeHide(relatedTarget) {\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE, relatedTarget)\n if (hideEvent.defaultPrevented) {\n return\n }\n\n // If this is a touch-enabled device we remove the extra\n // empty mouseover listeners we added for iOS support\n if ('ontouchstart' in document.documentElement) {\n for (const element of [].concat(...document.body.children)) {\n EventHandler.off(element, 'mouseover', noop)\n }\n }\n\n if (this._popper) {\n this._popper.destroy()\n }\n\n this._menu.classList.remove(CLASS_NAME_SHOW)\n this._element.classList.remove(CLASS_NAME_SHOW)\n this._element.setAttribute('aria-expanded', 'false')\n Manipulator.removeDataAttribute(this._menu, 'popper')\n EventHandler.trigger(this._element, EVENT_HIDDEN, relatedTarget)\n }\n\n _getConfig(config) {\n config = super._getConfig(config)\n\n if (typeof config.reference === 'object' && !isElement(config.reference) &&\n typeof config.reference.getBoundingClientRect !== 'function'\n ) {\n // Popper virtual elements require a getBoundingClientRect method\n throw new TypeError(`${NAME.toUpperCase()}: Option \"reference\" provided type \"object\" without a required \"getBoundingClientRect\" method.`)\n }\n\n return config\n }\n\n _createPopper() {\n if (typeof Popper === 'undefined') {\n throw new TypeError('Bootstrap\\'s dropdowns require Popper (https://popper.js.org/docs/v2/)')\n }\n\n let referenceElement = this._element\n\n if (this._config.reference === 'parent') {\n referenceElement = this._parent\n } else if (isElement(this._config.reference)) {\n referenceElement = getElement(this._config.reference)\n } else if (typeof this._config.reference === 'object') {\n referenceElement = this._config.reference\n }\n\n const popperConfig = this._getPopperConfig()\n this._popper = Popper.createPopper(referenceElement, this._menu, popperConfig)\n }\n\n _isShown() {\n return this._menu.classList.contains(CLASS_NAME_SHOW)\n }\n\n _getPlacement() {\n const parentDropdown = this._parent\n\n if (parentDropdown.classList.contains(CLASS_NAME_DROPEND)) {\n return PLACEMENT_RIGHT\n }\n\n if (parentDropdown.classList.contains(CLASS_NAME_DROPSTART)) {\n return PLACEMENT_LEFT\n }\n\n if (parentDropdown.classList.contains(CLASS_NAME_DROPUP_CENTER)) {\n return PLACEMENT_TOPCENTER\n }\n\n if (parentDropdown.classList.contains(CLASS_NAME_DROPDOWN_CENTER)) {\n return PLACEMENT_BOTTOMCENTER\n }\n\n // We need to trim the value because custom properties can also include spaces\n const isEnd = getComputedStyle(this._menu).getPropertyValue('--bs-position').trim() === 'end'\n\n if (parentDropdown.classList.contains(CLASS_NAME_DROPUP)) {\n return isEnd ? PLACEMENT_TOPEND : PLACEMENT_TOP\n }\n\n return isEnd ? PLACEMENT_BOTTOMEND : PLACEMENT_BOTTOM\n }\n\n _detectNavbar() {\n return this._element.closest(SELECTOR_NAVBAR) !== null\n }\n\n _getOffset() {\n const { offset } = this._config\n\n if (typeof offset === 'string') {\n return offset.split(',').map(value => Number.parseInt(value, 10))\n }\n\n if (typeof offset === 'function') {\n return popperData => offset(popperData, this._element)\n }\n\n return offset\n }\n\n _getPopperConfig() {\n const defaultBsPopperConfig = {\n placement: this._getPlacement(),\n modifiers: [{\n name: 'preventOverflow',\n options: {\n boundary: this._config.boundary\n }\n },\n {\n name: 'offset',\n options: {\n offset: this._getOffset()\n }\n }]\n }\n\n // Disable Popper if we have a static display or Dropdown is in Navbar\n if (this._inNavbar || this._config.display === 'static') {\n Manipulator.setDataAttribute(this._menu, 'popper', 'static') // TODO: v6 remove\n defaultBsPopperConfig.modifiers = [{\n name: 'applyStyles',\n enabled: false\n }]\n }\n\n return {\n ...defaultBsPopperConfig,\n ...execute(this._config.popperConfig, [undefined, defaultBsPopperConfig])\n }\n }\n\n _selectMenuItem({ key, target }) {\n const items = SelectorEngine.find(SELECTOR_VISIBLE_ITEMS, this._menu).filter(element => isVisible(element))\n\n if (!items.length) {\n return\n }\n\n // if target isn't included in items (e.g. when expanding the dropdown)\n // allow cycling to get the last item in case key equals ARROW_UP_KEY\n getNextActiveElement(items, target, key === ARROW_DOWN_KEY, !items.includes(target)).focus()\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Dropdown.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n })\n }\n\n static clearMenus(event) {\n if (event.button === RIGHT_MOUSE_BUTTON || (event.type === 'keyup' && event.key !== TAB_KEY)) {\n return\n }\n\n const openToggles = SelectorEngine.find(SELECTOR_DATA_TOGGLE_SHOWN)\n\n for (const toggle of openToggles) {\n const context = Dropdown.getInstance(toggle)\n if (!context || context._config.autoClose === false) {\n continue\n }\n\n const composedPath = event.composedPath()\n const isMenuTarget = composedPath.includes(context._menu)\n if (\n composedPath.includes(context._element) ||\n (context._config.autoClose === 'inside' && !isMenuTarget) ||\n (context._config.autoClose === 'outside' && isMenuTarget)\n ) {\n continue\n }\n\n // Tab navigation through the dropdown menu or events from contained inputs shouldn't close the menu\n if (context._menu.contains(event.target) && ((event.type === 'keyup' && event.key === TAB_KEY) || /input|select|option|textarea|form/i.test(event.target.tagName))) {\n continue\n }\n\n const relatedTarget = { relatedTarget: context._element }\n\n if (event.type === 'click') {\n relatedTarget.clickEvent = event\n }\n\n context._completeHide(relatedTarget)\n }\n }\n\n static dataApiKeydownHandler(event) {\n // If not an UP | DOWN | ESCAPE key => not a dropdown command\n // If input/textarea && if key is other than ESCAPE => not a dropdown command\n\n const isInput = /input|textarea/i.test(event.target.tagName)\n const isEscapeEvent = event.key === ESCAPE_KEY\n const isUpOrDownEvent = [ARROW_UP_KEY, ARROW_DOWN_KEY].includes(event.key)\n\n if (!isUpOrDownEvent && !isEscapeEvent) {\n return\n }\n\n if (isInput && !isEscapeEvent) {\n return\n }\n\n event.preventDefault()\n\n // TODO: v6 revert #37011 & change markup https://getbootstrap.com/docs/5.3/forms/input-group/\n const getToggleButton = this.matches(SELECTOR_DATA_TOGGLE) ?\n this :\n (SelectorEngine.prev(this, SELECTOR_DATA_TOGGLE)[0] ||\n SelectorEngine.next(this, SELECTOR_DATA_TOGGLE)[0] ||\n SelectorEngine.findOne(SELECTOR_DATA_TOGGLE, event.delegateTarget.parentNode))\n\n const instance = Dropdown.getOrCreateInstance(getToggleButton)\n\n if (isUpOrDownEvent) {\n event.stopPropagation()\n instance.show()\n instance._selectMenuItem(event)\n return\n }\n\n if (instance._isShown()) { // else is escape and we check if it is shown\n event.stopPropagation()\n instance.hide()\n getToggleButton.focus()\n }\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_KEYDOWN_DATA_API, SELECTOR_DATA_TOGGLE, Dropdown.dataApiKeydownHandler)\nEventHandler.on(document, EVENT_KEYDOWN_DATA_API, SELECTOR_MENU, Dropdown.dataApiKeydownHandler)\nEventHandler.on(document, EVENT_CLICK_DATA_API, Dropdown.clearMenus)\nEventHandler.on(document, EVENT_KEYUP_DATA_API, Dropdown.clearMenus)\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n event.preventDefault()\n Dropdown.getOrCreateInstance(this).toggle()\n})\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Dropdown)\n\nexport default Dropdown\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/backdrop.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport Config from './config.js'\nimport {\n execute, executeAfterTransition, getElement, reflow\n} from './index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'backdrop'\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\nconst EVENT_MOUSEDOWN = `mousedown.bs.${NAME}`\n\nconst Default = {\n className: 'modal-backdrop',\n clickCallback: null,\n isAnimated: false,\n isVisible: true, // if false, we use the backdrop helper without adding any element to the dom\n rootElement: 'body' // give the choice to place backdrop under different elements\n}\n\nconst DefaultType = {\n className: 'string',\n clickCallback: '(function|null)',\n isAnimated: 'boolean',\n isVisible: 'boolean',\n rootElement: '(element|string)'\n}\n\n/**\n * Class definition\n */\n\nclass Backdrop extends Config {\n constructor(config) {\n super()\n this._config = this._getConfig(config)\n this._isAppended = false\n this._element = null\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n show(callback) {\n if (!this._config.isVisible) {\n execute(callback)\n return\n }\n\n this._append()\n\n const element = this._getElement()\n if (this._config.isAnimated) {\n reflow(element)\n }\n\n element.classList.add(CLASS_NAME_SHOW)\n\n this._emulateAnimation(() => {\n execute(callback)\n })\n }\n\n hide(callback) {\n if (!this._config.isVisible) {\n execute(callback)\n return\n }\n\n this._getElement().classList.remove(CLASS_NAME_SHOW)\n\n this._emulateAnimation(() => {\n this.dispose()\n execute(callback)\n })\n }\n\n dispose() {\n if (!this._isAppended) {\n return\n }\n\n EventHandler.off(this._element, EVENT_MOUSEDOWN)\n\n this._element.remove()\n this._isAppended = false\n }\n\n // Private\n _getElement() {\n if (!this._element) {\n const backdrop = document.createElement('div')\n backdrop.className = this._config.className\n if (this._config.isAnimated) {\n backdrop.classList.add(CLASS_NAME_FADE)\n }\n\n this._element = backdrop\n }\n\n return this._element\n }\n\n _configAfterMerge(config) {\n // use getElement() with the default \"body\" to get a fresh Element on each instantiation\n config.rootElement = getElement(config.rootElement)\n return config\n }\n\n _append() {\n if (this._isAppended) {\n return\n }\n\n const element = this._getElement()\n this._config.rootElement.append(element)\n\n EventHandler.on(element, EVENT_MOUSEDOWN, () => {\n execute(this._config.clickCallback)\n })\n\n this._isAppended = true\n }\n\n _emulateAnimation(callback) {\n executeAfterTransition(callback, this._getElement(), this._config.isAnimated)\n }\n}\n\nexport default Backdrop\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/focustrap.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport EventHandler from '../dom/event-handler.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport Config from './config.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'focustrap'\nconst DATA_KEY = 'bs.focustrap'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst EVENT_FOCUSIN = `focusin${EVENT_KEY}`\nconst EVENT_KEYDOWN_TAB = `keydown.tab${EVENT_KEY}`\n\nconst TAB_KEY = 'Tab'\nconst TAB_NAV_FORWARD = 'forward'\nconst TAB_NAV_BACKWARD = 'backward'\n\nconst Default = {\n autofocus: true,\n trapElement: null // The element to trap focus inside of\n}\n\nconst DefaultType = {\n autofocus: 'boolean',\n trapElement: 'element'\n}\n\n/**\n * Class definition\n */\n\nclass FocusTrap extends Config {\n constructor(config) {\n super()\n this._config = this._getConfig(config)\n this._isActive = false\n this._lastTabNavDirection = null\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n activate() {\n if (this._isActive) {\n return\n }\n\n if (this._config.autofocus) {\n this._config.trapElement.focus()\n }\n\n EventHandler.off(document, EVENT_KEY) // guard against infinite focus loop\n EventHandler.on(document, EVENT_FOCUSIN, event => this._handleFocusin(event))\n EventHandler.on(document, EVENT_KEYDOWN_TAB, event => this._handleKeydown(event))\n\n this._isActive = true\n }\n\n deactivate() {\n if (!this._isActive) {\n return\n }\n\n this._isActive = false\n EventHandler.off(document, EVENT_KEY)\n }\n\n // Private\n _handleFocusin(event) {\n const { trapElement } = this._config\n\n if (event.target === document || event.target === trapElement || trapElement.contains(event.target)) {\n return\n }\n\n const elements = SelectorEngine.focusableChildren(trapElement)\n\n if (elements.length === 0) {\n trapElement.focus()\n } else if (this._lastTabNavDirection === TAB_NAV_BACKWARD) {\n elements[elements.length - 1].focus()\n } else {\n elements[0].focus()\n }\n }\n\n _handleKeydown(event) {\n if (event.key !== TAB_KEY) {\n return\n }\n\n this._lastTabNavDirection = event.shiftKey ? TAB_NAV_BACKWARD : TAB_NAV_FORWARD\n }\n}\n\nexport default FocusTrap\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/scrollBar.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Manipulator from '../dom/manipulator.js'\nimport SelectorEngine from '../dom/selector-engine.js'\nimport { isElement } from './index.js'\n\n/**\n * Constants\n */\n\nconst SELECTOR_FIXED_CONTENT = '.fixed-top, .fixed-bottom, .is-fixed, .sticky-top'\nconst SELECTOR_STICKY_CONTENT = '.sticky-top'\nconst PROPERTY_PADDING = 'padding-right'\nconst PROPERTY_MARGIN = 'margin-right'\n\n/**\n * Class definition\n */\n\nclass ScrollBarHelper {\n constructor() {\n this._element = document.body\n }\n\n // Public\n getWidth() {\n // https://developer.mozilla.org/en-US/docs/Web/API/Window/innerWidth#usage_notes\n const documentWidth = document.documentElement.clientWidth\n return Math.abs(window.innerWidth - documentWidth)\n }\n\n hide() {\n const width = this.getWidth()\n this._disableOverFlow()\n // give padding to element to balance the hidden scrollbar width\n this._setElementAttributes(this._element, PROPERTY_PADDING, calculatedValue => calculatedValue + width)\n // trick: We adjust positive paddingRight and negative marginRight to sticky-top elements to keep showing fullwidth\n this._setElementAttributes(SELECTOR_FIXED_CONTENT, PROPERTY_PADDING, calculatedValue => calculatedValue + width)\n this._setElementAttributes(SELECTOR_STICKY_CONTENT, PROPERTY_MARGIN, calculatedValue => calculatedValue - width)\n }\n\n reset() {\n this._resetElementAttributes(this._element, 'overflow')\n this._resetElementAttributes(this._element, PROPERTY_PADDING)\n this._resetElementAttributes(SELECTOR_FIXED_CONTENT, PROPERTY_PADDING)\n this._resetElementAttributes(SELECTOR_STICKY_CONTENT, PROPERTY_MARGIN)\n }\n\n isOverflowing() {\n return this.getWidth() > 0\n }\n\n // Private\n _disableOverFlow() {\n this._saveInitialAttribute(this._element, 'overflow')\n this._element.style.overflow = 'hidden'\n }\n\n _setElementAttributes(selector, styleProperty, callback) {\n const scrollbarWidth = this.getWidth()\n const manipulationCallBack = element => {\n if (element !== this._element && window.innerWidth > element.clientWidth + scrollbarWidth) {\n return\n }\n\n this._saveInitialAttribute(element, styleProperty)\n const calculatedValue = window.getComputedStyle(element).getPropertyValue(styleProperty)\n element.style.setProperty(styleProperty, `${callback(Number.parseFloat(calculatedValue))}px`)\n }\n\n this._applyManipulationCallback(selector, manipulationCallBack)\n }\n\n _saveInitialAttribute(element, styleProperty) {\n const actualValue = element.style.getPropertyValue(styleProperty)\n if (actualValue) {\n Manipulator.setDataAttribute(element, styleProperty, actualValue)\n }\n }\n\n _resetElementAttributes(selector, styleProperty) {\n const manipulationCallBack = element => {\n const value = Manipulator.getDataAttribute(element, styleProperty)\n // We only want to remove the property if the value is `null`; the value can also be zero\n if (value === null) {\n element.style.removeProperty(styleProperty)\n return\n }\n\n Manipulator.removeDataAttribute(element, styleProperty)\n element.style.setProperty(styleProperty, value)\n }\n\n this._applyManipulationCallback(selector, manipulationCallBack)\n }\n\n _applyManipulationCallback(selector, callBack) {\n if (isElement(selector)) {\n callBack(selector)\n return\n }\n\n for (const sel of SelectorEngine.find(selector, this._element)) {\n callBack(sel)\n }\n }\n}\n\nexport default ScrollBarHelper\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap modal.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport Backdrop from './util/backdrop.js'\nimport { enableDismissTrigger } from './util/component-functions.js'\nimport FocusTrap from './util/focustrap.js'\nimport {\n defineJQueryPlugin, isRTL, isVisible, reflow\n} from './util/index.js'\nimport ScrollBarHelper from './util/scrollbar.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'modal'\nconst DATA_KEY = 'bs.modal'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\nconst ESCAPE_KEY = 'Escape'\n\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDE_PREVENTED = `hidePrevented${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_RESIZE = `resize${EVENT_KEY}`\nconst EVENT_CLICK_DISMISS = `click.dismiss${EVENT_KEY}`\nconst EVENT_MOUSEDOWN_DISMISS = `mousedown.dismiss${EVENT_KEY}`\nconst EVENT_KEYDOWN_DISMISS = `keydown.dismiss${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_OPEN = 'modal-open'\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_NAME_STATIC = 'modal-static'\n\nconst OPEN_SELECTOR = '.modal.show'\nconst SELECTOR_DIALOG = '.modal-dialog'\nconst SELECTOR_MODAL_BODY = '.modal-body'\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"modal\"]'\n\nconst Default = {\n backdrop: true,\n focus: true,\n keyboard: true\n}\n\nconst DefaultType = {\n backdrop: '(boolean|string)',\n focus: 'boolean',\n keyboard: 'boolean'\n}\n\n/**\n * Class definition\n */\n\nclass Modal extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._dialog = SelectorEngine.findOne(SELECTOR_DIALOG, this._element)\n this._backdrop = this._initializeBackDrop()\n this._focustrap = this._initializeFocusTrap()\n this._isShown = false\n this._isTransitioning = false\n this._scrollBar = new ScrollBarHelper()\n\n this._addEventListeners()\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle(relatedTarget) {\n return this._isShown ? this.hide() : this.show(relatedTarget)\n }\n\n show(relatedTarget) {\n if (this._isShown || this._isTransitioning) {\n return\n }\n\n const showEvent = EventHandler.trigger(this._element, EVENT_SHOW, {\n relatedTarget\n })\n\n if (showEvent.defaultPrevented) {\n return\n }\n\n this._isShown = true\n this._isTransitioning = true\n\n this._scrollBar.hide()\n\n document.body.classList.add(CLASS_NAME_OPEN)\n\n this._adjustDialog()\n\n this._backdrop.show(() => this._showElement(relatedTarget))\n }\n\n hide() {\n if (!this._isShown || this._isTransitioning) {\n return\n }\n\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE)\n\n if (hideEvent.defaultPrevented) {\n return\n }\n\n this._isShown = false\n this._isTransitioning = true\n this._focustrap.deactivate()\n\n this._element.classList.remove(CLASS_NAME_SHOW)\n\n this._queueCallback(() => this._hideModal(), this._element, this._isAnimated())\n }\n\n dispose() {\n EventHandler.off(window, EVENT_KEY)\n EventHandler.off(this._dialog, EVENT_KEY)\n\n this._backdrop.dispose()\n this._focustrap.deactivate()\n\n super.dispose()\n }\n\n handleUpdate() {\n this._adjustDialog()\n }\n\n // Private\n _initializeBackDrop() {\n return new Backdrop({\n isVisible: Boolean(this._config.backdrop), // 'static' option will be translated to true, and booleans will keep their value,\n isAnimated: this._isAnimated()\n })\n }\n\n _initializeFocusTrap() {\n return new FocusTrap({\n trapElement: this._element\n })\n }\n\n _showElement(relatedTarget) {\n // try to append dynamic modal\n if (!document.body.contains(this._element)) {\n document.body.append(this._element)\n }\n\n this._element.style.display = 'block'\n this._element.removeAttribute('aria-hidden')\n this._element.setAttribute('aria-modal', true)\n this._element.setAttribute('role', 'dialog')\n this._element.scrollTop = 0\n\n const modalBody = SelectorEngine.findOne(SELECTOR_MODAL_BODY, this._dialog)\n if (modalBody) {\n modalBody.scrollTop = 0\n }\n\n reflow(this._element)\n\n this._element.classList.add(CLASS_NAME_SHOW)\n\n const transitionComplete = () => {\n if (this._config.focus) {\n this._focustrap.activate()\n }\n\n this._isTransitioning = false\n EventHandler.trigger(this._element, EVENT_SHOWN, {\n relatedTarget\n })\n }\n\n this._queueCallback(transitionComplete, this._dialog, this._isAnimated())\n }\n\n _addEventListeners() {\n EventHandler.on(this._element, EVENT_KEYDOWN_DISMISS, event => {\n if (event.key !== ESCAPE_KEY) {\n return\n }\n\n if (this._config.keyboard) {\n this.hide()\n return\n }\n\n this._triggerBackdropTransition()\n })\n\n EventHandler.on(window, EVENT_RESIZE, () => {\n if (this._isShown && !this._isTransitioning) {\n this._adjustDialog()\n }\n })\n\n EventHandler.on(this._element, EVENT_MOUSEDOWN_DISMISS, event => {\n // a bad trick to segregate clicks that may start inside dialog but end outside, and avoid listen to scrollbar clicks\n EventHandler.one(this._element, EVENT_CLICK_DISMISS, event2 => {\n if (this._element !== event.target || this._element !== event2.target) {\n return\n }\n\n if (this._config.backdrop === 'static') {\n this._triggerBackdropTransition()\n return\n }\n\n if (this._config.backdrop) {\n this.hide()\n }\n })\n })\n }\n\n _hideModal() {\n this._element.style.display = 'none'\n this._element.setAttribute('aria-hidden', true)\n this._element.removeAttribute('aria-modal')\n this._element.removeAttribute('role')\n this._isTransitioning = false\n\n this._backdrop.hide(() => {\n document.body.classList.remove(CLASS_NAME_OPEN)\n this._resetAdjustments()\n this._scrollBar.reset()\n EventHandler.trigger(this._element, EVENT_HIDDEN)\n })\n }\n\n _isAnimated() {\n return this._element.classList.contains(CLASS_NAME_FADE)\n }\n\n _triggerBackdropTransition() {\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE_PREVENTED)\n if (hideEvent.defaultPrevented) {\n return\n }\n\n const isModalOverflowing = this._element.scrollHeight > document.documentElement.clientHeight\n const initialOverflowY = this._element.style.overflowY\n // return if the following background transition hasn't yet completed\n if (initialOverflowY === 'hidden' || this._element.classList.contains(CLASS_NAME_STATIC)) {\n return\n }\n\n if (!isModalOverflowing) {\n this._element.style.overflowY = 'hidden'\n }\n\n this._element.classList.add(CLASS_NAME_STATIC)\n this._queueCallback(() => {\n this._element.classList.remove(CLASS_NAME_STATIC)\n this._queueCallback(() => {\n this._element.style.overflowY = initialOverflowY\n }, this._dialog)\n }, this._dialog)\n\n this._element.focus()\n }\n\n /**\n * The following methods are used to handle overflowing modals\n */\n\n _adjustDialog() {\n const isModalOverflowing = this._element.scrollHeight > document.documentElement.clientHeight\n const scrollbarWidth = this._scrollBar.getWidth()\n const isBodyOverflowing = scrollbarWidth > 0\n\n if (isBodyOverflowing && !isModalOverflowing) {\n const property = isRTL() ? 'paddingLeft' : 'paddingRight'\n this._element.style[property] = `${scrollbarWidth}px`\n }\n\n if (!isBodyOverflowing && isModalOverflowing) {\n const property = isRTL() ? 'paddingRight' : 'paddingLeft'\n this._element.style[property] = `${scrollbarWidth}px`\n }\n }\n\n _resetAdjustments() {\n this._element.style.paddingLeft = ''\n this._element.style.paddingRight = ''\n }\n\n // Static\n static jQueryInterface(config, relatedTarget) {\n return this.each(function () {\n const data = Modal.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config](relatedTarget)\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n const target = SelectorEngine.getElementFromSelector(this)\n\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n EventHandler.one(target, EVENT_SHOW, showEvent => {\n if (showEvent.defaultPrevented) {\n // only register focus restorer if modal will actually get shown\n return\n }\n\n EventHandler.one(target, EVENT_HIDDEN, () => {\n if (isVisible(this)) {\n this.focus()\n }\n })\n })\n\n // avoid conflict when clicking modal toggler while another one is open\n const alreadyOpen = SelectorEngine.findOne(OPEN_SELECTOR)\n if (alreadyOpen) {\n Modal.getInstance(alreadyOpen).hide()\n }\n\n const data = Modal.getOrCreateInstance(target)\n\n data.toggle(this)\n})\n\nenableDismissTrigger(Modal)\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Modal)\n\nexport default Modal\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap offcanvas.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport Backdrop from './util/backdrop.js'\nimport { enableDismissTrigger } from './util/component-functions.js'\nimport FocusTrap from './util/focustrap.js'\nimport {\n defineJQueryPlugin,\n isDisabled,\n isVisible\n} from './util/index.js'\nimport ScrollBarHelper from './util/scrollbar.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'offcanvas'\nconst DATA_KEY = 'bs.offcanvas'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\nconst EVENT_LOAD_DATA_API = `load${EVENT_KEY}${DATA_API_KEY}`\nconst ESCAPE_KEY = 'Escape'\n\nconst CLASS_NAME_SHOW = 'show'\nconst CLASS_NAME_SHOWING = 'showing'\nconst CLASS_NAME_HIDING = 'hiding'\nconst CLASS_NAME_BACKDROP = 'offcanvas-backdrop'\nconst OPEN_SELECTOR = '.offcanvas.show'\n\nconst EVENT_SHOW = `show${EVENT_KEY}`\nconst EVENT_SHOWN = `shown${EVENT_KEY}`\nconst EVENT_HIDE = `hide${EVENT_KEY}`\nconst EVENT_HIDE_PREVENTED = `hidePrevented${EVENT_KEY}`\nconst EVENT_HIDDEN = `hidden${EVENT_KEY}`\nconst EVENT_RESIZE = `resize${EVENT_KEY}`\nconst EVENT_CLICK_DATA_API = `click${EVENT_KEY}${DATA_API_KEY}`\nconst EVENT_KEYDOWN_DISMISS = `keydown.dismiss${EVENT_KEY}`\n\nconst SELECTOR_DATA_TOGGLE = '[data-bs-toggle=\"offcanvas\"]'\n\nconst Default = {\n backdrop: true,\n keyboard: true,\n scroll: false\n}\n\nconst DefaultType = {\n backdrop: '(boolean|string)',\n keyboard: 'boolean',\n scroll: 'boolean'\n}\n\n/**\n * Class definition\n */\n\nclass Offcanvas extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n this._isShown = false\n this._backdrop = this._initializeBackDrop()\n this._focustrap = this._initializeFocusTrap()\n this._addEventListeners()\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n toggle(relatedTarget) {\n return this._isShown ? this.hide() : this.show(relatedTarget)\n }\n\n show(relatedTarget) {\n if (this._isShown) {\n return\n }\n\n const showEvent = EventHandler.trigger(this._element, EVENT_SHOW, { relatedTarget })\n\n if (showEvent.defaultPrevented) {\n return\n }\n\n this._isShown = true\n this._backdrop.show()\n\n if (!this._config.scroll) {\n new ScrollBarHelper().hide()\n }\n\n this._element.setAttribute('aria-modal', true)\n this._element.setAttribute('role', 'dialog')\n this._element.classList.add(CLASS_NAME_SHOWING)\n\n const completeCallBack = () => {\n if (!this._config.scroll || this._config.backdrop) {\n this._focustrap.activate()\n }\n\n this._element.classList.add(CLASS_NAME_SHOW)\n this._element.classList.remove(CLASS_NAME_SHOWING)\n EventHandler.trigger(this._element, EVENT_SHOWN, { relatedTarget })\n }\n\n this._queueCallback(completeCallBack, this._element, true)\n }\n\n hide() {\n if (!this._isShown) {\n return\n }\n\n const hideEvent = EventHandler.trigger(this._element, EVENT_HIDE)\n\n if (hideEvent.defaultPrevented) {\n return\n }\n\n this._focustrap.deactivate()\n this._element.blur()\n this._isShown = false\n this._element.classList.add(CLASS_NAME_HIDING)\n this._backdrop.hide()\n\n const completeCallback = () => {\n this._element.classList.remove(CLASS_NAME_SHOW, CLASS_NAME_HIDING)\n this._element.removeAttribute('aria-modal')\n this._element.removeAttribute('role')\n\n if (!this._config.scroll) {\n new ScrollBarHelper().reset()\n }\n\n EventHandler.trigger(this._element, EVENT_HIDDEN)\n }\n\n this._queueCallback(completeCallback, this._element, true)\n }\n\n dispose() {\n this._backdrop.dispose()\n this._focustrap.deactivate()\n super.dispose()\n }\n\n // Private\n _initializeBackDrop() {\n const clickCallback = () => {\n if (this._config.backdrop === 'static') {\n EventHandler.trigger(this._element, EVENT_HIDE_PREVENTED)\n return\n }\n\n this.hide()\n }\n\n // 'static' option will be translated to true, and booleans will keep their value\n const isVisible = Boolean(this._config.backdrop)\n\n return new Backdrop({\n className: CLASS_NAME_BACKDROP,\n isVisible,\n isAnimated: true,\n rootElement: this._element.parentNode,\n clickCallback: isVisible ? clickCallback : null\n })\n }\n\n _initializeFocusTrap() {\n return new FocusTrap({\n trapElement: this._element\n })\n }\n\n _addEventListeners() {\n EventHandler.on(this._element, EVENT_KEYDOWN_DISMISS, event => {\n if (event.key !== ESCAPE_KEY) {\n return\n }\n\n if (this._config.keyboard) {\n this.hide()\n return\n }\n\n EventHandler.trigger(this._element, EVENT_HIDE_PREVENTED)\n })\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Offcanvas.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (data[config] === undefined || config.startsWith('_') || config === 'constructor') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config](this)\n })\n }\n}\n\n/**\n * Data API implementation\n */\n\nEventHandler.on(document, EVENT_CLICK_DATA_API, SELECTOR_DATA_TOGGLE, function (event) {\n const target = SelectorEngine.getElementFromSelector(this)\n\n if (['A', 'AREA'].includes(this.tagName)) {\n event.preventDefault()\n }\n\n if (isDisabled(this)) {\n return\n }\n\n EventHandler.one(target, EVENT_HIDDEN, () => {\n // focus on trigger when it is closed\n if (isVisible(this)) {\n this.focus()\n }\n })\n\n // avoid conflict when clicking a toggler of an offcanvas, while another is open\n const alreadyOpen = SelectorEngine.findOne(OPEN_SELECTOR)\n if (alreadyOpen && alreadyOpen !== target) {\n Offcanvas.getInstance(alreadyOpen).hide()\n }\n\n const data = Offcanvas.getOrCreateInstance(target)\n data.toggle(this)\n})\n\nEventHandler.on(window, EVENT_LOAD_DATA_API, () => {\n for (const selector of SelectorEngine.find(OPEN_SELECTOR)) {\n Offcanvas.getOrCreateInstance(selector).show()\n }\n})\n\nEventHandler.on(window, EVENT_RESIZE, () => {\n for (const element of SelectorEngine.find('[aria-modal][class*=show][class*=offcanvas-]')) {\n if (getComputedStyle(element).position !== 'fixed') {\n Offcanvas.getOrCreateInstance(element).hide()\n }\n }\n})\n\nenableDismissTrigger(Offcanvas)\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Offcanvas)\n\nexport default Offcanvas\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/sanitizer.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\n// js-docs-start allow-list\nconst ARIA_ATTRIBUTE_PATTERN = /^aria-[\\w-]*$/i\n\nexport const DefaultAllowlist = {\n // Global attributes allowed on any supplied element below.\n '*': ['class', 'dir', 'id', 'lang', 'role', ARIA_ATTRIBUTE_PATTERN],\n a: ['target', 'href', 'title', 'rel'],\n area: [],\n b: [],\n br: [],\n col: [],\n code: [],\n dd: [],\n div: [],\n dl: [],\n dt: [],\n em: [],\n hr: [],\n h1: [],\n h2: [],\n h3: [],\n h4: [],\n h5: [],\n h6: [],\n i: [],\n img: ['src', 'srcset', 'alt', 'title', 'width', 'height'],\n li: [],\n ol: [],\n p: [],\n pre: [],\n s: [],\n small: [],\n span: [],\n sub: [],\n sup: [],\n strong: [],\n u: [],\n ul: []\n}\n// js-docs-end allow-list\n\nconst uriAttributes = new Set([\n 'background',\n 'cite',\n 'href',\n 'itemtype',\n 'longdesc',\n 'poster',\n 'src',\n 'xlink:href'\n])\n\n/**\n * A pattern that recognizes URLs that are safe wrt. XSS in URL navigation\n * contexts.\n *\n * Shout-out to Angular https://github.com/angular/angular/blob/15.2.8/packages/core/src/sanitization/url_sanitizer.ts#L38\n */\nconst SAFE_URL_PATTERN = /^(?!javascript:)(?:[a-z0-9+.-]+:|[^&:/?#]*(?:[/?#]|$))/i\n\nconst allowedAttribute = (attribute, allowedAttributeList) => {\n const attributeName = attribute.nodeName.toLowerCase()\n\n if (allowedAttributeList.includes(attributeName)) {\n if (uriAttributes.has(attributeName)) {\n return Boolean(SAFE_URL_PATTERN.test(attribute.nodeValue))\n }\n\n return true\n }\n\n // Check if a regular expression validates the attribute.\n return allowedAttributeList.filter(attributeRegex => attributeRegex instanceof RegExp)\n .some(regex => regex.test(attributeName))\n}\n\nexport function sanitizeHtml(unsafeHtml, allowList, sanitizeFunction) {\n if (!unsafeHtml.length) {\n return unsafeHtml\n }\n\n if (sanitizeFunction && typeof sanitizeFunction === 'function') {\n return sanitizeFunction(unsafeHtml)\n }\n\n const domParser = new window.DOMParser()\n const createdDocument = domParser.parseFromString(unsafeHtml, 'text/html')\n const elements = [].concat(...createdDocument.body.querySelectorAll('*'))\n\n for (const element of elements) {\n const elementName = element.nodeName.toLowerCase()\n\n if (!Object.keys(allowList).includes(elementName)) {\n element.remove()\n continue\n }\n\n const attributeList = [].concat(...element.attributes)\n const allowedAttributes = [].concat(allowList['*'] || [], allowList[elementName] || [])\n\n for (const attribute of attributeList) {\n if (!allowedAttribute(attribute, allowedAttributes)) {\n element.removeAttribute(attribute.nodeName)\n }\n }\n }\n\n return createdDocument.body.innerHTML\n}\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap util/template-factory.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport SelectorEngine from '../dom/selector-engine.js'\nimport Config from './config.js'\nimport { DefaultAllowlist, sanitizeHtml } from './sanitizer.js'\nimport { execute, getElement, isElement } from './index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'TemplateFactory'\n\nconst Default = {\n allowList: DefaultAllowlist,\n content: {}, // { selector : text , selector2 : text2 , }\n extraClass: '',\n html: false,\n sanitize: true,\n sanitizeFn: null,\n template: '
'\n}\n\nconst DefaultType = {\n allowList: 'object',\n content: 'object',\n extraClass: '(string|function)',\n html: 'boolean',\n sanitize: 'boolean',\n sanitizeFn: '(null|function)',\n template: 'string'\n}\n\nconst DefaultContentType = {\n entry: '(string|element|function|null)',\n selector: '(string|element)'\n}\n\n/**\n * Class definition\n */\n\nclass TemplateFactory extends Config {\n constructor(config) {\n super()\n this._config = this._getConfig(config)\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n getContent() {\n return Object.values(this._config.content)\n .map(config => this._resolvePossibleFunction(config))\n .filter(Boolean)\n }\n\n hasContent() {\n return this.getContent().length > 0\n }\n\n changeContent(content) {\n this._checkContent(content)\n this._config.content = { ...this._config.content, ...content }\n return this\n }\n\n toHtml() {\n const templateWrapper = document.createElement('div')\n templateWrapper.innerHTML = this._maybeSanitize(this._config.template)\n\n for (const [selector, text] of Object.entries(this._config.content)) {\n this._setContent(templateWrapper, text, selector)\n }\n\n const template = templateWrapper.children[0]\n const extraClass = this._resolvePossibleFunction(this._config.extraClass)\n\n if (extraClass) {\n template.classList.add(...extraClass.split(' '))\n }\n\n return template\n }\n\n // Private\n _typeCheckConfig(config) {\n super._typeCheckConfig(config)\n this._checkContent(config.content)\n }\n\n _checkContent(arg) {\n for (const [selector, content] of Object.entries(arg)) {\n super._typeCheckConfig({ selector, entry: content }, DefaultContentType)\n }\n }\n\n _setContent(template, content, selector) {\n const templateElement = SelectorEngine.findOne(selector, template)\n\n if (!templateElement) {\n return\n }\n\n content = this._resolvePossibleFunction(content)\n\n if (!content) {\n templateElement.remove()\n return\n }\n\n if (isElement(content)) {\n this._putElementInTemplate(getElement(content), templateElement)\n return\n }\n\n if (this._config.html) {\n templateElement.innerHTML = this._maybeSanitize(content)\n return\n }\n\n templateElement.textContent = content\n }\n\n _maybeSanitize(arg) {\n return this._config.sanitize ? sanitizeHtml(arg, this._config.allowList, this._config.sanitizeFn) : arg\n }\n\n _resolvePossibleFunction(arg) {\n return execute(arg, [undefined, this])\n }\n\n _putElementInTemplate(element, templateElement) {\n if (this._config.html) {\n templateElement.innerHTML = ''\n templateElement.append(element)\n return\n }\n\n templateElement.textContent = element.textContent\n }\n}\n\nexport default TemplateFactory\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap tooltip.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport * as Popper from '@popperjs/core'\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport Manipulator from './dom/manipulator.js'\nimport {\n defineJQueryPlugin, execute, findShadowRoot, getElement, getUID, isRTL, noop\n} from './util/index.js'\nimport { DefaultAllowlist } from './util/sanitizer.js'\nimport TemplateFactory from './util/template-factory.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'tooltip'\nconst DISALLOWED_ATTRIBUTES = new Set(['sanitize', 'allowList', 'sanitizeFn'])\n\nconst CLASS_NAME_FADE = 'fade'\nconst CLASS_NAME_MODAL = 'modal'\nconst CLASS_NAME_SHOW = 'show'\n\nconst SELECTOR_TOOLTIP_INNER = '.tooltip-inner'\nconst SELECTOR_MODAL = `.${CLASS_NAME_MODAL}`\n\nconst EVENT_MODAL_HIDE = 'hide.bs.modal'\n\nconst TRIGGER_HOVER = 'hover'\nconst TRIGGER_FOCUS = 'focus'\nconst TRIGGER_CLICK = 'click'\nconst TRIGGER_MANUAL = 'manual'\n\nconst EVENT_HIDE = 'hide'\nconst EVENT_HIDDEN = 'hidden'\nconst EVENT_SHOW = 'show'\nconst EVENT_SHOWN = 'shown'\nconst EVENT_INSERTED = 'inserted'\nconst EVENT_CLICK = 'click'\nconst EVENT_FOCUSIN = 'focusin'\nconst EVENT_FOCUSOUT = 'focusout'\nconst EVENT_MOUSEENTER = 'mouseenter'\nconst EVENT_MOUSELEAVE = 'mouseleave'\n\nconst AttachmentMap = {\n AUTO: 'auto',\n TOP: 'top',\n RIGHT: isRTL() ? 'left' : 'right',\n BOTTOM: 'bottom',\n LEFT: isRTL() ? 'right' : 'left'\n}\n\nconst Default = {\n allowList: DefaultAllowlist,\n animation: true,\n boundary: 'clippingParents',\n container: false,\n customClass: '',\n delay: 0,\n fallbackPlacements: ['top', 'right', 'bottom', 'left'],\n html: false,\n offset: [0, 6],\n placement: 'top',\n popperConfig: null,\n sanitize: true,\n sanitizeFn: null,\n selector: false,\n template: '
' +\n '
' +\n '
' +\n '
',\n title: '',\n trigger: 'hover focus'\n}\n\nconst DefaultType = {\n allowList: 'object',\n animation: 'boolean',\n boundary: '(string|element)',\n container: '(string|element|boolean)',\n customClass: '(string|function)',\n delay: '(number|object)',\n fallbackPlacements: 'array',\n html: 'boolean',\n offset: '(array|string|function)',\n placement: '(string|function)',\n popperConfig: '(null|object|function)',\n sanitize: 'boolean',\n sanitizeFn: '(null|function)',\n selector: '(string|boolean)',\n template: 'string',\n title: '(string|element|function)',\n trigger: 'string'\n}\n\n/**\n * Class definition\n */\n\nclass Tooltip extends BaseComponent {\n constructor(element, config) {\n if (typeof Popper === 'undefined') {\n throw new TypeError('Bootstrap\\'s tooltips require Popper (https://popper.js.org/docs/v2/)')\n }\n\n super(element, config)\n\n // Private\n this._isEnabled = true\n this._timeout = 0\n this._isHovered = null\n this._activeTrigger = {}\n this._popper = null\n this._templateFactory = null\n this._newContent = null\n\n // Protected\n this.tip = null\n\n this._setListeners()\n\n if (!this._config.selector) {\n this._fixTitle()\n }\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n enable() {\n this._isEnabled = true\n }\n\n disable() {\n this._isEnabled = false\n }\n\n toggleEnabled() {\n this._isEnabled = !this._isEnabled\n }\n\n toggle() {\n if (!this._isEnabled) {\n return\n }\n\n if (this._isShown()) {\n this._leave()\n return\n }\n\n this._enter()\n }\n\n dispose() {\n clearTimeout(this._timeout)\n\n EventHandler.off(this._element.closest(SELECTOR_MODAL), EVENT_MODAL_HIDE, this._hideModalHandler)\n\n if (this._element.getAttribute('data-bs-original-title')) {\n this._element.setAttribute('title', this._element.getAttribute('data-bs-original-title'))\n }\n\n this._disposePopper()\n super.dispose()\n }\n\n show() {\n if (this._element.style.display === 'none') {\n throw new Error('Please use show on visible elements')\n }\n\n if (!(this._isWithContent() && this._isEnabled)) {\n return\n }\n\n const showEvent = EventHandler.trigger(this._element, this.constructor.eventName(EVENT_SHOW))\n const shadowRoot = findShadowRoot(this._element)\n const isInTheDom = (shadowRoot || this._element.ownerDocument.documentElement).contains(this._element)\n\n if (showEvent.defaultPrevented || !isInTheDom) {\n return\n }\n\n // TODO: v6 remove this or make it optional\n this._disposePopper()\n\n const tip = this._getTipElement()\n\n this._element.setAttribute('aria-describedby', tip.getAttribute('id'))\n\n const { container } = this._config\n\n if (!this._element.ownerDocument.documentElement.contains(this.tip)) {\n container.append(tip)\n EventHandler.trigger(this._element, this.constructor.eventName(EVENT_INSERTED))\n }\n\n this._popper = this._createPopper(tip)\n\n tip.classList.add(CLASS_NAME_SHOW)\n\n // If this is a touch-enabled device we add extra\n // empty mouseover listeners to the body's immediate children;\n // only needed because of broken event delegation on iOS\n // https://www.quirksmode.org/blog/archives/2014/02/mouse_event_bub.html\n if ('ontouchstart' in document.documentElement) {\n for (const element of [].concat(...document.body.children)) {\n EventHandler.on(element, 'mouseover', noop)\n }\n }\n\n const complete = () => {\n EventHandler.trigger(this._element, this.constructor.eventName(EVENT_SHOWN))\n\n if (this._isHovered === false) {\n this._leave()\n }\n\n this._isHovered = false\n }\n\n this._queueCallback(complete, this.tip, this._isAnimated())\n }\n\n hide() {\n if (!this._isShown()) {\n return\n }\n\n const hideEvent = EventHandler.trigger(this._element, this.constructor.eventName(EVENT_HIDE))\n if (hideEvent.defaultPrevented) {\n return\n }\n\n const tip = this._getTipElement()\n tip.classList.remove(CLASS_NAME_SHOW)\n\n // If this is a touch-enabled device we remove the extra\n // empty mouseover listeners we added for iOS support\n if ('ontouchstart' in document.documentElement) {\n for (const element of [].concat(...document.body.children)) {\n EventHandler.off(element, 'mouseover', noop)\n }\n }\n\n this._activeTrigger[TRIGGER_CLICK] = false\n this._activeTrigger[TRIGGER_FOCUS] = false\n this._activeTrigger[TRIGGER_HOVER] = false\n this._isHovered = null // it is a trick to support manual triggering\n\n const complete = () => {\n if (this._isWithActiveTrigger()) {\n return\n }\n\n if (!this._isHovered) {\n this._disposePopper()\n }\n\n this._element.removeAttribute('aria-describedby')\n EventHandler.trigger(this._element, this.constructor.eventName(EVENT_HIDDEN))\n }\n\n this._queueCallback(complete, this.tip, this._isAnimated())\n }\n\n update() {\n if (this._popper) {\n this._popper.update()\n }\n }\n\n // Protected\n _isWithContent() {\n return Boolean(this._getTitle())\n }\n\n _getTipElement() {\n if (!this.tip) {\n this.tip = this._createTipElement(this._newContent || this._getContentForTemplate())\n }\n\n return this.tip\n }\n\n _createTipElement(content) {\n const tip = this._getTemplateFactory(content).toHtml()\n\n // TODO: remove this check in v6\n if (!tip) {\n return null\n }\n\n tip.classList.remove(CLASS_NAME_FADE, CLASS_NAME_SHOW)\n // TODO: v6 the following can be achieved with CSS only\n tip.classList.add(`bs-${this.constructor.NAME}-auto`)\n\n const tipId = getUID(this.constructor.NAME).toString()\n\n tip.setAttribute('id', tipId)\n\n if (this._isAnimated()) {\n tip.classList.add(CLASS_NAME_FADE)\n }\n\n return tip\n }\n\n setContent(content) {\n this._newContent = content\n if (this._isShown()) {\n this._disposePopper()\n this.show()\n }\n }\n\n _getTemplateFactory(content) {\n if (this._templateFactory) {\n this._templateFactory.changeContent(content)\n } else {\n this._templateFactory = new TemplateFactory({\n ...this._config,\n // the `content` var has to be after `this._config`\n // to override config.content in case of popover\n content,\n extraClass: this._resolvePossibleFunction(this._config.customClass)\n })\n }\n\n return this._templateFactory\n }\n\n _getContentForTemplate() {\n return {\n [SELECTOR_TOOLTIP_INNER]: this._getTitle()\n }\n }\n\n _getTitle() {\n return this._resolvePossibleFunction(this._config.title) || this._element.getAttribute('data-bs-original-title')\n }\n\n // Private\n _initializeOnDelegatedTarget(event) {\n return this.constructor.getOrCreateInstance(event.delegateTarget, this._getDelegateConfig())\n }\n\n _isAnimated() {\n return this._config.animation || (this.tip && this.tip.classList.contains(CLASS_NAME_FADE))\n }\n\n _isShown() {\n return this.tip && this.tip.classList.contains(CLASS_NAME_SHOW)\n }\n\n _createPopper(tip) {\n const placement = execute(this._config.placement, [this, tip, this._element])\n const attachment = AttachmentMap[placement.toUpperCase()]\n return Popper.createPopper(this._element, tip, this._getPopperConfig(attachment))\n }\n\n _getOffset() {\n const { offset } = this._config\n\n if (typeof offset === 'string') {\n return offset.split(',').map(value => Number.parseInt(value, 10))\n }\n\n if (typeof offset === 'function') {\n return popperData => offset(popperData, this._element)\n }\n\n return offset\n }\n\n _resolvePossibleFunction(arg) {\n return execute(arg, [this._element, this._element])\n }\n\n _getPopperConfig(attachment) {\n const defaultBsPopperConfig = {\n placement: attachment,\n modifiers: [\n {\n name: 'flip',\n options: {\n fallbackPlacements: this._config.fallbackPlacements\n }\n },\n {\n name: 'offset',\n options: {\n offset: this._getOffset()\n }\n },\n {\n name: 'preventOverflow',\n options: {\n boundary: this._config.boundary\n }\n },\n {\n name: 'arrow',\n options: {\n element: `.${this.constructor.NAME}-arrow`\n }\n },\n {\n name: 'preSetPlacement',\n enabled: true,\n phase: 'beforeMain',\n fn: data => {\n // Pre-set Popper's placement attribute in order to read the arrow sizes properly.\n // Otherwise, Popper mixes up the width and height dimensions since the initial arrow style is for top placement\n this._getTipElement().setAttribute('data-popper-placement', data.state.placement)\n }\n }\n ]\n }\n\n return {\n ...defaultBsPopperConfig,\n ...execute(this._config.popperConfig, [undefined, defaultBsPopperConfig])\n }\n }\n\n _setListeners() {\n const triggers = this._config.trigger.split(' ')\n\n for (const trigger of triggers) {\n if (trigger === 'click') {\n EventHandler.on(this._element, this.constructor.eventName(EVENT_CLICK), this._config.selector, event => {\n const context = this._initializeOnDelegatedTarget(event)\n context._activeTrigger[TRIGGER_CLICK] = !(context._isShown() && context._activeTrigger[TRIGGER_CLICK])\n context.toggle()\n })\n } else if (trigger !== TRIGGER_MANUAL) {\n const eventIn = trigger === TRIGGER_HOVER ?\n this.constructor.eventName(EVENT_MOUSEENTER) :\n this.constructor.eventName(EVENT_FOCUSIN)\n const eventOut = trigger === TRIGGER_HOVER ?\n this.constructor.eventName(EVENT_MOUSELEAVE) :\n this.constructor.eventName(EVENT_FOCUSOUT)\n\n EventHandler.on(this._element, eventIn, this._config.selector, event => {\n const context = this._initializeOnDelegatedTarget(event)\n context._activeTrigger[event.type === 'focusin' ? TRIGGER_FOCUS : TRIGGER_HOVER] = true\n context._enter()\n })\n EventHandler.on(this._element, eventOut, this._config.selector, event => {\n const context = this._initializeOnDelegatedTarget(event)\n context._activeTrigger[event.type === 'focusout' ? TRIGGER_FOCUS : TRIGGER_HOVER] =\n context._element.contains(event.relatedTarget)\n\n context._leave()\n })\n }\n }\n\n this._hideModalHandler = () => {\n if (this._element) {\n this.hide()\n }\n }\n\n EventHandler.on(this._element.closest(SELECTOR_MODAL), EVENT_MODAL_HIDE, this._hideModalHandler)\n }\n\n _fixTitle() {\n const title = this._element.getAttribute('title')\n\n if (!title) {\n return\n }\n\n if (!this._element.getAttribute('aria-label') && !this._element.textContent.trim()) {\n this._element.setAttribute('aria-label', title)\n }\n\n this._element.setAttribute('data-bs-original-title', title) // DO NOT USE IT. Is only for backwards compatibility\n this._element.removeAttribute('title')\n }\n\n _enter() {\n if (this._isShown() || this._isHovered) {\n this._isHovered = true\n return\n }\n\n this._isHovered = true\n\n this._setTimeout(() => {\n if (this._isHovered) {\n this.show()\n }\n }, this._config.delay.show)\n }\n\n _leave() {\n if (this._isWithActiveTrigger()) {\n return\n }\n\n this._isHovered = false\n\n this._setTimeout(() => {\n if (!this._isHovered) {\n this.hide()\n }\n }, this._config.delay.hide)\n }\n\n _setTimeout(handler, timeout) {\n clearTimeout(this._timeout)\n this._timeout = setTimeout(handler, timeout)\n }\n\n _isWithActiveTrigger() {\n return Object.values(this._activeTrigger).includes(true)\n }\n\n _getConfig(config) {\n const dataAttributes = Manipulator.getDataAttributes(this._element)\n\n for (const dataAttribute of Object.keys(dataAttributes)) {\n if (DISALLOWED_ATTRIBUTES.has(dataAttribute)) {\n delete dataAttributes[dataAttribute]\n }\n }\n\n config = {\n ...dataAttributes,\n ...(typeof config === 'object' && config ? config : {})\n }\n config = this._mergeConfigObj(config)\n config = this._configAfterMerge(config)\n this._typeCheckConfig(config)\n return config\n }\n\n _configAfterMerge(config) {\n config.container = config.container === false ? document.body : getElement(config.container)\n\n if (typeof config.delay === 'number') {\n config.delay = {\n show: config.delay,\n hide: config.delay\n }\n }\n\n if (typeof config.title === 'number') {\n config.title = config.title.toString()\n }\n\n if (typeof config.content === 'number') {\n config.content = config.content.toString()\n }\n\n return config\n }\n\n _getDelegateConfig() {\n const config = {}\n\n for (const [key, value] of Object.entries(this._config)) {\n if (this.constructor.Default[key] !== value) {\n config[key] = value\n }\n }\n\n config.selector = false\n config.trigger = 'manual'\n\n // In the future can be replaced with:\n // const keysWithDifferentValues = Object.entries(this._config).filter(entry => this.constructor.Default[entry[0]] !== this._config[entry[0]])\n // `Object.fromEntries(keysWithDifferentValues)`\n return config\n }\n\n _disposePopper() {\n if (this._popper) {\n this._popper.destroy()\n this._popper = null\n }\n\n if (this.tip) {\n this.tip.remove()\n this.tip = null\n }\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Tooltip.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n })\n }\n}\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Tooltip)\n\nexport default Tooltip\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap popover.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport Tooltip from './tooltip.js'\nimport { defineJQueryPlugin } from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'popover'\n\nconst SELECTOR_TITLE = '.popover-header'\nconst SELECTOR_CONTENT = '.popover-body'\n\nconst Default = {\n ...Tooltip.Default,\n content: '',\n offset: [0, 8],\n placement: 'right',\n template: '
' +\n '
' +\n '

' +\n '
' +\n '
',\n trigger: 'click'\n}\n\nconst DefaultType = {\n ...Tooltip.DefaultType,\n content: '(null|string|element|function)'\n}\n\n/**\n * Class definition\n */\n\nclass Popover extends Tooltip {\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Overrides\n _isWithContent() {\n return this._getTitle() || this._getContent()\n }\n\n // Private\n _getContentForTemplate() {\n return {\n [SELECTOR_TITLE]: this._getTitle(),\n [SELECTOR_CONTENT]: this._getContent()\n }\n }\n\n _getContent() {\n return this._resolvePossibleFunction(this._config.content)\n }\n\n // Static\n static jQueryInterface(config) {\n return this.each(function () {\n const data = Popover.getOrCreateInstance(this, config)\n\n if (typeof config !== 'string') {\n return\n }\n\n if (typeof data[config] === 'undefined') {\n throw new TypeError(`No method named \"${config}\"`)\n }\n\n data[config]()\n })\n }\n}\n\n/**\n * jQuery\n */\n\ndefineJQueryPlugin(Popover)\n\nexport default Popover\n","/**\n * --------------------------------------------------------------------------\n * Bootstrap scrollspy.js\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/main/LICENSE)\n * --------------------------------------------------------------------------\n */\n\nimport BaseComponent from './base-component.js'\nimport EventHandler from './dom/event-handler.js'\nimport SelectorEngine from './dom/selector-engine.js'\nimport {\n defineJQueryPlugin, getElement, isDisabled, isVisible\n} from './util/index.js'\n\n/**\n * Constants\n */\n\nconst NAME = 'scrollspy'\nconst DATA_KEY = 'bs.scrollspy'\nconst EVENT_KEY = `.${DATA_KEY}`\nconst DATA_API_KEY = '.data-api'\n\nconst EVENT_ACTIVATE = `activate${EVENT_KEY}`\nconst EVENT_CLICK = `click${EVENT_KEY}`\nconst EVENT_LOAD_DATA_API = `load${EVENT_KEY}${DATA_API_KEY}`\n\nconst CLASS_NAME_DROPDOWN_ITEM = 'dropdown-item'\nconst CLASS_NAME_ACTIVE = 'active'\n\nconst SELECTOR_DATA_SPY = '[data-bs-spy=\"scroll\"]'\nconst SELECTOR_TARGET_LINKS = '[href]'\nconst SELECTOR_NAV_LIST_GROUP = '.nav, .list-group'\nconst SELECTOR_NAV_LINKS = '.nav-link'\nconst SELECTOR_NAV_ITEMS = '.nav-item'\nconst SELECTOR_LIST_ITEMS = '.list-group-item'\nconst SELECTOR_LINK_ITEMS = `${SELECTOR_NAV_LINKS}, ${SELECTOR_NAV_ITEMS} > ${SELECTOR_NAV_LINKS}, ${SELECTOR_LIST_ITEMS}`\nconst SELECTOR_DROPDOWN = '.dropdown'\nconst SELECTOR_DROPDOWN_TOGGLE = '.dropdown-toggle'\n\nconst Default = {\n offset: null, // TODO: v6 @deprecated, keep it for backwards compatibility reasons\n rootMargin: '0px 0px -25%',\n smoothScroll: false,\n target: null,\n threshold: [0.1, 0.5, 1]\n}\n\nconst DefaultType = {\n offset: '(number|null)', // TODO v6 @deprecated, keep it for backwards compatibility reasons\n rootMargin: 'string',\n smoothScroll: 'boolean',\n target: 'element',\n threshold: 'array'\n}\n\n/**\n * Class definition\n */\n\nclass ScrollSpy extends BaseComponent {\n constructor(element, config) {\n super(element, config)\n\n // this._element is the observablesContainer and config.target the menu links wrapper\n this._targetLinks = new Map()\n this._observableSections = new Map()\n this._rootElement = getComputedStyle(this._element).overflowY === 'visible' ? null : this._element\n this._activeTarget = null\n this._observer = null\n this._previousScrollData = {\n visibleEntryTop: 0,\n parentScrollTop: 0\n }\n this.refresh() // initialize\n }\n\n // Getters\n static get Default() {\n return Default\n }\n\n static get DefaultType() {\n return DefaultType\n }\n\n static get NAME() {\n return NAME\n }\n\n // Public\n refresh() {\n this._initializeTargetsAndObservables()\n this._maybeEnableSmoothScroll()\n\n if (this._observer) {\n this._observer.disconnect()\n } else {\n this._observer = this._getNewObserver()\n }\n\n for (const section of this._observableSections.values()) {\n this._observer.observe(section)\n }\n }\n\n dispose() {\n this._observer.disconnect()\n super.dispose()\n }\n\n // Private\n _configAfterMerge(config) {\n // TODO: on v6 target should be given explicitly & remove the {target: 'ss-target'} case\n config.target = getElement(config.target) || document.body\n\n // TODO: v6 Only for backwards compatibility reasons. Use rootMargin only\n config.rootMargin = config.offset ? `${config.offset}px 0px -30%` : config.rootMargin\n\n if (typeof config.threshold === 'string') {\n config.threshold = config.threshold.split(',').map(value => Number.parseFloat(value))\n }\n\n return config\n }\n\n _maybeEnableSmoothScroll() {\n if (!this._config.smoothScroll) {\n return\n }\n\n // unregister any previous listeners\n EventHandler.off(this._config.target, EVENT_CLICK)\n\n EventHandler.on(this._config.target, EVENT_CLICK, SELECTOR_TARGET_LINKS, event => {\n const observableSection = this._observableSections.get(event.target.hash)\n if (observableSection) {\n event.preventDefault()\n const root = this._rootElement || window\n const height = observableSection.offsetTop - this._element.offsetTop\n if (root.scrollTo) {\n root.scrollTo({ top: height, behavior: 'smooth' })\n return\n }\n\n // Chrome 60 doesn't support `scrollTo`\n root.scrollTop = height\n }\n })\n }\n\n _getNewObserver() {\n const options = {\n root: this._rootElement,\n threshold: this._config.threshold,\n rootMargin: this._config.rootMargin\n }\n\n return new IntersectionObserver(entries => this._observerCallback(entries), options)\n }\n\n // The logic of selection\n _observerCallback(entries) {\n const targetElement = entry => this._targetLinks.get(`#${entry.target.id}`)\n const activate = entry => {\n this._previousScrollData.visibleEntryTop = entry.target.offsetTop\n this._process(targetElement(entry))\n }\n\n const parentScrollTop = (this._rootElement || document.documentElement).scrollTop\n const userScrollsDown = parentScrollTop >= this._previousScrollData.parentScrollTop\n this._previousScrollData.parentScrollTop = parentScrollTop\n\n for (const entry of entries) {\n if (!entry.isIntersecting) {\n this._activeTarget = null\n this._clearActiveClass(targetElement(entry))\n\n continue\n }\n\n const entryIsLowerThanPrevious = entry.target.offsetTop >= this._previousScrollData.visibleEntryTop\n // if we are scrolling down, pick the bigger offsetTop\n if (userScrollsDown && entryIsLowerThanPrevious) {\n activate(entry)\n // if parent isn't scrolled, let's keep the first visible item, breaking the iteration\n if (!parentScrollTop) {\n return\n }\n\n continue\n }\n\n // if we are scrolling up, pick the smallest offsetTop\n if (!userScrollsDown && !entryIsLowerThanPrevious) {\n activate(entry)\n }\n }\n }\n\n _initializeTargetsAndObservables() {\n this._targetLinks = new Map()\n this._observableSections = new Map()\n\n const targetLinks = SelectorEngine.find(SELECTOR_TARGET_LINKS, this._config.target)\n\n for (const anchor of targetLinks) {\n // ensure that the anchor has an id and is not disabled\n if (!anchor.hash || isDisabled(anchor)) {\n continue\n }\n\n const observableSection = SelectorEngine.findOne(decodeURI(anchor.hash), this._element)\n\n // ensure that the observableSection exists & is visible\n if (isVisible(observableSection)) {\n this._targetLinks.set(decodeURI(anchor.hash), anchor)\n this._observableSections.set(anchor.hash, observableSection)\n }\n }\n }\n\n _process(target) {\n if (this._activeTarget === target) {\n return\n }\n\n this._clearActiveClass(this._config.target)\n this._activeTarget = target\n target.classList.add(CLASS_NAME_ACTIVE)\n this._activateParents(target)\n\n EventHandler.trigger(this._element, EVENT_ACTIVATE, { relatedTarget: target })\n }\n\n _activateParents(target) {\n // Activate dropdown parents\n if (target.classList.contains(CLASS_NAME_DROPDOWN_ITEM)) {\n SelectorEngine.findOne(SELECTOR_DROPDOWN_TOGGLE, target.closest(SELECTOR_DROPDOWN))\n .classList.add(CLASS_NAME_ACTIVE)\n return\n }\n\n for (const listGroup of SelectorEngine.parents(target, SELECTOR_NAV_LIST_GROUP)) {\n // Set triggered links parents as active\n // With both
    and
')},createChildNavList:function(e){var t=this.createNavList();return e.append(t),t},generateNavEl:function(e,t){var n=a('');n.attr("href","#"+e),n.text(t);var r=a("
  • ");return r.append(n),r},generateNavItem:function(e){var t=this.generateAnchor(e),n=a(e),r=n.data("toc-text")||n.text();return this.generateNavEl(t,r)},getTopLevel:function(e){for(var t=1;t<=6;t++){if(1 + + + + + + + + + + + + diff --git a/docs/deps/font-awesome-6.5.2/css/all.css b/docs/deps/font-awesome-6.5.2/css/all.css new file mode 100644 index 00000000..151dd57c --- /dev/null +++ b/docs/deps/font-awesome-6.5.2/css/all.css @@ -0,0 +1,8028 @@ +/*! + * Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com + * License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) + * Copyright 2024 Fonticons, Inc. + */ +.fa { + font-family: var(--fa-style-family, "Font Awesome 6 Free"); + font-weight: var(--fa-style, 900); } + +.fa, +.fa-classic, +.fa-sharp, +.fas, +.fa-solid, +.far, +.fa-regular, +.fab, +.fa-brands { + -moz-osx-font-smoothing: grayscale; + -webkit-font-smoothing: antialiased; + display: var(--fa-display, inline-block); + font-style: normal; + font-variant: normal; + line-height: 1; + text-rendering: auto; } + +.fas, +.fa-classic, +.fa-solid, +.far, +.fa-regular { + font-family: 'Font Awesome 6 Free'; } + +.fab, +.fa-brands { + font-family: 'Font Awesome 6 Brands'; } + +.fa-1x { + font-size: 1em; } + +.fa-2x { + font-size: 2em; } + +.fa-3x { + font-size: 3em; } + +.fa-4x { + font-size: 4em; } + +.fa-5x { + font-size: 5em; } + +.fa-6x { + font-size: 6em; } + +.fa-7x { + font-size: 7em; } + +.fa-8x { + font-size: 8em; } + +.fa-9x { + font-size: 9em; } + +.fa-10x { + font-size: 10em; } + +.fa-2xs { + font-size: 0.625em; + line-height: 0.1em; + vertical-align: 0.225em; } + +.fa-xs { + font-size: 0.75em; + line-height: 0.08333em; + vertical-align: 0.125em; } + +.fa-sm { + font-size: 0.875em; + line-height: 0.07143em; + vertical-align: 0.05357em; } + +.fa-lg { + font-size: 1.25em; + line-height: 0.05em; + vertical-align: -0.075em; } + +.fa-xl { + font-size: 1.5em; + line-height: 0.04167em; + vertical-align: -0.125em; } + +.fa-2xl { + font-size: 2em; + line-height: 0.03125em; + vertical-align: -0.1875em; } + +.fa-fw { + text-align: center; + width: 1.25em; } + +.fa-ul { + list-style-type: none; + margin-left: var(--fa-li-margin, 2.5em); + padding-left: 0; } + .fa-ul > li { + position: relative; } + +.fa-li { + left: calc(var(--fa-li-width, 2em) * -1); + position: absolute; + text-align: center; + width: var(--fa-li-width, 2em); + line-height: inherit; } + +.fa-border { + border-color: var(--fa-border-color, #eee); + border-radius: var(--fa-border-radius, 0.1em); + border-style: var(--fa-border-style, solid); + border-width: var(--fa-border-width, 0.08em); + padding: var(--fa-border-padding, 0.2em 0.25em 0.15em); } + +.fa-pull-left { + float: left; + margin-right: var(--fa-pull-margin, 0.3em); } + +.fa-pull-right { + float: right; + margin-left: var(--fa-pull-margin, 0.3em); } + +.fa-beat { + -webkit-animation-name: fa-beat; + animation-name: fa-beat; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, ease-in-out); + animation-timing-function: var(--fa-animation-timing, ease-in-out); } + +.fa-bounce { + -webkit-animation-name: fa-bounce; + animation-name: fa-bounce; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.28, 0.84, 0.42, 1)); + animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.28, 0.84, 0.42, 1)); } + +.fa-fade { + -webkit-animation-name: fa-fade; + animation-name: fa-fade; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.4, 0, 0.6, 1)); + animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.4, 0, 0.6, 1)); } + +.fa-beat-fade { + -webkit-animation-name: fa-beat-fade; + animation-name: fa-beat-fade; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.4, 0, 0.6, 1)); + animation-timing-function: var(--fa-animation-timing, cubic-bezier(0.4, 0, 0.6, 1)); } + +.fa-flip { + -webkit-animation-name: fa-flip; + animation-name: fa-flip; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, ease-in-out); + animation-timing-function: var(--fa-animation-timing, ease-in-out); } + +.fa-shake { + -webkit-animation-name: fa-shake; + animation-name: fa-shake; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, linear); + animation-timing-function: var(--fa-animation-timing, linear); } + +.fa-spin { + -webkit-animation-name: fa-spin; + animation-name: fa-spin; + -webkit-animation-delay: var(--fa-animation-delay, 0s); + animation-delay: var(--fa-animation-delay, 0s); + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 2s); + animation-duration: var(--fa-animation-duration, 2s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, linear); + animation-timing-function: var(--fa-animation-timing, linear); } + +.fa-spin-reverse { + --fa-animation-direction: reverse; } + +.fa-pulse, +.fa-spin-pulse { + -webkit-animation-name: fa-spin; + animation-name: fa-spin; + -webkit-animation-direction: var(--fa-animation-direction, normal); + animation-direction: var(--fa-animation-direction, normal); + -webkit-animation-duration: var(--fa-animation-duration, 1s); + animation-duration: var(--fa-animation-duration, 1s); + -webkit-animation-iteration-count: var(--fa-animation-iteration-count, infinite); + animation-iteration-count: var(--fa-animation-iteration-count, infinite); + -webkit-animation-timing-function: var(--fa-animation-timing, steps(8)); + animation-timing-function: var(--fa-animation-timing, steps(8)); } + +@media (prefers-reduced-motion: reduce) { + .fa-beat, + .fa-bounce, + .fa-fade, + .fa-beat-fade, + .fa-flip, + .fa-pulse, + .fa-shake, + .fa-spin, + .fa-spin-pulse { + -webkit-animation-delay: -1ms; + animation-delay: -1ms; + -webkit-animation-duration: 1ms; + animation-duration: 1ms; + -webkit-animation-iteration-count: 1; + animation-iteration-count: 1; + -webkit-transition-delay: 0s; + transition-delay: 0s; + -webkit-transition-duration: 0s; + transition-duration: 0s; } } + +@-webkit-keyframes fa-beat { + 0%, 90% { + -webkit-transform: scale(1); + transform: scale(1); } + 45% { + -webkit-transform: scale(var(--fa-beat-scale, 1.25)); + transform: scale(var(--fa-beat-scale, 1.25)); } } + +@keyframes fa-beat { + 0%, 90% { + -webkit-transform: scale(1); + transform: scale(1); } + 45% { + -webkit-transform: scale(var(--fa-beat-scale, 1.25)); + transform: scale(var(--fa-beat-scale, 1.25)); } } + +@-webkit-keyframes fa-bounce { + 0% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } + 10% { + -webkit-transform: scale(var(--fa-bounce-start-scale-x, 1.1), var(--fa-bounce-start-scale-y, 0.9)) translateY(0); + transform: scale(var(--fa-bounce-start-scale-x, 1.1), var(--fa-bounce-start-scale-y, 0.9)) translateY(0); } + 30% { + -webkit-transform: scale(var(--fa-bounce-jump-scale-x, 0.9), var(--fa-bounce-jump-scale-y, 1.1)) translateY(var(--fa-bounce-height, -0.5em)); + transform: scale(var(--fa-bounce-jump-scale-x, 0.9), var(--fa-bounce-jump-scale-y, 1.1)) translateY(var(--fa-bounce-height, -0.5em)); } + 50% { + -webkit-transform: scale(var(--fa-bounce-land-scale-x, 1.05), var(--fa-bounce-land-scale-y, 0.95)) translateY(0); + transform: scale(var(--fa-bounce-land-scale-x, 1.05), var(--fa-bounce-land-scale-y, 0.95)) translateY(0); } + 57% { + -webkit-transform: scale(1, 1) translateY(var(--fa-bounce-rebound, -0.125em)); + transform: scale(1, 1) translateY(var(--fa-bounce-rebound, -0.125em)); } + 64% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } + 100% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } } + +@keyframes fa-bounce { + 0% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } + 10% { + -webkit-transform: scale(var(--fa-bounce-start-scale-x, 1.1), var(--fa-bounce-start-scale-y, 0.9)) translateY(0); + transform: scale(var(--fa-bounce-start-scale-x, 1.1), var(--fa-bounce-start-scale-y, 0.9)) translateY(0); } + 30% { + -webkit-transform: scale(var(--fa-bounce-jump-scale-x, 0.9), var(--fa-bounce-jump-scale-y, 1.1)) translateY(var(--fa-bounce-height, -0.5em)); + transform: scale(var(--fa-bounce-jump-scale-x, 0.9), var(--fa-bounce-jump-scale-y, 1.1)) translateY(var(--fa-bounce-height, -0.5em)); } + 50% { + -webkit-transform: scale(var(--fa-bounce-land-scale-x, 1.05), var(--fa-bounce-land-scale-y, 0.95)) translateY(0); + transform: scale(var(--fa-bounce-land-scale-x, 1.05), var(--fa-bounce-land-scale-y, 0.95)) translateY(0); } + 57% { + -webkit-transform: scale(1, 1) translateY(var(--fa-bounce-rebound, -0.125em)); + transform: scale(1, 1) translateY(var(--fa-bounce-rebound, -0.125em)); } + 64% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } + 100% { + -webkit-transform: scale(1, 1) translateY(0); + transform: scale(1, 1) translateY(0); } } + +@-webkit-keyframes fa-fade { + 50% { + opacity: var(--fa-fade-opacity, 0.4); } } + +@keyframes fa-fade { + 50% { + opacity: var(--fa-fade-opacity, 0.4); } } + +@-webkit-keyframes fa-beat-fade { + 0%, 100% { + opacity: var(--fa-beat-fade-opacity, 0.4); + -webkit-transform: scale(1); + transform: scale(1); } + 50% { + opacity: 1; + -webkit-transform: scale(var(--fa-beat-fade-scale, 1.125)); + transform: scale(var(--fa-beat-fade-scale, 1.125)); } } + +@keyframes fa-beat-fade { + 0%, 100% { + opacity: var(--fa-beat-fade-opacity, 0.4); + -webkit-transform: scale(1); + transform: scale(1); } + 50% { + opacity: 1; + -webkit-transform: scale(var(--fa-beat-fade-scale, 1.125)); + transform: scale(var(--fa-beat-fade-scale, 1.125)); } } + +@-webkit-keyframes fa-flip { + 50% { + -webkit-transform: rotate3d(var(--fa-flip-x, 0), var(--fa-flip-y, 1), var(--fa-flip-z, 0), var(--fa-flip-angle, -180deg)); + transform: rotate3d(var(--fa-flip-x, 0), var(--fa-flip-y, 1), var(--fa-flip-z, 0), var(--fa-flip-angle, -180deg)); } } + +@keyframes fa-flip { + 50% { + -webkit-transform: rotate3d(var(--fa-flip-x, 0), var(--fa-flip-y, 1), var(--fa-flip-z, 0), var(--fa-flip-angle, -180deg)); + transform: rotate3d(var(--fa-flip-x, 0), var(--fa-flip-y, 1), var(--fa-flip-z, 0), var(--fa-flip-angle, -180deg)); } } + +@-webkit-keyframes fa-shake { + 0% { + -webkit-transform: rotate(-15deg); + transform: rotate(-15deg); } + 4% { + -webkit-transform: rotate(15deg); + transform: rotate(15deg); } + 8%, 24% { + -webkit-transform: rotate(-18deg); + transform: rotate(-18deg); } + 12%, 28% { + -webkit-transform: rotate(18deg); + transform: rotate(18deg); } + 16% { + -webkit-transform: rotate(-22deg); + transform: rotate(-22deg); } + 20% { + -webkit-transform: rotate(22deg); + transform: rotate(22deg); } + 32% { + -webkit-transform: rotate(-12deg); + transform: rotate(-12deg); } + 36% { + -webkit-transform: rotate(12deg); + transform: rotate(12deg); } + 40%, 100% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); } } + +@keyframes fa-shake { + 0% { + -webkit-transform: rotate(-15deg); + transform: rotate(-15deg); } + 4% { + -webkit-transform: rotate(15deg); + transform: rotate(15deg); } + 8%, 24% { + -webkit-transform: rotate(-18deg); + transform: rotate(-18deg); } + 12%, 28% { + -webkit-transform: rotate(18deg); + transform: rotate(18deg); } + 16% { + -webkit-transform: rotate(-22deg); + transform: rotate(-22deg); } + 20% { + -webkit-transform: rotate(22deg); + transform: rotate(22deg); } + 32% { + -webkit-transform: rotate(-12deg); + transform: rotate(-12deg); } + 36% { + -webkit-transform: rotate(12deg); + transform: rotate(12deg); } + 40%, 100% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); } } + +@-webkit-keyframes fa-spin { + 0% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); } + 100% { + -webkit-transform: rotate(360deg); + transform: rotate(360deg); } } + +@keyframes fa-spin { + 0% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); } + 100% { + -webkit-transform: rotate(360deg); + transform: rotate(360deg); } } + +.fa-rotate-90 { + -webkit-transform: rotate(90deg); + transform: rotate(90deg); } + +.fa-rotate-180 { + -webkit-transform: rotate(180deg); + transform: rotate(180deg); } + +.fa-rotate-270 { + -webkit-transform: rotate(270deg); + transform: rotate(270deg); } + +.fa-flip-horizontal { + -webkit-transform: scale(-1, 1); + transform: scale(-1, 1); } + +.fa-flip-vertical { + -webkit-transform: scale(1, -1); + transform: scale(1, -1); } + +.fa-flip-both, +.fa-flip-horizontal.fa-flip-vertical { + -webkit-transform: scale(-1, -1); + transform: scale(-1, -1); } + +.fa-rotate-by { + -webkit-transform: rotate(var(--fa-rotate-angle, 0)); + transform: rotate(var(--fa-rotate-angle, 0)); } + +.fa-stack { + display: inline-block; + height: 2em; + line-height: 2em; + position: relative; + vertical-align: middle; + width: 2.5em; } + +.fa-stack-1x, +.fa-stack-2x { + left: 0; + position: absolute; + text-align: center; + width: 100%; + z-index: var(--fa-stack-z-index, auto); } + +.fa-stack-1x { + line-height: inherit; } + +.fa-stack-2x { + font-size: 2em; } + +.fa-inverse { + color: var(--fa-inverse, #fff); } + +/* Font Awesome uses the Unicode Private Use Area (PUA) to ensure screen +readers do not read off random characters that represent icons */ + +.fa-0::before { + content: "\30"; } + +.fa-1::before { + content: "\31"; } + +.fa-2::before { + content: "\32"; } + +.fa-3::before { + content: "\33"; } + +.fa-4::before { + content: "\34"; } + +.fa-5::before { + content: "\35"; } + +.fa-6::before { + content: "\36"; } + +.fa-7::before { + content: "\37"; } + +.fa-8::before { + content: "\38"; } + +.fa-9::before { + content: "\39"; } + +.fa-fill-drip::before { + content: "\f576"; } + +.fa-arrows-to-circle::before { + content: "\e4bd"; } + +.fa-circle-chevron-right::before { + content: "\f138"; } + +.fa-chevron-circle-right::before { + content: "\f138"; } + +.fa-at::before { + content: "\40"; } + +.fa-trash-can::before { + content: "\f2ed"; } + +.fa-trash-alt::before { + content: "\f2ed"; } + +.fa-text-height::before { + content: "\f034"; } + +.fa-user-xmark::before { + content: "\f235"; } + +.fa-user-times::before { + content: "\f235"; } + +.fa-stethoscope::before { + content: "\f0f1"; } + +.fa-message::before { + content: "\f27a"; } + +.fa-comment-alt::before { + content: "\f27a"; } + +.fa-info::before { + content: "\f129"; } + +.fa-down-left-and-up-right-to-center::before { + content: "\f422"; } + +.fa-compress-alt::before { + content: "\f422"; } + +.fa-explosion::before { + content: "\e4e9"; } + +.fa-file-lines::before { + content: "\f15c"; } + +.fa-file-alt::before { + content: "\f15c"; } + +.fa-file-text::before { + content: "\f15c"; } + +.fa-wave-square::before { + content: "\f83e"; } + +.fa-ring::before { + content: "\f70b"; } + +.fa-building-un::before { + content: "\e4d9"; } + +.fa-dice-three::before { + content: "\f527"; } + +.fa-calendar-days::before { + content: "\f073"; } + +.fa-calendar-alt::before { + content: "\f073"; } + +.fa-anchor-circle-check::before { + content: "\e4aa"; } + +.fa-building-circle-arrow-right::before { + content: "\e4d1"; } + +.fa-volleyball::before { + content: "\f45f"; } + +.fa-volleyball-ball::before { + content: "\f45f"; } + +.fa-arrows-up-to-line::before { + content: "\e4c2"; } + +.fa-sort-down::before { + content: "\f0dd"; } + +.fa-sort-desc::before { + content: "\f0dd"; } + +.fa-circle-minus::before { + content: "\f056"; } + +.fa-minus-circle::before { + content: "\f056"; } + +.fa-door-open::before { + content: "\f52b"; } + +.fa-right-from-bracket::before { + content: "\f2f5"; } + +.fa-sign-out-alt::before { + content: "\f2f5"; } + +.fa-atom::before { + content: "\f5d2"; } + +.fa-soap::before { + content: "\e06e"; } + +.fa-icons::before { + content: "\f86d"; } + +.fa-heart-music-camera-bolt::before { + content: "\f86d"; } + +.fa-microphone-lines-slash::before { + content: "\f539"; } + +.fa-microphone-alt-slash::before { + content: "\f539"; } + +.fa-bridge-circle-check::before { + content: "\e4c9"; } + +.fa-pump-medical::before { + content: "\e06a"; } + +.fa-fingerprint::before { + content: "\f577"; } + +.fa-hand-point-right::before { + content: "\f0a4"; } + +.fa-magnifying-glass-location::before { + content: "\f689"; } + +.fa-search-location::before { + content: "\f689"; } + +.fa-forward-step::before { + content: "\f051"; } + +.fa-step-forward::before { + content: "\f051"; } + +.fa-face-smile-beam::before { + content: "\f5b8"; } + +.fa-smile-beam::before { + content: "\f5b8"; } + +.fa-flag-checkered::before { + content: "\f11e"; } + +.fa-football::before { + content: "\f44e"; } + +.fa-football-ball::before { + content: "\f44e"; } + +.fa-school-circle-exclamation::before { + content: "\e56c"; } + +.fa-crop::before { + content: "\f125"; } + +.fa-angles-down::before { + content: "\f103"; } + +.fa-angle-double-down::before { + content: "\f103"; } + +.fa-users-rectangle::before { + content: "\e594"; } + +.fa-people-roof::before { + content: "\e537"; } + +.fa-people-line::before { + content: "\e534"; } + +.fa-beer-mug-empty::before { + content: "\f0fc"; } + +.fa-beer::before { + content: "\f0fc"; } + +.fa-diagram-predecessor::before { + content: "\e477"; } + +.fa-arrow-up-long::before { + content: "\f176"; } + +.fa-long-arrow-up::before { + content: "\f176"; } + +.fa-fire-flame-simple::before { + content: "\f46a"; } + +.fa-burn::before { + content: "\f46a"; } + +.fa-person::before { + content: "\f183"; } + +.fa-male::before { + content: "\f183"; } + +.fa-laptop::before { + content: "\f109"; } + +.fa-file-csv::before { + content: "\f6dd"; } + +.fa-menorah::before { + content: "\f676"; } + +.fa-truck-plane::before { + content: "\e58f"; } + +.fa-record-vinyl::before { + content: "\f8d9"; } + +.fa-face-grin-stars::before { + content: "\f587"; } + +.fa-grin-stars::before { + content: "\f587"; } + +.fa-bong::before { + content: "\f55c"; } + +.fa-spaghetti-monster-flying::before { + content: "\f67b"; } + +.fa-pastafarianism::before { + content: "\f67b"; } + +.fa-arrow-down-up-across-line::before { + content: "\e4af"; } + +.fa-spoon::before { + content: "\f2e5"; } + +.fa-utensil-spoon::before { + content: "\f2e5"; } + +.fa-jar-wheat::before { + content: "\e517"; } + +.fa-envelopes-bulk::before { + content: "\f674"; } + +.fa-mail-bulk::before { + content: "\f674"; } + +.fa-file-circle-exclamation::before { + content: "\e4eb"; } + +.fa-circle-h::before { + content: "\f47e"; } + +.fa-hospital-symbol::before { + content: "\f47e"; } + +.fa-pager::before { + content: "\f815"; } + +.fa-address-book::before { + content: "\f2b9"; } + +.fa-contact-book::before { + content: "\f2b9"; } + +.fa-strikethrough::before { + content: "\f0cc"; } + +.fa-k::before { + content: "\4b"; } + +.fa-landmark-flag::before { + content: "\e51c"; } + +.fa-pencil::before { + content: "\f303"; } + +.fa-pencil-alt::before { + content: "\f303"; } + +.fa-backward::before { + content: "\f04a"; } + +.fa-caret-right::before { + content: "\f0da"; } + +.fa-comments::before { + content: "\f086"; } + +.fa-paste::before { + content: "\f0ea"; } + +.fa-file-clipboard::before { + content: "\f0ea"; } + +.fa-code-pull-request::before { + content: "\e13c"; } + +.fa-clipboard-list::before { + content: "\f46d"; } + +.fa-truck-ramp-box::before { + content: "\f4de"; } + +.fa-truck-loading::before { + content: "\f4de"; } + +.fa-user-check::before { + content: "\f4fc"; } + +.fa-vial-virus::before { + content: "\e597"; } + +.fa-sheet-plastic::before { + content: "\e571"; } + +.fa-blog::before { + content: "\f781"; } + +.fa-user-ninja::before { + content: "\f504"; } + +.fa-person-arrow-up-from-line::before { + content: "\e539"; } + +.fa-scroll-torah::before { + content: "\f6a0"; } + +.fa-torah::before { + content: "\f6a0"; } + +.fa-broom-ball::before { + content: "\f458"; } + +.fa-quidditch::before { + content: "\f458"; } + +.fa-quidditch-broom-ball::before { + content: "\f458"; } + +.fa-toggle-off::before { + content: "\f204"; } + +.fa-box-archive::before { + content: "\f187"; } + +.fa-archive::before { + content: "\f187"; } + +.fa-person-drowning::before { + content: "\e545"; } + +.fa-arrow-down-9-1::before { + content: "\f886"; } + +.fa-sort-numeric-desc::before { + content: "\f886"; } + +.fa-sort-numeric-down-alt::before { + content: "\f886"; } + +.fa-face-grin-tongue-squint::before { + content: "\f58a"; } + +.fa-grin-tongue-squint::before { + content: "\f58a"; } + +.fa-spray-can::before { + content: "\f5bd"; } + +.fa-truck-monster::before { + content: "\f63b"; } + +.fa-w::before { + content: "\57"; } + +.fa-earth-africa::before { + content: "\f57c"; } + +.fa-globe-africa::before { + content: "\f57c"; } + +.fa-rainbow::before { + content: "\f75b"; } + +.fa-circle-notch::before { + content: "\f1ce"; } + +.fa-tablet-screen-button::before { + content: "\f3fa"; } + +.fa-tablet-alt::before { + content: "\f3fa"; } + +.fa-paw::before { + content: "\f1b0"; } + +.fa-cloud::before { + content: "\f0c2"; } + +.fa-trowel-bricks::before { + content: "\e58a"; } + +.fa-face-flushed::before { + content: "\f579"; } + +.fa-flushed::before { + content: "\f579"; } + +.fa-hospital-user::before { + content: "\f80d"; } + +.fa-tent-arrow-left-right::before { + content: "\e57f"; } + +.fa-gavel::before { + content: "\f0e3"; } + +.fa-legal::before { + content: "\f0e3"; } + +.fa-binoculars::before { + content: "\f1e5"; } + +.fa-microphone-slash::before { + content: "\f131"; } + +.fa-box-tissue::before { + content: "\e05b"; } + +.fa-motorcycle::before { + content: "\f21c"; } + +.fa-bell-concierge::before { + content: "\f562"; } + +.fa-concierge-bell::before { + content: "\f562"; } + +.fa-pen-ruler::before { + content: "\f5ae"; } + +.fa-pencil-ruler::before { + content: "\f5ae"; } + +.fa-people-arrows::before { + content: "\e068"; } + +.fa-people-arrows-left-right::before { + content: "\e068"; } + +.fa-mars-and-venus-burst::before { + content: "\e523"; } + +.fa-square-caret-right::before { + content: "\f152"; } + +.fa-caret-square-right::before { + content: "\f152"; } + +.fa-scissors::before { + content: "\f0c4"; } + +.fa-cut::before { + content: "\f0c4"; } + +.fa-sun-plant-wilt::before { + content: "\e57a"; } + +.fa-toilets-portable::before { + content: "\e584"; } + +.fa-hockey-puck::before { + content: "\f453"; } + +.fa-table::before { + content: "\f0ce"; } + +.fa-magnifying-glass-arrow-right::before { + content: "\e521"; } + +.fa-tachograph-digital::before { + content: "\f566"; } + +.fa-digital-tachograph::before { + content: "\f566"; } + +.fa-users-slash::before { + content: "\e073"; } + +.fa-clover::before { + content: "\e139"; } + +.fa-reply::before { + content: "\f3e5"; } + +.fa-mail-reply::before { + content: "\f3e5"; } + +.fa-star-and-crescent::before { + content: "\f699"; } + +.fa-house-fire::before { + content: "\e50c"; } + +.fa-square-minus::before { + content: "\f146"; } + +.fa-minus-square::before { + content: "\f146"; } + +.fa-helicopter::before { + content: "\f533"; } + +.fa-compass::before { + content: "\f14e"; } + +.fa-square-caret-down::before { + content: "\f150"; } + +.fa-caret-square-down::before { + content: "\f150"; } + +.fa-file-circle-question::before { + content: "\e4ef"; } + +.fa-laptop-code::before { + content: "\f5fc"; } + +.fa-swatchbook::before { + content: "\f5c3"; } + +.fa-prescription-bottle::before { + content: "\f485"; } + +.fa-bars::before { + content: "\f0c9"; } + +.fa-navicon::before { + content: "\f0c9"; } + +.fa-people-group::before { + content: "\e533"; } + +.fa-hourglass-end::before { + content: "\f253"; } + +.fa-hourglass-3::before { + content: "\f253"; } + +.fa-heart-crack::before { + content: "\f7a9"; } + +.fa-heart-broken::before { + content: "\f7a9"; } + +.fa-square-up-right::before { + content: "\f360"; } + +.fa-external-link-square-alt::before { + content: "\f360"; } + +.fa-face-kiss-beam::before { + content: "\f597"; } + +.fa-kiss-beam::before { + content: "\f597"; } + +.fa-film::before { + content: "\f008"; } + +.fa-ruler-horizontal::before { + content: "\f547"; } + +.fa-people-robbery::before { + content: "\e536"; } + +.fa-lightbulb::before { + content: "\f0eb"; } + +.fa-caret-left::before { + content: "\f0d9"; } + +.fa-circle-exclamation::before { + content: "\f06a"; } + +.fa-exclamation-circle::before { + content: "\f06a"; } + +.fa-school-circle-xmark::before { + content: "\e56d"; } + +.fa-arrow-right-from-bracket::before { + content: "\f08b"; } + +.fa-sign-out::before { + content: "\f08b"; } + +.fa-circle-chevron-down::before { + content: "\f13a"; } + +.fa-chevron-circle-down::before { + content: "\f13a"; } + +.fa-unlock-keyhole::before { + content: "\f13e"; } + +.fa-unlock-alt::before { + content: "\f13e"; } + +.fa-cloud-showers-heavy::before { + content: "\f740"; } + +.fa-headphones-simple::before { + content: "\f58f"; } + +.fa-headphones-alt::before { + content: "\f58f"; } + +.fa-sitemap::before { + content: "\f0e8"; } + +.fa-circle-dollar-to-slot::before { + content: "\f4b9"; } + +.fa-donate::before { + content: "\f4b9"; } + +.fa-memory::before { + content: "\f538"; } + +.fa-road-spikes::before { + content: "\e568"; } + +.fa-fire-burner::before { + content: "\e4f1"; } + +.fa-flag::before { + content: "\f024"; } + +.fa-hanukiah::before { + content: "\f6e6"; } + +.fa-feather::before { + content: "\f52d"; } + +.fa-volume-low::before { + content: "\f027"; } + +.fa-volume-down::before { + content: "\f027"; } + +.fa-comment-slash::before { + content: "\f4b3"; } + +.fa-cloud-sun-rain::before { + content: "\f743"; } + +.fa-compress::before { + content: "\f066"; } + +.fa-wheat-awn::before { + content: "\e2cd"; } + +.fa-wheat-alt::before { + content: "\e2cd"; } + +.fa-ankh::before { + content: "\f644"; } + +.fa-hands-holding-child::before { + content: "\e4fa"; } + +.fa-asterisk::before { + content: "\2a"; } + +.fa-square-check::before { + content: "\f14a"; } + +.fa-check-square::before { + content: "\f14a"; } + +.fa-peseta-sign::before { + content: "\e221"; } + +.fa-heading::before { + content: "\f1dc"; } + +.fa-header::before { + content: "\f1dc"; } + +.fa-ghost::before { + content: "\f6e2"; } + +.fa-list::before { + content: "\f03a"; } + +.fa-list-squares::before { + content: "\f03a"; } + +.fa-square-phone-flip::before { + content: "\f87b"; } + +.fa-phone-square-alt::before { + content: "\f87b"; } + +.fa-cart-plus::before { + content: "\f217"; } + +.fa-gamepad::before { + content: "\f11b"; } + +.fa-circle-dot::before { + content: "\f192"; } + +.fa-dot-circle::before { + content: "\f192"; } + +.fa-face-dizzy::before { + content: "\f567"; } + +.fa-dizzy::before { + content: "\f567"; } + +.fa-egg::before { + content: "\f7fb"; } + +.fa-house-medical-circle-xmark::before { + content: "\e513"; } + +.fa-campground::before { + content: "\f6bb"; } + +.fa-folder-plus::before { + content: "\f65e"; } + +.fa-futbol::before { + content: "\f1e3"; } + +.fa-futbol-ball::before { + content: "\f1e3"; } + +.fa-soccer-ball::before { + content: "\f1e3"; } + +.fa-paintbrush::before { + content: "\f1fc"; } + +.fa-paint-brush::before { + content: "\f1fc"; } + +.fa-lock::before { + content: "\f023"; } + +.fa-gas-pump::before { + content: "\f52f"; } + +.fa-hot-tub-person::before { + content: "\f593"; } + +.fa-hot-tub::before { + content: "\f593"; } + +.fa-map-location::before { + content: "\f59f"; } + +.fa-map-marked::before { + content: "\f59f"; } + +.fa-house-flood-water::before { + content: "\e50e"; } + +.fa-tree::before { + content: "\f1bb"; } + +.fa-bridge-lock::before { + content: "\e4cc"; } + +.fa-sack-dollar::before { + content: "\f81d"; } + +.fa-pen-to-square::before { + content: "\f044"; } + +.fa-edit::before { + content: "\f044"; } + +.fa-car-side::before { + content: "\f5e4"; } + +.fa-share-nodes::before { + content: "\f1e0"; } + +.fa-share-alt::before { + content: "\f1e0"; } + +.fa-heart-circle-minus::before { + content: "\e4ff"; } + +.fa-hourglass-half::before { + content: "\f252"; } + +.fa-hourglass-2::before { + content: "\f252"; } + +.fa-microscope::before { + content: "\f610"; } + +.fa-sink::before { + content: "\e06d"; } + +.fa-bag-shopping::before { + content: "\f290"; } + +.fa-shopping-bag::before { + content: "\f290"; } + +.fa-arrow-down-z-a::before { + content: "\f881"; } + +.fa-sort-alpha-desc::before { + content: "\f881"; } + +.fa-sort-alpha-down-alt::before { + content: "\f881"; } + +.fa-mitten::before { + content: "\f7b5"; } + +.fa-person-rays::before { + content: "\e54d"; } + +.fa-users::before { + content: "\f0c0"; } + +.fa-eye-slash::before { + content: "\f070"; } + +.fa-flask-vial::before { + content: "\e4f3"; } + +.fa-hand::before { + content: "\f256"; } + +.fa-hand-paper::before { + content: "\f256"; } + +.fa-om::before { + content: "\f679"; } + +.fa-worm::before { + content: "\e599"; } + +.fa-house-circle-xmark::before { + content: "\e50b"; } + +.fa-plug::before { + content: "\f1e6"; } + +.fa-chevron-up::before { + content: "\f077"; } + +.fa-hand-spock::before { + content: "\f259"; } + +.fa-stopwatch::before { + content: "\f2f2"; } + +.fa-face-kiss::before { + content: "\f596"; } + +.fa-kiss::before { + content: "\f596"; } + +.fa-bridge-circle-xmark::before { + content: "\e4cb"; } + +.fa-face-grin-tongue::before { + content: "\f589"; } + +.fa-grin-tongue::before { + content: "\f589"; } + +.fa-chess-bishop::before { + content: "\f43a"; } + +.fa-face-grin-wink::before { + content: "\f58c"; } + +.fa-grin-wink::before { + content: "\f58c"; } + +.fa-ear-deaf::before { + content: "\f2a4"; } + +.fa-deaf::before { + content: "\f2a4"; } + +.fa-deafness::before { + content: "\f2a4"; } + +.fa-hard-of-hearing::before { + content: "\f2a4"; } + +.fa-road-circle-check::before { + content: "\e564"; } + +.fa-dice-five::before { + content: "\f523"; } + +.fa-square-rss::before { + content: "\f143"; } + +.fa-rss-square::before { + content: "\f143"; } + +.fa-land-mine-on::before { + content: "\e51b"; } + +.fa-i-cursor::before { + content: "\f246"; } + +.fa-stamp::before { + content: "\f5bf"; } + +.fa-stairs::before { + content: "\e289"; } + +.fa-i::before { + content: "\49"; } + +.fa-hryvnia-sign::before { + content: "\f6f2"; } + +.fa-hryvnia::before { + content: "\f6f2"; } + +.fa-pills::before { + content: "\f484"; } + +.fa-face-grin-wide::before { + content: "\f581"; } + +.fa-grin-alt::before { + content: "\f581"; } + +.fa-tooth::before { + content: "\f5c9"; } + +.fa-v::before { + content: "\56"; } + +.fa-bangladeshi-taka-sign::before { + content: "\e2e6"; } + +.fa-bicycle::before { + content: "\f206"; } + +.fa-staff-snake::before { + content: "\e579"; } + +.fa-rod-asclepius::before { + content: "\e579"; } + +.fa-rod-snake::before { + content: "\e579"; } + +.fa-staff-aesculapius::before { + content: "\e579"; } + +.fa-head-side-cough-slash::before { + content: "\e062"; } + +.fa-truck-medical::before { + content: "\f0f9"; } + +.fa-ambulance::before { + content: "\f0f9"; } + +.fa-wheat-awn-circle-exclamation::before { + content: "\e598"; } + +.fa-snowman::before { + content: "\f7d0"; } + +.fa-mortar-pestle::before { + content: "\f5a7"; } + +.fa-road-barrier::before { + content: "\e562"; } + +.fa-school::before { + content: "\f549"; } + +.fa-igloo::before { + content: "\f7ae"; } + +.fa-joint::before { + content: "\f595"; } + +.fa-angle-right::before { + content: "\f105"; } + +.fa-horse::before { + content: "\f6f0"; } + +.fa-q::before { + content: "\51"; } + +.fa-g::before { + content: "\47"; } + +.fa-notes-medical::before { + content: "\f481"; } + +.fa-temperature-half::before { + content: "\f2c9"; } + +.fa-temperature-2::before { + content: "\f2c9"; } + +.fa-thermometer-2::before { + content: "\f2c9"; } + +.fa-thermometer-half::before { + content: "\f2c9"; } + +.fa-dong-sign::before { + content: "\e169"; } + +.fa-capsules::before { + content: "\f46b"; } + +.fa-poo-storm::before { + content: "\f75a"; } + +.fa-poo-bolt::before { + content: "\f75a"; } + +.fa-face-frown-open::before { + content: "\f57a"; } + +.fa-frown-open::before { + content: "\f57a"; } + +.fa-hand-point-up::before { + content: "\f0a6"; } + +.fa-money-bill::before { + content: "\f0d6"; } + +.fa-bookmark::before { + content: "\f02e"; } + +.fa-align-justify::before { + content: "\f039"; } + +.fa-umbrella-beach::before { + content: "\f5ca"; } + +.fa-helmet-un::before { + content: "\e503"; } + +.fa-bullseye::before { + content: "\f140"; } + +.fa-bacon::before { + content: "\f7e5"; } + +.fa-hand-point-down::before { + content: "\f0a7"; } + +.fa-arrow-up-from-bracket::before { + content: "\e09a"; } + +.fa-folder::before { + content: "\f07b"; } + +.fa-folder-blank::before { + content: "\f07b"; } + +.fa-file-waveform::before { + content: "\f478"; } + +.fa-file-medical-alt::before { + content: "\f478"; } + +.fa-radiation::before { + content: "\f7b9"; } + +.fa-chart-simple::before { + content: "\e473"; } + +.fa-mars-stroke::before { + content: "\f229"; } + +.fa-vial::before { + content: "\f492"; } + +.fa-gauge::before { + content: "\f624"; } + +.fa-dashboard::before { + content: "\f624"; } + +.fa-gauge-med::before { + content: "\f624"; } + +.fa-tachometer-alt-average::before { + content: "\f624"; } + +.fa-wand-magic-sparkles::before { + content: "\e2ca"; } + +.fa-magic-wand-sparkles::before { + content: "\e2ca"; } + +.fa-e::before { + content: "\45"; } + +.fa-pen-clip::before { + content: "\f305"; } + +.fa-pen-alt::before { + content: "\f305"; } + +.fa-bridge-circle-exclamation::before { + content: "\e4ca"; } + +.fa-user::before { + content: "\f007"; } + +.fa-school-circle-check::before { + content: "\e56b"; } + +.fa-dumpster::before { + content: "\f793"; } + +.fa-van-shuttle::before { + content: "\f5b6"; } + +.fa-shuttle-van::before { + content: "\f5b6"; } + +.fa-building-user::before { + content: "\e4da"; } + +.fa-square-caret-left::before { + content: "\f191"; } + +.fa-caret-square-left::before { + content: "\f191"; } + +.fa-highlighter::before { + content: "\f591"; } + +.fa-key::before { + content: "\f084"; } + +.fa-bullhorn::before { + content: "\f0a1"; } + +.fa-globe::before { + content: "\f0ac"; } + +.fa-synagogue::before { + content: "\f69b"; } + +.fa-person-half-dress::before { + content: "\e548"; } + +.fa-road-bridge::before { + content: "\e563"; } + +.fa-location-arrow::before { + content: "\f124"; } + +.fa-c::before { + content: "\43"; } + +.fa-tablet-button::before { + content: "\f10a"; } + +.fa-building-lock::before { + content: "\e4d6"; } + +.fa-pizza-slice::before { + content: "\f818"; } + +.fa-money-bill-wave::before { + content: "\f53a"; } + +.fa-chart-area::before { + content: "\f1fe"; } + +.fa-area-chart::before { + content: "\f1fe"; } + +.fa-house-flag::before { + content: "\e50d"; } + +.fa-person-circle-minus::before { + content: "\e540"; } + +.fa-ban::before { + content: "\f05e"; } + +.fa-cancel::before { + content: "\f05e"; } + +.fa-camera-rotate::before { + content: "\e0d8"; } + +.fa-spray-can-sparkles::before { + content: "\f5d0"; } + +.fa-air-freshener::before { + content: "\f5d0"; } + +.fa-star::before { + content: "\f005"; } + +.fa-repeat::before { + content: "\f363"; } + +.fa-cross::before { + content: "\f654"; } + +.fa-box::before { + content: "\f466"; } + +.fa-venus-mars::before { + content: "\f228"; } + +.fa-arrow-pointer::before { + content: "\f245"; } + +.fa-mouse-pointer::before { + content: "\f245"; } + +.fa-maximize::before { + content: "\f31e"; } + +.fa-expand-arrows-alt::before { + content: "\f31e"; } + +.fa-charging-station::before { + content: "\f5e7"; } + +.fa-shapes::before { + content: "\f61f"; } + +.fa-triangle-circle-square::before { + content: "\f61f"; } + +.fa-shuffle::before { + content: "\f074"; } + +.fa-random::before { + content: "\f074"; } + +.fa-person-running::before { + content: "\f70c"; } + +.fa-running::before { + content: "\f70c"; } + +.fa-mobile-retro::before { + content: "\e527"; } + +.fa-grip-lines-vertical::before { + content: "\f7a5"; } + +.fa-spider::before { + content: "\f717"; } + +.fa-hands-bound::before { + content: "\e4f9"; } + +.fa-file-invoice-dollar::before { + content: "\f571"; } + +.fa-plane-circle-exclamation::before { + content: "\e556"; } + +.fa-x-ray::before { + content: "\f497"; } + +.fa-spell-check::before { + content: "\f891"; } + +.fa-slash::before { + content: "\f715"; } + +.fa-computer-mouse::before { + content: "\f8cc"; } + +.fa-mouse::before { + content: "\f8cc"; } + +.fa-arrow-right-to-bracket::before { + content: "\f090"; } + +.fa-sign-in::before { + content: "\f090"; } + +.fa-shop-slash::before { + content: "\e070"; } + +.fa-store-alt-slash::before { + content: "\e070"; } + +.fa-server::before { + content: "\f233"; } + +.fa-virus-covid-slash::before { + content: "\e4a9"; } + +.fa-shop-lock::before { + content: "\e4a5"; } + +.fa-hourglass-start::before { + content: "\f251"; } + +.fa-hourglass-1::before { + content: "\f251"; } + +.fa-blender-phone::before { + content: "\f6b6"; } + +.fa-building-wheat::before { + content: "\e4db"; } + +.fa-person-breastfeeding::before { + content: "\e53a"; } + +.fa-right-to-bracket::before { + content: "\f2f6"; } + +.fa-sign-in-alt::before { + content: "\f2f6"; } + +.fa-venus::before { + content: "\f221"; } + +.fa-passport::before { + content: "\f5ab"; } + +.fa-heart-pulse::before { + content: "\f21e"; } + +.fa-heartbeat::before { + content: "\f21e"; } + +.fa-people-carry-box::before { + content: "\f4ce"; } + +.fa-people-carry::before { + content: "\f4ce"; } + +.fa-temperature-high::before { + content: "\f769"; } + +.fa-microchip::before { + content: "\f2db"; } + +.fa-crown::before { + content: "\f521"; } + +.fa-weight-hanging::before { + content: "\f5cd"; } + +.fa-xmarks-lines::before { + content: "\e59a"; } + +.fa-file-prescription::before { + content: "\f572"; } + +.fa-weight-scale::before { + content: "\f496"; } + +.fa-weight::before { + content: "\f496"; } + +.fa-user-group::before { + content: "\f500"; } + +.fa-user-friends::before { + content: "\f500"; } + +.fa-arrow-up-a-z::before { + content: "\f15e"; } + +.fa-sort-alpha-up::before { + content: "\f15e"; } + +.fa-chess-knight::before { + content: "\f441"; } + +.fa-face-laugh-squint::before { + content: "\f59b"; } + +.fa-laugh-squint::before { + content: "\f59b"; } + +.fa-wheelchair::before { + content: "\f193"; } + +.fa-circle-arrow-up::before { + content: "\f0aa"; } + +.fa-arrow-circle-up::before { + content: "\f0aa"; } + +.fa-toggle-on::before { + content: "\f205"; } + +.fa-person-walking::before { + content: "\f554"; } + +.fa-walking::before { + content: "\f554"; } + +.fa-l::before { + content: "\4c"; } + +.fa-fire::before { + content: "\f06d"; } + +.fa-bed-pulse::before { + content: "\f487"; } + +.fa-procedures::before { + content: "\f487"; } + +.fa-shuttle-space::before { + content: "\f197"; } + +.fa-space-shuttle::before { + content: "\f197"; } + +.fa-face-laugh::before { + content: "\f599"; } + +.fa-laugh::before { + content: "\f599"; } + +.fa-folder-open::before { + content: "\f07c"; } + +.fa-heart-circle-plus::before { + content: "\e500"; } + +.fa-code-fork::before { + content: "\e13b"; } + +.fa-city::before { + content: "\f64f"; } + +.fa-microphone-lines::before { + content: "\f3c9"; } + +.fa-microphone-alt::before { + content: "\f3c9"; } + +.fa-pepper-hot::before { + content: "\f816"; } + +.fa-unlock::before { + content: "\f09c"; } + +.fa-colon-sign::before { + content: "\e140"; } + +.fa-headset::before { + content: "\f590"; } + +.fa-store-slash::before { + content: "\e071"; } + +.fa-road-circle-xmark::before { + content: "\e566"; } + +.fa-user-minus::before { + content: "\f503"; } + +.fa-mars-stroke-up::before { + content: "\f22a"; } + +.fa-mars-stroke-v::before { + content: "\f22a"; } + +.fa-champagne-glasses::before { + content: "\f79f"; } + +.fa-glass-cheers::before { + content: "\f79f"; } + +.fa-clipboard::before { + content: "\f328"; } + +.fa-house-circle-exclamation::before { + content: "\e50a"; } + +.fa-file-arrow-up::before { + content: "\f574"; } + +.fa-file-upload::before { + content: "\f574"; } + +.fa-wifi::before { + content: "\f1eb"; } + +.fa-wifi-3::before { + content: "\f1eb"; } + +.fa-wifi-strong::before { + content: "\f1eb"; } + +.fa-bath::before { + content: "\f2cd"; } + +.fa-bathtub::before { + content: "\f2cd"; } + +.fa-underline::before { + content: "\f0cd"; } + +.fa-user-pen::before { + content: "\f4ff"; } + +.fa-user-edit::before { + content: "\f4ff"; } + +.fa-signature::before { + content: "\f5b7"; } + +.fa-stroopwafel::before { + content: "\f551"; } + +.fa-bold::before { + content: "\f032"; } + +.fa-anchor-lock::before { + content: "\e4ad"; } + +.fa-building-ngo::before { + content: "\e4d7"; } + +.fa-manat-sign::before { + content: "\e1d5"; } + +.fa-not-equal::before { + content: "\f53e"; } + +.fa-border-top-left::before { + content: "\f853"; } + +.fa-border-style::before { + content: "\f853"; } + +.fa-map-location-dot::before { + content: "\f5a0"; } + +.fa-map-marked-alt::before { + content: "\f5a0"; } + +.fa-jedi::before { + content: "\f669"; } + +.fa-square-poll-vertical::before { + content: "\f681"; } + +.fa-poll::before { + content: "\f681"; } + +.fa-mug-hot::before { + content: "\f7b6"; } + +.fa-car-battery::before { + content: "\f5df"; } + +.fa-battery-car::before { + content: "\f5df"; } + +.fa-gift::before { + content: "\f06b"; } + +.fa-dice-two::before { + content: "\f528"; } + +.fa-chess-queen::before { + content: "\f445"; } + +.fa-glasses::before { + content: "\f530"; } + +.fa-chess-board::before { + content: "\f43c"; } + +.fa-building-circle-check::before { + content: "\e4d2"; } + +.fa-person-chalkboard::before { + content: "\e53d"; } + +.fa-mars-stroke-right::before { + content: "\f22b"; } + +.fa-mars-stroke-h::before { + content: "\f22b"; } + +.fa-hand-back-fist::before { + content: "\f255"; } + +.fa-hand-rock::before { + content: "\f255"; } + +.fa-square-caret-up::before { + content: "\f151"; } + +.fa-caret-square-up::before { + content: "\f151"; } + +.fa-cloud-showers-water::before { + content: "\e4e4"; } + +.fa-chart-bar::before { + content: "\f080"; } + +.fa-bar-chart::before { + content: "\f080"; } + +.fa-hands-bubbles::before { + content: "\e05e"; } + +.fa-hands-wash::before { + content: "\e05e"; } + +.fa-less-than-equal::before { + content: "\f537"; } + +.fa-train::before { + content: "\f238"; } + +.fa-eye-low-vision::before { + content: "\f2a8"; } + +.fa-low-vision::before { + content: "\f2a8"; } + +.fa-crow::before { + content: "\f520"; } + +.fa-sailboat::before { + content: "\e445"; } + +.fa-window-restore::before { + content: "\f2d2"; } + +.fa-square-plus::before { + content: "\f0fe"; } + +.fa-plus-square::before { + content: "\f0fe"; } + +.fa-torii-gate::before { + content: "\f6a1"; } + +.fa-frog::before { + content: "\f52e"; } + +.fa-bucket::before { + content: "\e4cf"; } + +.fa-image::before { + content: "\f03e"; } + +.fa-microphone::before { + content: "\f130"; } + +.fa-cow::before { + content: "\f6c8"; } + +.fa-caret-up::before { + content: "\f0d8"; } + +.fa-screwdriver::before { + content: "\f54a"; } + +.fa-folder-closed::before { + content: "\e185"; } + +.fa-house-tsunami::before { + content: "\e515"; } + +.fa-square-nfi::before { + content: "\e576"; } + +.fa-arrow-up-from-ground-water::before { + content: "\e4b5"; } + +.fa-martini-glass::before { + content: "\f57b"; } + +.fa-glass-martini-alt::before { + content: "\f57b"; } + +.fa-rotate-left::before { + content: "\f2ea"; } + +.fa-rotate-back::before { + content: "\f2ea"; } + +.fa-rotate-backward::before { + content: "\f2ea"; } + +.fa-undo-alt::before { + content: "\f2ea"; } + +.fa-table-columns::before { + content: "\f0db"; } + +.fa-columns::before { + content: "\f0db"; } + +.fa-lemon::before { + content: "\f094"; } + +.fa-head-side-mask::before { + content: "\e063"; } + +.fa-handshake::before { + content: "\f2b5"; } + +.fa-gem::before { + content: "\f3a5"; } + +.fa-dolly::before { + content: "\f472"; } + +.fa-dolly-box::before { + content: "\f472"; } + +.fa-smoking::before { + content: "\f48d"; } + +.fa-minimize::before { + content: "\f78c"; } + +.fa-compress-arrows-alt::before { + content: "\f78c"; } + +.fa-monument::before { + content: "\f5a6"; } + +.fa-snowplow::before { + content: "\f7d2"; } + +.fa-angles-right::before { + content: "\f101"; } + +.fa-angle-double-right::before { + content: "\f101"; } + +.fa-cannabis::before { + content: "\f55f"; } + +.fa-circle-play::before { + content: "\f144"; } + +.fa-play-circle::before { + content: "\f144"; } + +.fa-tablets::before { + content: "\f490"; } + +.fa-ethernet::before { + content: "\f796"; } + +.fa-euro-sign::before { + content: "\f153"; } + +.fa-eur::before { + content: "\f153"; } + +.fa-euro::before { + content: "\f153"; } + +.fa-chair::before { + content: "\f6c0"; } + +.fa-circle-check::before { + content: "\f058"; } + +.fa-check-circle::before { + content: "\f058"; } + +.fa-circle-stop::before { + content: "\f28d"; } + +.fa-stop-circle::before { + content: "\f28d"; } + +.fa-compass-drafting::before { + content: "\f568"; } + +.fa-drafting-compass::before { + content: "\f568"; } + +.fa-plate-wheat::before { + content: "\e55a"; } + +.fa-icicles::before { + content: "\f7ad"; } + +.fa-person-shelter::before { + content: "\e54f"; } + +.fa-neuter::before { + content: "\f22c"; } + +.fa-id-badge::before { + content: "\f2c1"; } + +.fa-marker::before { + content: "\f5a1"; } + +.fa-face-laugh-beam::before { + content: "\f59a"; } + +.fa-laugh-beam::before { + content: "\f59a"; } + +.fa-helicopter-symbol::before { + content: "\e502"; } + +.fa-universal-access::before { + content: "\f29a"; } + +.fa-circle-chevron-up::before { + content: "\f139"; } + +.fa-chevron-circle-up::before { + content: "\f139"; } + +.fa-lari-sign::before { + content: "\e1c8"; } + +.fa-volcano::before { + content: "\f770"; } + +.fa-person-walking-dashed-line-arrow-right::before { + content: "\e553"; } + +.fa-sterling-sign::before { + content: "\f154"; } + +.fa-gbp::before { + content: "\f154"; } + +.fa-pound-sign::before { + content: "\f154"; } + +.fa-viruses::before { + content: "\e076"; } + +.fa-square-person-confined::before { + content: "\e577"; } + +.fa-user-tie::before { + content: "\f508"; } + +.fa-arrow-down-long::before { + content: "\f175"; } + +.fa-long-arrow-down::before { + content: "\f175"; } + +.fa-tent-arrow-down-to-line::before { + content: "\e57e"; } + +.fa-certificate::before { + content: "\f0a3"; } + +.fa-reply-all::before { + content: "\f122"; } + +.fa-mail-reply-all::before { + content: "\f122"; } + +.fa-suitcase::before { + content: "\f0f2"; } + +.fa-person-skating::before { + content: "\f7c5"; } + +.fa-skating::before { + content: "\f7c5"; } + +.fa-filter-circle-dollar::before { + content: "\f662"; } + +.fa-funnel-dollar::before { + content: "\f662"; } + +.fa-camera-retro::before { + content: "\f083"; } + +.fa-circle-arrow-down::before { + content: "\f0ab"; } + +.fa-arrow-circle-down::before { + content: "\f0ab"; } + +.fa-file-import::before { + content: "\f56f"; } + +.fa-arrow-right-to-file::before { + content: "\f56f"; } + +.fa-square-arrow-up-right::before { + content: "\f14c"; } + +.fa-external-link-square::before { + content: "\f14c"; } + +.fa-box-open::before { + content: "\f49e"; } + +.fa-scroll::before { + content: "\f70e"; } + +.fa-spa::before { + content: "\f5bb"; } + +.fa-location-pin-lock::before { + content: "\e51f"; } + +.fa-pause::before { + content: "\f04c"; } + +.fa-hill-avalanche::before { + content: "\e507"; } + +.fa-temperature-empty::before { + content: "\f2cb"; } + +.fa-temperature-0::before { + content: "\f2cb"; } + +.fa-thermometer-0::before { + content: "\f2cb"; } + +.fa-thermometer-empty::before { + content: "\f2cb"; } + +.fa-bomb::before { + content: "\f1e2"; } + +.fa-registered::before { + content: "\f25d"; } + +.fa-address-card::before { + content: "\f2bb"; } + +.fa-contact-card::before { + content: "\f2bb"; } + +.fa-vcard::before { + content: "\f2bb"; } + +.fa-scale-unbalanced-flip::before { + content: "\f516"; } + +.fa-balance-scale-right::before { + content: "\f516"; } + +.fa-subscript::before { + content: "\f12c"; } + +.fa-diamond-turn-right::before { + content: "\f5eb"; } + +.fa-directions::before { + content: "\f5eb"; } + +.fa-burst::before { + content: "\e4dc"; } + +.fa-house-laptop::before { + content: "\e066"; } + +.fa-laptop-house::before { + content: "\e066"; } + +.fa-face-tired::before { + content: "\f5c8"; } + +.fa-tired::before { + content: "\f5c8"; } + +.fa-money-bills::before { + content: "\e1f3"; } + +.fa-smog::before { + content: "\f75f"; } + +.fa-crutch::before { + content: "\f7f7"; } + +.fa-cloud-arrow-up::before { + content: "\f0ee"; } + +.fa-cloud-upload::before { + content: "\f0ee"; } + +.fa-cloud-upload-alt::before { + content: "\f0ee"; } + +.fa-palette::before { + content: "\f53f"; } + +.fa-arrows-turn-right::before { + content: "\e4c0"; } + +.fa-vest::before { + content: "\e085"; } + +.fa-ferry::before { + content: "\e4ea"; } + +.fa-arrows-down-to-people::before { + content: "\e4b9"; } + +.fa-seedling::before { + content: "\f4d8"; } + +.fa-sprout::before { + content: "\f4d8"; } + +.fa-left-right::before { + content: "\f337"; } + +.fa-arrows-alt-h::before { + content: "\f337"; } + +.fa-boxes-packing::before { + content: "\e4c7"; } + +.fa-circle-arrow-left::before { + content: "\f0a8"; } + +.fa-arrow-circle-left::before { + content: "\f0a8"; } + +.fa-group-arrows-rotate::before { + content: "\e4f6"; } + +.fa-bowl-food::before { + content: "\e4c6"; } + +.fa-candy-cane::before { + content: "\f786"; } + +.fa-arrow-down-wide-short::before { + content: "\f160"; } + +.fa-sort-amount-asc::before { + content: "\f160"; } + +.fa-sort-amount-down::before { + content: "\f160"; } + +.fa-cloud-bolt::before { + content: "\f76c"; } + +.fa-thunderstorm::before { + content: "\f76c"; } + +.fa-text-slash::before { + content: "\f87d"; } + +.fa-remove-format::before { + content: "\f87d"; } + +.fa-face-smile-wink::before { + content: "\f4da"; } + +.fa-smile-wink::before { + content: "\f4da"; } + +.fa-file-word::before { + content: "\f1c2"; } + +.fa-file-powerpoint::before { + content: "\f1c4"; } + +.fa-arrows-left-right::before { + content: "\f07e"; } + +.fa-arrows-h::before { + content: "\f07e"; } + +.fa-house-lock::before { + content: "\e510"; } + +.fa-cloud-arrow-down::before { + content: "\f0ed"; } + +.fa-cloud-download::before { + content: "\f0ed"; } + +.fa-cloud-download-alt::before { + content: "\f0ed"; } + +.fa-children::before { + content: "\e4e1"; } + +.fa-chalkboard::before { + content: "\f51b"; } + +.fa-blackboard::before { + content: "\f51b"; } + +.fa-user-large-slash::before { + content: "\f4fa"; } + +.fa-user-alt-slash::before { + content: "\f4fa"; } + +.fa-envelope-open::before { + content: "\f2b6"; } + +.fa-handshake-simple-slash::before { + content: "\e05f"; } + +.fa-handshake-alt-slash::before { + content: "\e05f"; } + +.fa-mattress-pillow::before { + content: "\e525"; } + +.fa-guarani-sign::before { + content: "\e19a"; } + +.fa-arrows-rotate::before { + content: "\f021"; } + +.fa-refresh::before { + content: "\f021"; } + +.fa-sync::before { + content: "\f021"; } + +.fa-fire-extinguisher::before { + content: "\f134"; } + +.fa-cruzeiro-sign::before { + content: "\e152"; } + +.fa-greater-than-equal::before { + content: "\f532"; } + +.fa-shield-halved::before { + content: "\f3ed"; } + +.fa-shield-alt::before { + content: "\f3ed"; } + +.fa-book-atlas::before { + content: "\f558"; } + +.fa-atlas::before { + content: "\f558"; } + +.fa-virus::before { + content: "\e074"; } + +.fa-envelope-circle-check::before { + content: "\e4e8"; } + +.fa-layer-group::before { + content: "\f5fd"; } + +.fa-arrows-to-dot::before { + content: "\e4be"; } + +.fa-archway::before { + content: "\f557"; } + +.fa-heart-circle-check::before { + content: "\e4fd"; } + +.fa-house-chimney-crack::before { + content: "\f6f1"; } + +.fa-house-damage::before { + content: "\f6f1"; } + +.fa-file-zipper::before { + content: "\f1c6"; } + +.fa-file-archive::before { + content: "\f1c6"; } + +.fa-square::before { + content: "\f0c8"; } + +.fa-martini-glass-empty::before { + content: "\f000"; } + +.fa-glass-martini::before { + content: "\f000"; } + +.fa-couch::before { + content: "\f4b8"; } + +.fa-cedi-sign::before { + content: "\e0df"; } + +.fa-italic::before { + content: "\f033"; } + +.fa-table-cells-column-lock::before { + content: "\e678"; } + +.fa-church::before { + content: "\f51d"; } + +.fa-comments-dollar::before { + content: "\f653"; } + +.fa-democrat::before { + content: "\f747"; } + +.fa-z::before { + content: "\5a"; } + +.fa-person-skiing::before { + content: "\f7c9"; } + +.fa-skiing::before { + content: "\f7c9"; } + +.fa-road-lock::before { + content: "\e567"; } + +.fa-a::before { + content: "\41"; } + +.fa-temperature-arrow-down::before { + content: "\e03f"; } + +.fa-temperature-down::before { + content: "\e03f"; } + +.fa-feather-pointed::before { + content: "\f56b"; } + +.fa-feather-alt::before { + content: "\f56b"; } + +.fa-p::before { + content: "\50"; } + +.fa-snowflake::before { + content: "\f2dc"; } + +.fa-newspaper::before { + content: "\f1ea"; } + +.fa-rectangle-ad::before { + content: "\f641"; } + +.fa-ad::before { + content: "\f641"; } + +.fa-circle-arrow-right::before { + content: "\f0a9"; } + +.fa-arrow-circle-right::before { + content: "\f0a9"; } + +.fa-filter-circle-xmark::before { + content: "\e17b"; } + +.fa-locust::before { + content: "\e520"; } + +.fa-sort::before { + content: "\f0dc"; } + +.fa-unsorted::before { + content: "\f0dc"; } + +.fa-list-ol::before { + content: "\f0cb"; } + +.fa-list-1-2::before { + content: "\f0cb"; } + +.fa-list-numeric::before { + content: "\f0cb"; } + +.fa-person-dress-burst::before { + content: "\e544"; } + +.fa-money-check-dollar::before { + content: "\f53d"; } + +.fa-money-check-alt::before { + content: "\f53d"; } + +.fa-vector-square::before { + content: "\f5cb"; } + +.fa-bread-slice::before { + content: "\f7ec"; } + +.fa-language::before { + content: "\f1ab"; } + +.fa-face-kiss-wink-heart::before { + content: "\f598"; } + +.fa-kiss-wink-heart::before { + content: "\f598"; } + +.fa-filter::before { + content: "\f0b0"; } + +.fa-question::before { + content: "\3f"; } + +.fa-file-signature::before { + content: "\f573"; } + +.fa-up-down-left-right::before { + content: "\f0b2"; } + +.fa-arrows-alt::before { + content: "\f0b2"; } + +.fa-house-chimney-user::before { + content: "\e065"; } + +.fa-hand-holding-heart::before { + content: "\f4be"; } + +.fa-puzzle-piece::before { + content: "\f12e"; } + +.fa-money-check::before { + content: "\f53c"; } + +.fa-star-half-stroke::before { + content: "\f5c0"; } + +.fa-star-half-alt::before { + content: "\f5c0"; } + +.fa-code::before { + content: "\f121"; } + +.fa-whiskey-glass::before { + content: "\f7a0"; } + +.fa-glass-whiskey::before { + content: "\f7a0"; } + +.fa-building-circle-exclamation::before { + content: "\e4d3"; } + +.fa-magnifying-glass-chart::before { + content: "\e522"; } + +.fa-arrow-up-right-from-square::before { + content: "\f08e"; } + +.fa-external-link::before { + content: "\f08e"; } + +.fa-cubes-stacked::before { + content: "\e4e6"; } + +.fa-won-sign::before { + content: "\f159"; } + +.fa-krw::before { + content: "\f159"; } + +.fa-won::before { + content: "\f159"; } + +.fa-virus-covid::before { + content: "\e4a8"; } + +.fa-austral-sign::before { + content: "\e0a9"; } + +.fa-f::before { + content: "\46"; } + +.fa-leaf::before { + content: "\f06c"; } + +.fa-road::before { + content: "\f018"; } + +.fa-taxi::before { + content: "\f1ba"; } + +.fa-cab::before { + content: "\f1ba"; } + +.fa-person-circle-plus::before { + content: "\e541"; } + +.fa-chart-pie::before { + content: "\f200"; } + +.fa-pie-chart::before { + content: "\f200"; } + +.fa-bolt-lightning::before { + content: "\e0b7"; } + +.fa-sack-xmark::before { + content: "\e56a"; } + +.fa-file-excel::before { + content: "\f1c3"; } + +.fa-file-contract::before { + content: "\f56c"; } + +.fa-fish-fins::before { + content: "\e4f2"; } + +.fa-building-flag::before { + content: "\e4d5"; } + +.fa-face-grin-beam::before { + content: "\f582"; } + +.fa-grin-beam::before { + content: "\f582"; } + +.fa-object-ungroup::before { + content: "\f248"; } + +.fa-poop::before { + content: "\f619"; } + +.fa-location-pin::before { + content: "\f041"; } + +.fa-map-marker::before { + content: "\f041"; } + +.fa-kaaba::before { + content: "\f66b"; } + +.fa-toilet-paper::before { + content: "\f71e"; } + +.fa-helmet-safety::before { + content: "\f807"; } + +.fa-hard-hat::before { + content: "\f807"; } + +.fa-hat-hard::before { + content: "\f807"; } + +.fa-eject::before { + content: "\f052"; } + +.fa-circle-right::before { + content: "\f35a"; } + +.fa-arrow-alt-circle-right::before { + content: "\f35a"; } + +.fa-plane-circle-check::before { + content: "\e555"; } + +.fa-face-rolling-eyes::before { + content: "\f5a5"; } + +.fa-meh-rolling-eyes::before { + content: "\f5a5"; } + +.fa-object-group::before { + content: "\f247"; } + +.fa-chart-line::before { + content: "\f201"; } + +.fa-line-chart::before { + content: "\f201"; } + +.fa-mask-ventilator::before { + content: "\e524"; } + +.fa-arrow-right::before { + content: "\f061"; } + +.fa-signs-post::before { + content: "\f277"; } + +.fa-map-signs::before { + content: "\f277"; } + +.fa-cash-register::before { + content: "\f788"; } + +.fa-person-circle-question::before { + content: "\e542"; } + +.fa-h::before { + content: "\48"; } + +.fa-tarp::before { + content: "\e57b"; } + +.fa-screwdriver-wrench::before { + content: "\f7d9"; } + +.fa-tools::before { + content: "\f7d9"; } + +.fa-arrows-to-eye::before { + content: "\e4bf"; } + +.fa-plug-circle-bolt::before { + content: "\e55b"; } + +.fa-heart::before { + content: "\f004"; } + +.fa-mars-and-venus::before { + content: "\f224"; } + +.fa-house-user::before { + content: "\e1b0"; } + +.fa-home-user::before { + content: "\e1b0"; } + +.fa-dumpster-fire::before { + content: "\f794"; } + +.fa-house-crack::before { + content: "\e3b1"; } + +.fa-martini-glass-citrus::before { + content: "\f561"; } + +.fa-cocktail::before { + content: "\f561"; } + +.fa-face-surprise::before { + content: "\f5c2"; } + +.fa-surprise::before { + content: "\f5c2"; } + +.fa-bottle-water::before { + content: "\e4c5"; } + +.fa-circle-pause::before { + content: "\f28b"; } + +.fa-pause-circle::before { + content: "\f28b"; } + +.fa-toilet-paper-slash::before { + content: "\e072"; } + +.fa-apple-whole::before { + content: "\f5d1"; } + +.fa-apple-alt::before { + content: "\f5d1"; } + +.fa-kitchen-set::before { + content: "\e51a"; } + +.fa-r::before { + content: "\52"; } + +.fa-temperature-quarter::before { + content: "\f2ca"; } + +.fa-temperature-1::before { + content: "\f2ca"; } + +.fa-thermometer-1::before { + content: "\f2ca"; } + +.fa-thermometer-quarter::before { + content: "\f2ca"; } + +.fa-cube::before { + content: "\f1b2"; } + +.fa-bitcoin-sign::before { + content: "\e0b4"; } + +.fa-shield-dog::before { + content: "\e573"; } + +.fa-solar-panel::before { + content: "\f5ba"; } + +.fa-lock-open::before { + content: "\f3c1"; } + +.fa-elevator::before { + content: "\e16d"; } + +.fa-money-bill-transfer::before { + content: "\e528"; } + +.fa-money-bill-trend-up::before { + content: "\e529"; } + +.fa-house-flood-water-circle-arrow-right::before { + content: "\e50f"; } + +.fa-square-poll-horizontal::before { + content: "\f682"; } + +.fa-poll-h::before { + content: "\f682"; } + +.fa-circle::before { + content: "\f111"; } + +.fa-backward-fast::before { + content: "\f049"; } + +.fa-fast-backward::before { + content: "\f049"; } + +.fa-recycle::before { + content: "\f1b8"; } + +.fa-user-astronaut::before { + content: "\f4fb"; } + +.fa-plane-slash::before { + content: "\e069"; } + +.fa-trademark::before { + content: "\f25c"; } + +.fa-basketball::before { + content: "\f434"; } + +.fa-basketball-ball::before { + content: "\f434"; } + +.fa-satellite-dish::before { + content: "\f7c0"; } + +.fa-circle-up::before { + content: "\f35b"; } + +.fa-arrow-alt-circle-up::before { + content: "\f35b"; } + +.fa-mobile-screen-button::before { + content: "\f3cd"; } + +.fa-mobile-alt::before { + content: "\f3cd"; } + +.fa-volume-high::before { + content: "\f028"; } + +.fa-volume-up::before { + content: "\f028"; } + +.fa-users-rays::before { + content: "\e593"; } + +.fa-wallet::before { + content: "\f555"; } + +.fa-clipboard-check::before { + content: "\f46c"; } + +.fa-file-audio::before { + content: "\f1c7"; } + +.fa-burger::before { + content: "\f805"; } + +.fa-hamburger::before { + content: "\f805"; } + +.fa-wrench::before { + content: "\f0ad"; } + +.fa-bugs::before { + content: "\e4d0"; } + +.fa-rupee-sign::before { + content: "\f156"; } + +.fa-rupee::before { + content: "\f156"; } + +.fa-file-image::before { + content: "\f1c5"; } + +.fa-circle-question::before { + content: "\f059"; } + +.fa-question-circle::before { + content: "\f059"; } + +.fa-plane-departure::before { + content: "\f5b0"; } + +.fa-handshake-slash::before { + content: "\e060"; } + +.fa-book-bookmark::before { + content: "\e0bb"; } + +.fa-code-branch::before { + content: "\f126"; } + +.fa-hat-cowboy::before { + content: "\f8c0"; } + +.fa-bridge::before { + content: "\e4c8"; } + +.fa-phone-flip::before { + content: "\f879"; } + +.fa-phone-alt::before { + content: "\f879"; } + +.fa-truck-front::before { + content: "\e2b7"; } + +.fa-cat::before { + content: "\f6be"; } + +.fa-anchor-circle-exclamation::before { + content: "\e4ab"; } + +.fa-truck-field::before { + content: "\e58d"; } + +.fa-route::before { + content: "\f4d7"; } + +.fa-clipboard-question::before { + content: "\e4e3"; } + +.fa-panorama::before { + content: "\e209"; } + +.fa-comment-medical::before { + content: "\f7f5"; } + +.fa-teeth-open::before { + content: "\f62f"; } + +.fa-file-circle-minus::before { + content: "\e4ed"; } + +.fa-tags::before { + content: "\f02c"; } + +.fa-wine-glass::before { + content: "\f4e3"; } + +.fa-forward-fast::before { + content: "\f050"; } + +.fa-fast-forward::before { + content: "\f050"; } + +.fa-face-meh-blank::before { + content: "\f5a4"; } + +.fa-meh-blank::before { + content: "\f5a4"; } + +.fa-square-parking::before { + content: "\f540"; } + +.fa-parking::before { + content: "\f540"; } + +.fa-house-signal::before { + content: "\e012"; } + +.fa-bars-progress::before { + content: "\f828"; } + +.fa-tasks-alt::before { + content: "\f828"; } + +.fa-faucet-drip::before { + content: "\e006"; } + +.fa-cart-flatbed::before { + content: "\f474"; } + +.fa-dolly-flatbed::before { + content: "\f474"; } + +.fa-ban-smoking::before { + content: "\f54d"; } + +.fa-smoking-ban::before { + content: "\f54d"; } + +.fa-terminal::before { + content: "\f120"; } + +.fa-mobile-button::before { + content: "\f10b"; } + +.fa-house-medical-flag::before { + content: "\e514"; } + +.fa-basket-shopping::before { + content: "\f291"; } + +.fa-shopping-basket::before { + content: "\f291"; } + +.fa-tape::before { + content: "\f4db"; } + +.fa-bus-simple::before { + content: "\f55e"; } + +.fa-bus-alt::before { + content: "\f55e"; } + +.fa-eye::before { + content: "\f06e"; } + +.fa-face-sad-cry::before { + content: "\f5b3"; } + +.fa-sad-cry::before { + content: "\f5b3"; } + +.fa-audio-description::before { + content: "\f29e"; } + +.fa-person-military-to-person::before { + content: "\e54c"; } + +.fa-file-shield::before { + content: "\e4f0"; } + +.fa-user-slash::before { + content: "\f506"; } + +.fa-pen::before { + content: "\f304"; } + +.fa-tower-observation::before { + content: "\e586"; } + +.fa-file-code::before { + content: "\f1c9"; } + +.fa-signal::before { + content: "\f012"; } + +.fa-signal-5::before { + content: "\f012"; } + +.fa-signal-perfect::before { + content: "\f012"; } + +.fa-bus::before { + content: "\f207"; } + +.fa-heart-circle-xmark::before { + content: "\e501"; } + +.fa-house-chimney::before { + content: "\e3af"; } + +.fa-home-lg::before { + content: "\e3af"; } + +.fa-window-maximize::before { + content: "\f2d0"; } + +.fa-face-frown::before { + content: "\f119"; } + +.fa-frown::before { + content: "\f119"; } + +.fa-prescription::before { + content: "\f5b1"; } + +.fa-shop::before { + content: "\f54f"; } + +.fa-store-alt::before { + content: "\f54f"; } + +.fa-floppy-disk::before { + content: "\f0c7"; } + +.fa-save::before { + content: "\f0c7"; } + +.fa-vihara::before { + content: "\f6a7"; } + +.fa-scale-unbalanced::before { + content: "\f515"; } + +.fa-balance-scale-left::before { + content: "\f515"; } + +.fa-sort-up::before { + content: "\f0de"; } + +.fa-sort-asc::before { + content: "\f0de"; } + +.fa-comment-dots::before { + content: "\f4ad"; } + +.fa-commenting::before { + content: "\f4ad"; } + +.fa-plant-wilt::before { + content: "\e5aa"; } + +.fa-diamond::before { + content: "\f219"; } + +.fa-face-grin-squint::before { + content: "\f585"; } + +.fa-grin-squint::before { + content: "\f585"; } + +.fa-hand-holding-dollar::before { + content: "\f4c0"; } + +.fa-hand-holding-usd::before { + content: "\f4c0"; } + +.fa-bacterium::before { + content: "\e05a"; } + +.fa-hand-pointer::before { + content: "\f25a"; } + +.fa-drum-steelpan::before { + content: "\f56a"; } + +.fa-hand-scissors::before { + content: "\f257"; } + +.fa-hands-praying::before { + content: "\f684"; } + +.fa-praying-hands::before { + content: "\f684"; } + +.fa-arrow-rotate-right::before { + content: "\f01e"; } + +.fa-arrow-right-rotate::before { + content: "\f01e"; } + +.fa-arrow-rotate-forward::before { + content: "\f01e"; } + +.fa-redo::before { + content: "\f01e"; } + +.fa-biohazard::before { + content: "\f780"; } + +.fa-location-crosshairs::before { + content: "\f601"; } + +.fa-location::before { + content: "\f601"; } + +.fa-mars-double::before { + content: "\f227"; } + +.fa-child-dress::before { + content: "\e59c"; } + +.fa-users-between-lines::before { + content: "\e591"; } + +.fa-lungs-virus::before { + content: "\e067"; } + +.fa-face-grin-tears::before { + content: "\f588"; } + +.fa-grin-tears::before { + content: "\f588"; } + +.fa-phone::before { + content: "\f095"; } + +.fa-calendar-xmark::before { + content: "\f273"; } + +.fa-calendar-times::before { + content: "\f273"; } + +.fa-child-reaching::before { + content: "\e59d"; } + +.fa-head-side-virus::before { + content: "\e064"; } + +.fa-user-gear::before { + content: "\f4fe"; } + +.fa-user-cog::before { + content: "\f4fe"; } + +.fa-arrow-up-1-9::before { + content: "\f163"; } + +.fa-sort-numeric-up::before { + content: "\f163"; } + +.fa-door-closed::before { + content: "\f52a"; } + +.fa-shield-virus::before { + content: "\e06c"; } + +.fa-dice-six::before { + content: "\f526"; } + +.fa-mosquito-net::before { + content: "\e52c"; } + +.fa-bridge-water::before { + content: "\e4ce"; } + +.fa-person-booth::before { + content: "\f756"; } + +.fa-text-width::before { + content: "\f035"; } + +.fa-hat-wizard::before { + content: "\f6e8"; } + +.fa-pen-fancy::before { + content: "\f5ac"; } + +.fa-person-digging::before { + content: "\f85e"; } + +.fa-digging::before { + content: "\f85e"; } + +.fa-trash::before { + content: "\f1f8"; } + +.fa-gauge-simple::before { + content: "\f629"; } + +.fa-gauge-simple-med::before { + content: "\f629"; } + +.fa-tachometer-average::before { + content: "\f629"; } + +.fa-book-medical::before { + content: "\f7e6"; } + +.fa-poo::before { + content: "\f2fe"; } + +.fa-quote-right::before { + content: "\f10e"; } + +.fa-quote-right-alt::before { + content: "\f10e"; } + +.fa-shirt::before { + content: "\f553"; } + +.fa-t-shirt::before { + content: "\f553"; } + +.fa-tshirt::before { + content: "\f553"; } + +.fa-cubes::before { + content: "\f1b3"; } + +.fa-divide::before { + content: "\f529"; } + +.fa-tenge-sign::before { + content: "\f7d7"; } + +.fa-tenge::before { + content: "\f7d7"; } + +.fa-headphones::before { + content: "\f025"; } + +.fa-hands-holding::before { + content: "\f4c2"; } + +.fa-hands-clapping::before { + content: "\e1a8"; } + +.fa-republican::before { + content: "\f75e"; } + +.fa-arrow-left::before { + content: "\f060"; } + +.fa-person-circle-xmark::before { + content: "\e543"; } + +.fa-ruler::before { + content: "\f545"; } + +.fa-align-left::before { + content: "\f036"; } + +.fa-dice-d6::before { + content: "\f6d1"; } + +.fa-restroom::before { + content: "\f7bd"; } + +.fa-j::before { + content: "\4a"; } + +.fa-users-viewfinder::before { + content: "\e595"; } + +.fa-file-video::before { + content: "\f1c8"; } + +.fa-up-right-from-square::before { + content: "\f35d"; } + +.fa-external-link-alt::before { + content: "\f35d"; } + +.fa-table-cells::before { + content: "\f00a"; } + +.fa-th::before { + content: "\f00a"; } + +.fa-file-pdf::before { + content: "\f1c1"; } + +.fa-book-bible::before { + content: "\f647"; } + +.fa-bible::before { + content: "\f647"; } + +.fa-o::before { + content: "\4f"; } + +.fa-suitcase-medical::before { + content: "\f0fa"; } + +.fa-medkit::before { + content: "\f0fa"; } + +.fa-user-secret::before { + content: "\f21b"; } + +.fa-otter::before { + content: "\f700"; } + +.fa-person-dress::before { + content: "\f182"; } + +.fa-female::before { + content: "\f182"; } + +.fa-comment-dollar::before { + content: "\f651"; } + +.fa-business-time::before { + content: "\f64a"; } + +.fa-briefcase-clock::before { + content: "\f64a"; } + +.fa-table-cells-large::before { + content: "\f009"; } + +.fa-th-large::before { + content: "\f009"; } + +.fa-book-tanakh::before { + content: "\f827"; } + +.fa-tanakh::before { + content: "\f827"; } + +.fa-phone-volume::before { + content: "\f2a0"; } + +.fa-volume-control-phone::before { + content: "\f2a0"; } + +.fa-hat-cowboy-side::before { + content: "\f8c1"; } + +.fa-clipboard-user::before { + content: "\f7f3"; } + +.fa-child::before { + content: "\f1ae"; } + +.fa-lira-sign::before { + content: "\f195"; } + +.fa-satellite::before { + content: "\f7bf"; } + +.fa-plane-lock::before { + content: "\e558"; } + +.fa-tag::before { + content: "\f02b"; } + +.fa-comment::before { + content: "\f075"; } + +.fa-cake-candles::before { + content: "\f1fd"; } + +.fa-birthday-cake::before { + content: "\f1fd"; } + +.fa-cake::before { + content: "\f1fd"; } + +.fa-envelope::before { + content: "\f0e0"; } + +.fa-angles-up::before { + content: "\f102"; } + +.fa-angle-double-up::before { + content: "\f102"; } + +.fa-paperclip::before { + content: "\f0c6"; } + +.fa-arrow-right-to-city::before { + content: "\e4b3"; } + +.fa-ribbon::before { + content: "\f4d6"; } + +.fa-lungs::before { + content: "\f604"; } + +.fa-arrow-up-9-1::before { + content: "\f887"; } + +.fa-sort-numeric-up-alt::before { + content: "\f887"; } + +.fa-litecoin-sign::before { + content: "\e1d3"; } + +.fa-border-none::before { + content: "\f850"; } + +.fa-circle-nodes::before { + content: "\e4e2"; } + +.fa-parachute-box::before { + content: "\f4cd"; } + +.fa-indent::before { + content: "\f03c"; } + +.fa-truck-field-un::before { + content: "\e58e"; } + +.fa-hourglass::before { + content: "\f254"; } + +.fa-hourglass-empty::before { + content: "\f254"; } + +.fa-mountain::before { + content: "\f6fc"; } + +.fa-user-doctor::before { + content: "\f0f0"; } + +.fa-user-md::before { + content: "\f0f0"; } + +.fa-circle-info::before { + content: "\f05a"; } + +.fa-info-circle::before { + content: "\f05a"; } + +.fa-cloud-meatball::before { + content: "\f73b"; } + +.fa-camera::before { + content: "\f030"; } + +.fa-camera-alt::before { + content: "\f030"; } + +.fa-square-virus::before { + content: "\e578"; } + +.fa-meteor::before { + content: "\f753"; } + +.fa-car-on::before { + content: "\e4dd"; } + +.fa-sleigh::before { + content: "\f7cc"; } + +.fa-arrow-down-1-9::before { + content: "\f162"; } + +.fa-sort-numeric-asc::before { + content: "\f162"; } + +.fa-sort-numeric-down::before { + content: "\f162"; } + +.fa-hand-holding-droplet::before { + content: "\f4c1"; } + +.fa-hand-holding-water::before { + content: "\f4c1"; } + +.fa-water::before { + content: "\f773"; } + +.fa-calendar-check::before { + content: "\f274"; } + +.fa-braille::before { + content: "\f2a1"; } + +.fa-prescription-bottle-medical::before { + content: "\f486"; } + +.fa-prescription-bottle-alt::before { + content: "\f486"; } + +.fa-landmark::before { + content: "\f66f"; } + +.fa-truck::before { + content: "\f0d1"; } + +.fa-crosshairs::before { + content: "\f05b"; } + +.fa-person-cane::before { + content: "\e53c"; } + +.fa-tent::before { + content: "\e57d"; } + +.fa-vest-patches::before { + content: "\e086"; } + +.fa-check-double::before { + content: "\f560"; } + +.fa-arrow-down-a-z::before { + content: "\f15d"; } + +.fa-sort-alpha-asc::before { + content: "\f15d"; } + +.fa-sort-alpha-down::before { + content: "\f15d"; } + +.fa-money-bill-wheat::before { + content: "\e52a"; } + +.fa-cookie::before { + content: "\f563"; } + +.fa-arrow-rotate-left::before { + content: "\f0e2"; } + +.fa-arrow-left-rotate::before { + content: "\f0e2"; } + +.fa-arrow-rotate-back::before { + content: "\f0e2"; } + +.fa-arrow-rotate-backward::before { + content: "\f0e2"; } + +.fa-undo::before { + content: "\f0e2"; } + +.fa-hard-drive::before { + content: "\f0a0"; } + +.fa-hdd::before { + content: "\f0a0"; } + +.fa-face-grin-squint-tears::before { + content: "\f586"; } + +.fa-grin-squint-tears::before { + content: "\f586"; } + +.fa-dumbbell::before { + content: "\f44b"; } + +.fa-rectangle-list::before { + content: "\f022"; } + +.fa-list-alt::before { + content: "\f022"; } + +.fa-tarp-droplet::before { + content: "\e57c"; } + +.fa-house-medical-circle-check::before { + content: "\e511"; } + +.fa-person-skiing-nordic::before { + content: "\f7ca"; } + +.fa-skiing-nordic::before { + content: "\f7ca"; } + +.fa-calendar-plus::before { + content: "\f271"; } + +.fa-plane-arrival::before { + content: "\f5af"; } + +.fa-circle-left::before { + content: "\f359"; } + +.fa-arrow-alt-circle-left::before { + content: "\f359"; } + +.fa-train-subway::before { + content: "\f239"; } + +.fa-subway::before { + content: "\f239"; } + +.fa-chart-gantt::before { + content: "\e0e4"; } + +.fa-indian-rupee-sign::before { + content: "\e1bc"; } + +.fa-indian-rupee::before { + content: "\e1bc"; } + +.fa-inr::before { + content: "\e1bc"; } + +.fa-crop-simple::before { + content: "\f565"; } + +.fa-crop-alt::before { + content: "\f565"; } + +.fa-money-bill-1::before { + content: "\f3d1"; } + +.fa-money-bill-alt::before { + content: "\f3d1"; } + +.fa-left-long::before { + content: "\f30a"; } + +.fa-long-arrow-alt-left::before { + content: "\f30a"; } + +.fa-dna::before { + content: "\f471"; } + +.fa-virus-slash::before { + content: "\e075"; } + +.fa-minus::before { + content: "\f068"; } + +.fa-subtract::before { + content: "\f068"; } + +.fa-chess::before { + content: "\f439"; } + +.fa-arrow-left-long::before { + content: "\f177"; } + +.fa-long-arrow-left::before { + content: "\f177"; } + +.fa-plug-circle-check::before { + content: "\e55c"; } + +.fa-street-view::before { + content: "\f21d"; } + +.fa-franc-sign::before { + content: "\e18f"; } + +.fa-volume-off::before { + content: "\f026"; } + +.fa-hands-asl-interpreting::before { + content: "\f2a3"; } + +.fa-american-sign-language-interpreting::before { + content: "\f2a3"; } + +.fa-asl-interpreting::before { + content: "\f2a3"; } + +.fa-hands-american-sign-language-interpreting::before { + content: "\f2a3"; } + +.fa-gear::before { + content: "\f013"; } + +.fa-cog::before { + content: "\f013"; } + +.fa-droplet-slash::before { + content: "\f5c7"; } + +.fa-tint-slash::before { + content: "\f5c7"; } + +.fa-mosque::before { + content: "\f678"; } + +.fa-mosquito::before { + content: "\e52b"; } + +.fa-star-of-david::before { + content: "\f69a"; } + +.fa-person-military-rifle::before { + content: "\e54b"; } + +.fa-cart-shopping::before { + content: "\f07a"; } + +.fa-shopping-cart::before { + content: "\f07a"; } + +.fa-vials::before { + content: "\f493"; } + +.fa-plug-circle-plus::before { + content: "\e55f"; } + +.fa-place-of-worship::before { + content: "\f67f"; } + +.fa-grip-vertical::before { + content: "\f58e"; } + +.fa-arrow-turn-up::before { + content: "\f148"; } + +.fa-level-up::before { + content: "\f148"; } + +.fa-u::before { + content: "\55"; } + +.fa-square-root-variable::before { + content: "\f698"; } + +.fa-square-root-alt::before { + content: "\f698"; } + +.fa-clock::before { + content: "\f017"; } + +.fa-clock-four::before { + content: "\f017"; } + +.fa-backward-step::before { + content: "\f048"; } + +.fa-step-backward::before { + content: "\f048"; } + +.fa-pallet::before { + content: "\f482"; } + +.fa-faucet::before { + content: "\e005"; } + +.fa-baseball-bat-ball::before { + content: "\f432"; } + +.fa-s::before { + content: "\53"; } + +.fa-timeline::before { + content: "\e29c"; } + +.fa-keyboard::before { + content: "\f11c"; } + +.fa-caret-down::before { + content: "\f0d7"; } + +.fa-house-chimney-medical::before { + content: "\f7f2"; } + +.fa-clinic-medical::before { + content: "\f7f2"; } + +.fa-temperature-three-quarters::before { + content: "\f2c8"; } + +.fa-temperature-3::before { + content: "\f2c8"; } + +.fa-thermometer-3::before { + content: "\f2c8"; } + +.fa-thermometer-three-quarters::before { + content: "\f2c8"; } + +.fa-mobile-screen::before { + content: "\f3cf"; } + +.fa-mobile-android-alt::before { + content: "\f3cf"; } + +.fa-plane-up::before { + content: "\e22d"; } + +.fa-piggy-bank::before { + content: "\f4d3"; } + +.fa-battery-half::before { + content: "\f242"; } + +.fa-battery-3::before { + content: "\f242"; } + +.fa-mountain-city::before { + content: "\e52e"; } + +.fa-coins::before { + content: "\f51e"; } + +.fa-khanda::before { + content: "\f66d"; } + +.fa-sliders::before { + content: "\f1de"; } + +.fa-sliders-h::before { + content: "\f1de"; } + +.fa-folder-tree::before { + content: "\f802"; } + +.fa-network-wired::before { + content: "\f6ff"; } + +.fa-map-pin::before { + content: "\f276"; } + +.fa-hamsa::before { + content: "\f665"; } + +.fa-cent-sign::before { + content: "\e3f5"; } + +.fa-flask::before { + content: "\f0c3"; } + +.fa-person-pregnant::before { + content: "\e31e"; } + +.fa-wand-sparkles::before { + content: "\f72b"; } + +.fa-ellipsis-vertical::before { + content: "\f142"; } + +.fa-ellipsis-v::before { + content: "\f142"; } + +.fa-ticket::before { + content: "\f145"; } + +.fa-power-off::before { + content: "\f011"; } + +.fa-right-long::before { + content: "\f30b"; } + +.fa-long-arrow-alt-right::before { + content: "\f30b"; } + +.fa-flag-usa::before { + content: "\f74d"; } + +.fa-laptop-file::before { + content: "\e51d"; } + +.fa-tty::before { + content: "\f1e4"; } + +.fa-teletype::before { + content: "\f1e4"; } + +.fa-diagram-next::before { + content: "\e476"; } + +.fa-person-rifle::before { + content: "\e54e"; } + +.fa-house-medical-circle-exclamation::before { + content: "\e512"; } + +.fa-closed-captioning::before { + content: "\f20a"; } + +.fa-person-hiking::before { + content: "\f6ec"; } + +.fa-hiking::before { + content: "\f6ec"; } + +.fa-venus-double::before { + content: "\f226"; } + +.fa-images::before { + content: "\f302"; } + +.fa-calculator::before { + content: "\f1ec"; } + +.fa-people-pulling::before { + content: "\e535"; } + +.fa-n::before { + content: "\4e"; } + +.fa-cable-car::before { + content: "\f7da"; } + +.fa-tram::before { + content: "\f7da"; } + +.fa-cloud-rain::before { + content: "\f73d"; } + +.fa-building-circle-xmark::before { + content: "\e4d4"; } + +.fa-ship::before { + content: "\f21a"; } + +.fa-arrows-down-to-line::before { + content: "\e4b8"; } + +.fa-download::before { + content: "\f019"; } + +.fa-face-grin::before { + content: "\f580"; } + +.fa-grin::before { + content: "\f580"; } + +.fa-delete-left::before { + content: "\f55a"; } + +.fa-backspace::before { + content: "\f55a"; } + +.fa-eye-dropper::before { + content: "\f1fb"; } + +.fa-eye-dropper-empty::before { + content: "\f1fb"; } + +.fa-eyedropper::before { + content: "\f1fb"; } + +.fa-file-circle-check::before { + content: "\e5a0"; } + +.fa-forward::before { + content: "\f04e"; } + +.fa-mobile::before { + content: "\f3ce"; } + +.fa-mobile-android::before { + content: "\f3ce"; } + +.fa-mobile-phone::before { + content: "\f3ce"; } + +.fa-face-meh::before { + content: "\f11a"; } + +.fa-meh::before { + content: "\f11a"; } + +.fa-align-center::before { + content: "\f037"; } + +.fa-book-skull::before { + content: "\f6b7"; } + +.fa-book-dead::before { + content: "\f6b7"; } + +.fa-id-card::before { + content: "\f2c2"; } + +.fa-drivers-license::before { + content: "\f2c2"; } + +.fa-outdent::before { + content: "\f03b"; } + +.fa-dedent::before { + content: "\f03b"; } + +.fa-heart-circle-exclamation::before { + content: "\e4fe"; } + +.fa-house::before { + content: "\f015"; } + +.fa-home::before { + content: "\f015"; } + +.fa-home-alt::before { + content: "\f015"; } + +.fa-home-lg-alt::before { + content: "\f015"; } + +.fa-calendar-week::before { + content: "\f784"; } + +.fa-laptop-medical::before { + content: "\f812"; } + +.fa-b::before { + content: "\42"; } + +.fa-file-medical::before { + content: "\f477"; } + +.fa-dice-one::before { + content: "\f525"; } + +.fa-kiwi-bird::before { + content: "\f535"; } + +.fa-arrow-right-arrow-left::before { + content: "\f0ec"; } + +.fa-exchange::before { + content: "\f0ec"; } + +.fa-rotate-right::before { + content: "\f2f9"; } + +.fa-redo-alt::before { + content: "\f2f9"; } + +.fa-rotate-forward::before { + content: "\f2f9"; } + +.fa-utensils::before { + content: "\f2e7"; } + +.fa-cutlery::before { + content: "\f2e7"; } + +.fa-arrow-up-wide-short::before { + content: "\f161"; } + +.fa-sort-amount-up::before { + content: "\f161"; } + +.fa-mill-sign::before { + content: "\e1ed"; } + +.fa-bowl-rice::before { + content: "\e2eb"; } + +.fa-skull::before { + content: "\f54c"; } + +.fa-tower-broadcast::before { + content: "\f519"; } + +.fa-broadcast-tower::before { + content: "\f519"; } + +.fa-truck-pickup::before { + content: "\f63c"; } + +.fa-up-long::before { + content: "\f30c"; } + +.fa-long-arrow-alt-up::before { + content: "\f30c"; } + +.fa-stop::before { + content: "\f04d"; } + +.fa-code-merge::before { + content: "\f387"; } + +.fa-upload::before { + content: "\f093"; } + +.fa-hurricane::before { + content: "\f751"; } + +.fa-mound::before { + content: "\e52d"; } + +.fa-toilet-portable::before { + content: "\e583"; } + +.fa-compact-disc::before { + content: "\f51f"; } + +.fa-file-arrow-down::before { + content: "\f56d"; } + +.fa-file-download::before { + content: "\f56d"; } + +.fa-caravan::before { + content: "\f8ff"; } + +.fa-shield-cat::before { + content: "\e572"; } + +.fa-bolt::before { + content: "\f0e7"; } + +.fa-zap::before { + content: "\f0e7"; } + +.fa-glass-water::before { + content: "\e4f4"; } + +.fa-oil-well::before { + content: "\e532"; } + +.fa-vault::before { + content: "\e2c5"; } + +.fa-mars::before { + content: "\f222"; } + +.fa-toilet::before { + content: "\f7d8"; } + +.fa-plane-circle-xmark::before { + content: "\e557"; } + +.fa-yen-sign::before { + content: "\f157"; } + +.fa-cny::before { + content: "\f157"; } + +.fa-jpy::before { + content: "\f157"; } + +.fa-rmb::before { + content: "\f157"; } + +.fa-yen::before { + content: "\f157"; } + +.fa-ruble-sign::before { + content: "\f158"; } + +.fa-rouble::before { + content: "\f158"; } + +.fa-rub::before { + content: "\f158"; } + +.fa-ruble::before { + content: "\f158"; } + +.fa-sun::before { + content: "\f185"; } + +.fa-guitar::before { + content: "\f7a6"; } + +.fa-face-laugh-wink::before { + content: "\f59c"; } + +.fa-laugh-wink::before { + content: "\f59c"; } + +.fa-horse-head::before { + content: "\f7ab"; } + +.fa-bore-hole::before { + content: "\e4c3"; } + +.fa-industry::before { + content: "\f275"; } + +.fa-circle-down::before { + content: "\f358"; } + +.fa-arrow-alt-circle-down::before { + content: "\f358"; } + +.fa-arrows-turn-to-dots::before { + content: "\e4c1"; } + +.fa-florin-sign::before { + content: "\e184"; } + +.fa-arrow-down-short-wide::before { + content: "\f884"; } + +.fa-sort-amount-desc::before { + content: "\f884"; } + +.fa-sort-amount-down-alt::before { + content: "\f884"; } + +.fa-less-than::before { + content: "\3c"; } + +.fa-angle-down::before { + content: "\f107"; } + +.fa-car-tunnel::before { + content: "\e4de"; } + +.fa-head-side-cough::before { + content: "\e061"; } + +.fa-grip-lines::before { + content: "\f7a4"; } + +.fa-thumbs-down::before { + content: "\f165"; } + +.fa-user-lock::before { + content: "\f502"; } + +.fa-arrow-right-long::before { + content: "\f178"; } + +.fa-long-arrow-right::before { + content: "\f178"; } + +.fa-anchor-circle-xmark::before { + content: "\e4ac"; } + +.fa-ellipsis::before { + content: "\f141"; } + +.fa-ellipsis-h::before { + content: "\f141"; } + +.fa-chess-pawn::before { + content: "\f443"; } + +.fa-kit-medical::before { + content: "\f479"; } + +.fa-first-aid::before { + content: "\f479"; } + +.fa-person-through-window::before { + content: "\e5a9"; } + +.fa-toolbox::before { + content: "\f552"; } + +.fa-hands-holding-circle::before { + content: "\e4fb"; } + +.fa-bug::before { + content: "\f188"; } + +.fa-credit-card::before { + content: "\f09d"; } + +.fa-credit-card-alt::before { + content: "\f09d"; } + +.fa-car::before { + content: "\f1b9"; } + +.fa-automobile::before { + content: "\f1b9"; } + +.fa-hand-holding-hand::before { + content: "\e4f7"; } + +.fa-book-open-reader::before { + content: "\f5da"; } + +.fa-book-reader::before { + content: "\f5da"; } + +.fa-mountain-sun::before { + content: "\e52f"; } + +.fa-arrows-left-right-to-line::before { + content: "\e4ba"; } + +.fa-dice-d20::before { + content: "\f6cf"; } + +.fa-truck-droplet::before { + content: "\e58c"; } + +.fa-file-circle-xmark::before { + content: "\e5a1"; } + +.fa-temperature-arrow-up::before { + content: "\e040"; } + +.fa-temperature-up::before { + content: "\e040"; } + +.fa-medal::before { + content: "\f5a2"; } + +.fa-bed::before { + content: "\f236"; } + +.fa-square-h::before { + content: "\f0fd"; } + +.fa-h-square::before { + content: "\f0fd"; } + +.fa-podcast::before { + content: "\f2ce"; } + +.fa-temperature-full::before { + content: "\f2c7"; } + +.fa-temperature-4::before { + content: "\f2c7"; } + +.fa-thermometer-4::before { + content: "\f2c7"; } + +.fa-thermometer-full::before { + content: "\f2c7"; } + +.fa-bell::before { + content: "\f0f3"; } + +.fa-superscript::before { + content: "\f12b"; } + +.fa-plug-circle-xmark::before { + content: "\e560"; } + +.fa-star-of-life::before { + content: "\f621"; } + +.fa-phone-slash::before { + content: "\f3dd"; } + +.fa-paint-roller::before { + content: "\f5aa"; } + +.fa-handshake-angle::before { + content: "\f4c4"; } + +.fa-hands-helping::before { + content: "\f4c4"; } + +.fa-location-dot::before { + content: "\f3c5"; } + +.fa-map-marker-alt::before { + content: "\f3c5"; } + +.fa-file::before { + content: "\f15b"; } + +.fa-greater-than::before { + content: "\3e"; } + +.fa-person-swimming::before { + content: "\f5c4"; } + +.fa-swimmer::before { + content: "\f5c4"; } + +.fa-arrow-down::before { + content: "\f063"; } + +.fa-droplet::before { + content: "\f043"; } + +.fa-tint::before { + content: "\f043"; } + +.fa-eraser::before { + content: "\f12d"; } + +.fa-earth-americas::before { + content: "\f57d"; } + +.fa-earth::before { + content: "\f57d"; } + +.fa-earth-america::before { + content: "\f57d"; } + +.fa-globe-americas::before { + content: "\f57d"; } + +.fa-person-burst::before { + content: "\e53b"; } + +.fa-dove::before { + content: "\f4ba"; } + +.fa-battery-empty::before { + content: "\f244"; } + +.fa-battery-0::before { + content: "\f244"; } + +.fa-socks::before { + content: "\f696"; } + +.fa-inbox::before { + content: "\f01c"; } + +.fa-section::before { + content: "\e447"; } + +.fa-gauge-high::before { + content: "\f625"; } + +.fa-tachometer-alt::before { + content: "\f625"; } + +.fa-tachometer-alt-fast::before { + content: "\f625"; } + +.fa-envelope-open-text::before { + content: "\f658"; } + +.fa-hospital::before { + content: "\f0f8"; } + +.fa-hospital-alt::before { + content: "\f0f8"; } + +.fa-hospital-wide::before { + content: "\f0f8"; } + +.fa-wine-bottle::before { + content: "\f72f"; } + +.fa-chess-rook::before { + content: "\f447"; } + +.fa-bars-staggered::before { + content: "\f550"; } + +.fa-reorder::before { + content: "\f550"; } + +.fa-stream::before { + content: "\f550"; } + +.fa-dharmachakra::before { + content: "\f655"; } + +.fa-hotdog::before { + content: "\f80f"; } + +.fa-person-walking-with-cane::before { + content: "\f29d"; } + +.fa-blind::before { + content: "\f29d"; } + +.fa-drum::before { + content: "\f569"; } + +.fa-ice-cream::before { + content: "\f810"; } + +.fa-heart-circle-bolt::before { + content: "\e4fc"; } + +.fa-fax::before { + content: "\f1ac"; } + +.fa-paragraph::before { + content: "\f1dd"; } + +.fa-check-to-slot::before { + content: "\f772"; } + +.fa-vote-yea::before { + content: "\f772"; } + +.fa-star-half::before { + content: "\f089"; } + +.fa-boxes-stacked::before { + content: "\f468"; } + +.fa-boxes::before { + content: "\f468"; } + +.fa-boxes-alt::before { + content: "\f468"; } + +.fa-link::before { + content: "\f0c1"; } + +.fa-chain::before { + content: "\f0c1"; } + +.fa-ear-listen::before { + content: "\f2a2"; } + +.fa-assistive-listening-systems::before { + content: "\f2a2"; } + +.fa-tree-city::before { + content: "\e587"; } + +.fa-play::before { + content: "\f04b"; } + +.fa-font::before { + content: "\f031"; } + +.fa-table-cells-row-lock::before { + content: "\e67a"; } + +.fa-rupiah-sign::before { + content: "\e23d"; } + +.fa-magnifying-glass::before { + content: "\f002"; } + +.fa-search::before { + content: "\f002"; } + +.fa-table-tennis-paddle-ball::before { + content: "\f45d"; } + +.fa-ping-pong-paddle-ball::before { + content: "\f45d"; } + +.fa-table-tennis::before { + content: "\f45d"; } + +.fa-person-dots-from-line::before { + content: "\f470"; } + +.fa-diagnoses::before { + content: "\f470"; } + +.fa-trash-can-arrow-up::before { + content: "\f82a"; } + +.fa-trash-restore-alt::before { + content: "\f82a"; } + +.fa-naira-sign::before { + content: "\e1f6"; } + +.fa-cart-arrow-down::before { + content: "\f218"; } + +.fa-walkie-talkie::before { + content: "\f8ef"; } + +.fa-file-pen::before { + content: "\f31c"; } + +.fa-file-edit::before { + content: "\f31c"; } + +.fa-receipt::before { + content: "\f543"; } + +.fa-square-pen::before { + content: "\f14b"; } + +.fa-pen-square::before { + content: "\f14b"; } + +.fa-pencil-square::before { + content: "\f14b"; } + +.fa-suitcase-rolling::before { + content: "\f5c1"; } + +.fa-person-circle-exclamation::before { + content: "\e53f"; } + +.fa-chevron-down::before { + content: "\f078"; } + +.fa-battery-full::before { + content: "\f240"; } + +.fa-battery::before { + content: "\f240"; } + +.fa-battery-5::before { + content: "\f240"; } + +.fa-skull-crossbones::before { + content: "\f714"; } + +.fa-code-compare::before { + content: "\e13a"; } + +.fa-list-ul::before { + content: "\f0ca"; } + +.fa-list-dots::before { + content: "\f0ca"; } + +.fa-school-lock::before { + content: "\e56f"; } + +.fa-tower-cell::before { + content: "\e585"; } + +.fa-down-long::before { + content: "\f309"; } + +.fa-long-arrow-alt-down::before { + content: "\f309"; } + +.fa-ranking-star::before { + content: "\e561"; } + +.fa-chess-king::before { + content: "\f43f"; } + +.fa-person-harassing::before { + content: "\e549"; } + +.fa-brazilian-real-sign::before { + content: "\e46c"; } + +.fa-landmark-dome::before { + content: "\f752"; } + +.fa-landmark-alt::before { + content: "\f752"; } + +.fa-arrow-up::before { + content: "\f062"; } + +.fa-tv::before { + content: "\f26c"; } + +.fa-television::before { + content: "\f26c"; } + +.fa-tv-alt::before { + content: "\f26c"; } + +.fa-shrimp::before { + content: "\e448"; } + +.fa-list-check::before { + content: "\f0ae"; } + +.fa-tasks::before { + content: "\f0ae"; } + +.fa-jug-detergent::before { + content: "\e519"; } + +.fa-circle-user::before { + content: "\f2bd"; } + +.fa-user-circle::before { + content: "\f2bd"; } + +.fa-user-shield::before { + content: "\f505"; } + +.fa-wind::before { + content: "\f72e"; } + +.fa-car-burst::before { + content: "\f5e1"; } + +.fa-car-crash::before { + content: "\f5e1"; } + +.fa-y::before { + content: "\59"; } + +.fa-person-snowboarding::before { + content: "\f7ce"; } + +.fa-snowboarding::before { + content: "\f7ce"; } + +.fa-truck-fast::before { + content: "\f48b"; } + +.fa-shipping-fast::before { + content: "\f48b"; } + +.fa-fish::before { + content: "\f578"; } + +.fa-user-graduate::before { + content: "\f501"; } + +.fa-circle-half-stroke::before { + content: "\f042"; } + +.fa-adjust::before { + content: "\f042"; } + +.fa-clapperboard::before { + content: "\e131"; } + +.fa-circle-radiation::before { + content: "\f7ba"; } + +.fa-radiation-alt::before { + content: "\f7ba"; } + +.fa-baseball::before { + content: "\f433"; } + +.fa-baseball-ball::before { + content: "\f433"; } + +.fa-jet-fighter-up::before { + content: "\e518"; } + +.fa-diagram-project::before { + content: "\f542"; } + +.fa-project-diagram::before { + content: "\f542"; } + +.fa-copy::before { + content: "\f0c5"; } + +.fa-volume-xmark::before { + content: "\f6a9"; } + +.fa-volume-mute::before { + content: "\f6a9"; } + +.fa-volume-times::before { + content: "\f6a9"; } + +.fa-hand-sparkles::before { + content: "\e05d"; } + +.fa-grip::before { + content: "\f58d"; } + +.fa-grip-horizontal::before { + content: "\f58d"; } + +.fa-share-from-square::before { + content: "\f14d"; } + +.fa-share-square::before { + content: "\f14d"; } + +.fa-child-combatant::before { + content: "\e4e0"; } + +.fa-child-rifle::before { + content: "\e4e0"; } + +.fa-gun::before { + content: "\e19b"; } + +.fa-square-phone::before { + content: "\f098"; } + +.fa-phone-square::before { + content: "\f098"; } + +.fa-plus::before { + content: "\2b"; } + +.fa-add::before { + content: "\2b"; } + +.fa-expand::before { + content: "\f065"; } + +.fa-computer::before { + content: "\e4e5"; } + +.fa-xmark::before { + content: "\f00d"; } + +.fa-close::before { + content: "\f00d"; } + +.fa-multiply::before { + content: "\f00d"; } + +.fa-remove::before { + content: "\f00d"; } + +.fa-times::before { + content: "\f00d"; } + +.fa-arrows-up-down-left-right::before { + content: "\f047"; } + +.fa-arrows::before { + content: "\f047"; } + +.fa-chalkboard-user::before { + content: "\f51c"; } + +.fa-chalkboard-teacher::before { + content: "\f51c"; } + +.fa-peso-sign::before { + content: "\e222"; } + +.fa-building-shield::before { + content: "\e4d8"; } + +.fa-baby::before { + content: "\f77c"; } + +.fa-users-line::before { + content: "\e592"; } + +.fa-quote-left::before { + content: "\f10d"; } + +.fa-quote-left-alt::before { + content: "\f10d"; } + +.fa-tractor::before { + content: "\f722"; } + +.fa-trash-arrow-up::before { + content: "\f829"; } + +.fa-trash-restore::before { + content: "\f829"; } + +.fa-arrow-down-up-lock::before { + content: "\e4b0"; } + +.fa-lines-leaning::before { + content: "\e51e"; } + +.fa-ruler-combined::before { + content: "\f546"; } + +.fa-copyright::before { + content: "\f1f9"; } + +.fa-equals::before { + content: "\3d"; } + +.fa-blender::before { + content: "\f517"; } + +.fa-teeth::before { + content: "\f62e"; } + +.fa-shekel-sign::before { + content: "\f20b"; } + +.fa-ils::before { + content: "\f20b"; } + +.fa-shekel::before { + content: "\f20b"; } + +.fa-sheqel::before { + content: "\f20b"; } + +.fa-sheqel-sign::before { + content: "\f20b"; } + +.fa-map::before { + content: "\f279"; } + +.fa-rocket::before { + content: "\f135"; } + +.fa-photo-film::before { + content: "\f87c"; } + +.fa-photo-video::before { + content: "\f87c"; } + +.fa-folder-minus::before { + content: "\f65d"; } + +.fa-store::before { + content: "\f54e"; } + +.fa-arrow-trend-up::before { + content: "\e098"; } + +.fa-plug-circle-minus::before { + content: "\e55e"; } + +.fa-sign-hanging::before { + content: "\f4d9"; } + +.fa-sign::before { + content: "\f4d9"; } + +.fa-bezier-curve::before { + content: "\f55b"; } + +.fa-bell-slash::before { + content: "\f1f6"; } + +.fa-tablet::before { + content: "\f3fb"; } + +.fa-tablet-android::before { + content: "\f3fb"; } + +.fa-school-flag::before { + content: "\e56e"; } + +.fa-fill::before { + content: "\f575"; } + +.fa-angle-up::before { + content: "\f106"; } + +.fa-drumstick-bite::before { + content: "\f6d7"; } + +.fa-holly-berry::before { + content: "\f7aa"; } + +.fa-chevron-left::before { + content: "\f053"; } + +.fa-bacteria::before { + content: "\e059"; } + +.fa-hand-lizard::before { + content: "\f258"; } + +.fa-notdef::before { + content: "\e1fe"; } + +.fa-disease::before { + content: "\f7fa"; } + +.fa-briefcase-medical::before { + content: "\f469"; } + +.fa-genderless::before { + content: "\f22d"; } + +.fa-chevron-right::before { + content: "\f054"; } + +.fa-retweet::before { + content: "\f079"; } + +.fa-car-rear::before { + content: "\f5de"; } + +.fa-car-alt::before { + content: "\f5de"; } + +.fa-pump-soap::before { + content: "\e06b"; } + +.fa-video-slash::before { + content: "\f4e2"; } + +.fa-battery-quarter::before { + content: "\f243"; } + +.fa-battery-2::before { + content: "\f243"; } + +.fa-radio::before { + content: "\f8d7"; } + +.fa-baby-carriage::before { + content: "\f77d"; } + +.fa-carriage-baby::before { + content: "\f77d"; } + +.fa-traffic-light::before { + content: "\f637"; } + +.fa-thermometer::before { + content: "\f491"; } + +.fa-vr-cardboard::before { + content: "\f729"; } + +.fa-hand-middle-finger::before { + content: "\f806"; } + +.fa-percent::before { + content: "\25"; } + +.fa-percentage::before { + content: "\25"; } + +.fa-truck-moving::before { + content: "\f4df"; } + +.fa-glass-water-droplet::before { + content: "\e4f5"; } + +.fa-display::before { + content: "\e163"; } + +.fa-face-smile::before { + content: "\f118"; } + +.fa-smile::before { + content: "\f118"; } + +.fa-thumbtack::before { + content: "\f08d"; } + +.fa-thumb-tack::before { + content: "\f08d"; } + +.fa-trophy::before { + content: "\f091"; } + +.fa-person-praying::before { + content: "\f683"; } + +.fa-pray::before { + content: "\f683"; } + +.fa-hammer::before { + content: "\f6e3"; } + +.fa-hand-peace::before { + content: "\f25b"; } + +.fa-rotate::before { + content: "\f2f1"; } + +.fa-sync-alt::before { + content: "\f2f1"; } + +.fa-spinner::before { + content: "\f110"; } + +.fa-robot::before { + content: "\f544"; } + +.fa-peace::before { + content: "\f67c"; } + +.fa-gears::before { + content: "\f085"; } + +.fa-cogs::before { + content: "\f085"; } + +.fa-warehouse::before { + content: "\f494"; } + +.fa-arrow-up-right-dots::before { + content: "\e4b7"; } + +.fa-splotch::before { + content: "\f5bc"; } + +.fa-face-grin-hearts::before { + content: "\f584"; } + +.fa-grin-hearts::before { + content: "\f584"; } + +.fa-dice-four::before { + content: "\f524"; } + +.fa-sim-card::before { + content: "\f7c4"; } + +.fa-transgender::before { + content: "\f225"; } + +.fa-transgender-alt::before { + content: "\f225"; } + +.fa-mercury::before { + content: "\f223"; } + +.fa-arrow-turn-down::before { + content: "\f149"; } + +.fa-level-down::before { + content: "\f149"; } + +.fa-person-falling-burst::before { + content: "\e547"; } + +.fa-award::before { + content: "\f559"; } + +.fa-ticket-simple::before { + content: "\f3ff"; } + +.fa-ticket-alt::before { + content: "\f3ff"; } + +.fa-building::before { + content: "\f1ad"; } + +.fa-angles-left::before { + content: "\f100"; } + +.fa-angle-double-left::before { + content: "\f100"; } + +.fa-qrcode::before { + content: "\f029"; } + +.fa-clock-rotate-left::before { + content: "\f1da"; } + +.fa-history::before { + content: "\f1da"; } + +.fa-face-grin-beam-sweat::before { + content: "\f583"; } + +.fa-grin-beam-sweat::before { + content: "\f583"; } + +.fa-file-export::before { + content: "\f56e"; } + +.fa-arrow-right-from-file::before { + content: "\f56e"; } + +.fa-shield::before { + content: "\f132"; } + +.fa-shield-blank::before { + content: "\f132"; } + +.fa-arrow-up-short-wide::before { + content: "\f885"; } + +.fa-sort-amount-up-alt::before { + content: "\f885"; } + +.fa-house-medical::before { + content: "\e3b2"; } + +.fa-golf-ball-tee::before { + content: "\f450"; } + +.fa-golf-ball::before { + content: "\f450"; } + +.fa-circle-chevron-left::before { + content: "\f137"; } + +.fa-chevron-circle-left::before { + content: "\f137"; } + +.fa-house-chimney-window::before { + content: "\e00d"; } + +.fa-pen-nib::before { + content: "\f5ad"; } + +.fa-tent-arrow-turn-left::before { + content: "\e580"; } + +.fa-tents::before { + content: "\e582"; } + +.fa-wand-magic::before { + content: "\f0d0"; } + +.fa-magic::before { + content: "\f0d0"; } + +.fa-dog::before { + content: "\f6d3"; } + +.fa-carrot::before { + content: "\f787"; } + +.fa-moon::before { + content: "\f186"; } + +.fa-wine-glass-empty::before { + content: "\f5ce"; } + +.fa-wine-glass-alt::before { + content: "\f5ce"; } + +.fa-cheese::before { + content: "\f7ef"; } + +.fa-yin-yang::before { + content: "\f6ad"; } + +.fa-music::before { + content: "\f001"; } + +.fa-code-commit::before { + content: "\f386"; } + +.fa-temperature-low::before { + content: "\f76b"; } + +.fa-person-biking::before { + content: "\f84a"; } + +.fa-biking::before { + content: "\f84a"; } + +.fa-broom::before { + content: "\f51a"; } + +.fa-shield-heart::before { + content: "\e574"; } + +.fa-gopuram::before { + content: "\f664"; } + +.fa-earth-oceania::before { + content: "\e47b"; } + +.fa-globe-oceania::before { + content: "\e47b"; } + +.fa-square-xmark::before { + content: "\f2d3"; } + +.fa-times-square::before { + content: "\f2d3"; } + +.fa-xmark-square::before { + content: "\f2d3"; } + +.fa-hashtag::before { + content: "\23"; } + +.fa-up-right-and-down-left-from-center::before { + content: "\f424"; } + +.fa-expand-alt::before { + content: "\f424"; } + +.fa-oil-can::before { + content: "\f613"; } + +.fa-t::before { + content: "\54"; } + +.fa-hippo::before { + content: "\f6ed"; } + +.fa-chart-column::before { + content: "\e0e3"; } + +.fa-infinity::before { + content: "\f534"; } + +.fa-vial-circle-check::before { + content: "\e596"; } + +.fa-person-arrow-down-to-line::before { + content: "\e538"; } + +.fa-voicemail::before { + content: "\f897"; } + +.fa-fan::before { + content: "\f863"; } + +.fa-person-walking-luggage::before { + content: "\e554"; } + +.fa-up-down::before { + content: "\f338"; } + +.fa-arrows-alt-v::before { + content: "\f338"; } + +.fa-cloud-moon-rain::before { + content: "\f73c"; } + +.fa-calendar::before { + content: "\f133"; } + +.fa-trailer::before { + content: "\e041"; } + +.fa-bahai::before { + content: "\f666"; } + +.fa-haykal::before { + content: "\f666"; } + +.fa-sd-card::before { + content: "\f7c2"; } + +.fa-dragon::before { + content: "\f6d5"; } + +.fa-shoe-prints::before { + content: "\f54b"; } + +.fa-circle-plus::before { + content: "\f055"; } + +.fa-plus-circle::before { + content: "\f055"; } + +.fa-face-grin-tongue-wink::before { + content: "\f58b"; } + +.fa-grin-tongue-wink::before { + content: "\f58b"; } + +.fa-hand-holding::before { + content: "\f4bd"; } + +.fa-plug-circle-exclamation::before { + content: "\e55d"; } + +.fa-link-slash::before { + content: "\f127"; } + +.fa-chain-broken::before { + content: "\f127"; } + +.fa-chain-slash::before { + content: "\f127"; } + +.fa-unlink::before { + content: "\f127"; } + +.fa-clone::before { + content: "\f24d"; } + +.fa-person-walking-arrow-loop-left::before { + content: "\e551"; } + +.fa-arrow-up-z-a::before { + content: "\f882"; } + +.fa-sort-alpha-up-alt::before { + content: "\f882"; } + +.fa-fire-flame-curved::before { + content: "\f7e4"; } + +.fa-fire-alt::before { + content: "\f7e4"; } + +.fa-tornado::before { + content: "\f76f"; } + +.fa-file-circle-plus::before { + content: "\e494"; } + +.fa-book-quran::before { + content: "\f687"; } + +.fa-quran::before { + content: "\f687"; } + +.fa-anchor::before { + content: "\f13d"; } + +.fa-border-all::before { + content: "\f84c"; } + +.fa-face-angry::before { + content: "\f556"; } + +.fa-angry::before { + content: "\f556"; } + +.fa-cookie-bite::before { + content: "\f564"; } + +.fa-arrow-trend-down::before { + content: "\e097"; } + +.fa-rss::before { + content: "\f09e"; } + +.fa-feed::before { + content: "\f09e"; } + +.fa-draw-polygon::before { + content: "\f5ee"; } + +.fa-scale-balanced::before { + content: "\f24e"; } + +.fa-balance-scale::before { + content: "\f24e"; } + +.fa-gauge-simple-high::before { + content: "\f62a"; } + +.fa-tachometer::before { + content: "\f62a"; } + +.fa-tachometer-fast::before { + content: "\f62a"; } + +.fa-shower::before { + content: "\f2cc"; } + +.fa-desktop::before { + content: "\f390"; } + +.fa-desktop-alt::before { + content: "\f390"; } + +.fa-m::before { + content: "\4d"; } + +.fa-table-list::before { + content: "\f00b"; } + +.fa-th-list::before { + content: "\f00b"; } + +.fa-comment-sms::before { + content: "\f7cd"; } + +.fa-sms::before { + content: "\f7cd"; } + +.fa-book::before { + content: "\f02d"; } + +.fa-user-plus::before { + content: "\f234"; } + +.fa-check::before { + content: "\f00c"; } + +.fa-battery-three-quarters::before { + content: "\f241"; } + +.fa-battery-4::before { + content: "\f241"; } + +.fa-house-circle-check::before { + content: "\e509"; } + +.fa-angle-left::before { + content: "\f104"; } + +.fa-diagram-successor::before { + content: "\e47a"; } + +.fa-truck-arrow-right::before { + content: "\e58b"; } + +.fa-arrows-split-up-and-left::before { + content: "\e4bc"; } + +.fa-hand-fist::before { + content: "\f6de"; } + +.fa-fist-raised::before { + content: "\f6de"; } + +.fa-cloud-moon::before { + content: "\f6c3"; } + +.fa-briefcase::before { + content: "\f0b1"; } + +.fa-person-falling::before { + content: "\e546"; } + +.fa-image-portrait::before { + content: "\f3e0"; } + +.fa-portrait::before { + content: "\f3e0"; } + +.fa-user-tag::before { + content: "\f507"; } + +.fa-rug::before { + content: "\e569"; } + +.fa-earth-europe::before { + content: "\f7a2"; } + +.fa-globe-europe::before { + content: "\f7a2"; } + +.fa-cart-flatbed-suitcase::before { + content: "\f59d"; } + +.fa-luggage-cart::before { + content: "\f59d"; } + +.fa-rectangle-xmark::before { + content: "\f410"; } + +.fa-rectangle-times::before { + content: "\f410"; } + +.fa-times-rectangle::before { + content: "\f410"; } + +.fa-window-close::before { + content: "\f410"; } + +.fa-baht-sign::before { + content: "\e0ac"; } + +.fa-book-open::before { + content: "\f518"; } + +.fa-book-journal-whills::before { + content: "\f66a"; } + +.fa-journal-whills::before { + content: "\f66a"; } + +.fa-handcuffs::before { + content: "\e4f8"; } + +.fa-triangle-exclamation::before { + content: "\f071"; } + +.fa-exclamation-triangle::before { + content: "\f071"; } + +.fa-warning::before { + content: "\f071"; } + +.fa-database::before { + content: "\f1c0"; } + +.fa-share::before { + content: "\f064"; } + +.fa-mail-forward::before { + content: "\f064"; } + +.fa-bottle-droplet::before { + content: "\e4c4"; } + +.fa-mask-face::before { + content: "\e1d7"; } + +.fa-hill-rockslide::before { + content: "\e508"; } + +.fa-right-left::before { + content: "\f362"; } + +.fa-exchange-alt::before { + content: "\f362"; } + +.fa-paper-plane::before { + content: "\f1d8"; } + +.fa-road-circle-exclamation::before { + content: "\e565"; } + +.fa-dungeon::before { + content: "\f6d9"; } + +.fa-align-right::before { + content: "\f038"; } + +.fa-money-bill-1-wave::before { + content: "\f53b"; } + +.fa-money-bill-wave-alt::before { + content: "\f53b"; } + +.fa-life-ring::before { + content: "\f1cd"; } + +.fa-hands::before { + content: "\f2a7"; } + +.fa-sign-language::before { + content: "\f2a7"; } + +.fa-signing::before { + content: "\f2a7"; } + +.fa-calendar-day::before { + content: "\f783"; } + +.fa-water-ladder::before { + content: "\f5c5"; } + +.fa-ladder-water::before { + content: "\f5c5"; } + +.fa-swimming-pool::before { + content: "\f5c5"; } + +.fa-arrows-up-down::before { + content: "\f07d"; } + +.fa-arrows-v::before { + content: "\f07d"; } + +.fa-face-grimace::before { + content: "\f57f"; } + +.fa-grimace::before { + content: "\f57f"; } + +.fa-wheelchair-move::before { + content: "\e2ce"; } + +.fa-wheelchair-alt::before { + content: "\e2ce"; } + +.fa-turn-down::before { + content: "\f3be"; } + +.fa-level-down-alt::before { + content: "\f3be"; } + +.fa-person-walking-arrow-right::before { + content: "\e552"; } + +.fa-square-envelope::before { + content: "\f199"; } + +.fa-envelope-square::before { + content: "\f199"; } + +.fa-dice::before { + content: "\f522"; } + +.fa-bowling-ball::before { + content: "\f436"; } + +.fa-brain::before { + content: "\f5dc"; } + +.fa-bandage::before { + content: "\f462"; } + +.fa-band-aid::before { + content: "\f462"; } + +.fa-calendar-minus::before { + content: "\f272"; } + +.fa-circle-xmark::before { + content: "\f057"; } + +.fa-times-circle::before { + content: "\f057"; } + +.fa-xmark-circle::before { + content: "\f057"; } + +.fa-gifts::before { + content: "\f79c"; } + +.fa-hotel::before { + content: "\f594"; } + +.fa-earth-asia::before { + content: "\f57e"; } + +.fa-globe-asia::before { + content: "\f57e"; } + +.fa-id-card-clip::before { + content: "\f47f"; } + +.fa-id-card-alt::before { + content: "\f47f"; } + +.fa-magnifying-glass-plus::before { + content: "\f00e"; } + +.fa-search-plus::before { + content: "\f00e"; } + +.fa-thumbs-up::before { + content: "\f164"; } + +.fa-user-clock::before { + content: "\f4fd"; } + +.fa-hand-dots::before { + content: "\f461"; } + +.fa-allergies::before { + content: "\f461"; } + +.fa-file-invoice::before { + content: "\f570"; } + +.fa-window-minimize::before { + content: "\f2d1"; } + +.fa-mug-saucer::before { + content: "\f0f4"; } + +.fa-coffee::before { + content: "\f0f4"; } + +.fa-brush::before { + content: "\f55d"; } + +.fa-mask::before { + content: "\f6fa"; } + +.fa-magnifying-glass-minus::before { + content: "\f010"; } + +.fa-search-minus::before { + content: "\f010"; } + +.fa-ruler-vertical::before { + content: "\f548"; } + +.fa-user-large::before { + content: "\f406"; } + +.fa-user-alt::before { + content: "\f406"; } + +.fa-train-tram::before { + content: "\e5b4"; } + +.fa-user-nurse::before { + content: "\f82f"; } + +.fa-syringe::before { + content: "\f48e"; } + +.fa-cloud-sun::before { + content: "\f6c4"; } + +.fa-stopwatch-20::before { + content: "\e06f"; } + +.fa-square-full::before { + content: "\f45c"; } + +.fa-magnet::before { + content: "\f076"; } + +.fa-jar::before { + content: "\e516"; } + +.fa-note-sticky::before { + content: "\f249"; } + +.fa-sticky-note::before { + content: "\f249"; } + +.fa-bug-slash::before { + content: "\e490"; } + +.fa-arrow-up-from-water-pump::before { + content: "\e4b6"; } + +.fa-bone::before { + content: "\f5d7"; } + +.fa-user-injured::before { + content: "\f728"; } + +.fa-face-sad-tear::before { + content: "\f5b4"; } + +.fa-sad-tear::before { + content: "\f5b4"; } + +.fa-plane::before { + content: "\f072"; } + +.fa-tent-arrows-down::before { + content: "\e581"; } + +.fa-exclamation::before { + content: "\21"; } + +.fa-arrows-spin::before { + content: "\e4bb"; } + +.fa-print::before { + content: "\f02f"; } + +.fa-turkish-lira-sign::before { + content: "\e2bb"; } + +.fa-try::before { + content: "\e2bb"; } + +.fa-turkish-lira::before { + content: "\e2bb"; } + +.fa-dollar-sign::before { + content: "\24"; } + +.fa-dollar::before { + content: "\24"; } + +.fa-usd::before { + content: "\24"; } + +.fa-x::before { + content: "\58"; } + +.fa-magnifying-glass-dollar::before { + content: "\f688"; } + +.fa-search-dollar::before { + content: "\f688"; } + +.fa-users-gear::before { + content: "\f509"; } + +.fa-users-cog::before { + content: "\f509"; } + +.fa-person-military-pointing::before { + content: "\e54a"; } + +.fa-building-columns::before { + content: "\f19c"; } + +.fa-bank::before { + content: "\f19c"; } + +.fa-institution::before { + content: "\f19c"; } + +.fa-museum::before { + content: "\f19c"; } + +.fa-university::before { + content: "\f19c"; } + +.fa-umbrella::before { + content: "\f0e9"; } + +.fa-trowel::before { + content: "\e589"; } + +.fa-d::before { + content: "\44"; } + +.fa-stapler::before { + content: "\e5af"; } + +.fa-masks-theater::before { + content: "\f630"; } + +.fa-theater-masks::before { + content: "\f630"; } + +.fa-kip-sign::before { + content: "\e1c4"; } + +.fa-hand-point-left::before { + content: "\f0a5"; } + +.fa-handshake-simple::before { + content: "\f4c6"; } + +.fa-handshake-alt::before { + content: "\f4c6"; } + +.fa-jet-fighter::before { + content: "\f0fb"; } + +.fa-fighter-jet::before { + content: "\f0fb"; } + +.fa-square-share-nodes::before { + content: "\f1e1"; } + +.fa-share-alt-square::before { + content: "\f1e1"; } + +.fa-barcode::before { + content: "\f02a"; } + +.fa-plus-minus::before { + content: "\e43c"; } + +.fa-video::before { + content: "\f03d"; } + +.fa-video-camera::before { + content: "\f03d"; } + +.fa-graduation-cap::before { + content: "\f19d"; } + +.fa-mortar-board::before { + content: "\f19d"; } + +.fa-hand-holding-medical::before { + content: "\e05c"; } + +.fa-person-circle-check::before { + content: "\e53e"; } + +.fa-turn-up::before { + content: "\f3bf"; } + +.fa-level-up-alt::before { + content: "\f3bf"; } + +.sr-only, +.fa-sr-only { + position: absolute; + width: 1px; + height: 1px; + padding: 0; + margin: -1px; + overflow: hidden; + clip: rect(0, 0, 0, 0); + white-space: nowrap; + border-width: 0; } + +.sr-only-focusable:not(:focus), +.fa-sr-only-focusable:not(:focus) { + position: absolute; + width: 1px; + height: 1px; + padding: 0; + margin: -1px; + overflow: hidden; + clip: rect(0, 0, 0, 0); + white-space: nowrap; + border-width: 0; } +:root, :host { + --fa-style-family-brands: 'Font Awesome 6 Brands'; + --fa-font-brands: normal 400 1em/1 'Font Awesome 6 Brands'; } + +@font-face { + font-family: 'Font Awesome 6 Brands'; + font-style: normal; + font-weight: 400; + font-display: block; + src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); } + +.fab, +.fa-brands { + font-weight: 400; } + +.fa-monero:before { + content: "\f3d0"; } + +.fa-hooli:before { + content: "\f427"; } + +.fa-yelp:before { + content: "\f1e9"; } + +.fa-cc-visa:before { + content: "\f1f0"; } + +.fa-lastfm:before { + content: "\f202"; } + +.fa-shopware:before { + content: "\f5b5"; } + +.fa-creative-commons-nc:before { + content: "\f4e8"; } + +.fa-aws:before { + content: "\f375"; } + +.fa-redhat:before { + content: "\f7bc"; } + +.fa-yoast:before { + content: "\f2b1"; } + +.fa-cloudflare:before { + content: "\e07d"; } + +.fa-ups:before { + content: "\f7e0"; } + +.fa-pixiv:before { + content: "\e640"; } + +.fa-wpexplorer:before { + content: "\f2de"; } + +.fa-dyalog:before { + content: "\f399"; } + +.fa-bity:before { + content: "\f37a"; } + +.fa-stackpath:before { + content: "\f842"; } + +.fa-buysellads:before { + content: "\f20d"; } + +.fa-first-order:before { + content: "\f2b0"; } + +.fa-modx:before { + content: "\f285"; } + +.fa-guilded:before { + content: "\e07e"; } + +.fa-vnv:before { + content: "\f40b"; } + +.fa-square-js:before { + content: "\f3b9"; } + +.fa-js-square:before { + content: "\f3b9"; } + +.fa-microsoft:before { + content: "\f3ca"; } + +.fa-qq:before { + content: "\f1d6"; } + +.fa-orcid:before { + content: "\f8d2"; } + +.fa-java:before { + content: "\f4e4"; } + +.fa-invision:before { + content: "\f7b0"; } + +.fa-creative-commons-pd-alt:before { + content: "\f4ed"; } + +.fa-centercode:before { + content: "\f380"; } + +.fa-glide-g:before { + content: "\f2a6"; } + +.fa-drupal:before { + content: "\f1a9"; } + +.fa-jxl:before { + content: "\e67b"; } + +.fa-hire-a-helper:before { + content: "\f3b0"; } + +.fa-creative-commons-by:before { + content: "\f4e7"; } + +.fa-unity:before { + content: "\e049"; } + +.fa-whmcs:before { + content: "\f40d"; } + +.fa-rocketchat:before { + content: "\f3e8"; } + +.fa-vk:before { + content: "\f189"; } + +.fa-untappd:before { + content: "\f405"; } + +.fa-mailchimp:before { + content: "\f59e"; } + +.fa-css3-alt:before { + content: "\f38b"; } + +.fa-square-reddit:before { + content: "\f1a2"; } + +.fa-reddit-square:before { + content: "\f1a2"; } + +.fa-vimeo-v:before { + content: "\f27d"; } + +.fa-contao:before { + content: "\f26d"; } + +.fa-square-font-awesome:before { + content: "\e5ad"; } + +.fa-deskpro:before { + content: "\f38f"; } + +.fa-brave:before { + content: "\e63c"; } + +.fa-sistrix:before { + content: "\f3ee"; } + +.fa-square-instagram:before { + content: "\e055"; } + +.fa-instagram-square:before { + content: "\e055"; } + +.fa-battle-net:before { + content: "\f835"; } + +.fa-the-red-yeti:before { + content: "\f69d"; } + +.fa-square-hacker-news:before { + content: "\f3af"; } + +.fa-hacker-news-square:before { + content: "\f3af"; } + +.fa-edge:before { + content: "\f282"; } + +.fa-threads:before { + content: "\e618"; } + +.fa-napster:before { + content: "\f3d2"; } + +.fa-square-snapchat:before { + content: "\f2ad"; } + +.fa-snapchat-square:before { + content: "\f2ad"; } + +.fa-google-plus-g:before { + content: "\f0d5"; } + +.fa-artstation:before { + content: "\f77a"; } + +.fa-markdown:before { + content: "\f60f"; } + +.fa-sourcetree:before { + content: "\f7d3"; } + +.fa-google-plus:before { + content: "\f2b3"; } + +.fa-diaspora:before { + content: "\f791"; } + +.fa-foursquare:before { + content: "\f180"; } + +.fa-stack-overflow:before { + content: "\f16c"; } + +.fa-github-alt:before { + content: "\f113"; } + +.fa-phoenix-squadron:before { + content: "\f511"; } + +.fa-pagelines:before { + content: "\f18c"; } + +.fa-algolia:before { + content: "\f36c"; } + +.fa-red-river:before { + content: "\f3e3"; } + +.fa-creative-commons-sa:before { + content: "\f4ef"; } + +.fa-safari:before { + content: "\f267"; } + +.fa-google:before { + content: "\f1a0"; } + +.fa-square-font-awesome-stroke:before { + content: "\f35c"; } + +.fa-font-awesome-alt:before { + content: "\f35c"; } + +.fa-atlassian:before { + content: "\f77b"; } + +.fa-linkedin-in:before { + content: "\f0e1"; } + +.fa-digital-ocean:before { + content: "\f391"; } + +.fa-nimblr:before { + content: "\f5a8"; } + +.fa-chromecast:before { + content: "\f838"; } + +.fa-evernote:before { + content: "\f839"; } + +.fa-hacker-news:before { + content: "\f1d4"; } + +.fa-creative-commons-sampling:before { + content: "\f4f0"; } + +.fa-adversal:before { + content: "\f36a"; } + +.fa-creative-commons:before { + content: "\f25e"; } + +.fa-watchman-monitoring:before { + content: "\e087"; } + +.fa-fonticons:before { + content: "\f280"; } + +.fa-weixin:before { + content: "\f1d7"; } + +.fa-shirtsinbulk:before { + content: "\f214"; } + +.fa-codepen:before { + content: "\f1cb"; } + +.fa-git-alt:before { + content: "\f841"; } + +.fa-lyft:before { + content: "\f3c3"; } + +.fa-rev:before { + content: "\f5b2"; } + +.fa-windows:before { + content: "\f17a"; } + +.fa-wizards-of-the-coast:before { + content: "\f730"; } + +.fa-square-viadeo:before { + content: "\f2aa"; } + +.fa-viadeo-square:before { + content: "\f2aa"; } + +.fa-meetup:before { + content: "\f2e0"; } + +.fa-centos:before { + content: "\f789"; } + +.fa-adn:before { + content: "\f170"; } + +.fa-cloudsmith:before { + content: "\f384"; } + +.fa-opensuse:before { + content: "\e62b"; } + +.fa-pied-piper-alt:before { + content: "\f1a8"; } + +.fa-square-dribbble:before { + content: "\f397"; } + +.fa-dribbble-square:before { + content: "\f397"; } + +.fa-codiepie:before { + content: "\f284"; } + +.fa-node:before { + content: "\f419"; } + +.fa-mix:before { + content: "\f3cb"; } + +.fa-steam:before { + content: "\f1b6"; } + +.fa-cc-apple-pay:before { + content: "\f416"; } + +.fa-scribd:before { + content: "\f28a"; } + +.fa-debian:before { + content: "\e60b"; } + +.fa-openid:before { + content: "\f19b"; } + +.fa-instalod:before { + content: "\e081"; } + +.fa-expeditedssl:before { + content: "\f23e"; } + +.fa-sellcast:before { + content: "\f2da"; } + +.fa-square-twitter:before { + content: "\f081"; } + +.fa-twitter-square:before { + content: "\f081"; } + +.fa-r-project:before { + content: "\f4f7"; } + +.fa-delicious:before { + content: "\f1a5"; } + +.fa-freebsd:before { + content: "\f3a4"; } + +.fa-vuejs:before { + content: "\f41f"; } + +.fa-accusoft:before { + content: "\f369"; } + +.fa-ioxhost:before { + content: "\f208"; } + +.fa-fonticons-fi:before { + content: "\f3a2"; } + +.fa-app-store:before { + content: "\f36f"; } + +.fa-cc-mastercard:before { + content: "\f1f1"; } + +.fa-itunes-note:before { + content: "\f3b5"; } + +.fa-golang:before { + content: "\e40f"; } + +.fa-kickstarter:before { + content: "\f3bb"; } + +.fa-square-kickstarter:before { + content: "\f3bb"; } + +.fa-grav:before { + content: "\f2d6"; } + +.fa-weibo:before { + content: "\f18a"; } + +.fa-uncharted:before { + content: "\e084"; } + +.fa-firstdraft:before { + content: "\f3a1"; } + +.fa-square-youtube:before { + content: "\f431"; } + +.fa-youtube-square:before { + content: "\f431"; } + +.fa-wikipedia-w:before { + content: "\f266"; } + +.fa-wpressr:before { + content: "\f3e4"; } + +.fa-rendact:before { + content: "\f3e4"; } + +.fa-angellist:before { + content: "\f209"; } + +.fa-galactic-republic:before { + content: "\f50c"; } + +.fa-nfc-directional:before { + content: "\e530"; } + +.fa-skype:before { + content: "\f17e"; } + +.fa-joget:before { + content: "\f3b7"; } + +.fa-fedora:before { + content: "\f798"; } + +.fa-stripe-s:before { + content: "\f42a"; } + +.fa-meta:before { + content: "\e49b"; } + +.fa-laravel:before { + content: "\f3bd"; } + +.fa-hotjar:before { + content: "\f3b1"; } + +.fa-bluetooth-b:before { + content: "\f294"; } + +.fa-square-letterboxd:before { + content: "\e62e"; } + +.fa-sticker-mule:before { + content: "\f3f7"; } + +.fa-creative-commons-zero:before { + content: "\f4f3"; } + +.fa-hips:before { + content: "\f452"; } + +.fa-behance:before { + content: "\f1b4"; } + +.fa-reddit:before { + content: "\f1a1"; } + +.fa-discord:before { + content: "\f392"; } + +.fa-chrome:before { + content: "\f268"; } + +.fa-app-store-ios:before { + content: "\f370"; } + +.fa-cc-discover:before { + content: "\f1f2"; } + +.fa-wpbeginner:before { + content: "\f297"; } + +.fa-confluence:before { + content: "\f78d"; } + +.fa-shoelace:before { + content: "\e60c"; } + +.fa-mdb:before { + content: "\f8ca"; } + +.fa-dochub:before { + content: "\f394"; } + +.fa-accessible-icon:before { + content: "\f368"; } + +.fa-ebay:before { + content: "\f4f4"; } + +.fa-amazon:before { + content: "\f270"; } + +.fa-unsplash:before { + content: "\e07c"; } + +.fa-yarn:before { + content: "\f7e3"; } + +.fa-square-steam:before { + content: "\f1b7"; } + +.fa-steam-square:before { + content: "\f1b7"; } + +.fa-500px:before { + content: "\f26e"; } + +.fa-square-vimeo:before { + content: "\f194"; } + +.fa-vimeo-square:before { + content: "\f194"; } + +.fa-asymmetrik:before { + content: "\f372"; } + +.fa-font-awesome:before { + content: "\f2b4"; } + +.fa-font-awesome-flag:before { + content: "\f2b4"; } + +.fa-font-awesome-logo-full:before { + content: "\f2b4"; } + +.fa-gratipay:before { + content: "\f184"; } + +.fa-apple:before { + content: "\f179"; } + +.fa-hive:before { + content: "\e07f"; } + +.fa-gitkraken:before { + content: "\f3a6"; } + +.fa-keybase:before { + content: "\f4f5"; } + +.fa-apple-pay:before { + content: "\f415"; } + +.fa-padlet:before { + content: "\e4a0"; } + +.fa-amazon-pay:before { + content: "\f42c"; } + +.fa-square-github:before { + content: "\f092"; } + +.fa-github-square:before { + content: "\f092"; } + +.fa-stumbleupon:before { + content: "\f1a4"; } + +.fa-fedex:before { + content: "\f797"; } + +.fa-phoenix-framework:before { + content: "\f3dc"; } + +.fa-shopify:before { + content: "\e057"; } + +.fa-neos:before { + content: "\f612"; } + +.fa-square-threads:before { + content: "\e619"; } + +.fa-hackerrank:before { + content: "\f5f7"; } + +.fa-researchgate:before { + content: "\f4f8"; } + +.fa-swift:before { + content: "\f8e1"; } + +.fa-angular:before { + content: "\f420"; } + +.fa-speakap:before { + content: "\f3f3"; } + +.fa-angrycreative:before { + content: "\f36e"; } + +.fa-y-combinator:before { + content: "\f23b"; } + +.fa-empire:before { + content: "\f1d1"; } + +.fa-envira:before { + content: "\f299"; } + +.fa-google-scholar:before { + content: "\e63b"; } + +.fa-square-gitlab:before { + content: "\e5ae"; } + +.fa-gitlab-square:before { + content: "\e5ae"; } + +.fa-studiovinari:before { + content: "\f3f8"; } + +.fa-pied-piper:before { + content: "\f2ae"; } + +.fa-wordpress:before { + content: "\f19a"; } + +.fa-product-hunt:before { + content: "\f288"; } + +.fa-firefox:before { + content: "\f269"; } + +.fa-linode:before { + content: "\f2b8"; } + +.fa-goodreads:before { + content: "\f3a8"; } + +.fa-square-odnoklassniki:before { + content: "\f264"; } + +.fa-odnoklassniki-square:before { + content: "\f264"; } + +.fa-jsfiddle:before { + content: "\f1cc"; } + +.fa-sith:before { + content: "\f512"; } + +.fa-themeisle:before { + content: "\f2b2"; } + +.fa-page4:before { + content: "\f3d7"; } + +.fa-hashnode:before { + content: "\e499"; } + +.fa-react:before { + content: "\f41b"; } + +.fa-cc-paypal:before { + content: "\f1f4"; } + +.fa-squarespace:before { + content: "\f5be"; } + +.fa-cc-stripe:before { + content: "\f1f5"; } + +.fa-creative-commons-share:before { + content: "\f4f2"; } + +.fa-bitcoin:before { + content: "\f379"; } + +.fa-keycdn:before { + content: "\f3ba"; } + +.fa-opera:before { + content: "\f26a"; } + +.fa-itch-io:before { + content: "\f83a"; } + +.fa-umbraco:before { + content: "\f8e8"; } + +.fa-galactic-senate:before { + content: "\f50d"; } + +.fa-ubuntu:before { + content: "\f7df"; } + +.fa-draft2digital:before { + content: "\f396"; } + +.fa-stripe:before { + content: "\f429"; } + +.fa-houzz:before { + content: "\f27c"; } + +.fa-gg:before { + content: "\f260"; } + +.fa-dhl:before { + content: "\f790"; } + +.fa-square-pinterest:before { + content: "\f0d3"; } + +.fa-pinterest-square:before { + content: "\f0d3"; } + +.fa-xing:before { + content: "\f168"; } + +.fa-blackberry:before { + content: "\f37b"; } + +.fa-creative-commons-pd:before { + content: "\f4ec"; } + +.fa-playstation:before { + content: "\f3df"; } + +.fa-quinscape:before { + content: "\f459"; } + +.fa-less:before { + content: "\f41d"; } + +.fa-blogger-b:before { + content: "\f37d"; } + +.fa-opencart:before { + content: "\f23d"; } + +.fa-vine:before { + content: "\f1ca"; } + +.fa-signal-messenger:before { + content: "\e663"; } + +.fa-paypal:before { + content: "\f1ed"; } + +.fa-gitlab:before { + content: "\f296"; } + +.fa-typo3:before { + content: "\f42b"; } + +.fa-reddit-alien:before { + content: "\f281"; } + +.fa-yahoo:before { + content: "\f19e"; } + +.fa-dailymotion:before { + content: "\e052"; } + +.fa-affiliatetheme:before { + content: "\f36b"; } + +.fa-pied-piper-pp:before { + content: "\f1a7"; } + +.fa-bootstrap:before { + content: "\f836"; } + +.fa-odnoklassniki:before { + content: "\f263"; } + +.fa-nfc-symbol:before { + content: "\e531"; } + +.fa-mintbit:before { + content: "\e62f"; } + +.fa-ethereum:before { + content: "\f42e"; } + +.fa-speaker-deck:before { + content: "\f83c"; } + +.fa-creative-commons-nc-eu:before { + content: "\f4e9"; } + +.fa-patreon:before { + content: "\f3d9"; } + +.fa-avianex:before { + content: "\f374"; } + +.fa-ello:before { + content: "\f5f1"; } + +.fa-gofore:before { + content: "\f3a7"; } + +.fa-bimobject:before { + content: "\f378"; } + +.fa-brave-reverse:before { + content: "\e63d"; } + +.fa-facebook-f:before { + content: "\f39e"; } + +.fa-square-google-plus:before { + content: "\f0d4"; } + +.fa-google-plus-square:before { + content: "\f0d4"; } + +.fa-web-awesome:before { + content: "\e682"; } + +.fa-mandalorian:before { + content: "\f50f"; } + +.fa-first-order-alt:before { + content: "\f50a"; } + +.fa-osi:before { + content: "\f41a"; } + +.fa-google-wallet:before { + content: "\f1ee"; } + +.fa-d-and-d-beyond:before { + content: "\f6ca"; } + +.fa-periscope:before { + content: "\f3da"; } + +.fa-fulcrum:before { + content: "\f50b"; } + +.fa-cloudscale:before { + content: "\f383"; } + +.fa-forumbee:before { + content: "\f211"; } + +.fa-mizuni:before { + content: "\f3cc"; } + +.fa-schlix:before { + content: "\f3ea"; } + +.fa-square-xing:before { + content: "\f169"; } + +.fa-xing-square:before { + content: "\f169"; } + +.fa-bandcamp:before { + content: "\f2d5"; } + +.fa-wpforms:before { + content: "\f298"; } + +.fa-cloudversify:before { + content: "\f385"; } + +.fa-usps:before { + content: "\f7e1"; } + +.fa-megaport:before { + content: "\f5a3"; } + +.fa-magento:before { + content: "\f3c4"; } + +.fa-spotify:before { + content: "\f1bc"; } + +.fa-optin-monster:before { + content: "\f23c"; } + +.fa-fly:before { + content: "\f417"; } + +.fa-aviato:before { + content: "\f421"; } + +.fa-itunes:before { + content: "\f3b4"; } + +.fa-cuttlefish:before { + content: "\f38c"; } + +.fa-blogger:before { + content: "\f37c"; } + +.fa-flickr:before { + content: "\f16e"; } + +.fa-viber:before { + content: "\f409"; } + +.fa-soundcloud:before { + content: "\f1be"; } + +.fa-digg:before { + content: "\f1a6"; } + +.fa-tencent-weibo:before { + content: "\f1d5"; } + +.fa-letterboxd:before { + content: "\e62d"; } + +.fa-symfony:before { + content: "\f83d"; } + +.fa-maxcdn:before { + content: "\f136"; } + +.fa-etsy:before { + content: "\f2d7"; } + +.fa-facebook-messenger:before { + content: "\f39f"; } + +.fa-audible:before { + content: "\f373"; } + +.fa-think-peaks:before { + content: "\f731"; } + +.fa-bilibili:before { + content: "\e3d9"; } + +.fa-erlang:before { + content: "\f39d"; } + +.fa-x-twitter:before { + content: "\e61b"; } + +.fa-cotton-bureau:before { + content: "\f89e"; } + +.fa-dashcube:before { + content: "\f210"; } + +.fa-42-group:before { + content: "\e080"; } + +.fa-innosoft:before { + content: "\e080"; } + +.fa-stack-exchange:before { + content: "\f18d"; } + +.fa-elementor:before { + content: "\f430"; } + +.fa-square-pied-piper:before { + content: "\e01e"; } + +.fa-pied-piper-square:before { + content: "\e01e"; } + +.fa-creative-commons-nd:before { + content: "\f4eb"; } + +.fa-palfed:before { + content: "\f3d8"; } + +.fa-superpowers:before { + content: "\f2dd"; } + +.fa-resolving:before { + content: "\f3e7"; } + +.fa-xbox:before { + content: "\f412"; } + +.fa-square-web-awesome-stroke:before { + content: "\e684"; } + +.fa-searchengin:before { + content: "\f3eb"; } + +.fa-tiktok:before { + content: "\e07b"; } + +.fa-square-facebook:before { + content: "\f082"; } + +.fa-facebook-square:before { + content: "\f082"; } + +.fa-renren:before { + content: "\f18b"; } + +.fa-linux:before { + content: "\f17c"; } + +.fa-glide:before { + content: "\f2a5"; } + +.fa-linkedin:before { + content: "\f08c"; } + +.fa-hubspot:before { + content: "\f3b2"; } + +.fa-deploydog:before { + content: "\f38e"; } + +.fa-twitch:before { + content: "\f1e8"; } + +.fa-ravelry:before { + content: "\f2d9"; } + +.fa-mixer:before { + content: "\e056"; } + +.fa-square-lastfm:before { + content: "\f203"; } + +.fa-lastfm-square:before { + content: "\f203"; } + +.fa-vimeo:before { + content: "\f40a"; } + +.fa-mendeley:before { + content: "\f7b3"; } + +.fa-uniregistry:before { + content: "\f404"; } + +.fa-figma:before { + content: "\f799"; } + +.fa-creative-commons-remix:before { + content: "\f4ee"; } + +.fa-cc-amazon-pay:before { + content: "\f42d"; } + +.fa-dropbox:before { + content: "\f16b"; } + +.fa-instagram:before { + content: "\f16d"; } + +.fa-cmplid:before { + content: "\e360"; } + +.fa-upwork:before { + content: "\e641"; } + +.fa-facebook:before { + content: "\f09a"; } + +.fa-gripfire:before { + content: "\f3ac"; } + +.fa-jedi-order:before { + content: "\f50e"; } + +.fa-uikit:before { + content: "\f403"; } + +.fa-fort-awesome-alt:before { + content: "\f3a3"; } + +.fa-phabricator:before { + content: "\f3db"; } + +.fa-ussunnah:before { + content: "\f407"; } + +.fa-earlybirds:before { + content: "\f39a"; } + +.fa-trade-federation:before { + content: "\f513"; } + +.fa-autoprefixer:before { + content: "\f41c"; } + +.fa-whatsapp:before { + content: "\f232"; } + +.fa-square-upwork:before { + content: "\e67c"; } + +.fa-slideshare:before { + content: "\f1e7"; } + +.fa-google-play:before { + content: "\f3ab"; } + +.fa-viadeo:before { + content: "\f2a9"; } + +.fa-line:before { + content: "\f3c0"; } + +.fa-google-drive:before { + content: "\f3aa"; } + +.fa-servicestack:before { + content: "\f3ec"; } + +.fa-simplybuilt:before { + content: "\f215"; } + +.fa-bitbucket:before { + content: "\f171"; } + +.fa-imdb:before { + content: "\f2d8"; } + +.fa-deezer:before { + content: "\e077"; } + +.fa-raspberry-pi:before { + content: "\f7bb"; } + +.fa-jira:before { + content: "\f7b1"; } + +.fa-docker:before { + content: "\f395"; } + +.fa-screenpal:before { + content: "\e570"; } + +.fa-bluetooth:before { + content: "\f293"; } + +.fa-gitter:before { + content: "\f426"; } + +.fa-d-and-d:before { + content: "\f38d"; } + +.fa-microblog:before { + content: "\e01a"; } + +.fa-cc-diners-club:before { + content: "\f24c"; } + +.fa-gg-circle:before { + content: "\f261"; } + +.fa-pied-piper-hat:before { + content: "\f4e5"; } + +.fa-kickstarter-k:before { + content: "\f3bc"; } + +.fa-yandex:before { + content: "\f413"; } + +.fa-readme:before { + content: "\f4d5"; } + +.fa-html5:before { + content: "\f13b"; } + +.fa-sellsy:before { + content: "\f213"; } + +.fa-square-web-awesome:before { + content: "\e683"; } + +.fa-sass:before { + content: "\f41e"; } + +.fa-wirsindhandwerk:before { + content: "\e2d0"; } + +.fa-wsh:before { + content: "\e2d0"; } + +.fa-buromobelexperte:before { + content: "\f37f"; } + +.fa-salesforce:before { + content: "\f83b"; } + +.fa-octopus-deploy:before { + content: "\e082"; } + +.fa-medapps:before { + content: "\f3c6"; } + +.fa-ns8:before { + content: "\f3d5"; } + +.fa-pinterest-p:before { + content: "\f231"; } + +.fa-apper:before { + content: "\f371"; } + +.fa-fort-awesome:before { + content: "\f286"; } + +.fa-waze:before { + content: "\f83f"; } + +.fa-bluesky:before { + content: "\e671"; } + +.fa-cc-jcb:before { + content: "\f24b"; } + +.fa-snapchat:before { + content: "\f2ab"; } + +.fa-snapchat-ghost:before { + content: "\f2ab"; } + +.fa-fantasy-flight-games:before { + content: "\f6dc"; } + +.fa-rust:before { + content: "\e07a"; } + +.fa-wix:before { + content: "\f5cf"; } + +.fa-square-behance:before { + content: "\f1b5"; } + +.fa-behance-square:before { + content: "\f1b5"; } + +.fa-supple:before { + content: "\f3f9"; } + +.fa-webflow:before { + content: "\e65c"; } + +.fa-rebel:before { + content: "\f1d0"; } + +.fa-css3:before { + content: "\f13c"; } + +.fa-staylinked:before { + content: "\f3f5"; } + +.fa-kaggle:before { + content: "\f5fa"; } + +.fa-space-awesome:before { + content: "\e5ac"; } + +.fa-deviantart:before { + content: "\f1bd"; } + +.fa-cpanel:before { + content: "\f388"; } + +.fa-goodreads-g:before { + content: "\f3a9"; } + +.fa-square-git:before { + content: "\f1d2"; } + +.fa-git-square:before { + content: "\f1d2"; } + +.fa-square-tumblr:before { + content: "\f174"; } + +.fa-tumblr-square:before { + content: "\f174"; } + +.fa-trello:before { + content: "\f181"; } + +.fa-creative-commons-nc-jp:before { + content: "\f4ea"; } + +.fa-get-pocket:before { + content: "\f265"; } + +.fa-perbyte:before { + content: "\e083"; } + +.fa-grunt:before { + content: "\f3ad"; } + +.fa-weebly:before { + content: "\f5cc"; } + +.fa-connectdevelop:before { + content: "\f20e"; } + +.fa-leanpub:before { + content: "\f212"; } + +.fa-black-tie:before { + content: "\f27e"; } + +.fa-themeco:before { + content: "\f5c6"; } + +.fa-python:before { + content: "\f3e2"; } + +.fa-android:before { + content: "\f17b"; } + +.fa-bots:before { + content: "\e340"; } + +.fa-free-code-camp:before { + content: "\f2c5"; } + +.fa-hornbill:before { + content: "\f592"; } + +.fa-js:before { + content: "\f3b8"; } + +.fa-ideal:before { + content: "\e013"; } + +.fa-git:before { + content: "\f1d3"; } + +.fa-dev:before { + content: "\f6cc"; } + +.fa-sketch:before { + content: "\f7c6"; } + +.fa-yandex-international:before { + content: "\f414"; } + +.fa-cc-amex:before { + content: "\f1f3"; } + +.fa-uber:before { + content: "\f402"; } + +.fa-github:before { + content: "\f09b"; } + +.fa-php:before { + content: "\f457"; } + +.fa-alipay:before { + content: "\f642"; } + +.fa-youtube:before { + content: "\f167"; } + +.fa-skyatlas:before { + content: "\f216"; } + +.fa-firefox-browser:before { + content: "\e007"; } + +.fa-replyd:before { + content: "\f3e6"; } + +.fa-suse:before { + content: "\f7d6"; } + +.fa-jenkins:before { + content: "\f3b6"; } + +.fa-twitter:before { + content: "\f099"; } + +.fa-rockrms:before { + content: "\f3e9"; } + +.fa-pinterest:before { + content: "\f0d2"; } + +.fa-buffer:before { + content: "\f837"; } + +.fa-npm:before { + content: "\f3d4"; } + +.fa-yammer:before { + content: "\f840"; } + +.fa-btc:before { + content: "\f15a"; } + +.fa-dribbble:before { + content: "\f17d"; } + +.fa-stumbleupon-circle:before { + content: "\f1a3"; } + +.fa-internet-explorer:before { + content: "\f26b"; } + +.fa-stubber:before { + content: "\e5c7"; } + +.fa-telegram:before { + content: "\f2c6"; } + +.fa-telegram-plane:before { + content: "\f2c6"; } + +.fa-old-republic:before { + content: "\f510"; } + +.fa-odysee:before { + content: "\e5c6"; } + +.fa-square-whatsapp:before { + content: "\f40c"; } + +.fa-whatsapp-square:before { + content: "\f40c"; } + +.fa-node-js:before { + content: "\f3d3"; } + +.fa-edge-legacy:before { + content: "\e078"; } + +.fa-slack:before { + content: "\f198"; } + +.fa-slack-hash:before { + content: "\f198"; } + +.fa-medrt:before { + content: "\f3c8"; } + +.fa-usb:before { + content: "\f287"; } + +.fa-tumblr:before { + content: "\f173"; } + +.fa-vaadin:before { + content: "\f408"; } + +.fa-quora:before { + content: "\f2c4"; } + +.fa-square-x-twitter:before { + content: "\e61a"; } + +.fa-reacteurope:before { + content: "\f75d"; } + +.fa-medium:before { + content: "\f23a"; } + +.fa-medium-m:before { + content: "\f23a"; } + +.fa-amilia:before { + content: "\f36d"; } + +.fa-mixcloud:before { + content: "\f289"; } + +.fa-flipboard:before { + content: "\f44d"; } + +.fa-viacoin:before { + content: "\f237"; } + +.fa-critical-role:before { + content: "\f6c9"; } + +.fa-sitrox:before { + content: "\e44a"; } + +.fa-discourse:before { + content: "\f393"; } + +.fa-joomla:before { + content: "\f1aa"; } + +.fa-mastodon:before { + content: "\f4f6"; } + +.fa-airbnb:before { + content: "\f834"; } + +.fa-wolf-pack-battalion:before { + content: "\f514"; } + +.fa-buy-n-large:before { + content: "\f8a6"; } + +.fa-gulp:before { + content: "\f3ae"; } + +.fa-creative-commons-sampling-plus:before { + content: "\f4f1"; } + +.fa-strava:before { + content: "\f428"; } + +.fa-ember:before { + content: "\f423"; } + +.fa-canadian-maple-leaf:before { + content: "\f785"; } + +.fa-teamspeak:before { + content: "\f4f9"; } + +.fa-pushed:before { + content: "\f3e1"; } + +.fa-wordpress-simple:before { + content: "\f411"; } + +.fa-nutritionix:before { + content: "\f3d6"; } + +.fa-wodu:before { + content: "\e088"; } + +.fa-google-pay:before { + content: "\e079"; } + +.fa-intercom:before { + content: "\f7af"; } + +.fa-zhihu:before { + content: "\f63f"; } + +.fa-korvue:before { + content: "\f42f"; } + +.fa-pix:before { + content: "\e43a"; } + +.fa-steam-symbol:before { + content: "\f3f6"; } +:root, :host { + --fa-style-family-classic: 'Font Awesome 6 Free'; + --fa-font-regular: normal 400 1em/1 'Font Awesome 6 Free'; } + +@font-face { + font-family: 'Font Awesome 6 Free'; + font-style: normal; + font-weight: 400; + font-display: block; + src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); } + +.far, +.fa-regular { + font-weight: 400; } +:root, :host { + --fa-style-family-classic: 'Font Awesome 6 Free'; + --fa-font-solid: normal 900 1em/1 'Font Awesome 6 Free'; } + +@font-face { + font-family: 'Font Awesome 6 Free'; + font-style: normal; + font-weight: 900; + font-display: block; + src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); } + +.fas, +.fa-solid { + font-weight: 900; } +@font-face { + font-family: 'Font Awesome 5 Brands'; + font-display: block; + font-weight: 400; + src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); } + +@font-face { + font-family: 'Font Awesome 5 Free'; + font-display: block; + font-weight: 900; + src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); } + +@font-face { + font-family: 'Font Awesome 5 Free'; + font-display: block; + font-weight: 400; + src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); } +@font-face { + font-family: 'FontAwesome'; + font-display: block; + src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); } + +@font-face { + font-family: 'FontAwesome'; + font-display: block; + src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); } + +@font-face { + font-family: 'FontAwesome'; + font-display: block; + src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); } + +@font-face { + font-family: 'FontAwesome'; + font-display: block; + src: url("../webfonts/fa-v4compatibility.woff2") format("woff2"), url("../webfonts/fa-v4compatibility.ttf") format("truetype"); } diff --git a/docs/deps/font-awesome-6.5.2/css/all.min.css b/docs/deps/font-awesome-6.5.2/css/all.min.css new file mode 100644 index 00000000..269bceea --- /dev/null +++ b/docs/deps/font-awesome-6.5.2/css/all.min.css @@ -0,0 +1,9 @@ +/*! + * Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com + * License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) + * Copyright 2024 Fonticons, Inc. + */ +.fa{font-family:var(--fa-style-family,"Font Awesome 6 Free");font-weight:var(--fa-style,900)}.fa,.fa-brands,.fa-classic,.fa-regular,.fa-sharp,.fa-solid,.fab,.far,.fas{-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased;display:var(--fa-display,inline-block);font-style:normal;font-variant:normal;line-height:1;text-rendering:auto}.fa-classic,.fa-regular,.fa-solid,.far,.fas{font-family:"Font Awesome 6 Free"}.fa-brands,.fab{font-family:"Font Awesome 6 Brands"}.fa-1x{font-size:1em}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-6x{font-size:6em}.fa-7x{font-size:7em}.fa-8x{font-size:8em}.fa-9x{font-size:9em}.fa-10x{font-size:10em}.fa-2xs{font-size:.625em;line-height:.1em;vertical-align:.225em}.fa-xs{font-size:.75em;line-height:.08333em;vertical-align:.125em}.fa-sm{font-size:.875em;line-height:.07143em;vertical-align:.05357em}.fa-lg{font-size:1.25em;line-height:.05em;vertical-align:-.075em}.fa-xl{font-size:1.5em;line-height:.04167em;vertical-align:-.125em}.fa-2xl{font-size:2em;line-height:.03125em;vertical-align:-.1875em}.fa-fw{text-align:center;width:1.25em}.fa-ul{list-style-type:none;margin-left:var(--fa-li-margin,2.5em);padding-left:0}.fa-ul>li{position:relative}.fa-li{left:calc(var(--fa-li-width, 2em)*-1);position:absolute;text-align:center;width:var(--fa-li-width,2em);line-height:inherit}.fa-border{border-radius:var(--fa-border-radius,.1em);border:var(--fa-border-width,.08em) var(--fa-border-style,solid) var(--fa-border-color,#eee);padding:var(--fa-border-padding,.2em .25em .15em)}.fa-pull-left{float:left;margin-right:var(--fa-pull-margin,.3em)}.fa-pull-right{float:right;margin-left:var(--fa-pull-margin,.3em)}.fa-beat{-webkit-animation-name:fa-beat;animation-name:fa-beat;-webkit-animation-delay:var(--fa-animation-delay,0s);animation-delay:var(--fa-animation-delay,0s);-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal);-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,ease-in-out);animation-timing-function:var(--fa-animation-timing,ease-in-out)}.fa-bounce{-webkit-animation-name:fa-bounce;animation-name:fa-bounce;-webkit-animation-delay:var(--fa-animation-delay,0s);animation-delay:var(--fa-animation-delay,0s);-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal);-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,cubic-bezier(.28,.84,.42,1));animation-timing-function:var(--fa-animation-timing,cubic-bezier(.28,.84,.42,1))}.fa-fade{-webkit-animation-name:fa-fade;animation-name:fa-fade;-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,cubic-bezier(.4,0,.6,1));animation-timing-function:var(--fa-animation-timing,cubic-bezier(.4,0,.6,1))}.fa-beat-fade,.fa-fade{-webkit-animation-delay:var(--fa-animation-delay,0s);animation-delay:var(--fa-animation-delay,0s);-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal);-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s)}.fa-beat-fade{-webkit-animation-name:fa-beat-fade;animation-name:fa-beat-fade;-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,cubic-bezier(.4,0,.6,1));animation-timing-function:var(--fa-animation-timing,cubic-bezier(.4,0,.6,1))}.fa-flip{-webkit-animation-name:fa-flip;animation-name:fa-flip;-webkit-animation-delay:var(--fa-animation-delay,0s);animation-delay:var(--fa-animation-delay,0s);-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal);-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,ease-in-out);animation-timing-function:var(--fa-animation-timing,ease-in-out)}.fa-shake{-webkit-animation-name:fa-shake;animation-name:fa-shake;-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,linear);animation-timing-function:var(--fa-animation-timing,linear)}.fa-shake,.fa-spin{-webkit-animation-delay:var(--fa-animation-delay,0s);animation-delay:var(--fa-animation-delay,0s);-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal)}.fa-spin{-webkit-animation-name:fa-spin;animation-name:fa-spin;-webkit-animation-duration:var(--fa-animation-duration,2s);animation-duration:var(--fa-animation-duration,2s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,linear);animation-timing-function:var(--fa-animation-timing,linear)}.fa-spin-reverse{--fa-animation-direction:reverse}.fa-pulse,.fa-spin-pulse{-webkit-animation-name:fa-spin;animation-name:fa-spin;-webkit-animation-direction:var(--fa-animation-direction,normal);animation-direction:var(--fa-animation-direction,normal);-webkit-animation-duration:var(--fa-animation-duration,1s);animation-duration:var(--fa-animation-duration,1s);-webkit-animation-iteration-count:var(--fa-animation-iteration-count,infinite);animation-iteration-count:var(--fa-animation-iteration-count,infinite);-webkit-animation-timing-function:var(--fa-animation-timing,steps(8));animation-timing-function:var(--fa-animation-timing,steps(8))}@media (prefers-reduced-motion:reduce){.fa-beat,.fa-beat-fade,.fa-bounce,.fa-fade,.fa-flip,.fa-pulse,.fa-shake,.fa-spin,.fa-spin-pulse{-webkit-animation-delay:-1ms;animation-delay:-1ms;-webkit-animation-duration:1ms;animation-duration:1ms;-webkit-animation-iteration-count:1;animation-iteration-count:1;-webkit-transition-delay:0s;transition-delay:0s;-webkit-transition-duration:0s;transition-duration:0s}}@-webkit-keyframes fa-beat{0%,90%{-webkit-transform:scale(1);transform:scale(1)}45%{-webkit-transform:scale(var(--fa-beat-scale,1.25));transform:scale(var(--fa-beat-scale,1.25))}}@keyframes fa-beat{0%,90%{-webkit-transform:scale(1);transform:scale(1)}45%{-webkit-transform:scale(var(--fa-beat-scale,1.25));transform:scale(var(--fa-beat-scale,1.25))}}@-webkit-keyframes fa-bounce{0%{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}10%{-webkit-transform:scale(var(--fa-bounce-start-scale-x,1.1),var(--fa-bounce-start-scale-y,.9)) translateY(0);transform:scale(var(--fa-bounce-start-scale-x,1.1),var(--fa-bounce-start-scale-y,.9)) translateY(0)}30%{-webkit-transform:scale(var(--fa-bounce-jump-scale-x,.9),var(--fa-bounce-jump-scale-y,1.1)) translateY(var(--fa-bounce-height,-.5em));transform:scale(var(--fa-bounce-jump-scale-x,.9),var(--fa-bounce-jump-scale-y,1.1)) translateY(var(--fa-bounce-height,-.5em))}50%{-webkit-transform:scale(var(--fa-bounce-land-scale-x,1.05),var(--fa-bounce-land-scale-y,.95)) translateY(0);transform:scale(var(--fa-bounce-land-scale-x,1.05),var(--fa-bounce-land-scale-y,.95)) translateY(0)}57%{-webkit-transform:scale(1) translateY(var(--fa-bounce-rebound,-.125em));transform:scale(1) translateY(var(--fa-bounce-rebound,-.125em))}64%{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}to{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}}@keyframes fa-bounce{0%{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}10%{-webkit-transform:scale(var(--fa-bounce-start-scale-x,1.1),var(--fa-bounce-start-scale-y,.9)) translateY(0);transform:scale(var(--fa-bounce-start-scale-x,1.1),var(--fa-bounce-start-scale-y,.9)) translateY(0)}30%{-webkit-transform:scale(var(--fa-bounce-jump-scale-x,.9),var(--fa-bounce-jump-scale-y,1.1)) translateY(var(--fa-bounce-height,-.5em));transform:scale(var(--fa-bounce-jump-scale-x,.9),var(--fa-bounce-jump-scale-y,1.1)) translateY(var(--fa-bounce-height,-.5em))}50%{-webkit-transform:scale(var(--fa-bounce-land-scale-x,1.05),var(--fa-bounce-land-scale-y,.95)) translateY(0);transform:scale(var(--fa-bounce-land-scale-x,1.05),var(--fa-bounce-land-scale-y,.95)) translateY(0)}57%{-webkit-transform:scale(1) translateY(var(--fa-bounce-rebound,-.125em));transform:scale(1) translateY(var(--fa-bounce-rebound,-.125em))}64%{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}to{-webkit-transform:scale(1) translateY(0);transform:scale(1) translateY(0)}}@-webkit-keyframes fa-fade{50%{opacity:var(--fa-fade-opacity,.4)}}@keyframes fa-fade{50%{opacity:var(--fa-fade-opacity,.4)}}@-webkit-keyframes fa-beat-fade{0%,to{opacity:var(--fa-beat-fade-opacity,.4);-webkit-transform:scale(1);transform:scale(1)}50%{opacity:1;-webkit-transform:scale(var(--fa-beat-fade-scale,1.125));transform:scale(var(--fa-beat-fade-scale,1.125))}}@keyframes fa-beat-fade{0%,to{opacity:var(--fa-beat-fade-opacity,.4);-webkit-transform:scale(1);transform:scale(1)}50%{opacity:1;-webkit-transform:scale(var(--fa-beat-fade-scale,1.125));transform:scale(var(--fa-beat-fade-scale,1.125))}}@-webkit-keyframes fa-flip{50%{-webkit-transform:rotate3d(var(--fa-flip-x,0),var(--fa-flip-y,1),var(--fa-flip-z,0),var(--fa-flip-angle,-180deg));transform:rotate3d(var(--fa-flip-x,0),var(--fa-flip-y,1),var(--fa-flip-z,0),var(--fa-flip-angle,-180deg))}}@keyframes fa-flip{50%{-webkit-transform:rotate3d(var(--fa-flip-x,0),var(--fa-flip-y,1),var(--fa-flip-z,0),var(--fa-flip-angle,-180deg));transform:rotate3d(var(--fa-flip-x,0),var(--fa-flip-y,1),var(--fa-flip-z,0),var(--fa-flip-angle,-180deg))}}@-webkit-keyframes fa-shake{0%{-webkit-transform:rotate(-15deg);transform:rotate(-15deg)}4%{-webkit-transform:rotate(15deg);transform:rotate(15deg)}8%,24%{-webkit-transform:rotate(-18deg);transform:rotate(-18deg)}12%,28%{-webkit-transform:rotate(18deg);transform:rotate(18deg)}16%{-webkit-transform:rotate(-22deg);transform:rotate(-22deg)}20%{-webkit-transform:rotate(22deg);transform:rotate(22deg)}32%{-webkit-transform:rotate(-12deg);transform:rotate(-12deg)}36%{-webkit-transform:rotate(12deg);transform:rotate(12deg)}40%,to{-webkit-transform:rotate(0deg);transform:rotate(0deg)}}@keyframes fa-shake{0%{-webkit-transform:rotate(-15deg);transform:rotate(-15deg)}4%{-webkit-transform:rotate(15deg);transform:rotate(15deg)}8%,24%{-webkit-transform:rotate(-18deg);transform:rotate(-18deg)}12%,28%{-webkit-transform:rotate(18deg);transform:rotate(18deg)}16%{-webkit-transform:rotate(-22deg);transform:rotate(-22deg)}20%{-webkit-transform:rotate(22deg);transform:rotate(22deg)}32%{-webkit-transform:rotate(-12deg);transform:rotate(-12deg)}36%{-webkit-transform:rotate(12deg);transform:rotate(12deg)}40%,to{-webkit-transform:rotate(0deg);transform:rotate(0deg)}}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(1turn);transform:rotate(1turn)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(1turn);transform:rotate(1turn)}}.fa-rotate-90{-webkit-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-webkit-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-webkit-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-webkit-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-webkit-transform:scaleY(-1);transform:scaleY(-1)}.fa-flip-both,.fa-flip-horizontal.fa-flip-vertical{-webkit-transform:scale(-1);transform:scale(-1)}.fa-rotate-by{-webkit-transform:rotate(var(--fa-rotate-angle,0));transform:rotate(var(--fa-rotate-angle,0))}.fa-stack{display:inline-block;height:2em;line-height:2em;position:relative;vertical-align:middle;width:2.5em}.fa-stack-1x,.fa-stack-2x{left:0;position:absolute;text-align:center;width:100%;z-index:var(--fa-stack-z-index,auto)}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:var(--fa-inverse,#fff)} + +.fa-0:before{content:"\30"}.fa-1:before{content:"\31"}.fa-2:before{content:"\32"}.fa-3:before{content:"\33"}.fa-4:before{content:"\34"}.fa-5:before{content:"\35"}.fa-6:before{content:"\36"}.fa-7:before{content:"\37"}.fa-8:before{content:"\38"}.fa-9:before{content:"\39"}.fa-fill-drip:before{content:"\f576"}.fa-arrows-to-circle:before{content:"\e4bd"}.fa-chevron-circle-right:before,.fa-circle-chevron-right:before{content:"\f138"}.fa-at:before{content:"\40"}.fa-trash-alt:before,.fa-trash-can:before{content:"\f2ed"}.fa-text-height:before{content:"\f034"}.fa-user-times:before,.fa-user-xmark:before{content:"\f235"}.fa-stethoscope:before{content:"\f0f1"}.fa-comment-alt:before,.fa-message:before{content:"\f27a"}.fa-info:before{content:"\f129"}.fa-compress-alt:before,.fa-down-left-and-up-right-to-center:before{content:"\f422"}.fa-explosion:before{content:"\e4e9"}.fa-file-alt:before,.fa-file-lines:before,.fa-file-text:before{content:"\f15c"}.fa-wave-square:before{content:"\f83e"}.fa-ring:before{content:"\f70b"}.fa-building-un:before{content:"\e4d9"}.fa-dice-three:before{content:"\f527"}.fa-calendar-alt:before,.fa-calendar-days:before{content:"\f073"}.fa-anchor-circle-check:before{content:"\e4aa"}.fa-building-circle-arrow-right:before{content:"\e4d1"}.fa-volleyball-ball:before,.fa-volleyball:before{content:"\f45f"}.fa-arrows-up-to-line:before{content:"\e4c2"}.fa-sort-desc:before,.fa-sort-down:before{content:"\f0dd"}.fa-circle-minus:before,.fa-minus-circle:before{content:"\f056"}.fa-door-open:before{content:"\f52b"}.fa-right-from-bracket:before,.fa-sign-out-alt:before{content:"\f2f5"}.fa-atom:before{content:"\f5d2"}.fa-soap:before{content:"\e06e"}.fa-heart-music-camera-bolt:before,.fa-icons:before{content:"\f86d"}.fa-microphone-alt-slash:before,.fa-microphone-lines-slash:before{content:"\f539"}.fa-bridge-circle-check:before{content:"\e4c9"}.fa-pump-medical:before{content:"\e06a"}.fa-fingerprint:before{content:"\f577"}.fa-hand-point-right:before{content:"\f0a4"}.fa-magnifying-glass-location:before,.fa-search-location:before{content:"\f689"}.fa-forward-step:before,.fa-step-forward:before{content:"\f051"}.fa-face-smile-beam:before,.fa-smile-beam:before{content:"\f5b8"}.fa-flag-checkered:before{content:"\f11e"}.fa-football-ball:before,.fa-football:before{content:"\f44e"}.fa-school-circle-exclamation:before{content:"\e56c"}.fa-crop:before{content:"\f125"}.fa-angle-double-down:before,.fa-angles-down:before{content:"\f103"}.fa-users-rectangle:before{content:"\e594"}.fa-people-roof:before{content:"\e537"}.fa-people-line:before{content:"\e534"}.fa-beer-mug-empty:before,.fa-beer:before{content:"\f0fc"}.fa-diagram-predecessor:before{content:"\e477"}.fa-arrow-up-long:before,.fa-long-arrow-up:before{content:"\f176"}.fa-burn:before,.fa-fire-flame-simple:before{content:"\f46a"}.fa-male:before,.fa-person:before{content:"\f183"}.fa-laptop:before{content:"\f109"}.fa-file-csv:before{content:"\f6dd"}.fa-menorah:before{content:"\f676"}.fa-truck-plane:before{content:"\e58f"}.fa-record-vinyl:before{content:"\f8d9"}.fa-face-grin-stars:before,.fa-grin-stars:before{content:"\f587"}.fa-bong:before{content:"\f55c"}.fa-pastafarianism:before,.fa-spaghetti-monster-flying:before{content:"\f67b"}.fa-arrow-down-up-across-line:before{content:"\e4af"}.fa-spoon:before,.fa-utensil-spoon:before{content:"\f2e5"}.fa-jar-wheat:before{content:"\e517"}.fa-envelopes-bulk:before,.fa-mail-bulk:before{content:"\f674"}.fa-file-circle-exclamation:before{content:"\e4eb"}.fa-circle-h:before,.fa-hospital-symbol:before{content:"\f47e"}.fa-pager:before{content:"\f815"}.fa-address-book:before,.fa-contact-book:before{content:"\f2b9"}.fa-strikethrough:before{content:"\f0cc"}.fa-k:before{content:"\4b"}.fa-landmark-flag:before{content:"\e51c"}.fa-pencil-alt:before,.fa-pencil:before{content:"\f303"}.fa-backward:before{content:"\f04a"}.fa-caret-right:before{content:"\f0da"}.fa-comments:before{content:"\f086"}.fa-file-clipboard:before,.fa-paste:before{content:"\f0ea"}.fa-code-pull-request:before{content:"\e13c"}.fa-clipboard-list:before{content:"\f46d"}.fa-truck-loading:before,.fa-truck-ramp-box:before{content:"\f4de"}.fa-user-check:before{content:"\f4fc"}.fa-vial-virus:before{content:"\e597"}.fa-sheet-plastic:before{content:"\e571"}.fa-blog:before{content:"\f781"}.fa-user-ninja:before{content:"\f504"}.fa-person-arrow-up-from-line:before{content:"\e539"}.fa-scroll-torah:before,.fa-torah:before{content:"\f6a0"}.fa-broom-ball:before,.fa-quidditch-broom-ball:before,.fa-quidditch:before{content:"\f458"}.fa-toggle-off:before{content:"\f204"}.fa-archive:before,.fa-box-archive:before{content:"\f187"}.fa-person-drowning:before{content:"\e545"}.fa-arrow-down-9-1:before,.fa-sort-numeric-desc:before,.fa-sort-numeric-down-alt:before{content:"\f886"}.fa-face-grin-tongue-squint:before,.fa-grin-tongue-squint:before{content:"\f58a"}.fa-spray-can:before{content:"\f5bd"}.fa-truck-monster:before{content:"\f63b"}.fa-w:before{content:"\57"}.fa-earth-africa:before,.fa-globe-africa:before{content:"\f57c"}.fa-rainbow:before{content:"\f75b"}.fa-circle-notch:before{content:"\f1ce"}.fa-tablet-alt:before,.fa-tablet-screen-button:before{content:"\f3fa"}.fa-paw:before{content:"\f1b0"}.fa-cloud:before{content:"\f0c2"}.fa-trowel-bricks:before{content:"\e58a"}.fa-face-flushed:before,.fa-flushed:before{content:"\f579"}.fa-hospital-user:before{content:"\f80d"}.fa-tent-arrow-left-right:before{content:"\e57f"}.fa-gavel:before,.fa-legal:before{content:"\f0e3"}.fa-binoculars:before{content:"\f1e5"}.fa-microphone-slash:before{content:"\f131"}.fa-box-tissue:before{content:"\e05b"}.fa-motorcycle:before{content:"\f21c"}.fa-bell-concierge:before,.fa-concierge-bell:before{content:"\f562"}.fa-pen-ruler:before,.fa-pencil-ruler:before{content:"\f5ae"}.fa-people-arrows-left-right:before,.fa-people-arrows:before{content:"\e068"}.fa-mars-and-venus-burst:before{content:"\e523"}.fa-caret-square-right:before,.fa-square-caret-right:before{content:"\f152"}.fa-cut:before,.fa-scissors:before{content:"\f0c4"}.fa-sun-plant-wilt:before{content:"\e57a"}.fa-toilets-portable:before{content:"\e584"}.fa-hockey-puck:before{content:"\f453"}.fa-table:before{content:"\f0ce"}.fa-magnifying-glass-arrow-right:before{content:"\e521"}.fa-digital-tachograph:before,.fa-tachograph-digital:before{content:"\f566"}.fa-users-slash:before{content:"\e073"}.fa-clover:before{content:"\e139"}.fa-mail-reply:before,.fa-reply:before{content:"\f3e5"}.fa-star-and-crescent:before{content:"\f699"}.fa-house-fire:before{content:"\e50c"}.fa-minus-square:before,.fa-square-minus:before{content:"\f146"}.fa-helicopter:before{content:"\f533"}.fa-compass:before{content:"\f14e"}.fa-caret-square-down:before,.fa-square-caret-down:before{content:"\f150"}.fa-file-circle-question:before{content:"\e4ef"}.fa-laptop-code:before{content:"\f5fc"}.fa-swatchbook:before{content:"\f5c3"}.fa-prescription-bottle:before{content:"\f485"}.fa-bars:before,.fa-navicon:before{content:"\f0c9"}.fa-people-group:before{content:"\e533"}.fa-hourglass-3:before,.fa-hourglass-end:before{content:"\f253"}.fa-heart-broken:before,.fa-heart-crack:before{content:"\f7a9"}.fa-external-link-square-alt:before,.fa-square-up-right:before{content:"\f360"}.fa-face-kiss-beam:before,.fa-kiss-beam:before{content:"\f597"}.fa-film:before{content:"\f008"}.fa-ruler-horizontal:before{content:"\f547"}.fa-people-robbery:before{content:"\e536"}.fa-lightbulb:before{content:"\f0eb"}.fa-caret-left:before{content:"\f0d9"}.fa-circle-exclamation:before,.fa-exclamation-circle:before{content:"\f06a"}.fa-school-circle-xmark:before{content:"\e56d"}.fa-arrow-right-from-bracket:before,.fa-sign-out:before{content:"\f08b"}.fa-chevron-circle-down:before,.fa-circle-chevron-down:before{content:"\f13a"}.fa-unlock-alt:before,.fa-unlock-keyhole:before{content:"\f13e"}.fa-cloud-showers-heavy:before{content:"\f740"}.fa-headphones-alt:before,.fa-headphones-simple:before{content:"\f58f"}.fa-sitemap:before{content:"\f0e8"}.fa-circle-dollar-to-slot:before,.fa-donate:before{content:"\f4b9"}.fa-memory:before{content:"\f538"}.fa-road-spikes:before{content:"\e568"}.fa-fire-burner:before{content:"\e4f1"}.fa-flag:before{content:"\f024"}.fa-hanukiah:before{content:"\f6e6"}.fa-feather:before{content:"\f52d"}.fa-volume-down:before,.fa-volume-low:before{content:"\f027"}.fa-comment-slash:before{content:"\f4b3"}.fa-cloud-sun-rain:before{content:"\f743"}.fa-compress:before{content:"\f066"}.fa-wheat-alt:before,.fa-wheat-awn:before{content:"\e2cd"}.fa-ankh:before{content:"\f644"}.fa-hands-holding-child:before{content:"\e4fa"}.fa-asterisk:before{content:"\2a"}.fa-check-square:before,.fa-square-check:before{content:"\f14a"}.fa-peseta-sign:before{content:"\e221"}.fa-header:before,.fa-heading:before{content:"\f1dc"}.fa-ghost:before{content:"\f6e2"}.fa-list-squares:before,.fa-list:before{content:"\f03a"}.fa-phone-square-alt:before,.fa-square-phone-flip:before{content:"\f87b"}.fa-cart-plus:before{content:"\f217"}.fa-gamepad:before{content:"\f11b"}.fa-circle-dot:before,.fa-dot-circle:before{content:"\f192"}.fa-dizzy:before,.fa-face-dizzy:before{content:"\f567"}.fa-egg:before{content:"\f7fb"}.fa-house-medical-circle-xmark:before{content:"\e513"}.fa-campground:before{content:"\f6bb"}.fa-folder-plus:before{content:"\f65e"}.fa-futbol-ball:before,.fa-futbol:before,.fa-soccer-ball:before{content:"\f1e3"}.fa-paint-brush:before,.fa-paintbrush:before{content:"\f1fc"}.fa-lock:before{content:"\f023"}.fa-gas-pump:before{content:"\f52f"}.fa-hot-tub-person:before,.fa-hot-tub:before{content:"\f593"}.fa-map-location:before,.fa-map-marked:before{content:"\f59f"}.fa-house-flood-water:before{content:"\e50e"}.fa-tree:before{content:"\f1bb"}.fa-bridge-lock:before{content:"\e4cc"}.fa-sack-dollar:before{content:"\f81d"}.fa-edit:before,.fa-pen-to-square:before{content:"\f044"}.fa-car-side:before{content:"\f5e4"}.fa-share-alt:before,.fa-share-nodes:before{content:"\f1e0"}.fa-heart-circle-minus:before{content:"\e4ff"}.fa-hourglass-2:before,.fa-hourglass-half:before{content:"\f252"}.fa-microscope:before{content:"\f610"}.fa-sink:before{content:"\e06d"}.fa-bag-shopping:before,.fa-shopping-bag:before{content:"\f290"}.fa-arrow-down-z-a:before,.fa-sort-alpha-desc:before,.fa-sort-alpha-down-alt:before{content:"\f881"}.fa-mitten:before{content:"\f7b5"}.fa-person-rays:before{content:"\e54d"}.fa-users:before{content:"\f0c0"}.fa-eye-slash:before{content:"\f070"}.fa-flask-vial:before{content:"\e4f3"}.fa-hand-paper:before,.fa-hand:before{content:"\f256"}.fa-om:before{content:"\f679"}.fa-worm:before{content:"\e599"}.fa-house-circle-xmark:before{content:"\e50b"}.fa-plug:before{content:"\f1e6"}.fa-chevron-up:before{content:"\f077"}.fa-hand-spock:before{content:"\f259"}.fa-stopwatch:before{content:"\f2f2"}.fa-face-kiss:before,.fa-kiss:before{content:"\f596"}.fa-bridge-circle-xmark:before{content:"\e4cb"}.fa-face-grin-tongue:before,.fa-grin-tongue:before{content:"\f589"}.fa-chess-bishop:before{content:"\f43a"}.fa-face-grin-wink:before,.fa-grin-wink:before{content:"\f58c"}.fa-deaf:before,.fa-deafness:before,.fa-ear-deaf:before,.fa-hard-of-hearing:before{content:"\f2a4"}.fa-road-circle-check:before{content:"\e564"}.fa-dice-five:before{content:"\f523"}.fa-rss-square:before,.fa-square-rss:before{content:"\f143"}.fa-land-mine-on:before{content:"\e51b"}.fa-i-cursor:before{content:"\f246"}.fa-stamp:before{content:"\f5bf"}.fa-stairs:before{content:"\e289"}.fa-i:before{content:"\49"}.fa-hryvnia-sign:before,.fa-hryvnia:before{content:"\f6f2"}.fa-pills:before{content:"\f484"}.fa-face-grin-wide:before,.fa-grin-alt:before{content:"\f581"}.fa-tooth:before{content:"\f5c9"}.fa-v:before{content:"\56"}.fa-bangladeshi-taka-sign:before{content:"\e2e6"}.fa-bicycle:before{content:"\f206"}.fa-rod-asclepius:before,.fa-rod-snake:before,.fa-staff-aesculapius:before,.fa-staff-snake:before{content:"\e579"}.fa-head-side-cough-slash:before{content:"\e062"}.fa-ambulance:before,.fa-truck-medical:before{content:"\f0f9"}.fa-wheat-awn-circle-exclamation:before{content:"\e598"}.fa-snowman:before{content:"\f7d0"}.fa-mortar-pestle:before{content:"\f5a7"}.fa-road-barrier:before{content:"\e562"}.fa-school:before{content:"\f549"}.fa-igloo:before{content:"\f7ae"}.fa-joint:before{content:"\f595"}.fa-angle-right:before{content:"\f105"}.fa-horse:before{content:"\f6f0"}.fa-q:before{content:"\51"}.fa-g:before{content:"\47"}.fa-notes-medical:before{content:"\f481"}.fa-temperature-2:before,.fa-temperature-half:before,.fa-thermometer-2:before,.fa-thermometer-half:before{content:"\f2c9"}.fa-dong-sign:before{content:"\e169"}.fa-capsules:before{content:"\f46b"}.fa-poo-bolt:before,.fa-poo-storm:before{content:"\f75a"}.fa-face-frown-open:before,.fa-frown-open:before{content:"\f57a"}.fa-hand-point-up:before{content:"\f0a6"}.fa-money-bill:before{content:"\f0d6"}.fa-bookmark:before{content:"\f02e"}.fa-align-justify:before{content:"\f039"}.fa-umbrella-beach:before{content:"\f5ca"}.fa-helmet-un:before{content:"\e503"}.fa-bullseye:before{content:"\f140"}.fa-bacon:before{content:"\f7e5"}.fa-hand-point-down:before{content:"\f0a7"}.fa-arrow-up-from-bracket:before{content:"\e09a"}.fa-folder-blank:before,.fa-folder:before{content:"\f07b"}.fa-file-medical-alt:before,.fa-file-waveform:before{content:"\f478"}.fa-radiation:before{content:"\f7b9"}.fa-chart-simple:before{content:"\e473"}.fa-mars-stroke:before{content:"\f229"}.fa-vial:before{content:"\f492"}.fa-dashboard:before,.fa-gauge-med:before,.fa-gauge:before,.fa-tachometer-alt-average:before{content:"\f624"}.fa-magic-wand-sparkles:before,.fa-wand-magic-sparkles:before{content:"\e2ca"}.fa-e:before{content:"\45"}.fa-pen-alt:before,.fa-pen-clip:before{content:"\f305"}.fa-bridge-circle-exclamation:before{content:"\e4ca"}.fa-user:before{content:"\f007"}.fa-school-circle-check:before{content:"\e56b"}.fa-dumpster:before{content:"\f793"}.fa-shuttle-van:before,.fa-van-shuttle:before{content:"\f5b6"}.fa-building-user:before{content:"\e4da"}.fa-caret-square-left:before,.fa-square-caret-left:before{content:"\f191"}.fa-highlighter:before{content:"\f591"}.fa-key:before{content:"\f084"}.fa-bullhorn:before{content:"\f0a1"}.fa-globe:before{content:"\f0ac"}.fa-synagogue:before{content:"\f69b"}.fa-person-half-dress:before{content:"\e548"}.fa-road-bridge:before{content:"\e563"}.fa-location-arrow:before{content:"\f124"}.fa-c:before{content:"\43"}.fa-tablet-button:before{content:"\f10a"}.fa-building-lock:before{content:"\e4d6"}.fa-pizza-slice:before{content:"\f818"}.fa-money-bill-wave:before{content:"\f53a"}.fa-area-chart:before,.fa-chart-area:before{content:"\f1fe"}.fa-house-flag:before{content:"\e50d"}.fa-person-circle-minus:before{content:"\e540"}.fa-ban:before,.fa-cancel:before{content:"\f05e"}.fa-camera-rotate:before{content:"\e0d8"}.fa-air-freshener:before,.fa-spray-can-sparkles:before{content:"\f5d0"}.fa-star:before{content:"\f005"}.fa-repeat:before{content:"\f363"}.fa-cross:before{content:"\f654"}.fa-box:before{content:"\f466"}.fa-venus-mars:before{content:"\f228"}.fa-arrow-pointer:before,.fa-mouse-pointer:before{content:"\f245"}.fa-expand-arrows-alt:before,.fa-maximize:before{content:"\f31e"}.fa-charging-station:before{content:"\f5e7"}.fa-shapes:before,.fa-triangle-circle-square:before{content:"\f61f"}.fa-random:before,.fa-shuffle:before{content:"\f074"}.fa-person-running:before,.fa-running:before{content:"\f70c"}.fa-mobile-retro:before{content:"\e527"}.fa-grip-lines-vertical:before{content:"\f7a5"}.fa-spider:before{content:"\f717"}.fa-hands-bound:before{content:"\e4f9"}.fa-file-invoice-dollar:before{content:"\f571"}.fa-plane-circle-exclamation:before{content:"\e556"}.fa-x-ray:before{content:"\f497"}.fa-spell-check:before{content:"\f891"}.fa-slash:before{content:"\f715"}.fa-computer-mouse:before,.fa-mouse:before{content:"\f8cc"}.fa-arrow-right-to-bracket:before,.fa-sign-in:before{content:"\f090"}.fa-shop-slash:before,.fa-store-alt-slash:before{content:"\e070"}.fa-server:before{content:"\f233"}.fa-virus-covid-slash:before{content:"\e4a9"}.fa-shop-lock:before{content:"\e4a5"}.fa-hourglass-1:before,.fa-hourglass-start:before{content:"\f251"}.fa-blender-phone:before{content:"\f6b6"}.fa-building-wheat:before{content:"\e4db"}.fa-person-breastfeeding:before{content:"\e53a"}.fa-right-to-bracket:before,.fa-sign-in-alt:before{content:"\f2f6"}.fa-venus:before{content:"\f221"}.fa-passport:before{content:"\f5ab"}.fa-heart-pulse:before,.fa-heartbeat:before{content:"\f21e"}.fa-people-carry-box:before,.fa-people-carry:before{content:"\f4ce"}.fa-temperature-high:before{content:"\f769"}.fa-microchip:before{content:"\f2db"}.fa-crown:before{content:"\f521"}.fa-weight-hanging:before{content:"\f5cd"}.fa-xmarks-lines:before{content:"\e59a"}.fa-file-prescription:before{content:"\f572"}.fa-weight-scale:before,.fa-weight:before{content:"\f496"}.fa-user-friends:before,.fa-user-group:before{content:"\f500"}.fa-arrow-up-a-z:before,.fa-sort-alpha-up:before{content:"\f15e"}.fa-chess-knight:before{content:"\f441"}.fa-face-laugh-squint:before,.fa-laugh-squint:before{content:"\f59b"}.fa-wheelchair:before{content:"\f193"}.fa-arrow-circle-up:before,.fa-circle-arrow-up:before{content:"\f0aa"}.fa-toggle-on:before{content:"\f205"}.fa-person-walking:before,.fa-walking:before{content:"\f554"}.fa-l:before{content:"\4c"}.fa-fire:before{content:"\f06d"}.fa-bed-pulse:before,.fa-procedures:before{content:"\f487"}.fa-shuttle-space:before,.fa-space-shuttle:before{content:"\f197"}.fa-face-laugh:before,.fa-laugh:before{content:"\f599"}.fa-folder-open:before{content:"\f07c"}.fa-heart-circle-plus:before{content:"\e500"}.fa-code-fork:before{content:"\e13b"}.fa-city:before{content:"\f64f"}.fa-microphone-alt:before,.fa-microphone-lines:before{content:"\f3c9"}.fa-pepper-hot:before{content:"\f816"}.fa-unlock:before{content:"\f09c"}.fa-colon-sign:before{content:"\e140"}.fa-headset:before{content:"\f590"}.fa-store-slash:before{content:"\e071"}.fa-road-circle-xmark:before{content:"\e566"}.fa-user-minus:before{content:"\f503"}.fa-mars-stroke-up:before,.fa-mars-stroke-v:before{content:"\f22a"}.fa-champagne-glasses:before,.fa-glass-cheers:before{content:"\f79f"}.fa-clipboard:before{content:"\f328"}.fa-house-circle-exclamation:before{content:"\e50a"}.fa-file-arrow-up:before,.fa-file-upload:before{content:"\f574"}.fa-wifi-3:before,.fa-wifi-strong:before,.fa-wifi:before{content:"\f1eb"}.fa-bath:before,.fa-bathtub:before{content:"\f2cd"}.fa-underline:before{content:"\f0cd"}.fa-user-edit:before,.fa-user-pen:before{content:"\f4ff"}.fa-signature:before{content:"\f5b7"}.fa-stroopwafel:before{content:"\f551"}.fa-bold:before{content:"\f032"}.fa-anchor-lock:before{content:"\e4ad"}.fa-building-ngo:before{content:"\e4d7"}.fa-manat-sign:before{content:"\e1d5"}.fa-not-equal:before{content:"\f53e"}.fa-border-style:before,.fa-border-top-left:before{content:"\f853"}.fa-map-location-dot:before,.fa-map-marked-alt:before{content:"\f5a0"}.fa-jedi:before{content:"\f669"}.fa-poll:before,.fa-square-poll-vertical:before{content:"\f681"}.fa-mug-hot:before{content:"\f7b6"}.fa-battery-car:before,.fa-car-battery:before{content:"\f5df"}.fa-gift:before{content:"\f06b"}.fa-dice-two:before{content:"\f528"}.fa-chess-queen:before{content:"\f445"}.fa-glasses:before{content:"\f530"}.fa-chess-board:before{content:"\f43c"}.fa-building-circle-check:before{content:"\e4d2"}.fa-person-chalkboard:before{content:"\e53d"}.fa-mars-stroke-h:before,.fa-mars-stroke-right:before{content:"\f22b"}.fa-hand-back-fist:before,.fa-hand-rock:before{content:"\f255"}.fa-caret-square-up:before,.fa-square-caret-up:before{content:"\f151"}.fa-cloud-showers-water:before{content:"\e4e4"}.fa-bar-chart:before,.fa-chart-bar:before{content:"\f080"}.fa-hands-bubbles:before,.fa-hands-wash:before{content:"\e05e"}.fa-less-than-equal:before{content:"\f537"}.fa-train:before{content:"\f238"}.fa-eye-low-vision:before,.fa-low-vision:before{content:"\f2a8"}.fa-crow:before{content:"\f520"}.fa-sailboat:before{content:"\e445"}.fa-window-restore:before{content:"\f2d2"}.fa-plus-square:before,.fa-square-plus:before{content:"\f0fe"}.fa-torii-gate:before{content:"\f6a1"}.fa-frog:before{content:"\f52e"}.fa-bucket:before{content:"\e4cf"}.fa-image:before{content:"\f03e"}.fa-microphone:before{content:"\f130"}.fa-cow:before{content:"\f6c8"}.fa-caret-up:before{content:"\f0d8"}.fa-screwdriver:before{content:"\f54a"}.fa-folder-closed:before{content:"\e185"}.fa-house-tsunami:before{content:"\e515"}.fa-square-nfi:before{content:"\e576"}.fa-arrow-up-from-ground-water:before{content:"\e4b5"}.fa-glass-martini-alt:before,.fa-martini-glass:before{content:"\f57b"}.fa-rotate-back:before,.fa-rotate-backward:before,.fa-rotate-left:before,.fa-undo-alt:before{content:"\f2ea"}.fa-columns:before,.fa-table-columns:before{content:"\f0db"}.fa-lemon:before{content:"\f094"}.fa-head-side-mask:before{content:"\e063"}.fa-handshake:before{content:"\f2b5"}.fa-gem:before{content:"\f3a5"}.fa-dolly-box:before,.fa-dolly:before{content:"\f472"}.fa-smoking:before{content:"\f48d"}.fa-compress-arrows-alt:before,.fa-minimize:before{content:"\f78c"}.fa-monument:before{content:"\f5a6"}.fa-snowplow:before{content:"\f7d2"}.fa-angle-double-right:before,.fa-angles-right:before{content:"\f101"}.fa-cannabis:before{content:"\f55f"}.fa-circle-play:before,.fa-play-circle:before{content:"\f144"}.fa-tablets:before{content:"\f490"}.fa-ethernet:before{content:"\f796"}.fa-eur:before,.fa-euro-sign:before,.fa-euro:before{content:"\f153"}.fa-chair:before{content:"\f6c0"}.fa-check-circle:before,.fa-circle-check:before{content:"\f058"}.fa-circle-stop:before,.fa-stop-circle:before{content:"\f28d"}.fa-compass-drafting:before,.fa-drafting-compass:before{content:"\f568"}.fa-plate-wheat:before{content:"\e55a"}.fa-icicles:before{content:"\f7ad"}.fa-person-shelter:before{content:"\e54f"}.fa-neuter:before{content:"\f22c"}.fa-id-badge:before{content:"\f2c1"}.fa-marker:before{content:"\f5a1"}.fa-face-laugh-beam:before,.fa-laugh-beam:before{content:"\f59a"}.fa-helicopter-symbol:before{content:"\e502"}.fa-universal-access:before{content:"\f29a"}.fa-chevron-circle-up:before,.fa-circle-chevron-up:before{content:"\f139"}.fa-lari-sign:before{content:"\e1c8"}.fa-volcano:before{content:"\f770"}.fa-person-walking-dashed-line-arrow-right:before{content:"\e553"}.fa-gbp:before,.fa-pound-sign:before,.fa-sterling-sign:before{content:"\f154"}.fa-viruses:before{content:"\e076"}.fa-square-person-confined:before{content:"\e577"}.fa-user-tie:before{content:"\f508"}.fa-arrow-down-long:before,.fa-long-arrow-down:before{content:"\f175"}.fa-tent-arrow-down-to-line:before{content:"\e57e"}.fa-certificate:before{content:"\f0a3"}.fa-mail-reply-all:before,.fa-reply-all:before{content:"\f122"}.fa-suitcase:before{content:"\f0f2"}.fa-person-skating:before,.fa-skating:before{content:"\f7c5"}.fa-filter-circle-dollar:before,.fa-funnel-dollar:before{content:"\f662"}.fa-camera-retro:before{content:"\f083"}.fa-arrow-circle-down:before,.fa-circle-arrow-down:before{content:"\f0ab"}.fa-arrow-right-to-file:before,.fa-file-import:before{content:"\f56f"}.fa-external-link-square:before,.fa-square-arrow-up-right:before{content:"\f14c"}.fa-box-open:before{content:"\f49e"}.fa-scroll:before{content:"\f70e"}.fa-spa:before{content:"\f5bb"}.fa-location-pin-lock:before{content:"\e51f"}.fa-pause:before{content:"\f04c"}.fa-hill-avalanche:before{content:"\e507"}.fa-temperature-0:before,.fa-temperature-empty:before,.fa-thermometer-0:before,.fa-thermometer-empty:before{content:"\f2cb"}.fa-bomb:before{content:"\f1e2"}.fa-registered:before{content:"\f25d"}.fa-address-card:before,.fa-contact-card:before,.fa-vcard:before{content:"\f2bb"}.fa-balance-scale-right:before,.fa-scale-unbalanced-flip:before{content:"\f516"}.fa-subscript:before{content:"\f12c"}.fa-diamond-turn-right:before,.fa-directions:before{content:"\f5eb"}.fa-burst:before{content:"\e4dc"}.fa-house-laptop:before,.fa-laptop-house:before{content:"\e066"}.fa-face-tired:before,.fa-tired:before{content:"\f5c8"}.fa-money-bills:before{content:"\e1f3"}.fa-smog:before{content:"\f75f"}.fa-crutch:before{content:"\f7f7"}.fa-cloud-arrow-up:before,.fa-cloud-upload-alt:before,.fa-cloud-upload:before{content:"\f0ee"}.fa-palette:before{content:"\f53f"}.fa-arrows-turn-right:before{content:"\e4c0"}.fa-vest:before{content:"\e085"}.fa-ferry:before{content:"\e4ea"}.fa-arrows-down-to-people:before{content:"\e4b9"}.fa-seedling:before,.fa-sprout:before{content:"\f4d8"}.fa-arrows-alt-h:before,.fa-left-right:before{content:"\f337"}.fa-boxes-packing:before{content:"\e4c7"}.fa-arrow-circle-left:before,.fa-circle-arrow-left:before{content:"\f0a8"}.fa-group-arrows-rotate:before{content:"\e4f6"}.fa-bowl-food:before{content:"\e4c6"}.fa-candy-cane:before{content:"\f786"}.fa-arrow-down-wide-short:before,.fa-sort-amount-asc:before,.fa-sort-amount-down:before{content:"\f160"}.fa-cloud-bolt:before,.fa-thunderstorm:before{content:"\f76c"}.fa-remove-format:before,.fa-text-slash:before{content:"\f87d"}.fa-face-smile-wink:before,.fa-smile-wink:before{content:"\f4da"}.fa-file-word:before{content:"\f1c2"}.fa-file-powerpoint:before{content:"\f1c4"}.fa-arrows-h:before,.fa-arrows-left-right:before{content:"\f07e"}.fa-house-lock:before{content:"\e510"}.fa-cloud-arrow-down:before,.fa-cloud-download-alt:before,.fa-cloud-download:before{content:"\f0ed"}.fa-children:before{content:"\e4e1"}.fa-blackboard:before,.fa-chalkboard:before{content:"\f51b"}.fa-user-alt-slash:before,.fa-user-large-slash:before{content:"\f4fa"}.fa-envelope-open:before{content:"\f2b6"}.fa-handshake-alt-slash:before,.fa-handshake-simple-slash:before{content:"\e05f"}.fa-mattress-pillow:before{content:"\e525"}.fa-guarani-sign:before{content:"\e19a"}.fa-arrows-rotate:before,.fa-refresh:before,.fa-sync:before{content:"\f021"}.fa-fire-extinguisher:before{content:"\f134"}.fa-cruzeiro-sign:before{content:"\e152"}.fa-greater-than-equal:before{content:"\f532"}.fa-shield-alt:before,.fa-shield-halved:before{content:"\f3ed"}.fa-atlas:before,.fa-book-atlas:before{content:"\f558"}.fa-virus:before{content:"\e074"}.fa-envelope-circle-check:before{content:"\e4e8"}.fa-layer-group:before{content:"\f5fd"}.fa-arrows-to-dot:before{content:"\e4be"}.fa-archway:before{content:"\f557"}.fa-heart-circle-check:before{content:"\e4fd"}.fa-house-chimney-crack:before,.fa-house-damage:before{content:"\f6f1"}.fa-file-archive:before,.fa-file-zipper:before{content:"\f1c6"}.fa-square:before{content:"\f0c8"}.fa-glass-martini:before,.fa-martini-glass-empty:before{content:"\f000"}.fa-couch:before{content:"\f4b8"}.fa-cedi-sign:before{content:"\e0df"}.fa-italic:before{content:"\f033"}.fa-table-cells-column-lock:before{content:"\e678"}.fa-church:before{content:"\f51d"}.fa-comments-dollar:before{content:"\f653"}.fa-democrat:before{content:"\f747"}.fa-z:before{content:"\5a"}.fa-person-skiing:before,.fa-skiing:before{content:"\f7c9"}.fa-road-lock:before{content:"\e567"}.fa-a:before{content:"\41"}.fa-temperature-arrow-down:before,.fa-temperature-down:before{content:"\e03f"}.fa-feather-alt:before,.fa-feather-pointed:before{content:"\f56b"}.fa-p:before{content:"\50"}.fa-snowflake:before{content:"\f2dc"}.fa-newspaper:before{content:"\f1ea"}.fa-ad:before,.fa-rectangle-ad:before{content:"\f641"}.fa-arrow-circle-right:before,.fa-circle-arrow-right:before{content:"\f0a9"}.fa-filter-circle-xmark:before{content:"\e17b"}.fa-locust:before{content:"\e520"}.fa-sort:before,.fa-unsorted:before{content:"\f0dc"}.fa-list-1-2:before,.fa-list-numeric:before,.fa-list-ol:before{content:"\f0cb"}.fa-person-dress-burst:before{content:"\e544"}.fa-money-check-alt:before,.fa-money-check-dollar:before{content:"\f53d"}.fa-vector-square:before{content:"\f5cb"}.fa-bread-slice:before{content:"\f7ec"}.fa-language:before{content:"\f1ab"}.fa-face-kiss-wink-heart:before,.fa-kiss-wink-heart:before{content:"\f598"}.fa-filter:before{content:"\f0b0"}.fa-question:before{content:"\3f"}.fa-file-signature:before{content:"\f573"}.fa-arrows-alt:before,.fa-up-down-left-right:before{content:"\f0b2"}.fa-house-chimney-user:before{content:"\e065"}.fa-hand-holding-heart:before{content:"\f4be"}.fa-puzzle-piece:before{content:"\f12e"}.fa-money-check:before{content:"\f53c"}.fa-star-half-alt:before,.fa-star-half-stroke:before{content:"\f5c0"}.fa-code:before{content:"\f121"}.fa-glass-whiskey:before,.fa-whiskey-glass:before{content:"\f7a0"}.fa-building-circle-exclamation:before{content:"\e4d3"}.fa-magnifying-glass-chart:before{content:"\e522"}.fa-arrow-up-right-from-square:before,.fa-external-link:before{content:"\f08e"}.fa-cubes-stacked:before{content:"\e4e6"}.fa-krw:before,.fa-won-sign:before,.fa-won:before{content:"\f159"}.fa-virus-covid:before{content:"\e4a8"}.fa-austral-sign:before{content:"\e0a9"}.fa-f:before{content:"\46"}.fa-leaf:before{content:"\f06c"}.fa-road:before{content:"\f018"}.fa-cab:before,.fa-taxi:before{content:"\f1ba"}.fa-person-circle-plus:before{content:"\e541"}.fa-chart-pie:before,.fa-pie-chart:before{content:"\f200"}.fa-bolt-lightning:before{content:"\e0b7"}.fa-sack-xmark:before{content:"\e56a"}.fa-file-excel:before{content:"\f1c3"}.fa-file-contract:before{content:"\f56c"}.fa-fish-fins:before{content:"\e4f2"}.fa-building-flag:before{content:"\e4d5"}.fa-face-grin-beam:before,.fa-grin-beam:before{content:"\f582"}.fa-object-ungroup:before{content:"\f248"}.fa-poop:before{content:"\f619"}.fa-location-pin:before,.fa-map-marker:before{content:"\f041"}.fa-kaaba:before{content:"\f66b"}.fa-toilet-paper:before{content:"\f71e"}.fa-hard-hat:before,.fa-hat-hard:before,.fa-helmet-safety:before{content:"\f807"}.fa-eject:before{content:"\f052"}.fa-arrow-alt-circle-right:before,.fa-circle-right:before{content:"\f35a"}.fa-plane-circle-check:before{content:"\e555"}.fa-face-rolling-eyes:before,.fa-meh-rolling-eyes:before{content:"\f5a5"}.fa-object-group:before{content:"\f247"}.fa-chart-line:before,.fa-line-chart:before{content:"\f201"}.fa-mask-ventilator:before{content:"\e524"}.fa-arrow-right:before{content:"\f061"}.fa-map-signs:before,.fa-signs-post:before{content:"\f277"}.fa-cash-register:before{content:"\f788"}.fa-person-circle-question:before{content:"\e542"}.fa-h:before{content:"\48"}.fa-tarp:before{content:"\e57b"}.fa-screwdriver-wrench:before,.fa-tools:before{content:"\f7d9"}.fa-arrows-to-eye:before{content:"\e4bf"}.fa-plug-circle-bolt:before{content:"\e55b"}.fa-heart:before{content:"\f004"}.fa-mars-and-venus:before{content:"\f224"}.fa-home-user:before,.fa-house-user:before{content:"\e1b0"}.fa-dumpster-fire:before{content:"\f794"}.fa-house-crack:before{content:"\e3b1"}.fa-cocktail:before,.fa-martini-glass-citrus:before{content:"\f561"}.fa-face-surprise:before,.fa-surprise:before{content:"\f5c2"}.fa-bottle-water:before{content:"\e4c5"}.fa-circle-pause:before,.fa-pause-circle:before{content:"\f28b"}.fa-toilet-paper-slash:before{content:"\e072"}.fa-apple-alt:before,.fa-apple-whole:before{content:"\f5d1"}.fa-kitchen-set:before{content:"\e51a"}.fa-r:before{content:"\52"}.fa-temperature-1:before,.fa-temperature-quarter:before,.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:"\f2ca"}.fa-cube:before{content:"\f1b2"}.fa-bitcoin-sign:before{content:"\e0b4"}.fa-shield-dog:before{content:"\e573"}.fa-solar-panel:before{content:"\f5ba"}.fa-lock-open:before{content:"\f3c1"}.fa-elevator:before{content:"\e16d"}.fa-money-bill-transfer:before{content:"\e528"}.fa-money-bill-trend-up:before{content:"\e529"}.fa-house-flood-water-circle-arrow-right:before{content:"\e50f"}.fa-poll-h:before,.fa-square-poll-horizontal:before{content:"\f682"}.fa-circle:before{content:"\f111"}.fa-backward-fast:before,.fa-fast-backward:before{content:"\f049"}.fa-recycle:before{content:"\f1b8"}.fa-user-astronaut:before{content:"\f4fb"}.fa-plane-slash:before{content:"\e069"}.fa-trademark:before{content:"\f25c"}.fa-basketball-ball:before,.fa-basketball:before{content:"\f434"}.fa-satellite-dish:before{content:"\f7c0"}.fa-arrow-alt-circle-up:before,.fa-circle-up:before{content:"\f35b"}.fa-mobile-alt:before,.fa-mobile-screen-button:before{content:"\f3cd"}.fa-volume-high:before,.fa-volume-up:before{content:"\f028"}.fa-users-rays:before{content:"\e593"}.fa-wallet:before{content:"\f555"}.fa-clipboard-check:before{content:"\f46c"}.fa-file-audio:before{content:"\f1c7"}.fa-burger:before,.fa-hamburger:before{content:"\f805"}.fa-wrench:before{content:"\f0ad"}.fa-bugs:before{content:"\e4d0"}.fa-rupee-sign:before,.fa-rupee:before{content:"\f156"}.fa-file-image:before{content:"\f1c5"}.fa-circle-question:before,.fa-question-circle:before{content:"\f059"}.fa-plane-departure:before{content:"\f5b0"}.fa-handshake-slash:before{content:"\e060"}.fa-book-bookmark:before{content:"\e0bb"}.fa-code-branch:before{content:"\f126"}.fa-hat-cowboy:before{content:"\f8c0"}.fa-bridge:before{content:"\e4c8"}.fa-phone-alt:before,.fa-phone-flip:before{content:"\f879"}.fa-truck-front:before{content:"\e2b7"}.fa-cat:before{content:"\f6be"}.fa-anchor-circle-exclamation:before{content:"\e4ab"}.fa-truck-field:before{content:"\e58d"}.fa-route:before{content:"\f4d7"}.fa-clipboard-question:before{content:"\e4e3"}.fa-panorama:before{content:"\e209"}.fa-comment-medical:before{content:"\f7f5"}.fa-teeth-open:before{content:"\f62f"}.fa-file-circle-minus:before{content:"\e4ed"}.fa-tags:before{content:"\f02c"}.fa-wine-glass:before{content:"\f4e3"}.fa-fast-forward:before,.fa-forward-fast:before{content:"\f050"}.fa-face-meh-blank:before,.fa-meh-blank:before{content:"\f5a4"}.fa-parking:before,.fa-square-parking:before{content:"\f540"}.fa-house-signal:before{content:"\e012"}.fa-bars-progress:before,.fa-tasks-alt:before{content:"\f828"}.fa-faucet-drip:before{content:"\e006"}.fa-cart-flatbed:before,.fa-dolly-flatbed:before{content:"\f474"}.fa-ban-smoking:before,.fa-smoking-ban:before{content:"\f54d"}.fa-terminal:before{content:"\f120"}.fa-mobile-button:before{content:"\f10b"}.fa-house-medical-flag:before{content:"\e514"}.fa-basket-shopping:before,.fa-shopping-basket:before{content:"\f291"}.fa-tape:before{content:"\f4db"}.fa-bus-alt:before,.fa-bus-simple:before{content:"\f55e"}.fa-eye:before{content:"\f06e"}.fa-face-sad-cry:before,.fa-sad-cry:before{content:"\f5b3"}.fa-audio-description:before{content:"\f29e"}.fa-person-military-to-person:before{content:"\e54c"}.fa-file-shield:before{content:"\e4f0"}.fa-user-slash:before{content:"\f506"}.fa-pen:before{content:"\f304"}.fa-tower-observation:before{content:"\e586"}.fa-file-code:before{content:"\f1c9"}.fa-signal-5:before,.fa-signal-perfect:before,.fa-signal:before{content:"\f012"}.fa-bus:before{content:"\f207"}.fa-heart-circle-xmark:before{content:"\e501"}.fa-home-lg:before,.fa-house-chimney:before{content:"\e3af"}.fa-window-maximize:before{content:"\f2d0"}.fa-face-frown:before,.fa-frown:before{content:"\f119"}.fa-prescription:before{content:"\f5b1"}.fa-shop:before,.fa-store-alt:before{content:"\f54f"}.fa-floppy-disk:before,.fa-save:before{content:"\f0c7"}.fa-vihara:before{content:"\f6a7"}.fa-balance-scale-left:before,.fa-scale-unbalanced:before{content:"\f515"}.fa-sort-asc:before,.fa-sort-up:before{content:"\f0de"}.fa-comment-dots:before,.fa-commenting:before{content:"\f4ad"}.fa-plant-wilt:before{content:"\e5aa"}.fa-diamond:before{content:"\f219"}.fa-face-grin-squint:before,.fa-grin-squint:before{content:"\f585"}.fa-hand-holding-dollar:before,.fa-hand-holding-usd:before{content:"\f4c0"}.fa-bacterium:before{content:"\e05a"}.fa-hand-pointer:before{content:"\f25a"}.fa-drum-steelpan:before{content:"\f56a"}.fa-hand-scissors:before{content:"\f257"}.fa-hands-praying:before,.fa-praying-hands:before{content:"\f684"}.fa-arrow-right-rotate:before,.fa-arrow-rotate-forward:before,.fa-arrow-rotate-right:before,.fa-redo:before{content:"\f01e"}.fa-biohazard:before{content:"\f780"}.fa-location-crosshairs:before,.fa-location:before{content:"\f601"}.fa-mars-double:before{content:"\f227"}.fa-child-dress:before{content:"\e59c"}.fa-users-between-lines:before{content:"\e591"}.fa-lungs-virus:before{content:"\e067"}.fa-face-grin-tears:before,.fa-grin-tears:before{content:"\f588"}.fa-phone:before{content:"\f095"}.fa-calendar-times:before,.fa-calendar-xmark:before{content:"\f273"}.fa-child-reaching:before{content:"\e59d"}.fa-head-side-virus:before{content:"\e064"}.fa-user-cog:before,.fa-user-gear:before{content:"\f4fe"}.fa-arrow-up-1-9:before,.fa-sort-numeric-up:before{content:"\f163"}.fa-door-closed:before{content:"\f52a"}.fa-shield-virus:before{content:"\e06c"}.fa-dice-six:before{content:"\f526"}.fa-mosquito-net:before{content:"\e52c"}.fa-bridge-water:before{content:"\e4ce"}.fa-person-booth:before{content:"\f756"}.fa-text-width:before{content:"\f035"}.fa-hat-wizard:before{content:"\f6e8"}.fa-pen-fancy:before{content:"\f5ac"}.fa-digging:before,.fa-person-digging:before{content:"\f85e"}.fa-trash:before{content:"\f1f8"}.fa-gauge-simple-med:before,.fa-gauge-simple:before,.fa-tachometer-average:before{content:"\f629"}.fa-book-medical:before{content:"\f7e6"}.fa-poo:before{content:"\f2fe"}.fa-quote-right-alt:before,.fa-quote-right:before{content:"\f10e"}.fa-shirt:before,.fa-t-shirt:before,.fa-tshirt:before{content:"\f553"}.fa-cubes:before{content:"\f1b3"}.fa-divide:before{content:"\f529"}.fa-tenge-sign:before,.fa-tenge:before{content:"\f7d7"}.fa-headphones:before{content:"\f025"}.fa-hands-holding:before{content:"\f4c2"}.fa-hands-clapping:before{content:"\e1a8"}.fa-republican:before{content:"\f75e"}.fa-arrow-left:before{content:"\f060"}.fa-person-circle-xmark:before{content:"\e543"}.fa-ruler:before{content:"\f545"}.fa-align-left:before{content:"\f036"}.fa-dice-d6:before{content:"\f6d1"}.fa-restroom:before{content:"\f7bd"}.fa-j:before{content:"\4a"}.fa-users-viewfinder:before{content:"\e595"}.fa-file-video:before{content:"\f1c8"}.fa-external-link-alt:before,.fa-up-right-from-square:before{content:"\f35d"}.fa-table-cells:before,.fa-th:before{content:"\f00a"}.fa-file-pdf:before{content:"\f1c1"}.fa-bible:before,.fa-book-bible:before{content:"\f647"}.fa-o:before{content:"\4f"}.fa-medkit:before,.fa-suitcase-medical:before{content:"\f0fa"}.fa-user-secret:before{content:"\f21b"}.fa-otter:before{content:"\f700"}.fa-female:before,.fa-person-dress:before{content:"\f182"}.fa-comment-dollar:before{content:"\f651"}.fa-briefcase-clock:before,.fa-business-time:before{content:"\f64a"}.fa-table-cells-large:before,.fa-th-large:before{content:"\f009"}.fa-book-tanakh:before,.fa-tanakh:before{content:"\f827"}.fa-phone-volume:before,.fa-volume-control-phone:before{content:"\f2a0"}.fa-hat-cowboy-side:before{content:"\f8c1"}.fa-clipboard-user:before{content:"\f7f3"}.fa-child:before{content:"\f1ae"}.fa-lira-sign:before{content:"\f195"}.fa-satellite:before{content:"\f7bf"}.fa-plane-lock:before{content:"\e558"}.fa-tag:before{content:"\f02b"}.fa-comment:before{content:"\f075"}.fa-birthday-cake:before,.fa-cake-candles:before,.fa-cake:before{content:"\f1fd"}.fa-envelope:before{content:"\f0e0"}.fa-angle-double-up:before,.fa-angles-up:before{content:"\f102"}.fa-paperclip:before{content:"\f0c6"}.fa-arrow-right-to-city:before{content:"\e4b3"}.fa-ribbon:before{content:"\f4d6"}.fa-lungs:before{content:"\f604"}.fa-arrow-up-9-1:before,.fa-sort-numeric-up-alt:before{content:"\f887"}.fa-litecoin-sign:before{content:"\e1d3"}.fa-border-none:before{content:"\f850"}.fa-circle-nodes:before{content:"\e4e2"}.fa-parachute-box:before{content:"\f4cd"}.fa-indent:before{content:"\f03c"}.fa-truck-field-un:before{content:"\e58e"}.fa-hourglass-empty:before,.fa-hourglass:before{content:"\f254"}.fa-mountain:before{content:"\f6fc"}.fa-user-doctor:before,.fa-user-md:before{content:"\f0f0"}.fa-circle-info:before,.fa-info-circle:before{content:"\f05a"}.fa-cloud-meatball:before{content:"\f73b"}.fa-camera-alt:before,.fa-camera:before{content:"\f030"}.fa-square-virus:before{content:"\e578"}.fa-meteor:before{content:"\f753"}.fa-car-on:before{content:"\e4dd"}.fa-sleigh:before{content:"\f7cc"}.fa-arrow-down-1-9:before,.fa-sort-numeric-asc:before,.fa-sort-numeric-down:before{content:"\f162"}.fa-hand-holding-droplet:before,.fa-hand-holding-water:before{content:"\f4c1"}.fa-water:before{content:"\f773"}.fa-calendar-check:before{content:"\f274"}.fa-braille:before{content:"\f2a1"}.fa-prescription-bottle-alt:before,.fa-prescription-bottle-medical:before{content:"\f486"}.fa-landmark:before{content:"\f66f"}.fa-truck:before{content:"\f0d1"}.fa-crosshairs:before{content:"\f05b"}.fa-person-cane:before{content:"\e53c"}.fa-tent:before{content:"\e57d"}.fa-vest-patches:before{content:"\e086"}.fa-check-double:before{content:"\f560"}.fa-arrow-down-a-z:before,.fa-sort-alpha-asc:before,.fa-sort-alpha-down:before{content:"\f15d"}.fa-money-bill-wheat:before{content:"\e52a"}.fa-cookie:before{content:"\f563"}.fa-arrow-left-rotate:before,.fa-arrow-rotate-back:before,.fa-arrow-rotate-backward:before,.fa-arrow-rotate-left:before,.fa-undo:before{content:"\f0e2"}.fa-hard-drive:before,.fa-hdd:before{content:"\f0a0"}.fa-face-grin-squint-tears:before,.fa-grin-squint-tears:before{content:"\f586"}.fa-dumbbell:before{content:"\f44b"}.fa-list-alt:before,.fa-rectangle-list:before{content:"\f022"}.fa-tarp-droplet:before{content:"\e57c"}.fa-house-medical-circle-check:before{content:"\e511"}.fa-person-skiing-nordic:before,.fa-skiing-nordic:before{content:"\f7ca"}.fa-calendar-plus:before{content:"\f271"}.fa-plane-arrival:before{content:"\f5af"}.fa-arrow-alt-circle-left:before,.fa-circle-left:before{content:"\f359"}.fa-subway:before,.fa-train-subway:before{content:"\f239"}.fa-chart-gantt:before{content:"\e0e4"}.fa-indian-rupee-sign:before,.fa-indian-rupee:before,.fa-inr:before{content:"\e1bc"}.fa-crop-alt:before,.fa-crop-simple:before{content:"\f565"}.fa-money-bill-1:before,.fa-money-bill-alt:before{content:"\f3d1"}.fa-left-long:before,.fa-long-arrow-alt-left:before{content:"\f30a"}.fa-dna:before{content:"\f471"}.fa-virus-slash:before{content:"\e075"}.fa-minus:before,.fa-subtract:before{content:"\f068"}.fa-chess:before{content:"\f439"}.fa-arrow-left-long:before,.fa-long-arrow-left:before{content:"\f177"}.fa-plug-circle-check:before{content:"\e55c"}.fa-street-view:before{content:"\f21d"}.fa-franc-sign:before{content:"\e18f"}.fa-volume-off:before{content:"\f026"}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before,.fa-hands-american-sign-language-interpreting:before,.fa-hands-asl-interpreting:before{content:"\f2a3"}.fa-cog:before,.fa-gear:before{content:"\f013"}.fa-droplet-slash:before,.fa-tint-slash:before{content:"\f5c7"}.fa-mosque:before{content:"\f678"}.fa-mosquito:before{content:"\e52b"}.fa-star-of-david:before{content:"\f69a"}.fa-person-military-rifle:before{content:"\e54b"}.fa-cart-shopping:before,.fa-shopping-cart:before{content:"\f07a"}.fa-vials:before{content:"\f493"}.fa-plug-circle-plus:before{content:"\e55f"}.fa-place-of-worship:before{content:"\f67f"}.fa-grip-vertical:before{content:"\f58e"}.fa-arrow-turn-up:before,.fa-level-up:before{content:"\f148"}.fa-u:before{content:"\55"}.fa-square-root-alt:before,.fa-square-root-variable:before{content:"\f698"}.fa-clock-four:before,.fa-clock:before{content:"\f017"}.fa-backward-step:before,.fa-step-backward:before{content:"\f048"}.fa-pallet:before{content:"\f482"}.fa-faucet:before{content:"\e005"}.fa-baseball-bat-ball:before{content:"\f432"}.fa-s:before{content:"\53"}.fa-timeline:before{content:"\e29c"}.fa-keyboard:before{content:"\f11c"}.fa-caret-down:before{content:"\f0d7"}.fa-clinic-medical:before,.fa-house-chimney-medical:before{content:"\f7f2"}.fa-temperature-3:before,.fa-temperature-three-quarters:before,.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:"\f2c8"}.fa-mobile-android-alt:before,.fa-mobile-screen:before{content:"\f3cf"}.fa-plane-up:before{content:"\e22d"}.fa-piggy-bank:before{content:"\f4d3"}.fa-battery-3:before,.fa-battery-half:before{content:"\f242"}.fa-mountain-city:before{content:"\e52e"}.fa-coins:before{content:"\f51e"}.fa-khanda:before{content:"\f66d"}.fa-sliders-h:before,.fa-sliders:before{content:"\f1de"}.fa-folder-tree:before{content:"\f802"}.fa-network-wired:before{content:"\f6ff"}.fa-map-pin:before{content:"\f276"}.fa-hamsa:before{content:"\f665"}.fa-cent-sign:before{content:"\e3f5"}.fa-flask:before{content:"\f0c3"}.fa-person-pregnant:before{content:"\e31e"}.fa-wand-sparkles:before{content:"\f72b"}.fa-ellipsis-v:before,.fa-ellipsis-vertical:before{content:"\f142"}.fa-ticket:before{content:"\f145"}.fa-power-off:before{content:"\f011"}.fa-long-arrow-alt-right:before,.fa-right-long:before{content:"\f30b"}.fa-flag-usa:before{content:"\f74d"}.fa-laptop-file:before{content:"\e51d"}.fa-teletype:before,.fa-tty:before{content:"\f1e4"}.fa-diagram-next:before{content:"\e476"}.fa-person-rifle:before{content:"\e54e"}.fa-house-medical-circle-exclamation:before{content:"\e512"}.fa-closed-captioning:before{content:"\f20a"}.fa-hiking:before,.fa-person-hiking:before{content:"\f6ec"}.fa-venus-double:before{content:"\f226"}.fa-images:before{content:"\f302"}.fa-calculator:before{content:"\f1ec"}.fa-people-pulling:before{content:"\e535"}.fa-n:before{content:"\4e"}.fa-cable-car:before,.fa-tram:before{content:"\f7da"}.fa-cloud-rain:before{content:"\f73d"}.fa-building-circle-xmark:before{content:"\e4d4"}.fa-ship:before{content:"\f21a"}.fa-arrows-down-to-line:before{content:"\e4b8"}.fa-download:before{content:"\f019"}.fa-face-grin:before,.fa-grin:before{content:"\f580"}.fa-backspace:before,.fa-delete-left:before{content:"\f55a"}.fa-eye-dropper-empty:before,.fa-eye-dropper:before,.fa-eyedropper:before{content:"\f1fb"}.fa-file-circle-check:before{content:"\e5a0"}.fa-forward:before{content:"\f04e"}.fa-mobile-android:before,.fa-mobile-phone:before,.fa-mobile:before{content:"\f3ce"}.fa-face-meh:before,.fa-meh:before{content:"\f11a"}.fa-align-center:before{content:"\f037"}.fa-book-dead:before,.fa-book-skull:before{content:"\f6b7"}.fa-drivers-license:before,.fa-id-card:before{content:"\f2c2"}.fa-dedent:before,.fa-outdent:before{content:"\f03b"}.fa-heart-circle-exclamation:before{content:"\e4fe"}.fa-home-alt:before,.fa-home-lg-alt:before,.fa-home:before,.fa-house:before{content:"\f015"}.fa-calendar-week:before{content:"\f784"}.fa-laptop-medical:before{content:"\f812"}.fa-b:before{content:"\42"}.fa-file-medical:before{content:"\f477"}.fa-dice-one:before{content:"\f525"}.fa-kiwi-bird:before{content:"\f535"}.fa-arrow-right-arrow-left:before,.fa-exchange:before{content:"\f0ec"}.fa-redo-alt:before,.fa-rotate-forward:before,.fa-rotate-right:before{content:"\f2f9"}.fa-cutlery:before,.fa-utensils:before{content:"\f2e7"}.fa-arrow-up-wide-short:before,.fa-sort-amount-up:before{content:"\f161"}.fa-mill-sign:before{content:"\e1ed"}.fa-bowl-rice:before{content:"\e2eb"}.fa-skull:before{content:"\f54c"}.fa-broadcast-tower:before,.fa-tower-broadcast:before{content:"\f519"}.fa-truck-pickup:before{content:"\f63c"}.fa-long-arrow-alt-up:before,.fa-up-long:before{content:"\f30c"}.fa-stop:before{content:"\f04d"}.fa-code-merge:before{content:"\f387"}.fa-upload:before{content:"\f093"}.fa-hurricane:before{content:"\f751"}.fa-mound:before{content:"\e52d"}.fa-toilet-portable:before{content:"\e583"}.fa-compact-disc:before{content:"\f51f"}.fa-file-arrow-down:before,.fa-file-download:before{content:"\f56d"}.fa-caravan:before{content:"\f8ff"}.fa-shield-cat:before{content:"\e572"}.fa-bolt:before,.fa-zap:before{content:"\f0e7"}.fa-glass-water:before{content:"\e4f4"}.fa-oil-well:before{content:"\e532"}.fa-vault:before{content:"\e2c5"}.fa-mars:before{content:"\f222"}.fa-toilet:before{content:"\f7d8"}.fa-plane-circle-xmark:before{content:"\e557"}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen-sign:before,.fa-yen:before{content:"\f157"}.fa-rouble:before,.fa-rub:before,.fa-ruble-sign:before,.fa-ruble:before{content:"\f158"}.fa-sun:before{content:"\f185"}.fa-guitar:before{content:"\f7a6"}.fa-face-laugh-wink:before,.fa-laugh-wink:before{content:"\f59c"}.fa-horse-head:before{content:"\f7ab"}.fa-bore-hole:before{content:"\e4c3"}.fa-industry:before{content:"\f275"}.fa-arrow-alt-circle-down:before,.fa-circle-down:before{content:"\f358"}.fa-arrows-turn-to-dots:before{content:"\e4c1"}.fa-florin-sign:before{content:"\e184"}.fa-arrow-down-short-wide:before,.fa-sort-amount-desc:before,.fa-sort-amount-down-alt:before{content:"\f884"}.fa-less-than:before{content:"\3c"}.fa-angle-down:before{content:"\f107"}.fa-car-tunnel:before{content:"\e4de"}.fa-head-side-cough:before{content:"\e061"}.fa-grip-lines:before{content:"\f7a4"}.fa-thumbs-down:before{content:"\f165"}.fa-user-lock:before{content:"\f502"}.fa-arrow-right-long:before,.fa-long-arrow-right:before{content:"\f178"}.fa-anchor-circle-xmark:before{content:"\e4ac"}.fa-ellipsis-h:before,.fa-ellipsis:before{content:"\f141"}.fa-chess-pawn:before{content:"\f443"}.fa-first-aid:before,.fa-kit-medical:before{content:"\f479"}.fa-person-through-window:before{content:"\e5a9"}.fa-toolbox:before{content:"\f552"}.fa-hands-holding-circle:before{content:"\e4fb"}.fa-bug:before{content:"\f188"}.fa-credit-card-alt:before,.fa-credit-card:before{content:"\f09d"}.fa-automobile:before,.fa-car:before{content:"\f1b9"}.fa-hand-holding-hand:before{content:"\e4f7"}.fa-book-open-reader:before,.fa-book-reader:before{content:"\f5da"}.fa-mountain-sun:before{content:"\e52f"}.fa-arrows-left-right-to-line:before{content:"\e4ba"}.fa-dice-d20:before{content:"\f6cf"}.fa-truck-droplet:before{content:"\e58c"}.fa-file-circle-xmark:before{content:"\e5a1"}.fa-temperature-arrow-up:before,.fa-temperature-up:before{content:"\e040"}.fa-medal:before{content:"\f5a2"}.fa-bed:before{content:"\f236"}.fa-h-square:before,.fa-square-h:before{content:"\f0fd"}.fa-podcast:before{content:"\f2ce"}.fa-temperature-4:before,.fa-temperature-full:before,.fa-thermometer-4:before,.fa-thermometer-full:before{content:"\f2c7"}.fa-bell:before{content:"\f0f3"}.fa-superscript:before{content:"\f12b"}.fa-plug-circle-xmark:before{content:"\e560"}.fa-star-of-life:before{content:"\f621"}.fa-phone-slash:before{content:"\f3dd"}.fa-paint-roller:before{content:"\f5aa"}.fa-hands-helping:before,.fa-handshake-angle:before{content:"\f4c4"}.fa-location-dot:before,.fa-map-marker-alt:before{content:"\f3c5"}.fa-file:before{content:"\f15b"}.fa-greater-than:before{content:"\3e"}.fa-person-swimming:before,.fa-swimmer:before{content:"\f5c4"}.fa-arrow-down:before{content:"\f063"}.fa-droplet:before,.fa-tint:before{content:"\f043"}.fa-eraser:before{content:"\f12d"}.fa-earth-america:before,.fa-earth-americas:before,.fa-earth:before,.fa-globe-americas:before{content:"\f57d"}.fa-person-burst:before{content:"\e53b"}.fa-dove:before{content:"\f4ba"}.fa-battery-0:before,.fa-battery-empty:before{content:"\f244"}.fa-socks:before{content:"\f696"}.fa-inbox:before{content:"\f01c"}.fa-section:before{content:"\e447"}.fa-gauge-high:before,.fa-tachometer-alt-fast:before,.fa-tachometer-alt:before{content:"\f625"}.fa-envelope-open-text:before{content:"\f658"}.fa-hospital-alt:before,.fa-hospital-wide:before,.fa-hospital:before{content:"\f0f8"}.fa-wine-bottle:before{content:"\f72f"}.fa-chess-rook:before{content:"\f447"}.fa-bars-staggered:before,.fa-reorder:before,.fa-stream:before{content:"\f550"}.fa-dharmachakra:before{content:"\f655"}.fa-hotdog:before{content:"\f80f"}.fa-blind:before,.fa-person-walking-with-cane:before{content:"\f29d"}.fa-drum:before{content:"\f569"}.fa-ice-cream:before{content:"\f810"}.fa-heart-circle-bolt:before{content:"\e4fc"}.fa-fax:before{content:"\f1ac"}.fa-paragraph:before{content:"\f1dd"}.fa-check-to-slot:before,.fa-vote-yea:before{content:"\f772"}.fa-star-half:before{content:"\f089"}.fa-boxes-alt:before,.fa-boxes-stacked:before,.fa-boxes:before{content:"\f468"}.fa-chain:before,.fa-link:before{content:"\f0c1"}.fa-assistive-listening-systems:before,.fa-ear-listen:before{content:"\f2a2"}.fa-tree-city:before{content:"\e587"}.fa-play:before{content:"\f04b"}.fa-font:before{content:"\f031"}.fa-table-cells-row-lock:before{content:"\e67a"}.fa-rupiah-sign:before{content:"\e23d"}.fa-magnifying-glass:before,.fa-search:before{content:"\f002"}.fa-ping-pong-paddle-ball:before,.fa-table-tennis-paddle-ball:before,.fa-table-tennis:before{content:"\f45d"}.fa-diagnoses:before,.fa-person-dots-from-line:before{content:"\f470"}.fa-trash-can-arrow-up:before,.fa-trash-restore-alt:before{content:"\f82a"}.fa-naira-sign:before{content:"\e1f6"}.fa-cart-arrow-down:before{content:"\f218"}.fa-walkie-talkie:before{content:"\f8ef"}.fa-file-edit:before,.fa-file-pen:before{content:"\f31c"}.fa-receipt:before{content:"\f543"}.fa-pen-square:before,.fa-pencil-square:before,.fa-square-pen:before{content:"\f14b"}.fa-suitcase-rolling:before{content:"\f5c1"}.fa-person-circle-exclamation:before{content:"\e53f"}.fa-chevron-down:before{content:"\f078"}.fa-battery-5:before,.fa-battery-full:before,.fa-battery:before{content:"\f240"}.fa-skull-crossbones:before{content:"\f714"}.fa-code-compare:before{content:"\e13a"}.fa-list-dots:before,.fa-list-ul:before{content:"\f0ca"}.fa-school-lock:before{content:"\e56f"}.fa-tower-cell:before{content:"\e585"}.fa-down-long:before,.fa-long-arrow-alt-down:before{content:"\f309"}.fa-ranking-star:before{content:"\e561"}.fa-chess-king:before{content:"\f43f"}.fa-person-harassing:before{content:"\e549"}.fa-brazilian-real-sign:before{content:"\e46c"}.fa-landmark-alt:before,.fa-landmark-dome:before{content:"\f752"}.fa-arrow-up:before{content:"\f062"}.fa-television:before,.fa-tv-alt:before,.fa-tv:before{content:"\f26c"}.fa-shrimp:before{content:"\e448"}.fa-list-check:before,.fa-tasks:before{content:"\f0ae"}.fa-jug-detergent:before{content:"\e519"}.fa-circle-user:before,.fa-user-circle:before{content:"\f2bd"}.fa-user-shield:before{content:"\f505"}.fa-wind:before{content:"\f72e"}.fa-car-burst:before,.fa-car-crash:before{content:"\f5e1"}.fa-y:before{content:"\59"}.fa-person-snowboarding:before,.fa-snowboarding:before{content:"\f7ce"}.fa-shipping-fast:before,.fa-truck-fast:before{content:"\f48b"}.fa-fish:before{content:"\f578"}.fa-user-graduate:before{content:"\f501"}.fa-adjust:before,.fa-circle-half-stroke:before{content:"\f042"}.fa-clapperboard:before{content:"\e131"}.fa-circle-radiation:before,.fa-radiation-alt:before{content:"\f7ba"}.fa-baseball-ball:before,.fa-baseball:before{content:"\f433"}.fa-jet-fighter-up:before{content:"\e518"}.fa-diagram-project:before,.fa-project-diagram:before{content:"\f542"}.fa-copy:before{content:"\f0c5"}.fa-volume-mute:before,.fa-volume-times:before,.fa-volume-xmark:before{content:"\f6a9"}.fa-hand-sparkles:before{content:"\e05d"}.fa-grip-horizontal:before,.fa-grip:before{content:"\f58d"}.fa-share-from-square:before,.fa-share-square:before{content:"\f14d"}.fa-child-combatant:before,.fa-child-rifle:before{content:"\e4e0"}.fa-gun:before{content:"\e19b"}.fa-phone-square:before,.fa-square-phone:before{content:"\f098"}.fa-add:before,.fa-plus:before{content:"\2b"}.fa-expand:before{content:"\f065"}.fa-computer:before{content:"\e4e5"}.fa-close:before,.fa-multiply:before,.fa-remove:before,.fa-times:before,.fa-xmark:before{content:"\f00d"}.fa-arrows-up-down-left-right:before,.fa-arrows:before{content:"\f047"}.fa-chalkboard-teacher:before,.fa-chalkboard-user:before{content:"\f51c"}.fa-peso-sign:before{content:"\e222"}.fa-building-shield:before{content:"\e4d8"}.fa-baby:before{content:"\f77c"}.fa-users-line:before{content:"\e592"}.fa-quote-left-alt:before,.fa-quote-left:before{content:"\f10d"}.fa-tractor:before{content:"\f722"}.fa-trash-arrow-up:before,.fa-trash-restore:before{content:"\f829"}.fa-arrow-down-up-lock:before{content:"\e4b0"}.fa-lines-leaning:before{content:"\e51e"}.fa-ruler-combined:before{content:"\f546"}.fa-copyright:before{content:"\f1f9"}.fa-equals:before{content:"\3d"}.fa-blender:before{content:"\f517"}.fa-teeth:before{content:"\f62e"}.fa-ils:before,.fa-shekel-sign:before,.fa-shekel:before,.fa-sheqel-sign:before,.fa-sheqel:before{content:"\f20b"}.fa-map:before{content:"\f279"}.fa-rocket:before{content:"\f135"}.fa-photo-film:before,.fa-photo-video:before{content:"\f87c"}.fa-folder-minus:before{content:"\f65d"}.fa-store:before{content:"\f54e"}.fa-arrow-trend-up:before{content:"\e098"}.fa-plug-circle-minus:before{content:"\e55e"}.fa-sign-hanging:before,.fa-sign:before{content:"\f4d9"}.fa-bezier-curve:before{content:"\f55b"}.fa-bell-slash:before{content:"\f1f6"}.fa-tablet-android:before,.fa-tablet:before{content:"\f3fb"}.fa-school-flag:before{content:"\e56e"}.fa-fill:before{content:"\f575"}.fa-angle-up:before{content:"\f106"}.fa-drumstick-bite:before{content:"\f6d7"}.fa-holly-berry:before{content:"\f7aa"}.fa-chevron-left:before{content:"\f053"}.fa-bacteria:before{content:"\e059"}.fa-hand-lizard:before{content:"\f258"}.fa-notdef:before{content:"\e1fe"}.fa-disease:before{content:"\f7fa"}.fa-briefcase-medical:before{content:"\f469"}.fa-genderless:before{content:"\f22d"}.fa-chevron-right:before{content:"\f054"}.fa-retweet:before{content:"\f079"}.fa-car-alt:before,.fa-car-rear:before{content:"\f5de"}.fa-pump-soap:before{content:"\e06b"}.fa-video-slash:before{content:"\f4e2"}.fa-battery-2:before,.fa-battery-quarter:before{content:"\f243"}.fa-radio:before{content:"\f8d7"}.fa-baby-carriage:before,.fa-carriage-baby:before{content:"\f77d"}.fa-traffic-light:before{content:"\f637"}.fa-thermometer:before{content:"\f491"}.fa-vr-cardboard:before{content:"\f729"}.fa-hand-middle-finger:before{content:"\f806"}.fa-percent:before,.fa-percentage:before{content:"\25"}.fa-truck-moving:before{content:"\f4df"}.fa-glass-water-droplet:before{content:"\e4f5"}.fa-display:before{content:"\e163"}.fa-face-smile:before,.fa-smile:before{content:"\f118"}.fa-thumb-tack:before,.fa-thumbtack:before{content:"\f08d"}.fa-trophy:before{content:"\f091"}.fa-person-praying:before,.fa-pray:before{content:"\f683"}.fa-hammer:before{content:"\f6e3"}.fa-hand-peace:before{content:"\f25b"}.fa-rotate:before,.fa-sync-alt:before{content:"\f2f1"}.fa-spinner:before{content:"\f110"}.fa-robot:before{content:"\f544"}.fa-peace:before{content:"\f67c"}.fa-cogs:before,.fa-gears:before{content:"\f085"}.fa-warehouse:before{content:"\f494"}.fa-arrow-up-right-dots:before{content:"\e4b7"}.fa-splotch:before{content:"\f5bc"}.fa-face-grin-hearts:before,.fa-grin-hearts:before{content:"\f584"}.fa-dice-four:before{content:"\f524"}.fa-sim-card:before{content:"\f7c4"}.fa-transgender-alt:before,.fa-transgender:before{content:"\f225"}.fa-mercury:before{content:"\f223"}.fa-arrow-turn-down:before,.fa-level-down:before{content:"\f149"}.fa-person-falling-burst:before{content:"\e547"}.fa-award:before{content:"\f559"}.fa-ticket-alt:before,.fa-ticket-simple:before{content:"\f3ff"}.fa-building:before{content:"\f1ad"}.fa-angle-double-left:before,.fa-angles-left:before{content:"\f100"}.fa-qrcode:before{content:"\f029"}.fa-clock-rotate-left:before,.fa-history:before{content:"\f1da"}.fa-face-grin-beam-sweat:before,.fa-grin-beam-sweat:before{content:"\f583"}.fa-arrow-right-from-file:before,.fa-file-export:before{content:"\f56e"}.fa-shield-blank:before,.fa-shield:before{content:"\f132"}.fa-arrow-up-short-wide:before,.fa-sort-amount-up-alt:before{content:"\f885"}.fa-house-medical:before{content:"\e3b2"}.fa-golf-ball-tee:before,.fa-golf-ball:before{content:"\f450"}.fa-chevron-circle-left:before,.fa-circle-chevron-left:before{content:"\f137"}.fa-house-chimney-window:before{content:"\e00d"}.fa-pen-nib:before{content:"\f5ad"}.fa-tent-arrow-turn-left:before{content:"\e580"}.fa-tents:before{content:"\e582"}.fa-magic:before,.fa-wand-magic:before{content:"\f0d0"}.fa-dog:before{content:"\f6d3"}.fa-carrot:before{content:"\f787"}.fa-moon:before{content:"\f186"}.fa-wine-glass-alt:before,.fa-wine-glass-empty:before{content:"\f5ce"}.fa-cheese:before{content:"\f7ef"}.fa-yin-yang:before{content:"\f6ad"}.fa-music:before{content:"\f001"}.fa-code-commit:before{content:"\f386"}.fa-temperature-low:before{content:"\f76b"}.fa-biking:before,.fa-person-biking:before{content:"\f84a"}.fa-broom:before{content:"\f51a"}.fa-shield-heart:before{content:"\e574"}.fa-gopuram:before{content:"\f664"}.fa-earth-oceania:before,.fa-globe-oceania:before{content:"\e47b"}.fa-square-xmark:before,.fa-times-square:before,.fa-xmark-square:before{content:"\f2d3"}.fa-hashtag:before{content:"\23"}.fa-expand-alt:before,.fa-up-right-and-down-left-from-center:before{content:"\f424"}.fa-oil-can:before{content:"\f613"}.fa-t:before{content:"\54"}.fa-hippo:before{content:"\f6ed"}.fa-chart-column:before{content:"\e0e3"}.fa-infinity:before{content:"\f534"}.fa-vial-circle-check:before{content:"\e596"}.fa-person-arrow-down-to-line:before{content:"\e538"}.fa-voicemail:before{content:"\f897"}.fa-fan:before{content:"\f863"}.fa-person-walking-luggage:before{content:"\e554"}.fa-arrows-alt-v:before,.fa-up-down:before{content:"\f338"}.fa-cloud-moon-rain:before{content:"\f73c"}.fa-calendar:before{content:"\f133"}.fa-trailer:before{content:"\e041"}.fa-bahai:before,.fa-haykal:before{content:"\f666"}.fa-sd-card:before{content:"\f7c2"}.fa-dragon:before{content:"\f6d5"}.fa-shoe-prints:before{content:"\f54b"}.fa-circle-plus:before,.fa-plus-circle:before{content:"\f055"}.fa-face-grin-tongue-wink:before,.fa-grin-tongue-wink:before{content:"\f58b"}.fa-hand-holding:before{content:"\f4bd"}.fa-plug-circle-exclamation:before{content:"\e55d"}.fa-chain-broken:before,.fa-chain-slash:before,.fa-link-slash:before,.fa-unlink:before{content:"\f127"}.fa-clone:before{content:"\f24d"}.fa-person-walking-arrow-loop-left:before{content:"\e551"}.fa-arrow-up-z-a:before,.fa-sort-alpha-up-alt:before{content:"\f882"}.fa-fire-alt:before,.fa-fire-flame-curved:before{content:"\f7e4"}.fa-tornado:before{content:"\f76f"}.fa-file-circle-plus:before{content:"\e494"}.fa-book-quran:before,.fa-quran:before{content:"\f687"}.fa-anchor:before{content:"\f13d"}.fa-border-all:before{content:"\f84c"}.fa-angry:before,.fa-face-angry:before{content:"\f556"}.fa-cookie-bite:before{content:"\f564"}.fa-arrow-trend-down:before{content:"\e097"}.fa-feed:before,.fa-rss:before{content:"\f09e"}.fa-draw-polygon:before{content:"\f5ee"}.fa-balance-scale:before,.fa-scale-balanced:before{content:"\f24e"}.fa-gauge-simple-high:before,.fa-tachometer-fast:before,.fa-tachometer:before{content:"\f62a"}.fa-shower:before{content:"\f2cc"}.fa-desktop-alt:before,.fa-desktop:before{content:"\f390"}.fa-m:before{content:"\4d"}.fa-table-list:before,.fa-th-list:before{content:"\f00b"}.fa-comment-sms:before,.fa-sms:before{content:"\f7cd"}.fa-book:before{content:"\f02d"}.fa-user-plus:before{content:"\f234"}.fa-check:before{content:"\f00c"}.fa-battery-4:before,.fa-battery-three-quarters:before{content:"\f241"}.fa-house-circle-check:before{content:"\e509"}.fa-angle-left:before{content:"\f104"}.fa-diagram-successor:before{content:"\e47a"}.fa-truck-arrow-right:before{content:"\e58b"}.fa-arrows-split-up-and-left:before{content:"\e4bc"}.fa-fist-raised:before,.fa-hand-fist:before{content:"\f6de"}.fa-cloud-moon:before{content:"\f6c3"}.fa-briefcase:before{content:"\f0b1"}.fa-person-falling:before{content:"\e546"}.fa-image-portrait:before,.fa-portrait:before{content:"\f3e0"}.fa-user-tag:before{content:"\f507"}.fa-rug:before{content:"\e569"}.fa-earth-europe:before,.fa-globe-europe:before{content:"\f7a2"}.fa-cart-flatbed-suitcase:before,.fa-luggage-cart:before{content:"\f59d"}.fa-rectangle-times:before,.fa-rectangle-xmark:before,.fa-times-rectangle:before,.fa-window-close:before{content:"\f410"}.fa-baht-sign:before{content:"\e0ac"}.fa-book-open:before{content:"\f518"}.fa-book-journal-whills:before,.fa-journal-whills:before{content:"\f66a"}.fa-handcuffs:before{content:"\e4f8"}.fa-exclamation-triangle:before,.fa-triangle-exclamation:before,.fa-warning:before{content:"\f071"}.fa-database:before{content:"\f1c0"}.fa-mail-forward:before,.fa-share:before{content:"\f064"}.fa-bottle-droplet:before{content:"\e4c4"}.fa-mask-face:before{content:"\e1d7"}.fa-hill-rockslide:before{content:"\e508"}.fa-exchange-alt:before,.fa-right-left:before{content:"\f362"}.fa-paper-plane:before{content:"\f1d8"}.fa-road-circle-exclamation:before{content:"\e565"}.fa-dungeon:before{content:"\f6d9"}.fa-align-right:before{content:"\f038"}.fa-money-bill-1-wave:before,.fa-money-bill-wave-alt:before{content:"\f53b"}.fa-life-ring:before{content:"\f1cd"}.fa-hands:before,.fa-sign-language:before,.fa-signing:before{content:"\f2a7"}.fa-calendar-day:before{content:"\f783"}.fa-ladder-water:before,.fa-swimming-pool:before,.fa-water-ladder:before{content:"\f5c5"}.fa-arrows-up-down:before,.fa-arrows-v:before{content:"\f07d"}.fa-face-grimace:before,.fa-grimace:before{content:"\f57f"}.fa-wheelchair-alt:before,.fa-wheelchair-move:before{content:"\e2ce"}.fa-level-down-alt:before,.fa-turn-down:before{content:"\f3be"}.fa-person-walking-arrow-right:before{content:"\e552"}.fa-envelope-square:before,.fa-square-envelope:before{content:"\f199"}.fa-dice:before{content:"\f522"}.fa-bowling-ball:before{content:"\f436"}.fa-brain:before{content:"\f5dc"}.fa-band-aid:before,.fa-bandage:before{content:"\f462"}.fa-calendar-minus:before{content:"\f272"}.fa-circle-xmark:before,.fa-times-circle:before,.fa-xmark-circle:before{content:"\f057"}.fa-gifts:before{content:"\f79c"}.fa-hotel:before{content:"\f594"}.fa-earth-asia:before,.fa-globe-asia:before{content:"\f57e"}.fa-id-card-alt:before,.fa-id-card-clip:before{content:"\f47f"}.fa-magnifying-glass-plus:before,.fa-search-plus:before{content:"\f00e"}.fa-thumbs-up:before{content:"\f164"}.fa-user-clock:before{content:"\f4fd"}.fa-allergies:before,.fa-hand-dots:before{content:"\f461"}.fa-file-invoice:before{content:"\f570"}.fa-window-minimize:before{content:"\f2d1"}.fa-coffee:before,.fa-mug-saucer:before{content:"\f0f4"}.fa-brush:before{content:"\f55d"}.fa-mask:before{content:"\f6fa"}.fa-magnifying-glass-minus:before,.fa-search-minus:before{content:"\f010"}.fa-ruler-vertical:before{content:"\f548"}.fa-user-alt:before,.fa-user-large:before{content:"\f406"}.fa-train-tram:before{content:"\e5b4"}.fa-user-nurse:before{content:"\f82f"}.fa-syringe:before{content:"\f48e"}.fa-cloud-sun:before{content:"\f6c4"}.fa-stopwatch-20:before{content:"\e06f"}.fa-square-full:before{content:"\f45c"}.fa-magnet:before{content:"\f076"}.fa-jar:before{content:"\e516"}.fa-note-sticky:before,.fa-sticky-note:before{content:"\f249"}.fa-bug-slash:before{content:"\e490"}.fa-arrow-up-from-water-pump:before{content:"\e4b6"}.fa-bone:before{content:"\f5d7"}.fa-user-injured:before{content:"\f728"}.fa-face-sad-tear:before,.fa-sad-tear:before{content:"\f5b4"}.fa-plane:before{content:"\f072"}.fa-tent-arrows-down:before{content:"\e581"}.fa-exclamation:before{content:"\21"}.fa-arrows-spin:before{content:"\e4bb"}.fa-print:before{content:"\f02f"}.fa-try:before,.fa-turkish-lira-sign:before,.fa-turkish-lira:before{content:"\e2bb"}.fa-dollar-sign:before,.fa-dollar:before,.fa-usd:before{content:"\24"}.fa-x:before{content:"\58"}.fa-magnifying-glass-dollar:before,.fa-search-dollar:before{content:"\f688"}.fa-users-cog:before,.fa-users-gear:before{content:"\f509"}.fa-person-military-pointing:before{content:"\e54a"}.fa-bank:before,.fa-building-columns:before,.fa-institution:before,.fa-museum:before,.fa-university:before{content:"\f19c"}.fa-umbrella:before{content:"\f0e9"}.fa-trowel:before{content:"\e589"}.fa-d:before{content:"\44"}.fa-stapler:before{content:"\e5af"}.fa-masks-theater:before,.fa-theater-masks:before{content:"\f630"}.fa-kip-sign:before{content:"\e1c4"}.fa-hand-point-left:before{content:"\f0a5"}.fa-handshake-alt:before,.fa-handshake-simple:before{content:"\f4c6"}.fa-fighter-jet:before,.fa-jet-fighter:before{content:"\f0fb"}.fa-share-alt-square:before,.fa-square-share-nodes:before{content:"\f1e1"}.fa-barcode:before{content:"\f02a"}.fa-plus-minus:before{content:"\e43c"}.fa-video-camera:before,.fa-video:before{content:"\f03d"}.fa-graduation-cap:before,.fa-mortar-board:before{content:"\f19d"}.fa-hand-holding-medical:before{content:"\e05c"}.fa-person-circle-check:before{content:"\e53e"}.fa-level-up-alt:before,.fa-turn-up:before{content:"\f3bf"} +.fa-sr-only,.fa-sr-only-focusable:not(:focus),.sr-only,.sr-only-focusable:not(:focus){position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}:host,:root{--fa-style-family-brands:"Font Awesome 6 Brands";--fa-font-brands:normal 400 1em/1 "Font Awesome 6 Brands"}@font-face{font-family:"Font Awesome 6 Brands";font-style:normal;font-weight:400;font-display:block;src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); }.fa-brands,.fab{font-weight:400}.fa-monero:before{content:"\f3d0"}.fa-hooli:before{content:"\f427"}.fa-yelp:before{content:"\f1e9"}.fa-cc-visa:before{content:"\f1f0"}.fa-lastfm:before{content:"\f202"}.fa-shopware:before{content:"\f5b5"}.fa-creative-commons-nc:before{content:"\f4e8"}.fa-aws:before{content:"\f375"}.fa-redhat:before{content:"\f7bc"}.fa-yoast:before{content:"\f2b1"}.fa-cloudflare:before{content:"\e07d"}.fa-ups:before{content:"\f7e0"}.fa-pixiv:before{content:"\e640"}.fa-wpexplorer:before{content:"\f2de"}.fa-dyalog:before{content:"\f399"}.fa-bity:before{content:"\f37a"}.fa-stackpath:before{content:"\f842"}.fa-buysellads:before{content:"\f20d"}.fa-first-order:before{content:"\f2b0"}.fa-modx:before{content:"\f285"}.fa-guilded:before{content:"\e07e"}.fa-vnv:before{content:"\f40b"}.fa-js-square:before,.fa-square-js:before{content:"\f3b9"}.fa-microsoft:before{content:"\f3ca"}.fa-qq:before{content:"\f1d6"}.fa-orcid:before{content:"\f8d2"}.fa-java:before{content:"\f4e4"}.fa-invision:before{content:"\f7b0"}.fa-creative-commons-pd-alt:before{content:"\f4ed"}.fa-centercode:before{content:"\f380"}.fa-glide-g:before{content:"\f2a6"}.fa-drupal:before{content:"\f1a9"}.fa-jxl:before{content:"\e67b"}.fa-hire-a-helper:before{content:"\f3b0"}.fa-creative-commons-by:before{content:"\f4e7"}.fa-unity:before{content:"\e049"}.fa-whmcs:before{content:"\f40d"}.fa-rocketchat:before{content:"\f3e8"}.fa-vk:before{content:"\f189"}.fa-untappd:before{content:"\f405"}.fa-mailchimp:before{content:"\f59e"}.fa-css3-alt:before{content:"\f38b"}.fa-reddit-square:before,.fa-square-reddit:before{content:"\f1a2"}.fa-vimeo-v:before{content:"\f27d"}.fa-contao:before{content:"\f26d"}.fa-square-font-awesome:before{content:"\e5ad"}.fa-deskpro:before{content:"\f38f"}.fa-brave:before{content:"\e63c"}.fa-sistrix:before{content:"\f3ee"}.fa-instagram-square:before,.fa-square-instagram:before{content:"\e055"}.fa-battle-net:before{content:"\f835"}.fa-the-red-yeti:before{content:"\f69d"}.fa-hacker-news-square:before,.fa-square-hacker-news:before{content:"\f3af"}.fa-edge:before{content:"\f282"}.fa-threads:before{content:"\e618"}.fa-napster:before{content:"\f3d2"}.fa-snapchat-square:before,.fa-square-snapchat:before{content:"\f2ad"}.fa-google-plus-g:before{content:"\f0d5"}.fa-artstation:before{content:"\f77a"}.fa-markdown:before{content:"\f60f"}.fa-sourcetree:before{content:"\f7d3"}.fa-google-plus:before{content:"\f2b3"}.fa-diaspora:before{content:"\f791"}.fa-foursquare:before{content:"\f180"}.fa-stack-overflow:before{content:"\f16c"}.fa-github-alt:before{content:"\f113"}.fa-phoenix-squadron:before{content:"\f511"}.fa-pagelines:before{content:"\f18c"}.fa-algolia:before{content:"\f36c"}.fa-red-river:before{content:"\f3e3"}.fa-creative-commons-sa:before{content:"\f4ef"}.fa-safari:before{content:"\f267"}.fa-google:before{content:"\f1a0"}.fa-font-awesome-alt:before,.fa-square-font-awesome-stroke:before{content:"\f35c"}.fa-atlassian:before{content:"\f77b"}.fa-linkedin-in:before{content:"\f0e1"}.fa-digital-ocean:before{content:"\f391"}.fa-nimblr:before{content:"\f5a8"}.fa-chromecast:before{content:"\f838"}.fa-evernote:before{content:"\f839"}.fa-hacker-news:before{content:"\f1d4"}.fa-creative-commons-sampling:before{content:"\f4f0"}.fa-adversal:before{content:"\f36a"}.fa-creative-commons:before{content:"\f25e"}.fa-watchman-monitoring:before{content:"\e087"}.fa-fonticons:before{content:"\f280"}.fa-weixin:before{content:"\f1d7"}.fa-shirtsinbulk:before{content:"\f214"}.fa-codepen:before{content:"\f1cb"}.fa-git-alt:before{content:"\f841"}.fa-lyft:before{content:"\f3c3"}.fa-rev:before{content:"\f5b2"}.fa-windows:before{content:"\f17a"}.fa-wizards-of-the-coast:before{content:"\f730"}.fa-square-viadeo:before,.fa-viadeo-square:before{content:"\f2aa"}.fa-meetup:before{content:"\f2e0"}.fa-centos:before{content:"\f789"}.fa-adn:before{content:"\f170"}.fa-cloudsmith:before{content:"\f384"}.fa-opensuse:before{content:"\e62b"}.fa-pied-piper-alt:before{content:"\f1a8"}.fa-dribbble-square:before,.fa-square-dribbble:before{content:"\f397"}.fa-codiepie:before{content:"\f284"}.fa-node:before{content:"\f419"}.fa-mix:before{content:"\f3cb"}.fa-steam:before{content:"\f1b6"}.fa-cc-apple-pay:before{content:"\f416"}.fa-scribd:before{content:"\f28a"}.fa-debian:before{content:"\e60b"}.fa-openid:before{content:"\f19b"}.fa-instalod:before{content:"\e081"}.fa-expeditedssl:before{content:"\f23e"}.fa-sellcast:before{content:"\f2da"}.fa-square-twitter:before,.fa-twitter-square:before{content:"\f081"}.fa-r-project:before{content:"\f4f7"}.fa-delicious:before{content:"\f1a5"}.fa-freebsd:before{content:"\f3a4"}.fa-vuejs:before{content:"\f41f"}.fa-accusoft:before{content:"\f369"}.fa-ioxhost:before{content:"\f208"}.fa-fonticons-fi:before{content:"\f3a2"}.fa-app-store:before{content:"\f36f"}.fa-cc-mastercard:before{content:"\f1f1"}.fa-itunes-note:before{content:"\f3b5"}.fa-golang:before{content:"\e40f"}.fa-kickstarter:before,.fa-square-kickstarter:before{content:"\f3bb"}.fa-grav:before{content:"\f2d6"}.fa-weibo:before{content:"\f18a"}.fa-uncharted:before{content:"\e084"}.fa-firstdraft:before{content:"\f3a1"}.fa-square-youtube:before,.fa-youtube-square:before{content:"\f431"}.fa-wikipedia-w:before{content:"\f266"}.fa-rendact:before,.fa-wpressr:before{content:"\f3e4"}.fa-angellist:before{content:"\f209"}.fa-galactic-republic:before{content:"\f50c"}.fa-nfc-directional:before{content:"\e530"}.fa-skype:before{content:"\f17e"}.fa-joget:before{content:"\f3b7"}.fa-fedora:before{content:"\f798"}.fa-stripe-s:before{content:"\f42a"}.fa-meta:before{content:"\e49b"}.fa-laravel:before{content:"\f3bd"}.fa-hotjar:before{content:"\f3b1"}.fa-bluetooth-b:before{content:"\f294"}.fa-square-letterboxd:before{content:"\e62e"}.fa-sticker-mule:before{content:"\f3f7"}.fa-creative-commons-zero:before{content:"\f4f3"}.fa-hips:before{content:"\f452"}.fa-behance:before{content:"\f1b4"}.fa-reddit:before{content:"\f1a1"}.fa-discord:before{content:"\f392"}.fa-chrome:before{content:"\f268"}.fa-app-store-ios:before{content:"\f370"}.fa-cc-discover:before{content:"\f1f2"}.fa-wpbeginner:before{content:"\f297"}.fa-confluence:before{content:"\f78d"}.fa-shoelace:before{content:"\e60c"}.fa-mdb:before{content:"\f8ca"}.fa-dochub:before{content:"\f394"}.fa-accessible-icon:before{content:"\f368"}.fa-ebay:before{content:"\f4f4"}.fa-amazon:before{content:"\f270"}.fa-unsplash:before{content:"\e07c"}.fa-yarn:before{content:"\f7e3"}.fa-square-steam:before,.fa-steam-square:before{content:"\f1b7"}.fa-500px:before{content:"\f26e"}.fa-square-vimeo:before,.fa-vimeo-square:before{content:"\f194"}.fa-asymmetrik:before{content:"\f372"}.fa-font-awesome-flag:before,.fa-font-awesome-logo-full:before,.fa-font-awesome:before{content:"\f2b4"}.fa-gratipay:before{content:"\f184"}.fa-apple:before{content:"\f179"}.fa-hive:before{content:"\e07f"}.fa-gitkraken:before{content:"\f3a6"}.fa-keybase:before{content:"\f4f5"}.fa-apple-pay:before{content:"\f415"}.fa-padlet:before{content:"\e4a0"}.fa-amazon-pay:before{content:"\f42c"}.fa-github-square:before,.fa-square-github:before{content:"\f092"}.fa-stumbleupon:before{content:"\f1a4"}.fa-fedex:before{content:"\f797"}.fa-phoenix-framework:before{content:"\f3dc"}.fa-shopify:before{content:"\e057"}.fa-neos:before{content:"\f612"}.fa-square-threads:before{content:"\e619"}.fa-hackerrank:before{content:"\f5f7"}.fa-researchgate:before{content:"\f4f8"}.fa-swift:before{content:"\f8e1"}.fa-angular:before{content:"\f420"}.fa-speakap:before{content:"\f3f3"}.fa-angrycreative:before{content:"\f36e"}.fa-y-combinator:before{content:"\f23b"}.fa-empire:before{content:"\f1d1"}.fa-envira:before{content:"\f299"}.fa-google-scholar:before{content:"\e63b"}.fa-gitlab-square:before,.fa-square-gitlab:before{content:"\e5ae"}.fa-studiovinari:before{content:"\f3f8"}.fa-pied-piper:before{content:"\f2ae"}.fa-wordpress:before{content:"\f19a"}.fa-product-hunt:before{content:"\f288"}.fa-firefox:before{content:"\f269"}.fa-linode:before{content:"\f2b8"}.fa-goodreads:before{content:"\f3a8"}.fa-odnoklassniki-square:before,.fa-square-odnoklassniki:before{content:"\f264"}.fa-jsfiddle:before{content:"\f1cc"}.fa-sith:before{content:"\f512"}.fa-themeisle:before{content:"\f2b2"}.fa-page4:before{content:"\f3d7"}.fa-hashnode:before{content:"\e499"}.fa-react:before{content:"\f41b"}.fa-cc-paypal:before{content:"\f1f4"}.fa-squarespace:before{content:"\f5be"}.fa-cc-stripe:before{content:"\f1f5"}.fa-creative-commons-share:before{content:"\f4f2"}.fa-bitcoin:before{content:"\f379"}.fa-keycdn:before{content:"\f3ba"}.fa-opera:before{content:"\f26a"}.fa-itch-io:before{content:"\f83a"}.fa-umbraco:before{content:"\f8e8"}.fa-galactic-senate:before{content:"\f50d"}.fa-ubuntu:before{content:"\f7df"}.fa-draft2digital:before{content:"\f396"}.fa-stripe:before{content:"\f429"}.fa-houzz:before{content:"\f27c"}.fa-gg:before{content:"\f260"}.fa-dhl:before{content:"\f790"}.fa-pinterest-square:before,.fa-square-pinterest:before{content:"\f0d3"}.fa-xing:before{content:"\f168"}.fa-blackberry:before{content:"\f37b"}.fa-creative-commons-pd:before{content:"\f4ec"}.fa-playstation:before{content:"\f3df"}.fa-quinscape:before{content:"\f459"}.fa-less:before{content:"\f41d"}.fa-blogger-b:before{content:"\f37d"}.fa-opencart:before{content:"\f23d"}.fa-vine:before{content:"\f1ca"}.fa-signal-messenger:before{content:"\e663"}.fa-paypal:before{content:"\f1ed"}.fa-gitlab:before{content:"\f296"}.fa-typo3:before{content:"\f42b"}.fa-reddit-alien:before{content:"\f281"}.fa-yahoo:before{content:"\f19e"}.fa-dailymotion:before{content:"\e052"}.fa-affiliatetheme:before{content:"\f36b"}.fa-pied-piper-pp:before{content:"\f1a7"}.fa-bootstrap:before{content:"\f836"}.fa-odnoklassniki:before{content:"\f263"}.fa-nfc-symbol:before{content:"\e531"}.fa-mintbit:before{content:"\e62f"}.fa-ethereum:before{content:"\f42e"}.fa-speaker-deck:before{content:"\f83c"}.fa-creative-commons-nc-eu:before{content:"\f4e9"}.fa-patreon:before{content:"\f3d9"}.fa-avianex:before{content:"\f374"}.fa-ello:before{content:"\f5f1"}.fa-gofore:before{content:"\f3a7"}.fa-bimobject:before{content:"\f378"}.fa-brave-reverse:before{content:"\e63d"}.fa-facebook-f:before{content:"\f39e"}.fa-google-plus-square:before,.fa-square-google-plus:before{content:"\f0d4"}.fa-web-awesome:before{content:"\e682"}.fa-mandalorian:before{content:"\f50f"}.fa-first-order-alt:before{content:"\f50a"}.fa-osi:before{content:"\f41a"}.fa-google-wallet:before{content:"\f1ee"}.fa-d-and-d-beyond:before{content:"\f6ca"}.fa-periscope:before{content:"\f3da"}.fa-fulcrum:before{content:"\f50b"}.fa-cloudscale:before{content:"\f383"}.fa-forumbee:before{content:"\f211"}.fa-mizuni:before{content:"\f3cc"}.fa-schlix:before{content:"\f3ea"}.fa-square-xing:before,.fa-xing-square:before{content:"\f169"}.fa-bandcamp:before{content:"\f2d5"}.fa-wpforms:before{content:"\f298"}.fa-cloudversify:before{content:"\f385"}.fa-usps:before{content:"\f7e1"}.fa-megaport:before{content:"\f5a3"}.fa-magento:before{content:"\f3c4"}.fa-spotify:before{content:"\f1bc"}.fa-optin-monster:before{content:"\f23c"}.fa-fly:before{content:"\f417"}.fa-aviato:before{content:"\f421"}.fa-itunes:before{content:"\f3b4"}.fa-cuttlefish:before{content:"\f38c"}.fa-blogger:before{content:"\f37c"}.fa-flickr:before{content:"\f16e"}.fa-viber:before{content:"\f409"}.fa-soundcloud:before{content:"\f1be"}.fa-digg:before{content:"\f1a6"}.fa-tencent-weibo:before{content:"\f1d5"}.fa-letterboxd:before{content:"\e62d"}.fa-symfony:before{content:"\f83d"}.fa-maxcdn:before{content:"\f136"}.fa-etsy:before{content:"\f2d7"}.fa-facebook-messenger:before{content:"\f39f"}.fa-audible:before{content:"\f373"}.fa-think-peaks:before{content:"\f731"}.fa-bilibili:before{content:"\e3d9"}.fa-erlang:before{content:"\f39d"}.fa-x-twitter:before{content:"\e61b"}.fa-cotton-bureau:before{content:"\f89e"}.fa-dashcube:before{content:"\f210"}.fa-42-group:before,.fa-innosoft:before{content:"\e080"}.fa-stack-exchange:before{content:"\f18d"}.fa-elementor:before{content:"\f430"}.fa-pied-piper-square:before,.fa-square-pied-piper:before{content:"\e01e"}.fa-creative-commons-nd:before{content:"\f4eb"}.fa-palfed:before{content:"\f3d8"}.fa-superpowers:before{content:"\f2dd"}.fa-resolving:before{content:"\f3e7"}.fa-xbox:before{content:"\f412"}.fa-square-web-awesome-stroke:before{content:"\e684"}.fa-searchengin:before{content:"\f3eb"}.fa-tiktok:before{content:"\e07b"}.fa-facebook-square:before,.fa-square-facebook:before{content:"\f082"}.fa-renren:before{content:"\f18b"}.fa-linux:before{content:"\f17c"}.fa-glide:before{content:"\f2a5"}.fa-linkedin:before{content:"\f08c"}.fa-hubspot:before{content:"\f3b2"}.fa-deploydog:before{content:"\f38e"}.fa-twitch:before{content:"\f1e8"}.fa-ravelry:before{content:"\f2d9"}.fa-mixer:before{content:"\e056"}.fa-lastfm-square:before,.fa-square-lastfm:before{content:"\f203"}.fa-vimeo:before{content:"\f40a"}.fa-mendeley:before{content:"\f7b3"}.fa-uniregistry:before{content:"\f404"}.fa-figma:before{content:"\f799"}.fa-creative-commons-remix:before{content:"\f4ee"}.fa-cc-amazon-pay:before{content:"\f42d"}.fa-dropbox:before{content:"\f16b"}.fa-instagram:before{content:"\f16d"}.fa-cmplid:before{content:"\e360"}.fa-upwork:before{content:"\e641"}.fa-facebook:before{content:"\f09a"}.fa-gripfire:before{content:"\f3ac"}.fa-jedi-order:before{content:"\f50e"}.fa-uikit:before{content:"\f403"}.fa-fort-awesome-alt:before{content:"\f3a3"}.fa-phabricator:before{content:"\f3db"}.fa-ussunnah:before{content:"\f407"}.fa-earlybirds:before{content:"\f39a"}.fa-trade-federation:before{content:"\f513"}.fa-autoprefixer:before{content:"\f41c"}.fa-whatsapp:before{content:"\f232"}.fa-square-upwork:before{content:"\e67c"}.fa-slideshare:before{content:"\f1e7"}.fa-google-play:before{content:"\f3ab"}.fa-viadeo:before{content:"\f2a9"}.fa-line:before{content:"\f3c0"}.fa-google-drive:before{content:"\f3aa"}.fa-servicestack:before{content:"\f3ec"}.fa-simplybuilt:before{content:"\f215"}.fa-bitbucket:before{content:"\f171"}.fa-imdb:before{content:"\f2d8"}.fa-deezer:before{content:"\e077"}.fa-raspberry-pi:before{content:"\f7bb"}.fa-jira:before{content:"\f7b1"}.fa-docker:before{content:"\f395"}.fa-screenpal:before{content:"\e570"}.fa-bluetooth:before{content:"\f293"}.fa-gitter:before{content:"\f426"}.fa-d-and-d:before{content:"\f38d"}.fa-microblog:before{content:"\e01a"}.fa-cc-diners-club:before{content:"\f24c"}.fa-gg-circle:before{content:"\f261"}.fa-pied-piper-hat:before{content:"\f4e5"}.fa-kickstarter-k:before{content:"\f3bc"}.fa-yandex:before{content:"\f413"}.fa-readme:before{content:"\f4d5"}.fa-html5:before{content:"\f13b"}.fa-sellsy:before{content:"\f213"}.fa-square-web-awesome:before{content:"\e683"}.fa-sass:before{content:"\f41e"}.fa-wirsindhandwerk:before,.fa-wsh:before{content:"\e2d0"}.fa-buromobelexperte:before{content:"\f37f"}.fa-salesforce:before{content:"\f83b"}.fa-octopus-deploy:before{content:"\e082"}.fa-medapps:before{content:"\f3c6"}.fa-ns8:before{content:"\f3d5"}.fa-pinterest-p:before{content:"\f231"}.fa-apper:before{content:"\f371"}.fa-fort-awesome:before{content:"\f286"}.fa-waze:before{content:"\f83f"}.fa-bluesky:before{content:"\e671"}.fa-cc-jcb:before{content:"\f24b"}.fa-snapchat-ghost:before,.fa-snapchat:before{content:"\f2ab"}.fa-fantasy-flight-games:before{content:"\f6dc"}.fa-rust:before{content:"\e07a"}.fa-wix:before{content:"\f5cf"}.fa-behance-square:before,.fa-square-behance:before{content:"\f1b5"}.fa-supple:before{content:"\f3f9"}.fa-webflow:before{content:"\e65c"}.fa-rebel:before{content:"\f1d0"}.fa-css3:before{content:"\f13c"}.fa-staylinked:before{content:"\f3f5"}.fa-kaggle:before{content:"\f5fa"}.fa-space-awesome:before{content:"\e5ac"}.fa-deviantart:before{content:"\f1bd"}.fa-cpanel:before{content:"\f388"}.fa-goodreads-g:before{content:"\f3a9"}.fa-git-square:before,.fa-square-git:before{content:"\f1d2"}.fa-square-tumblr:before,.fa-tumblr-square:before{content:"\f174"}.fa-trello:before{content:"\f181"}.fa-creative-commons-nc-jp:before{content:"\f4ea"}.fa-get-pocket:before{content:"\f265"}.fa-perbyte:before{content:"\e083"}.fa-grunt:before{content:"\f3ad"}.fa-weebly:before{content:"\f5cc"}.fa-connectdevelop:before{content:"\f20e"}.fa-leanpub:before{content:"\f212"}.fa-black-tie:before{content:"\f27e"}.fa-themeco:before{content:"\f5c6"}.fa-python:before{content:"\f3e2"}.fa-android:before{content:"\f17b"}.fa-bots:before{content:"\e340"}.fa-free-code-camp:before{content:"\f2c5"}.fa-hornbill:before{content:"\f592"}.fa-js:before{content:"\f3b8"}.fa-ideal:before{content:"\e013"}.fa-git:before{content:"\f1d3"}.fa-dev:before{content:"\f6cc"}.fa-sketch:before{content:"\f7c6"}.fa-yandex-international:before{content:"\f414"}.fa-cc-amex:before{content:"\f1f3"}.fa-uber:before{content:"\f402"}.fa-github:before{content:"\f09b"}.fa-php:before{content:"\f457"}.fa-alipay:before{content:"\f642"}.fa-youtube:before{content:"\f167"}.fa-skyatlas:before{content:"\f216"}.fa-firefox-browser:before{content:"\e007"}.fa-replyd:before{content:"\f3e6"}.fa-suse:before{content:"\f7d6"}.fa-jenkins:before{content:"\f3b6"}.fa-twitter:before{content:"\f099"}.fa-rockrms:before{content:"\f3e9"}.fa-pinterest:before{content:"\f0d2"}.fa-buffer:before{content:"\f837"}.fa-npm:before{content:"\f3d4"}.fa-yammer:before{content:"\f840"}.fa-btc:before{content:"\f15a"}.fa-dribbble:before{content:"\f17d"}.fa-stumbleupon-circle:before{content:"\f1a3"}.fa-internet-explorer:before{content:"\f26b"}.fa-stubber:before{content:"\e5c7"}.fa-telegram-plane:before,.fa-telegram:before{content:"\f2c6"}.fa-old-republic:before{content:"\f510"}.fa-odysee:before{content:"\e5c6"}.fa-square-whatsapp:before,.fa-whatsapp-square:before{content:"\f40c"}.fa-node-js:before{content:"\f3d3"}.fa-edge-legacy:before{content:"\e078"}.fa-slack-hash:before,.fa-slack:before{content:"\f198"}.fa-medrt:before{content:"\f3c8"}.fa-usb:before{content:"\f287"}.fa-tumblr:before{content:"\f173"}.fa-vaadin:before{content:"\f408"}.fa-quora:before{content:"\f2c4"}.fa-square-x-twitter:before{content:"\e61a"}.fa-reacteurope:before{content:"\f75d"}.fa-medium-m:before,.fa-medium:before{content:"\f23a"}.fa-amilia:before{content:"\f36d"}.fa-mixcloud:before{content:"\f289"}.fa-flipboard:before{content:"\f44d"}.fa-viacoin:before{content:"\f237"}.fa-critical-role:before{content:"\f6c9"}.fa-sitrox:before{content:"\e44a"}.fa-discourse:before{content:"\f393"}.fa-joomla:before{content:"\f1aa"}.fa-mastodon:before{content:"\f4f6"}.fa-airbnb:before{content:"\f834"}.fa-wolf-pack-battalion:before{content:"\f514"}.fa-buy-n-large:before{content:"\f8a6"}.fa-gulp:before{content:"\f3ae"}.fa-creative-commons-sampling-plus:before{content:"\f4f1"}.fa-strava:before{content:"\f428"}.fa-ember:before{content:"\f423"}.fa-canadian-maple-leaf:before{content:"\f785"}.fa-teamspeak:before{content:"\f4f9"}.fa-pushed:before{content:"\f3e1"}.fa-wordpress-simple:before{content:"\f411"}.fa-nutritionix:before{content:"\f3d6"}.fa-wodu:before{content:"\e088"}.fa-google-pay:before{content:"\e079"}.fa-intercom:before{content:"\f7af"}.fa-zhihu:before{content:"\f63f"}.fa-korvue:before{content:"\f42f"}.fa-pix:before{content:"\e43a"}.fa-steam-symbol:before{content:"\f3f6"}:host,:root{--fa-font-regular:normal 400 1em/1 "Font Awesome 6 Free"}@font-face{font-family:"Font Awesome 6 Free";font-style:normal;font-weight:400;font-display:block;src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); }.fa-regular,.far{font-weight:400}:host,:root{--fa-style-family-classic:"Font Awesome 6 Free";--fa-font-solid:normal 900 1em/1 "Font Awesome 6 Free"}@font-face{font-family:"Font Awesome 6 Free";font-style:normal;font-weight:900;font-display:block;src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); }.fa-solid,.fas{font-weight:900}@font-face{font-family:"Font Awesome 5 Brands";font-display:block;font-weight:400;src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); }@font-face{font-family:"Font Awesome 5 Free";font-display:block;font-weight:900;src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); }@font-face{font-family:"Font Awesome 5 Free";font-display:block;font-weight:400;src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); }@font-face{font-family:"FontAwesome";font-display:block;src: url("../webfonts/fa-solid-900.woff2") format("woff2"), url("../webfonts/fa-solid-900.ttf") format("truetype"); }@font-face{font-family:"FontAwesome";font-display:block;src: url("../webfonts/fa-brands-400.woff2") format("woff2"), url("../webfonts/fa-brands-400.ttf") format("truetype"); }@font-face{font-family:"FontAwesome";font-display:block;src: url("../webfonts/fa-regular-400.woff2") format("woff2"), url("../webfonts/fa-regular-400.ttf") format("truetype"); }@font-face{font-family:"FontAwesome";font-display:block;src: url("../webfonts/fa-v4compatibility.woff2") format("woff2"), url("../webfonts/fa-v4compatibility.ttf") format("truetype"); } \ No newline at end of file diff --git a/docs/deps/font-awesome-6.5.2/css/v4-shims.css b/docs/deps/font-awesome-6.5.2/css/v4-shims.css new file mode 100644 index 00000000..ea60ea4d --- /dev/null +++ b/docs/deps/font-awesome-6.5.2/css/v4-shims.css @@ -0,0 +1,2194 @@ +/*! + * Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com + * License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) + * Copyright 2024 Fonticons, Inc. + */ +.fa.fa-glass:before { + content: "\f000"; } + +.fa.fa-envelope-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-envelope-o:before { + content: "\f0e0"; } + +.fa.fa-star-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-star-o:before { + content: "\f005"; } + +.fa.fa-remove:before { + content: "\f00d"; } + +.fa.fa-close:before { + content: "\f00d"; } + +.fa.fa-gear:before { + content: "\f013"; } + +.fa.fa-trash-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-trash-o:before { + content: "\f2ed"; } + +.fa.fa-home:before { + content: "\f015"; } + +.fa.fa-file-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-o:before { + content: "\f15b"; } + +.fa.fa-clock-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-clock-o:before { + content: "\f017"; } + +.fa.fa-arrow-circle-o-down { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-arrow-circle-o-down:before { + content: "\f358"; } + +.fa.fa-arrow-circle-o-up { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-arrow-circle-o-up:before { + content: "\f35b"; } + +.fa.fa-play-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-play-circle-o:before { + content: "\f144"; } + +.fa.fa-repeat:before { + content: "\f01e"; } + +.fa.fa-rotate-right:before { + content: "\f01e"; } + +.fa.fa-refresh:before { + content: "\f021"; } + +.fa.fa-list-alt { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-list-alt:before { + content: "\f022"; } + +.fa.fa-dedent:before { + content: "\f03b"; } + +.fa.fa-video-camera:before { + content: "\f03d"; } + +.fa.fa-picture-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-picture-o:before { + content: "\f03e"; } + +.fa.fa-photo { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-photo:before { + content: "\f03e"; } + +.fa.fa-image { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-image:before { + content: "\f03e"; } + +.fa.fa-map-marker:before { + content: "\f3c5"; } + +.fa.fa-pencil-square-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-pencil-square-o:before { + content: "\f044"; } + +.fa.fa-edit { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-edit:before { + content: "\f044"; } + +.fa.fa-share-square-o:before { + content: "\f14d"; } + +.fa.fa-check-square-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-check-square-o:before { + content: "\f14a"; } + +.fa.fa-arrows:before { + content: "\f0b2"; } + +.fa.fa-times-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-times-circle-o:before { + content: "\f057"; } + +.fa.fa-check-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-check-circle-o:before { + content: "\f058"; } + +.fa.fa-mail-forward:before { + content: "\f064"; } + +.fa.fa-expand:before { + content: "\f424"; } + +.fa.fa-compress:before { + content: "\f422"; } + +.fa.fa-eye { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-eye-slash { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-warning:before { + content: "\f071"; } + +.fa.fa-calendar:before { + content: "\f073"; } + +.fa.fa-arrows-v:before { + content: "\f338"; } + +.fa.fa-arrows-h:before { + content: "\f337"; } + +.fa.fa-bar-chart:before { + content: "\e0e3"; } + +.fa.fa-bar-chart-o:before { + content: "\e0e3"; } + +.fa.fa-twitter-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-twitter-square:before { + content: "\f081"; } + +.fa.fa-facebook-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-facebook-square:before { + content: "\f082"; } + +.fa.fa-gears:before { + content: "\f085"; } + +.fa.fa-thumbs-o-up { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-thumbs-o-up:before { + content: "\f164"; } + +.fa.fa-thumbs-o-down { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-thumbs-o-down:before { + content: "\f165"; } + +.fa.fa-heart-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-heart-o:before { + content: "\f004"; } + +.fa.fa-sign-out:before { + content: "\f2f5"; } + +.fa.fa-linkedin-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-linkedin-square:before { + content: "\f08c"; } + +.fa.fa-thumb-tack:before { + content: "\f08d"; } + +.fa.fa-external-link:before { + content: "\f35d"; } + +.fa.fa-sign-in:before { + content: "\f2f6"; } + +.fa.fa-github-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-github-square:before { + content: "\f092"; } + +.fa.fa-lemon-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-lemon-o:before { + content: "\f094"; } + +.fa.fa-square-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-square-o:before { + content: "\f0c8"; } + +.fa.fa-bookmark-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-bookmark-o:before { + content: "\f02e"; } + +.fa.fa-twitter { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-facebook { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-facebook:before { + content: "\f39e"; } + +.fa.fa-facebook-f { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-facebook-f:before { + content: "\f39e"; } + +.fa.fa-github { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-credit-card { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-feed:before { + content: "\f09e"; } + +.fa.fa-hdd-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hdd-o:before { + content: "\f0a0"; } + +.fa.fa-hand-o-right { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-o-right:before { + content: "\f0a4"; } + +.fa.fa-hand-o-left { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-o-left:before { + content: "\f0a5"; } + +.fa.fa-hand-o-up { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-o-up:before { + content: "\f0a6"; } + +.fa.fa-hand-o-down { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-o-down:before { + content: "\f0a7"; } + +.fa.fa-globe:before { + content: "\f57d"; } + +.fa.fa-tasks:before { + content: "\f828"; } + +.fa.fa-arrows-alt:before { + content: "\f31e"; } + +.fa.fa-group:before { + content: "\f0c0"; } + +.fa.fa-chain:before { + content: "\f0c1"; } + +.fa.fa-cut:before { + content: "\f0c4"; } + +.fa.fa-files-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-files-o:before { + content: "\f0c5"; } + +.fa.fa-floppy-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-floppy-o:before { + content: "\f0c7"; } + +.fa.fa-save { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-save:before { + content: "\f0c7"; } + +.fa.fa-navicon:before { + content: "\f0c9"; } + +.fa.fa-reorder:before { + content: "\f0c9"; } + +.fa.fa-magic:before { + content: "\e2ca"; } + +.fa.fa-pinterest { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pinterest-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pinterest-square:before { + content: "\f0d3"; } + +.fa.fa-google-plus-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-plus-square:before { + content: "\f0d4"; } + +.fa.fa-google-plus { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-plus:before { + content: "\f0d5"; } + +.fa.fa-money:before { + content: "\f3d1"; } + +.fa.fa-unsorted:before { + content: "\f0dc"; } + +.fa.fa-sort-desc:before { + content: "\f0dd"; } + +.fa.fa-sort-asc:before { + content: "\f0de"; } + +.fa.fa-linkedin { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-linkedin:before { + content: "\f0e1"; } + +.fa.fa-rotate-left:before { + content: "\f0e2"; } + +.fa.fa-legal:before { + content: "\f0e3"; } + +.fa.fa-tachometer:before { + content: "\f625"; } + +.fa.fa-dashboard:before { + content: "\f625"; } + +.fa.fa-comment-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-comment-o:before { + content: "\f075"; } + +.fa.fa-comments-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-comments-o:before { + content: "\f086"; } + +.fa.fa-flash:before { + content: "\f0e7"; } + +.fa.fa-clipboard:before { + content: "\f0ea"; } + +.fa.fa-lightbulb-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-lightbulb-o:before { + content: "\f0eb"; } + +.fa.fa-exchange:before { + content: "\f362"; } + +.fa.fa-cloud-download:before { + content: "\f0ed"; } + +.fa.fa-cloud-upload:before { + content: "\f0ee"; } + +.fa.fa-bell-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-bell-o:before { + content: "\f0f3"; } + +.fa.fa-cutlery:before { + content: "\f2e7"; } + +.fa.fa-file-text-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-text-o:before { + content: "\f15c"; } + +.fa.fa-building-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-building-o:before { + content: "\f1ad"; } + +.fa.fa-hospital-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hospital-o:before { + content: "\f0f8"; } + +.fa.fa-tablet:before { + content: "\f3fa"; } + +.fa.fa-mobile:before { + content: "\f3cd"; } + +.fa.fa-mobile-phone:before { + content: "\f3cd"; } + +.fa.fa-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-circle-o:before { + content: "\f111"; } + +.fa.fa-mail-reply:before { + content: "\f3e5"; } + +.fa.fa-github-alt { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-folder-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-folder-o:before { + content: "\f07b"; } + +.fa.fa-folder-open-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-folder-open-o:before { + content: "\f07c"; } + +.fa.fa-smile-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-smile-o:before { + content: "\f118"; } + +.fa.fa-frown-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-frown-o:before { + content: "\f119"; } + +.fa.fa-meh-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-meh-o:before { + content: "\f11a"; } + +.fa.fa-keyboard-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-keyboard-o:before { + content: "\f11c"; } + +.fa.fa-flag-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-flag-o:before { + content: "\f024"; } + +.fa.fa-mail-reply-all:before { + content: "\f122"; } + +.fa.fa-star-half-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-star-half-o:before { + content: "\f5c0"; } + +.fa.fa-star-half-empty { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-star-half-empty:before { + content: "\f5c0"; } + +.fa.fa-star-half-full { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-star-half-full:before { + content: "\f5c0"; } + +.fa.fa-code-fork:before { + content: "\f126"; } + +.fa.fa-chain-broken:before { + content: "\f127"; } + +.fa.fa-unlink:before { + content: "\f127"; } + +.fa.fa-calendar-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-calendar-o:before { + content: "\f133"; } + +.fa.fa-maxcdn { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-html5 { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-css3 { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-unlock-alt:before { + content: "\f09c"; } + +.fa.fa-minus-square-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-minus-square-o:before { + content: "\f146"; } + +.fa.fa-level-up:before { + content: "\f3bf"; } + +.fa.fa-level-down:before { + content: "\f3be"; } + +.fa.fa-pencil-square:before { + content: "\f14b"; } + +.fa.fa-external-link-square:before { + content: "\f360"; } + +.fa.fa-compass { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-caret-square-o-down { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-caret-square-o-down:before { + content: "\f150"; } + +.fa.fa-toggle-down { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-toggle-down:before { + content: "\f150"; } + +.fa.fa-caret-square-o-up { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-caret-square-o-up:before { + content: "\f151"; } + +.fa.fa-toggle-up { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-toggle-up:before { + content: "\f151"; } + +.fa.fa-caret-square-o-right { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-caret-square-o-right:before { + content: "\f152"; } + +.fa.fa-toggle-right { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-toggle-right:before { + content: "\f152"; } + +.fa.fa-eur:before { + content: "\f153"; } + +.fa.fa-euro:before { + content: "\f153"; } + +.fa.fa-gbp:before { + content: "\f154"; } + +.fa.fa-usd:before { + content: "\24"; } + +.fa.fa-dollar:before { + content: "\24"; } + +.fa.fa-inr:before { + content: "\e1bc"; } + +.fa.fa-rupee:before { + content: "\e1bc"; } + +.fa.fa-jpy:before { + content: "\f157"; } + +.fa.fa-cny:before { + content: "\f157"; } + +.fa.fa-rmb:before { + content: "\f157"; } + +.fa.fa-yen:before { + content: "\f157"; } + +.fa.fa-rub:before { + content: "\f158"; } + +.fa.fa-ruble:before { + content: "\f158"; } + +.fa.fa-rouble:before { + content: "\f158"; } + +.fa.fa-krw:before { + content: "\f159"; } + +.fa.fa-won:before { + content: "\f159"; } + +.fa.fa-btc { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bitcoin { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bitcoin:before { + content: "\f15a"; } + +.fa.fa-file-text:before { + content: "\f15c"; } + +.fa.fa-sort-alpha-asc:before { + content: "\f15d"; } + +.fa.fa-sort-alpha-desc:before { + content: "\f881"; } + +.fa.fa-sort-amount-asc:before { + content: "\f884"; } + +.fa.fa-sort-amount-desc:before { + content: "\f160"; } + +.fa.fa-sort-numeric-asc:before { + content: "\f162"; } + +.fa.fa-sort-numeric-desc:before { + content: "\f886"; } + +.fa.fa-youtube-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-youtube-square:before { + content: "\f431"; } + +.fa.fa-youtube { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-xing { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-xing-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-xing-square:before { + content: "\f169"; } + +.fa.fa-youtube-play { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-youtube-play:before { + content: "\f167"; } + +.fa.fa-dropbox { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-stack-overflow { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-instagram { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-flickr { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-adn { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bitbucket { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bitbucket-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bitbucket-square:before { + content: "\f171"; } + +.fa.fa-tumblr { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-tumblr-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-tumblr-square:before { + content: "\f174"; } + +.fa.fa-long-arrow-down:before { + content: "\f309"; } + +.fa.fa-long-arrow-up:before { + content: "\f30c"; } + +.fa.fa-long-arrow-left:before { + content: "\f30a"; } + +.fa.fa-long-arrow-right:before { + content: "\f30b"; } + +.fa.fa-apple { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-windows { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-android { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-linux { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-dribbble { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-skype { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-foursquare { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-trello { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gratipay { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gittip { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gittip:before { + content: "\f184"; } + +.fa.fa-sun-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-sun-o:before { + content: "\f185"; } + +.fa.fa-moon-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-moon-o:before { + content: "\f186"; } + +.fa.fa-vk { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-weibo { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-renren { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pagelines { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-stack-exchange { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-arrow-circle-o-right { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-arrow-circle-o-right:before { + content: "\f35a"; } + +.fa.fa-arrow-circle-o-left { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-arrow-circle-o-left:before { + content: "\f359"; } + +.fa.fa-caret-square-o-left { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-caret-square-o-left:before { + content: "\f191"; } + +.fa.fa-toggle-left { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-toggle-left:before { + content: "\f191"; } + +.fa.fa-dot-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-dot-circle-o:before { + content: "\f192"; } + +.fa.fa-vimeo-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-vimeo-square:before { + content: "\f194"; } + +.fa.fa-try:before { + content: "\e2bb"; } + +.fa.fa-turkish-lira:before { + content: "\e2bb"; } + +.fa.fa-plus-square-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-plus-square-o:before { + content: "\f0fe"; } + +.fa.fa-slack { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wordpress { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-openid { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-institution:before { + content: "\f19c"; } + +.fa.fa-bank:before { + content: "\f19c"; } + +.fa.fa-mortar-board:before { + content: "\f19d"; } + +.fa.fa-yahoo { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-reddit { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-reddit-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-reddit-square:before { + content: "\f1a2"; } + +.fa.fa-stumbleupon-circle { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-stumbleupon { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-delicious { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-digg { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pied-piper-pp { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pied-piper-alt { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-drupal { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-joomla { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-behance { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-behance-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-behance-square:before { + content: "\f1b5"; } + +.fa.fa-steam { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-steam-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-steam-square:before { + content: "\f1b7"; } + +.fa.fa-automobile:before { + content: "\f1b9"; } + +.fa.fa-cab:before { + content: "\f1ba"; } + +.fa.fa-spotify { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-deviantart { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-soundcloud { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-file-pdf-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-pdf-o:before { + content: "\f1c1"; } + +.fa.fa-file-word-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-word-o:before { + content: "\f1c2"; } + +.fa.fa-file-excel-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-excel-o:before { + content: "\f1c3"; } + +.fa.fa-file-powerpoint-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-powerpoint-o:before { + content: "\f1c4"; } + +.fa.fa-file-image-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-image-o:before { + content: "\f1c5"; } + +.fa.fa-file-photo-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-photo-o:before { + content: "\f1c5"; } + +.fa.fa-file-picture-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-picture-o:before { + content: "\f1c5"; } + +.fa.fa-file-archive-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-archive-o:before { + content: "\f1c6"; } + +.fa.fa-file-zip-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-zip-o:before { + content: "\f1c6"; } + +.fa.fa-file-audio-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-audio-o:before { + content: "\f1c7"; } + +.fa.fa-file-sound-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-sound-o:before { + content: "\f1c7"; } + +.fa.fa-file-video-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-video-o:before { + content: "\f1c8"; } + +.fa.fa-file-movie-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-movie-o:before { + content: "\f1c8"; } + +.fa.fa-file-code-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-file-code-o:before { + content: "\f1c9"; } + +.fa.fa-vine { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-codepen { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-jsfiddle { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-life-bouy:before { + content: "\f1cd"; } + +.fa.fa-life-buoy:before { + content: "\f1cd"; } + +.fa.fa-life-saver:before { + content: "\f1cd"; } + +.fa.fa-support:before { + content: "\f1cd"; } + +.fa.fa-circle-o-notch:before { + content: "\f1ce"; } + +.fa.fa-rebel { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-ra { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-ra:before { + content: "\f1d0"; } + +.fa.fa-resistance { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-resistance:before { + content: "\f1d0"; } + +.fa.fa-empire { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-ge { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-ge:before { + content: "\f1d1"; } + +.fa.fa-git-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-git-square:before { + content: "\f1d2"; } + +.fa.fa-git { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-hacker-news { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-y-combinator-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-y-combinator-square:before { + content: "\f1d4"; } + +.fa.fa-yc-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-yc-square:before { + content: "\f1d4"; } + +.fa.fa-tencent-weibo { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-qq { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-weixin { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wechat { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wechat:before { + content: "\f1d7"; } + +.fa.fa-send:before { + content: "\f1d8"; } + +.fa.fa-paper-plane-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-paper-plane-o:before { + content: "\f1d8"; } + +.fa.fa-send-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-send-o:before { + content: "\f1d8"; } + +.fa.fa-circle-thin { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-circle-thin:before { + content: "\f111"; } + +.fa.fa-header:before { + content: "\f1dc"; } + +.fa.fa-futbol-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-futbol-o:before { + content: "\f1e3"; } + +.fa.fa-soccer-ball-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-soccer-ball-o:before { + content: "\f1e3"; } + +.fa.fa-slideshare { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-twitch { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-yelp { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-newspaper-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-newspaper-o:before { + content: "\f1ea"; } + +.fa.fa-paypal { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-wallet { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-visa { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-mastercard { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-discover { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-amex { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-paypal { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-stripe { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bell-slash-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-bell-slash-o:before { + content: "\f1f6"; } + +.fa.fa-trash:before { + content: "\f2ed"; } + +.fa.fa-copyright { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-eyedropper:before { + content: "\f1fb"; } + +.fa.fa-area-chart:before { + content: "\f1fe"; } + +.fa.fa-pie-chart:before { + content: "\f200"; } + +.fa.fa-line-chart:before { + content: "\f201"; } + +.fa.fa-lastfm { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-lastfm-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-lastfm-square:before { + content: "\f203"; } + +.fa.fa-ioxhost { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-angellist { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-cc:before { + content: "\f20a"; } + +.fa.fa-ils:before { + content: "\f20b"; } + +.fa.fa-shekel:before { + content: "\f20b"; } + +.fa.fa-sheqel:before { + content: "\f20b"; } + +.fa.fa-buysellads { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-connectdevelop { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-dashcube { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-forumbee { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-leanpub { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-sellsy { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-shirtsinbulk { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-simplybuilt { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-skyatlas { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-diamond { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-diamond:before { + content: "\f3a5"; } + +.fa.fa-transgender:before { + content: "\f224"; } + +.fa.fa-intersex:before { + content: "\f224"; } + +.fa.fa-transgender-alt:before { + content: "\f225"; } + +.fa.fa-facebook-official { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-facebook-official:before { + content: "\f09a"; } + +.fa.fa-pinterest-p { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-whatsapp { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-hotel:before { + content: "\f236"; } + +.fa.fa-viacoin { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-medium { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-y-combinator { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-yc { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-yc:before { + content: "\f23b"; } + +.fa.fa-optin-monster { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-opencart { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-expeditedssl { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-battery-4:before { + content: "\f240"; } + +.fa.fa-battery:before { + content: "\f240"; } + +.fa.fa-battery-3:before { + content: "\f241"; } + +.fa.fa-battery-2:before { + content: "\f242"; } + +.fa.fa-battery-1:before { + content: "\f243"; } + +.fa.fa-battery-0:before { + content: "\f244"; } + +.fa.fa-object-group { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-object-ungroup { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-sticky-note-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-sticky-note-o:before { + content: "\f249"; } + +.fa.fa-cc-jcb { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-cc-diners-club { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-clone { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hourglass-o:before { + content: "\f254"; } + +.fa.fa-hourglass-1:before { + content: "\f251"; } + +.fa.fa-hourglass-2:before { + content: "\f252"; } + +.fa.fa-hourglass-3:before { + content: "\f253"; } + +.fa.fa-hand-rock-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-rock-o:before { + content: "\f255"; } + +.fa.fa-hand-grab-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-grab-o:before { + content: "\f255"; } + +.fa.fa-hand-paper-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-paper-o:before { + content: "\f256"; } + +.fa.fa-hand-stop-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-stop-o:before { + content: "\f256"; } + +.fa.fa-hand-scissors-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-scissors-o:before { + content: "\f257"; } + +.fa.fa-hand-lizard-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-lizard-o:before { + content: "\f258"; } + +.fa.fa-hand-spock-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-spock-o:before { + content: "\f259"; } + +.fa.fa-hand-pointer-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-pointer-o:before { + content: "\f25a"; } + +.fa.fa-hand-peace-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-hand-peace-o:before { + content: "\f25b"; } + +.fa.fa-registered { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-creative-commons { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gg { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gg-circle { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-odnoklassniki { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-odnoklassniki-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-odnoklassniki-square:before { + content: "\f264"; } + +.fa.fa-get-pocket { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wikipedia-w { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-safari { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-chrome { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-firefox { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-opera { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-internet-explorer { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-television:before { + content: "\f26c"; } + +.fa.fa-contao { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-500px { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-amazon { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-calendar-plus-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-calendar-plus-o:before { + content: "\f271"; } + +.fa.fa-calendar-minus-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-calendar-minus-o:before { + content: "\f272"; } + +.fa.fa-calendar-times-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-calendar-times-o:before { + content: "\f273"; } + +.fa.fa-calendar-check-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-calendar-check-o:before { + content: "\f274"; } + +.fa.fa-map-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-map-o:before { + content: "\f279"; } + +.fa.fa-commenting:before { + content: "\f4ad"; } + +.fa.fa-commenting-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-commenting-o:before { + content: "\f4ad"; } + +.fa.fa-houzz { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-vimeo { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-vimeo:before { + content: "\f27d"; } + +.fa.fa-black-tie { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-fonticons { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-reddit-alien { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-edge { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-credit-card-alt:before { + content: "\f09d"; } + +.fa.fa-codiepie { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-modx { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-fort-awesome { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-usb { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-product-hunt { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-mixcloud { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-scribd { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-pause-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-pause-circle-o:before { + content: "\f28b"; } + +.fa.fa-stop-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-stop-circle-o:before { + content: "\f28d"; } + +.fa.fa-bluetooth { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-bluetooth-b { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-gitlab { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wpbeginner { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wpforms { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-envira { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wheelchair-alt { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wheelchair-alt:before { + content: "\f368"; } + +.fa.fa-question-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-question-circle-o:before { + content: "\f059"; } + +.fa.fa-volume-control-phone:before { + content: "\f2a0"; } + +.fa.fa-asl-interpreting:before { + content: "\f2a3"; } + +.fa.fa-deafness:before { + content: "\f2a4"; } + +.fa.fa-hard-of-hearing:before { + content: "\f2a4"; } + +.fa.fa-glide { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-glide-g { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-signing:before { + content: "\f2a7"; } + +.fa.fa-viadeo { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-viadeo-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-viadeo-square:before { + content: "\f2aa"; } + +.fa.fa-snapchat { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-snapchat-ghost { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-snapchat-ghost:before { + content: "\f2ab"; } + +.fa.fa-snapchat-square { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-snapchat-square:before { + content: "\f2ad"; } + +.fa.fa-pied-piper { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-first-order { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-yoast { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-themeisle { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-plus-official { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-plus-official:before { + content: "\f2b3"; } + +.fa.fa-google-plus-circle { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-google-plus-circle:before { + content: "\f2b3"; } + +.fa.fa-font-awesome { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-fa { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-fa:before { + content: "\f2b4"; } + +.fa.fa-handshake-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-handshake-o:before { + content: "\f2b5"; } + +.fa.fa-envelope-open-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-envelope-open-o:before { + content: "\f2b6"; } + +.fa.fa-linode { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-address-book-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-address-book-o:before { + content: "\f2b9"; } + +.fa.fa-vcard:before { + content: "\f2bb"; } + +.fa.fa-address-card-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-address-card-o:before { + content: "\f2bb"; } + +.fa.fa-vcard-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-vcard-o:before { + content: "\f2bb"; } + +.fa.fa-user-circle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-user-circle-o:before { + content: "\f2bd"; } + +.fa.fa-user-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-user-o:before { + content: "\f007"; } + +.fa.fa-id-badge { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-drivers-license:before { + content: "\f2c2"; } + +.fa.fa-id-card-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-id-card-o:before { + content: "\f2c2"; } + +.fa.fa-drivers-license-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-drivers-license-o:before { + content: "\f2c2"; } + +.fa.fa-quora { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-free-code-camp { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-telegram { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-thermometer-4:before { + content: "\f2c7"; } + +.fa.fa-thermometer:before { + content: "\f2c7"; } + +.fa.fa-thermometer-3:before { + content: "\f2c8"; } + +.fa.fa-thermometer-2:before { + content: "\f2c9"; } + +.fa.fa-thermometer-1:before { + content: "\f2ca"; } + +.fa.fa-thermometer-0:before { + content: "\f2cb"; } + +.fa.fa-bathtub:before { + content: "\f2cd"; } + +.fa.fa-s15:before { + content: "\f2cd"; } + +.fa.fa-window-maximize { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-window-restore { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-times-rectangle:before { + content: "\f410"; } + +.fa.fa-window-close-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-window-close-o:before { + content: "\f410"; } + +.fa.fa-times-rectangle-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-times-rectangle-o:before { + content: "\f410"; } + +.fa.fa-bandcamp { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-grav { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-etsy { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-imdb { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-ravelry { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-eercast { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-eercast:before { + content: "\f2da"; } + +.fa.fa-snowflake-o { + font-family: 'Font Awesome 6 Free'; + font-weight: 400; } + +.fa.fa-snowflake-o:before { + content: "\f2dc"; } + +.fa.fa-superpowers { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-wpexplorer { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } + +.fa.fa-meetup { + font-family: 'Font Awesome 6 Brands'; + font-weight: 400; } diff --git a/docs/deps/font-awesome-6.5.2/css/v4-shims.min.css b/docs/deps/font-awesome-6.5.2/css/v4-shims.min.css new file mode 100644 index 00000000..09baf5fc --- /dev/null +++ b/docs/deps/font-awesome-6.5.2/css/v4-shims.min.css @@ -0,0 +1,6 @@ +/*! + * Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com + * License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) + * Copyright 2024 Fonticons, Inc. + */ +.fa.fa-glass:before{content:"\f000"}.fa.fa-envelope-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-envelope-o:before{content:"\f0e0"}.fa.fa-star-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-star-o:before{content:"\f005"}.fa.fa-close:before,.fa.fa-remove:before{content:"\f00d"}.fa.fa-gear:before{content:"\f013"}.fa.fa-trash-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-trash-o:before{content:"\f2ed"}.fa.fa-home:before{content:"\f015"}.fa.fa-file-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-o:before{content:"\f15b"}.fa.fa-clock-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-clock-o:before{content:"\f017"}.fa.fa-arrow-circle-o-down{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-arrow-circle-o-down:before{content:"\f358"}.fa.fa-arrow-circle-o-up{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-arrow-circle-o-up:before{content:"\f35b"}.fa.fa-play-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-play-circle-o:before{content:"\f144"}.fa.fa-repeat:before,.fa.fa-rotate-right:before{content:"\f01e"}.fa.fa-refresh:before{content:"\f021"}.fa.fa-list-alt{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-list-alt:before{content:"\f022"}.fa.fa-dedent:before{content:"\f03b"}.fa.fa-video-camera:before{content:"\f03d"}.fa.fa-picture-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-picture-o:before{content:"\f03e"}.fa.fa-photo{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-photo:before{content:"\f03e"}.fa.fa-image{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-image:before{content:"\f03e"}.fa.fa-map-marker:before{content:"\f3c5"}.fa.fa-pencil-square-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-pencil-square-o:before{content:"\f044"}.fa.fa-edit{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-edit:before{content:"\f044"}.fa.fa-share-square-o:before{content:"\f14d"}.fa.fa-check-square-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-check-square-o:before{content:"\f14a"}.fa.fa-arrows:before{content:"\f0b2"}.fa.fa-times-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-times-circle-o:before{content:"\f057"}.fa.fa-check-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-check-circle-o:before{content:"\f058"}.fa.fa-mail-forward:before{content:"\f064"}.fa.fa-expand:before{content:"\f424"}.fa.fa-compress:before{content:"\f422"}.fa.fa-eye,.fa.fa-eye-slash{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-warning:before{content:"\f071"}.fa.fa-calendar:before{content:"\f073"}.fa.fa-arrows-v:before{content:"\f338"}.fa.fa-arrows-h:before{content:"\f337"}.fa.fa-bar-chart-o:before,.fa.fa-bar-chart:before{content:"\e0e3"}.fa.fa-twitter-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-twitter-square:before{content:"\f081"}.fa.fa-facebook-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-facebook-square:before{content:"\f082"}.fa.fa-gears:before{content:"\f085"}.fa.fa-thumbs-o-up{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-thumbs-o-up:before{content:"\f164"}.fa.fa-thumbs-o-down{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-thumbs-o-down:before{content:"\f165"}.fa.fa-heart-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-heart-o:before{content:"\f004"}.fa.fa-sign-out:before{content:"\f2f5"}.fa.fa-linkedin-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-linkedin-square:before{content:"\f08c"}.fa.fa-thumb-tack:before{content:"\f08d"}.fa.fa-external-link:before{content:"\f35d"}.fa.fa-sign-in:before{content:"\f2f6"}.fa.fa-github-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-github-square:before{content:"\f092"}.fa.fa-lemon-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-lemon-o:before{content:"\f094"}.fa.fa-square-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-square-o:before{content:"\f0c8"}.fa.fa-bookmark-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-bookmark-o:before{content:"\f02e"}.fa.fa-facebook,.fa.fa-twitter{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-facebook:before{content:"\f39e"}.fa.fa-facebook-f{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-facebook-f:before{content:"\f39e"}.fa.fa-github{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-credit-card{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-feed:before{content:"\f09e"}.fa.fa-hdd-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hdd-o:before{content:"\f0a0"}.fa.fa-hand-o-right{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-o-right:before{content:"\f0a4"}.fa.fa-hand-o-left{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-o-left:before{content:"\f0a5"}.fa.fa-hand-o-up{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-o-up:before{content:"\f0a6"}.fa.fa-hand-o-down{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-o-down:before{content:"\f0a7"}.fa.fa-globe:before{content:"\f57d"}.fa.fa-tasks:before{content:"\f828"}.fa.fa-arrows-alt:before{content:"\f31e"}.fa.fa-group:before{content:"\f0c0"}.fa.fa-chain:before{content:"\f0c1"}.fa.fa-cut:before{content:"\f0c4"}.fa.fa-files-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-files-o:before{content:"\f0c5"}.fa.fa-floppy-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-floppy-o:before{content:"\f0c7"}.fa.fa-save{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-save:before{content:"\f0c7"}.fa.fa-navicon:before,.fa.fa-reorder:before{content:"\f0c9"}.fa.fa-magic:before{content:"\e2ca"}.fa.fa-pinterest,.fa.fa-pinterest-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-pinterest-square:before{content:"\f0d3"}.fa.fa-google-plus-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-google-plus-square:before{content:"\f0d4"}.fa.fa-google-plus{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-google-plus:before{content:"\f0d5"}.fa.fa-money:before{content:"\f3d1"}.fa.fa-unsorted:before{content:"\f0dc"}.fa.fa-sort-desc:before{content:"\f0dd"}.fa.fa-sort-asc:before{content:"\f0de"}.fa.fa-linkedin{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-linkedin:before{content:"\f0e1"}.fa.fa-rotate-left:before{content:"\f0e2"}.fa.fa-legal:before{content:"\f0e3"}.fa.fa-dashboard:before,.fa.fa-tachometer:before{content:"\f625"}.fa.fa-comment-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-comment-o:before{content:"\f075"}.fa.fa-comments-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-comments-o:before{content:"\f086"}.fa.fa-flash:before{content:"\f0e7"}.fa.fa-clipboard:before{content:"\f0ea"}.fa.fa-lightbulb-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-lightbulb-o:before{content:"\f0eb"}.fa.fa-exchange:before{content:"\f362"}.fa.fa-cloud-download:before{content:"\f0ed"}.fa.fa-cloud-upload:before{content:"\f0ee"}.fa.fa-bell-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-bell-o:before{content:"\f0f3"}.fa.fa-cutlery:before{content:"\f2e7"}.fa.fa-file-text-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-text-o:before{content:"\f15c"}.fa.fa-building-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-building-o:before{content:"\f1ad"}.fa.fa-hospital-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hospital-o:before{content:"\f0f8"}.fa.fa-tablet:before{content:"\f3fa"}.fa.fa-mobile-phone:before,.fa.fa-mobile:before{content:"\f3cd"}.fa.fa-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-circle-o:before{content:"\f111"}.fa.fa-mail-reply:before{content:"\f3e5"}.fa.fa-github-alt{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-folder-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-folder-o:before{content:"\f07b"}.fa.fa-folder-open-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-folder-open-o:before{content:"\f07c"}.fa.fa-smile-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-smile-o:before{content:"\f118"}.fa.fa-frown-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-frown-o:before{content:"\f119"}.fa.fa-meh-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-meh-o:before{content:"\f11a"}.fa.fa-keyboard-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-keyboard-o:before{content:"\f11c"}.fa.fa-flag-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-flag-o:before{content:"\f024"}.fa.fa-mail-reply-all:before{content:"\f122"}.fa.fa-star-half-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-star-half-o:before{content:"\f5c0"}.fa.fa-star-half-empty{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-star-half-empty:before{content:"\f5c0"}.fa.fa-star-half-full{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-star-half-full:before{content:"\f5c0"}.fa.fa-code-fork:before{content:"\f126"}.fa.fa-chain-broken:before,.fa.fa-unlink:before{content:"\f127"}.fa.fa-calendar-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-calendar-o:before{content:"\f133"}.fa.fa-css3,.fa.fa-html5,.fa.fa-maxcdn{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-unlock-alt:before{content:"\f09c"}.fa.fa-minus-square-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-minus-square-o:before{content:"\f146"}.fa.fa-level-up:before{content:"\f3bf"}.fa.fa-level-down:before{content:"\f3be"}.fa.fa-pencil-square:before{content:"\f14b"}.fa.fa-external-link-square:before{content:"\f360"}.fa.fa-compass{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-caret-square-o-down{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-caret-square-o-down:before{content:"\f150"}.fa.fa-toggle-down{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-toggle-down:before{content:"\f150"}.fa.fa-caret-square-o-up{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-caret-square-o-up:before{content:"\f151"}.fa.fa-toggle-up{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-toggle-up:before{content:"\f151"}.fa.fa-caret-square-o-right{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-caret-square-o-right:before{content:"\f152"}.fa.fa-toggle-right{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-toggle-right:before{content:"\f152"}.fa.fa-eur:before,.fa.fa-euro:before{content:"\f153"}.fa.fa-gbp:before{content:"\f154"}.fa.fa-dollar:before,.fa.fa-usd:before{content:"\24"}.fa.fa-inr:before,.fa.fa-rupee:before{content:"\e1bc"}.fa.fa-cny:before,.fa.fa-jpy:before,.fa.fa-rmb:before,.fa.fa-yen:before{content:"\f157"}.fa.fa-rouble:before,.fa.fa-rub:before,.fa.fa-ruble:before{content:"\f158"}.fa.fa-krw:before,.fa.fa-won:before{content:"\f159"}.fa.fa-bitcoin,.fa.fa-btc{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-bitcoin:before{content:"\f15a"}.fa.fa-file-text:before{content:"\f15c"}.fa.fa-sort-alpha-asc:before{content:"\f15d"}.fa.fa-sort-alpha-desc:before{content:"\f881"}.fa.fa-sort-amount-asc:before{content:"\f884"}.fa.fa-sort-amount-desc:before{content:"\f160"}.fa.fa-sort-numeric-asc:before{content:"\f162"}.fa.fa-sort-numeric-desc:before{content:"\f886"}.fa.fa-youtube-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-youtube-square:before{content:"\f431"}.fa.fa-xing,.fa.fa-xing-square,.fa.fa-youtube{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-xing-square:before{content:"\f169"}.fa.fa-youtube-play{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-youtube-play:before{content:"\f167"}.fa.fa-adn,.fa.fa-bitbucket,.fa.fa-bitbucket-square,.fa.fa-dropbox,.fa.fa-flickr,.fa.fa-instagram,.fa.fa-stack-overflow{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-bitbucket-square:before{content:"\f171"}.fa.fa-tumblr,.fa.fa-tumblr-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-tumblr-square:before{content:"\f174"}.fa.fa-long-arrow-down:before{content:"\f309"}.fa.fa-long-arrow-up:before{content:"\f30c"}.fa.fa-long-arrow-left:before{content:"\f30a"}.fa.fa-long-arrow-right:before{content:"\f30b"}.fa.fa-android,.fa.fa-apple,.fa.fa-dribbble,.fa.fa-foursquare,.fa.fa-gittip,.fa.fa-gratipay,.fa.fa-linux,.fa.fa-skype,.fa.fa-trello,.fa.fa-windows{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-gittip:before{content:"\f184"}.fa.fa-sun-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-sun-o:before{content:"\f185"}.fa.fa-moon-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-moon-o:before{content:"\f186"}.fa.fa-pagelines,.fa.fa-renren,.fa.fa-stack-exchange,.fa.fa-vk,.fa.fa-weibo{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-arrow-circle-o-right{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-arrow-circle-o-right:before{content:"\f35a"}.fa.fa-arrow-circle-o-left{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-arrow-circle-o-left:before{content:"\f359"}.fa.fa-caret-square-o-left{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-caret-square-o-left:before{content:"\f191"}.fa.fa-toggle-left{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-toggle-left:before{content:"\f191"}.fa.fa-dot-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-dot-circle-o:before{content:"\f192"}.fa.fa-vimeo-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-vimeo-square:before{content:"\f194"}.fa.fa-try:before,.fa.fa-turkish-lira:before{content:"\e2bb"}.fa.fa-plus-square-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-plus-square-o:before{content:"\f0fe"}.fa.fa-openid,.fa.fa-slack,.fa.fa-wordpress{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-bank:before,.fa.fa-institution:before{content:"\f19c"}.fa.fa-mortar-board:before{content:"\f19d"}.fa.fa-google,.fa.fa-reddit,.fa.fa-reddit-square,.fa.fa-yahoo{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-reddit-square:before{content:"\f1a2"}.fa.fa-behance,.fa.fa-behance-square,.fa.fa-delicious,.fa.fa-digg,.fa.fa-drupal,.fa.fa-joomla,.fa.fa-pied-piper-alt,.fa.fa-pied-piper-pp,.fa.fa-stumbleupon,.fa.fa-stumbleupon-circle{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-behance-square:before{content:"\f1b5"}.fa.fa-steam,.fa.fa-steam-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-steam-square:before{content:"\f1b7"}.fa.fa-automobile:before{content:"\f1b9"}.fa.fa-cab:before{content:"\f1ba"}.fa.fa-deviantart,.fa.fa-soundcloud,.fa.fa-spotify{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-file-pdf-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-pdf-o:before{content:"\f1c1"}.fa.fa-file-word-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-word-o:before{content:"\f1c2"}.fa.fa-file-excel-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-excel-o:before{content:"\f1c3"}.fa.fa-file-powerpoint-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-powerpoint-o:before{content:"\f1c4"}.fa.fa-file-image-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-image-o:before{content:"\f1c5"}.fa.fa-file-photo-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-photo-o:before{content:"\f1c5"}.fa.fa-file-picture-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-picture-o:before{content:"\f1c5"}.fa.fa-file-archive-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-archive-o:before{content:"\f1c6"}.fa.fa-file-zip-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-zip-o:before{content:"\f1c6"}.fa.fa-file-audio-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-audio-o:before{content:"\f1c7"}.fa.fa-file-sound-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-sound-o:before{content:"\f1c7"}.fa.fa-file-video-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-video-o:before{content:"\f1c8"}.fa.fa-file-movie-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-movie-o:before{content:"\f1c8"}.fa.fa-file-code-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-file-code-o:before{content:"\f1c9"}.fa.fa-codepen,.fa.fa-jsfiddle,.fa.fa-vine{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-life-bouy:before,.fa.fa-life-buoy:before,.fa.fa-life-saver:before,.fa.fa-support:before{content:"\f1cd"}.fa.fa-circle-o-notch:before{content:"\f1ce"}.fa.fa-ra,.fa.fa-rebel{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-ra:before{content:"\f1d0"}.fa.fa-resistance{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-resistance:before{content:"\f1d0"}.fa.fa-empire,.fa.fa-ge{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-ge:before{content:"\f1d1"}.fa.fa-git-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-git-square:before{content:"\f1d2"}.fa.fa-git,.fa.fa-hacker-news,.fa.fa-y-combinator-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-y-combinator-square:before{content:"\f1d4"}.fa.fa-yc-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-yc-square:before{content:"\f1d4"}.fa.fa-qq,.fa.fa-tencent-weibo,.fa.fa-wechat,.fa.fa-weixin{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-wechat:before{content:"\f1d7"}.fa.fa-send:before{content:"\f1d8"}.fa.fa-paper-plane-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-paper-plane-o:before{content:"\f1d8"}.fa.fa-send-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-send-o:before{content:"\f1d8"}.fa.fa-circle-thin{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-circle-thin:before{content:"\f111"}.fa.fa-header:before{content:"\f1dc"}.fa.fa-futbol-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-futbol-o:before{content:"\f1e3"}.fa.fa-soccer-ball-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-soccer-ball-o:before{content:"\f1e3"}.fa.fa-slideshare,.fa.fa-twitch,.fa.fa-yelp{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-newspaper-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-newspaper-o:before{content:"\f1ea"}.fa.fa-cc-amex,.fa.fa-cc-discover,.fa.fa-cc-mastercard,.fa.fa-cc-paypal,.fa.fa-cc-stripe,.fa.fa-cc-visa,.fa.fa-google-wallet,.fa.fa-paypal{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-bell-slash-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-bell-slash-o:before{content:"\f1f6"}.fa.fa-trash:before{content:"\f2ed"}.fa.fa-copyright{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-eyedropper:before{content:"\f1fb"}.fa.fa-area-chart:before{content:"\f1fe"}.fa.fa-pie-chart:before{content:"\f200"}.fa.fa-line-chart:before{content:"\f201"}.fa.fa-lastfm,.fa.fa-lastfm-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-lastfm-square:before{content:"\f203"}.fa.fa-angellist,.fa.fa-ioxhost{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-cc{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-cc:before{content:"\f20a"}.fa.fa-ils:before,.fa.fa-shekel:before,.fa.fa-sheqel:before{content:"\f20b"}.fa.fa-buysellads,.fa.fa-connectdevelop,.fa.fa-dashcube,.fa.fa-forumbee,.fa.fa-leanpub,.fa.fa-sellsy,.fa.fa-shirtsinbulk,.fa.fa-simplybuilt,.fa.fa-skyatlas{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-diamond{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-diamond:before{content:"\f3a5"}.fa.fa-intersex:before,.fa.fa-transgender:before{content:"\f224"}.fa.fa-transgender-alt:before{content:"\f225"}.fa.fa-facebook-official{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-facebook-official:before{content:"\f09a"}.fa.fa-pinterest-p,.fa.fa-whatsapp{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-hotel:before{content:"\f236"}.fa.fa-medium,.fa.fa-viacoin,.fa.fa-y-combinator,.fa.fa-yc{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-yc:before{content:"\f23b"}.fa.fa-expeditedssl,.fa.fa-opencart,.fa.fa-optin-monster{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-battery-4:before,.fa.fa-battery:before{content:"\f240"}.fa.fa-battery-3:before{content:"\f241"}.fa.fa-battery-2:before{content:"\f242"}.fa.fa-battery-1:before{content:"\f243"}.fa.fa-battery-0:before{content:"\f244"}.fa.fa-object-group,.fa.fa-object-ungroup,.fa.fa-sticky-note-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-sticky-note-o:before{content:"\f249"}.fa.fa-cc-diners-club,.fa.fa-cc-jcb{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-clone{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hourglass-o:before{content:"\f254"}.fa.fa-hourglass-1:before{content:"\f251"}.fa.fa-hourglass-2:before{content:"\f252"}.fa.fa-hourglass-3:before{content:"\f253"}.fa.fa-hand-rock-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-rock-o:before{content:"\f255"}.fa.fa-hand-grab-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-grab-o:before{content:"\f255"}.fa.fa-hand-paper-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-paper-o:before{content:"\f256"}.fa.fa-hand-stop-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-stop-o:before{content:"\f256"}.fa.fa-hand-scissors-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-scissors-o:before{content:"\f257"}.fa.fa-hand-lizard-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-lizard-o:before{content:"\f258"}.fa.fa-hand-spock-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-spock-o:before{content:"\f259"}.fa.fa-hand-pointer-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-pointer-o:before{content:"\f25a"}.fa.fa-hand-peace-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-hand-peace-o:before{content:"\f25b"}.fa.fa-registered{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-creative-commons,.fa.fa-gg,.fa.fa-gg-circle,.fa.fa-odnoklassniki,.fa.fa-odnoklassniki-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-odnoklassniki-square:before{content:"\f264"}.fa.fa-chrome,.fa.fa-firefox,.fa.fa-get-pocket,.fa.fa-internet-explorer,.fa.fa-opera,.fa.fa-safari,.fa.fa-wikipedia-w{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-television:before{content:"\f26c"}.fa.fa-500px,.fa.fa-amazon,.fa.fa-contao{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-calendar-plus-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-calendar-plus-o:before{content:"\f271"}.fa.fa-calendar-minus-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-calendar-minus-o:before{content:"\f272"}.fa.fa-calendar-times-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-calendar-times-o:before{content:"\f273"}.fa.fa-calendar-check-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-calendar-check-o:before{content:"\f274"}.fa.fa-map-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-map-o:before{content:"\f279"}.fa.fa-commenting:before{content:"\f4ad"}.fa.fa-commenting-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-commenting-o:before{content:"\f4ad"}.fa.fa-houzz,.fa.fa-vimeo{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-vimeo:before{content:"\f27d"}.fa.fa-black-tie,.fa.fa-edge,.fa.fa-fonticons,.fa.fa-reddit-alien{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-credit-card-alt:before{content:"\f09d"}.fa.fa-codiepie,.fa.fa-fort-awesome,.fa.fa-mixcloud,.fa.fa-modx,.fa.fa-product-hunt,.fa.fa-scribd,.fa.fa-usb{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-pause-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-pause-circle-o:before{content:"\f28b"}.fa.fa-stop-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-stop-circle-o:before{content:"\f28d"}.fa.fa-bluetooth,.fa.fa-bluetooth-b,.fa.fa-envira,.fa.fa-gitlab,.fa.fa-wheelchair-alt,.fa.fa-wpbeginner,.fa.fa-wpforms{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-wheelchair-alt:before{content:"\f368"}.fa.fa-question-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-question-circle-o:before{content:"\f059"}.fa.fa-volume-control-phone:before{content:"\f2a0"}.fa.fa-asl-interpreting:before{content:"\f2a3"}.fa.fa-deafness:before,.fa.fa-hard-of-hearing:before{content:"\f2a4"}.fa.fa-glide,.fa.fa-glide-g{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-signing:before{content:"\f2a7"}.fa.fa-viadeo,.fa.fa-viadeo-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-viadeo-square:before{content:"\f2aa"}.fa.fa-snapchat,.fa.fa-snapchat-ghost{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-snapchat-ghost:before{content:"\f2ab"}.fa.fa-snapchat-square{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-snapchat-square:before{content:"\f2ad"}.fa.fa-first-order,.fa.fa-google-plus-official,.fa.fa-pied-piper,.fa.fa-themeisle,.fa.fa-yoast{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-google-plus-official:before{content:"\f2b3"}.fa.fa-google-plus-circle{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-google-plus-circle:before{content:"\f2b3"}.fa.fa-fa,.fa.fa-font-awesome{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-fa:before{content:"\f2b4"}.fa.fa-handshake-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-handshake-o:before{content:"\f2b5"}.fa.fa-envelope-open-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-envelope-open-o:before{content:"\f2b6"}.fa.fa-linode{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-address-book-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-address-book-o:before{content:"\f2b9"}.fa.fa-vcard:before{content:"\f2bb"}.fa.fa-address-card-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-address-card-o:before{content:"\f2bb"}.fa.fa-vcard-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-vcard-o:before{content:"\f2bb"}.fa.fa-user-circle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-user-circle-o:before{content:"\f2bd"}.fa.fa-user-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-user-o:before{content:"\f007"}.fa.fa-id-badge{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-drivers-license:before{content:"\f2c2"}.fa.fa-id-card-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-id-card-o:before{content:"\f2c2"}.fa.fa-drivers-license-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-drivers-license-o:before{content:"\f2c2"}.fa.fa-free-code-camp,.fa.fa-quora,.fa.fa-telegram{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-thermometer-4:before,.fa.fa-thermometer:before{content:"\f2c7"}.fa.fa-thermometer-3:before{content:"\f2c8"}.fa.fa-thermometer-2:before{content:"\f2c9"}.fa.fa-thermometer-1:before{content:"\f2ca"}.fa.fa-thermometer-0:before{content:"\f2cb"}.fa.fa-bathtub:before,.fa.fa-s15:before{content:"\f2cd"}.fa.fa-window-maximize,.fa.fa-window-restore{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-times-rectangle:before{content:"\f410"}.fa.fa-window-close-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-window-close-o:before{content:"\f410"}.fa.fa-times-rectangle-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-times-rectangle-o:before{content:"\f410"}.fa.fa-bandcamp,.fa.fa-eercast,.fa.fa-etsy,.fa.fa-grav,.fa.fa-imdb,.fa.fa-ravelry{font-family:"Font Awesome 6 Brands";font-weight:400}.fa.fa-eercast:before{content:"\f2da"}.fa.fa-snowflake-o{font-family:"Font Awesome 6 Free";font-weight:400}.fa.fa-snowflake-o:before{content:"\f2dc"}.fa.fa-meetup,.fa.fa-superpowers,.fa.fa-wpexplorer{font-family:"Font Awesome 6 Brands";font-weight:400} \ No newline at end of file diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.ttf b/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.ttf new file mode 100644 index 00000000..1fbb1f7c Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.ttf differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.woff2 b/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.woff2 new file mode 100644 index 00000000..5d280216 Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-brands-400.woff2 differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.ttf b/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.ttf new file mode 100644 index 00000000..549d68dc Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.ttf differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.woff2 b/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.woff2 new file mode 100644 index 00000000..18400d7f Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-regular-400.woff2 differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.ttf b/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.ttf new file mode 100644 index 00000000..bb2a8695 Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.ttf differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.woff2 b/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.woff2 new file mode 100644 index 00000000..758dd4f6 Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-solid-900.woff2 differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.ttf b/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.ttf new file mode 100644 index 00000000..8c5864c4 Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.ttf differ diff --git a/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.woff2 b/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.woff2 new file mode 100644 index 00000000..f94bec22 Binary files /dev/null and b/docs/deps/font-awesome-6.5.2/webfonts/fa-v4compatibility.woff2 differ diff --git a/docs/deps/headroom-0.11.0/headroom.min.js b/docs/deps/headroom-0.11.0/headroom.min.js new file mode 100644 index 00000000..433069fd --- /dev/null +++ b/docs/deps/headroom-0.11.0/headroom.min.js @@ -0,0 +1,7 @@ +/*! + * headroom.js v0.11.0 - Give your page some headroom. Hide your header until you need it + * Copyright (c) 2020 Nick Williams - http://wicky.nillia.ms/headroom.js + * License: MIT + */ + +!function(t,n){"object"==typeof exports&&"undefined"!=typeof module?module.exports=n():"function"==typeof define&&define.amd?define(n):(t=t||self).Headroom=n()}(this,function(){"use strict";function t(){return"undefined"!=typeof window}function d(t){return function(t){return t&&t.document&&function(t){return 9===t.nodeType}(t.document)}(t)?function(t){var n=t.document,o=n.body,s=n.documentElement;return{scrollHeight:function(){return Math.max(o.scrollHeight,s.scrollHeight,o.offsetHeight,s.offsetHeight,o.clientHeight,s.clientHeight)},height:function(){return t.innerHeight||s.clientHeight||o.clientHeight},scrollY:function(){return void 0!==t.pageYOffset?t.pageYOffset:(s||o.parentNode||o).scrollTop}}}(t):function(t){return{scrollHeight:function(){return Math.max(t.scrollHeight,t.offsetHeight,t.clientHeight)},height:function(){return Math.max(t.offsetHeight,t.clientHeight)},scrollY:function(){return t.scrollTop}}}(t)}function n(t,s,e){var n,o=function(){var n=!1;try{var t={get passive(){n=!0}};window.addEventListener("test",t,t),window.removeEventListener("test",t,t)}catch(t){n=!1}return n}(),i=!1,r=d(t),l=r.scrollY(),a={};function c(){var t=Math.round(r.scrollY()),n=r.height(),o=r.scrollHeight();a.scrollY=t,a.lastScrollY=l,a.direction=ls.tolerance[a.direction],e(a),l=t,i=!1}function h(){i||(i=!0,n=requestAnimationFrame(c))}var u=!!o&&{passive:!0,capture:!1};return t.addEventListener("scroll",h,u),c(),{destroy:function(){cancelAnimationFrame(n),t.removeEventListener("scroll",h,u)}}}function o(t,n){n=n||{},Object.assign(this,o.options,n),this.classes=Object.assign({},o.options.classes,n.classes),this.elem=t,this.tolerance=function(t){return t===Object(t)?t:{down:t,up:t}}(this.tolerance),this.initialised=!1,this.frozen=!1}return o.prototype={constructor:o,init:function(){return o.cutsTheMustard&&!this.initialised&&(this.addClass("initial"),this.initialised=!0,setTimeout(function(t){t.scrollTracker=n(t.scroller,{offset:t.offset,tolerance:t.tolerance},t.update.bind(t))},100,this)),this},destroy:function(){this.initialised=!1,Object.keys(this.classes).forEach(this.removeClass,this),this.scrollTracker.destroy()},unpin:function(){!this.hasClass("pinned")&&this.hasClass("unpinned")||(this.addClass("unpinned"),this.removeClass("pinned"),this.onUnpin&&this.onUnpin.call(this))},pin:function(){this.hasClass("unpinned")&&(this.addClass("pinned"),this.removeClass("unpinned"),this.onPin&&this.onPin.call(this))},freeze:function(){this.frozen=!0,this.addClass("frozen")},unfreeze:function(){this.frozen=!1,this.removeClass("frozen")},top:function(){this.hasClass("top")||(this.addClass("top"),this.removeClass("notTop"),this.onTop&&this.onTop.call(this))},notTop:function(){this.hasClass("notTop")||(this.addClass("notTop"),this.removeClass("top"),this.onNotTop&&this.onNotTop.call(this))},bottom:function(){this.hasClass("bottom")||(this.addClass("bottom"),this.removeClass("notBottom"),this.onBottom&&this.onBottom.call(this))},notBottom:function(){this.hasClass("notBottom")||(this.addClass("notBottom"),this.removeClass("bottom"),this.onNotBottom&&this.onNotBottom.call(this))},shouldUnpin:function(t){return"down"===t.direction&&!t.top&&t.toleranceExceeded},shouldPin:function(t){return"up"===t.direction&&t.toleranceExceeded||t.top},addClass:function(t){this.elem.classList.add.apply(this.elem.classList,this.classes[t].split(" "))},removeClass:function(t){this.elem.classList.remove.apply(this.elem.classList,this.classes[t].split(" "))},hasClass:function(t){return this.classes[t].split(" ").every(function(t){return this.classList.contains(t)},this.elem)},update:function(t){t.isOutOfBounds||!0!==this.frozen&&(t.top?this.top():this.notTop(),t.bottom?this.bottom():this.notBottom(),this.shouldUnpin(t)?this.unpin():this.shouldPin(t)&&this.pin())}},o.options={tolerance:{up:0,down:0},offset:0,scroller:t()?window:null,classes:{frozen:"headroom--frozen",pinned:"headroom--pinned",unpinned:"headroom--unpinned",top:"headroom--top",notTop:"headroom--not-top",bottom:"headroom--bottom",notBottom:"headroom--not-bottom",initial:"headroom"}},o.cutsTheMustard=!!(t()&&function(){}.bind&&"classList"in document.documentElement&&Object.assign&&Object.keys&&requestAnimationFrame),o}); \ No newline at end of file diff --git a/docs/deps/headroom-0.11.0/jQuery.headroom.min.js b/docs/deps/headroom-0.11.0/jQuery.headroom.min.js new file mode 100644 index 00000000..17f70c9e --- /dev/null +++ b/docs/deps/headroom-0.11.0/jQuery.headroom.min.js @@ -0,0 +1,7 @@ +/*! + * headroom.js v0.9.4 - Give your page some headroom. Hide your header until you need it + * Copyright (c) 2017 Nick Williams - http://wicky.nillia.ms/headroom.js + * License: MIT + */ + +!function(a){a&&(a.fn.headroom=function(b){return this.each(function(){var c=a(this),d=c.data("headroom"),e="object"==typeof b&&b;e=a.extend(!0,{},Headroom.options,e),d||(d=new Headroom(this,e),d.init(),c.data("headroom",d)),"string"==typeof b&&(d[b](),"destroy"===b&&c.removeData("headroom"))})},a("[data-headroom]").each(function(){var b=a(this);b.headroom(b.data())}))}(window.Zepto||window.jQuery); \ No newline at end of file diff --git a/docs/deps/jquery-3.6.0/jquery-3.6.0.js b/docs/deps/jquery-3.6.0/jquery-3.6.0.js new file mode 100644 index 00000000..fc6c299b --- /dev/null +++ b/docs/deps/jquery-3.6.0/jquery-3.6.0.js @@ -0,0 +1,10881 @@ +/*! + * jQuery JavaScript Library v3.6.0 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright OpenJS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2021-03-02T17:08Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 + // Plus for old WebKit, typeof returns "function" for HTML collections + // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) + return typeof obj === "function" && typeof obj.nodeType !== "number" && + typeof obj.item !== "function"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.6.0", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), + function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); + } ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.6 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2021-02-16 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem && elem.namespaceURI, + docElem = elem && ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +} +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the primary Deferred + primary = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + primary.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( primary.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return primary.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); + } + + return primary.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
    " ], + col: [ 2, "", "
    " ], + tr: [ 2, "", "
    " ], + td: [ 3, "", "
    " ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + + // Support: Chrome 86+ + // In Chrome, if an element having a focusout handler is blurred by + // clicking outside of it, it invokes the handler synchronously. If + // that handler calls `.remove()` on the element, the data is cleared, + // leaving `result` undefined. We need to guard against this. + return result && result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + which: true +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + // Suppress native focus or blur as it's already being fired + // in leverageNative. + _default: function() { + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + // + // Support: Firefox 70+ + // Only Firefox includes border widths + // in computed dimensions. (gh-4529) + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; + tr.style.cssText = "border:1px solid"; + + // Support: Chrome 86+ + // Height set through cssText does not get applied. + // Computed height then comes back as 0. + tr.style.height = "1px"; + trChild.style.height = "9px"; + + // Support: Android 8 Chrome 86+ + // In our bodyBackground.html iframe, + // display for all div elements is set to "inline", + // which causes a problem only in Android 8 Chrome 86. + // Ensuring the div is display: block + // gets around this issue. + trChild.style.display = "block"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + + parseInt( trStyle.borderTopWidth, 10 ) + + parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml, parserErrorElem; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) {} + + parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; + if ( !xml || parserErrorElem ) { + jQuery.error( "Invalid XML: " + ( + parserErrorElem ? + jQuery.map( parserErrorElem.childNodes, function( el ) { + return el.textContent; + } ).join( "\n" ) : + data + ) ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ).filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ).map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + +originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script but not if jsonp + if ( !isSuccess && + jQuery.inArray( "script", s.dataTypes ) > -1 && + jQuery.inArray( "json", s.dataTypes ) < 0 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " - - - - - + + + + + + - - - - -
    -
    - + + Skip to contents +
    -
    + dsBase -
    + 6.3.6.9000 + + + + + + + +
    +
    +
    +

    dsBase: ‘DataSHIELD’ Server Side Base Functions

    License R build status Codecov test coverage

    @@ -72,8 +60,8 @@

    Installationinstall.packages("remotes") remotes::install_github("datashield/dsBase", "<BRANCH>") -# Install v6.3.4 with the following -remotes::install_github("datashield/dsBase", "6.3.4")

    +# Install v6.3.6 with the following +remotes::install_github("datashield/dsBase", "6.3.6")

    For a full list of development branches, checkout https://github.com/datashield/dsBase/branches

    @@ -122,10 +110,7 @@

    References -
    +
    -
    -

    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    +

    - diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 00000000..4a82b19f --- /dev/null +++ b/docs/index.md @@ -0,0 +1,101 @@ +## dsBase: ‘DataSHIELD’ Server Side Base Functions + +[![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html) +[![](https://www.r-pkg.org/badges/version/dsBase?color=black)](https://cran.r-project.org/package=dsBase) +[![R build +status](https://github.com/datashield/dsBase/workflows/R-CMD-check/badge.svg)](https://github.com/datashield/dsBase/actions) +[![Codecov test +coverage](https://codecov.io/gh/datashield/dsBase/graph/badge.svg)](https://app.codecov.io/gh/datashield/dsBase) + +## Installation + +You can install the released version of dsBase from +[CRAN](https://cran.r-project.org/package=dsBase) with: + +``` r +install.packages("dsBase") +``` + +And the development version from +[GitHub](https://github.com/datashield/dsBase/) with: + +``` r +install.packages("remotes") +remotes::install_github("datashield/dsBase", "") + +# Install v6.3.6 with the following +remotes::install_github("datashield/dsBase", "6.3.6") +``` + +For a full list of development branches, checkout + + +## About + +DataSHIELD is a software package which allows you to do non-disclosive +federated analysis on sensitive data. Our website +() has in depth descriptions of what it is, +how it works and how to install it. A key point to highlight is that +DataSHIELD has a client-server infrastructure, so the dsBase package +() needs to be used in conjunction +with the dsBaseClient package +() - trying to use one +without the other makes no sense. + +Detailed instructions on how to install DataSHIELD are at +. The code here is organised as: + +| Location | What is it? | +|---------------|---------------------------------------------------------| +| obiba CRAN | Where you probably should install DataSHIELD from. | +| releases | Stable releases. | +| master branch | Mostly in sync with the latest release, changes rarely. | + +## References + +\[1\] Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg A, +Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye A, +Escribà Montagut X, Wheater S (2025). *dsBase: ‘DataSHIELD’ Server Side +Base Functions*. R package version 6.3.4. +. + +\[2\] Gaye A, Marcon Y, Isaeva J, LaFlamme P, Turner A, Jones E, Minion +J, Boyd A, Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir I, +Doiron D, Giepmans L, Wallace S, Budin-Ljøsne I, Oliver Schmidt C, +Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, +Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry I, Peters A, Phillips +C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van +den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier I, Harris J, +Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014). “DataSHIELD: +taking the analysis to the data, not the data to the analysis.” +*International Journal of Epidemiology*, *43*(6), 1929-1944. +. + +\[3\] Wilson R, W. Butters O, Avraam D, Baker J, Tedds J, Turner A, +Murtagh M, R. Burton P (2017). “DataSHIELD – New Directions and +Dimensions.” *Data Science Journal*, *16*(21), 1-21. +. + +\[4\] Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters +O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, +Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde +E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan A, Murtagh M, +Nestor M, Nybo Andersen A, Parker S, Pinot de Moira A, Schwarz F, +Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024). +“DataSHIELD: mitigating disclosure risk in a multi-site federated +analysis platform.” *Bioinformatics Advances*, *5*(1), 1-21. +. + +> ***Note:*** Apple Mx architecture users, please be aware that there +> are some numerical limitations on this platform, which leads to +> unexpected results when using base R packages, like stats​. +> +> x \<- c(0, 3, 7) +> +> 1 - cor(x, x)​ +> +> The above should result in a value of zero. +> +> *Also See:* For more details see +> +> and the bug report: diff --git a/docs/katex-auto.js b/docs/katex-auto.js new file mode 100644 index 00000000..2adab3a9 --- /dev/null +++ b/docs/katex-auto.js @@ -0,0 +1,16 @@ +// https://github.com/jgm/pandoc/blob/29fa97ab96b8e2d62d48326e1b949a71dc41f47a/src/Text/Pandoc/Writers/HTML.hs#L332-L345 +document.addEventListener("DOMContentLoaded", function () { + var mathElements = document.getElementsByClassName("math"); + var macros = []; + for (var i = 0; i < mathElements.length; i++) { + var texText = mathElements[i].firstChild; + if (mathElements[i].tagName == "SPAN") { + katex.render(texText.data, mathElements[i], { + displayMode: mathElements[i].classList.contains("display"), + throwOnError: false, + macros: macros, + fleqn: false + }); + } + } +}); diff --git a/docs/lightswitch.js b/docs/lightswitch.js new file mode 100644 index 00000000..3808ca11 --- /dev/null +++ b/docs/lightswitch.js @@ -0,0 +1,85 @@ + +/*! + * Color mode toggler for Bootstrap's docs (https://getbootstrap.com/) + * Copyright 2011-2023 The Bootstrap Authors + * Licensed under the Creative Commons Attribution 3.0 Unported License. + * Updates for {pkgdown} by the {bslib} authors, also licensed under CC-BY-3.0. + */ + +const getStoredTheme = () => localStorage.getItem('theme') +const setStoredTheme = theme => localStorage.setItem('theme', theme) + +const getPreferredTheme = () => { + const storedTheme = getStoredTheme() + if (storedTheme) { + return storedTheme + } + + return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light' +} + +const setTheme = theme => { + if (theme === 'auto') { + document.documentElement.setAttribute('data-bs-theme', (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light')) + } else { + document.documentElement.setAttribute('data-bs-theme', theme) + } +} + +function bsSetupThemeToggle() { + 'use strict' + + const showActiveTheme = (theme, focus = false) => { + var activeLabel, activeIcon; + + document.querySelectorAll('[data-bs-theme-value]').forEach(element => { + const buttonTheme = element.getAttribute('data-bs-theme-value') + const isActive = buttonTheme == theme + + element.classList.toggle('active', isActive) + element.setAttribute('aria-pressed', isActive) + + if (isActive) { + activeLabel = element.textContent; + activeIcon = element.querySelector('span').classList.value; + } + }) + + const themeSwitcher = document.querySelector('#dropdown-lightswitch') + if (!themeSwitcher) { + return + } + + themeSwitcher.setAttribute('aria-label', activeLabel) + themeSwitcher.querySelector('span').classList.value = activeIcon; + + if (focus) { + themeSwitcher.focus() + } + } + + window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => { + const storedTheme = getStoredTheme() + if (storedTheme !== 'light' && storedTheme !== 'dark') { + setTheme(getPreferredTheme()) + } + }) + + window.addEventListener('DOMContentLoaded', () => { + showActiveTheme(getPreferredTheme()) + + document + .querySelectorAll('[data-bs-theme-value]') + .forEach(toggle => { + toggle.addEventListener('click', () => { + const theme = toggle.getAttribute('data-bs-theme-value') + setTheme(theme) + setStoredTheme(theme) + showActiveTheme(theme, true) + }) + }) + }) +} + +setTheme(getPreferredTheme()); +bsSetupThemeToggle(); diff --git a/docs/llms.txt b/docs/llms.txt new file mode 100644 index 00000000..af99250f --- /dev/null +++ b/docs/llms.txt @@ -0,0 +1,489 @@ +## dsBase: ‘DataSHIELD’ Server Side Base Functions + +[![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html) +[![](https://www.r-pkg.org/badges/version/dsBase?color=black)](https://cran.r-project.org/package=dsBase) +[![R build +status](https://github.com/datashield/dsBase/workflows/R-CMD-check/badge.svg)](https://github.com/datashield/dsBase/actions) +[![Codecov test +coverage](https://codecov.io/gh/datashield/dsBase/graph/badge.svg)](https://app.codecov.io/gh/datashield/dsBase) + +## Installation + +You can install the released version of dsBase from +[CRAN](https://cran.r-project.org/package=dsBase) with: + +``` r +install.packages("dsBase") +``` + +And the development version from +[GitHub](https://github.com/datashield/dsBase/) with: + +``` r +install.packages("remotes") +remotes::install_github("datashield/dsBase", "") + +# Install v6.3.6 with the following +remotes::install_github("datashield/dsBase", "6.3.6") +``` + +For a full list of development branches, checkout + + +## About + +DataSHIELD is a software package which allows you to do non-disclosive +federated analysis on sensitive data. Our website +() has in depth descriptions of what it is, +how it works and how to install it. A key point to highlight is that +DataSHIELD has a client-server infrastructure, so the dsBase package +() needs to be used in conjunction +with the dsBaseClient package +() - trying to use one +without the other makes no sense. + +Detailed instructions on how to install DataSHIELD are at +. The code here is organised as: + +| Location | What is it? | +|---------------|---------------------------------------------------------| +| obiba CRAN | Where you probably should install DataSHIELD from. | +| releases | Stable releases. | +| master branch | Mostly in sync with the latest release, changes rarely. | + +## References + +\[1\] Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg A, +Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye A, +Escribà Montagut X, Wheater S (2025). *dsBase: ‘DataSHIELD’ Server Side +Base Functions*. R package version 6.3.4. +. + +\[2\] Gaye A, Marcon Y, Isaeva J, LaFlamme P, Turner A, Jones E, Minion +J, Boyd A, Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir I, +Doiron D, Giepmans L, Wallace S, Budin-Ljøsne I, Oliver Schmidt C, +Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, +Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry I, Peters A, Phillips +C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van +den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier I, Harris J, +Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014). “DataSHIELD: +taking the analysis to the data, not the data to the analysis.” +*International Journal of Epidemiology*, *43*(6), 1929-1944. +. + +\[3\] Wilson R, W. Butters O, Avraam D, Baker J, Tedds J, Turner A, +Murtagh M, R. Burton P (2017). “DataSHIELD – New Directions and +Dimensions.” *Data Science Journal*, *16*(21), 1-21. +. + +\[4\] Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters +O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, +Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde +E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan A, Murtagh M, +Nestor M, Nybo Andersen A, Parker S, Pinot de Moira A, Schwarz F, +Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024). +“DataSHIELD: mitigating disclosure risk in a multi-site federated +analysis platform.” *Bioinformatics Advances*, *5*(1), 1-21. +. + +> ***Note:*** Apple Mx architecture users, please be aware that there +> are some numerical limitations on this platform, which leads to +> unexpected results when using base R packages, like stats​. +> +> x \<- c(0, 3, 7) +> +> 1 - cor(x, x)​ +> +> The above should result in a value of zero. +> +> *Also See:* For more details see +> +> and the bug report: + +# Package index + +## All functions + +- [`BooleDS()`](BooleDS.md) : BooleDS + +- [`absDS()`](absDS.md) : Computes the absolute values of the input + variable + +- [`asCharacterDS()`](asCharacterDS.md) : Coerces an R object into class + character + +- [`asDataMatrixDS()`](asDataMatrixDS.md) : asDataMatrixDS a serverside + assign function called by ds.asDataMatrix + +- [`asFactorDS1()`](asFactorDS1.md) : Determines the levels of the input + variable in each single study + +- [`asFactorDS2()`](asFactorDS2.md) : Converts a numeric vector into a + factor + +- [`asFactorSimpleDS()`](asFactorSimpleDS.md) : Converts a numeric + vector into a factor + +- [`asIntegerDS()`](asIntegerDS.md) : Coerces an R object into class + integer + +- [`asListDS()`](asListDS.md) : asListDS a serverside aggregate function + called by ds.asList + +- [`asLogicalDS()`](asLogicalDS.md) : Coerces an R object into class + numeric + +- [`asMatrixDS()`](asMatrixDS.md) : Coerces an R object into a matrix + +- [`asNumericDS()`](asNumericDS.md) : Coerces an R object into class + numeric + +- [`aucDS()`](aucDS.md) : aucDS an aggregate function called by ds.auc + +- [`blackBoxDS()`](blackBoxDS.md) : Secure ranking of "V2BR" (vector to + be ranked) across all sources + +- [`blackBoxRanksDS()`](blackBoxRanksDS.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`boxPlotGGDS()`](boxPlotGGDS.md) : Create the identity stats and + necessary data to draw a plot on the client + +- [`boxPlotGG_data_TreatmentDS()`](boxPlotGG_data_TreatmentDS.md) : + Arrange data frame to pass it to the boxplot function + +- [`boxPlotGG_data_Treatment_numericDS()`](boxPlotGG_data_Treatment_numericDS.md) + : Arrange vector to pass it to the boxplot function + +- [`bp_standardsDS()`](bp_standardsDS.md) : Calculates Blood pressure + z-scores + +- [`cDS()`](cDS.md) : Concatenates objects into a vector or list + +- [`cbindDS()`](cbindDS.md) : cbindDS called by ds.cbind + +- [`changeRefGroupDS()`](changeRefGroupDS.md) : Changes a reference + level of a factor + +- [`checkNegValueDS()`](checkNegValueDS.md) : Checks if a numeric + variable has negative values + +- [`checkPermissivePrivacyControlLevel()`](checkPermissivePrivacyControlLevel.md) + : checkPermissivePrivacyControlLevel + +- [`classDS()`](classDS.md) : Returns the class of an object + +- [`colnamesDS()`](colnamesDS.md) : Returns the column names of a data + frame or matrix + +- [`completeCasesDS()`](completeCasesDS.md) : completeCasesDS: an assign + function called by ds.completeCases + +- [`corDS()`](corDS.md) : Computes the sum of each variable and the sum + of products for each pair of variables + +- [`corTestDS()`](corTestDS.md) : Tests for correlation between paired + samples + +- [`covDS()`](covDS.md) : Computes the sum of each variable and the sum + of products for each pair of variables + +- [`dataFrameDS()`](dataFrameDS.md) : dataFrameDS called by ds.dataFrame + +- [`dataFrameFillDS()`](dataFrameFillDS.md) : dataFrameFillDS + +- [`dataFrameSortDS()`](dataFrameSortDS.md) : Sorting and reordering + data frames, vectors or matrices + +- [`dataFrameSubsetDS1()`](dataFrameSubsetDS1.md) : dataFrameSubsetDS1 + an aggregate function called by ds.dataFrameSubset + +- [`dataFrameSubsetDS2()`](dataFrameSubsetDS2.md) : dataFrameSubsetDS2 + an assign function called by ds.dataFrameSubset + +- [`densityGridDS()`](densityGridDS.md) : Generates a density grid with + or without a priori defined limits + +- [`dimDS()`](dimDS.md) : Returns the dimension of a data frame or + matrix + +- [`dmtC2SDS()`](dmtC2SDS.md) : Copy a clientside data.frame, matrix or + tibble (DMT) to the serverside. + +- [`elsplineDS()`](elsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`extractQuantilesDS1()`](extractQuantilesDS1.md) : Secure ranking of + "V2BR" (vector to be ranked) across all sources and use of these ranks + to estimate global quantiles across all studies + +- [`extractQuantilesDS2()`](extractQuantilesDS2.md) : Secure ranking of + "V2BR" (vector to be ranked) across all sources and use of these ranks + to estimate global quantiles across all studies + +- [`fixClassDS()`](fixClassDS.md) : Change Class of Target Variables in + a Data Frame + +- [`fixColsDS()`](fixColsDS.md) : Add Missing Columns with NA Values + +- [`fixLevelsDS()`](fixLevelsDS.md) : Set Factor Levels for Specific + Columns in a Data Frame + +- [`gamlssDS()`](gamlssDS.md) : gamlssDS an aggregate function called by + ds.gamlss + +- [`getAllLevelsDS()`](getAllLevelsDS.md) : Retrieve Factor Levels for + Specific Columns + +- [`getClassAllColsDS()`](getClassAllColsDS.md) : Get the Class of All + Columns in a Data Frame + +- [`getWGSRDS()`](getWGSRDS.md) : Computes the WHO Growth Reference + z-scores of anthropometric data + +- [`glmDS1()`](glmDS1.md) : glmDS1 called by ds.glm + +- [`glmDS2()`](glmDS2.md) : glmDS2 called by ds.glm + +- [`glmPredictDS.ag()`](glmPredictDS.ag.md) : predict regression + responses from a glm object + +- [`glmPredictDS.as()`](glmPredictDS.as.md) : predict regression + responses from a glm object + +- [`glmSLMADS.assign()`](glmSLMADS.assign.md) : Fit a Generalized Linear + Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSLMADS1()`](glmSLMADS1.md) : Fit a Generalized Linear Model (GLM) + with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSLMADS2()`](glmSLMADS2.md) : Fit a Generalized Linear Model (GLM) + with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSummaryDS.ag()`](glmSummaryDS.ag.md) : summarize a glm object on + the serverside + +- [`glmSummaryDS.as()`](glmSummaryDS.as.md) : summarize a glm object on + the serverside + +- [`glmerSLMADS.assign()`](glmerSLMADS.assign.md) : Fitting generalized + linear mixed effect models - serverside function + +- [`glmerSLMADS2()`](glmerSLMADS2.md) : Fitting generalized linear mixed + effect models - serverside function + +- [`heatmapPlotDS()`](heatmapPlotDS.md) : Calculates the coordinates of + the centroid of each n nearest neighbours + +- [`hetcorDS()`](hetcorDS.md) : Heterogeneous Correlation Matrix + +- [`histogramDS1()`](histogramDS1.md) : returns the minimum and the + maximum of the input numeric vector + +- [`histogramDS2()`](histogramDS2.md) : Computes a histogram of the + input variable without plotting. + +- [`igb_standardsDS()`](igb_standardsDS.md) : Converts birth + measurements to intergrowth z-scores/centiles + +- [`isNaDS()`](isNaDS.md) : Checks if a vector is empty + +- [`isValidDS()`](isValidDS.md) : Checks if an input is valid + +- [`kurtosisDS1()`](kurtosisDS1.md) : Calculates the kurtosis of a + numeric variable + +- [`kurtosisDS2()`](kurtosisDS2.md) : Calculates the kurtosis of a + numeric variable + +- [`lengthDS()`](lengthDS.md) : Returns the length of a vector or list + +- [`levelsDS()`](levelsDS.md) : Returns the levels of a factor vector + +- [`lexisDS1()`](lexisDS1.md) : lexisDS1 + +- [`lexisDS2()`](lexisDS2.md) : lexisDS2 + +- [`lexisDS3()`](lexisDS3.md) : @title lexisDS3 + +- [`listDS()`](listDS.md) : Coerce objects into a list + +- [`listDisclosureSettingsDS()`](listDisclosureSettingsDS.md) : + listDisclosureSettingsDS + +- [`lmerSLMADS.assign()`](lmerSLMADS.assign.md) : Fitting linear mixed + effect models - serverside function + +- [`lmerSLMADS2()`](lmerSLMADS2.md) : Fitting linear mixed effect + models - serverside function + +- [`lsDS()`](lsDS.md) : lists all objects on a serverside environment + +- [`lsplineDS()`](lsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`matrixDS()`](matrixDS.md) : matrixDS assign function called by + ds.matrix + +- [`matrixDetDS1()`](matrixDetDS1.md) : matrixDetDS aggregate function + called by ds.matrixDet.report + +- [`matrixDetDS2()`](matrixDetDS2.md) : matrixDetDS assign function + called by ds.matrixDet + +- [`matrixDiagDS()`](matrixDiagDS.md) : matrixDiagDS assign function + called by ds.matrixDiag + +- [`matrixDimnamesDS()`](matrixDimnamesDS.md) : matrixDimnamesDS assign + function called by ds.matrixDimnames + +- [`matrixInvertDS()`](matrixInvertDS.md) : matrixInvertDS serverside + assign function called by ds.matrixInvert + +- [`matrixMultDS()`](matrixMultDS.md) : matrixMultDS serverside assign + function called by ds.matrixMult + +- [`matrixTransposeDS()`](matrixTransposeDS.md) : matrixTransposeDS + serverside assign function called by ds.matrixTranspose + +- [`mdPatternDS()`](mdPatternDS.md) : Missing data pattern with + disclosure control + +- [`meanDS()`](meanDS.md) : Computes statistical mean of a vector + +- [`meanSdGpDS()`](meanSdGpDS.md) : MeanSdGpDS + +- [`mergeDS()`](mergeDS.md) : mergeDS (assign function) called by + ds.merge + +- [`messageDS()`](messageDS.md) : messageDS + +- [`metadataDS()`](metadataDS.md) : Returns the metadata, if any, about + the specified variable + +- [`miceDS()`](miceDS.md) : Aggregate function called by ds.mice + +- [`minMaxRandDS()`](minMaxRandDS.md) : Secure ranking of "V2BR" (vector + to be ranked) across all sources + +- [`namesDS()`](namesDS.md) : Return the names of a list object + +- [`nsDS()`](nsDS.md) : Generate a Basis Matrix for Natural Cubic + Splines + +- [`numNaDS()`](numNaDS.md) : Counts the number of missing values + +- [`qlsplineDS()`](qlsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`quantileMeanDS()`](quantileMeanDS.md) : Generates quantiles and mean + information without maximum and minimum + +- [`rBinomDS()`](rBinomDS.md) : rBinomDS serverside assign function + +- [`rNormDS()`](rNormDS.md) : rNormDS serverside assign function + +- [`rPoisDS()`](rPoisDS.md) : rPoisDS serverside assign function + +- [`rUnifDS()`](rUnifDS.md) : rUnifDS serverside assign function + +- [`rangeDS()`](rangeDS.md) : returns the minimum and maximum of a + numeric vector + +- [`ranksSecureDS1()`](ranksSecureDS1.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS2()`](ranksSecureDS2.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS3()`](ranksSecureDS3.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS4()`](ranksSecureDS4.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS5()`](ranksSecureDS5.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`rbindDS()`](rbindDS.md) : rbindDS called by ds.rbind + +- [`reShapeDS()`](reShapeDS.md) : reShapeDS (assign function) called by + ds.reShape + +- [`recodeLevelsDS()`](recodeLevelsDS.md) : Recodes the levels of a + categorical variables + +- [`recodeValuesDS()`](recodeValuesDS.md) : recodeValuesDS an assign + function called by ds.recodeValues + +- [`repDS()`](repDS.md) : repDS called by ds.rep + +- [`replaceNaDS()`](replaceNaDS.md) : Replaces the missing values in a + vector + +- [`rmDS()`](rmDS.md) : rmDS an aggregate function called by ds.rm + +- [`rowColCalcDS()`](rowColCalcDS.md) : Computes sums and means of rows + or columns of numeric arrays + +- [`sampleDS()`](sampleDS.md) : random sampling and permuting of + vectors, dataframes and matrices + +- [`scatterPlotDS()`](scatterPlotDS.md) : Calculates the coordinates of + the data to be plot + +- [`seqDS()`](seqDS.md) : seqDS a serverside assign function called by + ds.seq + +- [`setSeedDS()`](setSeedDS.md) : setSeedDs called by ds.setSeed, + ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom + +- [`skewnessDS1()`](skewnessDS1.md) : Calculates the skewness of a + numeric variable + +- [`skewnessDS2()`](skewnessDS2.md) : Calculates the skewness of a + numeric variable + +- [`sqrtDS()`](sqrtDS.md) : Computes the square root values of the input + variable + +- [`subsetByClassDS()`](subsetByClassDS.md) : Breaks down a dataframe or + a factor into its sub-classes + +- [`subsetDS()`](subsetDS.md) : Generates a valid subset of a table or a + vector + +- [`table1DDS()`](table1DDS.md) : Creates 1-dimensional contingency + tables + +- [`table2DDS()`](table2DDS.md) : table2DDS (aggregate function) called + by ds.table2D + +- [`tableDS()`](tableDS.md) : tableDS is the first of two serverside + aggregate functions called by ds.table + +- [`tableDS.assign()`](tableDS.assign.md) : tableDS.assign is the + serverside assign function called by ds.table + +- [`tableDS2()`](tableDS2.md) : tableDS is the second of two serverside + aggregate functions called by ds.table + +- [`tapplyDS()`](tapplyDS.md) : tapplyDS called by ds.tapply + +- [`tapplyDS.assign()`](tapplyDS.assign.md) : tapplyDS.assign called by + ds.tapply.assign + +- [`testObjExistsDS()`](testObjExistsDS.md) : testObjExistsDS + +- [`unListDS()`](unListDS.md) : + + `unListDS` a serverside assign function called by `ds.unList` + +- [`uniqueDS()`](uniqueDS.md) : + + Applies the `unique` method to a server-side variable. + +- [`varDS()`](varDS.md) : Computes the variance of vector + +- [`vectorDS()`](vectorDS.md) : Creates a vector on the server-side. + diff --git a/docs/pkgdown.js b/docs/pkgdown.js index 6f0eee40..0a5573ae 100644 --- a/docs/pkgdown.js +++ b/docs/pkgdown.js @@ -1,108 +1,162 @@ /* http://gregfranko.com/blog/jquery-best-practices/ */ -(function($) { - $(function() { +(function ($) { + $(function () { - $('.navbar-fixed-top').headroom(); + $('nav.navbar').headroom(); - $('body').css('padding-top', $('.navbar').height() + 10); - $(window).resize(function(){ - $('body').css('padding-top', $('.navbar').height() + 10); + Toc.init({ + $nav: $("#toc"), + $scope: $("main h2, main h3, main h4, main h5, main h6") }); - $('[data-toggle="tooltip"]').tooltip(); - - var cur_path = paths(location.pathname); - var links = $("#navbar ul li a"); - var max_length = -1; - var pos = -1; - for (var i = 0; i < links.length; i++) { - if (links[i].getAttribute("href") === "#") - continue; - // Ignore external links - if (links[i].host !== location.host) - continue; - - var nav_path = paths(links[i].pathname); - - var length = prefix_length(nav_path, cur_path); - if (length > max_length) { - max_length = length; - pos = i; - } + if ($('#toc').length) { + $('body').scrollspy({ + target: '#toc', + offset: $("nav.navbar").outerHeight() + 1 + }); } - // Add class to parent
  • , and enclosing
  • if in dropdown - if (pos >= 0) { - var menu_anchor = $(links[pos]); - menu_anchor.parent().addClass("active"); - menu_anchor.closest("li.dropdown").addClass("active"); - } - }); - - function paths(pathname) { - var pieces = pathname.split("/"); - pieces.shift(); // always starts with / + // Activate popovers + $('[data-bs-toggle="popover"]').popover({ + container: 'body', + html: true, + trigger: 'focus', + placement: "top", + sanitize: false, + }); - var end = pieces[pieces.length - 1]; - if (end === "index.html" || end === "") - pieces.pop(); - return(pieces); - } + $('[data-bs-toggle="tooltip"]').tooltip(); - // Returns -1 if not found - function prefix_length(needle, haystack) { - if (needle.length > haystack.length) - return(-1); + /* Clipboard --------------------------*/ - // Special case for length-0 haystack, since for loop won't run - if (haystack.length === 0) { - return(needle.length === 0 ? 0 : -1); + function changeTooltipMessage(element, msg) { + var tooltipOriginalTitle = element.getAttribute('data-bs-original-title'); + element.setAttribute('data-bs-original-title', msg); + $(element).tooltip('show'); + element.setAttribute('data-bs-original-title', tooltipOriginalTitle); } - for (var i = 0; i < haystack.length; i++) { - if (needle[i] != haystack[i]) - return(i); - } + if (ClipboardJS.isSupported()) { + $(document).ready(function () { + var copyButton = ""; - return(haystack.length); - } + $("div.sourceCode").addClass("hasCopyButton"); - /* Clipboard --------------------------*/ + // Insert copy buttons: + $(copyButton).prependTo(".hasCopyButton"); - function changeTooltipMessage(element, msg) { - var tooltipOriginalTitle=element.getAttribute('data-original-title'); - element.setAttribute('data-original-title', msg); - $(element).tooltip('show'); - element.setAttribute('data-original-title', tooltipOriginalTitle); - } + // Initialize tooltips: + $('.btn-copy-ex').tooltip({ container: 'body' }); - if(ClipboardJS.isSupported()) { - $(document).ready(function() { - var copyButton = ""; + // Initialize clipboard: + var clipboard = new ClipboardJS('[data-clipboard-copy]', { + text: function (trigger) { + return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, ""); + } + }); - $("div.sourceCode").addClass("hasCopyButton"); + clipboard.on('success', function (e) { + changeTooltipMessage(e.trigger, 'Copied!'); + e.clearSelection(); + }); - // Insert copy buttons: - $(copyButton).prependTo(".hasCopyButton"); + clipboard.on('error', function (e) { + changeTooltipMessage(e.trigger, 'Press Ctrl+C or Command+C to copy'); + }); - // Initialize tooltips: - $('.btn-copy-ex').tooltip({container: 'body'}); + }); + } - // Initialize clipboard: - var clipboardBtnCopies = new ClipboardJS('[data-clipboard-copy]', { - text: function(trigger) { - return trigger.parentNode.textContent.replace(/\n#>[^\n]*/g, ""); + /* Search marking --------------------------*/ + var url = new URL(window.location.href); + var toMark = url.searchParams.get("q"); + var mark = new Mark("main#main"); + if (toMark) { + mark.mark(toMark, { + accuracy: { + value: "complementary", + limiters: [",", ".", ":", "/"], } }); + } - clipboardBtnCopies.on('success', function(e) { - changeTooltipMessage(e.trigger, 'Copied!'); - e.clearSelection(); - }); + /* Search --------------------------*/ + /* Adapted from https://github.com/rstudio/bookdown/blob/2d692ba4b61f1e466c92e78fd712b0ab08c11d31/inst/resources/bs4_book/bs4_book.js#L25 */ + // Initialise search index on focus + var fuse; + $("#search-input").focus(async function (e) { + if (fuse) { + return; + } - clipboardBtnCopies.on('error', function() { - changeTooltipMessage(e.trigger,'Press Ctrl+C or Command+C to copy'); - }); + $(e.target).addClass("loading"); + var response = await fetch($("#search-input").data("search-index")); + var data = await response.json(); + + var options = { + keys: ["what", "text", "code"], + ignoreLocation: true, + threshold: 0.1, + includeMatches: true, + includeScore: true, + }; + fuse = new Fuse(data, options); + + $(e.target).removeClass("loading"); }); - } + + // Use algolia autocomplete + var options = { + autoselect: true, + debug: true, + hint: false, + minLength: 2, + }; + var q; + async function searchFuse(query, callback) { + await fuse; + + var items; + if (!fuse) { + items = []; + } else { + q = query; + var results = fuse.search(query, { limit: 20 }); + items = results + .filter((x) => x.score <= 0.75) + .map((x) => x.item); + if (items.length === 0) { + items = [{ dir: "Sorry 😿", previous_headings: "", title: "No results found.", what: "No results found.", path: window.location.href }]; + } + } + callback(items); + } + $("#search-input").autocomplete(options, [ + { + name: "content", + source: searchFuse, + templates: { + suggestion: (s) => { + if (s.title == s.what) { + return `${s.dir} >
    ${s.title}
    `; + } else if (s.previous_headings == "") { + return `${s.dir} >
    ${s.title}
    > ${s.what}`; + } else { + return `${s.dir} >
    ${s.title}
    > ${s.previous_headings} > ${s.what}`; + } + }, + }, + }, + ]).on('autocomplete:selected', function (event, s) { + window.location.href = s.path + "?q=" + q + "#" + s.id; + }); + }); })(window.jQuery || window.$) + +document.addEventListener('keydown', function (event) { + // Check if the pressed key is '/' + if (event.key === '/') { + event.preventDefault(); // Prevent any default action associated with the '/' key + document.getElementById('search-input').focus(); // Set focus to the search input + } +}); diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml index 45989012..c37ff40e 100644 --- a/docs/pkgdown.yml +++ b/docs/pkgdown.yml @@ -1,5 +1,5 @@ pandoc: 3.1.3 -pkgdown: 2.1.3 +pkgdown: 2.2.0 pkgdown_sha: ~ articles: {} -last_built: 2025-09-17T15:04Z +last_built: 2026-07-06T11:51Z diff --git a/docs/reference/BooleDS.html b/docs/reference/BooleDS.html index e99c093a..cad9df6b 100644 --- a/docs/reference/BooleDS.html +++ b/docs/reference/BooleDS.html @@ -1,51 +1,45 @@ -BooleDS — BooleDS • dsBase - - -
    -
    -
    -
    -

    BooleDS

    + - + + + +
    +
    +
    +
    + +

    BooleDS

    + +
    BooleDS.Rd
    -
    +

    Converts the individual elements of a vector or other object into Boolean indicators.

    -
    +
    +

    Usage

    BooleDS(
   V1.name = NULL,
   V2.name = NULL,
@@ -55,8 +49,8 @@ 
    BooleDS
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    V1.name
    @@ -90,36 +84,32 @@

    Arguments

    should be of class numeric (1/0) or class logical (TRUE/FALSE).

    -
    -

    Value

    +
    +

    Value

    the levels of the input variable.

    -
    -

    Details

    +
    +

    Details

    The function converts the input vector into Boolean indicators.

    -
    -

    Author

    +
    +

    Author

    DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/BooleDS.md b/docs/reference/BooleDS.md new file mode 100644 index 00000000..179cbd6d --- /dev/null +++ b/docs/reference/BooleDS.md @@ -0,0 +1,60 @@ +# BooleDS + +Converts the individual elements of a vector or other object into +Boolean indicators. + +## Usage + +``` r +BooleDS( + V1.name = NULL, + V2.name = NULL, + Boolean.operator.n = NULL, + na.assign.text, + numeric.output = TRUE +) +``` + +## Arguments + +- V1.name: + + A character string specifying the name of the vector to which the + Boolean operator is to be applied + +- V2.name: + + A character string specifying the name of the vector or scalar to + which \ is to be compared. + +- Boolean.operator.n: + + An integer value (1 to 6) providing a numeric coding for the character + string specifying one of six possible Boolean operators: '==', '!=', + '\>', '\>=','\<', '\<=' that could legally be passed from client to + server via DataSHIELD parser + +- na.assign.text: + + A character string taking values 'NA', '1' or '0'. If 'NA' then any NA + values in the input vector remain as NAs in the output vector. If '1' + or '0' NA values in the input vector are all converted to 1 or 0 + respectively. + +- numeric.output: + + a TRUE/FALSE indicator defaulting to TRUE determining whether the + final output variable should be of class numeric (1/0) or class + logical (TRUE/FALSE). + +## Value + +the levels of the input variable. + +## Details + +The function converts the input vector into Boolean indicators. + +## Author + +DataSHIELD Development Team diff --git a/docs/reference/absDS.html b/docs/reference/absDS.html index cb618048..f9e2417f 100644 --- a/docs/reference/absDS.html +++ b/docs/reference/absDS.html @@ -1,94 +1,83 @@ -Computes the absolute values of the input variable — absDS • dsBase - - -
    -
    -
    -
    -

    Computes the absolute values of the input variable

    + - + + + +
    +
    +
    +
    + +

    Computes the absolute values of the input variable

    + +
    absDS.Rd
    -
    +

    This function is similar to R function abs.

    -
    +
    +

    Usage

    absDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of a numeric or integer vector

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument of ds.abs (or default name abs.newobj) which is written to the serverside. The output object is of class numeric or integer.

    -
    -

    Details

    +
    +

    Details

    The function computes the absolute values of an input numeric or integer vector.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/absDS.md b/docs/reference/absDS.md new file mode 100644 index 00000000..d1c88d8e --- /dev/null +++ b/docs/reference/absDS.md @@ -0,0 +1,30 @@ +# Computes the absolute values of the input variable + +This function is similar to R function `abs`. + +## Usage + +``` r +absDS(x) +``` + +## Arguments + +- x: + + a string character, the name of a numeric or integer vector + +## Value + +the object specified by the `newobj` argument of `ds.abs` (or default +name `abs.newobj`) which is written to the serverside. The output object +is of class numeric or integer. + +## Details + +The function computes the absolute values of an input numeric or integer +vector. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/asCharacterDS.html b/docs/reference/asCharacterDS.html index ad7fee82..d5e1dd32 100644 --- a/docs/reference/asCharacterDS.html +++ b/docs/reference/asCharacterDS.html @@ -1,54 +1,47 @@ -Coerces an R object into class character — asCharacterDS • dsBase - - -
    -
    -
    -
    -

    Coerces an R object into class character

    + - + + + +
    +
    +
    +
    + +

    Coerces an R object into class character

    + +
    asCharacterDS.Rd
    -
    +

    this function is based on the native R function as.character

    -
    +
    +

    Usage

    asCharacterDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -58,38 +51,34 @@

    Arguments

    ds.asCharacter

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument (or its default name "ascharacter.newobj") which is written to the serverside. For further details see help on the clientside function ds.asCharacter

    -
    -

    Details

    +
    +

    Details

    See help for function as.character in native R

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asCharacterDS.md b/docs/reference/asCharacterDS.md new file mode 100644 index 00000000..6f9301e7 --- /dev/null +++ b/docs/reference/asCharacterDS.md @@ -0,0 +1,33 @@ +# Coerces an R object into class character + +this function is based on the native R function `as.character` + +## Usage + +``` r +asCharacterDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class character. Must be + specified in inverted commas. But this argument is usually specified + directly by `x.name` argument of the clientside function + `ds.asCharacter` + +## Value + +the object specified by the `newobj` argument (or its default name +"ascharacter.newobj") which is written to the serverside. For further +details see help on the clientside function `ds.asCharacter` + +## Details + +See help for function `as.character` in native R + +## Author + +Amadou Gaye, Paul Burton, Demetris Avraam for DataSHIELD Development +Team diff --git a/docs/reference/asDataMatrixDS.html b/docs/reference/asDataMatrixDS.html index 043d39ca..6f441126 100644 --- a/docs/reference/asDataMatrixDS.html +++ b/docs/reference/asDataMatrixDS.html @@ -1,56 +1,50 @@ -asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS • dsBase - - -
    -
    -
    -
    -

    asDataMatrixDS a serverside assign function called by ds.asDataMatrix

    + - + + + +
    +
    +
    +
    + +

    asDataMatrixDS a serverside assign function called by ds.asDataMatrix

    + +
    asDataMatrixDS.Rd
    -
    +

    Coerces an R object into a matrix maintaining original class for all columns in data.frames.

    -
    +
    +

    Usage

    asDataMatrixDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -60,14 +54,14 @@

    Arguments

    ds.asDataMatrix

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name "asdatamatrix.newobj") which is written to the serverside. For further details see help on the clientside function ds.asDataMatrix

    -
    -

    Details

    +
    +

    Details

    This assign function is based on the native R function data.matrix If applied to a data.frame, the native R function as.matrix converts all columns into character class. In contrast, if applied to @@ -75,28 +69,24 @@

    Details

    the data.frame to a matrix but maintains all data columns in their original class

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asDataMatrixDS.md b/docs/reference/asDataMatrixDS.md new file mode 100644 index 00000000..e67e9f7c --- /dev/null +++ b/docs/reference/asDataMatrixDS.md @@ -0,0 +1,37 @@ +# asDataMatrixDS a serverside assign function called by ds.asDataMatrix + +Coerces an R object into a matrix maintaining original class for all +columns in data.frames. + +## Usage + +``` r +asDataMatrixDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class data.matrix. Must + be specified in inverted commas. But this argument is usually + specified directly by \ argument of the clientside function + `ds.asDataMatrix` + +## Value + +the object specified by the \ argument (or its default name +"asdatamatrix.newobj") which is written to the serverside. For further +details see help on the clientside function `ds.asDataMatrix` + +## Details + +This assign function is based on the native R function `data.matrix` If +applied to a data.frame, the native R function `as.matrix` converts all +columns into character class. In contrast, if applied to a data.frame +the native R function `data.matrix` converts the data.frame to a matrix +but maintains all data columns in their original class + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/asFactorDS1.html b/docs/reference/asFactorDS1.html index 5fc2e8c2..27ad0cf7 100644 --- a/docs/reference/asFactorDS1.html +++ b/docs/reference/asFactorDS1.html @@ -1,90 +1,80 @@ -Determines the levels of the input variable in each single study — asFactorDS1 • dsBase - - -
    -
    -
    -
    -

    Determines the levels of the input variable in each single study

    + - + + + +
    +
    +
    +
    + +

    Determines the levels of the input variable in each single study

    + +
    asFactorDS1.Rd
    -
    +

    This function is an aggregate DataSHIELD function that returns the levels of the input variable from each single study to the client-side function.

    -
    +
    +

    Usage

    asFactorDS1(input.var.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name

    the name of the variable that is to be converted to a factor.

    -
    -

    Value

    +
    +

    Value

    the levels of the input variable.

    -
    -

    Details

    +
    +

    Details

    The function encodes the input vector as factor and returns its levels in ascending order if the levels are numerical or in alphabetical order if the levels are of type character.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asFactorDS1.md b/docs/reference/asFactorDS1.md new file mode 100644 index 00000000..f2d57bee --- /dev/null +++ b/docs/reference/asFactorDS1.md @@ -0,0 +1,27 @@ +# Determines the levels of the input variable in each single study + +This function is an aggregate DataSHIELD function that returns the +levels of the input variable from each single study to the client-side +function. + +## Usage + +``` r +asFactorDS1(input.var.name = NULL) +``` + +## Arguments + +- input.var.name: + + the name of the variable that is to be converted to a factor. + +## Value + +the levels of the input variable. + +## Details + +The function encodes the input vector as factor and returns its levels +in ascending order if the levels are numerical or in alphabetical order +if the levels are of type character. diff --git a/docs/reference/asFactorDS2.html b/docs/reference/asFactorDS2.html index 8fc3ef70..341be85b 100644 --- a/docs/reference/asFactorDS2.html +++ b/docs/reference/asFactorDS2.html @@ -1,51 +1,45 @@ -Converts a numeric vector into a factor — asFactorDS2 • dsBase - - -
    -
    -
    -
    -

    Converts a numeric vector into a factor

    + - + + + +
    +
    +
    +
    + +

    Converts a numeric vector into a factor

    + +
    asFactorDS2.Rd
    -
    +

    This function is an assign DataSHIELD function that converts a numeric vector into a factor type that presented as a vector or as a matrix with dummy variables.

    -
    +
    +

    Usage

    asFactorDS2(
   input.var.name = NULL,
   all.unique.levels.transmit = NULL,
@@ -54,8 +48,8 @@ 
    Converts a numeric vector into a factor
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name
    @@ -79,34 +73,30 @@

    Arguments

    matrix of dummy variables.

    -
    -

    Value

    +
    +

    Value

    an object of class factor

    -
    -

    Details

    +
    +

    Details

    The functions converts the input variable into a factor which is presented as a vector if the fixed.dummy.vars is set to FALSE or as a matrix with dummy variables if the fixed.dummy.vars is set to TRUE (see the help file of ds.asFactor.b for more details).

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asFactorDS2.md b/docs/reference/asFactorDS2.md new file mode 100644 index 00000000..5d982fbb --- /dev/null +++ b/docs/reference/asFactorDS2.md @@ -0,0 +1,51 @@ +# Converts a numeric vector into a factor + +This function is an assign DataSHIELD function that converts a numeric +vector into a factor type that presented as a vector or as a matrix with +dummy variables. + +## Usage + +``` r +asFactorDS2( + input.var.name = NULL, + all.unique.levels.transmit = NULL, + fixed.dummy.vars = NULL, + baseline.level = NULL +) +``` + +## Arguments + +- input.var.name: + + the name of the variable that is to be converted to a factor. + +- all.unique.levels.transmit: + + the levels that the variable will be transmitted to. + +- fixed.dummy.vars: + + a boolean that determines whether the new object will be represented + as a vector or as a matrix of dummy variables indicating the factor + level of each data point. If this argument is set to FALSE (default) + then the input variable is converted to a factor and assigned as a + vector. If is set to TRUE then the input variable is converted to a + factor but assigned as a matrix of dummy variables. + +- baseline.level: + + a number indicating the baseline level to be used in the creation of + the matrix of dummy variables. + +## Value + +an object of class factor + +## Details + +The functions converts the input variable into a factor which is +presented as a vector if the `fixed.dummy.vars` is set to FALSE or as a +matrix with dummy variables if the `fixed.dummy.vars` is set to TRUE +(see the help file of ds.asFactor.b for more details). diff --git a/docs/reference/asFactorSimpleDS.html b/docs/reference/asFactorSimpleDS.html index 999c986c..b9bad8ba 100644 --- a/docs/reference/asFactorSimpleDS.html +++ b/docs/reference/asFactorSimpleDS.html @@ -1,68 +1,62 @@ -Converts a numeric vector into a factor — asFactorSimpleDS • dsBase - - -
    -
    -
    -
    -

    Converts a numeric vector into a factor

    + - + + + +
    +
    +
    +
    + +

    Converts a numeric vector into a factor

    + +
    asFactorSimpleDS.Rd
    -
    +

    This function is an assign DataSHIELD function that coerces a numeric or character vector into a factor

    -
    +
    +

    Usage

    asFactorSimpleDS(input.var.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name

    the name of the variable that is to be converted to a factor.

    -
    -

    Value

    +
    +

    Value

    an object of class factor

    -
    -

    Details

    +
    +

    Details

    The functions converts the input variable into a factor. Unlike ds.asFactor and its serverside functions, ds.asFactorSimple does no more than coerce the class of a variable to factor in each study. It does not check for @@ -73,23 +67,19 @@

    Details

    of these things you will have to use the ds.asFactor function.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asFactorSimpleDS.md b/docs/reference/asFactorSimpleDS.md new file mode 100644 index 00000000..421ef160 --- /dev/null +++ b/docs/reference/asFactorSimpleDS.md @@ -0,0 +1,32 @@ +# Converts a numeric vector into a factor + +This function is an assign DataSHIELD function that coerces a numeric or +character vector into a factor + +## Usage + +``` r +asFactorSimpleDS(input.var.name = NULL) +``` + +## Arguments + +- input.var.name: + + the name of the variable that is to be converted to a factor. + +## Value + +an object of class factor + +## Details + +The functions converts the input variable into a factor. Unlike +ds.asFactor and its serverside functions, ds.asFactorSimple does no more +than coerce the class of a variable to factor in each study. It does not +check for or enforce consistency of factor levels across sources or +allow you to force an arbitrary set of levels unless those levels +actually exist in the sources. In addition, it does not allow you to +create an array of binary dummy variables that is equivalent to a +factor. If you need to do any of these things you will have to use the +ds.asFactor function. diff --git a/docs/reference/asIntegerDS.html b/docs/reference/asIntegerDS.html index 77292901..ca0b3b14 100644 --- a/docs/reference/asIntegerDS.html +++ b/docs/reference/asIntegerDS.html @@ -1,54 +1,47 @@ -Coerces an R object into class integer — asIntegerDS • dsBase - - -
    -
    -
    -
    -

    Coerces an R object into class integer

    + - + + + +
    +
    +
    +
    + +

    Coerces an R object into class integer

    + +
    asIntegerDS.Rd
    -
    +

    This function is based on the native R function as.integer.

    -
    +
    +

    Usage

    asIntegerDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -58,39 +51,35 @@

    Arguments

    ds.asInteger.

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name "asinteger.newobj") which is written to the serverside. For further details see help on the clientside function ds.asInteger.

    -
    -

    Details

    +
    +

    Details

    See help for function as.integer in native R, and details section in the help file of the clientside function ds.asInteger.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton, Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asIntegerDS.md b/docs/reference/asIntegerDS.md new file mode 100644 index 00000000..79ae9679 --- /dev/null +++ b/docs/reference/asIntegerDS.md @@ -0,0 +1,34 @@ +# Coerces an R object into class integer + +This function is based on the native R function `as.integer`. + +## Usage + +``` r +asIntegerDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class integer. Must be + specified in inverted commas. But this argument is usually specified + directly by \ argument of the clientside function + `ds.asInteger`. + +## Value + +the object specified by the \ argument (or its default name +"asinteger.newobj") which is written to the serverside. For further +details see help on the clientside function `ds.asInteger`. + +## Details + +See help for function `as.integer` in native R, and details section in +the help file of the clientside function `ds.asInteger`. + +## Author + +Amadou Gaye, Paul Burton, Demetris Avraam, for DataSHIELD Development +Team diff --git a/docs/reference/asListDS.html b/docs/reference/asListDS.html index 65cdc968..b91d222d 100644 --- a/docs/reference/asListDS.html +++ b/docs/reference/asListDS.html @@ -1,54 +1,47 @@ -asListDS a serverside aggregate function called by ds.asList — asListDS • dsBase - - -
    -
    -
    -
    -

    asListDS a serverside aggregate function called by ds.asList

    + - + + + +
    +
    +
    +
    + +

    asListDS a serverside aggregate function called by ds.asList

    + +
    asListDS.Rd
    -
    +

    Coerces an R object into a list

    -
    +
    +

    Usage

    asListDS(x.name, newobj)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -63,8 +56,8 @@

    Arguments

    function written to the serverside

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name <x.name>.mat) which is written to the serverside. In addition, two validity messages are returned. The first confirms an output @@ -72,8 +65,8 @@

    Value

    coerces objects to list depends on the class of the object, but in general the class of the output object should usually be 'list'

    -
    -

    Details

    +
    +

    Details

    Unlike most other class coercing functions this is an aggregate function rather than an assign function. This is because the datashield.assign function in the data repository deals specially with @@ -82,28 +75,24 @@

    Details

    This aggregate function is based on the native R function as.list and so additional information can be found in the help for as.list

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asListDS.md b/docs/reference/asListDS.md new file mode 100644 index 00000000..b3d25351 --- /dev/null +++ b/docs/reference/asListDS.md @@ -0,0 +1,46 @@ +# asListDS a serverside aggregate function called by ds.asList + +Coerces an R object into a list + +## Usage + +``` r +asListDS(x.name, newobj) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class data.matrix. Must + be specified in inverted commas. But this argument is usually + specified directly by \ argument of the clientside function + `ds.asList` + +- newobj: + + is the object hard assigned '\<\<-' to be the output of the function + written to the serverside + +## Value + +the object specified by the \ argument (or its default name +\.mat) which is written to the serverside. In addition, two +validity messages are returned. The first confirms an output object has +been created, the second states its class. The way that `as.list` +coerces objects to list depends on the class of the object, but in +general the class of the output object should usually be 'list' + +## Details + +Unlike most other class coercing functions this is an aggregate function +rather than an assign function. This is because the `datashield.assign` +function in the data repository deals specially with a created object +(newobj) if it is of class list. Reconfiguring the function as an +aggregate function works around this problem. This aggregate function is +based on the native R function `as.list` and so additional information +can be found in the help for `as.list` + +## Author + +Amadou Gaye, Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/asLogicalDS.html b/docs/reference/asLogicalDS.html index 1f6ab041..026dedb0 100644 --- a/docs/reference/asLogicalDS.html +++ b/docs/reference/asLogicalDS.html @@ -1,54 +1,47 @@ -Coerces an R object into class numeric — asLogicalDS • dsBase - - -
    -
    -
    -
    -

    Coerces an R object into class numeric

    + - + + + +
    +
    +
    +
    + +

    Coerces an R object into class numeric

    + +
    asLogicalDS.Rd
    -
    +

    this function is based on the native R function as.numeric

    -
    +
    +

    Usage

    asLogicalDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -58,38 +51,34 @@

    Arguments

    ds.aslogical

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name <x.name>.logic) which is written to the serverside. For further details see help on the clientside function ds.asLogical

    -
    -

    Details

    +
    +

    Details

    See help for function as.logical in native R

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asLogicalDS.md b/docs/reference/asLogicalDS.md new file mode 100644 index 00000000..1632a7d5 --- /dev/null +++ b/docs/reference/asLogicalDS.md @@ -0,0 +1,32 @@ +# Coerces an R object into class numeric + +this function is based on the native R function `as.numeric` + +## Usage + +``` r +asLogicalDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class numeric. Must be + specified in inverted commas. But this argument is usually specified + directly by \ argument of the clientside function + `ds.aslogical` + +## Value + +the object specified by the \ argument (or its default name +\.logic) which is written to the serverside. For further +details see help on the clientside function `ds.asLogical` + +## Details + +See help for function `as.logical` in native R + +## Author + +Amadou Gaye, Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/asMatrixDS.html b/docs/reference/asMatrixDS.html index 24e13348..c6b61439 100644 --- a/docs/reference/asMatrixDS.html +++ b/docs/reference/asMatrixDS.html @@ -1,54 +1,47 @@ -Coerces an R object into a matrix — asMatrixDS • dsBase - - -
    -
    -
    -
    -

    Coerces an R object into a matrix

    + - + + + +
    +
    +
    +
    + +

    Coerces an R object into a matrix

    + +
    asMatrixDS.Rd
    -
    +

    this function is based on the native R function as.matrix

    -
    +
    +

    Usage

    asMatrixDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -58,38 +51,34 @@

    Arguments

    ds.asMatrix

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name <x.name>.mat) which is written to the serverside. For further details see help on the clientside function ds.asMatrix

    -
    -

    Details

    +
    +

    Details

    See help for function as.matrix in native R

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asMatrixDS.md b/docs/reference/asMatrixDS.md new file mode 100644 index 00000000..3f600741 --- /dev/null +++ b/docs/reference/asMatrixDS.md @@ -0,0 +1,32 @@ +# Coerces an R object into a matrix + +this function is based on the native R function `as.matrix` + +## Usage + +``` r +asMatrixDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class matrix. Must be + specified in inverted commas. But this argument is usually specified + directly by \ argument of the clientside function + `ds.asMatrix` + +## Value + +the object specified by the \ argument (or its default name +\.mat) which is written to the serverside. For further details +see help on the clientside function `ds.asMatrix` + +## Details + +See help for function `as.matrix` in native R + +## Author + +Amadou Gaye, Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/asNumericDS.html b/docs/reference/asNumericDS.html index 9f8e3871..214f9727 100644 --- a/docs/reference/asNumericDS.html +++ b/docs/reference/asNumericDS.html @@ -1,54 +1,47 @@ -Coerces an R object into class numeric — asNumericDS • dsBase - - -
    -
    -
    -
    -

    Coerces an R object into class numeric

    + - + + + +
    +
    +
    +
    + +

    Coerces an R object into class numeric

    + +
    asNumericDS.Rd
    -
    +

    This function is based on the native R function as.numeric.

    -
    +
    +

    Usage

    asNumericDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -58,39 +51,35 @@

    Arguments

    ds.asNumeric.

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or its default name <x.name>.num) which is written to the serverside. For further details see help on the clientside function ds.asNumeric.

    -
    -

    Details

    +
    +

    Details

    See help for function as.numeric in native R, and details section in the help file of the clientside function ds.asNumeric.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton, Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/asNumericDS.md b/docs/reference/asNumericDS.md new file mode 100644 index 00000000..4277dbfc --- /dev/null +++ b/docs/reference/asNumericDS.md @@ -0,0 +1,34 @@ +# Coerces an R object into class numeric + +This function is based on the native R function `as.numeric`. + +## Usage + +``` r +asNumericDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be coerced to class numeric. Must be + specified in inverted commas. But this argument is usually specified + directly by \ argument of the clientside function + `ds.asNumeric`. + +## Value + +the object specified by the \ argument (or its default name +\.num) which is written to the serverside. For further details +see help on the clientside function `ds.asNumeric`. + +## Details + +See help for function `as.numeric` in native R, and details section in +the help file of the clientside function `ds.asNumeric`. + +## Author + +Amadou Gaye, Paul Burton, Demetris Avraam, for DataSHIELD Development +Team diff --git a/docs/reference/aucDS.html b/docs/reference/aucDS.html index d031f39e..619818b6 100644 --- a/docs/reference/aucDS.html +++ b/docs/reference/aucDS.html @@ -1,56 +1,50 @@ -aucDS an aggregate function called by ds.auc — aucDS • dsBase - - -
    -
    -
    -
    -

    aucDS an aggregate function called by ds.auc

    + - + + + +
    +
    +
    +
    + +

    aucDS an aggregate function called by ds.auc

    + +
    aucDS.Rd
    -
    +

    This function calculates the C-statistic or AUC for logistic regression models.

    -
    +
    +

    Usage

    aucDS(pred = pred, y = y)
    -
    -

    Arguments

    +
    +

    Arguments

    pred
    @@ -62,36 +56,32 @@

    Arguments

    the complete cases that are used in the regression model.

    -
    -

    Value

    +
    +

    Value

    returns the AUC and its standard error

    -
    -

    Details

    +
    +

    Details

    The AUC determines the discriminative ability of a model.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/aucDS.md b/docs/reference/aucDS.md new file mode 100644 index 00000000..329f0c49 --- /dev/null +++ b/docs/reference/aucDS.md @@ -0,0 +1,33 @@ +# aucDS an aggregate function called by ds.auc + +This function calculates the C-statistic or AUC for logistic regression +models. + +## Usage + +``` r +aucDS(pred = pred, y = y) +``` + +## Arguments + +- pred: + + the name of the vector of the predicted values + +- y: + + the name of the outcome variable. Note that this variable should + include the complete cases that are used in the regression model. + +## Value + +returns the AUC and its standard error + +## Details + +The AUC determines the discriminative ability of a model. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/blackBoxDS.html b/docs/reference/blackBoxDS.html index 29be83ec..10af157f 100644 --- a/docs/reference/blackBoxDS.html +++ b/docs/reference/blackBoxDS.html @@ -1,56 +1,50 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — blackBoxDS • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + - + + + +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    blackBoxDS.Rd
    -
    +

    The first key serverside function that sets up the V2BR for ranking in the client.

    -
    +
    +

    Usage

    blackBoxDS(input.var.name = NULL, shared.seedval, synth.real.ratio, NA.manage)
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name
    @@ -87,16 +81,16 @@

    Arguments

    for ds.ranksSecure.

    -
    -

    Value

    +
    +

    Value

    writes a data frame object entitled blackbox.output.df to the serverside. In each study this contains the encrypted "combined real+pseudo data vector" and a range of other key components from the first stage of the ranking procedure. For more details see the associated document entitled "secure.global.ranking.docx"

    -
    -

    Details

    +
    +

    Details

    Severside assign function called by ds.ranksSecure. Creates pseudo-data by using the real distribution of values in V2BR to create a large number of synthetic data with a similar distribution to @@ -117,28 +111,24 @@

    Details

    see the associated document entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/blackBoxDS.md b/docs/reference/blackBoxDS.md new file mode 100644 index 00000000..5261428c --- /dev/null +++ b/docs/reference/blackBoxDS.md @@ -0,0 +1,81 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +The first key serverside function that sets up the V2BR for ranking in +the client. + +## Usage + +``` r +blackBoxDS(input.var.name = NULL, shared.seedval, synth.real.ratio, NA.manage) +``` + +## Arguments + +- input.var.name: + + a character string specifying the name of V2BR. This argument is set + by the argument with the same name in the clientside function + ds.ranksSecure + +- shared.seedval: + + a pseudorandom number seed that ensures that the processes generating + the order and parameterisation of the encryption algorithms are the + same in each study. This argument is set by the argument + \ in the clientside function ds.ranksSecure. For + more details, including future plans to share this starting seed in a + more secure way, please see the associated document entitled + "secure.global.ranking.docx" and the header file for ds.ranksSecure. + +- synth.real.ratio: + + an integer value representing the ratio of synthetic (pseudo-data) + values to the real number of values in V2BR. This argument is set by + the argument with the same name in the clientside function + ds.ranksSecure. For more details, please see the associated document + entitled "secure.global.ranking.docx" and the header file for + ds.ranksSecure. + +- NA.manage: + + character string indicating how missing values (NAs) in V2BR should be + managed. It takes three possible values: "NA.delete", + "NA.low","NA.hi". This argument is set by the argument with the same + name in the clientside function ds.ranksSecure. For more details, + please see the associated document entitled + "secure.global.ranking.docx" and the header file for ds.ranksSecure. + +## Value + +writes a data frame object entitled blackbox.output.df to the +serverside. In each study this contains the encrypted "combined +real+pseudo data vector" and a range of other key components from the +first stage of the ranking procedure. For more details see the +associated document entitled "secure.global.ranking.docx" + +## Details + +Severside assign function called by ds.ranksSecure. Creates pseudo-data +by using the real distribution of values in V2BR to create a large +number of synthetic data with a similar distribution to the values in +V2BR but with a slightly broader distribution at both ends to ensure +that any extreme values in the "combined real+pseudo data vector" are +all pseudo-data. Also ensures that the number of decimal places of the +values in the V2BR is reflected by the number of decimal places in the +pseudodata. Finally, takes the "combined real+pseudo data vector" +through seven rounds of rank consistent encryption that involves +algorithms themselves generated by a pseudorandom process that selects +which transformation to apply and with what parameters. The encryption +algorithms are the same in each study ensuring that ranks also remain +consistent between studies. After encryption the encrypted "combined +real+pseudo data vector" is written to the serverside as a dataframe +also including other key component vectors from the first stage of the +ranking procedure. For more details about the cluster of functions that +collectively enable secure global ranking and estimation of global +quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/blackBoxRanksDS.html b/docs/reference/blackBoxRanksDS.html index a552e899..dbf3c955 100644 --- a/docs/reference/blackBoxRanksDS.html +++ b/docs/reference/blackBoxRanksDS.html @@ -1,60 +1,56 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — blackBoxRanksDS • dsBaseSecure ranking of "V2BR" (vector to be ranked) across all sources — blackBoxRanksDS • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    - +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    blackBoxRanksDS.Rd
    -
    +

    The second key serverside function that prepares the global ranks of the the real data only generated in the first stage of the ranking procedure and encrypts them in preparation for generating global ranks that correspond 1 to 1 with only the real data in V2BR.

    -
    +
    +

    Usage

    blackBoxRanksDS(input.var.name = NULL, shared.seedval)
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name
    @@ -77,16 +73,16 @@

    Arguments

    and the header file for ds.ranksSecure.

    -
    -

    Value

    +
    +

    Value

    writes a data frame object entitled blackbox.ranks.df to the serverside. In each study this contains the encrypted global ranks and a range of other key components from the second stage (ranking of global ranks for real observations only) of the ranking procedure. For more details see the associated document entitled "secure.global.ranking.docx"

    -
    -

    Details

    +
    +

    Details

    Severside assign function called by ds.ranksSecure. It takes the global ranks currently held in sR5.df which reflect the global ranks based on the "combined real+pseudo data vector" as encrypted by blackBoxDS @@ -109,28 +105,24 @@

    Details

    see the associated document entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure and the header file for blackBoxDS

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/blackBoxRanksDS.md b/docs/reference/blackBoxRanksDS.md new file mode 100644 index 00000000..5634fd90 --- /dev/null +++ b/docs/reference/blackBoxRanksDS.md @@ -0,0 +1,71 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +The second key serverside function that prepares the global ranks of the +the real data only generated in the first stage of the ranking procedure +and encrypts them in preparation for generating global ranks that +correspond 1 to 1 with only the real data in V2BR. + +## Usage + +``` r +blackBoxRanksDS(input.var.name = NULL, shared.seedval) +``` + +## Arguments + +- input.var.name: + + a character string specifying the name of the vector holding the + global ranks. This argument is set automatically by the clientside + function ds.ranksSecure + +- shared.seedval: + + a pseudorandom number seed that ensures that the processes generating + the order and parameterisation of the encryption algorithms are the + same in each study. This argument is set by the argument + \ in the clientside function ds.ranksSecure. The + seed value shared by all studies in setting up the encryption + procedures in blackBoxRanksDS is arbitrarily changed from that used to + set up the encryption procedures in blackBoxDS, so the the set of 7 + encryption algorithms is deliberately different. For more details, + including future plans to share this starting seed in a more secure + way, please see the associated document entitled + "secure.global.ranking.docx" and the header file for ds.ranksSecure. + +## Value + +writes a data frame object entitled blackbox.ranks.df to the serverside. +In each study this contains the encrypted global ranks and a range of +other key components from the second stage (ranking of global ranks for +real observations only) of the ranking procedure. For more details see +the associated document entitled "secure.global.ranking.docx" + +## Details + +Severside assign function called by ds.ranksSecure. It takes the global +ranks currently held in sR5.df which reflect the global ranks based on +the "combined real+pseudo data vector" as encrypted by blackBoxDS but +with all pseudo-data stripped out. It then uses these global ranks (of +the real data) as if they were a new variable to be ranked. This is then +equivalent to blackBoxDS with the primary difference that no pseudo-data +are needed. This is because the global ranks are fundamentally +non-disclosive and so can be transferred to the clientside with no risk +of disclosure. However, in order to ensure that the client cannot +compare the list of global.ranks in sR4.df (after initial global ranking +based on ranking of real and pseudo-data combined) with the global.ranks +to be generated by blackBoxRanksDS (based solely on the real data they +are processed through seven more rounds of encryption as before in +blackBoxDS. In consequence the client remains unable to determine which +of the original global ranks corresponded to real data and which to +pseudo-data. In addition, blackBoxRanksDS does not need to determine the +number of decimal places in the data because it is only applied to ranks +which are assumed to be integers. For more details about the cluster of +functions that collectively enable secure global ranking and estimation +of global quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure and the header file for blackBoxDS + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/boxPlotGGDS.html b/docs/reference/boxPlotGGDS.html index be71d316..ed19da2e 100644 --- a/docs/reference/boxPlotGGDS.html +++ b/docs/reference/boxPlotGGDS.html @@ -1,60 +1,56 @@ -Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS • dsBaseCreate the identity stats and necessary data to draw a plot on the client — boxPlotGGDS • dsBase - - -
    -
    -
    -
    -

    Create the identity stats and necessary data to draw a plot on the client

    - +
    +
    +
    +
    + +

    Create the identity stats and necessary data to draw a plot on the client

    + +
    boxPlotGGDS.Rd
    -
    +

    In order to create a non disclosive box plot, the data that is passed to the client is purely geometrical aspects of the plot, as a ggplot object contains all the data inside, only the graphical parameters are passed. There are three different cases depending if there are grouping variables. The outliers are also removed from the graphical parameters.

    -
    +
    +

    Usage

    boxPlotGGDS(data_table, group = NULL, group2 = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    data_table
    @@ -73,30 +69,26 @@

    Arguments

    character (default NULL) Name of the second grouping variable.

    -
    -

    Value

    +
    +

    Value

    list with:
    -data frame Geometrical parameters (identity stats of ggplot)
    -character Type of plot (single_group, double_group or no_group)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/boxPlotGGDS.md b/docs/reference/boxPlotGGDS.md new file mode 100644 index 00000000..5a0c7d28 --- /dev/null +++ b/docs/reference/boxPlotGGDS.md @@ -0,0 +1,41 @@ +# Create the identity stats and necessary data to draw a plot on the client + +In order to create a non disclosive box plot, the data that is passed to +the client is purely geometrical aspects of the plot, as a ggplot object +contains all the data inside, only the graphical parameters are passed. +There are three different cases depending if there are grouping +variables. The outliers are also removed from the graphical parameters. + +## Usage + +``` r +boxPlotGGDS(data_table, group = NULL, group2 = NULL) +``` + +## Arguments + +- data_table: + + `data frame` Table that holds the information to be plotted, arranged + as: + + Column 'x': Names on the X axis of the boxplot, aka variables to + plot + Column 'value': Values for that variable (raw data of columns + rbinded) + Column 'group': (Optional) Values of the grouping variable + Column 'group2': (Optional) Values of the second grouping variable + +- group: + + `character` (default `NULL`) Name of the first grouping variable. + +- group2: + + `character` (default `NULL`) Name of the second grouping variable. + +## Value + +`list` with: +-`data frame` Geometrical parameters (identity stats of ggplot) +-`character` Type of plot (single_group, double_group or no_group) diff --git a/docs/reference/boxPlotGG_data_TreatmentDS.html b/docs/reference/boxPlotGG_data_TreatmentDS.html index b7afc848..84140381 100644 --- a/docs/reference/boxPlotGG_data_TreatmentDS.html +++ b/docs/reference/boxPlotGG_data_TreatmentDS.html @@ -1,54 +1,47 @@ -Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS • dsBase - - -
    -
    -
    -
    -

    Arrange data frame to pass it to the boxplot function

    + - + + + +
    +
    +
    +
    + +

    Arrange data frame to pass it to the boxplot function

    + +
    boxPlotGG_data_TreatmentDS.Rd
    -
    +

    Arrange data frame to pass it to the boxplot function

    -
    +
    +

    Usage

    boxPlotGG_data_TreatmentDS(table, variables, group = NULL, group2 = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    table
    @@ -67,8 +60,8 @@

    Arguments

    character (default NULL) Name of the second grouping variable.

    -
    -

    Value

    +
    +

    Value

    data frame with the following structure:

    Column 'x': Names on the X axis of the boxplot, aka variables to plot
    Column 'value': Values for that variable (raw data of columns rbinded)
    @@ -76,23 +69,19 @@

    Value

    Column 'group2': (Optional) Values of the second grouping variable

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/boxPlotGG_data_TreatmentDS.md b/docs/reference/boxPlotGG_data_TreatmentDS.md new file mode 100644 index 00000000..4bcbf375 --- /dev/null +++ b/docs/reference/boxPlotGG_data_TreatmentDS.md @@ -0,0 +1,37 @@ +# Arrange data frame to pass it to the boxplot function + +Arrange data frame to pass it to the boxplot function + +## Usage + +``` r +boxPlotGG_data_TreatmentDS(table, variables, group = NULL, group2 = NULL) +``` + +## Arguments + +- table: + + `data frame` Table that holds the information to be plotted later + +- variables: + + `character vector` Name of the column(s) of the data frame to include + on the boxplot + +- group: + + `character` (default `NULL`) Name of the first grouping variable. + +- group2: + + `character` (default `NULL`) Name of the second grouping variable. + +## Value + +`data frame` with the following structure: + +Column 'x': Names on the X axis of the boxplot, aka variables to plot +Column 'value': Values for that variable (raw data of columns rbinded) +Column 'group': (Optional) Values of the grouping variable +Column 'group2': (Optional) Values of the second grouping variable diff --git a/docs/reference/boxPlotGG_data_Treatment_numericDS.html b/docs/reference/boxPlotGG_data_Treatment_numericDS.html index 7d6902ab..1592cfbd 100644 --- a/docs/reference/boxPlotGG_data_Treatment_numericDS.html +++ b/docs/reference/boxPlotGG_data_Treatment_numericDS.html @@ -1,84 +1,73 @@ -Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS • dsBase - - -
    -
    -
    -
    -

    Arrange vector to pass it to the boxplot function

    + - + + + +
    +
    +
    +
    + +

    Arrange vector to pass it to the boxplot function

    + +
    boxPlotGG_data_Treatment_numericDS.Rd
    -
    +

    Arrange vector to pass it to the boxplot function

    -
    +
    +

    Usage

    boxPlotGG_data_Treatment_numericDS(vector)
    -
    -

    Arguments

    +
    +

    Arguments

    vector

    numeric vector Vector to arrange to be plotted later

    -
    -

    Value

    +
    +

    Value

    data frame with the following structure:

    Column 'x': Names on the X axis of the boxplot, aka name of the vector (vector argument)
    Column 'value': Values for that variable

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/boxPlotGG_data_Treatment_numericDS.md b/docs/reference/boxPlotGG_data_Treatment_numericDS.md new file mode 100644 index 00000000..8925f645 --- /dev/null +++ b/docs/reference/boxPlotGG_data_Treatment_numericDS.md @@ -0,0 +1,23 @@ +# Arrange vector to pass it to the boxplot function + +Arrange vector to pass it to the boxplot function + +## Usage + +``` r +boxPlotGG_data_Treatment_numericDS(vector) +``` + +## Arguments + +- vector: + + `numeric vector` Vector to arrange to be plotted later + +## Value + +`data frame` with the following structure: + +Column 'x': Names on the X axis of the boxplot, aka name of the vector +(vector argument) +Column 'value': Values for that variable diff --git a/docs/reference/bp_standardsDS.html b/docs/reference/bp_standardsDS.html index 18406769..12f2e923 100644 --- a/docs/reference/bp_standardsDS.html +++ b/docs/reference/bp_standardsDS.html @@ -1,55 +1,51 @@ -Calculates Blood pressure z-scores — bp_standardsDS • dsBaseCalculates Blood pressure z-scores — bp_standardsDS • dsBase - - -
    -
    -
    -
    -

    Calculates Blood pressure z-scores

    - +
    +
    +
    +
    + +

    Calculates Blood pressure z-scores

    + +
    bp_standardsDS.Rd
    -
    +

    The function calculates blood pressure z-scores in two steps: Step 1. Calculates z-score of height according to CDC growth chart (Not the WHO growth chart!). Step 2. Calculates z-score of BP according to the fourth report on BP management, USA

    -
    +
    +

    Usage

    bp_standardsDS(
   sex = sex,
   age = age,
@@ -59,8 +55,8 @@ 
    Calculates Blood pressure z-scores
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    sex
    @@ -88,39 +84,35 @@

    Arguments

    blood pressure.

    -
    -

    Value

    +
    +

    Value

    assigns a new object on the server-side. The assigned object is a list with two elements: the 'Zbp' which is the zscores of the blood pressure and 'perc' which is the percentiles of the BP zscores.

    -
    -

    Note

    +
    +

    Note

    The z-scores of height based on CDC growth charts are calculated by the sds function from the childsds R package.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/bp_standardsDS.md b/docs/reference/bp_standardsDS.md new file mode 100644 index 00000000..8cb92a08 --- /dev/null +++ b/docs/reference/bp_standardsDS.md @@ -0,0 +1,60 @@ +# Calculates Blood pressure z-scores + +The function calculates blood pressure z-scores in two steps: Step 1. +Calculates z-score of height according to CDC growth chart (Not the WHO +growth chart!). Step 2. Calculates z-score of BP according to the fourth +report on BP management, USA + +## Usage + +``` r +bp_standardsDS( + sex = sex, + age = age, + height = height, + bp = bp, + systolic = systolic +) +``` + +## Arguments + +- sex: + + the name of the sex variable. The variable should be coded as 1 for + males and 2 for females. If it is coded differently (e.g. 0/1), then + you can use the ds.recodeValues function to recode the categories to + 1/2 before the use of ds.bp_standards + +- age: + + the name of the age variable in years. + +- height: + + the name of the height variable in cm + +- bp: + + the name of the blood pressure variable. + +- systolic: + + logical. If TRUE (default) the function assumes conversion of systolic + blood pressure. If FALSE the function assumes conversion of diastolic + blood pressure. + +## Value + +assigns a new object on the server-side. The assigned object is a list +with two elements: the 'Zbp' which is the zscores of the blood pressure +and 'perc' which is the percentiles of the BP zscores. + +## Note + +The z-scores of height based on CDC growth charts are calculated by the +sds function from the childsds R package. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/cDS.html b/docs/reference/cDS.html index 410b22da..f212d31c 100644 --- a/docs/reference/cDS.html +++ b/docs/reference/cDS.html @@ -1,91 +1,80 @@ -Concatenates objects into a vector or list — cDS • dsBase - - -
    -
    -
    -
    -

    Concatenates objects into a vector or list

    + - + + + +
    +
    +
    +
    + +

    Concatenates objects into a vector or list

    + +
    cDS.Rd
    -
    +

    This function is similar to the R base function 'c'.

    -
    +
    +

    Usage

    cDS(objs)
    -
    -

    Arguments

    +
    +

    Arguments

    objs

    a list which contains the the objects to concatenate.

    -
    -

    Value

    +
    +

    Value

    a vector or list

    -
    -

    Details

    +
    +

    Details

    Unlike the R base function 'c' on vector or list of certain length are allowed as output

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/cDS.md b/docs/reference/cDS.md new file mode 100644 index 00000000..12e229e2 --- /dev/null +++ b/docs/reference/cDS.md @@ -0,0 +1,28 @@ +# Concatenates objects into a vector or list + +This function is similar to the R base function 'c'. + +## Usage + +``` r +cDS(objs) +``` + +## Arguments + +- objs: + + a list which contains the the objects to concatenate. + +## Value + +a vector or list + +## Details + +Unlike the R base function 'c' on vector or list of certain length are +allowed as output + +## Author + +Gaye, A. diff --git a/docs/reference/cbindDS.html b/docs/reference/cbindDS.html index c4be7c18..905ee861 100644 --- a/docs/reference/cbindDS.html +++ b/docs/reference/cbindDS.html @@ -1,58 +1,53 @@ -cbindDS called by ds.cbind — cbindDS • dsBasecbindDS called by ds.cbind — cbindDS • dsBase - - -
    -
    -
    -
    -

    cbindDS called by ds.cbind

    - +
    +
    +
    +
    + +

    cbindDS called by ds.cbind

    + +
    cbindDS.Rd
    -
    +

    serverside assign function that takes a sequence of vector, matrix or data-frame arguments and combines them by column to produce a data-frame.

    -
    +
    +

    Usage

    cbindDS(x.names.transmit = NULL, colnames.transmit = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x.names.transmit
    @@ -67,14 +62,14 @@

    Arguments

    column names for the output object converted into a transmittable format.

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument of ds.cbind (or default name cbind.newobj) which is written to the serverside. The output object is of class data.frame.

    -
    -

    Details

    +
    +

    Details

    A sequence of vector, matrix or data-frame arguments is combined column by column to produce a data-frame which is written to the serverside. A critical requirement is that @@ -83,28 +78,24 @@

    Details

    data.frame will then have this same number of rows. For more details see help for ds.cbind and the native R function cbind.

    -
    -

    Author

    +
    +

    Author

    Paul Burton and Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/cbindDS.md b/docs/reference/cbindDS.md new file mode 100644 index 00000000..8e6c31ea --- /dev/null +++ b/docs/reference/cbindDS.md @@ -0,0 +1,45 @@ +# cbindDS called by ds.cbind + +serverside assign function that takes a sequence of vector, matrix or +data-frame arguments and combines them by column to produce a +data-frame. + +## Usage + +``` r +cbindDS(x.names.transmit = NULL, colnames.transmit = NULL) +``` + +## Arguments + +- x.names.transmit: + + This is a vector of character strings representing the names of the + elemental components to be combined converted into a transmittable + format. This argument is fully specified by the `x` argument of the + client-side `ds.cbind` function. + +- colnames.transmit: + + This is a vector of character strings representing column names for + the output object converted into a transmittable format. + +## Value + +the object specified by the `newobj` argument of `ds.cbind` (or default +name `cbind.newobj`) which is written to the serverside. The output +object is of class data.frame. + +## Details + +A sequence of vector, matrix or data-frame arguments is combined column +by column to produce a data-frame which is written to the serverside. A +critical requirement is that the length of all component variables, and +the number of rows of the component data.frames or matrices must all be +the same. The output data.frame will then have this same number of rows. +For more details see help for `ds.cbind` and the native R function +`cbind`. + +## Author + +Paul Burton and Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/changeRefGroupDS.html b/docs/reference/changeRefGroupDS.html index 06ebb201..499ff8e4 100644 --- a/docs/reference/changeRefGroupDS.html +++ b/docs/reference/changeRefGroupDS.html @@ -1,54 +1,47 @@ -Changes a reference level of a factor — changeRefGroupDS • dsBase - - -
    -
    -
    -
    -

    Changes a reference level of a factor

    + - + + + +
    +
    +
    +
    + +

    Changes a reference level of a factor

    + +
    changeRefGroupDS.Rd
    -
    +

    This function is similar to R function relevel,

    -
    +
    +

    Usage

    changeRefGroupDS(xvect, ref = NULL, reorderByRef = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -64,12 +57,12 @@

    Arguments

    vector should be ordered by the reference group.

    -
    -

    Value

    +
    +

    Value

    a factor of the same length as xvect

    -
    -

    Details

    +
    +

    Details

    In addition to what the R function does, this function allows for the user to re-order the vector, putting the reference group first. If the user chooses the re-order a warning is issued @@ -77,28 +70,24 @@

    Details

    into a table that is not reordered in the same way. Such mismatch can render the results of operations on that table invalid.

    -
    -

    Author

    +
    +

    Author

    Isaeva, J., Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/changeRefGroupDS.md b/docs/reference/changeRefGroupDS.md new file mode 100644 index 00000000..9f04c139 --- /dev/null +++ b/docs/reference/changeRefGroupDS.md @@ -0,0 +1,41 @@ +# Changes a reference level of a factor + +This function is similar to R function `relevel`, + +## Usage + +``` r +changeRefGroupDS(xvect, ref = NULL, reorderByRef = NULL) +``` + +## Arguments + +- xvect: + + a factor vector + +- ref: + + a character, the reference level + +- reorderByRef: + + a boolean that tells whether or not the new vector should be ordered + by the reference group. + +## Value + +a factor of the same length as xvect + +## Details + +In addition to what the R function does, this function allows for the +user to re-order the vector, putting the reference group first. If the +user chooses the re-order a warning is issued as this can introduce a +mismatch of values if the vector is put back into a table that is not +reordered in the same way. Such mismatch can render the results of +operations on that table invalid. + +## Author + +Isaeva, J., Gaye, A. diff --git a/docs/reference/checkNegValueDS.html b/docs/reference/checkNegValueDS.html index f96f4e41..5f88d3fa 100644 --- a/docs/reference/checkNegValueDS.html +++ b/docs/reference/checkNegValueDS.html @@ -1,92 +1,81 @@ -Checks if a numeric variable has negative values — checkNegValueDS • dsBase - - -
    -
    -
    -
    -

    Checks if a numeric variable has negative values

    + - + + + +
    +
    +
    +
    + +

    Checks if a numeric variable has negative values

    + +
    checkNegValueDS.Rd
    -
    +

    this function is only called by the client function ds.glm.

    -
    +
    +

    Usage

    checkNegValueDS(weights)
    -
    -

    Arguments

    +
    +

    Arguments

    weights

    a numeric vector

    -
    -

    Value

    +
    +

    Value

    a boolean; TRUE if the vector has one or more negative values and FALSE otherwise

    -
    -

    Details

    +
    +

    Details

    if a user sets the parameter 'weights' on the client side function ds.glm this server side function is called to verify that the 'weights' vector does not have negative values because no negative are allowed in weights.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/checkNegValueDS.md b/docs/reference/checkNegValueDS.md new file mode 100644 index 00000000..f5e5bca2 --- /dev/null +++ b/docs/reference/checkNegValueDS.md @@ -0,0 +1,31 @@ +# Checks if a numeric variable has negative values + +this function is only called by the client function `ds.glm`. + +## Usage + +``` r +checkNegValueDS(weights) +``` + +## Arguments + +- weights: + + a numeric vector + +## Value + +a boolean; TRUE if the vector has one or more negative values and FALSE +otherwise + +## Details + +if a user sets the parameter 'weights' on the client side function +`ds.glm` this server side function is called to verify that the +'weights' vector does not have negative values because no negative are +allowed in weights. + +## Author + +Gaye, A. diff --git a/docs/reference/checkPermissivePrivacyControlLevel.html b/docs/reference/checkPermissivePrivacyControlLevel.html index e6efd045..2c987ac9 100644 --- a/docs/reference/checkPermissivePrivacyControlLevel.html +++ b/docs/reference/checkPermissivePrivacyControlLevel.html @@ -1,92 +1,81 @@ -checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel • dsBase - - -
    -
    -
    -
    -

    checkPermissivePrivacyControlLevel

    + - + + + +
    +
    +
    +
    + +

    checkPermissivePrivacyControlLevel

    + +
    checkPermissivePrivacyControlLevel.Rd
    -
    +

    This server-side function check that the server is running in "permissive" privacy control level.

    -
    +
    +

    Usage

    checkPermissivePrivacyControlLevel(privacyControlLevels)
    -
    -

    Arguments

    +
    +

    Arguments

    privacyControlLevels

    is a vector of strings which contains the privacy control level names which are permitted by the calling method.

    -
    -

    Value

    +
    +

    Value

    No return value, called for side effects

    -
    -

    Details

    +
    +

    Details

    Tests whether the R option "datashield.privacyControlLevel" is set to "permissive", if it isn't will cause a call to stop() with the message "BLOCKED: The server is running in 'non-permissive' mode which has caused this method to be blocked".

    -
    -

    Author

    +
    +

    Author

    Wheater, Dr SM., DataSHIELD Development Team.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/checkPermissivePrivacyControlLevel.md b/docs/reference/checkPermissivePrivacyControlLevel.md new file mode 100644 index 00000000..8d83c6b7 --- /dev/null +++ b/docs/reference/checkPermissivePrivacyControlLevel.md @@ -0,0 +1,32 @@ +# checkPermissivePrivacyControlLevel + +This server-side function check that the server is running in +"permissive" privacy control level. + +## Usage + +``` r +checkPermissivePrivacyControlLevel(privacyControlLevels) +``` + +## Arguments + +- privacyControlLevels: + + is a vector of strings which contains the privacy control level names + which are permitted by the calling method. + +## Value + +No return value, called for side effects + +## Details + +Tests whether the R option "datashield.privacyControlLevel" is set to +"permissive", if it isn't will cause a call to stop() with the message +"BLOCKED: The server is running in 'non-permissive' mode which has +caused this method to be blocked". + +## Author + +Wheater, Dr SM., DataSHIELD Development Team. diff --git a/docs/reference/classDS.html b/docs/reference/classDS.html index 71412168..75f7f623 100644 --- a/docs/reference/classDS.html +++ b/docs/reference/classDS.html @@ -1,90 +1,79 @@ -Returns the class of an object — classDS • dsBase - - -
    -
    -
    -
    -

    Returns the class of an object

    + - + + + +
    +
    +
    +
    + +

    Returns the class of an object

    + +
    classDS.Rd
    -
    +

    This function is similar to R function class.

    -
    +
    +

    Usage

    classDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of an object

    -
    -

    Value

    +
    +

    Value

    the class of the input object

    -
    -

    Details

    +
    +

    Details

    The function returns the class of an object

    -
    -

    Author

    +
    +

    Author

    Stuart Wheater, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/classDS.md b/docs/reference/classDS.md new file mode 100644 index 00000000..de7f5625 --- /dev/null +++ b/docs/reference/classDS.md @@ -0,0 +1,27 @@ +# Returns the class of an object + +This function is similar to R function `class`. + +## Usage + +``` r +classDS(x) +``` + +## Arguments + +- x: + + a string character, the name of an object + +## Value + +the class of the input object + +## Details + +The function returns the class of an object + +## Author + +Stuart Wheater, for DataSHIELD Development Team diff --git a/docs/reference/colnamesDS.html b/docs/reference/colnamesDS.html index e1132722..6a44825e 100644 --- a/docs/reference/colnamesDS.html +++ b/docs/reference/colnamesDS.html @@ -1,90 +1,79 @@ -Returns the column names of a data frame or matrix — colnamesDS • dsBase - - -
    -
    -
    -
    -

    Returns the column names of a data frame or matrix

    + - + + + +
    +
    +
    +
    + +

    Returns the column names of a data frame or matrix

    + +
    colnamesDS.Rd
    -
    +

    This function is similar to R function colnames.

    -
    +
    +

    Usage

    colnamesDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of a dataframe or matrix

    -
    -

    Value

    +
    +

    Value

    the column names of the input object

    -
    -

    Details

    +
    +

    Details

    The function returns the column names of the input dataframe or matrix

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/colnamesDS.md b/docs/reference/colnamesDS.md new file mode 100644 index 00000000..4c64219a --- /dev/null +++ b/docs/reference/colnamesDS.md @@ -0,0 +1,27 @@ +# Returns the column names of a data frame or matrix + +This function is similar to R function `colnames`. + +## Usage + +``` r +colnamesDS(x) +``` + +## Arguments + +- x: + + a string character, the name of a dataframe or matrix + +## Value + +the column names of the input object + +## Details + +The function returns the column names of the input dataframe or matrix + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/completeCasesDS.html b/docs/reference/completeCasesDS.html index 56845bf1..736c22dd 100644 --- a/docs/reference/completeCasesDS.html +++ b/docs/reference/completeCasesDS.html @@ -1,56 +1,50 @@ -completeCasesDS: an assign function called by ds.completeCases — completeCasesDS • dsBase - - -
    -
    -
    -
    -

    completeCasesDS: an assign function called by ds.completeCases

    + - + + + +
    +
    +
    +
    + +

    completeCasesDS: an assign function called by ds.completeCases

    + +
    completeCasesDS.Rd
    -
    +

    Identifies and strips out all rows of a data.frame, matrix or vector that contain NAs.

    -
    +
    +

    Usage

    completeCasesDS(x1.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    x1.transmit
    @@ -60,8 +54,8 @@

    Arguments

    of the ds.completeCases function.

    -
    -

    Value

    +
    +

    Value

    a modified data.frame, matrix or vector from which all rows containing at least one NA have been deleted. This modified object is written to the serverside in each source. @@ -79,8 +73,8 @@

    Value

    without problems no studysideMessage will have been saved and ds.message("newobj") will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    In the case of a data.frame or matrix, completeCasesDS identifies all rows containing one or more NAs and deletes those rows altogether. Any one variable with NA in a given row will lead @@ -91,28 +85,24 @@

    Details

    in native R. Limited additional information can therefore be found under help("complete.cases") in native R.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/completeCasesDS.md b/docs/reference/completeCasesDS.md new file mode 100644 index 00000000..57acdb49 --- /dev/null +++ b/docs/reference/completeCasesDS.md @@ -0,0 +1,54 @@ +# completeCasesDS: an assign function called by ds.completeCases + +Identifies and strips out all rows of a data.frame, matrix or vector +that contain NAs. + +## Usage + +``` r +completeCasesDS(x1.transmit) +``` + +## Arguments + +- x1.transmit: + + This argument determines the input data.frame, matrix or vector from + which rows with NAs are to be stripped. The \ argument + is fully specified by the \ argument of the `ds.completeCases` + function. + +## Value + +a modified data.frame, matrix or vector from which all rows containing +at least one NA have been deleted. This modified object is written to +the serverside in each source. In addition, two validity messages are +returned indicating whether \ has been created in each data +source and if so whether it is in a valid form. If its form is not valid +in at least one study - e.g. because a disclosure trap was tripped and +creation of the full output object was blocked - ds.completeCases also +returns any studysideMessages that can help explain the error in +creating the full output object. As well as appearing on the screen at +run time,if you wish to see the relevant studysideMessages at a later +date you can use the `ds.message` function. If you type +ds.message("newobj") it will print out the relevant studysideMessage +from any datasource in which there was an error in creating \ +and a studysideMessage was saved. If there was no error and \ +was created without problems no studysideMessage will have been saved +and ds.message("newobj") will return the message: "ALL OK: there are no +studysideMessage(s) on this datasource". + +## Details + +In the case of a data.frame or matrix, `completeCasesDS` identifies all +rows containing one or more NAs and deletes those rows altogether. Any +one variable with NA in a given row will lead to deletion of the whole +row. In the case of a vector, `completeCasesDS` acts in an equivalent +manner but there is no equivalent to a 'row' and so it simply strips out +all observations recorded as NA. `ds.completeCASES` is analogous to the +`complete.cases` function in native R. Limited additional information +can therefore be found under help("complete.cases") in native R. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/corDS.html b/docs/reference/corDS.html index 1f20381d..bbeb3a25 100644 --- a/docs/reference/corDS.html +++ b/docs/reference/corDS.html @@ -1,56 +1,50 @@ -Computes the sum of each variable and the sum of products for each pair of variables — corDS • dsBase - - -
    -
    -
    -
    -

    Computes the sum of each variable and the sum of products for each pair of variables

    + - + + + +
    +
    +
    +
    + +

    Computes the sum of each variable and the sum of products for each pair of variables

    + +
    corDS.Rd
    -
    +

    This function computes the sum of each vector of variable and the sum of the products of each two variables (i.e. the scalar product of each two vectors).

    -
    +
    +

    Usage

    corDS(x = NULL, y = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -62,8 +56,8 @@

    Arguments

    NULL (default) or the name of a vector, matrix or dataframe with compatible dimensions to x.

    -
    -

    Value

    +
    +

    Value

    a list that includes a matrix with elements the sum of products between each two variables, a matrix with elements the sum of the values of each variable, a matrix with elements the number of complete cases in each pair of variables, a list with the number of missing values in each variable @@ -73,33 +67,29 @@

    Value

    by the 'nfilter.glm'). The second disclosure control checks that none of them is dichotomous with a level having fewer counts than the pre-specified 'nfilter.tab' threshold.

    -
    -

    Details

    +
    +

    Details

    computes the sum of each vector of variable and the sum of the products of each two variables

    -
    -

    Author

    +
    +

    Author

    Paul Burton, and Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/corDS.md b/docs/reference/corDS.md new file mode 100644 index 00000000..b997b9eb --- /dev/null +++ b/docs/reference/corDS.md @@ -0,0 +1,47 @@ +# Computes the sum of each variable and the sum of products for each pair of variables + +This function computes the sum of each vector of variable and the sum of +the products of each two variables (i.e. the scalar product of each two +vectors). + +## Usage + +``` r +corDS(x = NULL, y = NULL) +``` + +## Arguments + +- x: + + a character, the name of a vector, matrix or dataframe of variables(s) + for which the correlation(s) is (are) going to calculated for. + +- y: + + NULL (default) or the name of a vector, matrix or dataframe with + compatible dimensions to x. + +## Value + +a list that includes a matrix with elements the sum of products between +each two variables, a matrix with elements the sum of the values of each +variable, a matrix with elements the number of complete cases in each +pair of variables, a list with the number of missing values in each +variable separately (columnwise) and the number of missing values +casewise, and a vector with elements the sum of squares of each +variable. The first disclosure control checks that the number of +variables is not bigger than a percentage of the individual-level +records (the allowed percentage is pre-specified by the 'nfilter.glm'). +The second disclosure control checks that none of them is dichotomous +with a level having fewer counts than the pre-specified 'nfilter.tab' +threshold. + +## Details + +computes the sum of each vector of variable and the sum of the products +of each two variables + +## Author + +Paul Burton, and Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/corTestDS.html b/docs/reference/corTestDS.html index 95a08f8b..ddabba9a 100644 --- a/docs/reference/corTestDS.html +++ b/docs/reference/corTestDS.html @@ -1,54 +1,47 @@ -Tests for correlation between paired samples — corTestDS • dsBase - - -
    -
    -
    -
    -

    Tests for correlation between paired samples

    + - + + + +
    +
    +
    +
    + +

    Tests for correlation between paired samples

    + +
    corTestDS.Rd
    -
    +

    This function is similar to R function cor.test.

    -
    +
    +

    Usage

    corTestDS(x, y, method, exact, conf.level)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -75,36 +68,32 @@

    Arguments

    4 complete pairs of observations.

    -
    -

    Value

    +
    +

    Value

    the results of the correlation test.

    -
    -

    Details

    +
    +

    Details

    The function runs a two-sided correlation test

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/corTestDS.md b/docs/reference/corTestDS.md new file mode 100644 index 00000000..6968c63c --- /dev/null +++ b/docs/reference/corTestDS.md @@ -0,0 +1,48 @@ +# Tests for correlation between paired samples + +This function is similar to R function `cor.test`. + +## Usage + +``` r +corTestDS(x, y, method, exact, conf.level) +``` + +## Arguments + +- x: + + a character string providing the name of a numerical vector. + +- y: + + a character string providing the name of a numerical vector. + +- method: + + a character string indicating which correlation coefficient is to be + used for the test. One of "pearson", "kendall", or "spearman", can be + abbreviated. + +- exact: + + a logical indicating whether an exact p-value should be computed. Used + for Kendall's tau and Spearman's rho. + +- conf.level: + + confidence level for the returned confidence interval. Currently only + used for the Pearson product moment correlation coefficient if there + are at least 4 complete pairs of observations. + +## Value + +the results of the correlation test. + +## Details + +The function runs a two-sided correlation test + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/covDS.html b/docs/reference/covDS.html index 63be57ee..ecd7d58f 100644 --- a/docs/reference/covDS.html +++ b/docs/reference/covDS.html @@ -1,56 +1,50 @@ -Computes the sum of each variable and the sum of products for each pair of variables — covDS • dsBase - - -
    -
    -
    -
    -

    Computes the sum of each variable and the sum of products for each pair of variables

    + - + + + +
    +
    +
    +
    + +

    Computes the sum of each variable and the sum of products for each pair of variables

    + +
    covDS.Rd
    -
    +

    This function computes the sum of each vector of variable and the sum of the products of each two variables (i.e. the scalar product of each two vectors).

    -
    +
    +

    Usage

    covDS(x = NULL, y = NULL, use = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -71,8 +65,8 @@

    Arguments

    two variables.

    -
    -

    Value

    +
    +

    Value

    a list that includes a matrix with elements the sum of products between each two variables, a matrix with elements the sum of the values of each variable, a matrix with elements the number of complete cases in each pair of variables, a list with the number of missing values in each variable separately (columnwise) and the number @@ -83,33 +77,29 @@

    Value

    counts than the pre-specified 'nfilter.tab' threshold. If any of the input variables do not pass the disclosure controls then all the output values are replaced with NAs.

    -
    -

    Details

    +
    +

    Details

    computes the sum of each vector of variable and the sum of the products of each two variables

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton, and Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/covDS.md b/docs/reference/covDS.md new file mode 100644 index 00000000..d4b47fe2 --- /dev/null +++ b/docs/reference/covDS.md @@ -0,0 +1,63 @@ +# Computes the sum of each variable and the sum of products for each pair of variables + +This function computes the sum of each vector of variable and the sum of +the products of each two variables (i.e. the scalar product of each two +vectors). + +## Usage + +``` r +covDS(x = NULL, y = NULL, use = NULL) +``` + +## Arguments + +- x: + + a character, the name of a vector, matrix or dataframe of variable(s) + for which the covariance(s) and the correlation(s) is (are) going to + calculated for. + +- y: + + NULL (default) or the name of a vector, matrix or dataframe with + compatible dimensions to x. + +- use: + + a character string giving a method for computing covariances in the + presence of missing values. This must be one of the strings + "casewise.complete" or "pairwise.complete". If `use` is set to + 'casewise.complete' then any rows with missing values are omitted from + the vector, matrix or dataframe before the calculations of the sums. + If `use` is set to 'pairwise.complete' (which is the default case set + on the client-side), then the sums of products are computed for each + two variables using only the complete pairs of observations on the two + variables. + +## Value + +a list that includes a matrix with elements the sum of products between +each two variables, a matrix with elements the sum of the values of each +variable, a matrix with elements the number of complete cases in each +pair of variables, a list with the number of missing values in each +variable separately (columnwise) and the number of missing values +casewise or pairwise depending on the argument `use`, and an error +message which indicates whether or not the input variables pass the +disclosure controls. The first disclosure control checks that the number +of variables is not bigger than a percentage of the individual-level +records (the allowed percentage is pre-specified by the 'nfilter.glm'). +The second disclosure control checks that none of them is dichotomous +with a level having fewer counts than the pre-specified 'nfilter.tab' +threshold. If any of the input variables do not pass the disclosure +controls then all the output values are replaced with NAs. + +## Details + +computes the sum of each vector of variable and the sum of the products +of each two variables + +## Author + +Amadou Gaye, Paul Burton, and Demetris Avraam for DataSHIELD Development +Team diff --git a/docs/reference/dataFrameDS.html b/docs/reference/dataFrameDS.html index 719f5f38..8f861972 100644 --- a/docs/reference/dataFrameDS.html +++ b/docs/reference/dataFrameDS.html @@ -1,53 +1,48 @@ -dataFrameDS called by ds.dataFrame — dataFrameDS • dsBasedataFrameDS called by ds.dataFrame — dataFrameDS • dsBase - - -
    -
    -
    -
    -

    dataFrameDS called by ds.dataFrame

    - +
    +
    +
    +
    + +

    dataFrameDS called by ds.dataFrame

    + +
    dataFrameDS.Rd
    -
    +

    The serverside function that creates a data frame from its elemental components. That is: pre-existing data frames; single variables; and/or matrices

    -
    +
    +

    Usage

    dataFrameDS(
   vectors = NULL,
   r.names = NULL,
@@ -59,8 +54,8 @@ 
    dataFrameDS called by ds.dataFrame
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    vectors
    @@ -103,14 +98,14 @@

    Arguments

    included: any rows with missing values in any component will be excluded. Default FALSE.

    -
    -

    Value

    +
    +

    Value

    a dataframe composed of the specified elemental components will be created on the serverside and named according to the <newobj> argument of the clientside function ds.dataFrame()

    -
    -

    Details

    +
    +

    Details

    A data frame is a list of variables all with the same number of rows with unique row names, which is of class 'data.frame'. ds.dataFrame will create a data frame by combining a series of elemental components which may be pre-existing data.frames, matrices or variables. @@ -122,28 +117,24 @@

    Details

    In consequence, additional information can be sought from the help() for data.frame().

    -
    -

    Author

    +
    +

    Author

    DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dataFrameDS.md b/docs/reference/dataFrameDS.md new file mode 100644 index 00000000..c1984d97 --- /dev/null +++ b/docs/reference/dataFrameDS.md @@ -0,0 +1,87 @@ +# dataFrameDS called by ds.dataFrame + +The serverside function that creates a data frame from its elemental +components. That is: pre-existing data frames; single variables; and/or +matrices + +## Usage + +``` r +dataFrameDS( + vectors = NULL, + r.names = NULL, + ch.rows = FALSE, + ch.names = TRUE, + clnames = NULL, + strAsFactors = TRUE, + completeCases = FALSE +) +``` + +## Arguments + +- vectors: + + a list which contains the elemental components to combine. These + correspond to the vector of character strings specified in argument x + of the clientside function ds.dataFrame() + +- r.names: + + NULL or a character vector specifying the names of the rows. Default + NULL. + +- ch.rows: + + logical, if TRUE then the rows are checked for consistency of length + and names. Default FALSE. + +- ch.names: + + logical, if TRUE then the names of the variables in the data frame are + checked to ensure that they are syntactically valid variable names and + are not duplicated. Default TRUE. In fact, the clientside function + ensures no duplicated names can be presented to dataFrameDS but this + argument is kept to check for other forms of syntactic validity. + +- clnames: + + a list of characters, the column names of the output data frame. These + are generated by the clientside function from the names of vectors, + and the column names of data.frames and matrices being combined in + producing the output data.frame + +- strAsFactors: + + logical, if TRUE determines whether character vectors should + automatically be converted to factors? Default TRUE. + +- completeCases: + + logical. If TRUE indicates that only complete cases should be + included: any rows with missing values in any component will be + excluded. Default FALSE. + +## Value + +a dataframe composed of the specified elemental components will be +created on the serverside and named according to the \ argument +of the clientside function ds.dataFrame() + +## Details + +A data frame is a list of variables all with the same number of rows +with unique row names, which is of class 'data.frame'. ds.dataFrame will +create a data frame by combining a series of elemental components which +may be pre-existing data.frames, matrices or variables. A critical +requirement is that the length of all component variables, and the +number of rows of the component data.frames or matrices must all be the +same. The output data.frame will then have this same number of rows. The +serverside function dataFrameDS() calls the native R function +data.frame() and several of its arguments are precisely the same as for +data.frame(). In consequence, additional information can be sought from +the help() for data.frame(). + +## Author + +DataSHIELD Development Team diff --git a/docs/reference/dataFrameFillDS.html b/docs/reference/dataFrameFillDS.html index 63526a3c..49cdcdb4 100644 --- a/docs/reference/dataFrameFillDS.html +++ b/docs/reference/dataFrameFillDS.html @@ -1,49 +1,42 @@ -dataFrameFillDS — dataFrameFillDS • dsBase - - -
    -
    -
    -
    -

    dataFrameFillDS

    + - + + + +
    +
    +
    +
    + +

    dataFrameFillDS

    + +
    dataFrameFillDS.Rd
    -
    +

    An assign function called by the clientside ds.dataFrameFill function.

    -
    +
    +

    Usage

    dataFrameFillDS(
   df.name,
   allNames.transmit,
@@ -52,8 +45,8 @@ 
    dataFrameFillDS
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    df.name
    @@ -77,40 +70,36 @@

    Arguments

    The classes supported are 'numeric', 'integer', 'character', 'factor' and 'logical'.

    -
    -

    Value

    +
    +

    Value

    Nothing is returned to the client. The generated object is written to the serverside.

    -
    -

    Details

    +
    +

    Details

    This function checks if each study has all the variables compared to the other studies in the analysis. If a study does not have some of the variables, the function generates those variables as vectors of missing values and combines them as columns to the input data frame. Then, the "complete" in terms of the columns dataframe is saved in each server with a name specified by the argument newobj on the clientside.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dataFrameFillDS.md b/docs/reference/dataFrameFillDS.md new file mode 100644 index 00000000..5741f242 --- /dev/null +++ b/docs/reference/dataFrameFillDS.md @@ -0,0 +1,56 @@ +# dataFrameFillDS + +An assign function called by the clientside ds.dataFrameFill function. + +## Usage + +``` r +dataFrameFillDS( + df.name, + allNames.transmit, + class.vect.transmit, + levels.vec.transmit +) +``` + +## Arguments + +- df.name: + + a character string representing the name of the input data frame that + will be filled with extra columns with missing values if a number of + variables is missing from it compared to the data frames of the other + studies used in the analysis. + +- allNames.transmit: + + unique names of all the variables that are included in the input data + frames from all the used datasources. + +- class.vect.transmit: + + the classes of all the variables that are included in the vector + `allNames.transmit`. + +- levels.vec.transmit: + + the levels of all factor variables. The classes supported are + 'numeric', 'integer', 'character', 'factor' and 'logical'. + +## Value + +Nothing is returned to the client. The generated object is written to +the serverside. + +## Details + +This function checks if each study has all the variables compared to the +other studies in the analysis. If a study does not have some of the +variables, the function generates those variables as vectors of missing +values and combines them as columns to the input data frame. Then, the +"complete" in terms of the columns dataframe is saved in each server +with a name specified by the argument `newobj` on the clientside. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/dataFrameSortDS.html b/docs/reference/dataFrameSortDS.html index 47246150..9f5a25ac 100644 --- a/docs/reference/dataFrameSortDS.html +++ b/docs/reference/dataFrameSortDS.html @@ -1,49 +1,42 @@ -Sorting and reordering data frames, vectors or matrices — dataFrameSortDS • dsBase - - -
    -
    -
    -
    -

    Sorting and reordering data frames, vectors or matrices

    + - + + + +
    +
    +
    +
    + +

    Sorting and reordering data frames, vectors or matrices

    + +
    dataFrameSortDS.Rd
    -
    +

    Sorts a data frame using a specified alphanumeric or numeric sort key

    -
    +
    +

    Usage

    dataFrameSortDS(
   df.name = NULL,
   sort.key.name = NULL,
@@ -52,8 +45,8 @@ 
    Sorting and reordering data frames, vectors or matrices
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    df.name
    @@ -86,14 +79,14 @@

    Arguments

    in ds.dataFrameShort and further details can be found at help("ds.dataFrameSort").

    -
    -

    Value

    +
    +

    Value

    the appropriately re-sorted data.frame will be written to the serverside R environment as a data.frame named according to the <newobj> argument(or with default name 'dataframesort.newobj') if no name is specified

    -
    -

    Details

    +
    +

    Details

    Serverside assign function dataFrameSortDS is called by clientside function ds.dataFrameSort. A vector or a matrix can be added to, or coerced into, a data frame (using function [ds.dataFrame]) @@ -102,29 +95,25 @@

    Details

    data frame on the serverside using a sort key also on the serverside. For more details see help for the clientside function: [ds.dataFrameShort]

    -
    -

    Author

    +
    +

    Author

    Paul Burton, with critical error identification by Leire Abarrategui-Martinez, for DataSHIELD Development Team, 2/4/2020

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dataFrameSortDS.md b/docs/reference/dataFrameSortDS.md new file mode 100644 index 00000000..c2671532 --- /dev/null +++ b/docs/reference/dataFrameSortDS.md @@ -0,0 +1,72 @@ +# Sorting and reordering data frames, vectors or matrices + +Sorts a data frame using a specified alphanumeric or numeric sort key + +## Usage + +``` r +dataFrameSortDS( + df.name = NULL, + sort.key.name = NULL, + sort.descending, + sort.method +) +``` + +## Arguments + +- df.name: + + a character string providing the name for the serverside data.frame to + be sorted. This parameter is fully specified by the equivalent + argument in ds.dataFrameShort and further details can be found at + help("ds.dataFrameSort"). + +- sort.key.name: + + a character string providing the name for the sort key. This will be a + serverside vector which may sit inside the data frame to be sorted or + independently in the serverside analysis environment. But, if it sits + outside the data frame it must then be the same length as the data + frame. This parameter is fully specified by the equivalent argument in + ds.dataFrameShort and further details can be found at + help("ds.dataFrameSort"). + +- sort.descending: + + logical, if TRUE the data.frame will be sorted by the sort key in + descending order. Default = FALSE (sort order ascending). This + parameter is fully specified by the equivalent argument in + ds.dataFrameShort and further details can be found at + help("ds.dataFrameSort"). + +- sort.method: + + A character string taking one of the values: "default", "d", + "alphabetic", "a", "numeric", "n", or NULL. Default value is + "default". This parameter is fully specified by the equivalent + argument in ds.dataFrameShort and further details can be found at + help("ds.dataFrameSort"). + +## Value + +the appropriately re-sorted data.frame will be written to the serverside +R environment as a data.frame named according to the \ +argument(or with default name 'dataframesort.newobj') if no name is +specified + +## Details + +Serverside assign function dataFrameSortDS is called by clientside +function ds.dataFrameSort. A vector or a matrix can be added to, or +coerced into, a data frame (using function \[ds.dataFrame\]) and this +means that they too can be sorted/reordered using ds.dataFrameSort. +Fundamentally, the function \[ds.dataFrameSort\] will sort a specified +data frame on the serverside using a sort key also on the serverside. +For more details see help for the clientside function: +\[ds.dataFrameShort\] + +## Author + +Paul Burton, with critical error identification by Leire +Abarrategui-Martinez, for DataSHIELD Development Team, 2/4/2020 diff --git a/docs/reference/dataFrameSubsetDS1.html b/docs/reference/dataFrameSubsetDS1.html index cd201b50..9666bd1b 100644 --- a/docs/reference/dataFrameSubsetDS1.html +++ b/docs/reference/dataFrameSubsetDS1.html @@ -1,49 +1,42 @@ -dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1 • dsBase - - -
    -
    -
    -
    -

    dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset

    + - + + + +
    +
    +
    +
    + +

    dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset

    + +
    dataFrameSubsetDS1.Rd
    -
    +

    First serverside function for subsetting a data frame by row or by column.

    -
    +
    +

    Usage

    dataFrameSubsetDS1(
   df.name = NULL,
   V1.name = NULL,
@@ -55,8 +48,8 @@ 
    dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    df.name
    @@ -113,8 +106,8 @@

    Arguments

    dataFrameSubsetDS1 by ds.dataFrameSubset

    -
    -

    Value

    +
    +

    Value

    This first serverside function called by ds.dataFrameSubset provides first level traps for a comprehensive series of disclosure risks which can be returned directly to the clientside because dataFrameSubsetDS1 is an aggregate @@ -124,33 +117,29 @@

    Value

    In consequence, it records error messages as studysideMessages which can only be retrieved using ds.message

    -
    -

    Details

    +
    +

    Details

    A data frame is a list of variables all with the same number of rows, which is of class 'data.frame'. For all details see the help header for ds.dataFrameSubset

    -
    -

    Author

    +
    +

    Author

    Paul Burton

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dataFrameSubsetDS1.md b/docs/reference/dataFrameSubsetDS1.md new file mode 100644 index 00000000..7a884cb4 --- /dev/null +++ b/docs/reference/dataFrameSubsetDS1.md @@ -0,0 +1,96 @@ +# dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset + +First serverside function for subsetting a data frame by row or by +column. + +## Usage + +``` r +dataFrameSubsetDS1( + df.name = NULL, + V1.name = NULL, + V2.name = NULL, + Boolean.operator.n = NULL, + keep.cols = NULL, + rm.cols = NULL, + keep.NAs = NULL +) +``` + +## Arguments + +- df.name: + + a character string providing the name for the data.frame to be sorted. + \ argument generated and passed directly to + dataFrameSubsetDS1 by ds.dataFrameSubset + +- V1.name: + + A character string specifying the name of a subsetting vector to which + a Boolean operator will be applied to define the subset to be created. + \ argument generated and passed directly to + dataFrameSubsetDS1 by ds.dataFrameSubset + +- V2.name: + + A character string specifying the name of the vector or scalar to + which the values in the vector specified by the argument \ + is to be compared. \ argument generated and passed directly + to dataFrameSubsetDS1 by ds.dataFrameSubset + +- Boolean.operator.n: + + A character string specifying one of six possible Boolean operators: + '==', '!=', '\>', '\>=', '\<', '\<=' \ argument + generated and passed directly to dataFrameSubsetDS1 by + ds.dataFrameSubset + +- keep.cols: + + a numeric vector specifying the numbers of the columns to be kept in + the final subset when subsetting by column. For example: + keep.cols=c(2:5,7,12) will keep columns 2,3,4,5,7 and 12. + \ argument generated and passed directly to + dataFrameSubsetDS1 by ds.dataFrameSubset + +- rm.cols: + + a numeric vector specifying the numbers of the columns to be removed + before creating the final subset when subsetting by column. For + example: rm.cols=c(2:5,7,12) will remove columns 2,3,4,5,7 and 12. + \ argument generated and passed directly to + dataFrameSubsetDS1 by ds.dataFrameSubset + +- keep.NAs: + + logical, if TRUE any NAs in the vector holding the final Boolean + vector indicating whether a given row should be included in the subset + will be converted into 1s and so they will be included in the subset. + Such NAs could be caused by NAs in either \ or \. + If FALSE or NULL NAs in the final Boolean vector will be converted to + 0s and the corresponding row will therefore be excluded from the + subset. \ argument generated and passed directly to + dataFrameSubsetDS1 by ds.dataFrameSubset + +## Value + +This first serverside function called by ds.dataFrameSubset provides +first level traps for a comprehensive series of disclosure risks which +can be returned directly to the clientside because dataFrameSubsetDS1 is +an aggregate function. The second serverside function called by +ds.dataFrameSubset (dataFrameSubsetDS2) carries out most of the same +disclosure tests, but it is an assign function because it writes the +subsetted data.frame to the serverside. In consequence, it records error +messages as studysideMessages which can only be retrieved using +ds.message + +## Details + +A data frame is a list of variables all with the same number of rows, +which is of class 'data.frame'. For all details see the help header for +ds.dataFrameSubset + +## Author + +Paul Burton diff --git a/docs/reference/dataFrameSubsetDS2.html b/docs/reference/dataFrameSubsetDS2.html index 66dc97f6..0cdeb039 100644 --- a/docs/reference/dataFrameSubsetDS2.html +++ b/docs/reference/dataFrameSubsetDS2.html @@ -1,49 +1,42 @@ -dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2 • dsBase - - -
    -
    -
    -
    -

    dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset

    + - + + + +
    +
    +
    +
    + +

    dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset

    + +
    dataFrameSubsetDS2.Rd
    -
    +

    Second serverside function for subsetting a data frame by row or by column.

    -
    +
    +

    Usage

    dataFrameSubsetDS2(
   df.name = NULL,
   V1.name = NULL,
@@ -55,8 +48,8 @@ 
    dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    df.name
    @@ -113,8 +106,8 @@

    Arguments

    dataFrameSubsetDS2 by ds.dataFrameSubset

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or default name '<df.name>_subset') initially specified in calling ds.dataFrameSubset. The output object (the required subsetted data.frame called <newobj> is written to the serverside. In addition, @@ -132,33 +125,29 @@

    Value

    without problems no studysideMessage will have been saved and ds.message("newobj") will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    A data frame is a list of variables all with the same number of rows, which is of class 'data.frame'. For all details see the help header for ds.dataFrameSubset

    -
    -

    Author

    +
    +

    Author

    DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dataFrameSubsetDS2.md b/docs/reference/dataFrameSubsetDS2.md new file mode 100644 index 00000000..601749da --- /dev/null +++ b/docs/reference/dataFrameSubsetDS2.md @@ -0,0 +1,106 @@ +# dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset + +Second serverside function for subsetting a data frame by row or by +column. + +## Usage + +``` r +dataFrameSubsetDS2( + df.name = NULL, + V1.name = NULL, + V2.name = NULL, + Boolean.operator.n = NULL, + keep.cols = NULL, + rm.cols = NULL, + keep.NAs = NULL +) +``` + +## Arguments + +- df.name: + + a character string providing the name for the data.frame to be sorted. + \ argument generated and passed directly to + dataFrameSubsetDS2 by ds.dataFrameSubset + +- V1.name: + + A character string specifying the name of a subsetting vector to which + a Boolean operator will be applied to define the subset to be created. + \ argument generated and passed directly to + dataFrameSubsetDS2 by ds.dataFrameSubset + +- V2.name: + + A character string specifying the name of the vector or scalar to + which the values in the vector specified by the argument \ + is to be compared. \ argument generated and passed directly + to dataFrameSubsetDS2 by ds.dataFrameSubset + +- Boolean.operator.n: + + A character string specifying one of six possible Boolean operators: + '==', '!=', '\>', '\>=', '\<', '\<=' \ argument + generated and passed directly to dataFrameSubsetDS2 by + ds.dataFrameSubset + +- keep.cols: + + a numeric vector specifying the numbers of the columns to be kept in + the final subset when subsetting by column. For example: + keep.cols=c(2:5,7,12) will keep columns 2,3,4,5,7 and 12. + \ argument generated and passed directly to + dataFrameSubsetDS2 by ds.dataFrameSubset + +- rm.cols: + + a numeric vector specifying the numbers of the columns to be removed + before creating the final subset when subsetting by column. For + example: rm.cols=c(2:5,7,12) will remove columns 2,3,4,5,7 and 12. + \ argument generated and passed directly to + dataFrameSubsetDS2 by ds.dataFrameSubset + +- keep.NAs: + + logical, if TRUE any NAs in the vector holding the final Boolean + vector indicating whether a given row should be included in the subset + will be converted into 1s and so they will be included in the subset. + Such NAs could be caused by NAs in either \ or \. + If FALSE or NULL NAs in the final Boolean vector will be converted to + 0s and the corresponding row will therefore be excluded from the + subset. \ argument generated and passed directly to + dataFrameSubsetDS2 by ds.dataFrameSubset + +## Value + +the object specified by the \ argument (or default name +'\\_subset') initially specified in calling +ds.dataFrameSubset. The output object (the required subsetted data.frame +called \ is written to the serverside. In addition, two +validity messages are returned via ds.dataFrameSubset indicating whether +\ has been created in each data source and if so whether it is +in a valid form. If its form is not valid in at least one study - e.g. +because a disclosure trap was tripped and creation of the full output +object was blocked - dataFrameSubsetDS2 (via ds.dataFrame()) also +returns any studysideMessages that can explain the error in creating the +full output object. As well as appearing on the screen at run time,if +you wish to see the relevant studysideMessages at a later date you can +use the `ds.message` function. If you type ds.message("newobj") it will +print out the relevant studysideMessage from any datasource in which +there was an error in creating \ and a studysideMessage was +saved. If there was no error and \ was created without problems +no studysideMessage will have been saved and ds.message("newobj") will +return the message: "ALL OK: there are no studysideMessage(s) on this +datasource". + +## Details + +A data frame is a list of variables all with the same number of rows, +which is of class 'data.frame'. For all details see the help header for +ds.dataFrameSubset + +## Author + +DataSHIELD Development Team diff --git a/docs/reference/densityGridDS.html b/docs/reference/densityGridDS.html index 14c4e7b2..3afc8616 100644 --- a/docs/reference/densityGridDS.html +++ b/docs/reference/densityGridDS.html @@ -1,49 +1,42 @@ -Generates a density grid with or without a priori defined limits — densityGridDS • dsBase - - -
    -
    -
    -
    -

    Generates a density grid with or without a priori defined limits

    + - + + + +
    +
    +
    +
    + +

    Generates a density grid with or without a priori defined limits

    + +
    densityGridDS.Rd
    -
    +

    Generates a density grid that can then be used for heatmap or contour plots.

    -
    +
    +

    Usage

    densityGridDS(
   xvect,
   yvect,
@@ -56,8 +49,8 @@ 
    Generates a density grid with or without a priori defined limits
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -94,37 +87,33 @@

    Arguments

    a number of intervals for the grid density object, by default is 20

    -
    -

    Value

    +
    +

    Value

    a grid density matrix

    -
    -

    Details

    +
    +

    Details

    Invalid cells (cells with count < to the set filter value for the minimum allowed counts in table cells) are turn to 0.

    -
    -

    Author

    +
    +

    Author

    Julia Isaeva, Amadou Gaye, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/densityGridDS.md b/docs/reference/densityGridDS.md new file mode 100644 index 00000000..99646388 --- /dev/null +++ b/docs/reference/densityGridDS.md @@ -0,0 +1,70 @@ +# Generates a density grid with or without a priori defined limits + +Generates a density grid that can then be used for heatmap or contour +plots. + +## Usage + +``` r +densityGridDS( + xvect, + yvect, + limits = FALSE, + x.min = NULL, + x.max = NULL, + y.min = NULL, + y.max = NULL, + numints = 20 +) +``` + +## Arguments + +- xvect: + + a numerical vector + +- yvect: + + a numerical vector + +- limits: + + a logical expression for whether or not limits of the density grid are + defined by a user. If `limits` is set to "FALSE", min and max of xvect + and yvect are used as a range. If `limits` is set to "TRUE", limits + defined by x.min, x.max, y.min and y.max are used. + +- x.min: + + a minimum value for the x axis of the grid density object, if needed + +- x.max: + + a maximum value for the x axis of the grid density object, if needed + +- y.min: + + a minimum value for the y axis of the grid density object, if needed + +- y.max: + + a maximum value for the y axis of the grid density object, if needed + +- numints: + + a number of intervals for the grid density object, by default is 20 + +## Value + +a grid density matrix + +## Details + +Invalid cells (cells with count \< to the set filter value for the +minimum allowed counts in table cells) are turn to 0. + +## Author + +Julia Isaeva, Amadou Gaye, Demetris Avraam for DataSHIELD Development +Team diff --git a/docs/reference/dimDS.html b/docs/reference/dimDS.html index ccda6820..958c6406 100644 --- a/docs/reference/dimDS.html +++ b/docs/reference/dimDS.html @@ -1,90 +1,79 @@ -Returns the dimension of a data frame or matrix — dimDS • dsBase - - -
    -
    -
    -
    -

    Returns the dimension of a data frame or matrix

    + - + + + +
    +
    +
    +
    + +

    Returns the dimension of a data frame or matrix

    + +
    dimDS.Rd
    -
    +

    This function is similar to R function dim.

    -
    +
    +

    Usage

    dimDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of a dataframe or matrix

    -
    -

    Value

    +
    +

    Value

    the dimension of the input object

    -
    -

    Details

    +
    +

    Details

    The function returns the dimension of the input dataframe or matrix

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dimDS.md b/docs/reference/dimDS.md new file mode 100644 index 00000000..1c5d6e63 --- /dev/null +++ b/docs/reference/dimDS.md @@ -0,0 +1,27 @@ +# Returns the dimension of a data frame or matrix + +This function is similar to R function `dim`. + +## Usage + +``` r +dimDS(x) +``` + +## Arguments + +- x: + + a string character, the name of a dataframe or matrix + +## Value + +the dimension of the input object + +## Details + +The function returns the dimension of the input dataframe or matrix + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/dmtC2SDS.html b/docs/reference/dmtC2SDS.html index df76184d..952c70fb 100644 --- a/docs/reference/dmtC2SDS.html +++ b/docs/reference/dmtC2SDS.html @@ -1,51 +1,45 @@ -Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS • dsBase - - -
    -
    -
    -
    -

    Copy a clientside data.frame, matrix or tibble (DMT) to the serverside.

    + - + + + +
    +
    +
    +
    + +

    Copy a clientside data.frame, matrix or tibble (DMT) to the serverside.

    + +
    dmtC2SDS.Rd
    -
    +

    Creates a data.frame, matrix or tibble on the serverside that is equivalent to that same data.frame, matrix or tibble (DMT) on the clientside.

    -
    +
    +

    Usage

    dmtC2SDS(
   dfdata.mat.transmit,
   inout.object.transmit,
@@ -58,8 +52,8 @@ 
    Copy a clientside data.frame, matrix or tibble (DMT) to the serverside.
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    dfdata.mat.transmit
    @@ -121,39 +115,35 @@

    Arguments

    function as FALSE (fill column by column).

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or default name "matdftbl.copied.C2S") which is written as a data.frame, matrix or tibble to the serverside.

    -
    -

    Details

    +
    +

    Details

    dmtC2SDS is a serverside assign function called by ds.dmtC2S. For more information about how it works see help for ds.dmtC2S

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team - 3rd June, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dmtC2SDS.md b/docs/reference/dmtC2SDS.md new file mode 100644 index 00000000..ea46b0d9 --- /dev/null +++ b/docs/reference/dmtC2SDS.md @@ -0,0 +1,97 @@ +# Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. + +Creates a data.frame, matrix or tibble on the serverside that is +equivalent to that same data.frame, matrix or tibble (DMT) on the +clientside. + +## Usage + +``` r +dmtC2SDS( + dfdata.mat.transmit, + inout.object.transmit, + from, + nrows.transmit, + ncols.transmit, + colnames.transmit, + colclass.transmit, + byrow +) +``` + +## Arguments + +- dfdata.mat.transmit: + + a character string in a format that can pass through the DataSHIELD R + parser which specifies the name of the DMT to be copied from the + clientside to the serverside. Value fully specified by \ + argument of ds.dmtC2S. + +- inout.object.transmit: + + a character string taking values "DF", "MAT" or "TBL". The value of + this argument is automatically set by ds.dmtC2S depending on whether + the clientside DMT is a data.frame, matrix or tibble. Correspondingly, + its value determines whether the object created on the serverside is a + data.frame, matrix or tibble. This is unlikely to always work (some + class misspecifications may occur) but it works in all the test cases. + +- from: + + a character string specifying the source of \. Fixed by + clientside function as "clientside.matdftbl". + +- nrows.transmit: + + specifies the number of rows in the matrix to be created. Fixed by the + clientside function as equal to the number of rows in the clientside + DMT to be transferred. + +- ncols.transmit: + + specifies the number of columns in the matrix to be created. Fixed by + the clientside function as equal to the number of columns in the + clientside DMT to be transferred. + +- colnames.transmit: + + a parser-transmissible vector specifying the name of each column in + the DMT being transferred from clientside to serverside. Generated + automatically by clientside function from colnames of clientside DMT. + +- colclass.transmit: + + a parser-transmissible vector specifying the class of the vector + representing each individual column in the DMT to be transferred. + Generated automatically by clientside function. This allows the + transmission of DMTs containing columns with different classes.If + something is going to go wrong with class misspecification (see + inout.object.transmit) it is a DMT with a complex combination of + data/column types that will most likely be the cause. This suggests + that you always check the class of the serverside DMT and its + individual columns (if the latter is important). If a situation arises + where the class of the columns is crucial and the function cannot do + what is needed please contact the DataSHIELD forum and we can try to + remedy the problem. + +- byrow: + + a logical value specifying whether the DMT created on the serverside + should be filled row by row or column by column. This is fixed by the + clientside function as FALSE (fill column by column). + +## Value + +the object specified by the \ argument (or default name +"matdftbl.copied.C2S") which is written as a data.frame, matrix or +tibble to the serverside. + +## Details + +dmtC2SDS is a serverside assign function called by ds.dmtC2S. For more +information about how it works see help for ds.dmtC2S + +## Author + +Paul Burton for DataSHIELD Development Team - 3rd June, 2021 diff --git a/docs/reference/dsBase-package.html b/docs/reference/dsBase-package.html index e6269505..41f8edfd 100644 --- a/docs/reference/dsBase-package.html +++ b/docs/reference/dsBase-package.html @@ -1,53 +1,46 @@ -dsBase: 'DataSHIELD' Server Side Base Functions — dsBase-package • dsBase - - -
    -
    -
    -
    -

    dsBase: 'DataSHIELD' Server Side Base Functions

    + - + + + +
    +
    +
    +
    + +

    dsBase: 'DataSHIELD' Server Side Base Functions

    + +
    dsBase-package.Rd
    -
    +

    Base 'DataSHIELD' functions for the server side. 'DataSHIELD' is a software package which allows you to do non-disclosive federated analysis on sensitive data. 'DataSHIELD' analytic functions have been designed to only share non disclosive summary statistics, with built in automated output checking based on statistical disclosure control. With data sites setting the threshold values for the automated output checks. For more details, see 'citation("dsBase")'.

    -
    -

    Author

    +
    +

    Author

    Maintainer: Stuart Wheater stuart.wheater@arjuna.com (ORCID)

    -

    Authors:

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/dsBase-package.md b/docs/reference/dsBase-package.md new file mode 100644 index 00000000..770ae061 --- /dev/null +++ b/docs/reference/dsBase-package.md @@ -0,0 +1,45 @@ +# dsBase: 'DataSHIELD' Server Side Base Functions + +Base 'DataSHIELD' functions for the server side. 'DataSHIELD' is a +software package which allows you to do non-disclosive federated +analysis on sensitive data. 'DataSHIELD' analytic functions have been +designed to only share non disclosive summary statistics, with built in +automated output checking based on statistical disclosure control. With +data sites setting the threshold values for the automated output checks. +For more details, see 'citation("dsBase")'. + +## Author + +**Maintainer**: Stuart Wheater +([ORCID](https://orcid.org/0009-0003-2419-1964)) + +Authors: + +- Stuart Wheater + ([ORCID](https://orcid.org/0009-0003-2419-1964)) + +- Paul Burton ([ORCID](https://orcid.org/0000-0001-5799-9634)) + +- Rebecca Wilson ([ORCID](https://orcid.org/0000-0003-2294-593X)) + +- Olly Butters ([ORCID](https://orcid.org/0000-0003-0354-8461)) + +- Patricia Ryser-Welch ([ORCID](https://orcid.org/0000-0002-0070-0264)) + +- Alex Westerberg + +- Leire Abarrategui + +- Roberto Villegas-Diaz ([ORCID](https://orcid.org/0000-0001-5036-8661)) + +- Demetris Avraam ([ORCID](https://orcid.org/0000-0001-8908-2441)) + +- Yannick Marcon + ([ORCID](https://orcid.org/0000-0003-0138-2023)) + +- Tom Bishop + +- Amadou Gaye ([ORCID](https://orcid.org/0000-0002-1180-2792)) + +- Xavier Escribà-Montagut + ([ORCID](https://orcid.org/0000-0003-2888-8948)) diff --git a/docs/reference/elsplineDS.html b/docs/reference/elsplineDS.html index 190483ae..3315aebb 100644 --- a/docs/reference/elsplineDS.html +++ b/docs/reference/elsplineDS.html @@ -1,60 +1,56 @@ -Basis for a piecewise linear spline with meaningful coefficients — elsplineDS • dsBaseBasis for a piecewise linear spline with meaningful coefficients — elsplineDS • dsBase - - -
    -
    -
    -
    -

    Basis for a piecewise linear spline with meaningful coefficients

    - +
    +
    +
    +
    + +

    Basis for a piecewise linear spline with meaningful coefficients

    + +
    elsplineDS.Rd
    -
    +

    This function is based on the native R function elspline from the lspline package. This function computes the basis of piecewise-linear spline such that, depending on the argument marginal, the coefficients can be interpreted as (1) slopes of consecutive spline segments, or (2) slope change at consecutive knots.

    -
    +
    +

    Usage

    elsplineDS(x = x, n = n, marginal = FALSE, names = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -74,13 +70,13 @@

    Arguments

    character, vector of names for constructed variables

    -
    -

    Value

    +
    +

    Value

    an object of class "lspline" and "matrix", which its name is specified by the newobj argument (or its default name "elspline.newobj"), is assigned on the serverside.

    -
    -

    Details

    +
    +

    Details

    If marginal is FALSE (default) the coefficients of the spline correspond to slopes of the consecutive segments. If it is TRUE the first coefficient correspond to the slope of the first segment. The consecutive coefficients correspond to the change @@ -88,28 +84,24 @@

    Details

    Function elspline wraps lspline and computes the knot positions such that they cut the range of x into n equal-width intervals.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/elsplineDS.md b/docs/reference/elsplineDS.md new file mode 100644 index 00000000..4401f000 --- /dev/null +++ b/docs/reference/elsplineDS.md @@ -0,0 +1,52 @@ +# Basis for a piecewise linear spline with meaningful coefficients + +This function is based on the native R function `elspline` from the +`lspline` package. This function computes the basis of piecewise-linear +spline such that, depending on the argument marginal, the coefficients +can be interpreted as (1) slopes of consecutive spline segments, or (2) +slope change at consecutive knots. + +## Usage + +``` r +elsplineDS(x = x, n = n, marginal = FALSE, names = NULL) +``` + +## Arguments + +- x: + + the name of the input numeric variable + +- n: + + integer greater than 2, knots are computed such that they cut n + equally-spaced intervals along the range of x + +- marginal: + + logical, how to parametrize the spline, see Details + +- names: + + character, vector of names for constructed variables + +## Value + +an object of class "lspline" and "matrix", which its name is specified +by the `newobj` argument (or its default name "elspline.newobj"), is +assigned on the serverside. + +## Details + +If marginal is FALSE (default) the coefficients of the spline correspond +to slopes of the consecutive segments. If it is TRUE the first +coefficient correspond to the slope of the first segment. The +consecutive coefficients correspond to the change in slope as compared +to the previous segment. Function elspline wraps lspline and computes +the knot positions such that they cut the range of x into n equal-width +intervals. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/extractQuantilesDS1.html b/docs/reference/extractQuantilesDS1.html index dd55cbf1..757856e3 100644 --- a/docs/reference/extractQuantilesDS1.html +++ b/docs/reference/extractQuantilesDS1.html @@ -1,56 +1,50 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies — extractQuantilesDS1 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    + - + + + +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    + +
    extractQuantilesDS1.Rd
    -
    +

    identify the global values of V2BR (i.e. the values across all studies) that relate to a set of quantiles to be evaluated.

    -
    +
    +

    Usage

    extractQuantilesDS1(extract.quantiles, extract.summary.output.ranks.df)
    -
    -

    Arguments

    +
    +

    Arguments

    extract.quantiles
    @@ -75,8 +69,8 @@

    Arguments

    ds.extractQuantiles).

    -
    -

    Value

    +
    +

    Value

    as a first step in creating the vector of values of values of V2BR that correspond to each quantile value, extractQuantilesDS1 identifies the two closest quantile values across all studies that span each key quantile @@ -87,8 +81,8 @@

    Value

    available via the client, this function stops the processing and returns a warning/error message.

    -
    -

    Details

    +
    +

    Details

    Severside aggregate function called by ds.extractQuantiles via ds.ranksSecure. As well as estimating the key values of V2BR that correspond to the selected quantiles, this function also implements a disclosure control @@ -102,28 +96,24 @@

    Details

    collectively enable secure global ranking and estimation of global quantiles see the associated document entitled "secure.global.ranking.docx"

    -
    -

    Author

    +
    +

    Author

    Paul Burton 11th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/extractQuantilesDS1.md b/docs/reference/extractQuantilesDS1.md new file mode 100644 index 00000000..b828396a --- /dev/null +++ b/docs/reference/extractQuantilesDS1.md @@ -0,0 +1,66 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies + +identify the global values of V2BR (i.e. the values across all studies) +that relate to a set of quantiles to be evaluated. + +## Usage + +``` r +extractQuantilesDS1(extract.quantiles, extract.summary.output.ranks.df) +``` + +## Arguments + +- extract.quantiles: + + one of a restricted set of character strings that fix the set of + quantile values for which the corresponding values across all studies + are to be estimated. For more details see the associated document + entitled "secure.global.ranking.docx", the header for ds.ranksSecure + and ds.extractQuantiles functions. The value of this argument is set + in choosing the value of the argument \ in + ds.ranksSecure. + +- extract.summary.output.ranks.df: + + character string specifying optional name for the data.frame written + to the serverside on each data source that contains 5 of the key + output variables from the ranking procedure pertaining to that + particular data source. This data frame represents the key source of + information - including global ranks - that determines the values of + V2BR that are identified as corresponding to the particular set of + quantiles to be estimated as specified by the + \ argument of function ds.ranksSecure (and + the \ argument of ds.extractQuantiles). + +## Value + +as a first step in creating the vector of values of values of V2BR that +correspond to each quantile value, extractQuantilesDS1 identifies the +two closest quantile values across all studies that span each key +quantile value. These are saved as the data frame "closest.bounds.df" on +the clientside and then saved on the serverside by ds.dmtC2S into the +data frame "global.bounds.df". Also if the number of observations across +all studies is too small, and a disclosure risk exists if the +final.quantile.vector is made available via the client, this function +stops the processing and returns a warning/error message. + +## Details + +Severside aggregate function called by ds.extractQuantiles via +ds.ranksSecure. As well as estimating the key values of V2BR that +correspond to the selected quantiles, this function also implements a +disclosure control trap. If the ratio of the total number of all +observations across all studies divided by the number of quantile values +to be estimated is less than or equal to nfilter.subset (which specifies +the minimum size of a subset) the process stops and an error message is +returned suggesting that you might try selecting a narrower range of +quantiles with less quantile values to be estimated as specified by the +argument \ of the function ds.ranksSecure. +For more details about the cluster of functions that collectively enable +secure global ranking and estimation of global quantiles see the +associated document entitled "secure.global.ranking.docx" + +## Author + +Paul Burton 11th November, 2021 diff --git a/docs/reference/extractQuantilesDS2.html b/docs/reference/extractQuantilesDS2.html index 94fc91d4..e1d6d96c 100644 --- a/docs/reference/extractQuantilesDS2.html +++ b/docs/reference/extractQuantilesDS2.html @@ -1,56 +1,50 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies — extractQuantilesDS2 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    + - + + + +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    + +
    extractQuantilesDS2.Rd
    -
    +

    identify the global values of V2BR (i.e. the values across all studies) that relate to a set of quantiles to be evaluated.

    -
    +
    +

    Usage

    extractQuantilesDS2(extract.summary.output.ranks.df)
    -
    -

    Arguments

    +
    +

    Arguments

    extract.summary.output.ranks.df
    @@ -65,8 +59,8 @@

    Arguments

    ds.extractQuantiles).

    -
    -

    Value

    +
    +

    Value

    the single value of V2BR which best corresponds to each key quantile value to be estimated as specified by the argument <quantiles.for.estimation> A data frame (final.quantile.df)summarising the results of this analysis @@ -77,8 +71,8 @@

    Value

    "final.quantile.vector" details the values of V2BR that correspond to the the key quantiles listed in vector 1.

    -
    -

    Details

    +
    +

    Details

    Severside aggregate function called by ds.extractQuantiles via ds.ranksSecure. This takes the "global.bounds.df" data frame saved on the serverside following construction by extractQuantilesDS1. This @@ -100,28 +94,24 @@

    Details

    value of V2BR for that quantile (see above for explanation) and so the mean of the two is a reasonable interpolated summary.

    -
    -

    Author

    +
    +

    Author

    Paul Burton 11th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/extractQuantilesDS2.md b/docs/reference/extractQuantilesDS2.md new file mode 100644 index 00000000..99e4e20a --- /dev/null +++ b/docs/reference/extractQuantilesDS2.md @@ -0,0 +1,65 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies + +identify the global values of V2BR (i.e. the values across all studies) +that relate to a set of quantiles to be evaluated. + +## Usage + +``` r +extractQuantilesDS2(extract.summary.output.ranks.df) +``` + +## Arguments + +- extract.summary.output.ranks.df: + + character string specifies an optional name for the data.frame written + to the serverside on each data source that contains 5 of the key + output variables from the ranking procedure pertaining to that + particular data source. This data frame represents the key source of + information - including global ranks - that determines the values of + V2BR that are identified as corresponding to the particular set of + quantiles to be estimated as specified by the + \ argument of function ds.ranksSecure (and + the \ argument of ds.extractQuantiles). + +## Value + +the single value of V2BR which best corresponds to each key quantile +value to be estimated as specified by the argument +\ A data frame (final.quantile.df)summarising +the results of this analysis is written to the clientside. This data +frame consists of two vectors. The first is named +"evaluation.quantiles". It lists the full set of quantiles you have +requested for evaluation as specified by the argument +"quantiles.for.estimation" The second vector which is called +"final.quantile.vector" details the values of V2BR that correspond to +the the key quantiles listed in vector 1. + +## Details + +Severside aggregate function called by ds.extractQuantiles via +ds.ranksSecure. This takes the "global.bounds.df" data frame saved on +the serverside following construction by extractQuantilesDS1. This data +frame includes the two quantile values that most closely span each +quartile value to be estimated. If either of the values had been the +correct value for a given quantile, both the bounding values would have +taken that value in global.bounds.df. This is because the upper bound +was defined as the lowest value that was equal to or greater than the +true value for that quantile while the lower bound was defined as the +highest value that was equal to or lower than the true value. Next, the +function extractQuantileDS2 goes round study by study to identify the +values of V2BR that actually correspond to each of the spanning values +around each quantile. Then the function goes quantile by quantile and +estimates the mean of the two values of V2BR that correspond to the the +spanning quantiles. If these two values are the same it means that that +value of V2BR is the "true" value and the mean of two (or potentially +several) instances of that value is inevitably also equal to that true +value. If the upper and lower bounding values of V2BR differ, neither +can be the precisely correct single value of V2BR for that quantile (see +above for explanation) and so the mean of the two is a reasonable +interpolated summary. + +## Author + +Paul Burton 11th November, 2021 diff --git a/docs/reference/fixClassDS.html b/docs/reference/fixClassDS.html new file mode 100644 index 00000000..35697eae --- /dev/null +++ b/docs/reference/fixClassDS.html @@ -0,0 +1,84 @@ + +Change Class of Target Variables in a Data Frame — fixClassDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Change Class of Target Variables in a Data Frame

    + +
    fixClassDS.Rd
    +
    + +
    +

    Change Class of Target Variables in a Data Frame

    +
    + +
    +

    Usage

    + 
    fixClassDS(df.name, target_vars, target_class)
    +
    + +
    +

    Arguments

    + + +
    df.name
    +

    A string representing the name of the data frame.

    + + +
    target_vars
    +

    A character vector specifying the columns to be modified.

    + + +
    target_class
    +

    A character vector specifying the new classes for each column (1 = factor, +2 = integer, 3 = numeric, 4 = character, 5 = logical).

    + +
    +
    +

    Value

    +

    A modified data frame with the specified columns converted to the target classes.

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/fixClassDS.md b/docs/reference/fixClassDS.md new file mode 100644 index 00000000..cd7e9d0e --- /dev/null +++ b/docs/reference/fixClassDS.md @@ -0,0 +1,29 @@ +# Change Class of Target Variables in a Data Frame + +Change Class of Target Variables in a Data Frame + +## Usage + +``` r +fixClassDS(df.name, target_vars, target_class) +``` + +## Arguments + +- df.name: + + A string representing the name of the data frame. + +- target_vars: + + A character vector specifying the columns to be modified. + +- target_class: + + A character vector specifying the new classes for each column (1 = + factor, 2 = integer, 3 = numeric, 4 = character, 5 = logical). + +## Value + +A modified data frame with the specified columns converted to the target +classes. diff --git a/docs/reference/fixColsDS.html b/docs/reference/fixColsDS.html new file mode 100644 index 00000000..0718c215 --- /dev/null +++ b/docs/reference/fixColsDS.html @@ -0,0 +1,79 @@ + +Add Missing Columns with NA Values — fixColsDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Add Missing Columns with NA Values

    + +
    fixColsDS.Rd
    +
    + +
    +

    Add Missing Columns with NA Values

    +
    + +
    +

    Usage

    + 
    fixColsDS(.data, cols)
    +
    + +
    +

    Arguments

    + + +
    .data
    +

    A string representing the name of the data frame.

    + + +
    cols
    +

    A character vector specifying the columns to be added if missing.

    + +
    +
    +

    Value

    +

    A modified data frame with missing columns added and filled with NA.

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/fixColsDS.md b/docs/reference/fixColsDS.md new file mode 100644 index 00000000..25ca1b61 --- /dev/null +++ b/docs/reference/fixColsDS.md @@ -0,0 +1,23 @@ +# Add Missing Columns with NA Values + +Add Missing Columns with NA Values + +## Usage + +``` r +fixColsDS(.data, cols) +``` + +## Arguments + +- .data: + + A string representing the name of the data frame. + +- cols: + + A character vector specifying the columns to be added if missing. + +## Value + +A modified data frame with missing columns added and filled with NA. diff --git a/docs/reference/fixLevelsDS.html b/docs/reference/fixLevelsDS.html new file mode 100644 index 00000000..f3cab97d --- /dev/null +++ b/docs/reference/fixLevelsDS.html @@ -0,0 +1,83 @@ + +Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Set Factor Levels for Specific Columns in a Data Frame

    + +
    fixLevelsDS.Rd
    +
    + +
    +

    Set Factor Levels for Specific Columns in a Data Frame

    +
    + +
    +

    Usage

    + 
    fixLevelsDS(df.name, vars, levels)
    +
    + +
    +

    Arguments

    + + +
    df.name
    +

    A string representing the name of the data frame to modify.

    + + +
    vars
    +

    A character vector specifying the columns to be modified.

    + + +
    levels
    +

    A named list where each element contains the levels for the corresponding factor variable.

    + +
    +
    +

    Value

    +

    A modified data frame with the specified columns converted to factors with the provided levels.

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/fixLevelsDS.md b/docs/reference/fixLevelsDS.md new file mode 100644 index 00000000..54c693e4 --- /dev/null +++ b/docs/reference/fixLevelsDS.md @@ -0,0 +1,29 @@ +# Set Factor Levels for Specific Columns in a Data Frame + +Set Factor Levels for Specific Columns in a Data Frame + +## Usage + +``` r +fixLevelsDS(df.name, vars, levels) +``` + +## Arguments + +- df.name: + + A string representing the name of the data frame to modify. + +- vars: + + A character vector specifying the columns to be modified. + +- levels: + + A named list where each element contains the levels for the + corresponding factor variable. + +## Value + +A modified data frame with the specified columns converted to factors +with the provided levels. diff --git a/docs/reference/gamlssDS.html b/docs/reference/gamlssDS.html index 94fbce79..f1be9220 100644 --- a/docs/reference/gamlssDS.html +++ b/docs/reference/gamlssDS.html @@ -1,51 +1,49 @@ -gamlssDS an aggregate function called by ds.gamlss — gamlssDS • dsBase - - -
    -
    -
    -
    -

    gamlssDS an aggregate function called by ds.gamlss

    + - + + + +
    +
    +
    +
    + +

    gamlssDS an aggregate function called by ds.gamlss

    + +
    gamlssDS.Rd
    -
    +

    This function calls the gamlssDS that is a wrapper function from the gamlss R package. The function returns an object of class "gamlss", which is a generalized additive model for location, scale and shape (GAMLSS). The @@ -55,7 +53,8 @@

    gamlssDS an aggregate function called by ds.gamlss

    returns the sample percentages below each centile curve.

    -
    +
    +

    Usage

    gamlssDS(
   formula = formula,
   sigma.formula = sigma.formula,
@@ -76,8 +75,8 @@ 
    gamlssDS an aggregate function called by ds.gamlss
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -183,40 +182,36 @@

    Arguments

    that is stored on the data servers. Default gamlss_residuals.

    -
    -

    Value

    +
    +

    Value

    a gamlss object with all components as in the native R gamlss function. Individual-level information like the components y (the response response) and residuals (the normalised quantile residuals of the model) are not disclosed to the client-side.

    -
    -

    Details

    +
    +

    Details

    For additional details see the help header of gamlss and centiles functions in native R gamlss package.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/gamlssDS.md b/docs/reference/gamlssDS.md new file mode 100644 index 00000000..3bc67567 --- /dev/null +++ b/docs/reference/gamlssDS.md @@ -0,0 +1,158 @@ +# gamlssDS an aggregate function called by ds.gamlss + +This function calls the gamlssDS that is a wrapper function from the +gamlss R package. The function returns an object of class "gamlss", +which is a generalized additive model for location, scale and shape +(GAMLSS). The function also saves the residuals as an object on the +server-side with a name specified by the newobj argument. In addition, +if the argument centiles is set to TRUE, the function calls the centiles +function from the gamlss package and returns the sample percentages +below each centile curve. + +## Usage + +``` r +gamlssDS( + formula = formula, + sigma.formula = sigma.formula, + nu.formula = nu.formula, + tau.formula = tau.formula, + family = family, + data = data, + method = method, + mu.fix = mu.fix, + sigma.fix = sigma.fix, + nu.fix = nu.fix, + tau.fix = tau.fix, + control = control, + i.control = i.control, + centiles = centiles, + xvar = xvar, + newobj = newobj +) +``` + +## Arguments + +- formula: + + a formula object, with the response on the left of an ~ operator, and + the terms, separated by + operators, on the right. Nonparametric + smoothing terms are indicated by pb() for penalised beta splines, cs + for smoothing splines, lo for loess smooth terms and random or ra for + random terms, e.g. y~cs(x,df=5)+x1+x2\*x3. + +- sigma.formula: + + a formula object for fitting a model to the sigma parameter, as in the + formula above, e.g. sigma.formula=~cs(x,df=5). + +- nu.formula: + + a formula object for fitting a model to the nu parameter, e.g. + nu.formula=~x + +- tau.formula: + + a formula object for fitting a model to the tau parameter, e.g. + tau.formula=~cs(x,df=2) + +- family: + + a gamlss.family object, which is used to define the distribution and + the link functions of the various parameters. The distribution + families supported by gamlss() can be found in gamlss.family. + Functions such as BI() (binomial) produce a family object. Also can be + given without the parentheses i.e. BI. Family functions can take + arguments, as in BI(mu.link=probit). + +- data: + + a data frame containing the variables occurring in the formula. If + this is missing, the variables should be on the parent environment. + +- method: + + a character indicating the algorithm for GAMLSS. Can be either 'RS', + 'CG' or 'mixed'. If method='RS' the function will use the Rigby and + Stasinopoulos algorithm, if method='CG' the function will use the Cole + and Green algorithm, and if method='mixed' the function will use the + RS algorithm twice before switching to the Cole and Green algorithm + for up to 10 extra iterations. + +- mu.fix: + + logical, indicate whether the mu parameter should be kept fixed in the + fitting processes. + +- sigma.fix: + + logical, indicate whether the sigma parameter should be kept fixed in + the fitting processes. + +- nu.fix: + + logical, indicate whether the nu parameter should be kept fixed in the + fitting processes. + +- tau.fix: + + logical, indicate whether the tau parameter should be kept fixed in + the fitting processes. + +- control: + + this sets the control parameters of the outer iterations algorithm + using the gamlss.control function. This is a vector of 7 numeric + values: (i) c.crit (the convergence criterion for the algorithm), (ii) + n.cyc (the number of cycles of the algorithm), (iii) mu.step (the step + length for the parameter mu), (iv) sigma.step (the step length for the + parameter sigma), (v) nu.step (the step length for the parameter + nu), (vi) tau.step (the step length for the parameter tau), (vii) + gd.tol (global deviance tolerance level). The default values for these + 7 parameters are set to c(0.001, 20, 1, 1, 1, 1, Inf). + +- i.control: + + this sets the control parameters of the inner iterations of the RS + algorithm using the glim.control function. This is a vector of 4 + numeric values: (i) cc (the convergence criterion for the + algorithm), (ii) cyc (the number of cycles of the algorithm), (iii) + bf.cyc (the number of cycles of the backfitting algorithm), (iv) + bf.tol (the convergence criterion (tolerance level) for the + backfitting algorithm). The default values for these 4 parameters are + set to c(0.001, 50, 30, 0.001). + +- centiles: + + logical, indicating whether the function centiles() will be used to + tabulate the sample percentages below each centile curve. Default is + set to FALSE. + +- xvar: + + the unique explanatory variable used in the centiles() function. This + variable is used only if the centiles argument is set to TRUE. A + restriction in the centiles function is that it applies to models with + one explanatory variable only. + +- newobj: + + a character string that provides the name for the output object that + is stored on the data servers. Default `gamlss_residuals`. + +## Value + +a gamlss object with all components as in the native R gamlss function. +Individual-level information like the components y (the response +response) and residuals (the normalised quantile residuals of the model) +are not disclosed to the client-side. + +## Details + +For additional details see the help header of gamlss and centiles +functions in native R gamlss package. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/getAllLevelsDS.html b/docs/reference/getAllLevelsDS.html new file mode 100644 index 00000000..2712667d --- /dev/null +++ b/docs/reference/getAllLevelsDS.html @@ -0,0 +1,79 @@ + +Retrieve Factor Levels for Specific Columns — getAllLevelsDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Retrieve Factor Levels for Specific Columns

    + +
    getAllLevelsDS.Rd
    +
    + +
    +

    Retrieve Factor Levels for Specific Columns

    +
    + +
    +

    Usage

    + 
    getAllLevelsDS(df.name, factor_vars)
    +
    + +
    +

    Arguments

    + + +
    df.name
    +

    A string representing the name of the data frame.

    + + +
    factor_vars
    +

    A character vector specifying the factor columns.

    + +
    +
    +

    Value

    +

    A list of factor levels for the specified columns.

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/getAllLevelsDS.md b/docs/reference/getAllLevelsDS.md new file mode 100644 index 00000000..adba3ac1 --- /dev/null +++ b/docs/reference/getAllLevelsDS.md @@ -0,0 +1,23 @@ +# Retrieve Factor Levels for Specific Columns + +Retrieve Factor Levels for Specific Columns + +## Usage + +``` r +getAllLevelsDS(df.name, factor_vars) +``` + +## Arguments + +- df.name: + + A string representing the name of the data frame. + +- factor_vars: + + A character vector specifying the factor columns. + +## Value + +A list of factor levels for the specified columns. diff --git a/docs/reference/getClassAllColsDS.html b/docs/reference/getClassAllColsDS.html new file mode 100644 index 00000000..bbec37d0 --- /dev/null +++ b/docs/reference/getClassAllColsDS.html @@ -0,0 +1,75 @@ + +Get the Class of All Columns in a Data Frame — getClassAllColsDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Get the Class of All Columns in a Data Frame

    + +
    getClassAllColsDS.Rd
    +
    + +
    +

    Get the Class of All Columns in a Data Frame

    +
    + +
    +

    Usage

    + 
    getClassAllColsDS(df.name)
    +
    + +
    +

    Arguments

    + + +
    df.name
    +

    A string representing the name of the data frame.

    + +
    +
    +

    Value

    +

    A tibble with the class of each column in the data frame.

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/getClassAllColsDS.md b/docs/reference/getClassAllColsDS.md new file mode 100644 index 00000000..2efb3e28 --- /dev/null +++ b/docs/reference/getClassAllColsDS.md @@ -0,0 +1,19 @@ +# Get the Class of All Columns in a Data Frame + +Get the Class of All Columns in a Data Frame + +## Usage + +``` r +getClassAllColsDS(df.name) +``` + +## Arguments + +- df.name: + + A string representing the name of the data frame. + +## Value + +A tibble with the class of each column in the data frame. diff --git a/docs/reference/getWGSRDS.html b/docs/reference/getWGSRDS.html index fb40e162..27b73cc0 100644 --- a/docs/reference/getWGSRDS.html +++ b/docs/reference/getWGSRDS.html @@ -1,56 +1,50 @@ -Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS • dsBase - - -
    -
    -
    -
    -

    Computes the WHO Growth Reference z-scores of anthropometric data

    + - + + + +
    +
    +
    +
    + +

    Computes the WHO Growth Reference z-scores of anthropometric data

    + +
    getWGSRDS.Rd
    -
    +

    Calculate WHO Growth Reference z-score for a given anthropometric measurement This function is similar to R function getWGSR from the zscorer package.

    -
    +
    +

    Usage

    getWGSRDS(sex, firstPart, secondPart, index, standing = NA, thirdPart = NA)
    -
    -

    Arguments

    +
    +

    Arguments

    sex
    @@ -109,13 +103,13 @@

    Arguments

    name as in (e.g.) "age". Be careful with units (age in days).

    -
    -

    Value

    +
    +

    Value

    ds.getWGSR assigns a numeric vector that includes the z-scores for the specified index.

    -
    -

    Details

    +
    +

    Details

    The function computes the WHO Growth Reference z-scores of anthropometric data for weight, height or length, MUAC, head circumference, sub-scapular skinfold and triceps skinfold. Note that the function might fail or return NAs when the variables are outside the ranges @@ -123,28 +117,24 @@

    Details

    0 to 60 months for age). It is up to the user to check the ranges and the units of their data.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/getWGSRDS.md b/docs/reference/getWGSRDS.md new file mode 100644 index 00000000..93a43e36 --- /dev/null +++ b/docs/reference/getWGSRDS.md @@ -0,0 +1,92 @@ +# Computes the WHO Growth Reference z-scores of anthropometric data + +Calculate WHO Growth Reference z-score for a given anthropometric +measurement This function is similar to R function `getWGSR` from the +`zscorer` package. + +## Usage + +``` r +getWGSRDS(sex, firstPart, secondPart, index, standing = NA, thirdPart = NA) +``` + +## Arguments + +- sex: + + the name of the binary variable that indicates the sex of the subject. + This must be coded as 1 = male and 2 = female. If in your project the + variable sex has different levels, you should recode the levels to 1 + for males and 2 for females using the `ds.recodeValues` DataSHIELD + function before the use of the `ds.getWGSR`. + +- firstPart: + + Name of variable specifying: + Weight (kg) for BMI/A, W/A, W/H, or W/L + Head circumference (cm) for HC/A + Height (cm) for H/A + Length (cm) for L/A + MUAC (cm) for MUAC/A + Sub-scapular skinfold (mm) for SSF/A + Triceps skinfold (mm) for TSF/A + Give a quoted variable name as in (e.g.) "weight". Be careful with + units (weight in kg; height, length, head circumference, and MUAC in + cm, skinfolds in mm). + +- secondPart: + + Name of variable specifying: + Age (days) for H/A, HC/A, L/A, MUAC/A, SSF/A, or TSF/A + Height (cm) for BMI/A, or W/H + Length (cm) for W/L + Give a quoted variable name as in (e.g.) "age". Be careful with units + (age in days; height and length in cm). + +- index: + + The index to be calculated and added to data. One of: + bfa BMI for age + hca Head circumference for age + hfa Height for age + lfa Length for age + mfa MUAC for age + ssa Sub-scapular skinfold for age + tsa Triceps skinfold for age + wfa Weight for age + wfh Weight for height + wfl Weight for length + Give a quoted index name as in (e.g.) "wfh". + +- standing: + + Variable specifying how stature was measured. If NA (default) then age + (for "hfa" or "lfa") or height rules (for "wfh" or "wfl") will be + applied. This must be coded as 1 = Standing; 2 = Supine; 3 = Unknown. + Missing values will be recoded to 3 = Unknown. Give a single value + (e.g."1"). If no value is specified then height and age rules will be + applied. + +- thirdPart: + + Name of variable specifying age (in days) for BMI/A. Give a quoted + variable name as in (e.g.) "age". Be careful with units (age in days). + +## Value + +`ds.getWGSR` assigns a numeric vector that includes the z-scores for the +specified index. + +## Details + +The function computes the WHO Growth Reference z-scores of +anthropometric data for weight, height or length, MUAC, head +circumference, sub-scapular skinfold and triceps skinfold. Note that the +function might fail or return NAs when the variables are outside the +ranges given in the WGS (WHO Child Growth Standards) reference (i.e. 45 +to 120 cm for height and 0 to 60 months for age). It is up to the user +to check the ranges and the units of their data. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/glmDS1.html b/docs/reference/glmDS1.html index 058ae910..626a7393 100644 --- a/docs/reference/glmDS1.html +++ b/docs/reference/glmDS1.html @@ -1,54 +1,47 @@ -glmDS1 called by ds.glm — glmDS1 • dsBase - - -
    -
    -
    -
    -

    glmDS1 called by ds.glm

    + - + + + +
    +
    +
    +
    + +

    glmDS1 called by ds.glm

    + +
    glmDS1.Rd
    -
    +

    This is the first server-side aggregate function called by ds.glm

    -
    +
    +

    Usage

    glmDS1(formula, family, weights, offset, data)
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -75,40 +68,36 @@

    Arguments

    analysed under the specified model

    -
    -

    Value

    +
    +

    Value

    List with values from GLM model.

    -
    -

    Details

    +
    +

    Details

    It is an aggregation function that sets up the model structure and creates the starting beta.vector that feeds, via ds.glm, into glmDS2 to enable iterative fitting of the generalized linear model that has been been specified. For more details please see the extensive header for ds.glm.

    -
    -

    Author

    +
    +

    Author

    Burton PR for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmDS1.md b/docs/reference/glmDS1.md new file mode 100644 index 00000000..42ce28b4 --- /dev/null +++ b/docs/reference/glmDS1.md @@ -0,0 +1,50 @@ +# glmDS1 called by ds.glm + +This is the first server-side aggregate function called by ds.glm + +## Usage + +``` r +glmDS1(formula, family, weights, offset, data) +``` + +## Arguments + +- formula: + + a glm() formula consistent with R syntax eg U~x+y+Z to regress + variables U on x,y and Z + +- family: + + a glm() family consistent with R syntax eg "gaussian", "poisson", + "binomial" + +- weights: + + an optional variable providing regression weights + +- offset: + + the offset + +- data: + + an optional character string specifying a data.frame object holding + the data to be analysed under the specified model + +## Value + +List with values from GLM model. + +## Details + +It is an aggregation function that sets up the model structure and +creates the starting beta.vector that feeds, via ds.glm, into glmDS2 to +enable iterative fitting of the generalized linear model that has been +been specified. For more details please see the extensive header for +ds.glm. + +## Author + +Burton PR for DataSHIELD Development Team diff --git a/docs/reference/glmDS2.html b/docs/reference/glmDS2.html index 71ccd910..5d41de1a 100644 --- a/docs/reference/glmDS2.html +++ b/docs/reference/glmDS2.html @@ -1,54 +1,47 @@ -glmDS2 called by ds.glm — glmDS2 • dsBase - - -
    -
    -
    -
    -

    glmDS2 called by ds.glm

    + - + + + +
    +
    +
    +
    + +

    glmDS2 called by ds.glm

    + +
    glmDS2.Rd
    -
    +

    This is the second server-side aggregate function called by ds.glm.

    -
    +
    +

    Usage

    glmDS2(formula, family, beta.vect, offset, weights, dataName)
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -79,12 +72,12 @@

    Arguments

    the data to be analysed under the specified model same

    -
    -

    Value

    +
    +

    Value

    List with values from GLM model

    -
    -

    Details

    +
    +

    Details

    It is an aggregate function that uses the model structure and starting beta.vector constructed by glmDS1 to iteratively fit the generalized linear model that has been specified. The function glmDS2 also carries out a series of disclosure @@ -93,28 +86,24 @@

    Details

    created and returned to ds.glm on the clientside. For more details please see the extensive header for ds.glm.

    -
    -

    Author

    +
    +

    Author

    Paul Burton, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmDS2.md b/docs/reference/glmDS2.md new file mode 100644 index 00000000..5be71c72 --- /dev/null +++ b/docs/reference/glmDS2.md @@ -0,0 +1,57 @@ +# glmDS2 called by ds.glm + +This is the second server-side aggregate function called by ds.glm. + +## Usage + +``` r +glmDS2(formula, family, beta.vect, offset, weights, dataName) +``` + +## Arguments + +- formula: + + a glm() formula consistent with R syntax eg U~x+y+Z to regress + variables U on x, y and Z + +- family: + + a glm() family consistent with R syntax eg "gaussian", "poisson", + "binomial" + +- beta.vect: + + a numeric vector created by the clientside function specifying the + vector of regression coefficients at the current iteration + +- offset: + + an optional variable providing a regression offset + +- weights: + + an optional variable providing regression weights + +- dataName: + + an optional character string specifying a data.frame object holding + the data to be analysed under the specified model same + +## Value + +List with values from GLM model + +## Details + +It is an aggregate function that uses the model structure and starting +beta.vector constructed by glmDS1 to iteratively fit the generalized +linear model that has been specified. The function glmDS2 also carries +out a series of disclosure checks and if the arguments or data fail any +of those tests, model construction is blocked and an appropriate +serverside error message is created and returned to ds.glm on the +clientside. For more details please see the extensive header for ds.glm. + +## Author + +Paul Burton, for DataSHIELD Development Team diff --git a/docs/reference/glmPredictDS.ag.html b/docs/reference/glmPredictDS.ag.html index f99f1f21..1cbe2ac1 100644 --- a/docs/reference/glmPredictDS.ag.html +++ b/docs/reference/glmPredictDS.ag.html @@ -1,53 +1,48 @@ -predict regression responses from a glm object — glmPredictDS.ag • dsBasepredict regression responses from a glm object — glmPredictDS.ag • dsBase - - -
    -
    -
    -
    -

    predict regression responses from a glm object

    - +
    +
    +
    +
    + +

    predict regression responses from a glm object

    + +
    glmPredictDS.ag.Rd
    -
    +

    identify and return key components/summaries of a serverside glm_predict object that can safely be returned to the clientside without disclosure risk

    -
    +
    +

    Usage

    glmPredictDS.ag(
   glmname.transmit,
   newdataname.transmit,
@@ -59,8 +54,8 @@ 
    predict regression responses from a glm object
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    glmname.transmit
    @@ -101,16 +96,16 @@

    Arguments

    Fully specified by na.action argument in ds.glmPredict.

    -
    -

    Value

    +
    +

    Value

    components/summarising statistics of a serverside predict_glm object that can safely be transmitted to the clientside without a risk of disclosure. For further details see DataSHIELD help for ds.glmPredict and glmPredict.as and help in native R for predict.glm predict.glm in native R

    -
    -

    Details

    +
    +

    Details

    Serverside aggregate function called by ds.glmPredict. It is called immediately after the assign function glmPredict.as has created a predict_glm object on the serverside by applying @@ -120,28 +115,24 @@

    Details

    without a risk of disclosure. For further details see DataSHIELD help for ds.glmPredict and glmPredict.as and help in native R for predict.glm

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (20/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmPredictDS.ag.md b/docs/reference/glmPredictDS.ag.md new file mode 100644 index 00000000..e1518d87 --- /dev/null +++ b/docs/reference/glmPredictDS.ag.md @@ -0,0 +1,85 @@ +# predict regression responses from a glm object + +identify and return key components/summaries of a serverside glm_predict +object that can safely be returned to the clientside without disclosure +risk + +## Usage + +``` r +glmPredictDS.ag( + glmname.transmit, + newdataname.transmit, + output.type, + se.fit, + dispersion, + terms.transmit, + na.action +) +``` + +## Arguments + +- glmname.transmit: + + a character string specifying the name of the glm object on the + serverside that is to be used for prediction. Fully specified by + glmname argument in ds.glmPredict + +- newdataname.transmit: + + a character string specifying an (optional) dataframe on the + serverside in which to look for (potentially) new covariate values on + which to base the predictions. Fully specified by newdataname argument + in ds.glmPredict. + +- output.type: + + a character string taking the values 'response', 'link' or 'terms'. + Fully specified by corresponding argument in ds.glmPredict. + +- se.fit: + + logical if standard errors for the fitted predictions are required. + Fully specified by corresponding argument in ds.glmPredict. + +- dispersion: + + numeric value specifying the dispersion of the GLM fit to be assumed + in computing the standard errors. Fully specified by corresponding + argument in ds.glmPredict. + +- terms.transmit: + + a character vector specifying a subset of terms to return in the + prediction. Fully specified by 'terms' argument in ds.glmPredict. + +- na.action: + + character string determining what should be done with missing values + in the data.frame identified by \. Fully + specified by na.action argument in ds.glmPredict. + +## Value + +components/summarising statistics of a serverside predict_glm object +that can safely be transmitted to the clientside without a risk of +disclosure. For further details see DataSHIELD help for ds.glmPredict +and glmPredict.as and help in native R for predict.glm predict.glm in +native R + +## Details + +Serverside aggregate function called by ds.glmPredict. It is called +immediately after the assign function glmPredict.as has created a +predict_glm object on the serverside by applying the equivalent of +predict.glm() in native R to a glm object on the serverside. The +aggregate function, glmPredict.ag, then identifies and returns +components of that predict_glm object that can safely be returned to the +clientside without a risk of disclosure. For further details see +DataSHIELD help for ds.glmPredict and glmPredict.as and help in native R +for predict.glm + +## Author + +Paul Burton for DataSHIELD Development Team (20/7/20) diff --git a/docs/reference/glmPredictDS.as.html b/docs/reference/glmPredictDS.as.html index 763f05f2..848ffb27 100644 --- a/docs/reference/glmPredictDS.as.html +++ b/docs/reference/glmPredictDS.as.html @@ -1,55 +1,51 @@ -predict regression responses from a glm object — glmPredictDS.as • dsBasepredict regression responses from a glm object — glmPredictDS.as • dsBase - - -
    -
    -
    -
    -

    predict regression responses from a glm object

    - +
    +
    +
    +
    + +

    predict regression responses from a glm object

    + +
    glmPredictDS.as.Rd
    -
    +

    create a predict_glm object on the serverside by applying the equivalent of predict.glm() in native R to a glm object on the serverside. Identify and return components of the predict_glm object that can safely be sent to the clientside without a risk of disclosure

    -
    +
    +

    Usage

    glmPredictDS.as(
   glmname.transmit,
   newdataname.transmit,
@@ -61,8 +57,8 @@ 
    predict regression responses from a glm object
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    glmname.transmit
    @@ -103,15 +99,15 @@

    Arguments

    Fully specified by na.action argument in ds.glmPredict.

    -
    -

    Value

    +
    +

    Value

    glmPredict.as writes a new object to the serverside containing output precisely equivalent to the output from predict.glm in native R. For more details see DataSHIELD help for ds.glmPredict and help for predict.glm in native R

    -
    -

    Details

    +
    +

    Details

    Serverside assign function called by ds.glmPredict makes predictions of regression responses based on a serverside glm object that has already been created on the serverside by ds.glmSLMA and @@ -119,28 +115,24 @@

    Details

    For further details see help for ds.glmPredict and help in native R for predict.glm

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (20/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmPredictDS.as.md b/docs/reference/glmPredictDS.as.md new file mode 100644 index 00000000..09b18452 --- /dev/null +++ b/docs/reference/glmPredictDS.as.md @@ -0,0 +1,81 @@ +# predict regression responses from a glm object + +create a predict_glm object on the serverside by applying the equivalent +of predict.glm() in native R to a glm object on the serverside. Identify +and return components of the predict_glm object that can safely be sent +to the clientside without a risk of disclosure + +## Usage + +``` r +glmPredictDS.as( + glmname.transmit, + newdataname.transmit, + output.type, + se.fit, + dispersion, + terms.transmit, + na.action +) +``` + +## Arguments + +- glmname.transmit: + + a character string specifying the name of the glm object on the + serverside that is to be used for prediction. Fully specified by + glmname argument in ds.glmPredict + +- newdataname.transmit: + + a character string specifying an (optional) dataframe on the + serverside in which to look for (potentially) new covariate values on + which to base the predictions. Fully specified by newdataname argument + in ds.glmPredict. + +- output.type: + + a character string taking the values 'response', 'link' or 'terms'. + Fully specified by corresponding argument in ds.glmPredict. + +- se.fit: + + logical if standard errors for the fitted predictions are required. + Fully specified by corresponding argument in ds.glmPredict. + +- dispersion: + + numeric value specifying the dispersion of the GLM fit to be assumed + in computing the standard errors. Fully specified by corresponding + argument in ds.glmPredict. + +- terms.transmit: + + a character vector specifying a subset of terms to return in the + prediction. Fully specified by 'terms' argument in ds.glmPredict. + +- na.action: + + character string determining what should be done with missing values + in the data.frame identified by \. Fully + specified by na.action argument in ds.glmPredict. + +## Value + +glmPredict.as writes a new object to the serverside containing output +precisely equivalent to the output from predict.glm in native R. For +more details see DataSHIELD help for ds.glmPredict and help for +predict.glm in native R + +## Details + +Serverside assign function called by ds.glmPredict makes predictions of +regression responses based on a serverside glm object that has already +been created on the serverside by ds.glmSLMA and and writes the +predict_glm object to the serverside. For further details see help for +ds.glmPredict and help in native R for predict.glm + +## Author + +Paul Burton for DataSHIELD Development Team (20/7/20) diff --git a/docs/reference/glmSLMADS.assign.html b/docs/reference/glmSLMADS.assign.html index 13ea50d0..b2c9410c 100644 --- a/docs/reference/glmSLMADS.assign.html +++ b/docs/reference/glmSLMADS.assign.html @@ -1,56 +1,50 @@ -Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign • dsBase - - -
    -
    -
    -
    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + - + + + +
    +
    +
    +
    + +

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + +
    glmSLMADS.assign.Rd
    -
    +

    Fits a generalized linear model (GLM) on data from single or multiple sources with pooled co-analysis across studies being based on SLMA (Study Level Meta Analysis).

    -
    +
    +

    Usage

    glmSLMADS.assign(formula, family, offsetName, weightsName, dataName)
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -76,39 +70,35 @@

    Arguments

    holding the data for the model. Specified in call to ds.glmSLMA.

    -
    -

    Value

    +
    +

    Value

    writes glm object summarising the fitted model to the serverside. For more detailed information see help for ds.glmSLMA.

    -
    -

    Details

    +
    +

    Details

    glmSLMADS.assign is an assign function called by clientside function ds.glmSLMA. ds.glmSLMA also calls two aggregate functions glmSLMADS1 and glmSLMADS2. For more detailed information see help for ds.glmSLMA.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (14/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmSLMADS.assign.md b/docs/reference/glmSLMADS.assign.md new file mode 100644 index 00000000..c8855662 --- /dev/null +++ b/docs/reference/glmSLMADS.assign.md @@ -0,0 +1,52 @@ +# Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) + +Fits a generalized linear model (GLM) on data from single or multiple +sources with pooled co-analysis across studies being based on SLMA +(Study Level Meta Analysis). + +## Usage + +``` r +glmSLMADS.assign(formula, family, offsetName, weightsName, dataName) +``` + +## Arguments + +- formula: + + a glm formula, specified in call to ds.glmSLMA + +- family: + + a glm family, specified in call to ds.glmSLMA + +- offsetName: + + a character string specifying a variable to be used as an offset. + Specified in call to ds.glmSLMA. + +- weightsName: + + a character string specifying a variable to be used as regression + weights. Specified in call to ds.glmSLMA. Specified in call to + ds.glmSLMA. + +- dataName: + + a character string specifying the name of a data.frame holding the + data for the model. Specified in call to ds.glmSLMA. + +## Value + +writes glm object summarising the fitted model to the serverside. For +more detailed information see help for ds.glmSLMA. + +## Details + +glmSLMADS.assign is an assign function called by clientside function +ds.glmSLMA. ds.glmSLMA also calls two aggregate functions glmSLMADS1 and +glmSLMADS2. For more detailed information see help for ds.glmSLMA. + +## Author + +Paul Burton for DataSHIELD Development Team (14/7/20) diff --git a/docs/reference/glmSLMADS1.html b/docs/reference/glmSLMADS1.html index 95fd50ed..4a79832a 100644 --- a/docs/reference/glmSLMADS1.html +++ b/docs/reference/glmSLMADS1.html @@ -1,56 +1,50 @@ -Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1 • dsBase - - -
    -
    -
    -
    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + - + + + +
    +
    +
    +
    + +

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + +
    glmSLMADS1.Rd
    -
    +

    Fits a generalized linear model (GLM) on data from single or multiple sources with pooled co-analysis across studies being based on SLMA (Study Level Meta Analysis).

    -
    +
    +

    Usage

    glmSLMADS1(formula, family, weights, offset, data)
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -76,41 +70,37 @@

    Arguments

    holding the data for the model. Specified as dataName in call to ds.glmSLMA.

    -
    -

    Value

    +
    +

    Value

    assesses and returns information about failure to pass disclosure traps such as test of model complexity (saturation). For more detailed information see help for ds.glmSLMA.

    -
    -

    Details

    +
    +

    Details

    glmSLMADS.assign is an aggregate function called by clientside function ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 and an assign function glmSLMADS.assign For more detailed information see help for ds.glmSLMA.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (14/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmSLMADS1.md b/docs/reference/glmSLMADS1.md new file mode 100644 index 00000000..7a1a4ac2 --- /dev/null +++ b/docs/reference/glmSLMADS1.md @@ -0,0 +1,54 @@ +# Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) + +Fits a generalized linear model (GLM) on data from single or multiple +sources with pooled co-analysis across studies being based on SLMA +(Study Level Meta Analysis). + +## Usage + +``` r +glmSLMADS1(formula, family, weights, offset, data) +``` + +## Arguments + +- formula: + + a glm formula, specified in call to ds.glmSLMA + +- family: + + a glm family, specified in call to ds.glmSLMA + +- weights: + + a character string specifying a variable to be used as regression + weights. Specified in call to ds.glmSLMA. Specified in call to + ds.glmSLMA. + +- offset: + + a character string specifying a variable to be used as an offset. + Specified in call to ds.glmSLMA. + +- data: + + a character string specifying the name of a data.frame holding the + data for the model. Specified as dataName in call to ds.glmSLMA. + +## Value + +assesses and returns information about failure to pass disclosure traps +such as test of model complexity (saturation). For more detailed +information see help for ds.glmSLMA. + +## Details + +glmSLMADS.assign is an aggregate function called by clientside function +ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 +and an assign function glmSLMADS.assign For more detailed information +see help for ds.glmSLMA. + +## Author + +Paul Burton for DataSHIELD Development Team (14/7/20) diff --git a/docs/reference/glmSLMADS2.html b/docs/reference/glmSLMADS2.html index 22858f93..3a0604c0 100644 --- a/docs/reference/glmSLMADS2.html +++ b/docs/reference/glmSLMADS2.html @@ -1,56 +1,50 @@ -Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2 • dsBase - - -
    -
    -
    -
    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + - + + + +
    +
    +
    +
    + +

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    + +
    glmSLMADS2.Rd
    -
    +

    Fits a generalized linear model (GLM) on data from single or multiple sources with pooled co-analysis across studies being based on SLMA (Study Level Meta Analysis).

    -
    +
    +

    Usage

    glmSLMADS2(formula, family, offset, weights, newobj, dataName)
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -83,42 +77,38 @@

    Arguments

    holding the data for the model. Specified in call to ds.glmSLMA.

    -
    -

    Value

    +
    +

    Value

    All quantitative, Boolean, and character objects required to enable the SLMA pooling of the separate glm models fitted to each study - in particular including the study-specific regression coefficients and their corresponding standard errors.

    -
    -

    Details

    +
    +

    Details

    glmSLMADS.assign is an aggregate function called by clientside function ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 and an assign function glmSLMADS.assign For more detailed information see help for ds.glmSLMA.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (14/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmSLMADS2.md b/docs/reference/glmSLMADS2.md new file mode 100644 index 00000000..50b4f462 --- /dev/null +++ b/docs/reference/glmSLMADS2.md @@ -0,0 +1,62 @@ +# Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) + +Fits a generalized linear model (GLM) on data from single or multiple +sources with pooled co-analysis across studies being based on SLMA +(Study Level Meta Analysis). + +## Usage + +``` r +glmSLMADS2(formula, family, offset, weights, newobj, dataName) +``` + +## Arguments + +- formula: + + a glm formula, specified in call to ds.glmSLMA + +- family: + + a glm family, specified in call to ds.glmSLMA + +- offset: + + a character string specifying a variable to be used as an offset. + Specified in call to ds.glmSLMA. + +- weights: + + a character string specifying a variable to be used as regression + weights. Specified in call to ds.glmSLMA. Specified in call to + ds.glmSLMA. + +- newobj: + + a character string specifying the name of the glm object written to + the serverside by glmSLMADS.assign. This is either the name specified + by the newobj argument in ds.glmSLMA or if newobj was unspecified or + NULL it is called new.glm.obj. + +- dataName: + + a character string specifying the name of a data.frame holding the + data for the model. Specified in call to ds.glmSLMA. + +## Value + +All quantitative, Boolean, and character objects required to enable the +SLMA pooling of the separate glm models fitted to each study - in +particular including the study-specific regression coefficients and +their corresponding standard errors. + +## Details + +glmSLMADS.assign is an aggregate function called by clientside function +ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 +and an assign function glmSLMADS.assign For more detailed information +see help for ds.glmSLMA. + +## Author + +Paul Burton for DataSHIELD Development Team (14/7/20) diff --git a/docs/reference/glmSummaryDS.ag.html b/docs/reference/glmSummaryDS.ag.html index b8b68d6d..6e5017b0 100644 --- a/docs/reference/glmSummaryDS.ag.html +++ b/docs/reference/glmSummaryDS.ag.html @@ -1,58 +1,53 @@ -summarize a glm object on the serverside — glmSummaryDS.ag • dsBasesummarize a glm object on the serverside — glmSummaryDS.ag • dsBase - - -
    -
    -
    -
    -

    summarize a glm object on the serverside

    - +
    +
    +
    +
    + +

    summarize a glm object on the serverside

    + +
    glmSummaryDS.ag.Rd
    -
    +

    returns the non-disclosive elements to the clientside of a glm object and the corresponding object holding the output of summary(glm object) on the serverside.

    -
    +
    +

    Usage

    glmSummaryDS.ag(x.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    x.transmit
    @@ -61,14 +56,14 @@

    Arguments

    specified by x.name argument in ds.glmSummary

    -
    -

    Value

    +
    +

    Value

    returns to the clientside all of the non-disclosive elements (and only the non-disclosive elements) of a specified serverside glm and its corresponding summary_glm object.

    -
    -

    Details

    +
    +

    Details

    Serverside aggregate function called by ds.glmSummary. ds.glmSummary first calls glmSummaryDS.ag to create a glm_summary object on the serverside based on applying native R's summary.glm() to a @@ -77,28 +72,24 @@

    Details

    elements (and only the non-disclosive elements) of the serverside glm and its corresponding summary_glm object.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (20/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmSummaryDS.ag.md b/docs/reference/glmSummaryDS.ag.md new file mode 100644 index 00000000..e0ababae --- /dev/null +++ b/docs/reference/glmSummaryDS.ag.md @@ -0,0 +1,39 @@ +# summarize a glm object on the serverside + +returns the non-disclosive elements to the clientside of a glm object +and the corresponding object holding the output of summary(glm object) +on the serverside. + +## Usage + +``` r +glmSummaryDS.ag(x.transmit) +``` + +## Arguments + +- x.transmit: + + a character string specifying the name of the glm object on the + serverside that is to be summarised. This is specified by x.name + argument in ds.glmSummary + +## Value + +returns to the clientside all of the non-disclosive elements (and only +the non-disclosive elements) of a specified serverside glm and its +corresponding summary_glm object. + +## Details + +Serverside aggregate function called by ds.glmSummary. ds.glmSummary +first calls glmSummaryDS.ag to create a glm_summary object on the +serverside based on applying native R's summary.glm() to a serverside +glm object previously created by ds.glmSLMA. Then it calls +glmSummaryDS.ag to return to the clientside all of the non-disclosive +elements (and only the non-disclosive elements) of the serverside glm +and its corresponding summary_glm object. + +## Author + +Paul Burton for DataSHIELD Development Team (20/7/20) diff --git a/docs/reference/glmSummaryDS.as.html b/docs/reference/glmSummaryDS.as.html index a133e4f2..13639671 100644 --- a/docs/reference/glmSummaryDS.as.html +++ b/docs/reference/glmSummaryDS.as.html @@ -1,60 +1,56 @@ -summarize a glm object on the serverside — glmSummaryDS.as • dsBasesummarize a glm object on the serverside — glmSummaryDS.as • dsBase - - -
    -
    -
    -
    -

    summarize a glm object on the serverside

    - +
    +
    +
    +
    + +

    summarize a glm object on the serverside

    + +
    glmSummaryDS.as.Rd
    -
    +

    summarize a glm object on the serverside to create a summary_glm object. Also identify and return components of both the glm object and the summary_glm object that can safely be sent to the clientside without a risk of disclosure

    -
    +
    +

    Usage

    glmSummaryDS.as(x.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    x.transmit
    @@ -63,41 +59,37 @@

    Arguments

    specified by x.name argument in ds.glmSummary

    -
    -

    Value

    +
    +

    Value

    writes object to serverside which is precisely equivalent to summary(glm object) in native R

    -
    -

    Details

    +
    +

    Details

    Serverside assign function called by ds.glmSummary summarises a glm object that has already been created on the serverside by fitting ds.glmSLMA and writes the summary_glm object to the serverside. For further details see help for ds.glmSLMA and help in native R for glm() and summary.glm

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team (20/7/20)

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmSummaryDS.as.md b/docs/reference/glmSummaryDS.as.md new file mode 100644 index 00000000..6d9ffde5 --- /dev/null +++ b/docs/reference/glmSummaryDS.as.md @@ -0,0 +1,37 @@ +# summarize a glm object on the serverside + +summarize a glm object on the serverside to create a summary_glm object. +Also identify and return components of both the glm object and the +summary_glm object that can safely be sent to the clientside without a +risk of disclosure + +## Usage + +``` r +glmSummaryDS.as(x.transmit) +``` + +## Arguments + +- x.transmit: + + a character string specifying the name of the glm object on the + serverside that is to be summarised. This is specified by x.name + argument in ds.glmSummary + +## Value + +writes object to serverside which is precisely equivalent to summary(glm +object) in native R + +## Details + +Serverside assign function called by ds.glmSummary summarises a glm +object that has already been created on the serverside by fitting +ds.glmSLMA and writes the summary_glm object to the serverside. For +further details see help for ds.glmSLMA and help in native R for glm() +and summary.glm + +## Author + +Paul Burton for DataSHIELD Development Team (20/7/20) diff --git a/docs/reference/glmerSLMADS.assign.html b/docs/reference/glmerSLMADS.assign.html index 932f8c63..53486c5a 100644 --- a/docs/reference/glmerSLMADS.assign.html +++ b/docs/reference/glmerSLMADS.assign.html @@ -1,51 +1,45 @@ -Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign • dsBase - - -
    -
    -
    -
    -

    Fitting generalized linear mixed effect models - serverside function

    + - + + + +
    +
    +
    +
    + +

    Fitting generalized linear mixed effect models - serverside function

    + +
    glmerSLMADS.assign.Rd
    -
    +

    glmerSLMADS.assign is the same as glmerSLMADS2 which fits a generalized linear mixed effects model (glme) per study and saves the outcomes in each study

    -
    +
    +

    Usage

    glmerSLMADS.assign(
   formula,
   offset,
@@ -61,8 +55,8 @@ 
    Fitting generalized linear mixed effect models - serverside function
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -118,41 +112,37 @@

    Arguments

    function ds.glmerSLMA

    -
    -

    Value

    +
    +

    Value

    writes glmerMod object summarising the fitted model to the serverside. For more detailed information see help for ds.glmerSLMA.

    -
    -

    Details

    +
    +

    Details

    glmerSLMADS.assign is a serverside function called by ds.glmerSLMA on the clientside. The analytic work engine is the glmer function in R which sits in the lme4 package. glmerSLMADS.assign fits a generalized linear mixed effects model (glme) - e.g. a logistic or Poisson regression model including both fixed and random effects - on data from each single data source and saves the regression outcomes on the serverside.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmerSLMADS.assign.md b/docs/reference/glmerSLMADS.assign.md new file mode 100644 index 00000000..57029ccc --- /dev/null +++ b/docs/reference/glmerSLMADS.assign.md @@ -0,0 +1,95 @@ +# Fitting generalized linear mixed effect models - serverside function + +glmerSLMADS.assign is the same as glmerSLMADS2 which fits a generalized +linear mixed effects model (glme) per study and saves the outcomes in +each study + +## Usage + +``` r +glmerSLMADS.assign( + formula, + offset, + weights, + dataName, + family, + control_type = NULL, + control_value.transmit = NULL, + nAGQ = 1L, + verbose = 0, + theta = NULL, + fixef = NULL +) +``` + +## Arguments + +- formula: + + see help for ds.glmerSLMA + +- offset: + + see help for ds.glmerSLMA + +- weights: + + see help for ds.glmerSLMA + +- dataName: + + see help for ds.glmerSLMA + +- family: + + see help for ds.glmerSLMA + +- control_type: + + see help for ds.glmerSLMA + +- control_value.transmit: + + see help for argument \ for function ds.glmerSLMA + +- nAGQ: + + integer scalar, defaulting to 1L. IN PRACTICE, IT MAY BE NECESSARY TO + SET nAGQ TO 0L when the model appears to converge perfectly well (e.g. + verbose=2 demonstrates good initial convergence of both the + log-likelihood and regression coefficients) but formal convergence + does not get declared - so no output is produced - despite running the + model for many iterations. The nAGQ argument is set by the nAGQ + argument for ds.glmerSLMA and further details can be found in + help(ds.glmerSLMA) and in the native R help for glmer() + +- verbose: + + see help for ds.glmerSLMA + +- theta: + + see help for argument \ for function ds.glmerSLMA + +- fixef: + + see help for argument \ for function ds.glmerSLMA + +## Value + +writes glmerMod object summarising the fitted model to the serverside. +For more detailed information see help for ds.glmerSLMA. + +## Details + +glmerSLMADS.assign is a serverside function called by ds.glmerSLMA on +the clientside. The analytic work engine is the glmer function in R +which sits in the lme4 package. glmerSLMADS.assign fits a generalized +linear mixed effects model (glme) - e.g. a logistic or Poisson +regression model including both fixed and random effects - on data from +each single data source and saves the regression outcomes on the +serverside. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/glmerSLMADS2.html b/docs/reference/glmerSLMADS2.html index a7672b28..afe402cf 100644 --- a/docs/reference/glmerSLMADS2.html +++ b/docs/reference/glmerSLMADS2.html @@ -1,53 +1,48 @@ -Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2 • dsBaseFitting generalized linear mixed effect models - serverside function — glmerSLMADS2 • dsBase - - -
    -
    -
    -
    -

    Fitting generalized linear mixed effect models - serverside function

    - +
    +
    +
    +
    + +

    Fitting generalized linear mixed effect models - serverside function

    + +
    glmerSLMADS2.Rd
    -
    +

    glmerSLMADS2 fits a generalized linear mixed effects model (glme) - e.g. a logistic or Poisson regression model including both fixed and random effects - on data from one or multiple sources with pooling via SLMA (study level meta-analysis)

    -
    +
    +

    Usage

    glmerSLMADS2(
   formula,
   offset,
@@ -63,8 +58,8 @@ 
    Fitting generalized linear mixed effect models - serverside function
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -120,12 +115,12 @@

    Arguments

    function ds.glmerSLMA

    -
    -

    Value

    +
    +

    Value

    all key model components see help for ds.glmerSLMA

    -
    -

    Details

    +
    +

    Details

    glmerSLMADS2 is a serverside function called by ds.glmerSLMA on the clientside. The analytic work engine is the glmer function in R which sits in the lme4 package. ds.glmerSLMA fits a generalized linear mixed effects model (glme) - e.g. a logistic or @@ -139,28 +134,24 @@

    Details

    any approach to meta-analysis they choose. Additional information about fitting glmes using the glmer engine can be obtained using R help for glmer and the lme4 package

    -
    -

    Author

    +
    +

    Author

    Tom Bishop, with some additions by Paul Burton

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/glmerSLMADS2.md b/docs/reference/glmerSLMADS2.md new file mode 100644 index 00000000..f7bf47b2 --- /dev/null +++ b/docs/reference/glmerSLMADS2.md @@ -0,0 +1,103 @@ +# Fitting generalized linear mixed effect models - serverside function + +glmerSLMADS2 fits a generalized linear mixed effects model (glme) - e.g. +a logistic or Poisson regression model including both fixed and random +effects - on data from one or multiple sources with pooling via SLMA +(study level meta-analysis) + +## Usage + +``` r +glmerSLMADS2( + formula, + offset, + weights, + dataName, + family, + control_type = NULL, + control_value.transmit = NULL, + nAGQ = 1L, + verbose = 0, + theta = NULL, + fixef = NULL +) +``` + +## Arguments + +- formula: + + see help for ds.glmerSLMA + +- offset: + + see help for ds.glmerSLMA + +- weights: + + see help for ds.glmerSLMA + +- dataName: + + see help for ds.glmerSLMA + +- family: + + see help for ds.glmerSLMA + +- control_type: + + see help for ds.glmerSLMA + +- control_value.transmit: + + see help for argument \ for function ds.glmerSLMA + +- nAGQ: + + integer scalar, defaulting to 1L. IN PRACTICE, IT MAY BE NECESSARY TO + SET nAGQ TO 0L when the model appears to converge perfectly well (e.g. + verbose=2 demonstrates good initial convergence of both the + log-likelihood and regression coefficients) but formal convergence + does not get declared - so no output is produced - despite running the + model for many iterations. The nAGQ argument is set by the nAGQ + argument for ds.glmerSLMA and further details can be found in + help(ds.glmerSLMA) and in the native R help for glmer() + +- verbose: + + see help for ds.glmerSLMA + +- theta: + + see help for argument \ for function ds.glmerSLMA + +- fixef: + + see help for argument \ for function ds.glmerSLMA + +## Value + +all key model components see help for ds.glmerSLMA + +## Details + +glmerSLMADS2 is a serverside function called by ds.glmerSLMA on the +clientside. The analytic work engine is the glmer function in R which +sits in the lme4 package. ds.glmerSLMA fits a generalized linear mixed +effects model (glme) - e.g. a logistic or Poisson regression model +including both fixed and random effects - on data from a single or +multiple sources. When there are multiple data sources, the glme is +fitted to convergence in each data source independently and the +estimates and standard errors returned to the client thereby enabling +cross-study pooling using study level meta-analysis (SLMA). By default +the SLMA is undertaken using the metafor package, but as the SLMA occurs +on the clientside which, as far as the user is concerned is just a +standard R environment, the user can choose to use any approach to +meta-analysis they choose. Additional information about fitting glmes +using the glmer engine can be obtained using R help for glmer and the +lme4 package + +## Author + +Tom Bishop, with some additions by Paul Burton diff --git a/docs/reference/heatmapPlotDS.html b/docs/reference/heatmapPlotDS.html index 459a5a98..6a5f6f19 100644 --- a/docs/reference/heatmapPlotDS.html +++ b/docs/reference/heatmapPlotDS.html @@ -1,54 +1,47 @@ -Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS • dsBase - - -
    -
    -
    -
    -

    Calculates the coordinates of the centroid of each n nearest neighbours

    + - + + + +
    +
    +
    +
    + +

    Calculates the coordinates of the centroid of each n nearest neighbours

    + +
    heatmapPlotDS.Rd
    -
    +

    This function calculates the coordinates of the centroids for each n nearest neighbours.

    -
    +
    +

    Usage

    heatmapPlotDS(x, y, k, noise, method.indicator)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -74,13 +67,13 @@

    Arguments

    'deterministic' method is used. If the value is set to 2 the 'probabilistic' method is used.

    -
    -

    Value

    +
    +

    Value

    a list with the x and y coordinates of the centroids if the deterministic method is used or the x and y coordinated of the noisy data if the probabilistic method is used.

    -
    -

    Details

    +
    +

    Details

    The function finds the n-1 nearest neighbours of each data point in a 2-dimensional space. The nearest neighbours are the data points with the minimum Euclidean distances from the point of interest. Each point of interest and its n-1 nearest neighbours are then used for the calculation @@ -90,28 +83,24 @@

    Details

    neighbours. The coordinates of the centroids return to the client side function and can be used for the plot of non-disclosive graphs (e.g. scatter plots, heatmap plots, contour plots, etc).

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/heatmapPlotDS.md b/docs/reference/heatmapPlotDS.md new file mode 100644 index 00000000..d69acd0d --- /dev/null +++ b/docs/reference/heatmapPlotDS.md @@ -0,0 +1,63 @@ +# Calculates the coordinates of the centroid of each n nearest neighbours + +This function calculates the coordinates of the centroids for each n +nearest neighbours. + +## Usage + +``` r +heatmapPlotDS(x, y, k, noise, method.indicator) +``` + +## Arguments + +- x: + + the name of a numeric vector, the x-variable. + +- y: + + the name of a numeric vector, the y-variable. + +- k: + + the number of the nearest neighbours for which their centroid is + calculated if the `method.indicator` is equal to 1 (i.e. deterministic + method). + +- noise: + + the percentage of the initial variance that is used as the variance of + the embedded noise if the `method.indicator` is equal to 2 (i.e. + probabilistic method). + +- method.indicator: + + a number equal to either 1 or 2. If the value is equal to 1 then the + 'deterministic' method is used. If the value is set to 2 the + 'probabilistic' method is used. + +## Value + +a list with the x and y coordinates of the centroids if the +deterministic method is used or the x and y coordinated of the noisy +data if the probabilistic method is used. + +## Details + +The function finds the n-1 nearest neighbours of each data point in a +2-dimensional space. The nearest neighbours are the data points with the +minimum Euclidean distances from the point of interest. Each point of +interest and its n-1 nearest neighbours are then used for the +calculation of the coordinates of the centroid of those n points. +Centroid here is referred to the centre of mass, i.e. the x-coordinate +of the centroid is the average value of the x-coordinates of the n +nearest neighbours and the y-coordinate of the centroid is the average +of the y-coordinates of the n nearest neighbours. The coordinates of the +centroids return to the client side function and can be used for the +plot of non-disclosive graphs (e.g. scatter plots, heatmap plots, +contour plots, etc). + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/hetcorDS.html b/docs/reference/hetcorDS.html index ac02df16..a97a9ff1 100644 --- a/docs/reference/hetcorDS.html +++ b/docs/reference/hetcorDS.html @@ -1,54 +1,47 @@ -Heterogeneous Correlation Matrix — hetcorDS • dsBase - - -
    -
    -
    -
    -

    Heterogeneous Correlation Matrix

    + - + + + +
    +
    +
    +
    + +

    Heterogeneous Correlation Matrix

    + +
    hetcorDS.Rd
    -
    +

    This function is based on the hetcor function from the R package polycor.

    -
    +
    +

    Usage

    hetcorDS(data, ML, std.err, bins, pd, use)
    -
    -

    Arguments

    +
    +

    Arguments

    data
    @@ -82,8 +75,8 @@

    Arguments

    compute each correlation using all observations with valid data for that pair of variables.

    -
    -

    Value

    +
    +

    Value

    Returns an object of class "hetcor" with the following components: the correlation matrix; the type of each correlation: "Pearson", "Polychoric", or "Polyserial"; the standard errors of the correlations, if requested; the number (or numbers) of observations on which the correlations are @@ -91,34 +84,30 @@

    Value

    any missing data were handled: "complete.obs" or "pairwise.complete.obs"; TRUE for ML estimates, FALSE for two-step estimates.

    -
    -

    Details

    +
    +

    Details

    Computes a heterogeneous correlation matrix, consisting of Pearson product-moment correlations between numeric variables, polyserial correlations between numeric and ordinal variables, and polychoric correlations between ordinal variables.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/hetcorDS.md b/docs/reference/hetcorDS.md new file mode 100644 index 00000000..72e70f1d --- /dev/null +++ b/docs/reference/hetcorDS.md @@ -0,0 +1,68 @@ +# Heterogeneous Correlation Matrix + +This function is based on the hetcor function from the R package +`polycor`. + +## Usage + +``` r +hetcorDS(data, ML, std.err, bins, pd, use) +``` + +## Arguments + +- data: + + the name of a data frame consisting of factors, ordered factors, + logical variables, character variables, and/or numeric variables, or + the first of several variables. + +- ML: + + if TRUE, compute maximum-likelihood estimates; if FALSE (default), + compute quick two-step estimates. + +- std.err: + + if TRUE (default), compute standard errors. + +- bins: + + number of bins to use for continuous variables in testing bivariate + normality; the default is 4. + +- pd: + + if TRUE (default) and if the correlation matrix is not + positive-definite, an attempt will be made to adjust it to a + positive-definite matrix, using the nearPD function in the Matrix + package. Note that default arguments to nearPD are used (except + corr=TRUE); for more control call nearPD directly. + +- use: + + if "complete.obs", remove observations with any missing data; if + "pairwise.complete.obs", compute each correlation using all + observations with valid data for that pair of variables. + +## Value + +Returns an object of class "hetcor" with the following components: the +correlation matrix; the type of each correlation: "Pearson", +"Polychoric", or "Polyserial"; the standard errors of the correlations, +if requested; the number (or numbers) of observations on which the +correlations are based; p-values for tests of bivariate normality for +each pair of variables; the method by which any missing data were +handled: "complete.obs" or "pairwise.complete.obs"; TRUE for ML +estimates, FALSE for two-step estimates. + +## Details + +Computes a heterogeneous correlation matrix, consisting of Pearson +product-moment correlations between numeric variables, polyserial +correlations between numeric and ordinal variables, and polychoric +correlations between ordinal variables. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/histogramDS1.html b/docs/reference/histogramDS1.html index dfae6675..dabcc695 100644 --- a/docs/reference/histogramDS1.html +++ b/docs/reference/histogramDS1.html @@ -1,51 +1,49 @@ -returns the minimum and the maximum of the input numeric vector — histogramDS1 • dsBasereturns the minimum and the maximum of the input numeric vector — histogramDS1 • dsBase - - -
    -
    -
    -
    -

    returns the minimum and the maximum of the input numeric vector

    + - + + + +
    +
    +
    +
    + +

    returns the minimum and the maximum of the input numeric vector

    + +
    histogramDS1.Rd
    -
    +

    this function returns the minimum and maximum of the input numeric vector which depends on the argument method.indicator. If the method.indicator is set to 1 (i.e. the 'smallCellsRule' is used) the computed minimum and maximum values are multiplied by a very small @@ -55,12 +53,13 @@

    returns the minimum and the maximum of the input numeric vector

    minimum and maximum values of the generated 'noisy' vector.

    -
    +
    +

    Usage

    histogramDS1(xvect, method.indicator, k, noise)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -84,32 +83,28 @@

    Arguments

    noise if the method.indicator is equal to 3 (i.e. probabilistic method).

    -
    -

    Value

    +
    +

    Value

    a numeric vector which contains the minimum and the maximum values of the vector

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/histogramDS1.md b/docs/reference/histogramDS1.md new file mode 100644 index 00000000..fbed8cfe --- /dev/null +++ b/docs/reference/histogramDS1.md @@ -0,0 +1,53 @@ +# returns the minimum and the maximum of the input numeric vector + +this function returns the minimum and maximum of the input numeric +vector which depends on the argument `method.indicator`. If the +method.indicator is set to 1 (i.e. the 'smallCellsRule' is used) the +computed minimum and maximum values are multiplied by a very small +random number. If the method.indicator is set to 2 (i.e. the +'deterministic' method is used) the function returns the minimum and +maximum values of the vector with the scaled centroids. If the +method.indicator is set to 3 (i.e. the 'probabilistic' method is used) +the function returns the minimum and maximum values of the generated +'noisy' vector. + +## Usage + +``` r +histogramDS1(xvect, method.indicator, k, noise) +``` + +## Arguments + +- xvect: + + the numeric vector for which the histogram is desired. + +- method.indicator: + + a number equal to either 1, 2 or 3 indicating the method of disclosure + control that is used for the generation of the histogram. If the value + is equal to 1 then the 'smallCellsRule' is used. If the value is equal + to 2 then the 'deterministic' method is used. If the value is set to 3 + then the 'probabilistic' method is used. + +- k: + + the number of the nearest neighbours for which their centroid is + calculated if the `method.indicator` is equal to 2 (i.e. deterministic + method). + +- noise: + + the percentage of the initial variance that is used as the variance of + the embedded noise if the `method.indicator` is equal to 3 (i.e. + probabilistic method). + +## Value + +a numeric vector which contains the minimum and the maximum values of +the vector + +## Author + +Amadou Gaye, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/histogramDS2.html b/docs/reference/histogramDS2.html index e897cb2a..d37a9d6f 100644 --- a/docs/reference/histogramDS2.html +++ b/docs/reference/histogramDS2.html @@ -1,49 +1,45 @@ -Computes a histogram of the input variable without plotting. — histogramDS2 • dsBaseComputes a histogram of the input variable without plotting. — histogramDS2 • dsBase - - -
    -
    -
    -
    -

    Computes a histogram of the input variable without plotting.

    + - + +
    +
    +
    +
    + +

    Computes a histogram of the input variable without plotting.

    + +
    histogramDS2.Rd
    -
    +

    This function produces the information required to plot a histogram. This is done without allowing for bins (cells) with number of counts less than the pre-specified disclosure control set for the minimum cell @@ -51,12 +47,13 @@

    Computes a histogram of the input variable without plotting.

    and its density are replaced by a 0 value.

    -
    +
    +

    Usage

    histogramDS2(xvect, num.breaks, min, max, method.indicator, k, noise)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -92,36 +89,32 @@

    Arguments

    noise if the method.indicator is equal to 3 (i.e. probabilistic method).

    -
    -

    Value

    +
    +

    Value

    a list with an object of class histogram and the number of invalid cells

    -
    -

    Details

    +
    +

    Details

    Please find more details in the documentation of the clientside ds.histogram function.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/histogramDS2.md b/docs/reference/histogramDS2.md new file mode 100644 index 00000000..817cde21 --- /dev/null +++ b/docs/reference/histogramDS2.md @@ -0,0 +1,65 @@ +# Computes a histogram of the input variable without plotting. + +This function produces the information required to plot a histogram. +This is done without allowing for bins (cells) with number of counts +less than the pre-specified disclosure control set for the minimum cell +size of a table. If a bin has less counts than this threshold then their +counts and its density are replaced by a 0 value. + +## Usage + +``` r +histogramDS2(xvect, num.breaks, min, max, method.indicator, k, noise) +``` + +## Arguments + +- xvect: + + the numeric vector for which the histogram is desired. + +- num.breaks: + + the number of breaks that the range of the variable is divided. + +- min: + + a numeric, the lower limit of the distribution. + +- max: + + a numeric, the upper limit of the distribution. + +- method.indicator: + + a number equal to either 1, 2 or 3 indicating the method of disclosure + control that is used for the generation of the histogram. If the value + is equal to 1 then the 'smallCellsRule' is used. If the value is equal + to 2 then the 'deterministic' method is used. If the value is set to 3 + then the 'probabilistic' method is used. + +- k: + + the number of the nearest neighbours for which their centroid is + calculated if the `method.indicator` is equal to 2 (i.e. deterministic + method). + +- noise: + + the percentage of the initial variance that is used as the variance of + the embedded noise if the `method.indicator` is equal to 3 (i.e. + probabilistic method). + +## Value + +a list with an object of class `histogram` and the number of invalid +cells + +## Details + +Please find more details in the documentation of the clientside +ds.histogram function. + +## Author + +Amadou Gaye, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/igb_standardsDS.html b/docs/reference/igb_standardsDS.html index 357d8b12..2559dd84 100644 --- a/docs/reference/igb_standardsDS.html +++ b/docs/reference/igb_standardsDS.html @@ -1,49 +1,42 @@ -Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS • dsBase - - -
    -
    -
    -
    -

    Converts birth measurements to intergrowth z-scores/centiles

    + - + + + +
    +
    +
    +
    + +

    Converts birth measurements to intergrowth z-scores/centiles

    + +
    igb_standardsDS.Rd
    -
    +

    Converts birth measurements to INTERGROWTH z-scores/centiles (generic)

    -
    +
    +

    Usage

    igb_standardsDS(
   gagebrth = gagebrth,
   z = z,
@@ -55,8 +48,8 @@ 
    Converts birth measurements to intergrowth z-scores/centiles
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    gagebrth
    @@ -92,37 +85,33 @@

    Arguments

    "igb_zscore2value", "igb_value2zscore" (default), "igb_value2centile".

    -
    -

    Value

    +
    +

    Value

    assigns the converted measurement as a new object on the server-side

    -
    -

    Note

    +
    +

    Note

    For gestational ages between 24 and 33 weeks, the INTERGROWTH very early preterm standard is used.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/igb_standardsDS.md b/docs/reference/igb_standardsDS.md new file mode 100644 index 00000000..dc136b35 --- /dev/null +++ b/docs/reference/igb_standardsDS.md @@ -0,0 +1,68 @@ +# Converts birth measurements to intergrowth z-scores/centiles + +Converts birth measurements to INTERGROWTH z-scores/centiles (generic) + +## Usage + +``` r +igb_standardsDS( + gagebrth = gagebrth, + z = z, + p = p, + val = val, + var = var, + sex = sex, + fun = fun +) +``` + +## Arguments + +- gagebrth: + + the name of the "gestational age at birth in days" variable. + +- z: + + z-score(s) to convert (must be between 0 and 1). Default value is 0. + This value is used only if `fun` is set to "igb_zscore2value". + +- p: + + centile(s) to convert (must be between 0 and 100). Default value is + p=50. This value is used only if `fun` is set to "igb_centile2value". + +- val: + + the name of the anthropometric variable to convert. + +- var: + + the name of the measurement to convert ("lencm", "wtkg", "hcircm", + "wlr") + +- sex: + + the name of the sex factor variable. The variable should be coded as + Male/Female. If it is coded differently (e.g. 0/1), then you can use + the ds.recodeValues function to recode the categories to Male/Female + before the use of ds.igb_standards + +- fun: + + the name of the function to be used. This can be one of: + "igb_centile2value", "igb_zscore2value", "igb_value2zscore" (default), + "igb_value2centile". + +## Value + +assigns the converted measurement as a new object on the server-side + +## Note + +For gestational ages between 24 and 33 weeks, the INTERGROWTH very early +preterm standard is used. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/index.html b/docs/reference/index.html index 59255ef6..70e4e58a 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -1,596 +1,1029 @@ -Package index • dsBase - - -
    -
    +
    +
    +
    -
    -
    -
    -

    Reference

    +

    Package index

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -

    All functions

    -

    -
    -

    BooleDS()

    -

    BooleDS

    -

    absDS()

    -

    Computes the absolute values of the input variable

    -

    asCharacterDS()

    -

    Coerces an R object into class character

    -

    asDataMatrixDS()

    -

    asDataMatrixDS a serverside assign function called by ds.asDataMatrix

    -

    asFactorDS1()

    -

    Determines the levels of the input variable in each single study

    -

    asFactorDS2()

    -

    Converts a numeric vector into a factor

    -

    asFactorSimpleDS()

    -

    Converts a numeric vector into a factor

    -

    asIntegerDS()

    -

    Coerces an R object into class integer

    -

    asListDS()

    -

    asListDS a serverside aggregate function called by ds.asList

    -

    asLogicalDS()

    -

    Coerces an R object into class numeric

    -

    asMatrixDS()

    -

    Coerces an R object into a matrix

    -

    asNumericDS()

    -

    Coerces an R object into class numeric

    -

    aucDS()

    -

    aucDS an aggregate function called by ds.auc

    -

    blackBoxDS()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    blackBoxRanksDS()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    boxPlotGGDS()

    -

    Create the identity stats and necessary data to draw a plot on the client

    -

    boxPlotGG_data_TreatmentDS()

    -

    Arrange data frame to pass it to the boxplot function

    -

    boxPlotGG_data_Treatment_numericDS()

    -

    Arrange vector to pass it to the boxplot function

    -

    bp_standardsDS()

    -

    Calculates Blood pressure z-scores

    -

    cDS()

    -

    Concatenates objects into a vector or list

    -

    cbindDS()

    -

    cbindDS called by ds.cbind

    -

    changeRefGroupDS()

    -

    Changes a reference level of a factor

    -

    checkNegValueDS()

    -

    Checks if a numeric variable has negative values

    -

    checkPermissivePrivacyControlLevel()

    -

    checkPermissivePrivacyControlLevel

    -

    classDS()

    -

    Returns the class of an object

    -

    colnamesDS()

    -

    Returns the column names of a data frame or matrix

    -

    completeCasesDS()

    -

    completeCasesDS: an assign function called by ds.completeCases

    -

    corDS()

    -

    Computes the sum of each variable and the sum of products for each pair of variables

    -

    corTestDS()

    -

    Tests for correlation between paired samples

    -

    covDS()

    -

    Computes the sum of each variable and the sum of products for each pair of variables

    -

    dataFrameDS()

    -

    dataFrameDS called by ds.dataFrame

    -

    dataFrameFillDS()

    -

    dataFrameFillDS

    -

    dataFrameSortDS()

    -

    Sorting and reordering data frames, vectors or matrices

    -

    dataFrameSubsetDS1()

    -

    dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset

    -

    dataFrameSubsetDS2()

    -

    dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset

    -

    densityGridDS()

    -

    Generates a density grid with or without a priori defined limits

    -

    dimDS()

    -

    Returns the dimension of a data frame or matrix

    -

    dmtC2SDS()

    -

    Copy a clientside data.frame, matrix or tibble (DMT) to the serverside.

    -

    elsplineDS()

    -

    Basis for a piecewise linear spline with meaningful coefficients

    -

    extractQuantilesDS1()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    -

    extractQuantilesDS2()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies

    -

    gamlssDS()

    -

    gamlssDS an aggregate function called by ds.gamlss

    -

    getWGSRDS()

    -

    Computes the WHO Growth Reference z-scores of anthropometric data

    -

    glmDS1()

    -

    glmDS1 called by ds.glm

    -

    glmDS2()

    -

    glmDS2 called by ds.glm

    -

    glmPredictDS.ag()

    -

    predict regression responses from a glm object

    -

    glmPredictDS.as()

    -

    predict regression responses from a glm object

    -

    glmSLMADS.assign()

    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    -

    glmSLMADS1()

    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    -

    glmSLMADS2()

    -

    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)

    -

    glmSummaryDS.ag()

    -

    summarize a glm object on the serverside

    -

    glmSummaryDS.as()

    -

    summarize a glm object on the serverside

    -

    glmerSLMADS.assign()

    -

    Fitting generalized linear mixed effect models - serverside function

    -

    glmerSLMADS2()

    -

    Fitting generalized linear mixed effect models - serverside function

    -

    heatmapPlotDS()

    -

    Calculates the coordinates of the centroid of each n nearest neighbours

    -

    hetcorDS()

    -

    Heterogeneous Correlation Matrix

    -

    histogramDS1()

    -

    returns the minimum and the maximum of the input numeric vector

    -

    histogramDS2()

    -

    Computes a histogram of the input variable without plotting.

    -

    igb_standardsDS()

    -

    Converts birth measurements to intergrowth z-scores/centiles

    -

    isNaDS()

    -

    Checks if a vector is empty

    -

    isValidDS()

    -

    Checks if an input is valid

    -

    kurtosisDS1()

    -

    Calculates the kurtosis of a numeric variable

    -

    kurtosisDS2()

    -

    Calculates the kurtosis of a numeric variable

    -

    lengthDS()

    -

    Returns the length of a vector or list

    -

    levelsDS()

    -

    Returns the levels of a factor vector

    -

    lexisDS1()

    -

    lexisDS1

    -

    lexisDS2()

    -

    lexisDS2

    -

    lexisDS3()

    -

    @title lexisDS3

    -

    listDS()

    -

    Coerce objects into a list

    -

    listDisclosureSettingsDS()

    -

    listDisclosureSettingsDS

    -

    lmerSLMADS.assign()

    -

    Fitting linear mixed effect models - serverside function

    -

    lmerSLMADS2()

    -

    Fitting linear mixed effect models - serverside function

    -

    lsDS()

    -

    lists all objects on a serverside environment

    -

    lsplineDS()

    -

    Basis for a piecewise linear spline with meaningful coefficients

    -

    matrixDS()

    -

    matrixDS assign function called by ds.matrix

    -

    matrixDetDS1()

    -

    matrixDetDS aggregate function called by ds.matrixDet.report

    -

    matrixDetDS2()

    -

    matrixDetDS assign function called by ds.matrixDet

    -

    matrixDiagDS()

    -

    matrixDiagDS assign function called by ds.matrixDiag

    -

    matrixDimnamesDS()

    -

    matrixDimnamesDS assign function called by ds.matrixDimnames

    -

    matrixInvertDS()

    -

    matrixInvertDS serverside assign function called by ds.matrixInvert

    -

    matrixMultDS()

    -

    matrixMultDS serverside assign function called by ds.matrixMult

    -

    matrixTransposeDS()

    -

    matrixTransposeDS serverside assign function called by ds.matrixTranspose

    -

    meanDS()

    -

    Computes statistical mean of a vector

    -

    meanSdGpDS()

    -

    MeanSdGpDS

    -

    mergeDS()

    -

    mergeDS (assign function) called by ds.merge

    -

    messageDS()

    -

    messageDS

    -

    metadataDS()

    -

    Returns the metadata, if any, about the specified variable

    -

    miceDS()

    -

    Aggregate function called by ds.mice

    -

    minMaxRandDS()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    namesDS()

    -

    Return the names of a list object

    -

    nsDS()

    -

    Generate a Basis Matrix for Natural Cubic Splines

    -

    numNaDS()

    -

    Counts the number of missing values

    -

    qlsplineDS()

    -

    Basis for a piecewise linear spline with meaningful coefficients

    -

    quantileMeanDS()

    -

    Generates quantiles and mean information without maximum and minimum

    -

    rBinomDS()

    -

    rBinomDS serverside assign function

    -

    rNormDS()

    -

    rNormDS serverside assign function

    -

    rPoisDS()

    -

    rPoisDS serverside assign function

    -

    rUnifDS()

    -

    rUnifDS serverside assign function

    -

    rangeDS()

    -

    returns the minimum and maximum of a numeric vector

    -

    ranksSecureDS1()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    ranksSecureDS2()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    ranksSecureDS3()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    ranksSecureDS4()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    ranksSecureDS5()

    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    -

    rbindDS()

    -

    rbindDS called by ds.rbind

    -

    reShapeDS()

    -

    reShapeDS (assign function) called by ds.reShape

    -

    recodeLevelsDS()

    -

    Recodes the levels of a categorical variables

    -

    recodeValuesDS()

    -

    recodeValuesDS an assign function called by ds.recodeValues

    -

    repDS()

    -

    repDS called by ds.rep

    -

    replaceNaDS()

    -

    Replaces the missing values in a vector

    -

    rmDS()

    -

    rmDS an aggregate function called by ds.rm

    -

    rowColCalcDS()

    -

    Computes sums and means of rows or columns of numeric arrays

    -

    sampleDS()

    -

    random sampling and permuting of vectors, dataframes and matrices

    -

    scatterPlotDS()

    -

    Calculates the coordinates of the data to be plot

    -

    seqDS()

    -

    seqDS a serverside assign function called by ds.seq

    -

    setSeedDS()

    -

    setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom

    -

    skewnessDS1()

    -

    Calculates the skewness of a numeric variable

    -

    skewnessDS2()

    -

    Calculates the skewness of a numeric variable

    -

    sqrtDS()

    -

    Computes the square root values of the input variable

    -

    subsetByClassDS()

    -

    Breaks down a dataframe or a factor into its sub-classes

    -

    subsetDS()

    -

    Generates a valid subset of a table or a vector

    -

    table1DDS()

    -

    Creates 1-dimensional contingency tables

    -

    table2DDS()

    -

    table2DDS (aggregate function) called by ds.table2D

    -

    tableDS()

    -

    tableDS is the first of two serverside aggregate functions called by ds.table

    -

    tableDS.assign()

    -

    tableDS.assign is the serverside assign function called by ds.table

    -

    tableDS2()

    -

    tableDS is the second of two serverside aggregate functions called by ds.table

    -

    tapplyDS()

    -

    tapplyDS called by ds.tapply

    -

    tapplyDS.assign()

    -

    tapplyDS.assign called by ds.tapply.assign

    -

    testObjExistsDS()

    -

    testObjExistsDS

    -

    unListDS()

    -

    unListDS a serverside assign function called by ds.unList

    -

    uniqueDS()

    -

    Applies the unique method to a server-side variable.

    -

    varDS()

    -

    Computes the variance of vector

    -

    vectorDS()

    -

    Creates a vector on the server-side.

    - - -
    +
    +

    All functions

    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -
    -

    Site built with pkgdown 2.1.3.

    +
    + + + + +
    + + BooleDS() + +
    +
    BooleDS
    + +
    + + absDS() + +
    +
    Computes the absolute values of the input variable
    + +
    + + asCharacterDS() + +
    +
    Coerces an R object into class character
    + +
    + + asDataMatrixDS() + +
    +
    asDataMatrixDS a serverside assign function called by ds.asDataMatrix
    + +
    + + asFactorDS1() + +
    +
    Determines the levels of the input variable in each single study
    + +
    + + asFactorDS2() + +
    +
    Converts a numeric vector into a factor
    + +
    + + asFactorSimpleDS() + +
    +
    Converts a numeric vector into a factor
    + +
    + + asIntegerDS() + +
    +
    Coerces an R object into class integer
    + +
    + + asListDS() + +
    +
    asListDS a serverside aggregate function called by ds.asList
    + +
    + + asLogicalDS() + +
    +
    Coerces an R object into class numeric
    + +
    + + asMatrixDS() + +
    +
    Coerces an R object into a matrix
    + +
    + + asNumericDS() + +
    +
    Coerces an R object into class numeric
    + +
    + + aucDS() + +
    +
    aucDS an aggregate function called by ds.auc
    + +
    + + blackBoxDS() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + blackBoxRanksDS() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + boxPlotGGDS() + +
    +
    Create the identity stats and necessary data to draw a plot on the client
    + +
    + + boxPlotGG_data_TreatmentDS() + +
    +
    Arrange data frame to pass it to the boxplot function
    + +
    + + boxPlotGG_data_Treatment_numericDS() + +
    +
    Arrange vector to pass it to the boxplot function
    + +
    + + bp_standardsDS() + +
    +
    Calculates Blood pressure z-scores
    + +
    + + cDS() + +
    +
    Concatenates objects into a vector or list
    + +
    + + cbindDS() + +
    +
    cbindDS called by ds.cbind
    + +
    + + changeRefGroupDS() + +
    +
    Changes a reference level of a factor
    + +
    + + checkNegValueDS() + +
    +
    Checks if a numeric variable has negative values
    + +
    + + checkPermissivePrivacyControlLevel() + +
    +
    checkPermissivePrivacyControlLevel
    + +
    + + classDS() + +
    +
    Returns the class of an object
    + +
    + + colnamesDS() + +
    +
    Returns the column names of a data frame or matrix
    + +
    + + completeCasesDS() + +
    +
    completeCasesDS: an assign function called by ds.completeCases
    + +
    + + corDS() + +
    +
    Computes the sum of each variable and the sum of products for each pair of variables
    + +
    + + corTestDS() + +
    +
    Tests for correlation between paired samples
    + +
    + + covDS() + +
    +
    Computes the sum of each variable and the sum of products for each pair of variables
    + +
    + + dataFrameDS() + +
    +
    dataFrameDS called by ds.dataFrame
    + +
    + + dataFrameFillDS() + +
    +
    dataFrameFillDS
    + +
    + + dataFrameSortDS() + +
    +
    Sorting and reordering data frames, vectors or matrices
    + +
    + + dataFrameSubsetDS1() + +
    +
    dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset
    + +
    + + dataFrameSubsetDS2() + +
    +
    dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset
    + +
    + + densityGridDS() + +
    +
    Generates a density grid with or without a priori defined limits
    + +
    + + dimDS() + +
    +
    Returns the dimension of a data frame or matrix
    + +
    + + dmtC2SDS() + +
    +
    Copy a clientside data.frame, matrix or tibble (DMT) to the serverside.
    + +
    + + elsplineDS() + +
    +
    Basis for a piecewise linear spline with meaningful coefficients
    + +
    + + extractQuantilesDS1() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies
    + +
    + + extractQuantilesDS2() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources and use of these ranks to estimate global quantiles across all studies
    + +
    + + fixClassDS() + +
    +
    Change Class of Target Variables in a Data Frame
    + +
    + + fixColsDS() + +
    +
    Add Missing Columns with NA Values
    + +
    + + fixLevelsDS() + +
    +
    Set Factor Levels for Specific Columns in a Data Frame
    + +
    + + gamlssDS() + +
    +
    gamlssDS an aggregate function called by ds.gamlss
    + +
    + + getAllLevelsDS() + +
    +
    Retrieve Factor Levels for Specific Columns
    + +
    + + getClassAllColsDS() + +
    +
    Get the Class of All Columns in a Data Frame
    + +
    + + getWGSRDS() + +
    +
    Computes the WHO Growth Reference z-scores of anthropometric data
    + +
    + + glmDS1() + +
    +
    glmDS1 called by ds.glm
    + +
    + + glmDS2() + +
    +
    glmDS2 called by ds.glm
    + +
    + + glmPredictDS.ag() + +
    +
    predict regression responses from a glm object
    + +
    + + glmPredictDS.as() + +
    +
    predict regression responses from a glm object
    + +
    + + glmSLMADS.assign() + +
    +
    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)
    + +
    + + glmSLMADS1() + +
    +
    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)
    + +
    + + glmSLMADS2() + +
    +
    Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA)
    + +
    + + glmSummaryDS.ag() + +
    +
    summarize a glm object on the serverside
    + +
    + + glmSummaryDS.as() + +
    +
    summarize a glm object on the serverside
    + +
    + + glmerSLMADS.assign() + +
    +
    Fitting generalized linear mixed effect models - serverside function
    + +
    + + glmerSLMADS2() + +
    +
    Fitting generalized linear mixed effect models - serverside function
    + +
    + + heatmapPlotDS() + +
    +
    Calculates the coordinates of the centroid of each n nearest neighbours
    + +
    + + hetcorDS() + +
    +
    Heterogeneous Correlation Matrix
    + +
    + + histogramDS1() + +
    +
    returns the minimum and the maximum of the input numeric vector
    + +
    + + histogramDS2() + +
    +
    Computes a histogram of the input variable without plotting.
    + +
    + + igb_standardsDS() + +
    +
    Converts birth measurements to intergrowth z-scores/centiles
    + +
    + + isNaDS() + +
    +
    Checks if a vector is empty
    + +
    + + isValidDS() + +
    +
    Checks if an input is valid
    + +
    + + kurtosisDS1() + +
    +
    Calculates the kurtosis of a numeric variable
    + +
    + + kurtosisDS2() + +
    +
    Calculates the kurtosis of a numeric variable
    + +
    + + lengthDS() + +
    +
    Returns the length of a vector or list
    + +
    + + levelsDS() + +
    +
    Returns the levels of a factor vector
    + +
    + + lexisDS1() + +
    +
    lexisDS1
    + +
    + + lexisDS2() + +
    +
    lexisDS2
    + +
    + + lexisDS3() + +
    +
    @title lexisDS3
    + +
    + + listDS() + +
    +
    Coerce objects into a list
    + +
    + + listDisclosureSettingsDS() + +
    +
    listDisclosureSettingsDS
    + +
    + + lmerSLMADS.assign() + +
    +
    Fitting linear mixed effect models - serverside function
    + +
    + + lmerSLMADS2() + +
    +
    Fitting linear mixed effect models - serverside function
    + +
    + + lsDS() + +
    +
    lists all objects on a serverside environment
    + +
    + + lsplineDS() + +
    +
    Basis for a piecewise linear spline with meaningful coefficients
    + +
    + + matrixDS() + +
    +
    matrixDS assign function called by ds.matrix
    + +
    + + matrixDetDS1() + +
    +
    matrixDetDS aggregate function called by ds.matrixDet.report
    + +
    + + matrixDetDS2() + +
    +
    matrixDetDS assign function called by ds.matrixDet
    + +
    + + matrixDiagDS() + +
    +
    matrixDiagDS assign function called by ds.matrixDiag
    + +
    + + matrixDimnamesDS() + +
    +
    matrixDimnamesDS assign function called by ds.matrixDimnames
    + +
    + + matrixInvertDS() + +
    +
    matrixInvertDS serverside assign function called by ds.matrixInvert
    + +
    + + matrixMultDS() + +
    +
    matrixMultDS serverside assign function called by ds.matrixMult
    + +
    + + matrixTransposeDS() + +
    +
    matrixTransposeDS serverside assign function called by ds.matrixTranspose
    + +
    + + mdPatternDS() + +
    +
    Missing data pattern with disclosure control
    + +
    + + meanDS() + +
    +
    Computes statistical mean of a vector
    + +
    + + meanSdGpDS() + +
    +
    MeanSdGpDS
    + +
    + + mergeDS() + +
    +
    mergeDS (assign function) called by ds.merge
    + +
    + + messageDS() + +
    +
    messageDS
    + +
    + + metadataDS() + +
    +
    Returns the metadata, if any, about the specified variable
    + +
    + + miceDS() + +
    +
    Aggregate function called by ds.mice
    + +
    + + minMaxRandDS() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + namesDS() + +
    +
    Return the names of a list object
    + +
    + + nsDS() + +
    +
    Generate a Basis Matrix for Natural Cubic Splines
    + +
    + + numNaDS() + +
    +
    Counts the number of missing values
    + +
    + + qlsplineDS() + +
    +
    Basis for a piecewise linear spline with meaningful coefficients
    + +
    + + quantileMeanDS() + +
    +
    Generates quantiles and mean information without maximum and minimum
    + +
    + + rBinomDS() + +
    +
    rBinomDS serverside assign function
    + +
    + + rNormDS() + +
    +
    rNormDS serverside assign function
    + +
    + + rPoisDS() + +
    +
    rPoisDS serverside assign function
    + +
    + + rUnifDS() + +
    +
    rUnifDS serverside assign function
    + +
    + + rangeDS() + +
    +
    returns the minimum and maximum of a numeric vector
    + +
    + + ranksSecureDS1() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + ranksSecureDS2() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + ranksSecureDS3() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + ranksSecureDS4() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + ranksSecureDS5() + +
    +
    Secure ranking of "V2BR" (vector to be ranked) across all sources
    + +
    + + rbindDS() + +
    +
    rbindDS called by ds.rbind
    + +
    + + reShapeDS() + +
    +
    reShapeDS (assign function) called by ds.reShape
    + +
    + + recodeLevelsDS() + +
    +
    Recodes the levels of a categorical variables
    + +
    + + recodeValuesDS() + +
    +
    recodeValuesDS an assign function called by ds.recodeValues
    + +
    + + repDS() + +
    +
    repDS called by ds.rep
    + +
    + + replaceNaDS() + +
    +
    Replaces the missing values in a vector
    + +
    + + rmDS() + +
    +
    rmDS an aggregate function called by ds.rm
    + +
    + + rowColCalcDS() + +
    +
    Computes sums and means of rows or columns of numeric arrays
    + +
    + + sampleDS() + +
    +
    random sampling and permuting of vectors, dataframes and matrices
    + +
    + + scatterPlotDS() + +
    +
    Calculates the coordinates of the data to be plot
    + +
    + + seqDS() + +
    +
    seqDS a serverside assign function called by ds.seq
    + +
    + + setSeedDS() + +
    +
    setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom
    + +
    + + skewnessDS1() + +
    +
    Calculates the skewness of a numeric variable
    + +
    + + skewnessDS2() + +
    +
    Calculates the skewness of a numeric variable
    + +
    + + sqrtDS() + +
    +
    Computes the square root values of the input variable
    + +
    + + subsetByClassDS() + +
    +
    Breaks down a dataframe or a factor into its sub-classes
    + +
    + + subsetDS() + +
    +
    Generates a valid subset of a table or a vector
    + +
    + + table1DDS() + +
    +
    Creates 1-dimensional contingency tables
    + +
    + + table2DDS() + +
    +
    table2DDS (aggregate function) called by ds.table2D
    + +
    + + tableDS() + +
    +
    tableDS is the first of two serverside aggregate functions called by ds.table
    + +
    + + tableDS.assign() + +
    +
    tableDS.assign is the serverside assign function called by ds.table
    + +
    + + tableDS2() + +
    +
    tableDS is the second of two serverside aggregate functions called by ds.table
    + +
    + + tapplyDS() + +
    +
    tapplyDS called by ds.tapply
    + +
    + + tapplyDS.assign() + +
    +
    tapplyDS.assign called by ds.tapply.assign
    + +
    + + testObjExistsDS() + +
    +
    testObjExistsDS
    + +
    + + unListDS() + +
    +
    unListDS a serverside assign function called by ds.unList
    + +
    + + uniqueDS() + +
    +
    Applies the unique method to a server-side variable.
    + +
    + + varDS() + +
    +
    Computes the variance of vector
    + +
    + + vectorDS() + +
    +
    Creates a vector on the server-side.
    +
    +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    +
    +

    Site built with pkgdown 2.2.0.

    +
    +
    diff --git a/docs/reference/index.md b/docs/reference/index.md new file mode 100644 index 00000000..c755f5fc --- /dev/null +++ b/docs/reference/index.md @@ -0,0 +1,386 @@ +# Package index + +## All functions + +- [`BooleDS()`](BooleDS.md) : BooleDS + +- [`absDS()`](absDS.md) : Computes the absolute values of the input + variable + +- [`asCharacterDS()`](asCharacterDS.md) : Coerces an R object into class + character + +- [`asDataMatrixDS()`](asDataMatrixDS.md) : asDataMatrixDS a serverside + assign function called by ds.asDataMatrix + +- [`asFactorDS1()`](asFactorDS1.md) : Determines the levels of the input + variable in each single study + +- [`asFactorDS2()`](asFactorDS2.md) : Converts a numeric vector into a + factor + +- [`asFactorSimpleDS()`](asFactorSimpleDS.md) : Converts a numeric + vector into a factor + +- [`asIntegerDS()`](asIntegerDS.md) : Coerces an R object into class + integer + +- [`asListDS()`](asListDS.md) : asListDS a serverside aggregate function + called by ds.asList + +- [`asLogicalDS()`](asLogicalDS.md) : Coerces an R object into class + numeric + +- [`asMatrixDS()`](asMatrixDS.md) : Coerces an R object into a matrix + +- [`asNumericDS()`](asNumericDS.md) : Coerces an R object into class + numeric + +- [`aucDS()`](aucDS.md) : aucDS an aggregate function called by ds.auc + +- [`blackBoxDS()`](blackBoxDS.md) : Secure ranking of "V2BR" (vector to + be ranked) across all sources + +- [`blackBoxRanksDS()`](blackBoxRanksDS.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`boxPlotGGDS()`](boxPlotGGDS.md) : Create the identity stats and + necessary data to draw a plot on the client + +- [`boxPlotGG_data_TreatmentDS()`](boxPlotGG_data_TreatmentDS.md) : + Arrange data frame to pass it to the boxplot function + +- [`boxPlotGG_data_Treatment_numericDS()`](boxPlotGG_data_Treatment_numericDS.md) + : Arrange vector to pass it to the boxplot function + +- [`bp_standardsDS()`](bp_standardsDS.md) : Calculates Blood pressure + z-scores + +- [`cDS()`](cDS.md) : Concatenates objects into a vector or list + +- [`cbindDS()`](cbindDS.md) : cbindDS called by ds.cbind + +- [`changeRefGroupDS()`](changeRefGroupDS.md) : Changes a reference + level of a factor + +- [`checkNegValueDS()`](checkNegValueDS.md) : Checks if a numeric + variable has negative values + +- [`checkPermissivePrivacyControlLevel()`](checkPermissivePrivacyControlLevel.md) + : checkPermissivePrivacyControlLevel + +- [`classDS()`](classDS.md) : Returns the class of an object + +- [`colnamesDS()`](colnamesDS.md) : Returns the column names of a data + frame or matrix + +- [`completeCasesDS()`](completeCasesDS.md) : completeCasesDS: an assign + function called by ds.completeCases + +- [`corDS()`](corDS.md) : Computes the sum of each variable and the sum + of products for each pair of variables + +- [`corTestDS()`](corTestDS.md) : Tests for correlation between paired + samples + +- [`covDS()`](covDS.md) : Computes the sum of each variable and the sum + of products for each pair of variables + +- [`dataFrameDS()`](dataFrameDS.md) : dataFrameDS called by ds.dataFrame + +- [`dataFrameFillDS()`](dataFrameFillDS.md) : dataFrameFillDS + +- [`dataFrameSortDS()`](dataFrameSortDS.md) : Sorting and reordering + data frames, vectors or matrices + +- [`dataFrameSubsetDS1()`](dataFrameSubsetDS1.md) : dataFrameSubsetDS1 + an aggregate function called by ds.dataFrameSubset + +- [`dataFrameSubsetDS2()`](dataFrameSubsetDS2.md) : dataFrameSubsetDS2 + an assign function called by ds.dataFrameSubset + +- [`densityGridDS()`](densityGridDS.md) : Generates a density grid with + or without a priori defined limits + +- [`dimDS()`](dimDS.md) : Returns the dimension of a data frame or + matrix + +- [`dmtC2SDS()`](dmtC2SDS.md) : Copy a clientside data.frame, matrix or + tibble (DMT) to the serverside. + +- [`elsplineDS()`](elsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`extractQuantilesDS1()`](extractQuantilesDS1.md) : Secure ranking of + "V2BR" (vector to be ranked) across all sources and use of these ranks + to estimate global quantiles across all studies + +- [`extractQuantilesDS2()`](extractQuantilesDS2.md) : Secure ranking of + "V2BR" (vector to be ranked) across all sources and use of these ranks + to estimate global quantiles across all studies + +- [`fixClassDS()`](fixClassDS.md) : Change Class of Target Variables in + a Data Frame + +- [`fixColsDS()`](fixColsDS.md) : Add Missing Columns with NA Values + +- [`fixLevelsDS()`](fixLevelsDS.md) : Set Factor Levels for Specific + Columns in a Data Frame + +- [`gamlssDS()`](gamlssDS.md) : gamlssDS an aggregate function called by + ds.gamlss + +- [`getAllLevelsDS()`](getAllLevelsDS.md) : Retrieve Factor Levels for + Specific Columns + +- [`getClassAllColsDS()`](getClassAllColsDS.md) : Get the Class of All + Columns in a Data Frame + +- [`getWGSRDS()`](getWGSRDS.md) : Computes the WHO Growth Reference + z-scores of anthropometric data + +- [`glmDS1()`](glmDS1.md) : glmDS1 called by ds.glm + +- [`glmDS2()`](glmDS2.md) : glmDS2 called by ds.glm + +- [`glmPredictDS.ag()`](glmPredictDS.ag.md) : predict regression + responses from a glm object + +- [`glmPredictDS.as()`](glmPredictDS.as.md) : predict regression + responses from a glm object + +- [`glmSLMADS.assign()`](glmSLMADS.assign.md) : Fit a Generalized Linear + Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSLMADS1()`](glmSLMADS1.md) : Fit a Generalized Linear Model (GLM) + with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSLMADS2()`](glmSLMADS2.md) : Fit a Generalized Linear Model (GLM) + with pooling via Study Level Meta-Analysis (SLMA) + +- [`glmSummaryDS.ag()`](glmSummaryDS.ag.md) : summarize a glm object on + the serverside + +- [`glmSummaryDS.as()`](glmSummaryDS.as.md) : summarize a glm object on + the serverside + +- [`glmerSLMADS.assign()`](glmerSLMADS.assign.md) : Fitting generalized + linear mixed effect models - serverside function + +- [`glmerSLMADS2()`](glmerSLMADS2.md) : Fitting generalized linear mixed + effect models - serverside function + +- [`heatmapPlotDS()`](heatmapPlotDS.md) : Calculates the coordinates of + the centroid of each n nearest neighbours + +- [`hetcorDS()`](hetcorDS.md) : Heterogeneous Correlation Matrix + +- [`histogramDS1()`](histogramDS1.md) : returns the minimum and the + maximum of the input numeric vector + +- [`histogramDS2()`](histogramDS2.md) : Computes a histogram of the + input variable without plotting. + +- [`igb_standardsDS()`](igb_standardsDS.md) : Converts birth + measurements to intergrowth z-scores/centiles + +- [`isNaDS()`](isNaDS.md) : Checks if a vector is empty + +- [`isValidDS()`](isValidDS.md) : Checks if an input is valid + +- [`kurtosisDS1()`](kurtosisDS1.md) : Calculates the kurtosis of a + numeric variable + +- [`kurtosisDS2()`](kurtosisDS2.md) : Calculates the kurtosis of a + numeric variable + +- [`lengthDS()`](lengthDS.md) : Returns the length of a vector or list + +- [`levelsDS()`](levelsDS.md) : Returns the levels of a factor vector + +- [`lexisDS1()`](lexisDS1.md) : lexisDS1 + +- [`lexisDS2()`](lexisDS2.md) : lexisDS2 + +- [`lexisDS3()`](lexisDS3.md) : @title lexisDS3 + +- [`listDS()`](listDS.md) : Coerce objects into a list + +- [`listDisclosureSettingsDS()`](listDisclosureSettingsDS.md) : + listDisclosureSettingsDS + +- [`lmerSLMADS.assign()`](lmerSLMADS.assign.md) : Fitting linear mixed + effect models - serverside function + +- [`lmerSLMADS2()`](lmerSLMADS2.md) : Fitting linear mixed effect + models - serverside function + +- [`lsDS()`](lsDS.md) : lists all objects on a serverside environment + +- [`lsplineDS()`](lsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`matrixDS()`](matrixDS.md) : matrixDS assign function called by + ds.matrix + +- [`matrixDetDS1()`](matrixDetDS1.md) : matrixDetDS aggregate function + called by ds.matrixDet.report + +- [`matrixDetDS2()`](matrixDetDS2.md) : matrixDetDS assign function + called by ds.matrixDet + +- [`matrixDiagDS()`](matrixDiagDS.md) : matrixDiagDS assign function + called by ds.matrixDiag + +- [`matrixDimnamesDS()`](matrixDimnamesDS.md) : matrixDimnamesDS assign + function called by ds.matrixDimnames + +- [`matrixInvertDS()`](matrixInvertDS.md) : matrixInvertDS serverside + assign function called by ds.matrixInvert + +- [`matrixMultDS()`](matrixMultDS.md) : matrixMultDS serverside assign + function called by ds.matrixMult + +- [`matrixTransposeDS()`](matrixTransposeDS.md) : matrixTransposeDS + serverside assign function called by ds.matrixTranspose + +- [`mdPatternDS()`](mdPatternDS.md) : Missing data pattern with + disclosure control + +- [`meanDS()`](meanDS.md) : Computes statistical mean of a vector + +- [`meanSdGpDS()`](meanSdGpDS.md) : MeanSdGpDS + +- [`mergeDS()`](mergeDS.md) : mergeDS (assign function) called by + ds.merge + +- [`messageDS()`](messageDS.md) : messageDS + +- [`metadataDS()`](metadataDS.md) : Returns the metadata, if any, about + the specified variable + +- [`miceDS()`](miceDS.md) : Aggregate function called by ds.mice + +- [`minMaxRandDS()`](minMaxRandDS.md) : Secure ranking of "V2BR" (vector + to be ranked) across all sources + +- [`namesDS()`](namesDS.md) : Return the names of a list object + +- [`nsDS()`](nsDS.md) : Generate a Basis Matrix for Natural Cubic + Splines + +- [`numNaDS()`](numNaDS.md) : Counts the number of missing values + +- [`qlsplineDS()`](qlsplineDS.md) : Basis for a piecewise linear spline + with meaningful coefficients + +- [`quantileMeanDS()`](quantileMeanDS.md) : Generates quantiles and mean + information without maximum and minimum + +- [`rBinomDS()`](rBinomDS.md) : rBinomDS serverside assign function + +- [`rNormDS()`](rNormDS.md) : rNormDS serverside assign function + +- [`rPoisDS()`](rPoisDS.md) : rPoisDS serverside assign function + +- [`rUnifDS()`](rUnifDS.md) : rUnifDS serverside assign function + +- [`rangeDS()`](rangeDS.md) : returns the minimum and maximum of a + numeric vector + +- [`ranksSecureDS1()`](ranksSecureDS1.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS2()`](ranksSecureDS2.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS3()`](ranksSecureDS3.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS4()`](ranksSecureDS4.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`ranksSecureDS5()`](ranksSecureDS5.md) : Secure ranking of "V2BR" + (vector to be ranked) across all sources + +- [`rbindDS()`](rbindDS.md) : rbindDS called by ds.rbind + +- [`reShapeDS()`](reShapeDS.md) : reShapeDS (assign function) called by + ds.reShape + +- [`recodeLevelsDS()`](recodeLevelsDS.md) : Recodes the levels of a + categorical variables + +- [`recodeValuesDS()`](recodeValuesDS.md) : recodeValuesDS an assign + function called by ds.recodeValues + +- [`repDS()`](repDS.md) : repDS called by ds.rep + +- [`replaceNaDS()`](replaceNaDS.md) : Replaces the missing values in a + vector + +- [`rmDS()`](rmDS.md) : rmDS an aggregate function called by ds.rm + +- [`rowColCalcDS()`](rowColCalcDS.md) : Computes sums and means of rows + or columns of numeric arrays + +- [`sampleDS()`](sampleDS.md) : random sampling and permuting of + vectors, dataframes and matrices + +- [`scatterPlotDS()`](scatterPlotDS.md) : Calculates the coordinates of + the data to be plot + +- [`seqDS()`](seqDS.md) : seqDS a serverside assign function called by + ds.seq + +- [`setSeedDS()`](setSeedDS.md) : setSeedDs called by ds.setSeed, + ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom + +- [`skewnessDS1()`](skewnessDS1.md) : Calculates the skewness of a + numeric variable + +- [`skewnessDS2()`](skewnessDS2.md) : Calculates the skewness of a + numeric variable + +- [`sqrtDS()`](sqrtDS.md) : Computes the square root values of the input + variable + +- [`subsetByClassDS()`](subsetByClassDS.md) : Breaks down a dataframe or + a factor into its sub-classes + +- [`subsetDS()`](subsetDS.md) : Generates a valid subset of a table or a + vector + +- [`table1DDS()`](table1DDS.md) : Creates 1-dimensional contingency + tables + +- [`table2DDS()`](table2DDS.md) : table2DDS (aggregate function) called + by ds.table2D + +- [`tableDS()`](tableDS.md) : tableDS is the first of two serverside + aggregate functions called by ds.table + +- [`tableDS.assign()`](tableDS.assign.md) : tableDS.assign is the + serverside assign function called by ds.table + +- [`tableDS2()`](tableDS2.md) : tableDS is the second of two serverside + aggregate functions called by ds.table + +- [`tapplyDS()`](tapplyDS.md) : tapplyDS called by ds.tapply + +- [`tapplyDS.assign()`](tapplyDS.assign.md) : tapplyDS.assign called by + ds.tapply.assign + +- [`testObjExistsDS()`](testObjExistsDS.md) : testObjExistsDS + +- [`unListDS()`](unListDS.md) : + + `unListDS` a serverside assign function called by `ds.unList` + +- [`uniqueDS()`](uniqueDS.md) : + + Applies the `unique` method to a server-side variable. + +- [`varDS()`](varDS.md) : Computes the variance of vector + +- [`vectorDS()`](vectorDS.md) : Creates a vector on the server-side. diff --git a/docs/reference/isNaDS.html b/docs/reference/isNaDS.html index 06080e50..c1975a27 100644 --- a/docs/reference/isNaDS.html +++ b/docs/reference/isNaDS.html @@ -1,88 +1,78 @@ -Checks if a vector is empty — isNaDS • dsBase - - -
    -
    -
    -
    -

    Checks if a vector is empty

    + - + + + +
    +
    +
    +
    + +

    Checks if a vector is empty

    + +
    isNaDS.Rd
    -
    +

    this function is similar to R function is.na but instead of a vector of booleans it returns just one boolean to tell if all the element are missing values.

    -
    +
    +

    Usage

    isNaDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a numerical or character vector

    -
    -

    Value

    +
    +

    Value

    the integer '1' if the vector contains on NAs and '0' otherwise

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/isNaDS.md b/docs/reference/isNaDS.md new file mode 100644 index 00000000..8369ccad --- /dev/null +++ b/docs/reference/isNaDS.md @@ -0,0 +1,25 @@ +# Checks if a vector is empty + +this function is similar to R function `is.na` but instead of a vector +of booleans it returns just one boolean to tell if all the element are +missing values. + +## Usage + +``` r +isNaDS(xvect) +``` + +## Arguments + +- xvect: + + a numerical or character vector + +## Value + +the integer '1' if the vector contains on NAs and '0' otherwise + +## Author + +Gaye, A. diff --git a/docs/reference/isValidDS.html b/docs/reference/isValidDS.html index 57359377..41081b41 100644 --- a/docs/reference/isValidDS.html +++ b/docs/reference/isValidDS.html @@ -1,90 +1,79 @@ -Checks if an input is valid — isValidDS • dsBase - - -
    -
    -
    -
    -

    Checks if an input is valid

    + - + + + +
    +
    +
    +
    + +

    Checks if an input is valid

    + +
    isValidDS.Rd
    -
    +

    Tells if an object on the server side is valid.

    -
    +
    +

    Usage

    isValidDS(obj)
    -
    -

    Arguments

    +
    +

    Arguments

    obj,

    a vector (numeric, integer, factor, character), data.frame or matrix

    -
    -

    Value

    +
    +

    Value

    a boolean, TRUE if input is valid or FALSE if not.

    -
    -

    Details

    +
    +

    Details

    This function checks if an object is valid.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/isValidDS.md b/docs/reference/isValidDS.md new file mode 100644 index 00000000..d92cf10c --- /dev/null +++ b/docs/reference/isValidDS.md @@ -0,0 +1,27 @@ +# Checks if an input is valid + +Tells if an object on the server side is valid. + +## Usage + +``` r +isValidDS(obj) +``` + +## Arguments + +- obj, : + + a vector (numeric, integer, factor, character), data.frame or matrix + +## Value + +a boolean, TRUE if input is valid or FALSE if not. + +## Details + +This function checks if an object is valid. + +## Author + +Gaye, A. diff --git a/docs/reference/kurtosisDS1.html b/docs/reference/kurtosisDS1.html index d65a39fb..418efd02 100644 --- a/docs/reference/kurtosisDS1.html +++ b/docs/reference/kurtosisDS1.html @@ -1,54 +1,47 @@ -Calculates the kurtosis of a numeric variable — kurtosisDS1 • dsBase - - -
    -
    -
    -
    -

    Calculates the kurtosis of a numeric variable

    + - + + + +
    +
    +
    +
    + +

    Calculates the kurtosis of a numeric variable

    + +
    kurtosisDS1.Rd
    -
    +

    This function calculates the kurtosis of a numeric variable for each study separately.

    -
    +
    +

    Usage

    kurtosisDS1(x, method)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -60,38 +53,34 @@

    Arguments

    detailed in the headers of the client-side ds.kurtosis function.

    -
    -

    Value

    +
    +

    Value

    a list including the kurtosis of the input numeric variable, the number of valid observations and the study-side validity message.

    -
    -

    Details

    +
    +

    Details

    The function calculates the kurtosis of an input variable x with three different methods. The method is specified by the argument method in the client-side ds.kurtosis function.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/kurtosisDS1.md b/docs/reference/kurtosisDS1.md new file mode 100644 index 00000000..6060946b --- /dev/null +++ b/docs/reference/kurtosisDS1.md @@ -0,0 +1,37 @@ +# Calculates the kurtosis of a numeric variable + +This function calculates the kurtosis of a numeric variable for each +study separately. + +## Usage + +``` r +kurtosisDS1(x, method) +``` + +## Arguments + +- x: + + a string character, the name of a numeric variable. + +- method: + + an integer between 1 and 3 selecting one of the algorithms for + computing kurtosis detailed in the headers of the client-side + `ds.kurtosis` function. + +## Value + +a list including the kurtosis of the input numeric variable, the number +of valid observations and the study-side validity message. + +## Details + +The function calculates the kurtosis of an input variable x with three +different methods. The method is specified by the argument `method` in +the client-side `ds.kurtosis` function. + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/kurtosisDS2.html b/docs/reference/kurtosisDS2.html index 7758f44c..87dbccf8 100644 --- a/docs/reference/kurtosisDS2.html +++ b/docs/reference/kurtosisDS2.html @@ -1,56 +1,50 @@ -Calculates the kurtosis of a numeric variable — kurtosisDS2 • dsBase - - -
    -
    -
    -
    -

    Calculates the kurtosis of a numeric variable

    + - + + + +
    +
    +
    +
    + +

    Calculates the kurtosis of a numeric variable

    + +
    kurtosisDS2.Rd
    -
    +

    This function calculates summary statistics that are returned to the client-side and used for the estimation of the combined kurtosis of a numeric variable across all studies.

    -
    +
    +

    Usage

    kurtosisDS2(x, global.mean)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -61,42 +55,38 @@

    Arguments

    a numeric, the combined mean of the input variable across all studies.

    -
    -

    Value

    +
    +

    Value

    a list including the sum of quartic differences between the values of x and the global mean of x across all studies, the sum of squared differences between the values of x and the global mean of x across all studies, the number of valid observations (i.e. the length of x after excluding missing values), and a validity message indicating indicating a valid analysis if the number of valid observations are above the protection filter nfilter.tab or invalid analysis otherwise.

    -
    -

    Details

    +
    +

    Details

    The function calculates the sum of squared differences between the values of x and the global mean of x across all studies, the sum of quatric differences between the values of x and the global mean of x across all studies and the number of valid observations of the input variable x.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/kurtosisDS2.md b/docs/reference/kurtosisDS2.md new file mode 100644 index 00000000..45008ae0 --- /dev/null +++ b/docs/reference/kurtosisDS2.md @@ -0,0 +1,43 @@ +# Calculates the kurtosis of a numeric variable + +This function calculates summary statistics that are returned to the +client-side and used for the estimation of the combined kurtosis of a +numeric variable across all studies. + +## Usage + +``` r +kurtosisDS2(x, global.mean) +``` + +## Arguments + +- x: + + a string character, the name of a numeric variable. + +- global.mean: + + a numeric, the combined mean of the input variable across all studies. + +## Value + +a list including the sum of quartic differences between the values of x +and the global mean of x across all studies, the sum of squared +differences between the values of x and the global mean of x across all +studies, the number of valid observations (i.e. the length of x after +excluding missing values), and a validity message indicating indicating +a valid analysis if the number of valid observations are above the +protection filter nfilter.tab or invalid analysis otherwise. + +## Details + +The function calculates the sum of squared differences between the +values of x and the global mean of x across all studies, the sum of +quatric differences between the values of x and the global mean of x +across all studies and the number of valid observations of the input +variable x. + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/lengthDS.html b/docs/reference/lengthDS.html index 7c14412d..5fb7d0d7 100644 --- a/docs/reference/lengthDS.html +++ b/docs/reference/lengthDS.html @@ -1,90 +1,79 @@ -Returns the length of a vector or list — lengthDS • dsBase - - -
    -
    -
    -
    -

    Returns the length of a vector or list

    + - + + + +
    +
    +
    +
    + +

    Returns the length of a vector or list

    + +
    lengthDS.Rd
    -
    +

    This function is similar to R function length.

    -
    +
    +

    Usage

    lengthDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of a vector or list

    -
    -

    Value

    +
    +

    Value

    a numeric, the number of elements of the input vector or list.

    -
    -

    Details

    +
    +

    Details

    The function returns the length of the input vector or list.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lengthDS.md b/docs/reference/lengthDS.md new file mode 100644 index 00000000..f0823220 --- /dev/null +++ b/docs/reference/lengthDS.md @@ -0,0 +1,27 @@ +# Returns the length of a vector or list + +This function is similar to R function `length`. + +## Usage + +``` r +lengthDS(x) +``` + +## Arguments + +- x: + + a string character, the name of a vector or list + +## Value + +a numeric, the number of elements of the input vector or list. + +## Details + +The function returns the length of the input vector or list. + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/levelsDS.html b/docs/reference/levelsDS.html index 5d7163fb..5a301643 100644 --- a/docs/reference/levelsDS.html +++ b/docs/reference/levelsDS.html @@ -1,90 +1,79 @@ -Returns the levels of a factor vector — levelsDS • dsBase - - -
    -
    -
    -
    -

    Returns the levels of a factor vector

    + - + + + +
    +
    +
    +
    + +

    Returns the levels of a factor vector

    + +
    levelsDS.Rd
    -
    +

    This function is similar to R function levels.

    -
    +
    +

    Usage

    levelsDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a factor vector

    -
    -

    Value

    +
    +

    Value

    a list, the factor levels present in the vector

    -
    -

    Details

    +
    +

    Details

    The function returns the levels of the input vector or list.

    -
    -

    Author

    +
    +

    Author

    Alex Westerberg, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/levelsDS.md b/docs/reference/levelsDS.md new file mode 100644 index 00000000..1033e254 --- /dev/null +++ b/docs/reference/levelsDS.md @@ -0,0 +1,27 @@ +# Returns the levels of a factor vector + +This function is similar to R function `levels`. + +## Usage + +``` r +levelsDS(x) +``` + +## Arguments + +- x: + + a factor vector + +## Value + +a list, the factor levels present in the vector + +## Details + +The function returns the levels of the input vector or list. + +## Author + +Alex Westerberg, for DataSHIELD Development Team diff --git a/docs/reference/lexisDS1.html b/docs/reference/lexisDS1.html index acf40341..32d29298 100644 --- a/docs/reference/lexisDS1.html +++ b/docs/reference/lexisDS1.html @@ -1,91 +1,80 @@ -lexisDS1 — lexisDS1 • dsBase - - -
    -
    -
    -
    -

    lexisDS1

    + - + + + +
    +
    +
    +
    + +

    lexisDS1

    + +
    lexisDS1.Rd
    -
    +

    The first server-side function called by ds.lexis.

    -
    +
    +

    Usage

    lexisDS1(exitCol = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    exitCol

    a character string specifying the variable holding the time that each individual is censored or fails

    -
    -

    Value

    +
    +

    Value

    List with `max.time`

    -
    -

    Details

    +
    +

    Details

    This is an aggregate function. For more details see the extensive header for ds.lexis.

    -
    -

    Author

    +
    +

    Author

    Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lexisDS1.md b/docs/reference/lexisDS1.md new file mode 100644 index 00000000..93797e2d --- /dev/null +++ b/docs/reference/lexisDS1.md @@ -0,0 +1,29 @@ +# lexisDS1 + +The first server-side function called by ds.lexis. + +## Usage + +``` r +lexisDS1(exitCol = NULL) +``` + +## Arguments + +- exitCol: + + a character string specifying the variable holding the time that each + individual is censored or fails + +## Value + +List with \`max.time\` + +## Details + +This is an aggregate function. For more details see the extensive header +for ds.lexis. + +## Author + +Burton PR diff --git a/docs/reference/lexisDS2.html b/docs/reference/lexisDS2.html index 203d290c..ee7783e9 100644 --- a/docs/reference/lexisDS2.html +++ b/docs/reference/lexisDS2.html @@ -1,49 +1,42 @@ -lexisDS2 — lexisDS2 • dsBase - - -
    -
    -
    -
    -

    lexisDS2

    + - + + + +
    +
    +
    +
    + +

    lexisDS2

    + +
    lexisDS2.Rd
    -
    +

    The second serverside function called by ds.lexis.

    -
    +
    +

    Usage

    lexisDS2(
   datatext = NULL,
   intervalWidth,
@@ -56,8 +49,8 @@ 
    lexisDS2
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    datatext
    @@ -103,12 +96,12 @@

    Arguments

    'data' argument is set the full data.frame will be expanded and carried forward

    -
    -

    Value

    +
    +

    Value

    List with `expanded.table`

    -
    -

    Details

    +
    +

    Details

    This is the assign function which actually creates the expanded dataframe containing survival data for a piecewise exponential @@ -119,28 +112,24 @@

    Details

    message is stored. For more details see the extensive header for ds.lexis.

    -
    -

    Author

    +
    +

    Author

    Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lexisDS2.md b/docs/reference/lexisDS2.md new file mode 100644 index 00000000..efeb0408 --- /dev/null +++ b/docs/reference/lexisDS2.md @@ -0,0 +1,82 @@ +# lexisDS2 + +The second serverside function called by ds.lexis. + +## Usage + +``` r +lexisDS2( + datatext = NULL, + intervalWidth, + maxmaxtime, + idCol, + entryCol, + exitCol, + statusCol, + vartext = NULL +) +``` + +## Arguments + +- datatext: + + a clientside provided character string specifying the data.frame + holding the data set to be expanded + +- intervalWidth: + + a clientside generated character string specifying the width of the + survival epochs in the expanded data + +- maxmaxtime: + + a clientside generated object specifying the maximum follow up time in + any of the sources + +- idCol: + + a clientside generated character string specifying the variable + holding the IDs of individuals in the data set to be expanded + +- entryCol: + + a clientside specified character string identifying the variable + holding the time that each individual starts follow up + +- exitCol: + + a clientside specified character string identifying the variable + holding the time that each individual ends follow up (is censored or + fails) + +- statusCol: + + a clientside specified character string identifying the variable + holding the final censoring status (failed/censored) + +- vartext: + + is a clientside provided vector of character strings denoting the + column names of additional variables to include in the final expanded + table. If the 'variables' argument is not set (is null) but the 'data' + argument is set the full data.frame will be expanded and carried + forward + +## Value + +List with \`expanded.table\` + +## Details + +This is the assign function which actually creates the expanded +dataframe containing survival data for a piecewise exponential +regression. lexisDS2 also carries out a series of disclosure checks and +if the arguments or data fail any of those tests, creation of the +expanded dataframe is blocked and an appropriate serverside error +message is stored. For more details see the extensive header for +ds.lexis. + +## Author + +Burton PR diff --git a/docs/reference/lexisDS3.html b/docs/reference/lexisDS3.html index c16502f5..c69127c5 100644 --- a/docs/reference/lexisDS3.html +++ b/docs/reference/lexisDS3.html @@ -1,81 +1,70 @@ -@title lexisDS3 — lexisDS3 • dsBase - - -
    -
    -
    -
    -

    @title lexisDS3

    + - + + + +
    +
    +
    +
    + +

    @title lexisDS3

    + +
    lexisDS3.Rd
    -
    +

    The third serverside function called by ds.lexis.

    -
    +
    +

    Usage

    lexisDS3()
    -
    -

    Value

    +
    +

    Value

    Data frame with `messageobj` object

    -
    -

    Details

    +
    +

    Details

    This is an assign function that simplifies the returned output from ds.lexis. Specifically, without lexisDS3 the output consists of a table within a list, but lexisDS3 converts this directly into a dataframe. For more details see the extensive header for ds.lexis.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lexisDS3.md b/docs/reference/lexisDS3.md new file mode 100644 index 00000000..9621f7c1 --- /dev/null +++ b/docs/reference/lexisDS3.md @@ -0,0 +1,20 @@ +# @title lexisDS3 + +The third serverside function called by ds.lexis. + +## Usage + +``` r +lexisDS3() +``` + +## Value + +Data frame with \`messageobj\` object + +## Details + +This is an assign function that simplifies the returned output from +ds.lexis. Specifically, without lexisDS3 the output consists of a table +within a list, but lexisDS3 converts this directly into a dataframe. For +more details see the extensive header for ds.lexis. diff --git a/docs/reference/listDS.html b/docs/reference/listDS.html index 517bff8d..4dc55619 100644 --- a/docs/reference/listDS.html +++ b/docs/reference/listDS.html @@ -1,54 +1,47 @@ -Coerce objects into a list — listDS • dsBase - - -
    -
    -
    -
    -

    Coerce objects into a list

    + - + + + +
    +
    +
    +
    + +

    Coerce objects into a list

    + +
    listDS.Rd
    -
    +

    this function is similar to R function 'list'

    -
    +
    +

    Usage

    listDS(input = NULL, eltnames = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    input
    @@ -59,37 +52,33 @@

    Arguments

    a character list, the names of the elements in the list.

    -
    -

    Value

    +
    +

    Value

    a list

    -
    -

    Details

    +
    +

    Details

    Unlike the R function 'list' it takes also a vector of characters, the names of the elements in the output list.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/listDS.md b/docs/reference/listDS.md new file mode 100644 index 00000000..ebe4364c --- /dev/null +++ b/docs/reference/listDS.md @@ -0,0 +1,32 @@ +# Coerce objects into a list + +this function is similar to R function 'list' + +## Usage + +``` r +listDS(input = NULL, eltnames = NULL) +``` + +## Arguments + +- input: + + a list of objects to coerce into a list + +- eltnames: + + a character list, the names of the elements in the list. + +## Value + +a list + +## Details + +Unlike the R function 'list' it takes also a vector of characters, the +names of the elements in the output list. + +## Author + +Gaye, A. diff --git a/docs/reference/listDisclosureSettingsDS.html b/docs/reference/listDisclosureSettingsDS.html index 2f6252fa..48f558d4 100644 --- a/docs/reference/listDisclosureSettingsDS.html +++ b/docs/reference/listDisclosureSettingsDS.html @@ -1,84 +1,74 @@ -listDisclosureSettingsDS — listDisclosureSettingsDS • dsBase - - -
    -
    -
    -
    -

    listDisclosureSettingsDS

    + - + + + +
    +
    +
    +
    + +

    listDisclosureSettingsDS

    + +
    listDisclosureSettingsDS.Rd
    -
    +

    This serverside function is an aggregate function that is called by the ds.listDisclosureSettings

    -
    +
    +

    Usage

    listDisclosureSettingsDS()
    -
    -

    Value

    +
    +

    Value

    List with DataSHIELD disclosure settings

    -
    -

    Details

    +
    +

    Details

    For more details see the extensive header for ds.listDisclosureSettings

    -
    -

    Author

    +
    +

    Author

    Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/listDisclosureSettingsDS.md b/docs/reference/listDisclosureSettingsDS.md new file mode 100644 index 00000000..ebcb2ef1 --- /dev/null +++ b/docs/reference/listDisclosureSettingsDS.md @@ -0,0 +1,22 @@ +# listDisclosureSettingsDS + +This serverside function is an aggregate function that is called by the +ds.listDisclosureSettings + +## Usage + +``` r +listDisclosureSettingsDS() +``` + +## Value + +List with DataSHIELD disclosure settings + +## Details + +For more details see the extensive header for ds.listDisclosureSettings + +## Author + +Paul Burton, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/lmerSLMADS.assign.html b/docs/reference/lmerSLMADS.assign.html index 48630bbd..9eb05a0a 100644 --- a/docs/reference/lmerSLMADS.assign.html +++ b/docs/reference/lmerSLMADS.assign.html @@ -1,51 +1,45 @@ -Fitting linear mixed effect models - serverside function — lmerSLMADS.assign • dsBase - - -
    -
    -
    -
    -

    Fitting linear mixed effect models - serverside function

    + - + + + +
    +
    +
    +
    + +

    Fitting linear mixed effect models - serverside function

    + +
    lmerSLMADS.assign.Rd
    -
    +

    lmerSLMADS.assign is the same as lmerSLMADS2 which fits a linear mixed effects model (lme) per study and saves the outcomes in each study

    -
    +
    +

    Usage

    lmerSLMADS.assign(
   formula,
   offset,
@@ -59,8 +53,8 @@ 
    Fitting linear mixed effect models - serverside function
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -100,40 +94,36 @@

    Arguments

    see help for ds.lmerSLMA

    -
    -

    Value

    +
    +

    Value

    writes lmerMod object summarising the fitted model to the serverside. For more detailed information see help for ds.lmerSLMA.

    -
    -

    Details

    +
    +

    Details

    lmerSLMADS.assign is a serverside function called by ds.lmerSLMA on the clientside. The analytic work engine is the lmer function in R which sits in the lme4 package. lmerSLMADS.assign fits a linear mixed effects model (lme) including both fixed and random effects - on data from each single data source and saves the regression outcomes on the serverside.

    -
    -

    Author

    +
    +

    Author

    TDemetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lmerSLMADS.assign.md b/docs/reference/lmerSLMADS.assign.md new file mode 100644 index 00000000..f1200c46 --- /dev/null +++ b/docs/reference/lmerSLMADS.assign.md @@ -0,0 +1,75 @@ +# Fitting linear mixed effect models - serverside function + +lmerSLMADS.assign is the same as lmerSLMADS2 which fits a linear mixed +effects model (lme) per study and saves the outcomes in each study + +## Usage + +``` r +lmerSLMADS.assign( + formula, + offset, + weights, + dataName, + REML = TRUE, + control_type, + control_value.transmit, + optimizer, + verbose = 0 +) +``` + +## Arguments + +- formula: + + see help for ds.lmerSLMA + +- offset: + + see help for ds.lmerSLMA + +- weights: + + see help for ds.lmerSLMA + +- dataName: + + see help for ds.lmerSLMA + +- REML: + + see help for ds.lmerSLMA + +- control_type: + + see help for ds.lmerSLMA + +- control_value.transmit: + + see help for argument \ for function ds.lmerSLMA + +- optimizer: + + see help for ds.lmerSLMA + +- verbose: + + see help for ds.lmerSLMA + +## Value + +writes lmerMod object summarising the fitted model to the serverside. +For more detailed information see help for ds.lmerSLMA. + +## Details + +lmerSLMADS.assign is a serverside function called by ds.lmerSLMA on the +clientside. The analytic work engine is the lmer function in R which +sits in the lme4 package. lmerSLMADS.assign fits a linear mixed effects +model (lme) including both fixed and random effects - on data from each +single data source and saves the regression outcomes on the serverside. + +## Author + +TDemetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/lmerSLMADS2.html b/docs/reference/lmerSLMADS2.html index 963b4627..2395d00d 100644 --- a/docs/reference/lmerSLMADS2.html +++ b/docs/reference/lmerSLMADS2.html @@ -1,53 +1,48 @@ -Fitting linear mixed effect models - serverside function — lmerSLMADS2 • dsBaseFitting linear mixed effect models - serverside function — lmerSLMADS2 • dsBase - - -
    -
    -
    -
    -

    Fitting linear mixed effect models - serverside function

    - +
    +
    +
    +
    + +

    Fitting linear mixed effect models - serverside function

    + +
    lmerSLMADS2.Rd
    -
    +

    lmerSLMADS2 is a serverside function which fits a linear mixed effects model (lme) - i.e. can include both fixed and random effects - on data from one or multiple sources with pooling via SLMA (study level meta-analysis)

    -
    +
    +

    Usage

    lmerSLMADS2(
   formula,
   offset,
@@ -61,8 +56,8 @@ 
    Fitting linear mixed effect models - serverside function
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    formula
    @@ -102,12 +97,12 @@

    Arguments

    see help for ds.lmerSLMA

    -
    -

    Value

    +
    +

    Value

    all key model components see help for ds.lmerSLMA

    -
    -

    Details

    +
    +

    Details

    lmerSLMADS2 is a serverside function called by ds.lmerSLMA on the clientside. The analytic work engine is the lmer function in R which sits in the lme4 package. ds.lmerSLMA fits a linear mixed effects model (lme) - can include both fixed and random @@ -122,28 +117,24 @@

    Details

    about fitting lmes using the lmer engine can be obtained using R help for lmer and the lme4 package

    -
    -

    Author

    +
    +

    Author

    Tom Bishop, with some additions by Paul Burton

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lmerSLMADS2.md b/docs/reference/lmerSLMADS2.md new file mode 100644 index 00000000..f56d78c9 --- /dev/null +++ b/docs/reference/lmerSLMADS2.md @@ -0,0 +1,86 @@ +# Fitting linear mixed effect models - serverside function + +lmerSLMADS2 is a serverside function which fits a linear mixed effects +model (lme) - i.e. can include both fixed and random effects - on data +from one or multiple sources with pooling via SLMA (study level +meta-analysis) + +## Usage + +``` r +lmerSLMADS2( + formula, + offset, + weights, + dataName, + REML = TRUE, + control_type, + control_value.transmit, + optimizer, + verbose = 0 +) +``` + +## Arguments + +- formula: + + see help for ds.lmerSLMA + +- offset: + + see help for ds.lmerSLMA + +- weights: + + see help for ds.lmerSLMA + +- dataName: + + see help for ds.lmerSLMA + +- REML: + + see help for ds.lmerSLMA + +- control_type: + + see help for ds.lmerSLMA + +- control_value.transmit: + + see help for argument \ for function ds.lmerSLMA + +- optimizer: + + see help for ds.lmerSLMA + +- verbose: + + see help for ds.lmerSLMA + +## Value + +all key model components see help for ds.lmerSLMA + +## Details + +lmerSLMADS2 is a serverside function called by ds.lmerSLMA on the +clientside. The analytic work engine is the lmer function in R which +sits in the lme4 package. ds.lmerSLMA fits a linear mixed effects model +(lme) - can include both fixed and random effects - on data from a +single or multiple sources. When there are multiple data sources, the +lme is fitted to convergence in each data source independently and the +estimates and standard errors returned to the client thereby enabling +cross-study pooling using study level meta-analysis (SLMA). By default +the SLMA is undertaken using the metafor package, but as the SLMA occurs +on the clientside which, as far as the user is concerned is just a +standard R environment, the user can choose to use any approach to +meta-analysis they choose. For more detailed help about any aspect of +lmerSLMDS2 please see the extensive help for ds.lmerSLMA. Additional +information about fitting lmes using the lmer engine can be obtained +using R help for lmer and the lme4 package + +## Author + +Tom Bishop, with some additions by Paul Burton diff --git a/docs/reference/lsDS.html b/docs/reference/lsDS.html index 104bc735..8fdea6b9 100644 --- a/docs/reference/lsDS.html +++ b/docs/reference/lsDS.html @@ -1,56 +1,50 @@ -lists all objects on a serverside environment — lsDS • dsBase - - -
    -
    -
    -
    -

    lists all objects on a serverside environment

    + - + + + +
    +
    +
    +
    + +

    lists all objects on a serverside environment

    + +
    lsDS.Rd
    -
    +

    creates a list of the names of all of the objects in a specified serverside environment

    -
    +
    +

    Usage

    lsDS(search.filter = NULL, env.to.search)
    -
    -

    Arguments

    +
    +

    Arguments

    search.filter
    @@ -65,16 +59,16 @@

    Arguments

    fully specified by its corresponding argument in the clientside function.

    -
    -

    Value

    +
    +

    Value

    a list containing: (1) the name/details of the serverside R environment which ds.ls has searched; (2) a vector of character strings giving the names of all objects meeting the naming criteria specified by the argument <search.filter> in this specified R serverside environment; (3) the nature of the search filter string as it was actually applied

    -
    -

    Details

    +
    +

    Details

    Serverside aggregate function lsDS called by clientside function ds.ls. When running analyses one may want to know the objects already generated. This request is not disclosive as it only returns the names of the objects and not their contents. @@ -85,28 +79,24 @@

    Details

    of managing or undertaking the analysis (variables, scalars, matrices, data.frames etc). For further details see help for ds.ls function and for native R function ls

    -
    -

    Author

    +
    +

    Author

    Gaye, A (2015). Updated and extended by Paul Burton (2020).

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lsDS.md b/docs/reference/lsDS.md new file mode 100644 index 00000000..f9a832ae --- /dev/null +++ b/docs/reference/lsDS.md @@ -0,0 +1,50 @@ +# lists all objects on a serverside environment + +creates a list of the names of all of the objects in a specified +serverside environment + +## Usage + +``` r +lsDS(search.filter = NULL, env.to.search) +``` + +## Arguments + +- search.filter: + + either NULL or a character string (potentially including '\*' + wildcards) specifying required search criteria. This argument is fully + specified by its corresponding argument in the clientside function. + +- env.to.search: + + integer (e.g. in a format such as '2' or '5L' format) specifying the + position in the search path of the environment to be explored. This + argument is fully specified by its corresponding argument in the + clientside function. + +## Value + +a list containing: (1) the name/details of the serverside R environment +which `ds.ls` has searched; (2) a vector of character strings giving the +names of all objects meeting the naming criteria specified by the +argument \ in this specified R serverside environment; +(3) the nature of the search filter string as it was actually applied + +## Details + +Serverside aggregate function `lsDS` called by clientside function +`ds.ls`. When running analyses one may want to know the objects already +generated. This request is not disclosive as it only returns the names +of the objects and not their contents. By default, objects in the +current 'active analytic environment' (".GlobalEnv") will be displayed. +This is the environment that contains all of the objects that serverside +DataSHIELD is using for the main analysis or has written out to the +serverside during the process of managing or undertaking the analysis +(variables, scalars, matrices, data.frames etc). For further details see +help for `ds.ls` function and for native R function `ls` + +## Author + +Gaye, A (2015). Updated and extended by Paul Burton (2020). diff --git a/docs/reference/lsplineDS.html b/docs/reference/lsplineDS.html index 777dd690..6fae0845 100644 --- a/docs/reference/lsplineDS.html +++ b/docs/reference/lsplineDS.html @@ -1,60 +1,56 @@ -Basis for a piecewise linear spline with meaningful coefficients — lsplineDS • dsBaseBasis for a piecewise linear spline with meaningful coefficients — lsplineDS • dsBase - - -
    -
    -
    -
    -

    Basis for a piecewise linear spline with meaningful coefficients

    - +
    +
    +
    +
    + +

    Basis for a piecewise linear spline with meaningful coefficients

    + +
    lsplineDS.Rd
    -
    +

    This function is based on the native R function lspline from the lspline package. This function computes the basis of piecewise-linear spline such that, depending on the argument marginal, the coefficients can be interpreted as (1) slopes of consecutive spline segments, or (2) slope change at consecutive knots.

    -
    +
    +

    Usage

    lsplineDS(x = x, knots = NULL, marginal = FALSE, names = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -73,40 +69,36 @@

    Arguments

    character, vector of names for constructed variables

    -
    -

    Value

    +
    +

    Value

    an object of class "lspline" and "matrix", which its name is specified by the newobj argument (or its default name "lspline.newobj"), is assigned on the serverside.

    -
    -

    Details

    +
    +

    Details

    If marginal is FALSE (default) the coefficients of the spline correspond to slopes of the consecutive segments. If it is TRUE the first coefficient correspond to the slope of the first segment. The consecutive coefficients correspond to the change in slope as compared to the previous segment.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/lsplineDS.md b/docs/reference/lsplineDS.md new file mode 100644 index 00000000..758fe2fe --- /dev/null +++ b/docs/reference/lsplineDS.md @@ -0,0 +1,49 @@ +# Basis for a piecewise linear spline with meaningful coefficients + +This function is based on the native R function `lspline` from the +`lspline` package. This function computes the basis of piecewise-linear +spline such that, depending on the argument marginal, the coefficients +can be interpreted as (1) slopes of consecutive spline segments, or (2) +slope change at consecutive knots. + +## Usage + +``` r +lsplineDS(x = x, knots = NULL, marginal = FALSE, names = NULL) +``` + +## Arguments + +- x: + + the name of the input numeric variable + +- knots: + + numeric vector of knot positions + +- marginal: + + logical, how to parametrize the spline, see Details + +- names, : + + character, vector of names for constructed variables + +## Value + +an object of class "lspline" and "matrix", which its name is specified +by the `newobj` argument (or its default name "lspline.newobj"), is +assigned on the serverside. + +## Details + +If marginal is FALSE (default) the coefficients of the spline correspond +to slopes of the consecutive segments. If it is TRUE the first +coefficient correspond to the slope of the first segment. The +consecutive coefficients correspond to the change in slope as compared +to the previous segment. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/matrixDS.html b/docs/reference/matrixDS.html index 6a64f8b4..ecfe407b 100644 --- a/docs/reference/matrixDS.html +++ b/docs/reference/matrixDS.html @@ -1,54 +1,47 @@ -matrixDS assign function called by ds.matrix — matrixDS • dsBase - - -
    -
    -
    -
    -

    matrixDS assign function called by ds.matrix

    + - + + + +
    +
    +
    +
    + +

    matrixDS assign function called by ds.matrix

    + +
    matrixDS.Rd
    -
    +

    Creates a matrix A on the serverside

    -
    +
    +

    Usage

    matrixDS(mdata.transmit, from, nrows.transmit, ncols.transmit, byrow, dimnames)
    -
    -

    Arguments

    +
    +

    Arguments

    mdata.transmit
    @@ -85,39 +78,35 @@

    Arguments

    Fully specified by <dimnames> argument of ds.matrix

    -
    -

    Value

    +
    +

    Value

    Output is the matrix A written to the serverside. For more details see help for ds.matrix

    -
    -

    Details

    +
    +

    Details

    Similar to the matrix() function in native R. Creates a matrix with dimensions specified by <nrows.scalar> and <ncols.scalar> arguments and assigns the values of all its elements based on the <mdata> argument

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixDS.md b/docs/reference/matrixDS.md new file mode 100644 index 00000000..4c6f456b --- /dev/null +++ b/docs/reference/matrixDS.md @@ -0,0 +1,60 @@ +# matrixDS assign function called by ds.matrix + +Creates a matrix A on the serverside + +## Usage + +``` r +matrixDS(mdata.transmit, from, nrows.transmit, ncols.transmit, byrow, dimnames) +``` + +## Arguments + +- mdata.transmit: + + specifies the elements of the matrix to be created. Fully specified by + \ argument of ds.matrix + +- from: + + a character string specifying the source and nature of \. + Fully specified by \ argument of ds.matrix + +- nrows.transmit: + + specifies the number of rows in the matrix to be created. Fully + specified by \ argument of ds.matrix + +- ncols.transmit: + + specifies the number of columns in the matrix to be created. Fully + specified by \ argument of ds.matrix + +- byrow: + + a logical value specifying whether, when \ is a vector, the + matrix created should be filled row by row or column by column. Fully + specified by \ argument of ds.matrix + +- dimnames: + + A dimnames attribute for the matrix: NULL or a list of length 2 giving + the row and column names respectively. An empty list is treated as + NULL, and a list of length one as row names only. Fully specified by + \ argument of ds.matrix + +## Value + +Output is the matrix A written to the serverside. For more details see +help for ds.matrix + +## Details + +Similar to the [`matrix()`](https://rdrr.io/r/base/matrix.html) function +in native R. Creates a matrix with dimensions specified by +\ and \ arguments and assigns the values +of all its elements based on the \ argument + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixDetDS1.html b/docs/reference/matrixDetDS1.html index 63f81b79..0d36ca5c 100644 --- a/docs/reference/matrixDetDS1.html +++ b/docs/reference/matrixDetDS1.html @@ -1,56 +1,50 @@ -matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1 • dsBase - - -
    -
    -
    -
    -

    matrixDetDS aggregate function called by ds.matrixDet.report

    + - + + + +
    +
    +
    +
    + +

    matrixDetDS aggregate function called by ds.matrixDet.report

    + +
    matrixDetDS1.Rd
    -
    +

    Calculates the determinant of a square matrix A and returns the output to the clientside

    -
    +
    +

    Usage

    matrixDetDS1(M1.name = NULL, logarithm)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name
    @@ -63,39 +57,35 @@

    Arguments

    determinant itself, TRUE returns the logarithm of the modulus of the determinant.

    -
    -

    Value

    +
    +

    Value

    Output is the determinant of the matrix identified by argument <M1> which is returned to the clientside. For more details see help for ds.matrixDet

    -
    -

    Details

    +
    +

    Details

    Calculates the determinant of a square matrix (for additional information see help for det function in native R). This operation is only possible if the number of columns and rows of A are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixDetDS1.md b/docs/reference/matrixDetDS1.md new file mode 100644 index 00000000..c5aa5dfe --- /dev/null +++ b/docs/reference/matrixDetDS1.md @@ -0,0 +1,38 @@ +# matrixDetDS aggregate function called by ds.matrixDet.report + +Calculates the determinant of a square matrix A and returns the output +to the clientside + +## Usage + +``` r +matrixDetDS1(M1.name = NULL, logarithm) +``` + +## Arguments + +- M1.name: + + A character string specifying the name of the matrix for which + determinant to be calculated + +- logarithm: + + logical. Default is FALSE, which returns the determinant itself, TRUE + returns the logarithm of the modulus of the determinant. + +## Value + +Output is the determinant of the matrix identified by argument \ +which is returned to the clientside. For more details see help for +ds.matrixDet + +## Details + +Calculates the determinant of a square matrix (for additional +information see help for `det` function in native R). This operation is +only possible if the number of columns and rows of A are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixDetDS2.html b/docs/reference/matrixDetDS2.html index 9792ce23..220a98a1 100644 --- a/docs/reference/matrixDetDS2.html +++ b/docs/reference/matrixDetDS2.html @@ -1,56 +1,50 @@ -matrixDetDS assign function called by ds.matrixDet — matrixDetDS2 • dsBase - - -
    -
    -
    -
    -

    matrixDetDS assign function called by ds.matrixDet

    + - + + + +
    +
    +
    +
    + +

    matrixDetDS assign function called by ds.matrixDet

    + +
    matrixDetDS2.Rd
    -
    +

    Calculates the determinant of a square matrix A and writes the output to the serverside

    -
    +
    +

    Usage

    matrixDetDS2(M1.name = NULL, logarithm)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name
    @@ -63,39 +57,35 @@

    Arguments

    determinant itself, TRUE returns the logarithm of the modulus of the determinant.

    -
    -

    Value

    +
    +

    Value

    Output is the determinant of the matrix identified by argument <M1> which is written to the serverside. For more details see help for ds.matrixDet

    -
    -

    Details

    +
    +

    Details

    Calculates the determinant of a square matrix (for additional information see help for det function in native R). This operation is only possible if the number of columns and rows of A are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixDetDS2.md b/docs/reference/matrixDetDS2.md new file mode 100644 index 00000000..ee5b8b91 --- /dev/null +++ b/docs/reference/matrixDetDS2.md @@ -0,0 +1,38 @@ +# matrixDetDS assign function called by ds.matrixDet + +Calculates the determinant of a square matrix A and writes the output to +the serverside + +## Usage + +``` r +matrixDetDS2(M1.name = NULL, logarithm) +``` + +## Arguments + +- M1.name: + + A character string specifying the name of the matrix for which + determinant to be calculated + +- logarithm: + + logical. Default is FALSE, which returns the determinant itself, TRUE + returns the logarithm of the modulus of the determinant. + +## Value + +Output is the determinant of the matrix identified by argument \ +which is written to the serverside. For more details see help for +ds.matrixDet + +## Details + +Calculates the determinant of a square matrix (for additional +information see help for `det` function in native R). This operation is +only possible if the number of columns and rows of A are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixDiagDS.html b/docs/reference/matrixDiagDS.html index 8b140d6b..bf968318 100644 --- a/docs/reference/matrixDiagDS.html +++ b/docs/reference/matrixDiagDS.html @@ -1,58 +1,53 @@ -matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS • dsBasematrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS • dsBase - - -
    -
    -
    -
    -

    matrixDiagDS assign function called by ds.matrixDiag

    - +
    +
    +
    +
    + +

    matrixDiagDS assign function called by ds.matrixDiag

    + +
    matrixDiagDS.Rd
    -
    +

    Extracts the diagonal vector from a square matrix A or creates a diagonal matrix A based on a vector or a scalar value and writes the output to the serverside

    -
    +
    +

    Usage

    matrixDiagDS(x1.transmit, aim, nrows.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    x1.transmit
    @@ -74,38 +69,34 @@

    Arguments

    For more details see help for ds.matrixDiag.

    -
    -

    Value

    +
    +

    Value

    Output is the matrix or vector specified by the <newobj> argument (or default name diag_<x1>) which is written to the serverside. For more details see help for ds.matrixDiag.

    -
    -

    Details

    +
    +

    Details

    For details see help for function ds.matrixDiag.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixDiagDS.md b/docs/reference/matrixDiagDS.md new file mode 100644 index 00000000..e24307ed --- /dev/null +++ b/docs/reference/matrixDiagDS.md @@ -0,0 +1,45 @@ +# matrixDiagDS assign function called by ds.matrixDiag + +Extracts the diagonal vector from a square matrix A or creates a +diagonal matrix A based on a vector or a scalar value and writes the +output to the serverside + +## Usage + +``` r +matrixDiagDS(x1.transmit, aim, nrows.transmit) +``` + +## Arguments + +- x1.transmit: + + identifies the input matrix or vector. Fully specified by \ + argument of `ds.matrixDiag`. For more details see help for + `ds.matrixDiag`. + +- aim: + + a character string specifying what behaviour is required of the + function. Fully specified by \ argument of `ds.matrixDiag`. For + more details see help for `ds.matrixDiag`. + +- nrows.transmit: + + a scalar value forcing the number of rows and columns in an output + matrix.Fully specified by \ argument of + `ds.matrixDiag`. For more details see help for `ds.matrixDiag`. + +## Value + +Output is the matrix or vector specified by the \ argument (or +default name diag\_\) which is written to the serverside. For more +details see help for `ds.matrixDiag`. + +## Details + +For details see help for function `ds.matrixDiag`. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixDimnamesDS.html b/docs/reference/matrixDimnamesDS.html index 3b09658c..a81f0588 100644 --- a/docs/reference/matrixDimnamesDS.html +++ b/docs/reference/matrixDimnamesDS.html @@ -1,56 +1,50 @@ -matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS • dsBase - - -
    -
    -
    -
    -

    matrixDimnamesDS assign function called by ds.matrixDimnames

    + - + + + +
    +
    +
    +
    + +

    matrixDimnamesDS assign function called by ds.matrixDimnames

    + +
    matrixDimnamesDS.Rd
    -
    +

    Adds dimnames (row names, column names or both) to a matrix on the serverside.

    -
    +
    +

    Usage

    matrixDimnamesDS(M1.name = NULL, dimnames)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name
    @@ -68,41 +62,37 @@

    Arguments

    see help for ds.matrixDimnames.

    -
    -

    Value

    +
    +

    Value

    Output is the serverside matrix specified by the <newobj> argument (or default name diag_<x1>) with specified dimnames (row and column names) which is written to the serverside.

    -
    -

    Details

    +
    +

    Details

    Adds dimnames (row names, column names or both) to a matrix on the serverside. Similar to the dimnames function in native R. For more details see help for function ds.matrixDimnames

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixDimnamesDS.md b/docs/reference/matrixDimnamesDS.md new file mode 100644 index 00000000..cb294288 --- /dev/null +++ b/docs/reference/matrixDimnamesDS.md @@ -0,0 +1,42 @@ +# matrixDimnamesDS assign function called by ds.matrixDimnames + +Adds dimnames (row names, column names or both) to a matrix on the +serverside. + +## Usage + +``` r +matrixDimnamesDS(M1.name = NULL, dimnames) +``` + +## Arguments + +- M1.name: + + Specifies the name of the serverside matrix to which dimnames are to + be added. Fully specified by \ argument of function + `ds.matrixDimnames`. For more details see help for + `ds.matrixDimnames`. + +- dimnames: + + A dimnames attribute for the matrix: NULL or a list of length 2 giving + the row and column names respectively. Fully specified by \ + argument of function `ds.matrixDimnames`. For more details see help + for `ds.matrixDimnames`. + +## Value + +Output is the serverside matrix specified by the \ argument (or +default name diag\_\) with specified dimnames (row and column +names) which is written to the serverside. + +## Details + +Adds dimnames (row names, column names or both) to a matrix on the +serverside. Similar to the `dimnames` function in native R. For more +details see help for function `ds.matrixDimnames` + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixInvertDS.html b/docs/reference/matrixInvertDS.html index 8c4157ef..d50fd660 100644 --- a/docs/reference/matrixInvertDS.html +++ b/docs/reference/matrixInvertDS.html @@ -1,93 +1,82 @@ -matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS • dsBase - - -
    -
    -
    -
    -

    matrixInvertDS serverside assign function called by ds.matrixInvert

    + - + + + +
    +
    +
    +
    + +

    matrixInvertDS serverside assign function called by ds.matrixInvert

    + +
    matrixInvertDS.Rd
    -
    +

    Inverts a square matrix A and writes the output to the serverside

    -
    +
    +

    Usage

    matrixInvertDS(M1.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name

    A character string specifying the name of the matrix to be inverted

    -
    -

    Value

    +
    +

    Value

    Output is the matrix representing the inverse of A which is written to the serverside. For more details see help for ds.matrixInvert

    -
    -

    Details

    +
    +

    Details

    Undertakes standard matrix inversion. This operation is only possible if the number of columns and rows of A are the same and the matrix is non-singular - positive definite (eg there is no row or column that is all zeros)

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixInvertDS.md b/docs/reference/matrixInvertDS.md new file mode 100644 index 00000000..99f442e5 --- /dev/null +++ b/docs/reference/matrixInvertDS.md @@ -0,0 +1,31 @@ +# matrixInvertDS serverside assign function called by ds.matrixInvert + +Inverts a square matrix A and writes the output to the serverside + +## Usage + +``` r +matrixInvertDS(M1.name = NULL) +``` + +## Arguments + +- M1.name: + + A character string specifying the name of the matrix to be inverted + +## Value + +Output is the matrix representing the inverse of A which is written to +the serverside. For more details see help for ds.matrixInvert + +## Details + +Undertakes standard matrix inversion. This operation is only possible if +the number of columns and rows of A are the same and the matrix is +non-singular - positive definite (eg there is no row or column that is +all zeros) + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixMultDS.html b/docs/reference/matrixMultDS.html index 8bae8648..323c6705 100644 --- a/docs/reference/matrixMultDS.html +++ b/docs/reference/matrixMultDS.html @@ -1,54 +1,47 @@ -matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS • dsBase - - -
    -
    -
    -
    -

    matrixMultDS serverside assign function called by ds.matrixMult

    + - + + + +
    +
    +
    +
    + +

    matrixMultDS serverside assign function called by ds.matrixMult

    + +
    matrixMultDS.Rd
    -
    +

    Calculates the matrix product of two matrices and writes output to serverside

    -
    +
    +

    Usage

    matrixMultDS(M1.name = NULL, M2.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name
    @@ -61,41 +54,37 @@

    Arguments

    specified by the M1 argument in the original call to ds.matrixMult

    -
    -

    Value

    +
    +

    Value

    Output is the matrix representing the product of M1 and M2 which is written to the serverside. For more details see help for ds.matrixMult

    -
    -

    Details

    +
    +

    Details

    Undertakes standard matrix multiplication where with input matrices A and B with dimensions A: mxn and B: nxp the output C has dimensions mxp and each element C[i,j] has value equal to the dot product of row i of A and column j of B where the dot product is obtained as sum(A[i,1]*B[1,j] + A[i,2]*B[2,j] + .... + A[i,n]*B[n,j]). This calculation is only valid if the number of columns of A is the same as the number of rows of B

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixMultDS.md b/docs/reference/matrixMultDS.md new file mode 100644 index 00000000..e90d3421 --- /dev/null +++ b/docs/reference/matrixMultDS.md @@ -0,0 +1,43 @@ +# matrixMultDS serverside assign function called by ds.matrixMult + +Calculates the matrix product of two matrices and writes output to +serverside + +## Usage + +``` r +matrixMultDS(M1.name = NULL, M2.name = NULL) +``` + +## Arguments + +- M1.name: + + A character string specifying the name of the first matrix (M1) + argument specified by the M1 argument in the original call to + ds.matrixMult + +- M2.name: + + A character string specifying the name of the second matrix (M2) + argument specified by the M1 argument in the original call to + ds.matrixMult + +## Value + +Output is the matrix representing the product of M1 and M2 which is +written to the serverside. For more details see help for ds.matrixMult + +## Details + +Undertakes standard matrix multiplication where with input matrices A +and B with dimensions A: mxn and B: nxp the output C has dimensions mxp +and each element C\[i,j\] has value equal to the dot product of row i of +A and column j of B where the dot product is obtained as +sum(A\[i,1\]\*B\[1,j\] + A\[i,2\]\*B\[2,j\] + .... + +A\[i,n\]\*B\[n,j\]). This calculation is only valid if the number of +columns of A is the same as the number of rows of B + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/matrixTransposeDS.html b/docs/reference/matrixTransposeDS.html index fc9337f2..1fa0c16b 100644 --- a/docs/reference/matrixTransposeDS.html +++ b/docs/reference/matrixTransposeDS.html @@ -1,94 +1,83 @@ -matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS • dsBase - - -
    -
    -
    -
    -

    matrixTransposeDS serverside assign function called by ds.matrixTranspose

    + - + + + +
    +
    +
    +
    + +

    matrixTransposeDS serverside assign function called by ds.matrixTranspose

    + +
    matrixTransposeDS.Rd
    -
    +

    Transposes a matrix A and writes the output to the serverside

    -
    +
    +

    Usage

    matrixTransposeDS(M1.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    M1.name

    A character string specifying the name of the matrix to be transposed

    -
    -

    Value

    +
    +

    Value

    Output is the matrix representing the transpose of A which is written to the serverside. For more details see help for ds.matrixTranspose

    -
    -

    Details

    +
    +

    Details

    Undertakes standard matrix transposition. This operation converts matrix A to matrix C where element C[i,j] of matrix C equals element A[j,i] of matrix A. Matrix A therefore has the same number of rows as matrix C has columns and vice versa.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/matrixTransposeDS.md b/docs/reference/matrixTransposeDS.md new file mode 100644 index 00000000..de882f54 --- /dev/null +++ b/docs/reference/matrixTransposeDS.md @@ -0,0 +1,31 @@ +# matrixTransposeDS serverside assign function called by ds.matrixTranspose + +Transposes a matrix A and writes the output to the serverside + +## Usage + +``` r +matrixTransposeDS(M1.name = NULL) +``` + +## Arguments + +- M1.name: + + A character string specifying the name of the matrix to be transposed + +## Value + +Output is the matrix representing the transpose of A which is written to +the serverside. For more details see help for ds.matrixTranspose + +## Details + +Undertakes standard matrix transposition. This operation converts matrix +A to matrix C where element C\[i,j\] of matrix C equals element A\[j,i\] +of matrix A. Matrix A therefore has the same number of rows as matrix C +has columns and vice versa. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/mdPatternDS.html b/docs/reference/mdPatternDS.html new file mode 100644 index 00000000..ad8b14b6 --- /dev/null +++ b/docs/reference/mdPatternDS.html @@ -0,0 +1,118 @@ + +Missing data pattern with disclosure control — mdPatternDS • dsBase + Skip to contents + + +
    +
    +
    + +

    Missing data pattern with disclosure control

    + +
    mdPatternDS.Rd
    +
    + +
    +

    This function is a serverside aggregate function that computes the +missing data pattern using mice::md.pattern and applies disclosure control to +prevent revealing small cell counts.

    +
    + +
    +

    Usage

    + 
    mdPatternDS(x)
    +
    + +
    +

    Arguments

    + + +
    x
    +

    a character string specifying the name of a data frame or matrix +containing the data to analyze for missing patterns.

    + +
    +
    +

    Value

    +

    A list containing:

    +
    pattern
    +

    The missing data pattern matrix with disclosure control applied

    + +
    valid
    +

    Logical indicating if all patterns meet disclosure requirements

    + +
    message
    +

    A message describing the validity status

    + +
    +
    +

    Details

    +

    This function calls the mice::md.pattern function to generate a matrix +showing the missing data patterns in the input data. To ensure disclosure control, +any pattern counts that are below the threshold (nfilter.tab, default=3) are +suppressed.

    +

    Suppression Method:

    +

    When a pattern count is below threshold: +- Row name is changed to "suppressed(<N>)" where N is the threshold +- All pattern values in that row are set to NA +- Summary row is also set to NA (prevents back-calculation)

    +

    Output Matrix Structure:

    +

    - Rows represent different missing data patterns (plus a summary row at the bottom) +- Row names contain pattern counts (or "suppressed(<N>)" for invalid patterns) +- Columns show 1 if variable is observed, 0 if missing +- Last column shows total number of missing values per pattern +- Last row shows total number of missing values per variable

    +

    Note for Pooling:

    +

    When this function is called from ds.mdPattern with type='combine', suppressed +patterns are excluded from pooling to prevent disclosure through subtraction. +This means pooled counts may underestimate the true total when patterns are +suppressed in some studies.

    +
    +
    +

    Author

    +

    Xavier Escribà montagut for DataSHIELD Development Team

    +
    + +
    + + +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    + +
    +

    Site built with pkgdown 2.2.0.

    +
    + +
    + + + + + + + diff --git a/docs/reference/mdPatternDS.md b/docs/reference/mdPatternDS.md new file mode 100644 index 00000000..e5b4e0e9 --- /dev/null +++ b/docs/reference/mdPatternDS.md @@ -0,0 +1,67 @@ +# Missing data pattern with disclosure control + +This function is a serverside aggregate function that computes the +missing data pattern using mice::md.pattern and applies disclosure +control to prevent revealing small cell counts. + +## Usage + +``` r +mdPatternDS(x) +``` + +## Arguments + +- x: + + a character string specifying the name of a data frame or matrix + containing the data to analyze for missing patterns. + +## Value + +A list containing: + +- pattern: + + The missing data pattern matrix with disclosure control applied + +- valid: + + Logical indicating if all patterns meet disclosure requirements + +- message: + + A message describing the validity status + +## Details + +This function calls the mice::md.pattern function to generate a matrix +showing the missing data patterns in the input data. To ensure +disclosure control, any pattern counts that are below the threshold +(nfilter.tab, default=3) are suppressed. + +**Suppression Method:** + +When a pattern count is below threshold: - Row name is changed to +"suppressed(\)" where N is the threshold - All pattern values in +that row are set to NA - Summary row is also set to NA (prevents +back-calculation) + +**Output Matrix Structure:** + +\- Rows represent different missing data patterns (plus a summary row at +the bottom) - Row names contain pattern counts (or "suppressed(\)" +for invalid patterns) - Columns show 1 if variable is observed, 0 if +missing - Last column shows total number of missing values per pattern - +Last row shows total number of missing values per variable + +**Note for Pooling:** + +When this function is called from ds.mdPattern with type='combine', +suppressed patterns are excluded from pooling to prevent disclosure +through subtraction. This means pooled counts may underestimate the true +total when patterns are suppressed in some studies. + +## Author + +Xavier Escribà montagut for DataSHIELD Development Team diff --git a/docs/reference/meanDS.html b/docs/reference/meanDS.html index e8946d90..1e758d7f 100644 --- a/docs/reference/meanDS.html +++ b/docs/reference/meanDS.html @@ -1,91 +1,80 @@ -Computes statistical mean of a vector — meanDS • dsBase - - -
    -
    -
    -
    -

    Computes statistical mean of a vector

    + - + + + +
    +
    +
    +
    + +

    Computes statistical mean of a vector

    + +
    meanDS.Rd
    -
    +

    Calculates the mean value.

    -
    +
    +

    Usage

    meanDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a vector

    -
    -

    Value

    +
    +

    Value

    a numeric, the statistical mean

    -
    -

    Details

    +
    +

    Details

    if the length of input vector is less than the set filter a missing value is returned.

    -
    -

    Author

    +
    +

    Author

    Gaye A, Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/meanDS.md b/docs/reference/meanDS.md new file mode 100644 index 00000000..74b2758d --- /dev/null +++ b/docs/reference/meanDS.md @@ -0,0 +1,28 @@ +# Computes statistical mean of a vector + +Calculates the mean value. + +## Usage + +``` r +meanDS(xvect) +``` + +## Arguments + +- xvect: + + a vector + +## Value + +a numeric, the statistical mean + +## Details + +if the length of input vector is less than the set filter a missing +value is returned. + +## Author + +Gaye A, Burton PR diff --git a/docs/reference/meanSdGpDS.html b/docs/reference/meanSdGpDS.html index 44cf811b..f8fa87c6 100644 --- a/docs/reference/meanSdGpDS.html +++ b/docs/reference/meanSdGpDS.html @@ -1,54 +1,47 @@ -MeanSdGpDS — meanSdGpDS • dsBase - - -
    -
    -
    -
    -

    MeanSdGpDS

    + - + + + +
    +
    +
    +
    + +

    MeanSdGpDS

    + +
    meanSdGpDS.Rd
    -
    +

    Server-side function called by ds.meanSdGp

    -
    +
    +

    Usage

    meanSdGpDS(X, INDEX)
    -
    -

    Arguments

    +
    +

    Arguments

    X
    @@ -61,37 +54,33 @@

    Arguments

    which means/SDs are to be calculated

    -
    -

    Value

    +
    +

    Value

    List with results from the group statistics

    -
    -

    Details

    +
    +

    Details

    Computes the mean and standard deviation across groups defined by one factor

    -
    -

    Author

    +
    +

    Author

    Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/meanSdGpDS.md b/docs/reference/meanSdGpDS.md new file mode 100644 index 00000000..13622471 --- /dev/null +++ b/docs/reference/meanSdGpDS.md @@ -0,0 +1,34 @@ +# MeanSdGpDS + +Server-side function called by ds.meanSdGp + +## Usage + +``` r +meanSdGpDS(X, INDEX) +``` + +## Arguments + +- X: + + a client-side supplied character string identifying the variable for + which means/SDs are to be calculated + +- INDEX: + + a client-side supplied character string identifying the factor across + which means/SDs are to be calculated + +## Value + +List with results from the group statistics + +## Details + +Computes the mean and standard deviation across groups defined by one +factor + +## Author + +Burton PR diff --git a/docs/reference/mergeDS.html b/docs/reference/mergeDS.html index 5cbb47cc..01bccb38 100644 --- a/docs/reference/mergeDS.html +++ b/docs/reference/mergeDS.html @@ -1,51 +1,45 @@ -mergeDS (assign function) called by ds.merge — mergeDS • dsBase - - -
    -
    -
    -
    -

    mergeDS (assign function) called by ds.merge

    + - + + + +
    +
    +
    +
    + +

    mergeDS (assign function) called by ds.merge

    + +
    mergeDS.Rd
    -
    +

    merges (links) two data.frames together based on common values in defined vectors in each data.frame

    -
    +
    +

    Usage

    mergeDS(
   x.name,
   y.name,
@@ -60,8 +54,8 @@ 
    mergeDS (assign function) called by ds.merge
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    x.name,
    @@ -127,8 +121,8 @@

    Arguments

    ds.merge

    -
    -

    Value

    +
    +

    Value

    the merged data.frame specified by the <newobj> argument of ds.merge (or by default 'x.name_y.name' if the <newobj> argument is NULL) which is written to the serverside. In addition, @@ -144,33 +138,29 @@

    Value

    without problems no studysideMessage will have been saved and ds.message(<newobj>) will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    For further information see details of the native R function merge and the DataSHIELD clientside function ds.merge.

    -
    -

    Author

    +
    +

    Author

    Paul Burton, Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/mergeDS.md b/docs/reference/mergeDS.md new file mode 100644 index 00000000..08b9b330 --- /dev/null +++ b/docs/reference/mergeDS.md @@ -0,0 +1,114 @@ +# mergeDS (assign function) called by ds.merge + +merges (links) two data.frames together based on common values in +defined vectors in each data.frame + +## Usage + +``` r +mergeDS( + x.name, + y.name, + by.x.names.transmit, + by.y.names.transmit, + all.x, + all.y, + sort, + suffixes.transmit, + no.dups, + incomparables +) +``` + +## Arguments + +- x.name, : + + the name of the first data.frame to be merged specified in inverted + commas. Specified via argument \ of `ds.merge` function + +- y.name, : + + the name of the second data.frame to be merged specified in inverted + commas. Specified via argument \ of `ds.merge` function + +- by.x.names.transmit: + + the name of a single variable or a vector of names of multiple + variables (in transmittable form) containing the IDs or other data on + which data.frame x is to be merged/linked to data.frame y. Specified + via argument \ of `ds.merge` function + +- by.y.names.transmit: + + the name of a single variable or a vector of names of multiple + variables (in transmittable form) containing the IDs or other data on + which data.frame y is to be merged/linked to data.frame x. Specified + via argument \ of `ds.merge` function + +- all.x: + + logical, if TRUE, then extra rows will be added to the output, one for + each row in x that has no matching row in y. Specified via argument + \ of `ds.merge` function. Default = FALSE. + +- all.y: + + logical, if TRUE, then extra rows will be added to the output, one for + each row in y that has no matching row in x. Specified via argument + \ of `ds.merge` function. Default = FALSE. + +- sort: + + logical, if TRUE the merged result should be sorted on elements in the + by.x.names and by.y.names columns. Specified via argument \ of + `ds.merge` function. Default = TRUE. + +- suffixes.transmit: + + a character vector of length 2 (in transmittable form) specifying the + suffixes to be used for making unique common column names in the two + input data.frames when they both appear in the merged data.frame. + Specified via argument \ of `ds.merge` function. Default + '.x' and '.y'. + +- no.dups: + + logical, when TRUE suffixes are appended in more cases to rigorously + avoid duplicated column names in the merged data.frame. Specified via + argument \ of `ds.merge` function. Default TRUE but was + apparently implicitly FALSE before R version 3.5.0. + +- incomparables, : + + values intended for merging on one column which cannot be matched. See + 'match' in help for Native R `merge` function. Specified via argument + \ of `ds.merge` + +## Value + +the merged data.frame specified by the \ argument of ds.merge +(or by default 'x.name_y.name' if the \ argument is NULL) which +is written to the serverside. In addition, two validity messages are +returned to the clientside indicating whether \ has been +created in each data source and if so whether it is in a valid form. If +its form is not valid in at least one study there may be a +studysideMessage that can explain the error in creating the full output +object. As well as appearing on the screen at run time,if you wish to +see the relevant studysideMessages at a later date you can use the +`ds.message` function. If you type ds.message(\) it will print +out the relevant studysideMessage from any datasource in which there was +an error in creating \ and a studysideMessage was saved. If +there was no error and \ was created without problems no +studysideMessage will have been saved and ds.message(\) will +return the message: "ALL OK: there are no studysideMessage(s) on this +datasource". + +## Details + +For further information see details of the native R function `merge` and +the DataSHIELD clientside function `ds.merge`. + +## Author + +Paul Burton, Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/messageDS.html b/docs/reference/messageDS.html index 5a984889..f8904b6d 100644 --- a/docs/reference/messageDS.html +++ b/docs/reference/messageDS.html @@ -1,56 +1,50 @@ -messageDS — messageDS • dsBase - - -
    -
    -
    -
    -

    messageDS

    + - + + + +
    +
    +
    +
    + +

    messageDS

    + +
    messageDS.Rd
    -
    +

    This function allows for error messages arising from the running of a server-side assign function to be returned to the client-side

    -
    +
    +

    Usage

    messageDS(message.object.name)
    -
    -

    Arguments

    +
    +

    Arguments

    message.object.name
    @@ -58,13 +52,13 @@

    Arguments

    message. See the header of the client-side function ds.message for more details.

    -
    -

    Value

    +
    +

    Value

    a list object from each study, containing whatever message has been written by DataSHIELD into $studysideMessage.

    -
    -

    Details

    +
    +

    Details

    Errors arising from aggregate server-side functions can be returned directly to the client-side. But this is not possible for server-side assign functions because they are designed specifically to write objects to the @@ -81,28 +75,24 @@

    Details

    $studysideMessage is a string that cannot exceed a length of nfilter.string a default of 80 characters.

    -
    -

    Author

    +
    +

    Author

    Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/messageDS.md b/docs/reference/messageDS.md new file mode 100644 index 00000000..d0580a9f --- /dev/null +++ b/docs/reference/messageDS.md @@ -0,0 +1,46 @@ +# messageDS + +This function allows for error messages arising from the running of a +server-side assign function to be returned to the client-side + +## Usage + +``` r +messageDS(message.object.name) +``` + +## Arguments + +- message.object.name: + + is a character string, containing the name of the list containing the + message. See the header of the client-side function ds.message for + more details. + +## Value + +a list object from each study, containing whatever message has been +written by DataSHIELD into \$studysideMessage. + +## Details + +Errors arising from aggregate server-side functions can be returned +directly to the client-side. But this is not possible for server-side +assign functions because they are designed specifically to write objects +to the server-side and to return no meaningful information to the +client-side. Otherwise, users may be able to use assign functions to +return disclosive output to the client-side. ds.message calls messageDS +which looks specifically for an object called \$serversideMessage in a +designated list on the server-side. Server-side functions from which +error messages are to be made available, are designed to be able to +write the designated error message to the \$serversideMessage object +into the list that is saved on the server-side as the primary output of +that function. So only valid server-side functions of DataSHIELD can +write a \$studysideMessage, and as additional protection against +unexpected ways that someone may try to get round this limitation, a +\$studysideMessage is a string that cannot exceed a length of +nfilter.string a default of 80 characters. + +## Author + +Burton PR diff --git a/docs/reference/metadataDS.html b/docs/reference/metadataDS.html index 6aed51c2..6c2b4036 100644 --- a/docs/reference/metadataDS.html +++ b/docs/reference/metadataDS.html @@ -1,91 +1,80 @@ -Returns the metadata, if any, about the specified variable — metadataDS • dsBase - - -
    -
    -
    -
    -

    Returns the metadata, if any, about the specified variable

    + - + + + +
    +
    +
    +
    + +

    Returns the metadata, if any, about the specified variable

    + +
    metadataDS.Rd
    -
    +

    This function returns metadata, if any, about specified variable.

    -
    +
    +

    Usage

    metadataDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, containing the name of the specified variable

    -
    -

    Value

    +
    +

    Value

    a list containing the metadata. The elements of the list will depend on the metadata available.

    -
    -

    Details

    +
    +

    Details

    The function returns the metadata, obtained from attributes function.

    -
    -

    Author

    +
    +

    Author

    Stuart Wheater, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/metadataDS.md b/docs/reference/metadataDS.md new file mode 100644 index 00000000..3335c512 --- /dev/null +++ b/docs/reference/metadataDS.md @@ -0,0 +1,28 @@ +# Returns the metadata, if any, about the specified variable + +This function returns metadata, if any, about specified variable. + +## Usage + +``` r +metadataDS(x) +``` + +## Arguments + +- x: + + a string character, containing the name of the specified variable + +## Value + +a list containing the metadata. The elements of the list will depend on +the metadata available. + +## Details + +The function returns the metadata, obtained from attributes function. + +## Author + +Stuart Wheater, for DataSHIELD Development Team diff --git a/docs/reference/miceDS.html b/docs/reference/miceDS.html index 9457e5a8..352df48a 100644 --- a/docs/reference/miceDS.html +++ b/docs/reference/miceDS.html @@ -1,51 +1,49 @@ -Aggregate function called by ds.mice — miceDS • dsBaseAggregate function called by ds.mice — miceDS • dsBase - - -
    -
    -
    -
    -

    Aggregate function called by ds.mice

    + - + + + +
    +
    +
    +
    + +

    Aggregate function called by ds.mice

    + +
    miceDS.Rd
    -
    +

    This function is a wrapper function of the mice from the mice R package. The function creates multiple imputations (replacement values) for multivariate missing data. The method is based on Fully Conditional Specification, @@ -55,7 +53,8 @@

    Aggregate function called by ds.mice

    imputations by means of passive imputation.

    -
    +
    +

    Usage

    miceDS(
   data = data,
   m = m,
@@ -70,8 +69,8 @@ 
    Aggregate function called by ds.mice
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    data
    @@ -134,39 +133,35 @@

    Arguments

    imputationSet.1, imputationSet.2, imputationSet.3, imputationSet.4, imputationSet.5.

    -
    -

    Value

    +
    +

    Value

    a list with three elements: the method, the predictorMatrix and the post. The function also saves in each server the mids object and all completed datasets as dataframes.

    -
    -

    Details

    +
    +

    Details

    For additional details see the help header of mice function in native R mice package.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/miceDS.md b/docs/reference/miceDS.md new file mode 100644 index 00000000..6d72d566 --- /dev/null +++ b/docs/reference/miceDS.md @@ -0,0 +1,108 @@ +# Aggregate function called by ds.mice + +This function is a wrapper function of the mice from the mice R package. +The function creates multiple imputations (replacement values) for +multivariate missing data. The method is based on Fully Conditional +Specification, where each incomplete variable is imputed by a separate +model. The MICE algorithm can impute mixes of continuous, binary, +unordered categorical and ordered categorical data. In addition, MICE +can impute continuous two-level data, and maintain consistency between +imputations by means of passive imputation. + +## Usage + +``` r +miceDS( + data = data, + m = m, + maxit = maxit, + method = method, + post = post, + seed = seed, + predictorMatrix = predictorMatrix, + ncol.pred.mat = ncol.pred.mat, + newobj_mids = newobj_mids, + newobj_df = newobj_df +) +``` + +## Arguments + +- data: + + a data frame or a matrix containing the incomplete data. + +- m: + + Number of multiple imputations. The default is m=5. The maximum + allowed number in DataSHIELD is m=20. + +- maxit: + + A scalar giving the number of iterations. The default is 5. The + maximum allowed number in DataSHIELD is maxit=30. + +- method: + + Can be either a single string, or a vector of strings with length + ncol(data), specifying the imputation method to be used for each + column in data. If specified as a single string, the same method will + be used for all blocks. The default imputation method (when no + argument is specified) depends on the measurement level of the target + column, as regulated by the defaultMethod argument in native R mice + function. Columns that need not be imputed have the empty method "". + +- post: + + A vector of strings with length ncol(data) specifying expressions as + strings. Each string is parsed and executed within the sampler() + function to post-process imputed values during the iterations. The + default is a vector of empty strings, indicating no post-processing. + Multivariate (block) imputation methods ignore the post parameter. + +- seed: + + either NA (default) or "fixed". If seed is set to "fixed" then a fixed + seed random number generator which is study-specific is used. + +- predictorMatrix: + + A numeric matrix of ncol(data) rows and ncol(data) columns, containing + 0/1 data specifying the set of predictors to be used for each target + column. Each row corresponds to a variable to be imputed. A value of 1 + means that the column variable is used as a predictor for the target + variables (in the rows). By default, the predictorMatrix is a square + matrix of ncol(data) rows and columns with all 1's, except for the + diagonal. + +- ncol.pred.mat: + + the number of columns of the predictorMatrix. + +- newobj_mids: + + a character string that provides the name for the output mids object + that is stored on the data servers. Default `mids_object`. + +- newobj_df: + + a character string that provides the name for the output dataframes + that are stored on the data servers. Default `imputationSet`. For + example, if m=5, and newobj_df="imputationSet", then five imputed + dataframes are saved on the servers with names imputationSet.1, + imputationSet.2, imputationSet.3, imputationSet.4, imputationSet.5. + +## Value + +a list with three elements: the method, the predictorMatrix and the +post. The function also saves in each server the mids object and all +completed datasets as dataframes. + +## Details + +For additional details see the help header of mice function in native R +mice package. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/minMaxRandDS.html b/docs/reference/minMaxRandDS.html index 779d22cb..81a8e983 100644 --- a/docs/reference/minMaxRandDS.html +++ b/docs/reference/minMaxRandDS.html @@ -1,58 +1,53 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — minMaxRandDS • dsBaseSecure ranking of "V2BR" (vector to be ranked) across all sources — minMaxRandDS • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    - +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    minMaxRandDS.Rd
    -
    +

    Creates a minimum value that is more negative, and less positive than any real value in V2BR and a maximum value that is more positive and less negative than any value of V2BR.

    -
    +
    +

    Usage

    minMaxRandDS(input.var.name)
    -
    -

    Arguments

    +
    +

    Arguments

    input.var.name
    @@ -61,14 +56,14 @@

    Arguments

    ds.ranksSecure

    -
    -

    Value

    +
    +

    Value

    the data frame objects containing the global ranks and quantiles. For more details see the associated document entitled "secure.global.ranking.docx"

    -
    -

    Details

    +
    +

    Details

    Severside aggregate function called by ds.ranksSecure. The minimum and maximum values it creates are used to replace missing values (NAs) in V2BR if the argument <NA.manag>e is set to "NA.low" or "NA.hi" @@ -77,28 +72,24 @@

    Details

    see the associated document entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/minMaxRandDS.md b/docs/reference/minMaxRandDS.md new file mode 100644 index 00000000..d937070b --- /dev/null +++ b/docs/reference/minMaxRandDS.md @@ -0,0 +1,40 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +Creates a minimum value that is more negative, and less positive than +any real value in V2BR and a maximum value that is more positive and +less negative than any value of V2BR. + +## Usage + +``` r +minMaxRandDS(input.var.name) +``` + +## Arguments + +- input.var.name: + + a character string specifying the name of V2BR. This argument is set + by the argument with the same name in the clientside function + ds.ranksSecure + +## Value + +the data frame objects containing the global ranks and quantiles. For +more details see the associated document entitled +"secure.global.ranking.docx" + +## Details + +Severside aggregate function called by ds.ranksSecure. The minimum and +maximum values it creates are used to replace missing values (NAs) in +V2BR if the argument \e is set to "NA.low" or "NA.hi" +respectively. For more details about the cluster of functions that +collectively enable secure global ranking and estimation of global +quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/namesDS.html b/docs/reference/namesDS.html index 4ce7acd5..fc6d2abd 100644 --- a/docs/reference/namesDS.html +++ b/docs/reference/namesDS.html @@ -1,67 +1,60 @@ -Return the names of a list object — namesDS • dsBase - - -
    -
    -
    -
    -

    Return the names of a list object

    + - + + + +
    +
    +
    +
    + +

    Return the names of a list object

    + +
    namesDS.Rd
    -
    +

    Returns the names of a designated server-side list

    -
    +
    +

    Usage

    namesDS(xname.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    xname.transmit

    a character string specifying the name of the list.

    -
    -

    Value

    +
    +

    Value

    namesDS returns to the client-side the names of a list object stored on the server-side.

    -
    -

    Details

    +
    +

    Details

    namesDS is an aggregate function called by ds.names. This function is similar to the native R function names but it does not subsume all functionality, @@ -74,28 +67,24 @@

    Details

    using ds.glmSLMA. The resultant object saved on each separate server is formally of double class "glm" and "ls" but responds TRUE to is.list(),

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, updated by Paul Burton 25/06/2020

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/namesDS.md b/docs/reference/namesDS.md new file mode 100644 index 00000000..83f84324 --- /dev/null +++ b/docs/reference/namesDS.md @@ -0,0 +1,37 @@ +# Return the names of a list object + +Returns the names of a designated server-side list + +## Usage + +``` r +namesDS(xname.transmit) +``` + +## Arguments + +- xname.transmit: + + a character string specifying the name of the list. + +## Value + +`namesDS` returns to the client-side the names of a list object stored +on the server-side. + +## Details + +namesDS is an aggregate function called by ds.names. This function is +similar to the native R function `names` but it does not subsume all +functionality, for example, it only works to extract names that already +exist, not to create new names for objects. The function is restricted +to objects of type list, but this includes objects that have a primary +class other than list but which return TRUE to the native R function +`is.list`. As an example, this includes the multi-component object +created by fitting a generalized linear model using ds.glmSLMA. The +resultant object saved on each separate server is formally of double +class "glm" and "ls" but responds TRUE to is.list(), + +## Author + +Amadou Gaye, updated by Paul Burton 25/06/2020 diff --git a/docs/reference/nsDS.html b/docs/reference/nsDS.html index 03822097..591cce7c 100644 --- a/docs/reference/nsDS.html +++ b/docs/reference/nsDS.html @@ -1,58 +1,53 @@ -Generate a Basis Matrix for Natural Cubic Splines — nsDS • dsBaseGenerate a Basis Matrix for Natural Cubic Splines — nsDS • dsBase - - -
    -
    -
    -
    -

    Generate a Basis Matrix for Natural Cubic Splines

    - +
    +
    +
    +
    + +

    Generate a Basis Matrix for Natural Cubic Splines

    + +
    nsDS.Rd
    -
    +

    This function is based on the native R function ns from the splines package. This function generate the B-spline basis matrix for a natural cubic spline.

    -
    +
    +

    Usage

    nsDS(x, df, knots, intercept, Boundary.knots)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -81,15 +76,15 @@

    Arguments

    are supplied, the basis parameters do not depend on x. Data can extend beyond Boundary.knots

    -
    -

    Value

    +
    +

    Value

    A matrix of dimension length(x) * df where either df was supplied or if knots were supplied, df = length(knots) + 1 + intercept. Attributes are returned that correspond to the arguments to ns, and explicitly give the knots, Boundary.knots etc for use by predict.ns(). The object is assigned at each serverside.

    -
    -

    Details

    +
    +

    Details

    ns is native R is based on the function splineDesign. It generates a basis matrix for representing the family of piecewise-cubic splines with the specified sequence of interior knots, and the natural boundary conditions. These enforce the constraint @@ -97,28 +92,24 @@

    Details

    to the extremes of the data. A primary use is in modeling formula to directly specify a natural spline term in a model.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/nsDS.md b/docs/reference/nsDS.md new file mode 100644 index 00000000..de0312ed --- /dev/null +++ b/docs/reference/nsDS.md @@ -0,0 +1,64 @@ +# Generate a Basis Matrix for Natural Cubic Splines + +This function is based on the native R function `ns` from the `splines` +package. This function generate the B-spline basis matrix for a natural +cubic spline. + +## Usage + +``` r +nsDS(x, df, knots, intercept, Boundary.knots) +``` + +## Arguments + +- x: + + the predictor variable. Missing values are allowed. + +- df: + + degrees of freedom. One can supply df rather than knots; ns() then + chooses df - 1 - intercept knots at suitably chosen quantiles of x + (which will ignore missing values). The default, df = NULL, sets the + number of inner knots as length(knots). + +- knots: + + breakpoints that define the spline. The default is no knots; together + with the natural boundary conditions this results in a basis for + linear regression on x. Typical values are the mean or median for one + knot, quantiles for more knots. See also Boundary.knots. + +- intercept: + + if TRUE, an intercept is included in the basis; default is FALSE. + +- Boundary.knots: + + boundary points at which to impose the natural boundary conditions and + anchor the B-spline basis (default the range of the data). If both + knots and Boundary.knots are supplied, the basis parameters do not + depend on x. Data can extend beyond Boundary.knots + +## Value + +A matrix of dimension length(x) \* df where either df was supplied or if +knots were supplied, df = length(knots) + 1 + intercept. Attributes are +returned that correspond to the arguments to ns, and explicitly give the +knots, Boundary.knots etc for use by predict.ns(). The object is +assigned at each serverside. + +## Details + +`ns` is native R is based on the function `splineDesign`. It generates a +basis matrix for representing the family of piecewise-cubic splines with +the specified sequence of interior knots, and the natural boundary +conditions. These enforce the constraint that the function is linear +beyond the boundary knots, which can either be supplied or default to +the extremes of the data. A primary use is in modeling formula to +directly specify a natural spline term in a model. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/numNaDS.html b/docs/reference/numNaDS.html index 1431c27e..914a96d1 100644 --- a/docs/reference/numNaDS.html +++ b/docs/reference/numNaDS.html @@ -1,88 +1,78 @@ -Counts the number of missing values — numNaDS • dsBase - - -
    -
    -
    -
    -

    Counts the number of missing values

    + - + + + +
    +
    +
    +
    + +

    Counts the number of missing values

    + +
    numNaDS.Rd
    -
    +

    this function just counts the number of missing entries in a vector.

    -
    +
    +

    Usage

    numNaDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a vector

    -
    -

    Value

    +
    +

    Value

    an integer, the number of missing values

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/numNaDS.md b/docs/reference/numNaDS.md new file mode 100644 index 00000000..8fbb3bba --- /dev/null +++ b/docs/reference/numNaDS.md @@ -0,0 +1,23 @@ +# Counts the number of missing values + +this function just counts the number of missing entries in a vector. + +## Usage + +``` r +numNaDS(xvect) +``` + +## Arguments + +- xvect: + + a vector + +## Value + +an integer, the number of missing values + +## Author + +Gaye, A. diff --git a/docs/reference/qlsplineDS.html b/docs/reference/qlsplineDS.html index 231fcb89..49ff0fdc 100644 --- a/docs/reference/qlsplineDS.html +++ b/docs/reference/qlsplineDS.html @@ -1,60 +1,56 @@ -Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS • dsBaseBasis for a piecewise linear spline with meaningful coefficients — qlsplineDS • dsBase - - -
    -
    -
    -
    -

    Basis for a piecewise linear spline with meaningful coefficients

    - +
    +
    +
    +
    + +

    Basis for a piecewise linear spline with meaningful coefficients

    + +
    qlsplineDS.Rd
    -
    +

    This function is based on the native R function qlspline from the lspline package. This function computes the basis of piecewise-linear spline such that, depending on the argument marginal, the coefficients can be interpreted as (1) slopes of consecutive spline segments, or (2) slope change at consecutive knots.

    -
    +
    +

    Usage

    qlsplineDS(x = x, q = q, na.rm = TRUE, marginal = FALSE, names = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -79,13 +75,13 @@

    Arguments

    character, vector of names for constructed variables

    -
    -

    Value

    +
    +

    Value

    an object of class "lspline" and "matrix", which its name is specified by the newobj argument (or its default name "qlspline.newobj"), is assigned on the serverside.

    -
    -

    Details

    +
    +

    Details

    If marginal is FALSE (default) the coefficients of the spline correspond to slopes of the consecutive segments. If it is TRUE the first coefficient correspond to the slope of the first segment. The consecutive coefficients correspond to the change @@ -96,28 +92,24 @@

    Details

    of x. Alternatively, q can be a vector of values in [0; 1] specifying the quantile probabilities directly (the vector is passed to argument probs of quantile).

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/qlsplineDS.md b/docs/reference/qlsplineDS.md new file mode 100644 index 00000000..20dd6f3f --- /dev/null +++ b/docs/reference/qlsplineDS.md @@ -0,0 +1,62 @@ +# Basis for a piecewise linear spline with meaningful coefficients + +This function is based on the native R function `qlspline` from the +`lspline` package. This function computes the basis of piecewise-linear +spline such that, depending on the argument marginal, the coefficients +can be interpreted as (1) slopes of consecutive spline segments, or (2) +slope change at consecutive knots. + +## Usage + +``` r +qlsplineDS(x = x, q = q, na.rm = TRUE, marginal = FALSE, names = NULL) +``` + +## Arguments + +- x: + + the name of the input numeric variable + +- q: + + numeric, a single scalar greater or equal to 2 for a number of + equal-frequency intervals along x or a vector of numbers in (0; 1) + specifying the quantiles explicitly. + +- na.rm: + + logical, whether NA should be removed when calculating quantiles, + passed to na.rm of quantile. Default set to TRUE. + +- marginal: + + logical, how to parametrize the spline, see Details + +- names: + + character, vector of names for constructed variables + +## Value + +an object of class "lspline" and "matrix", which its name is specified +by the `newobj` argument (or its default name "qlspline.newobj"), is +assigned on the serverside. + +## Details + +If marginal is FALSE (default) the coefficients of the spline correspond +to slopes of the consecutive segments. If it is TRUE the first +coefficient correspond to the slope of the first segment. The +consecutive coefficients correspond to the change in slope as compared +to the previous segment. Function qlspline wraps lspline and calculates +the knot positions to be at quantiles of x. If q is a numerical scalar +greater or equal to 2, the quantiles are computed at seq(0, 1, +length.out = q + 1)\[-c(1, q+1)\], i.e. knots are at q-tiles of the +distribution of x. Alternatively, q can be a vector of values in \[0; +1\] specifying the quantile probabilities directly (the vector is passed +to argument probs of quantile). + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/quantileMeanDS.html b/docs/reference/quantileMeanDS.html index ca7bbf2c..c299d055 100644 --- a/docs/reference/quantileMeanDS.html +++ b/docs/reference/quantileMeanDS.html @@ -1,88 +1,78 @@ -Generates quantiles and mean information without maximum and minimum — quantileMeanDS • dsBase - - -
    -
    -
    -
    -

    Generates quantiles and mean information without maximum and minimum

    + - + + + +
    +
    +
    +
    + +

    Generates quantiles and mean information without maximum and minimum

    + +
    quantileMeanDS.Rd
    -
    +

    the probabilities 5 are used to compute the corresponding quantiles.

    -
    +
    +

    Usage

    quantileMeanDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a numerical vector

    -
    -

    Value

    +
    +

    Value

    a numeric vector that represents the sample quantiles

    -
    -

    Author

    +
    +

    Author

    Burton, P.; Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/quantileMeanDS.md b/docs/reference/quantileMeanDS.md new file mode 100644 index 00000000..4414ad7c --- /dev/null +++ b/docs/reference/quantileMeanDS.md @@ -0,0 +1,23 @@ +# Generates quantiles and mean information without maximum and minimum + +the probabilities 5 are used to compute the corresponding quantiles. + +## Usage + +``` r +quantileMeanDS(xvect) +``` + +## Arguments + +- xvect: + + a numerical vector + +## Value + +a numeric vector that represents the sample quantiles + +## Author + +Burton, P.; Gaye, A. diff --git a/docs/reference/rBinomDS.html b/docs/reference/rBinomDS.html index 1e494c8c..606b19d2 100644 --- a/docs/reference/rBinomDS.html +++ b/docs/reference/rBinomDS.html @@ -1,54 +1,47 @@ -rBinomDS serverside assign function — rBinomDS • dsBase - - -
    -
    -
    -
    -

    rBinomDS serverside assign function

    + - + + + +
    +
    +
    +
    + +

    rBinomDS serverside assign function

    + +
    rBinomDS.Rd
    -
    +

    primary serverside assign function called by ds.rBinom

    -
    +
    +

    Usage

    rBinomDS(n, size = 1, prob = 0.5)
    -
    -

    Arguments

    +
    +

    Arguments

    n
    @@ -71,8 +64,8 @@

    Arguments

    observation to observation.

    -
    -

    Value

    +
    +

    Value

    Writes the pseudorandom number vector with the characteristics specified in the function call as a new serverside vector on the data source on which it has been called. Also returns key information to the clientside: @@ -82,35 +75,31 @@

    Value

    also returns a vector reporting the length of the pseudorandom vector created in each source.

    -
    -

    Details

    +
    +

    Details

    Generates the vector of pseudorandom numbers from a binomial distribution in each data source as specified by the arguments of ds.rBinom. This serverside function is effectively the same as the function rbinom() in native R and its arguments are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rBinomDS.md b/docs/reference/rBinomDS.md new file mode 100644 index 00000000..27d8961e --- /dev/null +++ b/docs/reference/rBinomDS.md @@ -0,0 +1,53 @@ +# rBinomDS serverside assign function + +primary serverside assign function called by ds.rBinom + +## Usage + +``` r +rBinomDS(n, size = 1, prob = 0.5) +``` + +## Arguments + +- n: + + length of the pseudorandom number vector to be generated as specified + by the argument \ in the function ds.rBinom + +- size: + + a scalar that must be a positive integer. Value set directly by + \ argument of ds.rBinom - for details see help for ds.rBinom. + May be a scalar or a vector allowing the size to vary from observation + to observation. + +- prob: + + a numeric scalar in range 0 \> prob \> 1 which specifies the + probability of a positive response. Value set directly by \ + argument of ds.rBinom - for details see help for ds.rBinom May be a + scalar or a vector allowing the size to vary from observation to + observation. + +## Value + +Writes the pseudorandom number vector with the characteristics specified +in the function call as a new serverside vector on the data source on +which it has been called. Also returns key information to the +clientside: the random seed as specified by you in each source + (if +requested) the full 626 length random seed vector this generated in each +source (see info for the argument \). It also +returns a vector reporting the length of the pseudorandom vector created +in each source. + +## Details + +Generates the vector of pseudorandom numbers from a binomial +distribution in each data source as specified by the arguments of +ds.rBinom. This serverside function is effectively the same as the +function rbinom() in native R and its arguments are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/rNormDS.html b/docs/reference/rNormDS.html index 7720f286..3145c743 100644 --- a/docs/reference/rNormDS.html +++ b/docs/reference/rNormDS.html @@ -1,54 +1,47 @@ -rNormDS serverside assign function — rNormDS • dsBase - - -
    -
    -
    -
    -

    rNormDS serverside assign function

    + - + + + +
    +
    +
    +
    + +

    rNormDS serverside assign function

    + +
    rNormDS.Rd
    -
    +

    primary serverside assign function called by ds.rNorm

    -
    +
    +

    Usage

    rNormDS(n, mean = 0, sd = 1, force.output.to.k.decimal.places = 9)
    -
    -

    Arguments

    +
    +

    Arguments

    n
    @@ -79,8 +72,8 @@

    Arguments

    in ds.rNorm

    -
    -

    Value

    +
    +

    Value

    Writes the pseudorandom number vector with the characteristics specified in the function call as a new serverside vector on the data source on which it has been called. Also returns key information to the clientside: @@ -90,35 +83,31 @@

    Value

    also returns a vector reporting the length of the pseudorandom vector created in each source.

    -
    -

    Details

    +
    +

    Details

    Generates the vector of pseudorandom numbers from a normal distribution in each data source as specified by the arguments of ds.rNorm. This serverside function is effectively the same as the function rnorm() in native R and its arguments are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rNormDS.md b/docs/reference/rNormDS.md new file mode 100644 index 00000000..690e0437 --- /dev/null +++ b/docs/reference/rNormDS.md @@ -0,0 +1,60 @@ +# rNormDS serverside assign function + +primary serverside assign function called by ds.rNorm + +## Usage + +``` r +rNormDS(n, mean = 0, sd = 1, force.output.to.k.decimal.places = 9) +``` + +## Arguments + +- n: + + length of the pseudorandom number vector to be generated as specified + by the argument \ in the function ds.rNorm + +- mean: + + this specifies the mean of the pseudorandom number vector to be + generated as specified by the argument \ in the function + ds.rNorm. May be a scalar or a vector allowing the mean to vary from + observation to observation. + +- sd: + + this specifies the standard deviation of the pseudorandom number + vector to be generated as specified by the argument \ in the + function ds.rNorm May be a scalar or a vector allowing the sd to vary + from observation to observation. + +- force.output.to.k.decimal.places: + + scalar integer. Forces the output random number vector to have k + decimal places. If 0 rounds it coerces decimal random number output to + integer, a k in range 1-8 forces output to have k decimal places. If k + = 9, no rounding occurs of native output. Default=9. Value specified + by \ argument in ds.rNorm + +## Value + +Writes the pseudorandom number vector with the characteristics specified +in the function call as a new serverside vector on the data source on +which it has been called. Also returns key information to the +clientside: the random seed as specified by you in each source + (if +requested) the full 626 length random seed vector this generated in each +source (see info for the argument \). It also +returns a vector reporting the length of the pseudorandom vector created +in each source. + +## Details + +Generates the vector of pseudorandom numbers from a normal distribution +in each data source as specified by the arguments of ds.rNorm. This +serverside function is effectively the same as the function rnorm() in +native R and its arguments are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/rPoisDS.html b/docs/reference/rPoisDS.html index c560901e..474e0105 100644 --- a/docs/reference/rPoisDS.html +++ b/docs/reference/rPoisDS.html @@ -1,54 +1,47 @@ -rPoisDS serverside assign function — rPoisDS • dsBase - - -
    -
    -
    -
    -

    rPoisDS serverside assign function

    + - + + + +
    +
    +
    +
    + +

    rPoisDS serverside assign function

    + +
    rPoisDS.Rd
    -
    +

    primary serverside assign function called by ds.rPois

    -
    +
    +

    Usage

    rPoisDS(n, lambda = 1)
    -
    -

    Arguments

    +
    +

    Arguments

    n
    @@ -63,8 +56,8 @@

    Arguments

    to vary from observation to observation.

    -
    -

    Value

    +
    +

    Value

    Writes the pseudorandom number vector with the characteristics specified in the function call as a new serverside vector on the data source on which it has been called. Also returns key information to the clientside: @@ -74,36 +67,32 @@

    Value

    also returns a vector reporting the length of the pseudorandom vector created in each source.

    -
    -

    Details

    +
    +

    Details

    Generates the vector of pseudorandom numbers (non-negative integers) from a Poisson distribution in each data source as specified by the arguments of ds.rPois. This serverside function is effectively the same as the function rpois() in native R and its arguments are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rPoisDS.md b/docs/reference/rPoisDS.md new file mode 100644 index 00000000..60c04857 --- /dev/null +++ b/docs/reference/rPoisDS.md @@ -0,0 +1,45 @@ +# rPoisDS serverside assign function + +primary serverside assign function called by ds.rPois + +## Usage + +``` r +rPoisDS(n, lambda = 1) +``` + +## Arguments + +- n: + + length of the pseudorandom number vector to be generated as specified + by the argument \ in the function ds.rPois + +- lambda: + + a numeric scalar specifying the expected count of the Poisson + distribution used to generate the random counts. Specified directly by + the lambda argument in ds.rPois. May be a scalar or a vector allowing + lambda to vary from observation to observation. + +## Value + +Writes the pseudorandom number vector with the characteristics specified +in the function call as a new serverside vector on the data source on +which it has been called. Also returns key information to the +clientside: the random seed as specified by you in each source + (if +requested) the full 626 length random seed vector this generated in each +source (see info for the argument \). It also +returns a vector reporting the length of the pseudorandom vector created +in each source. + +## Details + +Generates the vector of pseudorandom numbers (non-negative integers) +from a Poisson distribution in each data source as specified by the +arguments of ds.rPois. This serverside function is effectively the same +as the function rpois() in native R and its arguments are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/rUnifDS.html b/docs/reference/rUnifDS.html index 7af321e6..f4392430 100644 --- a/docs/reference/rUnifDS.html +++ b/docs/reference/rUnifDS.html @@ -1,54 +1,47 @@ -rUnifDS serverside assign function — rUnifDS • dsBase - - -
    -
    -
    -
    -

    rUnifDS serverside assign function

    + - + + + +
    +
    +
    +
    + +

    rUnifDS serverside assign function

    + +
    rUnifDS.Rd
    -
    +

    primary serverside assign function called by ds.rUnif

    -
    +
    +

    Usage

    rUnifDS(n, min = 0, max = 1, force.output.to.k.decimal.places = 9)
    -
    -

    Arguments

    +
    +

    Arguments

    n
    @@ -79,8 +72,8 @@

    Arguments

    in ds.rUnif

    -
    -

    Value

    +
    +

    Value

    Writes the pseudorandom number vector with the characteristics specified in the function call as a new serverside vector on the data source on which it has been called. Also returns key information to the clientside: @@ -90,35 +83,31 @@

    Value

    also returns a vector reporting the length of the pseudorandom vector created in each source.

    -
    -

    Details

    +
    +

    Details

    Generates the vector of pseudorandom numbers from a uniform distribution in each data source as specified by the arguments of ds.rUnif. This serverside function is effectively the same as the function runif() in native R and its arguments are the same.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rUnifDS.md b/docs/reference/rUnifDS.md new file mode 100644 index 00000000..01f5505e --- /dev/null +++ b/docs/reference/rUnifDS.md @@ -0,0 +1,60 @@ +# rUnifDS serverside assign function + +primary serverside assign function called by ds.rUnif + +## Usage + +``` r +rUnifDS(n, min = 0, max = 1, force.output.to.k.decimal.places = 9) +``` + +## Arguments + +- n: + + length of the pseudorandom number vector to be generated as specified + by the argument \ in the function ds.rUnif + +- min: + + a numeric scalar specifying the minimum of the range across which the + random numbers will be generated in each source. Specified directly by + the min argument in ds.rUnif. May be a scalar or a vector allowing the + min to vary from observation to observation. + +- max: + + a numeric scalar specifying the maximum of the range across which the + random numbers will be generated in each source. Specified directly by + the max argument in ds.rUnif. May be a scalar or a vector allowing the + min to vary from observation to observation. + +- force.output.to.k.decimal.places: + + scalar integer. Forces the output random number vector to have k + decimal places. If 0 rounds it coerces decimal random number output to + integer, a k in range 1-8 forces output to have k decimal places. If k + = 9, no rounding occurs of native output. Default=9. Value specified + by \ argument in ds.rUnif + +## Value + +Writes the pseudorandom number vector with the characteristics specified +in the function call as a new serverside vector on the data source on +which it has been called. Also returns key information to the +clientside: the random seed as specified by you in each source + (if +requested) the full 626 length random seed vector this generated in each +source (see info for the argument \). It also +returns a vector reporting the length of the pseudorandom vector created +in each source. + +## Details + +Generates the vector of pseudorandom numbers from a uniform distribution +in each data source as specified by the arguments of ds.rUnif. This +serverside function is effectively the same as the function runif() in +native R and its arguments are the same. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/rangeDS.html b/docs/reference/rangeDS.html index fb661e2f..6483488d 100644 --- a/docs/reference/rangeDS.html +++ b/docs/reference/rangeDS.html @@ -1,88 +1,78 @@ -returns the minimum and maximum of a numeric vector — rangeDS • dsBase - - -
    -
    -
    -
    -

    returns the minimum and maximum of a numeric vector

    + - + + + +
    +
    +
    +
    + +

    returns the minimum and maximum of a numeric vector

    + +
    rangeDS.Rd
    -
    +

    this function is similar to R function range but instead to not return the real minimum and maximum, the computed values are multiplied by a very small random number.

    -
    +
    +

    Usage

    rangeDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a numerical

    -
    -

    Value

    +
    +

    Value

    a numeric vector which contains the minimum and the maximum values of the vector

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rangeDS.md b/docs/reference/rangeDS.md new file mode 100644 index 00000000..9ac00d23 --- /dev/null +++ b/docs/reference/rangeDS.md @@ -0,0 +1,26 @@ +# returns the minimum and maximum of a numeric vector + +this function is similar to R function `range` but instead to not return +the real minimum and maximum, the computed values are multiplied by a +very small random number. + +## Usage + +``` r +rangeDS(xvect) +``` + +## Arguments + +- xvect: + + a numerical + +## Value + +a numeric vector which contains the minimum and the maximum values of +the vector + +## Author + +Amadou Gaye, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/ranksSecureDS1.html b/docs/reference/ranksSecureDS1.html index dac835d7..a97e4497 100644 --- a/docs/reference/ranksSecureDS1.html +++ b/docs/reference/ranksSecureDS1.html @@ -1,64 +1,58 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS1 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + - + + + +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    ranksSecureDS1.Rd
    -
    +

    takes key non-disclosive components of the serverside data frame blackbox.output.df over to the clientside to enable global ranking.

    -
    +
    +

    Usage

    ranksSecureDS1()
    -
    -

    Value

    +
    +

    Value

    the non-disclosive elements of blackbox.output.df (see details) on the serverside as a data frame object (called blackbox.output) on the clientside. After processing to create the global ranks across all studies, this is returned to the serverside as the data frame sR4.df using the clientside function ds.dmtC2S

    -
    -

    Details

    +
    +

    Details

    Severside aggregate function called by ds.ranksSecure. The non-disclosive components of blackbox.output.df that are transmitted to the clientside are: (1) final values of the "combined real+pseudo data vector" @@ -71,28 +65,24 @@

    Details

    entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/ranksSecureDS1.md b/docs/reference/ranksSecureDS1.md new file mode 100644 index 00000000..db7bb40f --- /dev/null +++ b/docs/reference/ranksSecureDS1.md @@ -0,0 +1,37 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +takes key non-disclosive components of the serverside data frame +blackbox.output.df over to the clientside to enable global ranking. + +## Usage + +``` r +ranksSecureDS1() +``` + +## Value + +the non-disclosive elements of blackbox.output.df (see details) on the +serverside as a data frame object (called blackbox.output) on the +clientside. After processing to create the global ranks across all +studies, this is returned to the serverside as the data frame sR4.df +using the clientside function ds.dmtC2S + +## Details + +Severside aggregate function called by ds.ranksSecure. The +non-disclosive components of blackbox.output.df that are transmitted to +the clientside are: (1) final values of the "combined real+pseudo data +vector" after all seven rounds of encryption have been completed; (2) a +set of sequential IDs allocated after sorting the "combined real+pseudo +data vector" by value (in ascending order). This allows later re-linkage +of values back on the serverside and confirmation that that linkage is +correct. For more details about the cluster of functions that +collectively enable secure global ranking and estimation of global +quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/ranksSecureDS2.html b/docs/reference/ranksSecureDS2.html index b50f0029..6aab7b75 100644 --- a/docs/reference/ranksSecureDS2.html +++ b/docs/reference/ranksSecureDS2.html @@ -1,52 +1,51 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS2 • dsBaseSecure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS2 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + - + + + +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    ranksSecureDS2.Rd
    -
    +

    Checks that the data frame produced in creating the initial global ranks (ranks based on real and pseudo-data after the running of blackBoxDS)has the correct dimensions and order as the serverside data frames @@ -57,19 +56,20 @@

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    the real data

    -
    +
    +

    Usage

    ranksSecureDS2()
    -
    -

    Value

    +
    +

    Value

    creates a new data frame sR5.df on the serverside containing solely the real data and including key elements needed for next stage of the ranking process. Most crucially these include "global.rank" and "ID.by.val" sorted in ascending order of the magnitude of V2BR

    -
    -

    Details

    +
    +

    Details

    Severside assign function called by ds.ranksSecure. It works on the on the output created by serverside function ranksSecureDS1 and saved on the serverside in data frame sR4.df by ds.dmtC2S. Having @@ -86,28 +86,24 @@

    Details

    entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/ranksSecureDS2.md b/docs/reference/ranksSecureDS2.md new file mode 100644 index 00000000..78febe60 --- /dev/null +++ b/docs/reference/ranksSecureDS2.md @@ -0,0 +1,45 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +Checks that the data frame produced in creating the initial global ranks +(ranks based on real and pseudo-data after the running of blackBoxDS)has +the correct dimensions and order as the serverside data frames to which +it will now be appended. If either the number of rows or the order of +the rows are inconsistent with the pre-existing data frames on the +serverside an error message is returned and the processing stops. Then +strips out the pseudo-data leaving solely the global ranks based just on +the real data + +## Usage + +``` r +ranksSecureDS2() +``` + +## Value + +creates a new data frame sR5.df on the serverside containing solely the +real data and including key elements needed for next stage of the +ranking process. Most crucially these include "global.rank" and +"ID.by.val" sorted in ascending order of the magnitude of V2BR + +## Details + +Severside assign function called by ds.ranksSecure. It works on the on +the output created by serverside function ranksSecureDS1 and saved on +the serverside in data frame sR4.df by ds.dmtC2S. Having checked QA it +strips out all rows corresponding to pseudo-data. The resultant data +frame contains the following vectors: (1) the fully encrypted V2BR +(after application of blackBoxDS);(2) "ID.by.val" the sequential ID +associated with the "combined real+pseudo data vector" sorted by value +(ascending); (3) "studyid", a vector consisting solely of value n in the +nth study; (4) "global.rank" the vector containing global ranks created +by the clientside code in ds.ranksSecure after ranksSecureDS1 is called +and up to the point where ds.dmtC2S sends sR4.df to the serverside. For +more details about the cluster of functions that collectively enable +secure global ranking and estimation of global quantiles see the +associated document entitled "secure.global.ranking.docx". Also see the +header file for ds.ranksSecure + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/ranksSecureDS3.html b/docs/reference/ranksSecureDS3.html index ddc7e933..7740a6d8 100644 --- a/docs/reference/ranksSecureDS3.html +++ b/docs/reference/ranksSecureDS3.html @@ -1,58 +1,53 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS3 • dsBaseSecure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS3 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    - +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    ranksSecureDS3.Rd
    -
    +

    takes key non-disclosive components of the serverside data frame blackbox.ranks.df over to the clientside to enable global re-ranking of the global ranks just applying to the real data (not the pseudo-data).

    -
    +
    +

    Usage

    ranksSecureDS3()
    -
    -

    Value

    +
    +

    Value

    the non-disclosive elements of blackbox.output.df (see details) on the serverside as a data frame object (called sR6.df) on the clientside. After processing within ds.ranksSecure to create the @@ -67,8 +62,8 @@

    Value

    and estimation of global quantiles see the associated document entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Details

    +
    +

    Details

    Severside aggregate function called by ds.ranksSecure. The non-disclosive components of blackbox.ranks.df that are transmitted to the clientside are: (1) final values of the encrypted global ranks vector @@ -83,28 +78,24 @@

    Details

    see the associated document entitled "secure.global.ranking.docx". Also see the header file for ds.ranksSecure

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/ranksSecureDS3.md b/docs/reference/ranksSecureDS3.md new file mode 100644 index 00000000..5602ce29 --- /dev/null +++ b/docs/reference/ranksSecureDS3.md @@ -0,0 +1,49 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +takes key non-disclosive components of the serverside data frame +blackbox.ranks.df over to the clientside to enable global re-ranking of +the global ranks just applying to the real data (not the pseudo-data). + +## Usage + +``` r +ranksSecureDS3() +``` + +## Value + +the non-disclosive elements of blackbox.output.df (see details) on the +serverside as a data frame object (called sR6.df) on the clientside. +After processing within ds.ranksSecure to create the global ranks and +global quantiles (of real data only) across all studies, this is +returned to the serverside as data frame "global.ranks.quantiles.df" +using the clientside function ds.dmtC2S. To illustrate the difference +between ranks and quantiles, if there are a total of 1000 original real +observations across all studies and one particular observation has the +rank 250, it will have quantile value 0.25 (i.e. 25 increasing value). +Both ranks and quantiles can have ties. For more details about the +cluster of functions that collectively enable secure global ranking and +estimation of global quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure + +## Details + +Severside aggregate function called by ds.ranksSecure. The +non-disclosive components of blackbox.ranks.df that are transmitted to +the clientside are: (1) final values of the encrypted global ranks +vector after all seven rounds of encryption have been completed; (2) a +set of sequential IDs allocated to the global ranks vector in each study +in their current order based on increasing value of V2BR. This allows +later re-linkage of values back on the serverside and confirmation that +that linkage is correct. (3) a studyid vector with all values n in the +nth study. This facilitates data management on the serverside during the +global ranking of global ranks. For more details about the cluster of +functions that collectively enable secure global ranking and estimation +of global quantiles see the associated document entitled +"secure.global.ranking.docx". Also see the header file for +ds.ranksSecure + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/ranksSecureDS4.html b/docs/reference/ranksSecureDS4.html index c5db0477..60c03845 100644 --- a/docs/reference/ranksSecureDS4.html +++ b/docs/reference/ranksSecureDS4.html @@ -1,60 +1,56 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS4 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    - +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    ranksSecureDS4.Rd
    -
    +

    Creates a data frame "sR8.df" by cbinding the data frame "blackBox.ranks.df" with the global ranks and global quantiles vectors in "global.ranks.quantiles.df". Performs QA on this matrix and orders the sR8.df data frame according to the argument <ranks.sort.by> in ds.ranksSecure

    -
    +
    +

    Usage

    ranksSecureDS4(ranks.sort.by)
    -
    -

    Arguments

    +
    +

    Arguments

    ranks.sort.by
    @@ -65,16 +61,16 @@

    Arguments

    Default value is "ID.orig".

    -
    -

    Value

    +
    +

    Value

    Creates the data frame identified by the name given by the argument (<output.ranks.df>) of the ds.ranksSecure function and writes it to the serverside. If the argument <output.ranks.df> is NULL or unspecified the output data frame is called "main.ranks.df". The data frame is ordered according to the argument <ranks.sort.by> in ds.ranksSecure.

    -
    -

    Details

    +
    +

    Details

    Severside assign function called by ds.ranksSecure. Creates a data frame "sR8.df" by cbinding the data frame "blackBox.ranks.df" with the global ranks and global quantiles vectors in @@ -98,28 +94,24 @@

    Details

    basis of analysis based on the global ranks or quantiles including a range of types of non-parametric analysis.

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/ranksSecureDS4.md b/docs/reference/ranksSecureDS4.md new file mode 100644 index 00000000..814907c9 --- /dev/null +++ b/docs/reference/ranksSecureDS4.md @@ -0,0 +1,62 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +Creates a data frame "sR8.df" by cbinding the data frame +"blackBox.ranks.df" with the global ranks and global quantiles vectors +in "global.ranks.quantiles.df". Performs QA on this matrix and orders +the sR8.df data frame according to the argument \ in +ds.ranksSecure + +## Usage + +``` r +ranksSecureDS4(ranks.sort.by) +``` + +## Arguments + +- ranks.sort.by: + + a character string taking two possible values. These are "ID.orig" and + "vals.orig". These define the order in which the output.ranks.df and + summary.output.ranks.df data frames are presented. This argument is + set by the argument with the same name in ds.ranksSecure. Default + value is "ID.orig". + +## Value + +Creates the data frame identified by the name given by the argument +(\) of the ds.ranksSecure function and writes it to +the serverside. If the argument \ is NULL or +unspecified the output data frame is called "main.ranks.df". The data +frame is ordered according to the argument \ in +ds.ranksSecure. + +## Details + +Severside assign function called by ds.ranksSecure. Creates a data frame +"sR8.df" by cbinding the data frame "blackBox.ranks.df" with the global +ranks and global quantiles vectors in "global.ranks.quantiles.df". +Checks that all components of sR8.df have the correct dimensions and are +consistent in their ordering. If either the number of rows or the order +of the rows are inconsistent with those in "blackBox.ranks.df" an error +message is returned and the processing stops. If sR8.df passes all QA +tests it is written to the serverside as a data frame with its name +identified by the argument \ in ds.ranksSecure. If +that argument is NULL or unspecified the data frame is called +"main.ranks.df". The ranksSecureDS4 function also orders the combined +data frame (\) in one of two ways: if the argument +\ in ds.ranksSecure is set to "ID.orig" the combined +data frame is ordered in the same way as the original V2BR vector; if +the argument \ is set to vals.orig" the combined data +frame is ordered by the magnitude of the values of V2BR (ascending). +Having created the data frame (\) in this manner it +can now be directly cbinded to either the V2BR vector itself or to a +data frame, tibble or matrix containing V2BR (assuming they are also in +the order corresponding to the argument \) and this +combined object can be used as the basis of analysis based on the global +ranks or quantiles including a range of types of non-parametric +analysis. + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/ranksSecureDS5.html b/docs/reference/ranksSecureDS5.html index bb98ac56..1bb7537d 100644 --- a/docs/reference/ranksSecureDS5.html +++ b/docs/reference/ranksSecureDS5.html @@ -1,60 +1,56 @@ -Secure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS5 • dsBaseSecure ranking of "V2BR" (vector to be ranked) across all sources — ranksSecureDS5 • dsBase - - -
    -
    -
    -
    -

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    - +
    +
    +
    +
    + +

    Secure ranking of "V2BR" (vector to be ranked) across all sources

    + +
    ranksSecureDS5.Rd
    -
    +

    Summarises the serverside data frame written by ranksSecureDS4 which is identified by the name given by the argument (<output.ranks.df>) of the ds.ranksSecure function to produce a new output data frame containing only 5 key variables.

    -
    +
    +

    Usage

    ranksSecureDS5(output.ranks.df)
    -
    -

    Arguments

    +
    +

    Arguments

    output.ranks.df
    @@ -65,14 +61,14 @@

    Arguments

    the same name in ds.ranksSecure.

    -
    -

    Value

    +
    +

    Value

    extracts 5 key vectors from the larger data frame created by ranksSecureDS4 to produce a summary data frame that is written to the serverside. It is given a name specified by the argument.

    -
    -

    Details

    +
    +

    Details

    Serverside assign function called by clientside function ds.ranksSecure. Takes the serverside data frame written by ranksSecureDS4 which is identified by the name given by the argument (<output.ranks.df>) of @@ -98,28 +94,24 @@

    Details

    original values in V2BR, with ties reflected appropriately; (5) a studyid vector in which all elements take the value n in the nth study.

    -
    -

    Author

    +
    +

    Author

    Paul Burton 9th November, 2021

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/ranksSecureDS5.md b/docs/reference/ranksSecureDS5.md new file mode 100644 index 00000000..7c4d964b --- /dev/null +++ b/docs/reference/ranksSecureDS5.md @@ -0,0 +1,61 @@ +# Secure ranking of "V2BR" (vector to be ranked) across all sources + +Summarises the serverside data frame written by ranksSecureDS4 which is +identified by the name given by the argument (\) of +the ds.ranksSecure function to produce a new output data frame +containing only 5 key variables. + +## Usage + +``` r +ranksSecureDS5(output.ranks.df) +``` + +## Arguments + +- output.ranks.df: + + a character string which specifies an optional name for the data.frame + written to the serverside on each data source that contains 11 of the + key output variables from the ranking procedure pertaining to that + particular data source. This argument is set by the argument with the + same name in ds.ranksSecure. + +## Value + +extracts 5 key vectors from the larger data frame created by +ranksSecureDS4 to produce a summary data frame that is written to the +serverside. It is given a name specified by the argument. + +## Details + +Serverside assign function called by clientside function ds.ranksSecure. +Takes the serverside data frame written by ranksSecureDS4 which is +identified by the name given by the argument (\) of +the ds.ranksSecure function. This holds 11 vectors including the final +global ranks across all studies and final global quantiles. The data +frame is ordered according to the argument \ in +ds.ranksSecure. The ranksSecureDS5 function then extracts 5 key vectors +from the larger data frame to produce a summary data frame that is given +a name specified by the argument (\) the +ds.ranksSecure function. This data frame includes the following +components: (1) The values of a sequential ID variable +(ID.seq.real.orig) created to lie alongside the original V2BR vector in +the same order as that vector was itself ordered. These ID values +therefore reflect which row in the original data corresponds to a given +row in the output. If the argument \ in ds.ranksSecure +is set to "ID.orig" the values of the ID.seq.real.orig vector in the +output data frame simply run sequentially from 1 to N where N is the +number of individuals in the corresponding study. If \ +is set to "vals.orig" the values of the ID.seq.real.orig vector will be +determined by the magnitude of the corresponding V2BR value and will +appear to be ordered in a haphazard manner; (2) the original values of +V2BR; (3) the global ranks corresponding to the original values in V2BR, +with ties reflected appropriately; (4) the global quantiles +corresponding to the original values in V2BR, with ties reflected +appropriately; (5) a studyid vector in which all elements take the value +n in the nth study. + +## Author + +Paul Burton 9th November, 2021 diff --git a/docs/reference/rbindDS.html b/docs/reference/rbindDS.html index 646c1d25..e2a48678 100644 --- a/docs/reference/rbindDS.html +++ b/docs/reference/rbindDS.html @@ -1,58 +1,53 @@ -rbindDS called by ds.rbind — rbindDS • dsBaserbindDS called by ds.rbind — rbindDS • dsBase - - -
    -
    -
    -
    -

    rbindDS called by ds.rbind

    - +
    +
    +
    +
    + +

    rbindDS called by ds.rbind

    + +
    rbindDS.Rd
    -
    +

    serverside assign function that takes a sequence of vector, matrix or data-frame arguments and combines them by row to produce a matrix.

    -
    +
    +

    Usage

    rbindDS(x.names.transmit = NULL, colnames.transmit = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x.names.transmit
    @@ -71,8 +66,8 @@

    Arguments

    of ds.cbind.

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument of ds.rbind(or default name <rbind.out>) which is written to the serverside. As well as writing the output object as <newobj> @@ -89,35 +84,31 @@

    Value

    without problems no studysideMessage will have been saved and ds.message("<newobj>") will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    A sequence of vector, matrix or data-frame arguments is combined row by row to produce a matrix which is written to the serverside. For more details see help for ds.rbind and the native R function rbind.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rbindDS.md b/docs/reference/rbindDS.md new file mode 100644 index 00000000..8ba404af --- /dev/null +++ b/docs/reference/rbindDS.md @@ -0,0 +1,56 @@ +# rbindDS called by ds.rbind + +serverside assign function that takes a sequence of vector, matrix or +data-frame arguments and combines them by row to produce a matrix. + +## Usage + +``` r +rbindDS(x.names.transmit = NULL, colnames.transmit = NULL) +``` + +## Arguments + +- x.names.transmit: + + This is a vector of character strings representing the names of the + elemental components to be combined converted into a transmittable + format. This argument is fully specified by the \ argument of + `ds.rbind` + +- colnames.transmit: + + This is NULL or a vector of character strings representing forced + column names for the output object converted into a transmittable + format. This argument is fully specified by the \ + argument of `ds.cbind`. + +## Value + +the object specified by the \ argument of `ds.rbind`(or default +name \) which is written to the serverside. As well as +writing the output object as \ on the serverside, two validity +messages are returned indicating whether \ has been created in +each data source and if so whether it is in a valid form. If its form is +not valid in at least one study - e.g. because a disclosure trap was +tripped and creation of the full output object was blocked - ds.cbind() +also returns any studysideMessages that can explain the error in +creating the full output object. As well as appearing on the screen at +run time,if you wish to see the relevant studysideMessages at a later +date you can use the `ds.message` function. If you type +ds.message("\") it will print out the relevant studysideMessage +from any datasource in which there was an error in creating \ +and a studysideMessage was saved. If there was no error and \ +was created without problems no studysideMessage will have been saved +and ds.message("\") will return the message: "ALL OK: there are +no studysideMessage(s) on this datasource". + +## Details + +A sequence of vector, matrix or data-frame arguments is combined row by +row to produce a matrix which is written to the serverside. For more +details see help for `ds.rbind` and the native R function `rbind`. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/reShapeDS.html b/docs/reference/reShapeDS.html index 0b5ebc94..171c73e3 100644 --- a/docs/reference/reShapeDS.html +++ b/docs/reference/reShapeDS.html @@ -1,51 +1,45 @@ -reShapeDS (assign function) called by ds.reShape — reShapeDS • dsBase - - -
    -
    -
    -
    -

    reShapeDS (assign function) called by ds.reShape

    + - + + + +
    +
    +
    +
    + +

    reShapeDS (assign function) called by ds.reShape

    + +
    reShapeDS.Rd
    -
    +

    Reshapes a data frame containing longitudinal or otherwise grouped data from 'wide' to 'long' format or vice-versa

    -
    +
    +

    Usage

    reShapeDS(
   data.name,
   varying.transmit,
@@ -58,8 +52,8 @@ 
    reShapeDS (assign function) called by ds.reShape
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    data.name,
    @@ -112,8 +106,8 @@

    Arguments

    via argument <sep> of ds.reShape function

    -
    -

    Value

    +
    +

    Value

    a reshaped data.frame converted from long to wide format or from wide to long format which is written to the serverside and given the name provided as the <newobj> argument of ds.reShape or 'newObject' if no name is specified. @@ -121,36 +115,32 @@

    Value

    indicating whether <newobj> has been created in each data source and if so whether it is in a valid form (see header for ds.reShape.

    -
    -

    Details

    +
    +

    Details

    This function is based on the native R function reshape. It reshapes a data frame containing longitudinal or otherwise grouped data between 'wide' format with repeated measurements in separate columns of the same record and 'long' format with the repeated measurements in separate records. The reshaping can be in either direction

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/reShapeDS.md b/docs/reference/reShapeDS.md new file mode 100644 index 00000000..8dbaca85 --- /dev/null +++ b/docs/reference/reShapeDS.md @@ -0,0 +1,92 @@ +# reShapeDS (assign function) called by ds.reShape + +Reshapes a data frame containing longitudinal or otherwise grouped data +from 'wide' to 'long' format or vice-versa + +## Usage + +``` r +reShapeDS( + data.name, + varying.transmit, + v.names.transmit, + timevar.name, + idvar.name, + drop.transmit, + direction, + sep +) +``` + +## Arguments + +- data.name, : + + the name of the data.frame to be reshaped. Specified via argument + \ of `ds.reShape` function + +- varying.transmit, : + + names of sets of variables in the wide format that correspond to + single variables in long format (typically what may be called + 'time-varying' or 'time-dependent' variables). Specified via argument + \ of `ds.reShape` function. + +- v.names.transmit, : + + the names of variables in the long format that correspond to multiple + variables in the wide format - for example, sbp7, sbp11, sbp15 + (measured systolic blood pressure at ages 7, 11 and 15 years). + Specified via argument \ of `ds.reShape` function + +- timevar.name, : + + the variable in long format that differentiates multiple records from + the same group or individual. Specified via argument \ + of `ds.reShape` function + +- idvar.name, : + + names of one or more variables in long format that identify multiple + records from the same group/individual. This/these variable(s) may + also be present in wide format. Specified via argument \ + of `ds.reShape` function + +- drop.transmit, : + + a vector of names of variables to drop before reshaping. Specified via + argument \ of `ds.reShape` function + +- direction, : + + a character string, partially matched to either "wide" to reshape from + long to wide format, or "long" to reshape from wide to long format. + Specified via argument \ of `ds.reShape` function + +- sep, : + + a character vector of length 1, indicating a separating character in + the variable names in the wide format. Specified via argument \ + of `ds.reShape` function + +## Value + +a reshaped data.frame converted from long to wide format or from wide to +long format which is written to the serverside and given the name +provided as the \ argument of `ds.reShape` or 'newObject' if no +name is specified. In addition, two validity messages are returned to +the clientside indicating whether \ has been created in each +data source and if so whether it is in a valid form (see header for +`ds.reShape`. + +## Details + +This function is based on the native R function `reshape`. It reshapes a +data frame containing longitudinal or otherwise grouped data between +'wide' format with repeated measurements in separate columns of the same +record and 'long' format with the repeated measurements in separate +records. The reshaping can be in either direction + +## Author + +Demetris Avraam, Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/recodeLevelsDS.html b/docs/reference/recodeLevelsDS.html index a7279d5c..479f17a8 100644 --- a/docs/reference/recodeLevelsDS.html +++ b/docs/reference/recodeLevelsDS.html @@ -1,56 +1,50 @@ -Recodes the levels of a categorical variables — recodeLevelsDS • dsBase - - -
    -
    -
    -
    -

    Recodes the levels of a categorical variables

    + - + + + +
    +
    +
    +
    + +

    Recodes the levels of a categorical variables

    + +
    recodeLevelsDS.Rd
    -
    +

    The functions uses the input factor and generates a new factor with new levels.

    -
    +
    +

    Usage

    recodeLevelsDS(x = NULL, classes = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -61,32 +55,28 @@

    Arguments

    a character vector the levels of the newt factor vector

    -
    -

    Value

    +
    +

    Value

    a factor vector with the new levels

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/recodeLevelsDS.md b/docs/reference/recodeLevelsDS.md new file mode 100644 index 00000000..f2735ebd --- /dev/null +++ b/docs/reference/recodeLevelsDS.md @@ -0,0 +1,28 @@ +# Recodes the levels of a categorical variables + +The functions uses the input factor and generates a new factor with new +levels. + +## Usage + +``` r +recodeLevelsDS(x = NULL, classes = NULL) +``` + +## Arguments + +- x: + + a factor vector + +- classes: + + a character vector the levels of the newt factor vector + +## Value + +a factor vector with the new levels + +## Author + +Gaye, A. diff --git a/docs/reference/recodeValuesDS.html b/docs/reference/recodeValuesDS.html index d58ae97e..540e3a81 100644 --- a/docs/reference/recodeValuesDS.html +++ b/docs/reference/recodeValuesDS.html @@ -1,51 +1,45 @@ -recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS • dsBase - - -
    -
    -
    -
    -

    recodeValuesDS an assign function called by ds.recodeValues

    + - + + + +
    +
    +
    +
    + +

    recodeValuesDS an assign function called by ds.recodeValues

    + +
    recodeValuesDS.Rd
    -
    +

    This function recodes specified values of elements in a vector into a matched set of alternative specified values.

    -
    +
    +

    Usage

    recodeValuesDS(
   var.name.text = NULL,
   values2replace.text = NULL,
@@ -54,8 +48,8 @@ 
    recodeValuesDS an assign function called by ds.recodeValues
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    var.name.text
    @@ -89,38 +83,34 @@

    Arguments

    will be replaced by this value.

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or default name '<var.name>_recoded') initially specified in calling ds.recodeValues. The output object (the required recoded variable called <newobj> is written to the serverside.

    -
    -

    Details

    +
    +

    Details

    For all details see the help header for ds.recodeValues

    -
    -

    Author

    +
    +

    Author

    Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/recodeValuesDS.md b/docs/reference/recodeValuesDS.md new file mode 100644 index 00000000..aada9b31 --- /dev/null +++ b/docs/reference/recodeValuesDS.md @@ -0,0 +1,65 @@ +# recodeValuesDS an assign function called by ds.recodeValues + +This function recodes specified values of elements in a vector into a +matched set of alternative specified values. + +## Usage + +``` r +recodeValuesDS( + var.name.text = NULL, + values2replace.text = NULL, + new.values.text = NULL, + missing = NULL +) +``` + +## Arguments + +- var.name.text: + + a character string providing the name for the vector representing the + variable to be recoded. \ argument generated and + passed directly to recodeValuesDS by ds.recodeValues + +- values2replace.text: + + a character string specifying the values in the vector specified by + the argument \ that are to be replaced by new values + as specified in the new.values.vector. The \ + argument is generated and passed directly to recodeValuesDS by + ds.recodeValues. In effect, the \ argument of + the ds.recodeValues function is converted to a character string format + that is acceptable to the DataSHIELD R parser in the data repository + and so can be accepted by recodeValuesDS + +- new.values.text: + + a character string specifying the new values to which the specified + values in the vector \ are to be converted. The + \ argument is generated and passed directly to + recodeValuesDS by ds.recodeValues. In effect, the + \ argument of the ds.recodeValues function is + converted to a character string format that is acceptable to the + DataSHIELD R parser in the data repository and so can be used in the + call to recodeValuesDS. + +- missing: + + if supplied, any missing values in the variable referred to by + var.name.text will be replaced by this value. + +## Value + +the object specified by the \ argument (or default name +'\\_recoded') initially specified in calling ds.recodeValues. +The output object (the required recoded variable called \ is +written to the serverside. + +## Details + +For all details see the help header for ds.recodeValues + +## Author + +Paul Burton, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/repDS.html b/docs/reference/repDS.html index 1299f1e9..cf48655b 100644 --- a/docs/reference/repDS.html +++ b/docs/reference/repDS.html @@ -1,49 +1,45 @@ -repDS called by ds.rep — repDS • dsBaserepDS called by ds.rep — repDS • dsBase - - -
    -
    -
    -
    -

    repDS called by ds.rep

    + - + +
    +
    +
    +
    + +

    repDS called by ds.rep

    + +
    repDS.Rd
    -
    +

    An assign function which creates a repetitive sequence by repeating an identified scalar, or specified elements of a vector @@ -51,7 +47,8 @@

    repDS called by ds.rep

    The sequence is written as a new object to the serverside

    -
    +
    +

    Usage

    repDS(
   x1.transmit,
   times.transmit,
@@ -65,8 +62,8 @@ 
    repDS called by ds.rep
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    x1.transmit
    @@ -138,8 +135,8 @@

    Arguments

    the argument <source.each> in the call to ds.rep that itself calls repDS.

    -
    -

    Value

    +
    +

    Value

    the vector containing the specified repetitive sequence and write to the output object defined by the <newobj> argument (or default name seq.vect) which is written to the serverside in @@ -156,8 +153,8 @@

    Value

    without problems no studysideMessage will have been saved and ds.message("newobj") will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    Further details can be found in the help details for on ds.rep and the following aspects of the help for the function rep in native R also apply (as explained @@ -179,28 +176,24 @@

    Details

    computed quantity it is prudent to add a small fuzz or use round. And analogously for each.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team, 14/10/2019

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/repDS.md b/docs/reference/repDS.md new file mode 100644 index 00000000..f97dee62 --- /dev/null +++ b/docs/reference/repDS.md @@ -0,0 +1,145 @@ +# repDS called by ds.rep + +An assign function which creates a repetitive sequence by repeating an +identified scalar, or specified elements of a vector or list. This is +analogous to the `rep` function in native R. The sequence is written as +a new object to the serverside + +## Usage + +``` r +repDS( + x1.transmit, + times.transmit, + length.out.transmit, + each.transmit, + x1.includes.characters, + source.x1, + source.times, + source.length.out, + source.each +) +``` + +## Arguments + +- x1.transmit: + + This argument determines the input scalar, vector or list. for + behaviour see help for `ds.rep` and "details from native R help for + \" (see above). This parameter is usually fully defined by the + argument \ in the call to `ds.rep` that itself calls `repDS`. + +- times.transmit: + + This argument determines the number of replications and the pattern of + these replications of the input scalar/vector to construct the output + repetitive sequence. For behaviour see help for `ds.rep` and "details + from native R help for \" (see above). This parameter is usually + fully defined by the argument \ in the call to `ds.rep` that + itself calls `repDS`. + +- length.out.transmit: + + This argument fixes the length of the output repetitive sequence + vector For behaviour see help for `ds.rep` and "details from native R + help for \" (see above). This parameter is usually fully defined + by the argument \ in the call to `ds.rep` that itself + calls `repDS`. + +- each.transmit: + + This argument specifies the number of replications of individual + elements rather than replications of the full sequence. For behaviour + see help for `ds.rep` and "details from native R help for \" + (see above). This parameter is usually fully defined by the argument + \ in the call to `ds.rep` that itself calls `repDS`. + +- x1.includes.characters: + + Boolean parameter determining whether to coerce the final output + sequence to numeric. Defaults to FALSE and output is coerced to + numeric. For detailed behaviour see help for `ds.rep`. This parameter + is usually fully defined by the argument \ in + the call to `ds.rep` that itself calls `repDS`. + +- source.x1: + + This defines the source of the scalar or vector defined by the \ + argument. Four character strings are allowed: "clientside" or "c" and + serverside or "s". For behaviour see help for `ds.rep` and "details + from native R help for \" (see above). This parameter is usually + fully defined by the argument \ in the call to `ds.rep` + that itself calls `repDS`. + +- source.times: + + see "param source.x1" This parameter is usually fully defined by the + argument \ in the call to `ds.rep` that itself calls + `repDS`. + +- source.length.out: + + see "param source.x1" This parameter is usually fully defined by the + argument \ in the call to `ds.rep` that itself + calls `repDS`. + +- source.each: + + see "param source.x1" This parameter is usually fully defined by the + argument \ in the call to `ds.rep` that itself calls + `repDS`. + +## Value + +the vector containing the specified repetitive sequence and write to the +output object defined by the \ argument (or default name +seq.vect) which is written to the serverside in each source. In +addition, two validity messages are returned indicating whether +\ has been created in each data source and if so whether it is +in a valid form. If its form is not valid in at least one study - e.g. +because a disclosure trap was tripped and creation of the full output +object was blocked - ds.matrixDiag also returns any studysideMessages +that can explain the error in creating the full output object. As well +as appearing on the screen at run time,if you wish to see the relevant +studysideMessages at a later date you can use the `ds.message` function. +If you type ds.message("newobj") it will print out the relevant +studysideMessage from any datasource in which there was an error in +creating \ and a studysideMessage was saved. If there was no +error and \ was created without problems no studysideMessage +will have been saved and ds.message("newobj") will return the message: +"ALL OK: there are no studysideMessage(s) on this datasource". + +## Details + +Further details can be found in the help details for on ds.rep and the +following aspects of the help for the function `rep` in native R also +apply (as explained in more detail with exceptions identified in help +for `ds.rep`): + +In addition a Details from R help for \: + +The default behaviour is as if the call was rep(x, times = 1, length.out += NA, each = 1) Normally just one of the additional arguments is +specified, but if 'each' is specified with either of the other two, its +replication is performed first, and then that is followed by the +replication implied by times or length.out. + +If times consists of a single integer, the result consists of the whole +input repeated this many times. If times is a vector of the same length +as x (after replication by each), the result consists of x\[1\] repeated +times\[1\] times, x\[2\] repeated times\[2\] times and so on. \*\*\*Note +exception 1 above. + +length.out may be given in place of times, in which case x is repeated +as many times as is necessary to create a vector of this length. If both +are given, length.out takes priority and times is ignored. \*\*\*Note +exception 3 above. + +Non-integer values of times will be truncated towards zero. If times is +a computed quantity it is prudent to add a small fuzz or use round. And +analogously for each. + +## Author + +Paul Burton for DataSHIELD Development Team, 14/10/2019 diff --git a/docs/reference/replaceNaDS.html b/docs/reference/replaceNaDS.html index 17b516b6..f0f7a9af 100644 --- a/docs/reference/replaceNaDS.html +++ b/docs/reference/replaceNaDS.html @@ -1,56 +1,50 @@ -Replaces the missing values in a vector — replaceNaDS • dsBase - - -
    -
    -
    -
    -

    Replaces the missing values in a vector

    + - + + + +
    +
    +
    +
    + +

    Replaces the missing values in a vector

    + +
    replaceNaDS.Rd
    -
    +

    This function identifies missing values and replaces them by a value or values specified by the analyst.

    -
    +
    +

    Usage

    replaceNaDS(xvect, replacements)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -62,12 +56,12 @@

    Arguments

    more values for each study.

    -
    -

    Value

    +
    +

    Value

    a new vector without missing values

    -
    -

    Details

    +
    +

    Details

    This function is used when the analyst prefer or requires complete vectors. It is then possible the specify one value for each missing value by first returning the number of missing values using the function numNaDS but in most cases @@ -75,28 +69,24 @@

    Details

    replace all missing values in a vector by the mean or median value. Once the missing values have been replaced a new vector is created.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/replaceNaDS.md b/docs/reference/replaceNaDS.md new file mode 100644 index 00000000..f547025a --- /dev/null +++ b/docs/reference/replaceNaDS.md @@ -0,0 +1,39 @@ +# Replaces the missing values in a vector + +This function identifies missing values and replaces them by a value or +values specified by the analyst. + +## Usage + +``` r +replaceNaDS(xvect, replacements) +``` + +## Arguments + +- xvect: + + a character, the name of the vector to process. + +- replacements: + + a vector which contains the replacement value(s), a vector one or more + values for each study. + +## Value + +a new vector without missing values + +## Details + +This function is used when the analyst prefer or requires complete +vectors. It is then possible the specify one value for each missing +value by first returning the number of missing values using the function +`numNaDS` but in most cases it might be more sensible to replace all +missing values by one specific value e.g. replace all missing values in +a vector by the mean or median value. Once the missing values have been +replaced a new vector is created. + +## Author + +Amadou Gaye, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/rmDS.html b/docs/reference/rmDS.html index 190067c5..d055052a 100644 --- a/docs/reference/rmDS.html +++ b/docs/reference/rmDS.html @@ -1,54 +1,47 @@ -rmDS an aggregate function called by ds.rm — rmDS • dsBase - - -
    -
    -
    -
    -

    rmDS an aggregate function called by ds.rm

    + - + + + +
    +
    +
    +
    + +

    rmDS an aggregate function called by ds.rm

    + +
    rmDS.Rd
    -
    +

    deletes an R object on the serverside

    -
    +
    +

    Usage

    rmDS(x.names.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    x.names.transmit,
    @@ -57,8 +50,8 @@

    Arguments

    argument is specified via the <x.names> argument of ds.rm

    -
    -

    Value

    +
    +

    Value

    the specified object is deleted from the serverside. If this is successful the message "Object <x.names> successfully deleted" is returned to the clientside (where x.names are the names of the object to be deleted). @@ -66,8 +59,8 @@

    Value

    source, that source will return the message: "Object to be deleted, i.e. <x.names>, does not exist so does not need deleting".

    -
    -

    Details

    +
    +

    Details

    this is a serverside function based on the rm() function in native R. It is an aggregate function which may be surprising because it modifies an object @@ -77,28 +70,24 @@

    Details

    fail because the effect of the function is to delete the object and so it would be impossible to write it anywhere.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rmDS.md b/docs/reference/rmDS.md new file mode 100644 index 00000000..804b8e20 --- /dev/null +++ b/docs/reference/rmDS.md @@ -0,0 +1,40 @@ +# rmDS an aggregate function called by ds.rm + +deletes an R object on the serverside + +## Usage + +``` r +rmDS(x.names.transmit) +``` + +## Arguments + +- x.names.transmit, : + + the names of the objects to be deleted converted into transmissible + form, a comma separated list of character string. The argument is + specified via the \ argument of ds.rm + +## Value + +the specified object is deleted from the serverside. If this is +successful the message "Object \ successfully deleted" is +returned to the clientside (where x.names are the names of the object to +be deleted). If the objects to be deleted is already absent on a given +source, that source will return the message: "Object to be deleted, i.e. +\, does not exist so does not need deleting". + +## Details + +this is a serverside function based on the rm() function in native R. It +is an aggregate function which may be surprising because it modifies an +object on the serverside, and would therefore be expected to be an +assign function. However, as an assign function the last step in running +it would be to write the modified object as newobj. But this would fail +because the effect of the function is to delete the object and so it +would be impossible to write it anywhere. + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/rowColCalcDS.html b/docs/reference/rowColCalcDS.html index 2e657383..b01c118e 100644 --- a/docs/reference/rowColCalcDS.html +++ b/docs/reference/rowColCalcDS.html @@ -1,56 +1,50 @@ -Computes sums and means of rows or columns of numeric arrays — rowColCalcDS • dsBase - - -
    -
    -
    -
    -

    Computes sums and means of rows or columns of numeric arrays

    + - + + + +
    +
    +
    +
    + +

    Computes sums and means of rows or columns of numeric arrays

    + +
    rowColCalcDS.Rd
    -
    +

    The function is similar to R base functions 'rowSums', 'colSums', 'rowMeans' and 'colMeans'.

    -
    +
    +

    Usage

    rowColCalcDS(dataset, operation)
    -
    -

    Arguments

    +
    +

    Arguments

    dataset
    @@ -62,37 +56,33 @@

    Arguments

    1 for 'rowSums', 2 for 'colSums', 3 for 'rowMeans' or 4 for 'colMeans'

    -
    -

    Value

    +
    +

    Value

    a numeric vector

    -
    -

    Details

    +
    +

    Details

    the output is returned to the user only the number of entries in the output vector is greater or equal to the allowed size.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/rowColCalcDS.md b/docs/reference/rowColCalcDS.md new file mode 100644 index 00000000..78e95f4a --- /dev/null +++ b/docs/reference/rowColCalcDS.md @@ -0,0 +1,34 @@ +# Computes sums and means of rows or columns of numeric arrays + +The function is similar to R base functions 'rowSums', 'colSums', +'rowMeans' and 'colMeans'. + +## Usage + +``` r +rowColCalcDS(dataset, operation) +``` + +## Arguments + +- dataset: + + an array of two or more dimensions. + +- operation: + + an integer that indicates the operation to carry out: 1 for 'rowSums', + 2 for 'colSums', 3 for 'rowMeans' or 4 for 'colMeans' + +## Value + +a numeric vector + +## Details + +the output is returned to the user only the number of entries in the +output vector is greater or equal to the allowed size. + +## Author + +Gaye, A. diff --git a/docs/reference/sampleDS.html b/docs/reference/sampleDS.html index add11002..a2eb697b 100644 --- a/docs/reference/sampleDS.html +++ b/docs/reference/sampleDS.html @@ -1,53 +1,48 @@ -random sampling and permuting of vectors, dataframes and matrices — sampleDS • dsBaserandom sampling and permuting of vectors, dataframes and matrices — sampleDS • dsBase - - -
    -
    -
    -
    -

    random sampling and permuting of vectors, dataframes and matrices

    - +
    +
    +
    +
    + +

    random sampling and permuting of vectors, dataframes and matrices

    + +
    sampleDS.Rd
    -
    +

    draws a pseudorandom sample from a vector, dataframe or matrix on the serverside or - as a special case - randomly permutes a vector, dataframe or matrix.

    -
    +
    +

    Usage

    sampleDS(
   x.transmit,
   size.transmit,
@@ -56,8 +51,8 @@ 
    random sampling and permuting of vectors, dataframes and matrices
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    x.transmit
    @@ -92,41 +87,37 @@

    Arguments

    help for ds.sample and native R help for sample().

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument (or default name 'newobj.sample') which is written to the serverside. For further details see help for ds.sample and native R help for sample().

    -
    -

    Details

    +
    +

    Details

    Serverside assign function sampleDS called by clientside function ds.sample. Based on the native R function sample() but deals slightly differently with data.frames and matrices. For further details see help for ds.sample and native R help for sample().

    -
    -

    Author

    +
    +

    Author

    Paul Burton, for DataSHIELD Development Team, 15/4/2020

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/sampleDS.md b/docs/reference/sampleDS.md new file mode 100644 index 00000000..85154b36 --- /dev/null +++ b/docs/reference/sampleDS.md @@ -0,0 +1,71 @@ +# random sampling and permuting of vectors, dataframes and matrices + +draws a pseudorandom sample from a vector, dataframe or matrix on the +serverside or - as a special case - randomly permutes a vector, +dataframe or matrix. + +## Usage + +``` r +sampleDS( + x.transmit, + size.transmit, + replace.transmit = NULL, + prob.transmit = NULL +) +``` + +## Arguments + +- x.transmit: + + Either a character string providing the name for the serverside + vector, matrix or data.frame to be sampled or permuted, or an + integer/numeric scalar (e.g. 923) indicating that one should create a + new vector on the serverside that is a randomly permuted sample of the + vector 1:923. x.transmit is fully specified by the \[x\] argument of + ds.sample. For further details see help for ds.sample and native R + help for sample(). + +- size.transmit: + + a numeric/integer scalar indicating the size of the sample to be + drawn. size.transmit is fully specified by the \[size\] argument of + ds.sample. For further details see help for ds.sample and native R + help for sample(). + +- replace.transmit: + + a Boolean indicator (TRUE or FALSE) specifying whether the sample + should be drawn with or without replacement. Default is FALSE so the + sample is drawn without replacement. replace.transmit is fully + specified by the \[replace\] argument of ds.sample. For further + details see help for ds.sample and native R help for sample(). + +- prob.transmit: + + a character string containing the name of a numeric vector of + probability weights on the serverside that is associated with each of + the elements of the vector to be sampled enabling the drawing of a + sample with some elements given higher probability of being drawn than + others. prob.transmit is fully specified by the \[prob\] argument of + ds.sample. For further details see help for ds.sample and native R + help for sample(). + +## Value + +the object specified by the \ argument (or default name +'newobj.sample') which is written to the serverside. For further details +see help for ds.sample and native R help for sample(). + +## Details + +Serverside assign function sampleDS called by clientside function +ds.sample. Based on the native R function +[`sample()`](https://rdrr.io/r/base/sample.html) but deals slightly +differently with data.frames and matrices. For further details see help +for ds.sample and native R help for sample(). + +## Author + +Paul Burton, for DataSHIELD Development Team, 15/4/2020 diff --git a/docs/reference/scatterPlotDS.html b/docs/reference/scatterPlotDS.html index 337a3393..324dd373 100644 --- a/docs/reference/scatterPlotDS.html +++ b/docs/reference/scatterPlotDS.html @@ -1,56 +1,50 @@ -Calculates the coordinates of the data to be plot — scatterPlotDS • dsBase - - -
    -
    -
    -
    -

    Calculates the coordinates of the data to be plot

    + - + + + +
    +
    +
    +
    + +

    Calculates the coordinates of the data to be plot

    + +
    scatterPlotDS.Rd
    -
    +

    This function uses two disclosure control methods to generate non-disclosive coordinates that are returned to the client that generates the non-disclosive scatter plots.

    -
    +
    +

    Usage

    scatterPlotDS(x, y, method.indicator, k, noise)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -77,12 +71,12 @@

    Arguments

    noise if the probabilistic method is selected.

    -
    -

    Value

    +
    +

    Value

    a list with the x and y coordinates of the data to be plot

    -
    -

    Details

    +
    +

    Details

    If the user chooses the deterministic approach, the function finds the k-1 nearest neighbours of each data point in a 2-dimensional space. The nearest neighbours are the data points with the minimum Euclidean distances from the point of interest. Each point of interest @@ -96,28 +90,24 @@

    Details

    disclosure we fix the random number generator in a value that is specified by the input variables. Thus the function returns always the same noisy data for a given pair of variables.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/scatterPlotDS.md b/docs/reference/scatterPlotDS.md new file mode 100644 index 00000000..1cf95839 --- /dev/null +++ b/docs/reference/scatterPlotDS.md @@ -0,0 +1,63 @@ +# Calculates the coordinates of the data to be plot + +This function uses two disclosure control methods to generate +non-disclosive coordinates that are returned to the client that +generates the non-disclosive scatter plots. + +## Usage + +``` r +scatterPlotDS(x, y, method.indicator, k, noise) +``` + +## Arguments + +- x: + + the name of a numeric vector, the x-variable. + +- y: + + the name of a numeric vector, the y-variable. + +- method.indicator: + + an integer either 1 or 2. If the user selects the deterministic method + in the client side function the method.indicator is set to 1 while if + the user selects the probabilistic method this argument is set to 2. + +- k: + + the number of the nearest neighbours for which their centroid is + calculated if the deterministic method is selected. + +- noise: + + the percentage of the initial variance that is used as the variance of + the embedded noise if the probabilistic method is selected. + +## Value + +a list with the x and y coordinates of the data to be plot + +## Details + +If the user chooses the deterministic approach, the function finds the +k-1 nearest neighbours of each data point in a 2-dimensional space. The +nearest neighbours are the data points with the minimum Euclidean +distances from the point of interest. Each point of interest and its k-1 +nearest neighbours are then used for the calculation of the coordinates +of the centroid of those k points. Centroid here is referred to the +centre of mass, i.e. the x-coordinate of the centroid is the average +value of the x-coordinates of the k nearest neighbours and the +y-coordinate of the centroid is the average of the y-coordinates of the +k nearest neighbours. If the user chooses the probabilistic approach, +the function adds random noise to \$x\$ and \$y\$ separately. Each +random noise follows a normal distribution with zero mean and variance +equal to 10 disclosure we fix the random number generator in a value +that is specified by the input variables. Thus the function returns +always the same noisy data for a given pair of variables. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/seqDS.html b/docs/reference/seqDS.html index 34a78997..2b4ae7b2 100644 --- a/docs/reference/seqDS.html +++ b/docs/reference/seqDS.html @@ -1,49 +1,42 @@ -seqDS a serverside assign function called by ds.seq — seqDS • dsBase - - -
    -
    -
    -
    -

    seqDS a serverside assign function called by ds.seq

    + - + + + +
    +
    +
    +
    + +

    seqDS a serverside assign function called by ds.seq

    + +
    seqDS.Rd
    -
    +

    assign function seqDS called by ds.seq

    -
    +
    +

    Usage

    seqDS(
   FROM.value.char,
   TO.value.char,
@@ -53,8 +46,8 @@ 
    seqDS a serverside assign function called by ds.seq
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    FROM.value.char
    @@ -94,8 +87,8 @@

    Arguments

    of ds.seq.

    -
    -

    Value

    +
    +

    Value

    the object specified by the <newobj> argument of ds.seq (or its default name newObj) which is written to the serverside. @@ -113,8 +106,8 @@

    Value

    without problems no studysideMessage will have been saved and ds.message("<newobj>") will return the message: "ALL OK: there are no studysideMessage(s) on this datasource".

    -
    -

    Details

    +
    +

    Details

    An assign function that uses the native R function seq() to create any one of a flexible range of sequence vectors that can then be used to help manage and analyse data. As it is an assign function the resultant vector is @@ -122,28 +115,24 @@

    Details

    see "details" for ds.seq for more information about allowable combinations of arguments etc.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team, 17/9/2019

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/seqDS.md b/docs/reference/seqDS.md new file mode 100644 index 00000000..dce47c0e --- /dev/null +++ b/docs/reference/seqDS.md @@ -0,0 +1,81 @@ +# seqDS a serverside assign function called by ds.seq + +assign function seqDS called by ds.seq + +## Usage + +``` r +seqDS( + FROM.value.char, + TO.value.char, + BY.value.char, + LENGTH.OUT.value.char, + ALONG.WITH.name +) +``` + +## Arguments + +- FROM.value.char: + + the starting value for the sequence expressed as an integer or real + number with a decimal point but in character form. Fully specified by + \ argument of `ds.seq`. + +- TO.value.char: + + the terminal value for the sequence expressed as an integer or real + number with a decimal point but in character form. Fully specified by + \ argument of `ds.seq`. + +- BY.value.char: + + the value to increment each step in the sequence expressed as an + integer or real number with a decimal point but in character form. + Fully specified by \ argument of `ds.seq`. + +- LENGTH.OUT.value.char: + + length of the sequence at which point its extension should be stopped, + expressed as an integer or real number with a decimal point but in + character form. Fully specified by \ argument + of `ds.seq`. + +- ALONG.WITH.name: + + For convenience, rather than specifying a value for LENGTH.OUT it can + often be better to specify a variable name as the \ + argument. Fully specified by \ argument of `ds.seq`. + +## Value + +the object specified by the \ argument of `ds.seq` (or its +default name newObj) which is written to the serverside. As well as +writing the output object as \ on the serverside, two validity +messages are returned indicating whether \ has been created in +each data source and if so whether it is in a valid form. If its form is +not valid in at least one study - e.g. because a disclosure trap was +tripped and creation of the full output object was blocked - `ds.seq()` +also returns any studysideMessages that can explain the error in +creating the full output object. As well as appearing on the screen at +run time,if you wish to see the relevant studysideMessages at a later +date you can use the `ds.message` function. If you type +ds.message("\") it will print out the relevant studysideMessage +from any datasource in which there was an error in creating \ +and a studysideMessage was saved. If there was no error and \ +was created without problems no studysideMessage will have been saved +and ds.message("\") will return the message: "ALL OK: there are +no studysideMessage(s) on this datasource". + +## Details + +An assign function that uses the native R function seq() to create any +one of a flexible range of sequence vectors that can then be used to +help manage and analyse data. As it is an assign function the resultant +vector is written as a new object into all of the specified data source +servers. Please see "details" for `ds.seq` for more information about +allowable combinations of arguments etc. + +## Author + +Paul Burton for DataSHIELD Development Team, 17/9/2019 diff --git a/docs/reference/setSeedDS.html b/docs/reference/setSeedDS.html index 4e49ec86..1d0b9286 100644 --- a/docs/reference/setSeedDS.html +++ b/docs/reference/setSeedDS.html @@ -1,56 +1,50 @@ -setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS • dsBase - - -
    -
    -
    -
    -

    setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom

    + - + + + +
    +
    +
    +
    + +

    setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom

    + +
    setSeedDS.Rd
    -
    +

    An aggregate serverside function that primes the pseudorandom number generator in a data source

    -
    +
    +

    Usage

    setSeedDS(seedtext = NULL, kind = NULL, normal.kind = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    seedtext
    @@ -70,14 +64,14 @@

    Arguments

    see help for set.seed() function in native R

    -
    -

    Value

    +
    +

    Value

    Sets the values of the vector of integers of length 626 known as .Random.seed on each data source that is the true current state of the random seed in each source.

    -
    -

    Details

    +
    +

    Details

    setSeedDS is effectively equivalent to the native R function set.seed() and so the help for that function can provide many additional details. The only very minor difference is that the @@ -97,28 +91,24 @@

    Details

    the development team can be approached, but unless you are actually doing theoretical work with random number generators it is likely that the

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/setSeedDS.md b/docs/reference/setSeedDS.md new file mode 100644 index 00000000..115b18cb --- /dev/null +++ b/docs/reference/setSeedDS.md @@ -0,0 +1,60 @@ +# setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom + +An aggregate serverside function that primes the pseudorandom number +generator in a data source + +## Usage + +``` r +setSeedDS(seedtext = NULL, kind = NULL, normal.kind = NULL) +``` + +## Arguments + +- seedtext: + + this is simply the value of the \ argument of + ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois of ds.rBinom coerced into + character format. This is done by the clientside functions themselves + and does not require the DataSHIELD user to do anything. Please see + the help for these clientside functions, and in particular, the + information for the argument \ for more details. + +- kind: + + see help for set.seed() function in native R + +- normal.kind: + + see help for set.seed() function in native R + +## Value + +Sets the values of the vector of integers of length 626 known as +.Random.seed on each data source that is the true current state of the +random seed in each source. + +## Details + +setSeedDS is effectively equivalent to the native R function set.seed() +and so the help for that function can provide many additional details. +The only very minor difference is that the first argument of setSeedDS, +\ takes the integer priming seed in character format. +However, for the user that integer is still specified directly as an +integer as the \ argument of one of the clientside +functions ds.setSeed, ds.rNorm ..... Each of these clientside functions +coerces the integer to character format calls setSeedDS and the first +active line of code in setSeedDS converts the character string back to +an integer and treats it as the first argument \ of the native R +function set.seed(). The two other arguments of set.seed() in native R, +\ and \ are both defaulted by specifying them as +NULL. This defaulting is hard wired into the setSeedDS function and as +this cannot be changed by the analyst it means that setSeedDS is much +less flexible than native R's set.seed() function. If any DataSHIELD +user requires some aspect of this flexibility returned the development +team can be approached, but unless you are actually doing theoretical +work with random number generators it is likely that the + +## Author + +Paul Burton for DataSHIELD Development Team diff --git a/docs/reference/skewnessDS1.html b/docs/reference/skewnessDS1.html index e5e3fb6b..084bba82 100644 --- a/docs/reference/skewnessDS1.html +++ b/docs/reference/skewnessDS1.html @@ -1,54 +1,47 @@ -Calculates the skewness of a numeric variable — skewnessDS1 • dsBase - - -
    -
    -
    -
    -

    Calculates the skewness of a numeric variable

    + - + + + +
    +
    +
    +
    + +

    Calculates the skewness of a numeric variable

    + +
    skewnessDS1.Rd
    -
    +

    This function calculates the skewness of a numeric variable for each study separately.

    -
    +
    +

    Usage

    skewnessDS1(x, method)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -60,38 +53,34 @@

    Arguments

    detailed in the headers of the client-side ds.skewness function.

    -
    -

    Value

    +
    +

    Value

    a list including the skewness of the input numeric variable, the number of valid observations and the study-side validity message.

    -
    -

    Details

    +
    +

    Details

    The function calculates the skewness of an input variable x with three different methods. The method is specified by the argument method in the client-side ds.skewness function.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/skewnessDS1.md b/docs/reference/skewnessDS1.md new file mode 100644 index 00000000..3a1a8303 --- /dev/null +++ b/docs/reference/skewnessDS1.md @@ -0,0 +1,37 @@ +# Calculates the skewness of a numeric variable + +This function calculates the skewness of a numeric variable for each +study separately. + +## Usage + +``` r +skewnessDS1(x, method) +``` + +## Arguments + +- x: + + a string character, the name of a numeric variable. + +- method: + + an integer between 1 and 3 selecting one of the algorithms for + computing skewness detailed in the headers of the client-side + `ds.skewness` function. + +## Value + +a list including the skewness of the input numeric variable, the number +of valid observations and the study-side validity message. + +## Details + +The function calculates the skewness of an input variable x with three +different methods. The method is specified by the argument `method` in +the client-side `ds.skewness` function. + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/skewnessDS2.html b/docs/reference/skewnessDS2.html index f86c7490..8e2b0bbc 100644 --- a/docs/reference/skewnessDS2.html +++ b/docs/reference/skewnessDS2.html @@ -1,56 +1,50 @@ -Calculates the skewness of a numeric variable — skewnessDS2 • dsBase - - -
    -
    -
    -
    -

    Calculates the skewness of a numeric variable

    + - + + + +
    +
    +
    +
    + +

    Calculates the skewness of a numeric variable

    + +
    skewnessDS2.Rd
    -
    +

    This function calculates summary statistics that are returned to the client-side and used for the estimation of the combined skewness of a numeric variable across all studies.

    -
    +
    +

    Usage

    skewnessDS2(x, global.mean)
    -
    -

    Arguments

    +
    +

    Arguments

    x
    @@ -61,42 +55,38 @@

    Arguments

    a numeric, the combined mean of the input variable across all studies.

    -
    -

    Value

    +
    +

    Value

    a list including the sum of cubed differences between the values of x and the global mean of x across all studies, the sum of squared differences between the values of x and the global mean of x across all studies, the number of valid observations (i.e. the length of x after excluding missing values), and a validity message indicating indicating a valid analysis if the number of valid observations are above the protection filter nfilter.tab or invalid analysis otherwise.

    -
    -

    Details

    +
    +

    Details

    The function calculates the sum of squared differences between the values of x and the global mean of x across all studies, the sum of cubed differences between the values of x and the global mean of x across all studies and the number of valid observations of the input variable x.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/skewnessDS2.md b/docs/reference/skewnessDS2.md new file mode 100644 index 00000000..18a2d4d7 --- /dev/null +++ b/docs/reference/skewnessDS2.md @@ -0,0 +1,43 @@ +# Calculates the skewness of a numeric variable + +This function calculates summary statistics that are returned to the +client-side and used for the estimation of the combined skewness of a +numeric variable across all studies. + +## Usage + +``` r +skewnessDS2(x, global.mean) +``` + +## Arguments + +- x: + + a string character, the name of a numeric variable. + +- global.mean: + + a numeric, the combined mean of the input variable across all studies. + +## Value + +a list including the sum of cubed differences between the values of x +and the global mean of x across all studies, the sum of squared +differences between the values of x and the global mean of x across all +studies, the number of valid observations (i.e. the length of x after +excluding missing values), and a validity message indicating indicating +a valid analysis if the number of valid observations are above the +protection filter nfilter.tab or invalid analysis otherwise. + +## Details + +The function calculates the sum of squared differences between the +values of x and the global mean of x across all studies, the sum of +cubed differences between the values of x and the global mean of x +across all studies and the number of valid observations of the input +variable x. + +## Author + +Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/sqrtDS.html b/docs/reference/sqrtDS.html index e4685e8c..a8e01feb 100644 --- a/docs/reference/sqrtDS.html +++ b/docs/reference/sqrtDS.html @@ -1,94 +1,83 @@ -Computes the square root values of the input variable — sqrtDS • dsBase - - -
    -
    -
    -
    -

    Computes the square root values of the input variable

    + - + + + +
    +
    +
    +
    + +

    Computes the square root values of the input variable

    + +
    sqrtDS.Rd
    -
    +

    This function is similar to R function sqrt.

    -
    +
    +

    Usage

    sqrtDS(x)
    -
    -

    Arguments

    +
    +

    Arguments

    x

    a string character, the name of a numeric or integer vector

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument of ds.sqrt (or default name sqrt.newobj) which is written to the server-side. The output object is of class numeric or integer.

    -
    -

    Details

    +
    +

    Details

    The function computes the square root values of an input numeric or integer vector.

    -
    -

    Author

    +
    +

    Author

    Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/sqrtDS.md b/docs/reference/sqrtDS.md new file mode 100644 index 00000000..867e5495 --- /dev/null +++ b/docs/reference/sqrtDS.md @@ -0,0 +1,30 @@ +# Computes the square root values of the input variable + +This function is similar to R function `sqrt`. + +## Usage + +``` r +sqrtDS(x) +``` + +## Arguments + +- x: + + a string character, the name of a numeric or integer vector + +## Value + +the object specified by the `newobj` argument of `ds.sqrt` (or default +name `sqrt.newobj`) which is written to the server-side. The output +object is of class numeric or integer. + +## Details + +The function computes the square root values of an input numeric or +integer vector. + +## Author + +Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/subsetByClassDS.html b/docs/reference/subsetByClassDS.html index 92b0197c..2ffc23ef 100644 --- a/docs/reference/subsetByClassDS.html +++ b/docs/reference/subsetByClassDS.html @@ -1,58 +1,53 @@ -Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS • dsBaseBreaks down a dataframe or a factor into its sub-classes — subsetByClassDS • dsBase - - -
    -
    -
    -
    -

    Breaks down a dataframe or a factor into its sub-classes

    - +
    +
    +
    +
    + +

    Breaks down a dataframe or a factor into its sub-classes

    + +
    subsetByClassDS.Rd
    -
    +

    The function takes a categorical vector or dataframe as input and generates subset(s) vectors or dataframes for each category. Subsets are considered invalid if they hold between 1 and 4 observations.

    -
    +
    +

    Usage

    subsetByClassDS(data = NULL, variables = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    data
    @@ -63,12 +58,12 @@

    Arguments

    a vector of string characters, the names of the the variables to subset on.

    -
    -

    Value

    +
    +

    Value

    a list which contains the subsetted datasets

    -
    -

    Details

    +
    +

    Details

    If the input data object is a dataframe it is possible to specify the variables to subset on. If a subset is not 'valid' all its the values are reported as missing (i.e. NA), the name of the subsets is labelled as '_INVALID'. If no variables are specified to subset on, @@ -76,28 +71,24 @@

    Details

    And if none of the columns holds a factor variable a message is issued as output. A message is also issued as output if the input vector is not of type factor.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/subsetByClassDS.md b/docs/reference/subsetByClassDS.md new file mode 100644 index 00000000..b4ee99c9 --- /dev/null +++ b/docs/reference/subsetByClassDS.md @@ -0,0 +1,41 @@ +# Breaks down a dataframe or a factor into its sub-classes + +The function takes a categorical vector or dataframe as input and +generates subset(s) vectors or dataframes for each category. Subsets are +considered invalid if they hold between 1 and 4 observations. + +## Usage + +``` r +subsetByClassDS(data = NULL, variables = NULL) +``` + +## Arguments + +- data: + + a string character, the name of the dataframe or the factor vector + +- variables: + + a vector of string characters, the names of the the variables to + subset on. + +## Value + +a list which contains the subsetted datasets + +## Details + +If the input data object is a dataframe it is possible to specify the +variables to subset on. If a subset is not 'valid' all its the values +are reported as missing (i.e. NA), the name of the subsets is labelled +as '\_INVALID'. If no variables are specified to subset on, the +dataframe will be subset on each of its factor variables. And if none of +the columns holds a factor variable a message is issued as output. A +message is also issued as output if the input vector is not of type +factor. + +## Author + +Gaye, A. diff --git a/docs/reference/subsetDS.html b/docs/reference/subsetDS.html index 9a8aa624..2d7865a8 100644 --- a/docs/reference/subsetDS.html +++ b/docs/reference/subsetDS.html @@ -1,53 +1,48 @@ -Generates a valid subset of a table or a vector — subsetDS • dsBaseGenerates a valid subset of a table or a vector — subsetDS • dsBase - - -
    -
    -
    -
    -

    Generates a valid subset of a table or a vector

    - +
    +
    +
    +
    + +

    Generates a valid subset of a table or a vector

    + +
    subsetDS.Rd
    -
    +

    The function uses the R classical subsetting with squared brackets '[]' and allows also to subset using a logical operator and a threshold. The object to subset from must be a vector (factor, numeric or character) or a table (data.frame or matrix).

    -
    +
    +

    Usage

    subsetDS(
   dt = NULL,
   complt = NULL,
@@ -59,8 +54,8 @@ 
    Generates a valid subset of a table or a vector
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    dt
    @@ -96,12 +91,12 @@

    Arguments

    'rows' and/or 'cols' are provided.

    -
    -

    Value

    +
    +

    Value

    a subset of the vector, matrix or dataframe as specified is stored on the server side

    -
    -

    Details

    +
    +

    Details

    If the input data is a table: The user specifies the rows and/or columns to include in the subset if the input object is a table; the columns can be referred to by their names. The name of a vector (i.e. a variable) can also be provided with a logical operator and a threshold (see example 3). @@ -111,28 +106,24 @@

    Details

    number of observations), the subset is not generated, rather a table or a vector of missing values is generated to allow for any subsequent process using the output of the function to proceed after informing the user via a message.

    -
    -

    Author

    +
    +

    Author

    Gaye, A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/subsetDS.md b/docs/reference/subsetDS.md new file mode 100644 index 00000000..11059bdc --- /dev/null +++ b/docs/reference/subsetDS.md @@ -0,0 +1,86 @@ +# Generates a valid subset of a table or a vector + +The function uses the R classical subsetting with squared brackets +'\[\]' and allows also to subset using a logical operator and a +threshold. The object to subset from must be a vector (factor, numeric +or character) or a table (data.frame or matrix). + +## Usage + +``` r +subsetDS( + dt = NULL, + complt = NULL, + rs = NULL, + cs = NULL, + lg = NULL, + th = NULL, + varname = NULL +) +``` + +## Arguments + +- dt: + + a string character, the name of the dataframe or the factor vector and + the range of the subset. + +- complt: + + a boolean that tells if the subset to subset should include only + complete cases + +- rs: + + a vector of two integers that give the range of rows de extract. + +- cs: + + a vector of two integers or one or more characters; the indices of the + columns to extract or the names of the columns (i.e. names of the + variables to extract). + +- lg: + + a character, the logical parameter to use if the user wishes to subset + a vector using a logical operator. This parameter is ignored if the + input data is not a vector. + +- th: + + a numeric, the threshold to use in conjunction with the logical + parameter. This parameter is ignored if the input data is not a + vector. + +- varname: + + a character, if the input data is a table, if this parameter is + provided along with the 'logical' and 'threshold' parameters, a + subtable is based the threshold applied to the specified variable. + This parameter is however ignored if the parameter 'rows' and/or + 'cols' are provided. + +## Value + +a subset of the vector, matrix or dataframe as specified is stored on +the server side + +## Details + +If the input data is a table: The user specifies the rows and/or columns +to include in the subset if the input object is a table; the columns can +be referred to by their names. The name of a vector (i.e. a variable) +can also be provided with a logical operator and a threshold (see +example 3). If the input data is a vector: when the parameters 'rows', +'logical' and 'threshold' are all provided the last two are ignored ( +'rows' has precedence over the other two parameters then). If the +requested subset is not valid (i.e. contains less than the allowed +number of observations), the subset is not generated, rather a table or +a vector of missing values is generated to allow for any subsequent +process using the output of the function to proceed after informing the +user via a message. + +## Author + +Gaye, A. diff --git a/docs/reference/table1DDS.html b/docs/reference/table1DDS.html index 3df80b76..9bedc43b 100644 --- a/docs/reference/table1DDS.html +++ b/docs/reference/table1DDS.html @@ -1,97 +1,87 @@ -Creates 1-dimensional contingency tables — table1DDS • dsBase - - -
    -
    -
    -
    -

    Creates 1-dimensional contingency tables

    + - + + + +
    +
    +
    +
    + +

    Creates 1-dimensional contingency tables

    + +
    table1DDS.Rd
    -
    +

    This function generates a 1-dimensional table where potentially disclosive cells. (based on the set threshold) are replaced by a missing value ('NA').

    -
    +
    +

    Usage

    table1DDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a numerical vector with discrete values - usually a factor.

    -
    -

    Value

    +
    +

    Value

    a list which contains two elements: 'table', the 1-dimensional table and 'message' a message which informs about the validity of the table.

    -
    -

    Details

    +
    +

    Details

    It generates a 1-dimensional tables where valid (non-disclosive) 1-dimensional tables are defined as data from sources where no table cells have counts between 1 and the set threshold. When the output table is invalid all cells but the total count are replaced by missing values. Only the total count is visible on the table returned to the client side. A message is also returned with the 1-dimensional; the message says "invalid table - invalid counts present" if the table is invalid and 'valid table' otherwise.

    -
    -

    Author

    +
    +

    Author

    Gaye A.

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/table1DDS.md b/docs/reference/table1DDS.md new file mode 100644 index 00000000..9ef5e7f7 --- /dev/null +++ b/docs/reference/table1DDS.md @@ -0,0 +1,37 @@ +# Creates 1-dimensional contingency tables + +This function generates a 1-dimensional table where potentially +disclosive cells. (based on the set threshold) are replaced by a missing +value ('NA'). + +## Usage + +``` r +table1DDS(xvect) +``` + +## Arguments + +- xvect: + + a numerical vector with discrete values - usually a factor. + +## Value + +a list which contains two elements: 'table', the 1-dimensional table and +'message' a message which informs about the validity of the table. + +## Details + +It generates a 1-dimensional tables where valid (non-disclosive) +1-dimensional tables are defined as data from sources where no table +cells have counts between 1 and the set threshold. When the output table +is invalid all cells but the total count are replaced by missing values. +Only the total count is visible on the table returned to the client +side. A message is also returned with the 1-dimensional; the message +says "invalid table - invalid counts present" if the table is invalid +and 'valid table' otherwise. + +## Author + +Gaye A. diff --git a/docs/reference/table2DDS.html b/docs/reference/table2DDS.html index 46cc9336..5dc9357f 100644 --- a/docs/reference/table2DDS.html +++ b/docs/reference/table2DDS.html @@ -1,56 +1,50 @@ -table2DDS (aggregate function) called by ds.table2D — table2DDS • dsBase - - -
    -
    -
    -
    -

    table2DDS (aggregate function) called by ds.table2D

    + - + + + +
    +
    +
    +
    + +

    table2DDS (aggregate function) called by ds.table2D

    + +
    table2DDS.Rd
    -
    +

    This function generates a 2-dimensional contingency table where potentially disclosive cells (based on a set threshold) are replaced by a missing value ('NA').

    -
    +
    +

    Usage

    table2DDS(xvect, yvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect
    @@ -61,41 +55,37 @@

    Arguments

    a numerical vector with discrete values - usually a factor.

    -
    -

    Value

    +
    +

    Value

    a list which contains two elements: 'table', the 2-dimensional table and 'message' a message which informs about the validity of the table.

    -
    -

    Details

    +
    +

    Details

    It generates 2-dimensional contingency tables where valid (non-disclosive) tables are defined as those where none of their cells have counts between 1 and the set threshold "nfilter.tab". When the output table is invalid all cells except the total counts are replaced by missing values. Only the total counts are visible on the table returned to the client side. A message is also returned with the 2-dimensional table; the message says "invalid table - invalid counts present" if the table is invalid and 'valid table' otherwise.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/table2DDS.md b/docs/reference/table2DDS.md new file mode 100644 index 00000000..655e2396 --- /dev/null +++ b/docs/reference/table2DDS.md @@ -0,0 +1,42 @@ +# table2DDS (aggregate function) called by ds.table2D + +This function generates a 2-dimensional contingency table where +potentially disclosive cells (based on a set threshold) are replaced by +a missing value ('NA'). + +## Usage + +``` r +table2DDS(xvect, yvect) +``` + +## Arguments + +- xvect: + + a numerical vector with discrete values - usually a factor. + +- yvect: + + a numerical vector with discrete values - usually a factor. + +## Value + +a list which contains two elements: 'table', the 2-dimensional table and +'message' a message which informs about the validity of the table. + +## Details + +It generates 2-dimensional contingency tables where valid +(non-disclosive) tables are defined as those where none of their cells +have counts between 1 and the set threshold "nfilter.tab". When the +output table is invalid all cells except the total counts are replaced +by missing values. Only the total counts are visible on the table +returned to the client side. A message is also returned with the +2-dimensional table; the message says "invalid table - invalid counts +present" if the table is invalid and 'valid table' otherwise. + +## Author + +Amadou Gaye, Paul Burton, Demetris Avraam for DataSHIELD Development +Team diff --git a/docs/reference/tableDS.assign.html b/docs/reference/tableDS.assign.html index 60498ea1..6ffa07a5 100644 --- a/docs/reference/tableDS.assign.html +++ b/docs/reference/tableDS.assign.html @@ -1,51 +1,45 @@ -tableDS.assign is the serverside assign function called by ds.table — tableDS.assign • dsBase - - -
    -
    -
    -
    -

    tableDS.assign is the serverside assign function called by ds.table

    + - + + + +
    +
    +
    +
    + +

    tableDS.assign is the serverside assign function called by ds.table

    + +
    tableDS.assign.Rd
    -
    +

    helps creates 1-dimensional, 2-dimensional and 3-dimensional tables using the table function in native R.

    -
    +
    +

    Usage

    tableDS.assign(
   rvar.transmit,
   cvar.transmit,
@@ -58,8 +52,8 @@ 
    tableDS.assign is the serverside assign function called by ds.table
    
 )
    -
    -

    Arguments

    +
    +

    Arguments

    rvar.transmit
    @@ -109,12 +103,12 @@

    Arguments

    of ds.table. Fully specified by <useNA> argument of ds.table

    -
    -

    Value

    +
    +

    Value

    For information see help for ds.table

    -
    -

    Details

    +
    +

    Details

    If the <table.assign> argument of ds.table is set to TRUE, this assign function writes the the table requested in the format specified by ds.table function @@ -122,28 +116,24 @@

    Details

    information see help for ds.table in DataSHIELD and the table function in native R.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team, 13/11/2019

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/tableDS.assign.md b/docs/reference/tableDS.assign.md new file mode 100644 index 00000000..ff8b2d18 --- /dev/null +++ b/docs/reference/tableDS.assign.md @@ -0,0 +1,83 @@ +# tableDS.assign is the serverside assign function called by ds.table + +helps creates 1-dimensional, 2-dimensional and 3-dimensional tables +using the `table` function in native R. + +## Usage + +``` r +tableDS.assign( + rvar.transmit, + cvar.transmit, + stvar.transmit, + rvar.all.unique.levels.transmit, + cvar.all.unique.levels.transmit, + stvar.all.unique.levels.transmit, + exclude.transmit, + useNA.transmit +) +``` + +## Arguments + +- rvar.transmit: + + is a character string (in inverted commas) specifying the name of the + variable defining the rows in all of the 2 dimensional tables that + form the output. Fully specified by \ argument in `ds.table`. + For more information see help for `ds.table` + +- cvar.transmit: + + is a character string specifying the name of the variable defining the + columns in all of the 2 dimensional tables that form the output. Fully + specified by \ argument in `ds.table`. For more information see + help for `ds.table` + +- stvar.transmit: + + is a character string specifying the name of the variable that indexes + the separate two dimensional tables in the output if the call + specifies a 3 dimensional table. Fully specified by \ argument + in `ds.table`. For more information see help for `ds.table` + +- rvar.all.unique.levels.transmit: + + is a character string containing all unique level in rvar, across the + studies, separated by ','. + +- cvar.all.unique.levels.transmit: + + is a character string containing all unique level in cvar, across the + studies, separated by ','. + +- stvar.all.unique.levels.transmit: + + is a character string containing all unique level in stvar, across the + studies, separated by ','. + +- exclude.transmit: + + for information see help on \ argument of `ds.table`. Fully + specified by \ argument of `ds.table` + +- useNA.transmit: + + for information see help on \ argument of `ds.table`. Fully + specified by \ argument of `ds.table` + +## Value + +For information see help for `ds.table` + +## Details + +If the \ argument of `ds.table` is set to TRUE, this +assign function writes the the table requested in the format specified +by `ds.table` function as an object named by the \ argument of +`ds.table`. For more information see help for `ds.table` in DataSHIELD +and the `table` function in native R. + +## Author + +Paul Burton for DataSHIELD Development Team, 13/11/2019 diff --git a/docs/reference/tableDS.html b/docs/reference/tableDS.html index ad0ace8f..fe6f66e1 100644 --- a/docs/reference/tableDS.html +++ b/docs/reference/tableDS.html @@ -1,51 +1,45 @@ -tableDS is the first of two serverside aggregate functions called by ds.table — tableDS • dsBase - - -
    -
    -
    -
    -

    tableDS is the first of two serverside aggregate functions called by ds.table

    + - + + + +
    +
    +
    +
    + +

    tableDS is the first of two serverside aggregate functions called by ds.table

    + +
    tableDS.Rd
    -
    +

    creates 1-dimensional, 2-dimensional and 3-dimensional tables using the table function in native R.

    -
    +
    +

    Usage

    tableDS(
   rvar.transmit,
   cvar.transmit,
@@ -59,8 +53,8 @@ 
    tableDS is the first of two serverside aggregate functions called by ds.tabl
 )
    -
    -

    Arguments

    +
    +

    Arguments

    rvar.transmit
    @@ -115,39 +109,35 @@

    Arguments

    of ds.table. Fully specified by <force.nfilter> argument of ds.table

    -
    -

    Value

    +
    +

    Value

    For information see help for ds.table

    -
    -

    Details

    +
    +

    Details

    this serverside function is the workhorse of ds.table - creating the table requested in the format specified by ds.table. For more information see help for ds.table in DataSHIELD and the table function in native R.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team, 13/11/2019

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/tableDS.md b/docs/reference/tableDS.md new file mode 100644 index 00000000..e5f9bdc1 --- /dev/null +++ b/docs/reference/tableDS.md @@ -0,0 +1,88 @@ +# tableDS is the first of two serverside aggregate functions called by ds.table + +creates 1-dimensional, 2-dimensional and 3-dimensional tables using the +`table` function in native R. + +## Usage + +``` r +tableDS( + rvar.transmit, + cvar.transmit, + stvar.transmit, + rvar.all.unique.levels.transmit, + cvar.all.unique.levels.transmit, + stvar.all.unique.levels.transmit, + exclude.transmit, + useNA.transmit, + force.nfilter.transmit +) +``` + +## Arguments + +- rvar.transmit: + + is a character string (in inverted commas) specifying the name of the + variable defining the rows in all of the 2 dimensional tables that + form the output. Fully specified by \ argument in `ds.table`. + For more information see help for `ds.table` + +- cvar.transmit: + + is a character string specifying the name of the variable defining the + columns in all of the 2 dimensional tables that form the output. Fully + specified by \ argument in `ds.table`. For more information see + help for `ds.table` + +- stvar.transmit: + + is a character string specifying the name of the variable that indexes + the separate two dimensional tables in the output if the call + specifies a 3 dimensional table. Fully specified by \ argument + in `ds.table`. For more information see help for `ds.table` + +- rvar.all.unique.levels.transmit: + + is a character string containing all unique level in rvar, across the + studies, separated by ','. + +- cvar.all.unique.levels.transmit: + + is a character string containing all unique level in cvar, across the + studies, separated by ','. + +- stvar.all.unique.levels.transmit: + + is a character string containing all unique level in stvar, across the + studies, separated by ','. + +- exclude.transmit: + + for information see help on \ argument of `ds.table`. Fully + specified by \ argument of `ds.table` + +- useNA.transmit: + + for information see help on \ argument of `ds.table`. Fully + specified by \ argument of `ds.table` + +- force.nfilter.transmit: + + for information see help on \ argument of `ds.table`. + Fully specified by \ argument of `ds.table` + +## Value + +For information see help for `ds.table` + +## Details + +this serverside function is the workhorse of `ds.table` - creating the +table requested in the format specified by `ds.table`. For more +information see help for `ds.table` in DataSHIELD and the `table` +function in native R. + +## Author + +Paul Burton for DataSHIELD Development Team, 13/11/2019 diff --git a/docs/reference/tableDS2.html b/docs/reference/tableDS2.html index 05b130b5..62a1f762 100644 --- a/docs/reference/tableDS2.html +++ b/docs/reference/tableDS2.html @@ -1,56 +1,50 @@ -tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2 • dsBase - - -
    -
    -
    -
    -

    tableDS is the second of two serverside aggregate functions called by ds.table

    + - + + + +
    +
    +
    +
    + +

    tableDS is the second of two serverside aggregate functions called by ds.table

    + +
    tableDS2.Rd
    -
    +

    Helps creates 1-dimensional, 2-dimensional and 3-dimensional tables using the table function in native R.

    -
    +
    +

    Usage

    tableDS2(newobj, rvar.transmit, cvar.transmit, stvar.transmit)
    -
    -

    Arguments

    +
    +

    Arguments

    newobj
    @@ -84,40 +78,36 @@

    Arguments

    For more information see help for ds.table

    -
    -

    Value

    +
    +

    Value

    For information see help for ds.table

    -
    -

    Details

    +
    +

    Details

    If the <table.assign> argument of ds.table is set to TRUE, this aggregate function returns non-disclosive information about the table object written to the serverside by tableDS.assign. For more information see help for ds.table, tableDS.assign and tableDS in DataSHIELD and the table function in native R.

    -
    -

    Author

    +
    +

    Author

    Paul Burton for DataSHIELD Development Team, 13/11/2019

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/tableDS2.md b/docs/reference/tableDS2.md new file mode 100644 index 00000000..bbe86466 --- /dev/null +++ b/docs/reference/tableDS2.md @@ -0,0 +1,58 @@ +# tableDS is the second of two serverside aggregate functions called by ds.table + +Helps creates 1-dimensional, 2-dimensional and 3-dimensional tables +using the `table` function in native R. + +## Usage + +``` r +tableDS2(newobj, rvar.transmit, cvar.transmit, stvar.transmit) +``` + +## Arguments + +- newobj: + + this a character string providing a name for the output table object + to be written to the serverside if \ is TRUE. If no + explicit name for the table object is specified, but \ + is nevertheless TRUE, the name for the serverside table object + defaults to 'newObj'. Fully specified by \ argument in + `ds.table`. For more information see help for `ds.table` + +- rvar.transmit: + + is a character string (in inverted commas) specifying the name of the + variable defining the rows in all of the 2 dimensional tables that + form the output. Fully specified by \ argument in `ds.table`. + For more information see help for `ds.table` + +- cvar.transmit: + + is a character string specifying the name of the variable defining the + columns in all of the 2 dimensional tables that form the output. Fully + specified by \ argument in `ds.table`. For more information see + help for `ds.table` + +- stvar.transmit: + + is a character string specifying the name of the variable that indexes + the separate two dimensional tables in the output if the call + specifies a 3 dimensional table. Fully specified by \ argument + in `ds.table`. For more information see help for `ds.table` + +## Value + +For information see help for `ds.table` + +## Details + +If the \ argument of `ds.table` is set to TRUE, this +aggregate function returns non-disclosive information about the table +object written to the serverside by `tableDS.assign`. For more +information see help for `ds.table`, `tableDS.assign` and `tableDS` in +DataSHIELD and the `table` function in native R. + +## Author + +Paul Burton for DataSHIELD Development Team, 13/11/2019 diff --git a/docs/reference/tapplyDS.assign.html b/docs/reference/tapplyDS.assign.html index 8ebff9e1..6d49ecd2 100644 --- a/docs/reference/tapplyDS.assign.html +++ b/docs/reference/tapplyDS.assign.html @@ -1,58 +1,53 @@ -tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign • dsBasetapplyDS.assign called by ds.tapply.assign — tapplyDS.assign • dsBase - - -
    -
    -
    -
    -

    tapplyDS.assign called by ds.tapply.assign

    - +
    +
    +
    +
    + +

    tapplyDS.assign called by ds.tapply.assign

    + +
    tapplyDS.assign.Rd
    -
    +

    Apply one of a selected range of functions to summarize an outcome variable over one or more indexing factors and write the resultant summary as a newobj on the serverside

    -
    +
    +

    Usage

    tapplyDS.assign(X.name, INDEX.names.transmit, FUN.name)
    -
    -

    Arguments

    +
    +

    Arguments

    X.name,
    @@ -71,37 +66,33 @@

    Arguments

    Specified via argument <FUN.name> of ds.tapply.assign function.

    -
    -

    Value

    +
    +

    Value

    an array of the summarized values created by the tapplyDS.assign function. This array is written as a newobj on the serverside. It has the same number of dimensions as INDEX.

    -
    -

    Details

    +
    +

    Details

    see details for ds.tapply.assign function

    -
    -

    Author

    +
    +

    Author

    Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/tapplyDS.assign.md b/docs/reference/tapplyDS.assign.md new file mode 100644 index 00000000..0a9ffe83 --- /dev/null +++ b/docs/reference/tapplyDS.assign.md @@ -0,0 +1,43 @@ +# tapplyDS.assign called by ds.tapply.assign + +Apply one of a selected range of functions to summarize an outcome +variable over one or more indexing factors and write the resultant +summary as a newobj on the serverside + +## Usage + +``` r +tapplyDS.assign(X.name, INDEX.names.transmit, FUN.name) +``` + +## Arguments + +- X.name, : + + the name of the variable to be summarized. Specified via argument + \ of `ds.tapply.assign` function + +- INDEX.names.transmit, : + + the name of a single factor or a vector of names of factors to index + the variable to be summarized. Specified via argument \ + of `ds.tapply.assign` function + +- FUN.name, : + + the name of one of the allowable summarizing functions to be applied. + Specified via argument \ of `ds.tapply.assign` function. + +## Value + +an array of the summarized values created by the `tapplyDS.assign` +function. This array is written as a newobj on the serverside. It has +the same number of dimensions as INDEX. + +## Details + +see details for `ds.tapply.assign` function + +## Author + +Paul Burton, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/tapplyDS.html b/docs/reference/tapplyDS.html index 36a9d184..a52697f2 100644 --- a/docs/reference/tapplyDS.html +++ b/docs/reference/tapplyDS.html @@ -1,58 +1,53 @@ -tapplyDS called by ds.tapply — tapplyDS • dsBasetapplyDS called by ds.tapply — tapplyDS • dsBase - - -
    -
    -
    -
    -

    tapplyDS called by ds.tapply

    - +
    +
    +
    +
    + +

    tapplyDS called by ds.tapply

    + +
    tapplyDS.Rd
    -
    +

    Apply one of a selected range of functions to summarize an outcome variable over one or more indexing factors and write the resultant summary to the clientside

    -
    +
    +

    Usage

    tapplyDS(X.name, INDEX.names.transmit, FUN.name)
    -
    -

    Arguments

    +
    +

    Arguments

    X.name,
    @@ -71,37 +66,33 @@

    Arguments

    Specified via argument <FUN.name> of ds.tapply function.

    -
    -

    Value

    +
    +

    Value

    an array of the summarized values created by the tapplyDS function. This array is returned to the clientside. It has the same number of dimensions as INDEX.

    -
    -

    Details

    +
    +

    Details

    see details for ds.tapply function

    -
    -

    Author

    +
    +

    Author

    Paul Burton, Demetris Avraam for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/tapplyDS.md b/docs/reference/tapplyDS.md new file mode 100644 index 00000000..3f829bcd --- /dev/null +++ b/docs/reference/tapplyDS.md @@ -0,0 +1,43 @@ +# tapplyDS called by ds.tapply + +Apply one of a selected range of functions to summarize an outcome +variable over one or more indexing factors and write the resultant +summary to the clientside + +## Usage + +``` r +tapplyDS(X.name, INDEX.names.transmit, FUN.name) +``` + +## Arguments + +- X.name, : + + the name of the variable to be summarized. Specified via argument + \ of `ds.tapply` function + +- INDEX.names.transmit, : + + the name of a single factor or a vector of names of factors to index + the variable to be summarized. Specified via argument \ + of `ds.tapply` function + +- FUN.name, : + + the name of one of the allowable summarizing functions to be applied. + Specified via argument \ of `ds.tapply` function. + +## Value + +an array of the summarized values created by the tapplyDS function. This +array is returned to the clientside. It has the same number of +dimensions as INDEX. + +## Details + +see details for `ds.tapply` function + +## Author + +Paul Burton, Demetris Avraam for DataSHIELD Development Team diff --git a/docs/reference/testObjExistsDS.html b/docs/reference/testObjExistsDS.html index 489f9f7c..bfc7351f 100644 --- a/docs/reference/testObjExistsDS.html +++ b/docs/reference/testObjExistsDS.html @@ -1,54 +1,47 @@ -testObjExistsDS — testObjExistsDS • dsBase - - -
    -
    -
    -
    -

    testObjExistsDS

    + - + + + +
    +
    +
    +
    + +

    testObjExistsDS

    + +
    testObjExistsDS.Rd
    -
    +

    The server-side function called by ds.testObjExists

    -
    +
    +

    Usage

    testObjExistsDS(test.obj.name = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    test.obj.name
    @@ -56,39 +49,35 @@

    Arguments

    whose presence is to be tested in each data source

    -
    -

    Value

    +
    +

    Value

    List with `test.obj.exists` and `test.obj.class`

    -
    -

    Details

    +
    +

    Details

    Tests whether a given object exists in all sources. It is called at the end of all recently written assign functions to check the new (assigned) object has been created in all sources

    -
    -

    Author

    +
    +

    Author

    Burton PR

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/testObjExistsDS.md b/docs/reference/testObjExistsDS.md new file mode 100644 index 00000000..1c12056c --- /dev/null +++ b/docs/reference/testObjExistsDS.md @@ -0,0 +1,30 @@ +# testObjExistsDS + +The server-side function called by ds.testObjExists + +## Usage + +``` r +testObjExistsDS(test.obj.name = NULL) +``` + +## Arguments + +- test.obj.name: + + a client-side provided character string specifying the variable whose + presence is to be tested in each data source + +## Value + +List with \`test.obj.exists\` and \`test.obj.class\` + +## Details + +Tests whether a given object exists in all sources. It is called at the +end of all recently written assign functions to check the new (assigned) +object has been created in all sources + +## Author + +Burton PR diff --git a/docs/reference/unListDS.html b/docs/reference/unListDS.html index d7b8aaf4..dc1eef65 100644 --- a/docs/reference/unListDS.html +++ b/docs/reference/unListDS.html @@ -1,58 +1,53 @@ -unListDS a serverside assign function called by ds.unList — unListDS • dsBaseunListDS a serverside assign function called by ds.unList — unListDS • dsBase - - -
    -
    -
    -
    -

    unListDS a serverside assign function called by ds.unList

    - +
    +
    +
    +
    + +

    unListDS a serverside assign function called by ds.unList

    + +
    unListDS.Rd
    -
    +

    this function is based on the native R function unlist which coerces an object of list class back to the class it was when it was coerced into a list

    -
    +
    +

    Usage

    unListDS(x.name)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name
    @@ -61,8 +56,8 @@

    Arguments

    specified by the x.name argument of ds.unList

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument of the ds.unList function (or by default "unlist.newobj" if the newobj argument is NULL). This is written to the serverside. @@ -84,35 +79,31 @@

    Value

    function - one should check as far as one can the nature of the output from a call to ds.unList - e.g. ds.class, ds.length etc

    -
    -

    Details

    +
    +

    Details

    See details of the native R function unlist. This function represents a substantive restructuring of an earlier version created by Amadou Gaye. For further details of its working please see 'details' in the help for ds.unList.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye (2016), Paul Burton (19/09/2019) for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/unListDS.md b/docs/reference/unListDS.md new file mode 100644 index 00000000..1dc51809 --- /dev/null +++ b/docs/reference/unListDS.md @@ -0,0 +1,55 @@ +# `unListDS` a serverside assign function called by `ds.unList` + +this function is based on the native R function `unlist` which coerces +an object of list class back to the class it was when it was coerced +into a list + +## Usage + +``` r +unListDS(x.name) +``` + +## Arguments + +- x.name: + + the name of the input object to be unlisted. It must be specified in + inverted commas e.g. x.name="input.object.name". Fully specified by + the `x.name` argument of `ds.unList` + +## Value + +the object specified by the `newobj` argument of the `ds.unList` +function (or by default "unlist.newobj" if the `newobj` argument is +NULL). This is written to the serverside. As well as writing the output +object as `newobj` on the serverside, two validity messages are returned +indicating whether `newobj` has been created in each data source and if +so whether it is in a valid form. If its form is not valid in at least +one study - e.g. because a disclosure trap was tripped and creation of +the full output object was blocked - `ds.seq` also returns any +studysideMessages that can explain the error in creating the full output +object. As well as appearing on the screen at run time,if you wish to +see the relevant studysideMessages at a later date you can use the +`ds.message` function. If you type ds.message("\") it will +print out the relevant studysideMessage from any datasource in which +there was an error in creating `newobj` and a studysideMessage was +saved. Because the outcome object from `ds.unList` is typically a list +object with no names, if there are no errors in creating it the message +returned from ds.message("\") in each study will read "Outcome +object is a list without names. So a studysideMessage may be hidden. +Please check output is OK". This suggests that - in the case of this +specific function - one should check as far as one can the nature of the +output from a call to ds.unList - e.g. ds.class, ds.length etc + +## Details + +See details of the native R function `unlist`. This function represents +a substantive restructuring of an earlier version created by Amadou +Gaye. For further details of its working please see 'details' in the +help for `ds.unList`. + +## Author + +Amadou Gaye (2016), Paul Burton (19/09/2019) for DataSHIELD Development +Team diff --git a/docs/reference/uniqueDS.html b/docs/reference/uniqueDS.html index a25aeaca..c416b3e3 100644 --- a/docs/reference/uniqueDS.html +++ b/docs/reference/uniqueDS.html @@ -1,91 +1,80 @@ -Applies the unique method to a server-side variable. — uniqueDS • dsBase - - -
    -
    -
    -
    -

    Applies the unique method to a server-side variable.

    + - + + + +
    +
    +
    +
    + +

    Applies the unique method to a server-side variable.

    + +
    uniqueDS.Rd
    -
    +

    This function is similar to R function unique.

    -
    +
    +

    Usage

    uniqueDS(x.name.transmit = NULL)
    -
    -

    Arguments

    +
    +

    Arguments

    x.name.transmit

    is the name of the variable upon which unique method will be applied

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument which is written to the server-side.

    -
    -

    Details

    +
    +

    Details

    The function computes the uniques values of a variable.

    -
    -

    Author

    +
    +

    Author

    Stuart Wheater for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/uniqueDS.md b/docs/reference/uniqueDS.md new file mode 100644 index 00000000..18620909 --- /dev/null +++ b/docs/reference/uniqueDS.md @@ -0,0 +1,28 @@ +# Applies the `unique` method to a server-side variable. + +This function is similar to R function `unique`. + +## Usage + +``` r +uniqueDS(x.name.transmit = NULL) +``` + +## Arguments + +- x.name.transmit: + + is the name of the variable upon which `unique` method will be applied + +## Value + +the object specified by the `newobj` argument which is written to the +server-side. + +## Details + +The function computes the uniques values of a variable. + +## Author + +Stuart Wheater for DataSHIELD Development Team diff --git a/docs/reference/varDS.html b/docs/reference/varDS.html index 37a4d212..e42915fb 100644 --- a/docs/reference/varDS.html +++ b/docs/reference/varDS.html @@ -1,94 +1,83 @@ -Computes the variance of vector — varDS • dsBase - - -
    -
    -
    -
    -

    Computes the variance of vector

    + - + + + +
    +
    +
    +
    + +

    Computes the variance of vector

    + +
    varDS.Rd
    -
    +

    Calculates the variance.

    -
    +
    +

    Usage

    varDS(xvect)
    -
    -

    Arguments

    +
    +

    Arguments

    xvect

    a vector

    -
    -

    Value

    +
    +

    Value

    a list, with the sum of the input variable, the sum of squares of the input variable, the number of missing values, the number of valid values, the number of total length of the variable, and a study message indicating whether the number of valid is less than the disclosure threshold

    -
    -

    Details

    +
    +

    Details

    if the length of input vector is less than the set filter a missing value is returned.

    -
    -

    Author

    +
    +

    Author

    Amadou Gaye, Demetris Avraam, for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/varDS.md b/docs/reference/varDS.md new file mode 100644 index 00000000..c3880cd2 --- /dev/null +++ b/docs/reference/varDS.md @@ -0,0 +1,32 @@ +# Computes the variance of vector + +Calculates the variance. + +## Usage + +``` r +varDS(xvect) +``` + +## Arguments + +- xvect: + + a vector + +## Value + +a list, with the sum of the input variable, the sum of squares of the +input variable, the number of missing values, the number of valid +values, the number of total length of the variable, and a study message +indicating whether the number of valid is less than the disclosure +threshold + +## Details + +if the length of input vector is less than the set filter a missing +value is returned. + +## Author + +Amadou Gaye, Demetris Avraam, for DataSHIELD Development Team diff --git a/docs/reference/vectorDS.html b/docs/reference/vectorDS.html index c7cca023..17661a75 100644 --- a/docs/reference/vectorDS.html +++ b/docs/reference/vectorDS.html @@ -1,91 +1,80 @@ -Creates a vector on the server-side. — vectorDS • dsBase - - -
    -
    -
    -
    -

    Creates a vector on the server-side.

    + - + + + +
    +
    +
    +
    + +

    Creates a vector on the server-side.

    + +
    vectorDS.Rd
    -
    +

    This function is similar to R function c.

    -
    +
    +

    Usage

    vectorDS(...)
    -
    -

    Arguments

    +
    +

    Arguments

    ...

    parameter to be used to form the vector.

    -
    -

    Value

    +
    +

    Value

    the object specified by the newobj argument which is written to the server-side.

    -
    -

    Details

    +
    +

    Details

    The function computes the vectors values.

    -
    -

    Author

    +
    +

    Author

    Stuart Wheater for DataSHIELD Development Team

    -
    - -
    +
    -
    -

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    +
    +

    Developed by Paul Burton, Rebecca Wilson, Olly Butters, Patricia Ryser-Welch, Alex Westerberg, Leire Abarrategui, Roberto Villegas-Diaz, Demetris Avraam, Yannick Marcon, Tom Bishop, Amadou Gaye, Xavier Escribà-Montagut, Stuart Wheater.

    -
    -

    Site built with pkgdown 2.1.3.

    +
    +

    Site built with pkgdown 2.2.0.

    -
    - +
    diff --git a/docs/reference/vectorDS.md b/docs/reference/vectorDS.md new file mode 100644 index 00000000..70253841 --- /dev/null +++ b/docs/reference/vectorDS.md @@ -0,0 +1,28 @@ +# Creates a vector on the server-side. + +This function is similar to R function `c`. + +## Usage + +``` r +vectorDS(...) +``` + +## Arguments + +- ...: + + parameter to be used to form the vector. + +## Value + +the object specified by the `newobj` argument which is written to the +server-side. + +## Details + +The function computes the vectors values. + +## Author + +Stuart Wheater for DataSHIELD Development Team diff --git a/docs/search.json b/docs/search.json new file mode 100644 index 00000000..cd395fbe --- /dev/null +++ b/docs/search.json @@ -0,0 +1 @@ +[{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Paul Burton. Author. Rebecca Wilson. Author. Olly Butters. Author. Patricia Ryser-Welch. Author. Alex Westerberg. Author. Leire Abarrategui. Author. Roberto Villegas-Diaz. Author. Demetris Avraam. Author. Yannick Marcon. Author. Tom Bishop. Author. Amadou Gaye. Author. Xavier Escribà-Montagut. Author. Stuart Wheater. Author, maintainer.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg , Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye , Escribà-Montagut X, Wheater S (????). dsBase: 'DataSHIELD' Server Side Base Functions. R package version 6.3.6.9000. Gaye , Marcon Y, Isaeva J, LaFlamme P, Turner , Jones E, Minion J, Boyd , Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir , Doiron D, Giepmans L, Wallace S, Budin-Ljøsne , Schmidt C, Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry , Peters , Phillips C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier , Harris J, Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014). “DataSHIELD: taking analysis data, data analysis.” International Journal Epidemiology, 43(6), 1929–1944. doi:10.1093/ije/dyu188. Wilson R, Butters O, Avraam D, Baker J, Tedds J, Turner , Murtagh M, Burton P (2017). “DataSHIELD – New Directions Dimensions.” Data Science Journal, 16(21), 1–21. doi:10.5334/dsj-2017-021. Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan , Murtagh M, Nestor M, Nybo Andersen , Parker S, Pinot de Moira , Schwarz F, Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024). “DataSHIELD: mitigating disclosure risk multi-site federated analysis platform.” Bioinformatics Advances, 5(1), 1–21. doi:10.1093/bioadv/vbaf046.","code":"@Manual{, title = {dsBase: 'DataSHIELD' Server Side Base Functions}, author = {Paul Burton and Rebecca Wilson and Olly Butters and Patricia Ryser-Welch and Alex Westerberg and Leire Abarrategui and Roberto Villegas-Diaz and Demetris Avraam and Yannick Marcon and Tom Bishop and Amadou Gaye and Xavier Escribà-Montagut and Stuart Wheater}, note = {R package version 6.3.6.9000}, } @Article{, title = {{DataSHIELD: taking the analysis to the data, not the data to the analysis}}, author = {Amadou Gaye and Yannick Marcon and Julia Isaeva and Philippe {LaFlamme} and Andrew Turner and Elinor M Jones and Joel Minion and Andrew W Boyd and Christopher J Newby and Marja-Liisa Nuotio and Rebecca Wilson and Oliver Butters and Barnaby Murtagh and Ipek Demir and Dany Doiron and Lisette Giepmans and Susan E Wallace and Isabelle Budin-Lj{\\o}sne and Carsten O. Schmidt and Paolo Boffetta and Mathieu Boniol and Maria Bota and Kim W Carter and Nick {deKlerk} and Chris Dibben and Richard W Francis and Tero Hiekkalinna and Kristian Hveem and Kirsti Kval{\\o}y and Sean Millar and Ivan J Perry and Annette Peters and Catherine M Phillips and Frank Popham and Gillian Raab and Eva Reischl and Nuala Sheehan and Melanie Waldenberger and Markus Perola and Edwin {{van den Heuvel}} and John Macleod and Bartha M Knoppers and Ronald P Stolk and Isabel Fortier and Jennifer R Harris and Bruce H R Woffenbuttel and Madeleine J Murtagh and Vincent Ferretti and Paul R Burton}, journal = {International Journal of Epidemiology}, year = {2014}, volume = {43}, number = {6}, pages = {1929--1944}, doi = {10.1093/ije/dyu188}, } @Article{, title = {{DataSHIELD – New Directions and Dimensions}}, author = {Rebecca C. Wilson and Oliver W. Butters and Demetris Avraam and James Baker and Jonathan A. Tedds and Andrew Turner and Madeleine Murtagh and Paul R. Burton}, journal = {Data Science Journal}, year = {2017}, volume = {16}, number = {21}, pages = {1--21}, doi = {10.5334/dsj-2017-021}, } @Article{, title = {{DataSHIELD: mitigating disclosure risk in a multi-site federated analysis platform}}, author = {Demetris Avraam and Rebecca C Wilson and Noemi {{Aguirre Chan}} and Soumya Banerjee and Tom R P Bishop and Olly Butters and Tim Cadman and Luise Cederkvist and Liesbeth Duijts and Xavier {{Escrib{\\a`a} Montagut}} and Hugh Garner and Gon{\\c c}alo {Gon{\\c c}alves} and Juan R Gonz{\\a'a}lez and Sido Haakma and Mette Hartlev and Jan Hasenauer and Manuel Huth and Eleanor Hyde and Vincent W V Jaddoe and Yannick Marcon and Michaela Th Mayrhofer and Fruzsina Molnar-Gabor and Andrei Scott Morgan and Madeleine Murtagh and Marc Nestor and Anne-Marie {{Nybo Andersen}} and Simon Parker and Angela {{Pinot de Moira}} and Florian Schwarz and Katrine Strandberg-Larsen and Morris A Swertz and Marieke Welten and Stuart Wheater and Paul R Burton}, journal = {Bioinformatics Advances}, year = {2024}, volume = {5}, number = {1}, pages = {1--21}, doi = {10.1093/bioadv/vbaf046}, editor = {Thomas Lengauer}, publisher = {Oxford University Press (OUP)}, }"},{"path":[]},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"DataSHIELD Server Side Base Functions","text":"can install released version dsBase CRAN : development version GitHub : full list development branches, checkout https://github.com/datashield/dsBase/branches","code":"install.packages(\"dsBase\") install.packages(\"remotes\") remotes::install_github(\"datashield/dsBase\", \"\") # Install v6.3.6 with the following remotes::install_github(\"datashield/dsBase\", \"6.3.6\")"},{"path":"/index.html","id":"about","dir":"","previous_headings":"","what":"About","title":"DataSHIELD Server Side Base Functions","text":"DataSHIELD software package allows non-disclosive federated analysis sensitive data. website (https://www.datashield.org) depth descriptions , works install . key point highlight DataSHIELD client-server infrastructure, dsBase package (https://github.com/datashield/dsBase) needs used conjunction dsBaseClient package (https://github.com/datashield/dsBaseClient) - trying use one without makes sense. Detailed instructions install DataSHIELD https://wiki.datashield.org/. code organised :","code":""},{"path":"/index.html","id":"references","dir":"","previous_headings":"","what":"References","title":"DataSHIELD Server Side Base Functions","text":"[1] Burton P, Wilson R, Butters O, Ryser-Welch P, Westerberg , Abarrategui L, Villegas-Diaz R, Avraam D, Marcon Y, Bishop T, Gaye , Escribà Montagut X, Wheater S (2025). dsBase: ‘DataSHIELD’ Server Side Base Functions. R package version 6.3.4. https://doi.org/10.32614/CRAN.package.dsBase. [2] Gaye , Marcon Y, Isaeva J, LaFlamme P, Turner , Jones E, Minion J, Boyd , Newby C, Nuotio M, Wilson R, Butters O, Murtagh B, Demir , Doiron D, Giepmans L, Wallace S, Budin-Ljøsne , Oliver Schmidt C, Boffetta P, Boniol M, Bota M, Carter K, deKlerk N, Dibben C, Francis R, Hiekkalinna T, Hveem K, Kvaløy K, Millar S, Perry , Peters , Phillips C, Popham F, Raab G, Reischl E, Sheehan N, Waldenberger M, Perola M, van den Heuvel E, Macleod J, Knoppers B, Stolk R, Fortier , Harris J, Woffenbuttel B, Murtagh M, Ferretti V, Burton P (2014). “DataSHIELD: taking analysis data, data analysis.” International Journal Epidemiology, 43(6), 1929-1944. https://doi.org/10.1093/ije/dyu188. [3] Wilson R, W. Butters O, Avraam D, Baker J, Tedds J, Turner , Murtagh M, R. Burton P (2017). “DataSHIELD – New Directions Dimensions.” Data Science Journal, 16(21), 1-21. https://doi.org/10.5334/dsj-2017-021. [4] Avraam D, Wilson R, Aguirre Chan N, Banerjee S, Bishop T, Butters O, Cadman T, Cederkvist L, Duijts L, Escribà Montagut X, Garner H, Gonçalves G, González J, Haakma S, Hartlev M, Hasenauer J, Huth M, Hyde E, Jaddoe V, Marcon Y, Mayrhofer M, Molnar-Gabor F, Morgan , Murtagh M, Nestor M, Nybo Andersen , Parker S, Pinot de Moira , Schwarz F, Strandberg-Larsen K, Swertz M, Welten M, Wheater S, Burton P (2024). “DataSHIELD: mitigating disclosure risk multi-site federated analysis platform.” Bioinformatics Advances, 5(1), 1-21. https://doi.org/10.1093/bioadv/vbaf046. Note: Apple Mx architecture users, please aware numerical limitations platform, leads unexpected results using base R packages, like stats​. x <- c(0, 3, 7) 1 - cor(x, x)​ result value zero. Also See: details see https://cran.r-project.org/doc/FAQ/R-FAQ.html#-doesn_0027t-R-think--numbers--equal_003f bug report: https://bugs.r-project.org/show_bug.cgi?id=18941","code":""},{"path":"/reference/BooleDS.html","id":null,"dir":"Reference","previous_headings":"","what":"BooleDS — BooleDS","title":"BooleDS — BooleDS","text":"Converts individual elements vector object Boolean indicators.","code":""},{"path":"/reference/BooleDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"BooleDS — BooleDS","text":"","code":"BooleDS( V1.name = NULL, V2.name = NULL, Boolean.operator.n = NULL, na.assign.text, numeric.output = TRUE )"},{"path":"/reference/BooleDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"BooleDS — BooleDS","text":"V1.name character string specifying name vector Boolean operator applied V2.name character string specifying name vector scalar compared. Boolean.operator.n integer value (1 6) providing numeric coding character string specifying one six possible Boolean operators: '==', '!=', '>', '>=','<', '<=' legally passed client server via DataSHIELD parser na.assign.text character string taking values 'NA', '1' '0'. 'NA' NA values input vector remain NAs output vector. '1' '0' NA values input vector converted 1 0 respectively. numeric.output TRUE/FALSE indicator defaulting TRUE determining whether final output variable class numeric (1/0) class logical (TRUE/FALSE).","code":""},{"path":"/reference/BooleDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"BooleDS — BooleDS","text":"levels input variable.","code":""},{"path":"/reference/BooleDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"BooleDS — BooleDS","text":"function converts input vector Boolean indicators.","code":""},{"path":"/reference/BooleDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"BooleDS — BooleDS","text":"DataSHIELD Development Team","code":""},{"path":"/reference/absDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the absolute values of the input variable — absDS","title":"Computes the absolute values of the input variable — absDS","text":"function similar R function abs.","code":""},{"path":"/reference/absDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the absolute values of the input variable — absDS","text":"","code":"absDS(x)"},{"path":"/reference/absDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the absolute values of the input variable — absDS","text":"x string character, name numeric integer vector","code":""},{"path":"/reference/absDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the absolute values of the input variable — absDS","text":"object specified newobj argument ds.abs (default name abs.newobj) written serverside. output object class numeric integer.","code":""},{"path":"/reference/absDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the absolute values of the input variable — absDS","text":"function computes absolute values input numeric integer vector.","code":""},{"path":"/reference/absDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the absolute values of the input variable — absDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/asCharacterDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerces an R object into class character — asCharacterDS","title":"Coerces an R object into class character — asCharacterDS","text":"function based native R function .character","code":""},{"path":"/reference/asCharacterDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerces an R object into class character — asCharacterDS","text":"","code":"asCharacterDS(x.name)"},{"path":"/reference/asCharacterDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerces an R object into class character — asCharacterDS","text":"x.name name input object coerced class character. Must specified inverted commas. argument usually specified directly x.name argument clientside function ds.asCharacter","code":""},{"path":"/reference/asCharacterDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerces an R object into class character — asCharacterDS","text":"object specified newobj argument (default name \"ascharacter.newobj\") written serverside. details see help clientside function ds.asCharacter","code":""},{"path":"/reference/asCharacterDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerces an R object into class character — asCharacterDS","text":"See help function .character native R","code":""},{"path":"/reference/asCharacterDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerces an R object into class character — asCharacterDS","text":"Amadou Gaye, Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/asDataMatrixDS.html","id":null,"dir":"Reference","previous_headings":"","what":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"Coerces R object matrix maintaining original class columns data.frames.","code":""},{"path":"/reference/asDataMatrixDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"","code":"asDataMatrixDS(x.name)"},{"path":"/reference/asDataMatrixDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"x.name name input object coerced class data.matrix. Must specified inverted commas. argument usually specified directly argument clientside function ds.asDataMatrix","code":""},{"path":"/reference/asDataMatrixDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"object specified argument (default name \"asdatamatrix.newobj\") written serverside. details see help clientside function ds.asDataMatrix","code":""},{"path":"/reference/asDataMatrixDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"assign function based native R function data.matrix applied data.frame, native R function .matrix converts columns character class. contrast, applied data.frame native R function data.matrix converts data.frame matrix maintains data columns original class","code":""},{"path":"/reference/asDataMatrixDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"asDataMatrixDS a serverside assign function called by ds.asDataMatrix — asDataMatrixDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/asFactorDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Determines the levels of the input variable in each single study — asFactorDS1","title":"Determines the levels of the input variable in each single study — asFactorDS1","text":"function aggregate DataSHIELD function returns levels input variable single study client-side function.","code":""},{"path":"/reference/asFactorDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Determines the levels of the input variable in each single study — asFactorDS1","text":"","code":"asFactorDS1(input.var.name = NULL)"},{"path":"/reference/asFactorDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Determines the levels of the input variable in each single study — asFactorDS1","text":"input.var.name name variable converted factor.","code":""},{"path":"/reference/asFactorDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Determines the levels of the input variable in each single study — asFactorDS1","text":"levels input variable.","code":""},{"path":"/reference/asFactorDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Determines the levels of the input variable in each single study — asFactorDS1","text":"function encodes input vector factor returns levels ascending order levels numerical alphabetical order levels type character.","code":""},{"path":"/reference/asFactorDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Converts a numeric vector into a factor — asFactorDS2","title":"Converts a numeric vector into a factor — asFactorDS2","text":"function assign DataSHIELD function converts numeric vector factor type presented vector matrix dummy variables.","code":""},{"path":"/reference/asFactorDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Converts a numeric vector into a factor — asFactorDS2","text":"","code":"asFactorDS2( input.var.name = NULL, all.unique.levels.transmit = NULL, fixed.dummy.vars = NULL, baseline.level = NULL )"},{"path":"/reference/asFactorDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Converts a numeric vector into a factor — asFactorDS2","text":"input.var.name name variable converted factor. .unique.levels.transmit levels variable transmitted . fixed.dummy.vars boolean determines whether new object represented vector matrix dummy variables indicating factor level data point. argument set FALSE (default) input variable converted factor assigned vector. set TRUE input variable converted factor assigned matrix dummy variables. baseline.level number indicating baseline level used creation matrix dummy variables.","code":""},{"path":"/reference/asFactorDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Converts a numeric vector into a factor — asFactorDS2","text":"object class factor","code":""},{"path":"/reference/asFactorDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Converts a numeric vector into a factor — asFactorDS2","text":"functions converts input variable factor presented vector fixed.dummy.vars set FALSE matrix dummy variables fixed.dummy.vars set TRUE (see help file ds.asFactor.b details).","code":""},{"path":"/reference/asFactorSimpleDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Converts a numeric vector into a factor — asFactorSimpleDS","title":"Converts a numeric vector into a factor — asFactorSimpleDS","text":"function assign DataSHIELD function coerces numeric character vector factor","code":""},{"path":"/reference/asFactorSimpleDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Converts a numeric vector into a factor — asFactorSimpleDS","text":"","code":"asFactorSimpleDS(input.var.name = NULL)"},{"path":"/reference/asFactorSimpleDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Converts a numeric vector into a factor — asFactorSimpleDS","text":"input.var.name name variable converted factor.","code":""},{"path":"/reference/asFactorSimpleDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Converts a numeric vector into a factor — asFactorSimpleDS","text":"object class factor","code":""},{"path":"/reference/asFactorSimpleDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Converts a numeric vector into a factor — asFactorSimpleDS","text":"functions converts input variable factor. Unlike ds.asFactor serverside functions, ds.asFactorSimple coerce class variable factor study. check enforce consistency factor levels across sources allow force arbitrary set levels unless levels actually exist sources. addition, allow create array binary dummy variables equivalent factor. need things use ds.asFactor function.","code":""},{"path":"/reference/asIntegerDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerces an R object into class integer — asIntegerDS","title":"Coerces an R object into class integer — asIntegerDS","text":"function based native R function .integer.","code":""},{"path":"/reference/asIntegerDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerces an R object into class integer — asIntegerDS","text":"","code":"asIntegerDS(x.name)"},{"path":"/reference/asIntegerDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerces an R object into class integer — asIntegerDS","text":"x.name name input object coerced class integer. Must specified inverted commas. argument usually specified directly argument clientside function ds.asInteger.","code":""},{"path":"/reference/asIntegerDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerces an R object into class integer — asIntegerDS","text":"object specified argument (default name \"asinteger.newobj\") written serverside. details see help clientside function ds.asInteger.","code":""},{"path":"/reference/asIntegerDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerces an R object into class integer — asIntegerDS","text":"See help function .integer native R, details section help file clientside function ds.asInteger.","code":""},{"path":"/reference/asIntegerDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerces an R object into class integer — asIntegerDS","text":"Amadou Gaye, Paul Burton, Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/asListDS.html","id":null,"dir":"Reference","previous_headings":"","what":"asListDS a serverside aggregate function called by ds.asList — asListDS","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"Coerces R object list","code":""},{"path":"/reference/asListDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"","code":"asListDS(x.name, newobj)"},{"path":"/reference/asListDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"x.name name input object coerced class data.matrix. Must specified inverted commas. argument usually specified directly argument clientside function ds.asList newobj object hard assigned '<<-' output function written serverside","code":""},{"path":"/reference/asListDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"object specified argument (default name .mat) written serverside. addition, two validity messages returned. first confirms output object created, second states class. way .list coerces objects list depends class object, general class output object usually 'list'","code":""},{"path":"/reference/asListDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"Unlike class coercing functions aggregate function rather assign function. datashield.assign function data repository deals specially created object (newobj) class list. Reconfiguring function aggregate function works around problem. aggregate function based native R function .list additional information can found help .list","code":""},{"path":"/reference/asListDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"asListDS a serverside aggregate function called by ds.asList — asListDS","text":"Amadou Gaye, Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/asLogicalDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerces an R object into class numeric — asLogicalDS","title":"Coerces an R object into class numeric — asLogicalDS","text":"function based native R function .numeric","code":""},{"path":"/reference/asLogicalDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerces an R object into class numeric — asLogicalDS","text":"","code":"asLogicalDS(x.name)"},{"path":"/reference/asLogicalDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerces an R object into class numeric — asLogicalDS","text":"x.name name input object coerced class numeric. Must specified inverted commas. argument usually specified directly argument clientside function ds.aslogical","code":""},{"path":"/reference/asLogicalDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerces an R object into class numeric — asLogicalDS","text":"object specified argument (default name .logic) written serverside. details see help clientside function ds.asLogical","code":""},{"path":"/reference/asLogicalDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerces an R object into class numeric — asLogicalDS","text":"See help function .logical native R","code":""},{"path":"/reference/asLogicalDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerces an R object into class numeric — asLogicalDS","text":"Amadou Gaye, Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/asMatrixDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerces an R object into a matrix — asMatrixDS","title":"Coerces an R object into a matrix — asMatrixDS","text":"function based native R function .matrix","code":""},{"path":"/reference/asMatrixDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerces an R object into a matrix — asMatrixDS","text":"","code":"asMatrixDS(x.name)"},{"path":"/reference/asMatrixDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerces an R object into a matrix — asMatrixDS","text":"x.name name input object coerced class matrix. Must specified inverted commas. argument usually specified directly argument clientside function ds.asMatrix","code":""},{"path":"/reference/asMatrixDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerces an R object into a matrix — asMatrixDS","text":"object specified argument (default name .mat) written serverside. details see help clientside function ds.asMatrix","code":""},{"path":"/reference/asMatrixDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerces an R object into a matrix — asMatrixDS","text":"See help function .matrix native R","code":""},{"path":"/reference/asMatrixDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerces an R object into a matrix — asMatrixDS","text":"Amadou Gaye, Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/asNumericDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerces an R object into class numeric — asNumericDS","title":"Coerces an R object into class numeric — asNumericDS","text":"function based native R function .numeric.","code":""},{"path":"/reference/asNumericDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerces an R object into class numeric — asNumericDS","text":"","code":"asNumericDS(x.name)"},{"path":"/reference/asNumericDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerces an R object into class numeric — asNumericDS","text":"x.name name input object coerced class numeric. Must specified inverted commas. argument usually specified directly argument clientside function ds.asNumeric.","code":""},{"path":"/reference/asNumericDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerces an R object into class numeric — asNumericDS","text":"object specified argument (default name .num) written serverside. details see help clientside function ds.asNumeric.","code":""},{"path":"/reference/asNumericDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerces an R object into class numeric — asNumericDS","text":"See help function .numeric native R, details section help file clientside function ds.asNumeric.","code":""},{"path":"/reference/asNumericDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerces an R object into class numeric — asNumericDS","text":"Amadou Gaye, Paul Burton, Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/aucDS.html","id":null,"dir":"Reference","previous_headings":"","what":"aucDS an aggregate function called by ds.auc — aucDS","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"function calculates C-statistic AUC logistic regression models.","code":""},{"path":"/reference/aucDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"","code":"aucDS(pred = pred, y = y)"},{"path":"/reference/aucDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"pred name vector predicted values y name outcome variable. Note variable include complete cases used regression model.","code":""},{"path":"/reference/aucDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"returns AUC standard error","code":""},{"path":"/reference/aucDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"AUC determines discriminative ability model.","code":""},{"path":"/reference/aucDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"aucDS an aggregate function called by ds.auc — aucDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/blackBoxDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"first key serverside function sets V2BR ranking client.","code":""},{"path":"/reference/blackBoxDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"blackBoxDS(input.var.name = NULL, shared.seedval, synth.real.ratio, NA.manage)"},{"path":"/reference/blackBoxDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"input.var.name character string specifying name V2BR. argument set argument name clientside function ds.ranksSecure shared.seedval pseudorandom number seed ensures processes generating order parameterisation encryption algorithms study. argument set argument clientside function ds.ranksSecure. details, including future plans share starting seed secure way, please see associated document entitled \"secure.global.ranking.docx\" header file ds.ranksSecure. synth.real.ratio integer value representing ratio synthetic (pseudo-data) values real number values V2BR. argument set argument name clientside function ds.ranksSecure. details, please see associated document entitled \"secure.global.ranking.docx\" header file ds.ranksSecure. NA.manage character string indicating missing values (NAs) V2BR managed. takes three possible values: \"NA.delete\", \"NA.low\",\"NA.hi\". argument set argument name clientside function ds.ranksSecure. details, please see associated document entitled \"secure.global.ranking.docx\" header file ds.ranksSecure.","code":""},{"path":"/reference/blackBoxDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"writes data frame object entitled blackbox.output.df serverside. study contains encrypted \"combined real+pseudo data vector\" range key components first stage ranking procedure. details see associated document entitled \"secure.global.ranking.docx\"","code":""},{"path":"/reference/blackBoxDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside assign function called ds.ranksSecure. Creates pseudo-data using real distribution values V2BR create large number synthetic data similar distribution values V2BR slightly broader distribution ends ensure extreme values \"combined real+pseudo data vector\" pseudo-data. Also ensures number decimal places values V2BR reflected number decimal places pseudodata. Finally, takes \"combined real+pseudo data vector\" seven rounds rank consistent encryption involves algorithms generated pseudorandom process selects transformation apply parameters. encryption algorithms study ensuring ranks also remain consistent studies. encryption encrypted \"combined real+pseudo data vector\" written serverside dataframe also including key component vectors first stage ranking procedure. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/blackBoxDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/blackBoxRanksDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"second key serverside function prepares global ranks real data generated first stage ranking procedure encrypts preparation generating global ranks correspond 1 1 real data V2BR.","code":""},{"path":"/reference/blackBoxRanksDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"blackBoxRanksDS(input.var.name = NULL, shared.seedval)"},{"path":"/reference/blackBoxRanksDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"input.var.name character string specifying name vector holding global ranks. argument set automatically clientside function ds.ranksSecure shared.seedval pseudorandom number seed ensures processes generating order parameterisation encryption algorithms study. argument set argument clientside function ds.ranksSecure. seed value shared studies setting encryption procedures blackBoxRanksDS arbitrarily changed used set encryption procedures blackBoxDS, set 7 encryption algorithms deliberately different. details, including future plans share starting seed secure way, please see associated document entitled \"secure.global.ranking.docx\" header file ds.ranksSecure.","code":""},{"path":"/reference/blackBoxRanksDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"writes data frame object entitled blackbox.ranks.df serverside. study contains encrypted global ranks range key components second stage (ranking global ranks real observations ) ranking procedure. details see associated document entitled \"secure.global.ranking.docx\"","code":""},{"path":"/reference/blackBoxRanksDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside assign function called ds.ranksSecure. takes global ranks currently held sR5.df reflect global ranks based \"combined real+pseudo data vector\" encrypted blackBoxDS pseudo-data stripped . uses global ranks (real data) new variable ranked. equivalent blackBoxDS primary difference pseudo-data needed. global ranks fundamentally non-disclosive can transferred clientside risk disclosure. However, order ensure client compare list global.ranks sR4.df (initial global ranking based ranking real pseudo-data combined) global.ranks generated blackBoxRanksDS (based solely real data processed seven rounds encryption blackBoxDS. consequence client remains unable determine original global ranks corresponded real data pseudo-data. addition, blackBoxRanksDS need determine number decimal places data applied ranks assumed integers. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure header file blackBoxDS","code":""},{"path":"/reference/blackBoxRanksDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/boxPlotGGDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS","title":"Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS","text":"order create non disclosive box plot, data passed client purely geometrical aspects plot, ggplot object contains data inside, graphical parameters passed. three different cases depending grouping variables. outliers also removed graphical parameters.","code":""},{"path":"/reference/boxPlotGGDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS","text":"","code":"boxPlotGGDS(data_table, group = NULL, group2 = NULL)"},{"path":"/reference/boxPlotGGDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS","text":"data_table data frame Table holds information plotted, arranged : Column 'x': Names X axis boxplot, aka variables plot Column 'value': Values variable (raw data columns rbinded) Column 'group': (Optional) Values grouping variable Column 'group2': (Optional) Values second grouping variable group character (default NULL) Name first grouping variable. group2 character (default NULL) Name second grouping variable.","code":""},{"path":"/reference/boxPlotGGDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create the identity stats and necessary data to draw a plot on the client — boxPlotGGDS","text":"list : -data frame Geometrical parameters (identity stats ggplot) -character Type plot (single_group, double_group no_group)","code":""},{"path":"/reference/boxPlotGG_data_TreatmentDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS","title":"Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS","text":"Arrange data frame pass boxplot function","code":""},{"path":"/reference/boxPlotGG_data_TreatmentDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS","text":"","code":"boxPlotGG_data_TreatmentDS(table, variables, group = NULL, group2 = NULL)"},{"path":"/reference/boxPlotGG_data_TreatmentDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS","text":"table data frame Table holds information plotted later variables character vector Name column(s) data frame include boxplot group character (default NULL) Name first grouping variable. group2 character (default NULL) Name second grouping variable.","code":""},{"path":"/reference/boxPlotGG_data_TreatmentDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Arrange data frame to pass it to the boxplot function — boxPlotGG_data_TreatmentDS","text":"data frame following structure: Column 'x': Names X axis boxplot, aka variables plot Column 'value': Values variable (raw data columns rbinded) Column 'group': (Optional) Values grouping variable Column 'group2': (Optional) Values second grouping variable","code":""},{"path":"/reference/boxPlotGG_data_Treatment_numericDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS","title":"Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS","text":"Arrange vector pass boxplot function","code":""},{"path":"/reference/boxPlotGG_data_Treatment_numericDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS","text":"","code":"boxPlotGG_data_Treatment_numericDS(vector)"},{"path":"/reference/boxPlotGG_data_Treatment_numericDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS","text":"vector numeric vector Vector arrange plotted later","code":""},{"path":"/reference/boxPlotGG_data_Treatment_numericDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Arrange vector to pass it to the boxplot function — boxPlotGG_data_Treatment_numericDS","text":"data frame following structure: Column 'x': Names X axis boxplot, aka name vector (vector argument) Column 'value': Values variable","code":""},{"path":"/reference/bp_standardsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates Blood pressure z-scores — bp_standardsDS","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"function calculates blood pressure z-scores two steps: Step 1. Calculates z-score height according CDC growth chart (growth chart!). Step 2. Calculates z-score BP according fourth report BP management, USA","code":""},{"path":"/reference/bp_standardsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"","code":"bp_standardsDS( sex = sex, age = age, height = height, bp = bp, systolic = systolic )"},{"path":"/reference/bp_standardsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"sex name sex variable. variable coded 1 males 2 females. coded differently (e.g. 0/1), can use ds.recodeValues function recode categories 1/2 use ds.bp_standards age name age variable years. height name height variable cm bp name blood pressure variable. systolic logical. TRUE (default) function assumes conversion systolic blood pressure. FALSE function assumes conversion diastolic blood pressure.","code":""},{"path":"/reference/bp_standardsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"assigns new object server-side. assigned object list two elements: 'Zbp' zscores blood pressure 'perc' percentiles BP zscores.","code":""},{"path":"/reference/bp_standardsDS.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"z-scores height based CDC growth charts calculated sds function childsds R package.","code":""},{"path":"/reference/bp_standardsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates Blood pressure z-scores — bp_standardsDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/cDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Concatenates objects into a vector or list — cDS","title":"Concatenates objects into a vector or list — cDS","text":"function similar R base function 'c'.","code":""},{"path":"/reference/cDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Concatenates objects into a vector or list — cDS","text":"","code":"cDS(objs)"},{"path":"/reference/cDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Concatenates objects into a vector or list — cDS","text":"objs list contains objects concatenate.","code":""},{"path":"/reference/cDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Concatenates objects into a vector or list — cDS","text":"vector list","code":""},{"path":"/reference/cDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Concatenates objects into a vector or list — cDS","text":"Unlike R base function 'c' vector list certain length allowed output","code":""},{"path":"/reference/cDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Concatenates objects into a vector or list — cDS","text":"Gaye, .","code":""},{"path":"/reference/cbindDS.html","id":null,"dir":"Reference","previous_headings":"","what":"cbindDS called by ds.cbind — cbindDS","title":"cbindDS called by ds.cbind — cbindDS","text":"serverside assign function takes sequence vector, matrix data-frame arguments combines column produce data-frame.","code":""},{"path":"/reference/cbindDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"cbindDS called by ds.cbind — cbindDS","text":"","code":"cbindDS(x.names.transmit = NULL, colnames.transmit = NULL)"},{"path":"/reference/cbindDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"cbindDS called by ds.cbind — cbindDS","text":"x.names.transmit vector character strings representing names elemental components combined converted transmittable format. argument fully specified x argument client-side ds.cbind function. colnames.transmit vector character strings representing column names output object converted transmittable format.","code":""},{"path":"/reference/cbindDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"cbindDS called by ds.cbind — cbindDS","text":"object specified newobj argument ds.cbind (default name cbind.newobj) written serverside. output object class data.frame.","code":""},{"path":"/reference/cbindDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"cbindDS called by ds.cbind — cbindDS","text":"sequence vector, matrix data-frame arguments combined column column produce data-frame written serverside. critical requirement length component variables, number rows component data.frames matrices must . output data.frame number rows. details see help ds.cbind native R function cbind.","code":""},{"path":"/reference/cbindDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"cbindDS called by ds.cbind — cbindDS","text":"Paul Burton Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/changeRefGroupDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Changes a reference level of a factor — changeRefGroupDS","title":"Changes a reference level of a factor — changeRefGroupDS","text":"function similar R function relevel,","code":""},{"path":"/reference/changeRefGroupDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Changes a reference level of a factor — changeRefGroupDS","text":"","code":"changeRefGroupDS(xvect, ref = NULL, reorderByRef = NULL)"},{"path":"/reference/changeRefGroupDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Changes a reference level of a factor — changeRefGroupDS","text":"xvect factor vector ref character, reference level reorderByRef boolean tells whether new vector ordered reference group.","code":""},{"path":"/reference/changeRefGroupDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Changes a reference level of a factor — changeRefGroupDS","text":"factor length xvect","code":""},{"path":"/reference/changeRefGroupDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Changes a reference level of a factor — changeRefGroupDS","text":"addition R function , function allows user re-order vector, putting reference group first. user chooses re-order warning issued can introduce mismatch values vector put back table reordered way. mismatch can render results operations table invalid.","code":""},{"path":"/reference/changeRefGroupDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Changes a reference level of a factor — changeRefGroupDS","text":"Isaeva, J., Gaye, .","code":""},{"path":"/reference/checkNegValueDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Checks if a numeric variable has negative values — checkNegValueDS","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"function called client function ds.glm.","code":""},{"path":"/reference/checkNegValueDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"","code":"checkNegValueDS(weights)"},{"path":"/reference/checkNegValueDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"weights numeric vector","code":""},{"path":"/reference/checkNegValueDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"boolean; TRUE vector one negative values FALSE otherwise","code":""},{"path":"/reference/checkNegValueDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"user sets parameter 'weights' client side function ds.glm server side function called verify 'weights' vector negative values negative allowed weights.","code":""},{"path":"/reference/checkNegValueDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Checks if a numeric variable has negative values — checkNegValueDS","text":"Gaye, .","code":""},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":null,"dir":"Reference","previous_headings":"","what":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"server-side function check server running \"permissive\" privacy control level.","code":""},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"","code":"checkPermissivePrivacyControlLevel(privacyControlLevels)"},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"privacyControlLevels vector strings contains privacy control level names permitted calling method.","code":""},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"return value, called side effects","code":""},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"Tests whether R option \"datashield.privacyControlLevel\" set \"permissive\", cause call stop() message \"BLOCKED: server running 'non-permissive' mode caused method blocked\".","code":""},{"path":"/reference/checkPermissivePrivacyControlLevel.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"checkPermissivePrivacyControlLevel — checkPermissivePrivacyControlLevel","text":"Wheater, Dr SM., DataSHIELD Development Team.","code":""},{"path":"/reference/classDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the class of an object — classDS","title":"Returns the class of an object — classDS","text":"function similar R function class.","code":""},{"path":"/reference/classDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the class of an object — classDS","text":"","code":"classDS(x)"},{"path":"/reference/classDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the class of an object — classDS","text":"x string character, name object","code":""},{"path":"/reference/classDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the class of an object — classDS","text":"class input object","code":""},{"path":"/reference/classDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the class of an object — classDS","text":"function returns class object","code":""},{"path":"/reference/classDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the class of an object — classDS","text":"Stuart Wheater, DataSHIELD Development Team","code":""},{"path":"/reference/colnamesDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the column names of a data frame or matrix — colnamesDS","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"function similar R function colnames.","code":""},{"path":"/reference/colnamesDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"","code":"colnamesDS(x)"},{"path":"/reference/colnamesDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"x string character, name dataframe matrix","code":""},{"path":"/reference/colnamesDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"column names input object","code":""},{"path":"/reference/colnamesDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"function returns column names input dataframe matrix","code":""},{"path":"/reference/colnamesDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the column names of a data frame or matrix — colnamesDS","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/completeCasesDS.html","id":null,"dir":"Reference","previous_headings":"","what":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"Identifies strips rows data.frame, matrix vector contain NAs.","code":""},{"path":"/reference/completeCasesDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"","code":"completeCasesDS(x1.transmit)"},{"path":"/reference/completeCasesDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"x1.transmit argument determines input data.frame, matrix vector rows NAs stripped. argument fully specified argument ds.completeCases function.","code":""},{"path":"/reference/completeCasesDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"modified data.frame, matrix vector rows containing least one NA deleted. modified object written serverside source. addition, two validity messages returned indicating whether created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - ds.completeCases also returns studysideMessages can help explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"newobj\") print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message(\"newobj\") return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/completeCasesDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"case data.frame matrix, completeCasesDS identifies rows containing one NAs deletes rows altogether. one variable NA given row lead deletion whole row. case vector, completeCasesDS acts equivalent manner equivalent 'row' simply strips observations recorded NA. ds.completeCASES analogous complete.cases function native R. Limited additional information can therefore found help(\"complete.cases\") native R.","code":""},{"path":"/reference/completeCasesDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"completeCasesDS: an assign function called by ds.completeCases — completeCasesDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/corDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"function computes sum vector variable sum products two variables (.e. scalar product two vectors).","code":""},{"path":"/reference/corDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"","code":"corDS(x = NULL, y = NULL)"},{"path":"/reference/corDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"x character, name vector, matrix dataframe variables(s) correlation(s) () going calculated . y NULL (default) name vector, matrix dataframe compatible dimensions x.","code":""},{"path":"/reference/corDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"list includes matrix elements sum products two variables, matrix elements sum values variable, matrix elements number complete cases pair variables, list number missing values variable separately (columnwise) number missing values casewise, vector elements sum squares variable. first disclosure control checks number variables bigger percentage individual-level records (allowed percentage pre-specified 'nfilter.glm'). second disclosure control checks none dichotomous level fewer counts pre-specified 'nfilter.tab' threshold.","code":""},{"path":"/reference/corDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"computes sum vector variable sum products two variables","code":""},{"path":"/reference/corDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the sum of each variable and the sum of products for each pair of variables — corDS","text":"Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/corTestDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Tests for correlation between paired samples — corTestDS","title":"Tests for correlation between paired samples — corTestDS","text":"function similar R function cor.test.","code":""},{"path":"/reference/corTestDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Tests for correlation between paired samples — corTestDS","text":"","code":"corTestDS(x, y, method, exact, conf.level)"},{"path":"/reference/corTestDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Tests for correlation between paired samples — corTestDS","text":"x character string providing name numerical vector. y character string providing name numerical vector. method character string indicating correlation coefficient used test. One \"pearson\", \"kendall\", \"spearman\", can abbreviated. exact logical indicating whether exact p-value computed. Used Kendall's tau Spearman's rho. conf.level confidence level returned confidence interval. Currently used Pearson product moment correlation coefficient least 4 complete pairs observations.","code":""},{"path":"/reference/corTestDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Tests for correlation between paired samples — corTestDS","text":"results correlation test.","code":""},{"path":"/reference/corTestDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Tests for correlation between paired samples — corTestDS","text":"function runs two-sided correlation test","code":""},{"path":"/reference/corTestDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Tests for correlation between paired samples — corTestDS","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/covDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"function computes sum vector variable sum products two variables (.e. scalar product two vectors).","code":""},{"path":"/reference/covDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"","code":"covDS(x = NULL, y = NULL, use = NULL)"},{"path":"/reference/covDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"x character, name vector, matrix dataframe variable(s) covariance(s) correlation(s) () going calculated . y NULL (default) name vector, matrix dataframe compatible dimensions x. use character string giving method computing covariances presence missing values. must one strings \"casewise.complete\" \"pairwise.complete\". use set 'casewise.complete' rows missing values omitted vector, matrix dataframe calculations sums. use set 'pairwise.complete' (default case set client-side), sums products computed two variables using complete pairs observations two variables.","code":""},{"path":"/reference/covDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"list includes matrix elements sum products two variables, matrix elements sum values variable, matrix elements number complete cases pair variables, list number missing values variable separately (columnwise) number missing values casewise pairwise depending argument use, error message indicates whether input variables pass disclosure controls. first disclosure control checks number variables bigger percentage individual-level records (allowed percentage pre-specified 'nfilter.glm'). second disclosure control checks none dichotomous level fewer counts pre-specified 'nfilter.tab' threshold. input variables pass disclosure controls output values replaced NAs.","code":""},{"path":"/reference/covDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"computes sum vector variable sum products two variables","code":""},{"path":"/reference/covDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the sum of each variable and the sum of products for each pair of variables — covDS","text":"Amadou Gaye, Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/dataFrameDS.html","id":null,"dir":"Reference","previous_headings":"","what":"dataFrameDS called by ds.dataFrame — dataFrameDS","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"serverside function creates data frame elemental components. : pre-existing data frames; single variables; /matrices","code":""},{"path":"/reference/dataFrameDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"","code":"dataFrameDS( vectors = NULL, r.names = NULL, ch.rows = FALSE, ch.names = TRUE, clnames = NULL, strAsFactors = TRUE, completeCases = FALSE )"},{"path":"/reference/dataFrameDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"vectors list contains elemental components combine. correspond vector character strings specified argument x clientside function ds.dataFrame() r.names NULL character vector specifying names rows. Default NULL. ch.rows logical, TRUE rows checked consistency length names. Default FALSE. ch.names logical, TRUE names variables data frame checked ensure syntactically valid variable names duplicated. Default TRUE. fact, clientside function ensures duplicated names can presented dataFrameDS argument kept check forms syntactic validity. clnames list characters, column names output data frame. generated clientside function names vectors, column names data.frames matrices combined producing output data.frame strAsFactors logical, TRUE determines whether character vectors automatically converted factors? Default TRUE. completeCases logical. TRUE indicates complete cases included: rows missing values component excluded. Default FALSE.","code":""},{"path":"/reference/dataFrameDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"dataframe composed specified elemental components created serverside named according argument clientside function ds.dataFrame()","code":""},{"path":"/reference/dataFrameDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"data frame list variables number rows unique row names, class 'data.frame'. ds.dataFrame create data frame combining series elemental components may pre-existing data.frames, matrices variables. critical requirement length component variables, number rows component data.frames matrices must . output data.frame number rows. serverside function dataFrameDS() calls native R function data.frame() several arguments precisely data.frame(). consequence, additional information can sought help() data.frame().","code":""},{"path":"/reference/dataFrameDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"dataFrameDS called by ds.dataFrame — dataFrameDS","text":"DataSHIELD Development Team","code":""},{"path":"/reference/dataFrameFillDS.html","id":null,"dir":"Reference","previous_headings":"","what":"dataFrameFillDS — dataFrameFillDS","title":"dataFrameFillDS — dataFrameFillDS","text":"assign function called clientside ds.dataFrameFill function.","code":""},{"path":"/reference/dataFrameFillDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"dataFrameFillDS — dataFrameFillDS","text":"","code":"dataFrameFillDS( df.name, allNames.transmit, class.vect.transmit, levels.vec.transmit )"},{"path":"/reference/dataFrameFillDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"dataFrameFillDS — dataFrameFillDS","text":"df.name character string representing name input data frame filled extra columns missing values number variables missing compared data frames studies used analysis. allNames.transmit unique names variables included input data frames used datasources. class.vect.transmit classes variables included vector allNames.transmit. levels.vec.transmit levels factor variables. classes supported 'numeric', 'integer', 'character', 'factor' 'logical'.","code":""},{"path":"/reference/dataFrameFillDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"dataFrameFillDS — dataFrameFillDS","text":"Nothing returned client. generated object written serverside.","code":""},{"path":"/reference/dataFrameFillDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"dataFrameFillDS — dataFrameFillDS","text":"function checks study variables compared studies analysis. study variables, function generates variables vectors missing values combines columns input data frame. , \"complete\" terms columns dataframe saved server name specified argument newobj clientside.","code":""},{"path":"/reference/dataFrameFillDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"dataFrameFillDS — dataFrameFillDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/dataFrameSortDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"Sorts data frame using specified alphanumeric numeric sort key","code":""},{"path":"/reference/dataFrameSortDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"","code":"dataFrameSortDS( df.name = NULL, sort.key.name = NULL, sort.descending, sort.method )"},{"path":"/reference/dataFrameSortDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"df.name character string providing name serverside data.frame sorted. parameter fully specified equivalent argument ds.dataFrameShort details can found help(\"ds.dataFrameSort\"). sort.key.name character string providing name sort key. serverside vector may sit inside data frame sorted independently serverside analysis environment. , sits outside data frame must length data frame. parameter fully specified equivalent argument ds.dataFrameShort details can found help(\"ds.dataFrameSort\"). sort.descending logical, TRUE data.frame sorted sort key descending order. Default = FALSE (sort order ascending). parameter fully specified equivalent argument ds.dataFrameShort details can found help(\"ds.dataFrameSort\"). sort.method character string taking one values: \"default\", \"d\", \"alphabetic\", \"\", \"numeric\", \"n\", NULL. Default value \"default\". parameter fully specified equivalent argument ds.dataFrameShort details can found help(\"ds.dataFrameSort\").","code":""},{"path":"/reference/dataFrameSortDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"appropriately re-sorted data.frame written serverside R environment data.frame named according argument(default name 'dataframesort.newobj') name specified","code":""},{"path":"/reference/dataFrameSortDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"Serverside assign function dataFrameSortDS called clientside function ds.dataFrameSort. vector matrix can added , coerced , data frame (using function [ds.dataFrame]) means can sorted/reordered using ds.dataFrameSort. Fundamentally, function [ds.dataFrameSort] sort specified data frame serverside using sort key also serverside. details see help clientside function: [ds.dataFrameShort]","code":""},{"path":"/reference/dataFrameSortDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Sorting and reordering data frames, vectors or matrices — dataFrameSortDS","text":"Paul Burton, critical error identification Leire Abarrategui-Martinez, DataSHIELD Development Team, 2/4/2020","code":""},{"path":"/reference/dataFrameSubsetDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"First serverside function subsetting data frame row column.","code":""},{"path":"/reference/dataFrameSubsetDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"","code":"dataFrameSubsetDS1( df.name = NULL, V1.name = NULL, V2.name = NULL, Boolean.operator.n = NULL, keep.cols = NULL, rm.cols = NULL, keep.NAs = NULL )"},{"path":"/reference/dataFrameSubsetDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"df.name character string providing name data.frame sorted. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset V1.name character string specifying name subsetting vector Boolean operator applied define subset created. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset V2.name character string specifying name vector scalar values vector specified argument compared. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset Boolean.operator.n character string specifying one six possible Boolean operators: '==', '!=', '>', '>=', '<', '<=' argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset keep.cols numeric vector specifying numbers columns kept final subset subsetting column. example: keep.cols=c(2:5,7,12) keep columns 2,3,4,5,7 12. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset rm.cols numeric vector specifying numbers columns removed creating final subset subsetting column. example: rm.cols=c(2:5,7,12) remove columns 2,3,4,5,7 12. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset keep.NAs logical, TRUE NAs vector holding final Boolean vector indicating whether given row included subset converted 1s included subset. NAs caused NAs either . FALSE NULL NAs final Boolean vector converted 0s corresponding row therefore excluded subset. argument generated passed directly dataFrameSubsetDS1 ds.dataFrameSubset","code":""},{"path":"/reference/dataFrameSubsetDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"first serverside function called ds.dataFrameSubset provides first level traps comprehensive series disclosure risks can returned directly clientside dataFrameSubsetDS1 aggregate function. second serverside function called ds.dataFrameSubset (dataFrameSubsetDS2) carries disclosure tests, assign function writes subsetted data.frame serverside. consequence, records error messages studysideMessages can retrieved using ds.message","code":""},{"path":"/reference/dataFrameSubsetDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"data frame list variables number rows, class 'data.frame'. details see help header ds.dataFrameSubset","code":""},{"path":"/reference/dataFrameSubsetDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"dataFrameSubsetDS1 an aggregate function called by ds.dataFrameSubset — dataFrameSubsetDS1","text":"Paul Burton","code":""},{"path":"/reference/dataFrameSubsetDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"Second serverside function subsetting data frame row column.","code":""},{"path":"/reference/dataFrameSubsetDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"","code":"dataFrameSubsetDS2( df.name = NULL, V1.name = NULL, V2.name = NULL, Boolean.operator.n = NULL, keep.cols = NULL, rm.cols = NULL, keep.NAs = NULL )"},{"path":"/reference/dataFrameSubsetDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"df.name character string providing name data.frame sorted. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset V1.name character string specifying name subsetting vector Boolean operator applied define subset created. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset V2.name character string specifying name vector scalar values vector specified argument compared. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset Boolean.operator.n character string specifying one six possible Boolean operators: '==', '!=', '>', '>=', '<', '<=' argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset keep.cols numeric vector specifying numbers columns kept final subset subsetting column. example: keep.cols=c(2:5,7,12) keep columns 2,3,4,5,7 12. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset rm.cols numeric vector specifying numbers columns removed creating final subset subsetting column. example: rm.cols=c(2:5,7,12) remove columns 2,3,4,5,7 12. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset keep.NAs logical, TRUE NAs vector holding final Boolean vector indicating whether given row included subset converted 1s included subset. NAs caused NAs either . FALSE NULL NAs final Boolean vector converted 0s corresponding row therefore excluded subset. argument generated passed directly dataFrameSubsetDS2 ds.dataFrameSubset","code":""},{"path":"/reference/dataFrameSubsetDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"object specified argument (default name '_subset') initially specified calling ds.dataFrameSubset. output object (required subsetted data.frame called written serverside. addition, two validity messages returned via ds.dataFrameSubset indicating whether created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - dataFrameSubsetDS2 (via ds.dataFrame()) also returns studysideMessages can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"newobj\") print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message(\"newobj\") return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/dataFrameSubsetDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"data frame list variables number rows, class 'data.frame'. details see help header ds.dataFrameSubset","code":""},{"path":"/reference/dataFrameSubsetDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"dataFrameSubsetDS2 an assign function called by ds.dataFrameSubset — dataFrameSubsetDS2","text":"DataSHIELD Development Team","code":""},{"path":"/reference/densityGridDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Generates a density grid with or without a priori defined limits — densityGridDS","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"Generates density grid can used heatmap contour plots.","code":""},{"path":"/reference/densityGridDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"","code":"densityGridDS( xvect, yvect, limits = FALSE, x.min = NULL, x.max = NULL, y.min = NULL, y.max = NULL, numints = 20 )"},{"path":"/reference/densityGridDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"xvect numerical vector yvect numerical vector limits logical expression whether limits density grid defined user. limits set \"FALSE\", min max xvect yvect used range. limits set \"TRUE\", limits defined x.min, x.max, y.min y.max used. x.min minimum value x axis grid density object, needed x.max maximum value x axis grid density object, needed y.min minimum value y axis grid density object, needed y.max maximum value y axis grid density object, needed numints number intervals grid density object, default 20","code":""},{"path":"/reference/densityGridDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"grid density matrix","code":""},{"path":"/reference/densityGridDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"Invalid cells (cells count < set filter value minimum allowed counts table cells) turn 0.","code":""},{"path":"/reference/densityGridDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generates a density grid with or without a priori defined limits — densityGridDS","text":"Julia Isaeva, Amadou Gaye, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/dimDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the dimension of a data frame or matrix — dimDS","title":"Returns the dimension of a data frame or matrix — dimDS","text":"function similar R function dim.","code":""},{"path":"/reference/dimDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the dimension of a data frame or matrix — dimDS","text":"","code":"dimDS(x)"},{"path":"/reference/dimDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the dimension of a data frame or matrix — dimDS","text":"x string character, name dataframe matrix","code":""},{"path":"/reference/dimDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the dimension of a data frame or matrix — dimDS","text":"dimension input object","code":""},{"path":"/reference/dimDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the dimension of a data frame or matrix — dimDS","text":"function returns dimension input dataframe matrix","code":""},{"path":"/reference/dimDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the dimension of a data frame or matrix — dimDS","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/dmtC2SDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"Creates data.frame, matrix tibble serverside equivalent data.frame, matrix tibble (DMT) clientside.","code":""},{"path":"/reference/dmtC2SDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"","code":"dmtC2SDS( dfdata.mat.transmit, inout.object.transmit, from, nrows.transmit, ncols.transmit, colnames.transmit, colclass.transmit, byrow )"},{"path":"/reference/dmtC2SDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"dfdata.mat.transmit character string format can pass DataSHIELD R parser specifies name DMT copied clientside serverside. Value fully specified argument ds.dmtC2S. inout.object.transmit character string taking values \"DF\", \"MAT\" \"TBL\". value argument automatically set ds.dmtC2S depending whether clientside DMT data.frame, matrix tibble. Correspondingly, value determines whether object created serverside data.frame, matrix tibble. unlikely always work (class misspecifications may occur) works test cases. character string specifying source . Fixed clientside function \"clientside.matdftbl\". nrows.transmit specifies number rows matrix created. Fixed clientside function equal number rows clientside DMT transferred. ncols.transmit specifies number columns matrix created. Fixed clientside function equal number columns clientside DMT transferred. colnames.transmit parser-transmissible vector specifying name column DMT transferred clientside serverside. Generated automatically clientside function colnames clientside DMT. colclass.transmit parser-transmissible vector specifying class vector representing individual column DMT transferred. Generated automatically clientside function. allows transmission DMTs containing columns different classes.something going go wrong class misspecification (see inout.object.transmit) DMT complex combination data/column types likely cause. suggests always check class serverside DMT individual columns (latter important). situation arises class columns crucial function needed please contact DataSHIELD forum can try remedy problem. byrow logical value specifying whether DMT created serverside filled row row column column. fixed clientside function FALSE (fill column column).","code":""},{"path":"/reference/dmtC2SDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"object specified argument (default name \"matdftbl.copied.C2S\") written data.frame, matrix tibble serverside.","code":""},{"path":"/reference/dmtC2SDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"dmtC2SDS serverside assign function called ds.dmtC2S. information works see help ds.dmtC2S","code":""},{"path":"/reference/dmtC2SDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Copy a clientside data.frame, matrix or tibble (DMT) to the serverside. — dmtC2SDS","text":"Paul Burton DataSHIELD Development Team - 3rd June, 2021","code":""},{"path":"/reference/dsBase-package.html","id":null,"dir":"Reference","previous_headings":"","what":"dsBase: 'DataSHIELD' Server Side Base Functions — dsBase-package","title":"dsBase: 'DataSHIELD' Server Side Base Functions — dsBase-package","text":"Base 'DataSHIELD' functions server side. 'DataSHIELD' software package allows non-disclosive federated analysis sensitive data. 'DataSHIELD' analytic functions designed share non disclosive summary statistics, built automated output checking based statistical disclosure control. data sites setting threshold values automated output checks. details, see 'citation(\"dsBase\")'.","code":""},{"path":"/reference/dsBase-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"dsBase: 'DataSHIELD' Server Side Base Functions — dsBase-package","text":"Maintainer: Stuart Wheater stuart.wheater@arjuna.com (ORCID) Authors: Stuart Wheater stuart.wheater@arjuna.com (ORCID) Paul Burton (ORCID) Rebecca Wilson (ORCID) Olly Butters (ORCID) Patricia Ryser-Welch (ORCID) Alex Westerberg Leire Abarrategui Roberto Villegas-Diaz (ORCID) Demetris Avraam (ORCID) Yannick Marcon yannick.marcon@obiba.org (ORCID) Tom Bishop Amadou Gaye (ORCID) Xavier Escribà-Montagut (ORCID)","code":""},{"path":"/reference/elsplineDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"function based native R function elspline lspline package. function computes basis piecewise-linear spline , depending argument marginal, coefficients can interpreted (1) slopes consecutive spline segments, (2) slope change consecutive knots.","code":""},{"path":"/reference/elsplineDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"","code":"elsplineDS(x = x, n = n, marginal = FALSE, names = NULL)"},{"path":"/reference/elsplineDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"x name input numeric variable n integer greater 2, knots computed cut n equally-spaced intervals along range x marginal logical, parametrize spline, see Details names character, vector names constructed variables","code":""},{"path":"/reference/elsplineDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"object class \"lspline\" \"matrix\", name specified newobj argument (default name \"elspline.newobj\"), assigned serverside.","code":""},{"path":"/reference/elsplineDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"marginal FALSE (default) coefficients spline correspond slopes consecutive segments. TRUE first coefficient correspond slope first segment. consecutive coefficients correspond change slope compared previous segment. Function elspline wraps lspline computes knot positions cut range x n equal-width intervals.","code":""},{"path":"/reference/elsplineDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Basis for a piecewise linear spline with meaningful coefficients — elsplineDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/extractQuantilesDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"identify global values V2BR (.e. values across studies) relate set quantiles evaluated.","code":""},{"path":"/reference/extractQuantilesDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"extractQuantilesDS1(extract.quantiles, extract.summary.output.ranks.df)"},{"path":"/reference/extractQuantilesDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"extract.quantiles one restricted set character strings fix set quantile values corresponding values across studies estimated. details see associated document entitled \"secure.global.ranking.docx\", header ds.ranksSecure ds.extractQuantiles functions. value argument set choosing value argument ds.ranksSecure. extract.summary.output.ranks.df character string specifying optional name data.frame written serverside data source contains 5 key output variables ranking procedure pertaining particular data source. data frame represents key source information - including global ranks - determines values V2BR identified corresponding particular set quantiles estimated specified argument function ds.ranksSecure ( argument ds.extractQuantiles).","code":""},{"path":"/reference/extractQuantilesDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"first step creating vector values values V2BR correspond quantile value, extractQuantilesDS1 identifies two closest quantile values across studies span key quantile value. saved data frame \"closest.bounds.df\" clientside saved serverside ds.dmtC2S data frame \"global.bounds.df\". Also number observations across studies small, disclosure risk exists final.quantile.vector made available via client, function stops processing returns warning/error message.","code":""},{"path":"/reference/extractQuantilesDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside aggregate function called ds.extractQuantiles via ds.ranksSecure. well estimating key values V2BR correspond selected quantiles, function also implements disclosure control trap. ratio total number observations across studies divided number quantile values estimated less equal nfilter.subset (specifies minimum size subset) process stops error message returned suggesting might try selecting narrower range quantiles less quantile values estimated specified argument function ds.ranksSecure. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\"","code":""},{"path":"/reference/extractQuantilesDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 11th November, 2021","code":""},{"path":"/reference/extractQuantilesDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"identify global values V2BR (.e. values across studies) relate set quantiles evaluated.","code":""},{"path":"/reference/extractQuantilesDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"extractQuantilesDS2(extract.summary.output.ranks.df)"},{"path":"/reference/extractQuantilesDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"extract.summary.output.ranks.df character string specifies optional name data.frame written serverside data source contains 5 key output variables ranking procedure pertaining particular data source. data frame represents key source information - including global ranks - determines values V2BR identified corresponding particular set quantiles estimated specified argument function ds.ranksSecure ( argument ds.extractQuantiles).","code":""},{"path":"/reference/extractQuantilesDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"single value V2BR best corresponds key quantile value estimated specified argument data frame (final.quantile.df)summarising results analysis written clientside. data frame consists two vectors. first named \"evaluation.quantiles\". lists full set quantiles requested evaluation specified argument \"quantiles..estimation\" second vector called \"final.quantile.vector\" details values V2BR correspond key quantiles listed vector 1.","code":""},{"path":"/reference/extractQuantilesDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside aggregate function called ds.extractQuantiles via ds.ranksSecure. takes \"global.bounds.df\" data frame saved serverside following construction extractQuantilesDS1. data frame includes two quantile values closely span quartile value estimated. either values correct value given quantile, bounding values taken value global.bounds.df. upper bound defined lowest value equal greater true value quantile lower bound defined highest value equal lower true value. Next, function extractQuantileDS2 goes round study study identify values V2BR actually correspond spanning values around quantile. function goes quantile quantile estimates mean two values V2BR correspond spanning quantiles. two values means value V2BR \"true\" value mean two (potentially several) instances value inevitably also equal true value. upper lower bounding values V2BR differ, neither can precisely correct single value V2BR quantile (see explanation) mean two reasonable interpolated summary.","code":""},{"path":"/reference/extractQuantilesDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 11th November, 2021","code":""},{"path":"/reference/fixClassDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Change Class of Target Variables in a Data Frame — fixClassDS","title":"Change Class of Target Variables in a Data Frame — fixClassDS","text":"Change Class Target Variables Data Frame","code":""},{"path":"/reference/fixClassDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Change Class of Target Variables in a Data Frame — fixClassDS","text":"","code":"fixClassDS(df.name, target_vars, target_class)"},{"path":"/reference/fixClassDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Change Class of Target Variables in a Data Frame — fixClassDS","text":"df.name string representing name data frame. target_vars character vector specifying columns modified. target_class character vector specifying new classes column (1 = factor, 2 = integer, 3 = numeric, 4 = character, 5 = logical).","code":""},{"path":"/reference/fixClassDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Change Class of Target Variables in a Data Frame — fixClassDS","text":"modified data frame specified columns converted target classes.","code":""},{"path":"/reference/fixColsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Add Missing Columns with NA Values — fixColsDS","title":"Add Missing Columns with NA Values — fixColsDS","text":"Add Missing Columns NA Values","code":""},{"path":"/reference/fixColsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add Missing Columns with NA Values — fixColsDS","text":"","code":"fixColsDS(.data, cols)"},{"path":"/reference/fixColsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add Missing Columns with NA Values — fixColsDS","text":".data string representing name data frame. cols character vector specifying columns added missing.","code":""},{"path":"/reference/fixColsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add Missing Columns with NA Values — fixColsDS","text":"modified data frame missing columns added filled NA.","code":""},{"path":"/reference/fixLevelsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS","title":"Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS","text":"Set Factor Levels Specific Columns Data Frame","code":""},{"path":"/reference/fixLevelsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS","text":"","code":"fixLevelsDS(df.name, vars, levels)"},{"path":"/reference/fixLevelsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS","text":"df.name string representing name data frame modify. vars character vector specifying columns modified. levels named list element contains levels corresponding factor variable.","code":""},{"path":"/reference/fixLevelsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set Factor Levels for Specific Columns in a Data Frame — fixLevelsDS","text":"modified data frame specified columns converted factors provided levels.","code":""},{"path":"/reference/gamlssDS.html","id":null,"dir":"Reference","previous_headings":"","what":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"function calls gamlssDS wrapper function gamlss R package. function returns object class \"gamlss\", generalized additive model location, scale shape (GAMLSS). function also saves residuals object server-side name specified newobj argument. addition, argument centiles set TRUE, function calls centiles function gamlss package returns sample percentages centile curve.","code":""},{"path":"/reference/gamlssDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"","code":"gamlssDS( formula = formula, sigma.formula = sigma.formula, nu.formula = nu.formula, tau.formula = tau.formula, family = family, data = data, method = method, mu.fix = mu.fix, sigma.fix = sigma.fix, nu.fix = nu.fix, tau.fix = tau.fix, control = control, i.control = i.control, centiles = centiles, xvar = xvar, newobj = newobj )"},{"path":"/reference/gamlssDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"formula formula object, response left ~ operator, terms, separated + operators, right. Nonparametric smoothing terms indicated pb() penalised beta splines, cs smoothing splines, lo loess smooth terms random ra random terms, e.g. y~cs(x,df=5)+x1+x2*x3. sigma.formula formula object fitting model sigma parameter, formula , e.g. sigma.formula=~cs(x,df=5). nu.formula formula object fitting model nu parameter, e.g. nu.formula=~x tau.formula formula object fitting model tau parameter, e.g. tau.formula=~cs(x,df=2) family gamlss.family object, used define distribution link functions various parameters. distribution families supported gamlss() can found gamlss.family. Functions BI() (binomial) produce family object. Also can given without parentheses .e. BI. Family functions can take arguments, BI(mu.link=probit). data data frame containing variables occurring formula. missing, variables parent environment. method character indicating algorithm GAMLSS. Can either 'RS', 'CG' 'mixed'. method='RS' function use Rigby Stasinopoulos algorithm, method='CG' function use Cole Green algorithm, method='mixed' function use RS algorithm twice switching Cole Green algorithm 10 extra iterations. mu.fix logical, indicate whether mu parameter kept fixed fitting processes. sigma.fix logical, indicate whether sigma parameter kept fixed fitting processes. nu.fix logical, indicate whether nu parameter kept fixed fitting processes. tau.fix logical, indicate whether tau parameter kept fixed fitting processes. control sets control parameters outer iterations algorithm using gamlss.control function. vector 7 numeric values: () c.crit (convergence criterion algorithm), (ii) n.cyc (number cycles algorithm), (iii) mu.step (step length parameter mu), (iv) sigma.step (step length parameter sigma), (v) nu.step (step length parameter nu), (vi) tau.step (step length parameter tau), (vii) gd.tol (global deviance tolerance level). default values 7 parameters set c(0.001, 20, 1, 1, 1, 1, Inf). .control sets control parameters inner iterations RS algorithm using glim.control function. vector 4 numeric values: () cc (convergence criterion algorithm), (ii) cyc (number cycles algorithm), (iii) bf.cyc (number cycles backfitting algorithm), (iv) bf.tol (convergence criterion (tolerance level) backfitting algorithm). default values 4 parameters set c(0.001, 50, 30, 0.001). centiles logical, indicating whether function centiles() used tabulate sample percentages centile curve. Default set FALSE. xvar unique explanatory variable used centiles() function. variable used centiles argument set TRUE. restriction centiles function applies models one explanatory variable . newobj character string provides name output object stored data servers. Default gamlss_residuals.","code":""},{"path":"/reference/gamlssDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"gamlss object components native R gamlss function. Individual-level information like components y (response response) residuals (normalised quantile residuals model) disclosed client-side.","code":""},{"path":"/reference/gamlssDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"additional details see help header gamlss centiles functions native R gamlss package.","code":""},{"path":"/reference/gamlssDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"gamlssDS an aggregate function called by ds.gamlss — gamlssDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/getAllLevelsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Retrieve Factor Levels for Specific Columns — getAllLevelsDS","title":"Retrieve Factor Levels for Specific Columns — getAllLevelsDS","text":"Retrieve Factor Levels Specific Columns","code":""},{"path":"/reference/getAllLevelsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Retrieve Factor Levels for Specific Columns — getAllLevelsDS","text":"","code":"getAllLevelsDS(df.name, factor_vars)"},{"path":"/reference/getAllLevelsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Retrieve Factor Levels for Specific Columns — getAllLevelsDS","text":"df.name string representing name data frame. factor_vars character vector specifying factor columns.","code":""},{"path":"/reference/getAllLevelsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Retrieve Factor Levels for Specific Columns — getAllLevelsDS","text":"list factor levels specified columns.","code":""},{"path":"/reference/getClassAllColsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the Class of All Columns in a Data Frame — getClassAllColsDS","title":"Get the Class of All Columns in a Data Frame — getClassAllColsDS","text":"Get Class Columns Data Frame","code":""},{"path":"/reference/getClassAllColsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the Class of All Columns in a Data Frame — getClassAllColsDS","text":"","code":"getClassAllColsDS(df.name)"},{"path":"/reference/getClassAllColsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the Class of All Columns in a Data Frame — getClassAllColsDS","text":"df.name string representing name data frame.","code":""},{"path":"/reference/getClassAllColsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the Class of All Columns in a Data Frame — getClassAllColsDS","text":"tibble class column data frame.","code":""},{"path":"/reference/getWGSRDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"Calculate Growth Reference z-score given anthropometric measurement function similar R function getWGSR zscorer package.","code":""},{"path":"/reference/getWGSRDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"","code":"getWGSRDS(sex, firstPart, secondPart, index, standing = NA, thirdPart = NA)"},{"path":"/reference/getWGSRDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"sex name binary variable indicates sex subject. must coded 1 = male 2 = female. project variable sex different levels, recode levels 1 males 2 females using ds.recodeValues DataSHIELD function use ds.getWGSR. firstPart Name variable specifying: Weight (kg) BMI/, W/, W/H, W/L Head circumference (cm) HC/Height (cm) H/Length (cm) L/MUAC (cm) MUAC/Sub-scapular skinfold (mm) SSF/Triceps skinfold (mm) TSF/Give quoted variable name (e.g.) \"weight\". careful units (weight kg; height, length, head circumference, MUAC cm, skinfolds mm). secondPart Name variable specifying: Age (days) H/, HC/, L/, MUAC/, SSF/, TSF/Height (cm) BMI/, W/H Length (cm) W/L Give quoted variable name (e.g.) \"age\". careful units (age days; height length cm). index index calculated added data. One : bfa BMI age hca Head circumference age hfa Height age lfa Length age mfa MUAC age ssa Sub-scapular skinfold age tsa Triceps skinfold age wfa Weight age wfh Weight height wfl Weight length Give quoted index name (e.g.) \"wfh\". standing Variable specifying stature measured. NA (default) age (\"hfa\" \"lfa\") height rules (\"wfh\" \"wfl\") applied. must coded 1 = Standing; 2 = Supine; 3 = Unknown. Missing values recoded 3 = Unknown. Give single value (e.g.\"1\"). value specified height age rules applied. thirdPart Name variable specifying age (days) BMI/. Give quoted variable name (e.g.) \"age\". careful units (age days).","code":""},{"path":"/reference/getWGSRDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"ds.getWGSR assigns numeric vector includes z-scores specified index.","code":""},{"path":"/reference/getWGSRDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"function computes Growth Reference z-scores anthropometric data weight, height length, MUAC, head circumference, sub-scapular skinfold triceps skinfold. Note function might fail return NAs variables outside ranges given WGS (Child Growth Standards) reference (.e. 45 120 cm height 0 60 months age). user check ranges units data.","code":""},{"path":"/reference/getWGSRDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the WHO Growth Reference z-scores of anthropometric data — getWGSRDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/glmDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"glmDS1 called by ds.glm — glmDS1","title":"glmDS1 called by ds.glm — glmDS1","text":"first server-side aggregate function called ds.glm","code":""},{"path":"/reference/glmDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"glmDS1 called by ds.glm — glmDS1","text":"","code":"glmDS1(formula, family, weights, offset, data)"},{"path":"/reference/glmDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"glmDS1 called by ds.glm — glmDS1","text":"formula glm() formula consistent R syntax eg U~x+y+Z regress variables U x,y Z family glm() family consistent R syntax eg \"gaussian\", \"poisson\", \"binomial\" weights optional variable providing regression weights offset offset data optional character string specifying data.frame object holding data analysed specified model","code":""},{"path":"/reference/glmDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"glmDS1 called by ds.glm — glmDS1","text":"List values GLM model.","code":""},{"path":"/reference/glmDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"glmDS1 called by ds.glm — glmDS1","text":"aggregation function sets model structure creates starting beta.vector feeds, via ds.glm, glmDS2 enable iterative fitting generalized linear model specified. details please see extensive header ds.glm.","code":""},{"path":"/reference/glmDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"glmDS1 called by ds.glm — glmDS1","text":"Burton PR DataSHIELD Development Team","code":""},{"path":"/reference/glmDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"glmDS2 called by ds.glm — glmDS2","title":"glmDS2 called by ds.glm — glmDS2","text":"second server-side aggregate function called ds.glm.","code":""},{"path":"/reference/glmDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"glmDS2 called by ds.glm — glmDS2","text":"","code":"glmDS2(formula, family, beta.vect, offset, weights, dataName)"},{"path":"/reference/glmDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"glmDS2 called by ds.glm — glmDS2","text":"formula glm() formula consistent R syntax eg U~x+y+Z regress variables U x, y Z family glm() family consistent R syntax eg \"gaussian\", \"poisson\", \"binomial\" beta.vect numeric vector created clientside function specifying vector regression coefficients current iteration offset optional variable providing regression offset weights optional variable providing regression weights dataName optional character string specifying data.frame object holding data analysed specified model ","code":""},{"path":"/reference/glmDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"glmDS2 called by ds.glm — glmDS2","text":"List values GLM model","code":""},{"path":"/reference/glmDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"glmDS2 called by ds.glm — glmDS2","text":"aggregate function uses model structure starting beta.vector constructed glmDS1 iteratively fit generalized linear model specified. function glmDS2 also carries series disclosure checks arguments data fail tests, model construction blocked appropriate serverside error message created returned ds.glm clientside. details please see extensive header ds.glm.","code":""},{"path":"/reference/glmDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"glmDS2 called by ds.glm — glmDS2","text":"Paul Burton, DataSHIELD Development Team","code":""},{"path":"/reference/glmPredictDS.ag.html","id":null,"dir":"Reference","previous_headings":"","what":"predict regression responses from a glm object — glmPredictDS.ag","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"identify return key components/summaries serverside glm_predict object can safely returned clientside without disclosure risk","code":""},{"path":"/reference/glmPredictDS.ag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"","code":"glmPredictDS.ag( glmname.transmit, newdataname.transmit, output.type, se.fit, dispersion, terms.transmit, na.action )"},{"path":"/reference/glmPredictDS.ag.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"glmname.transmit character string specifying name glm object serverside used prediction. Fully specified glmname argument ds.glmPredict newdataname.transmit character string specifying (optional) dataframe serverside look (potentially) new covariate values base predictions. Fully specified newdataname argument ds.glmPredict. output.type character string taking values 'response', 'link' 'terms'. Fully specified corresponding argument ds.glmPredict. se.fit logical standard errors fitted predictions required. Fully specified corresponding argument ds.glmPredict. dispersion numeric value specifying dispersion GLM fit assumed computing standard errors. Fully specified corresponding argument ds.glmPredict. terms.transmit character vector specifying subset terms return prediction. Fully specified 'terms' argument ds.glmPredict. na.action character string determining done missing values data.frame identified . Fully specified na.action argument ds.glmPredict.","code":""},{"path":"/reference/glmPredictDS.ag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"components/summarising statistics serverside predict_glm object can safely transmitted clientside without risk disclosure. details see DataSHIELD help ds.glmPredict glmPredict.help native R predict.glm predict.glm native R","code":""},{"path":"/reference/glmPredictDS.ag.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"Serverside aggregate function called ds.glmPredict. called immediately assign function glmPredict.created predict_glm object serverside applying equivalent predict.glm() native R glm object serverside. aggregate function, glmPredict.ag, identifies returns components predict_glm object can safely returned clientside without risk disclosure. details see DataSHIELD help ds.glmPredict glmPredict.help native R predict.glm","code":""},{"path":"/reference/glmPredictDS.ag.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"predict regression responses from a glm object — glmPredictDS.ag","text":"Paul Burton DataSHIELD Development Team (20/7/20)","code":""},{"path":"/reference/glmPredictDS.as.html","id":null,"dir":"Reference","previous_headings":"","what":"predict regression responses from a glm object — glmPredictDS.as","title":"predict regression responses from a glm object — glmPredictDS.as","text":"create predict_glm object serverside applying equivalent predict.glm() native R glm object serverside. Identify return components predict_glm object can safely sent clientside without risk disclosure","code":""},{"path":"/reference/glmPredictDS.as.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"predict regression responses from a glm object — glmPredictDS.as","text":"","code":"glmPredictDS.as( glmname.transmit, newdataname.transmit, output.type, se.fit, dispersion, terms.transmit, na.action )"},{"path":"/reference/glmPredictDS.as.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"predict regression responses from a glm object — glmPredictDS.as","text":"glmname.transmit character string specifying name glm object serverside used prediction. Fully specified glmname argument ds.glmPredict newdataname.transmit character string specifying (optional) dataframe serverside look (potentially) new covariate values base predictions. Fully specified newdataname argument ds.glmPredict. output.type character string taking values 'response', 'link' 'terms'. Fully specified corresponding argument ds.glmPredict. se.fit logical standard errors fitted predictions required. Fully specified corresponding argument ds.glmPredict. dispersion numeric value specifying dispersion GLM fit assumed computing standard errors. Fully specified corresponding argument ds.glmPredict. terms.transmit character vector specifying subset terms return prediction. Fully specified 'terms' argument ds.glmPredict. na.action character string determining done missing values data.frame identified . Fully specified na.action argument ds.glmPredict.","code":""},{"path":"/reference/glmPredictDS.as.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"predict regression responses from a glm object — glmPredictDS.as","text":"glmPredict.writes new object serverside containing output precisely equivalent output predict.glm native R. details see DataSHIELD help ds.glmPredict help predict.glm native R","code":""},{"path":"/reference/glmPredictDS.as.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"predict regression responses from a glm object — glmPredictDS.as","text":"Serverside assign function called ds.glmPredict makes predictions regression responses based serverside glm object already created serverside ds.glmSLMA writes predict_glm object serverside. details see help ds.glmPredict help native R predict.glm","code":""},{"path":"/reference/glmPredictDS.as.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"predict regression responses from a glm object — glmPredictDS.as","text":"Paul Burton DataSHIELD Development Team (20/7/20)","code":""},{"path":"/reference/glmSLMADS.assign.html","id":null,"dir":"Reference","previous_headings":"","what":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"Fits generalized linear model (GLM) data single multiple sources pooled co-analysis across studies based SLMA (Study Level Meta Analysis).","code":""},{"path":"/reference/glmSLMADS.assign.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"","code":"glmSLMADS.assign(formula, family, offsetName, weightsName, dataName)"},{"path":"/reference/glmSLMADS.assign.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"formula glm formula, specified call ds.glmSLMA family glm family, specified call ds.glmSLMA offsetName character string specifying variable used offset. Specified call ds.glmSLMA. weightsName character string specifying variable used regression weights. Specified call ds.glmSLMA. Specified call ds.glmSLMA. dataName character string specifying name data.frame holding data model. Specified call ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS.assign.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"writes glm object summarising fitted model serverside. detailed information see help ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS.assign.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"glmSLMADS.assign assign function called clientside function ds.glmSLMA. ds.glmSLMA also calls two aggregate functions glmSLMADS1 glmSLMADS2. detailed information see help ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS.assign.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS.assign","text":"Paul Burton DataSHIELD Development Team (14/7/20)","code":""},{"path":"/reference/glmSLMADS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"Fits generalized linear model (GLM) data single multiple sources pooled co-analysis across studies based SLMA (Study Level Meta Analysis).","code":""},{"path":"/reference/glmSLMADS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"","code":"glmSLMADS1(formula, family, weights, offset, data)"},{"path":"/reference/glmSLMADS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"formula glm formula, specified call ds.glmSLMA family glm family, specified call ds.glmSLMA weights character string specifying variable used regression weights. Specified call ds.glmSLMA. Specified call ds.glmSLMA. offset character string specifying variable used offset. Specified call ds.glmSLMA. data character string specifying name data.frame holding data model. Specified dataName call ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"assesses returns information failure pass disclosure traps test model complexity (saturation). detailed information see help ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"glmSLMADS.assign aggregate function called clientside function ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 assign function glmSLMADS.assign detailed information see help ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS1","text":"Paul Burton DataSHIELD Development Team (14/7/20)","code":""},{"path":"/reference/glmSLMADS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"Fits generalized linear model (GLM) data single multiple sources pooled co-analysis across studies based SLMA (Study Level Meta Analysis).","code":""},{"path":"/reference/glmSLMADS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"","code":"glmSLMADS2(formula, family, offset, weights, newobj, dataName)"},{"path":"/reference/glmSLMADS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"formula glm formula, specified call ds.glmSLMA family glm family, specified call ds.glmSLMA offset character string specifying variable used offset. Specified call ds.glmSLMA. weights character string specifying variable used regression weights. Specified call ds.glmSLMA. Specified call ds.glmSLMA. newobj character string specifying name glm object written serverside glmSLMADS.assign. either name specified newobj argument ds.glmSLMA newobj unspecified NULL called new.glm.obj. dataName character string specifying name data.frame holding data model. Specified call ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"quantitative, Boolean, character objects required enable SLMA pooling separate glm models fitted study - particular including study-specific regression coefficients corresponding standard errors.","code":""},{"path":"/reference/glmSLMADS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"glmSLMADS.assign aggregate function called clientside function ds.glmSLMA. ds.glmSLMA also calls another aggregate function glmSLMADS2 assign function glmSLMADS.assign detailed information see help ds.glmSLMA.","code":""},{"path":"/reference/glmSLMADS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fit a Generalized Linear Model (GLM) with pooling via Study Level Meta-Analysis (SLMA) — glmSLMADS2","text":"Paul Burton DataSHIELD Development Team (14/7/20)","code":""},{"path":"/reference/glmSummaryDS.ag.html","id":null,"dir":"Reference","previous_headings":"","what":"summarize a glm object on the serverside — glmSummaryDS.ag","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"returns non-disclosive elements clientside glm object corresponding object holding output summary(glm object) serverside.","code":""},{"path":"/reference/glmSummaryDS.ag.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"","code":"glmSummaryDS.ag(x.transmit)"},{"path":"/reference/glmSummaryDS.ag.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"x.transmit character string specifying name glm object serverside summarised. specified x.name argument ds.glmSummary","code":""},{"path":"/reference/glmSummaryDS.ag.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"returns clientside non-disclosive elements (non-disclosive elements) specified serverside glm corresponding summary_glm object.","code":""},{"path":"/reference/glmSummaryDS.ag.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"Serverside aggregate function called ds.glmSummary. ds.glmSummary first calls glmSummaryDS.ag create glm_summary object serverside based applying native R's summary.glm() serverside glm object previously created ds.glmSLMA. calls glmSummaryDS.ag return clientside non-disclosive elements (non-disclosive elements) serverside glm corresponding summary_glm object.","code":""},{"path":"/reference/glmSummaryDS.ag.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"summarize a glm object on the serverside — glmSummaryDS.ag","text":"Paul Burton DataSHIELD Development Team (20/7/20)","code":""},{"path":"/reference/glmSummaryDS.as.html","id":null,"dir":"Reference","previous_headings":"","what":"summarize a glm object on the serverside — glmSummaryDS.as","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"summarize glm object serverside create summary_glm object. Also identify return components glm object summary_glm object can safely sent clientside without risk disclosure","code":""},{"path":"/reference/glmSummaryDS.as.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"","code":"glmSummaryDS.as(x.transmit)"},{"path":"/reference/glmSummaryDS.as.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"x.transmit character string specifying name glm object serverside summarised. specified x.name argument ds.glmSummary","code":""},{"path":"/reference/glmSummaryDS.as.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"writes object serverside precisely equivalent summary(glm object) native R","code":""},{"path":"/reference/glmSummaryDS.as.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"Serverside assign function called ds.glmSummary summarises glm object already created serverside fitting ds.glmSLMA writes summary_glm object serverside. details see help ds.glmSLMA help native R glm() summary.glm","code":""},{"path":"/reference/glmSummaryDS.as.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"summarize a glm object on the serverside — glmSummaryDS.as","text":"Paul Burton DataSHIELD Development Team (20/7/20)","code":""},{"path":"/reference/glmerSLMADS.assign.html","id":null,"dir":"Reference","previous_headings":"","what":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"glmerSLMADS.assign glmerSLMADS2 fits generalized linear mixed effects model (glme) per study saves outcomes study","code":""},{"path":"/reference/glmerSLMADS.assign.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"","code":"glmerSLMADS.assign( formula, offset, weights, dataName, family, control_type = NULL, control_value.transmit = NULL, nAGQ = 1L, verbose = 0, theta = NULL, fixef = NULL )"},{"path":"/reference/glmerSLMADS.assign.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"formula see help ds.glmerSLMA offset see help ds.glmerSLMA weights see help ds.glmerSLMA dataName see help ds.glmerSLMA family see help ds.glmerSLMA control_type see help ds.glmerSLMA control_value.transmit see help argument function ds.glmerSLMA nAGQ integer scalar, defaulting 1L. PRACTICE, MAY NECESSARY SET nAGQ 0L model appears converge perfectly well (e.g. verbose=2 demonstrates good initial convergence log-likelihood regression coefficients) formal convergence get declared - output produced - despite running model many iterations. nAGQ argument set nAGQ argument ds.glmerSLMA details can found help(ds.glmerSLMA) native R help glmer() verbose see help ds.glmerSLMA theta see help argument function ds.glmerSLMA fixef see help argument function ds.glmerSLMA","code":""},{"path":"/reference/glmerSLMADS.assign.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"writes glmerMod object summarising fitted model serverside. detailed information see help ds.glmerSLMA.","code":""},{"path":"/reference/glmerSLMADS.assign.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"glmerSLMADS.assign serverside function called ds.glmerSLMA clientside. analytic work engine glmer function R sits lme4 package. glmerSLMADS.assign fits generalized linear mixed effects model (glme) - e.g. logistic Poisson regression model including fixed random effects - data single data source saves regression outcomes serverside.","code":""},{"path":"/reference/glmerSLMADS.assign.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS.assign","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/glmerSLMADS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"glmerSLMADS2 fits generalized linear mixed effects model (glme) - e.g. logistic Poisson regression model including fixed random effects - data one multiple sources pooling via SLMA (study level meta-analysis)","code":""},{"path":"/reference/glmerSLMADS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"","code":"glmerSLMADS2( formula, offset, weights, dataName, family, control_type = NULL, control_value.transmit = NULL, nAGQ = 1L, verbose = 0, theta = NULL, fixef = NULL )"},{"path":"/reference/glmerSLMADS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"formula see help ds.glmerSLMA offset see help ds.glmerSLMA weights see help ds.glmerSLMA dataName see help ds.glmerSLMA family see help ds.glmerSLMA control_type see help ds.glmerSLMA control_value.transmit see help argument function ds.glmerSLMA nAGQ integer scalar, defaulting 1L. PRACTICE, MAY NECESSARY SET nAGQ 0L model appears converge perfectly well (e.g. verbose=2 demonstrates good initial convergence log-likelihood regression coefficients) formal convergence get declared - output produced - despite running model many iterations. nAGQ argument set nAGQ argument ds.glmerSLMA details can found help(ds.glmerSLMA) native R help glmer() verbose see help ds.glmerSLMA theta see help argument function ds.glmerSLMA fixef see help argument function ds.glmerSLMA","code":""},{"path":"/reference/glmerSLMADS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"key model components see help ds.glmerSLMA","code":""},{"path":"/reference/glmerSLMADS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"glmerSLMADS2 serverside function called ds.glmerSLMA clientside. analytic work engine glmer function R sits lme4 package. ds.glmerSLMA fits generalized linear mixed effects model (glme) - e.g. logistic Poisson regression model including fixed random effects - data single multiple sources. multiple data sources, glme fitted convergence data source independently estimates standard errors returned client thereby enabling cross-study pooling using study level meta-analysis (SLMA). default SLMA undertaken using metafor package, SLMA occurs clientside , far user concerned just standard R environment, user can choose use approach meta-analysis choose. Additional information fitting glmes using glmer engine can obtained using R help glmer lme4 package","code":""},{"path":"/reference/glmerSLMADS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fitting generalized linear mixed effect models - serverside function — glmerSLMADS2","text":"Tom Bishop, additions Paul Burton","code":""},{"path":"/reference/heatmapPlotDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"function calculates coordinates centroids n nearest neighbours.","code":""},{"path":"/reference/heatmapPlotDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"","code":"heatmapPlotDS(x, y, k, noise, method.indicator)"},{"path":"/reference/heatmapPlotDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"x name numeric vector, x-variable. y name numeric vector, y-variable. k number nearest neighbours centroid calculated method.indicator equal 1 (.e. deterministic method). noise percentage initial variance used variance embedded noise method.indicator equal 2 (.e. probabilistic method). method.indicator number equal either 1 2. value equal 1 'deterministic' method used. value set 2 'probabilistic' method used.","code":""},{"path":"/reference/heatmapPlotDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"list x y coordinates centroids deterministic method used x y coordinated noisy data probabilistic method used.","code":""},{"path":"/reference/heatmapPlotDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"function finds n-1 nearest neighbours data point 2-dimensional space. nearest neighbours data points minimum Euclidean distances point interest. point interest n-1 nearest neighbours used calculation coordinates centroid n points. Centroid referred centre mass, .e. x-coordinate centroid average value x-coordinates n nearest neighbours y-coordinate centroid average y-coordinates n nearest neighbours. coordinates centroids return client side function can used plot non-disclosive graphs (e.g. scatter plots, heatmap plots, contour plots, etc).","code":""},{"path":"/reference/heatmapPlotDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the coordinates of the centroid of each n nearest neighbours — heatmapPlotDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/hetcorDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Heterogeneous Correlation Matrix — hetcorDS","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"function based hetcor function R package polycor.","code":""},{"path":"/reference/hetcorDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"","code":"hetcorDS(data, ML, std.err, bins, pd, use)"},{"path":"/reference/hetcorDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"data name data frame consisting factors, ordered factors, logical variables, character variables, /numeric variables, first several variables. ML TRUE, compute maximum-likelihood estimates; FALSE (default), compute quick two-step estimates. std.err TRUE (default), compute standard errors. bins number bins use continuous variables testing bivariate normality; default 4. pd TRUE (default) correlation matrix positive-definite, attempt made adjust positive-definite matrix, using nearPD function Matrix package. Note default arguments nearPD used (except corr=TRUE); control call nearPD directly. use \"complete.obs\", remove observations missing data; \"pairwise.complete.obs\", compute correlation using observations valid data pair variables.","code":""},{"path":"/reference/hetcorDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"Returns object class \"hetcor\" following components: correlation matrix; type correlation: \"Pearson\", \"Polychoric\", \"Polyserial\"; standard errors correlations, requested; number (numbers) observations correlations based; p-values tests bivariate normality pair variables; method missing data handled: \"complete.obs\" \"pairwise.complete.obs\"; TRUE ML estimates, FALSE two-step estimates.","code":""},{"path":"/reference/hetcorDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"Computes heterogeneous correlation matrix, consisting Pearson product-moment correlations numeric variables, polyserial correlations numeric ordinal variables, polychoric correlations ordinal variables.","code":""},{"path":"/reference/hetcorDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Heterogeneous Correlation Matrix — hetcorDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/histogramDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"returns the minimum and the maximum of the input numeric vector — histogramDS1","title":"returns the minimum and the maximum of the input numeric vector — histogramDS1","text":"function returns minimum maximum input numeric vector depends argument method.indicator. method.indicator set 1 (.e. 'smallCellsRule' used) computed minimum maximum values multiplied small random number. method.indicator set 2 (.e. 'deterministic' method used) function returns minimum maximum values vector scaled centroids. method.indicator set 3 (.e. 'probabilistic' method used) function returns minimum maximum values generated 'noisy' vector.","code":""},{"path":"/reference/histogramDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"returns the minimum and the maximum of the input numeric vector — histogramDS1","text":"","code":"histogramDS1(xvect, method.indicator, k, noise)"},{"path":"/reference/histogramDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"returns the minimum and the maximum of the input numeric vector — histogramDS1","text":"xvect numeric vector histogram desired. method.indicator number equal either 1, 2 3 indicating method disclosure control used generation histogram. value equal 1 'smallCellsRule' used. value equal 2 'deterministic' method used. value set 3 'probabilistic' method used. k number nearest neighbours centroid calculated method.indicator equal 2 (.e. deterministic method). noise percentage initial variance used variance embedded noise method.indicator equal 3 (.e. probabilistic method).","code":""},{"path":"/reference/histogramDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"returns the minimum and the maximum of the input numeric vector — histogramDS1","text":"numeric vector contains minimum maximum values vector","code":""},{"path":"/reference/histogramDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"returns the minimum and the maximum of the input numeric vector — histogramDS1","text":"Amadou Gaye, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/histogramDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes a histogram of the input variable without plotting. — histogramDS2","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"function produces information required plot histogram. done without allowing bins (cells) number counts less pre-specified disclosure control set minimum cell size table. bin less counts threshold counts density replaced 0 value.","code":""},{"path":"/reference/histogramDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"","code":"histogramDS2(xvect, num.breaks, min, max, method.indicator, k, noise)"},{"path":"/reference/histogramDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"xvect numeric vector histogram desired. num.breaks number breaks range variable divided. min numeric, lower limit distribution. max numeric, upper limit distribution. method.indicator number equal either 1, 2 3 indicating method disclosure control used generation histogram. value equal 1 'smallCellsRule' used. value equal 2 'deterministic' method used. value set 3 'probabilistic' method used. k number nearest neighbours centroid calculated method.indicator equal 2 (.e. deterministic method). noise percentage initial variance used variance embedded noise method.indicator equal 3 (.e. probabilistic method).","code":""},{"path":"/reference/histogramDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"list object class histogram number invalid cells","code":""},{"path":"/reference/histogramDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"Please find details documentation clientside ds.histogram function.","code":""},{"path":"/reference/histogramDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes a histogram of the input variable without plotting. — histogramDS2","text":"Amadou Gaye, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/igb_standardsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"Converts birth measurements INTERGROWTH z-scores/centiles (generic)","code":""},{"path":"/reference/igb_standardsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"","code":"igb_standardsDS( gagebrth = gagebrth, z = z, p = p, val = val, var = var, sex = sex, fun = fun )"},{"path":"/reference/igb_standardsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"gagebrth name \"gestational age birth days\" variable. z z-score(s) convert (must 0 1). Default value 0. value used fun set \"igb_zscore2value\". p centile(s) convert (must 0 100). Default value p=50. value used fun set \"igb_centile2value\". val name anthropometric variable convert. var name measurement convert (\"lencm\", \"wtkg\", \"hcircm\", \"wlr\") sex name sex factor variable. variable coded Male/Female. coded differently (e.g. 0/1), can use ds.recodeValues function recode categories Male/Female use ds.igb_standards fun name function used. can one : \"igb_centile2value\", \"igb_zscore2value\", \"igb_value2zscore\" (default), \"igb_value2centile\".","code":""},{"path":"/reference/igb_standardsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"assigns converted measurement new object server-side","code":""},{"path":"/reference/igb_standardsDS.html","id":"note","dir":"Reference","previous_headings":"","what":"Note","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"gestational ages 24 33 weeks, INTERGROWTH early preterm standard used.","code":""},{"path":"/reference/igb_standardsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Converts birth measurements to intergrowth z-scores/centiles — igb_standardsDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/isNaDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Checks if a vector is empty — isNaDS","title":"Checks if a vector is empty — isNaDS","text":"function similar R function .na instead vector booleans returns just one boolean tell element missing values.","code":""},{"path":"/reference/isNaDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Checks if a vector is empty — isNaDS","text":"","code":"isNaDS(xvect)"},{"path":"/reference/isNaDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Checks if a vector is empty — isNaDS","text":"xvect numerical character vector","code":""},{"path":"/reference/isNaDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Checks if a vector is empty — isNaDS","text":"integer '1' vector contains NAs '0' otherwise","code":""},{"path":"/reference/isNaDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Checks if a vector is empty — isNaDS","text":"Gaye, .","code":""},{"path":"/reference/isValidDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Checks if an input is valid — isValidDS","title":"Checks if an input is valid — isValidDS","text":"Tells object server side valid.","code":""},{"path":"/reference/isValidDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Checks if an input is valid — isValidDS","text":"","code":"isValidDS(obj)"},{"path":"/reference/isValidDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Checks if an input is valid — isValidDS","text":"obj, vector (numeric, integer, factor, character), data.frame matrix","code":""},{"path":"/reference/isValidDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Checks if an input is valid — isValidDS","text":"boolean, TRUE input valid FALSE .","code":""},{"path":"/reference/isValidDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Checks if an input is valid — isValidDS","text":"function checks object valid.","code":""},{"path":"/reference/isValidDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Checks if an input is valid — isValidDS","text":"Gaye, .","code":""},{"path":"/reference/kurtosisDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the kurtosis of a numeric variable — kurtosisDS1","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"function calculates kurtosis numeric variable study separately.","code":""},{"path":"/reference/kurtosisDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"","code":"kurtosisDS1(x, method)"},{"path":"/reference/kurtosisDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"x string character, name numeric variable. method integer 1 3 selecting one algorithms computing kurtosis detailed headers client-side ds.kurtosis function.","code":""},{"path":"/reference/kurtosisDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"list including kurtosis input numeric variable, number valid observations study-side validity message.","code":""},{"path":"/reference/kurtosisDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"function calculates kurtosis input variable x three different methods. method specified argument method client-side ds.kurtosis function.","code":""},{"path":"/reference/kurtosisDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the kurtosis of a numeric variable — kurtosisDS1","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/kurtosisDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the kurtosis of a numeric variable — kurtosisDS2","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"function calculates summary statistics returned client-side used estimation combined kurtosis numeric variable across studies.","code":""},{"path":"/reference/kurtosisDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"","code":"kurtosisDS2(x, global.mean)"},{"path":"/reference/kurtosisDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"x string character, name numeric variable. global.mean numeric, combined mean input variable across studies.","code":""},{"path":"/reference/kurtosisDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"list including sum quartic differences values x global mean x across studies, sum squared differences values x global mean x across studies, number valid observations (.e. length x excluding missing values), validity message indicating indicating valid analysis number valid observations protection filter nfilter.tab invalid analysis otherwise.","code":""},{"path":"/reference/kurtosisDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"function calculates sum squared differences values x global mean x across studies, sum quatric differences values x global mean x across studies number valid observations input variable x.","code":""},{"path":"/reference/kurtosisDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the kurtosis of a numeric variable — kurtosisDS2","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/lengthDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the length of a vector or list — lengthDS","title":"Returns the length of a vector or list — lengthDS","text":"function similar R function length.","code":""},{"path":"/reference/lengthDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the length of a vector or list — lengthDS","text":"","code":"lengthDS(x)"},{"path":"/reference/lengthDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the length of a vector or list — lengthDS","text":"x string character, name vector list","code":""},{"path":"/reference/lengthDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the length of a vector or list — lengthDS","text":"numeric, number elements input vector list.","code":""},{"path":"/reference/lengthDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the length of a vector or list — lengthDS","text":"function returns length input vector list.","code":""},{"path":"/reference/lengthDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the length of a vector or list — lengthDS","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/levelsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the levels of a factor vector — levelsDS","title":"Returns the levels of a factor vector — levelsDS","text":"function similar R function levels.","code":""},{"path":"/reference/levelsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the levels of a factor vector — levelsDS","text":"","code":"levelsDS(x)"},{"path":"/reference/levelsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the levels of a factor vector — levelsDS","text":"x factor vector","code":""},{"path":"/reference/levelsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the levels of a factor vector — levelsDS","text":"list, factor levels present vector","code":""},{"path":"/reference/levelsDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the levels of a factor vector — levelsDS","text":"function returns levels input vector list.","code":""},{"path":"/reference/levelsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the levels of a factor vector — levelsDS","text":"Alex Westerberg, DataSHIELD Development Team","code":""},{"path":"/reference/lexisDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"lexisDS1 — lexisDS1","title":"lexisDS1 — lexisDS1","text":"first server-side function called ds.lexis.","code":""},{"path":"/reference/lexisDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"lexisDS1 — lexisDS1","text":"","code":"lexisDS1(exitCol = NULL)"},{"path":"/reference/lexisDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"lexisDS1 — lexisDS1","text":"exitCol character string specifying variable holding time individual censored fails","code":""},{"path":"/reference/lexisDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"lexisDS1 — lexisDS1","text":"List `max.time`","code":""},{"path":"/reference/lexisDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"lexisDS1 — lexisDS1","text":"aggregate function. details see extensive header ds.lexis.","code":""},{"path":"/reference/lexisDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"lexisDS1 — lexisDS1","text":"Burton PR","code":""},{"path":"/reference/lexisDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"lexisDS2 — lexisDS2","title":"lexisDS2 — lexisDS2","text":"second serverside function called ds.lexis.","code":""},{"path":"/reference/lexisDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"lexisDS2 — lexisDS2","text":"","code":"lexisDS2( datatext = NULL, intervalWidth, maxmaxtime, idCol, entryCol, exitCol, statusCol, vartext = NULL )"},{"path":"/reference/lexisDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"lexisDS2 — lexisDS2","text":"datatext clientside provided character string specifying data.frame holding data set expanded intervalWidth clientside generated character string specifying width survival epochs expanded data maxmaxtime clientside generated object specifying maximum follow time sources idCol clientside generated character string specifying variable holding IDs individuals data set expanded entryCol clientside specified character string identifying variable holding time individual starts follow exitCol clientside specified character string identifying variable holding time individual ends follow (censored fails) statusCol clientside specified character string identifying variable holding final censoring status (failed/censored) vartext clientside provided vector character strings denoting column names additional variables include final expanded table. 'variables' argument set (null) 'data' argument set full data.frame expanded carried forward","code":""},{"path":"/reference/lexisDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"lexisDS2 — lexisDS2","text":"List `expanded.table`","code":""},{"path":"/reference/lexisDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"lexisDS2 — lexisDS2","text":"assign function actually creates expanded dataframe containing survival data piecewise exponential regression. lexisDS2 also carries series disclosure checks arguments data fail tests, creation expanded dataframe blocked appropriate serverside error message stored. details see extensive header ds.lexis.","code":""},{"path":"/reference/lexisDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"lexisDS2 — lexisDS2","text":"Burton PR","code":""},{"path":"/reference/lexisDS3.html","id":null,"dir":"Reference","previous_headings":"","what":"@title lexisDS3 — lexisDS3","title":"@title lexisDS3 — lexisDS3","text":"third serverside function called ds.lexis.","code":""},{"path":"/reference/lexisDS3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"@title lexisDS3 — lexisDS3","text":"","code":"lexisDS3()"},{"path":"/reference/lexisDS3.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"@title lexisDS3 — lexisDS3","text":"Data frame `messageobj` object","code":""},{"path":"/reference/lexisDS3.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"@title lexisDS3 — lexisDS3","text":"assign function simplifies returned output ds.lexis. Specifically, without lexisDS3 output consists table within list, lexisDS3 converts directly dataframe. details see extensive header ds.lexis.","code":""},{"path":"/reference/listDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Coerce objects into a list — listDS","title":"Coerce objects into a list — listDS","text":"function similar R function 'list'","code":""},{"path":"/reference/listDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coerce objects into a list — listDS","text":"","code":"listDS(input = NULL, eltnames = NULL)"},{"path":"/reference/listDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coerce objects into a list — listDS","text":"input list objects coerce list eltnames character list, names elements list.","code":""},{"path":"/reference/listDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coerce objects into a list — listDS","text":"list","code":""},{"path":"/reference/listDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coerce objects into a list — listDS","text":"Unlike R function 'list' takes also vector characters, names elements output list.","code":""},{"path":"/reference/listDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Coerce objects into a list — listDS","text":"Gaye, .","code":""},{"path":"/reference/listDisclosureSettingsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"listDisclosureSettingsDS — listDisclosureSettingsDS","title":"listDisclosureSettingsDS — listDisclosureSettingsDS","text":"serverside function aggregate function called ds.listDisclosureSettings","code":""},{"path":"/reference/listDisclosureSettingsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"listDisclosureSettingsDS — listDisclosureSettingsDS","text":"","code":"listDisclosureSettingsDS()"},{"path":"/reference/listDisclosureSettingsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"listDisclosureSettingsDS — listDisclosureSettingsDS","text":"List DataSHIELD disclosure settings","code":""},{"path":"/reference/listDisclosureSettingsDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"listDisclosureSettingsDS — listDisclosureSettingsDS","text":"details see extensive header ds.listDisclosureSettings","code":""},{"path":"/reference/listDisclosureSettingsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"listDisclosureSettingsDS — listDisclosureSettingsDS","text":"Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/lmerSLMADS.assign.html","id":null,"dir":"Reference","previous_headings":"","what":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"lmerSLMADS.assign lmerSLMADS2 fits linear mixed effects model (lme) per study saves outcomes study","code":""},{"path":"/reference/lmerSLMADS.assign.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"","code":"lmerSLMADS.assign( formula, offset, weights, dataName, REML = TRUE, control_type, control_value.transmit, optimizer, verbose = 0 )"},{"path":"/reference/lmerSLMADS.assign.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"formula see help ds.lmerSLMA offset see help ds.lmerSLMA weights see help ds.lmerSLMA dataName see help ds.lmerSLMA REML see help ds.lmerSLMA control_type see help ds.lmerSLMA control_value.transmit see help argument function ds.lmerSLMA optimizer see help ds.lmerSLMA verbose see help ds.lmerSLMA","code":""},{"path":"/reference/lmerSLMADS.assign.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"writes lmerMod object summarising fitted model serverside. detailed information see help ds.lmerSLMA.","code":""},{"path":"/reference/lmerSLMADS.assign.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"lmerSLMADS.assign serverside function called ds.lmerSLMA clientside. analytic work engine lmer function R sits lme4 package. lmerSLMADS.assign fits linear mixed effects model (lme) including fixed random effects - data single data source saves regression outcomes serverside.","code":""},{"path":"/reference/lmerSLMADS.assign.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS.assign","text":"TDemetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/lmerSLMADS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"lmerSLMADS2 serverside function fits linear mixed effects model (lme) - .e. can include fixed random effects - data one multiple sources pooling via SLMA (study level meta-analysis)","code":""},{"path":"/reference/lmerSLMADS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"","code":"lmerSLMADS2( formula, offset, weights, dataName, REML = TRUE, control_type, control_value.transmit, optimizer, verbose = 0 )"},{"path":"/reference/lmerSLMADS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"formula see help ds.lmerSLMA offset see help ds.lmerSLMA weights see help ds.lmerSLMA dataName see help ds.lmerSLMA REML see help ds.lmerSLMA control_type see help ds.lmerSLMA control_value.transmit see help argument function ds.lmerSLMA optimizer see help ds.lmerSLMA verbose see help ds.lmerSLMA","code":""},{"path":"/reference/lmerSLMADS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"key model components see help ds.lmerSLMA","code":""},{"path":"/reference/lmerSLMADS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"lmerSLMADS2 serverside function called ds.lmerSLMA clientside. analytic work engine lmer function R sits lme4 package. ds.lmerSLMA fits linear mixed effects model (lme) - can include fixed random effects - data single multiple sources. multiple data sources, lme fitted convergence data source independently estimates standard errors returned client thereby enabling cross-study pooling using study level meta-analysis (SLMA). default SLMA undertaken using metafor package, SLMA occurs clientside , far user concerned just standard R environment, user can choose use approach meta-analysis choose. detailed help aspect lmerSLMDS2 please see extensive help ds.lmerSLMA. Additional information fitting lmes using lmer engine can obtained using R help lmer lme4 package","code":""},{"path":"/reference/lmerSLMADS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Fitting linear mixed effect models - serverside function — lmerSLMADS2","text":"Tom Bishop, additions Paul Burton","code":""},{"path":"/reference/lsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"lists all objects on a serverside environment — lsDS","title":"lists all objects on a serverside environment — lsDS","text":"creates list names objects specified serverside environment","code":""},{"path":"/reference/lsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"lists all objects on a serverside environment — lsDS","text":"","code":"lsDS(search.filter = NULL, env.to.search)"},{"path":"/reference/lsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"lists all objects on a serverside environment — lsDS","text":"search.filter either NULL character string (potentially including '*' wildcards) specifying required search criteria. argument fully specified corresponding argument clientside function. env..search integer (e.g. format '2' '5L' format) specifying position search path environment explored. argument fully specified corresponding argument clientside function.","code":""},{"path":"/reference/lsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"lists all objects on a serverside environment — lsDS","text":"list containing: (1) name/details serverside R environment ds.ls searched; (2) vector character strings giving names objects meeting naming criteria specified argument specified R serverside environment; (3) nature search filter string actually applied","code":""},{"path":"/reference/lsDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"lists all objects on a serverside environment — lsDS","text":"Serverside aggregate function lsDS called clientside function ds.ls. running analyses one may want know objects already generated. request disclosive returns names objects contents. default, objects current 'active analytic environment' (\".GlobalEnv\") displayed. environment contains objects serverside DataSHIELD using main analysis written serverside process managing undertaking analysis (variables, scalars, matrices, data.frames etc). details see help ds.ls function native R function ls","code":""},{"path":"/reference/lsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"lists all objects on a serverside environment — lsDS","text":"Gaye, (2015). Updated extended Paul Burton (2020).","code":""},{"path":"/reference/lsplineDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"function based native R function lspline lspline package. function computes basis piecewise-linear spline , depending argument marginal, coefficients can interpreted (1) slopes consecutive spline segments, (2) slope change consecutive knots.","code":""},{"path":"/reference/lsplineDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"","code":"lsplineDS(x = x, knots = NULL, marginal = FALSE, names = NULL)"},{"path":"/reference/lsplineDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"x name input numeric variable knots numeric vector knot positions marginal logical, parametrize spline, see Details names, character, vector names constructed variables","code":""},{"path":"/reference/lsplineDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"object class \"lspline\" \"matrix\", name specified newobj argument (default name \"lspline.newobj\"), assigned serverside.","code":""},{"path":"/reference/lsplineDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"marginal FALSE (default) coefficients spline correspond slopes consecutive segments. TRUE first coefficient correspond slope first segment. consecutive coefficients correspond change slope compared previous segment.","code":""},{"path":"/reference/lsplineDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Basis for a piecewise linear spline with meaningful coefficients — lsplineDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/matrixDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixDS assign function called by ds.matrix — matrixDS","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"Creates matrix serverside","code":""},{"path":"/reference/matrixDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"","code":"matrixDS(mdata.transmit, from, nrows.transmit, ncols.transmit, byrow, dimnames)"},{"path":"/reference/matrixDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"mdata.transmit specifies elements matrix created. Fully specified argument ds.matrix character string specifying source nature . Fully specified <> argument ds.matrix nrows.transmit specifies number rows matrix created. Fully specified argument ds.matrix ncols.transmit specifies number columns matrix created. Fully specified argument ds.matrix byrow logical value specifying whether, vector, matrix created filled row row column column. Fully specified argument ds.matrix dimnames dimnames attribute matrix: NULL list length 2 giving row column names respectively. empty list treated NULL, list length one row names . Fully specified argument ds.matrix","code":""},{"path":"/reference/matrixDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"Output matrix written serverside. details see help ds.matrix","code":""},{"path":"/reference/matrixDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"Similar matrix() function native R. Creates matrix dimensions specified arguments assigns values elements based argument","code":""},{"path":"/reference/matrixDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixDS assign function called by ds.matrix — matrixDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixDetDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"Calculates determinant square matrix returns output clientside","code":""},{"path":"/reference/matrixDetDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"","code":"matrixDetDS1(M1.name = NULL, logarithm)"},{"path":"/reference/matrixDetDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"M1.name character string specifying name matrix determinant calculated logarithm logical. Default FALSE, returns determinant , TRUE returns logarithm modulus determinant.","code":""},{"path":"/reference/matrixDetDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"Output determinant matrix identified argument returned clientside. details see help ds.matrixDet","code":""},{"path":"/reference/matrixDetDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"Calculates determinant square matrix (additional information see help det function native R). operation possible number columns rows .","code":""},{"path":"/reference/matrixDetDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixDetDS aggregate function called by ds.matrixDet.report — matrixDetDS1","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixDetDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"Calculates determinant square matrix writes output serverside","code":""},{"path":"/reference/matrixDetDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"","code":"matrixDetDS2(M1.name = NULL, logarithm)"},{"path":"/reference/matrixDetDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"M1.name character string specifying name matrix determinant calculated logarithm logical. Default FALSE, returns determinant , TRUE returns logarithm modulus determinant.","code":""},{"path":"/reference/matrixDetDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"Output determinant matrix identified argument written serverside. details see help ds.matrixDet","code":""},{"path":"/reference/matrixDetDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"Calculates determinant square matrix (additional information see help det function native R). operation possible number columns rows .","code":""},{"path":"/reference/matrixDetDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixDetDS assign function called by ds.matrixDet — matrixDetDS2","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixDiagDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"Extracts diagonal vector square matrix creates diagonal matrix based vector scalar value writes output serverside","code":""},{"path":"/reference/matrixDiagDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"","code":"matrixDiagDS(x1.transmit, aim, nrows.transmit)"},{"path":"/reference/matrixDiagDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"x1.transmit identifies input matrix vector. Fully specified argument ds.matrixDiag. details see help ds.matrixDiag. aim character string specifying behaviour required function. Fully specified argument ds.matrixDiag. details see help ds.matrixDiag. nrows.transmit scalar value forcing number rows columns output matrix.Fully specified argument ds.matrixDiag. details see help ds.matrixDiag.","code":""},{"path":"/reference/matrixDiagDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"Output matrix vector specified argument (default name diag_) written serverside. details see help ds.matrixDiag.","code":""},{"path":"/reference/matrixDiagDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"details see help function ds.matrixDiag.","code":""},{"path":"/reference/matrixDiagDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixDiagDS assign function called by ds.matrixDiag — matrixDiagDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixDimnamesDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"Adds dimnames (row names, column names ) matrix serverside.","code":""},{"path":"/reference/matrixDimnamesDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"","code":"matrixDimnamesDS(M1.name = NULL, dimnames)"},{"path":"/reference/matrixDimnamesDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"M1.name Specifies name serverside matrix dimnames added. Fully specified argument function ds.matrixDimnames. details see help ds.matrixDimnames. dimnames dimnames attribute matrix: NULL list length 2 giving row column names respectively. Fully specified argument function ds.matrixDimnames. details see help ds.matrixDimnames.","code":""},{"path":"/reference/matrixDimnamesDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"Output serverside matrix specified argument (default name diag_) specified dimnames (row column names) written serverside.","code":""},{"path":"/reference/matrixDimnamesDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"Adds dimnames (row names, column names ) matrix serverside. Similar dimnames function native R. details see help function ds.matrixDimnames","code":""},{"path":"/reference/matrixDimnamesDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixDimnamesDS assign function called by ds.matrixDimnames — matrixDimnamesDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixInvertDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"Inverts square matrix writes output serverside","code":""},{"path":"/reference/matrixInvertDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"","code":"matrixInvertDS(M1.name = NULL)"},{"path":"/reference/matrixInvertDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"M1.name character string specifying name matrix inverted","code":""},{"path":"/reference/matrixInvertDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"Output matrix representing inverse written serverside. details see help ds.matrixInvert","code":""},{"path":"/reference/matrixInvertDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"Undertakes standard matrix inversion. operation possible number columns rows matrix non-singular - positive definite (eg row column zeros)","code":""},{"path":"/reference/matrixInvertDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixInvertDS serverside assign function called by ds.matrixInvert — matrixInvertDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixMultDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"Calculates matrix product two matrices writes output serverside","code":""},{"path":"/reference/matrixMultDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"","code":"matrixMultDS(M1.name = NULL, M2.name = NULL)"},{"path":"/reference/matrixMultDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"M1.name character string specifying name first matrix (M1) argument specified M1 argument original call ds.matrixMult M2.name character string specifying name second matrix (M2) argument specified M1 argument original call ds.matrixMult","code":""},{"path":"/reference/matrixMultDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"Output matrix representing product M1 M2 written serverside. details see help ds.matrixMult","code":""},{"path":"/reference/matrixMultDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"Undertakes standard matrix multiplication input matrices B dimensions : mxn B: nxp output C dimensions mxp element C[,j] value equal dot product row column j B dot product obtained sum([,1]*B[1,j] + [,2]*B[2,j] + .... + [,n]*B[n,j]). calculation valid number columns number rows B","code":""},{"path":"/reference/matrixMultDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixMultDS serverside assign function called by ds.matrixMult — matrixMultDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/matrixTransposeDS.html","id":null,"dir":"Reference","previous_headings":"","what":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"Transposes matrix writes output serverside","code":""},{"path":"/reference/matrixTransposeDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"","code":"matrixTransposeDS(M1.name = NULL)"},{"path":"/reference/matrixTransposeDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"M1.name character string specifying name matrix transposed","code":""},{"path":"/reference/matrixTransposeDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"Output matrix representing transpose written serverside. details see help ds.matrixTranspose","code":""},{"path":"/reference/matrixTransposeDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"Undertakes standard matrix transposition. operation converts matrix matrix C element C[,j] matrix C equals element [j,] matrix . Matrix therefore number rows matrix C columns vice versa.","code":""},{"path":"/reference/matrixTransposeDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"matrixTransposeDS serverside assign function called by ds.matrixTranspose — matrixTransposeDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/mdPatternDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Missing data pattern with disclosure control — mdPatternDS","title":"Missing data pattern with disclosure control — mdPatternDS","text":"function serverside aggregate function computes missing data pattern using mice::md.pattern applies disclosure control prevent revealing small cell counts.","code":""},{"path":"/reference/mdPatternDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Missing data pattern with disclosure control — mdPatternDS","text":"","code":"mdPatternDS(x)"},{"path":"/reference/mdPatternDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Missing data pattern with disclosure control — mdPatternDS","text":"x character string specifying name data frame matrix containing data analyze missing patterns.","code":""},{"path":"/reference/mdPatternDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Missing data pattern with disclosure control — mdPatternDS","text":"list containing: pattern missing data pattern matrix disclosure control applied valid Logical indicating patterns meet disclosure requirements message message describing validity status","code":""},{"path":"/reference/mdPatternDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Missing data pattern with disclosure control — mdPatternDS","text":"function calls mice::md.pattern function generate matrix showing missing data patterns input data. ensure disclosure control, pattern counts threshold (nfilter.tab, default=3) suppressed. Suppression Method: pattern count threshold: - Row name changed \"suppressed()\" N threshold - pattern values row set NA - Summary row also set NA (prevents back-calculation) Output Matrix Structure: - Rows represent different missing data patterns (plus summary row bottom) - Row names contain pattern counts (\"suppressed()\" invalid patterns) - Columns show 1 variable observed, 0 missing - Last column shows total number missing values per pattern - Last row shows total number missing values per variable Note Pooling: function called ds.mdPattern type='combine', suppressed patterns excluded pooling prevent disclosure subtraction. means pooled counts may underestimate true total patterns suppressed studies.","code":""},{"path":"/reference/mdPatternDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Missing data pattern with disclosure control — mdPatternDS","text":"Xavier Escribà montagut DataSHIELD Development Team","code":""},{"path":"/reference/meanDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes statistical mean of a vector — meanDS","title":"Computes statistical mean of a vector — meanDS","text":"Calculates mean value.","code":""},{"path":"/reference/meanDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes statistical mean of a vector — meanDS","text":"","code":"meanDS(xvect)"},{"path":"/reference/meanDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes statistical mean of a vector — meanDS","text":"xvect vector","code":""},{"path":"/reference/meanDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes statistical mean of a vector — meanDS","text":"numeric, statistical mean","code":""},{"path":"/reference/meanDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes statistical mean of a vector — meanDS","text":"length input vector less set filter missing value returned.","code":""},{"path":"/reference/meanDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes statistical mean of a vector — meanDS","text":"Gaye , Burton PR","code":""},{"path":"/reference/meanSdGpDS.html","id":null,"dir":"Reference","previous_headings":"","what":"MeanSdGpDS — meanSdGpDS","title":"MeanSdGpDS — meanSdGpDS","text":"Server-side function called ds.meanSdGp","code":""},{"path":"/reference/meanSdGpDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"MeanSdGpDS — meanSdGpDS","text":"","code":"meanSdGpDS(X, INDEX)"},{"path":"/reference/meanSdGpDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"MeanSdGpDS — meanSdGpDS","text":"X client-side supplied character string identifying variable means/SDs calculated INDEX client-side supplied character string identifying factor across means/SDs calculated","code":""},{"path":"/reference/meanSdGpDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"MeanSdGpDS — meanSdGpDS","text":"List results group statistics","code":""},{"path":"/reference/meanSdGpDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"MeanSdGpDS — meanSdGpDS","text":"Computes mean standard deviation across groups defined one factor","code":""},{"path":"/reference/meanSdGpDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"MeanSdGpDS — meanSdGpDS","text":"Burton PR","code":""},{"path":"/reference/mergeDS.html","id":null,"dir":"Reference","previous_headings":"","what":"mergeDS (assign function) called by ds.merge — mergeDS","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"merges (links) two data.frames together based common values defined vectors data.frame","code":""},{"path":"/reference/mergeDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"","code":"mergeDS( x.name, y.name, by.x.names.transmit, by.y.names.transmit, all.x, all.y, sort, suffixes.transmit, no.dups, incomparables )"},{"path":"/reference/mergeDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"x.name, name first data.frame merged specified inverted commas. Specified via argument ds.merge function y.name, name second data.frame merged specified inverted commas. Specified via argument ds.merge function .x.names.transmit name single variable vector names multiple variables (transmittable form) containing IDs data data.frame x merged/linked data.frame y. Specified via argument <.x.names> ds.merge function .y.names.transmit name single variable vector names multiple variables (transmittable form) containing IDs data data.frame y merged/linked data.frame x. Specified via argument <.y.names> ds.merge function .x logical, TRUE, extra rows added output, one row x matching row y. Specified via argument <.x> ds.merge function. Default = FALSE. .y logical, TRUE, extra rows added output, one row y matching row x. Specified via argument <.y> ds.merge function. Default = FALSE. sort logical, TRUE merged result sorted elements .x.names .y.names columns. Specified via argument ds.merge function. Default = TRUE. suffixes.transmit character vector length 2 (transmittable form) specifying suffixes used making unique common column names two input data.frames appear merged data.frame. Specified via argument ds.merge function. Default '.x' '.y'. .dups logical, TRUE suffixes appended cases rigorously avoid duplicated column names merged data.frame. Specified via argument <.dups> ds.merge function. Default TRUE apparently implicitly FALSE R version 3.5.0. incomparables, values intended merging one column matched. See 'match' help Native R merge function. Specified via argument ds.merge","code":""},{"path":"/reference/mergeDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"merged data.frame specified argument ds.merge (default 'x.name_y.name' argument NULL) written serverside. addition, two validity messages returned clientside indicating whether created data source whether valid form. form valid least one study may studysideMessage can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message() print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message() return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/mergeDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"information see details native R function merge DataSHIELD clientside function ds.merge.","code":""},{"path":"/reference/mergeDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"mergeDS (assign function) called by ds.merge — mergeDS","text":"Paul Burton, Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/messageDS.html","id":null,"dir":"Reference","previous_headings":"","what":"messageDS — messageDS","title":"messageDS — messageDS","text":"function allows error messages arising running server-side assign function returned client-side","code":""},{"path":"/reference/messageDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"messageDS — messageDS","text":"","code":"messageDS(message.object.name)"},{"path":"/reference/messageDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"messageDS — messageDS","text":"message.object.name character string, containing name list containing message. See header client-side function ds.message details.","code":""},{"path":"/reference/messageDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"messageDS — messageDS","text":"list object study, containing whatever message written DataSHIELD $studysideMessage.","code":""},{"path":"/reference/messageDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"messageDS — messageDS","text":"Errors arising aggregate server-side functions can returned directly client-side. possible server-side assign functions designed specifically write objects server-side return meaningful information client-side. Otherwise, users may able use assign functions return disclosive output client-side. ds.message calls messageDS looks specifically object called $serversideMessage designated list server-side. Server-side functions error messages made available, designed able write designated error message $serversideMessage object list saved server-side primary output function. valid server-side functions DataSHIELD can write $studysideMessage, additional protection unexpected ways someone may try get round limitation, $studysideMessage string exceed length nfilter.string default 80 characters.","code":""},{"path":"/reference/messageDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"messageDS — messageDS","text":"Burton PR","code":""},{"path":"/reference/metadataDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Returns the metadata, if any, about the specified variable — metadataDS","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"function returns metadata, , specified variable.","code":""},{"path":"/reference/metadataDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"","code":"metadataDS(x)"},{"path":"/reference/metadataDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"x string character, containing name specified variable","code":""},{"path":"/reference/metadataDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"list containing metadata. elements list depend metadata available.","code":""},{"path":"/reference/metadataDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"function returns metadata, obtained attributes function.","code":""},{"path":"/reference/metadataDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Returns the metadata, if any, about the specified variable — metadataDS","text":"Stuart Wheater, DataSHIELD Development Team","code":""},{"path":"/reference/miceDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Aggregate function called by ds.mice — miceDS","title":"Aggregate function called by ds.mice — miceDS","text":"function wrapper function mice mice R package. function creates multiple imputations (replacement values) multivariate missing data. method based Fully Conditional Specification, incomplete variable imputed separate model. MICE algorithm can impute mixes continuous, binary, unordered categorical ordered categorical data. addition, MICE can impute continuous two-level data, maintain consistency imputations means passive imputation.","code":""},{"path":"/reference/miceDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Aggregate function called by ds.mice — miceDS","text":"","code":"miceDS( data = data, m = m, maxit = maxit, method = method, post = post, seed = seed, predictorMatrix = predictorMatrix, ncol.pred.mat = ncol.pred.mat, newobj_mids = newobj_mids, newobj_df = newobj_df )"},{"path":"/reference/miceDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Aggregate function called by ds.mice — miceDS","text":"data data frame matrix containing incomplete data. m Number multiple imputations. default m=5. maximum allowed number DataSHIELD m=20. maxit scalar giving number iterations. default 5. maximum allowed number DataSHIELD maxit=30. method Can either single string, vector strings length ncol(data), specifying imputation method used column data. specified single string, method used blocks. default imputation method (argument specified) depends measurement level target column, regulated defaultMethod argument native R mice function. Columns need imputed empty method \"\". post vector strings length ncol(data) specifying expressions strings. string parsed executed within sampler() function post-process imputed values iterations. default vector empty strings, indicating post-processing. Multivariate (block) imputation methods ignore post parameter. seed either NA (default) \"fixed\". seed set \"fixed\" fixed seed random number generator study-specific used. predictorMatrix numeric matrix ncol(data) rows ncol(data) columns, containing 0/1 data specifying set predictors used target column. row corresponds variable imputed. value 1 means column variable used predictor target variables (rows). default, predictorMatrix square matrix ncol(data) rows columns 1's, except diagonal. ncol.pred.mat number columns predictorMatrix. newobj_mids character string provides name output mids object stored data servers. Default mids_object. newobj_df character string provides name output dataframes stored data servers. Default imputationSet. example, m=5, newobj_df=\"imputationSet\", five imputed dataframes saved servers names imputationSet.1, imputationSet.2, imputationSet.3, imputationSet.4, imputationSet.5.","code":""},{"path":"/reference/miceDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Aggregate function called by ds.mice — miceDS","text":"list three elements: method, predictorMatrix post. function also saves server mids object completed datasets dataframes.","code":""},{"path":"/reference/miceDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Aggregate function called by ds.mice — miceDS","text":"additional details see help header mice function native R mice package.","code":""},{"path":"/reference/miceDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Aggregate function called by ds.mice — miceDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/minMaxRandDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"Creates minimum value negative, less positive real value V2BR maximum value positive less negative value V2BR.","code":""},{"path":"/reference/minMaxRandDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"minMaxRandDS(input.var.name)"},{"path":"/reference/minMaxRandDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"input.var.name character string specifying name V2BR. argument set argument name clientside function ds.ranksSecure","code":""},{"path":"/reference/minMaxRandDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"data frame objects containing global ranks quantiles. details see associated document entitled \"secure.global.ranking.docx\"","code":""},{"path":"/reference/minMaxRandDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside aggregate function called ds.ranksSecure. minimum maximum values creates used replace missing values (NAs) V2BR argument e set \"NA.low\" \"NA.hi\" respectively. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/minMaxRandDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/namesDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Return the names of a list object — namesDS","title":"Return the names of a list object — namesDS","text":"Returns names designated server-side list","code":""},{"path":"/reference/namesDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return the names of a list object — namesDS","text":"","code":"namesDS(xname.transmit)"},{"path":"/reference/namesDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Return the names of a list object — namesDS","text":"xname.transmit character string specifying name list.","code":""},{"path":"/reference/namesDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return the names of a list object — namesDS","text":"namesDS returns client-side names list object stored server-side.","code":""},{"path":"/reference/namesDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Return the names of a list object — namesDS","text":"namesDS aggregate function called ds.names. function similar native R function names subsume functionality, example, works extract names already exist, create new names objects. function restricted objects type list, includes objects primary class list return TRUE native R function .list. example, includes multi-component object created fitting generalized linear model using ds.glmSLMA. resultant object saved separate server formally double class \"glm\" \"ls\" responds TRUE .list(),","code":""},{"path":"/reference/namesDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Return the names of a list object — namesDS","text":"Amadou Gaye, updated Paul Burton 25/06/2020","code":""},{"path":"/reference/nsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"function based native R function ns splines package. function generate B-spline basis matrix natural cubic spline.","code":""},{"path":"/reference/nsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"","code":"nsDS(x, df, knots, intercept, Boundary.knots)"},{"path":"/reference/nsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"x predictor variable. Missing values allowed. df degrees freedom. One can supply df rather knots; ns() chooses df - 1 - intercept knots suitably chosen quantiles x (ignore missing values). default, df = NULL, sets number inner knots length(knots). knots breakpoints define spline. default knots; together natural boundary conditions results basis linear regression x. Typical values mean median one knot, quantiles knots. See also Boundary.knots. intercept TRUE, intercept included basis; default FALSE. Boundary.knots boundary points impose natural boundary conditions anchor B-spline basis (default range data). knots Boundary.knots supplied, basis parameters depend x. Data can extend beyond Boundary.knots","code":""},{"path":"/reference/nsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"matrix dimension length(x) * df either df supplied knots supplied, df = length(knots) + 1 + intercept. Attributes returned correspond arguments ns, explicitly give knots, Boundary.knots etc use predict.ns(). object assigned serverside.","code":""},{"path":"/reference/nsDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"ns native R based function splineDesign. generates basis matrix representing family piecewise-cubic splines specified sequence interior knots, natural boundary conditions. enforce constraint function linear beyond boundary knots, can either supplied default extremes data. primary use modeling formula directly specify natural spline term model.","code":""},{"path":"/reference/nsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generate a Basis Matrix for Natural Cubic Splines — nsDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/numNaDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Counts the number of missing values — numNaDS","title":"Counts the number of missing values — numNaDS","text":"function just counts number missing entries vector.","code":""},{"path":"/reference/numNaDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Counts the number of missing values — numNaDS","text":"","code":"numNaDS(xvect)"},{"path":"/reference/numNaDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Counts the number of missing values — numNaDS","text":"xvect vector","code":""},{"path":"/reference/numNaDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Counts the number of missing values — numNaDS","text":"integer, number missing values","code":""},{"path":"/reference/numNaDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Counts the number of missing values — numNaDS","text":"Gaye, .","code":""},{"path":"/reference/qlsplineDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"function based native R function qlspline lspline package. function computes basis piecewise-linear spline , depending argument marginal, coefficients can interpreted (1) slopes consecutive spline segments, (2) slope change consecutive knots.","code":""},{"path":"/reference/qlsplineDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"","code":"qlsplineDS(x = x, q = q, na.rm = TRUE, marginal = FALSE, names = NULL)"},{"path":"/reference/qlsplineDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"x name input numeric variable q numeric, single scalar greater equal 2 number equal-frequency intervals along x vector numbers (0; 1) specifying quantiles explicitly. na.rm logical, whether NA removed calculating quantiles, passed na.rm quantile. Default set TRUE. marginal logical, parametrize spline, see Details names character, vector names constructed variables","code":""},{"path":"/reference/qlsplineDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"object class \"lspline\" \"matrix\", name specified newobj argument (default name \"qlspline.newobj\"), assigned serverside.","code":""},{"path":"/reference/qlsplineDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"marginal FALSE (default) coefficients spline correspond slopes consecutive segments. TRUE first coefficient correspond slope first segment. consecutive coefficients correspond change slope compared previous segment. Function qlspline wraps lspline calculates knot positions quantiles x. q numerical scalar greater equal 2, quantiles computed seq(0, 1, length.= q + 1)[-c(1, q+1)], .e. knots q-tiles distribution x. Alternatively, q can vector values [0; 1] specifying quantile probabilities directly (vector passed argument probs quantile).","code":""},{"path":"/reference/qlsplineDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Basis for a piecewise linear spline with meaningful coefficients — qlsplineDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/quantileMeanDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","title":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","text":"probabilities 5 used compute corresponding quantiles.","code":""},{"path":"/reference/quantileMeanDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","text":"","code":"quantileMeanDS(xvect)"},{"path":"/reference/quantileMeanDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","text":"xvect numerical vector","code":""},{"path":"/reference/quantileMeanDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","text":"numeric vector represents sample quantiles","code":""},{"path":"/reference/quantileMeanDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generates quantiles and mean information without maximum and minimum — quantileMeanDS","text":"Burton, P.; Gaye, .","code":""},{"path":"/reference/rBinomDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rBinomDS serverside assign function — rBinomDS","title":"rBinomDS serverside assign function — rBinomDS","text":"primary serverside assign function called ds.rBinom","code":""},{"path":"/reference/rBinomDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rBinomDS serverside assign function — rBinomDS","text":"","code":"rBinomDS(n, size = 1, prob = 0.5)"},{"path":"/reference/rBinomDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rBinomDS serverside assign function — rBinomDS","text":"n length pseudorandom number vector generated specified argument function ds.rBinom size scalar must positive integer. Value set directly argument ds.rBinom - details see help ds.rBinom. May scalar vector allowing size vary observation observation. prob numeric scalar range 0 > prob > 1 specifies probability positive response. Value set directly argument ds.rBinom - details see help ds.rBinom May scalar vector allowing size vary observation observation.","code":""},{"path":"/reference/rBinomDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rBinomDS serverside assign function — rBinomDS","text":"Writes pseudorandom number vector characteristics specified function call new serverside vector data source called. Also returns key information clientside: random seed specified source + (requested) full 626 length random seed vector generated source (see info argument ). also returns vector reporting length pseudorandom vector created source.","code":""},{"path":"/reference/rBinomDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rBinomDS serverside assign function — rBinomDS","text":"Generates vector pseudorandom numbers binomial distribution data source specified arguments ds.rBinom. serverside function effectively function rbinom() native R arguments .","code":""},{"path":"/reference/rBinomDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rBinomDS serverside assign function — rBinomDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/rNormDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rNormDS serverside assign function — rNormDS","title":"rNormDS serverside assign function — rNormDS","text":"primary serverside assign function called ds.rNorm","code":""},{"path":"/reference/rNormDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rNormDS serverside assign function — rNormDS","text":"","code":"rNormDS(n, mean = 0, sd = 1, force.output.to.k.decimal.places = 9)"},{"path":"/reference/rNormDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rNormDS serverside assign function — rNormDS","text":"n length pseudorandom number vector generated specified argument function ds.rNorm mean specifies mean pseudorandom number vector generated specified argument function ds.rNorm. May scalar vector allowing mean vary observation observation. sd specifies standard deviation pseudorandom number vector generated specified argument function ds.rNorm May scalar vector allowing sd vary observation observation. force.output..k.decimal.places scalar integer. Forces output random number vector k decimal places. 0 rounds coerces decimal random number output integer, k range 1-8 forces output k decimal places. k = 9, rounding occurs native output. Default=9. Value specified argument ds.rNorm","code":""},{"path":"/reference/rNormDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rNormDS serverside assign function — rNormDS","text":"Writes pseudorandom number vector characteristics specified function call new serverside vector data source called. Also returns key information clientside: random seed specified source + (requested) full 626 length random seed vector generated source (see info argument ). also returns vector reporting length pseudorandom vector created source.","code":""},{"path":"/reference/rNormDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rNormDS serverside assign function — rNormDS","text":"Generates vector pseudorandom numbers normal distribution data source specified arguments ds.rNorm. serverside function effectively function rnorm() native R arguments .","code":""},{"path":"/reference/rNormDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rNormDS serverside assign function — rNormDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/rPoisDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rPoisDS serverside assign function — rPoisDS","title":"rPoisDS serverside assign function — rPoisDS","text":"primary serverside assign function called ds.rPois","code":""},{"path":"/reference/rPoisDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rPoisDS serverside assign function — rPoisDS","text":"","code":"rPoisDS(n, lambda = 1)"},{"path":"/reference/rPoisDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rPoisDS serverside assign function — rPoisDS","text":"n length pseudorandom number vector generated specified argument function ds.rPois lambda numeric scalar specifying expected count Poisson distribution used generate random counts. Specified directly lambda argument ds.rPois. May scalar vector allowing lambda vary observation observation.","code":""},{"path":"/reference/rPoisDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rPoisDS serverside assign function — rPoisDS","text":"Writes pseudorandom number vector characteristics specified function call new serverside vector data source called. Also returns key information clientside: random seed specified source + (requested) full 626 length random seed vector generated source (see info argument ). also returns vector reporting length pseudorandom vector created source.","code":""},{"path":"/reference/rPoisDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rPoisDS serverside assign function — rPoisDS","text":"Generates vector pseudorandom numbers (non-negative integers) Poisson distribution data source specified arguments ds.rPois. serverside function effectively function rpois() native R arguments .","code":""},{"path":"/reference/rPoisDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rPoisDS serverside assign function — rPoisDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/rUnifDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rUnifDS serverside assign function — rUnifDS","title":"rUnifDS serverside assign function — rUnifDS","text":"primary serverside assign function called ds.rUnif","code":""},{"path":"/reference/rUnifDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rUnifDS serverside assign function — rUnifDS","text":"","code":"rUnifDS(n, min = 0, max = 1, force.output.to.k.decimal.places = 9)"},{"path":"/reference/rUnifDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rUnifDS serverside assign function — rUnifDS","text":"n length pseudorandom number vector generated specified argument function ds.rUnif min numeric scalar specifying minimum range across random numbers generated source. Specified directly min argument ds.rUnif. May scalar vector allowing min vary observation observation. max numeric scalar specifying maximum range across random numbers generated source. Specified directly max argument ds.rUnif. May scalar vector allowing min vary observation observation. force.output..k.decimal.places scalar integer. Forces output random number vector k decimal places. 0 rounds coerces decimal random number output integer, k range 1-8 forces output k decimal places. k = 9, rounding occurs native output. Default=9. Value specified argument ds.rUnif","code":""},{"path":"/reference/rUnifDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rUnifDS serverside assign function — rUnifDS","text":"Writes pseudorandom number vector characteristics specified function call new serverside vector data source called. Also returns key information clientside: random seed specified source + (requested) full 626 length random seed vector generated source (see info argument ). also returns vector reporting length pseudorandom vector created source.","code":""},{"path":"/reference/rUnifDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rUnifDS serverside assign function — rUnifDS","text":"Generates vector pseudorandom numbers uniform distribution data source specified arguments ds.rUnif. serverside function effectively function runif() native R arguments .","code":""},{"path":"/reference/rUnifDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rUnifDS serverside assign function — rUnifDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/rangeDS.html","id":null,"dir":"Reference","previous_headings":"","what":"returns the minimum and maximum of a numeric vector — rangeDS","title":"returns the minimum and maximum of a numeric vector — rangeDS","text":"function similar R function range instead return real minimum maximum, computed values multiplied small random number.","code":""},{"path":"/reference/rangeDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"returns the minimum and maximum of a numeric vector — rangeDS","text":"","code":"rangeDS(xvect)"},{"path":"/reference/rangeDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"returns the minimum and maximum of a numeric vector — rangeDS","text":"xvect numerical","code":""},{"path":"/reference/rangeDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"returns the minimum and maximum of a numeric vector — rangeDS","text":"numeric vector contains minimum maximum values vector","code":""},{"path":"/reference/rangeDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"returns the minimum and maximum of a numeric vector — rangeDS","text":"Amadou Gaye, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/ranksSecureDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"takes key non-disclosive components serverside data frame blackbox.output.df clientside enable global ranking.","code":""},{"path":"/reference/ranksSecureDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"ranksSecureDS1()"},{"path":"/reference/ranksSecureDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"non-disclosive elements blackbox.output.df (see details) serverside data frame object (called blackbox.output) clientside. processing create global ranks across studies, returned serverside data frame sR4.df using clientside function ds.dmtC2S","code":""},{"path":"/reference/ranksSecureDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside aggregate function called ds.ranksSecure. non-disclosive components blackbox.output.df transmitted clientside : (1) final values \"combined real+pseudo data vector\" seven rounds encryption completed; (2) set sequential IDs allocated sorting \"combined real+pseudo data vector\" value (ascending order). allows later re-linkage values back serverside confirmation linkage correct. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/ranksSecureDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/ranksSecureDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"Checks data frame produced creating initial global ranks (ranks based real pseudo-data running blackBoxDS)correct dimensions order serverside data frames now appended. either number rows order rows inconsistent pre-existing data frames serverside error message returned processing stops. strips pseudo-data leaving solely global ranks based just real data","code":""},{"path":"/reference/ranksSecureDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"ranksSecureDS2()"},{"path":"/reference/ranksSecureDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"creates new data frame sR5.df serverside containing solely real data including key elements needed next stage ranking process. crucially include \"global.rank\" \"ID..val\" sorted ascending order magnitude V2BR","code":""},{"path":"/reference/ranksSecureDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside assign function called ds.ranksSecure. works output created serverside function ranksSecureDS1 saved serverside data frame sR4.df ds.dmtC2S. checked QA strips rows corresponding pseudo-data. resultant data frame contains following vectors: (1) fully encrypted V2BR (application blackBoxDS);(2) \"ID..val\" sequential ID associated \"combined real+pseudo data vector\" sorted value (ascending); (3) \"studyid\", vector consisting solely value n nth study; (4) \"global.rank\" vector containing global ranks created clientside code ds.ranksSecure ranksSecureDS1 called point ds.dmtC2S sends sR4.df serverside. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/ranksSecureDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/ranksSecureDS3.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"takes key non-disclosive components serverside data frame blackbox.ranks.df clientside enable global re-ranking global ranks just applying real data (pseudo-data).","code":""},{"path":"/reference/ranksSecureDS3.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"ranksSecureDS3()"},{"path":"/reference/ranksSecureDS3.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"non-disclosive elements blackbox.output.df (see details) serverside data frame object (called sR6.df) clientside. processing within ds.ranksSecure create global ranks global quantiles (real data ) across studies, returned serverside data frame \"global.ranks.quantiles.df\" using clientside function ds.dmtC2S. illustrate difference ranks quantiles, total 1000 original real observations across studies one particular observation rank 250, quantile value 0.25 (.e. 25 increasing value). ranks quantiles can ties. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/ranksSecureDS3.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside aggregate function called ds.ranksSecure. non-disclosive components blackbox.ranks.df transmitted clientside : (1) final values encrypted global ranks vector seven rounds encryption completed; (2) set sequential IDs allocated global ranks vector study current order based increasing value V2BR. allows later re-linkage values back serverside confirmation linkage correct. (3) studyid vector values n nth study. facilitates data management serverside global ranking global ranks. details cluster functions collectively enable secure global ranking estimation global quantiles see associated document entitled \"secure.global.ranking.docx\". Also see header file ds.ranksSecure","code":""},{"path":"/reference/ranksSecureDS3.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/ranksSecureDS4.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"Creates data frame \"sR8.df\" cbinding data frame \"blackBox.ranks.df\" global ranks global quantiles vectors \"global.ranks.quantiles.df\". Performs QA matrix orders sR8.df data frame according argument ds.ranksSecure","code":""},{"path":"/reference/ranksSecureDS4.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"ranksSecureDS4(ranks.sort.by)"},{"path":"/reference/ranksSecureDS4.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"ranks.sort.character string taking two possible values. \"ID.orig\" \"vals.orig\". define order output.ranks.df summary.output.ranks.df data frames presented. argument set argument name ds.ranksSecure. Default value \"ID.orig\".","code":""},{"path":"/reference/ranksSecureDS4.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"Creates data frame identified name given argument () ds.ranksSecure function writes serverside. argument NULL unspecified output data frame called \"main.ranks.df\". data frame ordered according argument ds.ranksSecure.","code":""},{"path":"/reference/ranksSecureDS4.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Severside assign function called ds.ranksSecure. Creates data frame \"sR8.df\" cbinding data frame \"blackBox.ranks.df\" global ranks global quantiles vectors \"global.ranks.quantiles.df\". Checks components sR8.df correct dimensions consistent ordering. either number rows order rows inconsistent \"blackBox.ranks.df\" error message returned processing stops. sR8.df passes QA tests written serverside data frame name identified argument ds.ranksSecure. argument NULL unspecified data frame called \"main.ranks.df\". ranksSecureDS4 function also orders combined data frame () one two ways: argument ds.ranksSecure set \"ID.orig\" combined data frame ordered way original V2BR vector; argument set vals.orig\" combined data frame ordered magnitude values V2BR (ascending). created data frame () manner can now directly cbinded either V2BR vector data frame, tibble matrix containing V2BR (assuming also order corresponding argument ) combined object can used basis analysis based global ranks quantiles including range types non-parametric analysis.","code":""},{"path":"/reference/ranksSecureDS4.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/ranksSecureDS5.html","id":null,"dir":"Reference","previous_headings":"","what":"Secure ranking of ","title":"Secure ranking of ","text":"Summarises serverside data frame written ranksSecureDS4 identified name given argument () ds.ranksSecure function produce new output data frame containing 5 key variables.","code":""},{"path":"/reference/ranksSecureDS5.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Secure ranking of ","text":"","code":"ranksSecureDS5(output.ranks.df)"},{"path":"/reference/ranksSecureDS5.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Secure ranking of ","text":"output.ranks.df character string specifies optional name data.frame written serverside data source contains 11 key output variables ranking procedure pertaining particular data source. argument set argument name ds.ranksSecure.","code":""},{"path":"/reference/ranksSecureDS5.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Secure ranking of ","text":"extracts 5 key vectors larger data frame created ranksSecureDS4 produce summary data frame written serverside. given name specified argument.","code":""},{"path":"/reference/ranksSecureDS5.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Secure ranking of ","text":"Serverside assign function called clientside function ds.ranksSecure. Takes serverside data frame written ranksSecureDS4 identified name given argument () ds.ranksSecure function. holds 11 vectors including final global ranks across studies final global quantiles. data frame ordered according argument ds.ranksSecure. ranksSecureDS5 function extracts 5 key vectors larger data frame produce summary data frame given name specified argument () ds.ranksSecure function. data frame includes following components: (1) values sequential ID variable (ID.seq.real.orig) created lie alongside original V2BR vector order vector ordered. ID values therefore reflect row original data corresponds given row output. argument ds.ranksSecure set \"ID.orig\" values ID.seq.real.orig vector output data frame simply run sequentially 1 N N number individuals corresponding study. set \"vals.orig\" values ID.seq.real.orig vector determined magnitude corresponding V2BR value appear ordered haphazard manner; (2) original values V2BR; (3) global ranks corresponding original values V2BR, ties reflected appropriately; (4) global quantiles corresponding original values V2BR, ties reflected appropriately; (5) studyid vector elements take value n nth study.","code":""},{"path":"/reference/ranksSecureDS5.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Secure ranking of ","text":"Paul Burton 9th November, 2021","code":""},{"path":"/reference/rbindDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rbindDS called by ds.rbind — rbindDS","title":"rbindDS called by ds.rbind — rbindDS","text":"serverside assign function takes sequence vector, matrix data-frame arguments combines row produce matrix.","code":""},{"path":"/reference/rbindDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rbindDS called by ds.rbind — rbindDS","text":"","code":"rbindDS(x.names.transmit = NULL, colnames.transmit = NULL)"},{"path":"/reference/rbindDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rbindDS called by ds.rbind — rbindDS","text":"x.names.transmit vector character strings representing names elemental components combined converted transmittable format. argument fully specified argument ds.rbind colnames.transmit NULL vector character strings representing forced column names output object converted transmittable format. argument fully specified argument ds.cbind.","code":""},{"path":"/reference/rbindDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rbindDS called by ds.rbind — rbindDS","text":"object specified argument ds.rbind(default name ) written serverside. well writing output object serverside, two validity messages returned indicating whether created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - ds.cbind() also returns studysideMessages can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"\") print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message(\"\") return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/rbindDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rbindDS called by ds.rbind — rbindDS","text":"sequence vector, matrix data-frame arguments combined row row produce matrix written serverside. details see help ds.rbind native R function rbind.","code":""},{"path":"/reference/rbindDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rbindDS called by ds.rbind — rbindDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/reShapeDS.html","id":null,"dir":"Reference","previous_headings":"","what":"reShapeDS (assign function) called by ds.reShape — reShapeDS","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"Reshapes data frame containing longitudinal otherwise grouped data 'wide' 'long' format vice-versa","code":""},{"path":"/reference/reShapeDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"","code":"reShapeDS( data.name, varying.transmit, v.names.transmit, timevar.name, idvar.name, drop.transmit, direction, sep )"},{"path":"/reference/reShapeDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"data.name, name data.frame reshaped. Specified via argument ds.reShape function varying.transmit, names sets variables wide format correspond single variables long format (typically may called 'time-varying' 'time-dependent' variables). Specified via argument ds.reShape function. v.names.transmit, names variables long format correspond multiple variables wide format - example, sbp7, sbp11, sbp15 (measured systolic blood pressure ages 7, 11 15 years). Specified via argument ds.reShape function timevar.name, variable long format differentiates multiple records group individual. Specified via argument ds.reShape function idvar.name, names one variables long format identify multiple records group/individual. /variable(s) may also present wide format. Specified via argument ds.reShape function drop.transmit, vector names variables drop reshaping. Specified via argument ds.reShape function direction, character string, partially matched either \"wide\" reshape long wide format, \"long\" reshape wide long format. Specified via argument ds.reShape function sep, character vector length 1, indicating separating character variable names wide format. Specified via argument ds.reShape function","code":""},{"path":"/reference/reShapeDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"reshaped data.frame converted long wide format wide long format written serverside given name provided argument ds.reShape 'newObject' name specified. addition, two validity messages returned clientside indicating whether created data source whether valid form (see header ds.reShape.","code":""},{"path":"/reference/reShapeDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"function based native R function reshape. reshapes data frame containing longitudinal otherwise grouped data 'wide' format repeated measurements separate columns record 'long' format repeated measurements separate records. reshaping can either direction","code":""},{"path":"/reference/reShapeDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"reShapeDS (assign function) called by ds.reShape — reShapeDS","text":"Demetris Avraam, Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/recodeLevelsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Recodes the levels of a categorical variables — recodeLevelsDS","title":"Recodes the levels of a categorical variables — recodeLevelsDS","text":"functions uses input factor generates new factor new levels.","code":""},{"path":"/reference/recodeLevelsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Recodes the levels of a categorical variables — recodeLevelsDS","text":"","code":"recodeLevelsDS(x = NULL, classes = NULL)"},{"path":"/reference/recodeLevelsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Recodes the levels of a categorical variables — recodeLevelsDS","text":"x factor vector classes character vector levels newt factor vector","code":""},{"path":"/reference/recodeLevelsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Recodes the levels of a categorical variables — recodeLevelsDS","text":"factor vector new levels","code":""},{"path":"/reference/recodeLevelsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Recodes the levels of a categorical variables — recodeLevelsDS","text":"Gaye, .","code":""},{"path":"/reference/recodeValuesDS.html","id":null,"dir":"Reference","previous_headings":"","what":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"function recodes specified values elements vector matched set alternative specified values.","code":""},{"path":"/reference/recodeValuesDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"","code":"recodeValuesDS( var.name.text = NULL, values2replace.text = NULL, new.values.text = NULL, missing = NULL )"},{"path":"/reference/recodeValuesDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"var.name.text character string providing name vector representing variable recoded. argument generated passed directly recodeValuesDS ds.recodeValues values2replace.text character string specifying values vector specified argument replaced new values specified new.values.vector. argument generated passed directly recodeValuesDS ds.recodeValues. effect, argument ds.recodeValues function converted character string format acceptable DataSHIELD R parser data repository can accepted recodeValuesDS new.values.text character string specifying new values specified values vector converted. argument generated passed directly recodeValuesDS ds.recodeValues. effect, argument ds.recodeValues function converted character string format acceptable DataSHIELD R parser data repository can used call recodeValuesDS. missing supplied, missing values variable referred var.name.text replaced value.","code":""},{"path":"/reference/recodeValuesDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"object specified argument (default name '_recoded') initially specified calling ds.recodeValues. output object (required recoded variable called written serverside.","code":""},{"path":"/reference/recodeValuesDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"details see help header ds.recodeValues","code":""},{"path":"/reference/recodeValuesDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"recodeValuesDS an assign function called by ds.recodeValues — recodeValuesDS","text":"Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/repDS.html","id":null,"dir":"Reference","previous_headings":"","what":"repDS called by ds.rep — repDS","title":"repDS called by ds.rep — repDS","text":"assign function creates repetitive sequence repeating identified scalar, specified elements vector list. analogous rep function native R. sequence written new object serverside","code":""},{"path":"/reference/repDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"repDS called by ds.rep — repDS","text":"","code":"repDS( x1.transmit, times.transmit, length.out.transmit, each.transmit, x1.includes.characters, source.x1, source.times, source.length.out, source.each )"},{"path":"/reference/repDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"repDS called by ds.rep — repDS","text":"x1.transmit argument determines input scalar, vector list. behaviour see help ds.rep \"details native R help \" (see ). parameter usually fully defined argument call ds.rep calls repDS. times.transmit argument determines number replications pattern replications input scalar/vector construct output repetitive sequence. behaviour see help ds.rep \"details native R help \" (see ). parameter usually fully defined argument call ds.rep calls repDS. length..transmit argument fixes length output repetitive sequence vector behaviour see help ds.rep \"details native R help \" (see ). parameter usually fully defined argument call ds.rep calls repDS. .transmit argument specifies number replications individual elements rather replications full sequence. behaviour see help ds.rep \"details native R help \" (see ). parameter usually fully defined argument <> call ds.rep calls repDS. x1.includes.characters Boolean parameter determining whether coerce final output sequence numeric. Defaults FALSE output coerced numeric. detailed behaviour see help ds.rep. parameter usually fully defined argument call ds.rep calls repDS. source.x1 defines source scalar vector defined argument. Four character strings allowed: \"clientside\" \"c\" serverside \"s\". behaviour see help ds.rep \"details native R help \" (see ). parameter usually fully defined argument call ds.rep calls repDS. source.times see \"param source.x1\" parameter usually fully defined argument call ds.rep calls repDS. source.length.see \"param source.x1\" parameter usually fully defined argument call ds.rep calls repDS. source.see \"param source.x1\" parameter usually fully defined argument call ds.rep calls repDS.","code":""},{"path":"/reference/repDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"repDS called by ds.rep — repDS","text":"vector containing specified repetitive sequence write output object defined argument (default name seq.vect) written serverside source. addition, two validity messages returned indicating whether created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - ds.matrixDiag also returns studysideMessages can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"newobj\") print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message(\"newobj\") return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/repDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"repDS called by ds.rep — repDS","text":"details can found help details ds.rep following aspects help function rep native R also apply (explained detail exceptions identified help ds.rep): addition Details R help : default behaviour call rep(x, times = 1, length.= NA, = 1) Normally just one additional arguments specified, '' specified either two, replication performed first, followed replication implied times length.. times consists single integer, result consists whole input repeated many times. times vector length x (replication ), result consists x[1] repeated times[1] times, x[2] repeated times[2] times . ***Note exception 1 . length.may given place times, case x repeated many times necessary create vector length. given, length.takes priority times ignored. ***Note exception 3 . Non-integer values times truncated towards zero. times computed quantity prudent add small fuzz use round. analogously .","code":""},{"path":"/reference/repDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"repDS called by ds.rep — repDS","text":"Paul Burton DataSHIELD Development Team, 14/10/2019","code":""},{"path":"/reference/replaceNaDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Replaces the missing values in a vector — replaceNaDS","title":"Replaces the missing values in a vector — replaceNaDS","text":"function identifies missing values replaces value values specified analyst.","code":""},{"path":"/reference/replaceNaDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Replaces the missing values in a vector — replaceNaDS","text":"","code":"replaceNaDS(xvect, replacements)"},{"path":"/reference/replaceNaDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Replaces the missing values in a vector — replaceNaDS","text":"xvect character, name vector process. replacements vector contains replacement value(s), vector one values study.","code":""},{"path":"/reference/replaceNaDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Replaces the missing values in a vector — replaceNaDS","text":"new vector without missing values","code":""},{"path":"/reference/replaceNaDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Replaces the missing values in a vector — replaceNaDS","text":"function used analyst prefer requires complete vectors. possible specify one value missing value first returning number missing values using function numNaDS cases might sensible replace missing values one specific value e.g. replace missing values vector mean median value. missing values replaced new vector created.","code":""},{"path":"/reference/replaceNaDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Replaces the missing values in a vector — replaceNaDS","text":"Amadou Gaye, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/rmDS.html","id":null,"dir":"Reference","previous_headings":"","what":"rmDS an aggregate function called by ds.rm — rmDS","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"deletes R object serverside","code":""},{"path":"/reference/rmDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"","code":"rmDS(x.names.transmit)"},{"path":"/reference/rmDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"x.names.transmit, names objects deleted converted transmissible form, comma separated list character string. argument specified via argument ds.rm","code":""},{"path":"/reference/rmDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"specified object deleted serverside. successful message \"Object successfully deleted\" returned clientside (x.names names object deleted). objects deleted already absent given source, source return message: \"Object deleted, .e. , exist need deleting\".","code":""},{"path":"/reference/rmDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"serverside function based rm() function native R. aggregate function may surprising modifies object serverside, therefore expected assign function. However, assign function last step running write modified object newobj. fail effect function delete object impossible write anywhere.","code":""},{"path":"/reference/rmDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"rmDS an aggregate function called by ds.rm — rmDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/rowColCalcDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"function similar R base functions 'rowSums', 'colSums', 'rowMeans' 'colMeans'.","code":""},{"path":"/reference/rowColCalcDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"","code":"rowColCalcDS(dataset, operation)"},{"path":"/reference/rowColCalcDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"dataset array two dimensions. operation integer indicates operation carry : 1 'rowSums', 2 'colSums', 3 'rowMeans' 4 'colMeans'","code":""},{"path":"/reference/rowColCalcDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"numeric vector","code":""},{"path":"/reference/rowColCalcDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"output returned user number entries output vector greater equal allowed size.","code":""},{"path":"/reference/rowColCalcDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes sums and means of rows or columns of numeric arrays — rowColCalcDS","text":"Gaye, .","code":""},{"path":"/reference/sampleDS.html","id":null,"dir":"Reference","previous_headings":"","what":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"draws pseudorandom sample vector, dataframe matrix serverside - special case - randomly permutes vector, dataframe matrix.","code":""},{"path":"/reference/sampleDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"","code":"sampleDS( x.transmit, size.transmit, replace.transmit = NULL, prob.transmit = NULL )"},{"path":"/reference/sampleDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"x.transmit Either character string providing name serverside vector, matrix data.frame sampled permuted, integer/numeric scalar (e.g. 923) indicating one create new vector serverside randomly permuted sample vector 1:923. x.transmit fully specified [x] argument ds.sample. details see help ds.sample native R help sample(). size.transmit numeric/integer scalar indicating size sample drawn. size.transmit fully specified [size] argument ds.sample. details see help ds.sample native R help sample(). replace.transmit Boolean indicator (TRUE FALSE) specifying whether sample drawn without replacement. Default FALSE sample drawn without replacement. replace.transmit fully specified [replace] argument ds.sample. details see help ds.sample native R help sample(). prob.transmit character string containing name numeric vector probability weights serverside associated elements vector sampled enabling drawing sample elements given higher probability drawn others. prob.transmit fully specified [prob] argument ds.sample. details see help ds.sample native R help sample().","code":""},{"path":"/reference/sampleDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"object specified argument (default name 'newobj.sample') written serverside. details see help ds.sample native R help sample().","code":""},{"path":"/reference/sampleDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"Serverside assign function sampleDS called clientside function ds.sample. Based native R function sample() deals slightly differently data.frames matrices. details see help ds.sample native R help sample().","code":""},{"path":"/reference/sampleDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"random sampling and permuting of vectors, dataframes and matrices — sampleDS","text":"Paul Burton, DataSHIELD Development Team, 15/4/2020","code":""},{"path":"/reference/scatterPlotDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the coordinates of the data to be plot — scatterPlotDS","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"function uses two disclosure control methods generate non-disclosive coordinates returned client generates non-disclosive scatter plots.","code":""},{"path":"/reference/scatterPlotDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"","code":"scatterPlotDS(x, y, method.indicator, k, noise)"},{"path":"/reference/scatterPlotDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"x name numeric vector, x-variable. y name numeric vector, y-variable. method.indicator integer either 1 2. user selects deterministic method client side function method.indicator set 1 user selects probabilistic method argument set 2. k number nearest neighbours centroid calculated deterministic method selected. noise percentage initial variance used variance embedded noise probabilistic method selected.","code":""},{"path":"/reference/scatterPlotDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"list x y coordinates data plot","code":""},{"path":"/reference/scatterPlotDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"user chooses deterministic approach, function finds k-1 nearest neighbours data point 2-dimensional space. nearest neighbours data points minimum Euclidean distances point interest. point interest k-1 nearest neighbours used calculation coordinates centroid k points. Centroid referred centre mass, .e. x-coordinate centroid average value x-coordinates k nearest neighbours y-coordinate centroid average y-coordinates k nearest neighbours. user chooses probabilistic approach, function adds random noise $x$ $y$ separately. random noise follows normal distribution zero mean variance equal 10 disclosure fix random number generator value specified input variables. Thus function returns always noisy data given pair variables.","code":""},{"path":"/reference/scatterPlotDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the coordinates of the data to be plot — scatterPlotDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/seqDS.html","id":null,"dir":"Reference","previous_headings":"","what":"seqDS a serverside assign function called by ds.seq — seqDS","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":"assign function seqDS called ds.seq","code":""},{"path":"/reference/seqDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":"","code":"seqDS( FROM.value.char, TO.value.char, BY.value.char, LENGTH.OUT.value.char, ALONG.WITH.name )"},{"path":"/reference/seqDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":".value.char starting value sequence expressed integer real number decimal point character form. Fully specified <.value.char> argument ds.seq. .value.char terminal value sequence expressed integer real number decimal point character form. Fully specified <.value.char> argument ds.seq. .value.char value increment step sequence expressed integer real number decimal point character form. Fully specified <.value.char> argument ds.seq. LENGTH..value.char length sequence point extension stopped, expressed integer real number decimal point character form. Fully specified argument ds.seq. ALONG..name convenience, rather specifying value LENGTH.can often better specify variable name argument. Fully specified argument ds.seq.","code":""},{"path":"/reference/seqDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":"object specified argument ds.seq (default name newObj) written serverside. well writing output object serverside, two validity messages returned indicating whether created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - ds.seq() also returns studysideMessages can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"\") print relevant studysideMessage datasource error creating studysideMessage saved. error created without problems studysideMessage saved ds.message(\"\") return message: \"OK: studysideMessage(s) datasource\".","code":""},{"path":"/reference/seqDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":"assign function uses native R function seq() create one flexible range sequence vectors can used help manage analyse data. assign function resultant vector written new object specified data source servers. Please see \"details\" ds.seq information allowable combinations arguments etc.","code":""},{"path":"/reference/seqDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"seqDS a serverside assign function called by ds.seq — seqDS","text":"Paul Burton DataSHIELD Development Team, 17/9/2019","code":""},{"path":"/reference/setSeedDS.html","id":null,"dir":"Reference","previous_headings":"","what":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"aggregate serverside function primes pseudorandom number generator data source","code":""},{"path":"/reference/setSeedDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"","code":"setSeedDS(seedtext = NULL, kind = NULL, normal.kind = NULL)"},{"path":"/reference/setSeedDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"seedtext simply value argument ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois ds.rBinom coerced character format. done clientside functions require DataSHIELD user anything. Please see help clientside functions, particular, information argument details. kind see help set.seed() function native R normal.kind see help set.seed() function native R","code":""},{"path":"/reference/setSeedDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"Sets values vector integers length 626 known .Random.seed data source true current state random seed source.","code":""},{"path":"/reference/setSeedDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"setSeedDS effectively equivalent native R function set.seed() help function can provide many additional details. minor difference first argument setSeedDS, takes integer priming seed character format. However, user integer still specified directly integer argument one clientside functions ds.setSeed, ds.rNorm ..... clientside functions coerces integer character format calls setSeedDS first active line code setSeedDS converts character string back integer treats first argument native R function set.seed(). two arguments set.seed() native R, defaulted specifying NULL. defaulting hard wired setSeedDS function changed analyst means setSeedDS much less flexible native R's set.seed() function. DataSHIELD user requires aspect flexibility returned development team can approached, unless actually theoretical work random number generators likely ","code":""},{"path":"/reference/setSeedDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"setSeedDs called by ds.setSeed, ds.rNorm, ds.rUnif, ds.rPois and ds.rBinom — setSeedDS","text":"Paul Burton DataSHIELD Development Team","code":""},{"path":"/reference/skewnessDS1.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the skewness of a numeric variable — skewnessDS1","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"function calculates skewness numeric variable study separately.","code":""},{"path":"/reference/skewnessDS1.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"","code":"skewnessDS1(x, method)"},{"path":"/reference/skewnessDS1.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"x string character, name numeric variable. method integer 1 3 selecting one algorithms computing skewness detailed headers client-side ds.skewness function.","code":""},{"path":"/reference/skewnessDS1.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"list including skewness input numeric variable, number valid observations study-side validity message.","code":""},{"path":"/reference/skewnessDS1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"function calculates skewness input variable x three different methods. method specified argument method client-side ds.skewness function.","code":""},{"path":"/reference/skewnessDS1.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the skewness of a numeric variable — skewnessDS1","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/skewnessDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"Calculates the skewness of a numeric variable — skewnessDS2","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"function calculates summary statistics returned client-side used estimation combined skewness numeric variable across studies.","code":""},{"path":"/reference/skewnessDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"","code":"skewnessDS2(x, global.mean)"},{"path":"/reference/skewnessDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"x string character, name numeric variable. global.mean numeric, combined mean input variable across studies.","code":""},{"path":"/reference/skewnessDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"list including sum cubed differences values x global mean x across studies, sum squared differences values x global mean x across studies, number valid observations (.e. length x excluding missing values), validity message indicating indicating valid analysis number valid observations protection filter nfilter.tab invalid analysis otherwise.","code":""},{"path":"/reference/skewnessDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"function calculates sum squared differences values x global mean x across studies, sum cubed differences values x global mean x across studies number valid observations input variable x.","code":""},{"path":"/reference/skewnessDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Calculates the skewness of a numeric variable — skewnessDS2","text":"Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/sqrtDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the square root values of the input variable — sqrtDS","title":"Computes the square root values of the input variable — sqrtDS","text":"function similar R function sqrt.","code":""},{"path":"/reference/sqrtDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the square root values of the input variable — sqrtDS","text":"","code":"sqrtDS(x)"},{"path":"/reference/sqrtDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the square root values of the input variable — sqrtDS","text":"x string character, name numeric integer vector","code":""},{"path":"/reference/sqrtDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the square root values of the input variable — sqrtDS","text":"object specified newobj argument ds.sqrt (default name sqrt.newobj) written server-side. output object class numeric integer.","code":""},{"path":"/reference/sqrtDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the square root values of the input variable — sqrtDS","text":"function computes square root values input numeric integer vector.","code":""},{"path":"/reference/sqrtDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the square root values of the input variable — sqrtDS","text":"Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/subsetByClassDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"function takes categorical vector dataframe input generates subset(s) vectors dataframes category. Subsets considered invalid hold 1 4 observations.","code":""},{"path":"/reference/subsetByClassDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"","code":"subsetByClassDS(data = NULL, variables = NULL)"},{"path":"/reference/subsetByClassDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"data string character, name dataframe factor vector variables vector string characters, names variables subset .","code":""},{"path":"/reference/subsetByClassDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"list contains subsetted datasets","code":""},{"path":"/reference/subsetByClassDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"input data object dataframe possible specify variables subset . subset 'valid' values reported missing (.e. NA), name subsets labelled '_INVALID'. variables specified subset , dataframe subset factor variables. none columns holds factor variable message issued output. message also issued output input vector type factor.","code":""},{"path":"/reference/subsetByClassDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Breaks down a dataframe or a factor into its sub-classes — subsetByClassDS","text":"Gaye, .","code":""},{"path":"/reference/subsetDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Generates a valid subset of a table or a vector — subsetDS","title":"Generates a valid subset of a table or a vector — subsetDS","text":"function uses R classical subsetting squared brackets '[]' allows also subset using logical operator threshold. object subset must vector (factor, numeric character) table (data.frame matrix).","code":""},{"path":"/reference/subsetDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generates a valid subset of a table or a vector — subsetDS","text":"","code":"subsetDS( dt = NULL, complt = NULL, rs = NULL, cs = NULL, lg = NULL, th = NULL, varname = NULL )"},{"path":"/reference/subsetDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generates a valid subset of a table or a vector — subsetDS","text":"dt string character, name dataframe factor vector range subset. complt boolean tells subset subset include complete cases rs vector two integers give range rows de extract. cs vector two integers one characters; indices columns extract names columns (.e. names variables extract). lg character, logical parameter use user wishes subset vector using logical operator. parameter ignored input data vector. th numeric, threshold use conjunction logical parameter. parameter ignored input data vector. varname character, input data table, parameter provided along 'logical' 'threshold' parameters, subtable based threshold applied specified variable. parameter however ignored parameter 'rows' /'cols' provided.","code":""},{"path":"/reference/subsetDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generates a valid subset of a table or a vector — subsetDS","text":"subset vector, matrix dataframe specified stored server side","code":""},{"path":"/reference/subsetDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Generates a valid subset of a table or a vector — subsetDS","text":"input data table: user specifies rows /columns include subset input object table; columns can referred names. name vector (.e. variable) can also provided logical operator threshold (see example 3). input data vector: parameters 'rows', 'logical' 'threshold' provided last two ignored ( 'rows' precedence two parameters ). requested subset valid (.e. contains less allowed number observations), subset generated, rather table vector missing values generated allow subsequent process using output function proceed informing user via message.","code":""},{"path":"/reference/subsetDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Generates a valid subset of a table or a vector — subsetDS","text":"Gaye, .","code":""},{"path":"/reference/table1DDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Creates 1-dimensional contingency tables — table1DDS","title":"Creates 1-dimensional contingency tables — table1DDS","text":"function generates 1-dimensional table potentially disclosive cells. (based set threshold) replaced missing value ('NA').","code":""},{"path":"/reference/table1DDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Creates 1-dimensional contingency tables — table1DDS","text":"","code":"table1DDS(xvect)"},{"path":"/reference/table1DDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Creates 1-dimensional contingency tables — table1DDS","text":"xvect numerical vector discrete values - usually factor.","code":""},{"path":"/reference/table1DDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Creates 1-dimensional contingency tables — table1DDS","text":"list contains two elements: 'table', 1-dimensional table 'message' message informs validity table.","code":""},{"path":"/reference/table1DDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Creates 1-dimensional contingency tables — table1DDS","text":"generates 1-dimensional tables valid (non-disclosive) 1-dimensional tables defined data sources table cells counts 1 set threshold. output table invalid cells total count replaced missing values. total count visible table returned client side. message also returned 1-dimensional; message says \"invalid table - invalid counts present\" table invalid 'valid table' otherwise.","code":""},{"path":"/reference/table1DDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Creates 1-dimensional contingency tables — table1DDS","text":"Gaye .","code":""},{"path":"/reference/table2DDS.html","id":null,"dir":"Reference","previous_headings":"","what":"table2DDS (aggregate function) called by ds.table2D — table2DDS","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"function generates 2-dimensional contingency table potentially disclosive cells (based set threshold) replaced missing value ('NA').","code":""},{"path":"/reference/table2DDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"","code":"table2DDS(xvect, yvect)"},{"path":"/reference/table2DDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"xvect numerical vector discrete values - usually factor. yvect numerical vector discrete values - usually factor.","code":""},{"path":"/reference/table2DDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"list contains two elements: 'table', 2-dimensional table 'message' message informs validity table.","code":""},{"path":"/reference/table2DDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"generates 2-dimensional contingency tables valid (non-disclosive) tables defined none cells counts 1 set threshold \"nfilter.tab\". output table invalid cells except total counts replaced missing values. total counts visible table returned client side. message also returned 2-dimensional table; message says \"invalid table - invalid counts present\" table invalid 'valid table' otherwise.","code":""},{"path":"/reference/table2DDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"table2DDS (aggregate function) called by ds.table2D — table2DDS","text":"Amadou Gaye, Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/tableDS.assign.html","id":null,"dir":"Reference","previous_headings":"","what":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":"helps creates 1-dimensional, 2-dimensional 3-dimensional tables using table function native R.","code":""},{"path":"/reference/tableDS.assign.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":"","code":"tableDS.assign( rvar.transmit, cvar.transmit, stvar.transmit, rvar.all.unique.levels.transmit, cvar.all.unique.levels.transmit, stvar.all.unique.levels.transmit, exclude.transmit, useNA.transmit )"},{"path":"/reference/tableDS.assign.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":"rvar.transmit character string (inverted commas) specifying name variable defining rows 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table cvar.transmit character string specifying name variable defining columns 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table stvar.transmit character string specifying name variable indexes separate two dimensional tables output call specifies 3 dimensional table. Fully specified argument ds.table. information see help ds.table rvar..unique.levels.transmit character string containing unique level rvar, across studies, separated ','. cvar..unique.levels.transmit character string containing unique level cvar, across studies, separated ','. stvar..unique.levels.transmit character string containing unique level stvar, across studies, separated ','. exclude.transmit information see help argument ds.table. Fully specified argument ds.table useNA.transmit information see help argument ds.table. Fully specified argument ds.table","code":""},{"path":"/reference/tableDS.assign.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":"information see help ds.table","code":""},{"path":"/reference/tableDS.assign.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":" argument ds.table set TRUE, assign function writes table requested format specified ds.table function object named argument ds.table. information see help ds.table DataSHIELD table function native R.","code":""},{"path":"/reference/tableDS.assign.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"tableDS.assign is the serverside assign function called by ds.table — tableDS.assign","text":"Paul Burton DataSHIELD Development Team, 13/11/2019","code":""},{"path":"/reference/tableDS.html","id":null,"dir":"Reference","previous_headings":"","what":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"creates 1-dimensional, 2-dimensional 3-dimensional tables using table function native R.","code":""},{"path":"/reference/tableDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"","code":"tableDS( rvar.transmit, cvar.transmit, stvar.transmit, rvar.all.unique.levels.transmit, cvar.all.unique.levels.transmit, stvar.all.unique.levels.transmit, exclude.transmit, useNA.transmit, force.nfilter.transmit )"},{"path":"/reference/tableDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"rvar.transmit character string (inverted commas) specifying name variable defining rows 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table cvar.transmit character string specifying name variable defining columns 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table stvar.transmit character string specifying name variable indexes separate two dimensional tables output call specifies 3 dimensional table. Fully specified argument ds.table. information see help ds.table rvar..unique.levels.transmit character string containing unique level rvar, across studies, separated ','. cvar..unique.levels.transmit character string containing unique level cvar, across studies, separated ','. stvar..unique.levels.transmit character string containing unique level stvar, across studies, separated ','. exclude.transmit information see help argument ds.table. Fully specified argument ds.table useNA.transmit information see help argument ds.table. Fully specified argument ds.table force.nfilter.transmit information see help argument ds.table. Fully specified argument ds.table","code":""},{"path":"/reference/tableDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"information see help ds.table","code":""},{"path":"/reference/tableDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"serverside function workhorse ds.table - creating table requested format specified ds.table. information see help ds.table DataSHIELD table function native R.","code":""},{"path":"/reference/tableDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"tableDS is the first of two serverside aggregate functions called by ds.table — tableDS","text":"Paul Burton DataSHIELD Development Team, 13/11/2019","code":""},{"path":"/reference/tableDS2.html","id":null,"dir":"Reference","previous_headings":"","what":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":"Helps creates 1-dimensional, 2-dimensional 3-dimensional tables using table function native R.","code":""},{"path":"/reference/tableDS2.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":"","code":"tableDS2(newobj, rvar.transmit, cvar.transmit, stvar.transmit)"},{"path":"/reference/tableDS2.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":"newobj character string providing name output table object written serverside TRUE. explicit name table object specified, nevertheless TRUE, name serverside table object defaults 'newObj'. Fully specified argument ds.table. information see help ds.table rvar.transmit character string (inverted commas) specifying name variable defining rows 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table cvar.transmit character string specifying name variable defining columns 2 dimensional tables form output. Fully specified argument ds.table. information see help ds.table stvar.transmit character string specifying name variable indexes separate two dimensional tables output call specifies 3 dimensional table. Fully specified argument ds.table. information see help ds.table","code":""},{"path":"/reference/tableDS2.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":"information see help ds.table","code":""},{"path":"/reference/tableDS2.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":" argument ds.table set TRUE, aggregate function returns non-disclosive information table object written serverside tableDS.assign. information see help ds.table, tableDS.assign tableDS DataSHIELD table function native R.","code":""},{"path":"/reference/tableDS2.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"tableDS is the second of two serverside aggregate functions called by ds.table — tableDS2","text":"Paul Burton DataSHIELD Development Team, 13/11/2019","code":""},{"path":"/reference/tapplyDS.assign.html","id":null,"dir":"Reference","previous_headings":"","what":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"Apply one selected range functions summarize outcome variable one indexing factors write resultant summary newobj serverside","code":""},{"path":"/reference/tapplyDS.assign.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"","code":"tapplyDS.assign(X.name, INDEX.names.transmit, FUN.name)"},{"path":"/reference/tapplyDS.assign.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"X.name, name variable summarized. Specified via argument ds.tapply.assign function INDEX.names.transmit, name single factor vector names factors index variable summarized. Specified via argument ds.tapply.assign function FUN.name, name one allowable summarizing functions applied. Specified via argument ds.tapply.assign function.","code":""},{"path":"/reference/tapplyDS.assign.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"array summarized values created tapplyDS.assign function. array written newobj serverside. number dimensions INDEX.","code":""},{"path":"/reference/tapplyDS.assign.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"see details ds.tapply.assign function","code":""},{"path":"/reference/tapplyDS.assign.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"tapplyDS.assign called by ds.tapply.assign — tapplyDS.assign","text":"Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/tapplyDS.html","id":null,"dir":"Reference","previous_headings":"","what":"tapplyDS called by ds.tapply — tapplyDS","title":"tapplyDS called by ds.tapply — tapplyDS","text":"Apply one selected range functions summarize outcome variable one indexing factors write resultant summary clientside","code":""},{"path":"/reference/tapplyDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"tapplyDS called by ds.tapply — tapplyDS","text":"","code":"tapplyDS(X.name, INDEX.names.transmit, FUN.name)"},{"path":"/reference/tapplyDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"tapplyDS called by ds.tapply — tapplyDS","text":"X.name, name variable summarized. Specified via argument ds.tapply function INDEX.names.transmit, name single factor vector names factors index variable summarized. Specified via argument ds.tapply function FUN.name, name one allowable summarizing functions applied. Specified via argument ds.tapply function.","code":""},{"path":"/reference/tapplyDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"tapplyDS called by ds.tapply — tapplyDS","text":"array summarized values created tapplyDS function. array returned clientside. number dimensions INDEX.","code":""},{"path":"/reference/tapplyDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"tapplyDS called by ds.tapply — tapplyDS","text":"see details ds.tapply function","code":""},{"path":"/reference/tapplyDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"tapplyDS called by ds.tapply — tapplyDS","text":"Paul Burton, Demetris Avraam DataSHIELD Development Team","code":""},{"path":"/reference/testObjExistsDS.html","id":null,"dir":"Reference","previous_headings":"","what":"testObjExistsDS — testObjExistsDS","title":"testObjExistsDS — testObjExistsDS","text":"server-side function called ds.testObjExists","code":""},{"path":"/reference/testObjExistsDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"testObjExistsDS — testObjExistsDS","text":"","code":"testObjExistsDS(test.obj.name = NULL)"},{"path":"/reference/testObjExistsDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"testObjExistsDS — testObjExistsDS","text":"test.obj.name client-side provided character string specifying variable whose presence tested data source","code":""},{"path":"/reference/testObjExistsDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"testObjExistsDS — testObjExistsDS","text":"List `test.obj.exists` `test.obj.class`","code":""},{"path":"/reference/testObjExistsDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"testObjExistsDS — testObjExistsDS","text":"Tests whether given object exists sources. called end recently written assign functions check new (assigned) object created sources","code":""},{"path":"/reference/testObjExistsDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"testObjExistsDS — testObjExistsDS","text":"Burton PR","code":""},{"path":"/reference/unListDS.html","id":null,"dir":"Reference","previous_headings":"","what":"unListDS a serverside assign function called by ds.unList — unListDS","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"function based native R function unlist coerces object list class back class coerced list","code":""},{"path":"/reference/unListDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"","code":"unListDS(x.name)"},{"path":"/reference/unListDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"x.name name input object unlisted. must specified inverted commas e.g. x.name=\"input.object.name\". Fully specified x.name argument ds.unList","code":""},{"path":"/reference/unListDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"object specified newobj argument ds.unList function (default \"unlist.newobj\" newobj argument NULL). written serverside. well writing output object newobj serverside, two validity messages returned indicating whether newobj created data source whether valid form. form valid least one study - e.g. disclosure trap tripped creation full output object blocked - ds.seq also returns studysideMessages can explain error creating full output object. well appearing screen run time,wish see relevant studysideMessages later date can use ds.message function. type ds.message(\"\") print relevant studysideMessage datasource error creating newobj studysideMessage saved. outcome object ds.unList typically list object names, errors creating message returned ds.message(\"\") study read \"Outcome object list without names. studysideMessage may hidden. Please check output OK\". suggests - case specific function - one check far one can nature output call ds.unList - e.g. ds.class, ds.length etc","code":""},{"path":"/reference/unListDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"See details native R function unlist. function represents substantive restructuring earlier version created Amadou Gaye. details working please see 'details' help ds.unList.","code":""},{"path":"/reference/unListDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"unListDS a serverside assign function called by ds.unList — unListDS","text":"Amadou Gaye (2016), Paul Burton (19/09/2019) DataSHIELD Development Team","code":""},{"path":"/reference/uniqueDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Applies the unique method to a server-side variable. — uniqueDS","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"function similar R function unique.","code":""},{"path":"/reference/uniqueDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"","code":"uniqueDS(x.name.transmit = NULL)"},{"path":"/reference/uniqueDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"x.name.transmit name variable upon unique method applied","code":""},{"path":"/reference/uniqueDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"object specified newobj argument written server-side.","code":""},{"path":"/reference/uniqueDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"function computes uniques values variable.","code":""},{"path":"/reference/uniqueDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Applies the unique method to a server-side variable. — uniqueDS","text":"Stuart Wheater DataSHIELD Development Team","code":""},{"path":"/reference/varDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Computes the variance of vector — varDS","title":"Computes the variance of vector — varDS","text":"Calculates variance.","code":""},{"path":"/reference/varDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Computes the variance of vector — varDS","text":"","code":"varDS(xvect)"},{"path":"/reference/varDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Computes the variance of vector — varDS","text":"xvect vector","code":""},{"path":"/reference/varDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Computes the variance of vector — varDS","text":"list, sum input variable, sum squares input variable, number missing values, number valid values, number total length variable, study message indicating whether number valid less disclosure threshold","code":""},{"path":"/reference/varDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Computes the variance of vector — varDS","text":"length input vector less set filter missing value returned.","code":""},{"path":"/reference/varDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Computes the variance of vector — varDS","text":"Amadou Gaye, Demetris Avraam, DataSHIELD Development Team","code":""},{"path":"/reference/vectorDS.html","id":null,"dir":"Reference","previous_headings":"","what":"Creates a vector on the server-side. — vectorDS","title":"Creates a vector on the server-side. — vectorDS","text":"function similar R function c.","code":""},{"path":"/reference/vectorDS.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Creates a vector on the server-side. — vectorDS","text":"","code":"vectorDS(...)"},{"path":"/reference/vectorDS.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Creates a vector on the server-side. — vectorDS","text":"... parameter used form vector.","code":""},{"path":"/reference/vectorDS.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Creates a vector on the server-side. — vectorDS","text":"object specified newobj argument written server-side.","code":""},{"path":"/reference/vectorDS.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Creates a vector on the server-side. — vectorDS","text":"function computes vectors values.","code":""},{"path":"/reference/vectorDS.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Creates a vector on the server-side. — vectorDS","text":"Stuart Wheater DataSHIELD Development Team","code":""}] diff --git a/docs/sitemap.xml b/docs/sitemap.xml index 04ef332c..ef247dbc 100644 --- a/docs/sitemap.xml +++ b/docs/sitemap.xml @@ -46,7 +46,12 @@ /reference/extract.html /reference/extractQuantilesDS1.html /reference/extractQuantilesDS2.html +/reference/fixClassDS.html +/reference/fixColsDS.html +/reference/fixLevelsDS.html /reference/gamlssDS.html +/reference/getAllLevelsDS.html +/reference/getClassAllColsDS.html /reference/getWGSRDS.html /reference/glmDS1.html /reference/glmDS2.html @@ -89,6 +94,7 @@ /reference/matrixInvertDS.html /reference/matrixMultDS.html /reference/matrixTransposeDS.html +/reference/mdPatternDS.html /reference/meanDS.html /reference/meanSdGpDS.html /reference/mergeDS.html diff --git a/inst/DATASHIELD b/inst/DATASHIELD index 8753f19d..e69da687 100644 --- a/inst/DATASHIELD +++ b/inst/DATASHIELD @@ -37,6 +37,7 @@ AggregateMethods: lmerSLMADS2, lsDS, matrixDetDS1, + mdPatternDS, meanDS, meanSdGpDS, messageDS, @@ -69,7 +70,9 @@ AggregateMethods: is.null=base::is.null, is.numeric=base::is.numeric, NROW=base::NROW, - t.test=stats::t.test + t.test=stats::t.test, + getClassAllColsDS, + getAllLevelsDS AssignMethods: absDS, asCharacterDS, @@ -160,7 +163,10 @@ AssignMethods: acos=base::acos, atan=base::atan, sum=base::sum, - unlist=base::unlist + unlist=base::unlist, + fixClassDS, + fixColsDS, + fixLevelsDS Options: datashield.privacyLevel=5, default.datashield.privacyControlLevel="banana", diff --git a/man/dsBase-package.Rd b/man/dsBase-package.Rd index 725c4131..be7f5744 100644 --- a/man/dsBase-package.Rd +++ b/man/dsBase-package.Rd @@ -13,6 +13,7 @@ Base 'DataSHIELD' functions for the server side. 'DataSHIELD' is a software pack Authors: \itemize{ + \item Stuart Wheater \email{stuart.wheater@arjuna.com} (\href{https://orcid.org/0009-0003-2419-1964}{ORCID}) \item Paul Burton (\href{https://orcid.org/0000-0001-5799-9634}{ORCID}) \item Rebecca Wilson (\href{https://orcid.org/0000-0003-2294-593X}{ORCID}) \item Olly Butters (\href{https://orcid.org/0000-0003-0354-8461}{ORCID}) diff --git a/man/fixClassDS.Rd b/man/fixClassDS.Rd new file mode 100644 index 00000000..d7b6bf17 --- /dev/null +++ b/man/fixClassDS.Rd @@ -0,0 +1,22 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/standardiseDfDS.R +\name{fixClassDS} +\alias{fixClassDS} +\title{Change Class of Target Variables in a Data Frame} +\usage{ +fixClassDS(df.name, target_vars, target_class) +} +\arguments{ +\item{df.name}{A string representing the name of the data frame.} + +\item{target_vars}{A character vector specifying the columns to be modified.} + +\item{target_class}{A character vector specifying the new classes for each column (1 = factor, +2 = integer, 3 = numeric, 4 = character, 5 = logical).} +} +\value{ +A modified data frame with the specified columns converted to the target classes. +} +\description{ +Change Class of Target Variables in a Data Frame +} diff --git a/man/fixColsDS.Rd b/man/fixColsDS.Rd new file mode 100644 index 00000000..709d9472 --- /dev/null +++ b/man/fixColsDS.Rd @@ -0,0 +1,19 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/standardiseDfDS.R +\name{fixColsDS} +\alias{fixColsDS} +\title{Add Missing Columns with NA Values} +\usage{ +fixColsDS(.data, cols) +} +\arguments{ +\item{.data}{A string representing the name of the data frame.} + +\item{cols}{A character vector specifying the columns to be added if missing.} +} +\value{ +A modified data frame with missing columns added and filled with NA. +} +\description{ +Add Missing Columns with NA Values +} diff --git a/man/fixLevelsDS.Rd b/man/fixLevelsDS.Rd new file mode 100644 index 00000000..096757a9 --- /dev/null +++ b/man/fixLevelsDS.Rd @@ -0,0 +1,21 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/standardiseDfDS.R +\name{fixLevelsDS} +\alias{fixLevelsDS} +\title{Set Factor Levels for Specific Columns in a Data Frame} +\usage{ +fixLevelsDS(df.name, vars, levels) +} +\arguments{ +\item{df.name}{A string representing the name of the data frame to modify.} + +\item{vars}{A character vector specifying the columns to be modified.} + +\item{levels}{A named list where each element contains the levels for the corresponding factor variable.} +} +\value{ +A modified data frame with the specified columns converted to factors with the provided levels. +} +\description{ +Set Factor Levels for Specific Columns in a Data Frame +} diff --git a/man/getAllLevelsDS.Rd b/man/getAllLevelsDS.Rd new file mode 100644 index 00000000..e5030725 --- /dev/null +++ b/man/getAllLevelsDS.Rd @@ -0,0 +1,19 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/standardiseDfDS.R +\name{getAllLevelsDS} +\alias{getAllLevelsDS} +\title{Retrieve Factor Levels for Specific Columns} +\usage{ +getAllLevelsDS(df.name, factor_vars) +} +\arguments{ +\item{df.name}{A string representing the name of the data frame.} + +\item{factor_vars}{A character vector specifying the factor columns.} +} +\value{ +A list of factor levels for the specified columns. +} +\description{ +Retrieve Factor Levels for Specific Columns +} diff --git a/man/getClassAllColsDS.Rd b/man/getClassAllColsDS.Rd new file mode 100644 index 00000000..cb2de0e7 --- /dev/null +++ b/man/getClassAllColsDS.Rd @@ -0,0 +1,17 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/standardiseDfDS.R +\name{getClassAllColsDS} +\alias{getClassAllColsDS} +\title{Get the Class of All Columns in a Data Frame} +\usage{ +getClassAllColsDS(df.name) +} +\arguments{ +\item{df.name}{A string representing the name of the data frame.} +} +\value{ +A tibble with the class of each column in the data frame. +} +\description{ +Get the Class of All Columns in a Data Frame +} diff --git a/man/mdPatternDS.Rd b/man/mdPatternDS.Rd new file mode 100644 index 00000000..1084565e --- /dev/null +++ b/man/mdPatternDS.Rd @@ -0,0 +1,54 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/mdPatternDS.R +\name{mdPatternDS} +\alias{mdPatternDS} +\title{Missing data pattern with disclosure control} +\usage{ +mdPatternDS(x) +} +\arguments{ +\item{x}{a character string specifying the name of a data frame or matrix +containing the data to analyze for missing patterns.} +} +\value{ +A list containing: +\item{pattern}{The missing data pattern matrix with disclosure control applied} +\item{valid}{Logical indicating if all patterns meet disclosure requirements} +\item{message}{A message describing the validity status} +} +\description{ +This function is a serverside aggregate function that computes the +missing data pattern using mice::md.pattern and applies disclosure control to +prevent revealing small cell counts. +} +\details{ +This function calls the mice::md.pattern function to generate a matrix +showing the missing data patterns in the input data. To ensure disclosure control, +any pattern counts that are below the threshold (nfilter.tab, default=3) are +suppressed. + +\strong{Suppression Method:} + +When a pattern count is below threshold: +- Row name is changed to "suppressed()" where N is the threshold +- All pattern values in that row are set to NA +- Summary row is also set to NA (prevents back-calculation) + +\strong{Output Matrix Structure:} + +- Rows represent different missing data patterns (plus a summary row at the bottom) +- Row names contain pattern counts (or "suppressed()" for invalid patterns) +- Columns show 1 if variable is observed, 0 if missing +- Last column shows total number of missing values per pattern +- Last row shows total number of missing values per variable + +\strong{Note for Pooling:} + +When this function is called from ds.mdPattern with type='combine', suppressed +patterns are excluded from pooling to prevent disclosure through subtraction. +This means pooled counts may underestimate the true total when patterns are +suppressed in some studies. +} +\author{ +Xavier Escribà montagut for DataSHIELD Development Team +} diff --git a/tests/testthat/perf_files/azure-pipeline.csv b/tests/testthat/perf_files/azure-pipeline_perf-profile.csv similarity index 100% rename from tests/testthat/perf_files/azure-pipeline.csv rename to tests/testthat/perf_files/azure-pipeline_perf-profile.csv diff --git a/tests/testthat/perf_files/circleci.csv b/tests/testthat/perf_files/circleci_perf-profile.csv similarity index 100% rename from tests/testthat/perf_files/circleci.csv rename to tests/testthat/perf_files/circleci_perf-profile.csv diff --git a/tests/testthat/perf_files/cran_check.cvs b/tests/testthat/perf_files/cran-check_perf-profile.cvs similarity index 100% rename from tests/testthat/perf_files/cran_check.cvs rename to tests/testthat/perf_files/cran-check_perf-profile.cvs diff --git a/tests/testthat/perf_files/default_perf_profile.csv b/tests/testthat/perf_files/default_perf-profile.csv similarity index 100% rename from tests/testthat/perf_files/default_perf_profile.csv rename to tests/testthat/perf_files/default_perf-profile.csv diff --git a/tests/testthat/perf_files/hp-laptop_quay.csv b/tests/testthat/perf_files/hp-laptop-quay_perf-profile.csv similarity index 100% rename from tests/testthat/perf_files/hp-laptop_quay.csv rename to tests/testthat/perf_files/hp-laptop-quay_perf-profile.csv diff --git a/tests/testthat/perf_tests/perf_rate.R b/tests/testthat/perf_tests/perf_rate.R index 584de1b0..611d466d 100644 --- a/tests/testthat/perf_tests/perf_rate.R +++ b/tests/testthat/perf_tests/perf_rate.R @@ -1,5 +1,5 @@ #------------------------------------------------------------------------------- -# Copyright (c) 2024 Arjuna Technologies, Newcastle upon Tyne. All rights reserved. +# Copyright (c) 2024-2026 Arjuna Technologies, Newcastle upon Tyne. All rights reserved. # # This program and the accompanying materials # are made available under the terms of the GNU Public License v3.0. @@ -8,12 +8,24 @@ # along with this program. If not, see . #------------------------------------------------------------------------------- -.perf.reference.filename <- getOption("perf.profile", "perf_files/default_perf_profile.csv") +.perf.reference.filename.base.prefix <- 'perf_files/' +.perf.reference.filename.base.postfix <- '_perf-profile.csv' +.perf.reference.save.filename <- NULL .perf.reference <- NULL .load.pref <- function() { - .perf.reference <<- read.csv(.perf.reference.filename, header = TRUE, sep = ",") + perf.profile <- base::Sys.getenv("PERF_PROFILE") + if (nchar(perf.profile) > 0) + perf.reference.filename.platform.infix <- base::tolower(perf.profile) + else + { + perf.reference.filename.platform.infix <- "default" + warning("Unknown performance profile platform, using 'default'") + } + + perf.reference.filename <- paste(.perf.reference.filename.base.prefix, perf.reference.filename.platform.infix, .perf.reference.filename.base.postfix, sep = "") + .perf.reference <<- read.csv(perf.reference.filename, header = TRUE, sep = ",") } perf.profile.tolerance.lower <- function() { @@ -36,11 +48,22 @@ perf.reference.save <- function(perf.ref.name, rate, tolerance.lower, tolerance. .perf.reference[nrow(.perf.reference)+1,] <- c(perf.ref.name, rate, tolerance.lower, tolerance.upper) - write.csv(.perf.reference, .perf.reference.filename, row.names = FALSE) + if (is.null(.perf.reference.save.filename)) + { + .perf.reference.save.filename <<- base::tempfile(pattern = "perf_file_", fileext = ".csv") + message(paste0("Additional perf record added to '", .perf.reference.save.filename, "'")) + } + + write.csv(.perf.reference, .perf.reference.save.filename, row.names = FALSE) .perf.reference <<- .perf.reference } +# Obtain performance test duration from PERF_DURATION_SEC environment variable, otherwise default.duration argument, otherwise "30". +perf.testduration <- function(default.duration = 30) { + base::as.integer(base::Sys.getenv("PERF_DURATION_SEC", unset = base::as.character(default.duration))) +} + perf.reference.rate <- function(perf.ref.name) { if (is.null(.perf.reference)) .load.pref() @@ -61,4 +84,3 @@ perf.reference.tolerance.upper <- function(perf.ref.name) { return(as.numeric(.perf.reference[which(.perf.reference$refer_name == perf.ref.name),]$upper_tolerance)) } - diff --git a/tests/testthat/test-arg-mdPatternDS.R b/tests/testthat/test-arg-mdPatternDS.R new file mode 100644 index 00000000..989deb76 --- /dev/null +++ b/tests/testthat/test-arg-mdPatternDS.R @@ -0,0 +1,43 @@ +#------------------------------------------------------------------------------- +# Copyright (c) 2025 ProPASS Consortium. All rights reserved. +# +# This program and the accompanying materials +# are made available under the terms of the GNU Public License v3.0. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . +#------------------------------------------------------------------------------- + +# +# Set up +# + +# context("mdPatternDS::arg::setup") + +set.standard.disclosure.settings() + +# +# Tests +# + +# context("mdPatternDS::arg::x NULL") +test_that("mdPatternDS x NULL", { + x <- NULL + + expect_error(mdPatternDS(x), "The input object must be of type 'data.frame' or 'matrix'. Current type: NULL") +}) + +# context("mdPatternDS::arg::x not valid variable") +test_that("mdPatternDS x not variable", { + x <- "not a variable" + + expect_error(mdPatternDS(x), "Object 'not a variable' does not exist on the server") +}) + +# +# Done +# + +# context("mdPatternDS::arg::shutdown") + +# context("mdPatternDS::arg::done") diff --git a/tests/testthat/test-disc-mdPatternDS.R b/tests/testthat/test-disc-mdPatternDS.R new file mode 100644 index 00000000..d10b004a --- /dev/null +++ b/tests/testthat/test-disc-mdPatternDS.R @@ -0,0 +1,69 @@ +#------------------------------------------------------------------------------- +# Copyright (c) 2025 ProPASS Consortium. All rights reserved. +# +# This program and the accompanying materials +# are made available under the terms of the GNU Public License v3.0. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . +#------------------------------------------------------------------------------- + +# +# Set up +# + +# context("mdPatternDS::disc::setup") + +set.standard.disclosure.settings() + +# +# Tests +# + +# context("mdPatternDS::disc::sample incomplete data.frame") +test_that("mdPatternDS: sample incomplete data.frame", { + x_val <- data.frame(v1 = c(0.0, NA, 2.0, 3.0, 4.0, 5.0, 6.0), v2 = c(6.0, 5.0, 4.0, 3.0, 2.0, 1.0, 0.0)) + x <- "x_val" + + res <- mdPatternDS(x) + + expect_length(res, 3) + expect_length(class(res), 1) + expect_true(all(class(res) %in% c("list"))) + expect_length(class(res$pattern), 2) + expect_true(all(class(res$pattern) %in% c("matrix", "array"))) + + expect_length(colnames(res$pattern), 3) + expect_equal(colnames(res$pattern)[1], "v2") + expect_equal(colnames(res$pattern)[2], "v1") + expect_equal(colnames(res$pattern)[3], "") + expect_length(rownames(res$pattern), 3) + expect_equal(rownames(res$pattern)[1], "6") + expect_equal(rownames(res$pattern)[2], "suppressed(<3)") + expect_equal(rownames(res$pattern)[3], "") + + expect_equal(res$pattern[1, 1], 1) + expect_equal(res$pattern[1, 2], 1) + expect_equal(res$pattern[1, 3], 0) + expect_true(is.na(res$pattern[2, 1])) + expect_true(is.na(res$pattern[2, 2])) + expect_true(is.na(res$pattern[2, 3])) + expect_true(is.na(res$pattern[3, 1])) + expect_true(is.na(res$pattern[3, 2])) + expect_true(is.na(res$pattern[3, 3])) + + expect_length(class(res$valid), 1) + expect_true(all(class(res$valid) %in% c("logical"))) + expect_false(res$valid) + expect_length(class(res$message), 1) + expect_true(all(class(res$message) %in% c("character"))) + expect_equal(res$message, "Invalid: some pattern counts below threshold (3) have been suppressed") +}) + +# +# Done +# + +# context("mdPatternDS::disc::shutdown") + +# context("mdPatternDS::disc::done") diff --git a/tests/testthat/test-perf-meanDS.R b/tests/testthat/test-perf-meanDS.R index 59266cb2..417e02db 100644 --- a/tests/testthat/test-perf-meanDS.R +++ b/tests/testthat/test-perf-meanDS.R @@ -1,5 +1,5 @@ #------------------------------------------------------------------------------- -# Copyright (c) 2024-2025 Arjuna Technologies, Newcastle upon Tyne. All rights reserved. +# Copyright (c) 2024-2026 Arjuna Technologies, Newcastle upon Tyne. All rights reserved. # # This program and the accompanying materials # are made available under the terms of the GNU Public License v3.0. @@ -30,7 +30,7 @@ test_that("numeric meanDS - performance", { input <- c(0.0, 1.0, 2.0, 3.0, 4.0) - .durationSec <- 30 # seconds + .durationSec <- perf.testduration(30) .count <- 0 .start.time <- Sys.time() .current.time <- .start.time @@ -65,7 +65,7 @@ test_that("numeric meanDS, with NA - performance", { input <- c(0.0, NA, 2.0, NA, 4.0) - .durationSec <- 30 # seconds + .durationSec <- perf.testduration(30) .count <- 0 .start.time <- Sys.time() .current.time <- .start.time diff --git a/tests/testthat/test-perf-varDS.R b/tests/testthat/test-perf-varDS.R index 10fff94a..15bd478a 100644 --- a/tests/testthat/test-perf-varDS.R +++ b/tests/testthat/test-perf-varDS.R @@ -30,7 +30,7 @@ test_that("numeric varDS - performance", { input <- c(0.0, 1.0, 2.0, 3.0, 4.0) - .durationSec <- 30 # seconds + .durationSec <- perf.testduration(30) .count <- 0 .start.time <- Sys.time() .current.time <- .start.time @@ -65,7 +65,7 @@ test_that("numeric varDS, with NA - performance", { input <- c(0.0, NA, 2.0, NA, 4.0) - .durationSec <- 30 # seconds + .durationSec <- perf.testduration(30) .count <- 0 .start.time <- Sys.time() .current.time <- .start.time diff --git a/tests/testthat/test-smk-dataFrameSubsetDS2.R b/tests/testthat/test-smk-dataFrameSubsetDS2.R index c93dc595..10ece1d2 100644 --- a/tests/testthat/test-smk-dataFrameSubsetDS2.R +++ b/tests/testthat/test-smk-dataFrameSubsetDS2.R @@ -13,7 +13,7 @@ # Set up # -# contect("gamlssDS::smk::setup") +# context("gamlssDS::smk::setup") set.standard.disclosure.settings() @@ -22,7 +22,7 @@ set.standard.disclosure.settings() # Tests # -# contect("dataFrameSubsetDS2::smk::test1") +# context("dataFrameSubsetDS2::smk::test1") test_that("test1 dataFrameSubsetDS2", { D <- as.data.frame(matrix(NA, nrow=20, ncol=3)) @@ -48,7 +48,7 @@ test_that("test1 dataFrameSubsetDS2", { }) -# contect("dataFrameSubsetDS2::smk::test2") +# context("dataFrameSubsetDS2::smk::test2") test_that("test2 dataFrameSubsetDS2", { D <- as.data.frame(matrix(NA, nrow=20, ncol=3)) @@ -75,6 +75,6 @@ test_that("test2 dataFrameSubsetDS2", { # Done # -# contect("dataFrameSubsetDS2::smk::shutdown") +# context("dataFrameSubsetDS2::smk::shutdown") -# contect("dataFrameSubsetDS2::smk::done") +# context("dataFrameSubsetDS2::smk::done") diff --git a/tests/testthat/test-smk-mdPatternDS.R b/tests/testthat/test-smk-mdPatternDS.R new file mode 100644 index 00000000..ba682b1e --- /dev/null +++ b/tests/testthat/test-smk-mdPatternDS.R @@ -0,0 +1,103 @@ +#------------------------------------------------------------------------------- +# Copyright (c) 2025 ProPASS Consortium. All rights reserved. +# +# This program and the accompanying materials +# are made available under the terms of the GNU Public License v3.0. +# +# You should have received a copy of the GNU General Public License +# along with this program. If not, see . +#------------------------------------------------------------------------------- + +# +# Set up +# + +# context("mdPatternDS::smk::setup") + +set.standard.disclosure.settings() + +# +# Tests +# + +# context("mdPatternDS::smk::sample 1 complete data.frame") +test_that("mdPatternDS: sample 1 complete data.frame", { + x_val <- data.frame(v1 = c(0.0, 1.0, 2.0, 3.0, 4.0), v2 = c(4.0, 3.0, 2.0, 1.0, 0.0)) + x <- "x_val" + + res <- mdPatternDS(x) + + expect_length(res, 3) + expect_length(class(res), 1) + expect_true(all(class(res) %in% c("list"))) + expect_length(class(res$pattern), 2) + expect_true(all(class(res$pattern) %in% c("matrix", "array"))) + + expect_length(colnames(res$pattern), 3) + expect_equal(colnames(res$pattern)[1], "v1") + expect_equal(colnames(res$pattern)[2], "v2") + expect_equal(colnames(res$pattern)[3], "") + expect_length(rownames(res$pattern), 2) + expect_equal(rownames(res$pattern)[1], "5") + expect_equal(rownames(res$pattern)[2], "") + + expect_equal(res$pattern[1, 1], 1) + expect_equal(res$pattern[1, 2], 1) + expect_equal(res$pattern[1, 3], 0) + expect_equal(res$pattern[2, 1], 0) + expect_equal(res$pattern[2, 2], 0) + expect_equal(res$pattern[2, 3], 0) + + expect_length(class(res$valid), 1) + expect_true(all(class(res$valid) %in% c("logical"))) + expect_true(res$valid) + expect_length(class(res$message), 1) + expect_true(all(class(res$message) %in% c("character"))) + expect_equal(res$message, "Valid: all pattern counts meet disclosure requirements") +}) + + +# context("mdPatternDS::smk::sample 2 complete data.frame") +test_that("mdPatternDS: sample 2 complete data.frame", { + x_val <- data.frame(v1 = c(0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0), v2 = c(9.0, 8.0, 7.0, 6.0, 5.0, 4.0, 3.0, 2.0, 1.0, 0.0)) + x <- "x_val" + + res <- mdPatternDS(x) + + expect_length(res, 3) + expect_length(class(res), 1) + expect_true(all(class(res) %in% c("list"))) + expect_length(class(res$pattern), 2) + expect_true(all(class(res$pattern) %in% c("matrix", "array"))) + + expect_length(colnames(res$pattern), 3) + expect_equal(colnames(res$pattern)[1], "v1") + expect_equal(colnames(res$pattern)[2], "v2") + expect_equal(colnames(res$pattern)[3], "") + expect_length(rownames(res$pattern), 2) + expect_equal(rownames(res$pattern)[1], "10") + expect_equal(rownames(res$pattern)[2], "") + expect_true(is.na(rownames(res$pattern)[3])) + + expect_equal(res$pattern[1, 1], 1) + expect_equal(res$pattern[1, 2], 1) + expect_equal(res$pattern[1, 3], 0) + expect_equal(res$pattern[2, 1], 0) + expect_equal(res$pattern[2, 2], 0) + expect_equal(res$pattern[2, 3], 0) + + expect_length(class(res$valid), 1) + expect_true(all(class(res$valid) %in% c("logical"))) + expect_true(res$valid) + expect_length(class(res$message), 1) + expect_true(all(class(res$message) %in% c("character"))) + expect_equal(res$message, "Valid: all pattern counts meet disclosure requirements") +}) + +# +# Done +# + +# context("mdPatternDS::smk::shutdown") + +# context("mdPatternDS::smk::done")