Display & Report Methods#

Drawing Tools provides @plot_data_view and @markdown_view methods across multiple classes for visualizing and reporting enrichment results. This page lists all available methods and shows interactive examples for each FeaturedSheet view.

All `@plot_data_view` Methods#

The following table lists every @plot_data_view in the package:

Class	Method	Selector	Description
`FeaturedDrawing`	`plot_data_view()`	`2D View`	Base 2D rendering of all sheets
`FeaturedDrawing`	`plot_data_view_indexes()`	`View Indexes`	All sheets with view index labels
`FeaturedDrawing`	`plot_data_grid_reference()`	`Grid Reference`	All sheets with grid reference overlay (zones, cells, labels)
`FeaturedDrawing`	`plot_data_title_view()`	`Title View`	All sheets with parsed view title overlays
`FeaturedDrawing`	`plot_data_balloons()`	`Balloons`	All sheets with balloon overlays (groups + labels)
`FeaturedDrawing`	`plot_data_balloon_flags()`	`Balloon Flags`	All sheets with flag symbols highlighted
`FeaturedDrawing`	`plot_data_sets()`	`Sets`	All sheets with detected set regions overlaid
`FeaturedDrawing`	`plot_data_tables()`	`Tables`	All sheets with detected table overlays
`FeaturedDrawing`	`plot_data_dimensions()`	`Dimensions`	All sheets with colored dimension labels
`FeaturedDrawing`	`plot_data_geometrical_tolerances()`	`Geometrical Tolerances`	All sheets with geometrical tolerance overlays (green outlines)
`FeaturedDrawing`	`plot_data_roughness()`	`Roughness`	All sheets with roughness overlays (blue outlines)
`FeaturedDrawing`	`plot_data_section_lines()`	`Section Lines`	All sheets with section line indicator overlays
`FeaturedDrawing`	`plot_data_auxiliary_view_indicators()`	`Auxiliary View Indicators`	All sheets with auxiliary view indicator overlays
`FeaturedDrawing`	`plot_data_all_identifiers()`	`All Identifiers`	All sheets with title + section lines + auxiliary view indicators combined
`FeaturedSheet`	`plot_data_view()`	`2D View`	Base 2D rendering of one sheet
`FeaturedSheet`	`plot_data_view_indexes()`	`View Indexes`	View index labels on each view
`FeaturedSheet`	`plot_data_grid_reference()`	`Grid Reference`	Grid reference overlay (zones, cells, labels)
`FeaturedSheet`	`plot_data_title_view()`	`Title View`	Parsed view title overlays
`FeaturedSheet`	`plot_data_balloons()`	`Balloons`	Balloon overlays (groups + labels) with legend
`FeaturedSheet`	`plot_data_balloon_flags()`	`Balloon Flags`	Flag symbols (multiplicators, FM) highlighted
`FeaturedSheet`	`plot_data_sets()`	`Sets`	Detected set regions with colored rectangles
`FeaturedSheet`	`plot_data_tables()`	`Tables`	Detected table overlays with title block tag
`FeaturedSheet`	`plot_data_dimensions()`	`Dimensions`	Colored dimension labels
`FeaturedSheet`	`plot_data_geometrical_tolerances()`	`Geometrical Tolerances`	Geometrical tolerance overlays (green outlines)
`FeaturedSheet`	`plot_data_roughness()`	`Roughness`	Roughness overlays (blue outlines)
`FeaturedSheet`	`plot_data_section_lines()`	`Section Lines`	Detected section line indicator overlays
`FeaturedSheet`	`plot_data_auxiliary_view_indicators()`	`Auxiliary View Indicators`	Auxiliary view indicator overlays on all views
`FeaturedSheet`	`plot_data_all_identifiers()`	`All Identifiers`	Title + section lines + auxiliary view indicators combined
`FeaturedView`	`plot_data_view()`	`2D View`	Base 2D rendering of one view
`FeaturedView`	`plot_data_title_view()`	`Title View`	Parsed title overlay on one view
`FeaturedView`	`plot_data_dimensions()`	`Dimensions`	Colored dimension labels on one view
`FeaturedView`	`plot_data_geometrical_tolerances()`	`Geometrical Tolerances`	Geometrical tolerance overlays on one view (green outlines)
`FeaturedView`	`plot_data_roughness()`	`Roughness`	Roughness overlays on one view (blue outlines)
`FeaturedView`	`plot_data_section_lines()`	`Section Lines`	Detected section line indicator overlays on one view
`FeaturedView`	`plot_data_auxiliary_view_indicators()`	`Auxiliary View Indicators`	Auxiliary view indicator overlays on one view
`FeaturedView`	`plot_data_all_identifiers()`	`All Identifiers`	Title + section lines + auxiliary view indicators on one view
`ViewTitle`	`plot_data_view()`	`Title View`	Source entity with title overlay labels

