E3 - Generate Linear ECM Objects
E3 - Generate Linear ECM Objects
Script Family
Series E - ECM Modelling
Purpose
Places linear ECM objects along selected reference lines.
When to Use
Use E3 for continuous linear street furniture represented by Feature Lines or 3D Polylines, such as railings or barriers.
Inputs
- Geometry Source Selection: valid Feature Lines or 3D Polylines.
- Feature Code Override.
- Style Type Override.
- Style Variant Override.
- Bypass Terminals toggles.
- Component Index Overrides for leading, intermediate, and trailing sections.
- Post Distribution Method: By Distribution or By Vertex.
- Post Interval Override.
- Generate Property Sets toggle.
- Clear Existing Linear ECM Objects toggle for rectification.
Outputs
- Linear ECM Objects along selected reference line geometry.
- Optional Property Sets attached to generated ECM Objects.
Workflow Summary
- Verify the direction of the reference line, because the starting point dictates generation direction.
- Select valid Feature Lines or 3D Polylines.
- Apply Style Code overrides if underlying COGO Points lack assigned Style Codes or a uniform style is required.
- Configure terminal skipping and component index overrides.
- Choose post distribution method and interval override.
- Enable Property Set generation when required.
- Run the script and save the drawing after successful generation.
Related HAPI Concepts
- Style_Code
- Linear_Style_Code if created later
- Style_Code_Input_Mechanisms
- Typical_ECM_Modelling_Workflow
- Segment_Type_Indicator
Related File Formats
None directly. Style data may originate from Raw Descriptions imported through ECM_Ready_CSV_File_Format.
Reverse-Engineering Notes
When reverse-engineering this Dynamo graph, identify:
- How line direction is determined and used.
- How Feature Code and Style Code are extracted from selected linework.
- How vertex-based Style Code propagation is applied.
- How terminal bypass toggles affect generated components.
- How component index overrides are mapped.
- How By Distribution and By Vertex post placement differ.
- How computationally intensive generation is staged to reduce Civil 3D instability.
Source Basis
- Primary source:
HAPI User Manual.pdf, Section 3.3.2. - This note is a manual-facing script overview, not a PythonNet3 implementation specification.
Open Questions
- Confirm whether the script uses Feature Line vertex COGO Points directly or reconstructs style transitions from other metadata.
