extract_signature: Extract signatures from the results

View source: R/utils.R

extract_signatureR Documentation

Extract signatures from the results

Description

Signature is a representation of each sample in the space of mistyR results.

Usage

extract_signature(
  misty.results,
  type = c("performance", "contribution", "importance"),
  trim = -Inf,
  trim.measure = c("gain.R2", "multi.R2", "intra.R2", "gain.RMSE", "multi.RMSE",
    "intra.RMSE")
)

Arguments

misty.results

a results list generated by collect_results().

type

type of signature to extract from the results.

trim

display targets with performance value above (if R2 or gain) or below (otherwise) this value only.

trim.measure

the measure used for trimming.

Details

The performance signature of each sample is a concatenation of the estimated values of variance explained using only the intraview, the variance explained by the multiview model and the gain in variance explained for each marker. The performance signature vector for each sample available in misty.results is of length \textrm{markers} \cdot 3.

The contribution signature of each sample is a concatenation of the estimated fraction of contribution of each view for each marker. The contribution signature vector for each sample available in misty.results is of length \textrm{markers} \cdot \textrm{views}.

The importance signature of each sample is a concatenation of the estimated and weighted importances for each predictor-target marker pair from all views. The importance signature vector for each sample available in misty.results is of length \textrm{markers}^2 \cdot \textrm{views}.

Value

A table with one row per sample from misty.results representing its signature.

See Also

collect_results() to generate a results list from raw results.

Examples

library(dplyr)

misty.results <-
  list.files("results", full.names = TRUE) %>% collect_results()

extract_signature(misty.results, "performance")

saezlab/mistyR documentation built on March 25, 2024, 4:12 p.m.