stkey | R Documentation |
Uses the supplied spatial pixel images and scalings to linearly interpolate the behaviour of the function over time, creating a trivariate density function in space-time.
stkey(start, stop, tlim, kf = NULL, tres = 64, kftimes = NULL, fscales = NULL, window = NULL)
start |
The spatial pixel |
stop |
The pixel |
tlim |
A numeric vector of length 2 representing the temporal window i.e. the time interval over which the interpolation takes place. |
kf |
A |
tres |
The resolution of the resulting array in the time dimension (default is 64). |
kftimes |
A vector of times that position the interim keyframes in |
fscales |
A numeric vector of unnormalised, relative point-intensity scales. This may be provided either as of |
window |
An object of class |
This function interpolates in a pixel-wise fashion between the im
objects supplied as start
and stop
(and kf
if supplied), placing them as keyframes at the times in tlim
(for start
and stop
) and kftimes
(for the members of kf
). The final result is rescaled such that its total integrated volume over the defined spatiotemporal domain is 1, yeilding a trivariate density function.
If fscale
is a vector of length tres
, each element will correspond to the relative overall scaling of one of the resulting interpolated pixel images. If it is of length length(kf) + 2
, the scales will correspond to start
, each keyframe in kf
and stop
in that order. The values in this argument are only interpretable in a relative sense: for example, with a single keyframe suppled to kf
(in addition to the required start
and stop
), then fscales = c(0.5,1,0.5)
has exactly the same effect on the final result as fscales = c(1,2,1)
, and is interpreted as yielding a point density that reaches twice the concentration at the time of the supplied keyframe relative to the start
and stop
margins. Supplying fscale
as a vector of length tres
thus allows finer control over the relative point density over time, such as for the incorporation of harmonic seasonal variation.
Like stgmix
, an object of class stim
giving the trivariate density. This is a list with six components:
a |
The |
v |
A pixel |
xcol |
Grid coordinates in the spatial x-axis (corresponds to each spatial |
yrow |
Grid coordinates in the spatial y-axis (corresponds to each spatial |
tlay |
Grid coordinates in the temporal axis (corresponds to the order of the spatial |
W |
A copy of |
A.K. Redmond and T.M. Davies
mn <- matrix(c(0,0,1,2,0.5,-1),nrow=2) vr <- array(c(0.2,0,0,2,1,0,0,1,1,0.3,0.3,0.5),dim=c(2,2,3)) im1 <- sgmix(mn,c(1,2,1),shp1,p=c(0.4,0.3,0.3)) im2 <- sgmix(matrix(c(-3,0,0,-2,-1,2),nrow=2),c(3,1,1),shp1,p=c(0.4,0.3,0.3)) im3 <- sgmix(mn,vr,shp1,p0=0.1) kf1 <- stkey(start=im1,stop=im2,tlim=c(5,20),window=shp1) plot(kf1) kf2 <- stkey(start=im1,stop=im1,tlim=c(0,15),kf=solist(im1,im1),kftimes=c(2,8), fscale=c(1,2,1.5,1),window=shp1) plot(kf2,fix.range=TRUE) kf3 <- stkey(start=im1,stop=im2,tlim=c(0,20),kf=solist(im1,im2),kftimes=c(8,12), fscale=c(1,2,2,1),window=shp1) plot(kf3,fix.range=TRUE) ff <- c(sin((1:64)/3)+1.5) plot(ff,type="l") kf4 <- stkey(start=im1,stop=im2,kf=solist(im3),kftimes=25,tlim=c(0,50),fscale=ff,window=shp1) plot(kf4,fix.range=TRUE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.