drawing_tools.helpers package

Subpackages

• drawing_tools.helpers.dimension package
  • Submodules
  • drawing_tools.helpers.dimension.constraint_points module
    • DimensionConstraintPoint
      • DimensionConstraintPoint.point
      • DimensionConstraintPoint.source_type
      • DimensionConstraintPoint.source_object
      • DimensionConstraintPoint.source_index
      • DimensionConstraintPoint.direction_vector
      • DimensionConstraintPoint.__post_init__()
      • DimensionConstraintPoint.matches_direction()
      • DimensionConstraintPoint.__init__()
    • DimensionConstraintPointsProcessor
      • DimensionConstraintPointsProcessor.__init__()
      • DimensionConstraintPointsProcessor.constraint_points
      • DimensionConstraintPointsProcessor.constraint_points_simple
      • DimensionConstraintPointsProcessor.geometry_constraint_points
  • drawing_tools.helpers.dimension.geometry module
    • find_edges_near_points()
  • Module contents
    • DimensionConstraintPoint
      • DimensionConstraintPoint.point
      • DimensionConstraintPoint.source_type
      • DimensionConstraintPoint.source_object
      • DimensionConstraintPoint.source_index
      • DimensionConstraintPoint.direction_vector
      • DimensionConstraintPoint.__post_init__()
      • DimensionConstraintPoint.matches_direction()
      • DimensionConstraintPoint.__init__()
    • DimensionConstraintPointsProcessor
      • DimensionConstraintPointsProcessor.__init__()
      • DimensionConstraintPointsProcessor.constraint_points
      • DimensionConstraintPointsProcessor.constraint_points_simple
      • DimensionConstraintPointsProcessor.geometry_constraint_points
    • find_edges_near_points()
