% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/respiration-ceemdan-kalman.R
\name{fuse_gazepoint_respiration_kalman}
\alias{fuse_gazepoint_respiration_kalman}
\title{Fuse respiration proxies using a Kalman filter}
\usage{
fuse_gazepoint_respiration_kalman(
  dat,
  primary_col,
  secondary_col,
  time_col = NULL,
  group_cols = NULL,
  process_var = 0.01,
  primary_var = 0.05,
  secondary_var = 0.05,
  output_col = "respiration_kalman_fused"
)
}
\arguments{
\item{dat}{A data frame.}

\item{primary_col}{First respiration proxy column.}

\item{secondary_col}{Second respiration proxy column.}

\item{time_col}{Optional time column.}

\item{group_cols}{Optional grouping columns.}

\item{process_var}{Process variance.}

\item{primary_var}{Measurement variance for \code{primary_col}.}

\item{secondary_var}{Measurement variance for \code{secondary_col}.}

\item{output_col}{Output fused respiration column.}
}
\value{
A data frame with fused respiration output and Kalman attributes.
}
\description{
Fuses two respiration proxy streams, such as PPG-derived respiration and
ECG-derived respiration, using a transparent one-dimensional Kalman filter.
This is a linear Kalman fusion helper. It is not an extended Kalman filter
unless the user supplies nonlinear state/measurement logic externally.
}
