RFgetModelInfo: Information on RMmodels

Description Usage Arguments Details Value Note See Also Examples

View source: R/getNset.R

Description

The function returns information about an RMmodel, either internal information when used in simulations, for instance, or general information

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
RFgetModelInfo(...) 

RFgetModelInfo_register(register, level = 1, spConform =
                 RFoptions()$general$spConform, which.submodels =
                 c("user", "internal", "call+user", "call+internal",
                 "user.but.once", "internal.but.once",
                 "user.but.once+jump", "internal.but.once+jump", "all"),
                 modelname = NULL, origin = "original")

RFgetModelInfo_model(model, params, dim = 1, Time = FALSE,
                     kernel = FALSE, exclude_trend = TRUE, ...)

Arguments

...

See the argument of RFgetModelInfo_register and RFgetModelInfo_model; RFgetModelInfo is an abbreviation for the other two functions.

register

0,...,21 or an evaluating function, e.g. RFsimulate. Place where intermediate calculations are stored. See also section Registers in RFoptions.

level

integer [0...5]; level of details, i.e. the higher the number the more details are given.

spConform

see RFoptions

which.submodels

Internally, the sub-models are represented in two different ways: ‘internal’ and ‘user’. The latter is very close to the model defined by the user.

Most models have a leading internal model. The values "call+user" and "call+internal" also return this leading model if existent.

The values "user.but.once", "internal.but.once" "user.but.once" returns the user path of the internal model following the leading model. "internal.but.once" would return the internal path of the user model following the leading model, but this path should never exist. So as all the other options if a certain direction does not exist, the alternative path is taken.

The values "user.but.once+jump", "internal.but.once+jump" same as "user.but.once" and "internal.but.once", except that the first submodel below the leading model is not given.

The value "all" returns the whole tree of models (very advanced).

modelname

string. If modelname is given then it returns the first appearance of the covariance model with name modelname. If meth is given then the model within the method is returned.

model,params \argModel

Here, NAs should be placed where information on the parameters is desired..

dim

positive integer. Spatial dimension.

Time

logical. Should time be considered, too?

kernel

logical. Should the model be considered as a kernel?

exclude_trend

logical. Currently, only TRUE is available.

origin \argOrigin

Details

RFgetModelInfo branches either into RFgetModelInfo_register or RFgetModelInfo_model, depending on the type of the first argument. The latter two are usually not called by the user.

RFgetModelInfo has three standard usages:

Whereas RFgetModelInfo() can return detailed internal information, RFgetModel returns a model that can be re-used by the user.

Value

If RFgetModelInfo(model) is called a list is returned with the following elements:

Else a list of internal structure is returned.

Note

Put Storing=TRUE, see RFoptions if you like to have more internal information in case of failure of an initialisation of a random field simulation.

See Also

commandRFgetModel, RFsimulate

Examples

1
2
3
4
5
6
7
8
9
RFoptions(seed=0) ## *ANY* simulation will have the random seed 0; set
##                   RFoptions(seed=NA) to make them all random again

model <- RMexp(scale=4, var=2) + RMnugget(var=3) + RMtrend(mean=1)
z <- RFsimulate(model, 1:4, storing=TRUE)
RFgetModelInfo()

model <-  RMwhittle(scale=NA, var=NA, nu=NA) + RMnugget(var=NA)
RFgetModelInfo(model)

RandomFields documentation built on Jan. 19, 2022, 1:06 a.m.