Tests one factor. Screens a thousand.
Where factrix fits
Does this factor possess predictive edge?
factrix is the first Polars-native Python toolkit that picks the right statistical test for each factor type. Cross-sectional, event, common factor — each gets the tests that fit its data-generating process.
factor construction → factrix (inference) → strategy construction → backtest → live trading
▲ you are here
For each candidate factor factrix answers — is the predictive power real? — and corrects for multiple testing when you screen at scale. Kill fakes before they cost you a backtest.
Why factrix?
- Type-routed evaluation — Information Coefficient + Fama-MacBeth for cross-sectional factors; Cumulative Average Abnormal Return for events.
- Financial statistics built in — autocorrelation-robust standard errors (Newey-West), overlapping-forward-return correction, persistent-predictor flagging (Stambaugh bias), and false-discovery-rate control across batches (Benjamini-Hochberg-Yekutieli).
- Polars-native — modern Polars alternative to the pandas-based alphalens.
factrix stops at the inference — primary test plus diagnostic battery. It does not size positions, model slippage, optimise weights, or compose alphas; those belong to the later stages of the pipeline.
Is factrix the right tool?
| You want to… | Use this |
|---|---|
| Inference on a factor (cross-sectional / event / common factor) | factrix |
| Screen many factors with multiple-testing correction | factrix |
| Backtest with positions / slippage / margin | zipline-reloaded, backtrader, bt, vectorbt, nautilus_trader |
| Optimise portfolio weights | skfolio, riskfolio-lib |
| Returns-level tear-sheet (P&L diagnostics) | pyfolio-reloaded, QuantStats |
| Familiar cross-sectional tear-sheet | alphalens-reloaded |
| End-to-end machine-learning pipeline | qlib |
| Deflated / probabilistic Sharpe today (commercial) | mlfinlab |
Installation
pip install factrix
# or
uv add factrix
See the installation guide for version pinning and development setup.
Typical usage
Single factor — IC evaluation
import factrix as fx
from factrix.metrics import ic
raw = fx.datasets.make_cs_panel(n_assets=100, n_dates=500, ic_target=0.08, seed=2024)
data = fx.preprocess.compute_forward_return(raw, forward_periods=5)
results = fx.evaluate(
data,
metrics={"ic": ic(inference=fx.inference.NEWEY_WEST)},
factor_cols=["factor"],
forward_periods=5,
)
res = results["factor"]
ic_res = res.metrics["ic"]
print('ic_mean =', round(ic_res.value, 4))
print('p_value =', round(ic_res.p_value, 4))
More scenarios, runnable end to end:
- Quickstart — same example, plus
.to_dict()output and warnings. - Multi-factor screening — BHY false-discovery-rate control across candidate factors.
- Multi-horizon evaluation — sweeping
forward_periodswithevaluate_horizons. - PANEL vs TIMESERIES — single-asset evaluation with
predictive_beta.
Documentation
- Get Started — install, quickstart, where factrix fits
- User Guide — concepts (three-axis design, architecture), how-to (PANEL vs TIMESERIES, BHY screening, slice analysis), examples
- API Reference — entry points, results, lookup tables, per-metric pages
- Development — contributing, design notes
- Release Notes — changelog
License
Released under the Apache License 2.0.
1 maintainer
Metadata
1 maintainer
Release files for factrix 0.21.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| factrix-0.21.0.tar.gz | 488.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| factrix-0.21.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 878.1 kB
Release files / factrix-0.21.0.tar.gz
| Download URL | factrix-0.21.0.tar.gz |
|---|---|
| Size | 488.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7433d3dbc2279978c9d3197774e9c1f336679057522a7d49f012446a255bf3d1
|
|
BLAKE2b-256 checksum How to use checksums |
56fed590edd66cf6301c824b30ba13638355c28b8944ab185e40cb2ea44ac304
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / factrix-0.21.0-py3-none-any.whl
| Download URL | factrix-0.21.0-py3-none-any.whl |
|---|---|
| Size | 389.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a8e531e0af8505bb407f559aef7cf5c4d26ad0c192a76486a0fe54b48e0cdb24
|
|
BLAKE2b-256 checksum How to use checksums |
d14d159cccd5cddf3d28679424de064ac95bf18062dcbfb3779ba1faa1053a27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency log
