deltaEnergy {DSWE} | R Documentation |

## Energy decomposition for wind turbine performance comparison

### Description

Energy decomposition compares energy production from two datasets and separates it into turbine effects (deltaE.turb) and weather/environment effects (deltaE.weather).

### Usage

```
deltaEnergy(
data,
powercol,
timecol = 0,
xcol,
sync.method = "minimum power",
imput = TRUE,
vcol = NULL,
vrange = NULL,
rated.power = NULL,
sample = TRUE,
size = 2500,
timestamp.min = 10
)
```

### Arguments

`data` |
A list of two data sets to be compared. A difference is always computed as (data2 - data1). |

`powercol` |
A numeric stating the column number of power production. |

`timecol` |
A numeric stating the column number of data time stamp. Default value is zero. A value other than zero should be provided when |

`xcol` |
A numeric or vector stating the column number(s) of power curve input covariates/features (environmental or weather variables are recommended). |

`sync.method` |
A string specifying data synchronization method. Default value |

`imput` |
A boolean (TRUE/FALSE) indicating whether power imputation should be performed before calculating energy decomposition. The recommended and default value is TRUE. Change to FALSE when data have been preprocessed or imputed before.#' @param vcol A numeric stating the column number of wind speed. It is required when |

`vcol` |
A numeric stating the column number of wind speed. |

`vrange` |
A vector of cut-in, rated, and cut-out wind speed. Values should be provided when |

`rated.power` |
A numerical value stating the wind turbine rated power. |

`sample` |
A boolean (TRUE/FALSE) indicating whether to use sample or the whole data sets to train the power curve to be used for power imputation. Default value is TRUE. It is only used when |

`size` |
A numeric stating the size of sample when |

`timestamp.min` |
A numerical value stating the resolution of the datasets in minutes. It is the difference between two consecutive time stamps at which data were recorded. Default value is 10. |

### Value

a list containing :

deltaE.turb - A numeric,

deltaE.weather - A numeric,

deltaE.hat - A numeric,

deltaE.obs - A numeric,

estimated.energy - A numeric vector of the total energy calculated from each of f1(x2), f1(x1), f2(x2), f1(x2). If power is in kW, these values will be in kWh.

data - A list of two datasets used to calculate energy decomposition, i.e. synchronized. When

`imput = TRUE`

, the power column is the result from imputation.

### References

Latiffianti, E, Ding, Y, Sheng, S, Williams, L, Morshedizadeh, M, Rodgers, M (2022). "Analysis of leading edge protection application on wind turbine performance through energy and power decomposition approaches". Wind Energy. 2022; 1-19. doi:10.1002/we.2722.

### Examples

```
data = list(data1[1:50,], data2[1:60,])
powercol = 7
timecol = 1
xcol = c(2:6)
sync.method = 'time'
imput = TRUE
vcol = 2
vrange = c(5,12,25)
rated.power = 100
sample = FALSE
Decomposition = deltaEnergy(data, powercol, timecol, xcol, sync.method, imput,
vcol, vrange, rated.power, sample)
```

*DSWE*version 1.8.2 Index]