System Requirements Definition: Difference between revisions

From SEBoK Draft
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "SEBoK v. 2.12, released 20 May 2025" to "SEBoK v. 2.12, released 27 May 2025")
 
(43 intermediate revisions by 3 users not shown)
Line 1: Line 1:
----
----
'''''Lead Author: ''''' ''Tami Katz'' '''''Contributing Authors:''''' ''Lou Wheatcraft, Mike Ryan, Alan Faisandier, Garry Roedler''
'''''Lead Author: ''''' ''Tami Katz'' '''''Contributing Authors:''''' ''Lou Wheatcraft, Mike Ryan''
----
----
The System Requirements Definition process transforms the {{term|Stakeholder (glossary)|stakeholder}} view of desired {{term|Capability (glossary)|capabilities}} into a technical view of how the system can achieve the capabilities. {{Term|System Requirement (glossary)|System requirements}} describe requirements which the integrated system must fulfill to satisfy the {{term|Stakeholder Requirement (glossary)|stakeholder needs}} and are expressed in an appropriate combination of well-formed textual statements and supporting models or diagrams. Inputs into this process are the life cycle concepts and integrated set of needs generated during the [[System Concept Definition]] activities.  
The System Requirements Definition process transforms the {{term|Stakeholder (glossary)|stakeholder}} view of desired {{term|Capability (glossary)|capabilities}} into a technical, developer view of how the system can achieve those capabilities. {{Term|System Requirement (glossary)|System requirements}} describe requirements which the {{Term|System-of-Interest (glossary)|system-of-interest}} (SoI) must fulfill to satisfy the {{term|Stakeholder Needs and Requirements (glossary)|stakeholder needs}} and are expressed in an appropriate combination of well-formed textual statements and supporting models or diagrams. Inputs into this process are the life cycle concepts and integrated set of needs generated during the [[System Concept Definition]] activities.  


System requirements play major roles in systems engineering, as they:
System requirements play major roles in systems engineering, as they:
* Form the basis of system {{Term|Architecture (glossary)|architecture}} and {{Term|Design (glossary)|design}} activities.
* Form the basis of system {{Term|Architecture (glossary)|architecture}} and {{Term|Design (glossary)|design}} activities.
*Form the basis of system {{Term|Integration (glossary)}} and {{Term|Verification (glossary)|verification}} activities.
* Form the basis of system {{Term|Integration (glossary)}} and {{Term|Verification (glossary)|verification}} activities.
* Provide a means of communication between the various project team members that interact throughout the project.
* Provide a means of communication between the various project team members that interact throughout the project.
The results of the System Requirements Definition process are a well-formed set of requirements that are used as inputs into the [[System Detailed Design Definition|System Detailed Design Definition]] process.  
Outputs of the System Requirements Definition process serve as inputs to a number of other technical processes, which include [[System Detailed Design Definition|System Design Definition]], [[System Architecture Design Definition|System Architecture Definition]], and [[System Verification]].
 
==Principles and Concepts==
==Principles and Concepts==
The outcome of the concept development phase is the identification of what is needed, why it is needed, and some initial architecture/life cycle concepts which will be further matured during Engineering Development. This is provided as input to the System Requirements Definition, the first activity in the {{term|System Definition (glossary)|System Definition Process}} (shown in Figure 1).
System Requirements Definition uses the outcome of the [[System Concept Definition]] activities to address what the system must do so that the integrated set of needs will be realized by the SoI. As shown in Figure 1, this information is then provided as input to the [[System Architecture Design Definition|System Architecture Definition]] and [[System Detailed Design Definition|System Design Definition]] processes, as well as the System Verification process.
 
[insert figure SysReqt-1 here]
 
Figure 1. System Requirements Definition is the first activity in the System Definition Process.  Original SEBoK figure derived from ISO 15288-2023.
 
Defining requirements is not an exercise in writing but is an exercise in engineering.  Every requirement represents an engineering decision as to what the SOI must do, or a quality the system must have, to meet the needs from which they were transformed.  Determination of what the system must do to meet a need is through a process of detailed requirement analysis, typically through usage of models and simulations.


==== Purpose of Requirements ====
[[File:Figure SysReqt-1 Original.jpg|thumb|900px|center|'''Figure 1. System Requirements Definition is the first activity in the System Definition Process.''' (SEBoK Original figure derived from ISO 15288-2023)]]
A requirement is a statement that translates or expresses a need and its associated constraints into an agreed-to obligation for an entity to perform some {{term|Function (glossary)|function}} or possess some quality [INCOSE 2022]. There are many types of requirements, this article will describe the requirements which are used as inputs into the [[System Detailed Design Definition|Design Definition]] process.  At the highest level of the architecture hierarchy these are referred to as System Requirements.
==== Needs versus Requirements ====
"Needs" communicate the stakeholder’s perspective concerning their expectations of what they need the system of interest (SoI) to do.  Example: The user needs the coffee maker to stop making coffee once the requested brew size has been made.


"Requirements" communicate the developer perspective concerning what the SoI must do to meet the stakeholder needs. Example: The Coffee Maker shall stop the brewing function once the designated brew size has been achieved.
Defining requirements is not only an exercise in writing it is also an exercise in engineering.  Every requirement represents an engineering decision as to what the SoI must do, or a quality the system must have, to meet the needs from which they were transformed.  Determination of what the system must do to meet a need is through a process of detailed requirement analysis, which can include the development and use of models, simulations, and prototypes.


The origination of needs is described in [[Stakeholder Needs Definition]].  Stakeholder expectations, needs and their requirements are treated as inputs into the System Requirement Definition process, which results in a set of requirements on the SoI.
A requirement statement is the result of a "formal transformation of one or more needs or parent requirements into an agreed-to obligation for an entity to perform some {{term|Function (glossary)|function}} or possess some quality within specified constraints with acceptable risk." (INCOSE NRM 2022). In this context the use of the term “quality” means an inherent feature or a distinguishing attribute.


==== Requirements versus Specifications ====
There are many types of requirements; this article describes the requirements which are used as inputs into the System Architecture and System Design Definition processes.  As such, these requirements can be referred to as design input requirements, which are defined iteratively and recursively as the integrated system is decomposed into subsystems and system elements (the SoI could exist at any level of a system architecture).
Requirements specify what the system needs to do (input into the design process), where a specification describes how a system is built and works (outputs from the design process).  While historically the term "requirements specification" has been used to describe a set of requirements, a more appropriate designator is "requirement document", "set of requirements", or "requirement artifact" to avoid confusion with products generated during the design process.


==Process for Generating System Requirements==
==Process for Generating System Requirements==
===Transforming Needs to System Requirements===
===Transforming Needs to System Requirements===
The System Requirement Definition activities begin with the transformation of the integrated set of needs into a set of requirements that are used as input into the design process.  These requirements are appropriate for the level the SoI that communicate “what” the system must do to meet the needs, avoiding requirements stating “how” to achieve the design realization of the physical SoI.  Need statements communicate a stakeholder perspective, where the requirement communicates the system perspective.  
The System Requirement Definition activities begin with the transformation of the integrated set of needs into a set of requirements for the SoI.  These requirements must be appropriate to the level that the SoI exists within the system architecture and communicate “what” the SoI must do to meet the needs, avoiding requirements that state implementation of “how” to achieve the design realization of the physical SoI.   
 
Example transformation:


* Need: "The customers need the bicycle to transport the rider using non-motorized power."
Needs communicate the stakeholder’s perspective concerning their expectations of what they need the system of interest (SoI) to do from an external, black box view.  
* Requirement: "The bicycle shall transport a rider using the propulsion force supplied by the rider.


