ESA PSS-05-01 Issue 1 Revision 1
March 1995
Guide
to the
software
engineering
standards
Prepared by:
ESA Board for Software
Standardisation and Control
(BSSC)
european space agency / agence spatiale européenne
8-10, rue Mario-Nikis, 75738 PARIS CEDEX, France
ii ESA PSS-05-01 Issue 1 Revision 1 (March 1995)
DOCUMENT STATUS SHEET
DOCUMENT STATUS SHEET
DOCUMENT STATUS SHEET
1. DOCUMENT TITLE: ESA PSS-05-01 Guide to the software engineering standards
2. ISSUE 3. REVISION 4. DATE 5. REASON FOR CHANGE
1 0 1991 First issue
1 1 1995 Minor updates for publication
Issue 1 Revision 1 approved, May 1995
Board for Software Standardisation and Control
M. Jones and U. Mortensen, co-chairmen
Issue 1 approved, 1st February 1992
Telematics Supervisory Board
Issue 1 approved by:
The Inspector General, ESA
Published by ESA Publications Division,
ESTEC, Noordwijk, The Netherlands.
Printed in the Netherlands.
ESA Price code: E2
ISSN 0379-4059
Copyright © 1995 by European Space Agency
ESA PSS-05-01 Issue 1 Revision 1 (March 1995) iii
TABLE OF CONTENTS
TABLE OF CONTENTS
CHAPTER 1 INTRODUCTION..................................................................................1
1.1 PURPOSE ................................................................................................................. 1
1.2 OVERVIEW................................................................................................................ 1
CHAPTER 2 THE DOCUMENT TREE ......................................................................3
2.1 INTRODUCTION....................................................................................................... 3
2.1 THE DOCUMENT IDENTIFIER................................................................................. 3
2.2 THE STRUCTURE OF THE DOCUMENT TREE ...................................................... 4
2.2.1 The Level 1 Document...................................................................................... 4
2.2.2 The Level 2 Documents.................................................................................... 4
2.2.3 The Level 3 Documents.................................................................................... 5
APPENDIX A GLOSSARY .................................................................................... A-1
iv ESA PSS-05-01 Issue 1 Revision 1 (March 1995)
TABLE OF CONTENTS
This page is intentionally left blank.
ESA PSS-05-01 Issue 1 Revision 1 (March 1995) 1
INTRODUCTION
CHAPTER 1
INTRODUCTION
1.1 PURPOSE
ESA PSS-05-0 describes the software engineering standards to be
applied for all deliverable software implemented for the European Space
Agency, either in house or by industry.
ESA PSS-05-0 is the top-level software engineering standard and is
the root of a document tree. Lower level standards that branch from this root
contain advisory and optional material. The purpose of this document is to
define and explain the principles and conventions of the document tree.
1.2 OVERVIEW
Chapter 2 explains the document identification scheme and the
structure of the document tree.
2 ESA PSS-05-01 Issue 1 Revision 1 (March 1995)
INTRODUCTION
This page is intentionally left blank.
ESA PSS-05-01 Issue 1 Revision 1 (March 1995) 3
THE DOCUMENT TREE
CHAPTER 2
THE DOCUMENT TREE
2.1 INTRODUCTION
The document tree currently planned is shown in figure 1. Further
documents may be added in the future.
Level 1
ESA
Software
Engineering
Standards
PSS-05-0
Level 2
Guide to the
Software Engineering
Standards
PSS-05-01
Guide to the Guide to
User Requirements Software Project
Definition Phase Management
PSS-05-02 UR Guide PSS-05-08 SPM Guide
PSS-05-03 SR Guide PSS-05-09 SCM Guide
PSS-05-04 AD Guide PSS-05-10 SVV Guide
PSS-05-05 DD Guide PSS-05-11 SQA Guide
PSS-05-06 TR Guide
PSS-05-07 OM Guide
Level 3
Guide to
Fortran Coding
PSS-05-05-01 Fortran
PSS-05-05-02 Ada
PSS-05-05-03 C
Figure 1: The ESA PSS-05-0 Document Tree
2.1 THE DOCUMENT IDENTIFIER
Each document is given an identifier that follows the protocol:
ESA PSS-05[-level 2 number][-level 3 number]
PSS stands for ‘ Procedures, Specifications and Standards'. The
first field, ‘
05', defines the subject area as ‘
software engineering'.
4 ESA PSS-05-01 Issue 1 Revision 1 (March 1995)
THE DOCUMENT TREE
The number of numeric fields in the identifier defines the level (e.g.
ESA PSS-05-05-02 is a level 3 document). A leading zero is added to
numbers in the range 1 to 9 to allow even tabulation of document lists.
Numbers are allocated sequentially from 1.
The exception to this protocol is the identifier for the level 1
document ESA PSS-05-0. The second numeric field ‘ -0' exists to retain
compatibility with earlier PSS numbering schemes.
2.2 THE STRUCTURE OF THE DOCUMENT TREE
2.2.1 The Level 1 Document
Level 1 contains one and only one document, ESA PSS-05-0, which
is a mandatory standard for all ESA projects.
2.2.2 The Level 2 Documents
Level 2 documents offer guidance in carrying out the standard
practices described in ESA PSS-05-0. They repeat mandatory practices
stated in ESA PSS-05-0 (with cross-references) and do not define any new
mandatory practices.
The first level 2 document, ESA PSS-05-01 (this document) exists to
define and explain the document tree.
ESA PSS-05-0 divides the software engineering activity into two
parts: the products themselves and the procedures used to make them.
The process of production is partitioned into six phases:
• User Requirements Definition;
• Software Requirements Definition;
• Architectural Design;
• Detailed Design and Production;
• Transfer;
• Operations and Maintenance.
ESA PSS-05-01 Issue 1 Revision 1 (March 1995) 5
THE DOCUMENT TREE
The related level 2 documents are:
Identifier Title
ESA PSS-05-02 Guide to the User Requirements Definition Phase
ESA PSS-05-03 Guide to the Software Requirements Definition Phase
ESA PSS-05-04 Guide to the Architectural Design Phase
ESA PSS-05-05 Guide to the Detailed Design and Production Phase
ESA PSS-05-06 Guide to the Transfer Phase
ESA PSS-05-07 Guide to the Operations and Maintenance Phase
Each document contains:
• an overview of the phase;
• guidelines on methods that can be used in the phase;
• guidelines on tools that can be used in the phase;
• instructions for documentation.
The procedures to be followed in the life cycle are governed by
plans. The various types of planning envisaged are:
• project management;
• configuration management;
• verification and validation;
• quality assurance.
The related level 2 documents are:
Identifier Title
ESA PSS-05-08 Guide to Software Project Management
ESA PSS-05-09 Guide to Software Configuration Management
ESA PSS-05-10 Guide to Software Verification and Validation
ESA PSS-05-11 Guide to Software Quality Assurance
2.2.3 The Level 3 Documents
Level 3 documents exist to:
• contain optional material;
• partition material in a higher level document into more manageable
quantities.
6 ESA PSS-05-01 Issue 1 Revision 1 (March 1995)
THE DOCUMENT TREE
The level 3 documents that have been defined to date are:
Identifier Title
ESA PSS-05-05-01 Guide to Fortran coding
ESA PSS-05-05-02 Guide to Ada coding
ESA PSS-05-05-03 Guide to C coding
Level 3 documents can be made applicable. If Ada is selected as
the programming language to be used for a system, for example, the
project's management may choose to make ESA PSS-05-05-02, ‘ Guide to
Ada Coding', applicable.
ESA PSS-05-01 Issue 1 Revision 1 (March 1995) A-1
GLOSSARY
APPENDIX A
GLOSSARY
AD Architectural Design
BSSC Board for Software Standardisation and Control
DD Detailed Design and production
ESA European Space Agency
OM Operations and Maintenance
PSS Procedures, Specifications and Standards
SA Structured Analysis
SCM Software Configuration Management
SPM Software Project Management
SQA Software Quality Assurance
SR Software Requirements
SVV Software Verification and Validation
TR Transfer
UR User Requirements
