extract_signature {mistyR} | R 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 markers x 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 markers x 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 markers^2 x 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")

[Package mistyR version 1.2.1 Index]