10.08.2013 Views

Code Manual for CONTAIN 2.0 - Federation of American Scientists

Code Manual for CONTAIN 2.0 - Federation of American Scientists

Code Manual for CONTAIN 2.0 - Federation of American Scientists

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

the difilculty, resolving the issue without resorting to code modification. For every apparent need<br />

that can be resolved without changing the code, there is concomitant elimination <strong>of</strong> the opportunity<br />

<strong>for</strong> all the types <strong>of</strong> error that maybe generated by a code change.<br />

D.2. 1.1 Chanpe Stimuli. The <strong>CONTAIN</strong> user community, the <strong>CONTAIN</strong> staff, and the USNRC<br />

are the principal sources <strong>of</strong> change stimuli. A planned update comes from the USNRC through the<br />

statement <strong>of</strong> work. As with any complex s<strong>of</strong>tware system, the operational baseline <strong>of</strong> <strong>CONTAIN</strong><br />

inevitably contains errors. When discovered by internal and/or external use <strong>of</strong> the code or in the<br />

testing process, errors become stimuli <strong>for</strong> change. Users also discover innovative ways to use<br />

<strong>CONTAIN</strong>. When these innovations are <strong>of</strong> broad interest, they too become change stimuli.<br />

D.2.1.2 CO NTAIN <strong>Code</strong> <strong>Manual</strong>. Quality assurance procedures concerning the release <strong>of</strong> a new<br />

<strong>Code</strong> <strong>Manual</strong> require that the manual pass through a review process that checks <strong>for</strong> consistency,<br />

accuracy, and clarity. The <strong>Code</strong> <strong>Manual</strong> is subjected to a thorough internal review in which the<br />

document goes through the SNL standard publication review process, which requires that the f~st<br />

two levels <strong>of</strong> SNL management approve the document. Prior to management review, the document<br />

is reviewed by other staff members. Any necessary changes are incorporated be<strong>for</strong>e publication <strong>of</strong><br />

the new <strong>Code</strong> <strong>Manual</strong>.<br />

Any subsequent changes are addressed by a <strong>Code</strong>/<strong>Code</strong> <strong>Manual</strong> Change Document. The changes<br />

may be due to code changes, peer review, or other stimuli. The Change Document completely<br />

describes the models and provides the appropriate user guidance. The Change Document also<br />

includes the update to <strong>CONTAIN</strong> and a discussion on the assessment <strong>of</strong> the models. The developer<br />

<strong>of</strong> the new model or revision is responsible <strong>for</strong> generating the Change Document. The draft Change<br />

Document is first reviewed by the author. Next, the document is sent to the <strong>CONTAIN</strong> staff and<br />

interested individuals <strong>for</strong> internal review. Prior to submission to the revision manager, the author<br />

is responsible <strong>for</strong> resolving the comments received from the internal review. The revision manager<br />

then reviews the document and signs <strong>of</strong>f on the cover sheet when the Change Document is judged<br />

to be satisfactory. After the completion <strong>of</strong> the internal review, the document is reviewed by the<br />

USNRC, and their recommendations are subsequently resolved by the author and the <strong>CONTAIN</strong><br />

staff.<br />

D.2.1.3 Cod e Releases. The <strong>CONTAIN</strong> code is distributed only in source code <strong>for</strong>mat. This<br />

ensures that the updates have been assembled correctly, since the work is done by the <strong>CONTAIN</strong><br />

staff. Also, it ensures that any machine-specific modifications are correctly included <strong>for</strong> a given<br />

workstation. Workstation issues are presently available <strong>for</strong> SUN, HP, DEC, and IBM machines.<br />

The Cray version is still available in source <strong>for</strong>m, but it is expected that few, if any, users will<br />

request this plat<strong>for</strong>m. As a final measure against the introduction <strong>of</strong> errors, the user is sent sample<br />

input and output <strong>for</strong> a test problem. The user can then verify that the code installation is correct and<br />

current.<br />

D.2.2 Requirements Definition<br />

The requirements definition function provides a number <strong>of</strong> mechanisms <strong>for</strong> controlling requirements<br />

specification errors. The code developer assigned to correct a known problem or add a new model<br />

Rev O D-7 6/30/97

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!