Windowed Cokurtosis
PortfolioOptimisers.WindowedCokurtosis — Type
struct WindowedCokurtosis{__T_kte, __T_w, __T_window} <: CokurtosisEstimatorCokurtosis estimator that restricts computation to a rolling or indexed observation window.
WindowedCokurtosis wraps another cokurtosis estimator and applies it to a subset of observations defined by a window and/or custom observation weights. This enables time-varying or recency-weighted cokurtosis estimation.
Fields
kte: Cokurtosis estimator.w: Optional observation weights vectorobservations × 1, or a concrete subtype ofDynamicAbstractWeights. Ifnothing, the computation is unweighted.window: Observation window. An integer selects the lastwindowobservations, and a vector of indices selects those observations.
Constructors
WindowedCokurtosis(; kte::CokurtosisEstimator = Cokurtosis(), w::Option{<:ObsWeights} = nothing, window::Option{<:Int_VecInt} = nothing) -> WindowedCokurtosisKeywords correspond to the struct's fields.
Validation
- If
wis notnothing,!isempty(w). - If
windowis provided, it must be nonempty, nonnegative, and finite.
Propagated parameters
When factory is called on this type, the following @fprop-tagged fields are automatically propagated:
kte: Recursively updated viafactory.w: Replaced with the incomingObsWeights.
View parameters
When port_opt_view is called on this type, the following @vprop-tagged fields are automatically subset to the selected indices:
kte: Recursively viewed viaport_opt_view.
Observation weight parameters
When obs_weights_view is called on this type, the following fields are automatically indexed to the selected observations:
kte: Recursively indexed viaobs_weights_view.w: Indexed to the selected observations viaobs_weights_view.
Examples
julia> WindowedCokurtosis()WindowedCokurtosis kte ┼ Cokurtosis │ me ┼ SimpleExpectedReturns │ │ w ┴ nothing │ mp ┼ MatrixProcessing │ │ pdm ┼ Posdef │ │ │ alg ┼ UnionAll: NearestCorrelationMatrix.Newton │ │ │ kwargs ┴ @NamedTuple{}: NamedTuple() │ │ dn ┼ nothing │ │ dt ┼ nothing │ │ alg ┼ nothing │ │ order ┴ NTuple{4, Symbol}: (:pdm, :dn, :dt, :alg) │ alg ┼ FullMoment() │ w ┼ nothing │ cache ┴ nothing w ┼ nothing window ┴ nothingRelated
PortfolioOptimisers.cokurtosis — Method
cokurtosis(kte::WindowedCokurtosis, X::MatNum; dims::Int = 1, mean = nothing, iv::Option{<:MatNum} = nothing, kwargs...)Compute cokurtosis over a rolling or indexed observation window (matrix input).
This method selects a window of observations from X (and applies observation weights if specified), then delegates to the underlying cokurtosis estimator.
Algorithm
- Resolve the window and the observation weights with
windowed_preamble, givinginner, a copy ofkte.ktethat carries the windowed weights, together with the windowedXand the windowediv. - Call
cokurtosisoninnerand the windowedX, and return its result. The inner estimator alone decides the value, so the window and the weights are the whole of this method's contribution.
Arguments
kte: Windowed cokurtosis estimator.X: Data matrix of asset returns (observations × assets).dims: Dimension along which to perform the computation.mean: Optional pre-computed mean passed to the underlying estimator.iv: Optional implied volatility matrix. Used if any internal covariance estimator is an instance ofImpliedVolatility.kwargs...: Additional keyword arguments passed to the underlying estimator.
Returns
kte::MatNum: Cokurtosis matrixassets x assets.
Related