ts-shape

ts-shape is a pandas library for manufacturing and IIoT time series. It works on long-format signal data (systime, uuid, value_double / value_integer / value_bool / value_string) and provides loaders, filters, feature extraction and event detectors for production (OEE, downtime, shift reports, traceability), quality (outliers, SPC rules, capability), process engineering, maintenance, energy, supply chain and process development. Every detector takes a DataFrame and returns a DataFrame, and any detector output can be turned into an OCEL 2.0 or XES event log for process mining.

Install

pip install ts-shape

Python 3.11 or later. The core depends only on pandas, numpy and scipy. Loader backends and a few detectors need extras:

Extra	Installs	Needed for
`parquet`	pyarrow	reading parquet files
`s3`	s3fs, pyarrow	S3 loaders
`azure`	azure-storage-blob, pyarrow	Azure Blob loaders
`api`	requests	REST metadata and energy API loaders
`sql`	sqlalchemy	TimescaleDB and SQL metadata loaders
`postgres`	sqlalchemy, psycopg2-binary	`sql` plus the PostgreSQL driver
`yaml`	pyyaml	signal specs and lambda rules from YAML
`units`	pint	`UnitConverter`
`ml`	scikit-learn	Isolation Forest outlier detection
`all`	all of the above

pip install "ts-shape[parquet,azure]"

Example

import pandas as pd
from ts_shape import (
    MachineStateEvents,
    OutlierDetectionEvents,
    concat,
    make_timeseries,
    profile,
    to_event_log,
)

# Synthetic data in the standard format; use a loader or pandas for your own
temp = make_timeseries(["oven:temp"], n_points=1440, freq="1min", n_outliers=4)
running = make_timeseries(["oven:running"], n_points=1440, freq="1min", value_column="value_bool")
df = pd.concat([temp, running], ignore_index=True)

print(profile(df).summary())   # signal kinds, gaps, counter resets, duplicates

outliers = OutlierDetectionEvents(temp, value_column="value_double").detect_outliers_zscore(n_sigma=4.0)
intervals = MachineStateEvents(df, run_state_uuid="oven:running").detect_run_idle(min_duration="5min")

log = concat(
    to_event_log(outliers, detector="OutlierDetectionEvents.detect_outliers_zscore"),
    to_event_log(intervals, detector="MachineStateEvents.detect_run_idle"),
)
print(log.events[["ocel:activity", "ocel:timestamp"]].head())

ts_shape.list_detectors() lists the public classes (name, category, module): the detectors, and also the transform, feature, loader, event-log and pipeline classes. The examples/ folder has one self-contained script per area of the library.

Metadata

Release files for ts-shape 0.0.75

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ts-shape 0.0.75
File	Size	Uploaded	Provenance
ts_shape-0.0.75.tar.gz	1.6 MB	Oct 21, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for ts-shape 0.0.75
File	Interpreter	ABI	Platform	Reset
ts_shape-0.0.75-py3-none-any.whl 815.5 kB Oct 21, 2026 Without provenance	Python 3	none	any	Details

Total release size: 2.4 MB

Release files / ts_shape-0.0.75.tar.gz

Download URL	ts_shape-0.0.75.tar.gz
Size	1.6 MB
Tags	Source
SHA-256 checksum How to use checksums	`b9b82136d37617fd02ad9e895cb4f0d35819b3bb9c15490987f159dad4977282`
BLAKE2b-256 checksum How to use checksums	`5d6e2ff595c9b2ded5f280208fd372ee64823e02d51a054ac8aad68e30f3981a`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / ts_shape-0.0.75-py3-none-any.whl

Download URL	ts_shape-0.0.75-py3-none-any.whl
Size	815.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7f7359127e4b80352199cb94ee5e40bc9dee8d28141e1a47f42888d81499a0ca`
BLAKE2b-256 checksum How to use checksums	`52328afdd9c890f44c129cbcdf4e1c2eecb14c6fec46d5f37fc266c5e97afe77`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Security for ts-shape 0.0.75

Report project as malware

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A 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.