• drawing_tools.helpers.visualization package
  • Production overlays (overlays/)
  • drawing_tools.helpers.visualization.overlays.featured module
    • build_detection_view_frame_primitive()
    • collect_view_index_overlay_primitives()
    • collect_balloon_overlay_primitives()
    • collect_balloon_flags_overlay_primitives()
    • collect_bonding_symbol_overlay_primitives()
    • collect_aircraft_orientation_overlay_primitives()
    • collect_section_line_overlay_primitives()
    • collect_aircraft_reference_line_overlay_primitives()
    • collect_title_overlay_primitives()
    • collect_auxiliary_view_indicator_overlay_primitives()
    • collect_all_identifier_overlay_primitives()
    • collect_sheet_title_overlay_primitives()
    • collect_sheet_section_line_overlay_primitives()
    • collect_sheet_aircraft_reference_line_overlay_primitives()
    • collect_sheet_table_overlay_primitives()
    • collect_sheet_balloon_overlay_primitives()
    • collect_sheet_bonding_symbol_overlay_primitives()
    • collect_sheet_aircraft_orientation_overlay_primitives()
    • collect_sheet_balloon_flags_overlay_primitives()
    • collect_sheet_sets_overlay_primitives()
    • collect_sheet_auxiliary_view_indicator_overlay_primitives()
    • collect_sheet_all_identifier_overlay_primitives()
    • collect_composite_arrow_leaders()
    • collect_view_arrow_head_overlay_primitives()
    • collect_view_leader_overlay_primitives()
    • collect_sheet_composite_arrow_leaders()
    • collect_sheet_arrow_head_overlay_primitives()
    • collect_sheet_leader_overlay_primitives()
  • drawing_tools.helpers.visualization.overlays.verdict module
    • Design principles
    • CalloutArrowConfig
      • CalloutArrowConfig.line_width
      • CalloutArrowConfig.head_length
      • CalloutArrowConfig.head_half_angle_deg
      • CalloutArrowConfig.start_gap
      • CalloutArrowConfig.end_gap
      • CalloutArrowConfig.__init__()
    • VerdictBoxConfig
      • VerdictBoxConfig.left
      • VerdictBoxConfig.right
      • VerdictBoxConfig.top
      • VerdictBoxConfig.bottom
      • VerdictBoxConfig.fill_color
      • VerdictBoxConfig.opacity
      • VerdictBoxConfig.line_width
      • VerdictBoxConfig.__init__()
    • VerdictGlyphConfig
      • VerdictGlyphConfig.corner
      • VerdictGlyphConfig.gap
      • VerdictGlyphConfig.height
      • VerdictGlyphConfig.font_size
      • VerdictGlyphConfig.on
      • VerdictGlyphConfig.__init__()
    • VerdictLabelConfig
      • VerdictLabelConfig.side
      • VerdictLabelConfig.gap
      • VerdictLabelConfig.height
      • VerdictLabelConfig.font_size
      • VerdictLabelConfig.bold
      • VerdictLabelConfig.line_gap
      • VerdictLabelConfig.__init__()
    • Viz
      • Viz.__init__()
      • Viz.bounding_rectangle
    • arrow()
    • callout()
    • closest_edge_point()
    • estimate_text_bbox()
    • highlight()
    • highlight_text()
    • link()
    • rectangle()
    • stacked_texts()
    • status_symbol()
    • text()
    • verdict_overlay()
  • drawing_tools.helpers.visualization.overlays.sheet_sets module
    • ViewWithAssignedSet
      • ViewWithAssignedSet.view_name
      • ViewWithAssignedSet.bounding_rectangle
      • ViewWithAssignedSet.set_name
      • ViewWithAssignedSet.set_color
      • ViewWithAssignedSet.ratio
      • ViewWithAssignedSet.contained_edges
    • SheetSetsSketcher
      • SheetSetsSketcher.__init__()
      • SheetSetsSketcher.plot_data_primitives()
    • get_sets_plot_data_primitives()
    • get_view_assigned_set_primitives()
  • drawing_tools.helpers.visualization.overlays.detected_table module
    • DEFAULT_CELL_FILL_RGB
    • TableCellSketcher
      • TableCellSketcher.__init__()
      • TableCellSketcher.plot_data_primitives()
    • DetectedTableSketcher
      • DetectedTableSketcher.__init__()
      • DetectedTableSketcher.bounds
      • DetectedTableSketcher.plot_data_primitives()
      • DetectedTableSketcher.cells_primitives()
    • TABLE_FRAME_LINE_WIDTH
    • TABLE_LABEL_HEIGHT_RATIO
    • collect_table_overlay_primitives()
  • Other modules
  • drawing_tools.helpers.visualization.palette module
    • cycle_color()
  • drawing_tools.helpers.visualization.edge_constraint_graph module
    • LabelParameters
      • LabelParameters.symbol
      • LabelParameters.point_key
      • LabelParameters.offset_x
      • LabelParameters.offset_y
      • LabelParameters.tooltip
      • LabelParameters.__init__()
    • RelationshipVisualizationConfig
      • RelationshipVisualizationConfig.RELATIONSHIP_COLORS
      • RelationshipVisualizationConfig.RELATIONSHIP_LINE_STYLES
      • RelationshipVisualizationConfig.CONNECTION_POINT_SIZE
      • RelationshipVisualizationConfig.EDGE_LINE_WIDTH
      • RelationshipVisualizationConfig.RELATIONSHIP_LINE_WIDTH
      • RelationshipVisualizationConfig.SYMBOL_SIZE
      • RelationshipVisualizationConfig.TEXT_SIZE
      • RelationshipVisualizationConfig.HIGHLIGHT_WIDTH
      • RelationshipVisualizationConfig.ANNOTATION_OFFSET
      • RelationshipVisualizationConfig.LEGEND_START_X
      • RelationshipVisualizationConfig.LEGEND_START_Y
      • RelationshipVisualizationConfig.LEGEND_ROW_HEIGHT
      • RelationshipVisualizationConfig.LEGEND_LINE_LENGTH
      • RelationshipVisualizationConfig.LEGEND_TEXT_OFFSET
      • RelationshipVisualizationConfig.TITLE_FONT_SIZE
      • RelationshipVisualizationConfig.TITLE_OFFSET_Y
      • RelationshipVisualizationConfig.DEFAULT_TITLE_X
      • RelationshipVisualizationConfig.DEFAULT_TITLE_Y
      • RelationshipVisualizationConfig.SYMMETRY_AXIS_EXTENT
      • RelationshipVisualizationConfig.SYMMETRY_AXIS_PATTERN
      • RelationshipVisualizationConfig.ARROW_SIZE_FACTOR
      • RelationshipVisualizationConfig.ARROW_HEAD_SIZE_FACTOR
      • RelationshipVisualizationConfig.ARROW_PERPENDICULAR_FACTOR
      • RelationshipVisualizationConfig.INTERSECTION_TOLERANCE
    • BaseRelationshipVisualizer
      • BaseRelationshipVisualizer.__init__()
      • BaseRelationshipVisualizer.visualize_relationship()
    • CoincidentRelationshipVisualizer
    • TangentRelationshipVisualizer
    • ConcentricRelationshipVisualizer
    • ParallelRelationshipVisualizer
    • PerpendicularRelationshipVisualizer
    • SymmetricRelationshipVisualizer
    • EdgeConstraintGraphVisualizer
      • EdgeConstraintGraphVisualizer.__init__()
      • EdgeConstraintGraphVisualizer.visualize_graph()
      • EdgeConstraintGraphVisualizer.create_relationship_legend()
      • EdgeConstraintGraphVisualizer.plot_constraint_graph()
    • visualize_view_constraint_graph()
    • analyze_constraint_graph_patterns()
  • Developer diagnostics (debug/)
  • drawing_tools.helpers.visualization.debug.sheet_table_detector module
    • VisualizationColors
      • VisualizationColors.KEPT_LINE
      • VisualizationColors.REJECTED_LINE
      • VisualizationColors.PROCESSED_LINE
      • VisualizationColors.NEIGHBORHOOD
      • VisualizationColors.CONNECTION
      • VisualizationColors.CLUSTER
      • VisualizationColors.TEXT
      • VisualizationColors.BORDER
      • VisualizationColors.BACKGROUND
    • VisualizationLayout
      • VisualizationLayout.PANEL_MARGIN_X
      • VisualizationLayout.PANEL_MARGIN_Y
      • VisualizationLayout.PANEL_SPACING_Y
      • VisualizationLayout.LINE_HEIGHT
      • VisualizationLayout.LABEL_OFFSET_Y
      • VisualizationLayout.HEADER_FONT_SIZE
      • VisualizationLayout.NORMAL_FONT_SIZE
      • VisualizationLayout.INFO_FONT_SIZE
      • VisualizationLayout.ELLIPSE_SEGMENTS
      • VisualizationLayout.KEPT_LINE_WIDTH
      • VisualizationLayout.REJECTED_LINE_WIDTH
      • VisualizationLayout.NEIGHBORHOOD_LINE_WIDTH
      • VisualizationLayout.CONNECTION_LINE_WIDTH
      • VisualizationLayout.CENTER_MARKER_WIDTH
      • VisualizationLayout.NEIGHBORHOOD_DASH
      • VisualizationLayout.CONNECTION_DASH
      • VisualizationLayout.STATS_HEADER
      • VisualizationLayout.STATS_SEPARATOR
    • ConnectivityFilterVisualizer
      • ConnectivityFilterVisualizer.__init__()
      • ConnectivityFilterVisualizer.generate_plot()
      • ConnectivityFilterVisualizer.draw_lines()
      • ConnectivityFilterVisualizer.draw_neighborhoods()
      • ConnectivityFilterVisualizer.draw_connections()
      • ConnectivityFilterVisualizer.add_statistics_panel()
      • ConnectivityFilterVisualizer.add_color_legend()
      • ConnectivityFilterVisualizer.add_rejected_lines_info()
  • drawing_tools.helpers.visualization.debug.table_detection_pipeline module
    • TableDetectionVisualizer
      • TableDetectionVisualizer.__init__()
      • TableDetectionVisualizer.step_names
      • TableDetectionVisualizer.get_step_primitives()
      • TableDetectionVisualizer.visualize_step()
  • Module contents

