# trace_splitter

**Reliability status**: `stable`

```{eval-rst}
.. argparse::
   :ref: traceratops.trace_splitter.parse_arguments
   :prog: trace_splitter
```

## Output Files

For each trace file analyzed, the script generates:

1. `[tracefile]_split.ecsv`: Trace table containing the original un-split traces plus the split traces, with updated `Trace_ID` values. When `--output` is provided for a single input, that exact path is used instead.

## Examples

```
trace_splitter --input original_traces.ecsv --std_threshold 1.5 --num_clusters 3
```

Given a chromatin trace table, this script:
   - Computes radius of gyration (Rg) for all traces.
   - Identifies traces with Rg larger than `mean + N * std_dev`.
   - Uses K-means to split these traces into `num_clusters`.
   - Saves the modified trace table with updated Trace_IDs.

## Notes

- See the command-line reference above for the complete option list.