.. _auto_connection_topology_aggregator:

*CONNECTION TOPOLOGY AGGREGATOR*
================================

Aggregates raw connection edges into part-to-part pairs with counts, dominant types, total mass / length / stiffness. Filters to the top-N highest-degree parts and applies a minimum-count threshold so very large models (thousands of edges) render as a tractable graph. Pipe normalized edges from ConnectionTopologyParserWorker into this.

When to use
-----------

Tagged: ``aggregation``, ``graph``, ``topology``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Edges
     - edges
     - dataset
     - —
     - 
     - Normalized connection edges (output of ConnectionTopologyParserWorker.edges).
   * - Top-N Parts
     - top_n_parts
     - integer
     - 150
     - 
     - Keep only the top-N parts by degree to limit graph size.
   * - Min Pair Count
     - min_pair_count
     - integer
     - 1
     - 
     - Drop part-pairs with fewer than this many connections (set to 2+ to hide one-off ties for cleaner view).
   * - Type Filter
     - type_filter
     - string
     - —
     - 
     - Comma-separated connection_type whitelist (e.g. 'CONSTRAINED_SPOTWELD,ELEMENT_BEAM'). Empty = all types.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Pair Edges
     - pair_edges
     - dataset
     - Aggregated edges — one row per unique part-pair: {source, target, count, types, total_mass, total_length, total_stiffness}.
   * - Visible Edges
     - visible_edges
     - dataset
     - Subset of pair_edges restricted to top-N parts (ready for graph rendering).
   * - Top Parts
     - top_parts
     - dataset
     - Top-N parts sorted by degree.
   * - Stats
     - stats
     - dataset
     - Aggregation counts + filter parameters.

Disciplines
-----------

- engineering.structural.topology

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>connection_topology_aggregator</code>. Schema hash: <code>aac588e919e2</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>