Comment:
Migration of unmigrated content due to installation of a new plugin
...
Alias
alias
SWE-055
...
Tabsetup
1. The Requirement
1
2. Rationale
2
3. Guidance
3
4. Small Projects
4
5. Resources
5
6. Lessons Learned
1. The Requirement
Wiki Markup
{div3:id=
Div
id
tabs-1
}
h1.
1.
Requirements
3.1.2.3
The
project
shall
perform
requirements
validation
to
ensure
that
the
software
will
perform
as
intended
in
the
customer
environment.
h2. {color:#003366}{*}1.1 Notes{*}{color}
Requirements validation includes confirmation that the requirements meet the needs and expectations of the customer. Requirement validation is confirmation, through the provision of objective evidence, that the requirements for a specific intended use or application have been fulfilled.
h2. 1.2 Applicability Across Classes
{applicable:asc=1\|ansc=1\|bsc=1\|bnsc=1\|csc=1\|cnsc=1\|dsc=1\|dnsc=0\|esc=1\|ensc=0\|f=1\|g=1|h=0|}
{div3}
Wiki Markup
{div3:id=tabs-2}
h1. 2. Rationale
Requirements are the basis for a project. They identify the need to be addressed, the behavior of the system, and the constraints under which the problem is to be solved. They also specify the performance of the product to be delivered by a contracted provider of software.
{floatbox}Per the NASA IV&V Technical Framework{sweref:003}document, "The objective of Requirements IV&V is to ensure the system's software requirements are high quality (correct, consistent, complete, accurate, readable, and testable), and will adequately meet the needs of the system and expectations of its customers and users, considering its operational environment under nominal and off-nominal conditions, and that no unintended features are introduced..." {floatbox}
Requirements that accurately describe the need to be solved by the project team need to be defined before the main planning and building activities begin. Validation is one way to ensure the requirements define the need completely, clearly, correctly, and consistently to give the software engineers the best chance to build the correct product.
Validation is a process of evaluating artifacts to ensure that the right behaviors have been defined in the artifacts. The right behaviors adequately describe what the system is supposed to do, what the system is not supposed to do, and what the system is supposed to do under adverse conditions.
Marasco (2007) describes requirements validation as "making sure everyone understands and agrees on the requirements put forth, and that they are realistic and precise" {sweref:247}
Other reasons for validating requirements:
* To ensure customer satisfaction with the end product.
* To reduce costs (i.e., get it right the first time).
* To gain confidence that the requirements can be fulfilled for the intended use.
* To clarify meaning and expectations.
{div3}
Wiki Markup
{div3:id=tabs-3}
h1. 3. Guidance
The basic validation process is shown below with the steps addressed by this requirement highlighted:
!SWE-055_Image.jpg|border=0,width=769,height=174!
{panel}Validation activities are not to be confused with verification activities as each has a specific goal. Validation is designed to confirm the right system is being produced while verification is designed to confirm the product is being produced correctly. {panel}
Requirements validation, as used in this requirement, addresses all of the following:
* Confirmation of the correctness, completeness, clarity, and consistency of the requirements with stakeholders.
* Confirmation that the requirements will be fulfilled by the resulting product.
* Confirmation that implied or inherent requirements (e.g., system should do X before Y) are correctly implemented.
Validation activities are not performed in an ad hoc manner, but are planned and captured in a validation plan document. The validation plan is typically part of a verification and validation (V&V) plan, a software V&V plan (SVVP), or is included in the Software Management/Development Plan (SMP/SDP).
All requirements need to be validated. Categories include, but are not limited to:
* System requirements (note that systems level validation procedures are described in NPR 7123.1A, NASA Systems Engineering Processes and Requirements {sweref:041}, with guidelines in NASA/SP-2007-6105, NASA Systems Engineering Handbook{sweref:273}).
* Subsystem requirements.
* Safety requirements.
* Component requirements.
* Integration requirements.
To perform complete requirements validation, multiple techniques may be required based on the nature of the system, the environment in which the system will function, or even the phase of the development life cycle. Sample validation techniques or methods include, but are not limited to:
* Develop operational concepts --
** Document descriptions of how the software "will be operated during the life-cycle phases ... describes the system characteristics from an operational perspective." {sweref:206}
** Use this technique to improve the quality of customer requirements. {sweref:274}
** Use this technique to ensure customer requirements and expectations are correctly captured.
* Prototype demonstrations --
** Creating incomplete versions of the software being created to allow stakeholders to evaluate the proposed solution(s) by trying them out (No Silver Bullet: Essence and Accidents of Software Engineering by Frederick P. Brooks {sweref:322}).
** Use this technique when budget and time allow, when stakeholders are hands-on, when the development model is an iterative process, etc.
* Functional demonstrations --
** Demonstrating specific actions or functions of the code.
** Use this technique to validate requirements related to questions. such as "can the user do this" or "does this particular feature work."
* Formal reviews --
** Structured reviews in which specified steps are taken and roles are assigned to individual reviewers
1.1 Notes
Requirements validation includes confirmation that the requirements meet the needs and expectations of the customer. Requirement validation is confirmation, through the provision of objective evidence, that the requirements for a specific intended use or application have been fulfilled.
1.2 Applicability Across Classes
applicable
f
1
g
1
h
0
asc
1
ansc
1
bnsc
1
csc
1
bsc
1
esc
1
cnsc
1
dsc
1
dnsc
0
ensc
0
Div
id
tabs-2
2. Rationale
Requirements are the basis for a project. They identify the need to be addressed, the behavior of the system, and the constraints under which the problem is to be solved. They also specify the performance of the product to be delivered by a contracted provider of software.
Floatbox
Per the NASA IV&V Technical Framework
sweref
003
003
document, "The objective of Requirements IV&V is to ensure the system's software requirements are high quality (correct, consistent, complete, accurate, readable, and testable), and will adequately meet the needs of the system and expectations of its customers and users, considering its operational environment under nominal and off-nominal conditions, and that no unintended features are introduced..."
Requirements that accurately describe the need to be solved by the project team need to be defined before the main planning and building activities begin. Validation is one way to ensure the requirements define the need completely, clearly, correctly, and consistently to give the software engineers the best chance to build the correct product.
Validation is a process of evaluating artifacts to ensure that the right behaviors have been defined in the artifacts. The right behaviors adequately describe what the system is supposed to do, what the system is not supposed to do, and what the system is supposed to do under adverse conditions.
Marasco (2007) describes requirements validation as "making sure everyone understands and agrees on the requirements put forth, and that they are realistic and precise"
sweref
247
247
Other reasons for validating requirements:
To ensure customer satisfaction with the end product.
To reduce costs (i.e., get it right the first time).
To gain confidence that the requirements can be fulfilled for the intended use.
To clarify meaning and expectations.
Div
id
tabs-3
3. Guidance
The basic validation process is shown below with the steps addressed by this requirement highlighted:
Image Added
Panel
Validation activities are not to be confused with verification activities as each has a specific goal. Validation is designed to confirm the right system is being produced while verification is designed to confirm the product is being produced correctly.
Requirements validation, as used in this requirement, addresses all of the following:
Confirmation of the correctness, completeness, clarity, and consistency of the requirements with stakeholders.
Confirmation that the requirements will be fulfilled by the resulting product.
Confirmation that implied or inherent requirements (e.g., system should do X before Y) are correctly implemented.
Validation activities are not performed in an ad hoc manner, but are planned and captured in a validation plan document. The validation plan is typically part of a verification and validation (V&V) plan, a software V&V plan (SVVP), or is included in the Software Management/Development Plan (SMP/SDP).
All requirements need to be validated. Categories include, but are not limited to:
System requirements (note that systems level validation procedures are described in NPR 7123.1A, NASA Systems Engineering Processes and Requirements
sweref
041
041
, with guidelines in NASA/SP-2007-6105, NASA Systems Engineering Handbook
sweref
273
273
).
Subsystem requirements.
Safety requirements.
Component requirements.
Integration requirements.
To perform complete requirements validation, multiple techniques may be required based on the nature of the system, the environment in which the system will function, or even the phase of the development life cycle. Sample validation techniques or methods include, but are not limited to:
Develop operational concepts –
Document descriptions of how the software "will be operated during the life-cycle phases ... describes the system characteristics from an operational perspective."
sweref
206
206
Use this technique to improve the quality of customer requirements.
sweref
274
274
Use this technique to ensure customer requirements and expectations are correctly captured.
Prototype demonstrations –
Creating incomplete versions of the software being created to allow stakeholders to evaluate the proposed solution(s) by trying them out (No Silver Bullet: Essence and Accidents of Software Engineering by Frederick P. Brooks
sweref
322
322
).
Use this technique when budget and time allow, when stakeholders are hands-on, when the development model is an iterative process, etc.
Functional demonstrations –
Demonstrating specific actions or functions of the code.
Use this technique to validate requirements related to questions. such as "can the user do this" or "does this particular feature work."
Formal reviews –
Structured reviews in which specified steps are taken and roles are assigned to individual reviewers (NASA-GB-8719.13,
NASA
Software
Safety
Guidebook
{sweref:276})
** Formal reviews are useful for validating documents, such as software requirements specifications
sweref
276
276
)
Formal reviews are useful for validating documents, such as software requirements specifications (SRS),
and
allow
for
discussion
and
eventual
agreement
on
the
requirements
among
persons
with
varied
viewpoints.
**
Formal
reviews
typically
only
address
portions
(sections
or
specified
number
of
pages)
of
documents
in
a
single
review
rather
than
an
entire
document.
**
Formal
reviews
allow
for
identification
of
defects
as
well
as
suggested
corrections.
*
Software
peer
reviews/inspections
of
product
components --
** Relevant stakeholders investigate and review a product, such as requirements to determine if it meets preset criteria and to identify product defects.
** Peer reviews and inspections are useful for validating documents, such as SRSs, and allow for peer discussion of the technical aspects of the document content.
** Inspections can be informal or formal with formal inspections being more structured with specific activities, assigned roles, and defined results (metrics, defects, etc.).
** Inspections typically cover larger volumes of information than formal reviews and only identify the issues; solutions are typically not part of the peer review/inspection process.
* Analysis
** Analysis can be considered a "lightweight" version of running software against a simulation and involves going through the calculations without actually running the simulation in real time.
** Analysis removes the time-related aspects of the validation, which may need to be validated using a different technique.
** Use this technique as part of an overall validation strategy or as a precursor step to a full simulation.
** Beta testing of new software applications.
** Use this technique when budget and time allow, when stakeholders are hands-on, when stakeholders (primarily user groups) and project schedule are amenable to this type of testing, etc.
\\
* Paper simulations/prototyping/storyboarding: {sweref:304}
** Drawing prototypes on paper.
** This is a low-cost prototyping technique that might be useful in the early stages of high-level requirements development to capture and display visually the ideas and concepts or for projects that don't have the budget for prototyping in software.
** Issues with prototyping on paper include storing for future reference and difficulty transforming into executable prototypes.
** Typically these prototypes simply end up in requirements documents.
* Use-case based modeling: {sweref:304}
** Modeling system behavior using use-cases to identify actors and their interaction with the system.
** Use this technique when it is easy to identify users (both human and other systems) and services or functionality provided by the system.
** This technique is helpful when the focus of the software defined by the requirements is on user interaction with the system because use-case models depict a problem and solution from the user's point of view, "who" does "what" with the system.
* Viewpoint-oriented requirements validation: {sweref:304}
** Identify conflicting requirements based on viewpoints of various stakeholders.
** Use this technique when there is a need to identify conflicting requirements based on viewpoints or when it is important to consider requirements from multiple perspectives.
* Formal methods
** Mathematically rigorous techniques.
** Use this technique to validate formal requirements specifications or to validate key properties of requirements. {sweref:181}
* Review of test cases
** Reviewing test cases individually and as a set to confirm coverage of system scenarios {sweref:209}.
** Reviewing test cases with stakeholders to confirm functional and operational scenarios (as defined by the requirements).
** Development and review of test cases can help find problems in the requirements "since it requires completely thinking through the operation of the application." {sweref:276}
** This technique is particularly useful for test-driven software development.
When validating requirements, either new or modified, consider including the following roles because all roles will review the requirements from a different perspective:
|| *Sample Roles for Validation Activities* ||
| Customer |
| Developer |
| Interface Representative |
| Requirement/SRS Author |
| Reviewer (topic expert, safety, software assurance, etc.) \\
\- As appropriate, multiple Reviewers could be included, each providing a specialized perspective |
When available and appropriate, checklists and documented procedures are used for the various techniques selected for requirements validation to ensure consistency of application of the technique.
|| *Sample Checklists and Procedures* ||
| Peer review/inspection checklists |
| Formal review checklists |
| Analysis procedures |
| Acceptance test procedures |
Samples are included in the Resources section of this guidance, but Center procedures take precedence when conducting requirements validation activities at a particular Center.
A requirements traceability matrix may also be useful to ensure that all requirements are validated. The matrix could include:
* Links to higher-level requirements which identify/define user needs.
* A place to record validation methods.
* A place to record or reference the validation results.
Some common issues related to requirements validation include: {sweref:012}
* Confusing management of requirements with validation of requirements.
** Managing requirements will not ensure they are correct.
* When using prototyping to validate requirements:
** Failing to keep the focus on _what_ the software is supposed to do.
** Allowing the focus to shift to the _how_ the system will look when it is done.
* Failing to re-validate requirements as they change during the project life cycle.
* Getting stakeholders with different views to agree on a single version of a requirement; interpretation can be troublesome.
* When using visual models to bridge the communication gaps among stakeholders, only translating a limited number of requirements into visual models (often due to time or budgetary constraints).
* Failing to link the text to visual models; both are needed for understanding.
* Failing to use a formal process to track all versions of the requirements as they change during the project.
Additionally, it is important to confirm with stakeholders that their needs and expectations remain adequately and correctly captured by the requirements following resolution of conflicting, impractical and/or unrealizable stakeholder requirements.
While the Software Requirements Review (SRR) addresses more than just "getting the requirements right", the SRR can include that action as part of the review.
Additional guidance related to requirements validation may be found in the following related requirements in this Handbook:
| [SWE-029|SWE-029] | Validation Planning |
| [SWE-031|SWE-031] | Validation Results |
| [SWE-073|SWE-073] | Platform or Hi-Fidelity Simulations |
| [SWE-102|SWE-102] | SW Development/Management Plan |
{div3}
Wiki Markup
{div3:id=tabs-4}
h1. 4. Small Projects
Small projects need to balance the effectiveness of the available methods against available resources to validate requirements associated with software. Safety-critical requirements, human-rated requirements, and other critical requirements need to be validated with appropriately rigorous methods which are documented in the project's software development/management plan.
{div3}
{div3:id=tabs-6}
h1. 6. Lessons Learned
A documented lesson from the NASA Lessons Learned database notes the following:
*Mars Climate Orbiter Mishap Investigation Board - Phase I Report. Lesson Number 0641:* A mishap could have been prevented if requirements validation had caught a mismatch between interface documentation and the requirements. Because the mismatch was not caught, the Mars Climate Orbiter (MCO) spacecraft was lost due to "the failure to use metric units in the coding of a ground software file...used in trajectory models...The data in the ...file was required to be in metric units per existing software interface documentation. " The data was provided in English units per the requirements{sweref:513}.
{div3}
components –
Relevant stakeholders investigate and review a product, such as requirements to determine if it meets preset criteria and to identify product defects.
Peer reviews and inspections are useful for validating documents, such as SRSs, and allow for peer discussion of the technical aspects of the document content.
Inspections can be informal or formal with formal inspections being more structured with specific activities, assigned roles, and defined results (metrics, defects, etc.).
Inspections typically cover larger volumes of information than formal reviews and only identify the issues; solutions are typically not part of the peer review/inspection process.
Analysis
Analysis can be considered a "lightweight" version of running software against a simulation and involves going through the calculations without actually running the simulation in real time.
Analysis removes the time-related aspects of the validation, which may need to be validated using a different technique.
Use this technique as part of an overall validation strategy or as a precursor step to a full simulation.
Beta testing of new software applications.
Use this technique when budget and time allow, when stakeholders are hands-on, when stakeholders (primarily user groups) and project schedule are amenable to this type of testing, etc.
Paper simulations/prototyping/storyboarding:
sweref
304
304
Drawing prototypes on paper.
This is a low-cost prototyping technique that might be useful in the early stages of high-level requirements development to capture and display visually the ideas and concepts or for projects that don't have the budget for prototyping in software.
Issues with prototyping on paper include storing for future reference and difficulty transforming into executable prototypes.
Typically these prototypes simply end up in requirements documents.
Use-case based modeling:
sweref
304
304
Modeling system behavior using use-cases to identify actors and their interaction with the system.
Use this technique when it is easy to identify users (both human and other systems) and services or functionality provided by the system.
This technique is helpful when the focus of the software defined by the requirements is on user interaction with the system because use-case models depict a problem and solution from the user's point of view, "who" does "what" with the system.
Viewpoint-oriented requirements validation:
sweref
304
304
Identify conflicting requirements based on viewpoints of various stakeholders.
Use this technique when there is a need to identify conflicting requirements based on viewpoints or when it is important to consider requirements from multiple perspectives.
Formal methods
Mathematically rigorous techniques.
Use this technique to validate formal requirements specifications or to validate key properties of requirements.
sweref
181
181
Review of test cases
Reviewing test cases individually and as a set to confirm coverage of system scenarios
sweref
209
209
.
Reviewing test cases with stakeholders to confirm functional and operational scenarios (as defined by the requirements).
Development and review of test cases can help find problems in the requirements "since it requires completely thinking through the operation of the application."
sweref
276
276
This technique is particularly useful for test-driven software development.
When validating requirements, either new or modified, consider including the following roles because all roles will review the requirements from a different perspective:
Sample Roles for Validation Activities
Customer
Developer
Interface Representative
Requirement/SRS Author
Reviewer (topic expert, safety, software assurance, etc.) - As appropriate, multiple Reviewers could be included, each providing a specialized perspective
When available and appropriate, checklists and documented procedures are used for the various techniques selected for requirements validation to ensure consistency of application of the technique.
Sample Checklists and Procedures
Peer review/inspection checklists
Formal review checklists
Analysis procedures
Acceptance test procedures
Samples are included in the Resources section of this guidance, but Center procedures take precedence when conducting requirements validation activities at a particular Center.
A requirements traceability matrix may also be useful to ensure that all requirements are validated. The matrix could include:
Links to higher-level requirements which identify/define user needs.
A place to record validation methods.
A place to record or reference the validation results.
Some common issues related to requirements validation include:
sweref
012
012
Confusing management of requirements with validation of requirements.
Managing requirements will not ensure they are correct.
When using prototyping to validate requirements:
Failing to keep the focus on what the software is supposed to do.
Allowing the focus to shift to the how the system will look when it is done.
Failing to re-validate requirements as they change during the project life cycle.
Getting stakeholders with different views to agree on a single version of a requirement; interpretation can be troublesome.
When using visual models to bridge the communication gaps among stakeholders, only translating a limited number of requirements into visual models (often due to time or budgetary constraints).
Failing to link the text to visual models; both are needed for understanding.
Failing to use a formal process to track all versions of the requirements as they change during the project.
Additionally, it is important to confirm with stakeholders that their needs and expectations remain adequately and correctly captured by the requirements following resolution of conflicting, impractical and/or unrealizable stakeholder requirements.
While the Software Requirements Review (SRR) addresses more than just "getting the requirements right", the SRR can include that action as part of the review.
Additional guidance related to requirements validation may be found in the following related requirements in this Handbook:
Small projects need to balance the effectiveness of the available methods against available resources to validate requirements associated with software. Safety-critical requirements, human-rated requirements, and other critical requirements need to be validated with appropriately rigorous methods which are documented in the project's software development/management plan.
Div
id
tabs-5
5. Resources
refstable
toolstable
Div
id
tabs-6
6. Lessons Learned
A documented lesson from the NASA Lessons Learned database notes the following:
Mars Climate Orbiter Mishap Investigation Board - Phase I Report. Lesson Number 0641: A mishap could have been prevented if requirements validation had caught a mismatch between interface documentation and the requirements. Because the mismatch was not caught, the Mars Climate Orbiter (MCO) spacecraft was lost due to "the failure to use metric units in the coding of a ground software file...used in trajectory models...The data in the ...file was required to be in metric units per existing software interface documentation. " The data was provided in English units per the requirements