R: Arithmetic on functional data ('fd') objects

arithmetic.fd {fda} | R Documentation

## Arithmetic on functional data ('fd') objects

### Description

Arithmetic on functional data objects

### Usage

    ## S3 method for class 'fd'
    e1 + e2
    ## S3 method for class 'fd'
    e1 - e2
    ## S3 method for class 'fd'
    e1 * e2
    plus.fd(e1, e2, basisobj=NULL)
    minus.fd(e1, e2, basisobj=NULL)
    times.fd(e1, e2, basisobj=NULL)

### Arguments

`e1, e2` | object of class 'fd' or a numeric vector. Note that 'e1+e2' will dispatch to plus.fd(e1, e2) only if e1 has class 'fd'. Similarly, 'e1-e2' or 'e1*e2' will dispatch to minus.fd(e1, e2) or time.fd(e1, e2), respectively, only if e1 is of class 'fd'.
`basisobj` | reference basis; defaults to e1[['basis']] * e2[['basis']]; ignored for `plus.fd` and `minus.fd`.

### Value

A function data object corresponding to the pointwise sum, difference or product of e1 and e2.

If both arguments are functional data objects, the bases are the same, and the coefficient matrices are the same dims, the indicated operation is applied to the coefficient matrices of the two objects. In other words, e1+e2 is obtained for this case by adding the coefficient matrices from e1 and e2.

If e1 or e2 is a numeric scalar, that scalar is applied to the coefficient matrix of the functional data object.

If either e1 or e2 is a numeric vector, it must be the same length as the number of replicated functional observations in the other argument.

When both arguments are functional data objects, they need not have the same bases. However, if they don't have the same number of replicates, then one of them must have a single replicate. In the second case, the singleton function is replicated to match the number of replicates of the other function. In either case, they must have the same number of functions. When both arguments are functional data objects, and the bases are not the same, the basis used for the sum is constructed to be of higher dimension than the basis for either factor according to rules described in function TIMES for two basis objects.

### See Also

`basisfd`, `basisfd.product` `exponentiate.fd`

### Examples

    ##
    ## add a parabola to itself
    ##
    bspl4 <- create.bspline.basis(nbasis=4)
    parab4.5 <- fd(c(3, -1, -1, 3)/3, bspl4)

    coef2 <- matrix(c(6, -2, -2, 6)/3, 4)
    dimnames(coef2) <- list(NULL, 'reps 1')

    all.equal(coef(parab4.5+parab4.5), coef2)

    ##
    ## Same example with interior knots at 1/3 and 1/2
    ##
    bspl5.3 <- create.bspline.basis(breaks=c(0, 1/3, 1))
    plot(bspl5.3)
    x. <- seq(0, 1, .1)
    para4.5.3 <- smooth.basis(x., 4*(x.-0.5)^2, fdParobj=bspl5.3)[['fd']]
    plot(para4.5.3)

    bspl5.2 <- create.bspline.basis(breaks=c(0, 1/2, 1))
    plot(bspl5.2)
    para4.5.2 <- smooth.basis(x., 4*(x.-0.5)^2, fdParobj=bspl5.2)[['fd']]
    plot(para4.5.2)

    #str(para4.5.3+para4.5.2)

    coef2. <- matrix(0, 9, 1)
    dimnames(coef2.) <- list(NULL, 'rep1')

    all.equal(coef(para4.5.3-para4.5.2), coef2.)

    ##
    ## product
    ##
    quart <- para4.5.3*para4.5.2

    # interior knots of the sum
    # = union(interior knots of the summands);
    # ditto for difference and product.

    all.equal(knots(quart), c(knots(para4.5.3), knots(para4.5.2)))

    # norder(quart) = norder(para4.5.2)+norder(para4.5.3)-1 = 7

    norder(quart) == (norder(para4.5.2)+norder(para4.5.3)-1)

    # para4.5.2 with knot at 0.5 and para4.5.3 with knot at 1/3
    # both have (2 end points + 1 interior knot) + norder-2
    #     = 5 basis functions
    # quart has (2 end points + 2 interior knots)+norder-2
    #     = 9 basis functions
    # coefficients look strange because the knots are at
    # (1/3, 1/2) and not symmetrical

    all.equal(as.numeric(coef(quart)),
    0.1*c(90, 50, 14, -10, 6, -2, -2, 30, 90)/9)

    plot(para4.5.3*para4.5.2) # quartic, not parabolic ...

    ##
    ## product with Fourier bases
    ##
    f3 <- fd(c(0,0,1), create.fourier.basis())
    f3^2 # number of basis functions = 7?

    ##
    ## fd+numeric
    ##
    coef1 <- matrix(c(6, 2, 2, 6)/3, 4)
    dimnames(coef1) <- list(NULL, 'reps 1')

    all.equal(coef(parab4.5+1), coef1)

    all.equal(1+parab4.5, parab4.5+1)

    ##
    ## fd-numeric
    ##
    coefneg <- matrix(c(-3, 1, 1, -3)/3, 4)
    dimnames(coefneg) <- list(NULL, 'reps 1')

    all.equal(coef(-parab4.5), coefneg)

    plot(parab4.5-1)

    plot(1-parab4.5)

[Package fda version 2.4.8 Index]