RFgetModelInfo: Information on RMmodels

Description

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

Usage

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)
RFgetModelInfo_model(model, dim = 1, Time = FALSE,
                     kernel = FALSE, exclude_trend = TRUE, ...)

Arguments

...

any of the arguments below

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

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+

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

an RMmodel with NAs where information on the parameters is requested.

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.

Value

If RFgetModelInfo(model) is called a list returned with the following elements:
- trans.inv: logical. Whether the model is translation invariant (stationary)
- isotropic: logical. Whether the model is rotation invariant (stationary)
- NAs: is case of an additive model it gives the number of NAs in each submodel
- minmax: a data frame containing information on all arguments set toNAs
  - pmin,pmax: lower and upper endpoint of the parameter values usually found in practice
  - type: integer; recognized particularities of a parameter; an explanation of the values is given after the table, if printed.
  - NAN: the number ofNANs found
  - min,max: mathetically valid lower and upper endpoints of the parameter values
  - omin,omax: logical. IfFALSEthe respective mathematical endpoint is included
  - col,row: the dimension of the parameter. If the parameter is a scalar thencol = row = 1. If it is a vector thencol = 1.
  - bayes: currently not used (alwaysFALSE)
Else a list of internal structure is returned.

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:

RFgetModelInfo()returns internal information on the last call of anRFfunction.
RFgetModelInfo(RFfunction)returns internal information on the last call ofRFfunction.
RFgetModelInfo(RMmodel)returns general information onRMmodel

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

Examples

Run this code

RFoptions(seed=0) ## *ANY* simulation will have the random seed 0; set
##                   RFoptions(seed=NA) to make them all random again
StartExample()
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)
FinalizeExample()