FeaturedDrawing methods return MultiplePlots (one plot per sheet). FeaturedSheet and FeaturedView methods return PrimitiveGroup.

All `@markdown_view` Methods#

The following markdown views generate text reports for the Dessia platform:

Class	Method	Selector	Description
`FeaturedDrawing`	`report()`	`Report`	Drawing-level markdown report
`FeaturedSheet`	`report()`	`Report`	Sheet-level markdown report
`FeaturedView`	`report()`	`Report`	View-level report (detected type, dimensions, tolerances, notes)
`ViewTitle`	`report()`	`Report`	Title parsing report (type, scale, identifiers, names by language)

FeaturedSheet Examples#

from pathlib import Path
from dessia_drawing.core import Drawing
from drawing_tools.config.default_language_configs import DEFAULT_FRENCH_CONFIG, DEFAULT_ENGLISH_CONFIG
from drawing_tools.featured_drawing import FeaturedDrawing

_DATA_DIR = Path("data/json")
drawing = Drawing.from_json(str(_DATA_DIR / "2902060102_--A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json"))
featured_drawing = FeaturedDrawing(drawing, language_configs=[DEFAULT_FRENCH_CONFIG, DEFAULT_ENGLISH_CONFIG])
featured_sheet = featured_drawing.sheets[1]

2D View#

The base sheet rendering without any overlay.

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.plot_data_view().plot()

View Indexes#

Each view is enclosed in a colored rectangle with its sheet and view index (e.g., S1 V2) displayed above. The background view gets an outline-only rectangle (no fill) to avoid obscuring the sheet content.

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.plot_data_view_indexes().plot()

Grid Reference#

Overlays the detected ISO 5457 grid reference on the sheet: colored border zones (left=blue, right=green, top=yellow, bottom=purple), red dashed cell boundaries, and centered cell labels (e.g. “A1”, “F4”). Falls back to base content when no grid reference is detected.

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.plot_data_grid_reference().plot()

Title View#

Each view’s detected title is highlighted with a bounding rectangle and all parsed attributes grouped by language (type, name, scale, repetition with / separators across languages, then identifiers per language, and additional text lines).

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.plot_data_title_view().plot()

Source: condor_BEAM_ASSY_FALSE.json, Sheet 4

featured_sheet.plot_data_title_view().plot()

Balloons#

Balloons are color-coded by group status: blue = parent, green = child, orange = isolated. Labels below a balloon appear only when it has special attributes:

Mult N — multiplicator (e.g., Mult 3), detected from nearby flag symbols (see Balloon Flags below)
FM — for-info flag (Pour Memoire / For Memory), detected from nearby PM/FM symbols (see Balloon Flags below)
Rep N — view repetition (e.g., Rep 2), inherited from the view’s title (see ViewTitle Guide)

featured_sheet.plot_data_balloons().plot()

Source: grouped_balloons_1.json, Sheet 1

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

Balloon Flags#

This view highlights the flag symbols themselves (multiplicator and for-info flag entities) rather than the balloons. Multiplicator symbols (e.g., X2, X3) are shown in blue, and PM/FM symbols in green. This is complementary to the Balloons view above, which shows the flags as labels on the balloons.

featured_sheet.plot_data_balloon_flags().plot()

Source: grouped_balloons_1.json, Sheet 1

Sets#

Detected sheet sets (sub-regions) are highlighted with colored rectangles and labels. Each set gets a distinct color.

Source: sheet_with_sets_1.json, Sheet 0

featured_sheet.plot_data_sets().plot()

Tables#

