Auto Structure Groups
auto_structure_groupsCreates one structure group per section, per material, or per section + material pair, with the Auto Structure Groups plugin's own engine: it reads every element's section and material, names each group from the prefix and the section/material names (cleaned and cut to 40 characters, as in the plugin; elements with no section/material go to UNASSIGNED), largest group first. Optional: include each group's nodes, skip groups with fewer than minElements elements, or write only the groups named in groups. A name that already exists is skipped unless existing: 'overwrite' — and then this run's members are ADDED to that group (CIVIL NX merges a write into an existing group; it never removes members). Previews unless apply: true with confirmPlanHash; the plugin's writer re-reads db/GRUP, writes in batches and checks the read-back. auto_structure_groups_undo reverses it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | What one group holds: one section, one section + material pair, or one material. | section |
| apply | No | Write to CIVIL NX. Only after the user approved the preview. | |
| groups | No | Write only these proposed groups (names from the preview); default all. | |
| prefix | No | Put in front of every group name. | SG_ |
| existing | No | A proposed name that already exists: leave that group alone, or add this run's members to it. | skip |
| minElements | No | Skip groups with fewer elements than this (2 or more turns the filter on). | |
| includeNodes | No | Also put each group's element nodes in the group. | |
| confirmPlanHash | No | planHash from the approved preview; the write is refused if the plan differs. |