# mathworks/traction-emotor-control-software-architecture architecture

> Architecture diagram of the GitHub repository mathworks/traction-emotor-control-software-architecture, 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/mathworks/traction-emotor-control-software-architecture
- Repository: https://github.com/mathworks/traction-emotor-control-software-architecture

## Overview

This MATLAB/System Composer example presents an EV traction e-motor control architecture as a digital thread from requirements through architecture, behavioral models, testing, and code. Engineers use the architecture as the central reference for component design, interface definition, analysis, and traceability. The README documents the lifecycle capabilities and the architecture-to-behavior bridge; source excerpts were not provided, so the graph does not infer detailed component call sequences or data flows.

Main entry points: [`ArchitectureModels/TractionEmotorSoftwareArch_DataBus.slx`](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ArchitectureModels/TractionEmotorSoftwareArch_DataBus.slx) (System Architecture), [`Tests`](https://github.com/mathworks/traction-emotor-control-software-architecture/tree/master/Tests) (Behavioral Tests), [`Requirements/TractionEmotorRequirements.slreqx`](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Requirements/TractionEmotorRequirements.slreqx) (Requirements), [`Scripts/GenerateCode_CI.m`](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Scripts/GenerateCode_CI.m) (Code Generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Digital Thread"]
  node_requirements["Requirements"]
  node_code_generation["Code Generation<br/>[GenerateCode_CI.m]"]
  node_process_advisor["Process Advisor CI"]
end

subgraph group_architecture["Software Architecture"]
  node_architecture_model["System Architecture"]
  node_interface_dictionary[("Interface Dictionary")]
  node_profiles["Component Metadata"]
end

subgraph group_behavior["Control Behavior"]
  node_mode_control["Mode Control"]
  node_current_control["Current Regulation"]
  node_dq_reference["DQ Current Reference"]
  node_torque_limits["Torque Limits"]
  node_flux_control["Flux Control"]
  node_pwm["PWM Generation"]
  node_diagnostics["Diagnostics"]
end

subgraph group_validation["Verification"]
  node_tests["Behavioral Tests"]
end

node_engineer(("Engineer"))

node_engineer -->|"develops architecture"| node_architecture_model
node_requirements -->|"traced to"| node_architecture_model
node_architecture_model -->|"defines interfaces"| node_interface_dictionary
node_architecture_model -->|"captures metadata"| node_profiles
node_architecture_model -->|"bridges to behavior"| node_mode_control
node_architecture_model -->|"bridges to behavior"| node_current_control
node_architecture_model -->|"bridges to behavior"| node_dq_reference
node_architecture_model -->|"bridges to behavior"| node_torque_limits
node_architecture_model -->|"bridges to behavior"| node_flux_control
node_architecture_model -->|"bridges to behavior"| node_pwm
node_architecture_model -->|"bridges to behavior"| node_diagnostics
node_architecture_model -->|"traced to tests"| node_tests
node_tests -->|"traced to code"| node_code_generation
node_engineer -->|"runs CI workflow"| node_process_advisor

click node_requirements "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Requirements/TractionEmotorRequirements.slreqx"
click node_architecture_model "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ArchitectureModels/TractionEmotorSoftwareArch_DataBus.slx"
click node_interface_dictionary "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/DataDictionary/TractionEmotorSoftwareArchInterfaceData.sldd"
click node_profiles "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Profiles/TractionEmotorSoftwareArch_profiles.xml"
click node_mode_control "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/SpeedandTorqueModeComponent.slx"
click node_current_control "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/CurrentRegulationandFeedbackComponent.slx"
click node_dq_reference "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/DQReferenceCurrentCalculationComponent.slx"
click node_torque_limits "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/TorqueDeratingandLimitingComponent.slx"
click node_flux_control "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/SimulinkBehaviorModels/FluxWeakeningControl.slx"
click node_pwm "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/PWMGenerationComponent.slx"
click node_diagnostics "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/MotorFaultsDiagnosticsComponent.slx"
click node_tests "https://github.com/mathworks/traction-emotor-control-software-architecture/tree/master/Tests"
click node_code_generation "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Scripts/GenerateCode_CI.m"
click node_process_advisor "https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/.github/workflows/ProcessAdvisor_Simulink_pipeline.yml"

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_requirements,node_code_generation,node_process_advisor toneBlue
class node_architecture_model,node_interface_dictionary,node_profiles toneAmber
class node_mode_control,node_current_control,node_dq_reference,node_torque_limits,node_flux_control,node_pwm,node_diagnostics toneMint
class node_tests toneRose
class node_engineer toneIndigo
```

## Components

### Digital Thread

- [Requirements](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Requirements/TractionEmotorRequirements.slreqx): `Requirements/TractionEmotorRequirements.slreqx`
- [Code Generation](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Scripts/GenerateCode_CI.m): `Scripts/GenerateCode_CI.m`
- [Process Advisor CI](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/.github/workflows/ProcessAdvisor_Simulink_pipeline.yml): `.github/workflows/ProcessAdvisor_Simulink_pipeline.yml`

### Software Architecture

- [System Architecture](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ArchitectureModels/TractionEmotorSoftwareArch_DataBus.slx): `ArchitectureModels/TractionEmotorSoftwareArch_DataBus.slx`
- [Interface Dictionary](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/DataDictionary/TractionEmotorSoftwareArchInterfaceData.sldd): `DataDictionary/TractionEmotorSoftwareArchInterfaceData.sldd`
- [Component Metadata](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/Profiles/TractionEmotorSoftwareArch_profiles.xml): `Profiles/TractionEmotorSoftwareArch_profiles.xml`

### Control Behavior

- [Mode Control](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/SpeedandTorqueModeComponent.slx): `ReferenceComponents/SpeedandTorqueModeComponent.slx`
- [Current Regulation](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/CurrentRegulationandFeedbackComponent.slx): `ReferenceComponents/CurrentRegulationandFeedbackComponent.slx`
- [DQ Current Reference](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/DQReferenceCurrentCalculationComponent.slx): `ReferenceComponents/DQReferenceCurrentCalculationComponent.slx`
- [Torque Limits](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/TorqueDeratingandLimitingComponent.slx): `ReferenceComponents/TorqueDeratingandLimitingComponent.slx`
- [Flux Control](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/SimulinkBehaviorModels/FluxWeakeningControl.slx): `SimulinkBehaviorModels/FluxWeakeningControl.slx`
- [PWM Generation](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/PWMGenerationComponent.slx): `ReferenceComponents/PWMGenerationComponent.slx`
- [Diagnostics](https://github.com/mathworks/traction-emotor-control-software-architecture/blob/master/ReferenceComponents/MotorFaultsDiagnosticsComponent.slx): `ReferenceComponents/MotorFaultsDiagnosticsComponent.slx`

### Verification

- [Behavioral Tests](https://github.com/mathworks/traction-emotor-control-software-architecture/tree/master/Tests): `Tests`

### Other components

- **Engineer**

## Connections

- Engineer → System Architecture: develops architecture (evidence: `README.md`)
- Requirements → System Architecture: traced to (evidence: `README.md`)
- System Architecture → Interface Dictionary: defines interfaces (evidence: `README.md`)
- System Architecture → Component Metadata: captures metadata (evidence: `README.md`)
- System Architecture → Mode Control: bridges to behavior (evidence: `README.md`)
- System Architecture → Current Regulation: bridges to behavior (evidence: `README.md`)
- System Architecture → DQ Current Reference: bridges to behavior (evidence: `README.md`)
- System Architecture → Torque Limits: bridges to behavior (evidence: `README.md`)
- System Architecture → Flux Control: bridges to behavior (evidence: `README.md`)
- System Architecture → PWM Generation: bridges to behavior (evidence: `README.md`)
- System Architecture → Diagnostics: bridges to behavior (evidence: `README.md`)
- System Architecture → Behavioral Tests: traced to tests (evidence: `README.md`)
- Behavioral Tests → Code Generation: traced to code (evidence: `README.md`)
- Engineer → Process Advisor CI: runs CI workflow (evidence: `README.md`)