Detected tables are highlighted with colored rectangles. The title block is tagged in magenta with [Title Block].

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.plot_data_tables().plot()

Dimensions#

Dimension annotations are highlighted with red outline rectangles. These are the linear, angular, radius, and diameter dimensions on the drawing.

featured_sheet.plot_data_dimensions().plot()

Source: RP6541D072_GICLEUR A00.json, Sheet 0 (64 dimensions)

Tip

Download this visualization

Source: 2902060202_–A_DEF01_LH SUPPORT ACCUMULATOR.json, Sheet 1 (16 dimensions)

Tip

Download this visualization

Tolerances#

Geometrical tolerances (GD&T) are highlighted with green outline rectangles. These are feature control frames specifying form, orientation, or position constraints (e.g., position, flatness, perpendicularity).

featured_sheet.plot_data_geometrical_tolerances().plot()

Source: RP6541D072_GICLEUR A00.json, Sheet 0 (18 tolerances)

Tip

Download this visualization

Source: 2902060202_LH SUPPORT ACCUMULATOR.json, Sheet 1 (5 tolerances)

Tip

Download this visualization

Roughness#

Surface roughness annotations are highlighted with blue outline rectangles. These specify surface finish requirements (e.g., Ra 1.6, Rz 3.2).

featured_sheet.plot_data_roughness().plot()

Source: RP6541D072_GICLEUR A00.json, Sheet 0 (11 roughness)

Tip

Download this visualization

Section Lines#

Detected section line indicators are highlighted with colored bounding rectangles and labels showing identifier, cross-reference, detection source, and arrow direction. Each indicator gets a distinct color from a rotating palette.

For details about section line indicators, see Section Line Indicators.

Source: condor_BEAM_ASSY.json, Sheet 3

featured_sheet.plot_data_section_lines().plot()

Auxiliary View Indicators#

Auxiliary view indicators are TypeNote annotations with letter F and a nearby FillArrow, matching the identifier pattern (e.g., "F3", "F1 2/3") that are not part of any view title or section line indicator. They represent view cross-references pointing to where auxiliary or section views are defined.

For details about auxiliary view indicators, see Auxiliary View Indicators.

Source: condor_BEAM_ASSY.json, Sheet 1

featured_sheet.plot_data_auxiliary_view_indicators().plot()

All Identifiers#

The plot_data_all_identifiers method combines overlays from all three identifier sources: view titles, section line indicators, and auxiliary view indicators.

Source: condor_BEAM_ASSY.json, Sheet 1

featured_sheet.plot_data_all_identifiers().plot()

Report#

The @markdown_view report generates a markdown summary table of the sheet, listing each view with its name, scale, angle, geometry count, and annotation count.

Source: 2902060102_–A_DEF01_LH SUPPORT ACCUMULATOR ASSEMBLY.json, Sheet 1

featured_sheet.report()

# Sheet: Calque.2

**Number of views:** 7

| # | Name | Scale | Angle | View Types | Geometries | Annotations |
|---|------|-------|-------|------------|------------|-------------|
| 0 | Main View | 1.0 | 0.0 | NoTypeView | 0 | 0 |
| 1 | Background View | 1.0 | 0.0 | NoTypeView | 107 | 74 |
| 2 | VUE DE FACE | 1.0 | 0.0 | NoTypeView | 321 | 4 |
| 3 | COUPE A2-A2 | 1.0 | 0.0 | NoTypeView | 97 | 2 |
| 4 | COUPE B2-B2 | 2.0 | 0.0 | NoTypeView | 98 | 4 |
| 5 | VUE ISOMETRIQUE | 1.0 | 0.0 | NoTypeView | 252 | 3 |
| 6 | COUPE C2-C2 REDRESSEE | 3.0 | 1.21 | NoTypeView | 148 | 6 |

Display & Report Methods#

All @plot_data_view Methods#

All @markdown_view Methods#

FeaturedSheet Examples#

2D View#

View Indexes#

Grid Reference#

Title View#

Balloons#

Balloon Flags#

Sets#

Tables#

Dimensions#

Tolerances#

Roughness#

Section Lines#

Auxiliary View Indicators#

All Identifiers#

Report#

All `@plot_data_view` Methods#

All `@markdown_view` Methods#