Create a new BDData object

Source: R/AllGenerics.R, R/BDData-constructor.R

Initializes a new BDData object of benchmarking data.

Data sets are stored as BDData objects within BenchDesign objects as well as SummarizedBenchmark objects. However, because data is directly specified to the BenchDesign constructor, there is usually no need to call the BDData constructor to create completely new data objects.

The BDData constructor is most useful for extracting the data sets contained in BenchDesign objects as well as SummarizedBenchmark objects. By default, the BDData object stored in SummarizedBenchmark objects will be MD5 hashes rather than the complete original data set. compareBDData can be used to compare various forms of BDData, as shown in the examples below.

BDData(data)

# S4 method for ANY
BDData(data)

# S4 method for BenchDesign
BDData(data)

# S4 method for SummarizedBenchmark
BDData(data)

# S4 method for BDData
BDData(data)

Arguments

data

a list object of data or MD5 hash string

Value

BDData object

See also

BDData-class, BenchDesign

Examples

## construct from data.frame
datadf <- data.frame(x = 1:5, y = runif(5))
bdd_df <- BDData(datadf)
bdd_df
#> BenchDesign Data (BDData) ---------------------------------- 
#>   type: data 
#>   data:
#>   x         y
#> 1 1 0.4663935
#> 2 2 0.4977774
#> 3 3 0.2897672
#> 4 4 0.7328820
#> 5 5 0.7725215

## construct from MD5 hash of data.frame
bdd_md5 <- BDData(digest::digest(datadf))
bdd_md5
#> BenchDesign Data (BDData) ---------------------------------- 
#>   type: md5hash 
#>   MD5 hash: 13694a3b6b722e78f6abf214c5764168 

## compare two BDData objects 
compareBDData(bdd_df, bdd_md5)
#> $data
#> [1] TRUE
#> 
#> $type
#> [1] FALSE
#> 

## note that the data is the same, i.e. the MD5 hashes match, but the
## data types ("data" vs. "md5has") are different