Skip to main content

tsecon

High-performance time series econometrics: a Rust core with a Python-first API.

Pre-1.0 software under active development. The name is settled — tsecon is what you install and import — but the API may still change before 1.0.

tsecon brings the scattered toolkit of modern time series econometrics — diagnostics and specification tests, ARIMA, GARCH, VARs and structural identification, local projections, Bayesian VARs, nowcasting, predictive regressions, panels, the term structure — into one fast, validated, Python-first library. The compute core is written from scratch in Rust (no BLAS, no heavy dependencies) so bootstrap inference and Monte Carlo work that is painfully slow elsewhere runs in seconds, with results bit-reproducible at any thread count.

Every estimator is validation-gated: its numbers are checked against a reference implementation (statsmodels, SciPy, NumPy, arch, linearmodels, scikit-learn, ArviZ) or a documented closed form before it ships, and a cross-library parity gate re-verifies the agreement in CI on every push. The library ships no data loaders and makes no network calls — the only runtime dependency is NumPy.

Install

pip install tsecon

A single self-contained wheel whose only runtime dependency is NumPy — no Rust toolchain, no system BLAS. Prebuilt wheels cover Linux (x86_64, aarch64), macOS on Apple Silicon (arm64), and Windows (x64), for every Python >= 3.9. Plotting is an optional extra:

pip install 'tsecon[plots]'    # adds matplotlib for the .plot_*() methods

Then check what you got:

import tsecon
print(tsecon.__version__)   # 0.2.0

There is no prebuilt wheel for Intel macOS (x86_64); on that platform, and for building from a checkout, pip compiles from the source distribution, which needs a Rust toolchain and Python >= 3.9. Contributors build with maturin:

pip install maturin
maturin develop --release -m bindings/python/Cargo.toml   # builds + installs into the active venv

A taste

import numpy as np
import tsecon

rng = np.random.default_rng(0)
y = np.cumsum(rng.standard_normal(300))          # a random walk

tsecon.check_stationarity(y)["recommendation"]   # -> "Difference"

# Fit a VAR, read off impulse responses, decompose the variance
data = rng.standard_normal((200, 3))
irf  = tsecon.var_irf(data, lags=2, horizon=16)          # [h][response][shock]
fevd = tsecon.var_fevd(data, lags=2, horizon=16)

# Robust SEs, exact-MLE ARIMA with a forecast fan, GARCH with robust SEs,
# instrumented local projections, a fiscal multiplier, a Bayesian VAR...
tsecon.ols(y, X, se_type="hac")
tsecon.arima_fit(y, p=1, d=1, q=1, forecast_steps=12, conf_alpha=0.1)
tsecon.garch_fit(returns, vol="gjr", dist="t")
tsecon.lp_multiplier(y_out, spending, instrument, horizons=20)
tsecon.bvar_irf_draws(data, lags=2, horizon=12, n_draws=800)

Every function takes plain NumPy arrays and returns arrays or dicts of documented keys. An opt-in tsecon.results layer wraps the same calls in objects that render themselves (.summary(), .plot_irf()) without changing the dict contract.

What's here today

126 functions across the full applied workflow: the diagnostic battery and unit-root workflow (ADF, KPSS, check_stationarity, and the one-call check_series battery with model recommendations); specification and stability tests (White, Breusch-Pagan, RESET, Chow, CUSUM); robust and HAC standard errors; the bootstrap family; an exact-diffuse Kalman filter; ARIMA, GARCH/GJR/EGARCH, and GAS score-driven volatility; VAR/SVAR with sign-restricted identification, FAVAR, and Diebold-Yilmaz connectedness; local projections (lag-augmented, LP-IV, state-dependent, and the Ramey-Zubairy integral multiplier); a Minnesota-NIW Bayesian VAR; GMM and IV-GMM; predictive regressions with IVX inference; heterogeneous panels (mean group, CCE-MG, PMG); cointegration and Markov switching; MIDAS and DFM nowcasting with a news decomposition; multivariate GARCH; realized volatility; spectral analysis; long memory; recession-probability models; survey-expectations tools; the Nelson-Siegel/Svensson term structure with the arbitrage-free (AFNS) adjustment; and a linear rational-expectations (DSGE-lite) solver.

