Skip to main content

ts-shape

PyPI Release Docs License: MIT

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.

Parts of this library were developed with the assistance of Claude, Anthropic's AI assistant. All code is reviewed and maintained by the project authors.

Metadata

Release files for ts-shape 0.0.76

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.76
File Size Uploaded Provenance
ts_shape-0.0.76.tar.gz 1.6 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for ts-shape 0.0.76
File Interpreter ABI Platform
ts_shape-0.0.76-py3-none-any.whl Python 3 none any Details

Total release size: 2.5 MB

Release files / ts_shape-0.0.76.tar.gz

Download URL ts_shape-0.0.76.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
5c86c306d811068fc4e56b1d4842eb723a1e0a9d0ddaeb77edc9ae3b147a4c6b
BLAKE2b-256 checksum
How to use checksums
1c484103a4f19c1b019bf72a8315976a0b84019c854ae36ee88d036b886be9a4
Upload date
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.76-py3-none-any.whl

Download URL ts_shape-0.0.76-py3-none-any.whl
Size 821.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ab05d306b32ff4245d542ac68cefd7e28464afbc7ab0e763597d92d8852ed7b3
BLAKE2b-256 checksum
How to use checksums
416aa1ffa28eb4d389c9762d974dacff7dcc7c10392a4ed64996e5da28fb238f
Upload date
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.76

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.

Release history Release notifications | RSS feed

This release

0.0.76 This release

2 release files No provenance

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