Add description to other docs

R/calculate-clusters.R

@@ -1,6 +1,6 @@
 #' Calculate graph-based clusters from a provided matrix
 #'
-#' This function is provided to simplify application of bluster package clustering functions on OpenScPCA data.
+#' @description This function is provided to simplify application of bluster package clustering functions on OpenScPCA data.
 #' In particular, this function runs `bluster::clusterRows()` with the `bluster::NNGraphParam()` function on a
 #' principal components matrix, provided either directly or via single-cell object.
 #' Note that defaults for some arguments may differ from the `bluster::NNGraphParam()` defaults.
@@ -155,7 +155,7 @@ calculate_clusters <- function(
 #' Extract a principal components (PC) matrix from either a SingleCellExperiment
 #' or a Seurat object.
 #'
-#' This function first determines if the provided object is a SingleCellExperiment or
+#' @description This function first determines if the provided object is a SingleCellExperiment or
 #' Seurat object, and then extract the PC matrix. If no name for the PC matrix is provided,
 #' this function will use "PCA" for SingleCellExperiment objects, and
 #' "pca" for Seurat objects.

R/convert-gene-ids.R

@@ -1,6 +1,6 @@
 #' Convert Ensembl gene ids to gene symbols based on reference gene lists
 #'
-#' The SingleCellExperiment objects produced as part of ScPCA are indexed by
+#' @description The SingleCellExperiment objects produced as part of ScPCA are indexed by
 #' Ensembl gene ids, as those are more stable than gene symbols. However,
 #' for many applications gene symbols are useful. This function provides
 #' simple conversion of Ensembl gene ids to gene symbols based on either the
@@ -105,7 +105,7 @@ ensembl_to_symbol <- function(
 
 #' Set the row names of an ScPCA SingleCellExperiment object to gene symbols
 #'
-#' The SingleCellExperiment objects produced as part of ScPCA are indexed by
+#' @description The SingleCellExperiment objects produced as part of ScPCA are indexed by
 #' Ensembl gene ids, as those are more stable than gene symbols. However,
 #' for many applications gene symbols are useful. This function converts the
 #' row names (indexes) of a SingleCellExperiment object to gene symbols based on the

R/data.R

@@ -3,7 +3,7 @@
 #' Conversion table for Ensembl gene ids and gene symbols
 #'
 #'
-#' This table includes the mapping for gene ids to gene symbols from different
+#' @description This table includes the mapping for gene ids to gene symbols from different
 #' reference genome gene annotation lists.
 #' Included are the original gene symbols and the modified gene symbols that
 #' are created when running the `make.unique()` function, as is done when

R/evaluate-clusters.R

@@ -1,6 +1,6 @@
 #' Calculate the silhouette width of clusters
 #'
-#' This function uses the `bluster::approxSilhouette()` function to calculate the
+#' @description This function uses the `bluster::approxSilhouette()` function to calculate the
 #' silhouette width for a clustering result. These results can be used downstream to
 #' calculate the average silhouette width, a popular metric for cluster evaluation.
 #'
@@ -73,7 +73,7 @@ calculate_silhouette <- function(
 
 #' Calculate the neighborhood purity of clusters
 #'
-#' This function uses the `bluster::neighborPurity()` function to calculate the
+#' @description This function uses the `bluster::neighborPurity()` function to calculate the
 #' neighborhood purity values for a clustering result.
 #'
 #' @param x Either a matrix of principal components (PCs), or a SingleCellExperiment
@@ -142,7 +142,7 @@ calculate_purity <- function(
 
 #' Calculate cluster stability using the Adjusted Rand Index (ARI)
 #'
-#' This function generates and clusters, using provided parameters, bootstrap
+#' @description This function generates and clusters, using provided parameters, bootstrap
 #' replicates calculates the Adjusted Rand Index (ARI) between each set of bootstrapped
 #' clusters and the original provided clusters. ARI measures similarity between different
 #' cluster results, where a value of 0 indicates an entirely random relationship between

R/make-seurat.R

@@ -1,6 +1,6 @@
 #' Convert an SCE object to Seurat
 #'
-#' Converts an ScPCA SingleCellExperiment (SCE) object to Seurat format. This is
+#' @description Converts an ScPCA SingleCellExperiment (SCE) object to Seurat format. This is
 #' primarily a wrapper around Seurat::as.Seurat() with some additional steps to
 #' include ScPCA metadata and options for converting the feature index from
 #' Ensembl gene ids to gene symbols.

R/sum-duplicate-genes.R

@@ -1,6 +1,6 @@
 #' Sum counts for genes with duplicate names in a SingleCellExperiment object.
 #'
-#' Genes with the same name are merged by summing their raw expression counts.
+#' @description Genes with the same name are merged by summing their raw expression counts.
 #' When multiple Ensembl gene IDs are associated with the same gene symbol,
 #' identifier conversion can result in duplicate gene names. This function
 #' resolves such duplicates by summing the expression values for each duplicate