Time Split
Time-based k-fold validation splits for heterogeneous data.
Folds plotted on a two-by-two grid. See the examples page for more.
What is it?
A library for creating time-based cross-validation splits of heterogeneous data, such as raw transaction data with strong non-stationary characteristics.
Highlighted Features
- Splitting schedules based on a fixed interval, a CRON-expression, or a pre-defined list.
- Data selection based on a timedelta, or the splitting schedule itself.
- Automatically extract and normalize data limits for supported data types.
- Plotting function for visualization of folds. Display fold sizes (hour/row count), or use custom text.
- Integrations for popular
libraries such as
pandas,polarsandscikit-learn. - Convenient web application for exploring folds with different parameters.
Experimenting with parameters
The Time Split application (available here) is designed to help evaluate the effects of different parameters. To start it locally, run
docker run -p 8501:8501 rsundqvist/time-split
or
pip install time-split[app]
python -m time_split app start
in the terminal. You may use
create_explorer_link()
to build application URLs with preselected splitting parameters.
Click here for documentation of the most important types, functions and classes used by the application.
Installation
The package is published through the Python Package Index (PyPI). Source code is available on GitHub: https://github.com/rsundqvist/time-split
pip install -U time-split
This is the preferred method to install time-split, as it will always install the
most recent stable release.
License
Documentation
Hosted on Read the Docs: https://time-split.readthedocs.io
Contributing
All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome. To get started, see the Contributing Guide and Code of Conduct.
Metadata
Release files for time-split 1.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| time_split-1.2.2.tar.gz | 36.5 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| time_split-1.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.4 kB
Release files / time_split-1.2.2.tar.gz
| Download URL | time_split-1.2.2.tar.gz |
|---|---|
| Size | 36.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1d0e88173c47a2e22f060d6d7441bff58f41189c451e2fdd0fb7c0f4fe524195
|
|
BLAKE2b-256 checksum How to use checksums |
2019a62fa6a10b5426d91f11d48582b13dc9858360c3b8a2d7b1b6ed247f96f7
|
| 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 Oct 22, 2026.
Transparency logRelease files / time_split-1.2.2-py3-none-any.whl
| Download URL | time_split-1.2.2-py3-none-any.whl |
|---|---|
| Size | 47.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
63f6cc9aaf37bc9c655129f68760d95f85935317102fa83b3482610e6cbec921
|
|
BLAKE2b-256 checksum How to use checksums |
8f8f406dcebbfaa4fa8e52b91c7e09ad5264084a87083be01e5ef33f7618d7af
|
| 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 Oct 22, 2026.
Transparency logSecurity for time-split 1.2.2
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for time_split-1.2.2.tar.gz
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 Oct 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.