Browse code

fix documentation issues causeing warnig

Nick authored on 01/02/2023 23:24:44
Showing 7 changed files

... ...
@@ -176,8 +176,7 @@ setClassUnion("TransformParamsOrNULL", c("TransformParams", "NULL"))
176 176
 #' @usage NULL
177 177
 #' @section Constructor:
178 178
 #' \describe{
179
-#' \item{}{
180
-#' \code{TransformParams(transform, characteristics = DataFrame(), intermediate = character(0), ...)} 
179
+#' \item{\code{TransformParams(transform, characteristics = DataFrame(), intermediate = character(0), ...)}}{ 
181 180
 #' Creates a \code{TransformParams} object which stores the function which will do the
182 181
 #' transformation and parameters that the function will use.
183 182
 #' \describe{
... ...
@@ -196,9 +195,9 @@ setClassUnion("TransformParamsOrNULL", c("TransformParams", "NULL"))
196 195
 #' } } }
197 196
 #' 
198 197
 #' @section Summary:
199
-#' \code{transformParams} is a \code{TransformParams} object.
198
+
200 199
 #' \describe{
201
-#' \item{}{
200
+#' \item{\code{transformParams} is a \code{TransformParams} object.}{
202 201
 #'     \code{show(transformParams)}: Prints a short summary of what \code{transformParams} contains.
203 202
 #'  }}
204 203
 #' 
... ...
@@ -271,41 +270,31 @@ setClass("FeatureSetCollection", representation(sets = "list"))
271 270
 #' @docType class
272 271
 #' @usage NULL
273 272
 #' @section Constructor:
274
-#' \describe{\item{}{
275
-#' \code{FeatureSetCollection(sets)}}
276
-#' }
273
+#' 
274
+#' \describe{
275
+#' \item{\code{FeatureSetCollection(sets)}}{
277 276
 #' \describe{
278 277
 #' \item{\code{sets}}{A named list. The names of the list
279 278
 #' describe the sets and the elements of the list specify the features which
280 279
 #' comprise the sets.}
281 280
 #' }
281
+#' }}
282 282
 #' @section Summary:
283
-#' \code{featureSets} is a \code{FeatureSetCollection} object.
284 283
 #' 
285 284
 #' \describe{
286
-#'   \item{}{
287
-#'     \code{show(featureSets)}: Prints a short summary of what \code{featureSets} contains.
288
-#'    }
289
-#'   \item{}{
285
+#'   \item{\code{featureSets} is a \code{FeatureSetCollection} object.}{
286
+#'     \code{show(featureSets)}: Prints a short summary of what \code{featureSets} contains.\cr
290 287
 #'     \code{length(featureSets)}: Prints how many sets of features there are.
291
-#'    }  
288
+#'    }
292 289
 #' }
293 290
 #' @section Subsetting:
294 291
 #' The \code{FeatureSetCollection} may be subsetted to a smaller set of elements or a single set
295 292
 #' may be extracted as a vector.
296
-#'  \code{featureSets} is a \code{FeatureSetCollection} object.
297 293
 #'  \describe{
298
-#'  \item{}{
299
-#'    \code{featureSets[i:j]}:
300
-#'      Reduces the object to a subset of the feature sets between elements \code{i} and \code{j}
301
-#'      of the collection.
302
-#'  }
303
-#'  \item{}{
304
-#'    \code{featureSets[[i]]}:
305
-#'      Extract the feature set identified by \code{i}. \code{i} may be a numeric index
306
-#'      or the character name of a feature set.
307
-#'    }    
308
-#'  }
294
+#'  \item{\code{featureSets} is a \code{FeatureSetCollection} object.}{
295
+#'    \code{featureSets[i:j]}: Reduces the object to a subset of the feature sets between elements \code{i} and \code{j} of the collection.\cr
296
+#'    \code{featureSets[[i]]}: Extract the feature set identified by \code{i}. \code{i} may be a numeric index or the character name of a feature set.
297
+#'  }}
309 298
 #' @author Dario Strbenac
