# predictPairSummary: Returns the row indices, correct answer, and predictions for... In heuristica: Heuristics Including Take the Best and Unit-Weight Linear

## Description

This makes it easy to see and evaluate predictions for all row pairs on a data set. It is intended for beginners. Advanced users can get more fine-grained control with rowPairApply.

## Usage

 `1` ```predictPairSummary(test_data, ...) ```

## Arguments

 `test_data` Data to try to predict. Must have same criterion column and cols_to_fit as the data heuristics were fit to. `...` One or more heuristics already fitted to data, e.g. the output of ttbModel.

## Value

A matrix with output for indices, the correct row pair answer, and predictions for each heuristic with as many rows as row pairs in the data. The columns names are Row1, Row2, CorrectGreater, and each heuristic fit_name (which is its class name by default, e.g. ttbModel).

`rowPairApply` for full flexibility.
 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27``` ```# Get some data and fit it with two models. train_df <- data.frame(criterion=c(9,8,7,6), a=c(101,101,2,2), b=c(59,58,5,59)) criterion_col <- 1 ttb <- ttbModel(train_df, criterion_col, c(2:3)) lreg <- logRegModel(train_df, criterion_col, c(2:3)) # Generate predictions and correct answers with predictPairSummary. out <- predictPairSummary(train_df, ttb, lreg) # Find rows where the models make differing predictions, subsetting on a # data.frame. out_df <- data.frame(out) out_df[out_df\$ttbModel != out_df\$logRegModel,] # Outputs: # Row1 Row2 CorrectGreater ttbModel logRegModel # 1 2 1 1 -1 # 3 4 1 -1 1 # So there are only two cases of differing predictions. # 1) For row 1 vs. 2, TTB predicted 1 and logReg predicted -1. # CorrectGreater says 1, so TTB was right. # 2) For row 3 vs. 4, TTB predicted -1 and logReg predicted 1. # CorrectGreater says -1, so logReg was right. # Note that under the hood, the above predictPairSummary call could be # done with rowPairApply like this: out2 <- rowPairApply(train_df, rowIndexes(), correctGreater(criterion_col), heuristics(ttb, lreg)) ```