The library ships with complete type stubs (py.typed), so autocomplete and type checking work out of the box.

Learn more

The full documentation — a 15-chapter guide to time series econometrics, model cards for every estimator family, a worked figure gallery, two replications of published results, a Monte Carlo validation suite, and an honest benchmark harness — lives in the project repository.

License

MIT OR Apache-2.0.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tsecon-0.3.0.tar.gz (1.7 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

tsecon-0.3.0-cp39-abi3-win_amd64.whl (4.3 MB view details)

Uploaded CPython 3.9+Windows x86-64

tsecon-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (4.9 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.17+ x86-64

tsecon-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (4.0 MB view details)

Uploaded CPython 3.9+manylinux: glibc 2.17+ ARM64

tsecon-0.3.0-cp39-abi3-macosx_11_0_arm64.whl (3.6 MB view details)

Uploaded CPython 3.9+macOS 11.0+ ARM64

File details

Details for the file tsecon-0.3.0.tar.gz.

File metadata

  • Download URL: tsecon-0.3.0.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tsecon-0.3.0.tar.gz
Algorithm Hash digest
SHA256 87e228f0028ccc660c403f4cf4864bd2d60306aa920ce5bb08c1ac7b07b821fd
MD5 c8413404ee6651dc052038fc289eca1a
BLAKE2b-256 10aa9c639b85ccdfc9a5d99bee05e383ccac77a0fd5312b05cf34080450588ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsecon-0.3.0.tar.gz:

Publisher: release.yml on cacoleman16/tsecon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tsecon-0.3.0-cp39-abi3-win_amd64.whl.

File metadata

  • Download URL: tsecon-0.3.0-cp39-abi3-win_amd64.whl
  • Upload date:
  • Size: 4.3 MB
  • Tags: CPython 3.9+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tsecon-0.3.0-cp39-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 de4932b032c967e04a549e8a2f5d6ae704ccccab7b653b9988dc032be2a46e0f
MD5 8fb1fd9221b673a569b797ecef3251c0
BLAKE2b-256 d9138328bfad7b7195dc49cb7400b80d95f3027c9b4f836362c3c15142335a39

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsecon-0.3.0-cp39-abi3-win_amd64.whl:

Publisher: release.yml on cacoleman16/tsecon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tsecon-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for tsecon-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f4e694845aaa99c5923aa457697de58bef4c3b551c56ebd744c05a5e86d19142
MD5 6fd17d1aaaf580be621f70946209c73a
BLAKE2b-256 9347cce786c55e85243e5cd2a3c9aad66cefabb1fccfb4851825236c0b4f06dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsecon-0.3.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on cacoleman16/tsecon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tsecon-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for tsecon-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 d3ac8e0982014afb7fe5874738434a8a8e7ebeee368022c275e01cbb35c8c05a
MD5 ffdab2118a7ff65b884415c19ae98625
BLAKE2b-256 b255fc248697c6cb976f442b20d624b3c1974e03e984789be93844a701297b3c

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsecon-0.3.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on cacoleman16/tsecon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tsecon-0.3.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for tsecon-0.3.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2c8ad3581703ecc774f8c0923d84e1964e8d58ca8247b2966849f1840b435860
MD5 d52498e2b2981305516d8e4ba205fb3e
BLAKE2b-256 a5afb5fcf02a54b3bf62f4f4d710351d0364369eeb4e796b4e6a255760f9ecbe

See more details on using hashes here.

Provenance

The following attestation bundles were made for tsecon-0.3.0-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on cacoleman16/tsecon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.6.0

5 files

0.5.0

5 files

0.4.0

5 files

This release

0.3.0 This release

5 files

0.2.0

5 files

0.1.0

5 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page