View source: R/7_plottingFunctions.R

decay | R Documentation |

This function is intended to aid the selection of the heuristic parameters *tao0*,
*delta* and *dispr* in the call to the model selection function fgpm_factory.
The values computed by decay are the ones that would be used by the ant colony algorithm as initial
pheromone load of the links pointing out to projection on each dimension. For more details, check the
technical report
explaining the ant colony algorithm implemented in funGp, and the manual of the package
(\Sexpr[results=rd]{tools:::Rd_expr_doi("https://doi.org/10.18637/jss.v109.i05")}).

```
decay(
k,
pmax = NULL,
tao0 = 0.1,
delta = 2,
dispr = 1.4,
doplot = TRUE,
deliver = FALSE
)
```

`k` |
A number indicating the dimension of the functional input under analysis. |

`pmax` |
An optional number specifying the hypothetical maximum projection dimension of this input. The user will be able to set this value later in the call to fgpm_factory as a constraint. If not specified, it takes the value of k. |

`tao0` |
Explained in the description of |

`delta` |
Explained in the description of |

`dispr` |
The arguments
with p taking the values of the projection dimensions. The argument |

`doplot` |
An optional boolean indicating if the pheromone loads should be plotted. Default = TRUE. |

`deliver` |
An optional boolean indicating if the pheromone loads should be returned. Default = FALSE. |

If deliver is TRUE, an object of class `"numeric"`

containing the initial pheromone values
corresponding to the specified projection dimensions. Otherwise, the function plots the pheromones and
nothing is returned.

José Betancourt, François Bachoc, Thierry Klein and Jérémy Rohmer

***** decay2probs for the function to generate the initial probability load;

***** fgpm_factory for heuristic funGp model selection.

```
# using default decay arguments____________________________________________________________
# input of dimension 15 projected maximum in dimension 15
decay(15)
# input of dimension 15 projected maximum in dimension 8
decay(15, 8)
# playing with decay arguments_____________________________________________________________
# input of dimension 15 projected maximum in dimension 15
decay(15)
# using a larger value of tao0
decay(15, tao0 = .3)
# using a larger value of tao0, keeping it fixed up to higher dimensions
decay(15, tao0 = .3, delta = 5)
# using a larger value of tao0, keeping it fixed up to higher dimensions, with slower decay
decay(15, tao0 = .3, delta = 5, dispr = 5.2)
# requesting pheromone values______________________________________________________________
# input of dimension 15 projected maximum in dimension 15
decay(15, deliver = TRUE)
```

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.