# co2 data example

In this example, we use a real dataset and apply a customised covariance kernel. See the documentation of the package for a description of this dataset.

## Loading co2 data

library(GPFDA)
data(co2, package = "GPFDA")

For visualisation purposes, we will use only the first five years of the sample.

y <- c(t(data.matrix(co2[1:5, 1:12])))
n <- length(y)
input <- 5*(1:n)/n
whichNeg <- (y<0) # removing negative values
y <- y[!whichNeg]
input <- input[!whichNeg]

We want to fit a GPR model using the observed data and then make predictions at a $$1000$$ equally spaced time points:

inputNew <- 5*seq(1/n, 1, length.out=1000) # input test for prediction

## Using exponential covariance kernel

We will first fit a GPR model with a linear trend line for the mean function by setting meanModel='t', and a exponential covariance function by setting Cov='pow.ex' and gamma=1.

set.seed(789)
fit1 <- gpr(input=input, response=y, Cov='pow.ex', gamma=1, meanModel='t',
nInitCandidates=50, trace=2)
sapply(fit1\$hyper, exp)
#>  pow.ex.v  pow.ex.w        vv
#> 3.330e+00 2.483e+00 3.162e-09

Since the noise variance vv estimate is extremely low, this fitted model basically interpolates the datapoints:

plot(fit1, main="exponential kernel - fitted model")

See below the large uncertainty in predictions for test input points:

pred1 <- gprPredict(train = fit1, inputNew=inputNew)
plot(pred1, main="exponential kernel - predictions")

These results suggest that the exponential kernel is likely not to be the best choice. A kernel which takes into account a periodic pattern may be wanted.

## Using a customised covariance kernel

To capture the periodic pattern, we use the following covariance function: $$$k(t,t')=v \exp(-w (t-t')^2 - u \sin^2(\pi (t-t'))), \quad v,w,u > 0 \label{cus-cov}$$$ (see Williams, C. K., & Rasmussen, C. E. (2006). “Gaussian Processes for Machine Learning”, the MIT press).

This is not a standard covariance kernel and is not included in the package. Therefore, we will define it manually.

### Defining a customised covariance kernel

The first step is to define the covariance kernel itself. The name of the kernel must be constituted by the prefix cov. and 6 letters ( e.g., cov.custom).

Here the C++ function distMat is used to calculate distances $$\exp(w)(t-t')^2$$. The similar distMatSq function is used when t and t' are identical. See package documentation for more details.

### Defining the first derivatives

The second step is to define the first derivative of the log-likelihood with respect to each of the hyperparameters of the covariance kernel.

The name of the functions should look like Dloglik.custom.w, where the middle affix is the custom defined name, and the last letter (i.e. w) names the vector of the hyperparameters.

For details about derivatives, see Shi, J. Q., and Choi, T. (2011), “Gaussian Process Regression Analysis for Functional Data”, CRC Press.

### Defining the second derivatives

The third step is to define the second derivatives of the log-likelihood.

### Defining a diagonal matrix including the signal variance

Finally, we define a function to calculate a diagonal matrix contanining the variance of the customised covariance function. This is used for making predictions at new input points.

### Fitting the GPR model with the customised kernel and making predictions

Note that now the noise variance vv estimate is no longer so small. Both the fitted model and the predictions seem much more reasonable for this dataset:

#> Predicted values not found, ploting fitted values