ORTEC Software File Structure Manual

69;,*
®
ORTEC Software
File Structure Manual
for DOS and Windows® Systems
Printed in U.S.A.
ORTEC Part No. 753800
Manual Revision E
1202
$GYDQFHG 0HDVXUHPHQW 7HFKQRORJ\ ,QF
a/k/a/ ORTEC®, a subsidiary of AMETEK®, Inc.
WARRANTY
ORTEC* DISCLAIMS ALL WARRANTIES OF ANY KIND, EITHER EXPRESSED OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, NOT
EXPRESSLY SET FORTH HEREIN. IN NO EVENT WILL ORTEC BE LIABLE FOR
INDIRECT, INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES,
INCLUDING LOST PROFITS OR LOST SAVINGS, EVEN IF ORTEC HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES RESULTING FROM THE
USE OF THESE DATA.
Copyright © 2002, Advanced Measurement Technology, Inc. All rights reserved.
*ORTEC® is a registered trademark of Advanced Measurement Technology, Inc. All other trademarks used herein are the
property of their respective owners.
TABLE OF CONTENTS
1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2. MESSAGE FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.1. DOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2. Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. EMULATOR FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1. Integer Data Files (.CHN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.1. Early Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.2. New Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.1.3. Old AlphaVision Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.2. ROI Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.3. Start Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.4. Other Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4. ANALYSIS FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.1. Inform Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2. Analysis Parameters Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2.1. Germanium Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2.2. Sodium Iodide Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Analysis Parameters Extension 1 Record . . . . . . . . . . . . . . . . . . 14
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Record 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.2.3. AlphaVision Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.3. Calibration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.3.1. Calibration Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.3.2. Calibration Parameter Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.3.2.1. Germanium Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
First Certificate Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
First Total Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Second Calibration Data Record . . . . . . . . . . . . . . . . . . . . . . . . . 20
4.3.2.2. Sodium Iodide Calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.4. Detector Description Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.4.1. Detector Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.5. Old Geometry Correction Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.5.1. Geometry Correction Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.5.2. Geometry Correction Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.6. New Geometry Correction Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.7. Sample Description Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.7.1. Sample Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
iii
ORTEC Software File Structure Manual for DOS and Windows Systems
4.8. ROI File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.8.1. Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.8.2. ROI Data Record 1 and 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.9. Old Absorption Correction Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.9.1. Absorption Correction Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.9.2. Absorption Correction Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.10. New Absorption Correction Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.11. Real Format Spectrum Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.11.1. Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.11.2. Acquisition Information Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.11.3. Sample Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.11.4. Detector Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.11.5. First, Second, and Third Analysis Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.11.6. Absorption Correction Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.11.7. Absorption Correction Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.11.8. Geometry Correction Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.11.9. Geometry Correction Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.11.10. Calibration Description Record, Calibration Data Records, and Efficiency Pairs
Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.11.11. Region-of-Interest Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Record 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.11.12. Hardware Parameters Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Record 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Record 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Multi-Nuclide MDA Preset Storage . . . . . . . . . . . . . . . . . . . . . . 38
4.11.13. Personality Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.11.14. Table Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.11.15. Table Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.11.16. Spectrum Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.12. Integer Format Spectrum Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
4.12.1. Other Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.12.2. Spectrum Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.13. Net Spectrum Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.14. AlphaVision Spectrum Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
4.15. Germanium Unformatted Output Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
iv
TABLE OF CONTENTS
4.15.1. Records 1 and 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.1.1. Old UFO Records 1 and 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.1.2. New UFO Records 1 and 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.2. UFO File CSI Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Records 1 and 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Records 2 and 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.3. UFO File GEN Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.4. UFO Absorption Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.5. UFO Geometry Description Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.6. UFO File Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.6.1. Old UFO File Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.6.2. New UFO File Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.7. UFO File Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.7.1. Old UFO File Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.15.7.2. New UFO File Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.16. Sodium Iodide Unformatted Output (UFO) File Peak Records . . . . . . . . . . . . . . . . . .
4.16.1. UFO Records 1 and 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Record 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.16.2. UFO File CSI Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Records 1 and 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Records 2 and 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.16.3. UFO File GEN Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.16.4. UFO File Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.16.5. UFO File Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.17. AlphaVision Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
46
46
46
47
48
48
48
50
51
51
51
52
52
53
54
55
55
56
58
58
60
63
63
63
64
65
65
66
66
67
68
70
5. ASCII FORMAT FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.1. SPE Spectrum Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2. IEEE Spectrum Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
6. LIBRARY FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1. Library Files (Germanium) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1.1. Header Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1.2. Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
75
75
75
76
v
ORTEC Software File Structure Manual for DOS and Windows Systems
6.1.3. Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2. PBC Files (Germanium) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.1. Header Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.2. Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.3. Peak Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3. Library Files in NuclideNavigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4. Library Files in AlphaVision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4.1. Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
77
77
78
79
79
80
80
80
7. DOS SYSTEM FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1. Sequence Number File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2. Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2.1. Configuration Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3. Report File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83
83
83
84
84
8. TABLE FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.1. Header Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2. Title Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3. Nuclide Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3.1. PBC Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
85
85
85
85
86
vi
1. INTRODUCTION
This manual describes the file structure for the files used in the ORTEC MCA control software
and the analysis software. These files are used to transfer information among the programs in these
products and to store data for future use. Developers who wish to design programs to use these
files or to create files that will be used by ORTEC software must adhere to the specifications
given.
There are six types of files used:
Message files (.MSG)
Integer spectrum data files (.CHN)
Analysis files (various extensions)
Library files (.LIB)
System files (various extensions)
Table files (.TBL)
Other file types (.BAT, .EXE, .COM) are system files and defined in other manuals.
All real numbers used in these files conform to the IEEE real data type as implemented by
Microsoft® and Intel®.
The files described here, especially the spectrum files and the analysis results files, have been
expanded to include more information about the details of the spectrum collection and the analysis
options. This was done to enable customers to better maintain their file archives and to support
their QA requirements.
Programs written for the DOS operating system are no longer supported because they do not pass
the Y2K tests. References to DOS in this manual are for the convenience of those using old
programs and does not imply support.
1
ORTEC Software File Structure Manual for DOS and Windows Systems
2
2. MESSAGE FILES
2.1. DOS
The message files contain the operator prompts, keyword replies, and error messages for the
programs. There is no internal file header. They are created as 64-byte fixed-length direct access
records (i.e., there are no interrecord delimiters). Program MSGCOM is used to compile the
random length sequential access records (i.e., there are interrecord delimiters), as from a text
editor, into this format. The extension is .MSG.
2.2. Windows
The message (.TXT) and initialization files (.INI) contain the operator prompts, keyword replies,
startup conditions, and error messages for the programs. There is no internal file header. They are
created as random length, sequential access records (i.e., there are interrecord delimiters). They
are read by the program as text files and require no processing.
3
ORTEC Software File Structure Manual for DOS and Windows Systems
4
3. EMULATOR FILES
3.1. Integer Data Files (.CHN)
.CHN files can be produced by the pulse-height analysis (PHA) programs (A63-BI, A64-BI,
A65-BI, and A65-B32), Transfer Program (A48-BI), Applications Manager (A18-BI), analysis
programs (A30-BI, A34-BI, A66-BI, and A66-B32) and others.
The .CHN integer data files contain the channel-by-channel contents of the MCB. The header is
32-bytes long and contains the following:
Byte
Offset
0
2
4
6
8
12
16
Byte
Length
2
2
2
2
4
4
8
24
4
28
30
2
2
Use
Must be 1
MCA number or Detector number
Segment number (set to 1 in UMCBI)
ASCII seconds of start time
Real Time (increments of 20 ms) (4-byte integer)
Live Time (increments of 20 ms) (4-byte integer)
Start date as ASCII DDMMMYY* or binary zeros, if not known. The *
character should be ignored if it is not a "1". If it is a "1", it indicates the
data is after the year 2000.
Start time as ASCII HHMM or binary zeros, if not known (see Byte 6
above)
Channel offset of data
Number of channels (length of data)
The next part of the file contains the spectrum stored as 4-byte integers. There are no record
separators in the file. The number of spectrum records is determined by the number of channels in
the spectrum.
3.1.1. Early Versions
The last part of the spectrum file contains additional descriptive information about the spectrum, as
follows (the byte offsets are relative to the end of the spectrum) for all DOS versions, for
GammaVision® V2 and below, MAESTRO® for Windows V3 and below:
Byte
Offset
0
2
4
Byte
Length
2
2
4
Use
Must be 101
Reserved
Energy calibration zero intercept, 0.0 for uncalibrated spectrum (4-byte
real)
5
ORTEC Software File Structure Manual for DOS and Windows Systems
8
12
16
4
4
4
20
24
256
257
320
321
384
4
232
1
63
1
63
128
Energy calibration slope, 1.0 for uncalibrated spectrum (4-byte real)
Reserved
Peak shape calibration zero intercept, 1.0 for uncalibrated spectrum
(4-byte real)
Peak shape calibration slope, 0.0 for uncalibrated spectrum (4-byte real)
Reserved
Length of detector description
Detector description
Length of sample description
Sample description
Reserved (The total length is 512 bytes)
This file is also created by STORE (A18-BI) and XFER (A48-BI).
3.1.2. New Versions
The last part of the spectrum file contains additional descriptive information about the spectrum, as
follows (the byte offsets are relative to the end of the spectrum) for GammaVision V2.2 and later,
MAESTRO V3.1 and later, MicroMCB and all versions of programs for Windows 95/98/NT:
Byte
Offset
0
2
4
6
Byte
Length
2
2
4
8
12
4
4
16
4
20
24
4
4
28
256
257
320
321
384
228
1
63
1
63
128
Use
Must be 102
Reserved
Energy calibration zero intercept, 0.0 for uncalibrated spectrum (4-byte
real)
Energy calibration slope, 1.0 for uncalibrated spectrum (4-byte real)
Energy calibration quadratic term, 0.0 for uncalibrated spectrum (4-byte
real)
Peak shape calibration zero intercept, 1.0 for uncalibrated spectrum
(4-byte real)
Peak shape calibration slope, 0.0 for uncalibrated spectrum (4-byte real)
Peak shape calibration quadratic term, 0.0 for uncalibrated spectrum
(4-byte real)
Reserved
Length of detector description
Detector description
Length of sample description
Sample description
Reserved (The total length is 512 bytes)
3. EMULATOR FILES
3.1.3. Old AlphaVision Version
The old (A36-BI) versions of AlphaVision used the following .CHN files. This file type is not used
in the new (A36-B32) versions. See Section 4.14 for the new AlphaVision spectrum files.
Byte
Offset
0
2
4
Byte
Length
2
2
4
8
12
4
4
16
4
20
24
4
4
28
256
257
320
321
384
388
420
430
440
444
448
450
454
458
462
466
470
474
478
482
228
1
63
1
63
4
32
10
10
4
4
4
2
4
4
4
4
4
4
4
30
Use
Must be 102
Reserved
Energy calibration zero intercept, 0.0 for uncalibrated spectrum (4-byte
real)
Energy calibration slope, 1.0 for uncalibrated spectrum (4-byte real)
Energy calibration quadratic term, 0.0 for uncalibrated spectrum (4-byte
real)
Peak shape calibration zero intercept, 1.0 for uncalibrated spectrum
(4-byte real)
Peak shape calibration slope, 0.0 for uncalibrated spectrum (4-byte real)
Peak shape calibration quadratic term, 0.0 for uncalibrated spectrum
(4-byte real)
Reserved
Length of detector description
Detector description
Length of sample description
Sample description
AlphaVision ID must be 0x53495641
Sample type name
ASCII collection date
ASCII collection time
Total volume of sample
Aliquot volume of sample
Tracer amount (DPM)
Volume units
Detector efficiency
Old calibration intercept
Old calibration slope
Old calibration shape
Old calibration efficiency
Old background counts
Old background CPM
Group Name
7
ORTEC Software File Structure Manual for DOS and Windows Systems
3.2. ROI Files
This file is created by SAVE ROI and contains a list of the start and stop channels for the ROIs in
the display. The file contents are as follows:
Byte
Offset
0
2
4
.
.
.
n
Byte
Length
2
2
2
.
.
.
2
Use
Must be 2
Start channel number of first ROI
Stop channel number of first ROI
.
.
.
Continue for all ROIs in the display
Start channel = 1 is end of data
3.3. Start Files
This file is written by the DOS Emulator (A63-BI) to store the start time and date of the
MCB/Segment data. It is used by Emulator when storing the data on disk. There is no header
block. This file is not used in any Windows program. The contents are:
Byte
Offset
0
2
16
24
28
Type
I*2
C*8
C*8
Use
File type = 4
Unused
Start date as MMM-DD-YY
Start time as HH:MM:SS
Unused
This file is put in the default directory.
3.4. Other Files
The file PRECAL.MCB is used for internal data transfer in the DOS Emulator. The contents are
reserved.
8
4. ANALYSIS FILES
4.1. Inform Structure
The analysis files are written in a defined format called the inform structure. This is a format that
allows great flexibility in the use and contents of the file. The header record contains the definition
of the contents and their position(s) in the file. As all of the inform files are dynamically allocated,
the first record must be carefully used, and must be modified if the file is modified. If the particular
record type doesn't exist in the file, the pointer is zero or negative. The recommended (or default)
extension is given in the following. The file extension does not, however, override the file-type bits
set in the file. All inform files have a record length of 128 bytes with no interrecord delimiter.
Significant changes have been made for analysis software files for Windows 95/98/NT.
4.2. Analysis Parameters Files
An analysis parameters file is created by GERPAR (B30) or MINPAR (A34) and contains the
analysis parameters used in the analysis. The file extension is .PRM. The first record in this file
contains the pointers to the four analysis parameters records (Words 9 through 12).
Word
Number
1
2
3–8
9
10
11
12
13–27
28
29
30–69
Use
Must be 1
Must be 32
Reserved
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Hardware parameters record pointer
Reserved
Maximum record number ever used
Maximum record number in use
Reserved
4.2.1. Germanium Parameters
The first two records are used for germanium analysis (A34 and B30). The files are not produced
by GammaVision but the analysis parameters records in the spectrum and other files are in this
format. The first germanium record contains the following data:
9
ORTEC Software File Structure Manual for DOS and Windows Systems
Word
Number
1
Local
Name
GELI
Type
I*2
2
3
4
5
6
7
8
FCHAN
LCHAN
SIGMA
UNPEKS
ENGCAL
DECDUR
FORM
I*2
I*2
I*2
I*2
I*2
L*2
I*2
9
GAMMA3
L*2
I*2
10
11
12
13
14
15
17
18
19
20
10
MPCON
PBCOR
RNDSUM
DECAY
GEOM
FACCOR
EFCALB
MDATYP
LIBNOT
LSTISO
L*2
L*2
L*2
L*2
L*2
R*4
L*2
I*2
L*2
L*2
Use
Bit 0 must be 1 for germanium. Bit 14 = 1 for
extended analysis records.
Start channel for analysis
Stop channel for analysis
Standard deviation for uncertainty (1, 2, or 3)
Maximum number of unused peaks allowed
True if spectrum is energy-calibrated
Decay during acquisition flag
1 = Count as %, 2 = Count as activity,
3 = Count and total as %, 4 = Count and total
as activity
(Old) True to enable peak interference
correction (Gamma 3)
(New) Analysis flag controls as follows (true if
bit set to 1)
Description
Bit
Bit 0
Enable library peak stripping
Bit 1
Enable average energy calculation
Bit 2
Enable iodine equivalence
Bit 3
Write ASCII report
Bit 4
Report RPG
Bit 5
Run at high priority
Bit 6
Directed fit flag
Bit 7
Use GV Report Writer
Bit 8
Manual peak stripping
Bit 9
Use collection dates
Bit 10
Enable TCC analysis
Bit 11
Display analysis results
Bit 12–16 Reserved
Maximum permissible concentration on/off
Peaked background correction on/off
Random summing on/off
Decay correction on/off
Geometry correction on/off
Reserved
True if spectrum is efficiency-calibrated
MDA type, 1 to 20 (see B30 manual)
True if analysis library found
True if isotopic abundance output requested
4. ANALYSIS FILES
21
FIVE
I*2
22
24
25
26
27
SENS
RECFCT
DETIDN
MATISO
MATCHN
R*4
R*4
I*2
L*2
I*2
28
30
32
RSFCT
SORFCT
DAYS
R*4
R*4
R*8
36
38
40
42
44
46
48
55
SAMWGH
UFCTN
UFCTD
IRRAD
PKRPRO
GERPRO
UNITS
CORDAT
R*4
R*4
R*4
R*4
R*4
R*4
C*1
C*1
60
64
CORTIM
SORP
C*1
L*2
1 = Automatic background, 2 = five-point
background width only, 3 = 3-point
background, 4 = minimum point
Sensitivity
Reserved
Detector identification number
True if isotopic/peak output requested
Output print control, true if bit set to 1.
Description
Bit
Bit 0
Print library peak list
Bit 1
Print unknown peak list
Bit 2–16 Reserved
Random summing factor
Absorption factor
Decay correction date in DECDAY format.
Days since 1Jan79. The example time date,
2Jan79 12:00:00, is 1.5
Sample weight
Units factor numerator
Units factor denominator
Reserved
Additional random error
Additional systematic error
Units name in ASCII (14 characters)
Date in ASCII (DD-MMM-YY*)
(10 characters)
Time in ASCII (HH:MM:SS) (8 characters)
Absorption correction flag
The DECDAY format is defined to be a double precision real number that represents the number
of days since 1-JAN-79. For dates before this date the number is negative.
The extended analysis record follows the above and contains:
Word
Number
1–2
3–4
5
6–7
8–9
Use
Fraction Limit test in percent
Unknown peak cutoff (REN-B32-G)
Divide activity by weight
Half-lives decay limit
Activity range factor
11
ORTEC Software File Structure Manual for DOS and Windows Systems
10–11
12
13–16
17–32
33–48
49–64
Minimum step background energy
Second MDA type
Analysis version
Reserved
Second library for manual peak strip
Third library for manual peak strip
The second germanium record contains the library names used in the analysis.
Word
Number
1
17
33
49
Local
Name
LIB1
LIB2
LIB3
PBCFIL
Type
C*32
C*32
C*32
C*32
Use
First nuclide library filename
Attenuation filename
Geometry correction filename
Peaked background correction filename
If long filenames are enabled, then the following 8 sequential records are defined as follows:
1+2
3+4
5+6
7+8
256 characters for LIB1
256 characters for Attenuation filename
256 characters for Geometry filename
256 characters for PBC filename
The third germanium record contains more filenames used in the analysis.
Word
Number
1
17
33
49
Local
Name
RPGPROG
RPTOUT
SUSLIB
ANLPROG
Type
C*32
C*32
C*32
C*32
Use
MPCFIL
Report filename
Suspected nuclide file
Analysis executable name
If long filenames are enabled, then the following 8 sequential records are defined as follows:
1+2
3+4
5+6
7+8
12
MPCFIL filename
Report filename
Suspected nuclide file
Analysis executable name
4. ANALYSIS FILES
4.2.2. Sodium Iodide Parameters
Analysis parameters record structure:
Word
Number
1
Local
Name
GELI
2
3
4
5
6
7
8
FCHAN
LCHAN
SIGMA
UNPEKS
ENGCAL
DECDUR
FORM
9
GAMMA3
10
11
12
13–14
15–16
MPCON
PBCOR
RNDSUM
DECAY
FACCOR
17
18
19
EFFCALB
MDATYP
LIBNOT
Type
Low byte must be 2; if bit 14 is 1, the extended analysis
record is included
Start channel for analysis
Last channel
Standard deviation for uncertainty (1, 2, or 3)
Maximum number of unused peaks allowed
Spectrum is energy calibrated?
Decay during acquisition?
(1 = Count as %, 2 = Count as activity, 3 = Count and
total %, 4 = Count and total activity)
Bit Description if = 1
0 Enable library peak stripping
1 Enable average energy calc
2 Enable iodine equivalence
3 Save report as file
4 Report RPG
5 Run at high priority
6 Directed fit flag
7 Use the GammaVision Report Writer
8 Fix the linear background fit
9 Report to printer
10 Report MDA (RENAISSANCE)
11 Report individual detectors (RENAISSANCE-32)
Maximum permissible concentration
Peaked background correction
Random summing correction
Calculation of ICRFAC
(Usually 0.5) acceptance width for identification of peak to
library
Spectrum is efficiency calibrated
MDA type
Analysis library found?
13
ORTEC Software File Structure Manual for DOS and Windows Systems
20
21
22–23
24–25
26
27
28–29
28–29
30–31
32–35
LSTISO
FIVE:
SENS
MATISO
MATCHN
RSFCT
SORFCT
DAYS
36
38
40
42–43
44–45
46–47
48–54
55–59
SAMWGH
UFCTN
UFCTD
60–63
CORTIM
64
UNITS
CORDAT
SORP
Isotopic abundance listing requested
Background type
Peak error cut off
Peak cutoff
Isotopic/peak output requested?
Energy/peak output requested
Linear background energy
Random summing factor
Absorption factor
DECDAY format of decay correction date
CORDAT,CORTIM
Sample weight or volume
Units factor numerator
Units factor denominator
Sample collection time
Fraction limit
Decay limit
Units name
Decay correction date (DD-MMM-YY*) (sample
collection date)
Decay correction time (HH:MM:SS) (sample collection
time)
Absorption correction
Analysis Parameters Extension 1 Record
This record follows next if bit 14, word 1 above is set to 1.
Word
Number
1
2
3–4
5
5–64
14
Use
1 = use peak cutoff, 0 = critical level cutoff
Directed fit flag
Fraction limit test in percent
Divide activity by weight (REN-B32 only)
Reserved
4. ANALYSIS FILES
Record 2
The second sodium iodide record contains the library names used in the analysis.
Word
Number
1
17
33
49
Local
Name
LIB1
LIB2
LIB3
PBCFIL
Type
C*32
C*32
C*32
C*32
Use
First nuclide library filename
Attenuation filename
Geometry correction filename
Peaked background correction filename
If long filenames are enabled, then the following 8 sequential records are defined as follows:
1+2
3+4
5+6
7+8
256 characters for LIB1
256 characters for attenuation filename
256 characters for geometry filename
256 characters for PBC filename
Record 3
The third sodium iodide record contains more filenames used in the analysis.
Word
Number
1
17
33
49
Local
Name
RPGPROG
RPTOUT
SUSLIB
ANLPROG
Type
C*32
C*32
C*32
C*32
Use
MPCFIL
Report filename
Suspected nuclide file
Analysis executable name
If long filenames are enabled, then the following 8 sequential records are defined as follows:
1+2
3+4
5+6
7+8
MPCFIL filename
Report filename
Suspected nuclide file
Analysis executable name
15
ORTEC Software File Structure Manual for DOS and Windows Systems
4.2.3. AlphaVision Parameters
AlphaVision analysis record 1.
Word
Number
0
1
2
18
23
27
29
31
33
34
36
38
40
42
44
46
48
54–255
256
258
260
262
264
266
268
270
272–329
330
331–362
363
364–385
386–511
Use
must be 4
AlphaVision ID, must be Ox53495641
Sample type name
ASCII collection date
ASCII collection time
Total Volume of sample
Aliquot Volume of sample
Tracer amount (DPM)
Tracer units
Detector Efficiency
Old calibration intercep
Old calibration slope
Old calibration shape
Old calibration efficiency
Old background counts
Old background CPM
Group name
Reserved
Calibration intercept
Calibration slope (1.0 = none)
Calibration shape (5.93)
Peak shape intercept (1.0 = none)
Peak shape slope (0.0 = none)
Peak shape
Calibration units
Efficiency
Reserved
Detector description length
Detector description
Sample description length
Sample description
Reserved
Analysis records 2 and 3 are not used in AlphaVision.
16
4. ANALYSIS FILES
4.3. Calibration Files
A calibration file is created by the calibration program and contains the calibration information
used in the analysis programs. The filename extension should be .CLB. This file contains the
calibration description (if any), the calibration parameter records, and the efficiency pairs records
(if any). The calibration file contents are:
Word
Number
1
2
3
16
17
18
19
20
21
22
23
24–27
28
29
30
31–64
Use
Must be 1
Must be 256
Contents flag
Bit 0 = 1 for long filename
Bit 1 = 1 for ZDT spectrum and ROI in file.
Reserved
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Reserved
Energy pairs record pointer (first record)
Number of energy pairs records (first record)
Reserved
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (See Word 20)
Reserved
4.3.1. Calibration Description Record
The calibration description record contains the user-supplied description of the calibration
parameters. The record is divided into two 64-character lines of ASCII text. The first 64
characters are used for the energy calibration and the second 64 characters for the efficiency
calibration.
4.3.2. Calibration Parameter Records
The first calibration data record contains the various coefficients produced by the calibration
program, as described below. Note that the FWHM coefficients (FC(i)) produce the FWHM in
channels, while the programs usually display the FWHM in energy units.
17
ORTEC Software File Structure Manual for DOS and Windows Systems
4.3.2.1. Germanium Calibration
Word
Number
1
2
3
4
5
7
9
11
13
15
17
19
21
23
18
Local
Name
AFIT
BFIT
EFFPRS
NCH
KNEE
ASIG
BSIG
EC(1)
EC(2)
EC(3)
FC(1)
FC(2)
FC(3)
PE(1)
Type
I*2
I*2
I*2
I*2
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
25
PE(2)
R*4
27
PE(3)
R*4
29
SE(1)
R*4
31
SE(2)
R*4
33
SE(3)
R*4
35
36
37
38
39
40
41
43
45
47
49
51
53
FWHTYP
PETYPE
I*2
ENGPRS
DETNUM
NBKNEE
ENA2
ENB2
ENC2
CALUNC
CALDIF
R(7)
R(8)
I*2
I*2
I*2
R*4
R*4
R*4
R*4
R*4
R*4
R*4
Use
Above knee efficiency calibration fit type
Below knee efficiency calibration fit type
Number of efficiency pairs
Number of channels in spectrum
Detector knee (keV)
2-sigma uncertainty above knee
2-sigma uncertainty below knee
Energy vs. channel coefficient A
Energy vs. channel coefficient B
Energy vs. channel coefficient C
FWHM vs. channel coefficient A
FWHM vs. channel coefficient B
FWHM vs. channel coefficient C
Above knee efficiency vs. energy coefficient A
or polynomial coefficient (1)
Above knee efficiency vs. energy coefficient B
or polynomial coefficient (2)
Above knee efficiency vs. energy coefficient C
or polynomial coefficient (3)
Below knee efficiency vs. energy coefficient A
or polynomial coefficient (4)
Below knee efficiency vs. energy coefficient B
or polynomial coefficient (5)
Below knee efficiency vs. energy coefficient C
or polynomial coefficient (6)
FWHM type
True for p-type
MAESTRO peak-search sensitivity
Number of energy pairs
Detector number
Number of calibration points below knee
Temp energy calibration
Temp energy calibration
Temp energy calibration
Calibration source uncertainty
Energy calibration difference
Polynomial coefficient 7
Polynomial coefficient 8
4. ANALYSIS FILES
55
57
59–60
61–62
63
64
R(9)
R(10)
R*4
R*4
STYPEFLAG
I*2
Polynomial coefficient 9
Polynomial coefficient 10
Low channel FWHM error
High channel FWHM error
Low channel limit for calibrating
True = next record has TCC data
This record contains the TCC calibration information and the standard efficiency certificate data
Word
Number
1–2
3
4
5–6
7–8
9–10
11–12
13–16
17–20
21–24
25–28
29–32
33–34
35–36
37–38
39–40
41
42
43–47
48–51
52–64
Use
Number of TCC calibration records including this one
First certificate record pointer
First total record pointer
Reserved
Number of certificate energies
Number peak-to-total pairs
Reserved
Peak-to-total fit intercept
Peak-to-total fit slope
LTS efficiency intercept
LTS efficiency slope
LTS efficiency quadratic
Live-time preset for energy calibration
Live-time preset for efficiency calibration
Live-time preset for background
Calibration SPC live time
Absorber flag:
0 = without absorber
1 = with absorber
TCC calibration method
0 = multiple point source
1 = single point source
2 = single extended source
TCC calibration date
TCC calibration time
Unused
19
ORTEC Software File Structure Manual for DOS and Windows Systems
First Certificate Record
Word
Number
1–4
5–8
9–12
13–16
17–20
21–24
25–28
29–33
34–37
38
39–40
41–64
Use
Isotope name
Isotope half-life in days
Peak energy
Branching ratio (%)
Measured value
Fitted value
Error in fit
Certificate date
Certificate time
Activity units
Live time for peak-to-total analysis
Unused
First Total Record
The total record contains the peak-to-total ratio for the isotope and energy given. There are two
entries per record. The record is repeated for as many times as needed for the complete list.
Word
Number
1– 4
5–8
9–12
13–16
17–20
21–22
23–32
33–36
37–40
41–44
45–48
49–52
53–54
55–64
20
Use
Words 1–32 are for the first isotope in record
Isotope name (ASCII)
Peak energy
Fitted value
Peak-to-total ratio
Difference between the fit and ratio
Live time
Unused
Words 33–64 are for the second isotope in record
Isotope name (ASCII)
Peak energy
Fitted value
Peak-to-total ratio
Difference between the fit and ratio
Live time
Unused
4. ANALYSIS FILES
Second Calibration Data Record
Word
Number
1
Local
Name
CALSPC
Type
C*1
17
CREDAT
C*1
22
CRETIM
C*1
26–32
33
EFFDAT
C*1
38
EFFTIM
C*1
42–64
Use
Filename in ASCII original calibration file (32
characters)
ASCII date calibration file was created
(10 characters). The last character should be
ignored if it is not a "1". If it is a "1", it
indicates the data is after the year 2000.
ASCII time calibration file was created
(8 characters)
Reserved
ASCII date when spectrum for efficiency
calibration was collected (10 characters)
ASCII time efficiency calibration file was
created (8 characters)
Unused
If long filenames are enabled, then the following 2 sequential records are defined as follows:
1+2
Filename in ASCII original calibration file
The energy channel pairs are stored as three records for peak centroid, three records for peak
energy, and three records for peak FWHM. The three records each contain 32 four-byte real
numbers for a total of 96 data points. The three sets of numbers are arranged in ascending energy
order. The records are stored sequentially beginning with the record number in Word 22 of the
first record. They are in the following order:
Word-22
+0
+1
+2
+3
+4
+5
+6
+7
+8
Contents
Centroid values from 1 to 32
Energy values from 1 to 32
FWHM values from 1 to 32
Centroid values from 33 to 64
Energy values from 33 to 64
FWHM values from 33 to 64
Centroid values from 65 to 96
Energy values from 65 to 96
FWHM values from 65 to 96
21
ORTEC Software File Structure Manual for DOS and Windows Systems
The following is a description of an efficiency pairs record(s). The first such record is pointed to
by Word 20 of the first record; the remaining records (if any) are positioned sequentially for the
number of records in Word 30 of the first record.
Word
Number
1
3
5
.
.
.
61
63
Local
Name
EFF(1,1)
EFF(2,1)
EFF(1,2)
.
.
.
.
.
.
EFF(1,16)
EFF(2,16)
Type
R*4
R*4
R*4
.
.
.
R*4
R*4
Use
Energy of first energy-efficiency pair in keV
Efficiency of first energy-efficiency pair
Energy of second energy-efficiency pair in keV
Energy of 16th energy-efficiency pair in keV
Efficiency of 16th energy-efficiency pair
4.3.2.2. Sodium Iodide Calibration
Record 1 (only valid if first analysis record, word 1 is 2 in the low byte)
Byte
Number
1
Type
AFIT
2
3
4
5–6
7–8
9–10
11–16
17–22
23–30
31
32–33
RE(1–4)
ENGPRS
CALUNC
Byte
Number
1–128
129–135
136–140
Type
CALSPC
CREDAT
CRETIM
22
DETNUM
EFFPRS
NCH
ASIG
Use
Above-knee efficiency calibration fit type (0 = None;
1 = Interp; 2 = Linear; 3 = Quad; 4 = Cubic)
Detector number
# of efficiency pairs for interpolation
No. of channels in spectrum
Error in fit above knee (2-sigma uncertainty)
Error in FWHM at bottom channel
Error in FWHM at top channel
Energy calibration (offset, linear, quadratic parameters)
FWHM calibration (offset, linear, quadratic parameters)
Cubic efficiency fit
Number of energy triples
Calibration source uncertainty Record 2 (only valid if first
analysis record, word 1 is 2 in the low byte)
Use
Filename in ASCII for original calibration file
ASCII calibration creation date
ASCII calibration creation time
4. ANALYSIS FILES
141–146
EFFDAT
147–151
EFFTIM
152–184
184–216
217–512
ASCII date when spectrum for efficiency calibration was
collected
ASCII time when spectrum for efficiency calibration was
collected
Description line 1
Description line 2
Reserved
4.4. Detector Description Files
A detector description file is created by the Detector program (A18) and contains the detector
description input by the operator. The file extension should be .DET. These are not used in
Windows programs. The contents of the file are:
Record 1
Word
Number
1
2
3–6
7
8–27
28
29
30–50
51
52–64
Use
Must be 1
Must be 16
Reserved
Detector description record pointer
Unused
Maximum record number ever used
Maximum record number in use
Reserved
Detector identification number
Reserved
4.4.1. Detector Description Record
The detector description record contains the user-supplied description of the detector used to
acquire the spectrum. The record is divided into two 64-character lines of text.
4.5. Old Geometry Correction Files
A geometry correction file is created by the program GEO (A30) and contains the correction
information used in the analysis program (A30). The contents are:
23
ORTEC Software File Structure Manual for DOS and Windows Systems
Record 1
Word
Number
1
2
3–14
15
16
17–27
28
29
30–64
Use
Must be 1
Must be 128
Reserved
Geometry correction description record pointer
Geometry correction data record pointer
Reserved
Maximum record number ever used
Maximum record number in use
Reserved
4.5.1. Geometry Correction Data Record
The geometry correction data record contains the data required to perform geometry correction.
The record is as follows:
Word
Number
1
3
.
.
.
31
33
35
.
.
.
63
Local
Name
GEKEV(1)
GEKEV(2)
.
.
.
.
.
.
GEKEV(16)
GEVAL(1)
GEVAL(2)
.
.
.
.
.
.
GEVAL(16)
Type
R*4
R*4
.
.
.
R*4
R*4
R*4
.
.
.
R*4
Use
Energy of the first datum in keV
Energy of the second datum in keV
Energy of the 16th datum in keV
Correction value for the first datum
Correction value for the second datum
Correction value for the 16th datum
4.5.2. Geometry Correction Description Record
The geometry correction description record contains information about the data on the geometry
correction data record. Note that this record differs from the geometry record in the .UFO file
(Section 4.15.5). The record is as follows:
24
4. ANALYSIS FILES
Word
Number
1
2
3
4
Local
Name
NPAIRS
DTYPE
GDETID
DATE1
Type
I*2
I*2
I*2
C*1
9
TIME1
C*1
13
FILESP
C*1
29
49–64
IDENT
C*1
Use
Number of data pairs on data record
1 indicates geometry correction
Detector identification number
Date geometry file was created
(DD-MMM-YY*) (10 characters). The *
character should be ignored if it is not a "1". If
it is a "1", it indicates the data is after the year
2000.
Time geometry file was created (HH:MM:SS)
(8 characters)
Original geometry filename in ASCII
(32 characters)
Detector description in ASCII (32 characters)
Reserved
4.6. New Geometry Correction Files
The new geometry correction master file is written by GammaVision and contains the energy,
Area1, Area2, ratio values, reference file, current file, and Detector ID. It has a file extension of
.GEO. This file contains the following format, which is the same as the .SOR file format:
Line 1:
Line 1:
Lines 2–n:
blank line
Length:
blank line
Reference File:
Current File:
blank line
Detector ID:
date and time
header
Energy, Area1, Area2, Ratio values
(absorption only)
(absorption only)
(geometry only)
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
Reference UFO
Current UFO
25
ORTEC Software File Structure Manual for DOS and Windows Systems
4.7. Sample Description Files
A sample description file is written by the program SAMPLE (A18) and contains the sample
description entered by the operator. It has a file extension of .SMP. This file is not used in
GammaVision. This file contains the following:
Record 1
Word
Number
1
2
3–5
6
7–27
28
29
30–64
Use
Must be 1
Must be 8
Reserved
Sample description record pointer
Reserved
Maximum record number ever used
Maximum record number in use
Reserved
4.7.1. Sample Description Record
This record is 128 ASCII characters split into two 64-character lines exactly as input by the
operator. Unused characters are set ASCII spaces.
4.8. ROI File
The ROI (region-of-interest) file is created by the program ROIDEFIN (A18) and contains the
definition of the regions of interest entered by the operator. The file contents are as follows:
4.8.1. Record 1
Word
Number
1
2
3–20
21
22–27
28
29
30–64
26
Use
Must be 1
Must be 2048
Reserved
Record number of the first of the two ROI records
Reserved
Maximum record number ever used
Maximum record number in use
Reserved
4. ANALYSIS FILES
4.8.2. ROI Data Record 1 and 2
There are two ROI data records, each record containing 64 short integer (2 byte) values. The first
record contains the starting channel number for up to 64 ROIs. The second record, which always
follows ROI Record 1, contains the number of channels for each of up to 64 ROIs. Undefined
ROIs will have 1 as start channel number. Entries in Record 2 for undefined ROIs are undefined,
but should be written as 1. The records are formatted as follows:
ROI Record 1
Word
Number
1
2
3
.
.
.
64
Type
I*2
I*2
I*2
.
.
.
I*2
Use
Start channel number for ROI 1
Start channel number for ROI 2
Start channel number for ROI 3
.
.
.
Start channel number for ROI 64ROI Record 2
Word
Number
1
2
3
.
.
.
64
Type
I*2
I*2
I*2
.
.
.
I*2
Use
Number of channels in ROI 1
Number of channels in ROI 2
Number of channels in ROI 3
.
.
.
Number of channels in ROI 64
4.9. Old Absorption Correction Files
The absorption correction file is written by the SOR program (A30) and contains the correction
information used by the analysis programs. The contents of the file are as follows:
Word
Number Use
1
Must be 1
3
Must be 64
3–12
Reserved
13
Absorption correction description record pointer
14
Absorption correction data record pointer
27
ORTEC Software File Structure Manual for DOS and Windows Systems
15–27
28
29
30–64
Reserved
Maximum record number ever used
Maximum record number in use
Reserved
4.9.1. Absorption Correction Data Record
The absorption correction data record contains the data required to perform absorption correction.
The record is formatted as follows:
Word
Number
1
3
.
.
.
31
33
35
.
.
.
63
Local
Name
SRKEV(1)
SRKEV(2)
.
.
.
.
.
.
SRKEV(16)
SRVAL(1)
SRVAL(2)
.
.
.
.
.
.
SRVAL(16)
Type
R*4
R*4
.
.
.
R*4
R*4
R*4
.
.
.
R*4
Use
Energy of the first datum in keV
Energy of the second datum in keV
Energy of the 16th datum in keV
Correction value for the first datum
Correction value for the second datum
Correction value for the 16th datum
4.9.2. Absorption Correction Description Record
The absorption correction description record, indexed by Word 13 of the first record, contains
information about the data contained on the absorption correction data record. See also the UFO
Absorption record (Section 4.15.4). The record is formatted as follows:
Word
Number
1
2
3
4
28
Local
Name
NPAIRS
DTYPE
DATE1
Type
I*2
I*2
C*2
C*10
Use
Number of data pairs in data record
2 = internal, 4 = external
Reserved
Date absorption file was created
(DD-Mmm-YY); (stored as 10 ASCII
characters). The * character should be ignored
if it is not a "1". If it is a "1", it indicates the
data is after the year 2000.
4. ANALYSIS FILES
9
14
16
32
33
TIME1
C*1
FILESP
C*2
C*1
IDENT
C*2
C*1
49–64
Time absorption file was created
(HH:MM:SS); (stored as 8 ASCII characters)
Reserved
Original absorption (stored as 32 ASCII
characters)
Reserved
Unit of measure as 30 ASCII characters (e.g.,
grams)
Reserved
4.10. New Absorption Correction Files
The new absorption correction master file is written by GammaVision and contains the energy,
area1, area2, ratio values, length, reference file, current file, and Detector ID. It has a file
extension of .SOR. This file contains the following format, which is the same as the .GEO file
format:
Line 1:
Line 1:
Lines 2–n:
blank line
Length:
blank line
Reference File:
Current File:
blank line
Detector ID:
date and time
header
Energy, Area1, Area2, Ratio values
(absorption only)
(absorption only)
(geometry only)
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
Reference UFO
Current UFO
4.11. Real Format Spectrum Files
A real format spectrum file is created by the program CONVERT (A18) and the file extension
should be .SPC. This file contains a spectrum and the associated information required to analyze
the spectrum. The associated information is obtained from other files related to the MCA and
segment that acquired the spectrum and are merged by CONVERT.
29
ORTEC Software File Structure Manual for DOS and Windows Systems
The contents of the real format spectrum files are:
4.11.1. Record 1
Word
Number
1
2
3
30
Local
Name
INFTYP
FILTYP
Type
I*2
I*2
4
5
6
7
8
9
10
11
12
13
ACQIRP
SAMDRP
DETDRP
EBRDESC
ANARP1
ANARP2
ANARP3
ANARP4
SRPDES
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
14
15
16
17
18
19
20
21
IEQDESC
GEODES
MPCDESC
CALDES
CALRP1
CALRP2
EFFPRP
ROIRP1
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
22
23
24
25
26
27
28
29
30
PERPTR
MAXRCS
LSTREC
EFFPNM
I*2
I*2
I*2
I*2
Use
Must be 1
Must be 5
Contents flag
Bit 0 = 1 for long filename
Bit 1 = 1 for ZDT spectrum and ROI in file
Reserved
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
EBR description record pointer
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameters record pointer
Absorption correction description record
pointer
IEQ description record pointer
Geometry correction description record pointer
MPC description record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the two ROI
records
Energy pairs record pointer
Number of energy pair records
Reserved
Disable deconvolution of unknown peaks
True = microcuries, false = becquerels
Laboratory and operator name record pointer
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (See
Word 20)
4. ANALYSIS FILES
31
SPCTRP
I*2
32
33
34
35
SPCRCN
SPCCHN
ABSTCH
ACQTIM
I*2
I*2
I*2
R*4
37
41
42
ACQTI8
SEQNUM
MCANU
R*8
I*2
I*2
43
SEGNUM
I*2
44
45
46
48
50
51
53
54
55–62
63–64
MCADVT
CHNSRT
RLTMDT
LVTMDT
I*2
I*2
R*4
R*4
I*2
I*2
I*2
I*2
RRSFCT
R*4
Spectrum record pointer (pointer to first
record)
Number of records in the spectrum
Number of channels in spectrum
Physical start channel for data
Date and time of acquisition start in DECDAY
format
Date and time as double precision DECDAY
Sequence number
MCA number as two ASCII characters (old) or
Detector number as integer for systems with
Connections
Segment number as two ASCII characters (old)
or as integer value 1 for systems with
Connections
MCA device type
Start channel number
Real Time in seconds
Live Time in seconds
Pointer to MGA or U235 or CZTU records
Pointer to FRAM records
Pointer to TRIFID records
Pointer to NaI records
Reserved
Total random summing factor
4.11.2. Acquisition Information Record
The acquisition information record contains character data that is written by CONVERT from
information in the .CHN file.
Byte
Number
1
17
29
39
49
59–90
Type
C*1
C*1
C*1
C*1
C*1
Use
Default spectrum file name (stored as 16 ASCII characters)
Date in the form DD-MMM-YY* (stored as 12 ASCII characters). The *
character should be ignored if it is not a "1". If it is a "1", it indicates the
data is after the year 2000.
Time in the form HH:MM:SS (stored as 10 ASCII characters)
Live Time rounded to nearest second (stored as 10 ASCII characters)
Real Time rounded to nearest second (stored as 10 ASCII characters)
Reserved
31
ORTEC Software File Structure Manual for DOS and Windows Systems
91
103
111
121
C*1
C*1
C*1
C*1
Start date of sample collection (10 ASCII characters)
Start time of sample collection (8 ASCII characters)
Stop date of sample collection (10 ASCII characters
Stop time of sample collection (8 ASCII characters)
4.11.3. Sample Description Record
This record is discussed in Section 4.7.
4.11.4. Detector Description Record
This record is described in Section 4.4.
4.11.5. First, Second, and Third Analysis Parameter
These records are described in Section 4.2.
4.11.6. Absorption Correction Description Record
Word
Number
1
2
3
4–5
6–7
8–12
13–16
17–32
33–48
49–64
Local
Name
SORPRS
SORINT
Type
I*2
I*2
SORGEO
I*2
SORDEN
SORLNG
SORDAT
SORTIM
SORNAM
SREFNAM
SCURNAM
R*4
R*4
C*10
C*10
C*32
C*32
C*32
Use
Number of pairs (between 1 and 100)
1 if geometry record, 2 if internal, 4 if external
absorption
1 if cylindrical geometry (internal only), 2 if
Marinelli geometry (internal only)
Absorber density
Absorber length
Date absorption file created
Time absorption file created
Absorber name
Reference UFO name
Current UFO name
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
32
Reference UFO name
Current UFO name
4. ANALYSIS FILES
4.11.7. Absorption Correction Data Record
Word
Number
1–16
17–32
33–48
49–64
Local
Name
SORKEV (1–8)
SORAREA1 (1–8)
SORAREA2 (1–8)
SORVAL (1–8)
Type
R*4
R*4
R*4
R*4
Use
Energy
Reference area
Current area
Linear attenuation values
If fewer than 8 pairs are used, the array values are set to zero. There are as many data records as
necessary, up to 64 energies.
4.11.8. Geometry Correction Description Record
Word
Number
1
2
Local
Name
GEOPRS
GEOINT
Type
I*2
I*2
3
4–5
6–7
8–12
13–16
17–32
33–48
49–64
unused
unused
unused
GEODAT
GEOTIM
unused
GREFNAM
GCURNAM
I*2
R*4
R*4
C*10
C*10
C*32
C*32
C*32
Use
Number of pairs (between 1 and 100)
1 if geometry record, 2 if internal, 4 if external
absorption
Date geometry file created
Time geometry file created
Reference UFO name
Current UFO name
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
Reference UFO name
Current UFO name
4.11.9. Geometry Correction Data Record
Word
Number
1–16
17–32
33–48
49–64
Local
Name
GEOKEV (1–8)
GEOAREA1 (1–8)
GEOAREA2 (1–8)
GEOVAL (1–8)
Type
R*4
R*4
R*4
R*4
Use
Energy
Reference peak area
Current peak area
Geometry correction ratios
33
ORTEC Software File Structure Manual for DOS and Windows Systems
If fewer than 8 pairs are used, the array values are set to zero. Up to 64 energies can be stored.
The unused values are set to zero.
4.11.10. Calibration Description Record, Calibration Data Records, and Efficiency
Pairs Records
These records are described in Section 4.3.
4.11.11. Region-of-Interest Records
This format follows the format described in Section 3.2. The ROI records will be three
consecutive records, with the first record pointed to by word 21 of record 1 (FORTRAN name =
ROIRP1). The end of the list of regions is given by a negative start channel.
Record 1
Word
Number
0
1
2
3
4
.
.
.
61
62
63
Use
Must be 2
Start channel of first ROI
Stop channel of first ROI
Start channel of second ROI
Stop channel of second ROI
.
.
.
Start channel of thirty-first ROI
Stop channel of thirty-first ROI
Reserved
A negative start channel terminates the list of regions.
Record 2
Word
Number
0
1
.
.
.
34
Use
Start channel of thirty-second ROI
Stop channel of thirty-second ROI
.
.
.
4. ANALYSIS FILES
62
63
Start channel of 63rd ROI
Stop channel of 63rd ROI
Record 3
This contains the energy calibration for the MCB or buffer at the time the ROIs were defined.
Word
Number
0
3
7
11–63
Type
R*4
R*4
R*4
Use
Energy calibration zero intercept
Energy calibration slope
Energy calibration quadratic term
Reserved
4.11.12. Hardware Parameters Records
These records contain the hardware parameters for the MCB when the data were collected. The
appropriate values are entered into the record when the spectrum file is saved. Any value that is
correctly inserted must have the corresponding bit set in the validity flag words at the beginning of
the first record. All unused bytes are set to binary 0. Any program reading this record must check
the validity bit for the specific value before using the value in the record.
These two sequential records are pointed to by word 12 of record 1 in any inform file (FORTRAN
name = ANARP4).
Record 1
Word
Number
1–4
5
7
9
11
13
15
16
17
18
Type
R*4
R*4
I*4
I*4
R*4
I*2
I*2
I*2
Use
Validity flag, each bit corresponds to a single entry. 1 = valid contents,
0 = unused for this record. Bits are counted from the right, starting with 1.
The bit number corresponds to the word number; i.e., if preset real time
(word 5) is valid, then bit 5 and 6 are 1.
Preset real time in seconds
Preset live time in seconds
Preset counts
Preset integral
Preset uncertainty in percent
Overflow preset, 0 = off, 1 = on
Start channel for uncertainty preset region
Stop channel for uncertainty preset region
ADC conversion gain in channels
35
ORTEC Software File Structure Manual for DOS and Windows Systems
19
20
21
22
23
24
I*2
I*2
I*2
I*2
I*2
R*4
26
28
R*4
I*2
29
31
33
34
35
36
38
40
41
43
44
45
46
47
49
51
53
55
56
58
59
60
64
R*4
R*4
I*2
R*4
R*4
R*4
I*2
I*2
I*2
I*2
R*4
R*4
R*4
R*4
I*2
R*4
I*2
I*2
I*2
ADC offset in channels
Lower level discriminator in channels
Upper level discriminator in channels
Input gate: 0 = off, 1 = coincidence, 2 = anti
Amplifier coarse gain
Amplifier fine gain as the value of the multiplier seen on the MAESTRO
display
Amplifier fine offset in fractional channels
Gain stabilizer adjustment amplifier gain setting as the value from the
MCB
Start channel for gain stabilizer region
Stop channel for gain stabilizer region
Gain stabilizer mode; 0 = Gauss, 1 = peak
Gain stabilizer on/off; 1 = on, 0 = off
Zero stabilizer adjustment setting as the value from the MCB
Start channel for zero-stabilizer region
Stop channel For zero-stabilizer region
Zero stabilizer on/off; 1 = on, 0 = off
Shaping time constant in microseconds (as reported)
Preamplifier type; 0 = resister, 1 = TRP
PZ valid; 0 = no, 1 = yes
PZ value as reported by MCB
High voltage value in volts
Rise time (DSPEC®) as reported on MAESTRO display
Width (DSPEC) as reported on MAESTRO display
Cusp (DSPEC) as reported on MAESTRO display
Tilt (DSPEC) as reported on MAESTRO display
Baseline type; 1 = auto, 2 = fast, 3 = slow
Baseline value in microseconds
Amplifier mode, 1 = germanium, 2 = sodium iodide
Acquisition mode, 1 = PHA, 2 = MCS
MCB serial number, as ASCII text, 8 characters
Number of hardware records in file
Record 2
Word
Number
1–2
3–4
36
Type
I*4
I*4
Use
Validity flags for words 1–32, each bit corresponds to a single entry.
1 = valid contents, 0 = unused for this record
Validity flags for words 33–64
4. ANALYSIS FILES
5
6–7
8
9–10
11
12
13–20
21
22
23
24–25
26–27
28
29
30
31
32
33–38
39–40
41–42
43
44
45
46–49
50
51
52
53–54
55
56
57
58
59
60
61
62
I*2
R*4
I*2
I*4
I*2
I*2
C*8
I*2
I*2
I*2
R*4
R*4
I*2
I*2
I*2
I*2
I*2
float
float
float
I*2
I*2
short
char
I*2
I*2
I*2
R*8
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Amplifier input polarity, +1 = positive, 1 = negative
Thermistor value, in ohms
Pileup rejector, 0 = off, 1 = on
Pileup rejector width in ns
OCTÊTE-PC current in nA
OCTÊTE-PC vacuum in mT
Firmware revision in ASCII, 16 characters
High Voltage enabled: 1 = Yes, 0 = No
Shaping time constant index
Battery Stat: 0 = Ext, 1 = Battery 1, 2 = Battery 2
Battery 1 voltage
Battery 2 voltage
Desired high voltage
HV shutdown mode: 0 = TTL, 1 = ORTEC, 2 = Off
ADC type: 0 = CI34, 1 = CI36, 2 = ORTEC, 3 = Silena
Maximum vacuum value
Automatic threshold flag (SBS-60): 0 = Off, 1 = On
MDA preset coefficients
MDA preset value
User’s MDA preset value
Low MDA preset ROI limit
High MDA preset ROI limit
MDA preset units: 0 = Bq, 1 = µCi, 1 = None
MDA preset nuclide name in ASCII
ZDT-enabled flag: 1 = On, 0 = Off
ZDT refresh rate in micosecs
ZDT view spectrum (1 = Normal, 2 = Corrected)
Total count rate in CPS
MiniMCA-166: analog threshold value
MiniMCA-166: input routing
0 = through internal amplifier
1 = bypass internal amplifier with 0 to +3 V
2 = bypass internal amplifier with 0 to 3 V
Firmware revision code (MiniMCA-166)
Hardware revision code (MiniMCA-166)
Time value low for PZ (MiniMCA-166)
Time value high for PZ (MiniMCA-166)
Slow discriminator value (MiniMCA-166)
Fast discriminator value (MiniMCA-166)
37
ORTEC Software File Structure Manual for DOS and Windows Systems
63
64
I*2
I*2
Power switches (MiniMCA-166)
ZDT mode: 0 = Off, 1 = Normal-Corrected (LTC-ZDT), 2 = ErrorUncertainty (ERR-ZDT)
Record 3
Word
Number
1–2
3–4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
22–30
31–32
33–40
41–48
49–56
57
58
59–60
61–62
63
64
38
Local
Name
dwFlg1
dwFlg2
wP12I
wM12I
wP24I
wM24I
wBatI
wHvI
wChrI
wColl
wCollFast
wCollSlow
wHVRise
wFastThr
wSyncT
wDifTC
wIntTC
wInhbt
Type
I*4
I*4
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Validity flags for words 1–32
Validity flags for words 33–64
+12-V current in mA (MiniMCA-166)
12-V current in mA (MiniMCA-166)
+24-V current in mA (MiniMCA-166)
24-V current in mA (MiniMCA-166)
Battery current in mA (MiniMCA-166)
HV current in mA (MiniMCA-166)
Charger current in mA (MiniMCA-166)
Collection time (SBS-60)
Collection start on fast signal: 0 = No, 1 = Yes
Collection start on slow signal: 0 = No, 1 = Yes
HV rise time in seconds
Fast threshold value (SBS-60)
Synchronize thresholds flag: : 0 = No, 1 = Yes
Differentiation time constant in µs
Integration time constant in µs
Inhibit signal polarity (SBS-60): 0 = Off, 1 = High,
2 = Low
Number of valid nuclides in MDA preset
High voltage polarity ±1
Text associated with shutdown modes
HV current in mA (good for all HVPS)
Text associated ADC type
Text associated with Gate
Text associated with PZ mode
Number of strings with szViewNames
HV shutdown status () = OK, 1 = Shutdown)
Gain stabilizer adjustment in percent (100 to +100)
Zero stabilizer adjustment in percent (100 to +100)
Number of status string pairs following View strings
Unused
4. ANALYSIS FILES
Record 4
Word
Number
1–2
3–4
5
6
7
8
9–32
33–64
Use
Validity flags for 1–32
Validity flats for 33–64
Start delay in seconds (DART)
Conserve delay in seconds (DART)
Off delay in seconds (DART)
Power mode (0 = On, 1 = Conserve)
Unused
Data view name strings
Multi-Nuclide MDA Preset Storage
Up to 20 nuclides according to Word 21 in record 3, which corresponds to records 5–9.
Word
Number
1–2
3–4
5–6
7–8
9
10
11
12–16
17–18
19–20
21–22
23–24
25
26
27
28–32
33–34
35–36
37–38
39–40
41
42
43
Type
R*4
R*4
R*4
R*4
I*2
I*2
C*5
Use
MDA user preset (in Bq)
Eff * Yield
MDA hardware preset
MDA energy
Low ROI limit
High ROI limit
Reserved
MDA nuclide 1 name
MDA user preset (in Bq)
Eff * Yield
MDA hardware preset
MDA energy
Low ROI limit
High ROI limit
Reserved
MDA nuclide 2 name
MDA user preset (in Bq)
Eff * Yield
MDA hardware preset
MDA energy
Low ROI limit
High ROI limit
Reserved
39
ORTEC Software File Structure Manual for DOS and Windows Systems
44–48
49–50
51–52
53–54
55–56
57
58
59
60–64
MDA nuclide 3 name
MDA user preset (in Bq)
Eff * Yield
MDA hardware preset
MDA energy
Low ROI limit
High ROI limit
Reserved
MDA nuclide 4 name
This is repeated in blocks of 4 nuclides for the total needed. Records 10 and up contain status
records for the hardware. The number of records is Word 63 of record 3.
4.11.13. Personality Record
This record contains the laboratory name and the operator name for this spectrum. These are set in
the GammaVision dialogs.
Word
Number
1
33
Local
Name
LABNAM
OPRNAM
Type
C*64
C*64
Use
Laboratory name
Operator name
4.11.14. Table Description Record
This set of records is pointed to by the TABREC pointer of record 1. It contains the tables for the
IEQ, EBAR, and MPC corrections.
Word
Number
1
2
3–7
8–11
12–18
19–34
Local
Name
ITBLTYP
NTBLVAL
TBLDAT
TBLTIM
MPCUNIT
TABNAM
Type
I*2
I*2
C*10
C*8
C*14
C*32
Use
Data type: 3 = EBR, 4 = IEQ, 5 = MPC
Number of data pairs
Date geometry file created
Time geometry file created
MPC data units
Table filename
If long filenames are enabled, then the following 2 sequential records are defined as follows:
1+2
40
Table filename
4. ANALYSIS FILES
4.11.15. Table Data Record
This record follows the table description record. Any unused values are set to 1.
Word
Number
1–40
41–61
Local
Name
ISONAM (1–10)
TABVAL (1–10)
Type
C*8
R*4
Use
Array of isotope names
Array of average energy or IEQ or MPC values
Table Data Records 2–N follow if necessary. Up to 40 isotopes can be stored. The unused values
are set to zero.
4.11.16. Spectrum Records
These records are the spectrum data stored as REAL*4 numbers beginning with the channel
number given and going through the number of channels in the file. They are stored as 64-word
records, which gives 32 data channels per record. They are stored sequentially, beginning with the
record pointer given.
4.12. Integer Format Spectrum Files
An integer format spectrum file is created by the GammaVision and the file extension should be
.SPC. This file contains a spectrum and the associated information required to analyze the
spectrum. The contents of the integer format spectrum files are as follows.
Record 1
Word
Number
1
2
3
4
5
6
7
8
9
10
11
Local
Name
INFTYP
FILTYP
Type
I*2
I*2
ACQIRP
SAMDRP
DETDRP
EBRDESC
ANARP1
ANARP2
ANARP3
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Must be 1
Must be 1
Contents flag
Bit 0 = 1 for long filename
Bit 1 = 1 for ZDT spectrum and ROI in file.
Reserved
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
EBAR description record
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
41
ORTEC Software File Structure Manual for DOS and Windows Systems
42
12
13
ANARP4
SRPDES
I*2
I*2
14
15
16
17
18
19
20
21
IEQDESC
GEODES
MPCDESC
CALDES
CALRP1
CALRP2
EFFPRP
ROIRP1
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
22
23
24
25
26
27
28
29
30
PERPTR
MAXRCS
LSTREC
EFFPNM
I*2
I*2
I*2
I*2
31
SPCTRP
I*2
32
33
34
35
SPCRCN
SPCCHN
ABSTCH
ACQTIM
I*2
I*2
I*2
R*4
37
41
42
ACQTI8
SEQNUM
MCANU
R*8
I*2
I*2
43
SEGNUM
I*2
44
45
46
48
MCADVT
CHNSRT
RLTMDT
LVTMDT
I*2
I*2
R*4
R*4
Fourth analysis parameters record pointer
Absorption correction description record
pointer
IEQ description record pointer
Geometry correction description record pointer
MPC description record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the two ROI
records
Energy pairs record pointer
Number of energy pair records
Reserved
Disable deconvolution of unknown peaks
True = microcuries, false = becquerels
Laboratory and operator name record pointer
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (See
Word 20)
Spectrum record pointer (pointer to first
record)
Number of records in the spectrum
Number of channels in spectrum
Physical start channel for data
Date and time of acquisition start in DECDAY
format
Date and time as double precision DECDAY
Sequence number
MCA number as two ASCII characters (old) or
Detector number as integer for systems with
Connections
Segment number as two ASCII characters (old)
or as integer value 1 for systems with
Connections
MCA device type
Start channel number
Real time in seconds
Live time in seconds
4. ANALYSIS FILES
50
51–64
Reserved
Reserved
4.12.1. Other Records
The remaining records are described in the real format spectrum file section with the exception
that the spectrum is stored as 4-byte integers.
4.12.2. Spectrum Records
These records are the spectrum data stored as INTEGER*4 numbers beginning with the channel
number given and going through the number of channels in the file. They are stored as 64-word
records, which gives 32 data channels per record. They are stored sequentially, beginning with the
record pointer given.
4.13. Net Spectrum Files
A net spectrum file should have the extension of .SPC. This file contains the difference between
two spectra with the analysis parameters and other associated data taken from the foreground
spectrum. The contents of the net spectrum file are:
Record 1
Word
Number
1
2
3
Local
Name
INFTYP
FILTYP
Type
I*2
I*2
4
5
6
7
8
9
10
11
12
ACQIRP
SAMDRP
DETDRP
EBRDESC
ANARP1
ANARP2
ANARP3
ANARP4
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
13
SRPDES
I*2
Use
Must be 1
Must be 7 (real) or 3 (integer)
Contents Flag
Bit 0 = 1 for long filename
Bit 1 = 1 for ZDT spectrum and ROI in file
Reserved
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
EBAR description record
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameter record pointer
Absorption correction description record
pointer
43
ORTEC Software File Structure Manual for DOS and Windows Systems
14
15
16
17
18
19
20
21
IEQDESC
GEODES
MPCDESC
CALDES
CALRP1
CALRP2
EFFPRP
ROIRPI
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
22
27
28
29
30
PERPTR
CALRP2
MAXRCS
LSTREC
EFFPNM
I*2
I*2
I*2
I*2
I*2
31
SPCTRP
I*2
32
33
35
SPCRCN
SPCCHN
ACQTIM
I*2
I*2
R*4
ACQTI8
SEQNUM
SEQNAM
MCADVT
CHNSRT
RLTMDT
LVTMDT
R*8
I*2
C*1
I*2
I*2
R*4
R*4
37
41
42
44
45
46
48
50–64
IEQ description data record pointer
Geometry correction description record pointer
MPC description record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the two ROI
records
Personality record pointer
Second calibration data record pointer
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (see
Word 20)
Spectrum record pointer (pointer to first
record)
Number of records in the spectrum
Number of channels in spectrum
Date and time of acquisition start in DECDAY
format
Date and time as double precision DECDAY
Sequence number
Sequence name of 4 ASCII characters
MCA device type
Start channel number
Real time in seconds
Live time seconds
Reserved
The remaining records are described in the real format spectrum file section.
4.14. AlphaVision Spectrum Files
These files are written by AlphaVision (A36-B32). They can be read by other programs (e.g.,
MAESTRO and WINPLOTS), but only the analysis parameters are used by AlphaVision.
44
4. ANALYSIS FILES
The first record is:
Word
Number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35–36
Use
Must be 1
Must be 1
Contents flag; on is true
Description
Bit
Bit 1
Long file names
Reserved
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
First table record pointer
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameters record pointer
Absorption correction description record pointer
Absorption correction data record pointer
Geometry correction description record pointer
Geometry correction data record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
ROI record pointer (first of the three records)
Energy pairs record pointer (first record)
Number of energy-pairs records
Reserved
Reserved
True = microcuries, False = becquerels
Pointer to personality record (laboratory name)
Maximum record allocated (unused for UFO)
Maximum record in use (or allocated for UFO)
Reserved
Spectrum record pointer
Number of records in spectrum
Number of channels
Start channel
Acquisition start in DECDAY format
45
ORTEC Software File Structure Manual for DOS and Windows Systems
37–40
41
42
43
44
45
46
48
50–64
Acquisition start in DECDAY8 format
Sequence number
Detector ID
Segment number (always 1)
MCA device type
Start channel number
Real time in seconds
Live time in seconds
Reserved
The remaining records are the same as the germanium spectrum files (see Section 4.12).
4.15. Germanium Unformatted Output Files
An unformatted output (.UFO) file is created by the programs AN1, FMPC (B30), MAN1, WAN1,
GAM32 (A66), MFMPC (A34), and all other Windows germanium-analysis programs. Older
.UFO files are used by PBC and PEAKPLOT, but .UFO files created by GammaVision cannot be
used with older programs. It should have a file extension of .UFO. A .UFO file contains the results,
both intermediate and final, of the germanium spectral analysis. Because of their size, the user
should delete .UFO files that are no longer needed.
The .UFO file has changed in GammaVision 5.2, that is, the “old” .UFO file was written before
version 5.2 and the “new” .UFO file is used by version 5.2 and later. To determine if a .UFO file is
“old” or “new,” look at Words 50 and 51 of Record 2. These will be 2 for new .UFO files and 0
(zero) for old files. Other values (i.e., not 2 or zero) should be interpreted as zero (old).
4.15.1. Records 1 and 2
4.15.1.1. Old UFO Records 1 and 2
The contents of the old .UFO file are:
Record 1
Word
Number
1
2
3
4
5
6
46
Local
Name
Use
Must be 1
Must be 1024
Special application record pointer 1
Special application record pointer 2
Acquisition information record pointer
Sample description record pointer
4. ANALYSIS FILES
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31–64
PERPTR
Detector description record pointer
Special application record pointer
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameters record pointer
Absorption correction description record pointer
Absorption correction data record pointer
Geometry correction description record pointer
Geometry correction data record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the ROI records
Energy pairs record pointer
Number of energy pair records
Reserved
Disable deconvolution of unknown peaks
True = microcuries, False = becquerels
Laboratory and operator name record pointer
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (see Word 20)
Reserved
Record 2
The second record of the old .UFO file contains pointers to other records used in the .UFO file and
data used by the various analysis programs used to analyze the data.
Word
Number
1
2
3
4
5
6
7
8
Local
Name
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
GEN record pointer
CSI 1 record pointer
CSI 2 record pointer
Library 1 peak records start pointer
Number of Library 1 peaks used
Number of Library 1 peaks allocated
Library 2 peak records start pointer
Number of Library 2 peak records used
47
ORTEC Software File Structure Manual for DOS and Windows Systems
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
28
29
30
31
32
33
35
37
39
41
43
45
49
50
59
61
63
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
R*4
R*4
R*4
R*4
I*2
I*2
I*2
R*4
R*4
R*4
Number of Library 2 peak records allocated
Library 3 peak records start pointer
Number of Library 3 peak records used
Number of Library 3 peak records allocated
Unknown peak records start pointer
Number of unknown peak records used
Number of unknown peak records allocated
Library 1 nuclide records start pointer
Number of Library 1 nuclide records used
Number of Library 1 nuclide records allocated
Library 2 nuclide records start pointer
Number of Library 2 nuclide records used
Number of Library 2 nuclide records allocated
Library 3 nuclide records start pointer
Number of Library 3 nuclide records used
Number of Library 3 nuclide records allocated
Reserved
CSI 3 record pointer
CSI 4 record pointer
Lowest in-range peak pointer for Lib-1 and this analysis
Lowest in-range peak pointer for Lib-2 and this analysis
Lowest in-range peak pointer for Lib-3 and this analysis
NUPISA
EBRDEC
IEQVAL
IEQDEC
NAC shadow for library 1
NAC shadow for library 2
NAC shadow for library 3
Pointer to start record 3
Reserved
EBRVAL
Total activity
Etime
Other Records
The records not described below are described in the real format spectrum file discussion,
Section 4.11.
48
4. ANALYSIS FILES
4.15.1.2. New UFO Records 1 and 2
The contents of the new .UFO file are:
Record 1
Word
Number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Local
Name
PERPTR
SPCTRP
Use
Must be 1
Must be 1024
Contents flag, 1 = true
Description
Bit
Bit 0 Long filename
Bit 1 ZDT
Reserved
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
First table record pointer
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameters record pointer
Absorption correction description record pointer
Absorption correction data record pointer
Geometry correction description record pointer
Geometry correction data record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the three ROI records
Energy pairs record pointer
Number of energy pair records
DLAN1.DLL debug, True = write AN1TRAIL.TXT
Disable deconvolution of unknown peaks
True = microcuries, False = becquerels
Laboratory and operator name record pointer
Maximum record number ever used
Maximum record number in use
Number of efficiency pairs records (see Word 20)
Spectrum record pointer
49
ORTEC Software File Structure Manual for DOS and Windows Systems
32
33
34
35–36
37–40
41
42
43
44
45
46
48
50
51
52
53
54
55–62
63–64
SPCRCN
SPCCHN
ABSTCH
ACQTIM
ACQT88
SEQNUM
MCANUM
SEGNUM
MCADVT
CHNSRT
RLTMDT
LVTMDT
Number of records in spectrum
Number of channels
Start channel
Acquisition start in DECDAY format
Acquisition start in DECDAY8 format
Sequence number
Detector ID
Segment number (always 1)
MCA device type
Start channel number
Real time in seconds
Live time in seconds
Pointer to MGA records
Pointer to FRAM records
Pointer to TRIFID records
Pointer to NaI records
Pointer to description record
Reserved
Random summing factor
Record 2
The second record of the new .UFO file contains pointers to other records used in the .UFO file
and data used by the various analysis programs used to analyze the data.
Word
Number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
50
Local
Name
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
GEN record pointer
CSI 1 record pointer
CSI 2 record pointer
Library 1 peak records start pointer
Number of Library 1 peaks used
Number of Library 1 peaks allocated
Library 2 peak records start pointer
Number of Library 2 peak records used
Number of Library 2 peak records allocated
Library 3 peak records start pointer
Number of Library 3 peak records used
Number of Library 3 peak records allocated
Unknown peak records start pointer
Number of unknown peak records used
4. ANALYSIS FILES
15
16
17
18
19
20
21
22
23
24
25
28
29
30
31
32
33
35
37
39
41
43
45
49
50
51
52–58
59
61
63
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
R*4
R*4
R*4
R*4
I*2
I*2
I*2
I*2
I*2
R*4
R*4
R*4
Number of unknown peak records allocated
Library 1 nuclide records start pointer
Number of Library 1 nuclide records used
Number of Library 1 nuclide records allocated
Library 2 nuclide records start pointer
Number of Library 2 nuclide records used
Number of Library 2 nuclide records allocated
Library 3 nuclide records start pointer
Number of Library 3 nuclide records used
Number of Library 3 nuclide records allocated
Reserved
CSI 3 record pointer
CSI 4 record pointer
Lowest in-range peak pointer for Lib-1 and this analysis
Lowest in-range peak pointer for Lib-2 and this analysis
Lowest in-range peak pointer for Lib-3 and this analysis
NUPISA
EBRDEC
IEQVAL
IEQDEC
NAC shadow for library 1
NAC shadow for library 2
NAC shadow for library 3
Pointer to start record 3
Ratio of new nuclide record size to old size. Must be 2
Ratio of new peak record size to old size. Must be 2
Unused.
EBRVAL
Total activity
Etime
Other Records
The records not described below are described in the real format spectrum file section.
51
ORTEC Software File Structure Manual for DOS and Windows Systems
4.15.2. UFO File CSI Records
Records 1 and 3
UFO File CSI 1 Record
Word
Number
1
17
33
49
Use
NAA standard table filename
Uranium fission correction filename
Reserved
Reserved
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
NAA standard table filename
Uranium fission correction filename
UFO File CSI 3 Record
Word
Number
1
33
Use
MPC Column Title; 64 ASCII characters
Unused
Records 2 and 4
CSI Records 2 and 4 contain the four filenames that are used in an analysis. Each file specification
is stored left-justified in its field as ASCII characters padded with spaces to the end. The contents
are:
UFO File CSI 2 Record
Word
Number
1
32
52
Use
RPT filename
MPC Table filename
4. ANALYSIS FILES
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
RPT filename
MPC Table filename
UFO File CSI 4 Record (indexed by Word 29 of the second record)
Word
Number
1
32
Use
UFO filename
Spectrum filename
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
UFO filename
Spectrum filename
4.15.3. UFO File GEN Record
The UFO file GEN record, indexed by Word 1 of the second record, is a special record that
contains details about the analysis.
Word
Number
1–7
8
9
10
11
12
13
14–15
16
17
18
19
20
21
22
Local
Name
Type
QA
IEQ
EBAR
RPTLUN
UFOLUN
SPCLUN
L*2
L*2
L*2
I*2
I*2
I*2
TBLLUN
LB1LUN
LB2LUN
LB3LUN
LB4LUN
PAGENM
LINENM
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Reserved
Reserved
Reserved
Reserved
Logical unit for report output
Logical unit for UFO file I/O
Logical unit for spectrum I/O
Reserved
Logical unit for table I/O
Logical unit for Library 1 I/O
Logical unit for Library 2 I/O
Logical unit for Library 3 I/O
Logical unit for Library 4 I/O
Current output page number in RPT
Current output line number in RPT
53
ORTEC Software File Structure Manual for DOS and Windows Systems
23
24
26
28
30
31
35
39
43
44
49–64
NOPISA
LIVETM
REALTM
STTIME
GAMID
GAMVER
GAMNAM
I*2
R*4
R*4
R*4
I*2
C*1
C*1
ACQTI8
DIRFTD
SUM
R*8
L*2
R*8
Number of unknown peaks above sens. cutoff
Live time (seconds) value for spectrum
Real time (seconds) value for spectrum
Analysis start time
Type of analysis to perform
Analysis version as 8 ASCII characters
ASCII name of analysis program as 8 ASCII
characters
Date and time as double precision DECDAY
True = do directed fit flag
Sum of all channels in the spectrum
Reserved
4.15.4. UFO Absorption Description Record
This record is the same as the absorption record in the .SPC file (Section 4.11.6).
Word
Number
1
2
3
4, 5
6, 7
8–12
13–16
17–32
33–48
49–64
Local
Name
SORPRS
SORINT
Type
I*2
I*2
SORGEO
I*2
SORDEN
SORLNG
SORDAT
SORTIM
SORNAM
SREFNAM
SCURNAM
R*4
R*4
C*10
C*10
C*32
C*32
C*32
Use
Number of pairs (between 1 and 100)
1 if geometry record, 2 if internal, 4 if external
absorption
1 if cylindrical geometry (internal only), 2 if
Marinelli geometry (internal only)
Absorber density
Absorber length
Date absorption file created
Time absorption file created
Absorber name
Reference UFO name
Current UFO name
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
54
Reference UFO name
Current UFO name
4. ANALYSIS FILES
4.15.5. UFO Geometry Description Record
Note that this record is the same as the geometry record in the .SPC file (Section 4.11.8).
Word
Number
1
2
Local
Name
GEOPRS
GEOINT
Type
I*2
I*2
3
4–5
6–7
8–12
13–16
17–32
33–48
49–64
unused
unused
unused
GEODAT
GEOTIM
unused
GREFNAM
GCURNAM
I*2
R*4
R*4
C*10
C*10
C*32
C*32
C*32
Use
Number of pairs (between 1 and 100)
1 if geometry record, 2 if internal, 4 if external
absorption
Date geometry file created
Time geometry file created
Reference UFO name
Current UFO name
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
Reference UFO name
Current UFO name
4.15.6. UFO File Nuclide Records
4.15.6.1. Old UFO File Nuclide Records
The .UFO file nuclide records are 32 words long with two of these records packed in each .UFO
file 64-word record. These records are allocated in groups of two so that an integer number of
64-word records is always used. The nuclide record contains information about the analysis of a
specific nuclide as described below:
Word
Number
1
5
7
9
10
11
13
15
Local
Name
ISONAM
HAFLIF
UNCERT
PBCVAL
ISONAA
MPCVAL
Type
C*I
R*4
R*4
I*2
I*2
R*4
R*4
R*4
Use
Isotope name as 8 ASCII characters
Half-life in days
Uncertainty
Reserved
Reserved
PBC correction factor
NAA concentration
MPC value
55
ORTEC Software File Structure Manual for DOS and Windows Systems
17
18
THSREC
ISOFLG
I*2
I*2
19
20
21
22
23
25
27
29
31
FRPKPT
I*2
I*2
I*2
I*2
R*4
R*4
R*4
R*4
R*4
ISOCUR
ICRFAC
ISOERR
TOTERR
ISOMDA
This record pointer
Nuclide analysis flag, bits as follows:
Description
Bit
Bit 0
MDA value used for activity
Bit 1
Area is below critical level
Bit 2
Nuclide must have a report entry
Bit 3
No valid peaks were detected
Bit 4
Area is between sensitivity and
critical level
Bit 5
Decay correction time >12 halflives
Bit 6
Decay time during acquisition
>12 half-lives
Bit 7
Nuclide not present
Bit 8
Unused
Bit 9
All peaks used in abundance
calculation were good
Bit 10
Library energy conflict
Bit 11
Directed fit activity
Bit 12
NAA concentration factor valid
Bit 13
NAA calculated
Bit 14
Activity calculated using Gamma 3
Bit 15
Unused
Pointer to first in-range peak for this nuclide
Unused
Unused
Reserved
Calculated abundance in becquerels
Decay time correction factor
Isotope counting error
Total error
MDA for this isotope
4.15.6.2. New UFO File Nuclide Records
The first part of the .UFO file nuclide records is 32 words long with two of these records packed in
each .UFO file 64-word record (see Section 4.15.1.2). These records are allocated in groups of two
so that an integer number of 64-word records is always used. The second part is pointed to by
Word 13 below. The nuclide record contains information about the analysis of a specific nuclide
as described below:
56
4. ANALYSIS FILES
Word
Number
1
5
7
9
10
11
13
14
15
17
18
19
20
21
22
23
25
27
Local
Name
ISONAM
HAFLIF
UNCERT
PBCVAL
H2REC
MPCVAL
THSREC
ISOFLG
FRPKPT
ISOCUR
ICRFAC
ISOERR
Type
C*I
R*4
R*4
I*2
I*2
R*4
I*2
I*2
R*4
I*2
I*2
I*2
I*2
I*2
I*2
R*4
R*4
R*4
Use
Isotope name as 8 ASCII characters
Half-life in days
Uncertainty
Reserved
Reserved
PBC correction factor
Pointer to nuclide record Part 2
Unused
MPC value
This record pointer
Nuclide analysis flag, bits as follows:
Description
Bit
Bit 0
MDA value used for activity
Bit 1
Area is below critical level
Bit 2
Nuclide must have a report entry
Bit 3
No valid peaks were detected
Bit 4
Area is between sensitivity and
critical level
Bit 5
Decay correction time >12 halflives
Bit 6
Decay time during acquisition
>12 half-lives
Bit 7
Nuclide not present
Bit 8
Nuclide in table
Bit 9
All peaks used in abundance
calculation were good
Bit 10
Library energy conflict
Bit 11
PBC subtracted
Bit 12
NAA concentration factor valid
Bit 13
Failed key line or fraction test
Bit 14
Unused
Bit 15
Unused
Pointer to first in-range peak for this nuclide
Unused
Unused
Reserved
Calculated abundance in becquerels
Decay time correction factor
Isotope counting error
57
ORTEC Software File Structure Manual for DOS and Windows Systems
29
31
TOTERR
ISOMDA
R*4
R*4
Total error
MDA for this isotope
Local
Name
Type
Use
Atomic number and atomic mass of the current
isotope
Branching ratio to first daughter
Branching ratio to second daughter
Branching ratio to third daughter
Pointer to first parent record
Pointer to second parent record
Pointer to third parent record
Pointer to first daughter record
Pointer to second daughter record
Pointer to third daughter record
Decay during acquisition factor
Decay during collection factor
Second MDA value (see B30WINS.INI)
Unused
Second part:
Word
Number
1
3
5
7
9
10
11
12
13
14
15
17
19
21–32
4.15.7. UFO File Peak Records
4.15.7.1. Old UFO File Peak Records
The UFO file peak records are 64 words long. These records contain information about the
analysis of specific peaks as described below:
Word
Number
1
3
5
7
9
11
13
58
Local
Name
PEKENG
PGMPRD
PEKCON
AREA
BKG
FPAREA
FPBKG
Type
R*4
R*4
R*4
R*4
R*4
R*4
R*4
Use
Library energy of the peak in keV
Gammas per 100 disintegration
Peak concentration for NAA
Corrected net area of the peak
Corrected background of the peak
First pass net area of the peak
First pass background of the peak
4. ANALYSIS FILES
15
17
19
21
23
25
26
27
28
29
30
31
CNTR
FWO4M
FW10M
FWHMOO
PKUNCT
ISNUM
ENPRE
ENNXT
PKARE
PKNXT
PEK1
FLAG1
R*4
R*4
R*4
R*4
R*4
I*2
I*2
I*2
I*2
I*2
I*2
I*2
32
FLAG 2
I*2
Peak centroid in fractional channels
Full-width-.04-maximum in fractional channels
Full-width-.10-maximum in channels
Full-width-half-maximum in channels
Peak counting uncertainty, as fraction
Pointer to nuclide record
Pointer to next lower library energy
Pointer to next higher library energy
Pointer to next lower nuclide energy
Pointer to next higher nuclide energy
Pointer to first in-range peak for this nuclide
Peak flag 1 as described below:
Description
Bit
Bit 0
FW25M/2.2 >1.2*FWHM
Bit 1
FW10M/1.83 >1.2*FWHM
Bit 2
Only 1 entry in library <FWHM
Bit 3
2 or more entries in library
<FWHM
Bit 4
FWHM(actual) <0.8 FWHM(calc)
or >1.2 FWHM(calc)
Bit 5
Peak out of range
Bit 6
Net area <0
Bit 7
Reserved
Bit 8
Centroid is too far from library line
Bit 9
HI LO + .8 * FWHM
Bit 10
Centroid not found
Bit 11
Beta peak (obsolete files only)
Bit 12
FW25M/2.2 <.8 * FWHM
Bit 13
Result of deconvolution
Bit 14
Set if error > sensitivity for first
in-range peak
Bit 15
Unused
Peak Flag 2 as described below:
Description
Bit
Bit 0
Unused
Bit 1
Abundance for this peak higher
than average
Bit 2
Abundance for this peak lower
than average
59
ORTEC Software File Structure Manual for DOS and Windows Systems
Bit 3
Bit 4
Bit 5
Subtraction has occurred
Peak used for MDA calculation
Reserved
Bit 6
33
35
36
37
39
40
41
43
45
PKCNTS
LACTWD
HACTWD
CNTENG
PKLOLM
PKHILM
LOAVE
HIAVE
PKABUN
R*4
I*2
I*2
R*4
I*2
I*2
R*4
R*4
R*4
47
49
50
51
53
55
PEKMDA
MPLOLM
MPHILM
UFSLOP
PKCONC
FLAG3
R*4
I*2
I*2
R*4
R*4
I*2
56
60
I*2
Peak used for abundance
calculation
Bit 7
Peak used for subtraction
Bit 8
First in-range peak rejected for any
reason
Bit 9
Peak itself has error > sensitivity
Bit 10
Duplicate energies in library
Bit 11
Unknown/library multiplet
Bit 12
Peak grossly out of shape
Bit 13
Peak had PBC subtracted
Bits 14–15 Unused
Number of uncorrected counts in peak
Width of background region below peak
Width of background region above peak
Actual peak centroid in energy
Peak low limit of integration
Peak high limit of integration
Average background below peak
Average background above peak
Isotopic abundance based on this peak only
Or efficiency-corrected area for unknown
peaks
MDA based on this peak only
Multiplet region low limit of integration
Multiplet region high limit of integration
Average background slope across peak
Peak Flag 3 as described below:
Description
Bit
Bit 0
NAC available
Bit 1
Used in concentration calculation
Bit 2
Parabolic background used
Bit 3
Directed fit on this peak
Bit 4–15 Reserved
Gamma fraction
4. ANALYSIS FILES
57
63
BKCOEF
R*4
I*2
Parabolic background coefficients (3)
0 = No other peaks close
1 = Other peaks are too close for reliable
deconvolution
2 = The peak area is derived via Gamma3
4.15.7.2. New UFO File Peak Records
The UFO file peak records are 64 words long. These records contain information about the
analysis of specific peaks as described below:
Word
Number
1
3
5
7
9
11
13
15
17
19
21
23
25
26
27
28
29
30
31
Local
Name
PEKENG
PGMPRD
PEKCON
AREA
BKG
FPAREA
FPBKG
CNTR
FWO4M
FW10M
FWHMOO
PKUNCT
ISNUM
ENPRE
ENNXT
PKARE
PKNXT
PEK1
FLAG1
Type
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
R*4
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Library energy of the peak in keV
Gammas per 100 disintegration
Peak concentration for NAA
Corrected net area of the peak
Corrected background of the peak
First pass net area of the peak
First pass background of the peak
Peak centroid in fractional channels
Full-width-.04-maximum in fractional channels
Full-width-.10-maximum in channels
Full-width-half-maximum in channels
Peak counting uncertainty, as fraction
Pointer to nuclide record
Pointer to next lower library energy
Pointer to next higher library energy
Pointer to next lower nuclide energy
Pointer to next higher nuclide energy
Pointer to first in-range peak for this nuclide
Peak flag 1 as described below:
Description
Bit
Bit 0
FW25M/2.2 >1.2*FWHM
Bit 1
FW10M/1.83 >1.2*FWHM
Bit 2
Only 1 entry in library <FWHM
Bit 3
2 or more entries in library
<FWHM
Bit 4
FWHM(actual) <0.8 FWHM(calc)
or
>1.2 FWHM(calc)
Bit 5
Peak out of range
61
ORTEC Software File Structure Manual for DOS and Windows Systems
Bit 6
Bit 7
Bit 8
Bit 9
Bit 10
Bit 11
Bit 12
Bit 13
Bit 14
62
32
FLAG 2
I*2
33
35
36
37
39
40
PKCNTS
LACTWD
HACTWD
CNTENG
PKLOLM
PKHILM
R*4
I*2
I*2
R*4
I*2
I*2
Net area <0
Reserved
Centroid is too far from library line
HI LO + .8 * FWHM
Centroid not found
Beta peak (obsolete files only)
FW25M/2.2 <.8 * FWHM
Result of deconvolution
Set if error > sensitivity for first
in-range peak
Bit 15
Unused
Peak Flag 2 as described below:
Description
Bit
Bit 0
Unused
Bit 1
Abundance for this peak higher
than average
Bit 2
Abundance for this peak lower
than average
Bit 3
Subtraction has occurred
Bit 4
Peak used for MDA calculation
Bit 5
Reserved
Bit 6
Peak used for abundance
calculation
Bit 7
Peak used for subtraction
Bit 8
First in-range peak rejected for any
reason
Bit 9
Peak itself has error > sensitivity
Bit 10
Duplicate energies in library
Bit 11
Unknown/library multiplet
Bit 12
Peak grossly out of shape
Bit 13
Peak had PBC subtracted
Bits 14–15 Unused
Number of uncorrected counts in peak
Width of background region below peak
Width of background region above peak
Actual peak centroid in energy
Peak low limit of integration
Peak high limit of integration
4. ANALYSIS FILES
41
43
45
LOAVE
HIAVE
PKABUN
R*4
R*4
R*4
47
49
50
51
53
55
PEKMDA
MPLOLM
MPHILM
UFSLOP
PKCONC
FLAG3
R*4
I*2
I*2
R*4
R*4
I*2
BKCOEF
I*2
R*4
I*2
56
57
63
64
65
66
67
68
69
70
71
72–73
74–75
76–77
78–81
82–128
MLTPRE
CURREC
LENPRE
LENNXT
G3PRE
G3NXT
FLAGT
MDA2
BRUNCT
TCCBR
SUSNAM
Average background below peak
Average background above peak
Isotopic abundance based on this peak only or
efficiency-corrected area for unknown peaks
MDA based on this peak only
Multiplet region low limit of integration
Multiplet region high limit of integration
Average background slope across peak
Peak Flag 3 as described below:
Description
Bit
Bit 0
NAC available
Bit 1
Used in concentration calculation
Bit 2
Parabolic background used
Bit 3
Directed fit on this peak
Bit 4–15 Reserved
PKCNUN
Parabolic background coefficients (3)
0 = No other peaks close
1 = Other peaks are too close for reliable
deconvolution
2 = The peak area is derived via Gamma3
Peak flags from library (see lib.h)
First peak in multiplet pointer
Current record pointer
Previous library peak pointer
Next library peak pointer
Previous overlapping peak pointer
Next overlapping peak pointer
TCC flag
Description
Bit
Bit 1
TCC library
Second MDA value
Branching ratio uncertainty
Original branching ratio of TCC library peak
Suspect library nuclide
Unused
63
ORTEC Software File Structure Manual for DOS and Windows Systems
4.16. Sodium Iodide Unformatted Output (UFO)
File Peak Records
4.16.1. UFO Records 1 and 2
The contents of the .UFO file are:
Record 1
Word
Number
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
64
Local
Name
PERPTR
Use
Must be 1
Must be 4096
Special application record pointer 1
Special application record pointer 2
Acquisition information record pointer
Sample description record pointer
Detector description record pointer
Special application record pointer
First analysis parameters record pointer
Second analysis parameters record pointer
Third analysis parameters record pointer
Fourth analysis parameters record pointer
Absorption correction description record pointer
Absorption correction data record pointer
Geometry correction description record pointer
Geometry correction data record pointer
Calibration description record pointer
First calibration data record pointer
Second calibration data record pointer
Efficiency pairs record pointer (first record)
Record number of the first of the two ROI records
Energy pairs record pointer
Number of energy pair records
Reserved
Disable deconvolution of unknown peaks
True = microcuries, False = becquerels
Laboratory and operator name record pointer
Maximum record number ever used
Maximum record number in use
4. ANALYSIS FILES
30
31–64
Number of efficiency pairs records (see Word 20)
Reserved
Record 2
The second record of the .UFO file contains pointers to other records used in the .UFO file and
data used by the various analysis programs used to analyze the data.
Word
Number
1
2
3
4–6
7–9
10–12
13–15
16–18
19–21
22–24
25–27
28
29
30
31
32
33–34
35–36
37–38
39–40
41–42
43–44
45–46
47–58
59–60
61–62
63–64
Local
Name
LNRGPK
LNRGP2
LNRGP3
NUPISA
EBRDEC
IEQVAL
IEQDEC
NAC1
NAC2
NAC3
Use
GEN record pointer
CSI record 1 pointer
CSI record 2 pointer
Peak record 1 pointer
Peak record 2 pointer
Peak record 3 pointer
unknown peak record pointer
Nuclide record 1 pointer
Nuclide record 2 pointer
Nuclide record 3 pointer
Reserved
CSI record 3 pointer
CSI record 4 pointer
First in-range peak
Reserved
EBRVAL
TOTAC
Etime
Total activity
Other records
The remaining record pointers shown in Record 1 above are described in the real format spectrum
file section.
65
ORTEC Software File Structure Manual for DOS and Windows Systems
4.16.2. UFO File CSI Records
Records 1 and 3
UFO File CSI 1 Record
Word
Number
1
17
33
49
Use
NAA standard table filename
Uranium fission correction filename
Reserved
Reserved
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
NAA standard table filename
Uranium fission correction filename
UFO File CSI 3 Record
Word
Number
1
33
Use
MPC Column Title; 64 ASCII characters
Unused
Records 2 and 4
CSI Records 2 and 4 contain the four filenames that are used in an analysis. Each file specification
is stored left-justified in its field as ASCII characters padded with spaces to the end.
The contents are:
UFO File CSI 2 Record
Word
Number
1
32
66
Use
RPT filename
MPC Table filename
4. ANALYSIS FILES
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
RPT filename
MPC Table filename
UFO File CSI 4 Record (indexed by Word 29 of the second record)
Word
Number
1
32
Use
UFO filename
Spectrum filename
If long filenames are enabled, then the following 4 sequential records are defined as follows:
1+2
3+4
UFO filename
Spectrum filename
4.16.3. UFO File GEN Record
Word
Number
1
2–5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Use
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Logical unit for report output
Logical unit for UFO file I/O
Logical unit for spectrum I/O
Reserved
Reserved
Logical unit for table I/O
Logical unit for library 1 I/O
Logical unit for library 2 I/O
Logical unit For library 3 I/O
Logical unit For library 4 I/O
Current output page number in RPT
Current output line number in RPT
Reserved
67
ORTEC Software File Structure Manual for DOS and Windows Systems
24
26
28
30
31
35
39–40
41–43
44–45
46–47
48–51
52
53
54
55
57–58
59–64
Live time
Real time
Start time
Type of analysis to perform
Analysis version
Analysis program
Acquisition date and time in DECDAY format
Reserved
Sum of all channels in spectrum
Reserved
Reserved
Reserved
Reserved
Reserved
Random summing factor
Reserved
Reserved
4.16.4. UFO File Nuclide Records
Word
Number
1–4
5–6
7–8
9
10
11–12
13–14
15–16
17
18
68
Local
Name
LIBNAM
HAFLIF
UNCERT
NACERR
THSISO
PBCVAL
ISONAA
MPCVAL
THSREC
ISOFLG
Type
Half-life in days
Source uncertainty
This nuclide record pointer
Nuclide analysis flag word
Bit Description
0 MDA value used for activity
1 Area is below critical level
2 Nuclide must have a report entry
3 No peaks in analysis range
4 Area is between sensitivity and critical level
5 Decay correction time > 12 half-lives
6 Decay during acquisition > 12 half-lives
7 Nuclide present
4. ANALYSIS FILES
19
20
21
22
23–24
25–26
27–28
29–30
31–32
ISOPEK
BCKISO
FREISO
NCCNER
ISOCUR
ICRFAC
ISOERR
TOTERR
ISOMDA
8 Nuclide in table
9 All peaks used in abundance calculation were good
10 Library energy conflict
11 PBC subtracted
12 NAACON fact available
Pointer to first in-range peak for this nuclide
Pointer to previous isotope nuclide record
Pointer to free isotope nuclide record
Calculated abundance in Bq
Decay-time correction factor
Isotope counting error
Total error
MDA for this isotope
4.16.5. UFO File Peak Records
Word
Number
1–2
3–4
5–6
7–8
9–10
11–12
13–14
15–16
17–18
19–20
21–22
23–24
25
26
Local
Name
PEKENG
PGMPRD
Type
Library energy
Cubic background coefficient GSA change
AREA
BKG
AREA1
BKG1
CNTR
FWHM04
FWHM01
FWHM00
PKUNCT
ISOPTR
ENPR
27
ENNXT
28
29
30
PKPRE
PKNXT
PEK1
(FirstNet)
(FirstBackground)
Centroid in channels
Nuclide record (1 means this is an unknown peak)
Next lower library energy peak record (not necessarily
same nuclide)
Next higher library energy peak record (not necessarily
same nuclide)
Next lower energy for this nuclide
Next higher energy for this nuclide
Pointer to first in–range peak for this nuclide
69
ORTEC Software File Structure Manual for DOS and Windows Systems
31
FLAG1
32
FLAG2
33–34
35
36
37–38
39
40
41–42
43–44
45–46
47–48
49
50
51–52
53–54
70
PKCNTS
CNTENG
PKLOLM
PKHILM
LOAVE
HIAVE
PKABUN
PEKMDA
MPLOLM
MPHILM
UFSLOP
PKCONC
Peak Flag 1
Bit Description
0 FW25M/2.2 > 1.2 × FWHM
1 FW10M/1.83 > 1.2 × FWHM
2 Only one entry in library < FWHM
3 Two or more entries in library < FWHM
4 FWHM(actual) not in range, i.e., !(0.8FWHM(calc) <
FWHM(actual) < 1.2FWHM(calc))
5 Peak out of range
6 Net area < 0
7 Centroid is too far from library line
8 HI LO + 0.8 × FWHM
9 Unused
10 Centroid not found
11 Beta peak (obsolete)
12 FW25M/2.2 < 0.8 × FWHM
13 Result of deconvolution
14 Error > Sensitivity for first in-range peak
Peak Flag 2
Bit Description
0–5 unused
6 Used in abundance calculation
7 First in-range peak rejected for any reason
8 Error > Sensitivity for peak itself
9 Peak grossly out of shape
10 Unused
11 PBC peak
Number of uncorrected counts in peak
Pointer to next higher present peak
Number peaks in multiplet region
Centroid in energy
Peak low limit
Peak high limit
Average background below peak
Average background above peak
Isotopic abundance based on this peak only
MDA based on this peak only
Multiplet low limit
Multiplet high limit
Average background slope above peak (SlopeAbove)
(PKCONC)
4. ANALYSIS FILES
55
56
57–62
63
64
FLAG3
BKCOEF
Peak Flag 3
Bit Description
0–3 Unused
4 Can use this line to calculate peak contribution
5 Subtract peak contribution from this line
6 unused
7 Use this line to calculate average activity
8 Background peak — no activity calculations
9 Peak used in fraction limit test, but not for Average
Activity
10 Peak used in fraction limit test, and, if matched, for
Activity
11 If nuclide absent, MDA is calculated for this peak
energy
12 If nuclide absent, LTL is calculated for this peak
energy
13 If nuclide absent, NET is calculated for this peak
energy (and critical level test performed)
14 Reserved
Reserved
Parabolic background coefficients (57,58),(59,60),(61,62)
Width
Library peak pointer
4.17. AlphaVision Output File
AlphaVision stores the analysis results directly in the database and does not create binary output
files.
71
ORTEC Software File Structure Manual for DOS and Windows Systems
72
5. ASCII FORMAT FILES
5.1. SPE Spectrum Files
The SPE format files are ASCII text files with several fields before and after the spectrum data.
The fields are delimited by fixed keywords beginning with $ in column 1. The spectrum data is
one channel per line. A program can read and use or ignore any fields or keywords not wanted or
recognized. Blank lines are ignored. This format is used by several different groups for data
interchange.
Keyword
$SPEC_ID:
$SPEC_REM:
$DATE_MEA:
$MEAS_TIM:
$DATA:
$ROI:
$ENER_FIT:
$MCA_CAL:
$SHAPE_CAL:
Content
One line of text describing the data
Any number of lines containing remarks about the data
Measurement date in the form mm/dd/yyyy hh:mm:ss
Live time and realtime of the spectrum in integer seconds, separated by
spaces
The first line contains the channel number of the first channel and the
number of channels separated by spaces. The remaining lines contain one
channel each of data.
This group contains the regions of interest marked in the spectrum. The first
line the number of regions, the following lines contain the start and stop
channels for each region.
This contains the energy calibration factors (a + b * chn) as two real
numbers, separated by spaces.
This contains the number of energy calibration factors on the first line, then
the factors on the second line as two numbers, separated by spaces.
This contains the number of FWHM calibration factors on the first line,
then the factors on the second line as two numbers, separated by spaces.
5.2. IEEE Spectrum Format
The IEEE spectrum file consists of a variable number of ASCII lines. Each line is 70 characters
long. Each line starts with a 4 character prefix of A004. The prefix is followed by 64 characters of
data. All lines end with carriage return and line feed characters. All unused characters in a line are
ASCII spaces. The contents of the lines are defined as follows:
Line
1
2
3
4
Contents
System identification, sub-system identification, analog-to-digital-converter
number, segment number, digital offset
Live time, real time, number of channels
Acquisition start time, sample collection time
Energy calibration coefficients
73
ORTEC Software File Structure Manual for DOS and Windows Systems
5
6
7
8
9
10
11–22
23–34
35–46
47–58
59
74
Peak full-width-half-maximum (FWHM) calibration coefficients
Sample description — 1
Sample description — 2
Sample description — 3
SAMPLE DESCRIption — 4
Spare
Energy and channel pairs
Energy and resolution pairs
Energy and efficiency pairs
User defined
Spectral data continues to the end
6. LIBRARY FILES
6.1. Library Files (Germanium)
The germanium library files are created and maintained by the ULI program (A30), the
GammaVision program (A66) or the NuclideNavigator programs (B53, C53) and contain the
nuclide information needed by the analysis program to analyze germanium spectra. The library file
has a header record, nuclide records, and peak records. All types have 64-word records. The
extension should be .LIB.
6.1.1. Header Record
Record 1
Word
Number
1
2
3
4
5
6
7–8
9
10
11
12
13
14
15
16
17
18
19
20
21
Local
Name
LIBID
LIBID2
RECLEN
RECTOT
TYPREC
ISOMAX
ISOLEN
ISOSTR
ISOEND
ISOFRE
ISOBAS
PKMAX
PKLEN
PKSTR
PKEND
PKFRE
Type
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Must be 4
Each bit represented below:
Description
Bit
Bits 0–13 Reserved
Bit 14
Sorted library flag
Bit 15
Library corrupt flag
Must be 64
Number of absolute records in the file
Must be 2
Pointer to library type name
Unused
Number of nuclide records allocated
Must be 21
Start of used nuclide records
End of used nuclide records
Start of free nuclide records
Must be 1
Must be 1
First 64-word record with nuclide records
Number of peak records allocated
Must be 16
Start of used peak records
End of used peak records
Start of free peak records
75
ORTEC Software File Structure Manual for DOS and Windows Systems
22
23
24
25–32
33
43
52
53
54–64
PKBAS
I*2
I*2
I*2
C*1
NUCUSE
PKUSE
C*1
I*2
I*2
Must be 2
Must be 0
First 64-word record with peak records
Reserved
Creation date and time as 18 ASCII characters.
The * character should be ignored if it is not a
"1". If it is a "1", it indicates the data is after
the year 2000.
Last edit date and time as 18 ASCII characters
Number of used nuclide records
Number of used peak records
Reserved
6.1.2. Nuclide Records
The nuclide records are each 21 words long. Three of these records are stored on each 64-word
record with one word at the end of each 64-word record left unused. Nuclide records are always
referred to by a number which is the ordinal number of the record counting from the start of the
nuclide records (not a number of a 64-word record).
Word
Number
1
5
7
9
10
11
12
76
Local
Name
NAME
HAFLIF
UNCERT
UNI
ISONUM
Type
C*1
R*4
R*4
I*2
I*2
I*2
Use
Nuclide name as 8 ASCII characters
Half-life
Gammas per disintegration uncertainty
Half-life units (S = 1, M = 2, H = 3, D = 4, or
Y = 5)
Position in the nuclide chain
Isotope type
Nuclide flags
Description
Bit
Bit 0
Thermal neutron activiation
Bit 1
Fast neutron activation
Bit 2
Fission product
Bit 3
Naturally occurring isotope
Bit 4
Photon reaction
Bit 5
Charged particle reaction
Bit 6
No MDA calculation
Bit 7
Activity not in total
6. LIBRARY FILES
13–16
17
18
19
20
21
I*2
I*2
I*2
I*2
Reserved
Pointer to this record
Reserved
Pointer to first peak for this nuclide
Back pointer in nuclide chain
Fore pointer in nuclide chain
6.1.3. Peak Records
The peak records are each 16 words long. Four of these records are stored on each 64-word
record. Peak records are always referred to by a number which is the ordinal number of the record
counting from the start of the peak records (not a number of a 64-word record).
Word
Number
1
3
5
6–8
9
10
11–12
13
14
15
16
Local
Name
KEV
GAMPRD
PKNUM
Type
R*4
R*4
I*2
I*2
I*2
I*2
I*2
I*2
I*2
Use
Energy in keV
Gammas per disintegration
Peak flags
Description
Bit
Bit 0
Gamma ray
Bit 1
X-ray
Bit 2
Positron decay
Bit 3
Single escape
Bit 4
Double escape
Bit 5
Key line
Bit 6
Not in average
Unused
Position in the sorted peak chain
Pointer to the nuclide record
Reserved
Back pointer in the sorted peak chain
Fore pointer in the sorted peak chain
Back pointer in the nuclide chain
Fore pointer in the nuclide chain
6.2. PBC Files (Germanium)
The peak background correction (.PBC) files are created and maintained by the GammaVision
program (A66) and contain the nuclide information needed by the analysis program to correct for
isotopes in the background spectrum. The .PBC file has a header record, nuclide records, and peak
records. All types have 64-word records. The extension should be .PBC.
77
ORTEC Software File Structure Manual for DOS and Windows Systems
6.2.1. Header Record
Record 1
Word
Number
1
2
Local
Name
LIBID
LIBID2
3
4
5
6
7–8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25–32
33
RECLEN
RECTOT
43
78
TYPREC
ISOMAX
ISOLEN
ISOSTR
ISOEND
ISOFRE
ISOBAS
PKMAX
PKLEN
PKSTR
PKEND
PKFRE
PKBAS
Type
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
I*2
C*1
C*1
Use
Must be 16
Each bit represented below:
Description
Bit
Bits 0–13 Reserved
Bit 14
Sorted file flag
Bit 15
File corrupt flag
Must be 64
Number of absolute records in the file
Must be 2
Pointer to file type name
Unused
Number of nuclide records allocated
Must be 21
Start of used nuclide records
End of used nuclide records
Start of free nuclide records
Must be 1
Must be 1
First 64-word record with nuclide records
Number of peak records allocated
Must be 16
Start of used peak records
End of used peak records
Start of free peak records
Must be 2
Must be 0
First 64-word record with peak records
Reserved
Creation date and time as 18 ASCII characters.
The * character should be ignored if it is not a
"1". If it is a "1", it indicates the data is after
the year 2000.
Last edit date and time as 18 ASCII characters
6. LIBRARY FILES
52
53
54–64
NUCUSE
PKUSE
I*2
I*2
Number of used nuclide records
Number of used peak records
Reserved
6.2.2. Nuclide Records
The nuclide records are each 21 words long. Three of these records are stored on each 64-word
record with one word at the end of each 64-word record left unused. Nuclide records are always
referred to by a number which is the ordinal number of the record counting from the start of the
nuclide records (not a number of a 64-word record).
Word
Number
1
5–9
10
11–16
17
18
19
20
21
Local
Name
NAME
Type
C*1
ISONUM
I*2
I*2
I*2
I*2
I*2
Use
Nuclide name as 8 ASCII characters
Reserved
Position in the nuclide chain
Reserved
Pointer to this record
Reserved
Pointer to first peak for this nuclide
Back pointer in nuclide chain
Fore pointer in nuclide chain
6.2.3. Peak Records
The peak records are each 16 words long. Four of these records are stored on each 64-word
record. Peak records are always referred to by a number which is the ordinal number of the record
counting from the start of the peak records (not a number of a 64-word record).
Word
Number
1
3
5–7
9
10
11–12
13
14
15
16
Local
Name
PBCKEV
PBCVAL
PKNUM
Type
R*4
R*4
I*2
I*2
I*2
I*2
I*2
I*2
Use
Peak energy in keV
Background peak in counts per second
Unused
Position in the sorted peak chain
Pointer to the nuclide record
Reserved
Back pointer in the sorted peak chain
Fore pointer in the sorted peak chain
Back pointer in the nuclide chain
Fore pointer in the nuclide chain
79
ORTEC Software File Structure Manual for DOS and Windows Systems
6.3. Library Files in NuclideNavigator
The NuclideNavigator database library files are created and maintained by the NuclideNavigator
programs (B53, C53). These files are in Microsoft Access® format. Access can be used to view
these files and their structure. NuclideNavigator can also produce GammaVision format libraries
as described above.
6.4. Library Files in AlphaVision
AlphaVision (A36-B32) will read NuclideNavigator libraries and convert them to the following
format used internally.
Word
Number
0
1
2
3
4
5–14
15–24
Use
AlphaVision ID, must be Ox53495641
Length of each library nuclide field
Number of nuclides (records) in library
Starting record number
Starting peak number
Creation date/time
Last modification date/time
6.4.1. Nuclide Records
The nuclide records follow directly after the library header record. The number of records is
word 2 of the header.
Word
Number
0
1–4
5–6
7
8–9
10–11
12
80
Use
Alpha library entry ID, must be ox53495641
Nuclide name
Half-life
Half-life units
1
seconds
2
minutes
3
hours
4
days
5
years
First peak — energy value
First peak — branching ratio
First peak — low-channel ROI value
6. LIBRARY FILES
13
14
15
16–17
18–19
20
21
22
23
24–25
26–27
28
29
30
31
32–33
34–35
36
37
38
39
40
41
42–45
46–47
48–49
50–51
52
53–64
First peak — high-channel ROI value
First peak — starting record number
First peak — starting peak number
Second peak — energy value
Second peak — branching ratio
Second peak — low-channel ROI value
Second peak — high-channel ROI value
Second peak — starting record number
Second peak — starting peak number
Third peak — energy value
Third peak — branching ratio
Third peak — low-channel ROI value
Third peak — high-channel ROI value
Third peak — starting record number
Third peak — starting peak number
Fourth peak — energy value
Fourth peak — branching ratio
Fourth peak — low-channel ROI value
Fourth peak — high-channel ROI value
Fourth peak — starting record number
Fourth peak — starting peak number
Low-channel tracer ROI value
High-channel tracer ROI value
Contaminant name
Contaminant percent
Unused
Expected DPM (used in efficiency calibration)
Expected CHN (used in energy calibration)
Reserved
81
ORTEC Software File Structure Manual for DOS and Windows Systems
82
7. DOS SYSTEM FILES
This section describes the files that are used by the system to pass information among programs or
to define the hardware system. These are used in DOS, but are not used in the Windows programs.
7.1. Sequence Number File
This file is created by the program SEQNUM (A18) and is always put in directory MCA. It
consists of one 64-word direct access record. The values are used to store the spectrum sequence
number that is added to the .SPC file by CONVERT (A18) or used to generate the default
filename in STORE (A18).
The contents are:
Word
Number
1
2
3
4
.
.
.
.
64
Use
Sequence number for MCA #1 Segment 1
Sequence number for MCA #1 Segment 2
Sequence number for MCA #1 Segment 3
Sequence number for MCA #1 Segment 4
.
.
.
.
Sequence number for MCA #4 Segment 16
7.2. Configuration File
The configuration file is created by the program SETUP (A18) and contains the information about
the number of MCAs on the system and the number of segments within those MCAs. The
configuration of a system may contain up to 16 MCAs, each having up to 16 segments. The
configuration file is always named \MCA\CONFIG.DAT. Each record is 256 bytes long.
Record 1
Word
Number
1
2
3–64
Use
Must be 16
Number of MCAs defined
Unused
83
ORTEC Software File Structure Manual for DOS and Windows Systems
7.2.1. Configuration Records
There is one configuration record for each MCA in the system. The MCA number (as seen by the
operator) is one less than the record number of the corresponding configuration record. The
contents are:
Word
Number
1
2
3
5
6
7
8
9
10
12
13
14
15
17
18
.
.
.
84
85
87
88
89
90
Type
I*2
I*2
C*1
I*2
I*2
I*2
I*2
I*2
I*2
I*2
.
.
.
I*2
I*2
I*2
C*1
Use
Total number of channels in MCA
Number of Segments in MCA
MCA device name as 4 ASCII characters
MCA unit number (0 or 1)
MCA type
Multiplexer address (0 for none)
Reserved
Reserved
Reserved
Start channel number for Segment 1
Number of channels in Segment 1
Reserved
Reserved
Start channel number for Segment 2
Number of channels in Segment 2
.
.
.
Reserved
Start channel number of Segment 16
Number of channels in Segment 16
Reserved
MCA description as 64 ASCII characters
7.3. Report File
The report file is created by the program RPT to hold the analysis output report. The extension
should be .RPT. This file is a formatted, sequential file of variable length records (i.e., it has
interrecord deliminators). The DOS commands TYPE or PRINT may be used to read this file.
84
8. TABLE FILES
8.1. Header Record
These files are mainly used in the DOS programs. Newer formats have been adopted for the
Windows programs.
A table file can be created by the programs PBCTABLE or MPCTABLE and contains a table of
REAL*4 values associated with a list of nuclides. The table may contain up to four columns of
values for each nuclide and it may have up to 300 rows of nuclides and values. A table file has
12-word records with the first five records containing the header information and the rest of the
records containing one row each (nuclide name and four values). The following list describes a
table file.
Record 1
Word
Number
1
2
3
4
5–12
Use
Must be 64
Reserved
Number of columns in table
Number of rows in table
Reserved
8.2. Title Records
These are Records 2 through 5 and are the titles for Columns 1 through 4, respectively. Title
records for unused columns are undefined. They are:
Word
Number
1
6
Use
Column title as 12 ASCII characters
Column units as 12 ASCII characters
8.3. Nuclide Records
There is one nuclide record for each nuclide defined above. Column values for undefined columns
are undefined.
85
ORTEC Software File Structure Manual for DOS and Windows Systems
Word
Number
1
5
7
9
11
Type
C*1
R*4
R*4
R*4
R*4
Use
Nuclide name as 8 ASCII characters
Column #1 value
Column #2 value
Column #3 value
Column #4 value
8.3.1. PBC Type
Record 1
Word
Number
1
2
3
4
5–12
Use
Must be 64
Reserved
Number of columns in table
Number of rows in table
Reserved
For .PBC files the nuclide records are:
Word
Number
1
5
7
9
11
86
Type
C*1
R*4
R*4
R*4
R*4
Use
Nuclide name as 8 ASCII characters
PBC value
Unused
Unused
Unused
">