The function estimates the model parameters of a 1-D continuous lag spatial Markov chain. Transition rates matrix along a user defined direction and proportions of categories are computed.
tpfit(data, coords, direction, method = "ml",
tolerance = pi/8, max.it = 9000, mle = "avg", ...)
An object of the class tpfit
is returned. The function print.tpfit
is used to print the fitted model. The object is a list with the following components:
the transition rates matrix computed for the user defined direction.
a vector containing the proportions of each observed category.
a numerical value which denotes the tolerance angle (in radians).
a categorical data vector of length \(n\).
an \(n \times d\) matrix where each row denotes the \(d\)-D coordinates of data locations.
a \(d\)-D numerical vector (or versor) which represents the chosen direction.
a character object specifying the method to estimate the transition rates. Possible choises are "ml"
(by default) for the mean length method, "ils"
for the iterated least squares and "me"
for the maximum entropy method.
a numerical value for the tolerance angle (in radians). It's pi/8
by default.
a numerical value which denotes the maximum number of iterations to perform during the optimization phase. It is 9000
by default and used only when the method is "me"
.
a character value to pass to the function mlen
. It is "avg"
by default and not use when the method is "ils"
.
other arguments to pass to the functions tpfit_ml
, tpfit_ils
or tpfit_me
.
Luca Sartore drwolf85@gmail.com
A 1-D continuous-lag spatial Markov chain is probabilistic model which involves a transition rate matrix \(R\) computed for the direction \(\phi\). It defines the transition probability \(\Pr(Z(s + h) = z_k | Z(s) = z_j)\) through the entry \(t_{jk}\) of the following matrix $$T = \mbox{expm} (h R),$$ where \(h\) is a positive lag value.
Three methods are available to calculate entries of the transition rate matrix. The mean length method is performed by the use of the function tpfit_ml
, the iterated least squares are applied through the function tpfit_ils
, while the function tpfit_me
implements the maximum entropy method.
Carle, S. F., Fogg, G. E. (1997) Modelling Spatial Variability with One and Multidimensional Continuous-Lag Markov Chains. Mathematical Geology, 29(7), 891-918.
Sartore, L. (2010) Geostatistical models for 3-D data. M.Phil. thesis, Ca' Foscari University of Venice.
predict.tpfit
, print.tpfit
, multi_tpfit
, transiogram
# \donttest{
data(ACM)
# Estimate the parameters of a
# one-dimensional MC model
tpfit(ACM$MAT5, ACM[, 1:3], c(0, 0, 1))
# }
Run the code above in your browser using DataLab