kzfs (version 1.5.0.2)

kzpdr.spikes: Count Spikes For Available Directional Periodogram Records

Description

Function kzpdr.spikes summarizes available periodogram pattern records collected from the outputs of kzpdr, gives expected wave number. This number is used by kzpdr.tol and kzpdr.valid in searching feasible tolerance setting and validation of estimated wave parameters.

Usage

kzpdr.spikes(rec = ls(1))

Arguments

rec

Data list from the outputs of function kzpdr. It includes the data frame for the marked frequency values and corresponding directions. Defaults is searching for available records in the environment.

Details

The expected wave number is defined as the mode of all the spike counts.

If any of the sampling direction in the available directional periodogram records, say A, happens to be orthogonal to a wave direction B, then there will be no spike appear on related periodogram for the wave propagated in direction B. Related spike counts will be less than the expected wave number. The absence of spike(s) in one direction can be taken as the evidence for the existing of wave(s) in its orthogonal direction.

Usually, it is very rare to have a simpling direction orthogonal to a wave direction. But if we know an approximate wave direction, we can take more samplings around its orthogonal direction. Since KZ periodogram can separate wave spikes in very close frequencies, we may get more accurate estimation for this wave direction with this method. It is also possible to use this way to validate estimations get by other approaches.

See Also

kzpdr, kzpdr.eval kzpdr.valid, kzpdr.tol

Examples

# NOT RUN {
# load pre-saved data 
data(kzpdr.demo); 

# count spikes
kzpdr.spikes(kzpdr.demo)

# }