310 299
 #' @examples
311 300
 #' 
... ...
@@ -484,36 +473,22 @@ setClassUnion("SelectParamsOrNULL", c("SelectParams", "NULL"))
484 473
 #' @docType class
485 474
 #' @section Constructor:
486 475
 #' \describe{
487
-#' \item{}{\preformatted{SelectParams(featureRanking, characteristics = DataFrame(), minPresence = 1, intermediate = character(0),
488
-#' subsetToSelections = TRUE, tuneParams = list(nFeatures = seq(10, 100, 10), performanceType = "Balanced Accuracy"), ...)} Creates a \code{SelectParams}
489
-#' object which stores the function(s) which will do the selection and parameters that the
490
-#' function will use.
491
-#' \describe{\item{\code{featureRanking}}{A character keyword referring to a registered feature ranking function. See \code{\link{available}}
492
-#' for valid keywords.}
493
-#' \item{\code{characteristics}}{A \code{\link{DataFrame}} describing the characteristics
494
-#' of feature selection to be done. First column must be named \code{"charateristic"} and
495
-#' second column must be named \code{"value"}. If using wrapper functions for feature
496
-#' selection in this package, the feature selection name will automatically be
497
-#' generated and therefore it is not necessary to specify it.}
498
-#' \item{\code{minPresence}}{If a list of functions was provided, how many of
499
-#' those must a feature have been selected by to be used in classification. 1
500
-#' is equivalent to a set union and a number the same length as
501
-#' \code{featureSelection} is equivalent to set intersection.}
502
-#' \item{\code{intermediate}}{Character vector. Names of any variables created
503
-#' in prior stages by \code{\link{runTest}} that need to be passed to a feature
504
-#' selection function.}
505
-#' \item{\code{subsetToSelections}}{Whether to subset the data table(s), after feature selection has been done.}
506
-#' \item{\code{tuneParams}}{A list specifying tuning parameters required during feature selection. The names of
507
-#' the list are the names of the parameters and the vectors are the values of the parameters to try. All possible
508
-#' combinations are generated. Two elements named \code{nFeatures} and \code{performanceType} are mandatory, to
509
-#' define the performance metric which will be used to select features and how many top-ranked features to try.}
510
-#' \item{\code{...}}{Other named parameters which will be used by the
511
-#' selection function. If \code{featureSelection} was a list of functions,
512
-#' this must be a list of lists, as long as \code{featureSelection}.} } } }
476
+#' \item
477
+#'     {\preformatted{SelectParams(featureRanking, characteristics = DataFrame(), minPresence = 1, intermediate = character(0),subsetToSelections = TRUE, tuneParams = list(nFeatures = seq(10, 100, 10), performanceType = "Balanced Accuracy"), ...)}}
478
+#'     {Creates a \code{SelectParams} object which stores the function(s) which will do the selection and parameters that the function will use.\cr
479
+#'     \describe{
480
+#'         \item{\code{featureRanking}}{A character keyword referring to a registered feature ranking function. See \code{\link{available}} for valid keywords.}
481
+#'         \item{\code{characteristics}}{A \code{\link{DataFrame}} describing the characteristics of feature selection to be done. First column must be named \code{"charateristic"} and second column must be named \code{"value"}. If using wrapper functions for feature selection in this package, the feature selection name will automatically be generated and therefore it is not necessary to specify it.}
482
+#'         \item{\code{minPresence}}{If a list of functions was provided, how many of those must a feature have been selected by to be used in classification. 1 is equivalent to a set union and a number the same length as \code{featureSelection} is equivalent to set intersection.}
483
+#'         \item{\code{intermediate}}{Character vector. Names of any variables created in prior stages by \code{\link{runTest}} that need to be passed to a feature selection function.}
484
+#'         \item{\code{subsetToSelections}}{Whether to subset the data table(s), after feature selection has been done.}
485
+#'         \item{\code{tuneParams}}{A list specifying tuning parameters required during feature selection. The names of the list are the names of the parameters and the vectors are the values of the parameters to try. All possible combinations are generated. Two elements named \code{nFeatures} and \code{performanceType} are mandatory, to define the performance metric which will be used to select features and how many top-ranked features to try.}
486
+#'         \item{\code{...}}{Other named parameters which will be used by the selection function. If \code{featureSelection} was a list of functions, this must be a list of lists, as long as \code{featureSelection}.}}
487
+#'     }
488
+#' }
513 489
 #' @section Summary:
