Description Usage Arguments Details Value Author(s) References See Also Examples

A symbolic routine to define that a surface is decreasing in one predictor and increasing in another in a formula argument to cgam.

1 | ```
s.incr.decr(x1, x2, numknots = c(0, 0), knots = list(k1 = 0, k2 = 0), space = c("E", "E"))
``` |

`x1` |
A numeric predictor which has the same length as the response vector. |

`x2` |
A numeric predictor which has the same length as the response vector. |

`numknots` |
A vector of the number of knots used to constrain |

`knots` |
A list of two vectors of knots used to constrain |

`space` |
A vector of the character specifying the method to create knots for |

"s.incr.decr" returns the vectors "x1" and "x2", and imposes on each vector six attributes: name, shape, numknots, knots, space and decreasing.

The name attribute is used in the subroutine plotpersp; the numknots, knots and space attributes are the same as the numknots, knots and space arguments in "s.incr.decr"; the shape attribute is "wps_id"(increasing-decreasing); the decreasing values for "x1" and "x2" are TRUE and FALSE. According to the value of the vector itself and its shape, numknots, knots, space and decreasing attributes, the cone edges will be made by warped-plane spline basis functions in Meyer (2016). The cone edges are a set of basis employed in the hinge algorithm.

Note that "s.incr.decr" does not make the corresponding cone edges itself. It sets things up to a subroutine called makedelta_wps.

See references cited in this section for more details.

The vectors *x_1* and *x_2*. Each of them has six attributes, i.e., name: names of *x_1* and *x_2*; shape: "wps_id"(increasing-decreasing); numknots: the numknots argument in "s.incr.decr"; knots: the knots argument in "s.incr.decr"; space: the space argument in "s.incr.decr"; decreasing: two logical values indicating the monotonicity of the isotonically-constrained surface with respect to *x_1* and *x_2*, which are FALSE and TRUE.

Mary C. Meyer and Xiyue Liao

Meyer, M. C. (2017) Estimation and inference for regression surfaces using shape-constrained splines.

`s.incr.incr`

, `s.decr.decr`

, `s.decr.incr`

, `cgam`

1 2 3 4 5 6 7 8 9 10 11 12 13 | ```
# generate data
n <- 100
set.seed(123)
x1 <- runif(n)
x2 <- runif(n)
y <- 4 * (x1 - x2) - x1 * x2 + rnorm(n, sd = .2)
# regress y on x1 and x2 under the shape-restriction: "increasing-decreasing"
# using the penalized estimator
ans <- cgam(y ~ s.incr.decr(x1, x2), pnt = TRUE)
# make a 3D plot of the constrained surface
plotpersp(ans)
``` |

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.