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
import ts_shape
from ts_shape.eventlog import concat, to_event_log

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

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

outliers = ts_shape.OutlierDetectionEvents(temp, value_column="value_double").detect_outliers_zscore(threshold=4.0)
intervals = ts_shape.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 detector classes. The examples/ folder has one self-contained script per area of the library.

Metadata

Release files for ts-shape 0.0.67

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.67
File	Size	Uploaded
ts_shape-0.0.67.tar.gz	1.3 MB	Oct 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ts-shape 0.0.67
File	Interpreter	ABI	Platform	Reset
ts_shape-0.0.67-py3-none-any.whl 685.1 kB Oct 15, 2026	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / ts_shape-0.0.67.tar.gz

Download URL	ts_shape-0.0.67.tar.gz
Size	1.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`513ade777c04a14903c9b3e33a3b0691e54b96505596cab3ec2ff5924bc15118`
BLAKE2b-256 checksum How to use checksums	`1dce1dca11b292fec7e22bd81d7066f4bb92db30afe69b7b2f8600938963a67e`
Upload date	Oct 15, 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.67-py3-none-any.whl

Download URL	ts_shape-0.0.67-py3-none-any.whl
Size	685.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b3c3107c50df0e46e25943fef235526b2d705e99a1d11fd96eb3eb125ecb822d`
BLAKE2b-256 checksum How to use checksums	`ef4d138e4451da9b124a5294e2ec0e337299777f010e38040769b05341158051`
Upload date	Oct 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`