ASTM E1472

This guide provides recommendations for writers of user’manuals and other documents for computer software prepared for scientific and engineering computations in fire models and other areas of fire protection engineering. The guide provides information that can be included in terms of three types of documents.

This guide is intended to assist in the understanding, usage, transfer, conversion, and modification of computer software. If the options and instructions contained in this guide are considered when documentation is prepared, the software should be used more readily for its intended purposes.

The use of fire models currently extends beyond the fire research laboratory and into the engineering, fire service, and legal communities. Sufficient documentation of computer software for fire models is necessary to ensure that users can judge the adequacy of the scientific and technical basis for the models, select the appropriate computer operating environment, and use the software effectively within the specified limitations. Adequate documentation will help prevent the unintentional misuse of fire models.

Additional guidelines on documentation can be found in ANSI/ANS 10.3 and ANSI/IEEE 1063.

ANSI/ANS 10.2 and 10.5 provide guidelines for programming to ease the portability of the software and meet user needs.

1. Scope

1.1 This guide provides information that should be in documentation for computer software prepared for scientific and engineering computations in fire models and other areas of fire protection engineering.

1.2 The guidelines are presented in terms of three types of documentation: (1) technical document; (2) user's manual; and (3) installation, maintenance, and programming manual.

1.3 There are no numerical values stated in this standard. It is recommended that SI units be the standard in the documentation and development of fire models.

1.4 This standard does not purport to address all of the safety concerns, if any, associated with its use. It is the responsibility of the user of this standard to establish appropriate safety and health practices and determine the applicability of regulatory limitations prior to use.

1.5 This fire standard cannot be used to provide quantitative measures.

2. Referenced Documents

E1355 Guide for Evaluating the Predictive Capability of Deterministic Fire Models
E1591 Guide for Obtaining Data for Deterministic Fire Models
E176 Terminology of Fire Standards
E1895 Guide for Determining Uses and Limitations of Deterministic Fire Models
ANSI/ANS 10.2 Portability of Scientific and Engineering Software
ANSI/ANS 10.3 Documentation of Computer Software
ANSI/ANS 10.5 Accomodating User Needs in Computer Program Development
ANSI/IEEE 1063 Software User Documentation
ANSI/IEEE 610.12 Glossary of Software Engineering Terminology
ANSI/INCITS X3.172 American National Standard Dictionary for Information Systems
ANSI/INCITS X3.88 Computer Program Abstracts

Index Terms

algorithm; computer program; computer software; documentation; fire model; manual; ICS Number Code 35.080; 35.080

Citing ASTM Standards

[Back to Top]