Skip to content

Product Traceability¤

Track parts through single stations, multi-step routings, or parallel process lines. Three classes provide increasing levels of traceability complexity.

Traceability Levels¤

flowchart LR
    subgraph L1["<b>Level 1 — Value</b><br/><i>simplest</i>"]
        V1["Part ID signal at<br/>a single station"]
    end

    subgraph L2["<b>Level 2 — Routing</b><br/><i>multi-step</i>"]
        R1["Station 1"] --> R2["Station 2"] --> R3["Station 3"]
    end

    subgraph L3["<b>Level 3 — Multi-Process</b><br/><i>parallel lines</i>"]
        direction TB
        M1["Line A: Press → Weld"]
        M2["Line B: Mill → Drill"]
        M3["Assembly"]
        M1 --> M3
        M2 --> M3
    end

    L1 ~~~ L2 ~~~ L3

    style L1 fill:#14532d,stroke:#22c55e,color:#dcfce7
    style L2 fill:#1a3a4a,stroke:#f59e0b,color:#fef3c7
    style L3 fill:#1a3a4a,stroke:#ef4444,color:#fecaca
Class Use When Signals Required
ValueTraceabilityEvents Single station, one ID signal Part ID (string)
RoutingTraceabilityEvents Sequential stations with routing/state signal Part ID + routing/state (integer)
MultiProcessTraceabilityEvents Parallel lines with handovers Multiple Part IDs + handover signals

Level 1 — Value Traceability¤

Track a part ID at a single station. The simplest form of traceability.

from ts_shape.events.production.value_traceability import ValueTraceabilityEvents

trace = ValueTraceabilityEvents(
    dataframe=df,
    id_uuid='part_id_signal',
    station_uuids=['station_1_present', 'station_2_present'],
)

# Build timeline: when each part was at each station
timeline = trace.build_timeline()

# Lead time per part (first seen → last seen)
lead_times = trace.lead_time()

# Station dwell time statistics
station_stats = trace.station_statistics()

Level 2 — Routing Traceability¤

Track parts through a sequential routing — correlate the part ID signal with a state/routing signal that indicates which step the part is at.

from ts_shape.events.production.routing_traceability import RoutingTraceabilityEvents

trace = RoutingTraceabilityEvents(
    dataframe=df,
    id_uuid='part_id_signal',
    routing_uuid='routing_step_signal',
    state_map={1: 'Loading', 2: 'Processing', 3: 'Inspection', 4: 'Unloading'},
    station_map={10: 'Station A', 20: 'Station B', 30: 'Station C'},
)

# Correlate ID with routing state — full timeline
timeline = trace.build_routing_timeline()

# End-to-end lead time per item
lead_times = trace.lead_time()

# Dwell-time statistics per station/step
station_stats = trace.station_statistics()

# Routing path frequency — which sequences are most common
paths = trace.routing_paths()

Level 3 — Multi-Process Traceability¤

Track parts across parallel process lines with handover events between them.

from ts_shape.events.production.multi_process_traceability import MultiProcessTraceabilityEvents

trace = MultiProcessTraceabilityEvents(
    dataframe=df,
    processes=[
        {'id_uuid': 'line_a_part_id', 'station_uuids': ['press_present', 'weld_present']},
        {'id_uuid': 'line_b_part_id', 'station_uuids': ['mill_present', 'drill_present']},
        {'id_uuid': 'assembly_part_id', 'station_uuids': ['assy_present']},
    ],
    handovers=[
        {'from_id_uuid': 'line_a_part_id', 'to_id_uuid': 'assembly_part_id'},
        {'from_id_uuid': 'line_b_part_id', 'to_id_uuid': 'assembly_part_id'},
    ],
)

# Full timeline across all processes
timeline = trace.build_timeline()

# End-to-end lead time across all processes
lead_times = trace.lead_time()

# Find items processed at multiple stations simultaneously
parallel = trace.parallel_activity()

# Handover events log
handover_log = trace.handover_log()

# Station dwell statistics across all processes
station_stats = trace.station_statistics()

# Routing path frequencies
paths = trace.routing_paths()

Choosing the Right Level¤

flowchart TD
    Q1{"How many<br/>process lines?"} -->|"One line"| Q2{"Does the part<br/>visit multiple stations?"}
    Q1 -->|"Multiple lines<br/>with handovers"| L3["<b>Multi-Process</b><br/>MultiProcessTraceabilityEvents"]

    Q2 -->|"Single station"| L1["<b>Value</b><br/>ValueTraceabilityEvents"]
    Q2 -->|"Multiple stations<br/>in sequence"| L2["<b>Routing</b><br/>RoutingTraceabilityEvents"]

    style L1 fill:#14532d,stroke:#22c55e,color:#dcfce7
    style L2 fill:#1a3a4a,stroke:#f59e0b,color:#fef3c7
    style L3 fill:#1a3a4a,stroke:#ef4444,color:#fecaca

Next Steps¤