Revision 68994912262e9c2ae98bff7968c23cd4cc8b9e8b authored by Martin Schlather on 24 August 2008, 00:00 UTC, committed by Gabor Csardi on 24 August 2008, 00:00 UTC
1 parent 3774b0f
GetRegisterInfo.Rd
\name{GetRegisterInfo}
\alias{GetRegisterInfo}
\alias{GetModelInfo}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{Internal information}
\description{
The function returns internal information about the simulation
of a random field
}
\usage{
GetRegisterInfo(register=0, ignore.active = FALSE, max.elements=10^6)
GetModelInfo(register=0)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
\item{register}{-2, -1, 0:9;
place where intermediate calculations are stored;
\item{ignore.active}{logical. If \code{FALSE} and the register has
non-active flag (because of an error or it is deleted) then a list
is returned that contains only the element \code{active=FALSE}.
Otherwise, the full list is always returned.
}
\item{max.elements}{integer; since \command{GetRegisterInfo}
might be a dump of simulation that needs a huge amount of
memory and since all entries are copied, the maximal amount
of available memory might be easily exceeded.  Therefore,
only the size of the critical parts are returned and not the
vector or matrix itself, if the number of elements exceeds
\code{max.elements}.
}
}
\details{
\code{GetRegisterInfo(register, ignore.active=TRUE)} is
useful for debugging and specialists' need to control
the algorithm, see the examples in \code{\link{RFparameters}}

the internal registers are not kept if \command{\link{GaussRF}} or
Hence \code{GetRegisterInfo} cannot
provide any information.

\code{GetModelInfo} returns the partial information on the internal
model structure. It allows for \code{register=-1} returning the
model structure for the last use of \command{\link{CovarianceFct}}
\code{register=-2} is for internal use only.
}
\note{
if you like to have more
internal information in case of an expected failure of an initialisation of
a random field simulation.
}
\value{
List of internal information is returned.
}
\author{Martin Schlather, \email{martin.schlather@math.uni-goettingen.de}
\url{http://www.stochastik.math.uni-goettingen.de/institute}}

\examples{
# lets regard at a non-initialised register first:
DeleteAllRegisters()
str(GetRegisterInfo(0))

# now, a register that has successfully initialised
try(GaussRF(1:4, grid=TRUE, model="exp", param=c(1,2,3,4), Storing=TRUE))
str(GetRegisterInfo(0))

# finally, a register that could not be successfully initialised
try(GaussRF(runif(4), grid=FALSE, model="exp", param=c(1,2,3,4),
me="ci", Storing=TRUE))
str(GetRegisterInfo(0, TRUE))
}
\keyword{spatial}


Computing file changes ...