# aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws architecture

> Architecture diagram of the GitHub repository aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws
- Repository: https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws

## Overview

This is an AWS P&ID digitization solution: users submit engineering drawings, which are validated, cleaned, analyzed for text, symbols, and connecting lines, then converted into graph and visualization outputs. Step Functions coordinates the processing stages and S3 stores execution-scoped inputs and results. The repository also includes symbol-model training and inference code. Workflow sequencing and major capabilities follow the README; source excerpts confirm selected Lambda, S3, and graph behaviors, while unsampled modules are represented only where documented.

Main entry points: [`cdk/lib/constructs/orchestration.ts`](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lib/constructs/orchestration.ts) (Step Functions), [`cdk/lambda/line_detection/app.py`](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/line_detection/app.py) (Line detection), [`cdk/lambda/graph_generator/document_processor.py`](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/document_processor.py) (Graph generation), [`cdk/lambda/input_validator/config_validator.py`](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/input_validator/config_validator.py) (Input validation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Diagram processing"]
  node_validator["Input validation"]
  node_notes["Notes processing"]
  node_frame["Frame detection<br/>[frame_detector.py]"]
  node_text["Text detection<br/>[index.py]"]
  node_symbols["Symbol detection<br/>[index.py]"]
  node_lines["Line detection<br/>[app.py]"]
  node_line_core["Line processing<br/>[line_detection.py]"]
end

subgraph group_analysis["Graph and visualization"]
  node_graph["Graph generation"]
  node_graph_service["Graph service<br/>[graph_service.py]"]
  node_dexpi["DEXPI export<br/>[dexpi_converter.py]"]
  node_visualization["Visualization<br/>[visualization.py]"]
end

subgraph group_platform["AWS platform"]
  node_bedrock{{"Bedrock Data Automation"}}
  node_endpoint{{"SageMaker endpoint"}}
  node_storage[("S3 buckets<br/>[storage.ts]")]
  node_orchestrator["Step Functions<br/>[orchestration.ts]"]
end

subgraph group_models["Symbol models"]
  node_synthetic["Synthetic data generation<br/>[generator.py]"]
  node_frcnn["Detector training<br/>[train.py]"]
  node_siamese_train["Similarity training<br/>[train.py]"]
  node_inference["Symbol inference<br/>[inference.py]"]
end

node_user(("Diagram submitter"))

node_user -->|"submits drawing"| node_validator
node_validator -->|"validated input"| node_notes
node_notes -->|"processed image"| node_text
node_notes -->|"processed image"| node_symbols
node_text -->|"requests OCR"| node_bedrock
node_symbols -->|"requests detection"| node_endpoint
node_text -->|"results via S3"| node_lines
node_symbols -->|"results via S3"| node_lines
node_lines -->|"runs detection"| node_line_core
node_lines -->|"line results"| node_graph
node_graph -.->|"builds graph"| node_graph_service
node_graph -->|"exports DEXPI"| node_dexpi
node_graph -->|"graph results"| node_visualization
node_validator -->|"stores configuration"| node_storage
node_user -->|"uploads drawing"| node_storage
node_orchestrator -.->|"invokes"| node_validator
node_orchestrator -->|"invokes"| node_notes
node_orchestrator -->|"invokes"| node_symbols
node_orchestrator -.->|"invokes"| node_text
node_orchestrator -.->|"invokes"| node_lines
node_synthetic -.->|"training data"| node_frcnn
node_synthetic -.->|"training data"| node_siamese_train
node_frcnn -.->|"trained detector"| node_inference
node_siamese_train -.->|"trained embeddings"| node_inference
node_inference -.->|"deployed model"| node_endpoint

click node_validator "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/input_validator/config_validator.py"
click node_notes "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/notes_processor/notes_section_detector.py"
click node_frame "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/notes_processor/frame_detector.py"
click node_text "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/text_detection/index.py"
click node_symbols "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/symbol_detection/index.py"
click node_lines "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/line_detection/app.py"
click node_line_core "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/line_detection/line_detection.py"
click node_graph "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/document_processor.py"
click node_graph_service "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/graph_service.py"
click node_dexpi "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/dexpi_converter.py"
click node_visualization "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_visualization/visualization.py"
click node_storage "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lib/constructs/storage.ts"
click node_orchestrator "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lib/constructs/orchestration.ts"
click node_synthetic "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/data_generator/synthetic_data_generator/generator.py"
click node_frcnn "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/frcnn/train.py"
click node_siamese_train "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/siamese_network/train.py"
click node_inference "https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/inference/inference.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_validator,node_notes,node_frame,node_text,node_symbols,node_lines,node_line_core toneBlue
class node_graph,node_graph_service,node_dexpi,node_visualization toneAmber
class node_bedrock,node_endpoint,node_storage,node_orchestrator toneMint
class node_synthetic,node_frcnn,node_siamese_train,node_inference toneRose
class node_user toneIndigo
```

## Components

### Diagram processing

- [Input validation](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/input_validator/config_validator.py): `cdk/lambda/input_validator/config_validator.py`
- [Notes processing](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/notes_processor/notes_section_detector.py): `cdk/lambda/notes_processor/notes_section_detector.py`
- [Frame detection](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/notes_processor/frame_detector.py): `cdk/lambda/notes_processor/frame_detector.py`
- [Text detection](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/text_detection/index.py): `cdk/lambda/text_detection/index.py`
- [Symbol detection](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/symbol_detection/index.py): `cdk/lambda/symbol_detection/index.py`
- [Line detection](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/line_detection/app.py): `cdk/lambda/line_detection/app.py`
- [Line processing](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/line_detection/line_detection.py): `cdk/lambda/line_detection/line_detection.py`

### Graph and visualization

- [Graph generation](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/document_processor.py): `cdk/lambda/graph_generator/document_processor.py`
- [Graph service](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/graph_service.py): `cdk/lambda/graph_generator/graph_service.py`
- [DEXPI export](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_generator/dexpi_converter.py): `cdk/lambda/graph_generator/dexpi_converter.py`
- [Visualization](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lambda/graph_visualization/visualization.py): `cdk/lambda/graph_visualization/visualization.py`

### AWS platform

- **Bedrock Data Automation**
- **SageMaker endpoint**
- [S3 buckets](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lib/constructs/storage.ts): `cdk/lib/constructs/storage.ts`
- [Step Functions](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/cdk/lib/constructs/orchestration.ts): `cdk/lib/constructs/orchestration.ts`

### Symbol models

- [Synthetic data generation](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/data_generator/synthetic_data_generator/generator.py): `training/data_generator/synthetic_data_generator/generator.py`
- [Detector training](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/frcnn/train.py): `training/frcnn/train.py`
- [Similarity training](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/training/siamese_network/train.py): `training/siamese_network/train.py`
- [Symbol inference](https://github.com/aws-solutions-library-samples/guidance-for-piping-and-instrumentation-diagrams-digitization-on-aws/blob/main/inference/inference.py): `inference/inference.py`

### Other components

- **Diagram submitter**

## Connections

- Diagram submitter → Input validation: submits drawing
- Input validation → Notes processing: validated input
- Notes processing → Text detection: processed image
- Notes processing → Symbol detection: processed image
- Text detection → Bedrock Data Automation: requests OCR (evidence: `cdk/lambda/text_detection/index.py`)
- Symbol detection → SageMaker endpoint: requests detection
- Text detection → Line detection: results via S3 (evidence: `cdk/lambda/line_detection/app.py`)
- Symbol detection → Line detection: results via S3 (evidence: `cdk/lambda/line_detection/app.py`)
- Line detection → Line processing: runs detection (evidence: `cdk/lambda/line_detection/app.py`)
- Line detection → Graph generation: line results
- Graph generation → Graph service: builds graph
- Graph generation → DEXPI export: exports DEXPI
- Graph generation → Visualization: graph results
- Input validation → S3 buckets: stores configuration
- Diagram submitter → S3 buckets: uploads drawing
- Step Functions → Input validation: invokes
- Step Functions → Notes processing: invokes (evidence: `cdk/lib/constructs/orchestration.ts`)
- Step Functions → Symbol detection: invokes (evidence: `cdk/lib/constructs/orchestration.ts`)
- Step Functions → Text detection: invokes
- Step Functions → Line detection: invokes
- Synthetic data generation → Detector training: training data
- Synthetic data generation → Similarity training: training data
- Detector training → Symbol inference: trained detector
- Similarity training → Symbol inference: trained embeddings
- Symbol inference → SageMaker endpoint: deployed model