In actuality the process of generating the requirement statement is more than changing the subject of the statement, it is an analysis of what must the system do to achieve what is needed.  Types of analyses that are used to make this determination include:
* Example: The user needs the coffee maker to stop heating water once the user-selected temperature has been achieved.
* Functional analysis
* Use of system models (activity, state machine, sequence diagrams, internal block diagrams)
* Performance measure analysis from MOEs
* House of Quality method
* Needs to requirements transformation matrix.
* Margin assessment and allocation
* Performance and resource budgets and allocation
* Specialty analyses (reliability, maintainability, etc.)


For functions that address the primary mission, goals, objectives and measures of the SoI, there are characteristics that describe the performance of that function, addressing "how well".  Requirement analysis for functions and performance can be performed using system models (supported by [[Model-Based Systems Engineering (MBSE)]] applications). Key enabling model views include activity diagrams, sequence diagrams, state machine diagrams, and structure diagrams (for hierarchy and interfaces). An example functional analysis is shown in Figure 2.
The sources of needs are described in [[Stakeholder Needs Definition]]. These sources include the stakeholder expectations and needs, drivers and constraints, risk analysis, and life cycle concept analysis and maturation activities. These needs are treated as inputs to the System Requirement Definition process, which results in a set of design input requirements for the SoI.


[insert figure SysReqt-2 here]
Requirements communicate the technical, developer perspective concerning what the SoI must do to meet the stakeholder needs from an internal white box view. 


Figure 2. Example Function Analysis using a SysML Activity Diagram.  Original SEBoK figure.
* Example: The Coffee Maker shall stop the heating function once the selected Brew Temperature has been achieved.


Close coordination with the stakeholders is necessary to ensure the translation is accurate and traceability is maintained. This results in a set of system functions and requirements specifying measurable characteristics which can form the basis for {{Term|System Realization (glossary)|system realization}}.  Using a detailed analysis a single need statement can be transformed into multiple requirements expressing what the system must do to meet it, including definition of measurable performance criteria.  
The process of generating a requirement statement is more than changing the subject of the need statement, it is an analysis of what the system must do to achieve what is needed.  There are many types of analyses and tools that are used to make this determination:  


An example requirement from the above transformation analysis could be:
* functional analysis, 
* interface analysis, 
* data flow diagrams, 
* performance analysis, and 
* needs to transformation matrix. 


'''Need''': The stakeholders need the automobile to increase speed when driver provides input to accelerate.
Requirement analysis for functions and performance can be performed by using system models (supported by [[Model-Based Systems Engineering (MBSE)]] applications). Key enabling model views include activity diagrams, sequence diagrams, state machine diagrams, and structure diagrams (for hierarchy and interfaces). An example functional analysis is shown in Figure 2.


'''Requirement''': When driver increases accelerator position, the Automobile shall increase torque to the engine in direct proportion to the acceleration position change.
[[File:Figure SysReqt-2 Original.jpg|thumb|900px|center|'''Figure 2. Example Function Analysis using a SysML Activity Diagram.''' (SEBoK Original)]]


