| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | % Generated by roxygen2: do not edit by hand | 
					
						
							|  |  |  | % Please edit documentation in R/validate.R | 
					
						
							|  |  |  | \name{validate} | 
					
						
							|  |  |  | \alias{validate} | 
					
						
							| 
									
										
										
										
											2022-01-26 11:38:39 +01:00
										 |  |  | \title{Perform cross-validation for the ranking.} | 
					
						
							| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | \usage{ | 
					
						
							| 
									
										
										
										
											2022-01-26 11:38:39 +01:00
										 |  |  | validate(ranking, reference_gene_ids, method_ids, progress = NULL) | 
					
						
							| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | } | 
					
						
							|  |  |  | \arguments{ | 
					
						
							| 
									
										
										
										
											2022-01-26 11:38:39 +01:00
										 |  |  | \item{ranking}{The ranking to validate.} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | \item{reference_gene_ids}{The reference gene IDs whose ranking should be | 
					
						
							|  |  |  | validated.} | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | \item{method_ids}{IDs of the methods that were used.} | 
					
						
							| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | \item{progress}{An optional progress function that should accept a single | 
					
						
							|  |  |  | value between 0.0 and 1.0 for progress information.} | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | \value{ | 
					
						
							| 
									
										
										
										
											2022-01-26 11:38:39 +01:00
										 |  |  | A validation object with the following items: | 
					
						
							|  |  |  | \describe{ | 
					
						
							|  |  |  | \item{\code{validation}}{A \code{data.table} containing percentiles of the | 
					
						
							|  |  |  | comparison genes from the original ranking as well as their validation. | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | \item{\code{mean_score}}{The mean score of the genes.} | 
					
						
							|  |  |  | \item{\code{mean_percentile_original}}{The mean percentile of the genes in | 
					
						
							|  |  |  | the original ranking. | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | \item{\code{mean_percentile_validation}}{The mean percentile of the genes | 
					
						
							|  |  |  | when optimizing without themselves. | 
					
						
							|  |  |  | } | 
					
						
							|  |  |  | \item{\code{mean_error}}{The mean absolute error.} | 
					
						
							|  |  |  | } | 
					
						
							| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | } | 
					
						
							|  |  |  | \description{ | 
					
						
							| 
									
										
										
										
											2022-01-26 11:38:39 +01:00
										 |  |  | This function reoptimizes the ranking leaving out one of the original | 
					
						
							| 
									
										
										
										
											2021-12-06 10:50:18 +01:00
										 |  |  | reference genes at a time. | 
					
						
							|  |  |  | } |