SAF-Specification icon indicating copy to clipboard operation
SAF-Specification copied to clipboard

The Specification for the System Architecture Framework (SAF)

SAF Specification

Disclaimer: System Architecture Framework Specification Bild is work in progress

System Architecture Framework

This repository contains both documentation for users of SAF and developers of SAF. To understand how we develop SAF, see how SAF is developed. We always welcome contributions from our MBSE community to improve SAF, see how to contribute to SAF.

The System Architecture Framework Specification application is demonstrated using the Fire Forest Detection System (FFDS) example, courtesy of Tim Weilkiens. The Fire Forest Detection System example is based on the publication SYSMOD - The Systems Modeling Toolbox, 3rd edition Pragmatic MBSE with SysML, Tim Weilkiens

SAF Releases

This is the main branch that reflects the current state of development and it is updated as required. The following SAF releases are available, each of which is managed in a separate branch:

SAF Tool Implementations

The SAF specification is implemented by 3 tool specific profiles which are available in separate github repositories:

SAF Viewpoint Grid

The SAF Viewpoints are organized as a Grid featuring Domains as rows and Aspects as columns.

SAF Grid

The subsequent sections give an overview about the SAF viewpoint specifications, grouped by Domains. The specifications of the SAF viewpoints are available as PDF format, too.

Operational Domain

Operational Domain Objective

The SAF Operational Domain aims to get an understanding of required organizational or operational entity capabilities, as a foundation and reasoning for to systems to be acquired or developed. The SAF Operational Domain supports the model-based development of a CONOPS - as well as an OPSCON and related life cycle concepts - for an organization or operational entity seeking for an improvement of existing capabilities or in establishing new ones. By identifying Stakeholders and their Requirements the SAF Operational Domain supports the derivation of a complete and consolidated set of Stakeholder Requirements based on operational stories, operational processes, operational capabilities, and operational exchanges.

Operational Domain Viewpoints

Operational Domain Aspect Context & Exchange

  • Operational Story Viewpoint
  • Operational Context Definition Viewpoint
  • Operational Context Exchange Viewpoint

Operational Domain Aspect Taxonomy & Structure

  • Operational Performer Viewpoint
  • Operational Domain Item Kind Viewpoint
  • Operational Capability Viewpoint
  • Stakeholder Identification Viewpoint

Operational Domain Aspect Process & Behavior

  • Operational Process Viewpoint

Operational Domain Aspect Interaction & Collaboration

  • Operational Interaction Viewpoint

Operational Domain Aspect Requirement

  • Stakeholder Requirement Viewpoint

Operational Domain Aspect Traceability & Mapping

  • Operational Capability Mapping Viewpoint
  • Operational Process Mapping Viewpoint

Functional Domain

Functional Domain Objective

The SAF Functional Domain assumes a conceptual black box perspective onto the system to be developed. It translates Operational Domain usage into the notion of System Functions defining the demanded system behavior and quality attributes - performance, safety, security, etc.; the demanded system behavior as it is perceived by the User or other Entities at the System Boundary (known as usage behavior). The result of the elaboration of the viewpoints in the Functional Domain is a comprehensive System Specification.

Functional Domain Viewpoints

Functional Domain Aspect Context & Exchange

  • System Use Case Viewpoint
  • System Context Definition Viewpoint
  • System Context Exchange Viewpoint

Functional Domain Aspect Taxonomy & Structure

  • System Domain Item Kind Viewpoint
  • System Capability Viewpoint
  • System Functional Breakdown Structure Viewpoint

Functional Domain Aspect Process & Behavior

  • System Process Viewpoint
  • System Functional Refinement Viewpoint
  • System State Viewpoint

Functional Domain Aspect Interaction & Collaboration

  • System Context Interaction Viewpoint

Functional Domain Aspect Interface

  • System Interface Definition Viewpoint

Functional Domain Aspect Requirement

  • System Requirement Viewpoint

Functional Domain Aspect Traceability & Mapping

  • System Capability Mapping Viewpoint
  • System Requirement Traceability Viewpoint

Logical Domain

Logical Domain Objective

The SAF Logical Domain assume a conceptual white box perspective onto the system to be developed. The Logical Domain Viewpoints describe the Logical Structure and the distribution of responsibilities for the Functionality of the SOI by means of a network of interacting Logical Elements that are responsible for a set of desired Functions. These Logical Elements and their Interactions are arranged in the Logical Architecture of the SOI. The structure of the Logical Architecture is in general influenced by nonfunctional criteria, e.g., maintainability, safety, and reliability. The Logical Domain is not a different abstraction level - compared to the Functional Domain, but a white box perspective on the same abstraction level.

Logical Domain Viewpoints

Logical Domain Aspect Taxonomy & Structure

  • Logical Structure Definition Viewpoint

Logical Domain Aspect Interaction & Collaboration

  • Logical Internal Interaction Viewpoint
  • Logical Internal Exchange Viewpoint

Logical Domain Aspect Traceability & Mapping

  • Logical Functional Mapping Viewpoint

Physical Domain

Physical Domain Objective

The SAF Physical Domain diagrams may be used to represent the Product Breakdown Structure, to identify external and internal physical interfaces, to provide diagrams for the system overview, to support the integration planning, to support production planning and to depict the features and variations implied in the system. The physical architecture typically is a combination of re-use elements, COTS elements and make-items for HW as well as for SW. The properties of the selected physical components and their provided resources are identified and modelled. A major concern of the Physical Domain are the physical interfaces, their identification and definition. For that purpose, the Physical Domain provides the diagrams to model interface with different level of detail considering the actual needs for the point of time in the project life cycle. For traceability the Physical Domain defines diagrams showing the mapping of the functional elements and their interfaces to physical elements and their interfaces.

Physical Domain Viewpoints

Physical Domain Aspect Context & Exchange

  • Physical Context Definition Viewpoint
  • Physical Context Exchange Viewpoint

Physical Domain Aspect Taxonomy & Structure

  • Physical Structure Viewpoint

Physical Domain Aspect Process & Behavior

Physical Domain Aspect Interaction & Collaboration

  • Physical Internal Exchange Viewpoint

Physical Domain Aspect Interface

  • Physical Interface Definition Viewpoint
  • Physical Protocol Stack Definition Viewpoint

Physical Domain Aspect Traceability & Mapping

  • Physical Functional Mapping Viewpoint
  • Physical Logical Mapping Viewpoint

Common Domain

Common Domain Objective

The SAF Common Domain provides viewpoints addressing model information that is common to all other domains or that are applicable throughout the model.

Common Domain Viewpoints

  • Argumentation Assurance Viewpoint
  • Common Standards Definition Viewpoint
  • Common Terms Definition Viewpoint
  • Grid Definition Viewpoint

Stakeholder Definition

  • List of Stakeholders

Concern Overview

  • List of Concerns

Profile Model

  • List of Stereotypes