Submodules

drawing_tools.helpers.geometry module

Generic geometry helper functions.

HORIZONTAL and VERTICAL are the orientation vocabulary orientation_from_direction() returns, and the one every caller compares against; a direction aligned with neither is reported as None rather than by a third value. Orientation types that vocabulary, so a stray string is caught by the type checker rather than at the dictionary lookup it would fail in. AXIS_ALIGNMENT_TOLERANCE is the aperture that decides it, as the sine of the largest angle still read as aligned. It is deliberately not called an angle tolerance: the balloon helpers already export a HORIZONTAL_ANGLE_TOLERANCE measured in radians, and the two must not be confused.

drawing_tools.helpers.geometry.points_coincide(p1: Any, p2: Any, tolerance: float = 1e-06) → bool

Check if two points are at the same position within tolerance.

Parameters:

• p1 – First point with x and y attributes.

• p2 – Second point with x and y attributes.

• tolerance – Maximum distance per axis for coincidence.

Returns:

True if both coordinates match within tolerance.

drawing_tools.helpers.geometry.segments_coincide(seg_a: Any, seg_b: Any, tolerance: float = 1e-06) → bool

Check if two segments are coincident (same endpoints, possibly reversed).

Parameters:

• seg_a – First segment with start and end attributes.

• seg_b – Second segment with start and end attributes.

