Skip to content

Commit

Permalink
adjust .Rd title tags for renamed functions
Browse files Browse the repository at this point in the history
  • Loading branch information
the-mayer committed Oct 14, 2024
1 parent 70f0de8 commit 392775d
Show file tree
Hide file tree
Showing 12 changed files with 46 additions and 13 deletions.
27 changes: 27 additions & 0 deletions R/assign_job_queue.R
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,9 @@
# file.path(common_root, "molevol_scripts", "R", "assignJobQueue.R")
common_root <- Sys.getenv("COMMON_SRC_ROOT")

#' mapOption2Process
#'
#' @description
#' Construct list where names (MolEvolvR advanced options) point to processes
#'
#' @return list where names (MolEvolvR advanced options) point to processes
Expand All @@ -22,6 +25,9 @@ mapOption2Process <- function() {
return(opts2processes)
}

#' mapAdvOption2Process
#'
#' @description
#' Use MolEvolvR advanced options to get associated processes
#'
#' @param advanced_opts character vector of MolEvolvR advanced options
Expand All @@ -44,6 +50,9 @@ mapAdvOption2Process <- function(advanced_opts) {
return(procs)
}

#' calculateProcessRuntime
#'
#' @description
#' Scrape MolEvolvR logs and calculate median processes
#'
#' @param dir_job_results [chr] path to MolEvolvR job_results
Expand Down Expand Up @@ -104,6 +113,9 @@ calculateProcessRuntime <- function(dir_job_results) {
return(list_proc_medians)
}

#' writeProcessRuntime2TSV
#'
#' @description
#' Write a table of 2 columns: 1) process and 2) median seconds
#'
#' @param dir_job_results [chr] path to MolEvolvR job_results
Expand Down Expand Up @@ -136,6 +148,9 @@ writeProcessRuntime2TSV <- function(dir_job_results, filepath) {
return(df_proc_medians)
}

#' writeProcessRuntime2YML
#'
#' @description
#' Compute median process runtimes, then write a YAML list of the processes and
#' their median runtimes in seconds to the path specified by 'filepath'.
#'
Expand All @@ -162,6 +177,9 @@ writeProcessRuntime2YML <- function(dir_job_results, filepath = NULL) {
yaml::write_yaml(medians, filepath)
}

#' getProcessRuntimeWeights
#'
#' @description
#' Quickly get the runtime weights for MolEvolvR backend processes
#'
#' @param dir_job_results [chr] path to MolEvolvR job_results
Expand Down Expand Up @@ -213,6 +231,9 @@ getProcessRuntimeWeights <- function(medians_yml_path = NULL) {
return(proc_weights)
}

#' calculateEstimatedWallTimeFromOpts
#'
#' @description
#' Given MolEvolvR advanced options and number of inputs,
#' calculate the total estimated walltime for the job
#'
Expand Down Expand Up @@ -279,6 +300,9 @@ calculateEstimatedWallTimeFromOpts <- function(advanced_opts,
}


#' assignJobQueue
#'
#' @description
#' Decision function to assign job queue
#'
#' @param t_sec_estimate estimated number of seconds a job will process
Expand All @@ -301,6 +325,9 @@ assignJobQueue <- function(
return(queue)
}

#' plotEstimatedWallTimes
#'
#' @description
#' Plot the estimated runtimes for different advanced options and number
#' of inputs
#'
Expand Down
3 changes: 3 additions & 0 deletions R/create_lineage_lookup.R
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
# library(biomartr)


#' createLineageLookup
#'
#' @description
#' Create a look up table that goes from TaxID, to Lineage
#'
#' @author Samuel Chen
Expand Down
2 changes: 1 addition & 1 deletion man/assignJobQueue.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 1 addition & 2 deletions man/calculateEstimatedWallTimeFromOpts.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/calculateProcessRuntime.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/createLineageLookup.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/getProcessRuntimeWeights.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/mapAdvOption2Process.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/mapOption2Process.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 4 additions & 2 deletions man/plotEstimatedWallTimes.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion man/writeProcessRuntime2TSV.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 4 additions & 2 deletions man/writeProcessRuntime2YML.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit 392775d

Please sign in to comment.