# industrial-edge/reference-architecture-for-industrial-ai-on-azure architecture

> Architecture diagram of the GitHub repository industrial-edge/reference-architecture-for-industrial-ai-on-azure, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure
- Repository: https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure

## Overview

This repository provides an Azure-oriented Industrial AI MLOps reference implementation, with image-classification and state-identifier workflows. The main path is pipeline preparation and submission, data preparation, model training and scoring, then model registration; separate packaging and delivery pipelines support edge deployment. The graph includes the documented Azure/Industrial AI context and sampled runtime modules. Some component wiring and deployment details are not shown in the excerpts, so those relationships are omitted rather than inferred.

Main entry points: [`mlops/image_classification/pipeline/mlops_pipeline.py`](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/pipeline/mlops_pipeline.py) (Image pipeline), [`mlops/state_identifier/pipeline/mlops_pipeline.py`](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/pipeline/mlops_pipeline.py) (State pipeline), [`mlops/common/pipeline/prepare_execute.py`](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/prepare_execute.py) (Prepare and execute), [`mlops/common/pipeline/packaging_pipeline.py`](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/packaging_pipeline.py) (Packaging pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Pipeline orchestration"]
  node_prep_exec["Prepare and execute<br/>[prepare_execute.py]"]
  node_compute["Compute selection<br/>[get_compute.py]"]
  node_environment["Environment selection<br/>[get_environment.py]"]
  node_execution["Job execution"]
end

subgraph group_vision["Image classification"]
  node_image_pipeline["Image pipeline<br/>[mlops_pipeline.py]"]
  node_image_data["Image data asset"]
  node_image_prep["Image preparation<br/>[prep.py]"]
  node_image_train["Image training<br/>[train.py]"]
  node_image_score["Image scoring<br/>[score.py]"]
  node_image_register["Image registration<br/>[register.py]"]
  node_image_package["Image packaging<br/>[packaging.py]"]
  node_image_payload["Vision payloads<br/>[payload.py]"]
end

subgraph group_state["State identification"]
  node_state_pipeline["State pipeline<br/>[mlops_pipeline.py]"]
  node_state_data["State data asset"]
  node_state_prep["State preparation<br/>[prep.py]"]
  node_state_train["State training<br/>[train.py]"]
  node_state_features["Feature pipeline<br/>[pipeline.py]"]
  node_state_transforms["Preprocessing transforms<br/>[preprocessing.py]"]
  node_state_score["State scoring<br/>[score.py]"]
  node_state_utils["Scoring utilities<br/>[scoring_utils.py]"]
  node_state_package["State packaging<br/>[packaging.py]"]
end

subgraph group_edge["Packaging and delivery"]
  node_package_pipeline["Packaging pipeline"]
  node_package_validation["Package validation"]
  node_package_registration["Package registration"]
  node_delivery_pipeline["Delivery pipeline"]
  node_delivery["Model Manager delivery"]
end

node_user(("MLOps operator"))
node_azureml["Azure Machine Learning"]
node_model_manager["Industrial AI Model Manager"]

node_user -->|"starts workflow"| node_prep_exec
node_prep_exec -->|"selects compute"| node_compute
node_prep_exec -->|"selects environment"| node_environment
node_prep_exec -->|"submits job"| node_execution
node_execution -->|"creates job"| node_azureml
node_image_pipeline -->|"uses orchestration"| node_prep_exec
node_state_pipeline -->|"uses orchestration"| node_prep_exec
node_image_pipeline -.->|"prepares data"| node_image_data
node_image_pipeline -.->|"loads preparation"| node_image_prep
node_image_pipeline -.->|"loads training"| node_image_train
node_image_pipeline -.->|"loads scoring"| node_image_score
node_image_pipeline -.->|"loads registration"| node_image_register
node_image_data -->|"calls preparation"| node_image_prep
node_image_pipeline -->|"constructs job"| node_azureml
node_image_package -.->|"uses payload handling"| node_image_payload
node_state_pipeline -.->|"loads preparation"| node_state_prep
node_state_pipeline -.->|"loads training"| node_state_train
node_state_pipeline -.->|"loads scoring"| node_state_score
node_state_pipeline -.->|"prepares data"| node_state_data
node_state_pipeline -->|"constructs job"| node_azureml
node_state_train -->|"uses pipeline"| node_state_features
node_state_train -->|"uses transforms"| node_state_transforms
node_state_score -->|"uses utilities"| node_state_utils
node_state_score -->|"uses preprocessing"| node_state_transforms
node_state_package -->|"uses utilities"| node_state_utils
node_state_package -->|"uses preprocessing"| node_state_transforms
node_package_pipeline -.->|"builds pipeline"| node_azureml
node_package_pipeline -.->|"validates package"| node_package_validation
node_package_pipeline -->|"registers package"| node_package_registration
node_delivery_pipeline -.->|"dispatches delivery"| node_delivery
node_delivery -.->|"sends delivery messages"| node_model_manager

click node_prep_exec "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/prepare_execute.py"
click node_compute "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/get_compute.py"
click node_environment "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/get_environment.py"
click node_execution "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/pipeline_execution_utils.py"
click node_image_pipeline "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/pipeline/mlops_pipeline.py"
click node_image_data "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/data_asset_creation/data_asset_creation.py"
click node_image_prep "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/prep/prep.py"
click node_image_train "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/train/train.py"
click node_image_score "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/score/score.py"
click node_image_register "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/register/register.py"
click node_image_package "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/package/packaging.py"
click node_image_payload "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/package/payload.py"
click node_state_pipeline "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/pipeline/mlops_pipeline.py"
click node_state_data "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/data_asset_creation/data_asset_creation.py"
click node_state_prep "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/prep/prep.py"
click node_state_train "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/train/train.py"
click node_state_features "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/si/pipeline.py"
click node_state_transforms "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/si/preprocessing.py"
click node_state_score "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/score/score.py"
click node_state_utils "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/score/scoring_utils.py"
click node_state_package "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/package/packaging.py"
click node_package_pipeline "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/packaging_pipeline.py"
click node_package_validation "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_validation.py"
click node_package_registration "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_registration.py"
click node_delivery_pipeline "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/delivery_pipeline.py"
click node_delivery "https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_delivery_mm.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_prep_exec,node_compute,node_environment,node_execution toneBlue
class node_image_pipeline,node_image_data,node_image_prep,node_image_train,node_image_score,node_image_register,node_image_package,node_image_payload toneAmber
class node_state_pipeline,node_state_data,node_state_prep,node_state_train,node_state_features,node_state_transforms,node_state_score,node_state_utils,node_state_package toneMint
class node_package_pipeline,node_package_validation,node_package_registration,node_delivery_pipeline,node_delivery toneRose
class node_user,node_azureml,node_model_manager toneIndigo
```

## Components

### Pipeline orchestration

- [Prepare and execute](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/prepare_execute.py): `mlops/common/pipeline/prepare_execute.py`
- [Compute selection](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/get_compute.py): `mlops/common/pipeline/get_compute.py`
- [Environment selection](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/get_environment.py): `mlops/common/pipeline/get_environment.py`
- [Job execution](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/pipeline_execution_utils.py): `mlops/common/pipeline/pipeline_execution_utils.py`

### Image classification

- [Image pipeline](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/pipeline/mlops_pipeline.py): `mlops/image_classification/pipeline/mlops_pipeline.py`
- [Image data asset](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/data_asset_creation/data_asset_creation.py): `mlops/image_classification/src/data_asset_creation/data_asset_creation.py`
- [Image preparation](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/prep/prep.py): `mlops/image_classification/src/prep/prep.py`
- [Image training](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/train/train.py): `mlops/image_classification/src/train/train.py`
- [Image scoring](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/score/score.py): `mlops/image_classification/src/score/score.py`
- [Image registration](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/register/register.py): `mlops/image_classification/src/register/register.py`
- [Image packaging](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/package/packaging.py): `mlops/image_classification/src/package/packaging.py`
- [Vision payloads](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/image_classification/src/package/payload.py): `mlops/image_classification/src/package/payload.py`

### State identification

- [State pipeline](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/pipeline/mlops_pipeline.py): `mlops/state_identifier/pipeline/mlops_pipeline.py`
- [State data asset](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/data_asset_creation/data_asset_creation.py): `mlops/state_identifier/src/data_asset_creation/data_asset_creation.py`
- [State preparation](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/prep/prep.py): `mlops/state_identifier/src/prep/prep.py`
- [State training](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/train/train.py): `mlops/state_identifier/src/train/train.py`
- [Feature pipeline](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/si/pipeline.py): `mlops/state_identifier/src/si/pipeline.py`
- [Preprocessing transforms](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/si/preprocessing.py): `mlops/state_identifier/src/si/preprocessing.py`
- [State scoring](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/score/score.py): `mlops/state_identifier/src/score/score.py`
- [Scoring utilities](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/score/scoring_utils.py): `mlops/state_identifier/src/score/scoring_utils.py`
- [State packaging](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/state_identifier/src/package/packaging.py): `mlops/state_identifier/src/package/packaging.py`

### Packaging and delivery

- [Packaging pipeline](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/packaging_pipeline.py): `mlops/common/pipeline/packaging_pipeline.py`
- [Package validation](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_validation.py): `mlops/common/src/package_validation.py`
- [Package registration](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_registration.py): `mlops/common/src/package_registration.py`
- [Delivery pipeline](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/pipeline/delivery_pipeline.py): `mlops/common/pipeline/delivery_pipeline.py`
- [Model Manager delivery](https://github.com/industrial-edge/reference-architecture-for-industrial-ai-on-azure/blob/main/mlops/common/src/package_delivery_mm.py): `mlops/common/src/package_delivery_mm.py`

### Other components

- **MLOps operator**
- **Azure Machine Learning**
- **Industrial AI Model Manager**

## Connections

- MLOps operator → Prepare and execute: starts workflow (evidence: `mlops/common/pipeline/prepare_execute.py`)
- Prepare and execute → Compute selection: selects compute (evidence: `mlops/common/pipeline/prepare_execute.py`)
- Prepare and execute → Environment selection: selects environment (evidence: `mlops/common/pipeline/prepare_execute.py`)
- Prepare and execute → Job execution: submits job (evidence: `mlops/common/pipeline/prepare_execute.py`)
- Job execution → Azure Machine Learning: creates job (evidence: `mlops/common/pipeline/pipeline_execution_utils.py`)
- Image pipeline → Prepare and execute: uses orchestration (evidence: `mlops/image_classification/pipeline/mlops_pipeline.py`)
- State pipeline → Prepare and execute: uses orchestration (evidence: `mlops/state_identifier/pipeline/mlops_pipeline.py`)
- Image pipeline → Image data asset: prepares data
- Image pipeline → Image preparation: loads preparation
- Image pipeline → Image training: loads training
- Image pipeline → Image scoring: loads scoring
- Image pipeline → Image registration: loads registration
- Image data asset → Image preparation: calls preparation (evidence: `mlops/image_classification/src/data_asset_creation/data_asset_creation.py`)
- Image pipeline → Azure Machine Learning: constructs job (evidence: `mlops/image_classification/pipeline/mlops_pipeline.py`)
- Image packaging → Vision payloads: uses payload handling
- State pipeline → State preparation: loads preparation
- State pipeline → State training: loads training
- State pipeline → State scoring: loads scoring
- State pipeline → State data asset: prepares data
- State pipeline → Azure Machine Learning: constructs job (evidence: `mlops/state_identifier/pipeline/mlops_pipeline.py`)
- State training → Feature pipeline: uses pipeline (evidence: `mlops/state_identifier/src/train/train.py`)
- State training → Preprocessing transforms: uses transforms (evidence: `mlops/state_identifier/src/train/train.py`)
- State scoring → Scoring utilities: uses utilities (evidence: `mlops/state_identifier/src/score/score.py`)
- State scoring → Preprocessing transforms: uses preprocessing (evidence: `mlops/state_identifier/src/score/score.py`)
- State packaging → Scoring utilities: uses utilities
- State packaging → Preprocessing transforms: uses preprocessing
- Packaging pipeline → Azure Machine Learning: builds pipeline
- Packaging pipeline → Package validation: validates package
- Packaging pipeline → Package registration: registers package (evidence: `mlops/common/pipeline/packaging_pipeline.py`)
- Delivery pipeline → Model Manager delivery: dispatches delivery
- Model Manager delivery → Industrial AI Model Manager: sends delivery messages