• tolerance – Point coincidence tolerance.

Returns:

True if the segments share the same endpoints.

drawing_tools.helpers.geometry.is_full_circle(edge: Edge) → bool

Check whether an edge is an arc sweeping a full turn.

Parameters:

edge – The edge to test.

Returns:

True for a closed circle (a FullArc2D, or an Arc2D of angle 2 pi).

drawing_tools.helpers.geometry.get_arc_radius(edge: Edge) → float

Get the radius of an arc edge.

Works around Edge.get_arc_radius, which returns self.radius instead of the geometry’s and therefore raises AttributeError for EVERY arc — an upstream dessia_drawing typo. Its sibling Edge.get_arc_center is fine and is used directly.

Parameters:

edge – An arc edge (Arc2D or FullArc2D); anything else raises AttributeError.

Returns:

The radius.

drawing_tools.helpers.geometry.is_segment_inside_circle(segment: Edge, center: Point2D, radius: float) → bool

Check whether both endpoints of a straight segment lie inside a circle.

Containment of the whole segment follows only because a disk is convex, so this holds for a LINE SEGMENT: on a curved edge, both endpoints inside says nothing about the middle.

Parameters:

• segment – The line segment to test.

• center – The circle center.

• radius – The circle radius.

Returns:

True when both endpoints lie inside the circle.

drawing_tools.helpers.geometry.orientation_from_direction(direction_x: float, direction_y: float, tolerance: float = 0.09) → Literal['horizontal', 'vertical'] | None

Tell whether a direction runs horizontally, vertically, or neither.

Works for anything that has a direction: a segment through its direction vector, a text through (cos(angle), sin(angle)). The off-axis component is compared to the tolerance scaled by the vector’s own norm, so the tolerance reads as the sine of the largest angle still accepted as aligned whatever the length of the vector passed in. A direction of zero length points nowhere and is reported as such.

Parameters:

• direction_x – Horizontal component of the direction.

• direction_y – Vertical component of the direction.

• tolerance – Sine of the maximum angle to an axis for the direction to count as aligned with it.

Returns:

HORIZONTAL, VERTICAL, or None for an oblique or null direction.

Module contents

Package initialization.