.. _auto_connection_topology_parser:

*CONNECTION TOPOLOGY PARSER*
============================

Parses connection topology data from a CSV/Excel/JSON file OR from an inline edges array. Canonical upstream source: pipe `peacock_parser` with tasks=['keyword_conn'] to get the model's connections.json file, then pass it here for normalization. Also accepts user-uploaded CSV with PART1 / PART2 / CONNECTION_ID / CONNECTION_TYPE columns. Normalizes column aliases, validates required fields, and returns clean edge records plus a summary (connection-type counts, stiffness-type counts, unique part count) and per-part degree.

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

Tagged: ``csv``, ``excel``, ``import``, ``json``, ``parser``, ``topology``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Topology File
     - topology_file
     - file
     - —
     - 
     - CSV / Excel / JSON file. JSON: array of connection objects. CSV: columns PART1,PART2,CONNECTION_ID,CONNECTION_TYPE (case-insensitive).
   * - Raw Edges
     - raw_edges
     - dataset
     - —
     - 
     - Alternative to file — inline array of connection records (used when piped from peacock_parser's keyword_conn output or a getConnections() callback).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Normalized Edges
     - edges
     - dataset
     - Clean array of {connection_id, connection_type, from_part_id, to_part_id, length, mass, stiffness, stiffness_type, from_node_id, to_node_id, from_xyz, to_xyz}.
   * - Summary
     - summary
     - dataset
     - Total connections, connection-type counts, stiffness-type counts, total mass, total length, unique-part count.
   * - Part Degree
     - part_degree
     - dataset
     - Per-part connection count (sorted descending).
   * - Rejected Rows
     - rejected
     - dataset
     - Rows that failed schema validation.

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

- engineering.structural.topology
- data.import

.. 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_parser</code>. Schema hash: <code>14c8f4b7b6f0</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>