RandomFields (version 3.1.12)

RFoptions: Setting control arguments

Description

RFoptions sets and returns control arguments for the analysis and the simulation of random fields

Usage

RFoptions(..., no.readonly = TRUE)

Arguments

...

arguments in tag = value form, or a list of tagged values.

no.readonly

If RFoptions is called without argument then all arguments are returned in a list. If no.readonly=TRUE then only rewritable arguments are returned.

Value

• NULL if any argument is given, and the full list of arguments, otherwise.

  if no.readonly=FALSE then additionally, a list called readonly is included containing * covmaxchar: the maximum length of a model name * covnr: number of currently implemented variogram/covariance models (-1 means that none of the functions like RFsimulate, RFfit , etc., have been called yet.) * distrmaxchar: max. name length for a distribution * distrnr: number of currently implemented distributions * maxdim: maximum number of dimensions for a random field * maxmodels: maximum number of elementary models in definition of a complex covariance model * methodmaxchar: max. name length for methods * methodnr: number of currently implemented simulation methods

Details

The subsections below comment on 1. general: General options 2. br: Options for Brown-Resnick Fields 3. circulant: Options for circulant embedding methods RPcirculant 4. coords: Options for coordinates and units, see coordinate systems 5. direct: Options for simulating by simple matrix decomposition 6. distr: Options for distributions, in particular RRrectangular 7. empvario: Options for calculating the empirical variogram 8. fit: Options for RFfit, RFratiotest, and RFcrossvalidate 9. gauss: Options for simulating Gaussian random fields 10. graphics: Options for graphical output 11. gui: Options for RFgui 12. hyper: Options for simulating hyperplane tessellations 13. krige: Options for Kriging 14. maxstable: Options for simulating max-stable random fields 15. mpp: Options for the random coins (shot noise) methods 16. nugget: Options for the nugget effect 17. registers: Register numbers 18. sequ: Options for the sequential method 19. solve: Options for solving linear systems 20. special: Options for some special methods 21. spectral: Options for the spectral (turning bands) method 22. tbm: Options for the turning bands method 23. internal: Internal 1. General options [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]2. Options for Brown-Resnick Fields [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object] 3. circulant: Options for circulant embedding methods, cf. RPcirculant These options influence the standard circulant embedding method, cutoff circulant embedding intrinsic circulant embedding. It can also influence RPtbm if the line is simulated with any circulant embedding method. [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]4. coords: Options for coordinates and units [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]5. direct: Options for simulating by simple matrix decomposition [object Object]6. distr: Options for distributions, in particular RRrectangular [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]7. empvario: Options for calculating the empirical variogram [object Object],[object Object],[object Object],[object Object],[object Object] 8. fit: Options for RFfit, RFratiotest, and RFcrossvalidate

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]9. gauss: Options for simulating Gaussian random fields [object Object],[object Object],[object Object],[object Object],[object Object],[object Object]10. graphics: Options for graphical output [object Object],[object Object],[object Object],file{character; only relevant if split_screen = TRUE. argument file in pdf If "" then no internal naming is performed.

Default: "". },[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]11. gui: Options for cRFgui [object Object],[object Object],[object Object]12. hyper: Options for simulating hyperplane tessellations [object Object],[object Object],[object Object],[object Object]

13. krige: Options for Kriging [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]14. maxstable: Options for simulating max-stable random fields [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]15. mpp: Options for the random coins (shot noise) methods [object Object],[object Object],[object Object],[object Object]16. nugget: Options for the nugget effect Simulating a nugget effect is per se trivial. However, it gets complicated and best methods (including direct and circulant embedding!) fail if zonal anisotropies are considered, where sets of points have to be identified that belong to the same subspace of eigenvalue 0 of the anisotropy matrix. [object Object]17. registers: Register numbers Model for different purposes are or can be stored at different places. They are called registers and have non-negative numbers up to 21 (currently). The user can use the registers 0..9. [object Object]18. sequ: Options for the sequential method [object Object],[object Object],[object Object]19. solve: Options for solving linear systems

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]20. special: Options for specific methods [object Object]21. spectral: Options for the spectral (turning bands) method [object Object],[object Object],[object Object],[object Object],[object Object]22. tbm: Options for the turning bands method [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]23. internal: Internal options mostly for warnings and messages

All these options should not be changed by the user unless he/she really known what he/she is doing.

Most of the options below change their value in a session without the user's notice.

[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]

References

• General
  • Schlather, M. (1999)An introduction to positive definite functions and to unconditional simulation of random fields.Technical report ST 99-10, Dept. of Maths and Statistics, Lancaster University.
  • Schlather, M. (2011) Construction of covariance functions and unconditional simulation of random fields. In Porcu, E., Montero, J.M. and Schlather, M.,Space-Time Processes and Challenges Related to Environmental Problems.New York: Springer. % \item Schlather, M. (2002) Models for stationary max-stable
• rectangular distribution;eps_zhou
  • Oesting, M., Schlather, M. and Zhou, C. (2013) On the Normalized Spectral Representation of Max-Stable Processes on a compact set.arXiv,1310.1813
• shape_power
  • Ballani, F. and Schlather, M. (2015) In preparation.

See Also

RFsimulate, RFoptionsAdvanced, RandomFields, and RFgetMethodNames.

Examples

RFoptions(seed=0) ## *ANY* simulation will have the random seed 0; set
##                   RFoptions(seed=NA) to make them all random again
StartExample()
RFoptions()


############################################################
##                                                        ## 
## use of exactness                                       ##
##                                                        ##
############################################################
x <- seq(0, 1, 1/30)
model <- RMgauss()

for (exactness in c(NA, FALSE, TRUE)) { 
  readline(paste("exactness: `", exactness, "'; press return"))
  z <- RFsimulate(model, x, x, exactness=exactness,
                  stationary_only=NA, storing=TRUE)
  print(RFgetModelInfo(which="internal")$internal$name)
}

FinalizeExample()