Commands  ›  Annotation  ›  Annotation Merge Adjacent Dimension Strings

Annotation Merge Adjacent Dimension Strings

Annotation writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document open; active view is a View; at least two Dimension ids supplied.

After it runs

One new Dimension added; input Dimensions deleted. One committed Transaction.

When to use this

Don't use this when

Non-collinear / disjoint dimension groups.

Decision flow

1) dimension ids csv → list of ids (≥ 2). 2) Resolve each to a Dimension on the active view; validate at least two survive. Else WireError + abort. 3) Open Transaction 'Merge dimension strings'. 4) Order by curve start-X; collect each dimension's References into a single ReferenceArray; pick the first dimension's line as the merged dimension line. 5) merged = doc.Create.NewDimension(view, line, refs). 6) Delete every original dimension. 7) Commit. 8) Bot JSON / User toast. 9) Exception → tracker.Fail + WireFault.

What you'll see in the chat

on start
Merging adjacent dimension strings…
thinking
Resolving dimensions + collecting references…
Creating merged dimension and deleting originals…
on success
Merged {merged_count} dimensions into {merged_dimension_id}.
on failure
Could not merge dimensions: {error}.

REST API

Not yet exposed

This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:

  • POST /api/v1/commands/annotation_merge_adjacent_dimension_strings
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

merge dimensions · join dimension strings · running dimension · drawing presentation · tidy dimensions

PillarAnnotation