514
-#' \code{selectParams} is a \code{SelectParams} object.
515 490
 #' \describe{
516
-#' \item{}{
491
+#' \item{\code{selectParams} is a \code{SelectParams} object.}{
517 492
 #'   \code{show(SelectParams)}: Prints a short summary of what \code{selectParams} contains.
518 493
 #' }}
519 494
 #' @author Dario Strbenac
... ...
@@ -605,8 +580,8 @@ setClass("TrainParams", representation(
605 580
 #' @docType class
606 581
 #' @section Constructor:
607 582
 #' \describe{
608
-#' \item{}{\preformatted{TrainParams(classifier, balancing = c("downsample", "upsample", "none"), characteristics = DataFrame(),
609
-#' intermediate = character(0), tuneParams = NULL, getFeatures = NULL, ...)}
583
+#' \item{\preformatted{TrainParams(classifier, balancing = c("downsample", "upsample", "none"), characteristics = DataFrame(),
584
+#' intermediate = character(0), tuneParams = NULL, getFeatures = NULL, ...)}}{
610 585
 #' Creates a \code{TrainParams} object which stores the function which will do the
611 586
 #' classifier building and parameters that the function will use.
612 587
 #' \describe{
... ...
@@ -633,9 +608,8 @@ setClass("TrainParams", representation(
633 608
 #' features.}
634 609
 #' \item{\code{...}}{Other named parameters which will be used by the classifier.} } } }
635 610
 #' @section Summary:
636
-#' \code{trainParams} is a \code{TrainParams} object.
637 611
 #' \describe{
638
-#' \item{}{
612
+#' \item{\code{trainParams} is a \code{TrainParams} object.}{
639 613
 #'   \code{show(trainParams)}: Prints a short summary of what \code{trainParams} contains.
640 614
 #' }}
641 615
 #' @author Dario Strbenac
... ...
@@ -719,9 +693,10 @@ setClass("PredictParams", representation(
719 693
 #' @aliases PredictParams PredictParams-class PredictParams,missing-method
720 694
 #' PredictParams,characterOrFunction-method show,PredictParams-method
721 695
 #' @docType class
722
-#' @section Constructor: \describe{\item{}{
723
-#' \code{PredictParams(predictor, characteristics = DataFrame(), intermediate =
724
-#' character(0), ...)} Creates a PredictParams object which stores the function
696
+#' @section Constructor: 
697
+#' \describe{
698
+#' \item{\code{PredictParams(predictor, characteristics = DataFrame(), intermediate = character(0), ...)}}{
699
+#' Creates a PredictParams object which stores the function
725 700
 #' which will do the class prediction, if required, and parameters that the
726 701
 #' function will use. If the training function also makes predictions, this
727 702
 #' must be set to \code{NULL}.}
... ...
@@ -735,9 +710,8 @@ setClass("PredictParams", representation(
735 710
 #' passed to the prediction function.}
736 711
 #' \item{\code{...}}{Other arguments that \code{predictor} may use.} } }
737 712
 #' @section Summary:
738
-#' \code{predictParams} is a \code{PredictParams} object.
739 713
 #' \describe{
740
-#' \item{}{
714
+#' \item{\code{predictParams} is a \code{PredictParams} object.}{
741 715
 #'   \code{show(predictParams)}: Prints a short summary of what \code{predictParams} contains.
742 716
 #' }}
743 717
 #' @author Dario Strbenac
... ...
@@ -905,9 +879,8 @@ setClassUnion("ModellingParamsOrNULL", c("ModellingParams", "NULL"))
905 879
 #' }
906 880
 #' 
907 881
 #' @section Summary:
908
-#' \code{result} is a \code{ClassifyResult} object.
909 882
 #' \describe{
910
-#' \item{}{
883
+#' \item{\code{result} is a \code{ClassifyResult} object.}{
911 884
 #'     \code{show(result)}: Prints a short summary of what \code{result} contains.
912 885
 #' }}
913 886
 #' 
... ...
@@ -68,9 +68,8 @@ most popular value of the parameter in cross-validation is used.}
68 68
 
69 69
 \section{Summary}{
70 70
 
71
-\code{result} is a \code{ClassifyResult} object.
72 71
 \describe{
73
-\item{}{
72
+\item{\code{result} is a \code{ClassifyResult} object.}{
74 73
     \code{show(result)}: Prints a short summary of what \code{result} contains.
75 74
 }}
76 75
 }
... ...
@@ -18,27 +18,25 @@ binary interactions (i.e. Two-column matrix of feature identifiers).
18 18
 }
19 19
 \section{Constructor}{
20 20
 
21
-\describe{\item{}{
22
-\code{FeatureSetCollection(sets)}}
23
-}
21
+
22
+\describe{
23
+\item{\code{FeatureSetCollection(sets)}}{
24 24
 \describe{
25 25
 \item{\code{sets}}{A named list. The names of the list
26 26
 describe the sets and the elements of the list specify the features which
27 27
 comprise the sets.}
28 28
 }
29
+}}
29 30
 }
30 31
 
31 32
 \section{Summary}{
32 33
 
33
-\code{featureSets} is a \code{FeatureSetCollection} object.
34 34
 
35 35
 \describe{
36
-  \item{}{
37
-    \code{show(featureSets)}: Prints a short summary of what \code{featureSets} contains.
38
-   }
39
-  \item{}{
36
+  \item{\code{featureSets} is a \code{FeatureSetCollection} object.}{
37
+    \code{show(featureSets)}: Prints a short summary of what \code{featureSets} contains.\cr
40 38
     \code{length(featureSets)}: Prints how many sets of features there are.
41
-   }  
39
+   }
42 40
 }
43 41
 }
44 42
 
... ...
@@ -46,19 +44,11 @@ comprise the sets.}
46 44
 
47 45
 The \code{FeatureSetCollection} may be subsetted to a smaller set of elements or a single set
48 46
 may be extracted as a vector.
49
- \code{featureSets} is a \code{FeatureSetCollection} object.
50 47
  \describe{
51
- \item{}{
52
-   \code{featureSets[i:j]}:
53
-     Reduces the object to a subset of the feature sets between elements \code{i} and \code{j}
54
-     of the collection.
55
- }
56
- \item{}{
57
-   \code{featureSets[[i]]}:
58
-     Extract the feature set identified by \code{i}. \code{i} may be a numeric index
59
-     or the character name of a feature set.
60
-   }    
61
- }
48
+ \item{\code{featureSets} is a \code{FeatureSetCollection} object.}{
49
+   \code{featureSets[i:j]}: Reduces the object to a subset of the feature sets between elements \code{i} and \code{j} of the collection.\cr
50
+   \code{featureSets[[i]]}: Extract the feature set identified by \code{i}. \code{i} may be a numeric index or the character name of a feature set.
51
+ }}
62 52
 }
63 53
 
64 54
 \examples{
... ...
@@ -19,9 +19,10 @@ to the levels of the class vector of the input data set, or a data frame
19 19
 which has two columns named class and score.
20 20
 }
21 21
 \section{Constructor}{
22
- \describe{\item{}{
23
-\code{PredictParams(predictor, characteristics = DataFrame(), intermediate =
24
-character(0), ...)} Creates a PredictParams object which stores the function
22
+ 
23
+\describe{
24
+\item{\code{PredictParams(predictor, characteristics = DataFrame(), intermediate = character(0), ...)}}{
25
+Creates a PredictParams object which stores the function
25 26
 which will do the class prediction, if required, and parameters that the
26 27
 function will use. If the training function also makes predictions, this
27 28
 must be set to \code{NULL}.}
... ...
@@ -38,9 +39,8 @@ passed to the prediction function.}
38 39
 
39 40
 \section{Summary}{
40 41
 
41
-\code{predictParams} is a \code{PredictParams} object.
42 42
 \describe{
43
-\item{}{
43
+\item{\code{predictParams} is a \code{PredictParams} object.}{
44 44
   \code{show(predictParams)}: Prints a short summary of what \code{predictParams} contains.
45 45
 }}
46 46
 }
... ...
@@ -16,39 +16,25 @@ feature selection. The empty constructor is provided for convenience.
16 16
 \section{Constructor}{
17 17
 
18 18
 \describe{
19
-\item{}{\preformatted{SelectParams(featureRanking, characteristics = DataFrame(), minPresence = 1, intermediate = character(0),
20
-subsetToSelections = TRUE, tuneParams = list(nFeatures = seq(10, 100, 10), performanceType = "Balanced Accuracy"), ...)} Creates a \code{SelectParams}
21
-object which stores the function(s) which will do the selection and parameters that the
22
-function will use.
23
-\describe{\item{\code{featureRanking}}{A character keyword referring to a registered feature ranking function. See \code{\link{available}}
24
-for valid keywords.}
25
-\item{\code{characteristics}}{A \code{\link{DataFrame}} describing the characteristics
26
-of feature selection to be done. First column must be named \code{"charateristic"} and
27
-second column must be named \code{"value"}. If using wrapper functions for feature
28
-selection in this package, the feature selection name will automatically be
29
-generated and therefore it is not necessary to specify it.}
30
-\item{\code{minPresence}}{If a list of functions was provided, how many of
31
-those must a feature have been selected by to be used in classification. 1
32
-is equivalent to a set union and a number the same length as
33
-\code{featureSelection} is equivalent to set intersection.}
34
-\item{\code{intermediate}}{Character vector. Names of any variables created
35
-in prior stages by \code{\link{runTest}} that need to be passed to a feature
36
-selection function.}
37
-\item{\code{subsetToSelections}}{Whether to subset the data table(s), after feature selection has been done.}
38
-\item{\code{tuneParams}}{A list specifying tuning parameters required during feature selection. The names of
39
-the list are the names of the parameters and the vectors are the values of the parameters to try. All possible
40
-combinations are generated. Two elements named \code{nFeatures} and \code{performanceType} are mandatory, to
41
-define the performance metric which will be used to select features and how many top-ranked features to try.}
42
-\item{\code{...}}{Other named parameters which will be used by the
43
-selection function. If \code{featureSelection} was a list of functions,
44
-this must be a list of lists, as long as \code{featureSelection}.} } } }
19
+\item
20
+    {\preformatted{SelectParams(featureRanking, characteristics = DataFrame(), minPresence = 1, intermediate = character(0),subsetToSelections = TRUE, tuneParams = list(nFeatures = seq(10, 100, 10), performanceType = "Balanced Accuracy"), ...)}}
21
+    {Creates a \code{SelectParams} object which stores the function(s) which will do the selection and parameters that the function will use.\cr
22
+    \describe{
23
+        \item{\code{featureRanking}}{A character keyword referring to a registered feature ranking function. See \code{\link{available}} for valid keywords.}
24
+        \item{\code{characteristics}}{A \code{\link{DataFrame}} describing the characteristics of feature selection to be done. First column must be named \code{"charateristic"} and second column must be named \code{"value"}. If using wrapper functions for feature selection in this package, the feature selection name will automatically be generated and therefore it is not necessary to specify it.}
25
+        \item{\code{minPresence}}{If a list of functions was provided, how many of those must a feature have been selected by to be used in classification. 1 is equivalent to a set union and a number the same length as \code{featureSelection} is equivalent to set intersection.}
26
+        \item{\code{intermediate}}{Character vector. Names of any variables created in prior stages by \code{\link{runTest}} that need to be passed to a feature selection function.}
27
+        \item{\code{subsetToSelections}}{Whether to subset the data table(s), after feature selection has been done.}
28
+        \item{\code{tuneParams}}{A list specifying tuning parameters required during feature selection. The names of the list are the names of the parameters and the vectors are the values of the parameters to try. All possible combinations are generated. Two elements named \code{nFeatures} and \code{performanceType} are mandatory, to define the performance metric which will be used to select features and how many top-ranked features to try.}
29
+        \item{\code{...}}{Other named parameters which will be used by the selection function. If \code{featureSelection} was a list of functions, this must be a list of lists, as long as \code{featureSelection}.}}
30
+    }
31
+}
45 32
 }
46 33
 
47 34
 \section{Summary}{
48 35
 
49
-\code{selectParams} is a \code{SelectParams} object.
50 36
 \describe{
51
-\item{}{
37
+\item{\code{selectParams} is a \code{SelectParams} object.}{
52 38
   \code{show(SelectParams)}: Prints a short summary of what \code{selectParams} contains.
53 39
 }}
54 40
 }
... ...
@@ -15,8 +15,8 @@ The empty constructor is provided for convenience.
15 15
 \section{Constructor}{
16 16
 
17 17
 \describe{
18
-\item{}{\preformatted{TrainParams(classifier, balancing = c("downsample", "upsample", "none"), characteristics = DataFrame(),
19
-intermediate = character(0), tuneParams = NULL, getFeatures = NULL, ...)}
18
+\item{\preformatted{TrainParams(classifier, balancing = c("downsample", "upsample", "none"), characteristics = DataFrame(),
19
+intermediate = character(0), tuneParams = NULL, getFeatures = NULL, ...)}}{
20 20
 Creates a \code{TrainParams} object which stores the function which will do the
21 21
 classifier building and parameters that the function will use.
22 22
 \describe{
... ...
@@ -46,9 +46,8 @@ features.}
46 46
 
47 47
 \section{Summary}{
48 48
 
49
-\code{trainParams} is a \code{TrainParams} object.
50 49
 \describe{
51
-\item{}{
50
+\item{\code{trainParams} is a \code{TrainParams} object.}{
52 51
   \code{show(trainParams)}: Prints a short summary of what \code{trainParams} contains.
53 52
 }}
54 53
 }
... ...
@@ -14,8 +14,7 @@ Collects and checks necessary parameters required for transformation within CV.
14 14
 \section{Constructor}{
15 15
 
16 16
 \describe{
17
-\item{}{
18
-\code{TransformParams(transform, characteristics = DataFrame(), intermediate = character(0), ...)} 
17
+\item{\code{TransformParams(transform, characteristics = DataFrame(), intermediate = character(0), ...)}}{ 
19 18
 Creates a \code{TransformParams} object which stores the function which will do the
20 19
 transformation and parameters that the function will use.
21 20
 \describe{
... ...
@@ -36,9 +35,8 @@ function.}
36 35
 
37 36
 \section{Summary}{
38 37
 
39
-\code{transformParams} is a \code{TransformParams} object.
40 38
 \describe{
41
-\item{}{
39
+\item{\code{transformParams} is a \code{TransformParams} object.}{
42 40
     \code{show(transformParams)}: Prints a short summary of what \code{transformParams} contains.
43 41
  }}
44 42
 }