The system requirements are based around identification and {{Term|Synthesis (glossary)|synthesis}} of the functions required of any solution system associated with performance and other quality measures and provide the basis for the assessment of candidate solutions and verification of the completed system. The {{Term|System Requirement (glossary)|system requirements}} are expressed in technical language that is useful for architecture and design: unambiguous, consistent, coherent, exhaustive, and verifiable.
Close and frequent coordination with the stakeholders is necessary to ensure the transformation is accurate and {{Term|Traceability (glossary|traceability}} is maintained. This results in a set of system requirements communicating measurable characteristics which can form the basis for {{Term|System Realization (glossary)|system realization}}.  A detailed analysis of a single need statement may result in multiple requirements expressing what the system must do to meet it, including definition of measurable performance criteria (INCOSE NRM 2022).


=== Use of Attributes ===
=== Use of Attributes ===
An attribute is additional information associated with an entity which is used to aid in its definition and management. Well-chosen attributes, when properly defined and tracked, can enable correct interpretation and management of requirements throughout the system life cycle.  Example attributes include:  
An attribute is additional information associated with an entity which is used to aid in its definition and management. Well-chosen attributes, when properly defined and tracked, can enable correct interpretation and management of requirements throughout the system life cycle.  There are several useful attributes to consider:  
 
* Identifier
* Title
* Rationale
* Trace to source
* Category
* System verification method


Example benefit of using attributes: Capturing rationale when developing the requirements. Requirement rationale is a statement as to why the requirement exists, any assumptions made, the results of related design studies, or any other related supporting information. This supports further requirements analysis and decomposition, as well as identifying the source of any requirement value.
* rationale,
* trace to source or parent,
* system verification success criteria,
* owner,
* category,
* status,
* criticality, and
* priority.  


The use of the rationale attribute helps communicate why the requirement is needed, any assumptions made, the source of numbers, the results of related design studies, or any other related supporting information. This supports further requirements analysis and decomposition, as well as identifying the source of any requirement value. Defining the system verification success criteria helps ensure the requirement is well-formed, is verifiable, and aids in the planning for the project's verification program (INCOSE NRM 2022).
=== Categorizing Requirements ===
=== Categorizing Requirements ===
It is useful to organize the requirements into categories, grouping similar types of requirements together within a set.  An example set of categories is shown in Table 1.
It is useful to organize the requirements into categories, grouping similar types of requirements together within a set.  An example set of categories is shown in Table 1. While organizations may have different categorizations, for the set of requirements to be complete ''each'' category topic in Table 1 must be addressed. 
{| class="wikitable"
{| class="wikitable"
|+Table 1.  Example Types of Requirement Categories. (Derived from the INCOSE Needs and Requirements Manual)
|+Table 1.  Example Types of Requirement Categories. (Derived from the INCOSE Needs and Requirements Manual)
Line 101: Line 84:
|}
|}


See Table 2 for example Requirement statements, attributes and categories.
See Table 2 for example requirement statements, attributes and categories.
{| class="wikitable"
{| class="wikitable"
|+'''Table 2. Example Requirement Statements.''' (SEBoK Original)
|+'''Table 2. Example Requirement Statements.''' (SEBoK Original)
|-
|-
|'''Reqt  ID'''
!'''Reqt  ID'''
|'''Requirement Title'''
!'''Requirement Title'''
|'''Requirement'''
!'''Requirement'''
|'''Rationale'''
!'''Rationale'''
|'''Category'''
!'''Category'''
|-
|-
|R1
|R1
|Variable Temperature Settings
|Variable Temperature Settings
|The Coffee Maker shall have two selectable settings for coffee brewing:  Warm:  96°C +/- 2°C, Hot: 100°C+/- 2°C.
|The Coffee Maker shall have two user-selectable settings for coffee brewing:  Warm:  96°C +/- 2°C, Hot: 100°C+/- 2°C.
|Based on focus group inputs for selectable  temperature; values are from analysis associated with consumer research  surveys and safety regulations.
|Based on focus group inputs for selectable  temperature; values are from analysis associated with consumer research  surveys and safety regulations.
|Function/Performance
|Function/Performance
Line 119: Line 102:
|R2
|R2
|Prohibit Brew if  Container Missing
|Prohibit Brew if  Container Missing
|If coffee container is missing from the brew location, the Coffee Maker shall prohibit brew function.
|If coffee container is not fully inserted into the brew location, the Coffee Maker shall prohibit brew function.
|Protective measure  related to off-nominal use case.
|Protective measure  related to off-nominal use case.
|Function/Performance
|Function/Performance
|-
|-
|R3
|R3
|Electrical Standard  Compliance
|The Coffee Maker shall  comply with the applicable requirements as noted in Table 1 of UL 1082,  Household Electric Coffee Makers and Brewing-Type Appliances.
|Ensures compliance  with US National Electrical Code, NFPA 70.
|Compliance
|-
|R4
|Coffee Maker Variants
|The Coffee Maker shall consist  of four variants that are differentiated by color.
|Design constraint based on  marketing strategy.
|Form
|-
|R5
|Operational Life
|Operational Life
|The Coffee Maker operational life shall be greater than or equal to 3 years.
|The Coffee Maker shall have an operational life greater than or equal to 3 years.
|Analysis shows  expected operational service of 1,000 hours over three years of usage,  ensuring appliance lasts through the warranty period.
|Analysis shows  expected operational service of 1,000 hours over three years of usage,  ensuring appliance lasts through the warranty period.
|Quality
|Quality
|-
|-
|R6
|R4
|User Interface
|User Inputs
|The Coffee Maker shall utilize  four user inputs: Power On, Brew Temperature, Brew Size, Brew Start.
|The Coffee Maker shall limit the number of user inputs to: Power On, Brew Temperature, Brew Size, Brew Start.
|User inputs are assessed from  focus groups to minimum set of inputs to achieve coffee maker full set of  life cycle concepts.
|User inputs are assessed from  focus groups to minimum set of inputs to achieve coffee maker full set of  life cycle concepts.
|Fit/Operation
|Fit/Operation
Line 149: Line 120:


=== Requirements At Levels Within the Hierarchy ===
=== Requirements At Levels Within the Hierarchy ===
Upon determination of the system hierarchy through the [[System Architecture Design Definition]] process, a requirement tree can be established showing the system level requirements and the supporting requirements at the lower-level elements of the hierarchy.  Figure 3 shows an example flow from System requirement to lower-level requirements, and an example requirement tree is shown in Figure 4.   
Requirements definition is an iterative and recursive process performed concurrently with the [[System Architecture Design Definition|Architecture Definition]] Process. Upon determination of the system hierarchy, a requirement tree can be established showing the system level requirements and the supporting requirements at the lower-level elements of the hierarchy.  Figure 3 shows an example flow from system requirement to lower-level requirements, and an example requirement tree is shown in Figure 4.   
 
[insert figure SysReqt-3 here]


Figure 3. Example Flow of System Requirements with to Lower-level Requirements.  This figure is derived from the INCOSE Needs and Requirements Manual v1.1, Figure 6-20, reprinted with permission of INCOSE. All other rights are reserved by the copyright owner.  
[[File:Figure SysReqt-3 NRM Figure 6-20.jpg|thumb|500px|center|'''Figure 3. Example Flow of System Requirements with to Lower-level Requirements.''' This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.]] 


[insert figure SysReqt-4 here]  
[[File:Figure SysReqt-4 Original.jpg|thumb|900px|center|'''Figure 4. Example Requirement Tree using a SysML Package Diagram.''' (SEBoK Original)]]


Figure 4. Example Requirement Tree using a SysML Package Diagram.  Original SEBoK figure.
Allocation is the process by which the requirements at one level of the physical architecture are assigned to those entities at the next lower level of the architecture that have a role in the implementation of the allocated requirement. This involves an analysis where the project team determines what “role”, if any, each subsystem or system element at the next level of the architecture has in the implementation of the requirement being allocated. Requirements generated at the lower level are referred to as child requirements of an allocated parent requirement.  


Allocation is the process by which the requirements at one level of the physical architecture are assigned to those entities at the next lower level of the architecture that have a role in the implementation of the allocated requirementThis involves an analysis where the project team determines what “role”, if any, each subsystem and system element at the next level of the architecture has in the implementation of the requirement being allocated. Requirements generated at the lower level are referred to as the children of the allocated parent requirement.
An important concept associated with allocation is budgeting.  Budget refers to the total value of a parameter defined at the system level. The system requirement value may be decomposed to ensure the lower-level elements contribute their portion, enabling the system level to achieve its total value. Budgeted quantities result in requirements that have a dependency - a change in one will result in the need to change anotherBudgeted values can include mass (weight), power usage, bandwidth, time, and quality attributes).  


==Principles Governing System Requirements==
==Principles Governing System Requirements==
===Establishing Achievable Measures===
When generating the criteria for requirements in the form of numerical values, the following guidance can ensure the final values are achievable and aligned with the original stated need:
* Requirement values must be achievable, for this reason a tolerance or range of values is applied to any specified value. {{term|Tolerance (glossary)|Tolerance}} refers to a permissible deviation from a specified value, while a range refers to a span of acceptable values, including less than, greater than options. Usage of Tolerances and Ranges ensures the values are achievable in test and operations (avoiding absolutes). If the tolerance or range is too “tight” or the range too “narrow” the cost to manufacture and verify the system will be more expensive.  If the tolerance is too “loose” or range is too “wide”, the possible variability during manufacturing may result in an issue with “tolerance stack up” (when the combination of +/- tolerances or allowable ranges may result in a SoI that does not work).
* For requirements that deal with taking a measure, the concepts of accuracy and precision are a consideration when specifying expected performance. Accuracy is a measure of how close an average of measures is to a baseline value expressed as a percent. Precision is a function of the distribution of measurements taken, i.e., closeness of agreement between independent, repeated measures obtained from the same sample under specific conditions. If the accuracy or precision values are too “tight” or “narrow” the cost to design and manufacture a system that meets those performance values will be more expensive, as will the cost to verify the system meets those values.
* For any system in its development life the current best estimate of a resource changes as the development team matures the design. For a system in development, most technical resources carry margin. A margin is the difference between the expected value and the value used in the requirement. Margins account for unexpected growth or limitations to ensure overall system is still able to meet its needs. When defining performance values, including margins is especially important when using new, immature technologies (harder to predict performance).
* Budget refers to the total value of a parameter at the system level. The system requirement value may be decomposed to ensure the lower-level elements contribute their portion, enabling the system level to achieve its total value. Budgeted quantities result in requirements that have a dependency - a change in one will result in the need to change another.
=== Addressing Unknowns ===
When initially generating a set of requirements, there is often a set of parameters which may require future analysis to determine their actual value.  One common method to do this is to use a placeholder in the requirement statement to indicate the requirement is drafted, yet further work is needed before it is considered complete.  When a value is unknown, a common approach is to use the "To Be Determined" (TBD) indication within the requirement statement, in place of an actual value. When a value is determined but confidence is low, a method to reflect this is to use the "To Be Resolved" (TBR) indication next to the value. Keeping track of the TBXs allows for awareness of the maturity of the requirements throughout the life cycle and is a valuable metric to evaluate completion and maturity of the set of needs and set of design input requirements.
TBXs can lead to risk if not addressed by the project prior to significant work in establishing the design solution.  TBX management is the process of identifying the TBXs in a requirement set, establishing the work needed to resolve closure of the issue, identifying the owner of the work, and "burning down" the actions to enable removal of these placeholders in the requirements.
=== Addressing Interfaces and Interactions ===
=== Addressing Interfaces and Interactions ===
An interface is a boundary where two or more systems interact.  Complex systems have large number of internal interactions, increasing the complexity of system integration as well as emergent behaviors of the integrated system. For each part of the architecture an external interface diagram provides the ability to address interactions between the SoI and external systems (Figure 5).  
For each part of the architecture, an external {{term|Interface (glossary)|interface}} diagram provides the ability to address interactions between the SoI and external systems (Figure 5).   
 
[insert figure SysReqt-5 here]    


Figure 5. Interfaces Address Interactions between Systems.  This figure is derived from the INCOSE Needs and Requirements Manual v1.1, Figure 6-10, reprinted with permission of INCOSE. All other rights are reserved by the copyright owner.
[[File:Figure SysReqt-5 NRM Figure 6-10.jpg|thumb|500px|center|'''Figure 5. Interfaces Address Interactions between Systems. ''' This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.]]


The phrase “interface requirement” refers to the specific form or template for a requirement that deals with an interaction of a system across an interface boundary with another system. Writing interface requirements is a three-step process:
The phrase “interface requirement” refers to the specific form or template for a functional requirement that deals with an interaction of a system across an interface boundary with another system. Writing interface requirements is a three-step process (INCOSE NRM 2022):


# Identify the interface boundaries and interactions across those boundaries.
# Identify the interface boundaries and interactions across those boundaries.
Line 188: Line 142:
# Write the interface requirements.
# Write the interface requirements.


Example forms of interface requirements:
Example interface requirement:
 
* The System shall [interact (function verb/object) with] [Another System] as defined in [location where the interaction is defined].
* The System shall [use/provide from/to] [Another System] [something] having the characteristics defined in [location where the something is defined].
 
The creation of interface requirements ensures that function/performance and fit/operational requirements are able to be specified associated with interactions from external systems.  Interface requirements should be included with the category of requirements they support based on their role in the primary SoOI objectives, placing them in separate locations just because they address interfaces may lead to confusion on whether the set of requirements is complete.
 
=== Textual versus Model Form of Requirement ===
Requirements can be recorded and managed via a document, database, or model-based approach in the form of a natural language expression, or in the form of a model element using MBSE. 
 
Benefits of Textual Requirements:  


* For many concepts that need to be communicated, there is a sizeable audience who cannot interpret (or are not willing to work with) diagrammatic or model-based representations of needs or requirements.
* The System shall send telemetry to the Ground System as defined in ICD 123, Table X.
* Not everyone has access to the toolset to leverage the model-based requirements and associated data, while most people have access to document-based tools.
* From a legal perspective, textual requirement statements are more acceptable in a formal agreement (or contract-based effort) by a wider, often non-technical, set of stakeholders.


Benefits of Model-based Requirements:  
=== Model Form of Requirements ===
Requirements can be recorded and managed via a document, database, or in the form of a model:


* Models provide the capability to address completeness in terms of functions, inputs to those functions, sources of those inputs, outputs, and customers (destinations/users) for those outputs.
* Models provide the capability to address completeness in terms of functions, inputs to those functions, sources of those inputs, outputs, and customers (destinations/users) for those outputs.
Line 211: Line 154:
* Models enable quantitative analyses and execution of simulations.
* Models enable quantitative analyses and execution of simulations.


Each type of form represents a specific visualization, ideally both are used to fully communicate the requirements of the system of interest. Combining textual requirements and models can leverage the advantages of both forms.  In MBSE, this is achieved when using the full textual statement as part of a requirement model element (Figure 6).
In MBSE, the model form of requirements can be expressed as a diagram (Figure 6) or within a table in the modeling tool (Figure 7), using well-formed textual statements as part of a requirement model element. Refer to [[Requirements Management]] for further guidance on usage of tools associated with textual and model requirements.


[insert figure SysReqt-6 here]
[[File:Figure SysReqt-6 Original.jpg|thumb|900px|center|'''Figure 6. Example of a Model Based Requirement Diagram.''' (SEBoK Original)]]


Figure 6. Example Mode-Based Requirements.  Original SEBoK figure.
[[File:Figure SysReqt-7 Original.jpg|thumb|900px|center|'''Figure 7. Example of a Model Based Requirement Table.''' (SEBoK Original)]]


There is a growing trend involving the usage of Natural Language Processors and Artificial Intelligence (AI) in generation of requirements. Some tools and organizations are researching how to utilize AI to develop complete and correct requirements. As a supporting tool, there is a lot of promise in AI with needs and requirements activities. At this time, the AI is unable to do the analysis associated with life cycle concepts and needs elicitation, or transformation of needs to requirements, as this involves understanding intent, and is not purely based on logic.
=== Addressing Unknowns ===
 
When initially generating a set of requirements, there is often a set of parameters which may require future analysis to determine their actual value.  One common method to do this is to use a placeholder in the requirement statement to indicate the requirement is drafted, yet further work is needed before it is considered complete. When a value is unknown, a common approach is to use the "To Be Determined" (TBD) indication within the requirement statement, in place of an actual value. When a value is determined but confidence is low (e.g., feasibility has not been assessed), a method to reflect this is to use the "To Be Resolved" (TBR) indication next to the value. Together, TBRs and TBDs are referred to generically as "TBXs". Keeping track of TBXs allows for awareness of the maturity of the requirements throughout the life cycle and is a valuable metric to evaluate completion and maturity of the integrated set of needs and set of design input requirements.  
=== Methods of Consolidation ===
Ensuring requirement statements are singular may result in a large quantity of requirements, which can lead to a challenge in comprehensibility of the requirement set, as well as costs associated with management and system verification activities for each of the requirements. A requirement set should have "just enough" requirements to ensure the realized system addresses the needs (achieving system validation).  The concept of consolidation is used to define techniques to ensure the requirements are necessary, sufficient, and "just enough".
 
The first method to ensure a consolidated requirement set is to assess each requirement against the following criteria:
 
* Is every requirement necessary to achieve the set of integrated needs?
* Does every requirement trace to a source?
* Are there redundancies within the requirement set?
* Are there hidden requirements in standards and regulations called out by requirements which need to be explicitly assessed for applicability, and perhaps pulled into the requirement set directly?
* Are all requirements at the correct level of abstraction? (No subsystem requirements in a system requirement set, and vice versa.)


When there are groupings of similar requirements with a common function and system verification approach, consider using a table to capture different criteria around that function.  While this does reduce the requirement quantity it is important to note that each criterion in the table will still require verification evidence.
TBXs can lead to risk if not addressed by the project team prior to significant work in establishing the design solution.  TBX management is the process of identifying the TBXs in a requirement set, establishing the work needed to resolve closure of the issue, identifying the owner of the work, and systematically iterating through and completing the actions to enable removal of these placeholders in the requirements.  
===Traceability===
===Traceability===
Traceability is a powerful way to manage the design input requirements, especially across levels and across subsystems and system elements within a specific level. Traceability helps ensure the requirements trace to their needs, and that they are correct and complete. Traceability also helps identify allocation of requirements to elements of the architecture.
Traceability is a powerful way to manage the design input requirements, especially across levels and across subsystems and system elements within a specific level as well as manage the requirements across the life cycle. Traceability helps ensure the requirements trace to their needs, and that they are correct and complete. Traceability also helps identify allocation of requirements to lower-level system elements of the architecture. Traceability is used to access any impacts of changes to requirements or other types of data across the life cycle, enabling insight into whether that change is beneficial or costly.
 
The individual sets of life cycle concepts, set of needs, system requirements, design output specifications, system validation artifacts, system verification artifacts represent a multi-level “spider web” of relationships throughout the development of the SoI.  Traceability provides the ability to connect this data, and track information at all levels of the system hierarchy (see [[Applying Life Cycle Processes]]). Traceability can be used to understand the source of requirements and can connect the verification data to the associated requirement during the System Verification process. Traceability is also used to address any impacts of changes to requirements or other types of data, enabling insight into whether that change is beneficial or costly.  


Defining a traceability relationship model at the beginning of the project enables an understanding of which relationships will be established and managed via traceability throughout the development of the SoI.  An example traceability model is shown in Figure 7.
Defining a traceability relationship model at the beginning of the project enables an understanding of which relationships will be established and managed via traceability throughout the development of the SoI.  An example traceability model is shown in Figure 8 (INCOSE NRM 2022).  


[insert figure SysReqt-7 here]
[[File:Figure SysReqt-8 NRM Figure 6-7.jpg|thumb|900px|center|'''Figure 8. Example Traceability Model.''' This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.]]


Figure 7. Example Traceability Model.  This figure is derived from the INCOSE Needs and Requirements Manual v1.1, Figure 6-20, reprinted with permission of INCOSE. All other rights are reserved by the copyright owner.
=== Planning for System Verification ===
=== Planning for System Verification ===
A best practice is to do early planning for how the project will perform [[System Verification|system verification]]. Verification activities must align with project constraints – otherwise there is a risk of missing objective evidence that the requirement is met by the SoI. System verification is the process to obtain objective evidence that the SOI satisfies the design input requirements. Defining the system verification Success Criteria, Strategy, and Method at this life cycle stage helps ensure the requirement statements are worded properly, are within the scope of the project plans, and demonstrate they achieve the characteristic of "verifiable".
A best practice is to do early planning for how the project will perform [[System Verification|system verification]]. Defining the system verification success criteria, strategy, and method when the requirements are generated helps ensure the requirement statements are worded properly, are within the scope of the project plans, and demonstrate they have the characteristic of "verifiable". This information can be captured within the attributes defined for the requirement.
 
===Assessing the System Requirements===
System requirements should be checked to gauge whether they are well expressed and appropriate. There are a number of characteristics that can be used to check system requirements, such as standard peer review techniques and comparison of each requirement against the set of requirements characteristics, which are listed in Table 2 and Table 3 of the "Presentation and Quality of Requirements" section (below). Requirements can be further validated using the requirements elicitation and rationale capture described in the section "Methods and Modeling Techniques" (below).


'''Requirement verification addresses:''' Are the requirements defined (stated) in a correct manner? Has the organization criteria for quality been followed?
===Assessing the Requirements===
Requirements should be assessed to gauge whether they are well-formed and that they meet the intent of the needs from which they were transformed.  Concepts behind assessment of the requirements are captured with the terms "requirement verification" and "requirement validation", which are not the same concepts described for system verification and system validation.


'''Requirement validation addresses:''' Do we have the right requirements?  Are the capabilities communicated by the requirement set sufficient to satisfy the integrated set of needs?  Validation addresses if the requirements are correct and are also achievable.
* Requirement verification activities address: Are the requirements well-formed, i.e., do the individual requirements and sets of requirements have the characteristics and follow the rules defined in the organizations criteria for well-formed requirements?
* Requirement validation activities address: Do we have the right requirements, i.e., do the requirements clearly communicate the intent of the needs, parent requirements, and other sources from which they were transformed, in a language understandable by the architectural definition, design definition, and manufacturing/coding teams?   Validation addresses if the requirements are correct and are also achievable.


For requirements communicated in a textual form, guidelines exist for writing well-formed requirements; they include recommendations about the syntax of requirements statements, wording (exclusions, representation of concepts, etc.), and characteristics (specific, measurable, achievable, feasible, testable, etc.). Refer to the INCOSE Guide to Writing Requirements as one example of guidance for writing and assessing well-formed requirements.
There are several methods that can be used to verify and validate requirements, such as standard peer review techniques and comparison of each requirement against a set of requirements characteristics and the integrated set of needs. For requirements communicated in a textual form, guidelines exist for writing well-formed requirements; they include recommendations about the syntax of requirements statements, wording (exclusions, representation of concepts, etc.), and characteristics (specific, measurable, achievable, feasible, testable, etc.) (INCOSE GtWR 2023).
===System Requirement Definition Artifacts===
The System Requirements Definition process results in a variety of artifacts:


There are several characteristics of both requirements and sets of requirements that are used to aid their development and to verify the implementation of requirements into the solution. Table 3 provides a list and descriptions of the characteristics for individual requirements and Table 4 provides a list and descriptions of characteristics for a set of requirements, as adapted from (ISO 2011, Sections 5.2.5 and 5.2.6).
* well-formed requirements recorded in models, databases, or documentation,
 
* requirement tree,
<center>
* traceability of requirements to other data,
{|
* defined interactions across boundaries,
|+'''Table 3. Characteristics of Individual Requirements.''' (SEBoK Original)
* performance budgets, and
!Characteristic
* initial system verification plans.
!Description
|-
|'''Necessary'''
|The requirement defines an essential capability, characteristic, constraint, and/or quality factor. If it is not included in the set of requirements, a deficiency in capability or characteristic will exist, which cannot be fulfilled by implementing other requirements
|-
|'''Appropriate'''
|The specific intent and amount of detail of the requirement is appropriate to the level of the entity to which it refers (level of abstraction).  This includes avoiding unnecessary constraints on the architecture or design to help ensure implementation independence to the extent possible
|-
|'''Unambiguous'''
|The requirement is stated in such a way so that it can be interpreted in only one way
|-
|'''Complete'''
|The requirement sufficiently describes the necessary capability, characteristic, constraint, or quality factor to meet the entity need without needing other information to understand the requirement 
|-
|'''Singular'''
|The requirement should state a single capability, characteristic, constraint, or quality factor
|-
|'''Feasible'''
|The requirement can be realized within entity constraints (e.g., cost, schedule, technical, legal, regulatory) with acceptable risk
|-
|'''Verifiable'''
|The requirement is structured and worded such that its realization can be proven (verified) to the customer’s satisfaction at the level at which the requirement exists
|-
|'''Correct'''
|The requirement must be an accurate representation of the entity need from which it was transformed
|-
|'''Conforming'''
|The individual requirements should conform to an approved standard template and style for writing requirements, when applicable
|}
</center>
 
<center>
{|
|+'''Table 4. Characteristics of a Set of Requirements.''' (SEBoK Original)
!Characteristic
!Description
|-
|'''Complete'''
|The requirement set stands alone such that it sufficiently describes the necessary capabilities, characteristics, constraints, and/or quality factors to meet the entity needs without needing other information. In addition, the set does not contain any to be defined (TBD), to be specified (TBS), or to be resolved (TBR) clauses.
|-
|'''Consistent'''
|The set of requirements contains individual requirements that are unique, do not conflict with or overlap with other requirements in the set, and the units and measurement systems they use are homogeneous. The language used within the set of requirements is consistent, i.e., the same word is used throughout the set to mean the same thing.
|-
|'''Feasible'''
|The requirement set can be realized within entity constraints (e.g., cost, schedule, technical, legal, regulatory) with acceptable risk. (Note: Feasible includes the concept of "affordable".)
|-
|'''Comprehensible'''
|The set of requirements must be written such that it is clear as to what is expected by the entity and its relation to the system of which it is a part.
|-
|'''Able to be validated'''
|It must be able to be proven the requirement set will lead to the achievement of the entity needs within the constraints (such as cost, schedule, technical, legal and regulatory compliance).
|}
</center>
 
===System Requirement Artifacts===
This process may create several artifacts, such as:
* System requirements document
* Set of requirements and associated attributes
* Requirement tree
* System model requirement diagram
* System model requirement table
 
The content, format, layout and ownership of these artifacts will vary depending on who is creating them as well as in which domain they will be utilized.  Between them and the outputs of the process, activities should cover the information identified in the first part of this article.


===Requirements Management===
===Requirements Management===
Requirements management is performed to ensure alignment of the system and system element requirements with other representations, analyses, and artifacts of the system.  It includes providing an understanding of the requirements, obtaining commitment, managing changes, maintaining bi-directional traceability among the requirements and with the rest of the system definition, and alignment with project resources and schedule. The [[Requirements Management]] article provides additional guidance on methods for performing requirements management.
Requirements Management (RM) is performed to ensure alignment of the system, subsystem, and system element requirements with other representations, analyses, and artifacts of the system across the life cycle.  It includes providing an understanding of the requirements, obtaining commitment, managing changes, maintaining bi-directional traceability among the requirements and with the rest of the system definition, and alignment with project resources and schedule. The [[Requirements Management]] article provides additional guidance on methods for performing requirements management.  
 
==Practical Considerations about System Requirements==
There are several '''pitfalls''' that will inhibit the generation and management of an optimal set of system requirements, as discussed in Table 5.


<center>
{|
|+'''Table 5. Major Pitfalls with Definition of System Requirements.''' (SEBoK Original)
!Pitfall
!Description
|-
|'''Insufficient Analysis of Stakeholder Needs and Requirements'''
|If the receivers of the stakeholder requirements do not perform a sufficient critical analysis of them, the consequence could be difficulties translating them into system requirements and the obligation to come back to the stakeholders, losing time.
|-
|'''Insufficient Analysis of Operational Modes and Scenarios'''
|The operational modes and operational scenarios are not sufficiently analyzed or defined by the person in charge of writing the system requirements. Those elements allow the structuring of the system and its use early in the engineering process and help the designer to remember functions and interfaces.
|-
|'''Incomplete Set of System Requirements'''
|If the system requirements are not sufficiently precise and complete, there is a great risk that the design will not have the expected level of quality and that the verification and validation of the system will be delayed.
|-
|'''Lack of Verification Method'''
|Delaying the capture of verification methods and events for each system requirement; identification of the verification approach for each requirement often provides additional insight as to the correctness and necessity of the requirement itself.
|-
|'''Missing traceability'''
|Incorrect or missing traceability of each requirement, both to an upper-level "parent" requirement as well as allocation to an inappropriate system or system element.
|}
</center>
==References==  
==References==  


===Works Cited===
===Works Cited===
INCOSE. 2022. INCOSE Needs and Requirements Manual, version 1.1. INCOSE-TP-2021-002-01.
INCOSE. 2022. ''INCOSE Needs and Requirements Manual (NRM)'', version 1.1. INCOSE-TP-2021-002-01.


INCOSE. 2022. INCOSE Guide to Needs and Requirements, version 1. INCOSE-TP-2021-003-01.
INCOSE. 2023. ''INCOSE Guide to Writing Requirements (GtWR)'', version 4. INCOSE-TP-2006-004-04.


===Primary References===
===Primary References===


ISO/IEC/IEEE. 2011. ''[[ISO/IEC/IEEE 29148|Systems and Software Engineering - Requirements Engineering]]''. Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC)/ Institute of Electrical and Electronics Engineers (IEEE), [[ISO/IEC/IEEE 29148]].
ISO/IEC/IEEE. 2018. ''[[ISO/IEC/IEEE 29148|Systems and Software Engineering - Requirements Engineering]]''. Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC)/ Institute of Electrical and Electronics Engineers (IEEE), [[ISO/IEC/IEEE 29148]].


