AR(2) Eigenvalue Persistence Analysis of Circadian Time Series

Estimates temporal persistence in gene expression time series by fitting a second-order autoregressive model per gene and reporting the eigenvalue modulus of its characteristic equation. Conventional circadian methods answer whether a gene cycles; the eigenvalue modulus instead measures how strongly recent expression constrains future expression, which separates clock genes from their targets and from background in intact tissue. Provides single-series and matrix-wide fitting, root-type classification, half-life and intrinsic-period conversions, residual-bootstrap confidence intervals for short series, and hierarchy summaries. Numerically equivalent to the reference 'Python' implementation 'par2-circadian'. The method is described in Whiteside (2026) .


par2circadian

An R implementation of AR(2) eigenvalue persistence analysis for gene expression time series — the R port of the Python package par2-circadian (RRID:SCR_028837).

Circadian tools ask does this gene cycle? par2circadian asks how long does its expression remember? It fits

x[t] = phi1 * x[t-1] + phi2 * x[t-2] + e[t]

per gene and returns |lambda|, the modulus of the largest root of r^2 - phi1*r - phi2 = 0: one number per gene measuring how strongly recent expression constrains future expression.

Install

# install.packages("par2circadian")            # once on CRAN
# remotes::install_github("mickwh2764/par2circadian-R")

Depends on base R and stats only.

Use

library(par2circadian)

fit <- fit_ar2(expression_vector)          # one gene
fit$eigenvalue; fit$root_type

fits <- fit_ar2_batch(expression_matrix)   # genes x timepoints
discover_hierarchy(fits)$gearbox_gap       # Clock - Target median |lambda|

fit_ar2(short_series, n_bootstrap = 2000, seed = 1)$eigenvalue_ci

vignette("par2circadian") works through a mouse liver series end to end.

What it is not

|lambda| is not a rhythmicity test, and should not be reported as one. Red noise with no rhythm scores high — correctly, because it is persistent — and a clean fixed-period cosine scores low. On noise-driven oscillators at 24 timepoints it detected 92% of true oscillators against 40–62% for JTK_CYCLE, ARSER and RAIN; on a clean 24 h cosine those methods reached 100% and |lambda| reached 12%. It answers a different question: use it alongside a rhythm-detection method, not instead of one.

Two further limits worth respecting: single-gene estimates from short series are imprecise (roughly a 0.4-wide 95% interval at 24 timepoints, biased upward below that), so report n_bootstrap intervals; and a high |lambda| with real roots is persistent but not oscillatory.

Agreement with the Python implementation

The test suite refits a 300-gene subset of GSE11923 (mouse liver, hourly for 48 h) and compares every gene against what par2-circadian returns. All 300 agree exactly on |lambda|, phi1, phi2, R^2, half-life, eigenperiod and root type at the 6 decimal places both implementations report — the worst-gene difference is 0, not merely small. Comparing the worst gene rather than a mean or a correlation is the point: a wrong estimator still correlates at 0.999 with the right one. The fixtures and the script that regenerates them are in inst/extdata/ and data-raw/. Bootstrap intervals are the exception — R and NumPy draw from different generators, so widths are comparable but endpoints are not.

Citation

citation("par2circadian")

Cite the method preprint (doi:10.21203/rs.3.rs-9283100/v1) alongside the software.

Licence

Apache-2.0. Test fixtures derive from GEO series GSE11923 (Hughes et al. 2009), a public dataset, subset for testing only.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("par2circadian")

0.1.1 by Michael Whiteside, 11 hours ago


https://github.com/mickwh2764/par2circadian-R


Report a bug at https://github.com/mickwh2764/par2circadian-R/issues


Browse source code at https://github.com/cran/par2circadian


Authors: Michael Whiteside [aut, cre, cph] (ORCID:


Documentation:   PDF Manual  


Apache License (>= 2) license


Imports stats

Suggests testthat, knitr, rmarkdown


See at CRAN