ISO/IEC/IEEE. 2015.''[[ISO/IEC/IEEE 15288|Systems and Software Engineering - System Life Cycle Processes]].'' Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC), Institute of Electrical and Electronics Engineers (IEEE). [[ISO/IEC/IEEE 15288]]:2015.
ISO/IEC/IEEE. 2023.''[[ISO/IEC/IEEE 15288|Systems and Software Engineering - System Life Cycle Processes]].'' Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC), Institute of Electrical and Electronics Engineers (IEEE). [[ISO/IEC/IEEE 15288]]:2023.


INCOSE. 2023. '[[INCOSE Systems Engineering Handbook|Systems Engineering Handbook]]: A Guide for System Life Cycle Processes and Activities', version 5.0. Hoboken, NJ, USA: John Wiley and Sons, Inc, ISBN: 978-1-118-99940-0.
INCOSE. 2023. ''[[INCOSE Systems Engineering Handbook|Systems Engineering Handbook]]: A Guide for System Life Cycle Processes and Activities'', version 5.0. Hoboken, NJ, USA: John Wiley and Sons, Inc, ISBN: 978-1-118-99940-0.


Lamsweerde, A. van. 2009. ''[[Requirements Engineering]]: From System Goals to UML Models to Software Specifications''. New York, NY, USA: Wiley.
INCOSE. 2022. ''INCOSE Needs and Requirements Manual (NRM)'', version 1.1. INCOSE-TP-2021-002-01.


===Additional References===
INCOSE. 2022. ''INCOSE Guide to Needs and Requirements (GtNR)'', version 1. INCOSE-TP-2021-003-01.


Faisandier, A. 2012. ''Systems Opportunities and Requirements''. Belberaud, France: Sinergy'Com.  
INCOSE. 2023. ''INCOSE Guide to Writing Requirements (GtWR)'', version 4. INCOSE-TP-2006-004-04.


Hooks, I.F. and K.A. Farry. 2000. ''Customer-Centered Products: Creating Successful Products through Smart Requirements Management.'' New York, NY, USA: American Management Association.
===Additional References===
 
Hull, M.E.C., K. Jackson, A.J.J. Dick. 2010. ''Systems Engineering,'' 3rd ed. London, UK: Springer.
 
Roedler, G., D. Rhodes, C. Jones, and H. Schimmoller. 2010. ''Systems Engineering Leading Indicators Guide,''  version 2.0. San Diego, CA, USA: International Council on Systems Engineering (INCOSE), INCOSE-TP-2005-001-03.


SEI. 2007. "Requirements Management Process Area" and "Requirements Development Process Area." in ''Capability Maturity Model Integrated (CMMI) for Development'', version 1.2. Pittsburgh, PA, USA: Software Engineering Institute (SEI)/Carnegie Mellon University (CMU).  
INCOSE. 2022. ''INCOSE Guide to Verification and Validation (GtVV)'', version 1. INCOSE-TP-2021-004-01.  


===Relevant Videos===
===Relevant Videos===
*[https://www.youtube.com/watch?v=qaiSB1bdS_8 Introduction to Systems Engineering and Requirements]
*[https://www.youtube.com/@incoserwg891 INCOSE Requirements Working Group YouTube Channel]
*[https://www.youtube.com/@incoserwg891 INCOSE Requirements Working Group YouTube Channel]


Line 388: Line 226:
<center>[[Stakeholder Needs Definition|< Previous Article]] | [[Systems Engineering and Management|Parent Article]] | [[System Architecture Design Definition|Next Article >]]</center>
<center>[[Stakeholder Needs Definition|< Previous Article]] | [[Systems Engineering and Management|Parent Article]] | [[System Architecture Design Definition|Next Article >]]</center>


<center>'''SEBoK v. 2.9, released 20 November 2023'''</center>
<center>'''SEBoK v. 2.12, released 27 May 2025'''</center>


[[Category: Part 3]][[Category:Knowledge Area]]
[[Category: Part 3]][[Category:Knowledge Area]]

Latest revision as of 01:20, 24 May 2025


Lead Author: Tami Katz Contributing Authors: Lou Wheatcraft, Mike Ryan


The System Requirements Definition process transforms the stakeholderstakeholder view of desired capabilitiescapabilities into a technical, developer view of how the system can achieve those capabilities. System requirementsSystem requirements describe requirements which the system-of-interestsystem-of-interest (SoI) must fulfill to satisfy the stakeholder needsstakeholder needs and are expressed in an appropriate combination of well-formed textual statements and supporting models or diagrams. Inputs into this process are the life cycle concepts and integrated set of needs generated during the System Concept Definition activities.

System requirements play major roles in systems engineering, as they:

  • Form the basis of system architecturearchitecture and designdesign activities.
  • Form the basis of system integrationintegration and verificationverification activities.
  • Provide a means of communication between the various project team members that interact throughout the project.

Outputs of the System Requirements Definition process serve as inputs to a number of other technical processes, which include System Design Definition, System Architecture Definition, and System Verification.

Principles and Concepts

System Requirements Definition uses the outcome of the System Concept Definition activities to address what the system must do so that the integrated set of needs will be realized by the SoI. As shown in Figure 1, this information is then provided as input to the System Architecture Definition and System Design Definition processes, as well as the System Verification process.

Figure 1. System Requirements Definition is the first activity in the System Definition Process. (SEBoK Original figure derived from ISO 15288-2023)

Defining requirements is not only an exercise in writing it is also an exercise in engineering.  Every requirement represents an engineering decision as to what the SoI must do, or a quality the system must have, to meet the needs from which they were transformed.  Determination of what the system must do to meet a need is through a process of detailed requirement analysis, which can include the development and use of models, simulations, and prototypes.

A requirement statement is the result of a "formal transformation of one or more needs or parent requirements into an agreed-to obligation for an entity to perform some functionfunction or possess some quality within specified constraints with acceptable risk." (INCOSE NRM 2022). In this context the use of the term “quality” means an inherent feature or a distinguishing attribute.

There are many types of requirements; this article describes the requirements which are used as inputs into the System Architecture and System Design Definition processes. As such, these requirements can be referred to as design input requirements, which are defined iteratively and recursively as the integrated system is decomposed into subsystems and system elements (the SoI could exist at any level of a system architecture).

Process for Generating System Requirements

Transforming Needs to System Requirements

The System Requirement Definition activities begin with the transformation of the integrated set of needs into a set of requirements for the SoI. These requirements must be appropriate to the level that the SoI exists within the system architecture and communicate “what” the SoI must do to meet the needs, avoiding requirements that state implementation of “how” to achieve the design realization of the physical SoI.

Needs communicate the stakeholder’s perspective concerning their expectations of what they need the system of interest (SoI) to do from an external, black box view.

  • Example: The user needs the coffee maker to stop heating water once the user-selected temperature has been achieved.

The sources of needs are described in Stakeholder Needs Definition. These sources include the stakeholder expectations and needs, drivers and constraints, risk analysis, and life cycle concept analysis and maturation activities. These needs are treated as inputs to the System Requirement Definition process, which results in a set of design input requirements for the SoI.

Requirements communicate the technical, developer perspective concerning what the SoI must do to meet the stakeholder needs from an internal white box view.

  • Example: The Coffee Maker shall stop the heating function once the selected Brew Temperature has been achieved.

The process of generating a requirement statement is more than changing the subject of the need statement, it is an analysis of what the system must do to achieve what is needed. There are many types of analyses and tools that are used to make this determination:

  • functional analysis,
  • interface analysis,
  • data flow diagrams,
  • performance analysis, and
  • needs to transformation matrix.

Requirement analysis for functions and performance can be performed by using system models (supported by Model-Based Systems Engineering (MBSE) applications). Key enabling model views include activity diagrams, sequence diagrams, state machine diagrams, and structure diagrams (for hierarchy and interfaces). An example functional analysis is shown in Figure 2.

Figure 2. Example Function Analysis using a SysML Activity Diagram. (SEBoK Original)

Close and frequent coordination with the stakeholders is necessary to ensure the transformation is accurate and traceabilitytraceability is maintained. This results in a set of system requirements communicating measurable characteristics which can form the basis for system realizationsystem realization. A detailed analysis of a single need statement may result in multiple requirements expressing what the system must do to meet it, including definition of measurable performance criteria (INCOSE NRM 2022).

Use of Attributes

An attribute is additional information associated with an entity which is used to aid in its definition and management. Well-chosen attributes, when properly defined and tracked, can enable correct interpretation and management of requirements throughout the system life cycle. There are several useful attributes to consider:

  • rationale,
  • trace to source or parent,
  • system verification success criteria,
  • owner,
  • category,
  • status,
  • criticality, and
  • priority.

The use of the rationale attribute helps communicate why the requirement is needed, any assumptions made, the source of numbers, the results of related design studies, or any other related supporting information. This supports further requirements analysis and decomposition, as well as identifying the source of any requirement value. Defining the system verification success criteria helps ensure the requirement is well-formed, is verifiable, and aids in the planning for the project's verification program (INCOSE NRM 2022).

Categorizing Requirements

It is useful to organize the requirements into categories, grouping similar types of requirements together within a set. An example set of categories is shown in Table 1. While organizations may have different categorizations, for the set of requirements to be complete each category topic in Table 1 must be addressed.

Table 1. Example Types of Requirement Categories. (Derived from the INCOSE Needs and Requirements Manual)
Category Description
Function/ Performance The primary functions and associated performance that the SoI needs to perform in terms of its intended use.  The functions address the capabilities and features the stakeholders expect the SoI to have; performance addresses how well, how many, how fast attributes of the function.  Many of the primary functions involve interactions (interfaces) between the SOI and systems external to the SOI. All critical and high priority needs would be included in this category.
Fit/Operational Requirements dealing with functions that deal with a secondary or enabling capabilities, functions, and interactions between the SoI and external systems needed for the system to accomplish its primary functions. This includes functions concerning the ability of the system to interface with, interact with, connect to, operate within, and become an integral part of the macro system it is a part.  Fit includes human system interactions and interfaces as well as both the induced and natural environmentsenvironments (conditions of operations, transportation, storage, maintenance). For example, needs associated with safety, security, power, cooling, transportation and handling, storage, maintenance, and disposal.
Form Physical Characteristics. The shape, size, dimensions, mass, weight, and other observable parameters and characterizes that uniquely distinguish a system.  For software, form could address programming language, lines of code, memory requirements.
Quality Fitness for use.  For example, various “-ilities” such as reliability, testability, operability, availability, maintainability, operability, supportability, manufacturability, and interoperability.
Compliance Conformance with design and construction standards and regulations.

See Table 2 for example requirement statements, attributes and categories.

Table 2. Example Requirement Statements. (SEBoK Original)
Reqt ID Requirement Title Requirement Rationale Category
R1 Variable Temperature Settings The Coffee Maker shall have two user-selectable settings for coffee brewing:  Warm: 96°C +/- 2°C, Hot: 100°C+/- 2°C. Based on focus group inputs for selectable temperature; values are from analysis associated with consumer research surveys and safety regulations. Function/Performance
R2 Prohibit Brew if Container Missing If coffee container is not fully inserted into the brew location, the Coffee Maker shall prohibit brew function. Protective measure related to off-nominal use case. Function/Performance
R3 Operational Life The Coffee Maker shall have an operational life greater than or equal to 3 years. Analysis shows expected operational service of 1,000 hours over three years of usage, ensuring appliance lasts through the warranty period. Quality
R4 User Inputs The Coffee Maker shall limit the number of user inputs to: Power On, Brew Temperature, Brew Size, Brew Start. User inputs are assessed from focus groups to minimum set of inputs to achieve coffee maker full set of life cycle concepts. Fit/Operation

Requirements At Levels Within the Hierarchy

Requirements definition is an iterative and recursive process performed concurrently with the Architecture Definition Process. Upon determination of the system hierarchy, a requirement tree can be established showing the system level requirements and the supporting requirements at the lower-level elements of the hierarchy. Figure 3 shows an example flow from system requirement to lower-level requirements, and an example requirement tree is shown in Figure 4.

Figure 3. Example Flow of System Requirements with to Lower-level Requirements. This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.
Figure 4. Example Requirement Tree using a SysML Package Diagram. (SEBoK Original)

Allocation is the process by which the requirements at one level of the physical architecture are assigned to those entities at the next lower level of the architecture that have a role in the implementation of the allocated requirement. This involves an analysis where the project team determines what “role”, if any, each subsystem or system element at the next level of the architecture has in the implementation of the requirement being allocated. Requirements generated at the lower level are referred to as child requirements of an allocated parent requirement.

An important concept associated with allocation is budgeting. Budget refers to the total value of a parameter defined at the system level. The system requirement value may be decomposed to ensure the lower-level elements contribute their portion, enabling the system level to achieve its total value. Budgeted quantities result in requirements that have a dependency - a change in one will result in the need to change another. Budgeted values can include mass (weight), power usage, bandwidth, time, and quality attributes).

Principles Governing System Requirements

Addressing Interfaces and Interactions

For each part of the architecture, an external interfaceinterface diagram provides the ability to address interactions between the SoI and external systems (Figure 5).

Figure 5. Interfaces Address Interactions between Systems. This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.

The phrase “interface requirement” refers to the specific form or template for a functional requirement that deals with an interaction of a system across an interface boundary with another system. Writing interface requirements is a three-step process (INCOSE NRM 2022):

  1. Identify the interface boundaries and interactions across those boundaries.
  2. Define the interactions across the interface boundaries (the characteristics of what is crossing the boundary, and media involved).
  3. Write the interface requirements.

Example interface requirement:

  • The System shall send telemetry to the Ground System as defined in ICD 123, Table X.

Model Form of Requirements

Requirements can be recorded and managed via a document, database, or in the form of a model:

  • Models provide the capability to address completeness in terms of functions, inputs to those functions, sources of those inputs, outputs, and customers (destinations/users) for those outputs.
  • Models help facilitate communication by making complex systems and processes easier to understand (a picture is worth a thousand words….).
  • Models enable the capture of interdependencies of requirements to other aspects of the system dataset, such as inputs, needs, architecture, test cases, etc.
  • Models enable quantitative analyses and execution of simulations.

In MBSE, the model form of requirements can be expressed as a diagram (Figure 6) or within a table in the modeling tool (Figure 7), using well-formed textual statements as part of a requirement model element. Refer to Requirements Management for further guidance on usage of tools associated with textual and model requirements.

Figure 6. Example of a Model Based Requirement Diagram. (SEBoK Original)
Figure 7. Example of a Model Based Requirement Table. (SEBoK Original)

Addressing Unknowns

When initially generating a set of requirements, there is often a set of parameters which may require future analysis to determine their actual value.  One common method to do this is to use a placeholder in the requirement statement to indicate the requirement is drafted, yet further work is needed before it is considered complete. When a value is unknown, a common approach is to use the "To Be Determined" (TBD) indication within the requirement statement, in place of an actual value. When a value is determined but confidence is low (e.g., feasibility has not been assessed), a method to reflect this is to use the "To Be Resolved" (TBR) indication next to the value. Together, TBRs and TBDs are referred to generically as "TBXs". Keeping track of TBXs allows for awareness of the maturity of the requirements throughout the life cycle and is a valuable metric to evaluate completion and maturity of the integrated set of needs and set of design input requirements.

TBXs can lead to risk if not addressed by the project team prior to significant work in establishing the design solution. TBX management is the process of identifying the TBXs in a requirement set, establishing the work needed to resolve closure of the issue, identifying the owner of the work, and systematically iterating through and completing the actions to enable removal of these placeholders in the requirements.

Traceability

Traceability is a powerful way to manage the design input requirements, especially across levels and across subsystems and system elements within a specific level as well as manage the requirements across the life cycle. Traceability helps ensure the requirements trace to their needs, and that they are correct and complete. Traceability also helps identify allocation of requirements to lower-level system elements of the architecture. Traceability is used to access any impacts of changes to requirements or other types of data across the life cycle, enabling insight into whether that change is beneficial or costly.

Defining a traceability relationship model at the beginning of the project enables an understanding of which relationships will be established and managed via traceability throughout the development of the SoI. An example traceability model is shown in Figure 8 (INCOSE NRM 2022).

Figure 8. Example Traceability Model. This figure is reprinted with permission of Lou Wheatcraft. All other rights are reserved by the copyright owner.

Planning for System Verification

A best practice is to do early planning for how the project will perform system verification. Defining the system verification success criteria, strategy, and method when the requirements are generated helps ensure the requirement statements are worded properly, are within the scope of the project plans, and demonstrate they have the characteristic of "verifiable". This information can be captured within the attributes defined for the requirement.

Assessing the Requirements

Requirements should be assessed to gauge whether they are well-formed and that they meet the intent of the needs from which they were transformed. Concepts behind assessment of the requirements are captured with the terms "requirement verification" and "requirement validation", which are not the same concepts described for system verification and system validation.

  • Requirement verification activities address: Are the requirements well-formed, i.e., do the individual requirements and sets of requirements have the characteristics and follow the rules defined in the organizations criteria for well-formed requirements?
  • Requirement validation activities address: Do we have the right requirements, i.e., do the requirements clearly communicate the intent of the needs, parent requirements, and other sources from which they were transformed, in a language understandable by the architectural definition, design definition, and manufacturing/coding teams?   Validation addresses if the requirements are correct and are also achievable.

There are several methods that can be used to verify and validate requirements, such as standard peer review techniques and comparison of each requirement against a set of requirements characteristics and the integrated set of needs. For requirements communicated in a textual form, guidelines exist for writing well-formed requirements; they include recommendations about the syntax of requirements statements, wording (exclusions, representation of concepts, etc.), and characteristics (specific, measurable, achievable, feasible, testable, etc.) (INCOSE GtWR 2023).

System Requirement Definition Artifacts

The System Requirements Definition process results in a variety of artifacts:

  • well-formed requirements recorded in models, databases, or documentation,
  • requirement tree,
  • traceability of requirements to other data,
  • defined interactions across boundaries,
  • performance budgets, and
  • initial system verification plans.

Requirements Management

Requirements Management (RM) is performed to ensure alignment of the system, subsystem, and system element requirements with other representations, analyses, and artifacts of the system across the life cycle. It includes providing an understanding of the requirements, obtaining commitment, managing changes, maintaining bi-directional traceability among the requirements and with the rest of the system definition, and alignment with project resources and schedule. The Requirements Management article provides additional guidance on methods for performing requirements management.

References

Works Cited

INCOSE. 2022. INCOSE Needs and Requirements Manual (NRM), version 1.1. INCOSE-TP-2021-002-01.

INCOSE. 2023. INCOSE Guide to Writing Requirements (GtWR), version 4. INCOSE-TP-2006-004-04.

Primary References

ISO/IEC/IEEE. 2018. Systems and Software Engineering - Requirements Engineering. Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC)/ Institute of Electrical and Electronics Engineers (IEEE), ISO/IEC/IEEE 29148.

ISO/IEC/IEEE. 2023.Systems and Software Engineering - System Life Cycle Processes. Geneva, Switzerland: International Organization for Standardization (ISO)/International Electrotechnical Commission (IEC), Institute of Electrical and Electronics Engineers (IEEE). ISO/IEC/IEEE 15288:2023.

INCOSE. 2023. Systems Engineering Handbook: A Guide for System Life Cycle Processes and Activities, version 5.0. Hoboken, NJ, USA: John Wiley and Sons, Inc, ISBN: 978-1-118-99940-0.

INCOSE. 2022. INCOSE Needs and Requirements Manual (NRM), version 1.1. INCOSE-TP-2021-002-01.

INCOSE. 2022. INCOSE Guide to Needs and Requirements (GtNR), version 1. INCOSE-TP-2021-003-01.

INCOSE. 2023. INCOSE Guide to Writing Requirements (GtWR), version 4. INCOSE-TP-2006-004-04.

Additional References

INCOSE. 2022. INCOSE Guide to Verification and Validation (GtVV), version 1. INCOSE-TP-2021-004-01.

Relevant Videos


< Previous Article | Parent Article | Next Article >
SEBoK v. 2.12, released 27 May 2025