path: root/vendor/cfitsio/cfitsio.ps

%!PS-Adobe-2.0
%%Creator: dvips(k) 5.96.1 Copyright 2007 Radical Eye Software
%%Title: cfitsio.dvi
%%CreationDate: Wed Jul 18 13:51:13 2012
%%Pages: 188
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
%%DocumentFonts: CMBX12 CMR12 CMR10 CMBX10 CMSL10 CMTT10 CMSY10 CMMI10
%%+ CMTI10
%%DocumentPaperSizes: Letter
%%EndComments
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -o cfitsio.ps cfitsio.dvi
%DVIPSParameters: dpi=600
%DVIPSSource:  TeX output 2012.07.18:1350
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72
mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0
0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{
landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize
mul 0}ifelse TR}if Resolution VResolution vsize -72 div 1 add mul TR[
matrix currentmatrix{A A round sub abs 0.00001 lt{round}if}forall round
exch round exch]setmatrix}N/@landscape{/isls true N}B/@manualfeed{
statusdict/manualfeed true put}B/@copies{/#copies X}B/FMat[1 0 0 -1 0 0]
N/FBB[0 0 0 0]N/nn 0 N/IEn 0 N/ctr 0 N/df-tail{/nn 8 dict N nn begin
/FontType 3 N/FontMatrix fntrx N/FontBBox FBB N string/base X array
/BitMaps X/BuildChar{CharBuilder}N/Encoding IEn N end A{/foo setfont}2
array copy cvx N load 0 nn put/ctr 0 N[}B/sf 0 N/df{/sf 1 N/fntrx FMat N
df-tail}B/dfs{div/sf X/fntrx[sf 0 0 sf neg 0 0]N df-tail}B/E{pop nn A
definefont setfont}B/Cw{Cd A length 5 sub get}B/Ch{Cd A length 4 sub get
}B/Cx{128 Cd A length 3 sub get sub}B/Cy{Cd A length 2 sub get 127 sub}
B/Cdx{Cd A length 1 sub get}B/Ci{Cd A type/stringtype ne{ctr get/ctr ctr
1 add N}if}B/CharBuilder{save 3 1 roll S A/base get 2 index get S
/BitMaps get S get/Cd X pop/ctr 0 N Cdx 0 Cx Cy Ch sub Cx Cw add Cy
setcachedevice Cw Ch true[1 0 0 -1 -.1 Cx sub Cy .1 sub]{Ci}imagemask
restore}B/D{/cc X A type/stringtype ne{]}if nn/base get cc ctr put nn
/BitMaps get S ctr S sf 1 ne{A A length 1 sub A 2 index S get sf div put
}if put/ctr ctr 1 add N}B/I{cc 1 add D}B/bop{userdict/bop-hook known{
bop-hook}if/SI save N @rigin 0 0 moveto/V matrix currentmatrix A 1 get A
mul exch 0 get A mul add .99 lt{/QV}{/RV}ifelse load def pop pop}N/eop{
SI restore userdict/eop-hook known{eop-hook}if showpage}N/@start{
userdict/start-hook known{start-hook}if pop/VResolution X/Resolution X
1000 div/DVImag X/IEn 256 array N 2 string 0 1 255{IEn S A 360 add 36 4
index cvrs cvn put}for pop 65781.76 div/vsize X 65781.76 div/hsize X}N
/p{show}N/RMat[1 0 0 -1 0 0]N/BDot 260 string N/Rx 0 N/Ry 0 N/V{}B/RV/v{
/Ry X/Rx X V}B statusdict begin/product where{pop false[(Display)(NeXT)
(LaserWriter 16/600)]{A length product length le{A length product exch 0
exch getinterval eq{pop true exit}if}{pop}ifelse}forall}{false}ifelse
end{{gsave TR -.1 .1 TR 1 1 scale Rx Ry false RMat{BDot}imagemask
grestore}}{{gsave TR -.1 .1 TR Rx Ry scale 1 1 false RMat{BDot}
imagemask grestore}}ifelse B/QV{gsave newpath transform round exch round
exch itransform moveto Rx 0 rlineto 0 Ry neg rlineto Rx neg 0 rlineto
fill grestore}B/a{moveto}B/delta 0 N/tail{A/delta X 0 rmoveto}B/M{S p
delta add tail}B/b{S p tail}B/c{-4 M}B/d{-3 M}B/e{-2 M}B/f{-1 M}B/g{0 M}
B/h{1 M}B/i{2 M}B/j{3 M}B/k{4 M}B/w{0 rmoveto}B/l{p -4 w}B/m{p -3 w}B/n{
p -2 w}B/o{p -1 w}B/q{p 1 w}B/r{p 2 w}B/s{p 3 w}B/t{p 4 w}B/x{0 S
rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end

%%EndProcSet
%%BeginProcSet: texps.pro 0 0
%!
TeXDict begin/rf{findfont dup length 1 add dict begin{1 index/FID ne 2
index/UniqueID ne and{def}{pop pop}ifelse}forall[1 index 0 6 -1 roll
exec 0 exch 5 -1 roll VResolution Resolution div mul neg 0 0]FontType 0
ne{/Metrics exch def dict begin Encoding{exch dup type/integertype ne{
pop pop 1 sub dup 0 le{pop}{[}ifelse}{FontMatrix 0 get div Metrics 0 get
div def}ifelse}forall Metrics/Metrics currentdict end def}{{1 index type
/nametype eq{exit}if exch pop}loop}ifelse[2 index currentdict end
definefont 3 -1 roll makefont/setfont cvx]cvx def}def/ObliqueSlant{dup
sin S cos div neg}B/SlantFont{4 index mul add}def/ExtendFont{3 -1 roll
mul exch}def/ReEncodeFont{CharStrings rcheck{/Encoding false def dup[
exch{dup CharStrings exch known not{pop/.notdef/Encoding true def}if}
forall Encoding{]exch pop}{cleartomark}ifelse}if/Encoding exch def}def
end

%%EndProcSet
%%BeginFont: CMTI10
%!PS-AdobeFont-1.1: CMTI10 1.00B
%%CreationDate: 1992 Feb 19 19:56:16
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.00B) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMTI10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle -14.04 def
/isFixedPitch false def
end readonly def
/FontName /CMTI10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 68 /D put
dup 72 /H put
dup 85 /U put
dup 97 /a put
dup 98 /b put
dup 101 /e put
dup 103 /g put
dup 105 /i put
dup 108 /l put
dup 109 /m put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 114 /r put
dup 115 /s put
dup 116 /t put
dup 117 /u put
readonly def
/FontBBox{-163 -250 1146 969}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA0529731C99A784CCBE85B4993B2EEBDE
3B12D472B7CF54651EF21185116A69AB1096ED4BAD2F646635E019B6417CC77B
532F85D811C70D1429A19A5307EF63EB5C5E02C89FC6C20F6D9D89E7D91FE470
B72BEFDA23F5DF76BE05AF4CE93137A219ED8A04A9D7D6FDF37E6B7FCDE0D90B
986423E5960A5D9FBB4C956556E8DF90CBFAEC476FA36FD9A5C8175C9AF513FE
D919C2DDD26BDC0D99398B9F4D03D5993DFC0930297866E1CD0A319B6B1FD958
9E3948FFB0B4E70F212EC976D65099D84E0D37A7A771C3101D6AD26A0513378F
21EC3643079EECE0C9AB54B4772E5DCA82D0D4ACC7F42FB493AA04A3BF4A1BD6
06ECE186315DBE9CFDCB1A0303E8D3E83027CD3AFA8F0BD466A8E8CA0E7164CF
55B332FAD43482748DD4A1CB3F40CB1F5E67192B8216A0D8FE30F9F05BF016F5
B5CC130A4B0796EE065495422FBA55BEE9BFD99D04464D987AC4D237C208FA86
0B112E55CE7B3782A34BC22E3DE31755D9AFF19E490C8E43B85E17ECE87FA8B9
1485831624D24F37C39BF9972D74E6EC4784727AC00B9C4A3AD3DA1C22BD6961
7E0ADAF55422F22ACA5E4DCD4DF9FCD187A566B7FB661D0530454D0DD6C6C50A
7A3875C6CBF8EC7769F32A1F3F7FC1C072BADEC97794D4E90E0035282A170402
356E5A9CD9ABD80AC4342A5283E458A7269252F4541CBB6452B39ED54D336D0B
19928E9CD1AB26AD83EB209E2EC75011A2643813053B5DBB0246097C4821B5F2
C92554E9140BE35B2DBFCD98809A8EC9FC910FDE9E0D86457C70ACB056EBF90F
244DC0A5BBD455E15D6E3180311D52CF50B0BF7D0A7F64F3A1821E0AEDBC2E7B
AEB549FE1D51088C153799C6E089B5D5D65E1C4E2D2B430CDF1FFA23CCB25D95
5C43C8942435D0AAA3D9055FF808F2C3C887A3C469BBD98F026D0A59E26BA9F9
C2144CFE49A9AD892D4D31764F0AE3A10644AE3966B0A790684B14D11FA49785
EC5565D2B2E584CBFD85125F3FAC133338DE35361943DCE9AF05FCF2840CE512
998D42CBEC52B57B79DD63F00985881E8463396ADA47189A94DDF951A78866F0
B8A3D9197E39335277EF2294308DA70065D910943A34F7D5F2090FB4AA42ED70
CBA469A9F64B95A6FBA4BC89DBC93765E3AE4723162DF3F9D6BDE77DD5870ADE
C8900D6346957B84C3CE88A8F9A12D46B8FCA50DF4433B0B8AED6A63B3DA102B
6DF94E62408E24154BAAC66B2B249C695BC0FA37A28699D9C0F3EE94AA32E3C5
8F8D7F803B5D25014D43A353D719B14B247A87898A960DF68C0C0BAF70C83917
6E9F7B3ACC64DBAEF3FDCD3A80C0AB907EE342E543D607556CBE5A9089B86D1D
E768F27D74A613F3ABF883222A8596B542EBF54E9DCE327B5682AEE5F6BCC38A
2A052EC4018AE3189DC1963BA39ACDED8F0C60C83F8873FBBF0302010956C520
A7F3F8ECD0F177EDF5F4D5522C5984A3678FF32EEEB570B69C142AB89467641F
917155D646DAF3352E27BF2AA0746E062E48532256AF364EFC0F0AAE3766F75C
5219ABA60BDFF177558536E000DE3263A4A6EAAA669F9F4E94BAB336391AF5FB
280A5B39995483E788CE4820EF77AECD73B1AE89DAC3F13E333F2628CDBA431D
2A5E547D4225E6BE13119660BEBC155823A51477647F7E07A23D7D24353F584B
2B311C4529E0E408B4E89A467BC03794CF4E7AA0A717A8247D5B60F438417D01
8155F17E09D4C4FECED18CE574D6849640E5E0592D771F026BCB0CE66FD13BC9
5A89D07EE26021FD5DF14B96AEDC02AEC3E099088C1DAE4FCA2AE841B17F5C4A
D251FB56462CF050AD3CA84DA12DC1D17F80301CCFDE6C35C81FA538A389E0B6
8BFF0DDC4B97D49B485E8C6AF47F951C042D2C750748B4084B3F4AC18488EEC2
900A9672A6CA2B06A0F091E8DD9DFE504A5C6DF1537AE7F54DCFD94EF5CC663A
A80E1C64CF1CD751D28858CDACA6F7CD0463A86619E87B9C03C9448B44537E78
5E60A25045FBDBEE678737FA45F029D92908443C7BB9FC87B7B280C314F39A96
B5287BA21CB3EBCF7816BC0900095F3F9F11D7774BC1D1D4A7F8098C610E3FB2
C2E2E9D9DAAA6CD1EE4F35CE854B7C79DF8318CCC10C52DE36E4AC5D75ED7D8A
DD4E8A3B827DC8A7D437DD38B782929EA60CAC4930F9711087DDC18574B472FA
B40DEFFED99BE0C0CA85E9FA2028152C8B6423CB94E797E3651043BE9636109E
87B70592852FD5198A7D340C0E1C419D0EBAEAF483300E41A6F6B1DFEAB071CD
A4E0A596509369A4EDB66ABC883443FC615AFFA74C672922D263B5F64E861C6D
C44E9C0BBBBA305C9AB04FAEB77E0C25C0D67F77639F6022D028847E796879D2
B6C4AB4313FF3568E407784F1E00503A5875DC68464A720C8E55BCD80269B4DE
B3C05D49DD15B581554B61E9D6313D47C39991582BECB1EF6E959CC64167DA7E
F98EB7F130EE821FF04BB4842D3B8F23E81C4DB8C4B340EC9807DA0CC2627ABE
9F1505EDA580A499BDC35E348CA6A15FB197597A5A3E519DF0B4749D5DC67B8E
2D93EA98498CA6129C0993C0A6945A5137CB4A1B4B38A008B1559D719681E6AC
09FAA1D2337E266FDC02D77AE822DC13724A0620C5ABFDA9402D3DD4DCB80CA5
28F875133862164328A59F7E58E36CA06F23E651D8BBAA490D145F3788A30BA9
C5389826A4B2F17E2B301BE89C464D9888C1E798744E815C44E68B94BABB8FC4
2872E1AFBB63CA489FB1504926C84C5F8AC7E6A93942C3B0C3250EEFAFF70449
3734AA4932BBF7B098C8287D8DD2F0E75F0F7B184BE5A24A6C9EF1C7CE86D58E
1018668396EF8842609FD4C207CF3D818DA21AB4FB96EDEDF11905E15153D319
93EF1A3297FB71AC25E9FEE544D66A2E6D94D147408033B1784D060EA8BD6807
1A2194884CBEFD552D52B7B8B63A2A9A1DE5C4B437262091089497D10E4C1678
52664B16F1FA71371BDF96D038FF88F695A02B7057DB4D97CC9AF8534518BE9E
FCE87619AD6BDAFBE6EE8FDDE427D3CCD32E4143AB09B27F559E7727CEF7F39F
DFB7E07E86E3512757E64C82D0FA29EB1E00E4F213B12679E2307BA8A363BBF6
B3411F4C50A8E51A11D6716CB5431B6B941B5548FCA3C85B3829F7EC05D881DE
4D2E994F6C815589CB4F5188A581FD9BE70E9D01E8F36BFBB5732F89DA7651FE
9F20A732F94035BDAB79728D559647EBC1A386F7BB3489D59BCB048910AB9D2F
38F9B3B9C0648A9AFA41B4089CE3EF93E7E8E5140532EFD745AE3F000502344B
5030FC71BAC616EF9349D5C8B336FA9A3624E1D2DDBE5C596702F778FD9FA98F
5899447510DDCDE2599939667F9831B6D06ED3CE3167D15F9C502EB035A05B86
D4AA82D68A8511BFD3312250273545C5C4355629DFEE31B5A1B078BC2C805305
22A3F4865F9C978C6E71A5F5C858E21CBA36053277190DB9D89A4B985FB916D8
DEC338E997F3226EAFA917AA18C1C9B055BB82DDDD50FFE00B93DA5C9C662760
7326F16E661443A6EDCCC04FF913605AD63E022EB96C7C9A7FA60E185073E163
0A61ADC0E39B114BE69EAA874209C8713E765D017A8D727648B0340295D56C13
34A95D3D2F40CF4CD2BBE527C433E09F00BC1BD5C7425E4DB2A17204F0B8DBA2
82CA3F37C424FC07B69C89635DFB3971894E946D928802471C2B1C40F49701FB
485186D20A803C0BA76DFED4ECB2446FF25258118E593CD1EBC8ACA718B5C9D6
C4F5AC941B28716B10B283FED21A16C94E92C431BFB9C8AC3D3F1EF7DC46ACCC
A82ACCE510A3F687AAEDC6839800F48AC96A5B81A97FE4F37CAA586969AB3D58
001C8134BE160EEEDB79A780D2AA57BEEBD2FBCD9A453066B6642C459A679A84
5E3FB8F50F7C00EFDE6049D2C01893750C5F60F2DC98FC36F2E656774123DFF3
E4EEE44D085083365124889B3103DFA03F5A5648446BDDAC9FA40C69D83D2D4D
0D6017D7D840A4F7CD97EFF126F48B331CAF5DE0856F689FD0FC450005793C8A
74EC6BEF32FF405AA2F4F6ADF624E0C72CEF916ABD6BDB7C0AEECEA855F07AA7
E5BE6F7DCCE459F4F390965C9350A3060825CE22CC25905FEEE40E4973C0189E
5021FF9FC2EAB4301790F255B617638A2C44F4D71A74EE96DA5178A9296D388C
0D43CD188C0F78D9A57D78EBE390A2BCCD0AC3087AF4A1273443795EF08D0F11
ABEA3A173746C05E538D88FBC0A3A1DC82A762F951E63A135F63BC3B7E05B8E6
B89DF17BD32E871FE1C967B5DA4FCB9187747B6A30B551B9C4FE920C34E40A8B
E268ED41382AD1DED7E79D18469F58305CE1275C4AFBE4770BCD87D06D7101F7
5EBF74D9F3AFF9608BE5736BF1B2B33B4B3E3C8CFD3A91CECDFCD7E0A4A586FC
699EE79D7756E49DD686C65451A58BEDCF0FEED1B23EB408845391FEE74A3628
11837485BDE72131D0EF7D0EDA3E23BCEFAFF9DC2616CBC8E52523EA157DF140
9498280EB11F1C42B05BA5281F7ACE1BF40F74F3D5D61A6B852461013F773915
0BA29094461022A1F1AD4B62CD619E6BDE7CA645914ABDFE87758C039B3C3848
04BAF878C215BBC35A1D259B2CC21AA2B7C7B43165398CF37779B31190DC8526
41E02F9361CA8E7750A39478DEAA823069009007B53FCBABBA40A98C90E603F0
C76E3383938422548A9A49CD8D9CABEFEC5D9DB27F60303DE67AAC2E79EBE12E
48A2D6B687A720D73169236DFE597514C656AACF348201B76008714FEB551241
5F2C86E06820109386E5588A7E67651C1EA9422DE9307BEEED35E87B6B61F0DE
3EE5C5B7FD94350FBB081378191539122C6A73939BA7D47AF08E54C5CC4553DA
420E9680BA4B954D9BBE82A8FC559C86861760F9B24103493A26FB55E2DC7880
5ABD36590011431ED606491093B769CA74AA6F8B91076D6D8368BB39D4C7B435
CC461A9E9FBDB28772E51AC2C563DD42C4A87F7A544C8B6D10D5D2504F9A4BBD
D4F1A5A6DF8278AB6F3B10214AD75FEB1B5E32801D2631983E2735BE149FAFA1
560E57087EAEC3E45526DF9C748F42E6540CCB14DE6DD11509F3F1BD6D5B3BFD
3D59D2EDB6235DEEE1A893F522497EC38CEED07774E8B23AFC381D6432B87015
A586224B9EC36C4498624E5CF2E9BE61FBFF52F479F4CD12A717C0FCC19182B5
A5A9F8D415472F4C61E8965AE972EDAC4A17776B6EC1132CE29D6396D2B01B6D
BEBA1ABD3273C62B3475E2DB8B57E61208AC63BFF8CCE2BA085321FE0C9F874C
A645C234812D75E9C5C02D0B0E13D57725D105724BB2C5A916F6E82D57D005F3
9F6B1F041A2B9675AF901B171E6E896F5B8FC545BC88E183AC5E5F1B2288CC5C
7351BAD140CBFA03F2FD18298551BDB15024BCBE844B418B067208EA0A13B731
58747D1B90BB00E37FD7DF9FFAAC80DBDD92E1301DDF1ADE62ACBF169FBFD927
AA84D56E00D02D5B8A34FE3D2B1AAC470336AA02062F42F2C958307142F7C6E7
BD440AC8D8C6A46DFB2B42A32BFA4255A47F3CB3F0733F294EB47AA59DD26A03
C81A4BD18162EFCB77F3BBEC3E8B225E76BA51DE178468B529D146A544180542
6EAE3A451781F5E38DF15BB377C9FE92096E976AFC14DADD11581D29222948F9
FE23D981CEE4E5013025FF3E69E479D32A7A8D25A842FB288A0EC63E23E297E0
168D22FEC35E333A2D67A37A4EED7B59A06F21F44DC6831CAFA473E48A66EDB5
00FEC1D5399A06F51A8A67A6803FE34C1B1F2E4CA8D7EA3CFA8BD046D477777A
D283296A8F181D671CBA5B9793DE178BFAF807A6F71E4FC6D69CE7CFEF11D0B6
F8B23221E627475226706C19EF519D19B80633DDBF4A1AD9E271E547CCC846B3
859CD96E495D12E3D5557A309F12949ACF5F373A29C0FD4A6456C737E6F08BDE
0A0C692D66BCE059ADB9B91F8F81975308ECB3313B34093E06462C9DA76A4BB2
1D8DEB5E4526CF73DA4D9D5CC7148E5FBABDF1D45F024469B6D84BB607BA975F
1F6EE627044A93D108427B6C14528B5C6D1568E65F3450D7F4A37EE34D619138
8B7914C63A362737025C0E57F928AB5741CB79D137249914A3CEEC0DECFF639C
0F6B8125C643EDA71F2945FC7DB555E4ED2896C49E83D4515B0DA9A72764C792
9D6A72F18F15C71BB655DD64E421EFF712865D45D2642C7E63501F3289D589FB
B983626C60523142AFBEADD4019BB3C4D9C6ADD66012D0CA6AAB374FCB7FF77E
89BF30C153007F48E06EE2278BFF6F0C9AD9BCE6AF9A9171A58EA65CBA2A6A82
E35D45980D84DE7D9199344686C8F08090DF43D0051C15C4E19A9D1C76E4686D
7412DAE7F6EF4E86230C43187D1997E98010F6C8E5E8941DC837C6E73E9C0947
AD2B9E8333BE73BF30D56C31E2B76DE3F6C841F42B109270CBE04D10A9D64CE9
0FB722EC4FCC3F1EB7CCAA2C6C6B3D285D786DAC189F440F32057CFC882A6257
3068C55D4470801D8E2D6B5972D30B54C54E
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMMI10
%!PS-AdobeFont-1.1: CMMI10 1.100
%%CreationDate: 1996 Jul 23 07:53:57
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.100) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMMI10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle -14.04 def
/isFixedPitch false def
end readonly def
/FontName /CMMI10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 62 /greater put
readonly def
/FontBBox{-32 -250 1048 750}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA0529731C99A784CCBE85B4993B2EEBDE
3B12D472B7CF54651EF21185116A69AB1096ED4BAD2F646635E019B6417CC77B
532F85D811C70D1429A19A5307EF63EB5C5E02C89FC6C20F6D9D89E7D91FE470
B72BEFDA23F5DF76BE05AF4CE93137A219ED8A04A9D7D6FDF37E6B7FCDE0D90B
986423E5960A5D9FBB4C956556E8DF90CBFAEC476FA36FD9A5C8175C9AF513FE
D919C2DDD26BDC0D99398B9F4D03D5993DFC0930297866E1CD0A319B6B1FD958
9E394A533A081C36D456A09920001A3D2199583EB9B84B4DEE08E3D12939E321
990CD249827D9648574955F61BAAA11263A91B6C3D47A5190165B0C25ABF6D3E
6EC187E4B05182126BB0D0323D943170B795255260F9FD25F2248D04F45DFBFB
DEF7FF8B19BFEF637B210018AE02572B389B3F76282BEB29CC301905D388C721
59616893E774413F48DE0B408BC66DCE3FE17CB9F84D205839D58014D6A88823
D9320AE93AF96D97A02C4D5A2BB2B8C7925C4578003959C46E3CE1A2F0EAC4BF
8B9B325E46435BDE60BC54D72BC8ACB5C0A34413AC87045DC7B84646A324B808
6FD8E34217213E131C3B1510415CE45420688ED9C1D27890EC68BD7C1235FAF9
1DAB3A369DD2FC3BE5CF9655C7B7EDA7361D7E05E5831B6B8E2EEC542A7B38EE
03BE4BAC6079D038ACB3C7C916279764547C2D51976BABA94BA9866D79F13909
95AA39B0F03103A07CBDF441B8C5669F729020AF284B7FF52A29C6255FCAACF1
74109050FBA2602E72593FBCBFC26E726EE4AEF97B7632BC4F5F353B5C67FED2
3EA752A4A57B8F7FEFF1D7341D895F0A3A0BE1D8E3391970457A967EFF84F6D8
47750B1145B8CC5BD96EE7AA99DDC9E06939E383BDA41175233D58AD263EBF19
AFC0E2F840512D321166547B306C592B8A01E1FA2564B9A26DAC14256414E4C8
42616728D918C74D13C349F4186EC7B9708B86467425A6FDB3A396562F7EE4D8
40B43621744CF8A23A6E532649B66C2A0002DD04F8F39618E4F572819DD34837
B5A08E643FDCA1505AF6A1FA3DDFD1FA758013CAED8ACDDBBB334D664DFF5B53
9560176676ABB71BBD0EE56B4CC492C0652750227CEC7B86E4740EB7B8775564
332769DD30794E501BBB0E4E5CB665F3628E10B1137CC8BC5C0A64A310B5E27E
5FD6E3B04DA3914C15987E638A72790AF4073CE9CDBF6E3C749CB4DFF9C54951
A58C386C54BC4E98B102B5E91E8567D2EEEF048F2CBD5D243701D20909290B4B
A3083F632D8552D42DEE0C69A4B14D8B15AA082DECC12B2ECAE6F663E6D09F81
EE2979EF41FBF12C9D8BF23B77E0A20088EBD107C5BF9DD6F03FFC3AB65B69A7
54953327E1D4AEF5A146273392BBDB321D4CC9A8FFFCFE5C515B466E21546CC7
C6209E5A76F916B03DB98BC6CED334F33E7B373D42761696F5A876CA6F93F16E
15A07E2E102148CA4F62A99C
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMSY10
%!PS-AdobeFont-1.1: CMSY10 1.0
%%CreationDate: 1991 Aug 15 07:20:57
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.0) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMSY10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle -14.035 def
/isFixedPitch false def
end readonly def
/FontName /CMSY10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 15 /bullet put
dup 102 /braceleft put
dup 103 /braceright put
dup 106 /bar put
readonly def
/FontBBox{-29 -960 1116 775}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052F09F9C8ADE9D907C058B87E9B6964
7D53359E51216774A4EAA1E2B58EC3176BD1184A633B951372B4198D4E8C5EF4
A213ACB58AA0A658908035BF2ED8531779838A960DFE2B27EA49C37156989C85
E21B3ABF72E39A89232CD9F4237FC80C9E64E8425AA3BEF7DED60B122A52922A
221A37D9A807DD01161779DDE7D31FF2B87F97C73D63EECDDA4C49501773468A
27D1663E0B62F461F6E40A5D6676D1D12B51E641C1D4E8E2771864FC104F8CBF
5B78EC1D88228725F1C453A678F58A7E1B7BD7CA700717D288EB8DA1F57C4F09
0ABF1D42C5DDD0C384C7E22F8F8047BE1D4C1CC8E33368FB1AC82B4E96146730
DE3302B2E6B819CB6AE455B1AF3187FFE8071AA57EF8A6616B9CB7941D44EC7A
71A7BB3DF755178D7D2E4BB69859EFA4BBC30BD6BB1531133FD4D9438FF99F09
4ECC068A324D75B5F696B8688EEB2F17E5ED34CCD6D047A4E3806D000C199D7C
515DB70A8D4F6146FE068DC1E5DE8BC57030ACE57A0A31C99BEDB251A0ECAD78
253AB321023D15FF7F55A3CE81514C1E7E76240C1FB36CD4874DDB761CC325F5
D588700B294849D690F93526EF438A42B9B5B0508584EA3766D35F5B8D51C458
ECB9FBD23A49576EAB06BACB7EA6D300985500835F4FE597D4A1110C8EABE6FC
CE3E1F95CFD3A42446F25355381D476B2FFB6EF247BF58A6FFC5EC0E4CC207BE
46485F8E07350B37DCA8C1864E62614332A1D3C9DEDDD6492181949A2C3498C9
EC2A81C1F4FF989A4654E375F509D24D969B97D2A9940FAF43BBB286E08559C0
F8D9674B0A294B36D3A050F7DED8C80E1D230812F6B8387B17948FD29FF050E2
AAC5EBE5D96AFD0879534E2F4BB81613A1571750F9CF4215199F93813D815B5D
1C79E11A0FCBB627CDE569F88C741CD502627777BB058ECAC09B6ACCFACA69B9
8F8168B0B5A1A6EB13E884B348FBB2ACF9EB180F6E27D57F8503710CE037A34A
F8B157201657C825E2A4B4A7696B58B7A988C05E43E66F0FF277A7694C555C54
AFB1D32F6DE102136FC810E1F3B5CEA42476EAC7AAFB390E3252B2169DCDEE6E
328507BD0E24734A85AAA263E0D2F64BE1607455BC855785BC27F8B30FE917B4
23AB3C812975355942E955501AF85A3C0CE836911AF679EA44AD6A7D042A6549
0C471FE294E8490024D93ADCADED460FAB7FBCDC29EFEBD2A9A127E11869E659
961B29206CE63944B6FA4B9315BCC528EB1E0223CE94C795A5D5231A7FC8545D
6B287B965F8EEDDB67A6774129DD01D5A21694ABE320BB2553043D4C42ACFF91
1009372CB03381035BEEEEFD05631E026A0980A72A67B3703323A4E7C94FFCEE
8D0B7407F9CCC043D3D184BEA4728385D6AB2FB0641DD8F5BA7E04035D30D628
7E97D31C1486DFD5B1D076B84B4ABA4829ED4310321F1F24B847C44E00185A69
37711A
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMBX12
%!PS-AdobeFont-1.1: CMBX12 1.0
%%CreationDate: 1991 Aug 20 16:34:54
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.0) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMBX12) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Bold) readonly def
/ItalicAngle 0 def
/isFixedPitch false def
end readonly def
/FontName /CMBX12 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 11 /ff put
dup 12 /fi put
dup 39 /quoteright put
dup 40 /parenleft put
dup 41 /parenright put
dup 45 /hyphen put
dup 46 /period put
dup 47 /slash put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 52 /four put
dup 53 /five put
dup 54 /six put
dup 55 /seven put
dup 56 /eight put
dup 57 /nine put
dup 58 /colon put
dup 65 /A put
dup 66 /B put
dup 67 /C put
dup 68 /D put
dup 69 /E put
dup 70 /F put
dup 71 /G put
dup 72 /H put
dup 73 /I put
dup 75 /K put
dup 76 /L put
dup 77 /M put
dup 78 /N put
dup 79 /O put
dup 80 /P put
dup 82 /R put
dup 83 /S put
dup 84 /T put
dup 85 /U put
dup 86 /V put
dup 87 /W put
dup 97 /a put
dup 98 /b put
dup 99 /c put
dup 100 /d put
dup 101 /e put
dup 102 /f put
dup 103 /g put
dup 104 /h put
dup 105 /i put
dup 107 /k put
dup 108 /l put
dup 109 /m put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 113 /q put
dup 114 /r put
dup 115 /s put
dup 116 /t put
dup 117 /u put
dup 118 /v put
dup 119 /w put
dup 120 /x put
dup 121 /y put
dup 122 /z put
readonly def
/FontBBox{-53 -251 1139 750}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052A014267B7904EB3C0D3BD0B83D891
016CA6CA4B712ADEB258FAAB9A130EE605E61F77FC1B738ABC7C51CD46EF8171
9098D5FEE67660E69A7AB91B58F29A4D79E57022F783EB0FBBB6D4F4EC35014F
D2DECBA99459A4C59DF0C6EBA150284454E707DC2100C15B76B4C19B84363758
469A6C558785B226332152109871A9883487DD7710949204DDCF837E6A8708B8
2BDBF16FBC7512FAA308A093FE5F0364CD5660F74BEE96790DE35AFA90CCF712
B1805DA88AE375A04D99598EADFC625BDC1F9C315B6CF28C9BD427F32C745C99
AEBE70DAAED49EA45AF94F081934AA47894A370D698ABABDA4215500B190AF26
7FCFB7DDA2BC68605A4EF61ECCA3D61C684B47FFB5887A3BEDE0B4D30E8EBABF
20980C23312618EB0EAF289B2924FF4A334B85D98FD68545FDADB47F991E7390
B10EE86A46A5AF8866C010225024D5E5862D49DEB5D8ECCB95D94283C50A363D
68A49071445610F03CE3600945118A6BC0B3AA4593104E727261C68C4A47F809
D77E4CF27B3681F6B6F3AC498E45361BF9E01FAF5527F5E3CC790D3084674B3E
26296F3E03321B5C555D2458578A89E72D3166A3C5D740B3ABB127CF420C316D
F957873DA04CF0DB25A73574A4DE2E4F2D5D4E8E0B430654CF7F341A1BDB3E26
77C194764EAD58C585F49EF10843FE020F9FDFD9008D660DE50B9BD7A2A87299
BC319E66D781101BB956E30643A19B93C8967E1AE4719F300BFE5866F0D6DA5E
C55E171A24D3B707EFA325D47F473764E99BC8B1108D815CF2ACADFA6C4663E8
30855D673CE98AB78F5F829F7FA226AB57F07B3E7D4E7CE30ED3B7EB0D3035C5
148DA8D9FA34483414FDA8E3DC9E6C479E3EEE9A11A0547FC9085FA4631AD19C
E936E0598E3197207FA7BB6E55CFD5EF72AEC12D9A9675241C7A71316B2E148D
E2A1732B3627109EA446CB320EBBE2E78281CDF0890E2E72B6711335857F1E23
337C75E729701E93D5BEC0630CDC7F4E957233EC09F917E5CA703C7E93841598
0E73843FC6619DE017C8473A6D1B2BE5142DEBA285B98FA1CC5E64D2ADB981E6
472971848451A245DDF6AA3B8225E9AC8E4630B0FF32D679EC27ACAD85C6394E
A6F71023B660EE883D8B676837E9EBA4E42BA8F365433A900F1DC3A9F0E88A26
30F7B5CE2041568C18D8F66D36C31B003C916EC14620F67D695D846F2EF97CB8
0D569CB47D8939FE3C0009749B48D0D9856FA050F2D1BEBE2DD68DDBFEAFC2ED
7A7BA881DF4859A0F43EF10EF5DC41B5E82C630F2E3E435E37DCD10B63D3C96A
38C0C5AAE886D864E24FDD862D6957C084CC4A39623629F00DA0F035DACFEF70
4D8DF7C197095975D874B919691A7E03C56534645AB63E6B829038B435E1D2AC
2ACA8A5E4C2DBD300F7C786A9C196539C8BE8A6FFCC109193E97455DBB0B9E55
941992A110EA4BC1B01B59EA538E6AE0749C24D452C351F13B1F64EF2D199563
F88F92BB8C6C8EF4ADC5ECDA3C2BD22CCF84431E43BC5A630332184CE06454E5
0F3A369D5B7B134E0CF54E4804F28162048BA9B8A03FD837E2C37D146EB0F14E
7DD93363EA5C819AC95F2C1501909E9F4B3A09CCF2C609F0A6EE86D340A19408
6F985E999EAE40D936E3B0BF5D646941E5CE26E1AFAE1EF59329EA2E24EDBE17
8B9F15CEC308AB6169A683CB3D56DE572DA21974D80181D7BCC09E8E08FFE441
0F93897DC162D782209CC451E553232680F997451B1CB2D8AA0CBF5DBB7EF923
1C7AA87DDE43C47B188B502C42FD3F47D73811469BC954267ADDAA9CD18D49D3
2FB55FC5555338B4522F0A7309E487DBAE445E3FB3489EF7E396835B3FED2044
5CCCAC17D69B0A1434958B658891E8AB16A992B77357BD4BD58A9251F50AB71C
B930D4652578C79C77D9083C420C895C83660D7FE13611BC7ABE5014C7CB5E37
62E71B7D3E215A8A7E51F9E4F3AAAB983FF93E49CBC1EFBBB2FD7150FA3E4745
5F8FC1DFD4A245586A56DE187584046746119E1F5770D83B0785427BDA36111A
881107BD4CDA253D2972687F010989B6FA7EED5836B377EA92906BFF453EA308
B4BF3287D966E98262724C896177F042966FA9666CD0C628C648AD6D8CBD23B6
6124005200490FB59E771E158055E93489A2D4D2447AF36988086AD21E8737E7
37B21FF521B78B92B5DAB8685B1249B8E82915B06DE48E1979EAEB8E02952345
53EA9181FD43C6F136FEE9286525F50ACC9236F602B542A36B51D511CE03EA9D
7F4E668FE9B7BB18A828DDD511C9AD2AF80B1D2F3D895D262C5FB883B36A4407
671EDDD228337CCE4DEEB68FFF6D46D9C87F577F60445962A97BD61549A5F2B4
F70E95DCCE8DA63DFB836F5A7901110B51B950872C8AFEC0495F51691B13DB31
B84E89B8C7E6D0132A26A348C2804887685803DB72B8C3223AB655830BCBAC24
2A3E989E13C38FD950B03977C2DE7BC27392A24DB30AD71D26E0969AE9D637C4
4247FF262AA189818067A8D3FE7F042E4DC47CF6D21504A9F06E440F79851826
ACDC43F89F482C220786BD85AF276D394B8D523C7675F57BE80E28F29A81EA0C
9875EE70C69D47EAF98963FC3DD370FC270A606BBD9FC16DC1B93B1179D810AC
F634883A2661B3B2DD26E0C24A6D8B3AD223FDC7251296A614D88F8860EE5031
7E5CFCC7233D3397830A27DE6E5306EB074FA6698087E86A8E1F144F43FD3937
0006B492CB5455EBEF58A9AA34FE66F5FF36B04A7CFAFE68F490854E2ED08EC3
1E5DA648A76CF178AFC6C05813E88E1C84D9AF826DC9583A04EFEEBFCC351B65
1C79FF12BD7D2879D8F4521E448757B3B2B9E7265FCD9D57D24A633E04676DAB
AC9B44A4406714856791692D23208139BC39147D57E4B1A9CC0CAFDBE4F2F6F8
87315413CC58B8ADA31B15A17226AE0AC8F047F7C7D9550D820B23994438FACB
CC4C65A302F033D1ABF788848EE63E6DF1590B586DF40050A800AB7E535963A9
18CD7F6DA52414A4EBBEBC24B83F824C0B85C3BD21401722E16307553617B597
0DBDEFE85B9086F522FDA0C43FB27C14CB9621C75D8254B05E24C87D754B347C
C9BEA9F2BCA71B37E3F6A67B0879BD67E8509B5786DBB025AE6159A7CE5143C8
0903EB0D6E6E40C36474093076EA17C554021D4C95A9B1AB6FDC30F5BAB2DC99
CF5699757E036207867F75F7FF2266A806E6581724493EF360694831C58925BB
E271C8202068A9B9EECEFF854DB4D744102A902B913A1770A2A628B9B85048AF
697CB3CBEEF4F8064DC93E093A6D9637179265FD5ACDD5E3A9C406E8BE70F30D
EDAF394FCB91BDA810D1C5E4B472F60E900DFEB45AAF82983A714E860548B737
BBE318EEBEE76B2063CEF47D7FA895A0237BA314DBF4E3A589B0DA21BD79F475
52E5F674985E38B21D07175B9CADCD3B5FF64E5A4ABC1D21D9E50B6C33A1828A
05E23D11398E7B56C1F8C5636575AB08CAD336F2DC2F9418BB0FBCC0166C5D85
FC062E82DC0E55C41C6C682ED75A78195C6FB552B19637B53467429726264132
943CA57A8C30D1E31A67387B679827443A52C4557DB9DD719D9FEC539CA09D07
47495060C8BFF195E7770D0B2F4DA353D7E755C853A7B9E9DDE5AED20A7DBECE
8569A8D9E5AF4D15388D65A10D055DE7EBC2E295073A86D082C2FFB2CCA7206A
7577BFD6E506D29F19452C3B2AF45D5531C0E1419B434F30ED32657A9DEE4C73
604C3E5F239137F49958F5CA638964DB763BBDE618818BD4EB23E57F1B250D11
B185093107056D2D4B6D53AD2BA245E121E3E206770CC01D0E07DDB5D00CF858
48F23AD1CCC23C42DD9F25AEDF3029ECFD31821A734F83B7C9F94AF3E6EBDEB5
686B484475F0AA7350856F9BFAFA0EEB9BFFA02E5CD0D8FDD562909539F89BA4
505A45D79CD2E7587EFC5E579EDFAD3661ABA956C7AABC46DED840EE00370EEF
87C3C48F109BF3FE0CCDD17E2B9974F817A08A8BEC4CDDEBC43F32F685F33D20
F3106584C83714D82D494C4721400FB88D7E5FACB331DFAA524553B401184571
E7F2C4F954D586D03F4685CA6ADC774B8E24FFCEF33094842A5F226E7D681B27
330F84BE13747EACEC6CA5D94F7A2C2E9C47EDD05B163A1A25FF78361F3FEB44
20D6BD2DE10AD0F093365AF1C00CC88D15443A21EEAC4EAF1F50D5ACA6ADCD81
D39D91A142999F33FCE4DC572BE9FBEA9F0BFA142976F2BCA7A6897135AC6E7E
D0435DABB724E2193489F87A87D54384B3CBA6395E7DE36AF07DB326C77AC61B
C9CD52C77A5A82A27C19D32D18B6FC17C1E6D38044A9DB4BCEFD8E05C1B5042B
4697173EA5ADCE6780871152B742AA7CEE0220663CC5C3AC3292C660FFF93286
1E50DB297296156955D18DA85931CCC9AB9E0BE2157ADC1343066050C7B735FE
130364B736F6521BC4560D44437C0D45427C207AB54F70E2FB9A0C2EA2436191
0F87B91BD3596F690335206069FA66A6BB08DE89C799966DA5C9857AC2F1339E
E6EFF63FCAF48D50CC130AA95B9B1EDE2DE8E19A98E9A8C93E2EBF60889081E2
5C5D4C9AB8F800A784F1174595874A39239E74F3F5F8816E024F631CAF136E99
39FF5D4F7FB5A4CDE1B57DA67AEABD4A41FFFA0AA4B210351EC5EEC22B857397
9CC04CDAEA7D7FF4BB3C3D771AF80E630D7AB58097BDD1A037E40194452DDCD7
376AE54B39206F76767460B9AD86530743BC63884C46F4577ADC62F19D38232F
1D80EC752DA6B4C8455A26574DF01D2D9686B7E75F19BE1A5A8758AB7B827ACF
0F8D395E6C18A6D591E01863DDB7BB7179FAB3F2C82D24F46151CFB8AE22F53F
4177189C80B26FA893E006321BBC6D9AC9817A1FBE4918F8A1B8658C35AC32D5
335531F4F907143CF7F190991DB7E243F4CE9199E6E46F26F16E00325C395670
330829D5AEDEA76337D4A9AD1C3A30AA28E56B40019C0836B4FC6BC22097FE3E
86175F36C3A5A879B9C700C50FFFFB6B7BE1361211E1D3F3BEB39A2267875463
CDD79C44BEE54CC30F78BD48BC1D2B3C96C6D2D1D2A8484703C4727657E6C544
C27C4ECFCB7090EC465D3E0C34BED015A0B017EA94FE7903C021580B83AA25A8
307E13BE4FE137FD505749F447C2FF77F3039DDDFC476D9553BE3D3884E81C4C
03123E78FFAE5151D3CBB0473CDB4F083AA5FB0B1BA99A3AD5F49AA87B73282B
5084873CA47BAA9D1E0385C9D4EA3498AACECDF6A6A0EC09EE0520C9FDE792C3
07FABCBCEC2B7474A6241099D6362C9436F32FBAF1D6CC11D933D4A64E0CB9E2
0943E082F4335F23E7E2C719ABFB70D7C9F48C6B88E980CA8A980958A308E898
BCC7C4E085167F33BC36349C0CC23B004C805DF196581DB0C551C2B53C82E948
EFFC164541AD80E6014A723760ED548F3FB0C47F4459D855211824B04D28D3DC
18E204F3A43C5F8D489920CAEBE3FB9800061827656FEC3C43BAA4219978FBFF
85507FF60CD5020365D73914861254547B36171070053498052CA13E1CCE5C70
B9ED44737D747DC28DA6FBB7791082C572BF8362C3D3E34FFB285AAFFBC1311B
ADF12AF9444E47D85B0169E851C2C35D8D089A5ACF6A2E9C94085ACDE361FAD2
B54B901EF8ADD09B1835B37CC6A5509872AE193541685EEA1EEA3770A1FD6318
DD7328E8CC51F099858659BFAA708541AB9E21CF1632458164B5E8659F6C23C6
88C0FFE47B820388404D0E9FE6CB06195BF2B2444582D4B7B38F45E18B604639
A0750219065C18492E2CDEF4BF96E2222A5D11DA68C6765565F9DBDED8F95F3E
7F2EB79DCE1C679D0743C5BDB832AD24C9B747AC4FA27D1279419E732DEEB543
BEE45F538A500AE50151C16C81346B88AC63D707E50958536C3CAE834A27E77B
AD95CEBDCE16FAB65DF308A0D34EF798078BF8FB0D03DFC782449C0BEDBC4AD2
5FDDF493FBDA5CA3641F4392487887D324A047904B1E033027143232A40D5014
DE1EB3E58C535A317733EA1D93C33A252CF750A9EEAEDF6313B9CE44373A288C
EA8DF423F248E3DAE7DC96A211659305C9B97946AFDB3ACFA2B79F05CCD03E05
2E372943C4F676BB72472D3EA1B0F566757FC5CFFF8F81F128995EEF12CBA8C3
5C0450BFF4B9C68E93C1638A70509FB6BD34ABFD2C0B7C0A238E98FD8FBEACC1
2539AA00D2B64D7C19AA45C3F1B17B9050546D751B2B346E19DE3359F02F5F1A
893148BA91ED8BD68A0BD5657F0001DB75E71F2A0160A7DDC39C773EBFB10458
A1BA0DA0CF4976AA41063B2FBE875FF0DA96FBAFD6AF0DF9652AA0EEBC1AA768
087B8CDD4883A044694186BBA78043EF79007FFCBCCA9606B0C132BBCF835ED5
2A7F459264147B460E5C9A487911146939166679E6A193A4AC979653DD2B8522
F6EB14CDED27F108C47D32E25D40FCCDA830D38B4AAEC9C6CDB212A1D8012AD8
17BDFEEDEA83194DB3369B8E0FF2BC5BF2FB83EDD20248820FEFB41278A7DC96
D47B40E6EE3F85FF38642B9C52CFA1F85FEF0DE3637BEBB66C1BDB2A8ACACB97
9CDABA4F994E1656812B0321D999339A2384E07D19388ACB8FB4A86FC98A2E73
3809461D8681C619766696A02A9099445CF756A6BD1ED778A4909D36839F7E91
153C0BC25297495E3EC490B189AA7C7B64480362764F6B89753B0EFEF35C86F4
65122B04CB43675EBE03A3026F4212D521AD81FC3E2D3575B1C6BBDF35E54199
0FAA02480892DAE8DEB52A4E1C8E5995A67D2B3652CAFC5FB0BB108A40019896
664ED1974AD21CABA4279BCC7D2E3DBFE7A70087CCBEA75FC65218C5ADF0D174
436BB02AAD79BF172589C03D0C1D4DECCD14F98AE90A86B4A7BEEC0F1CDF724E
0912CCC14AEDB5EC8E297CE357ECFAA0CE69B16F93EF2B214AA9BE98DED441D8
8DF022DD63C0AB8143A082073AE8FDD50DC7DD5BFF35F9BECE79C5188BF11056
D8D61F9D5FB03CAEFB421682269D8F6DC6637F277E0C97D7639553644B59FA30
DB3DF2B7B6633BA02AF683654FC048412F29BBA8872987BBF26FE15E4AAFD133
E2A61425C364F7A22C201039D5D765C1B14A06C1FB3C2BDC517FD2D0CD1280DE
6973B6365CB32BA2D5B60E1CA37398A37B7951E74D201140CC5DAE4FC0D66418
751EDA5A7D77D6CC9B4ED206B36A8CD4061E848500B284F1EFC5BC73CA717354
5F1C96C3B176937070F8DEDAC70ACA1504A0557C7BCE23A8FCD4E179AE4C3375
2A3099C9FAB588A0A47FA213030117F9455907169F00302E592A6B2D97CDF3F0
E0441B0DB0FF1324F99FCF21119336CB7570B488B31A0F8FD3DB110733DDDAC0
C9C994BD2AA5D5F4B3ED418205D8803C3EB6C591F7A5C34E00388A9E88DD8727
C76F347D5B35F5D59EAAA48B62D575ED3CE9F3F61170A376AAEB825ECA1A20A7
82C69F6BB354CA870717815F083067B7662A8950B85F64F693D58E17F1E35A39
44E491D46C73775BA837DE6498334594C554C7FDFECC828E3728057E3AD3FFC0
A1E63E94532B09CB28F5E50919A00A5AC50B0C6856A3697847314D8B9B8CCB52
76E4A1FD2A075CB2E9B9929D1EC55F5EF9518437738BEC7B300C19038AD2DD8C
6AC399A0D71867B943B1B197E884B9DA58D5C175E1AE398EBC0B5AEBCF2AB1FD
A960D13F12E423B2DC17C8DA6DDD431219A0427EC28E1E4D708B4DB0C90B8A87
738A2E4C6B8C49BE14091797A5CCE7A081485EBB8B2C629842DCBE25F5EAD1A0
D546F57455B532A9DE145CDE4841B08B2DA52906FF16F53180FE42B2C53066DC
0926AE1BAEF441FEEFA91F722FE6CF5E0B2A0875F71DD42095DFEB5851C82792
C5574EA07DDBD8D702B6AC0C82311A0490D5B57463389672933EC83FE646DAE6
AE8BEBD6B5CBA53FA936F88A4E4F556CBC56B47B8393457C9D5E9FD8BBF800E9
87CBC0C77CDDD9EE7768EA4A23E2B92ADB37BE882CD842D55EF629F6AB8E9C80
13BB6E37014B2DA56FC65071B345789BA7D3C193D3579C6FD98DF997D8F1903E
D53670E6030D2ABA91DB82DA54B97D0D8D3C56E08A3C21DFC15FCC12DAF6CECF
6D085C337F6CDCD044EB3E7F1D4C29344DE105C7CBA03E211E3244C2365A4ABA
88D9E17389FE2161A6D9A2BFB14554B0071614A301741D6F604EC3788236D782
152E3F41F8ACF4B04156EBA71CA125126C31FEDF066A474CCB8A76083B67EFA5
9C34E8BC213AA01B1862D866CA2C7F9CA3444464EAF496186CBAF607A0E7A60E
4D8959DE9DD6B42E3995F0D92A7AEF7C6E5C3BD7DB1DBCB1E6EA19B10709F709
40DC949106E454D9225606EEC9231D1694F71E350B8A8895016AAE4B44367EDA
F9E9FE18A201A08368AC00409F5FAFCE72DF38D27462875F0586E8631ECC090F
CE3DDB814193A5C154DDBCC1CCAAC3658BC4BE562DD1A5C3098BB32EA36D01E0
345A00F76E722736BE3762177A1EBC5390457316FC105A26440011C3A3505DAD
DF4586C826B71A7E08291F1864BB50A422DCB42C15CC6EA2B93C5C8312EF4EAC
025AE0A87C6E8C824D6E0564037A3F2DF3507923D31501B9B8FDEE3A06761DA8
25D1F3E7E4BFB11DC9C1981C0B1E878DEECDA57A367FCDE89B88707A07F1017C
CA88CB190F02CFD3541F27DE81A644E5B4318543740DF9D69CFA10EBAE0C487E
577ABD2155ADBAE841DA9C2FD0CB6D3FB4C8A109B7862A04B9976FE920B94318
21B7D6DF66D1812E0D07257A5E354946D59E9F162FA611B1CDC737E2B60D52B3
C82ADEAAC401B6C2D6DB473992B9E45B08A20744D53FC385E3F6D30C997F3FBB
7847C5B1ABB7AE53FD6616D7F23393E0AD34490AAFF9027168B5492145F5071F
DE0E6DD8E31277B3D3588B36372E4EA4F0107CC391DD3D0D5FE8970AD5FC5789
17DCE9CA706164456BB7A18A68638403621251B60213B46971CE3434C70487E0
6CA529999AEF89CCEA57A711290764C6E168E75EB756E0337081EDD6CC70FFB2
9632D22FB3A400774642B85F576F1B73CA52E7F5A23591229C0B0AE6408059E1
0427DA5122C7BAAFABE4ACAEDF7F5BDC3FE21909E7B474A52EEF3D98BF267FF2
B3803AEE0D1392F5418E84759FCE4310048C9124824A5976B09B56F8BED6EC68
D640A56126260FB5BD6D5AC13BFD5D0B0AEF252CD5FC1FA48A926F55885C6382
99B48123231F416C19CC5FF196D13371DD5D33CDB23ECE5256EE5760471EDCE4
26AF7FA95D468F2609FD64C6DE142E4961EC3156ACE3DC207C04CB4019CDB4AC
CE6013FD84D5B6887390A6C46F0F1A43FC0B1BA6AA6B5B44F23C9C360A20A1EF
E94366DA2A92098D60AEBDACB8D7B4736E4E17C4818DBD5398D8384CBE7CC1D4
A28B28BA328202F087E841206B35D89E26C2FDEA77DA957A5759CDEA30AAEE94
F6F5FFC1B3820C5E907CD6587295DDE110226E4DB1E46BA8DAA93EA2D135B635
23F6B1A98F3F165C0EA13B809CCE4D64B942137BD1D3F98EC2AD678F26CAB779
D9F8291DD64A677011B4B9604B8E4AC1F22B96A98760DB2FF1F47EEFB880814F
1200A077279EDF1BE39867C45DEC3596E4ACBDB1E200C27126AEC4366CB1A354
F4660DF153B940679229990358B4942D6DFC7625273857445C967C24FC51C804
3EDA0EDE8841235AF5F78B50368F80B3497E39F3EB0094F139D42BAA0831D6A4
200538253A922BD5CD0FA548C2241F1442C1E35636014F7CE5C1D2294AEB4502
F5248606EDEF0F33F998D05D95196AAF94039803898A673AFBB9873A1CC11045
A01D174F8CCB0482F6EEF5D5879C16A4D7B573D84FD0CD5960672E6515CA1BC1
BA40AF1D76501C06548399DA7D2662A61D03BC3BD75D012B30621D0C6A052213
B3390976661462DA6E60DB0CEB9CA555AD3785E99AB8AEED42E70305BF90ABFC
C56C390EFA417FBE2FB82E9AEA03B36811B408CD5F90D706EF81DE9A75ED5B15
6D726DCB2AFCE0E855DE25D23DF8E5D4EAA5364EBFF47C12481747F97B4826EA
2D639E00F037551E7A5EA6421BE789D54E1D5D30370196A35E65DF159E2C7FB3
8057ACF28035C9EFFD9907D566937228062B07CAE8E2B199512529B71EA8AC90
600AA84AEE684DD0EEB00CCE2355D089F6DFA6C0F18D138A7907615496D8A998
5974A956A524FD8EE5E6A82798C7FA1B71FB68271A0C0FB71CA17036064CA597
19F882FEE87C727ADF36872A0C05BA8D9FE0424CFFB637B1E85AA99B9572BEC8
031F44D8E24FCAD7833E27372F06233E805B8FA976FF30CBE858F5FE88FC54EA
CD09B4F56E6A0A48049D84C1A124028072A0C6A1AD032F0D8194F5191F53DB6B
07B65F9EF3A59248C055EC60A2CF7CBEE5CFAD31E6C0B26937E7AD0991A1F0E1
EAE9EF6F0D70E6C8649C460161EF09754C7246658454E44337119681342D7CCC
6438CBDA49130D072E2F49F1ED66B3A3BE6FDC93E573DF56748FD2F12E031DCF
2B0AD2F85D92AA9F31CA398D81572A05198E18DFDA86B817CB5F244AAB2A0039
6FE7ABFD61675119D606D8432B84010B80ACFBD917782C45787C3F6E20616FA0
301164B4386BC5A0D43732238A26553222C130A5981415B8DFF4467AF95C9605
CF63D0DFAF6D7E2D05DB0FD260E5C28838B3D8AD910DFE029F3B1BF9D43C38F4
5A6E3FE7DF3C1467C1D5C902EF9123C05F46EAAA8F17C380DF04B3F164C2180D
EA4EDE36FCF64AE318D8D13D0B307F668E3160A052639174F266116D4C6005C1
4588F003B07A68BEEA3B5719F331A58BC4DFAF393B487599A0307A37235D83AE
DFC96552E2238FD4D4F1AC215A8ABD6F928C96EA7E1437230F12E7D6B0EC4B62
40494113CFC38EF265418F4495020007B8F997875368D2F7EF8446CB30D370EE
DE8F36D195727C4A381F48F29B42AB70CC5211272822827868E958351B6E98F5
26576770A833A726586A6FA59A42D2780FFE5AC3DE9358953261B31DE9FE468F
CC8DB501C0F41B8A218076D77579B4C437C564534EE5646151ECC37C58E1B32A
6BD702518C4A0BAD79B5CF825CAE60104D0838A4F15FB9E005507BAABABDDC2D
F0E67F620F9920A83890DDF699308ED3BE657C51214DBDA6412EAB1906DAD9AD
0422DC9DE4648D9E106990EC08FCB54A09A931A7A91121C7E5AC976D56907E84
30B361DC13E62AA8CE37D255BA04EF9A2FC2D47484516B15C48BAF399DC489BA
68D0B7E973734FF9B17EF07AF4D5C93143EBE3E439717816F998A2AF4F7C684D
3CC1F9181C458A1D947F8A34C266882E62358F106EE81E02007C08C1A4F278A9
8AD244A30F74B17408244FB69ECD2238705F5C2927C51C8698AC10B593C4A651
04D5B601AB872D51288B5397165992E4CCB67B43F19E572472B6F804B309BA9A
1891C775EBC866CAE897FCBAA0DDB72469C51775E6C68EAEB4A0E0046F22013B
2E01213E604F9DE2DCE26273351A572C6408C264387CCEF8BE1CDE9DFA4E7F37
55B7BD1ACAFE9422AFC886D6A27C8F9BECFDD6612C29DDD4F45DE8C9C0582C8A
0406CA4253ABFD29307E143CD843C666B567AEFFB5D9B0FAD58AC3F7D1545075
8BFB2881035407A347E2CA572B4DF2266610A05B6FA34B59A54E0AD74A143F66
64B35A58DFE2A5351683243FBEE5CC314995BCD1F918F581304CBD363EF21C91
193428EB1CF98430D8BEB8D11E55E7A577B23BFA8609DA01593A6E53DB8756E6
8C3645521BA08AF58442946E70A655DF2D7A9C1CC40060F7D413D73B751D48E0
6D583969C3EA48526FC009311209D1600D9BEFCDC2F1A3F783D2A01B92F9F3DA
1BA6847BCE41847E6A991F54FEDE9D76DDF63E7D8312FDC6B308A6F5A1375EA2
2280F3C1480E3CB9C38CFC536FFFA3A357AAE845B00EF45230EA00CEC2FF06B3
670A87AC8CF3624898E4E240130AC15B8C573DCFB0B92E07D33B36CB5FFE70E1
9E14DE5562F968CDEBEA75721B8B087C698F009454DFCA91DD29C261D60871DC
FF6142EB798849E9166F3D61E021CC30D4B5DF371400A697BDCB9A78ED973DB7
8D8EB2DD13995F13C8653BC197F7D37F80F81C441DBF046E9CFA444CC1E189F5
494BD128B24BFFC8F517A12CDC18846958B8C69D41FFCFBD2F5A09AD965EE8B1
9E542E5AC2F5ADAB6A2C6EF31485D656CFD0B50720C5F3DFA642BCC1667BC298
A76FAF7DB441D6877A8B53A450ABDD299B9315EBAD0DD48A933867DC86811DDE
0B5EED686655AB00EF4A6DF7B0EE644D578C6DEF011D47AFB8E8C9B8715BEA1A
20EFAC19F11808A6CF93074686496830676CDE3EF843A2D3EF68CB004C3CB472
99E4DA5F2733B314FF90701AEA65130D1A18FADC67424526368158AE2D82079A
7E8078D9CE0C77AB16E582C16D0E5ACD1E12CF70A4A20689E33F9045781111AC
EDE1E3C25313D7DF52DBCC09303A0B2704C05CBB8F8C7226822F391C802BF293
106D58D1C37D35CF48F3518B25EDD50CFF51055D22778A7FC5FD0C62E9EF6B4A
C43B814B5E0A12A49AAF20BE95F6FE037277FC4860A60714BC367D28C9B237FC
87E58A07AB03E869B9FA79989733DC3E929BF36ED0B71DD9A9D2614299426E5F
4EE3F63BF07C3186FE7FCF2E8041C0F685D01D7BC5CF84661899EA0AE20CB1A9
3E37F28A6366D87B43FA2B9D256528A3E3442FC1F4AC3EDF8F074F8DDA4DA417
4F7D9F14ECE3D16771406CBE27E7379B4DA0C2BEFB217BF112735F94E3A543FF
F21CF6BE56DA34313D637F19FFDE7E1C9E84A4F24541307575D6C1B13A9BA39A
619A67E81A1B09B02D1BEA936EA12FC8F11247235211060F9F076DD604D307AB
3DA4D7A02A2E8443EB55EE6205DA626E163C51945990C2CE68D8DB41F361A2A4
1125C5C3CB75E039253C68EABD01F42012DEC2098B98EA479B510BE89967B61A
4AB9A5488A0FE103DA30872FF137B1D18DE85E083BF6D923D69A25FB315D432D
FA0F0A283231B5FD23FCF4EFE5EAF45EAEE63FD98132D68779943FA2D1A45576
1118A3210CA455BE0CE81CD9BFF04B3D9B2DDFDC5A239757FBAB6A4FEE94ADEB
F0466FE94E22680A09CC0A81D4CFCD3B9BBC91E4ED0A4AB0BAE58EAB103A6074
D0DA9D52DCE4931DDDD9451C1CB5B1669E518795C430C0AEFA33CB169692BBAA
4024E40CB5911215B4717530D9B2B937E8F86AB146A6C58B89F53403704ABA91
C860CE9916AB4CD468D10EE5ACDCCC8E75C8AFF0AEEEFDCA43682480BAD0DD2D
B7D3DFAA55C59CDF224977840A8A7881FC89332DA667CA62C3804116E4E541C1
1F7889D1CF79277EA29712531AB02D539B1FE27206F688765EB81716C41A3799
FF72F5DAA298AB30152954822C77F3B66FC54A51D6BC7AB6AEFF7CD93FA94ED5
66F0124F219ECEA72E6AEB15D5DD7EAA366128A54E43350B006CF47642900E0B
B4577DD12358BDF9C8E4C2C93444B9A29D442FEC36E40BF684D64594951EF807
D587786C2E636CBCC165B63D8DDE01A0EEA0FBE2DCA45C4EAA1A1CB164B05A3D
4B594249D0A0BF0CB2AEA95A71A483A179E77A11A49B73CA88C81F763950C6CB
C4702FF7F4A58665C23D73F00F55C48527464B453150CA6E5B99D1BA08D3DDFB
B5B304DE4E6CABFF791CF2FB9912908029A383E8EE39F7EA2CCEFE949B536D90
BC0D4D791582743075C21E37625DCD219364A71FB21476A2E559A9711F662F48
AEEEE7E73B1DDF6BBA199A66C60CC2166FF9B4C4309D096C0B13C011D3ED30B9
374210DC96CB26FB201EA9CDDF94DD9FAFF39732B4B6A71E86611FBDC8742D4A
C7E661E18DDE503C94DE0E6DADBB1AD6C7771D1AF783D504F2513FFB87C4B3B3
90AFE5B8A8969CEDD65B59085A2C2D11E826D1AE484253E4B31EEE0C6583DFE4
D482EAF253505DF691DE72EC54913AB5EAD1F051204DAFC9C6720157B67D883E
0D04B4D7412F0F854EC44CC4D83F8EA2A7DBE940F580DF77FC0B7F1687EA5FF6
DC8AC26C07052E011A10738CC7FA1104FCC60AF85B66D2294484B391267CCACD
9F50661526250FAF134A8C487B1BE57F01D08E06AB5E1689CA9ECC8B6062B568
0E43EDCB4C74EAADDFC3BB1D309C2BF166BA3E2E3F276E99A288D291630EA951
E63D256587E54FC0E731E43AEEBF68ED71BD85D95C957FE1C2D78EB5CE3A2FC3
B31F528FEE1B2B9EABF43AB591749CDEDDE9D83C2238E5541061E88C5B3E56D6
3B5E1EDABC2C238682705B8BD673B383284AA5E8B4AFE1B05913D1BBE8ECE2AF
E5B96CB431D77065D35AF5EA0FF1B84B47655A45286E4D6EEA94D0C7C1BA6BD7
9DD1943B5CA1D503CB10FC3F51FFC53E556893D280B1384F81599249F32BE524
9439734EA7DAD4A6C7C0CE41FBA832EC6D4B3E54EDF0AF02AC694949F425BE49
DAB43F2930D321A349023FBD4CFA05D9C8E1399E48F9EE7E3C61EF5833E89159
423F3A8155FE9441C9172E51C9552ADEEF047312BADE124C8BD0A0FD2A2E0DD1
A6F3D338598A3836AD46BEC0966499F558053D5DF15585DECA93339718037518
DD8DB8E9D7303BFFDE3AE50902CD27A97388460424CB79BB1348D2C0E6DD71DC
0147D980E94B4DD28F3BFFBFC356EDE6220076D2E0F9286D7E6E0ADFB03FD673
9095CB3696F5AB10F9CD2036CE9B88F51A3DE177DD9C6A82AD0D45DD6EA8B8AB
D8B7D1D5AB032EE378E5FB62E5C967F170590B0A9AD94E038C621902C674F43E
FC637BAD1B9EAC2206A29F6C7FD4448442BE438F688584192FDB60BB7524DEDF
0541CA37DC5E70A1776D62D5261425E17671E98C45070852192211D947627E8D
26195090547FAAC5D8763FA76353934B64DED4B01BB73A72131F60036CD7B86B
15B593959F997F7CB38189F00FD5BF1E90E7F419D163A57CEC5AF1ED84115741
3C176C863F8D53C6AB667E141B13B4D07C822D461840C8F7F8D2C46EF4D10F12
359C7C9EE4B4D7802C857544E4CCDEE30947593A474A87C81902983062345748
370F307C3D91785239E17215291863C565D2F737E4B1C2E44E85E098EACEAB72
0E31F40655E97175DF31035E66C73DD753561EB2F91FBAD13A4E1035775A4AA8
6E2994505069A011CB338779D4C3859CCB24EB8F787435C959AB36D83F04EEA6
50308A38CD3688C04A146DD15D2FE97716304CB6FECE9B748F9A5053DE280366
A94C14C0D642D169AB4185673C97C2F1D864E72C18A44D8D7D5498D3BD1F17D9
94A56AA314BB0BE57ACFEB16AE42FAA2DCD563CD67A9890B9AC072818838DB0A
F4A099C2DD
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMTT10
%!PS-AdobeFont-1.1: CMTT10 1.00B
%%CreationDate: 1992 Apr 26 10:42:42
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.00B) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMTT10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle 0 def
/isFixedPitch true def
end readonly def
/FontName /CMTT10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 33 /exclam put
dup 34 /quotedbl put
dup 35 /numbersign put
dup 36 /dollar put
dup 37 /percent put
dup 38 /ampersand put
dup 39 /quoteright put
dup 40 /parenleft put
dup 41 /parenright put
dup 42 /asterisk put
dup 43 /plus put
dup 44 /comma put
dup 45 /hyphen put
dup 46 /period put
dup 47 /slash put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 52 /four put
dup 53 /five put
dup 54 /six put
dup 55 /seven put
dup 56 /eight put
dup 57 /nine put
dup 58 /colon put
dup 59 /semicolon put
dup 60 /less put
dup 61 /equal put
dup 62 /greater put
dup 63 /question put
dup 64 /at put
dup 65 /A put
dup 66 /B put
dup 67 /C put
dup 68 /D put
dup 69 /E put
dup 70 /F put
dup 71 /G put
dup 72 /H put
dup 73 /I put
dup 74 /J put
dup 75 /K put
dup 76 /L put
dup 77 /M put
dup 78 /N put
dup 79 /O put
dup 80 /P put
dup 81 /Q put
dup 82 /R put
dup 83 /S put
dup 84 /T put
dup 85 /U put
dup 86 /V put
dup 87 /W put
dup 88 /X put
dup 89 /Y put
dup 90 /Z put
dup 91 /bracketleft put
dup 92 /backslash put
dup 93 /bracketright put
dup 94 /asciicircum put
dup 95 /underscore put
dup 97 /a put
dup 98 /b put
dup 99 /c put
dup 100 /d put
dup 101 /e put
dup 102 /f put
dup 103 /g put
dup 104 /h put
dup 105 /i put
dup 106 /j put
dup 107 /k put
dup 108 /l put
dup 109 /m put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 113 /q put
dup 114 /r put
dup 115 /s put
dup 116 /t put
dup 117 /u put
dup 118 /v put
dup 119 /w put
dup 120 /x put
dup 121 /y put
dup 122 /z put
dup 123 /braceleft put
dup 124 /bar put
dup 125 /braceright put
dup 126 /asciitilde put
readonly def
/FontBBox{-4 -235 731 800}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052A014267B7904EB3C0D3BD0B83D891
016CA6CA4B712ADEB258FAAB9A130EE605E61F77FC1B738ABC7C51CD46EF8171
9098D5FEE67660E69A7AB91B58F29A4D79E57022F783EB0FBBB6D4F4EC35014F
D2DECBA99459A4C59DF0C6EBA150284454E707DC2100C15B76B4C19B84363758
469A6C558785B226332152109871A9883487DD7710949204DDCF837E6A8708B8
2BDBF16FBC7512FAA308A093FE5F00F963068B8232429ED8B7CF6A3D879A2D19
38DD5C4467F9DD8C5D1A2000B3A6BF2F25629BAEC199AE8BD4BA6ED9BBF7DABF
D0E153BAB1C17900D4FCE209622ACD19E7C74C2807D0397357ED07AB460D5204
EB3A45B7AC4D106B7303AD8348853032A745F417943F9B4FED652B835AA49727
A8B4117AFF1D4BCE831EB510B6851796D0BE6982B76620CB3CE0C22CACDD4593
F244C14EEC0E5A7C4AC42392F81C01BC4257FE12AF33F4BFEA9108FF11CF9714
4DD6EC70A2C4C1E4F328A1EB25E43525FB1E16C07E28CC359DF61F426B7D41EA
6A0C84DD63275395A503AAE908E1C82D389FD12A21E86999799E7F24A994472E
A10EAE77096709BE0D11AAD24A30D96E15A51D720AFB3B10D2E0AC8DC1A1204B
E8725E00D7E3A96F9978BC19377034D93D080C4391E579C34FF9FC2379CB119F
1E5BBEA91AE20F343C6420BE1E2BD0636B04FCCC0BEE0DC2D56D66F06DB22438
452822CBEAF03EE9EAA8398F276EC0D92A7FB978C17805DB2F4A7DFBA56FD6AF
8670EB364F01DE8FCAFBAF657D68C3A03112915736CEABAA8BA5C0AC25288369
5D49BD891FABEFE8699A0AE3ED85B48ACB22229E15623399C93DE7D935734ADA
DA7A1462C111D44AD53EA35B57E5D0B5FC0B481820E43222DB8EFCD5D30E15F9
BA304FA879392EE0BCC0E1A61E74B3A1FC3A3D170218D7244580C7AA0DC65D19
741FA5FE6F8CBF60250ACC27454BBF0897CA4B909C83A56672958752ED4B5E79
E18660764F155E86F09EFA9F7685F2F5027EC85A775287B30E2069DE4E4D5712
E7D033481A53A2702BA7542C71062173039030CF28D8B9C63B5596A9B42B33E7
D922944A38713383D3648A4AF160A3B0C8F3379BA4372BE2E7EA49AABA75AEEE
C5DDE1D8BF68483C3D21271280ABB91D54CC819680322EAB72E1250A760BC8DA
726405EFE420635B5B7F0B48752C06083E92BDE06401C42A2C528C8A60381227
CEBEF0C9440DC034DAD9C19FB27DB399BDAEE22053591D6538587C768C1B7B0B
7D1E222D2D8AF3A6473CC4C0D6C3E0DB49068CEB8C9BD1C5CD486A50DAA10BC7
7D6286142355E3F21DD254E27C00C442728A0BAEC9D3F17AE9CE320D365152E9
EB0D5E3874F2BCEDA98521D23FCFC30B4B69DAD2ADBE80E5964ED0ABEF6C73B6
DAD30E2C5061E3747FE536E1A5D190D028F2130AF608F5DDF9DDDF1E77DC8437
ECB3EC93B33505DF47884DDBD1DC6BBE4098DF04A29AF6FA3AE344600D0AAB53
B3820DD7ECB600A3B8001C51AF2CA7A39AE1485A087FD1752DF68F55B52B4DA7
48030F2AA7E570B3D56C4EAD367B9B73FBC0A7356253233006178B9A6BC19081
B815B5988AE76FE6FAFD7AC239072B1106A3F509381AAEE79B2F2154CAC4727B
D199CDC8B4D05DF4BA006982512ABD7539E28D937B0F87FF79A3F84C29ECF943
A8DCB8BDF8EA9E7A0E7CD60BC2308C96B3E889C797D0FF28FF4847016B3DA141
E76FC6BE78A6EE9CE07E651FF86E720A1A1F075972D36E5C55162E3FE26BCE3A
814BFEB12D4C5FD24340CFFED499C7CA183E57EC4F12CFFBE3291D43F7270575
C6C3306F832EF182ADD0AA14C4D8669A17C09F632406AFA195F90C4DDC39779E
EC0A77E590211592D6EE19563963225C06C2F13265EBB5A6CFB7C17D9E77650D
11958305727AF662AE73AD0E3ED5F7E7086C5A0C3548A8129575980B06C715AF
DD55C8DF869BED0A7883491030B1A7E82C5EB04E5A7D952E716DD8F2EF6275EE
087614CFAB55FCE2BBECD7E8D9C90FD8359E929D5E0A416A23BD58158318B4FF
87B095EB63F7F052B3A77F136FD66EB2C52BD46CD7DB3091A4B78A607112B12C
4D171B2A00B78B0E1C44B0D90C20D9244281F5123DC1F6063F91E9E3E48DE78B
C862D848BAD073A4FCB5EEC9FF54B5AB8E234CCC3C7439C62ABC4A13EF1B8897
ABBF21F900C564C9A305FC36FC7224932F766E6E72C2EBB55953DFE2AFC2E3FD
33A0C6F0FDFF086E9FD796E7242596AE85B877223532667625E371D2156E4C04
0D7FFCD3337B93DF066CB6FE1E13960719EB7CB409EE805C08ACD2C06303ED9C
E34C898787A43C1B428B896551C6FEB50A831C6F8CE2073EFC662EC286CB7555
A3B42E58772E82FEE206948B8C439FEC5E4ECB9E11DC3A4CBC7611E30890E408
637A01A2118441B4F9467A98BB2A1B03BB2F5D8E3DB7D1D15C188D9E856088EC
B762F07B1C06024F7EF53A2FBD60C0A1F4C0275D07164545250ECEEF8CB15B04
A2D8AC44DDE818C4E3CBD2A5FA0FE49750886CD7CFAAF8B780255F89DF7F4F5C
BB594FE7C1597DA71813C2952AD3E811524459EB71D29696B450C924B6A5C843
8F36A0F1D7DFE796FB9564333666D74AE614D0D698FAFF20F83C86524C894BB0
272221C060544F3B653CB0E4E4F82B20D7530B3806E6A5830852C58070177815
E287C847F19F64E854F1463C23DDD80093D6FEB8BAA22C5F05C21F99FBA7193A
EB7CD49CFDF4308C6C68CC955A45FCFB54FCADA9A3BFBDE086B057DE88BE335D
280F5338D7E66AD39FD08F9B55884F1F377FB6869FBABE3EAA4B7ACCD85BE672
724B4B8F236B0889B6E7049CBA558A89F17863E82DF145DB8C7ED1F36332DE23
3C0053B74E850FA14F9EC9EFC23AF18E153CC96FB0FFD910347370E57F0D81E9
4A83E2D189EE5635E85A2BEAB5B1CB974546BFB2FC2ABA1E15DC0EC1BB3AF1DB
B2F93538B92F504CBD7AAFE36F5F3AD45EB16378F169B17869FE81464CB826CB
400D2F5441A496B6C60A4F15FD20ECCAC1F8F91015E7E1C1A10B7992A1554E52
9FBEE905A3005336E49CB04BA7223F1674C0BBDFA06ACA34F7BFDA56906E04A7
4DD79EC7E79B021A5008F3B1E04712D689366F520B0FA66A558F957011992728
561BF4B75C2BE07C4024C172085E51CCC5CFA439F570297154CDDBB3AA25CD6A
3004B936488851BA1E814260C06CD5479DCAB1A6AE21A5F4563024F973D738B4
0DDB6C6DD2E3AC21B4F6D95CF9AACA782919F5D3E613D61F3224A982AF485C8D
EA0037410EB70AB7D3EC174C6D5DE5C9C5A1220EF7C2B74499ADCEEFF077D1D3
50C1124535F88C3C3F66477E42F1932665AD323E06B398D2805B9CEA632F5B1E
50FA587B102A35E2F15EC22DD66E4DF06A3F4BB717A3ED7FBBE2458EB4D896DD
AF00D1BC71FE1CCA27890ECBF9F0AF01D3E65CAA29427FAF06B3BE1E640522E0
73B213D04491B93DB29113EF72211E31F4C5A7FD58451946CFC15FD805112FE2
547D1131A46710DFB75659A33695FFAF3CDD40AE5260AD6766DA81DAB0A6E96B
E89D57AAEF32B5EDBBE9F7CC033BB2595CA3FEDA2ABAC8E5395EBC35BC112FE9
67EAF1F123228538091483050847F8FB5194203609502D3A09CDE811EADC18B9
F039593782C27EFA7697182D6367E88E326AD5622C5A457FE2644FEADA88615D
9DE3E483BFD9329667953CDB86F9D2F0D4F02DAB8A98FDEB1D17CAAED9B6E2E6
0C55C1FEE25AB98FF59FC235876029CE03E4A713B75B3163BE3B2DC0D4472DBC
473E10400C0F57E627AE97FD0C1CB0F78FD8E2FA831A3D2B1C2BB3F2D4E812A4
194C8732B0C525361DC8480CB27C30CD4DCFF01318D2EB4F5234B4A42EA8C23E
7B3EECA41B8E4F54D5458B37EF0FB2F49EB19F4EA8AD2B53820FA36E93DD309E
48847F5C01B1118ECE7D0186E6B8953344EB775D655AAAD7BCDA642EA2E39A15
855C027CBC0E3FA752900EEB464E2D39404D1B85072B40834748C6F9C74C5B6C
3CEDE988343FD984CFE4B856A481E60E2E65D3BB41BAF2FA80AC0BFE381071C4
573C6ED65C524FF777F34D82E9661E4A75E3878CC77BC59218244612219C5A92
E95B90EC2C38614665550026F1730D11162F19D841681C04C401E102C047541B
97B9264D86F47E25A347696AE5EF0FF3ECD9BA32C92901DEDD816F7D73ED1216
0A98771892472CD625A8F7F19DEFCF5CA2AE57F8AD3898F2C1005B187DEC6F2A
A31C32720EBC934178E0E9979013B3C9AEDA4051DF63D8C903A399DC88F83DCB
A73F1B2083819D1BBEA5235F8FE1D098F32A2BA6274424A99A4975FE4BFD59AD
79B40A8003CC0AA728EA79D6BDCBBD73DF45B7918BC099C5BE4A068BF64A30B1
C39442CED98AAE1BD495F6CA32D564A72E3BF753B49E4178927E4BBC0F06048F
96DE7C30AF580B0BFFDB330B3B87D7F6532A24F403680BD9F15E758CDF04EB94
E83C7E644FDE5BEE7CE73EFAC75669E41BDFB20A5B8ADE1137378DD8102A0DBE
19499A623770417CBF5211395A6BA9F4490F4707A46F1F9B3FBE642DEA0CA053
9ABC307B1E71DC2B069DDDBB4EAE378BCC75AD61DA900AF8BA6DF0E27A8D2258
DC80205305AB6ABFE3726703E60869BFAFF1874F3C0E05FAD9C05D7D89ECECA9
DD2AF5F777D7514208697E712B52448B364D3ECEFD8127043DDC9D0757B7CC37
5CDE8001D007A6E961EA24D7FFC92410F3B13A32946F12A50DFFA256249BC8D7
C1842FB84AD51B41008EC4604F6B70990510EE13E6DA34F864A572D99A13FFC7
3609EF2BB1FCDEDF37A6018248C545E086EAD1BA1143E74AC60B684E755E59E7
36557B915F92EF78FC177621D49F777A2AF39F3C2AA6EC74750AAAE08BCC21CA
A71CCDC91DD45E6050D83ABA49ECE425B55EEE137C55619037F1C30530BD0A6E
CD2004B6A040405064D7E87C55536680364E09248BFAA3FDF95CDA0708E55F4C
F7D0A92A93DEE0C7B69638F171B28B7F854CCC6EBC6AEE14864BF5144EA36D46
A9C297225AB0325E28EF6BD06D7E40E3A724EA1E50C4C6163B195CFFD5DD291D
D7BBE9AF4324A69394117EFD62F08D6BA6A8F0AC3E2353492999AF28FBA758C3
A50B6840CC72054355E6CBDBD86F683537A4115049BC1616BA35C2B0B6F5CC32
3F6831DE4E6029310738DE23D36D2C6E82F04EB675FB89789F74AFE3B8854250
51812FBEFBCF162947554324FADAB765C74B6DA89F60A734076D44BBE45263B1
3FEFEEA90EC7948F23F34D4049087AF6563692417DDBCDD5A9552A373C2528F8
0318D3C0669279F292127CBA40B0ABE08A1476BC9EBFA8BD5D622BC5CE7DBA20
C689BDAF50D5B1EAA89E296787CC53845DB2BA54FDE363DCC98A7BA256663869
E9E02E09077884DF1A2A41AA698B7EDE8DAFA621B552DDA91AD1E671D636FB36
91C62B4D2D4112F2C169E0023EB7521F570CECC54ECA5EBA462049AABBE2ADEF
E3234BFD71B26DFDD9D34DFA69E5E80FD90406E6505A6798F030A4B5172A7BC2
C9B765A86ED55C0590E0432719BCD7BDE7CCC7F6B33BD467063D886276C8879D
E04897A4623111C14A1EDBBF69E2FEDDFEAEB2A785C6D2F0711DF4B93AAA291E
7F4E0CF9CC3FF0D31953C594DAD014097DA02CBD5AE8828C7E7B5BDA09188B05
0D7263F164E1E78CC430ACAD1E8FA71001E9BCEFAE47C79846916A5F819CA366
5734089BCDD458CA1A9E8E17BFF357A91F9A7A8A6E1DEFB121353AA80F1906A5
AF7CD2E59EE6776FC0DA6574DA0DE522918CAC4E566F13FB9B64EFE79F3A3BC0
689E3B0676741C90FF3BF85C7A0FA9716F4ED0E329512B66BFB8AEB56C3DD6B2
24F8D6E23751A8485F7EB46719E9D22618FEE86D5E01ECCF4C6E74368A8E9B49
245D80E7484DFBC916FB2447852B36EF3F99A82B6C106F786707D7689DCD7AEC
A0C51AC1A3F67034C16B74994403FAE7743BF02149BEBEF554814BEF31B79184
3FAB4D2C887E1BEE81B465D12DCDDAD03DE5ABE9E763C440B2CFD42FD16D96EB
C21FE788C8C2688F79F148AA7090BE64B0EA710D376222FD1590301BA9A2E715
D33B8C1D95F2589AB0EE476F7046537E27DBBCDADEA1E7357C9D7FA92C2F93A6
7BDDF58A44966590821023380C97CDE37EF6D449E35EF32BCA6E69DC8458511E
8DC8AB63171A6018AC9A334829E5978484C4C6E917A5F1C254E6669F4037C691
36980250A80673E0F18C9E0FBA1E5CCA3BE30B8E7B7188062B25F8E1E16528A2
F217C18D6A1955482E5463FBF097ABAF7314E449C6FEE56E2695407A8AA9648C
61AC2BF3B2D9CB6317A9B16CE931D318C8BC9676CD908505568C197D90C2BB46
06431C999EB68C8216409E4CABACB2BB34A05B697B9DD1E91471A404B4969519
E25209EF4EDD420944BED17B18DB3566FCB8059699FE416789191EC2B35086AA
2E10C139E3C9FA0A535DEE9255A867A26656213E85851DE5F51F9780D3A6E572
F1F5CE64DA176CA810799DC1C60A8FD2A5ED42E613021A19928EC4572059B2C1
EE441E79CDF7DD4AF7B6E3D3230419ACAED329388044B107DCB4DE91B71EB838
904B1F969738BBDA064FFE75C6623639BE9924602DDF0C166B433B9D54ACDA5E
018680477FB8F10621FF32319E58DB672D744959A33E7314A1B3CDE0C038F7D6
0C8A195AF191E36B0325334A711CD8E25D9C1D257E46A734779E486567481108
E0281DE96907D460546578DE83A0A01A9ABF64402B48DEF739F4308E14145753
719CEF720FE5CF8DAD7845E74D502B69DC18D172C3A27411259B8042F3FF82C3
B157BE242C351830255CF0EDA96577375A70657BD9A2E9FFC54AF0AE563D73F2
E510279FEF48D79F5F7745DBB492F1D74DA738E6A4FE4364799B5BEC93B4CAF6
B06B9B8C8D164F8FA1FBBA693204064F2C1806C39910910E02ECA8D092558CB8
33338B359D56483B7B99A1D8137204EC1AE70ED3D75881FC3B00BB9349AD934C
81A9F285312FDDC77FA923B18B1873D288C2AAF2E6D0AF90BF25A982B843789D
5662D6A2DD58E065026885601ABED4B09CAAA3116DEE6B430B15BE0A121FC1BB
FDEA5A501F0798CFFFFEAB5101E707F1A00C8E014A3561FD39972EA9AB108EBB
960AEA7FF60C301AD6CBFCAA7D35CBF6F8462A4D76C4FBA6F3DF6BB762DF7900
9F69529AB4EAF96C2866444B257160E8822533A7A1240C83EC18C364F577407B
4CB314678D2511735308A1660AD94B8B818CEA4A3DC00C5A1C978F8BB4E0491C
49328F6CDF95BF620AE53056364423841D84418B23C2A447B0CCF8D8633FE2E8
4A4AC1C6C74627EECDC994059F1BAE9E6B10FA80D767B3FE97BFFAD413DCB0A8
495039744B48266278194D60422D6E7C74D0DB45ACF217797D0C0678EEB60759
6231438CFEFB346553A7A447B50807EBB6E885B5A49CA9A350EC4A8C76EDFBB3
A4DA1C9E3EFA193CDF08553302998F20055C84420A4C5252F764CC4B7A4BEF6A
A09170EC417B296DD9E2301CD8EABE4A087E648E0525A9FFAF26374C47FDC123
82F18C9884843864F418ACB08041E7896FDD395225532460A8194A8DB4DBD824
1C68C6665F85059E365EC0972EC6465E2D8867449907DA6692A021F026F437BD
D02654BC11381BB6557663E0B0B8C4F2FF69E4776F4EABA69311BC1AF8155F7D
6D3A418BDC912CC7CF1A4BBC8A1376D8B4DEEB6585416959BCA4AA08D4520C33
EB054DE53140992D0707210593BE62B3659E3E493C4562C2E99CECA143791DAC
679896BCDA0699E405957E17DDBD243E65CDD7C9C8629F29A2078658746A7779
0F75BE24E2DDBB672B95F26366BAF036B3C23BE4132D7362E76D4183A469E0F7
29174711ECAF4FD9A923E72FE58DF2854C5537E3626317D471D1E8A922C9BBA4
CE9163A4086AC4A231C2BF35FBC39A5BBCFE41843CAC7D81A054509D31572BE1
596E0B0B563DF2BF0E57DB4943DAEE35CA26C8433FEE4FC61145C77F65DADE75
62DA18DFABC7F4194906F53884E62E77D8AB3E099776AB93B2B4D0C98FA44C71
597202A2643942795EE8CE098FE26F1AF8134F1E75FAE18D563B1FF43A511C9E
EAFB9EFCF61490A1A4FD2CF354927B72C5EDD5D62B2F3F5006D6130562A13BCB
1B988A994A8D68B051A5A821CCD5D0F8D9D49FE7CD04EECCFD7A554CCDFFD77E
27AC4AB5BF9FE40F90EBD066C483796CE1A364E95C5E0CF2154834760522F128
B2DBD1F4F73347D42635B2875A23597C35A0823CC6F71E49598125411BC9B2C2
72470D36DD967C947AFB031BFCF770FE50551A134DF8C5D1AB1F09819569A57E
E23D4E87C0B52CD02B0A2E3FAA7D27A94359E82AF047756BB769BC5950A75207
78ABD49D174F2F69810AFFA9336A52D6B93B004DCA5CDE58475C0210E0BA1D20
FD4FFD6838EC56A0922472D4C4EE0CC481574BC30618179E733EA40A48847E14
A75BE7717CC5DDCB5B0718074EAB6FF07CFFE794D335B3A13EB968EA8FC5B08A
13B38AD1C2C964E4B07E90B9732C458216B028E07DD593A5B767A2B415EFE7DA
951FC07800F11C7E2EF9BDD152BC6815B7F32117F49FE08BD79BEB949003512A
327F3F8FAE1767E7842348BA4373649F1A21DB2C56C081BCF9FA4EA86C8DFF00
FF45C4F1386CF8C2C4120F3F6019CEBB639F2D272D08C1763A470D4BF6330DC8
43C069A6333113C3A0C93471486EFE9BFC02B760C7CBB2E9156087D09EE8A178
5EF50B34994094C3F0015EA2ADB6C920F4302FDEF128711994875551C4E883E2
DDEFFAAE11F2234AFDD96400BB69C1B4E6EFD75734C586A10A54A98E7D790F28
DEF7C7DF61FB23BF91AA700AE585EBDE74E215DA49F4ED466F46129022722086
8884D8E026F35C4BEE7E866DF8E0846D5EC3534069B713FAB02D4B4EE3B44E1B
656F30D629D40AA1337786C1FDA08EA1217AFA4A6E2498B334DAB5461A70DFBB
5AA5686C89FFA4EE82D81CE2B28334DC5C032487CCE998616F48150BA1281911
076E626E5BFCC56A0A4CDC559F878F14C2BD7A5148C1D8CC303FF9EC473354D2
D4FB0F0F2AD0CF182A28074ED6552E179222570DE0E0D44E8FF4DB36C3AD6487
C4BA53C8548714A69FCF8E3E5202F09469D7447C6519AE902C1D611A720BAFB5
59E27A6DBA73624F44B4ABE0988BA3450F82E03521CCE8EDE8BE7EE1223B575A
DF9A52650E85545525E6F121FF2D1531F156EA9D5594239AEA2CD09EE28ACB15
A445E11FD1C031188DB61881F474D49425C084489A88A47D681EA68E7FC4B1F9
DBB552063A02A0EB51125E9B2CC646B940D46FF457415F9565892DEAC030F08B
E4C10DC38D825C7597394C844CB863CE6C843F67F2E1C42C4EF86AC7FB727BF0
224B5E91BAD99CC6638AB2C64469A81D8B1789981872ED037B3A34BDF3130137
80FE80FDA65EFBC11A08B98A1AE595F980B577E22D3CB7FED1D4016F5290ADF5
47D7D9BAFE39F294582F2C084003E9C83FDB9EBC87C8B477CB8BB359EDD9BBC9
9368D6605E1468A20909831BF602EFCEC0D5EBA99A2223E5A269275C8B221B3A
F9226654185929F794E1979ED18B4CD36152F973433AC67BE24B9D953254FBBD
B644CDF3BF0E29A2C72113DC486E46DED2CE8F8DFA8B0F8478D1F18C9AA8E054
A31C3DBE84ECEDD85DF6AF9467AC2990ECAA3384FBCA1BBE598AA0D6813C859E
1520B88BF30ADA910A6AC3068A5B8CFD76B7F0F6F4AF4C32450D628B5320C384
F23A2B5E8756895584155226A30F8B0437E028978491DCD00E79C0ED58DF261E
79B9DA17E57AEE03EE92102EAB2D63E69A88EE0B1E2087ED0C0CF6475EBDC3BE
0324D1FC8F7B90D8D807533E5436F2C2583B9629EC390403437FDAC908557894
03054A6DD6A3586043A9C8BFD0C7EDE1229DBB9F69F7A5D20F55664D061F6517
0051C6B3CD7338241FB403F2AF77DAB1A8EBE1650156D40863EC1957372BFDEA
BA8D0BB1193CC5BEB5A68C8274802E14FFA3ADCEBE19070325B1BDB960CF2988
C0F5A9BFD843C515ADEC8B8AB02B2891EDD7502D9F28F4E58D8F67D1ACAFD0C3
3531E0C7D1554344CCF90AC8696E83A3F968252981CAC09653956F4343B99D3D
4F17CB8BBE4506B354439B70F2024871D16668F9DECD8EDB872BE5E6ACC406F1
1DF4E3ADF60EFED57D1C426292970199BB663405236C6A907B6891C6190E87F2
78D9142220FF295C7BF44AF61470798FB8CFBEE6973C69DA1CC24ECB058AA753
DDBFD92FBB15560EA19D5D92F0005B74F06F0EA5901D231996E0866389DCA433
E62BE48479687084C1D67BC592E592939F806FA8BF5F0D3F644B1FA6F056DE0D
51D3F212C6818CB6166317058C2A0C07AE2E324CD90D4EC83CF4819B10CC348C
6DBABA024A5FCDAE6E288F82DA060BCD16437F07DCA43BF1E5A1B402F16C78FC
075BEE900B4021A1019C4A5ADC33230047FF11FDE8FB775DDA267040A22B4E5D
6012F7E72B8BC8DD3A81369A08FB81C6C4873C2147D03D4181D6D8032DD2B610
9C44CAB50C5BD8F489EBF01C72D4198B66EEA4E976462F8874143640B82AE57C
A51EDEDE75A9A55D31587C14F8DEFFE69F75EA7B95BF725CE9991FB2F07AF568
5AFEB39447B728B99BE0502BF28DE1D92B15926BE4E3DA2E7BB44A24836A97C6
EE3A2080E01DC6514180DAF9C055F4C94929D34F193920020505E62804461630
9F42C652F9D5681C91BE23DCB0C634247E739135F925EF3D5424767D5F5C5879
C46F2E32C7B3BE9E90FD6ABE693A6016AB77670129B58B8FE719FA97FE320842
6488CB85B6BCC0012975D22E75A2E086131DE676AB825A386C086FBE1B65DDDD
A19F06AA4C1D3EC84751C649F4A62CFDC48A7CF88CFEC68B959C211B60DCB045
6BFF922FD7349B98E1769394E6CEA4F764AC4B6536AAE4E6BE69099A39A6A33C
97671C3AB4E7A94DCB829FBA97DFE5F71B1728FC81F826699DFDB0ACE9BC60E0
6EC15D35EC479F3F53EE4D0398BAC138FED504A84A13B78568E3F9C86BAE8B88
61830A80F8B994D0D66A8FA3FCD6C5099C29FC285ABF096EF9A3BFDBB522157C
DCE9F0D6AAFB1F8D7B0A3C573D0C170357175DD56EAF37BAAEF4C92FBE17E26C
7D2BDAACB9B8F33D09651FBE0D49A8BE66B78D075485BCD38DED5056FCE48A12
D28E9670EC7CF4E9A277D6ABC2F7AB30BFF290B5452582F372FC9DE6CEA9EC0B
84328269F14FE7F47620B1042B283C54161AFCF84B46E6B1410587295E4F8958
C1800F120B59639C85D46D46A4C64309931A8C91F138EB52F779189EF75B9157
D624045F4B8846856ADF0AD735FC6FA41F7B6C002E9D1EBD92468E86C843AFB7
4D78E3D54D866029DE5DF865EE3F7313AC358EDA70A792E22F2F806EF86A6B57
64AAD565C57E64B1A6635B7394B4B5729189319FCAC8529ADE30633B9BDEE0D2
AF1F8944EFDC7C408FD8FC270822CC01E7BA355C856219B3AC5D05CA37EB0EF1
6766D62383AEDDA1F7CDAD1DF0172E766BB46C5FCCDDD61BB019D283EDEF312A
B2DBA38C9BB0928FB93F50E8516AB353BE04403D132805B5AAAA17163AB9C847
F1B54946B0775FD21325C82E4EC7F2186C54B4396BC4B0B913A59E4444D11B39
8AB56F2FD5788A9BA45DA5499A50BA74D28707F62086907BF8342E0C753A31A8
DE293B592F51D74DECA52858CCF76C69BAF2224F640069BEF2604983FB478173
792D68030D7A6E3FE083AFFE9488D872897ABFC88CA8BFE484A75201D73058D4
72A8A26A50BA1F2B50CBF98D46DFED0BA057619BF370E435A0400147928D7C06
28DF2A03527E3BE925D6A664E4640E63BD22D54A038D934B3DB5B500E075B8AB
06DB5279274E65FF870F1E5106E190AB0FD8849EEE2D605FD4F0DED2C3F86831
4EECBFAAD8B2A895F08DBA692A8176F9080045519CC6C46B52F0F31DF112AD79
8E46B9899C5527A011AB63FA443ACE90F09434C295A5D9E6753AF2645407488E
D29E7711546F87265C130B76B4632242E43962A5C886D4DB6316A2F3420FCAEA
3055AB5A9E1325EA870CE87F34BB2B3110E4919E1AFEE67606B00B03DD6824F0
20BA42968B81DAE198C88057438E36056D46C550E3E5E03A99BD4B07E66A2179
BBC5B3FB06D5D72022C53A3F3A1B759472D5A50D7F7A1F4E31D3F7A30EDC1D45
4B00AEB5DF680145A123CCA3BBD801CA64B2CBEEA99842720F8DCE432909AE78
5AD3F29AC69D302C62256CC4D47AC92EE11D2A3E1C666CEA24876491BB167548
9E3A990252DF8254CB5E7141F57B78FD1FEB38BE135815C6FC86EF81B5994711
E43083C3234C55DAD97CCCE4FF3F55C5A6C22ADD2C549513A465CFA3D8A9AEB6
331374DC05A4F496BE33F9263172FB6FE1CCD19EE9515C5155ABECA9492DC743
BE4142D63FB5E17D55C9FE642F07995502AECD9D555603D15B5BE420A65A6E98
4F341BA13E44DBBC1DC8CF0D561198A2B40FAF35F7ED5FEB4429BF71F5C88637
CB114F1377FD3227EDF592733EC68F4EFEAB14FE7C26DA7031075E04289FA6DC
8A79F81E4E18CAE8380CC585E7DA3DCDA3FCB53929AA8D772D53FC6D821EBB14
EB472017FB56CE9410FEEFF14EA69C188993922DAFEC805F4C8028537A9D6365
AE1A6BEF37CE8E02B995C41382984802AD3D12AA9FAA36837F9F9F8F60D16B81
474238F136F442CA9B14620F83E4046E41EB0FD02BD04DA7863DF26624B5489A
B8BA35B0B3A8D128FA10E01DC9B622C26CC57CA79CCDEEB7E174698EFDCC0CBE
879AE1434B3EC5AF48E6C2EC5652DEFE0ECD7415FA46BC0C80FCC57CC808B3DE
CBE4CC7B62AD3B092487F7A23C38A2D9102DEBB1CF4C1EE7FEDE1E8BBCDF7F73
54CAB1E591F9B3B3159D879A9492394B32F2CC43EE7EBA6E293AF12D7FC4ADF4
DAF8F2F48A777E927A915DE1FD9125B52D406BACB0BEA149F6F6D79D92D06413
5D68461A772D531F2E76D1947D2ED5BFFCD758E062B5435BFD180F7E3734D5DD
ABD86A1C2BA643955A36C482BEBAC608F588C43E6EA7EA2AE01D0346D28F50CD
BA8F9FD23674AB19A2B879E0DD19029EAC5D74D16B186CF4BE3382E74E361427
536A00347E536701808C1D31A617D1F9269110B76A0D59C7B84D98C8FE308733
C9497B807A77D244FEE03ED7FB5EB4D6ABB74A7129F23AF628BC01BEC6C43ED2
D62F4E2133006FDB94D33CD31F9FFE57C8C9E31DC6D7A81A2C6ABF1D971EE222
96A4D79F7232190EB796A43ECEB88F1C64A88A10C3AE8E98711EFDF984BF270B
55C5B9082D54DA7D32B168CE573597DC5A453D76953DBDDDBC1798F8A645AEB3
78B6B5BAF60C9AFA9D5F818740EDAA977EBEA0F68E531550E607E6FCB04F3E22
BC9D6440E1E153C8D780213DAB08CF8CFEB03018942AF980642745D711C7DB1D
BEFD825627798897ED8185D80234B6C087FBB602ADB1263C2A2A0F59AFCA7B09
EA4ED3BCF936C2DAEA9C8DDAA90130C24AD1A1BA47711CC760FF72EB3F27C165
CA1FDCF1250C6CA4A788AAEEE08902AB4EB03C6EDF281CA2F5B074C859DE3963
27F7CFC53CC91C80F779ABB25F7A6601453DF5606B72EC562F615A92C1DCED58
3911BE7784B6E8B17F8993E4D5693A327F9C289701F39ADCF583BB4EFDE1F835
1A59BBC2E6B73CF422D877B0B423E4E8FD116F5C66A4BEB706A3D42E7EFBB5E5
E73CD03D7A91719337CC8E13F9D8DA255185FBE3F4FB6DBE8EA90AF036A09BE3
5047B59BC18C1C3658ACE003B6535E42043E4D7E6D79E0B48B3D0DCA36C046D1
D5ACE0B6F91CB78BCBD144F3FAA3D9D711C9D11EC30B6CCDBF43CD490E9AC229
9ED2CFAC4F53927040CC8FD26004450889A1167FA34247B7C283A46E4C0A8C20
AB43314A34EF0BC02C5558746D35F2315624FB9D4A8ED13E3D1A8B80B872798E
CCB9775F985E31E8228B03949B4E35DCF7A41C834E53CE3C163EEECE81A8278C
FEA3A9E3264627D33738170C12F4EB23EF8F00811723FA4FE56A0EFE8ED5EBE4
90455B690EAE1E8F1092C1AAC07FC418A6790C2DDA6DF739B9B586B68263EB63
718EAD2B11037C5D26FF31FB2E56AB82773921B00EF07DECAEE2A8FD71AB232C
86865012F1FCC80CBDC4B0E881819601CE2FC5AC36875F2FB5C088436BB11159
813020F0433EDF6D96FD162F5E3241F88BA7025F2B010208DD1DF737FFF1185B
812864C3049CE325E06610404C8DE9322187DAA7FD90FFDF2DF3C86D94E8E792
377C1C1F10FDC78E1FDEAF718A2857C4922FA300C8D3FAC136BA2957C675FBDD
21E3A9E29C797142BA6D30FABB0D5E97AABB49D113A55C4838B253AB8D7443E7
15596B3BDF01C88C17135A74AF78551CEB6B0041BD17ECAF89321E6948E1C531
B227A1F071FC3558501BFFC842A4F8B80C14D9213E0633485A66F899BCB473D7
3C72329610575B6279C781714761468C785E426DC9393564979B1D6A6D55AE9B
4954010208883EC964F35E8363129682AAFA2D40E1ED08A4A1DF27F3DB5474E2
92B917B45D9473AC94EE40662DF06AC9D004541B6F88DF5AA4A36756620CBE83
1254ED1C3C9CA39B09E0D4148DA552B00FC60FF68E7159F556998EB8A66C8EC3
3B7842ACEE888BCBD1FA183BAB95B06B245ACEA49F8CC51A2EB01053E99E9A87
A5198C2FC26E270961FFF61A093A084594E6C0298CF96B251C5F8395ACDA26FC
461E6DB774F6220F8FA04C68519E19CF69EFA73E9A1BDFFE833B228DC19571BA
34B7AC21EB2BF8B1876BD11E128F002AC9AD6A9785CBBFE2D5FBAC307BE7CE5B
DDA7C12820028FBDBEF1343638CE166E43B95E6518A83828AA3C3628779FB2E4
CE32DED584715FD18C95D38FA85772DC8650EFC42F980A1ADC012ACD93B7E1E5
FA6453179ADC6F17C94FEA1F4CC2EF6A2A975C687ED81DEB7111F0897742B373
30720766409C534C5E0A42D7221337FF3C4C59BBD239518F3976DC55FDBB8C1C
8DB9CB4B05B1D9AFBAF0FA1D82B1564AD7FC92B6CB3582F7DA309403EB78916B
BFDC6F918E26A39755E5AD6394D985C92F7927FB1287FAFF2F60248236F918DC
2E8557C6805B01090A037E8D5C529E2D70976A9CBF3785F4BAFAF9923DB40756
7B6CE8EE83559893E3930790E5917EC3421FEB042C0CBF6CE74F16C44FA08025
82EDA0833C0486CDA66ACB450094BB65F54C83829B47DAAAC9E4CF115FC275C8
6BE583008180F2E2C9B003712ECE32333199BBF9772A471EADE59355FF264DD7
ADFD42FECCD00892FB545DFE555AAA4B273B82BD2740CB8C9ACD144DEEA94188
D1AFEDFA1FC63557F9E527C00AE7D14762FEC2814487CB60E406F8D4A47365B1
F7B0E0A56CEF011CC11345674611EBFB5A7C587C34F786498FEE4F0F999AF42F
D955CF2ECC5B64BB1C100310DE5B6C7D106A80FA4ACE0184A6E18FAC544EEDCF
307334E1C2A0CB6E488B21DA3BDDC5B593D5ABD6006D1E2BB56336EA88D56DAA
62DAFDDC379B06EF80E9F3661C6B7AA6787ADD06155F3DBCABAB6BA3A46C9047
5D295774447BC007D5423B9840E2ABACB5B811B30ABFF547A8A6E2C18A92DEF5
D30890D49388E80E6EC7626FE3236AABBF64B21E5525FFB7C802511129EBFAD3
D1E19814500A465DA92054F93FF77864698288510AB599237D0DBE1EECF81C46
F706515DF10A1D0FB06939473BC72429A42CE6E15BA2C97720756D80DDDC171E
7E8202D385C2E5B4A5A011933CE920E98A09527DDBF49FB4DAF2E736B1E42F57
354C91CAACB68BEE8FDD10F4DECF25ABA4EFFC4588DFDB9E98640737C015EA04
A33D5AAAF9AC4A7D288BC9D4A8AAB9B852516E215DF7614B10BEF003EE1D0572
E4654DBA4D71959D403B936339D41C381FC1A206BFA6505DF3082D9FF767EF67
437E8C2A14A8B6F0FB98C80DCC42A30C57C8AC3FE83570A1B4AB404374B85F45
A1056E389A7148CAF714CF6DC26A04E3DE8E2E7FD26F6CDE3E836AE65E593A9D
3FA7A24A32E3E99A152009C8713FF8960FC93A2E49B8F442B81A90F98B99E140
5F0E0253DE8ACE69F1248040510DEAEE069307FBD02B821D1DAEADE6C41111E8
37A80AB702B8D79977DD73429695C13DF81ED3B562FF4C168AE03ECD24909A41
22C579987CBB22700D1D34BB16E5D0B4BEDB4660D34EF5CF0A4FE507198EE14D
9FAF7C97CF769EA9159E1D8210B063141913DD402BAFD515CD746A7CBC061A74
CD6D6DF78AA722FF543C5379A1AF5102B75C06F73E075BD8531353892E1733D5
8143315C0C780BBB21D6954119C0AB1D4C89EA67C0AFDD4607AF07D509F481A9
9045776F08003CB429316307E66E1F9490E8547FE0336BDD8B070290558E0DCE
DB08FCF371A8A9FE905E9C3BA4CBD4F12BB2F512838D395BBCAB1488C58122C0
CD6D3634C0F6E193E2F2E8C632BB9185B20D94503E02244938D4400F0DD8FB81
3AB0CBCF32E462A223F9680A14AC8876917ADEDCC9B181D584AA307CFF3B66B6
F59FC840A9E8D1BE101AA1DE41934C22A1017A8AF69D257433C2D2C5A0474F9D
362A669B4044B3990BF83E8906C5B7E2B45D688CF12CC1FF38F2EA47743676CB
55FCD3C6261C6F5AF002869128882E39E089A6FA108195A8B86CB07913FFFA6F
6D8F8D5C9E897D63C174825286953B9DCB09B8475D0675E09C1D26286107E89C
C75F92D14002B1289A5E11F059F28FA27DF23FF395EEDFD5F22374FF67F0B60E
81D249898A228A6A89141B23918E977BA79C5F5E6CE84FD35F51B136D81428E4
E4D205612F6DEEC1CE6AE571B30A33DE004A8F096656A3BFAF8BAE8A2C73AA53
D7984D6777540082F3674304D2C3F17775BDF86A27563CC2BF95F190DB3E28E9
FBD0716C0F1B0D56A96E2E870882F03A3E160621FB469355859954858C9CC2AB
06EA8F87EA163B9ABC176D704D3C17A37508864381659070B071B80C79D6D60C
7858A32F5DE87B1F818E78048CE81E229FD7BD91286ECD773147F94E7A184450
D1060F0FBC5A8DB06BB4009B3F5F50EFEECEF8FE970E3FBFEB5ADEDE9EAC6A49
AECCEB5378A9CE274BC7F25D03CF477C2054D313FD988A4D913D20ED3981CE47
8674501E487FEFE5DD91CB0E5ED24BE1D2D45C88DBE1378B11F6B7076FE56BF4
8E8925E65FBF23330B9C4A943CD96EEC06A6073AED304CDF520CD2AC1CFFAC7A
6B8D8FFB7327834C9DADF578F250A51BE64D27A2B65A16DD0204635560B47075
3A054F7159EE483CA06345D3D55EFACD47AD32A9D7D7404ED0CB742A3AB8C47C
2C5CC71EA3E1405D6E114DD53D85C2350D46A8E4BDFD1667C65A8152D9F3331D
6235F40AE36EDB507325E21496725F3351C239207C0C4BBAEE2DC7D2797B8818
BEBAFCA4FEDBBBBBF3FDB633A0C21A8BBA856D4A3119394FB00AD092E314558B
99CD5B138D4A42BB7B621DFCC2A2E2AD262479E878D8F26195A643BA0D13F9C9
FCF3B6BE5774DE6F4564FB82BA3B2B9BA29A5F406F1A135D46DB10C80CA11E1C
39C9A74A18D8EEE86C85556F8B9203E00DE0B1A164134E48FCE7F37AAB98A79B
EAD809EA81192ADD3D3C6B35E521AC99E190262E5454C7170B081CB8AE338D09
D489BB694D228CE9C05DA95297BF106A3B71A99A5F199F122971F5C4B0B9C53A
4344FD111B92AF456697E0B85142B71FA56802C392C886A408558A297EC3C717
FB803CA1002361034D40420699FFE3C149800137EBA3AD99AAAD74B471038675
8B073F692D278E0A088D3F51360C2C79A83FCDABE9963A4D636631310E7C6D35
EF02828CD45CEBF9892C2761D934E07AF32BE74852C13FE63BD3DFF3619CEFA1
25F5FAC01306FD99A573F0F5F29116967FFA22C9236EE8EB052488C4CC204855
EEDB80B30838AEF66DD960389684231FAAB83750575E4C9BAE860D9B0F838927
791AE22921BAF254FE561771B7A9164362D6BD462A82763F6D19737ADA1C2B92
BD72443D7521795F9D3702F83B04BCF992667CA255A3AA539CB71F25F2D0ED57
9E0B180D1C199211FBC17EE282E7CA9E078593E6340BA651AB949482A0760790
E4C3F1446653CFF964B9A3142FF4FBE8C75CFBAEFFEEE1810D38033CBDA2FE9F
B42BBD97740EF0C118C7954FBE81FDDDC74608D036A3BBB75EEED4E1A4A56381
0F57C993C4651E4753A27684D170EBC495D09202AC0CDC5F10267EF26EF4E7D0
908F4524C91AD27F43737253BF0617559F2EB99EB26643D8C28B61F8968CEE7A
A79A818887ED9BC3AECE4A35AB15752A368D09594F93B7A741282DB5C6E42144
EAD79AADE23733A43500563C3AD34E0421D1E3B4642EC1D70F0054E3DB6CC218
FF930B11B1CCC3E4C90BC523D4635161C89CD9FF8F2C4F6E4127ABF479914610
4D95589775902AE3993E1CE3D4868A1055BFF961CCB244AE25C76C4CE556B8AF
98129765EA10B35FFF3D24DE1CA68BA55E133084CD2562832630E302C3823EB2
5D7293D0C760EC1788BA6BC9ADB7AF6DA83C951E0A23AD98EFAD64AD387F7764
21320EAA8DD04EFC4C2BC011185DAC3DC1FEF1461F3F9ED515E2240433D855E2
0229E1D5269092D0FF790539D2946A608E82E1FCA5E3A1254B27AA134C300FFE
C7C724824AE8B8436577129608078274BB69FB6A026D0CA48B97314F596EB375
390574158057D3E1C3EA4AC61BEC73F81C706A6C7A9B42EEACD6A4B5C4E69FD2
C68AB11CF02CE3D9B7148BAEC69F92FD7DAF6C9D772BE60AD4579BCE18396E4B
60EED65E6E2E62B283F135675C188F58C831B3A7ADCACACD39871EF8905B3264
567AEEE25FB31D64C6596D60597315F1AD8F74E5577E6C966F8F65B001850D1F
39F0234F0478F6DB136F17F20262CC072B25202BCC8A67EECB03A2834136EE5E
8FDF55397F3572922DF82D25376DA73083419420003E99A020198ED0ECA44A72
DCFF31392F59E14720BA027A5A5E81B3C32BE7DBEE039CEA50AFD5CF9CB9080B
3952949A3165C5AE1EF9D8C76E0C901DF5013469D55C8AFE1554A74D6C565533
FD00D77FAA0311910C9C191ECBE1A0FE30A4FCDC3909D4F6322DE2DE90865099
ABAA1A087DE9B4642DB649ECA28D40631EBA0B3902EA6D70F9260EA9DACBCE35
8EFFA26B2E8BF4567406788443950D8A71339F595C83E28111FC90181AF60EC8
9A7EDDE1989A2678B8C570F5D0BC178C4018626B9AC851604F03C98469EFDFCB
BC34589B59973E918756A2C1BB7D1811BEAA17D193DEA92EB273D50AE5C0FC30
661B330B083311E5D971D70DE46E2239532FAC9A6D8FD913E6DD03F42ED6148C
4F04E6D136D41C24BD9B973109A9B63233E51176EE64D247DE1C5CBB43F568BC
DBD5A6AEDFB68E5A0C8DC465E9949A96665AB78F41132F96F3680B5A9A79DC44
828FBDA04368F277C40F629961EAA9F3B253276EE252478A9F409C2FB6447C65
37AB9FC9A216970D7BF6912FAFC92BA0C000A58950291FB3E47F0DFD493EC7CC
A99555CACEB7EC87F4250AB92E7136500138087A19053E9152B6F007B8D3DE8C
96224FF8D464BD3289C08AD1E05B9D063375F38FD42CE97ADAC4E5B83B8A88D2
B2634B95A0DC0AE6A407E62D153BFC434B42680FD0F62F5FCF0818182F182D1D
6B9EBD47149F8506CF38BA61D8AE460A8B660F40DEFBC9243154E5683EA8D574
8D48276FE5128F972D96E42D89E374F7D8C72E70F84F028263507BC96F6B2B92
EF4B992CA46361BA3EDB888A6E5C57688198EF10A616F7DCCA55B4E1645FFBEA
C2201D5503101C400B147CA23A805AA95FF059120C677C32ADC486DCA6E775EC
23BB704624D3755E09505C395CC3AB83D68F10E2D6E1497BC179F3CA82A3DFC2
38275D10D3253264BA9C32DA47C0088660037C7A789C1DAF75D0476BA9ED5B62
CD30BA0E268DF3537F8298BDDCA16B1C970C2863B21CD839FF6B713438447A4C
C58C1F0ECE39E126AAC2353E31B6FB808253501CF26AA3AC48433D4CE5A946BF
10347C814A195929213655345791FAEB7986B1DD4F2B0C9E7116B11A4F1157CB
933B48B488B7DFE700423AD4FAA7E26F003B87B6255BB607A3A639830D68D663
A3350CDD992B528E3D2176DAF79AC03F6455B1BD626ED15299042B46F03BB46B
992109329C6F67F1CD92A620FB4D806558D6CFDD75DE4F7D6C558CD5325302BF
ABBF40001F90CC940511F63F32F112EB958944E37A603642C0CDFC7941D9EC65
F1F5B2805EC17A6662FABEAC3F1A7CE8A4958D64FCD57759F5CA294236B5834B
0071972DBCFAE0D89A1BA76FA1EEF2C8ACB12E45C8D8939B3EF1DA3970ECD2A3
30AE415757A89E44CED997FFF9F6378FDB532ADAFB25872A690137609D91405F
4FDA7B432D432325F1467A7C85363A9E2825F86D5B9F9523E53FC5B58D82CB28
90D43D172B2CBABDA71E5B83928A6271468C197108584BE45647AF5C9BD930E4
18E321AE20B3D28980B1CA53F8B2696043BCC4C925F218B0AFF8E8C2BC1B85A9
134BD28FC51E5F4E803761720601C5D9D87921116C342D832BB14EFA08032E5D
7C0C4F14F118883DBB1CA0313B6658E3BB5A7ABBA4970CAB64E66515031BEEA7
F0311CD7DF8CCADCB38103DBB1D60CE59FEF567B2755D0A65100C8F8EA622025
4AFEC5D179796C4F87808A76B3F420A228544CC12427AE7A5E2FB6CD76D4668D
BD5A22FF8161EF3FB20EE9FE64EFC4D1E466DEF81D20A395B020BDB7358E80D0
6CCBBB8725B9AB973B060770E4CB902F429D75295D1E5ADA0BDC01D0DA7A4ED2
A21346CC735F3E6662B87BCDED41C39EB2174C5ABD9C89A4A6554B3523E08BAD
F208FFE1095E6641C548DC0B7116851695AE8813E691347526DA61EC59DB43E1
03BD503968825F7EA207E22EA04656780C15E1E9D0A00CF8CEEC4D3FD48A4E93
7E82A2D0F952F5ED616618739ADDA48480DA4665526260E4269F135C89C2F28C
28B435A1A40C924B79934D6CC536A58D2F102CB46E4C3F6F5390008A7C7B5E28
4044E385A5D6FBE641B6FB074C4E15DB9D25152E503EB7DB52F45913FBD962C4
550310BC3592CF1C56A7E19A73261219812CA9A818856901E9F0FC46FA53FD67
20A7AF35375DC845C8A9BC82F46C061F46233CE3F963C6AC49CCE0936A1813CC
F7904CBE756A07106AC3D9B58C28EB405FE50A12710C7FA7B4F6900E163125DC
43672E2C565C6959C412F7CC333F49E0FF5B1AE666E0770255C43E1779A67D7A
BD794057140D8D1478B7B3C43C84C2C2E56DCA12A1A536F80B16BF9C5244FFB6
906F2729E0D6C3A6AE9A837CF39F81668CE7B299F4EC9825892A961935E4C81D
7A9FE5D9431283C53770E41DB77A70500A9B21D63B2F073D75D8E11579FF7C63
3D1BD1D11EA3C49A594D1D83A733ADB8D887AABCB81C32E3913FC4B2DD1DFF11
10C193CD5D5D5FDC8080F9B99C9B29A86ACFD94EAC9E052790D6A46E5A5E946F
6AB9541056CC23323C09CBA556F1B0F28BA2C30E039B3552DDBAC17B9311BF1F
648D3527E8650B3FC89CF81256E9A4A9054D9F1A9839BF7E0B875D25EAC8AFA8
2B5663DAD7CC7DED3206BF5957291DF837535DB23BA63F9F7ACA7141E1490A68
327E35FB7888C160C2D47BC4A7CD84194FF52646DF43AC83A51489481CBA4D20
1E5094E7AC3EE66A5828BF1D87A530D7786577F164AC3D5C0D624FC6CF1DDFFF
C2
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMSL10
%!PS-AdobeFont-1.1: CMSL10 1.0
%%CreationDate: 1991 Aug 20 16:40:20
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.0) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMSL10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle -9.46 def
/isFixedPitch false def
end readonly def
/FontName /CMSL10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 40 /parenleft put
dup 41 /parenright put
dup 45 /hyphen put
dup 46 /period put
dup 47 /slash put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 52 /four put
dup 53 /five put
dup 54 /six put
dup 55 /seven put
dup 56 /eight put
dup 57 /nine put
dup 65 /A put
dup 66 /B put
dup 67 /C put
dup 68 /D put
dup 69 /E put
dup 70 /F put
dup 71 /G put
dup 72 /H put
dup 73 /I put
dup 75 /K put
dup 76 /L put
dup 77 /M put
dup 78 /N put
dup 79 /O put
dup 80 /P put
dup 82 /R put
dup 83 /S put
dup 84 /T put
dup 85 /U put
dup 86 /V put
dup 87 /W put
dup 88 /X put
dup 89 /Y put
dup 90 /Z put
readonly def
/FontBBox{-62 -250 1123 750}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA0529731C99A784CCBE85B4993B2EEBDE
3B12D472B7CF54651EF21185116A69AB1096ED4BAD2F646635E019B6417CC77B
532F85D811C70D1429A19A5307EF63EB5C5E02C89FC6C20F6D9D89E7D91FE470
B72BEFDA23F5DF76BE05AF4CE93137A219ED8A04A9D7D6FDF37E6B7FCDE0D90B
986423E5960A5D9FBB4C956556E8DF90CBFAEC476FA36FD9A5C8175C9AF513FE
D919C2DDD26BDC0D99398B9F4D03D5993DFC0930297866E1CD0A319B6B1FD958
9429B9D40924DC059325D9D4CC0344F3F997A99E6CC0676735EBCD685AAC9142
08DAFEC78BB41AFC2F1C219910BDF41D6279284EF600B69776CA15BC8A34347C
30783C52AFA60FBE3E353E2AE354CF87B558776A22C776C7A0B5AB5CE1F941EF
C2D9CAC37294BF407A671F10E4743BF842143F4F7DFEE643BA3BBD8BB9E3F24A
BCCF7F0ADF8BA500620C81033EAE8C4EF2C1DEF13AC575F1B3BBB66F093D3B78
5412B82B67FFA087AF57182B2230F9F2137180CA58A7D9B2C822FF04BE6CD01D
43B2CA7058C7B953F6D9B5D6E91ECBAA5CDE1159B0E59C83DBAD96D6C8C8BAB1
374EF652D10C0F3EE7104472C98DD3572AAF2D45A70BF7061447E21EE3C3BF23
DF39C2D1B35B42CD5297BEBE6BC94F7C9DC6E61EC67E4F677256FED9064BD3E4
B51A71B1D27CA4E5AA9E1D8080E6DAB5310711EEF87C40859FA935B19524AE83
63B163FA8397BDFF443227FEDF7DB27DC35D89FB1C5E435DA0619A5C88AFC73B
89A2DF5E767C5B536BC7167A840A0C32BD57A14DE69A7D0D819AC36FF32F908A
5070F32983BB007437E3500799DF5E0AD3710A4C0000F0098D5BE99F2EB9C1C2
C444FD9552D0DCA098A94B3BF176F511CEE13DB7EFFAED7C47B5ADCF8D4700F5
7A5FD1B49560969BF5C44F3749370663A04776F749DDD7B50674D93254426C4B
EFE264BEE7810EC93784B7C01A7F29EFD92547E13A2C7851A2E709FBD5B87850
4A44F08F56A542DBE072D2FBC58D9E6468E1AB858DC35240E30D31C7AC13D6C5
7D2BB634BEE96FA0E10F842B11A789F72A333DD6DDCB1BC23227EBC406E50B40
30AF0C48E6359AB0C46898CDAF1118E46BFF8B00F54EACBC2AC262AB898C42B9
2E080C10DE923C18AD2A2BE7ABFE6A00500618FACABBD844A515F5D7C7F7213D
7084E7361377127944EB80BD687ACC3F3400538570CFA3A299054F000E0390FF
5478FADAE4484DB8477D6E5E843DA9465F52C8CB88994A2DCD7BACB89D10EE84
516D7ABC25A54AC996D6EBDCA47306CE267AF8AD5BB041EEB9F4B2CE4EAACFD1
5D1DB53C1F07287450201D43E3AD980A644F39FB1FCDCE21711FD48169A9BA08
EC2A65050703540945FEFDD28556DDA2FC55F7D7CAE89F4D176FBCB9A08A7BB0
9F6F402A5087641EC7DB75D2CBCACADA9A373AC28AA030584C930A4F787C0D6A
2E1F7B837C949DDCF59E188349BEE6721335A3AA15FD72464171B978C66C24BA
5F94014AD374ACC4DB2D6C93D3C8FE5091397FBE134513AE4AC018EF044AD529
02E2336906FE185C146C54EDCB967A7619E4403F9CE78491DE897A99715E0724
028CB94B23C8141063150EE57F90A6BE0994D689C8545D763A8C60BF8A14AB1A
74FFD3FE096003CFD3A7C4BB8AF842BEBCF18CB9A22A575383956D85181EAB6E
C2D44AAB62708F00DEDF1488344F09D1D08B3EDB11D617A161A473A7570E15D5
600868BFFFE8400320EF767806653ED6857CD72B6F038133C56AD7CD47A7B38C
9B2D909F4EAF9958CA3CDE2A6227254D968E72E24D3005E97C89927193F648D2
D2FE80F2845860B7C3B3F23570A2C1C5BD6348B905969E3322E72510696FCFF2
901F55946BB66CFD2472A24C3093964C546ECFDAD7FD28B24EFA1ACA58EC7BBF
470572D51E602B8AF8F42F8043D9A39D7598B61CFB7EC1E09E1FDE59A3AF2EE0
6E402EC1335C147FC7050081CB486676A355508563FCF063646D7AE6224E0C0F
397CDB78934CA760E52E113AEB044F20AF17AC32AA85C319A58541BB43313032
7374EFFD2DB344A77995A00ECB28192C3D65124F40A37E8CB3F6660204FBF2AB
CD193C8A1F199F1E92196742CA88926F6CEB7F72BEA0182365AAAE458A163A41
3A9F6E8EC5AB9F8A73BBB46591F87371178741A97AE3B39EBD8280491FDF2584
1F412CC3BCC22F2F7892A194E548D4B5712F7AC3CA4C5D43088FAFF53ECA3892
65C6AD135E9D3B75B7606E259DEEA083CB2E9C3822B2B02C4A42A965DA50C3BD
7355FB5738E25881777111280AE04BC1273698F7BE40E33151055C8DB4E2F38D
F6A6BA5DF17D13494B2739328FE2544C893A43759C9D615C41E85B423DAA600B
4DEBFAF52824B3D296E1F47B666E2326FBE1CE1802252939F6EF819BE3A9338A
EF3DCC2B84E3DAF00E7C0D45E44840F8793BABB055C561E0928F7AA01B5955CE
E3D94A281F2D47B024D2DDFD1BE0D39263D097FF18662A63EEA49594BCB4F66E
0AD12249D6FBD2F0B4B51411884C235A64AE1E698CDFEED19765749F1FC5C9E7
BFCDBCDD7F23D394EE73F2B73C65F0EE1C1FBB4000D63A2D1947CD869575A429
65A8B30EB7019F74B2B2048898B27B0650E2D291C8D3337EE09BEE0A8421E2DF
0D986E66F97EFCCA660606F0B0A7B18339FC44C75134D8630C74FD296232B686
47F3EFC94CBEE564EFA1CE4BD13947B32AE6C18C198FF5E3250F0BCE7A292004
6DF7BD82592128AF3EB9DA27AFEF27878C75AAC551A9DD748DB7F58160C33C51
3B28D39C1783DAB4696FD05D00D9A676083EA828D833649055CCBC47D14234AD
F2CE3C0A887655FC28EEACA2EA3258DD0237E1693F9E6B59815639757EF4D63E
837AD18BDD32B8E75D6AA862A057AEEB7201F5FED012C2C1FB3D9CEC057D3E23
5723187BF8E37A6C8E7C0A4D19A78654D07C72725AABEB05958EC35617411FB0
E66D2BBB10216B9AAAAC186CAD162E0F9D9953871816F1FD1A5423F43B2BFB5E
1AAE96834566EF0297E2D69CD19D6232CA6D5B6E9E9B7855796817F0DDCBA391
B523F461C746120683CA7F7D123BC715A1D1C4567EBCB3B27CC2F66CC022555C
53AE7E06DE7B967D6F0708224EAF72EA3C4C349C6C1DBF4E3F9EEDD8D344FF26
E0587F50407EF2F96B9FE5D4D1EED501BBABB525E43B9E34B1ABE4B4EE73C296
CE2883BCDDADF33E48C8A879065E0079A820107AC5321F61F7A1BE6A9706EFB6
598C0FA5F0C81C9E48CA22F86A9F437068711CB834D90CF79515BC7074C0E2BA
30E0486B9EA0B3DA075D6FA4BA44ACE3031E166F9BC8D293683C1D3B94A2653F
442958E6508B00EE81D879DD8EA003AA418A09893AD298C4708BC328A0A21A55
62177339C36961B86AFC97EDB88206DA6712353887FC431D60344E483212AD4A
DF9EA4632745674A51067E5F308343E5D1B5845FA6A623BF4ECD000B368BA9B5
9400034817AF11E3E4A5F8D00368A93E5D6F1FDBC3CC4B0065208B275B9858BB
40E57BF7C98A4E8158E84538E7541FD3FDFB11A015951187F875A0D8C9B7FDD1
BB3FDB57F4C1D89B547369E1D52CF180C7C57F1F4ED0F93E98BDD54DE02B2064
30D15CAC1DC1FB2ADA7D048AEFE4290B7F7E2AEBFB3C7D41EA1CFA52EA515C07
520A359529A88CCBCA53FEB15FB263D01CF5DAC4096A00E5C6482841CC42AF26
601A8101647FC35955587C768B7FBC7214098B01C53092C4869F65CD1E0E8616
D6166662CCD0E2DBCED327A7C8A65F2BE7A6F2F5AF70C6722D3717C150F4BEA2
C50CFD52C8473E80197084FD6220447C562981C6ACC17A833B6D88E3539D02EB
84AB15E42E4DDDC5A8F8EC091BA226888EBE1985A465DADE44B283B7EC620986
1D6C8B22D7D7B5FFD77185643146D49B6A5EC171969360AD890CBDA38F7DA67A
AEB2ADDBA1EAACAF16A2C76080764DEC104C99359AC7B606197DEC3F91985097
0B173D6DA02759B3406B1F05DB46A51DCA1B6A4D1BB709F5EE1C071553478ABF
AD71F1A99A6A8E488B32D0575ACA020AA97D9E107FCB5C7BA9428CCD04EDBB48
A1346168107718F3C98978CEC898A3494D96C724C355F01C04FD608CF1B9206E
8507257264443BEECE2C8AD2986A5ED9CF5BC20F779856E29BC9D0E44CECAF16
38483464B050DF21DB51C9AC852B60362F3FEE49F54152E794DA4BB628F1F1FC
0C7700599029ACDAC782DB220CFC678E82C09E51694EE72E821ED4CE5B524F38
05ADFD38982E5B91313757B55FF58873F8FF594E177301904C33BD54DBD196EC
437060F04CEFD4648EC5D6CC04522885ED6F1887393B6E6836F3768C9207EA1D
9CCA8B396BBF77D4FBFBCD401206B629AB96091B729FF137A152BBC0485E49C9
A0BA737BAFD17F53F319C202A90CC8153EDE244AB5EE452687C496C2E77FAD68
21DDA15C279714E0F6864882FB357599424BC7BE8695089F89C76F12818825AA
8E1BCE2EEB1E038B02ACDDDE39C803DF4C8C0D38228F852A1DCDCA97912C59B6
6C3CC7E533CCC630DA6920C04217E141E2F32AFEFC294A58AB3C95B326EF98EB
56E3F430BC78AF90D61BD5E810C9887877E93DC4D95DB2DC1D2C3C07D9BEF1CF
EE6FE5786CA88765C0899133AED7429395326A22D822027A4BC0475FE2F74EB8
BDF61C69C950CB72F45A45F95920E2412B8D776C6E8BD6338D3AFBA07793F4D6
7AD4CEDA52B8CA8BB8CB29DB49F8D5A920D1E167242F26C7D51FEE79677FC4E7
0E711ED65A8FF70517BB5283E057D8C8B1175934F9567C4C7BF479839C2CFC76
D990522E64E93579625F51A8D85B5CA4E3DC5ADBFE802F0B835F664572A2AA40
2EBC631BF40F7F53C12E1156048ECAE68DEE3BFAAECB70013B7DC4C2ACD5DDE7
D64C094E0FAACAC86246C5B9D522F483189D359DD65337DDCC6C4438615A99DC
1936E0C20D2109B3E7023F019BE2F006D12B5AA643C7B5443D73B7A3F28B5B7A
D8B8417E5B747A27FCF19B5263D542D6F2E02918E0B7A3574050641104FE2711
33E011619A91AC3D293D98EE25C2549C895FA14F749E76BD4E81F4FB055B8FD3
F2F65DA710EBEEA9AFFA46EBD7193F90D3112397A2AFAFE84CCF9DE1EA2147D1
907C47480FBECB6A6EE3BDE00C63187143E74F35C2027714B30FD5F09D80C412
BB820C5A8A30F3F11D395480FB43C20ABCCA913E6EDAACF7338A68EC3277A344
D571E1D2CA0675C197BFDE9B37EA3AE6A43DF326E0AFD91D9514A962E44617C9
AF848839DFEE22086E4EE1077403E9916D32348D4810FD973B7EBC4086700F29
2F62B0D59571A52A88E6E8A64193228349E288173F794312189F2BD2E1FDCC97
6881C1921FAB253BADE378D303BF2277DF8BE6D1C7A56C36C6CF3D74C6520AA2
37333C8C0F4A8F1BBDA2FE5920997235C8C8651519DE875BBEA6BA56C065AE5C
6F8C1C6227971E3DA49BE96C70263FE2173A3363585096B304DA49E46BBF6E34
715C7F41D56722C326CEA609CB72907D0732EBF080B538518CF0CB0635B0F97B
625F051EEDE437AD14A05A84DAD051E3425871065E4A2615874C30C0149837D6
B5A2893A49D062658008FAB040D27101F1571AC352ECD9672E2A30027E204EE9
433676723D012E8CC81569EC240B50C4902C5D4B30259BA95B69E82D1B81597F
CC48B22EC65F7237AF0B0A1595707489AC4452D40456E1247080B58A98419EE4
4BC1937D64008ED2B1E7C13D7FD261BF3B63F65D7EBB05A00F057D78554AB6A0
9AD437F65A25158A55155A9CBB0866DE98A2EDD5550590EEF0E1333DF5A974CF
39E4A61FF9F8802F030DEBF5039F962133D952073494FDBDB161DE14A84C6B62
C54A5C749AE60EBD07A0C29842706B74B75BD54D5092694B1325A58D5CDED356
CC6C8F81133915F05995EE1885991D3B14CE0794804F3BF58D5CE83BAFA05D5E
A005736C32E209E08555E88798A225113FAFB91F3946B290859B52D94C011F9A
295A554C3793C20ED3E3A6B5BE57B533E8FD92A5DB0F67A048743EF6C1BABD9B
FE787A1282E24B098F1276CDE25C6686E5455C8C84B19BEC816D58A5642E1660
8DC4BF1D7EB903042F6B57687E6D9A25058DFFDD5A55D27B4E8E30ACA5C11A90
CBE71DCD014E3ECBA954DE2EAE0E96BA275E6D5FBB2114BBA5D4AB02F9693545
A2F3307783FC641D1767C8AC174B98876767E4ED9F6E22DEF90BF7BA35CE7173
C7471745C7E3FFC15D15C135A87F38E96ADBDF35A36E86A8C30BA572A4A22FB0
365A02B3EFFA2491C3A9CED6D76E9293AEC8724E46DA15312444FF8EEC21077A
26E54E8CD9B077C81EFD5745973DC67C072BE37D4B9B7C6C3E6DE4E74C035022
52ADA17568968E18CE102CC748D679219D070864B2A465D6F4A2A0A4A08887D2
BDF4865CEE5BBAE5C764373A5B44EC9B399387F79B84F5A85A5DAF403F64CD29
6497560F918AB1D65397363498FDE113D1C43085B70F3761D6CFF81C64343B55
113754EA46D2CC06ABA93EE3D388AD8514579CCE2CDE11E14C9C1FAD283F57AC
607BD42A8DBDFFBC679BC1B858A95F2A1F2BDF280E8A19C98EA5E5FFAD402AA3
F03F1806AF305F072CE35F644BB0C095D38FECCAE226C00B63D26E367234E1C2
12DD8D4D9CD3264A39749A76EAC7E03D389D6AE33B068B2D42A947C2CAA69295
CFC49CF12D9898F5A54F12525B668555F97EDCFB8B0701A14DD5EADC49BB8531
5D6D7A1A4C78C895154F4762BD3F34DA3A3836F1B52695A064530984FDBD32A1
D064359695307BD42FF880489735008C405B63214F58EE970DA4F171BA941499
EB22232F4EE7B4E3D6063CB4FD10DF9D6EABA14220B994E5BD8CF96E21F966B4
9CD5A96EA1DF4430C46B043BDA6DB7A3C581A67AAA1773E8208E45F43DE3AE95
8ECF8210DF6A0C3A69FDED35554CFAC2403BBF4BB808DE0DA9BC3EC57604F150
17169E5A4BA101C020203EBC7CB27168348087687BA16096105BBCC82A0529EB
6E39BEC21BB348A074A0F2532307ABE656A0051F1B87C2B762074F7EA6A2611C
42244AC5AC971E43753FBCA6C025A5B9C03E573E0A9B42B43C2CD0E9FAE39E49
62490710A8175427337E393F80DF3AC43BF179CB829DE6331AB86422FA498833
D1C14F83E443DE738C7A9BAF36531D6FE7274FCF51A152B6447B15275AC70345
A51815AEB0C014299B15E880D593BA8631D656F33A56B5FC851AFCE74EB8640C
0094ED50A6931FADB9C20C453690BA4D6EC88ED660AF05316DF2186757B7CDC6
FF37755B746DC9FE45100117F1B8093F96254973D54B9DC21AC8B430DB9A6A5D
6CD60B3C822958C48EAD747F3C8AB10F47B29382BECC04D96B24B343CE86E7BB
C0926A6D6DED8F9F5E9B05F1CDFD07501315DBF2522EDB572B5724413A8051F5
D84DE87C7D8C505256194D083FA9887166547D96576ADCB15D9A6A1A5886CBA0
46372FCB670C6E95E2EA81DFB3511134C0CEC3C9280944958B7FA2B00D6A87C0
D28A8C30A8F6D5FD6C61B152DA5D43F5525FAD3A004055212BBB225AB5601B65
D684E9B4CB5DB6493BDF74B1F75B12F33ECDD0AD8103F865A36F2309ADDD8BE6
229CDB25B3A922B591322257AB8A5BD62312758C5185D34B109317A6893CCC3F
BC668B9E0EDB1885D9EF6A6F1077CC9B025C66F4E20C0BD2326F82BC6097A63E
E332543684D7433A7FA613E82CFBE7D081B484E71B5A938FEE191AC8C9C79A2A
929E58EAA236E4FCAF87EF1A1DDE828A84D5D43C25F0CCCF3977C79DCDFEC056
EFB75D03777F00F5AE7833F0EB91BBC1B6EE60B9CB8D6E774F72745D21FDC5D9
472332B20CE5A9887550310CBA5DD35532E4E7A5C810041165CA595B2285572B
29AAAAF676D81B1A028B7D9503BD9EB46B4C2FDF24CE4FD5926E4FE2E53A0D75
167FBF24100706E09CDA5B76C4650F9CF9A44E95560CFDF63672DEDCA589D737
F4E48F28CB42582D4ADB35494B41A4D37CD59986AE9298E1B191538253677D54
E0DE24266E195A6EDD88B9A5FF4C6A64B20194E86C551953458637878E41B944
8299B195E848D4A51EF3AAB030AC0048C780A12440CBFAF8531859586C97E826
9FFAF28E8BCF0AA7188CD31FA9F1A4C4D96B01C8F1E64895F16CA9EEDE3B1E05
963CC6B45F0E5C5C5C62BFE4522E30CA010DD477C61FA989F6D0F1D3A17ACC9F
5A43F41A6015A9F942DBF8FDDDCD7C27B4FAC601C0415982E6FE6CEFA3F7C1E5
9A182EB2235D4136F11D6F408BADA58654A928B58A24145E1F4B0B996D93635E
AFCDA40907CC13D1C1199ABB4F08E015C8B204A3A6EBCA8EA9A2A7D3ABFB00B9
BBD42CCAB8753DB0CC5968081A27F638831E8A78EE7CD3FB1D74C9355517A1D9
3AE0BD6ED674F581B398F1ADAF2AC848413BD4AB04B606C7D45C55B736E3F7F0
17E77DE215FAD7AEFC628062E0E5513C9F7E629CFAB25E14B4E04C0E96689AA6
8F6034FDE0E206CBAA6ED4D0799A99B41105A5C136CE05CBE2700B7B0283D376
782D3518644FE0AAD2993CCA0CA08A70A6D42ABA5EEB4B0F8BC6F729608BAB40
9D046BE1BDA44A9FAE8D534C365D0B8E6F39092461029CE88B843E33F93DC572
B49C727AF0127907FCAA339808291BDD960A1D65F83A8AB8137D48BE5D0C7496
439E9952B2667D999916C770FF0F8833FF9FEFFA76FDBD8DBFBD8673D95CA735
28452636631B8717E5081A8B41A192836A9BE01B60D545EEAC2FFB961D0EB73E
7E0C5230E9AE38CF6754B6C6C9BCA4B819FA08CC989430B849FFA13260691523
A03EB48C15A50A3A044C29BE621C4F8C124B53B09425AB326CFCB449759EA353
B569DC0D6D1D7DC29C8B23A31F35A94CC47148033635C787E406037B1C618E31
E3B43A9402E60720457F60BB4D5A31FFE1777644B053CD2BAF0D55DEA14434B2
F230DD01934F90C7D3A20363058D96056ADE53FF93A84B6DCAD0CA78132BD6CB
8C3C2C02F569DE5FD19ECE80891582B445B9D2EBD93A8402948A2BCB5940C75A
9B7E35BA0A2F8D51F41D89D1D221887023521F707DBBFC51D3935137B07EBDB7
FFFD435DA22425413DF92F516AFEB3F40BDE4BF90556AEAA944DBC5D8F17BAEA
67DD983C2ADD85D37289932A6462B632725EA66E3A335AEFDC40C5533EEA296F
CCA86531DB67AC517090633AB4DD8CBD7D8AA219FB1D58BE0B12E85D10E618CD
0FC6A362B042C6B9FCABAB9EFDCE81702A0F8AD3C64E4ADE4DF40E88197752C7
C89B8481FA463C3845A4226DC7E7F613197D689A6956906D487195C167EEDDA1
F4761DED3428B835AFC14E6683D7B4AB3CD54E3EF8D0CD312D29AABE4A31DA9A
1E488867F8B981E11207ECD854E55DB368A9A5BC9AB5FDCAAB67C9F0B5C27EC9
EE29FBA4B8E195B8CD9D53D9B24E1830494B6085540F5467341D23C581FEB427
52AF14F88D590F71F3A43407521FEB0F6F6D3885BDF79C8EE7414346853CECE8
1AB8B35728A13632371CF9456A68C760155FFCD23D2029770AFE5DFECABE6571
15FB24827CED98A2E39C9F3D3C6BC168191F0A32E1D4A3A6EFEFE5331555CE4B
AEF8502F2D20F1B561AEF8DDF61FE9A9C0DE17E1847B8C18342682BCEA1481B4
2E03967B9393ED8F64262CE87F5732B2A8F5C8BBA53068CE14AC143A41AFE6FF
7D1BBD08CF1C89C3F9DA27436745AC6117B9C68A3410C1C0143A97F62FF7EE55
4D23E7ED7EE9C31EC1913BC091E45E29E2EE681FDE83C55EBEA07BA7BE6A8883
80E50B0820C2537995E2AFA62782DE1E30EA87A569AB931838BD7024D297A690
106179136110A244859F1D5ABC6DBA94EC87C9DB9DE843AD2F05840D4F90E9F1
91C41D5FD756E25FAD3492C463315A556A63D97F4CEE0971B8B9D1BB30A58665
FD37B4D59A10F5365E3455A3DD3A732E5734279B6FDA63FE903CD70BC04D1358
2AC8F9DBBAEEE92A8A933410493F9F186EC52F3304D50037C96A419A281541B2
ACC0E5A9BAC9B7FAA8E0BD99B5251259A1A6EC8D3BA47974B9613948516857BD
A3B84DF70AFEB122B14982FB1C3E88F6EC2284DB4B4C943A2854FF29B4AF65E6
974332441DD5C83163CCC2F174AC761B7C702AB6C9754836E8BC1EF7B6A5E7FF
9A86F51EA594E2C7CB13DABD156B477FFEE840EEA55129C3994A424F69AF08B3
97D1663E33175B1159446831411E2F8C8CCD531FC46BDB0C1B590A396A3780F2
FC055C5C752BC9DD17B1A4962727D4D255E5D6080661263244E38E1BE17043CF
4DB4CCA19DA7CDDD94988886604746B49BC36C73E168FE7CC628C9F6376D3DCB
B4DB779C0F29537FC2F22A5FF5DBDC8738D32973A64CDBDBD0FC8E956431E871
8DD8E33DF06557E28B064CE7A7342FB658016BD92EE67A6E1F5389E977A95AC7
29BA4581090B2E4D7D53B20F56FD9311D86A9CCD61D42CAAC4977674C8683193
948DEB37FE15675B798F176632D7ECC56D9D48CFBD3EF0DCCB540BC072F887E1
2BAF8767F80C248CA2843E9BD7D3ED9C693B6B2BF7769821A6E813518A810780
EE9E13CC85358098797A1B19CE476831D3775D0DF7C7B90A8754E3D91FDA2873
858030879318D96CBD2220402A008ED4040241138F4A7A0AB8E9356F6D53F819
DDEF5FA13FB03DCC0C82CAE070E54A17C72B04A66EED7E6CF236C9CEA7E0BBC0
29F6AC55678C3469F15189A585AE48156F620A2FA122B4F028E936CF5710591D
17C0BB7B6BC53208849952DC5184245FA6CDDB9AE599CA076F3AB8CE856E5B0E
9EEDE67AA13E8F5089C2130ED6A053979E0C62A104CACB2741089189F627099F
42C3B82D792D7ED93CD0D63C87F0FC5FBB74CE9AD5DE2D81CCBF067BBBD2C323
411F1845C287B87BCFC5CCD50DDFC6B906E8D89D4994C8188D1DC5A40B0AF52E
5E8FF0F22280DDB503EEFED2236826F2EB9F5C3A23F343DD129A3D534D28548B
F2B08FCD34D33AA861266F62EBA0AA48C85A0D4869805F235278E49D9BCDDDB6
7C293B8BE5EABB67E64247AD01451912A522BA99F82A1C50087474F2C2020CED
DED7584E3356566100B06A492BF76E6D0914D9A684ACF99AFDDF909DBCA11A87
72FDDAB73425D666F55884D53D8E6DA6B8C1D6842B809A01BD806B648652949E
A7D352FCC8BCFEBCDD860DC736CFE87B09D47267912558F15560328573F1E163

0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMBX10
%!PS-AdobeFont-1.1: CMBX10 1.00B
%%CreationDate: 1992 Feb 19 19:54:06
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.00B) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMBX10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Bold) readonly def
/ItalicAngle 0 def
/isFixedPitch false def
end readonly def
/FontName /CMBX10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 12 /fi put
dup 45 /hyphen put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 52 /four put
dup 53 /five put
dup 54 /six put
dup 55 /seven put
dup 56 /eight put
dup 57 /nine put
dup 65 /A put
dup 66 /B put
dup 67 /C put
dup 68 /D put
dup 69 /E put
dup 70 /F put
dup 71 /G put
dup 72 /H put
dup 73 /I put
dup 76 /L put
dup 78 /N put
dup 79 /O put
dup 80 /P put
dup 82 /R put
dup 83 /S put
dup 84 /T put
dup 87 /W put
dup 97 /a put
dup 98 /b put
dup 99 /c put
dup 100 /d put
dup 101 /e put
dup 102 /f put
dup 103 /g put
dup 104 /h put
dup 105 /i put
dup 108 /l put
dup 109 /m put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 114 /r put
dup 115 /s put
dup 116 /t put
dup 117 /u put
dup 118 /v put
dup 120 /x put
dup 121 /y put
dup 122 /z put
readonly def
/FontBBox{-301 -250 1164 946}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052A014267B7904EB3C0D3BD0B83D891
016CA6CA4B712ADEB258FAAB9A130EE605E61F77FC1B738ABC7C51CD46EF8171
9098D5FEE67660E69A7AB91B58F29A4D79E57022F783EB0FBBB6D4F4EC35014F
D2DECBA99459A4C59DF0C6EBA150284454E707DC2100C15B76B4C19B84363758
469A6C558785B226332152109871A9883487DD7710949204DDCF837E6A8708B8
2BDBF16FBC7512FAA308A093FE5F00F963068B8B731A88D7740B0DDAED1B3F82
7DB9DFB4372D3935C286E39EE7AC9FB6A9B5CE4D2FAE1BC0E55AE02BFC464378
77B9F65C23E3BAB41EFAE344DDC9AB1B3CCBC0618290D83DC756F9D5BEFECB18
2DB0E39997F264D408BD076F65A50E7E94C9C88D849AB2E92005CFA316ACCD91
FF524AAD7262B10351C50EBAD08FB4CD55D2E369F6E836C82C591606E1E5C73F
DE3FA3CAD272C67C6CBF43B66FE4B8677DAFEEA19288428D07FEB1F4001BAA68
7AAD6DDBE432714E799CFA49D8A1A128F32E8B280524BC8041F1E64ECE4053C4
9F0AEC699A75B827002E9F95826DB3F643338F858011008E338A899020962176
CF66A62E3AEF046D91C88C87DEB03CE6CCDF4FB651990F0E86D17409F121773D
6877DF0085DFB269A3C07AA6660419BD0F0EF3C53DA2318BA1860AB34E28BAC6
E82DDB1C43E5203AC9DF9277098F2E42C0F7BD03C6D90B629DE97730245B8E8E
8903B9225098079C55A37E4E59AE2A9E36B6349FA2C09BB1F5F4433E4EEFC75E
3F9830EB085E7E6FBE2666AC5A398C2DF228062ACF9FCA5656390A15837C4A99
EC3740D873CFEF2E248B44CA134693A782594DD0692B4DBF1F16C4CDECA692C4
0E44FDBEF704101118BC53575BF22731E7F7717934AD715AC33B5D3679B784C9
4046E6CD3C0AD80ED1F65626B14E33CFDA6EB2825DC444FA6209615BC08173FF
1805BDFCCA4B11F50D6BD483FD8639F9E8D0245B463D65A0F12C26C8A8EE2910
757696C3F13144D8EA5649816AAD61A949C3A723ABB585990593F20A35CD6B7E
0FA0AD8551CEE41F61924DC36A464A10A1B14C33FAFB04862E30C66C1BC55665
6D07D93B8C0D596E109EE2B1AAB479F7FAA35279ADB468A624BE26D527BFF5ED
E067598E1B8B78188FA4BCFB0B51692D07B0BEBB930C6F0997B437E2C51B876B
61A563A2673932C2045833FAA35DB22ADE12102335D5DC734AE3AC5EEE6658D7
92EB62131E1DFBA441F53EFF9021D9D4C491F26BE8F54C61165CAD778CE8695C
EEAF70E3B20C64D4C2B34A084B5770BAB2A974E898F62BFE90F132A37E2DCA4F
43E13DB13C94DFA8ECE2B7374827AE168634FA007F8981ADA046CED3448BF453
FCD9A4F194FA648F9FC0971734BB69CB73439CB0DD021D44A7C11BF295E81733
4DFBA460FF3D654F9FB337E99E6D66FBA87A817EB9CA1536C84833870E3626DA
55D48DE850D3E6F6B29DA0E7C9D681283586F208DB8D58042E3A7CE55BE84822
C98237911453E479EAB65AFEBA3F61A763B40E74535BE56C9D8D06DDF9441741
5C9D9D917439368736619717FAB4F06E2C329AE0BA411F3FD522D9C33AD8369B
D7DCC9DF993778482F35F965973DE876FA19E109AA198A00658AB3F0D8E3DDD1
08A573F2D525202AFC57E05D141E6C0BB811E1FE280EEA002B7A45BB363AD06C
318D320D2C81AA5DCC842CEF66E7DF7670588CB39C9F42EE7763A3A17372432A
173BDEF7ECCEA297CCDD76A835C36DCE9DB8F8CB66CC71B4920CF5BF055A5260
5B41A5373BA6E4F63C85671D979EA5EC30D22163E6D206168A3827F465279870
CA80E6632872F721BBCC622EE4214BF723551C846765495FA9921E11FE1A950A
53150C3F5D8595958A47E0B16064CC3AFD65DA294FFD111153F4F233BC5468AE
69585C16CFBFCA32C4B96C161F47B56661DF84FCD8ADD3EC086CFB6BB5179BC3
A5469A1CFBC8620BC711F42D0D3139BCE4E38698D9C574450DB43B5A19FA6D54
0368BA9F7A8DBF96DCD0B8968CD194264E6DD10A958846C278B8C2BAFE7AAF8B
44C84C955F1A89A13E62A054BC76CABBBF6296DE00A79CD7C8C61C70F127618E
9975B59A880685E126F57AD80F8F4D376E1B476BDFDAC868FB6AFAD9D694B561
001623C4D9F55366D053B52F2B09EC08B81901AE0986C5350312E626006038AD
AC15FE313FCEE1A2E61F8992AC00CA7BB7F997707EA377D37EA6FF35BFBC2866
A572B31491F9B80445685DBA5E62F166E80589F768FC95BBC79158C23B2F1BD1
25816F1486A64F76D99A638AC0DC101FDF390811B3C118C2D972B2E7587F6F24
7F1DB2DD922D237A7D18FF08FD665355CFBBEE799D3BFF11CD94CFFDBA3E725E
DCF4CDE4307E3B199D91893A365D04F43A5305BDD2538E28A0788E061F3A621A
B4A04E5063B47F0109C1693A284FA43E8F1EA9B68145FF51C005D3FA40713BA8
1879BFC3CAA881B9D885A0C1AA8BB9A8C848963020A5B15F862E7DCC78F25D7C
56437215999EB78142C128C6CB1E6E75EBCBB1E4614E8516FEB1E68400C61326
D9F9E8A41216901F77D9466455E2A0B45FF50B27B55A1E1DD4F243C92BA6B175
8F7695CFA1E91CDD8651AEBA3D258FFABA6280BF2420A98FA7CECD552D152CFD
A8CCC94C032087A28D68332769DD2CB4ECECB15717C245BA305CB616CC72644D
C78326E77FA602364A7B1630CA0BD0282FA781E14282982C1AD13479B6178D28
1CAA541FD3F4316F4FF81C53496DCDF5F86E0D7C870FFCD85B36C936B1E08D78
CEF3823546BE4329B97EFA4E2880AF3361C0DD67F77C8BA6F1CE3822B7FBE567
064ED0477949BDA06483F8DD04F891473C8FBF73A61F7C06B20FB8B5F0BF4B77
1429190979A4BDB29D77E94D5FB486A93B8B61DBC84AE06B4E06CBDA3A942043
9F9926F541DDE4E9B73606C3DE3E4E957C91D74BAA629641A6BA8E053FFA10E5
581F14FAA575EEAFA39C6534A94D0B1BD7A8ADD7B219900B9F300BF1752C4236
81CA46AEF5361701257648AB2ACC9825BD79FD6663507BED21CC7724BE327C32
5223DCD4A92411BD7FEBC5C99BFD4C77DFE394FB6D190CBFF7C94837CF66EE0F
0D98EF9BF9CC9B14365F33C78320085E763FC27DA1E52B0006A0019F56E35236
C5D3C182F26D23353CBAB3DF0625BA335B5B965A15119F1240E2D757837B195F
5B089B39BC8AE493CA98A6151FF1228EF46924021498A17AC49B68B8B555FAED
73449B45A818BB4BBD8A0D5910790C9824F13F5A0D0C07634CBF077840537E38
E7B5D57B328D192C48DFDF345B485B9ABF6664FB147256268155E04BEB5E2D3C
B3635D6821066F8118281285E3DE0E31DCD1DD130171BDA0792ED9E4588D5A33
E9703E3A82240D7CB225D971B91F4457AE9A119DCE5670CD46344C1E9367F1D1
CF9FB36C5541128BEA31BD0E609170433D0092487F28845A5B234434B01BB2C0
FA3F2E8562D927A5B25BE0DC8313029969C9AC313947C924800EC92FF63127F3
0AC6801EC1B0FCB6C82CBF7370973B21C9C77CBDE9226278A4B5CC752FFECF16
8CF30E7B81CE53C3933AC580D848F9CC7F3377E0BA5BD88905DAE82BFD42E1C1
069C8AE5FEA017F4C8C9AED30585050FBDE9F530EFF051A780E5A7F7897B12BB
E968204D5654BF09156BAFB7DF7ADEB7AE2C0B05416D085ACAB40333D10926F3
F5734F57F0ABAE2ACFFDD09DB497EFC9E66BEBBEF18ECCD13B09650857925716
B4ACDABA324721422EEC2DF66005CA076F3657A12537DD5AA5E456FFFD52633F
12B352800E09339568D2F9BAC471B58E108C990AA8C481002C442932469EFA8D
67FD87C9F4DD28C62EDE5C0D58EA1E0911FDF9ED05E032E3D138D01B63F27988
471935C56A7C7E77DB9E6A3044FE2EF9F721486F229836C139FD92D82057EFD7
E7FBD5DCF2F9889F31ABF09F119DB6C0A9C2D56FAE51962FA345E78D873BA145
A1CD40DF061187115093C6DADAD21C1925A83BEBE4279DEA1B78A0183E68DB58
70409542168F86094825DE53480D281324FF58158658D21B48104B83D6347488
819B637A785A8D353B506DFC8D58F57ADABD4B70BE468558A73CFC5D0FCBD1D7
ECD18F93FB4B5125C5DA18FE220B12CBD50A1ADEA8158B4C48E2DB42DC80537E
4DA231CE0464C56CAB8F59FE60393C4C305F6E1724126F765B54652B93C96768
15F572F786700305087B798177719B112B67BDF3EF0E708A48E8D6296BF3B937
A9288AA57C8243C6D28DFA1B31C331FE72BECA3916FD0513E85709684D3C77C6
4392980F0F2859D40903C3AB70270ACDCF7644032510BFDF0965B30E5FA47CA6
61B6A7D3A467FFB5405A7FC00134B2D5570C74C1E27F5433FEDB15A29C7729C4
AE8C7F7517718CD8BA705D76008CB471D250A77F7529AD67103FA172B2B482D6
E6FBEB44DE62F956839E878A52588454DD72377A0CE7DF791C2EB04D559C0B4B
5BC9CD13D4B0082F29D8C2EBC6678050F0C6982DE10D3295086ECFE64255679F
EF0C90170EEE04D0DBC091DAD7472590E5D471239B1E9B8477B0EAF113B6DEE6
54F55398F7DA7C64092F33FC1DBFADE12B23FE70BA4C9538DBF1C19F4B947603
6D0B7049820B90804D19A22B8A9C3452CA601AE21204DB55787A53AAD6D42AD4
9F2A2E849AB4B1F4FC726D0776520D3AF92AB14F3B76AD31E91D47E8FA5EF826
642BB26EB6FE1BC93675AA40494148AD957B2077BBE240C1DC145C43F53C6DAA
4C5EAB2C91D2D3C63956160CB99ABF21C74C7930D7C9207E4B515293DC8B4BC1
42DD53FB3DB8F793BC0298044BB2D9F7F8588F267646F0C72181B900B8840743
A87717DE9694EABF10976EA2FC141DF70BBDAA4E1AED08ABA4E2C386ED629E24
AB9157BBC4CA7AC1B4016F927473F787DDE44BEAB16319C8694BA592A1426213
4DFE7039D154E7A5A969FCC2799A7ACA0174CADD74EE4B85AC4D62E1965FB298
EACF6FCC737604E71381B924D00BF62CABE5421C98211C3C01CA517D4A3984D0
0F5A24306C30224967BCFF64516137BE52BA47B283A62816C84205A296DD2CA0
9F39B6FD01BD2AFBD06F66A45645662F5FFA5A3E0C35E6627211181152CCD857
B2037555F204FA5B7E321873BCF4D84B1FC7C2942EA9F943D199AB7C7B12692F
77D30BF33B3F90905C1CF6AA6CF7FE2D7E7ACD6C296FF0AC39F9EC0335D1B1DF
B812CE8A9D64B833E0DD307DDAF65E9A2B4E7E03E79229F4E183540846A3C337
B00DD353ABF3538EE6AE68D4DD7BDD3DA51B5097331BD48AE31EB303B66689B8
2794A8D350F0B588B45632725BB6E7B14D89336E71D744C2E3E3453BA5407BB8
8E9898D3D4D24A3DA0962FAA7BB24A66379FFB6F0AA077E3B01F2612BDC8DEA3
CE1BCB25ACC872A6C0A98576F9EA016F723A0AE79BCC936BEDF4C091BA9F4764
4C7D026ECEE22AC2FAA631FE4EA642570CD3AA905DD810F08F7FC8A9C26F17CF
95C05142A1ECE12979BBCD0F52C0E6CE766C904C0B0F37ADDD3D97154A2B3728
F09C77809BF1CF46E09AFF024993E7C825A777815B420E3B8997B48E969DBDC7
4127CF29407C0089ECB3D63F6FA89AAEB2E4AD2D8622A3E245C854AF13062EFA
C52C7929CC42FF622C13B8C13631D09E9BCA05B113896E559DE7CACDD2655C67
BD760BF29FA4C51BF674A0D5DCA5DA2EC73E6C6101149DF9FFCDC152E7142CA8
49F9A6277FAB6B35F42A35DB82A564EA0C5989282966A92EF9CD1A37264207BA
59EE7146905948A128002F70022748117950E2A706EA9851B337B3C54F6B948B
B4E92AC726D48C214924C86F27AA8D054FE6C9C471B0D7140CE08319EFA54510
6DD42EA378FD0FFFCE2458630632AD8130DFD8701080D5F73A0CBE281EE5C3BD
81F49BCB11458164A061EFB788F7D2FBA00FC53E40A99CEBA0D4A6D1FA5D0FEE
07F08CF70575185902C77FF048E67B00440115054959D952CCD88580C590EA35
6A0EDB91E90F8E0AEE102C2A4AB460257090496809AB12276D3A262608F356B0
45D393DD4DF0031335BC278C2992866FFBF0CCCA02BC37C82680888C95E51917
368167ACAC86ED36FD3FB26B2D17E375089C699AEEDA5B0F68D87C8EB6BE46FE
C4CB0F4FC636F6DFF435CFD510EAAFDD266D9BD57D33F71AE47584805E14979A
3A374DC19A43E1065D5E4ED4C2FBCCA6C3BCE0EE791BC30630E08AB40452DBF4
9D2A21B4B01F5F210F3BB42FF8C9F869115E7A0D78F9D2AF68C91F9BEA8DC210
03870231F666E31899B1A24A0757EFDCD4E16C2E383D690D04D3D57E1F2CC85F
D23AF5BE23B1D4AFFEE6F66C684B93916B91B64DD85D1231E3D60C8E2FBEEAE7
81C58E0BE8A0016CE39EF705F76D628FB8C08013D25B925150B95F7D0B814D1A
A25C71C654D4F1B5213E05CABDCAC794BA0A1B9251A123ED53C36AF2177EFDFC
6AE748CFAA85A25946B2A72D599A076F5A515E3D741BD7119FC61C2C75C8589D
CCD57D7A9B15E7279ED49EE50A9B5AFA22B902074B5D471A8ED71187982AECA7
EA542C62EC41C509D2B13609A07CFB15FB2520D04D6EBC1BCA3B0DD51C1EDEF8
CCFE5B0B5123AE854AA7BE938A8F8D809047DF93499938EABC1614C7714600F8
862C14E0A4C1767686DFC884E39A1C63B17870FBB98FD39041539E12338EC4FA
0BB682BFBFA5B748CDF535DEBA2828BA26BEC55B96868BC4FA6E288F3E1ED920
EEFC42896CC017F618D19B63DF610CA08FF6721446B8AB73D536BD3F5BD1794E
F89F380D0E3EB181E0A675230FC8353B32A1DF6E7DE4EECD1EA87DF72F3033A3
B48097F10AF413BB5BE98852AF7E62F088E885A86BB07C15B1A4497AB0C7E181
7BAF23D1B31696AD74AF642F36ADB05A14F004EDB1CE6734E7FFC8CA049AB6C9
5408F91DCDA00C4B5022C29DE7B6A2D1C41C244E771DA6D050B14C08A8E3C8B0
D089BB4B68164EF281EEA9B6CF58A7B74B598A1E30DAD1F73D05D1E77647A6D5
673C6B83A012B15F373079C30E72523B591D29CF5F7615DF4B5F6726915A5D03
6D8233D313B1F8DCEE93FA749EEC483DDD9AF0FC7EB8C879930BE3BC58515B84
BEFBD90CD57E8377E2EB2984DF2B1BDA6A6CB3926BA821F58F9BCBA8317C56D2
6D37DF6AE562900695DC31004AF4506FEFDF6E8D5804A63A59D176517910C784
BDD6B7729337C7668EC4E393FFE08A158F0592B746D6754F5A97E4312AA7D376
A29C7D43BBBB8DB4CAE338FD76D8139D6D97F97F95905909490B48D37B7BBBA8
D9A98555961E734822D846EBC665DE1792F0F0D942BD7DA2D8DD9AB29470AA75
7D3078C021DF4BD24F5CC9B12F0C3D1DEF9CC10B47B7A12AD9558742B47484F2
DEFA8B5077ED0191C15E89FE58490107733572AA95D643F4FBA761C5AF8E0D6C
3250D597317FE0BAAC5CE4072E688B388FFD7D7F6D1792985768AEDD8A20255B
44F26FB215A666FAE804204C23472876169608AFE831886F8EBBF3F84A9CB38C
D80226FBBB3C2B60EEF75F0E2C9A9A30F5618D13F0DD84B36F4F30A211896FA5
858248862E9F422E9E31231DE72A628EA00EABA81C59567D86F0E66BBA8587D8
A3A0133BDB30C74F2652CF75C7F247C7F5B01ACB9E8F892676A67CB7FA879D9C
6034BD216AA626EEF69C718CF5AE2B9215D949FB4566E39169C803A4122D7D8A
2F5D2A7B903E7A5013EEFE0558D472CCEAB9827620333E4B44BF44ACC1CC0E8D
689C9202A9E972D34ACBF7A1C7C97EF057D5575957272934E0E5800153C8DB88
E771DC89C0407DD9C806EEBF6BAC5A15632C1A72EBB047F2C6C1583A2D4F8F08
58D680B3F48738CBDC2E4E81B0BCE80470960073B5B0F69C62435F10FDD73C06
80A0FCCD1B3BB0629A62F1EFC982C4328B6486FC222133091D4AC153D72C3A7F
C1ACF5B02AF85F63590D95DFA6B1F887B96505AB280053663AA8E9A0A8D446F2
CEB9778334A1C8469F5DAA99734EA85DFF2929FC6C1CDA3D1984283D4F3C8E5A
D3DE3D61040654C0958F49FE50F737312B1B8B53FD77EA34B8CBE290BF448661
F76CE5533613360094C37932A6A7AD06E63FD8D02B359688E345E548DF53DC86
B16692D707E2901C0721DB5BADBFB271A7BF00F2F3F0EF70918E322E4F343CEA
D18FC6504C697E69EA7D6BEB73EA87AD51AB32BABF794F1B22A6955B6455C114
9A438671F30970682719974FD0B71B2B4A699D0430027B3D3E6D8478CE522408
BFC9FD0A559944D24955742BAFF646C98004AFBDD735D457CA34B400B5D5D14E
55466E7F6476C54F49D9C240917AC429E534C51C92A9B4E52F5CCA11E3E5D3EC
6A0A28B39C2C7AC684FA169914A7ADDA925851D8DE6C750222591B9D98E4A209
0ECCF91AA890AAB75CF3D8F0651DD9440C5123C7F81446112B4B556CF001682C
C660950D870234A2E96B373C97AF166027AFEB6697748F952C87360540B26105
E958B8A1C306BC1CEA926496C9ED819AF00EC1DD7AAA64E6EE21BE8A65A99CF7
86746F3D155D79AC812E1F2A5CF3C6F5FB9716CA5C9A8AC7E580522C311B2990
E289ADEE82099F2187F37CAEE490F807BAA4B520977A62DD017A7CF836CDE5A5
6AA4A7862E11757B5D67A28BB35E3989BBDA1AE77AB80C7E33117D6A9A353593
687B60BAE871DDC7B0E9A10758CFC7E3E972B51A8F1DD50546AF7C498EA487DD
FF5E9AC8D87F2485A4E680909C07CED7254B5FF9E5433C3CFC55286B1431E39D
D4912DC8BECBBDCE1B7FA21AEF907D5CFC56685FC47116F7F20629747F766974
95D75B64D0A6657FD0CFE9B56B912E7FBA38AE10EDD1E8C427772EC42CC100BF
5ED34DFC3093EE90D7CFD9E2ACD55D1FF31118B86BFC8ADCB490499F71946C1F
57477E88574FAE17B4DAEBFC8E100BEECB1E473C5A2F882A63F61B7826C3CA7E
44363CB33E5D8BF5E88F27F626B3EBB0C313D34B0BC69CE395DF99983E35D77A
2193C441E0107DFCCF424F49E3C7995B8A2C6EED7ADA45A1A33895E07F9ECE8A
DD91AA4F5758CC030D3BB0D7C2E86A1531E9F1EDE5AE52F12AF9E91EDF021030
6E69FFE765CE505C617E6ACAC1B3D2021F1DDF82B3CE0B7E9A68EECD246AA818
2BBC9992E440BF3B96384125EF21BF56BF673D0256BF647CBA2A538438CA8292
89464AA423C9438EE2235BFE98B57CF89B1B1CAAAC22343324A63F913D1432DD
44FDB2E1F60FB78653DAF52BA657E5A48DE5FA5B4A419B83D52EBDED19355B5C
FE6A57303C33413039B9C074187F2ED11E52074A6EDE22482DF46B624FA64A70
B2FDCE4D657CD67EB327D5ACA3460815649AB144744DA5C51BC6EC5E94B3ED1E
4F88997E850E1ACC9544239CA85A7D5C28EE249B966081BCFDB0D51B81EE6D56
DCB2FA5AB76D47BA98896B0D52934577760E231FE276629D9BEEF1179CDAE173
BA3E480FD2E2D1AF8D73509D1AA108C56E668E8A7EBA8B6BD4FF4CA54FF2D202
DE60493D82588C215EEFE423619700C3FD2BB73DFDC0CE2EB6EFE7C2184657D7
33692854C0DB7DBC388D061CDC20060E4076889A01D0FC9D6368F0227FA1183C
3E68DD3AE54B28808C93FCEF4F7C0B3555234C1B700EF5F9906B871B2A33F656
74FF5C9BA74ADE3B7DD08EACFD8252E5F7E00349EF090A0CB375E8E16C035BB7
9C25D612AA75843EEC123998AD8AF43960D55DED6653D8E881C6D6B6DE9624C9
6E9FF1D74AF8B3BB39CEA0F74E13B65A171F1816FC514A32D56A0F6D2947EB44
FF916B467361A185C9D3337A26901BFB6137903D9A89359F3DFDCF4F74FE20ED
C37A1B1FA70E64B910E9E234F92CC6AFB9CD343E14C360C9A4D8349C125ED130
EE506B5E53C74FD4DB539C4038A5E99CAA46429F02E3DD462F5D2A078E2E8880
3AC7B4618454A08C8B3C994489449A5DA7ECA6B80FC084053C65B4574A75A1A7
4A9E7F86FEBEAFAAE9EB8F10B6FD73DF6E6B1638CD6F73FA2B3AFA49EA56A2CE
751D167118B3073746FC301F5E5F97C0EAB8B7B5DF5BB27958312CE8792281B9
D62301C147101F32634E7730E1697F6C76FF342770D635F417B26682E70FE88E
A5178BC9F1604681EF2E5BD37937B5EE0AFDAF9845F25A3454F30BE34BD516AC
7E104033A567B4445B5BD6ECB3D71EF454E349BAF12C059A90B9BED8A006CFC9
A927BFFE206AD54351CB3772A33A83EEFEAC789492C95A15CF6ED00C9016E642
3D474AAF77F5E968CED1637F7B96225C7D769FDDD18B385E78AA60089D2BE218
14F2E47DCB504026811C1E1966754072525FC8554943EC9817AD0A7511F21CBC
49BA61D493584866C5FE4BCB22000E1F72D6320C7A6449559A9E085C10C3C1C1
3C69C0C355385948C822CB4CE2726DB4A78BC3225FC1EDA373C64DFDD4F3A932
C99C34F0048A3C8412B0660BC8E435D8AA311487E6766F203149941CE19B48E8
724916A0250AEEB0EA527CB9D7DC48EC31BFD11190F329FD642D18A4BB0E01A2
E6C59C2AD964A3EDDAC052FB2479401777E6A5AD02BF93FB0D3D4C02B8771CFE
95502A45F1E36516BE1715B4AF4B73021771E4808E5C95CF68E472DA9DD4C429
936DE6A73825DBFB6CBFB3287A2922926B80CCB38D51612027440CC1CF53EAA5
278D9AA61490D705A0F4F912C72EBC8E8FCF6A51AD580D483E3C5B830AB6A41E
4DF559E9E61B92D183B62B7EE4DDFB9AD14F244B19F6467B2BF210327845F1C3
B77577E2E2A206913AA4FE0D5574230B54936A34ABDAF521F64DD42274A8DFC2
46896952479D9498448B59DF3B31A4BF20AB11B425DF82F11024A09AA89D9BA9
44E7E118D80E61DBB935B2EE788E0A79FC95BF18E264413186533EF5F24C4518
BC7C75E83E12660CE2B2087851BB4DEF2263D647BCB2383429FA0239DD08CC2F
B60EBD65000D268A1EF12570FD0777405DB67FAB4529A3E4C4AF4093FD6A0A66
5684568035B9B6B39C8B7263AAB848007FD44692A4D9C1DC972CA488D8979F78
D984BBBBBA63594EAA2147190E82EBDE64C2B4116D43A9809A2133B6F79999B9
22FC69623EC865A27A601351B1CD9F2534FB692DC570611FA8C87EAA4380637F
7939E2ECF4DE7E78E253AB42DA597D724ADACD23163F41DC48ADFCE89E241923
4F45B563D56816079967D165BB8E6747CF9C2CAE63438D6EB7AFEFADA73C53A3
524B8F33D53205E2C22C857836E2C71A87C3CE545814EDFB4007A69E5786B8DB
54B91E072C602898DF9CF4D93AB699101220A7B7A68192BFCDAB82947F7E1A77
7B5D8B2CABE483B87D0DCE7C9AE04DBEB4EC3ED1C74BC5B4ACA1EE89E1F879F7
89D81AC3BE8A1F61C0F0316DBD0363D193149EBA185CE7C561DE05C3E3FBBA9B
9BBE1C82E1D4BFA1F38F7CA850D101BF3C4B6D26D981CC71C7C9035809D17297
3293D1C5030219DF943C42B8947D2D8DD8E1D63EA94F4E1429FA6AE178D317AF
242D813B967B677CBEA4197A3418D647A90BC15F13C5E448C74E6D3563D7399E
8EDA835684ED87775CD3955D69BA7E87A5DEDDEB53E898A30F9ACC5707067968
90091B8862F83E3214191165AC4FE1F820A8DC9301A12E0C9B1706F0E655AD9D
3863E0D6B5700C23E47F17ED9F8D99296D4B84CF381C5BA776D5C210D193D22B
43ECC441368D803F4DF51BB88721F2765FA2DDFE5227846AF185745222E10BE0
95C282B5BE11FD21DD470705221403C776CD2199AB378A1B808A8D8378B554C6
41FD8C08EF663DC9B69BE65E4DA7E784D5C009E5F5E339DE43ACEAA8606ED98E
F88C13CF6B104463E048B405BC87A01C776CE1E6DD3BD14DCBF84C4F04F2DC70
90B8D8FB1A7C23829AF0B4AEF88FBD330B5CA2C122FF88D5308C003ABAB85CE4
283382B16DCBFAA56FC90BEC0390D4E9D159B27FC4359560F0B3F2D2A66E5957
451D6A81889B299614E39F6F5DC8D2CDCD2AD0B2045804304FE4093DB8024F49
095952867EE708A43684090C3C08325950E5B6E31614FCB9BE4530EA4F7C85AB
CEB8DCC3CA496E59DEF5F4D159B576C67D0F4E261D67F8D63446643C4AFDD11F
2D0B1A625F93E45A43A507D6137AE4D25A6AB887BDF403CFCAA4BE8B4F3433B5
0492A4E82FCF71F0F81DF6CF1412420BF8B7B74C3510E4D057A6490BA235DBA7
E2EAF838F9F6338EB93F5A5EBAABCCC73612D0EE7CAA32FBBC06F269D44429FB
9C9F270E8A461ED57EFE97D5620F357B37031C17DD01C129E42B7C09BEF447D6
363162F1A326EF50C9339C532FCA859F155ADDA8A614EC8E083863D68084655B
B9D22E3198EF1476E7179201594ABF6AB55D9C58D3C27AD95A6ED28D89E30A0F
00896350907820CFD6E25B7B6A8D45614E3D92AA93D6795ABF514A58F1512D31
C97E1588372BF8F0D3A25E86926EE1F546A1A9049F01186A2E057C26730B2DDE
EC28EB6A9F6A29EB6F6888C822AD5A1413FDA1990737E554056ACAA6358B8894
26EE5AED75B3582E857A487A954390629DAFB8DDA976CA79970C1486F80C7C11
F4FC26EE0B8B18BD9AC1ABC684E546D2FA829DA2BC619EA1BDFC27492CC0CC28
C232399559A1D5706909228BF0CA06301B36B87C0B5C761B1AD05EBE4A7FC4DA
BE7C55BD3ABAC5095192FFD33D441120A6560F12D886AE15B0B1FDAC9730A7EB
E54A1FAD362ABFCF5B72EEB279A86A0495B78A8FE5338C3BCF5F0105C66C2674
1DC8919CC9BF9F6BDDB04F42D18965C6D1C525E3E45ECE744F722BD6EA835732
DD72EEC69CB42B634D5FAD83C295B184110CD718BE52B7BD4A170FCE27ABABA4
74B32012F20F359D3F3D0C1818AE641D5DC4722221609DC3A78E826D68061EB8
EC734E42B9469B715D78CB2BE74E1599A47ECAE1234F8D278633FB1EE2D83B52
A7AA6B7E588819CEE90BEC43EBAE93E511E4BE18436657F174C2ED5957590800
F35AD6671FC0A352B1562E042140D3668E1239C90FF717CFCA0EA4BBF2679B86
B179F2717C27263E31DCF3788EE038D4C6FEFBC918C5313546C8AEFA73FCAB0D
FA055D120659BFD99937CCC34D533A10B67BF498E2A52E9DCCF38ED40F7FC380
9F869127773514D198C61031EC04E916126227BC4611B8528362C78429C897E5
8943F4B4DD8C590FC1AAABD603D9FF15133B1729FFBB1A2B0975BFDA92A30CDB
3C3A59B7A6B5255460A7AB1F01DB3C651DB95A3FA4D79E8EF704954A8F52343E
DDF4AD0DC6FF258118274C23A470844E58385F135D812D1EDB742CE6E33855EC
53EBEE6F4BFFD48A2230CBA4F30DCFC8F86037F942E6A253F03C2711002FF4F4
7027D7D1C0475487527D316FA6AB9E1B1D04A56E818CCC1D106BD5D9D2858522
92E832FD5718FBF7EC656CA84FE2B2794DBEE834BA2145EB1148FC5D57E818B9
B7AFF6D2F2B0816C301175E6DAF7F276FF495C0D0E647F4028C94D9610EE2B7A
A81E66E07D2A9726CD469EDA81858F8C269797EA3A8CC018B7A6C2DBDD71E261
90E903120EC01015CA59F444BA8D7137D57E68672C5CED88EAE80FCF9E67C3D7
9B86FD5734278233C8E264C53C88CB7BEFE88BCC5384095154E3FC528520B6E8
94BE6C714F9E8D97E2EE980FC6EC8AB86006D9F9D24F90D58BE98982ACB96F71
C2D5B94CBB00AB07A1B132606A87B1BF710C9419EE196753E24E544DF7EE0766
D2DCB7CF6A2934B96D66CDE5CDBDD23DD60F163217F3372138E7B8A7FD206843
CA23986600CB3CB287BAFEA5D94479FA9ED24AFA727EB872CDF44C43E870E43E
0C9688D426F0C86794ECE9D133A7C32229ED93313AD008730C3000D053962330
C8D100E7F5FE25E31D0C590010427CF42A6AA682AB43A082B52EA29C6C5BEE05
2D69BD0400954CEF43016B51ED03B80A28A8A427A89F099EB2162E688373D231
E7E9660ECAE039EF1F61CCE716589A9BC2DE32CDA7C2D72292608975DE5B5F5A
41F6169DC5A8097530BB4AB624ADCF9900247498756A91AF1257A7C980A5272A
3C6BD101D2706E53202682D16518C0B9B221A90EAA867ECA1FAEA87205AC8648
413801CA4376CE0C7EB38A816C54402513E68A0CC783B352F0D5ACEB7E7F344D
557C8E732E089D7329DD8ED63F2A22AF3E66914F8907789972E8D5CF72865E68
43783B11F75566F28081B5B74C56F44C05BE7DF015143E9F05ED154EB1CFDD7B
A99F2F535A258A9C6C0E6E0A2D4B91DF0CA6284C5EEA3263C3BFEE493E21F66F
A68B008DD39AEEB566C4F4FAB93E8172FD9EB0E00C93D057534C2FC2DFA4E92B
BEB8F33F1B685044467019470184DDDC1EA9A16F63DF5BF240EFC7B3DC53D8F0
8C2C168C317757418EA33ECC81B136A3DAF4A7625DBB9DBA43D053364B910BAE
537FE379B65ABF70D6A5DE9613FAC4
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMR10
%!PS-AdobeFont-1.1: CMR10 1.00B
%%CreationDate: 1992 Feb 19 19:54:52
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.00B) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMR10) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle 0 def
/isFixedPitch false def
end readonly def
/FontName /CMR10 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 11 /ff put
dup 12 /fi put
dup 13 /fl put
dup 14 /ffi put
dup 33 /exclam put
dup 34 /quotedblright put
dup 35 /numbersign put
dup 36 /dollar put
dup 37 /percent put
dup 38 /ampersand put
dup 39 /quoteright put
dup 40 /parenleft put
dup 41 /parenright put
dup 42 /asterisk put
dup 43 /plus put
dup 44 /comma put
dup 45 /hyphen put
dup 46 /period put
dup 47 /slash put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 52 /four put
dup 53 /five put
dup 54 /six put
dup 55 /seven put
dup 56 /eight put
dup 57 /nine put
dup 58 /colon put
dup 59 /semicolon put
dup 61 /equal put
dup 63 /question put
dup 64 /at put
dup 65 /A put
dup 66 /B put
dup 67 /C put
dup 68 /D put
dup 69 /E put
dup 70 /F put
dup 71 /G put
dup 72 /H put
dup 73 /I put
dup 74 /J put
dup 75 /K put
dup 76 /L put
dup 77 /M put
dup 78 /N put
dup 79 /O put
dup 80 /P put
dup 81 /Q put
dup 82 /R put
dup 83 /S put
dup 84 /T put
dup 85 /U put
dup 86 /V put
dup 87 /W put
dup 88 /X put
dup 89 /Y put
dup 90 /Z put
dup 91 /bracketleft put
dup 92 /quotedblleft put
dup 93 /bracketright put
dup 96 /quoteleft put
dup 97 /a put
dup 98 /b put
dup 99 /c put
dup 100 /d put
dup 101 /e put
dup 102 /f put
dup 103 /g put
dup 104 /h put
dup 105 /i put
dup 106 /j put
dup 107 /k put
dup 108 /l put
dup 109 /m put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 113 /q put
dup 114 /r put
dup 115 /s put
dup 116 /t put
dup 117 /u put
dup 118 /v put
dup 119 /w put
dup 120 /x put
dup 121 /y put
dup 122 /z put
dup 123 /endash put
readonly def
/FontBBox{-251 -250 1009 969}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052A014267B7904EB3C0D3BD0B83D891
016CA6CA4B712ADEB258FAAB9A130EE605E61F77FC1B738ABC7C51CD46EF8171
9098D5FEE67660E69A7AB91B58F29A4D79E57022F783EB0FBBB6D4F4EC35014F
D2DECBA99459A4C59DF0C6EBA150284454E707DC2100C15B76B4C19B84363758
469A6C558785B226332152109871A9883487DD7710949204DDCF837E6A8708B8
2BDBF16FBC7512FAA308A093FE5CF7158F1163BC1F3352E22A1452E73FECA8A4
87100FB1FFC4C8AF409B2067537220E605DA0852CA49839E1386AF9D7A1A455F
D1F017CE45884D76EF2CB9BC5821FD25365DDEA6E45F332B5F68A44AD8A530F0
92A36FAC8D27F9087AFEEA2096F839A2BC4B937F24E080EF7C0F9374A18D565C
295A05210DB96A23175AC59A9BD0147A310EF49C551A417E0A22703F94FF7B75
409A5D417DA6730A69E310FA6A4229FC7E4F620B0FC4C63C50E99E179EB51E4C
4BC45217722F1E8E40F1E1428E792EAFE05C5A50D38C52114DFCD24D54027CBF
2512DD116F0463DE4052A7AD53B641A27E81E481947884CE35661B49153FA19E
0A2A860C7B61558671303DE6AE06A80E4E450E17067676E6BBB42A9A24ACBC3E
B0CA7B7A3BFEA84FED39CCFB6D545BB2BCC49E5E16976407AB9D94556CD4F008
24EF579B6800B6DC3AAF840B3FC6822872368E3B4274DD06CA36AF8F6346C11B
43C772CC242F3B212C4BD7018D71A1A74C9A94ED0093A5FB6557F4E0751047AF
D72098ECA301B8AE68110F983796E581F106144951DF5B750432A230FDA3B575
5A38B5E7972AABC12306A01A99FCF8189D71B8DBF49550BAEA9CF1B97CBFC7CC
96498ECC938B1A1710B670657DE923A659DB8757147B140A48067328E7E3F9C3
7D1888B284904301450CE0BC15EEEA00E48CCD6388F3FC3BEFD8D9C400015B65
0F2F536D035626B1FF0A69D732C7A1836D635C30C06BED4327737029E5BA5830
B9E88A4024C3326AD2F34F47B54739B48825AD6699F7D117EA4C4AEC4440BF6D
AA0099DEFD326235965C63647921828BF269ECC87A2B1C8CAD6C78B6E561B007
97BE2BC7CA32B4534075F6491BE959D1F635463E71679E527F4F456F774B2AF8
FEF3D8C63B2F8B99FE0F73BA44B3CF15A613471EA3C7A1CD783D3EB41F4ACEE5
20759B6A4C4466E2D80EF7C7866BAD06E5DF0434D2C607FC82C9EBD4D8902EE4
0A7617C3AEACCB7CCE00319D0677AA6DB7E0250B51908F966977BD8C8D07FDBD
F4D058444E7D7D91788DEA997CBE0545902E67194B7BA3CD0BF454FCA60B9A20
3E6BB526D2D5B5321EE18DD2A0B15E53BCB8E3E01067B30ED2DD2CB9B06D3122
A737435305D42DE9C6B614926BFD44DF10D14402EBEDFF0B144B1C9BD22D7379
5262FEEAFE31C8A721C2D46AA00C10681BA9970D09F1EA4FA77428025D4059BA
2988AC2E3D7246BAAAFB89745F0E38580546045527C8779A254DB08DCC6FB9B9
0E172209FBE3857AF495A7F2B34BC895A39A30F903DC6E3202D29AC110D868F4
7184CB78407B8B9D42F6375F67FD4B828592E4A977B9E71854D143CD1A9EDCD1
767CC2929E071FBA4C3D17500E28A23F697B5D5CC68D5F56EAD14BD504E07182
3FDC12F5404E74EC1C02AF00C1A6A17F958770ED4A024F5B3644DEFB61F2578E
56013D0B4E7CA3AD255E23DD63369A921D427EEE0E098E8148B16E8A5613A8F8
A5F1099E15AD16EC554B644DF306F0CF3571055A81F1B464529DB49E919F88E7
581066BEC4765E31BBE28C245BBF0B74610DBA30C63A71A4F3B60593A6B41C6C
636C980828CFE9A3362FBC02F1967F0F770A4790F90DEF9D56E0A76B0703FC58
2841E6E8D984FB476D4FEB960FFB6B386EC6CBB9EB83704B0AF63F38C77090A8
DAA165E6C6BC86601B14F8E9F504A9D578AF05128D8C1BCEA9D21057958D5DCF
63459352EAD6B4A2A666CC5D85855641CB31507F9E30405977B74356FE985A6D
541884CB65A4F5A8D4C82CB9D82846CC510CBD243E98A0011AD37A81047021DF
46F69D7C3DFAF2F10F1F0CCEFBE12EB70420BE90C450975434E223C67D24226E
8B62BCA6BF93B0B1373AF55E4ADD92775B2DF199B6599CB02DB64B2D6160BEBE
449C057B5B2D226E0F5D7CFB5C9A4A7184FB29A595E91252AE787861A6331FC2
6605C995D55120121CB463473A7CBD22F270D56CA8E0DA99832A468D399CB9F5
A1CBCF0031D99F3C4F4B78A0944BED5A7B1AE23E3A66EED453917F9296077306
06CFA772BE60854A30885DC5FB8417E0D3F7AB45ABFE186D877A377F5D17DD35
0FAB81745294E35A5DCAB20321C6ECAE276B63BB17366867F346CAD53E06AD96
091CAC75465BCDDFDE9C4364B2A8EF496C4CDF76B058E4BC1F616F6CF62FB60A
64F81BABA7A729B8CF679CEE01B1C985558E8D1493C03B834F3696E5511A1917
2AE7E16AA8FC516CD2CEDE020BC5777598165B6EF2310F4DBD54FE14071101EB
47F4B2B59778B1EA7DE13ADF46393E07DBE2082C2487944A71CEDD4ED7D3D877
749D2500636C3996A34EE0CBA770F6B6A655DCB9840AA8236EF3F6182E1C8997
395077D9DB15B9D0A2DF9A3F6042C94E6E492C965E4E8542AC4AF5B21906B6E8
4AE2B01C0810E38BFAE99DD83EBFF8E145D09F763B6B134A25A1CC067C6DC1D0
7286045CE90BA968598D83E5602ED96C72A424848E211C028CB344D95DA04ADE
4C5DADCE9009A72B6EC01E7B5CF8C52BDFD2B416F5E1833F514659D94BB2F452
EC4F2E65CE71AAF79106A0468D76D283ADD44D7DB5760AA429D61C1DC2E912C7
9446C19557A1D12E7116B765BE522EA166E8F0B604807215323DC5C2DB1F2E05
246873CE189E03FA291A961E4AD90563A8F7B0E08A67DE4CB3607C6ECA114DD0
DCE97976E208615F3CA13FC44041360086A4A173D5441D9C33A38013099F73E9
0FBC96808F7442FD4D56DF7C4F2D4C9B2301F7CE626B4C6C1617B8F1584DF195
F92FC6385070EB02BF2541307E4EA34C131815FB9028C118F4B792C4338F02A0
F6B5FFA3E4CD9AA4C95E7FE26CA24BB2B34C48857055B8EB53480A6CDA79B587
3FE3E719924EC7D32A92D77221F13F3C4ADCCAE9A13BCFCB5FD72DC40F90F396
ACED5022449E600D9F12A63C094F3E26531ECF9AAC13D3FD80F25E37A9FF12FE
EEF0EA34D23081DE8674EA19431153CEC8E96702138A31C19C05246995EDC3AA
6C98E2316BF65DD696EFC55816C09C7F969FFBDD771250D41657BC81F95A6D6D
9FCF05E485ECD7C6F69CD8755197834EC8DAB8C390F161F74832525690D5A443
B2E63941267E719C53CE707F9C0B7FEF30A238A88EC1BDB8ED7D379225EF7122
3B7C8CF4C130B89A5DB4513F11B8D3333C4FD9B33CE874C104517553E6DD37BE
320318774481CF4EEEC3E43FFE81EC9C5043AA9DF67293D72FA76353412F321D
1A80076C42EE240D3E65912F94578B8A2B4DA42880469451907FFEAFB59F265E
80AA5D5C32348F9B7CE6A6855CDEBB4990938417ABF998E4B433556BFC31219B
C2D8ECA502C967DF8FE4206274E389B52AD065E9AEDB067F2E6595D5989C4788
41BF327A1AF644D3C3C1426270168E28CF38AB046EE4893970D0566367650CE0
9656CAB7CE1FB66A23CD3841E0F37D4DA2BD4520ABEC9B781A2B9E934B50D554
BFFE5D2EC1A5D1FD36B1208365FBE15516FAD517FE5ABCB086DCBCEB50B7918C
E324EC58BC736F594FA4789B528265B51B79B486AEC5252471D5EAD0C552628F
988EE219BB95D00123D475E96A268E8793B053343FE518C86FF4A0371D394E87
9CD9890B65DD3B714FF8AEBEEBB77FBC08B867B64E4086FF917B8AA277E1B3DA
65E05E5BE4941717FBC76966656A5EE7CC4E1488ED1B4388DAC813D1D25C1308
1B220AB8A036DA4A3104B552EE21330DC917B9458699100283BBED7DE5634B08
E1E8A1275815A358B4C0D3787313C850999DF7330A5165A70BB5B5104415A5F9
733160B501075FC60DAF1C8C6DA3A674331DDE8854DE916DDD0491906F4EBB7F
6AC56C4A9D6132320E2E021CFEA843F7C56203E943D3A9B12D8321EAABAE3580
BD58D81B6C551BB86D2FB83A3E6B4924EE0D07E961E5235E7D473647322CC62C
69EB8DDEA11AAED833A80339E58330BD4AC7BC67B692ABA6A34D4D2D7A1A279A
4591974DF964E64592E3856B6D72B26D6E16241437159F3A09A5F30A43600835
30C76CD71780CC61C31DDE51A144E6E656F62A579D808F5FA729F1A66382EABA
98B6E376765D96FF4015BF46B3314B72C007A8DAE08A2E29F3461FA56B4BA6DB
AF6AC06F4C94FE3F2D692913E13F99B6AFABF801C0119625C51F8015E35BA453
E58AD266F5BE4EA6E839C605AFCA7F11B673E51FF62A17D6BC824119A89599F8
6E04D3DF374382132A2F1FB1F9E307DB10AB21E627C4356DBEB97C0A6205AADC
1122176F33DEA813908601A242263A845256234C6A3C9242AA2811F9E43BAB93
4A024BDEDA3CB1E7DBE07BD210EA3341582B6D2A1577185C01E6F38CBE50E63D
C50C27D22533C60F2FA74E15A9098F5B0AB07B31A098A88C9629F2BFE3E51379
F443E54F4AC11B6134C39EA3F16B0AD01160792AEE382FA08C171DE8FE8D78B8
BFAF4B630DCC09B8C548ABF9AC0ECE250D4F18F481EFD5AF1F00B23DF090B57B
C57825A72FB1E529CAC192DC16ACD2D77E8FC158921B4E9073108E69D69E191B
7E8E1840F83F758C840A0DA59252EA309DF1828E5C01FB9528AF8EED2A5DBCE0
B98CFAEED4BE7BB81293E49C382F8662548F7CB5579C809007E665A50BBDD51B
2CE1756BA9E84AB65F970FE5E4282417D5006EF7786C02D0817D3841DF95E00C
87CA35863F66C06860C9117A4E7E5008D45B70584AE3154BFDCA49006E9548C9
78D25EB10052885AEDD07F8A050E5A64C5BE3270EA594D79CCECC92996C2FFB2
E5FA947080F1EF2335799A8DD8BFA215877BE32C2B5A633153F1F8EA8C93B836
2BA3C7452B8D0AB8E6EDB16FEEBE51B64FCD0601F8F9FA99EF4241CEB58F8291
28F21AAD148D8D681F84E51F5A53F6C13E5CAFEABB18CCF22180C0B911A37624
E25FB908863CC80ED9C93B93AA72997D13FE0C71F0F38F274B638D461A441421
4253CF8EA0F89FF54F775FBAF2540C02E895D0BD75B6F03DBB65124BB41F8743
FBB668587AE9359136D860FC3E09458570DE498CAEB9068F44BBF24C77D46395
96A3F22907F8A0C508C083FFF396ACFBFB26F6FDB2F28FE49053FF2FBB643CB2
50B37C1C917466C323ADDD9C246DF9F7D7B4AFA75BB0571D5DEBE80565F81ABF
02EB769F35EA6E2319FEA269303A7F72F754C81311A5A22F6C4927EA2B1EC35F
B804811735EF39249E020EC76AD775FFE4593CFCF5C6739AB35528E02C863668
48AB1521C4FF943E544E42E33DE193867A715D1F6ECAD74F1F5890369D6A1375
C468417352E9765AF21B9C0822494026EF63D63D5BB61200149FC2AA8F7CBBCB
7A7D5E7BF9EAF67987DE4F41ABD8B52D9978C70CCEE6550B42D14A6DC5D3DCA2
2AF30D02C0732B97A1E818C11C4818D35F55E45EF64F74C5BCAA9E58B7686DE9
51A29D0CF5CEB3AB6A1F280E893672BE474A173A6AB7E11D3BF82641AB1EC067
AC9F2175B1E324F9DB03DC91928081303FAB31002BE72A3541D91C86B3FB16CD
DA1F9440D6E67951640DB487D9C14B9A7DD41F2F450026CB7B311AB3E578E513
CBC2DEA9E8442DA882001486101C232581E3C287EA8B1B045D594EF81A715ADB
CCD68BE8EE8288D4FE53F1720A6E0F25FF0BA9B85D0BE1AFB9CFD76EADC35429
05FAA1D36BBEEB637B9514BDD2DD2C0C4366597F4A6DFA681F6524407F0082B7
73F05A553A57C15855D524588D46DDAB160AE72C99B6DD13B820B17A807DC197
7CDC6D8F5141167915F8965A57DFCA7FAF941502F6C00A1CE8AE03C8382D5041
3F0400089F18F9F8437D0AF632520F94F4BF2464B50A1AB0CDCD94F8BB75EE4B
9150F660BCDBE851879ABD99A35E9F75E52F859837B93410444E8E58CB9C4B9E
C7518E7AECD56AA1B04B3E89584919B6A84974A4B8F01F6B2E9D12F13F913479
710046D5AD2C9862B71E9384969AF640436C630796A0453E9735FE8F96D3CEDC
7FCD4A0DE65945A0205DF90B9E7FD31A3020B6E87756C41CBCFAD1B99D910E44
7D4E55730848EAA86C349C6E4051E7CCDF94DAE8E38D1406696C2F7B312EB45C
C8AE6400CC1B1E9613726751F1B66689F58DBFE9DD4435DD20D3164CE9551382
0C56E69322D6A55F9F84A67944A3AF8FC8A0FEBEC541B24140C17510A35A9483
FC9916389A93C8A6E7204087D167C15A3B3CD306B5EA0BA1A652FE4C0F4A63F3
00C706FF2069B4D1A74EBF169D3E550EDFB283EBFEEAA6BEC1161A363E3791C1
4DB5DAC83AAE1F922427127793255A482A6FB51E93A36ED4004D32FF21AC74EE
ECC545D1D9CB445C23FD6D3AB380E49F630A289060FE2F128CFF54F2E91F3693
A9E34F1B0DD6A078AB015C55DC52BA002FB1C597C3CF2A0C1F05C1ED15A173DC
EF084B375F84F9749187C633C3A2275BD9AB6C714884ED37C6CB144CE0035343
5D65C2CBE7CC790F4F6DEC3B40999F9F1FA1E2E552AF0CD0F913077E37D8E3F8
2B77C80134B6163034B8A8B54B13D1A75D4E21638188C1403F5376EC67341F0B
B69D18331EC9C4A6B85AAC493FBB73C1396A3CAA5A330AD45F074DD0A975F02F
A30A31820CF85BAD947252DCDC801992EC112A76E8E693AA911352B32F2C2C79
9E611ADD6329C6E258D293C5334C8DAA9B74247E8E138C377D563A10F1A64BAA
82B9F1E319AEA437E4895502CB8BCCD7EE3046E67A46E255CA5D34D049ADB2FD
AEB2725B5C13ED0335CE3AFFF946B913F5000376949348F3541E09A226D8AB43
D9B96D5DBB7FEBE52E13FDF86D8303A4A2753B6F3DF0DF97B885D5C6F6EEE3EB
A60967FA4B2FCBE6F039F6D2A6C79422D4F38CAEB72074C704DDA845A4544291
7BEEECF8A4AFE80143FAE28C27DDEB1E5CB0EFB1B017D42AFB5CAD9365A77F1D
AE6EAE307026390084C8C9DA9131A46487C410235020F12591168C41B6C4BF2A
5AA04581F532F15F27501295FE091BCAF8641FFB901434AE4847BD08FBD94A34
93B9A0FC241B152E0F1677D1F6A4CC955CA533A4E9CEC00782D9000AA325CA1A
8CBD580A18F9431BB20CEB8120814EEB48F9123279F26F7DDBA577D6F08E9F1D
42339C59A4D913AF2FC11E40632695D460AD1E2220F3E951754FB8807C90667D
6BC9ED16A6B96C2CEFFF8F84AB02B5619B53C9DA4237F2D51841044E55C591D2
F71F94A5D6B098EBEE8F535A84FA1EFF618D9E682F74C2B24F6B7492EE264485
D41FC1B135A3F78F7DBFE730B2862B9EBB76E50647C22B92421355D354C3305C
FFE93186364D9F3EBF9100C563388C426FC6B8A37F535A79D1DBA9858ECCA6AB
8B39A321815354F1FDCDE71B64D2429155C97D5906A2F9A2B8854C80045566F8
11E2A2205BB47FABB6207F0AA74F099B5DA39FEABE06D6B9748FDEEF7D2E977C
089F437B42450C9EBC6FE89D876F8DF6E58C20D2B147638252C63B4E84B61FDA
69EA7692FC1369369CBA019D16B6F6D28356835999BCC24DC6B0F0897E798426
84EAE64D0EEEA2CD568CD124810D330AE06D623259D22D2F977D51962A498898
89E0E19C928DCE67DA94C2B0C86CA257E453798DDD111791E29D6A2BBABF4580
1861D8D940D70EA3B431CC20F8A602B67C528381449DC8353343D1F205D016D0
538179F3AC9F4ECBE73D892692DD528DB2D3AF1D31E7248B5A4EA0343556CBE5
B619A19EC1F04FB65CEECC60D7B2C68A1D88347D2730A2819B3331006EB854C3
3A41FD0AD0DCD40235E8585077B41A6AD9678D87F7E14928F74F316BE123DDFC
47811C5E052E82410D52D0B13EA86E20942F4988466B0BA666321848F1B00174
457A338694C9B4115F0476E0B934B6A4F43B82505690836128266B686CAD4DB1
DF53574837271BC9B28F0E8439DFC8917EA393E6B15DF5E38571835A3209EFB3
7841AF4BFDC3B7F29CCD26CD41B14EBA0FB3B4860C4168C88160575983C511C6
45CC50FE11082DD88D9C74B28B72E133DBC714FA1F028C633118850D7282D719
2C7C2EC7CE1685DFED43816A34151A02FD6F78864758903A5CDDD5F0BAC32B42
FE53F2547BA1C0CE4BDE807CCA6E2738EC2C3D25165546FA8FBB46F8FF1E64B4
7714EC2C4C8978CB1EDD6B0C7F9341AD12E63D46DDA9DFE8D2239721E2E2C2DC
249FBD8AB460390D5BD7C3B9B68111FD3466E11BA596E769E39372C3CD1BC8D7
565C38FE1FE65FB3C26B3BF58AFBE54C6DAD2E3E3086B1B39F4BB496F08E7887
A992C7FAE9281E609989EC45652A3A2F13817AEBEA23F7C71077CAB9CF2E6191
F343BAD93C12D420E0AA5F706F917B7119FEA746269144F67AFEE8C66048ED78
0E024635A608692E1A31BBEA0D87DD37C41D4E29B7C36D26539B121B2004A706
999399ED1621854369C0856B5A3602E54FA53488B70CA8F7340F009D69BAB228
2D210498C0632E60DB02546D0A8F28E93AEF943BB8A19D6572365BB9B8786B38
B5A172834A3E651069084CF475ADF6BC436962580A06F5AE5BBE05753ACDF0E2
545E9D7404787D328725ACB7D10E4AFBF0EA921E2E1EB0A2FB36A60B94086554
FC6CF4AEE2E3166DB6FEF1412D5758A140FFE0210DD7EA7F5ED6CAB1064D4E0F
B8C5FCD936DA5BDD3051EA1E212F5ABEA7DE611D7019CB62FEC5C97F348FF947
E49768D88B45D2DF72EDD41E7AEE598E3BFF8BE8E6722D3AF05F991BA5FC7955
48F2C7149CF4F33B2B62856851149528F80498EB5A835D02BC7F15137950CCD5
8EBD57FF3BBEA46491E7E94C367856E6F8175864E895FF3DF53E37C3437A7268
DF442EBACDD073AD234E66BDD8AAAE748A5B49C251647F384E843C93C0724F2D
CE55E19CC28C2E0975EF4517C8E45D6B794C31ADBF7DA1832F286C9071FECCE7
9E2A81BE0C11B0BEA840775C1F5F094FCD44E22BF193BE278131F6E6398E021F
F1BCFAC298C92D1B3B63A2EC163885443D4B0BFE99A468A9586DF8E634AC5EE1
4FEFB7BFAAB04A9A5C21354B37B32A055913422E85D86C13D0CC6407F0294680
FB8BFC01749DF59401C258A44F5B8F9AA6F75910FA93786406D6C28C15067201
56D8C65DC1DDE24CFE365B0CA10698F999263311EE6E3A4C0B10DB6C938795D3
8073EF0652385A902915890966B8A95C081F36CCAD79492E4C43373719E3F49A
816C289AB5E1A3490098EED8D755822D25C97EE39FD9BDE82FBA7D3A7A988A6D
B00FE58376F725FF49E9D8D93CAE42AFFB48D01455A8934DBAC290EDFDFC06AF
F38139C11D57F29C8D0B562321AC107331ECD505634A54B3F7E7C70278B1578F
D4FE9EC16FAA9308DA077E973ACF872DBC9569C30BE9464EF647EE9E3EF7E057
56F95E8FD465FF0148689A7ECCCF65E53DCDC0E3750D226E92CE155380D314A7
896E8E3F079BF9ABDD45E47358DECFDF5B39B5DDF9A62FFB556AF17DEE47432C
2CB8E2B48AE6C4E7099794700D4E33CB7419020AC5BD616C13A53D7A6152C6F8
8BF5872FE600F44A245F884A0E2DBD44BDD1F3E81660C63A19A5E51571909146
A293FA884908938E3B59A33590D870800ECA676A70B97C55A02452AB5CA13128
E68C7119DFCB11213DA64985F54D038CE3A49363249867241246FC2C5DDEC532
1B3067F6BBB1BEA9B359D5FBC186CF19A965DFF5CF117823A614FA43AE5856B9
CFAF6EB0900741D3A2CBA1DF9E5F92503B128C878C2BF35973C8B67F7356328F
065AECFAA6750C633A435BF27EC5A815C5A50733DCBAAC59EA0629A79CB2C55E
349C802A8783FEA51C7254B52C563C2C3952739107ED219CCC9FF776F6BE85A7
0BBD47696B6E2A2118644B12B39C3C47EBBFCCEF7A47FAC7B048D7FA3BDB2EDB
DCEEA6E1806791D24CF1A933F97C4E0B4FBB8D8AB396CA6D9DFAC6A6C5F9D5B6
D84F203E506857F5EBE68DA4D3ACE0FAB800673B1CDA565BE75C96348A056256
E4E55820F5A3E92B3B54767283F69B7CDED30F43E13890C28EA5EB8044E781A1
E556B8BC14F4DF6A662CC960CA2D84E4E82E884A2993A2C4F72455E64C82426E
A3A06212E274881248106BBA6BB1912D9798CF18834A0B8A6AF0AB7D9C4CFD70
0755F3027E6B8B8CC92C3739550A25B53430E8233A38DC43058CA991BE39A049
E9C4F0738EBBFD64CAB93EB3CCEBB15873CBE1D3FDD0A2010D84772F026BEECE
457DD1F178024CDC317F7A4358415D187907DA789FA3F5CDD2DF409A4F560082
D866BAA86C282BB59661B780E305DBCBA141F8C31626FB8A2D96FE36D0BB6E0C
818A510EC286E339B272D134BCBCEAB20EA54E008749C987843A35E0BC4FC6F4
51C69156A5FBA0919F097703A589F0AC7CC1636BAD443ADBC14D1CEEC8CAAF7A
DFC003A9BB6D647564C31C9F8B634F08D902AA74CD31E78BEA3D1F7B48A76EF1
5EBDFFEA47A0AB6E112B0F4E9F8181915C38E764DF5A0AED0C0B6DA0A36C94DF
1E46D4E71FD152F2173E4CB14E2EFF13A5256E4459284EEDCF91BF2D468E5B69
B27E25AA8111D71FFEB0A233BB9E9111767D6A96C37A12E913C80EFFAF872D09
C247B13B4AB649AFEE4052B2A912799A1A64241E2FE836BF67E1FC57C6EE3D89
A60E4AD8024696519E1C831C6C3782D74274E57E11838AFD681034BEA8220243
17D634FBA59776051EE9845E682139F82DBEF57602655D2CEFED4CBA8734EB26
ECD5A8A187F47F9172B837B42DBC23ABC46E37B10AD31A12C78F6FAD29DC33DD
C9569882A60C2D47BEA5F1E1FA4C7444A5076BB2FAE7D890BF059E68EA743F14
3DBB31DFE65D661AA351455786DC4956EC6B41720C596E75703C2B3D2A243014
1C7A148BFE8074817026499A35908B25907706F05738206A1927DE3780F3055A
4257D086D5B2C16F9595C0102D03F9227AC82FC961BDFC923DB0ADE61517AE94
D5A6F5CF4692733707A90EDBCE9CF2C1702C891EE107328ACCBF406AE86F15CD
7DA45BE141F59F964BF11B6453CD9ACF6CF8255D3385219FE1F473811BF1A3AD
C1236F69DF20A21A2E7809D2D3B4E5C48CEC01FE0BE8A7E000EDBEC6D3BB8635
D88B61038CA583B986C4B8026EC737A22A1323096424ACF1940374D50097B613
F59D2EE1FCCA68247BFE459329CBF8B3946D71515FFD94989A22377F1C614197
A33F4BF7AA477EF83D2BF4C2B84AC30D082DA46B352AB2E4DDF79CFA06ACF6B3
F5B5276CF19AF172561D47A92C392A039E4A0C1602EFE1C2A4A7D12FFA4DF8E0
0D0735FA17211AF8E9EDC44E1B5AAA782755A91C57226130BD16381A96D7CFFE
B45E1DC5F25FD2DDF260D35A6A91ACC1D14FE619D78865E5D3CBB766BE1615EB
A972648777E55B847487DF5E1542FEAC876B2F3DCE15ADD69130FDCCF8DF2F0A
1280EB86A8575B9716EEA60F65469F928EBB5CA63364D24ACB1061134D4D1ADF
0F5E690C6B098898C1970E8B85DEFD65DADDE104D9486B1FC68E2E6E7AF84EF3
0184986F1C35C71C43BB1E22633D6AB97DCE2AADD8CD2AA6A4BD653964EFE00F
45777F2E211037281C3EE0529B11A53682E7D6A283DEF258FBC29F845D6698EE
9CEF1F691F80FE9CC15B6D49E4E65162F520908B3209C5F56F54D242FCD6FE14
FCCCF023938E9AD1FB75B47EE1CF65EAE507E0796018DACC8ECB7B7409EAC387
DFEC49F88B238CB1F58A988F096C9CD38D4DDF98ED5A1534EDC35045C0126172
7B9687C65C9B53A0BCF38A1AFDFCC09C70338876614FD4B94E0C5ED6DB2210F0
DD1493EFD84B0DBABC54349C7665785D534B0E62E0D60B826B9697A977DE2D10
7AB9C0FC1DF6B9C22374A768D1A83BBE3EB5A1AFF968612D252C38FF1E6DF43B
600BCE109770E4B72169D887D63ED4A99D42BBAC4A6D1040C236B9620A82B3C9
16E4867189B23C2CF3A4C74F2B6BA1A872A99321A2F83E2F4645AB26FCB722AD
69CD91A39BA3B80DB61E1F39B442182B4E5356F910D5D2B2A302D5E0A84F14F8
4A307FEB5F2B7C8AFEBC7E0E11F64E473E682E95182D19C62377CE3925B47D97
5BED80079258FB004E8DD0FAC627FA3B8419D2CDB57B691D4F5747D3C6F82D51
EF17725EE9D94221696AA7B7E22A2B761418CB71B2B022DD7B78BE7CE61D77C7
2B24EA281583002286742650CBE59383CE62A51B345D93A230BA5620B7B99C1B
01A653B8AE03CF79067FA259FB4C924C23FE19460BB276A5BC129BA8D10025A7
6BC48467B76E8DFB656D2E50FBAEEB148894F9808574A27F478BFC1AE5A06CC1
CB9B8DBA1649BAD8D945AC2CE7D42D995E44EA9482ABB7FAA7CCE140F9845344
C1B78999AFED6D23C668453074C2AFF1307DC40C80261321372C4A2AB9A9C2A8
9DBC33ABED76502F09099F2055D18974C2E0FB8AB6749CBE851A4DC97E3A8E04
EB48A390E99C541A59F2ECDC0CB3D5DE991DAEA6AA1368228898C8A69B90304C
FA18E275321266D06C32DB43390591CD41DD1E0CD7FD83129E89E3FA3D7D6E9C
FA3CC4C3FACEB55817D9D9457B559309A5DF56EDE46F4C4B99BA10C302245D51
F0D9660A99D01B5125349E1390B7D636E49D40A153A291B2B2A881CF8D9D0EE9
5A3AE6EFF61B01D926CA46AE78B8D8670DB0160A154AFA587DAAFDC88B1F07E3
5A09FB939FD04B0C49C891F4DEEDD67C300888829BD13645D1F3131C97CC39E2
4B076A76FEFA86C65BD3AD836C70FFE6239657B02686D4CF2EAEAE0C28222ABC
266508088A7A14C4F973C648C5EB3740144D6B1FE1B99CA2C3ACE458800C33CE
10EA2636874D5DB56A15EF7A416903E830F8A80AAB5A324D55A90B5133B750D7
15F6E7B057AF8861628364A577B0611D3CDA76CD0D1D0494FA66929CF31F0281
AD662396C8E6B960E63E454B1FEB22DAEC770F4558CDA9A88EF7528C8BAD10D8
400BD93BDE9DE519C516CEC04C0F4A04A2CBA8B20EBCA04E92427FD53C04BF6A
089A5291366162BCF9BDD5DF7D5EBF2814F62E440CE1C9A4545559D0805FBB15
D1478B4ADDB586ECA220567426C04EE77AFD804EAD66495589BBF59B99CBC118
FB84AFCAF626F16A0F9D3306F0D32C98C19A9D24433B1C0100564B3B67A0CD76
7BC54463440766C923C660C521ACA51CEC94F8426AA3F014B86C2818B61D68E8
27B1EF085993D82E66CB100AAD4B6F1F649D8EFF6AB9E70595CE158470F6A2C9
987A4EBC5CCFADAB433CC914EBAC83E6877C3E2FF6FBC7BA3D27173A5C3FE3D3
849C54452CC6EC6A49EB4888AE8704CAEBD788509DAB1AC5CF42F600855E068D
81E4FC6103002D0A3958665CB0C925FBB0DFD793573481ECFE3C47677BE59D1E
87753B9A476D791EC30B3271C26D164282472B9A9700B7B7B52B59743245D24E
9F9137BB2AE6397C1C983480DE0817D74667ACD338F22450A8E7A3CB2B0F8FAF
E62AE44F230FCF3AAB64313B9C71CFDD9FCBC61826B31C36E7673BBD5DB7B944
E1C47C7ECA5AC813D6C9A59AAFE306B8F9F3AD6159D77038542FFE1FBF307DFD
B72C26E5834B30E3B30456ED51D9068DC7C5610E07696D880000EA5EB33944F6
91C08157D9B9C094AF0CEC1269F1C75EADCB784503612B9F1CBB2E9ED8C75568
34BB8736888AF7BF9CBCEDDEF078C06DE0A39F605CCA03649EA2288646A53A86
48B4909E264892E3902F9049C63BD1B9FAED0F86B4E2A48BFFABEBDF03DF493E
7129A6DFE8745BF260F0E781CBDFBF82B8C0D675B30BD68A8920747A9F8BD67E
9225836B9D376803647BEBA6A793620A5B6E655F6E804BCC13AC9DC7523E8A37
B527C5B2C5678B2CEFC06BB34F1C717077E5EB2247C2ED7F1C8E799C9CFCD0C2
1981966D6B538AF1CA6A45E60DB3B56B3673388DDC88F4999AD320902EA4662A
C7AC86E9BC9846A8AD6C70243CB3F0CD76B8D85FB28459C6C934F1BDC914E1E6
05386FFB1FE419E92673185C4078C778C504926A3EF633F626C1E915A255CC19
0B5491D633E6C55EFBB14D331ACD310E05AF9255CF9D5F4A5366165FCB102D0E
82E350B6D1D7CA627C2B9364FA3CF6365E89F1F6A8B3EC62959723EA69947A8C
06E7FADD9E8F77306801886FC458D468D428EA661B177DD11EA9EB262E35C1CD
F2459040FD4FB56413E3D476175115466E86E86A48D37B7055091B34CA71175B
C7D3B92738747D9278171BD2B6D90FFAB0CA0C8A2059602BBCD576AEC8B22BAF
03B3D5166AF750BFC75E96DE08CD03D758A7D0D890733BB90B83B43D891C7C95
882EBA8CB11C8BC17CFC77D92425878C391825157792922E98BFE8E388CB7C34
E0864B35E46A66A76BE4AD49843DC8D7749EB3C75B4A9151D2D3BA2043144114
CE0790F3666D8247B193FF496C1FE74671DC0395472CCAC82964B06D06F0B5EA
FA826241D5C83D632A2E95B0155FDF99C3D9782813D74243BF5B2AFF49A9A2E6
7DBFEAD8071D41699398EF82AF074C6D36E2A958C7C22BFB7D244E23A9135803
1152C0F496F880192FC7D4291BE9ECCA4DA0B78329012146F9CDD5F13AE6BC64
1FA4AA0627D9BAAE5E94931A75956703502CD4AA005BDA838EEF2C8E2D9C86FE
C478840C67F0C3653E6761FA9E3D32699B87A5EA25E15A8586569A0A4C0B0355
F55C8EEA5972AD04D9D259483276957317A895EAE1A9051C2F50D8D8F2574C20
61BA0DFAAB062487915BBAC3F94D68597336D2CECBDDE91114397CA140304BBE
1F29BC4D399CA8294CCD1AF86F7154C35C2BDBD522D1E2B50C83F8A3653AF4FC
67E8DDD986C66AAF93DE1658EC602ADD39F149B4754F82047F31CAED0D16CB1B
D6432783BA32462770F2BF25CCAD21FF0BF63356D02BF65F609DFEFE2A6A49F0
3A99A28B4C956965831A5B4D7134E56DD49036A0BE4BF4FDC529C2E61C40CE36
527E593B4AC66EB306DCC8B7F9C5F03E51DF3E6CEB90360692EA4F1CA8507B0C
7E741318B8F27DA7B124DA9C6880200487003EBED5684CA278C9CAF90DC9512B
CF0C4EDE8E22E97DD209CDE76215ED9034C6DAA5FBF0CF0A69BE243DA3DC4C53
9409B184657FDB99EDDBD18E3D4875232E9CD7733DA08E917020D36EF8EE0DED
DC9748565E2FC6DB1A828931533EFE23C6E45D7D51B753F9651EBD911A7526BD
5800ECAFF7AA226EF9A77EEC33545BF089C1CBABCE64B535C8807CAE576DE6AB
DC87B761759CA53BBF81425076CB1A3E80E59E69871EADC7568217A647620647
F6E4DBE8C73D3CD572737DAD56D7C7CF8E0E29E4BE702FD3690917EABE0E0243
D6C0BEB85A7CE6B358C03B168B7498D5865E9EA0147AE2D0C03FE89FDE7D345F
170DDD1234AC758D038AAD707C8737A42C6CA8673A2BE06E822E7F810279F60C
6FEBFA60457F2B9FD4B8F0739845DCBE70A8917249D1DA0D0D6F689F19F88606
EE480B0E20AD4BC9C1FC6A69D7D8EEC59C9CE8BF5AA1F80EB16E71C9C729683C
C4BAEAAC8BBAC6CFFD75C6E263C3B5E0EC37915818DB6B5DCBA0E7642BC15A7C
25BED64854AD9EF87E641A6486ACE5D8E5985A12F641023BA4CF2A91B071592F
585BC2A5700FB7E78EC79B97F440FFD7D8BFED7A614AAABE8A02F96733C04489
4AD85C7D0A16D149CCBBEF1BFBF4681C8997D4B082BF6C23865BFDE1572BF747
D563A7CBC031FD1F31F87AB0360A3A19A4B0692DBB21D2870B213C2579A0468C
2C116720B51C9C05FA21C8926FB5C56C9A01592921EA6ACE28083A15ABFA09C7
F26F6718B5DD19C49136BD67889D92CD8EB170A390AF147CD77486E02AFBA609
FC026062588F302DBE927C81CC7181FEB421C9BD6F7EBF384351A76FF78F3FD0
CCDE2DA3A920F1E3ADB898C5F6FB17C1A2C9D916B150BB8D47E3F454FD9F5E6B
91AF2AE713B7F5699A87716DB11ECEE2DF4FD6AEA2338B4AABDC2AA4D5F2C3D1
95628214615DE31B258A69DCC8B0439D3834E704E4CA690583C4E044FECE3EA4
D2FAF665D893A7EFA74B37CAC3E6B9531D45C26ECC4B563F6052BE495D2F15F3
F4E243BC1365EB9C5D324B339B47589B835E74247E1A9880E689032D74C97D19
279A2DA845E3919355FF5473C3B63556A627A8062EA281BCACA002B910E513DB
E10D4487A38A21543F1BA8039C6832B40599D0E6167B7B3460D74BE10605EA47
3EE399C32A1406704534D419D26E15E8A66DDD88B7B3BF653D2BE8FC63CAD30A
FFDC877FA3A3E7E1A23CB44B70E7E203DCB586D7B81D1E3A1C1E500FBE3DEB6F
BF80C00DB97BB19DAFC0FB38270822331035AB82BB6B43D12B9CC5B0076AAA04
560E62C55017054BF01441F2DC393F44D1A4F37584D929EF7E0B801D4F5D1CF7
C0E8A6D6BA9F74051E614FA33AB7F00DEA6F138D03614573460D878BC25C3D72
07EF46D27D26F4755953ACCB841C30ABE706C4A28AC01204A6756215214361AB
E929409274B089DA1FCA4BF9A6FB7CEE925FC86FB1C4C018403204B1076E1857
B81233ACF6920D29DFD2C5E01310D4B41A5DD73E9EFD409202D87EAA7465F15B
2FEF5FAC46E012F7218982BB213A006B7756CB42A37E39700DA1961420E9FFAA
2FD4295D243A79ACA04E14729EE32B4B5E38F419FB1C4450C072B7F228017A94
118EEAD4DCF50896EB5AB380130E2E4C139C911FDE6036F6D1A36920CF4D8EDD
23449F8BBD9E7F0572895C444AAC65743AF93639680E85C27CD4D2CB53D16CEA
DFB66E6BCA776DA3E0B6722E64EC5951DB230346BE53B09EA0FEA4FCF8E86D27
A190FAB3B3277C158357BB542DD8DBF741912884523C16982125B85BBC746E65
3D0F0A1D7041383C4EED67B039674652D864F216B9141B6FAE8FE901AA46BC12
6D815BE37692B5CA665004FD4D23F148652657A35DDD97652B50D2C1973CBA05
DBA70EF4498B15541C27C528C081D492734D7C92F717A09EDE796C7986C5F3F6
21D1941B2A183B6D34B3695DE39527EE244B9533ACAA37805E79879810048820
D46FE34A3E25E1BADAFBA9F606B07EB20FDDA9775DFE883AFAA932088BF0CF68
DBA888D32E2CC0D3DC135DC5F537387E91D85B860F5FC7C268E7BDCB58BBBB4E
49114D3EF54271517E762CD5B38A43AA96E2CB38EC43BDC408B2BE858019C731
6266C735623E072450A46DB7F7100E75A52A6DF1C9034732268699EC5D5DB448
2B6CD8CE5508301801548A13E7192AB4C860D218A8B9197486F4393C9D1F63A6
23B74D2709C14379B2CF6A03C9078A49907D6F3D8A77103F0907D0B91AE09BAC
EF02774D74FD2A7B5FF5457F0C9EDB1AB6FA13232E1A2D7D9F135A7DE264857E
2EF7A190A73AA423042F8942E3E91A0E7A0A305201366693CC35F9517DC38B7E
B24E733C6068666C782C8D41CD27CD463559449A3BA4586AE7D07146FBE9EFDA
BCD23880A5CA2C1D45E07B12B1FE4877074B4BDD05F24B54307B736B0FC49AFF
60356E954E33130A60877DBAEECBCCA5619E5447FBE42C47AFB9B4D379690BBA
60BB3B6763BE9C12F3C05CBFE973D5D0D2F10CB0D75F6DD3A2875D200AEC5DF3
99805230170E8341F297E1C8F4CA0B72F6C4B4DD5808A658309DBF3709FC7F7F
B60BA3C59C1DD179348413107B935550DAF2413778CE356EA8F34DC3E7D64E23
8918F6EACCB7B2E80AA9180EBAF176B14313DF50B522AE0B0D7D243B5CA08033
507DE4F93087EE6F4C8FBE31D9C689622FB66F260CD29219EB2DF4C649B111BB
AA0E26AFB6972DF09FEBCCF00248BE2A7E8029BA08EBCE8A7B0E1CF310F74D24
100E8E5D51CFAFF984610A38CB1095B89EE7767DFE323E476B69E4800391B44A
5C51A7CC2C94200A5AB216EF0EDE3C26252BB664802D0858E722A8FDBEF4688F
00E5D12E69D5963B48AC1A26355AF9995BD566A6EA68675C5A0CBF7C179E297E
574993035D0B22B7FF7DA5717310707E6832696FB4020D0BAA41F247AAE332C1
80AF204E5972B4D399282C06BD1D6371F6CE17635A70339AE79DC85681D25B2F
67EDB43C4310BA00C6DB8C65F2D277D10E96EA4C06FA24E4D252E0144DEC8FB5
18EE43D5C71720E83F39B4B400E8787189ABCFF863F2692AFCE4388B41CDB171
B148102A5F4A50BB162866644EDCC4C7E6A615FA4B73FE735EBD5BB4C8B2A72B
E47ABF1B0D5EA995E28FB0F758E4F484B5227BA3E7A22F441122BB1CD07422D8
559CCBDB9D17068D0ACA47795E76CE25819875027FE4954924F7023216F1A526
75E0DBCDBA26AB40B39C740439B5643268E7B533AE8E4AE23DFDA57428AF1E95
33872479E12DC1022205AF91184D566D8C8A2A10F08E6475307A3E39EBFCFA38
1A11C110AC615378DCA70493B05837F5DFC80498DB0B8546B8A5D64B48683831
3CDC5B4E301CF298681CAA6D3AE1DD97113CBC7D009FECDCEC0D7F7A3D774DE8
C15EF3AB6F520C9C14BEE41D57D352ECEFAC66FBB95815C8626BC59A20068401
4E499E9388D5AA912097891EB8793F0A231478F9759B69C58F64E1338C00D12A
58BD7DC5A5164A287AE82301E96EC471F69EE38593C6D8D10107DB36728DEB2D
15E7D16DB331890DFB63A7328A14E5583C303F4AEF34A0FC41E0388E09126ABD
C9E2C2A7E1770EE0F894B8BBF22B4AEFE3E35B86AE9F7A75169EAA24FB17CFD1
C14ECFC0302AED2198ACDD642FF224DB45F96CB869C856FB51D6F2739F6C6D15
5740E9E4515DA13460C6330710E62BF93E65E4730BFA48BD01C55D78C616484F
D200AFAA5F1BEB2BD962E1D00FC806DFD6CE3304CF661B139BF9FA18B2222CA3
05F26D43C3469A8856D4FCA1CE3D400FABA0B6EFEF31E077F1C08022388E17C3
B82FF34A1EB9D25F9A7D930310A6DB534564CF7EDA5CF9032752A3E3262438C7
B16508E739F02EFB5A5651975A08C494E53872B6CD97AD868259EF95F3A4054F
9DA61DFAC94722F68A242B0E1278FEFBCD43F21087A82FD0CD09CAECC7FB4F3C
FE441938379EFB10D45E41C6E63DB2C2876810097200A1D9057F861561CCEEEB
0604AFF0DB4EA4869EA9FF6E7CD8F930A8DDBF82C800BE2626F46FD93F361D7F
9A3D3C138AC8B12CFC4734851697CE8F1673D8D43DFDD3AB2DFEA03B2C06B565
72FD751653A3DC6DDA4048760A1A4443903F3B039C2268220F2B580570A302D6
751FA82C884669AE49AE2A6D1EE377B96D125B47EE3E7DF66C33542A70ECE4DD
67F35081E2CEF1D28EED41A53EA61013B5C433B39532135352F2A94D59313328
FBE57D6FE410E64B1E846B03FE0A30422F4E5D5C8146128BB4AA8C2C630B9499
C910C05D206610438F4FA65DAD327282E3C58C3957101B20AFDBD864581875C9
DE2C3AC55C343137BC4D1B909629A2EF9135EC4BAC0BF29018A82A0C84142457
1F71A2A27E2D9484AA47784EB92EAC52573900E14F6925721406FDB8F9A2FD68
ADD352B5FA039D2390DFF4E0F72A078931A750411E9E035053B457E600314660
B50320B70934D4E94E4D3B308D7DBC2388A77FF084DD83F8884F309ADCF4EB87
66A7CAEE25C6E20824BF2C76068850C2B5FCBD07BC7CB7B4B7BC0E46A4092E08
2867CCC3184B02C3F04D18121275F250FD3E075C7A3810734B7D9ACBD4AD0D1C
DFEBF5037B035F0B74378B25F367DBF7C26E489B06E024EC80B473217B54C24B
D0F998E21732CB608D2477EE18CE7CE18FB417C0790B16BFB9F892033B97EC54
BD85AB9344F1BAB2A9BFA8DA80E33D589256F43A4257FD46F37C2F0592A48831
3DE6049C649ED4FA4E83A8CCD93B2247146F20D01018924FA8D188B03A5D3B44
413DB76A508EEA254DA3CEF3B03C0E624264A9E9D572ED479C3FA76FEDA23D0D
9887AD60469474764EEA04DD4B5DAAD669C14186D9678424A091D0FEAD822699
718F7D23B05076DED3C883404712226EB7E52ABB3DFF9FD907B4B5B7665A9865
1FD41E0F66E70B5CFA97DB81151B96FEB4B33A09720199082B46BF9C6E715C2B
D6345B45AB3F553D3F20E7D19CDE669F858ED0489DA8A09A3A95AF704F605176
3163DDDAF1D31B22DF8A5BFB4C0EBD69A6BB12C2DC74940E1BAEA5D954479566
029ECDAB26EC6D15DACCF75DCCECC4386DB0D86D2802726822FC04E6C676B7F4
3589EB5E53B57AFAD12C29B777266E0714FB0FB476CCA6FFA25F713CC5E27BC8
786B114EE2327D16DE9C0E0D42D018388D2F7B940279726ACA3ACCEC31F0852E
9EFE3419CB37660562658CF54E7843B8D70D62A7AF1C812017E7C826E58F3EFE
AFA779379127642BE0A60705400EDB133CCC8BA30965D09938D22C267D064296
85DE334C38DFAB31BC4F0CC33D8F3D93EBF3BFDCB0C43F77007B9C1E666C6713
DF254F5E19F655F8EFEA367E10BE74A282F909989D865C8B6D52D39B114A729C
A7F11D538920E61DF08EB89A48D59FDBCF4AEA67CF8CE990E1BAF5AF145CA80B
81C16BDDD9B2BD1A6B153137930D69ED680EA892ADD867B393F6501EE5A67316
DB3665BA3036321743415AB1A784A9D1464E245AAB0F9EC455254FB0DF049DC9
B83D67D7947A3FCA600745E4696190800752BCF657B656C19AFDE528940B059C
56B09D9A5D692576A746DF0214F0F8045A649351BBE92695C93866C060031350
9A85807EE23FAA86CABAC8C35EE8F8F87430298A9B2890DBFE87E520120F3D9F
25F4076B09619B7CAC6E1DA280637862B87DA391DAE17A768B82798BFB40FE82
72D6F288B8BC577CDB1D0E907729312C7F412FA1A6B568840B04B7F0ED55DEA3
71551E02D3451ADD0F0D46D697C7CF1CD8A6C4A372D11B4CB39A435CC350FD01
434914C1F9EF60E2296B5557EFCBC15AF21E4C82D9A52B0763128A6A9CF83D5C
F7C5F36B001C5E77C00ACED958E35AF237C055E27F26ED00FDACC250E8716574
D50B9DC810293430695F4D9270B981081E49C47A915B42039DCB36D3CE5555FC
26FCE46B2D996CEE6AB80454CBBB35F9F53A4E939C82BCF2477BA0AF6F88E574
D83B92F7081B0E1F5B0CCBF6BF9675AE7B9DBBD107120481737D28E2FFB6AAB6
DA6601EDFAD88E2BE75C12569E4B8551D4869DC5A36BB6E2AE00E1E141DB4A43
A6B4A90A334BCBACB678FCC647D25BEE140449033160EC5C363F9E575618C223
ECE6A79C1EB76FECA1578E151984914439AEDA51C3E86167E3D63552168B9B8D
E77901E3291E2C4DD5376F051EABC76D9127EE146B8BAC22857914B71D77475F
209F54B80B5F55A9D23913B5002394A1526B9492FEC352B05CE461F71C8CE490
47D9796810CC96290FDD9BE5D4350637F6F8C8870FEFECEED33C129FC5CD0602
BEE07534E254D181C89AEF245AC1D1BED915F4CDBB0B9B745B82049FE6762D6D
1E4CCE1886C823947623FD46E39E957B3CB503E93596921E75F4E8181B799D6A
277B64201D325B280564BDAA7CB7132F16F48EDC386E5285C1A5E3088EA7647B
92E39EDCDDEA3D554E3406C6E411C22313033C7AEAB9E4DB2A1A1A4B03F75D0D
C8F1B5B2E09B2C22FF062BB1F017BB7E383D444F6530B487BAD96C594CCB9685
C3C905398225E045A40F86717AE3B78234B3774D4B445EFBD95C26F2CBD98EA1
C95A2A88D21B4415A0DF1A724385AAD2115CEEC3EA9AEA9203ABDD304388EA0B
7C3B76DA1382D38AF01325D88FF9168028DA9353BAB23F67E960A5428F3107B5
5CF7221175F1810BF0D07343BE59584B6D06F9D9B5D171F1D6BB167B020C5039
C36EC1CB1AAC41773065BC7991D712ACEA5D7F627B02611FCDCE21711EC7EC74
AB0BFC57B1CCED1884BB9B18868A2053AF58F621016AE639ED6D58EABC42FF0F
A5F76685634C85F3BAC77EAB39C23707518CAAFC7DCBC9F9D27B8BE49E85D335
4A74F0A8D93CB7C2EC5A9982804BF24ED1832C549EC8B2AB2B1A212B14E04F26
BFBF1811C51029CF134633B62E08C3F88C615157DBCC5D336057548711630253
C97F950490F0A2479405C6D88896D9715A139D0D365EEF1F65254616DE309AAC
8C708FD30001B3AB61A07630C8A5ED420D286442FFB6729DF0BFA47BE2C87480
62BA997499C1CA63131F3AEA492C2292E8F1B87011932640FA023A1C022D98B9
2397BF2C01709CB33B012E69B928ED9E78B5157CC3A5E6F504267421EEA08A95
A5B3062D0AA95CA6411F51C3ABD548B82F47D3A759B3B1C5D8F8A227BA4A23C7
77B7C36721C2DAF57426DD1A5538DEAF00B432D8E839C15C33B2762320295E2D
CDF4F1277FA2319433F4249B246D4BEBAA57DB6378C96576881B855717AD5BE0
949882C4BCE64C7E037FD8161CFBF8E7212C23BAF8C9CDD6E194483436B69C59
CBE7AF01B041FA9507CF9EEA2272A8E90F4E8EE8D0EE8BE355369BABC289855A
10A2E0C23A146E9394BAAD955E6F55E44127003E6976DD267BCFC1BC14130D1B
5841165507F65D0599FA44E81329A04EC5B71BA7D4050071CA65421C0457D6BF
F4E361666041C197E2594BF098E6AD3212A1075DBB2815903464E2070A54ED33
C29B0B92254C9ABF5AD9A8B92F050D2B02244B09DBE3AE43920A0714CCFD525C
C5E5594E3E1B6C58AE380F3E680B96127F48C00A5CD25D09A4768FC25E0FA213
5662DDEA45A533F68B0B77E7938E03C304927D597C9925A925BEF5762DBE6951
2FB9C0D5E9D85704B2762D3A8E49DE2920E533A2A2B3A6B5910D0210D51B77F1
D4A7CCCC264DCB4D138E4157F9931A376785A4963EC4754BEE642C6A9953711F
9235407EAC877A53491706029B42562370A3776CD6E00664291BA8253644B031
8C1A997FB81F7D88B33D51939C7AA6833BE8B9E22BFE9960897299C357CA4244
A0F42A92156CBFC0C46E9F76C9210239D9B116BC8F0D1E024FCF879349137D86
10AAB7DF3EBAB12F3B087076146D0B4E0800ABE190175F877E67037E1C4D5DD2
B1F53957CFF1C51C349248F68FE367E451E7685F104482D3B9DD4D7930E63CAB
E8A97DE032E9B4ECCB6744C2FF3A796530603D9B1645A144EF9B78F832EF35D9
5F04CA48482BC44B56626F80195C2E34D5ABB6EC46B5CDD1051B1121C06BD2AE
633FA5F7EBBF4C54C9FDF19ED3165B0E176E3DFD22B2CD6B9376CCC6C862A13E
3A7316D6CDE2B598F22D3D3935A888146BA654907EFD4EBB93E16C1691127ADF
44D0D01061E29E58D102A537C84A694341595DE48E29D2928F067B7091C0E711
68EED7D9FE14B3F495CE41BF7BC7CCDBFABF97D8C9FA5FD21604698A1C8700D6
692774BF8A0A723B868BF8E80F82468FD097639C571C3A0EE0C154DE9FB11B7E
89979087BED793DE89F2B4B3C6A267E4FE3C8A02EA38847E2A4CB03E2B73AACE
332836D739D1C4B14C71E5E5E110DE20DBDCA5916E4E33D1B5037B55F991FD0F
12B91E669A6DBA12DC98B4CF9E160BAA103BBA643E25275BC32BFBA19AD5401B
EAF813FAC17F67B0B9F222D03A080813DC68EFF4CF745E42A0423A3A76A639A1
3C1217D84E62AEB0495FF3D9F9557D3EEADB4CF622232B6AE4FE2DC7A95AE179
6788BCEE6421FDF76448F0462B79F1612E83774EF10D5F62A5A275420F2E8590
3EF5ECFB398574DDED563876110507B87067F349E123010D781F9ED5EDAD8F07
443E8F84ADDA31121DB3D1414B540ECF9897476FD351A6EBDD5490EDDE270312
0234293E6B8293830F57F1B8AB65EAD8FF7EA3F0A3E02C38F927318FC492105E
F2AD9DB49BD49922F6F54B21DD1E5B8885C19424927CE4DF58754DD387A29CF6
11E2CC20B3B726B22A0D46C709FFEA147ED78FA7F874119B11D63CF78C54F6C0
E77AEB656B5F3318531CEF393C1860E69AE5EEB179C2C8E01E10D2A594FB29EB
B9F897CC3A7F0C3D9022D80197166552F2BEDEAE8459EB15821A9CE4CC97C7F1
3E588FA18BE5FE27953BE6E6C754E0C25BA394A62888B49B636661C69B5848F8
5E6F9C5516928D6C2BFE046A8E6E9DC127CBA203391D1DE19BFEF942A07AE4D2
5A6AADE9DED198F55D0E2BCC220C64DADDEDFAFF96CFC4A4BA1AE98605E81E66
96DF11D0DCB551701A4B76C64A7601D3B1B2C0A558F04FE5289C5EE052EED2DE
D72459CA00DD31AFA2AFAFFE05165E51D29F93C27891AA3829286C5EDE807583
D1F6B621B7BFC9A0158F6EEC63BD5FB85215891A22B8ABCFE02A1412F34A4B50
6C85476ACEE743051AD048FA3733791A0BBA0CC7A980E04C6845E8F771A07F0C
81BB3D93EE17BB943036396179D8118C00CA7BAACEB386B7C29D555A2AE07162
6BFAD2F69AB89542C2F3C1A1877B8D44EF6631AB459974B4987D4007C8CEB06F
D226E0845E190A170D2C8A84A579D9D171EFD7E29CA9B31CD1CD3CCCC95C1FC8
0625DC4C76F91E9066BD5E6094CE3072AAEF99DB5E6E10950FC342FEA8777404
ECD78AFA3565
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
%%BeginFont: CMR12
%!PS-AdobeFont-1.1: CMR12 1.0
%%CreationDate: 1991 Aug 20 16:38:05
% Copyright (C) 1997 American Mathematical Society. All Rights Reserved.
11 dict begin
/FontInfo 7 dict dup begin
/version (1.0) readonly def
/Notice (Copyright (C) 1997 American Mathematical Society. All Rights Reserved) readonly def
/FullName (CMR12) readonly def
/FamilyName (Computer Modern) readonly def
/Weight (Medium) readonly def
/ItalicAngle 0 def
/isFixedPitch false def
end readonly def
/FontName /CMR12 def
/PaintType 0 def
/FontType 1 def
/FontMatrix [0.001 0 0 0.001 0 0] readonly def
/Encoding 256 array
0 1 255 {1 index exch /.notdef put} for
dup 46 /period put
dup 48 /zero put
dup 49 /one put
dup 50 /two put
dup 51 /three put
dup 65 /A put
dup 86 /V put
dup 101 /e put
dup 105 /i put
dup 108 /l put
dup 110 /n put
dup 111 /o put
dup 112 /p put
dup 114 /r put
dup 115 /s put
readonly def
/FontBBox{-34 -251 988 750}readonly def
currentdict end
currentfile eexec
D9D66F633B846A97B686A97E45A3D0AA052A014267B7904EB3C0D3BD0B83D891
016CA6CA4B712ADEB258FAAB9A130EE605E61F77FC1B738ABC7C51CD46EF8171
9098D5FEE67660E69A7AB91B58F29A4D79E57022F783EB0FBBB6D4F4EC35014F
D2DECBA99459A4C59DF0C6EBA150284454E707DC2100C15B76B4C19B84363758
469A6C558785B226332152109871A9883487DD7710949204DDCF837E6A8708B8
2BDBF16FBC7512FAA308A093FE5CF4E9D2405B169CD5365D6ECED5D768D66D6C
68618B8C482B341F8CA38E9BB9BAFCFAAD9C2F3FD033B62690986ED43D9C9361
3645B82392D5CAE11A7CB49D7E2E82DCD485CBA04C77322EB2E6A79D73DC194E
59C120A2DABB9BF72E2CF256DD6EB54EECBA588101ABD933B57CE8A3A0D16B28
51D7494F73096DF53BDC66BBF896B587DF9643317D5F610CD9088F9849126F23
DDE030F7B277DD99055C8B119CAE9C99158AC4E150CDFC2C66ED92EBB4CC092A
AA078CE16247A1335AD332DAA950D20395A7384C33FF72EAA31A5B89766E635F
45C4C068AD7EE867398F0381B07CB94D29FF097D59FF9961D195A948E3D87C31
821E9295A56D21875B41988F7A16A1587050C3C71B4E4355BB37F255D6B237CE
96F25467F70FA19E0F85785FF49068949CCC79F2F8AE57D5F79BB9C5CF5EED5D
9857B9967D9B96CDCF73D5D65FF75AFABB66734018BAE264597220C89FD17379
26764A9302D078B4EB0E29178C878FD61007EEA2DDB119AE88C57ECFEF4B71E4
140A34951DDC3568A84CC92371A789021A103A1A347050FDA6ECF7903F67D213
1D0C7C474A9053866E9C88E65E6932BA87A73686EAB0019389F84D159809C498
1E7A30ED942EB211B00DBFF5BCC720F4E276C3339B31B6EABBB078430E6A09BB
377D3061A20B1EB98796B8607EECBC699445EAA866C38E02DF59F5EDD378303A
0733B90E7835C0AAF32BA04F1566D8161EA89CD4D14DDB953F8B910BFC8A7F03
5020F55EF8FC2640ADADA156F6CF8F2EB6610F7EE8874A26CBE7CD154469B9F4
ED76886B3FB679FFDEB59BB6C55AF7087BA48B75EE2FB374B19BCC421A963E15
FE05ECAAF9EECDF4B2715010A320102E6F8CCAA342FA11532671CEBFCF38BC60
5BF06A0E01053B7F105ED5140FA4FA37A4F45ABFB58DD41780629C7FA7594F8E
9488B074D45BA0E761190A94DBFF4CF204D5812EB1DFBC0C456D6A044C558945
8DF6D6AF8A51131AB5913EF2544E475F489FE776FA45E7C0EB62096CF4517450
8A57DD2B80EF97DBD17036EB9B73FCB82DC4F671BCFEF06A6F86189A2012F53C
E518466A9385D08942279391EF5C2B3567F2E53B2148AAA0625BDB358ECD2C9B
730A59F8DF70FD3E09378E24AEE772A69C96E09C0D0703350A75F3843DEDD822
B364988376CE8027EF12F0453575AE9AE46296E13925BACECA8B8808DA388222
BA35B431F56BC3C349B8CA6D4AB83664A991FED51478BFE25B0399B54EF27B18
65E2E39E57DFC5F57371FB4643D7EC0AD41840CA7C682EE7A1B4FE3E06E40238
B07A2E7A7FB3F35502F1CCA283F9420F2FAB9EC0A8C8982BF4AFE69A3D2690B3
CF5DB716B3CB9936C49A12944973F14C2D9A368E4067BDBF91E413A3321B3BFA
B84463D3C680604A4C4E4B49D0F9F9B59D5B68ECD3891FEEDE9B29B9C432212D
82505A8D423BA734A53DEB930A392BA6011C6EA6EBA7ABAA6AAC003721FB34A6
1544EEE16F6AD73E6C5743EFF09975C186A9C769A4732F78AA09218AE576FB14
70E1697B813AC1B09FFAB762678BA9320043C256766AF1BACD3702CED1228B94
57E353589810F99AF74109EFDA0740CB0475DE7870AA7218120462B23441BB1A
60ACAF3B8B171E7509854D1C05C8FBF62979D2B52030B4C91F9D038EF26F2C11
346D0E9955B491C3168E030B9CCE2964883B824F0DCF27EECA6C6E0478CF6B36
AF2D33C9265A5F8D76FCC46AA30E6093E3822CE70C1ED22CDB8A8F910F5BCF45
2C9D2D41B342B43DB5FE5EFCFEB5D378F78684296CAED9A39FC3834929073B6E
A934014457B89A61253E0924D3C6BB4FE4ADFBD0C9B3C61D08E3DB2B26785A1D
3B5E0E23258AE12276B63E9D79B2EAB305B8108A0987216C0EBF033A839BF611
CB208A97C18AD434B4AA716C57905AF301C24DD78EC659F2398D46BAC7C30682
F7E21FFC8370880EB1C9A98807FB05BD23F160F1567070B644C2C0F08C981C81
3D472A623CBA7ADB80D118D51BF4F2D139CD7F27753F38007D4831760CD2077C
23643D8F0C038E949E11415E9C570E6CBEDBB60B480B9892731D073C3357902B
40415292F69357C1AA0C94780336DB4702E659DF67225B2B25811EFE3FBAAA3C
E06C49CC4591E5E347925A62079C501D27DAB6205E3162D86152476602386329
0476AB5766DBE6936974CA9B133459886FA5FF402BE911036A9CA31BB71B6C92
01E5270681E15AC6F3999C114610B08B91FD22B4A4843D0B90276EC2F4FC347A
C814329239DB5C15CD43DB9A894C666F5121D37B7C6428FF061CBE3974D78B54
CD74069DCD42AF4734AB5D4239AB83CBBF751DBBD320BEEAB8F31B6036CAC31D
99C15FBCEA633DA4CDABC8FFEE5E634766C00D4CA8D81F7205A77EC394486032
57C8547EDB7FF10B3CC9ABB2BCBDD51E304153DEF8BD8EE3591005CC1013BB68
B579080881221360FF4A62C4D5235D9EF35E09BB44FEB0E41FFCFBF4F654BEFB
D273339665FAEA9167AE154EC7243623D74A9D2A60883D948DB4127B11F95F0E
2F5ADB3DDA9D8B9EFB7D32096C0562E81868F9B8277ED54053A37E9EA94C922D
C42F22136F3E33F63D819C4F8424ACD9C868CCEEFED00274B00A825E61837A2D
5DA162379664177CFBCD0D4CACE49044160B5275684CAD4C336B730FA4CA49B2
BC2A450D504857287F9D575884130AEB50F8F14B153C615CA8C3D2AF1EBD84A3
F158F2EB29BBD92095A15FFE4C6F40E06658A3A52B61EBFE9F3EE3F7E37AC477
BA24CD27BBFFC121478133B200731F4AF2032B6B6D4F03D113AD8F2391DA0DEE
27653D82D4838E4CF541CC922E141153BE8DD305D1F89C753180D11DAF0C792D
56F3674DEEEEDE6494EF766D2453232DF32A80DE36D626594CA73E0F5058B571
97CE052CA8364A3BE32FD595306A7177DF9BBA06B1B670BBF54D49446E913E64
E630478AABFCEBEDCA6BB1B1C8DC776E6E253D163DA2B6EE9E5C650F0E172EAD
A2082D2C14CC270C7E08D213BFEE4596BA64487C447528013F4015A3080FEC41
DBC11EDBDDA0746B228F45AE86F0A4DF2CEDF61602E7895F3CE32CE145756822
2E9629AD492BE60B91A0EFAFCD3CF61F019C134EC31A31B61715F7258453E321
10D09772F56CC4B267D7773BE2B2836C8882561DB6B76E1D40BA3C5A8745D6AA
ADF93F52BC563A6E27C5456D88F5861DD4E674B4046FFB51B1694C593D3A7D4E
E9C38ACB2DC0102AEB761556EB9C3C71D13737013D4AD5825FCA260C52F34370
DB85657F23087DA39702E64FAB15079224B181E9B6C45207DD6271F5F88A0F8C
3984186804B501D5F0B8EB83C9ABA185AB12A625A364B35857729DFC9EC85908
0E69DBC9DB97DED2FC244C5386AB7A5DD6C2F6D7B58D00BB3397E74AD5339E8F
C901FAAEF60492AAACF12C8FDF612DFE5383F98D49BE25BF19E6D21BC7AC3C1F
857497A5909CE313DA186A628C5437BCE75EEF0144D444B3B9213975D86FAB42
BEBD3B979136CA744374DC7047970A85744BBC7B15ECA6298819C3CFD43E2F5B
66FB7F7EF295784CF4BB97EC59C232BB33507366DFC3FAB358B45AC3A1A41F66
7511D9E06C0D1058A3A36FBB63A6CB58E2FFCA728B488D00FEF055B194963716
F4C638CD29B7B266C55714EC054CCD7FC211C6989A7DA04429CFA85F7A48036D
5B0C0C7448CAE051D9B40D9D5FC7CED07DBC1A729F5EB884A07494FC3CD32B25
C056499909ADB2C51C1B716593E71DDFA245C6F061FA75C47BA92BA3AB974098
4C597BF9360A45DAB32CED234C3DDB4F087295B191BAFA8601FA938220A208F8
7E69991199BD1AA04CE35AB4485C5D3F778ED3D98F7F7D60606BADBB9BE61A81
016CC2AB7F35D5F6C46CDE336F260E46F09BC0C8ABD019BEB8C2BCFC1492D5FC
2E5D7096FE60880690C7029E848F290AEDB43E2DADF66135CCF79C63FFE522C9
0A9F283C9CC4B5D4DD9982360EB2F3E07B0FA2E9A9790249D811A3DA5A27239D
E581D249898A648CA8E33C7273AF4D846C1FF578FF809782618227B2533EB859
40E2E3BE6ED0997FECECC84404014E3CD692A7CE3967C905B6C7CDE743EBCF5D
001F22C147C8F5B58D2C6FF35599022A8164F83D85172C5F294F0EF3F7EFCD42
9A5F91890146261D37F2213784AA79FE9EC56CFFE4DA2CC29B35146F3775E714
31F07B6673ED2E2AC1
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
TeXDict begin 40258431 52099146 1000 600 600 (cfitsio.dvi)
@start /Fa 138[49 30 37 38 1[46 46 51 74 23 2[28 1[42
1[42 2[42 46 11[68 12[68 3[69 68[{}17 90.9091 /CMTI10
rf /Fb 193[71 62[{}1 90.9091 /CMMI10 rf /Fc 149[25 2[45
45 86[45 15[{}4 90.9091 /CMSY10 rf /Fd 134[59 59 81 59
62 44 44 46 59 62 56 62 93 31 59 1[31 62 56 34 51 62
50 62 54 9[116 85 86 78 62 84 1[77 1[88 106 67 88 1[42
88 88 70 74 86 81 80 85 6[31 56 56 56 56 56 56 56 56
56 56 1[31 37 32[62 12[{}58 99.6264 /CMBX12 rf /Fe 129[48
48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48
48 48 48 48 48 48 48 48 48 48 48 1[48 48 48 48 48 48
48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48
48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48
48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48 48
48 48 48 33[{}93 90.9091 /CMTT10 rf /Ff 133[60 71 71
97 71 75 52 53 55 1[75 67 75 112 37 71 1[37 75 67 41
61 75 60 75 65 9[139 102 103 94 75 100 1[92 101 105 128
81 105 1[50 105 106 85 88 103 97 96 102 7[67 67 67 67
67 67 67 67 67 67 67 37 45 3[52 52 27[75 78 11[{}62 119.552
/CMBX12 rf /Fg 135[102 3[75 1[79 1[108 1[108 4[54 108
2[88 108 2[94 29[140 138 146 7[97 97 97 97 97 97 97 97
97 97 48[{}23 172.188 /CMBX12 rf /Fh 165[56 68 68 93
68 68 66 51 67 1[62 71 68 83 57 71 1[33 68 71 59 62 69
66 64 68 7[45 45 45 45 45 45 45 45 45 45 45 25 30 3[35
35 40[{}39 90.9091 /CMSL10 rf /Fi 133[46 55 55 1[55 58
41 41 43 1[58 52 58 87 29 2[29 58 52 32 48 58 46 58 51
9[108 2[73 58 78 1[71 79 82 1[63 2[40 82 82 66 69 80
76 74 79 7[52 52 52 52 52 52 52 52 52 52 2[35 32[58 12[{}51
90.9091 /CMBX10 rf /Fj 132[45 40 48 48 66 48 51 35 36
36 48 51 45 51 76 25 48 28 25 51 45 28 40 51 40 51 45
25 2[25 45 25 56 68 68 93 68 68 66 51 67 71 62 71 68
83 57 71 47 33 68 71 59 62 69 66 64 68 71 43 1[71 1[25
25 45 45 45 45 45 45 45 45 45 45 45 25 30 25 71 45 35
35 25 71 76 45 76 45 25 18[76 51 51 53 11[{}91 90.9091
/CMR10 rf /Fk 140[46 46 1[65 59 65 1[33 2[33 3[52 14[88
20[88 13[59 59 59 59 1[33 46[{}15 119.552 /CMR12 rf /Fl
139[63 64 66 2[81 90 134 45 2[45 1[81 49 74 1[72 1[78
12[112 90 2[110 6[60 2[101 2[117 1[122 65[{}20 143.462
/CMBX12 rf /Fm 133[103 123 123 1[123 129 90 92 95 1[129
116 129 194 65 2[65 129 116 71 106 129 103 129 113 9[240
1[179 162 129 173 1[159 175 182 1[140 2[87 182 183 146
153 178 168 165 175 25[65 26[129 12[{}42 206.559 /CMBX12
rf end
%%EndProlog
%%BeginSetup
%%Feature: *Resolution 600dpi
TeXDict begin
%%BeginPaperSize: Letter
letter
%%EndPaperSize
 end
%%EndSetup
%%Page: 1 1
TeXDict begin 1 0 bop 240 1799 a Fm(CFITSIO)76 b(User's)g(Reference)i
(Guide)727 2258 y Fl(An)53 b(In)l(terface)f(to)i(FITS)g(F)-13
b(ormat)54 b(Files)1263 2518 y(for)g(C)f(Programmers)1667
3013 y Fk(V)-10 b(ersion)38 b(3.3)1727 3916 y Fj(HEASAR)m(C)1764
4029 y(Co)s(de)30 b(662)1363 4142 y(Go)s(ddard)f(Space)i(Fligh)m(t)h
(Cen)m(ter)1522 4255 y(Green)m(b)s(elt,)f(MD)h(20771)1857
4367 y(USA)1682 5227 y Fk(April)37 b(2012)p eop end
%%Page: 2 2
TeXDict begin 2 1 bop 0 299 a Fj(ii)p eop end
%%Page: 3 3
TeXDict begin 3 2 bop 0 1267 a Fm(Con)-6 b(ten)g(ts)0
1858 y Fi(1)84 b(In)m(tro)s(duction)3136 b(1)136 2020
y Fj(1.1)125 b(A)30 b(Brief)h(Ov)m(erview)85 b(.)46 b(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131
b(1)136 2182 y(1.2)94 b(Sources)30 b(of)h(FITS)f(Soft)m(w)m(are)h(and)f
(Information)38 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(1)136
2344 y(1.3)94 b(Ac)m(kno)m(wledgmen)m(ts)30 b(.)46 b(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131
b(2)136 2506 y(1.4)94 b(Legal)32 b(Stu\013)92 b(.)46
b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)f(.)131 b(4)0 2766 y Fi(2)119 b(Creating)34
b(the)h(CFITSIO)e(Library)2256 b(5)136 2928 y Fj(2.1)94
b(Building)31 b(the)f(Library)58 b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(5)345 3090
y(2.1.1)106 b(Unix)31 b(Systems)44 b(.)h(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(5)345 3252
y(2.1.2)106 b(VMS)33 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(7)345
3413 y(2.1.3)106 b(Windo)m(ws)31 b(PCs)f(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(7)345
3575 y(2.1.4)106 b(Macin)m(tosh)32 b(PCs)55 b(.)46 b(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(7)136
3737 y(2.2)94 b(T)-8 b(esting)32 b(the)e(Library)j(.)46
b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
f(.)131 b(8)136 3899 y(2.3)94 b(Linking)31 b(Programs)f(with)g(CFITSIO)
45 b(.)g(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(9)136
4061 y(2.4)94 b(Using)31 b(CFITSIO)e(in)h(Multi-threaded)h(En)m
(vironmen)m(ts)62 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)131 b(9)136 4223 y(2.5)94
b(Getting)32 b(Started)f(with)f(CFITSIO)60 b(.)46 b(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)f(.)85 b(10)136 4385 y(2.6)94 b(Example)31
b(Program)86 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)f(.)85 b(10)0 4645 y Fi(3)119 b(A)35
b(FITS)f(Primer)2918 b(13)0 4904 y(4)119 b(Programming)37
b(Guidelines)2482 b(15)136 5066 y Fj(4.1)94 b(CFITSIO)29
b(De\014nitions)44 b(.)h(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)f(.)85 b(15)136 5228 y(4.2)94 b(Curren)m(t)30
b(Header)h(Data)h(Unit)e(\(CHDU\))87 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)f(.)85 b(17)136 5390 y(4.3)94 b(F)-8 b(unction)32
b(Names)e(and)g(V)-8 b(ariable)32 b(Datat)m(yp)s(es)41
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(18)136 5552 y(4.4)94
b(Supp)s(ort)29 b(for)h(Unsigned)g(In)m(tegers)h(and)f(Signed)g(Bytes)
86 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)f(.)85 b(20)136 5714 y(4.5)94 b(Dealing)33
b(with)d(Character)g(Strings)61 b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)f(.)85 b(22)1912 5942 y(iii)p eop end
%%Page: 4 4
TeXDict begin 4 3 bop 0 299 a Fj(iv)3311 b Fh(CONTENTS)136
555 y Fj(4.6)94 b(Implicit)31 b(Data)h(T)m(yp)s(e)e(Con)m(v)m(ersion)65
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(23)136 716 y(4.7)94 b(Data)32 b(Scaling)89 b(.)46 b(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(23)136 876 y(4.8)94 b(Supp)s(ort)29 b(for)h(IEEE)g(Sp)s(ecial)g(V)-8
b(alues)68 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(24)136 1037 y(4.9)94 b(Error)30 b(Status)g(V)-8 b(alues)32
b(and)d(the)i(Error)e(Message)j(Stac)m(k)44 b(.)i(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(24)136 1197 y(4.10)49 b(V)-8 b(ariable-Length)33 b(Arra)m(ys)d(in)g
(Binary)h(T)-8 b(ables)31 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(25)136 1358 y(4.11)49 b(Multiple)32 b(Access)f(to)g(the)g(Same)f
(FITS)g(File)h(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(26)136 1518 y(4.12)49 b(When)31 b(the)f(Final)h(Size)g(of)g(the)f
(FITS)g(HDU)h(is)f(Unkno)m(wn)k(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(27)136 1678
y(4.13)49 b(CFITSIO)29 b(Size)i(Limitations)42 b(.)k(.)f(.)h(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(27)0 1931
y Fi(5)f(Basic)36 b(CFITSIO)d(In)m(terface)h(Routines)2074
b(29)136 2092 y Fj(5.1)94 b(CFITSIO)29 b(Error)h(Status)g(Routines)89
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(29)136
2252 y(5.2)94 b(FITS)30 b(File)i(Access)f(Routines)g(.)46
b(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(30)136 2412 y(5.3)94 b(HDU)32 b(Access)f(Routines)72
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)85 b(33)136 2573 y(5.4)94 b(Header)31 b(Keyw)m(ord)f(Read/W)-8
b(rite)33 b(Routines)40 b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(35)345 2733 y(5.4.1)106 b(Keyw)m(ord)30 b(Reading)h(Routines)65
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(35)345
2894 y(5.4.2)106 b(Keyw)m(ord)30 b(W)-8 b(riting)32 b(Routines)86
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(38)136
3054 y(5.5)94 b(Primary)30 b(Arra)m(y)h(or)f(IMA)m(GE)i(Extension)e
(I/O)g(Routines)54 b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(40)136 3215 y(5.6)94
b(Image)32 b(Compression)f(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(44)136 3375
y(5.7)94 b(ASCI)s(I)29 b(and)h(Binary)h(T)-8 b(able)31
b(Routines)85 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(48)345 3536 y(5.7.1)106 b(Create)32 b(New)e(T)-8 b(able)84
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(48)345 3696 y(5.7.2)106 b(Column)30 b(Information)g(Routines)h(.)46
b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(49)345 3857 y(5.7.3)106
b(Routines)31 b(to)g(Edit)f(Ro)m(ws)h(or)f(Columns)39
b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(52)345 4017 y(5.7.4)106
b(Read)31 b(and)f(W)-8 b(rite)31 b(Column)f(Data)i(Routines)66
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)f(.)85 b(53)345 4178 y(5.7.5)106 b(Ro)m(w)31
b(Selection)h(and)e(Calculator)h(Routines)88 b(.)46 b(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(56)345 4338 y(5.7.6)106 b(Column)30 b(Binning)g(or)g(Histogramming)i
(Routines)74 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)f(.)85 b(57)136 4498 y(5.8)94 b(Utilit)m(y)33
b(Routines)27 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(60)345 4659 y(5.8.1)106
b(File)32 b(Chec)m(ksum)e(Routines)47 b(.)f(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)f(.)85 b(60)345 4819 y(5.8.2)106 b(Date)32
b(and)e(Time)g(Utilit)m(y)j(Routines)90 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)85 b(61)345 4980 y(5.8.3)106 b(General)32 b(Utilit)m(y)g(Routines)h
(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(62)0 5232 y Fi(6)119 b(The)35 b(CFITSIO)e(Iterator)g(F)-9
b(unction)2154 b(73)136 5393 y Fj(6.1)94 b(The)30 b(Iterator)i(W)-8
b(ork)31 b(F)-8 b(unction)45 b(.)g(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)f(.)85 b(74)136 5553 y(6.2)94 b(The)30 b(Iterator)i(Driv)m
(er)f(F)-8 b(unction)78 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)f(.)85 b(76)136 5714 y(6.3)94 b(Guidelines)31
b(for)f(Using)h(the)f(Iterator)i(F)-8 b(unction)45 b(.)h(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)85 b(77)p eop end
%%Page: 5 5
TeXDict begin 5 4 bop 0 299 a Fh(CONTENTS)3334 b Fj(v)136
555 y(6.4)94 b(Complete)32 b(List)e(of)h(Iterator)g(Routines)62
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(78)0
823 y Fi(7)119 b(W)-9 b(orld)36 b(Co)s(ordinate)e(System)h(Routines)
1992 b(81)136 986 y Fj(7.1)125 b(Self-con)m(tained)32
b(W)m(CS)e(Routines)f(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)85 b(82)0 1254 y Fi(8)119 b(Hierarc)m(hical)36
b(Grouping)g(Routines)2163 b(85)136 1418 y Fj(8.1)94
b(Grouping)30 b(T)-8 b(able)31 b(Routines)87 b(.)46 b(.)f(.)h(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(86)136 1581
y(8.2)94 b(Group)30 b(Mem)m(b)s(er)g(Routines)h(.)46
b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(88)0 1849 y Fi(9)119 b(Sp)s(ecialized)36 b(CFITSIO)d(In)m(terface)h
(Routines)1777 b(91)136 2013 y Fj(9.1)94 b(FITS)30 b(File)i(Access)f
(Routines)g(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
f(.)85 b(91)136 2176 y(9.2)94 b(HDU)32 b(Access)f(Routines)72
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)85 b(95)136 2340 y(9.3)94 b(Sp)s(ecialized)32 b(Header)e(Keyw)m(ord)
h(Routines)74 b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85
b(97)345 2503 y(9.3.1)106 b(Header)31 b(Information)f(Routines)64
b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(97)345 2667
y(9.3.2)106 b(Read)31 b(and)f(W)-8 b(rite)31 b(the)g(Required)f(Keyw)m
(ords)51 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(97)345 2830 y(9.3.3)106
b(W)-8 b(rite)32 b(Keyw)m(ord)e(Routines)c(.)46 b(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)f(.)85 b(99)345 2994 y(9.3.4)106
b(Insert)30 b(Keyw)m(ord)g(Routines)89 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)f(.)40 b(101)345 3157 y(9.3.5)106 b(Read)31
b(Keyw)m(ord)f(Routines)45 b(.)h(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)40 b(102)345 3321 y(9.3.6)106 b(Mo)s(dify)30 b(Keyw)m(ord)h
(Routines)36 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(104)345 3484 y(9.3.7)106 b(Up)s(date)31 b(Keyw)m(ord)f(Routines)c(.)
45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(105)136
3648 y(9.4)94 b(De\014ne)31 b(Data)h(Scaling)f(and)f(Unde\014ned)f
(Pixel)i(P)m(arameters)43 b(.)j(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(106)136 3811 y(9.5)94
b(Sp)s(ecialized)32 b(FITS)d(Primary)h(Arra)m(y)h(or)f(IMA)m(GE)h
(Extension)g(I/O)f(Routines)55 b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)
40 b(107)136 3975 y(9.6)94 b(Sp)s(ecialized)32 b(FITS)d(ASCI)s(I)g(and)
h(Binary)g(T)-8 b(able)31 b(Routines)87 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(110)345
4138 y(9.6.1)106 b(General)32 b(Column)d(Routines)51
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(110)345
4302 y(9.6.2)106 b(Lo)m(w-Lev)m(el)33 b(T)-8 b(able)31
b(Access)g(Routines)40 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(112)345 4465 y(9.6.3)106 b(W)-8 b(rite)32 b(Column)e(Data)i(Routines)
52 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(112)345
4629 y(9.6.4)106 b(Read)31 b(Column)e(Data)j(Routines)72
b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(113)0 4896
y Fi(10)67 b(Extended)35 b(File)f(Name)h(Syn)m(tax)2278
b(117)136 5060 y Fj(10.1)49 b(Ov)m(erview)84 b(.)46 b(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)40 b(117)136 5223 y(10.2)49 b(Filet)m(yp)s(e)62
b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(120)345 5387
y(10.2.1)61 b(Notes)32 b(ab)s(out)e(HTTP)g(pro)m(xy)g(serv)m(ers)k(.)46
b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(120)345 5550 y(10.2.2)61
b(Notes)32 b(ab)s(out)e(the)h(stream)f(\014let)m(yp)s(e)h(driv)m(er)54
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)f(.)40 b(121)345 5714 y(10.2.3)61 b(Notes)32
b(ab)s(out)e(the)h(gsiftp)f(\014let)m(yp)s(e)83 b(.)45
b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(122)p eop end
%%Page: 6 6
TeXDict begin 6 5 bop 0 299 a Fj(vi)3311 b Fh(CONTENTS)345
555 y Fj(10.2.4)61 b(Notes)32 b(ab)s(out)e(the)h(ro)s(ot)f(\014let)m
(yp)s(e)68 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h
(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(122)345 716 y(10.2.5)61 b(Notes)32 b(ab)s(out)e(the)h(shmem)e
(\014let)m(yp)s(e:)70 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(124)136 876 y(10.3)49 b(Base)32 b(Filename)90 b(.)45
b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)f(.)40 b(124)136 1037 y(10.4)49 b(Output)30 b(File)h(Name)g
(when)f(Op)s(ening)f(an)h(Existing)h(File)81 b(.)45 b(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(126)136 1197 y(10.5)49 b(T)-8 b(emplate)32 b(File)g(Name)f(when)e
(Creating)i(a)g(New)f(File)57 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(128)136
1358 y(10.6)49 b(Image)32 b(Tile-Compression)e(Sp)s(eci\014cation)91
b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(128)136 1518
y(10.7)49 b(HDU)32 b(Lo)s(cation)f(Sp)s(eci\014cation)47
b(.)e(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(128)136 1678 y(10.8)49 b(Image)32 b(Section)39 b(.)46
b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)f(.)40 b(130)136 1839 y(10.9)49 b(Image)32
b(T)-8 b(ransform)29 b(Filters)54 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(131)136 1999 y(10.10)t(Column)30
b(and)g(Keyw)m(ord)g(Filtering)h(Sp)s(eci\014cation)91
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)f(.)40 b(132)136 2160 y(10.11)t(Ro)m(w)31
b(Filtering)h(Sp)s(eci\014cation)82 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(134)345 2320 y(10.11.1)16
b(General)32 b(Syn)m(tax)44 b(.)i(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(135)345 2481 y(10.11.2)16
b(Bit)32 b(Masks)43 b(.)j(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(138)345 2641 y(10.11.3)16
b(V)-8 b(ector)32 b(Columns)92 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)
f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(138)345 2802 y(10.11.4)16
b(Go)s(o)s(d)30 b(Time)h(In)m(terv)-5 b(al)31 b(Filtering)62
b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(140)345
2962 y(10.11.5)16 b(Spatial)31 b(Region)h(Filtering)59
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(141)345 3123 y(10.11.6)16 b(Example)31 b(Ro)m(w)g(Filters)h(.)45
b(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(143)136 3283 y(10.12)35 b(Binning)30 b(or)g(Histogramming)i(Sp)s
(eci\014cation)f(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(144)0
3536 y Fi(11)32 b(T)-9 b(emplate)35 b(Files)2933 b(147)136
3696 y Fj(11.1)49 b(Detailed)33 b(T)-8 b(emplate)31 b(Line)g(F)-8
b(ormat)48 b(.)e(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(147)136 3857 y(11.2)49 b(Auto-indexing)31 b(of)g(Keyw)m(ords)73
b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(148)136 4017 y(11.3)49 b(T)-8 b(emplate)32 b(P)m(arser)f(Directiv)m
(es)87 b(.)45 b(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(149)136 4178 y(11.4)49 b(F)-8 b(ormal)32 b(T)-8 b(emplate)32
b(Syn)m(tax)i(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)f(.)40 b(149)136 4338 y(11.5)49 b(Errors)63 b(.)46
b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)
g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(150)136 4498 y(11.6)49
b(Examples)72 b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(150)0
4751 y Fi(12)67 b(Lo)s(cal)35 b(FITS)g(Con)m(v)m(en)m(tions)2462
b(153)136 4912 y Fj(12.1)49 b(64-Bit)33 b(Long)e(In)m(tegers)61
b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)
g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)40 b(153)136 5072 y(12.2)49 b(Long)31 b(String)f(Keyw)m(ord)g(V)
-8 b(alues.)65 b(.)46 b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)
40 b(153)136 5232 y(12.3)49 b(Arra)m(ys)31 b(of)f(Fixed-Length)i
(Strings)d(in)h(Binary)h(T)-8 b(ables)78 b(.)46 b(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(155)136 5393 y(12.4)49 b(Keyw)m(ord)31 b(Units)f(Strings)41
b(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)40 b(155)136 5553 y(12.5)49 b(HIERAR)m(CH)31 b(Con)m(v)m(en)m(tion)h
(for)e(Extended)g(Keyw)m(ord)g(Names)91 b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)
g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(156)136 5714
y(12.6)49 b(Tile-Compressed)31 b(Image)g(F)-8 b(ormat)52
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(156)p eop end
%%Page: 7 7
TeXDict begin 7 6 bop 0 299 a Fh(CONTENTS)3284 b Fj(vii)0
555 y Fi(13)67 b(Optimizing)35 b(Programs)2589 b(159)136
715 y Fj(13.1)49 b(Ho)m(w)32 b(CFITSIO)c(Manages)k(Data)g(I/O)78
b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)
f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40 b(159)136
876 y(13.2)49 b(Optimization)32 b(Strategies)77 b(.)46
b(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)40
b(160)0 1127 y Fi(A)57 b(Index)35 b(of)g(Routines)2789
b(165)0 1378 y(B)62 b(P)m(arameter)35 b(De\014nitions)2598
b(171)0 1629 y(C)60 b(CFITSIO)33 b(Error)i(Status)f(Co)s(des)2255
b(177)p eop end
%%Page: 8 8
TeXDict begin 8 7 bop 0 299 a Fj(viii)3261 b Fh(CONTENTS)p
eop end
%%Page: 1 9
TeXDict begin 1 8 bop 0 1225 a Fg(Chapter)65 b(1)0 1687
y Fm(In)-6 b(tro)6 b(duction)0 2216 y Ff(1.1)180 b(A)45
b(Brief)g(Ov)l(erview)0 2495 y Fj(CFITSIO)38 b(is)i(a)g(mac)m
(hine-indep)s(enden)m(t)g(library)f(of)h(routines)f(for)h(reading)g
(and)f(writing)g(data)i(\014les)e(in)h(the)0 2608 y(FITS)35
b(\(Flexible)i(Image)f(T)-8 b(ransp)s(ort)34 b(System\))h(data)h
(format.)56 b(It)35 b(can)h(also)g(read)f(IRAF)h(format)f(image)i
(\014les)0 2721 y(and)f(ra)m(w)h(binary)f(data)h(arra)m(ys)g(b)m(y)g
(con)m(v)m(erting)i(them)d(on)h(the)g(\015y)f(in)m(to)i(a)f(virtual)g
(FITS)f(format)h(\014le.)60 b(This)0 2833 y(library)32
b(is)h(written)g(in)f(ANSI)h(C)f(and)g(pro)m(vides)h(a)g(p)s(o)m(w)m
(erful)f(y)m(et)i(simple)f(in)m(terface)h(for)f(accessing)h(FITS)e
(\014les)0 2946 y(whic)m(h)k(will)h(run)e(on)h(most)h(commonly)g(used)f
(computers)g(and)g(w)m(orkstations.)60 b(CFITSIO)35 b(supp)s(orts)f
(all)k(the)0 3059 y(features)26 b(describ)s(ed)e(in)h(the)g(o\016cial)i
(NOST)d(de\014nition)h(of)h(the)f(FITS)g(format)h(and)e(can)i(read)f
(and)g(write)h(all)g(the)0 3172 y(curren)m(tly)c(de\014ned)e(t)m(yp)s
(es)i(of)g(extensions,)i(including)d(ASCI)s(I)g(tables)h(\(T)-8
b(ABLE\),)23 b(Binary)f(tables)h(\(BINT)-8 b(ABLE\))0
3285 y(and)27 b(IMA)m(GE)h(extensions.)40 b(The)27 b(CFITSIO)f
(routines)h(insulate)h(the)f(programmer)g(from)g(ha)m(ving)g(to)h(deal)
g(with)0 3398 y(the)d(complicated)h(formatting)g(details)f(in)f(the)h
(FITS)f(\014le,)i(ho)m(w)m(ev)m(er,)i(it)d(is)f(assumed)g(that)h(users)
f(ha)m(v)m(e)i(a)f(general)0 3511 y(kno)m(wledge)31 b(ab)s(out)f(the)h
(structure)f(and)g(usage)h(of)f(FITS)g(\014les.)0 3671
y(CFITSIO)k(also)j(con)m(tains)h(a)e(set)h(of)f(F)-8
b(ortran)36 b(callable)i(wrapp)s(er)d(routines)g(whic)m(h)h(allo)m(w)i
(F)-8 b(ortran)36 b(programs)0 3784 y(to)31 b(call)g(the)f(CFITSIO)e
(routines.)41 b(See)30 b(the)g(companion)g(\\FITSIO)f(User's)h(Guide")g
(for)g(the)g(de\014nition)g(of)g(the)0 3897 y(F)-8 b(ortran)39
b(subroutine)d(calling)k(sequences.)63 b(These)38 b(wrapp)s(ers)e
(replace)j(the)f(older)g(F)-8 b(ortran)39 b(FITSIO)d(library)0
4010 y(whic)m(h)30 b(is)h(no)f(longer)h(supp)s(orted.)0
4170 y(The)20 b(CFITSIO)f(pac)m(k)-5 b(age)23 b(w)m(as)e(initially)i
(dev)m(elop)s(ed)e(b)m(y)f(the)h(HEASAR)m(C)g(\(High)h(Energy)e
(Astroph)m(ysics)h(Science)0 4283 y(Arc)m(hiv)m(e)35
b(Researc)m(h)g(Cen)m(ter\))f(at)h(the)f(NASA)g(Go)s(ddard)e(Space)j
(Fligh)m(t)g(Cen)m(ter)f(to)h(con)m(v)m(ert)g(v)-5 b(arious)34
b(existing)0 4396 y(and)25 b(newly)h(acquired)g(astronomical)i(data)e
(sets)h(in)m(to)g(FITS)e(format)h(and)f(to)i(further)e(analyze)i(data)g
(already)f(in)0 4509 y(FITS)h(format.)41 b(New)28 b(features)g(con)m
(tin)m(ue)h(to)g(b)s(e)e(added)h(to)g(CFITSIO)f(in)g(large)i(part)f
(due)g(to)g(con)m(tributions)h(of)0 4622 y(ideas)k(or)g(actual)h(co)s
(de)f(from)f(users)g(of)h(the)g(pac)m(k)-5 b(age.)49
b(The)33 b(In)m(tegral)h(Science)f(Data)h(Cen)m(ter)f(in)g
(Switzerland,)0 4734 y(and)g(the)g(XMM/ESTEC)h(pro)5
b(ject)34 b(in)f(The)g(Netherlands)g(made)g(esp)s(ecially)i
(signi\014can)m(t)f(con)m(tributions)g(that)0 4847 y(resulted)c(in)g
(man)m(y)h(of)f(the)h(new)f(features)g(that)h(app)s(eared)f(in)g(v2.0)i
(of)e(CFITSIO.)0 5322 y Ff(1.2)135 b(Sources)45 b(of)g(FITS)f(Soft)l(w)
l(are)i(and)f(Information)0 5601 y Fj(The)22 b(latest)i(v)m(ersion)f
(of)g(the)f(CFITSIO)f(source)i(co)s(de,)h(do)s(cumen)m(tation,)i(and)21
b(example)j(programs)e(are)h(a)m(v)-5 b(ailable)0 5714
y(on)30 b(the)h(W)-8 b(orld-Wide)32 b(W)-8 b(eb)31 b(or)f(via)h(anon)m
(ymous)f(ftp)g(from:)1927 5942 y(1)p eop end
%%Page: 2 10
TeXDict begin 2 9 bop 0 299 a Fj(2)2452 b Fh(CHAPTER)30
b(1.)71 b(INTR)m(ODUCTION)382 555 y Fe(http://heasarc.gsfc.nasa)o(.go)o
(v/fi)o(tsio)382 668 y(ftp://legacy.gsfc.nasa.g)o(ov/)o(soft)o(ware)o
(/fi)o(tsio)o(/c)0 959 y Fj(An)m(y)28 b(questions,)g(bug)f(rep)s(orts,)
h(or)f(suggested)i(enhancemen)m(ts)f(related)g(to)h(the)e(CFITSIO)f
(pac)m(k)-5 b(age)30 b(should)d(b)s(e)0 1072 y(sen)m(t)k(to)g(the)g
(primary)e(author:)382 1362 y Fe(Dr.)47 b(William)f(Pence)810
b(Telephone:)92 b(\(301\))47 b(286-4599)382 1475 y(HEASARC,)e(Code)i
(662)811 b(E-mail:)45 b(William.D.Pence@nasa.gov)382
1588 y(NASA/Goddard)f(Space)j(Flight)f(Center)382 1701
y(Greenbelt,)f(MD)i(20771,)f(USA)0 1992 y Fj(This)40
b(User's)i(Guide)f(assumes)g(that)h(readers)f(already)g(ha)m(v)m(e)i(a)
f(general)g(understanding)d(of)j(the)f(de\014nition)0
2104 y(and)31 b(structure)g(of)h(FITS)e(format)i(\014les.)44
b(F)-8 b(urther)32 b(information)f(ab)s(out)h(FITS)f(formats)g(is)h(a)m
(v)-5 b(ailable)34 b(from)d(the)0 2217 y(FITS)h(Supp)s(ort)f(O\016ce)i
(at)g Fe(http://fits.gsfc.nasa.gov)o Fj(.)42 b(In)32
b(particular,)i(the)f('NOST)f(FITS)g(Standard')0 2330
y(giv)m(es)j(the)g(authoritativ)m(e)h(de\014nition)e(of)g(the)g(FITS)g
(data)h(format,)g(and)f(the)g(`FITS)g(User's)g(Guide')g(pro)m(vides)0
2443 y(additional)d(historical)h(bac)m(kground)e(and)g(practical)i
(advice)f(on)f(using)g(FITS)g(\014les.)0 2603 y(The)38
b(HEASAR)m(C)g(also)i(pro)m(vides)e(a)h(v)m(ery)g(sophisticated)h(FITS)
d(\014le)i(analysis)g(program)f(called)i(`Fv')f(whic)m(h)0
2716 y(can)34 b(b)s(e)f(used)g(to)h(displa)m(y)g(and)f(edit)h(the)g
(con)m(ten)m(ts)i(of)e(an)m(y)g(FITS)f(\014le)g(as)h(w)m(ell)h(as)f
(construct)g(new)f(FITS)g(\014les)0 2829 y(from)j(scratc)m(h.)61
b(The)36 b(displa)m(y)h(functions)f(in)g(Fv)h(allo)m(w)h(users)e(to)i
(in)m(teractiv)m(ely)h(adjust)d(the)h(brigh)m(tness)g(and)0
2942 y(con)m(trast)h(of)f(images,)i(pan,)f(zo)s(om,)h(and)d(blink)g
(images,)k(and)c(measure)h(the)f(p)s(ositions)h(and)f(brigh)m(tnesses)h
(of)0 3055 y(ob)5 b(jects)33 b(within)f(images.)47 b(FITS)31
b(tables)i(can)g(b)s(e)e(displa)m(y)m(ed)i(lik)m(e)h(a)e(spread)g
(sheet,)h(and)f(then)f(mo)s(di\014ed)g(using)0 3168 y(p)s(o)m(w)m
(erful)26 b(calculator)j(and)c(sorting)i(functions.)39
b(Fv)27 b(is)f(freely)h(a)m(v)-5 b(ailable)29 b(for)d(most)h(Unix)f
(platforms,)i(Mac)f(PCs,)0 3281 y(and)34 b(Windo)m(ws)g(PCs.)52
b(CFITSIO)33 b(users)h(ma)m(y)h(also)g(b)s(e)f(in)m(terested)i(in)e
(the)g(FTOOLS)f(pac)m(k)-5 b(age)37 b(of)d(programs)0
3394 y(that)27 b(can)f(b)s(e)g(used)f(to)i(manipulate)g(and)e(analyze)j
(FITS)d(format)i(\014les.)39 b(Fv)27 b(and)e(FTOOLS)g(are)i(a)m(v)-5
b(ailable)28 b(from)0 3507 y(their)i(resp)s(ectiv)m(e)i(W)-8
b(eb)31 b(sites)g(at:)382 3797 y Fe(http://fv.gsfc.nasa.gov)382
3910 y(http://heasarc.gsfc.nasa)o(.go)o(v/ft)o(ools)0
4280 y Ff(1.3)135 b(Ac)l(kno)l(wledgmen)l(ts)0 4538 y
Fj(The)27 b(dev)m(elopmen)m(t)h(of)g(the)f(man)m(y)g(p)s(o)m(w)m(erful)
g(features)h(in)f(CFITSIO)e(w)m(as)j(made)f(p)s(ossible)g(through)f
(collab)s(ora-)0 4650 y(tions)33 b(with)e(man)m(y)i(p)s(eople)f(or)g
(organizations)i(from)e(around)f(the)h(w)m(orld.)46 b(The)32
b(follo)m(wing)h(in)f(particular)h(ha)m(v)m(e)0 4763
y(made)d(esp)s(ecially)i(signi\014can)m(t)f(con)m(tributions:)0
4924 y(Programmers)25 b(from)h(the)f(In)m(tegral)i(Science)g(Data)g
(Cen)m(ter,)g(Switzerland)f(\(namely)-8 b(,)28 b(Jurek)c(Bork)m(o)m
(wski,)29 b(Bruce)0 5036 y(O'Neel,)34 b(and)e(Don)h(Jennings\),)f
(designed)g(the)h(concept)g(for)f(the)h(plug-in)f(I/O)g(driv)m(ers)g
(that)h(w)m(as)g(in)m(tro)s(duced)0 5149 y(with)i(CFITSIO)e(2.0.)56
b(The)34 b(use)h(of)g(`driv)m(ers')g(greatly)h(simpli\014ed)f(the)g(lo)
m(w-lev)m(el)j(I/O,)d(whic)m(h)f(in)h(turn)f(made)0 5262
y(other)40 b(new)f(features)i(in)e(CFITSIO)f(\(e.g.,)45
b(supp)s(ort)38 b(for)h(compressed)h(FITS)f(\014les)h(and)f(supp)s(ort)
f(for)i(IRAF)0 5375 y(format)32 b(image)g(\014les\))g(m)m(uc)m(h)f
(easier)i(to)f(implemen)m(t.)44 b(Jurek)31 b(Bork)m(o)m(wski)h(wrote)g
(the)g(Shared)e(Memory)i(driv)m(er,)0 5488 y(and)23 b(Bruce)i(O'Neel)g
(wrote)f(the)g(driv)m(ers)g(for)f(accessing)j(FITS)d(\014les)h(o)m(v)m
(er)h(the)f(net)m(w)m(ork)h(using)e(the)i(FTP)-8 b(,)24
b(HTTP)-8 b(,)0 5601 y(and)26 b(R)m(OOT)g(proto)s(cols.)41
b(Also,)28 b(in)e(2009,)k(Bruce)d(O'Neel)h(w)m(as)f(the)g(k)m(ey)g(dev)
m(elop)s(er)g(of)g(the)g(thread-safe)g(v)m(ersion)0 5714
y(of)k(CFITSIO.)p eop end
%%Page: 3 11
TeXDict begin 3 10 bop 0 299 a Fh(1.3.)72 b(A)m(CKNO)m(WLEDGMENTS)2623
b Fj(3)0 555 y(The)45 b(ISDC)g(also)h(pro)m(vided)f(the)h(template)h
(parsing)e(routines)g(\(written)h(b)m(y)f(Jurek)g(Bork)m(o)m(wski\))i
(and)e(the)0 668 y(hierarc)m(hical)39 b(grouping)d(routines)h
(\(written)h(b)m(y)f(Don)h(Jennings\).)60 b(The)37 b(ISDC)f(D)m(AL)i
(\(Data)h(Access)f(La)m(y)m(er\))0 781 y(routines)30
b(are)h(la)m(y)m(ered)h(on)e(top)h(of)f(CFITSIO)f(and)h(mak)m(e)h
(extensiv)m(e)h(use)e(of)h(these)g(features.)0 941 y(Giuliano)g(T)-8
b(a\013oni)31 b(and)f(Andrea)g(Barisani,)i(at)f(INAF,)g(Univ)m(ersit)m
(y)h(of)e(T)-8 b(rieste,)32 b(Italy)-8 b(,)32 b(implemen)m(ted)e(the)h
(I/O)0 1054 y(driv)m(er)f(routines)g(for)h(accessing)g(FITS)f(\014les)g
(on)h(the)f(computational)i(grids)e(using)g(the)h(gridftp)e(proto)s
(col.)0 1214 y(Uw)m(e)c(Lammers)e(\(XMM/ESA/ESTEC,)h(The)g
(Netherlands\))g(designed)g(the)g(high-p)s(erformance)f(lexical)j
(pars-)0 1327 y(ing)42 b(algorithm)h(that)f(is)g(used)f(to)i(do)e
(on-the-\015y)h(\014ltering)g(of)g(FITS)f(tables.)76
b(This)41 b(algorithm)i(essen)m(tially)0 1440 y(pre-compiles)36
b(the)g(user-supplied)e(selection)k(expression)d(in)m(to)i(a)f(form)g
(that)g(can)g(b)s(e)f(rapidly)g(ev)-5 b(aluated)37 b(for)0
1553 y(eac)m(h)31 b(ro)m(w.)40 b(P)m(eter)31 b(Wilson)f(\(RSTX,)f
(NASA/GSF)m(C\))i(then)e(wrote)h(the)g(parsing)f(routines)g(used)g(b)m
(y)g(CFITSIO)0 1666 y(based)i(on)f(Lammers')h(design,)g(com)m(bined)g
(with)g(other)g(tec)m(hniques)g(suc)m(h)g(as)g(the)g(CFITSIO)f
(iterator)i(routine)0 1779 y(to)g(further)e(enhance)h(the)h(data)g(pro)
s(cessing)f(throughput.)42 b(This)31 b(e\013ort)h(also)g(b)s
(ene\014ted)e(from)h(a)h(m)m(uc)m(h)f(earlier)0 1892
y(lexical)25 b(parsing)f(routine)f(that)h(w)m(as)g(dev)m(elop)s(ed)g(b)
m(y)g(Ken)m(t)g(Blac)m(kburn)f(\(NASA/GSF)m(C\).)i(More)g(recen)m(tly)
-8 b(,)27 b(Craig)0 2005 y(Markw)m(ardt)i(\(NASA/GSF)m(C\))g(implemen)m
(ted)g(additional)g(functions)f(\(median,)h(a)m(v)m(erage,)j(stddev\))c
(and)g(other)0 2118 y(enhancemen)m(ts)j(to)g(the)g(lexical)h(parser.)0
2278 y(The)40 b(CFITSIO)g(iterator)i(function)e(is)h(lo)s(osely)h
(based)f(on)f(similar)i(ideas)f(dev)m(elop)s(ed)g(for)g(the)g(XMM)g
(Data)0 2391 y(Access)31 b(La)m(y)m(er.)0 2551 y(P)m(eter)25
b(Wilson)g(\(RSTX,)f(NASA/GSF)m(C\))h(wrote)g(the)f(complete)i(set)e
(of)h(F)-8 b(ortran-callable)27 b(wrapp)s(ers)22 b(for)i(all)h(the)0
2664 y(CFITSIO)k(routines,)h(whic)m(h)g(in)g(turn)g(rely)g(on)h(the)f
(CF)m(OR)-8 b(TRAN)31 b(macro)g(dev)m(elop)s(ed)g(b)m(y)f(Burkhard)f
(Buro)m(w.)0 2824 y(The)h(syn)m(tax)i(used)e(b)m(y)h(CFITSIO)f(for)g
(\014ltering)i(or)f(binning)e(input)h(FITS)h(\014les)g(is)g(based)f(on)
h(ideas)h(dev)m(elop)s(ed)0 2937 y(for)41 b(the)g(AXAF)h(Science)g(Cen)
m(ter)g(Data)h(Mo)s(del)e(b)m(y)g(Jonathan)g(McDo)m(w)m(ell,)47
b(An)m(tonella)c(F)-8 b(ruscione,)45 b(Aneta)0 3050 y(Siemigino)m(wsk)
-5 b(a)27 b(and)e(Bill)i(Jo)m(y)m(e.)41 b(See)26 b(h)m
(ttp://heasarc.gsfc.nasa.go)m(v/do)s(cs/journal/axa)q(f7.h)m(t)q(ml)32
b(for)25 b(further)0 3163 y(description)30 b(of)h(the)g(AXAF)g(Data)h
(Mo)s(del.)0 3323 y(The)j(\014le)g(decompression)g(co)s(de)g(w)m(ere)h
(tak)m(en)g(directly)g(from)e(the)i(gzip)f(\(GNU)h(zip\))g(program)f
(dev)m(elop)s(ed)g(b)m(y)0 3436 y(Jean-loup)30 b(Gailly)i(and)e
(others.)0 3596 y(The)e(new)h(compressed)g(image)h(data)g(format)f
(\(where)g(the)g(image)h(is)f(tiled)h(and)e(the)h(compressed)g(b)m(yte)
h(stream)0 3709 y(from)k(eac)m(h)i(tile)h(is)d(stored)h(in)g(a)g
(binary)f(table\))j(w)m(as)e(implemen)m(ted)g(in)g(collab)s(oration)i
(with)d(Ric)m(hard)h(White)0 3822 y(\(STScI\),)30 b(P)m(erry)g
(Green\014eld)h(\(STScI\))f(and)f(Doug)i(T)-8 b(o)s(dy)30
b(\(NO)m(A)m(O\).)0 3982 y(Doug)h(Mink)g(\(SA)m(O\))f(pro)m(vided)g
(the)h(routines)f(for)g(con)m(v)m(erting)j(IRAF)d(format)h(images)g(in)
m(to)h(FITS)d(format.)0 4142 y(Martin)k(Reinec)m(k)m(e)i(\(Max)f(Planc)
m(k)f(Institute,)h(Garc)m(hing\)\))g(pro)m(vided)f(the)g(mo)s
(di\014cations)f(to)i(cfortran.h)e(that)0 4255 y(are)d(necessary)h(to)f
(supp)s(ort)e(64-bit)k(in)m(teger)f(v)-5 b(alues)29 b(when)f(calling)i
(C)f(routines)g(from)f(fortran)h(programs.)39 b(The)0
4368 y(cfortran.h)30 b(macros)h(w)m(ere)g(originally)h(dev)m(elop)s(ed)
e(b)m(y)h(Burkhard)e(Buro)m(w)h(\(CERN\).)0 4528 y(Julian)f(T)-8
b(a)m(ylor)31 b(\(ESO,)e(Garc)m(hing\))i(pro)m(vided)e(the)g(fast)h(b)m
(yte-sw)m(apping)g(algorithms)h(that)f(use)f(the)h(SSE2)f(and)0
4641 y(SSSE3)g(mac)m(hine)i(instructions)f(a)m(v)-5 b(ailable)33
b(on)d(x86)p 1784 4641 28 4 v 34 w(64)h(CPUs.)0 4801
y(In)c(addition,)i(man)m(y)f(other)g(p)s(eople)g(ha)m(v)m(e)h(made)f(v)
-5 b(aluable)29 b(con)m(tributions)f(to)h(the)f(dev)m(elopmen)m(t)h(of)
f(CFITSIO.)0 4914 y(These)i(include)g(\(with)h(ap)s(ologies)h(to)f
(others)f(that)h(ma)m(y)g(ha)m(v)m(e)h(inadv)m(erten)m(tly)g(b)s(een)d
(omitted\):)0 5074 y(Stev)m(e)g(Allen,)g(Carl)f(Ak)m(erlof,)h(Keith)f
(Arnaud,)g(Morten)g(Krabb)s(e)e(Barfo)s(ed,)j(Ken)m(t)f(Blac)m(kburn,)h
(G)f(Bo)s(dammer,)0 5187 y(Romk)m(e)h(Bon)m(tek)m(o)s(e,)i(Lucio)d
(Chiapp)s(etti,)g(Keith)g(Costorf,)g(Robin)g(Corb)s(et,)g(John)e(Da)m
(vis,)k(Ric)m(hard)e(Fink,)h(Ning)0 5300 y(Gan,)i(Emily)f(Greene,)h
(Gretc)m(hen)g(Green,)f(Jo)s(e)g(Harrington,)h(Cheng)f(Ho,)h(Phil)f(Ho)
s(dge,)g(Jim)g(Ingham,)g(Y)-8 b(oshi-)0 5413 y(tak)j(a)44
b(Ishisaki,)i(Diab)e(Jerius,)h(Mark)f(Levine,)i(T)-8
b(o)s(dd)42 b(Karak)-5 b(askian,)47 b(Edw)m(ard)42 b(King,)k(Scott)e
(Ko)s(c)m(h,)i(Claire)0 5526 y(Larkin,)32 b(Rob)g(Managan,)i(Eric)e
(Mandel,)h(Ric)m(hard)f(Mathar,)h(John)e(Matto)m(x,)k(Carsten)d(Mey)m
(er,)i(Emi)d(Miy)m(ata,)0 5639 y(Stefan)39 b(Mo)s(c)m(hnac)m(ki,)k(Mik)
m(e)e(Noble,)h(Oliv)m(er)e(Ob)s(erdorf,)f(Cliv)m(e)i(P)m(age,)i(Arvind)
38 b(P)m(armar,)j(Je\013)f(P)m(edelt)m(y)-8 b(,)43 b(Tim)p
eop end
%%Page: 4 12
TeXDict begin 4 11 bop 0 299 a Fj(4)2452 b Fh(CHAPTER)30
b(1.)71 b(INTR)m(ODUCTION)0 555 y Fj(P)m(earson,)40 b(Philipp)s(e)c
(Prugniel,)j(Maren)e(Purv)m(es,)i(Scott)g(Randall,)g(Chris)d(Rogers,)k
(Arnold)d(Rots,)i(Rob)e(Sea-)0 668 y(man,)23 b(Barry)e(Sc)m(hlesinger,)
i(Robin)e(Stebbins,)h(Andrew)d(Szymk)m(o)m(wiak,)25 b(Allyn)c(T)-8
b(ennan)m(t,)23 b(P)m(eter)f(T)-8 b(eub)s(en,)22 b(James)0
781 y(Theiler,)k(Doug)g(T)-8 b(o)s(dy)g(,)25 b(Shiro)f(Ueno,)j(Stev)m
(e)f(W)-8 b(alton,)28 b(Arc)m(hie)d(W)-8 b(arno)s(c)m(k,)27
b(Alan)e(W)-8 b(atson,)28 b(Dan)d(Whipple,)h(Wim)0 894
y(Wimmers,)31 b(P)m(eter)g(Y)-8 b(oung,)31 b(Jianjun)e(Xu,)h(and)g
(Nelson)h(Zarate.)0 1228 y Ff(1.4)135 b(Legal)46 b(Stu\013)0
1478 y Fj(Cop)m(yrigh)m(t)37 b(\(Unpublished{all)g(righ)m(ts)g(reserv)m
(ed)g(under)e(the)i(cop)m(yrigh)m(t)h(la)m(ws)f(of)g(the)g(United)g
(States\),)j(U.S.)0 1591 y(Go)m(v)m(ernmen)m(t)30 b(as)g(represen)m
(ted)e(b)m(y)h(the)g(Administrator)g(of)g(the)g(National)h(Aeronautics)
g(and)e(Space)h(Adminis-)0 1704 y(tration.)42 b(No)31
b(cop)m(yrigh)m(t)g(is)g(claimed)g(in)f(the)h(United)f(States)h(under)e
(Title)j(17,)f(U.S.)f(Co)s(de.)0 1864 y(P)m(ermission)g(to)g(freely)f
(use,)h(cop)m(y)-8 b(,)31 b(mo)s(dify)-8 b(,)29 b(and)g(distribute)g
(this)g(soft)m(w)m(are)i(and)e(its)h(do)s(cumen)m(tation)g(without)0
1977 y(fee)f(is)f(hereb)m(y)g(gran)m(ted,)i(pro)m(vided)e(that)h(this)f
(cop)m(yrigh)m(t)i(notice)f(and)f(disclaimer)h(of)f(w)m(arran)m(t)m(y)i
(app)s(ears)d(in)h(all)0 2090 y(copies.)0 2250 y(DISCLAIMER:)0
2410 y(THE)33 b(SOFTW)-10 b(ARE)32 b(IS)g(PR)m(O)m(VIDED)i('AS)f(IS')g
(WITHOUT)f(ANY)i(W)-10 b(ARRANTY)33 b(OF)g(ANY)h(KIND,)f(EI-)0
2523 y(THER)42 b(EXPRESSED,)f(IMPLIED,)i(OR)e(ST)-8 b(A)g(TUTOR)g(Y,)43
b(INCLUDING,)f(BUT)h(NOT)e(LIMITED)h(TO,)0 2636 y(ANY)33
b(W)-10 b(ARRANTY)33 b(THA)-8 b(T)32 b(THE)g(SOFTW)-10
b(ARE)32 b(WILL)g(CONF)m(ORM)g(TO)g(SPECIFICA)-8 b(TIONS,)30
b(ANY)0 2749 y(IMPLIED)38 b(W)-10 b(ARRANTIES)37 b(OF)h(MER)m(CHANT)-8
b(ABILITY,)38 b(FITNESS)f(F)m(OR)h(A)g(P)-8 b(AR)g(TICULAR)38
b(PUR-)0 2862 y(POSE,)24 b(AND)i(FREEDOM)f(FR)m(OM)h(INFRINGEMENT,)g
(AND)f(ANY)h(W)-10 b(ARRANTY)25 b(THA)-8 b(T)25 b(THE)g(DOC-)0
2974 y(UMENT)-8 b(A)g(TION)31 b(WILL)f(CONF)m(ORM)h(TO)e(THE)h(SOFTW)
-10 b(ARE,)30 b(OR)g(ANY)h(W)-10 b(ARRANTY)31 b(THA)-8
b(T)30 b(THE)0 3087 y(SOFTW)-10 b(ARE)31 b(WILL)h(BE)g(ERR)m(OR)g
(FREE.)g(IN)g(NO)g(EVENT)f(SHALL)g(NASA)h(BE)g(LIABLE)g(F)m(OR)g(ANY)0
3200 y(D)m(AMA)m(GES,)26 b(INCLUDING,)e(BUT)f(NOT)g(LIMITED)h(TO,)f
(DIRECT,)g(INDIRECT,)g(SPECIAL)f(OR)h(CON-)0 3313 y(SEQUENTIAL)28
b(D)m(AMA)m(GES,)k(ARISING)d(OUT)g(OF,)h(RESUL)-8 b(TING)29
b(FR)m(OM,)h(OR)f(IN)h(ANY)g(W)-10 b(A)i(Y)30 b(CON-)0
3426 y(NECTED)25 b(WITH)g(THIS)f(SOFTW)-10 b(ARE,)25
b(WHETHER)g(OR)g(NOT)g(BASED)g(UPON)g(W)-10 b(ARRANTY,)26
b(CON-)0 3539 y(TRA)m(CT,)d(TOR)-8 b(T)23 b(,)g(OR)g(OTHER)-10
b(WISE,)22 b(WHETHER)i(OR)f(NOT)f(INJUR)-8 b(Y)24 b(W)-10
b(AS)23 b(SUST)-8 b(AINED)23 b(BY)h(PER-)0 3652 y(SONS)h(OR)i(PR)m
(OPER)-8 b(TY)26 b(OR)g(OTHER)-10 b(WISE,)26 b(AND)h(WHETHER)g(OR)f
(NOT)g(LOSS)f(W)-10 b(AS)26 b(SUST)-8 b(AINED)0 3765
y(FR)m(OM,)37 b(OR)e(AR)m(OSE)h(OUT)f(OF)h(THE)g(RESUL)-8
b(TS)35 b(OF,)h(OR)f(USE)h(OF,)g(THE)g(SOFTW)-10 b(ARE)35
b(OR)g(SER-)0 3878 y(VICES)29 b(PR)m(O)m(VIDED)j(HEREUNDER.")p
eop end
%%Page: 5 13
TeXDict begin 5 12 bop 0 1225 a Fg(Chapter)65 b(2)0 1687
y Fm(Creating)77 b(the)h(CFITSIO)e(Library)0 2216 y Ff(2.1)135
b(Building)45 b(the)h(Library)0 2466 y Fj(The)h(CFITSIO)f(co)s(de)h(is)
h(con)m(tained)g(in)f(ab)s(out)g(40)h(C)f(source)h(\014les)f(\(*.c\))i
(and)e(header)g(\014les)g(\(*.h\).)93 b(On)0 2579 y(V)-10
b(AX/VMS)31 b(systems)g(2)f(assem)m(bly-co)s(de)i(\014les)e
(\(vmsieeed.mar)h(and)f(vmsieeer.mar\))i(are)e(also)i(needed.)0
2739 y(CFITSIO)d(has)h(curren)m(tly)g(b)s(een)g(tested)h(on)f(the)h
(follo)m(wing)h(platforms)e(\(not)h(up-to-date\):)95
2959 y Fe(OPERATING)46 b(SYSTEM)523 b(COMPILER)143 3072
y(Sun)47 b(OS)1002 b(gcc)47 b(and)g(cc)g(\(3.0.1\))143
3185 y(Sun)g(Solaris)762 b(gcc)47 b(and)g(cc)143 3298
y(Silicon)f(Graphics)g(IRIX)285 b(gcc)47 b(and)g(cc)143
3411 y(Silicon)f(Graphics)g(IRIX64)189 b(MIPS)143 3523
y(Dec)47 b(Alpha)f(OSF/1)572 b(gcc)47 b(and)g(cc)143
3636 y(DECstation)93 b(Ultrix)428 b(gcc)143 3749 y(Dec)47
b(Alpha)f(OpenVMS)476 b(cc)143 3862 y(DEC)47 b(VAX/VMS)762
b(gcc)47 b(and)g(cc)143 3975 y(HP-UX)1049 b(gcc)143 4088
y(IBM)47 b(AIX)954 b(gcc)143 4201 y(Linux)1049 b(gcc)143
4314 y(MkLinux)953 b(DR3)143 4427 y(Windows)46 b(95/98/NT)523
b(Borland)46 b(C++)h(V4.5)143 4540 y(Windows)f(95/98/NT/ME/XP)235
b(Microsoft/Compaq)43 b(Visual)j(C++)h(v5.0,)g(v6.0)143
4653 y(Windows)f(95/98/NT)523 b(Cygwin)46 b(gcc)143 4765
y(MacOS)h(7.1)f(or)i(greater)332 b(Metrowerks)45 b(10.+)143
4878 y(MacOS-X)h(10.1)h(or)g(greater)189 b(cc)47 b(\(gcc\))0
5098 y Fj(CFITSIO)26 b(will)j(probably)e(run)f(on)i(most)g(other)h
(Unix)e(platforms.)40 b(Cra)m(y)28 b(sup)s(ercomputers)e(are)j(curren)m
(tly)f(not)0 5211 y(supp)s(orted.)0 5495 y Fd(2.1.1)112
b(Unix)39 b(Systems)0 5714 y Fj(The)30 b(CFITSIO)f(library)h(is)g
(built)g(on)h(Unix)f(systems)g(b)m(y)g(t)m(yping:)1927
5942 y(5)p eop end
%%Page: 6 14
TeXDict begin 6 13 bop 0 299 a Fj(6)1580 b Fh(CHAPTER)30
b(2.)112 b(CREA)-8 b(TING)30 b(THE)g(CFITSIO)f(LIBRAR)-8
b(Y)48 555 y Fe(>)95 b(./configure)45 b([--prefix=/target/insta)o(llat)
o(ion)o(/pat)o(h])d([--enable-reentrant])764 668 y([--enable-sse2])h
([--enable-ssse3])48 781 y(>)95 b(make)476 b(\(or)95
b('make)46 b(shared'\))48 894 y(>)95 b(make)47 b(install)93
b(\(this)46 b(step)h(is)g(optional\))0 1128 y Fj(at)24
b(the)g(op)s(erating)g(system)g(prompt.)38 b(The)23 b(con\014gure)g
(command)g(customizes)i(the)f(Mak)m(e\014le)h(for)f(the)g(particular)0
1241 y(system,)g(then)d(the)g(`mak)m(e')i(command)e(compiles)h(the)f
(source)h(\014les)f(and)g(builds)f(the)h(library)-8 b(.)38
b(T)m(yp)s(e)21 b(`./con\014gure')0 1354 y(and)34 b(not)h(simply)f
(`con\014gure')h(to)h(ensure)e(that)h(the)g(con\014gure)g(script)f(in)h
(the)g(curren)m(t)f(directory)h(is)g(run)f(and)0 1467
y(not)29 b(some)g(other)g(system-wide)g(con\014gure)f(script.)40
b(The)29 b(optional)h('pre\014x')e(argumen)m(t)h(to)g(con\014gure)g
(giv)m(es)h(the)0 1580 y(path)e(to)i(the)f(directory)g(where)f(the)h
(CFITSIO)f(library)g(and)g(include)h(\014les)f(should)g(b)s(e)g
(installed)i(via)f(the)g(later)0 1692 y('mak)m(e)j(install')f(command.)
41 b(F)-8 b(or)31 b(example,)143 1926 y Fe(>)48 b(./configure)c
(--prefix=/usr1/local)0 2160 y Fj(will)25 b(cause)h(the)f('mak)m(e)h
(install')g(command)f(to)h(cop)m(y)g(the)f(CFITSIO)e(lib)s(c\014tsio)i
(\014le)h(to)f(/usr1/lo)s(cal/lib)i(and)e(the)0 2273
y(necessary)33 b(include)e(\014les)i(to)f(/usr1/lo)s(cal/include)j
(\(assuming)d(of)g(course)g(that)h(the)f(pro)s(cess)g(has)g(p)s
(ermission)0 2386 y(to)f(write)g(to)g(these)g(directories\).)0
2546 y(The)42 b(optional)i({enable-reen)m(tran)m(t)g(\015ag)f(will)g
(attempt)h(to)f(con\014gure)f(CFITSIO)f(so)i(that)g(it)g(can)g(b)s(e)f
(used)0 2659 y(in)35 b(m)m(ulti-threaded)g(programs.)54
b(See)35 b(the)g("Using)g(CFITSIO)e(in)i(Multi-threaded)g(En)m
(vironmen)m(ts")h(section,)0 2772 y(b)s(elo)m(w,)31 b(for)f(more)0
2932 y(The)24 b(optional)i({enable-sse2)g(and)e({enable-ssse3)i
(\015ags)e(will)h(cause)g(con\014gure)f(to)h(attempt)h(to)f(build)e
(CFITSIO)0 3045 y(using)29 b(faster)i(b)m(yte-sw)m(apping)f
(algorithms.)42 b(See)30 b(the)g("Optimizing)h(Programs")f(c)m(hapter)h
(of)f(this)g(man)m(ual)g(for)0 3158 y(more)h(information)f(ab)s(out)g
(these)h(options.)0 3318 y(The)d('mak)m(e)h(shared')f(option)h(builds)e
(a)i(shared)e(or)i(dynamic)f(v)m(ersion)h(of)f(the)h(CFITSIO)d(library)
-8 b(.)40 b(When)28 b(using)0 3431 y(the)f(shared)f(library)h(the)g
(executable)h(co)s(de)f(is)g(not)g(copied)g(in)m(to)h(y)m(our)f
(program)g(at)g(link)g(time)g(and)g(instead)g(the)0 3544
y(program)g(lo)s(cates)i(the)f(necessary)g(library)f(co)s(de)h(at)g
(run)e(time,)j(normally)f(through)e(LD)p 3065 3544 28
4 v 33 w(LIBRAR)-8 b(Y)p 3514 3544 V 34 w(P)g(A)g(TH)28
b(or)0 3657 y(some)j(other)f(metho)s(d.)41 b(The)29 b(adv)-5
b(an)m(tages)33 b(of)d(using)g(a)h(shared)e(library)h(are:)143
3891 y Fe(1.)95 b(Less)47 b(disk)f(space)h(if)g(you)g(build)f(more)h
(than)f(1)i(program)143 4004 y(2.)95 b(Less)47 b(memory)f(if)h(more)g
(than)f(one)h(copy)g(of)g(a)g(program)f(using)h(the)g(shared)334
4117 y(library)f(is)h(running)f(at)h(the)g(same)g(time)f(since)h(the)g
(system)f(is)h(smart)334 4230 y(enough)f(to)h(share)g(copies)f(of)h
(the)g(shared)f(library)g(at)h(run)g(time.)143 4343 y(3.)95
b(Possibly)46 b(easier)g(maintenance)e(since)j(a)g(new)g(version)f(of)h
(the)g(shared)334 4456 y(library)f(can)h(be)g(installed)e(without)h
(relinking)f(all)i(the)g(software)334 4568 y(that)g(uses)f(it)i(\(as)e
(long)h(as)g(the)g(subroutine)e(names)i(and)f(calling)334
4681 y(sequences)f(remain)h(unchanged\).)143 4794 y(4.)95
b(No)47 b(run-time)f(penalty.)0 5028 y Fj(The)30 b(disadv)-5
b(an)m(tages)32 b(are:)143 5262 y Fe(1.)47 b(More)g(hassle)f(at)h
(runtime.)94 b(You)46 b(have)h(to)g(either)f(build)h(the)g(programs)286
5375 y(specially)f(or)h(have)f(LD_LIBRARY_PATH)e(set)j(right.)143
5488 y(2.)g(There)g(may)g(be)g(a)g(slight)f(start)h(up)g(penalty,)e
(depending)h(on)h(where)f(you)h(are)286 5601 y(reading)f(the)h(shared)f
(library)g(and)h(the)g(program)f(from)g(and)h(if)g(your)g(CPU)g(is)286
5714 y(either)f(really)h(slow)f(or)h(really)f(heavily)g(loaded.)p
eop end
%%Page: 7 15
TeXDict begin 7 14 bop 0 299 a Fh(2.1.)72 b(BUILDING)31
b(THE)f(LIBRAR)-8 b(Y)2507 b Fj(7)0 555 y(On)32 b(Mac)i(OS)e(X)i
(platforms)f(the)g('mak)m(e)h(shared')f(command)f(w)m(orks)h(lik)m(e)i
(on)e(other)g(UNIX)g(platforms,)h(but)f(a)0 668 y(.dylib)f(\014le)g
(will)g(b)s(e)f(created)i(instead)g(of)f(.so.)46 b(If)31
b(installed)i(in)f(a)g(nonstandard)f(lo)s(cation,)j(add)d(its)i(lo)s
(cation)g(to)0 781 y(the)e(D)m(YLD)p 422 781 28 4 v 34
w(LIBRAR)-8 b(Y)p 872 781 V 33 w(P)g(A)g(TH)31 b(en)m(vironmen)m(t)g(v)
-5 b(ariable)31 b(so)g(that)g(the)f(library)g(can)h(b)s(e)f(found)f(at)
i(run)e(time.)0 941 y(On)h(HP/UX)i(systems,)g(the)f(en)m(vironmen)m(t)h
(v)-5 b(ariable)32 b(CFLA)m(GS)f(should)f(b)s(e)h(set)g(to)h(-Ae)g(b)s
(efore)f(running)e(con-)0 1054 y(\014gure)h(to)h(enable)g("extended)g
(ANSI")f(features.)0 1214 y(By)h(default,)h(a)f(set)h(of)f(F)-8
b(ortran-callable)34 b(wrapp)s(er)29 b(routines)i(are)g(also)h(built)f
(and)f(included)h(in)f(the)h(CFITSIO)0 1327 y(library)-8
b(.)70 b(If)40 b(these)g(wrapp)s(er)f(routines)h(are)g(not)h(needed)e
(\(i.e.,)45 b(the)40 b(CFITSIO)f(library)g(will)i(not)f(b)s(e)g(link)m
(ed)0 1440 y(to)d(an)m(y)f(F)-8 b(ortran)37 b(applications)g(whic)m(h)f
(call)h(FITSIO)e(subroutines\))g(then)h(they)g(ma)m(y)h(b)s(e)e
(omitted)i(from)f(the)0 1553 y(build)28 b(b)m(y)i(t)m(yping)g('mak)m(e)
g(all-no\014tsio')i(instead)d(of)h(simply)f(t)m(yping)h('mak)m(e'.)42
b(This)28 b(will)i(reduce)f(the)h(size)g(of)g(the)0 1666
y(CFITSIO)f(library)h(sligh)m(tly)-8 b(.)0 1826 y(It)33
b(ma)m(y)g(not)g(b)s(e)f(p)s(ossible)g(to)h(statically)i(link)e
(programs)f(that)h(use)g(CFITSIO)e(on)h(some)h(platforms)g(\(namely)-8
b(,)0 1939 y(on)28 b(Solaris)h(2.6\))h(due)e(to)h(the)g(net)m(w)m(ork)g
(driv)m(ers)f(\(whic)m(h)h(pro)m(vide)g(FTP)f(and)g(HTTP)g(access)h(to)
h(FITS)d(\014les\).)41 b(It)0 2052 y(is)33 b(p)s(ossible)f(to)i(mak)m
(e)f(b)s(oth)g(a)g(dynamic)f(and)g(a)i(static)g(v)m(ersion)f(of)g(the)g
(CFITSIO)e(library)-8 b(,)34 b(but)e(net)m(w)m(ork)i(\014le)0
2165 y(access)e(will)e(not)h(b)s(e)f(p)s(ossible)g(using)g(the)g
(static)i(v)m(ersion.)0 2627 y Fd(2.1.2)112 b(VMS)0 2880
y Fj(On)28 b(V)-10 b(AX/VMS)31 b(and)d(ALPHA/VMS)i(systems)f(the)h(mak)
m(e)p 2100 2880 V 34 w(g\015oat.com)h(command)e(\014le)g(ma)m(y)h(b)s
(e)f(executed)h(to)0 2993 y(build)35 b(the)i(c\014tsio.olb)g(ob)5
b(ject)37 b(library)f(using)g(the)g(default)h(G-\015oating)g(p)s(oin)m
(t)g(option)f(for)g(double)g(v)-5 b(ariables.)0 3106
y(The)37 b(mak)m(e)p 405 3106 V 33 w(d\015oat.com)i(and)d(mak)m(e)p
1279 3106 V 34 w(ieee.com)j(\014les)f(ma)m(y)f(b)s(e)g(used)f(instead)i
(to)g(build)e(the)h(library)g(with)g(the)0 3219 y(other)26
b(\015oating)i(p)s(oin)m(t)e(options.)39 b(Note)28 b(that)f(the)f
(getcwd)h(function)f(that)h(is)f(used)f(in)h(the)h(group.c)f(mo)s(dule)
f(ma)m(y)0 3332 y(require)44 b(that)i(programs)e(using)g(CFITSIO)f(b)s
(e)h(link)m(ed)i(with)e(the)h(ALPHA$LIBRAR)-8 b(Y:V)e(AX)m(CR)i(TL.OLB)
0 3445 y(library)g(.)41 b(See)30 b(the)h(example)g(link)f(line)h(in)f
(the)h(next)f(section)i(of)e(this)h(do)s(cumen)m(t.)0
3907 y Fd(2.1.3)112 b(Windo)m(ws)38 b(PCs)0 4161 y Fj(A)28
b(precompiled)g(DLL)g(v)m(ersion)g(of)g(CFITSIO)e(is)i(a)m(v)-5
b(ailable)31 b(for)c(IBM-PC)h(users)g(of)g(the)g(Borland)g(or)g
(Microsoft)0 4274 y(Visual)46 b(C++)e(compilers)i(in)f(the)h(\014les)f
(c\014tsio)s(dll)p 1799 4274 V 34 w(3xxx)p 2022 4274
V 33 w(b)s(orland.zip)f(and)h(c\014tsio)s(dll)p 3075
4274 V 33 w(3xxx)p 3297 4274 V 33 w(v)m(cc.zip,)51 b(where)0
4386 y('3xxx')45 b(represen)m(ts)f(the)g(curren)m(t)g(release)i(n)m(um)
m(b)s(er.)81 b(These)44 b(zip)g(arc)m(hiv)m(es)h(also)h(con)m(tains)f
(other)f(\014les)h(and)0 4499 y(instructions)30 b(on)g(ho)m(w)h(to)g
(use)f(the)h(CFITSIO)d(DLL)j(library)-8 b(.)0 4659 y(The)28
b(CFITSIO)g(library)g(ma)m(y)h(also)h(b)s(e)e(built)h(from)f(the)h
(source)g(co)s(de)g(using)g(the)g(mak)m(e\014le.b)s(c)g(or)g(mak)m
(e\014le.v)m(cc)0 4772 y(\014les.)55 b(Finally)-8 b(,)38
b(the)d(mak)m(ep)s(c.bat)h(\014le)f(giv)m(es)i(an)e(example)h(of)f
(building)f(CFITSIO)g(with)g(the)i(Borland)f(C++)0 4885
y(v4.5)c(or)g(v5.5)g(compiler)g(using)f(older)h(DOS)f(commands.)0
5348 y Fd(2.1.4)112 b(Macin)m(tosh)39 b(PCs)0 5601 y
Fj(When)20 b(building)f(on)i(Mac)g(OS-X,)f(users)g(should)f(follo)m(w)i
(the)g(Unix)f(instructions,)i(ab)s(o)m(v)m(e.)39 b(See)20
b(the)h(README.MacOS)0 5714 y(\014le)30 b(for)h(instructions)f(on)g
(building)g(a)g(Univ)m(ersal)i(Binary)e(that)h(supp)s(orts)e(b)s(oth)g
(In)m(tel)i(and)f(P)m(o)m(w)m(erPC)h(CPUs.)p eop end
%%Page: 8 16
TeXDict begin 8 15 bop 0 299 a Fj(8)1580 b Fh(CHAPTER)30
b(2.)112 b(CREA)-8 b(TING)30 b(THE)g(CFITSIO)f(LIBRAR)-8
b(Y)0 555 y Ff(2.2)135 b(T)-11 b(esting)46 b(the)f(Library)0
805 y Fj(The)40 b(CFITSIO)e(library)i(should)f(b)s(e)g(tested)i(b)m(y)f
(building)f(and)g(running)g(the)h(testprog.c)h(program)f(that)h(is)0
918 y(included)30 b(with)g(the)g(release.)42 b(On)30
b(Unix)g(systems,)h(t)m(yp)s(e:)191 1148 y Fe(\045)47
b(make)g(testprog)191 1261 y(\045)g(testprog)f(>)h(testprog.lis)191
1374 y(\045)g(diff)g(testprog.lis)d(testprog.out)191
1487 y(\045)j(cmp)g(testprog.fit)e(testprog.std)0 1717
y Fj(On)30 b(VMS)g(systems,)g(\(assuming)h(cc)g(is)f(the)h(name)f(of)h
(the)f(C)g(compiler)h(command\),)g(t)m(yp)s(e:)191 1947
y Fe($)47 b(cc)h(testprog.c)191 2060 y($)f(link)g(testprog,)e
(cfitsio/lib,)g(alpha$library:vaxcrtl/l)o(ib)191 2173
y($)i(run)g(testprog)0 2402 y Fj(The)42 b(test)h(program)f(should)f
(pro)s(duce)g(a)i(FITS)e(\014le)i(called)g(`testprog.\014t')h(that)f
(is)f(iden)m(tical)i(to)f(the)f(`test-)0 2515 y(prog.std')35
b(FITS)e(\014le)i(included)e(with)h(this)g(release.)54
b(The)34 b(diagnostic)i(messages)f(\(whic)m(h)g(w)m(ere)g(pip)s(ed)e
(to)i(the)0 2628 y(\014le)h(testprog.lis)i(in)e(the)h(Unix)f(example\))
h(should)e(b)s(e)h(iden)m(tical)i(to)f(the)f(listing)h(con)m(tained)h
(in)e(the)g(\014le)h(test-)0 2741 y(prog.out.)63 b(The)37
b('di\013)7 b(')38 b(and)f('cmp')h(commands)g(sho)m(wn)f(ab)s(o)m(v)m
(e)i(should)d(not)i(rep)s(ort)f(an)m(y)h(di\013erences)g(in)g(the)0
2854 y(\014les.)65 b(\(There)38 b(ma)m(y)h(b)s(e)f(some)h(minor)f
(format)h(di\013erences,)i(suc)m(h)d(as)h(the)g(presence)f(or)h
(absence)g(of)f(leading)0 2967 y(zeros,)31 b(or)g(3)f(digit)i(exp)s
(onen)m(ts)e(in)g(n)m(um)m(b)s(ers,)f(whic)m(h)h(can)h(b)s(e)f
(ignored\).)0 3127 y(The)e(F)-8 b(ortran)30 b(wrapp)s(ers)d(in)h
(CFITSIO)f(ma)m(y)j(b)s(e)e(tested)h(with)g(the)g(testf77)h(program)f
(on)g(Unix)f(systems)h(with:)191 3357 y Fe(\045)47 b(f77)g(-o)g
(testf77)f(testf77.f)g(-L.)g(-lcfitsio)g(-lnsl)g(-lsocket)95
3470 y(or)191 3583 y(\045)h(f77)g(-f)g(-o)h(testf77)d(testf77.f)h(-L.)h
(-lcfitsio)188 b(\(under)46 b(SUN)h(O/S\))95 3696 y(or)191
3809 y(\045)g(f77)g(-o)g(testf77)f(testf77.f)g(-Wl,-L.)f(-lcfitsio)h
(-lm)h(-lnsl)f(-lsocket)f(\(HP/UX\))191 4035 y(\045)i(testf77)f(>)i
(testf77.lis)191 4147 y(\045)f(diff)g(testf77.lis)e(testf77.out)191
4260 y(\045)i(cmp)g(testf77.fit)e(testf77.std)0 4490
y Fj(On)31 b(mac)m(hines)h(running)f(SUN)g(O/S,)h(F)-8
b(ortran)33 b(programs)e(m)m(ust)h(b)s(e)f(compiled)h(with)g(the)g('-f)
7 b(')32 b(option)h(to)f(force)0 4603 y(double)25 b(precision)h(v)-5
b(ariables)26 b(to)g(b)s(e)f(aligned)h(on)g(8-b)m(yte)h(b)s(oundarys)c
(to)j(mak)m(e)h(the)e(fortran-declared)h(v)-5 b(ariables)0
4716 y(compatible)34 b(with)e(C.)g(A)h(similar)g(compiler)g(option)g
(ma)m(y)g(b)s(e)f(required)g(on)g(other)h(platforms.)48
b(F)-8 b(ailing)34 b(to)f(use)0 4829 y(this)26 b(option)g(ma)m(y)g
(cause)h(the)f(program)f(to)i(crash)e(on)h(FITSIO)f(routines)g(that)i
(read)f(or)f(write)h(double)g(precision)0 4942 y(v)-5
b(ariables.)0 5102 y(Also)31 b(note)g(that)f(on)g(some)h(systems,)f
(the)h(output)e(listing)i(of)g(the)f(testf77)i(program)d(ma)m(y)i
(di\013er)f(sligh)m(tly)h(from)0 5215 y(the)g(testf77.std)h(template,)g
(if)f(leading)g(zeros)g(are)g(not)g(prin)m(ted)f(b)m(y)h(default)g(b)s
(efore)f(the)h(decimal)g(p)s(oin)m(t)g(when)0 5328 y(using)f(F)h
(format.)0 5488 y(A)37 b(few)f(other)g(utilit)m(y)i(programs)e(are)h
(included)f(with)g(CFITSIO;)f(the)i(\014rst)e(four)h(of)g(this)h
(programs)f(can)h(b)s(e)0 5601 y(compiled)e(an)g(link)m(ed)g(b)m(y)g(t)
m(yping)g(`mak)m(e)h(program)p 1815 5601 28 4 v 33 w(name')f(where)f
(`program)p 2746 5601 V 33 w(name')h(is)g(the)g(actual)h(name)f(of)0
5714 y(the)c(program:)p eop end
%%Page: 9 17
TeXDict begin 9 16 bop 0 299 a Fh(2.3.)72 b(LINKING)30
b(PR)m(OGRAMS)h(WITH)f(CFITSIO)1975 b Fj(9)191 555 y
Fe(speed)46 b(-)i(measures)d(the)i(maximum)f(throughput)f(\(in)i(MB)g
(per)g(second\))668 668 y(for)g(writing)f(and)h(reading)f(FITS)g(files)
h(with)f(CFITSIO.)191 894 y(listhead)f(-)j(lists)e(all)h(the)g(header)f
(keywords)g(in)h(any)g(FITS)f(file)191 1120 y(fitscopy)f(-)j(copies)e
(any)h(FITS)g(file)f(\(especially)f(useful)h(in)h(conjunction)811
1233 y(with)g(the)g(CFITSIO's)e(extended)h(input)g(filename)g
(syntax\).)191 1458 y(cookbook)f(-)j(a)f(sample)f(program)g(that)h
(performs)e(common)i(read)f(and)811 1571 y(write)h(operations)e(on)i(a)
g(FITS)g(file.)191 1797 y(iter_a,)f(iter_b,)g(iter_c)g(-)h(examples)f
(of)h(the)g(CFITSIO)f(iterator)f(routine)0 2167 y Ff(2.3)135
b(Linking)45 b(Programs)h(with)f(CFITSIO)0 2425 y Fj(When)25
b(linking)h(applications)h(soft)m(w)m(are)g(with)e(the)h(CFITSIO)e
(library)-8 b(,)27 b(sev)m(eral)g(system)f(libraries)g(usually)f(need)0
2538 y(to)36 b(b)s(e)f(sp)s(eci\014ed)g(on)g(the)g(link)h(command)f
(line.)56 b(On)34 b(Unix)i(systems,)h(the)e(most)h(reliable)g(w)m(a)m
(y)h(to)f(determine)0 2651 y(what)26 b(libraries)h(are)f(required)g(is)
g(to)h(t)m(yp)s(e)f('mak)m(e)i(testprog')f(and)f(see)h(what)f
(libraries)h(the)f(con\014gure)g(script)g(has)0 2764
y(added.)39 b(The)25 b(t)m(ypical)j(libraries)e(that)g(need)g(to)g(b)s
(e)g(added)f(are)h(-lm)h(\(the)f(math)g(library\))g(and)f(-lnsl)h(and)g
(-lso)s(c)m(k)m(et)0 2877 y(\(needed)k(only)g(for)g(FTP)g(and)f(HTTP)g
(\014le)h(access\).)43 b(These)30 b(latter)h(2)f(libraries)g(are)h(not)
f(needed)g(on)g(VMS)g(and)0 2989 y(Windo)m(ws)g(platforms,)h(b)s
(ecause)f(FTP)h(\014le)f(access)i(is)e(not)h(curren)m(tly)f(supp)s
(orted)f(on)h(those)h(platforms.)0 3150 y(Note)i(that)g(when)e
(upgrading)g(to)i(a)f(new)m(er)g(v)m(ersion)g(of)g(CFITSIO)f(it)h(is)g
(usually)g(necessary)g(to)h(recompile,)h(as)0 3263 y(w)m(ell)d(as)g
(relink,)g(the)f(programs)g(that)h(use)f(CFITSIO,)f(b)s(ecause)i(the)f
(de\014nitions)g(in)g(\014tsio.h)h(often)f(c)m(hange.)0
3633 y Ff(2.4)135 b(Using)46 b(CFITSIO)e(in)h(Multi-threaded)g(En)l
(vironmen)l(ts)0 3890 y Fj(CFITSIO)d(can)h(b)s(e)g(used)f(either)i
(with)e(the)i(POSIX)e(pthreads)g(in)m(terface)j(or)e(the)h(Op)s(enMP)d
(in)m(terface)k(for)0 4003 y(m)m(ulti-threaded)g(parallel)g(programs.)
81 b(When)43 b(used)h(in)f(a)i(m)m(ulti-threaded)f(en)m(vironmen)m(t,)k
(the)c(CFITSIO)0 4116 y(library)26 b(*m)m(ust*)h(b)s(e)e(built)h(using)
g(the)g(-D)p 1426 4116 28 4 v 34 w(REENTRANT)f(compiler)i(directiv)m
(e.)41 b(This)25 b(can)i(b)s(e)e(done)h(using)g(the)0
4229 y(follo)m(wing)32 b(build)d(commands:)95 4520 y
Fe(>./configure)45 b(--enable-reentrant)95 4633 y(>)j(make)0
4924 y Fj(A)32 b(function)g(called)i(\014ts)p 845 4924
V 32 w(is)p 938 4924 V 33 w(reen)m(tran)m(t)f(is)g(a)m(v)-5
b(ailable)34 b(to)f(test)h(whether)d(or)i(not)f(CFITSIO)f(w)m(as)h
(compiled)h(with)0 5036 y(the)28 b(-D)p 258 5036 V 34
w(REENTRANT)f(directiv)m(e.)42 b(When)28 b(this)g(feature)g(is)g
(enabled,)h(m)m(ultiple)g(threads)e(can)i(call)g(an)m(y)g(of)f(the)0
5149 y(CFITSIO)k(routines)h(to)h(sim)m(ultaneously)g(read)f(or)h(write)
f(separate)h(FITS)f(\014les.)49 b(Multiple)34 b(threads)f(can)h(also)0
5262 y(read)29 b(data)h(from)e(the)h(same)h(FITS)e(\014le)h(sim)m
(ultaneously)-8 b(,)31 b(as)e(long)h(as)f(the)g(\014le)g(w)m(as)h(op)s
(ened)e(indep)s(enden)m(tly)g(b)m(y)0 5375 y(eac)m(h)37
b(thread.)58 b(This)35 b(relies)i(on)f(the)g(op)s(erating)h(system)f
(to)h(correctly)g(deal)g(with)f(reading)g(the)g(same)h(\014le)f(b)m(y)0
5488 y(m)m(ultiple)30 b(pro)s(cesses.)41 b(Di\013eren)m(t)30
b(threads)g(should)e(not)i(share)f(the)h(same)g('\014ts\014le')g(p)s
(oin)m(ter)f(to)i(read)e(an)h(op)s(ened)0 5601 y(FITS)40
b(\014le,)j(unless)d(lo)s(c)m(ks)h(are)g(placed)f(around)g(the)g(calls)
i(to)f(the)g(CFITSIO)d(reading)j(routines.)71 b(Di\013eren)m(t)0
5714 y(threads)30 b(should)f(nev)m(er)i(try)f(to)h(write)g(to)g(the)g
(same)f(FITS)g(\014le.)p eop end
%%Page: 10 18
TeXDict begin 10 17 bop 0 299 a Fj(10)1535 b Fh(CHAPTER)30
b(2.)112 b(CREA)-8 b(TING)30 b(THE)g(CFITSIO)f(LIBRAR)-8
b(Y)0 555 y Ff(2.5)135 b(Getting)46 b(Started)g(with)f(CFITSIO)0
810 y Fj(In)27 b(order)h(to)g(e\013ectiv)m(ely)j(use)d(the)g(CFITSIO)e
(library)i(it)g(is)g(recommended)g(that)g(new)f(users)h(b)s(egin)f(b)m
(y)h(reading)0 923 y(the)g(\\CFITSIO)g(Quic)m(k)g(Start)g(Guide".)41
b(It)28 b(con)m(tains)h(all)h(the)e(basic)h(information)f(needed)g(to)h
(write)f(programs)0 1036 y(that)c(p)s(erform)f(most)h(t)m(yp)s(es)g(of)
g(op)s(erations)g(on)g(FITS)f(\014les.)39 b(The)23 b(set)i(of)f
(example)g(FITS)g(utilit)m(y)h(programs)e(that)0 1149
y(are)29 b(a)m(v)-5 b(ailable)31 b(from)d(the)g(CFITSIO)f(w)m(eb)i
(site)g(are)g(also)g(v)m(ery)g(useful)f(for)g(learning)h(ho)m(w)f(to)h
(use)f(CFITSIO.)f(T)-8 b(o)0 1262 y(learn)23 b(ev)m(en)g(more)g(ab)s
(out)f(the)h(capabilities)h(of)f(the)g(CFITSIO)e(library)h(the)h(follo)
m(wing)h(steps)e(are)h(recommended:)0 1422 y(1.)41 b(Read)31
b(the)f(follo)m(wing)i(short)e(`FITS)g(Primer')g(c)m(hapter)h(for)f(an)
h(o)m(v)m(erview)h(of)e(the)h(structure)f(of)g(FITS)g(\014les.)0
1582 y(2.)40 b(Review)28 b(the)f(Programming)g(Guidelines)h(in)f
(Chapter)f(4)i(to)g(b)s(ecome)f(familiar)h(with)f(the)h(con)m(v)m(en)m
(tions)h(used)0 1695 y(b)m(y)h(the)h(CFITSIO)e(in)m(terface.)0
1855 y(3.)74 b(Refer)41 b(to)h(the)g(co)s(okb)s(o)s(ok.c,)j
(listhead.c,)h(and)40 b(\014tscop)m(y)-8 b(.c)43 b(programs)e(that)h
(are)g(included)e(with)h(this)h(re-)0 1968 y(lease)g(for)e(examples)h
(of)g(routines)f(that)h(p)s(erform)e(v)-5 b(arious)41
b(common)g(FITS)f(\014le)g(op)s(erations.)72 b(T)m(yp)s(e)40
b('mak)m(e)0 2081 y(program)p 339 2081 28 4 v 33 w(name')30
b(to)h(compile)h(and)d(link)i(these)g(programs)f(on)g(Unix)g(systems.)0
2241 y(4.)40 b(W)-8 b(rite)30 b(a)e(simple)g(program)g(to)g(read)g(or)g
(write)g(a)h(FITS)e(\014le)h(using)g(the)g(Basic)h(In)m(terface)g
(routines)f(describ)s(ed)0 2354 y(in)i(Chapter)g(5.)0
2514 y(5.)79 b(Scan)43 b(through)f(the)h(more)g(sp)s(ecialized)i
(routines)d(that)i(are)f(describ)s(ed)f(in)h(the)g(follo)m(wing)i(c)m
(hapters)e(to)0 2627 y(b)s(ecome)31 b(familiar)g(with)f(the)h
(functionalit)m(y)g(that)g(they)g(pro)m(vide.)0 2986
y Ff(2.6)135 b(Example)46 b(Program)0 3241 y Fj(The)c(follo)m(wing)j
(listing)f(sho)m(ws)e(an)h(example)h(of)f(ho)m(w)g(to)g(use)g(the)g
(CFITSIO)f(routines)g(in)h(a)g(C)g(program.)0 3354 y(Refer)26
b(to)g(the)g(co)s(okb)s(o)s(ok.c)g(program)f(that)i(is)e(included)g
(with)g(the)h(CFITSIO)e(distribution)h(for)g(other)h(example)0
3466 y(routines.)0 3627 y(This)38 b(program)h(creates)h(a)f(new)f(FITS)
g(\014le,)k(con)m(taining)e(a)f(FITS)f(image.)68 b(An)38
b(`EXPOSURE')h(k)m(eyw)m(ord)g(is)0 3740 y(written)27
b(to)g(the)f(header,)i(then)e(the)h(image)g(data)h(are)f(written)f(to)h
(the)g(FITS)f(\014le)g(b)s(efore)h(closing)g(the)g(FITS)f(\014le.)0
4020 y Fe(#include)46 b("fitsio.h")92 b(/*)47 b(required)f(by)h(every)g
(program)e(that)i(uses)g(CFITSIO)93 b(*/)0 4133 y(main\(\))0
4246 y({)191 4359 y(fitsfile)45 b(*fptr;)333 b(/*)47
b(pointer)f(to)h(the)g(FITS)g(file;)f(defined)g(in)h(fitsio.h)f(*/)191
4472 y(int)h(status,)f(ii,)h(jj;)191 4585 y(long)94 b(fpixel)46
b(=)i(1,)f(naxis)f(=)i(2,)f(nelements,)e(exposure;)191
4698 y(long)i(naxes[2])e(=)j({)f(300,)g(200)g(};)142
b(/*)47 b(image)g(is)g(300)g(pixels)f(wide)h(by)g(200)g(rows)f(*/)191
4811 y(short)g(array[200][300];)191 5036 y(status)g(=)h(0;)429
b(/*)48 b(initialize)d(status)h(before)g(calling)g(fitsio)g(routines)f
(*/)191 5149 y(fits_create_file\(&fptr,)c("testfile.fits",)j
(&status\);)140 b(/*)48 b(create)e(new)h(file)f(*/)191
5375 y(/*)h(Create)f(the)h(primary)f(array)g(image)h(\(16-bit)e(short)i
(integer)f(pixels)g(*/)191 5488 y(fits_create_img\(fptr,)c(SHORT_IMG,)j
(naxis,)h(naxes,)g(&status\);)191 5714 y(/*)h(Write)f(a)i(keyword;)d
(must)i(pass)g(the)g(ADDRESS)e(of)j(the)f(value)f(*/)p
eop end
%%Page: 11 19
TeXDict begin 11 18 bop 0 299 a Fh(2.6.)72 b(EXAMPLE)31
b(PR)m(OGRAM)2618 b Fj(11)191 555 y Fe(exposure)45 b(=)j(1500.;)191
668 y(fits_update_key\(fptr,)42 b(TLONG,)k("EXPOSURE",)f(&exposure,)430
781 y("Total)h(Exposure)f(Time",)h(&status\);)191 1007
y(/*)h(Initialize)e(the)i(values)f(in)h(the)g(image)g(with)f(a)i
(linear)e(ramp)g(function)g(*/)191 1120 y(for)h(\(jj)g(=)g(0;)g(jj)h(<)
f(naxes[1];)e(jj++\))382 1233 y(for)i(\(ii)g(=)g(0;)g(ii)g(<)h
(naxes[0];)d(ii++\))573 1346 y(array[jj][ii])f(=)j(ii)h(+)f(jj;)191
1571 y(nelements)e(=)j(naxes[0])d(*)j(naxes[1];)474 b(/*)48
b(number)e(of)h(pixels)f(to)h(write)g(*/)191 1797 y(/*)g(Write)f(the)h
(array)g(of)g(integers)e(to)j(the)f(image)f(*/)191 1910
y(fits_write_img\(fptr,)c(TSHORT,)k(fpixel,)g(nelements,)f(array[0],)g
(&status\);)191 2136 y(fits_close_file\(fptr,)d(&status\);)570
b(/*)47 b(close)g(the)g(file)f(*/)191 2362 y(fits_report_error\(stderr)
o(,)c(status\);)93 b(/*)47 b(print)g(out)g(any)f(error)h(messages)e(*/)
191 2475 y(return\()h(status)g(\);)0 2588 y(})p eop end
%%Page: 12 20
TeXDict begin 12 19 bop 0 299 a Fj(12)1535 b Fh(CHAPTER)30
b(2.)112 b(CREA)-8 b(TING)30 b(THE)g(CFITSIO)f(LIBRAR)-8
b(Y)p eop end
%%Page: 13 21
TeXDict begin 13 20 bop 0 1225 a Fg(Chapter)65 b(3)0
1687 y Fm(A)78 b(FITS)f(Primer)0 2180 y Fj(This)23 b(section)j(giv)m
(es)f(a)g(brief)e(o)m(v)m(erview)j(of)e(the)h(structure)e(of)i(FITS)e
(\014les.)38 b(Users)24 b(should)g(refer)f(to)i(the)g(do)s(cumen-)0
2293 y(tation)j(a)m(v)-5 b(ailable)30 b(from)d(the)g(NOST,)f(as)i
(describ)s(ed)e(in)h(the)g(in)m(tro)s(duction,)h(for)f(more)g(detailed)
i(information)e(on)0 2406 y(FITS)j(formats.)0 2566 y(FITS)e(w)m(as)h
(\014rst)g(dev)m(elop)s(ed)g(in)f(the)h(late)i(1970's)g(as)e(a)g
(standard)f(data)i(in)m(terc)m(hange)g(format)f(b)s(et)m(w)m(een)h(v)-5
b(arious)0 2679 y(astronomical)36 b(observ)-5 b(atories.)52
b(Since)34 b(then)g(FITS)f(has)h(b)s(ecome)g(the)h(standard)e(data)i
(format)f(supp)s(orted)e(b)m(y)0 2791 y(most)f(astronomical)h(data)f
(analysis)g(soft)m(w)m(are)h(pac)m(k)-5 b(ages.)0 2952
y(A)34 b(FITS)f(\014le)g(consists)h(of)g(one)g(or)g(more)g(Header)g(+)f
(Data)i(Units)f(\(HDUs\),)i(where)d(the)h(\014rst)f(HDU)h(is)g(called)0
3065 y(the)j(`Primary)f(HDU',)i(or)f(`Primary)f(Arra)m(y'.)60
b(The)36 b(primary)g(arra)m(y)h(con)m(tains)h(an)e(N-dimensional)i
(arra)m(y)f(of)0 3177 y(pixels,)30 b(suc)m(h)g(as)g(a)h(1-D)g(sp)s
(ectrum,)e(a)h(2-D)h(image,)h(or)e(a)g(3-D)i(data)e(cub)s(e.)40
b(Six)30 b(di\013eren)m(t)g(primary)f(data)i(t)m(yp)s(es)0
3290 y(are)j(supp)s(orted:)44 b(Unsigned)33 b(8-bit)h(b)m(ytes,)h
(16-bit,)g(32-bit,)h(and)c(64-bit)j(signed)e(in)m(tegers,)i(and)e(32)h
(and)f(64-bit)0 3403 y(\015oating)28 b(p)s(oin)m(t)e(reals.)40
b(FITS)27 b(also)g(has)g(a)g(con)m(v)m(en)m(tion)i(for)d(storing)i(16)f
(and)f(32-bit)i(unsigned)e(in)m(tegers)i(\(see)g(the)0
3516 y(later)k(section)h(en)m(titled)g(`Unsigned)e(In)m(tegers')h(for)f
(more)h(details\).)44 b(The)31 b(primary)g(HDU)h(ma)m(y)g(also)g
(consist)g(of)0 3629 y(only)e(a)h(header)f(with)h(a)f(n)m(ull)h(arra)m
(y)f(con)m(taining)i(no)f(data)g(pixels.)0 3789 y(An)m(y)i(n)m(um)m(b)s
(er)e(of)h(additional)i(HDUs)f(ma)m(y)g(follo)m(w)h(the)e(primary)g
(arra)m(y;)i(these)f(additional)h(HDUs)f(are)g(called)0
3902 y(FITS)d(`extensions'.)41 b(There)30 b(are)h(curren)m(tly)f(3)h(t)
m(yp)s(es)g(of)f(extensions)h(de\014ned)e(b)m(y)h(the)h(FITS)f
(standard:)136 4171 y Fc(\017)46 b Fj(Image)31 b(Extension)g(-)g(a)f
(N-dimensional)h(arra)m(y)g(of)g(pixels,)g(lik)m(e)g(in)f(a)h(primary)e
(arra)m(y)136 4368 y Fc(\017)46 b Fj(ASCI)s(I)29 b(T)-8
b(able)31 b(Extension)g(-)f(ro)m(ws)h(and)e(columns)h(of)h(data)g(in)f
(ASCI)s(I)f(c)m(haracter)j(format)136 4564 y Fc(\017)46
b Fj(Binary)31 b(T)-8 b(able)31 b(Extension)f(-)h(ro)m(ws)f(and)g
(columns)g(of)h(data)g(in)f(binary)f(represen)m(tation)0
4833 y(In)k(eac)m(h)i(case)g(the)f(HDU)h(consists)g(of)f(an)g(ASCI)s(I)
e(Header)i(Unit)h(follo)m(w)m(ed)g(b)m(y)f(an)g(optional)h(Data)g
(Unit.)52 b(F)-8 b(or)0 4946 y(historical)37 b(reasons,)g(eac)m(h)f
(Header)g(or)g(Data)h(unit)e(m)m(ust)g(b)s(e)g(an)g(exact)i(m)m
(ultiple)f(of)g(2880)h(8-bit)f(b)m(ytes)g(long.)0 5059
y(An)m(y)30 b(un)m(used)g(space)g(is)h(padded)e(with)h(\014ll)g(c)m
(haracters)i(\(ASCI)s(I)d(blanks)h(or)h(zeros\).)0 5219
y(Eac)m(h)i(Header)f(Unit)h(consists)g(of)f(an)m(y)g(n)m(um)m(b)s(er)f
(of)i(80-c)m(haracter)i(k)m(eyw)m(ord)d(records)g(or)g(`card)h(images')
g(whic)m(h)0 5332 y(ha)m(v)m(e)f(the)e(general)i(form:)95
5601 y Fe(KEYNAME)46 b(=)i(value)e(/)i(comment)d(string)95
5714 y(NULLKEY)h(=)334 b(/)48 b(comment:)d(This)i(keyword)f(has)g(no)i
(value)1905 5942 y Fj(13)p eop end
%%Page: 14 22
TeXDict begin 14 21 bop 0 299 a Fj(14)2398 b Fh(CHAPTER)30
b(3.)112 b(A)30 b(FITS)g(PRIMER)0 555 y Fj(The)35 b(k)m(eyw)m(ord)i
(names)f(ma)m(y)g(b)s(e)g(up)f(to)h(8)h(c)m(haracters)g(long)g(and)e
(can)h(only)h(con)m(tain)g(upp)s(ercase)e(letters,)k(the)0
668 y(digits)25 b(0-9,)i(the)e(h)m(yphen,)g(and)f(the)h(underscore)e(c)
m(haracter.)41 b(The)24 b(k)m(eyw)m(ord)h(name)g(is)f(\(usually\))h
(follo)m(w)m(ed)i(b)m(y)d(an)0 781 y(equals)29 b(sign)g(and)f(a)g
(space)i(c)m(haracter)g(\(=)e(\))h(in)f(columns)h(9)g(-)f(10)i(of)f
(the)f(record,)h(follo)m(w)m(ed)i(b)m(y)d(the)h(v)-5
b(alue)29 b(of)g(the)0 894 y(k)m(eyw)m(ord)34 b(whic)m(h)g(ma)m(y)g(b)s
(e)f(either)h(an)g(in)m(teger,)i(a)e(\015oating)g(p)s(oin)m(t)g(n)m(um)
m(b)s(er,)g(a)g(c)m(haracter)h(string)e(\(enclosed)i(in)0
1007 y(single)28 b(quotes\),)i(or)e(a)g(b)s(o)s(olean)g(v)-5
b(alue)28 b(\(the)g(letter)h(T)f(or)f(F\).)i(A)f(k)m(eyw)m(ord)g(ma)m
(y)h(also)f(ha)m(v)m(e)h(a)g(n)m(ull)e(or)h(unde\014ned)0
1120 y(v)-5 b(alue)31 b(if)f(there)h(is)f(no)g(sp)s(eci\014ed)g(v)-5
b(alue)31 b(string,)g(as)f(in)g(the)h(second)f(example,)i(ab)s(o)m(v)m
(e)0 1280 y(The)42 b(last)h(k)m(eyw)m(ord)g(in)f(the)h(header)f(is)g
(alw)m(a)m(ys)i(the)f(`END')g(k)m(eyw)m(ord)g(whic)m(h)f(has)g(no)h(v)
-5 b(alue)42 b(or)h(commen)m(t)0 1393 y(\014elds.)d(There)30
b(are)h(man)m(y)f(rules)g(go)m(v)m(erning)i(the)e(exact)i(format)f(of)f
(a)h(k)m(eyw)m(ord)f(record)h(\(see)g(the)f(NOST)g(FITS)0
1506 y(Standard\))c(so)i(it)f(is)h(b)s(etter)f(to)h(rely)f(on)g
(standard)g(in)m(terface)h(soft)m(w)m(are)h(lik)m(e)f(CFITSIO)e(to)i
(correctly)h(construct)0 1619 y(or)h(to)h(parse)g(the)f(k)m(eyw)m(ord)h
(records)f(rather)g(than)h(try)f(to)h(deal)g(directly)g(with)f(the)g
(ra)m(w)h(FITS)f(formats.)0 1779 y(Eac)m(h)37 b(Header)g(Unit)f(b)s
(egins)g(with)g(a)g(series)h(of)f(required)g(k)m(eyw)m(ords)g(whic)m(h)
g(dep)s(end)f(on)h(the)g(t)m(yp)s(e)h(of)f(HDU.)0 1892
y(These)31 b(required)g(k)m(eyw)m(ords)h(sp)s(ecify)g(the)f(size)i(and)
e(format)h(of)g(the)g(follo)m(wing)h(Data)g(Unit.)45
b(The)31 b(header)g(ma)m(y)0 2005 y(con)m(tain)h(other)f(optional)g(k)m
(eyw)m(ords)g(to)h(describ)s(e)e(other)g(asp)s(ects)h(of)g(the)g(data,)
g(suc)m(h)g(as)g(the)f(units)g(or)h(scaling)0 2118 y(v)-5
b(alues.)44 b(Other)31 b(COMMENT)g(or)g(HISTOR)-8 b(Y)30
b(k)m(eyw)m(ords)i(are)g(also)g(frequen)m(tly)g(added)e(to)i(further)e
(do)s(cumen)m(t)0 2230 y(the)h(data)g(\014le.)0 2391
y(The)36 b(optional)h(Data)h(Unit)f(immediately)g(follo)m(ws)h(the)e
(last)h(2880-b)m(yte)i(blo)s(c)m(k)e(in)f(the)g(Header)h(Unit.)59
b(Some)0 2503 y(HDUs)31 b(do)f(not)h(ha)m(v)m(e)g(a)g(Data)h(Unit)f
(and)f(only)g(consist)h(of)g(the)f(Header)h(Unit.)0 2664
y(If)24 b(there)i(is)f(more)g(than)f(one)h(HDU)h(in)f(the)g(FITS)f
(\014le,)i(then)f(the)g(Header)h(Unit)f(of)g(the)g(next)g(HDU)h
(immediately)0 2777 y(follo)m(ws)g(the)e(last)i(2880-b)m(yte)h(blo)s(c)
m(k)e(of)g(the)f(previous)g(Data)j(Unit)d(\(or)h(Header)g(Unit)g(if)f
(there)h(is)g(no)f(Data)i(Unit\).)0 2937 y(The)k(main)g(required)g(k)m
(eyw)m(ords)g(in)g(FITS)g(primary)g(arra)m(ys)g(or)h(image)g
(extensions)g(are:)136 3172 y Fc(\017)46 b Fj(BITPIX)32
b({)g(de\014nes)e(the)i(data)g(t)m(yp)s(e)g(of)g(the)g(arra)m(y:)43
b(8,)33 b(16,)g(32,)g(64,)g(-32,)g(-64)g(for)e(unsigned)f(8{bit)j(b)m
(yte,)227 3284 y(16{bit)41 b(signed)f(in)m(teger,)j(32{bit)f(signed)d
(in)m(teger,)44 b(32{bit)d(IEEE)e(\015oating)h(p)s(oin)m(t,)i(and)e
(64{bit)h(IEEE)227 3397 y(double)30 b(precision)h(\015oating)g(p)s(oin)
m(t,)g(resp)s(ectiv)m(ely)-8 b(.)136 3585 y Fc(\017)46
b Fj(NAXIS)30 b({)h(the)g(n)m(um)m(b)s(er)e(of)h(dimensions)g(in)g(the)
h(arra)m(y)-8 b(,)31 b(usually)f(0,)h(1,)g(2,)g(3,)g(or)g(4.)136
3773 y Fc(\017)46 b Fj(NAXISn)30 b({)h(\(n)f(ranges)g(from)g(1)h(to)g
(NAXIS\))g(de\014nes)e(the)i(size)g(of)g(eac)m(h)g(dimension.)0
4008 y(FITS)e(tables)i(start)g(with)f(the)g(k)m(eyw)m(ord)g(XTENSION)g
(=)f(`T)-8 b(ABLE')31 b(\(for)f(ASCI)s(I)f(tables\))i(or)f(XTENSION)f
(=)0 4120 y(`BINT)-8 b(ABLE')32 b(\(for)e(binary)g(tables\))h(and)f(ha)
m(v)m(e)i(the)e(follo)m(wing)i(main)e(k)m(eyw)m(ords:)136
4355 y Fc(\017)46 b Fj(TFIELDS)30 b({)h(n)m(um)m(b)s(er)e(of)h
(\014elds)g(or)h(columns)f(in)g(the)g(table)136 4543
y Fc(\017)46 b Fj(NAXIS2)31 b({)g(n)m(um)m(b)s(er)e(of)h(ro)m(ws)h(in)f
(the)g(table)136 4731 y Fc(\017)46 b Fj(TTYPEn)29 b({)i(for)f(eac)m(h)i
(column)e(\(n)g(ranges)h(from)f(1)g(to)h(TFIELDS\))g(giv)m(es)g(the)g
(name)f(of)h(the)f(column)136 4918 y Fc(\017)46 b Fj(TF)m(ORMn)31
b({)f(the)h(data)g(t)m(yp)s(e)f(of)h(the)g(column)136
5106 y Fc(\017)46 b Fj(TUNITn)30 b({)g(the)h(ph)m(ysical)g(units)f(of)g
(the)h(column)f(\(optional\))0 5341 y(Users)k(should)f(refer)h(to)h
(the)f(FITS)g(Supp)s(ort)e(O\016ce)i(at)h Fe(http://fits.gsfc.nasa.gov)
27 b Fj(for)34 b(further)f(infor-)0 5454 y(mation)e(ab)s(out)f(the)h
(FITS)e(format)i(and)f(related)h(soft)m(w)m(are)h(pac)m(k)-5
b(ages.)p eop end
%%Page: 15 23
TeXDict begin 15 22 bop 0 1225 a Fg(Chapter)65 b(4)0
1687 y Fm(Programming)77 b(Guidelines)0 2216 y Ff(4.1)135
b(CFITSIO)44 b(De\014nitions)0 2466 y Fj(An)m(y)30 b(program)g(that)h
(uses)f(the)h(CFITSIO)d(in)m(terface)k(m)m(ust)e(include)g(the)h
(\014tsio.h)f(header)g(\014le)h(with)f(the)g(state-)0
2579 y(men)m(t)95 2818 y Fe(#include)46 b("fitsio.h")0
3057 y Fj(This)30 b(header)h(\014le)h(con)m(tains)g(the)f(protot)m(yp)s
(es)h(for)f(all)h(the)f(CFITSIO)f(user)g(in)m(terface)j(routines)e(as)g
(w)m(ell)h(as)g(the)0 3170 y(de\014nitions)g(of)g(v)-5
b(arious)32 b(constan)m(ts)h(used)e(in)h(the)h(in)m(terface.)47
b(It)32 b(also)h(de\014nes)e(a)i(C)f(structure)f(of)h(t)m(yp)s(e)h
(`\014ts\014le')0 3283 y(that)j(is)g(used)f(b)m(y)g(CFITSIO)f(to)j
(store)f(the)g(relev)-5 b(an)m(t)37 b(parameters)f(that)g(de\014ne)f
(the)h(format)g(of)g(a)g(particular)0 3396 y(FITS)c(\014le.)48
b(Application)34 b(programs)f(m)m(ust)g(de\014ne)f(a)h(p)s(oin)m(ter)g
(to)g(this)g(structure)g(for)f(eac)m(h)i(FITS)e(\014le)h(that)h(is)0
3508 y(to)i(b)s(e)f(op)s(ened.)56 b(This)35 b(structure)g(is)h
(initialized)h(\(i.e.,)i(memory)c(is)h(allo)s(cated)h(for)f(the)g
(structure\))f(when)g(the)0 3621 y(FITS)h(\014le)g(is)h(\014rst)e(op)s
(ened)h(or)g(created)i(with)e(the)g(\014ts)p 1949 3621
28 4 v 33 w(op)s(en)p 2172 3621 V 32 w(\014le)g(or)h(\014ts)p
2596 3621 V 32 w(create)p 2864 3621 V 34 w(\014le)g(routines.)59
b(This)35 b(\014ts\014le)0 3734 y(p)s(oin)m(ter)c(is)h(then)f(passed)g
(as)g(the)h(\014rst)e(argumen)m(t)i(to)g(ev)m(ery)g(other)g(CFITSIO)d
(routine)j(that)g(op)s(erates)g(on)f(the)0 3847 y(FITS)h(\014le.)48
b(Application)34 b(programs)f(m)m(ust)g(not)g(directly)g(read)g(or)g
(write)g(elemen)m(ts)h(in)f(this)g(\014ts\014le)f(structure)0
3960 y(b)s(ecause)e(the)h(de\014nition)f(of)h(the)f(structure)g(ma)m(y)
h(c)m(hange)g(in)g(future)e(v)m(ersions)i(of)f(CFITSIO.)0
4120 y(A)45 b(n)m(um)m(b)s(er)e(of)i(sym)m(b)s(olic)g(constan)m(ts)h
(are)f(also)g(de\014ned)f(in)g(\014tsio.h)h(for)f(the)h(con)m(v)m
(enience)i(of)e(application)0 4233 y(programmers.)55
b(Use)35 b(of)h(these)f(sym)m(b)s(olic)h(constan)m(ts)g(rather)f(than)g
(the)h(actual)g(n)m(umeric)f(v)-5 b(alue)36 b(will)f(help)g(to)0
4346 y(mak)m(e)c(the)g(source)f(co)s(de)h(more)g(readable)f(and)g
(easier)i(for)e(others)g(to)h(understand.)0 4585 y Fe(String)46
b(Lengths,)g(for)h(use)f(when)h(allocating)e(character)g(arrays:)95
4811 y(#define)h(FLEN_FILENAME)e(1025)j(/*)g(max)g(length)f(of)h(a)h
(filename)857 b(*/)95 4924 y(#define)46 b(FLEN_KEYWORD)140
b(72)95 b(/*)47 b(max)g(length)f(of)h(a)h(keyword)905
b(*/)95 5036 y(#define)46 b(FLEN_CARD)284 b(81)95 b(/*)47
b(max)g(length)f(of)h(a)h(FITS)f(header)f(card)476 b(*/)95
5149 y(#define)46 b(FLEN_VALUE)236 b(71)95 b(/*)47 b(max)g(length)f(of)
h(a)h(keyword)e(value)g(string)285 b(*/)95 5262 y(#define)46
b(FLEN_COMMENT)140 b(73)95 b(/*)47 b(max)g(length)f(of)h(a)h(keyword)e
(comment)g(string)189 b(*/)95 5375 y(#define)46 b(FLEN_ERRMSG)188
b(81)95 b(/*)47 b(max)g(length)f(of)h(a)h(CFITSIO)e(error)g(message)237
b(*/)95 5488 y(#define)46 b(FLEN_STATUS)188 b(31)95 b(/*)47
b(max)g(length)f(of)h(a)h(CFITSIO)e(status)g(text)g(string)h(*/)95
5714 y(Note)g(that)g(FLEN_KEYWORD)d(is)j(longer)f(than)h(the)g(nominal)
f(8-character)f(keyword)1905 5942 y Fj(15)p eop end
%%Page: 16 24
TeXDict begin 16 23 bop 0 299 a Fj(16)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)95 555 y Fe(name)47
b(length)f(because)g(the)h(HIERARCH)e(convention)g(supports)h(longer)g
(keyword)g(names.)0 781 y(Access)g(modes)g(when)h(opening)f(a)h(FITS)g
(file:)95 1007 y(#define)f(READONLY)94 b(0)95 1120 y(#define)46
b(READWRITE)g(1)0 1346 y(BITPIX)g(data)h(type)f(code)h(values)f(for)h
(FITS)g(images:)95 1571 y(#define)f(BYTE_IMG)284 b(8)96
b(/*)f(8-bit)46 b(unsigned)f(integers)h(*/)95 1684 y(#define)g
(SHORT_IMG)189 b(16)95 b(/*)47 b(16-bit)141 b(signed)46
b(integers)g(*/)95 1797 y(#define)g(LONG_IMG)237 b(32)95
b(/*)47 b(32-bit)141 b(signed)46 b(integers)g(*/)95 1910
y(#define)g(LONGLONG_IMG)f(64)95 b(/*)47 b(64-bit)141
b(signed)46 b(integers)g(*/)95 2023 y(#define)g(FLOAT_IMG)141
b(-32)95 b(/*)47 b(32-bit)f(single)g(precision)f(floating)h(point)g(*/)
95 2136 y(#define)g(DOUBLE_IMG)93 b(-64)i(/*)47 b(64-bit)f(double)g
(precision)f(floating)h(point)g(*/)95 2362 y(The)h(following)f(4)h
(data)g(type)f(codes)h(are)g(also)f(supported)g(by)h(CFITSIO:)95
2475 y(#define)f(SBYTE_IMG)93 b(10)143 b(/*)95 b(8-bit)46
b(signed)g(integers,)g(equivalent)f(to)i(*/)1241 2588
y(/*)95 b(BITPIX)46 b(=)h(8,)h(BSCALE)e(=)h(1,)g(BZERO)g(=)g(-128)g(*/)
95 2700 y(#define)f(USHORT_IMG)93 b(20)i(/*)47 b(16-bit)f(unsigned)g
(integers,)f(equivalent)g(to)i(*/)1241 2813 y(/*)95 b(BITPIX)46
b(=)h(16,)g(BSCALE)f(=)i(1,)f(BZERO)f(=)i(32768)e(*/)95
2926 y(#define)g(ULONG_IMG)141 b(40)95 b(/*)47 b(32-bit)f(unsigned)g
(integers,)f(equivalent)g(to)i(*/)1241 3039 y(/*)95 b(BITPIX)46
b(=)h(32,)g(BSCALE)f(=)i(1,)f(BZERO)f(=)i(2147483648)d(*/)0
3265 y(Codes)h(for)h(the)g(data)g(type)f(of)i(binary)e(table)g(columns)
g(and/or)g(for)h(the)0 3378 y(data)g(type)f(of)h(variables)f(when)g
(reading)g(or)h(writing)f(keywords)g(or)h(data:)1432
3604 y(DATATYPE)714 b(TFORM)46 b(CODE)95 3717 y(#define)g(TBIT)476
b(1)96 b(/*)1335 b('X')47 b(*/)95 3830 y(#define)f(TBYTE)381
b(11)95 b(/*)47 b(8-bit)f(unsigned)g(byte,)332 b('B')47
b(*/)95 3942 y(#define)f(TLOGICAL)237 b(14)95 b(/*)47
b(logicals)e(\(int)i(for)g(keywords)236 b(*/)1289 4055
y(/*)95 b(and)46 b(char)h(for)g(table)f(cols)142 b('L')47
b(*/)95 4168 y(#define)f(TSTRING)285 b(16)95 b(/*)47
b(ASCII)f(string,)666 b('A')47 b(*/)95 4281 y(#define)f(TSHORT)333
b(21)95 b(/*)47 b(signed)f(short,)666 b('I')47 b(*/)95
4394 y(#define)f(TLONG)381 b(41)95 b(/*)47 b(signed)f(long,)905
b(*/)95 4507 y(#define)46 b(TLONGLONG)189 b(81)95 b(/*)47
b(64-bit)f(long)h(signed)f(integer)f('K')i(*/)95 4620
y(#define)f(TFLOAT)333 b(42)95 b(/*)47 b(single)f(precision)f(float,)
189 b('E')47 b(*/)95 4733 y(#define)f(TDOUBLE)285 b(82)95
b(/*)47 b(double)f(precision)f(float,)189 b('D')47 b(*/)95
4846 y(#define)f(TCOMPLEX)237 b(83)95 b(/*)47 b(complex)f(\(pair)g(of)h
(floats\))141 b('C')47 b(*/)95 4959 y(#define)f(TDBLCOMPLEX)f(163)95
b(/*)47 b(double)f(complex)g(\(2)h(doubles\))e('M')i(*/)95
5185 y(The)g(following)f(data)g(type)h(codes)f(are)h(also)g(supported)e
(by)i(CFITSIO:)95 5297 y(#define)f(TINT)429 b(31)95 b(/*)47
b(int)1335 b(*/)95 5410 y(#define)46 b(TSBYTE)333 b(12)95
b(/*)47 b(8-bit)f(signed)g(byte,)428 b('S')47 b(*/)95
5523 y(#define)f(TUINT)381 b(30)95 b(/*)47 b(unsigned)e(int)715
b('V')47 b(*/)95 5636 y(#define)f(TUSHORT)285 b(20)95
b(/*)47 b(unsigned)e(short)619 b('U')95 b(*/)p eop end
%%Page: 17 25
TeXDict begin 17 24 bop 0 299 a Fh(4.2.)72 b(CURRENT)30
b(HEADER)h(D)m(A)-8 b(T)g(A)32 b(UNIT)e(\(CHDU\))1786
b Fj(17)95 555 y Fe(#define)46 b(TULONG)333 b(40)95 b(/*)47
b(unsigned)e(long)858 b(*/)95 781 y(The)47 b(following)f(data)g(type)h
(code)g(is)g(only)f(for)h(use)g(with)g(fits\\_get\\_coltype)95
894 y(#define)f(TINT32BIT)189 b(41)95 b(/*)47 b(signed)f(32-bit)g(int,)
428 b('J')47 b(*/)0 1233 y(HDU)g(type)g(code)f(values)g(\(value)g
(returned)g(when)h(moving)f(to)h(new)g(HDU\):)95 1458
y(#define)f(IMAGE_HDU)93 b(0)i(/*)48 b(Primary)d(Array)i(or)g(IMAGE)f
(HDU)h(*/)95 1571 y(#define)f(ASCII_TBL)93 b(1)i(/*)48
b(ASCII)94 b(table)46 b(HDU)h(*/)95 1684 y(#define)f(BINARY_TBL)f(2)95
b(/*)48 b(Binary)e(table)g(HDU)h(*/)95 1797 y(#define)f(ANY_HDU)142
b(-1)94 b(/*)48 b(matches)d(any)i(type)g(of)g(HDU)g(*/)0
2023 y(Column)f(name)h(and)g(string)f(matching)f(case-sensitivity:)95
2249 y(#define)h(CASESEN)142 b(1)g(/*)48 b(do)f(case-sensitive)d
(string)i(match)g(*/)95 2362 y(#define)g(CASEINSEN)g(0)142
b(/*)48 b(do)f(case-insensitive)c(string)j(match)h(*/)0
2588 y(Logical)f(states)g(\(if)h(TRUE)f(and)h(FALSE)g(are)g(not)g
(already)e(defined\):)95 2813 y(#define)h(TRUE)h(1)95
2926 y(#define)f(FALSE)h(0)0 3152 y(Values)f(to)h(represent)f
(undefined)f(floating)g(point)i(numbers:)95 3378 y(#define)f
(FLOATNULLVALUE)92 b(-9.11912E-36F)95 3491 y(#define)46
b(DOUBLENULLVALUE)e(-9.1191291391491E-36)0 3717 y(Image)i(compression)f
(algorithm)g(definitions)95 3942 y(#define)h(RICE_1)333
b(11)95 4055 y(#define)46 b(GZIP_1)333 b(21)95 4168 y(#define)46
b(PLIO_1)333 b(31)95 4281 y(#define)46 b(HCOMPRESS_1)93
b(41)0 4664 y Ff(4.2)135 b(Curren)l(t)46 b(Header)f(Data)h(Unit)g
(\(CHDU\))0 4924 y Fj(The)37 b(concept)h(of)g(the)f(Curren)m(t)g
(Header)g(and)g(Data)i(Unit,)h(or)d(CHDU,)h(is)f(fundamen)m(tal)h(to)g
(the)f(use)g(of)h(the)0 5036 y(CFITSIO)31 b(library)-8
b(.)46 b(A)32 b(simple)h(FITS)e(image)j(ma)m(y)f(only)f(con)m(tain)i(a)
e(single)h(Header)g(and)f(Data)h(unit)f(\(HDU\),)0 5149
y(but)39 b(in)g(general)i(FITS)e(\014les)h(can)g(con)m(tain)h(m)m
(ultiple)g(Header)f(Data)h(Units)f(\(also)h(kno)m(wn)e(as)h
(`extensions'\),)0 5262 y(concatenated)c(one)f(after)f(the)h(other)f
(in)g(the)g(\014le.)53 b(The)33 b(user)h(can)g(sp)s(ecify)g(whic)m(h)g
(HDU)h(should)e(b)s(e)g(initially)0 5375 y(op)s(ened)j(at)i(run)d(time)
j(b)m(y)f(giving)h(the)f(HDU)h(name)f(or)g(n)m(um)m(b)s(er)f(after)h
(the)g(ro)s(ot)h(\014le)f(name.)60 b(F)-8 b(or)38 b(example,)0
5488 y('m)m(y\014le.\014ts[4]')i(op)s(ens)d(the)h(5th)h(HDU)g(in)f(the)
g(\014le)g(\(note)h(that)g(the)f(n)m(um)m(b)s(ering)f(starts)i(with)f
(0\),)j(and)c('m)m(y-)0 5601 y(\014le.\014ts[EVENTS])k(op)s(ens)f(the)h
(HDU)h(with)e(the)h(name)g('EVENTS')g(\(as)g(de\014ned)f(b)m(y)h(the)g
(EXTNAME)g(or)0 5714 y(HDUNAME)35 b(k)m(eyw)m(ords\).)50
b(If)33 b(no)g(HDU)h(is)f(sp)s(eci\014ed)g(then)g(CFITSIO)e(op)s(ens)i
(the)g(\014rst)g(HDU)h(\(the)g(primary)p eop end
%%Page: 18 26
TeXDict begin 18 25 bop 0 299 a Fj(18)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)0 555 y Fj(arra)m(y\))24
b(b)m(y)e(default.)39 b(The)22 b(CFITSIO)f(routines)i(whic)m(h)g(read)f
(and)g(write)i(data)f(only)g(op)s(erate)g(within)g(the)g(op)s(ened)0
668 y(HDU,)32 b(Other)e(CFITSIO)f(routines)i(are)g(pro)m(vided)f(to)i
(mo)m(v)m(e)g(to)f(and)f(op)s(en)g(an)m(y)h(other)g(existing)h(HDU)f
(within)0 781 y(the)g(FITS)e(\014le)i(or)f(to)h(app)s(end)e(or)h
(insert)g(new)g(HDUs)h(in)f(the)h(FITS)f(\014le.)0 1111
y Ff(4.3)135 b(F)-11 b(unction)44 b(Names)i(and)f(V)-11
b(ariable)46 b(Datat)l(yp)t(es)0 1361 y Fj(Most)33 b(of)f(the)g
(CFITSIO)f(routines)h(ha)m(v)m(e)h(b)s(oth)e(a)i(short)e(name)h(as)h(w)
m(ell)g(as)f(a)g(longer)h(descriptiv)m(e)g(name.)45 b(The)0
1474 y(short)32 b(name)g(is)g(only)g(5)h(or)f(6)g(c)m(haracters)h(long)
g(and)f(is)g(similar)g(to)h(the)f(subroutine)f(name)h(in)g(the)g(F)-8
b(ortran-77)0 1587 y(v)m(ersion)38 b(of)g(FITSIO.)f(The)h(longer)g
(name)g(is)g(more)g(descriptiv)m(e)h(and)e(it)h(is)g(recommended)g
(that)g(it)h(b)s(e)e(used)0 1699 y(instead)31 b(of)f(the)h(short)f
(name)g(to)h(more)g(clearly)h(do)s(cumen)m(t)e(the)g(source)h(co)s(de.)
0 1860 y(Man)m(y)c(of)f(the)g(CFITSIO)f(routines)h(come)h(in)e
(families)i(whic)m(h)f(di\013er)g(only)g(in)g(the)g(data)h(t)m(yp)s(e)f
(of)g(the)g(asso)s(ciated)0 1973 y(parameter\(s\).)45
b(The)31 b(data)h(t)m(yp)s(e)g(of)g(these)g(routines)f(is)h(indicated)g
(b)m(y)f(the)h(su\016x)e(of)i(the)g(routine)f(name.)44
b(The)0 2085 y(short)27 b(routine)h(names)g(ha)m(v)m(e)h(a)f(1)g(or)f
(2)h(c)m(haracter)i(su\016x)c(\(e.g.,)31 b('j')c(in)h('\013pkyj'\))g
(while)f(the)h(long)g(routine)g(names)0 2198 y(ha)m(v)m(e)k(a)e(4)h(c)m
(haracter)h(or)e(longer)h(su\016x)f(as)g(sho)m(wn)g(in)g(the)h(follo)m
(wing)h(table:)191 2432 y Fe(Long)285 b(Short)94 b(Data)191
2545 y(Names)237 b(Names)94 b(Type)191 2658 y(-----)237
b(-----)94 b(----)191 2771 y(_bit)381 b(x)190 b(bit)191
2883 y(_byt)381 b(b)190 b(unsigned)46 b(byte)191 2996
y(_sbyt)333 b(sb)142 b(signed)46 b(byte)191 3109 y(_sht)381
b(i)190 b(short)47 b(integer)191 3222 y(_lng)381 b(j)190
b(long)47 b(integer)191 3335 y(_lnglng)237 b(jj)142 b(8-byte)46
b(LONGLONG)g(integer)g(\(see)g(note)h(below\))191 3448
y(_usht)333 b(ui)142 b(unsigned)46 b(short)g(integer)191
3561 y(_ulng)333 b(uj)142 b(unsigned)46 b(long)g(integer)191
3674 y(_uint)333 b(uk)142 b(unsigned)46 b(int)h(integer)191
3787 y(_int)381 b(k)190 b(int)47 b(integer)191 3900 y(_flt)381
b(e)190 b(real)47 b(exponential)e(floating)g(point)i(\(float\))191
4013 y(_fixflt)237 b(f)190 b(real)47 b(fixed-decimal)d(format)i
(floating)g(point)g(\(float\))191 4125 y(_dbl)381 b(d)190
b(double)46 b(precision)g(real)g(floating-point)e(\(double\))191
4238 y(_fixdbl)237 b(g)190 b(double)46 b(precision)g(fixed-format)e
(floating)i(point)g(\(double\))191 4351 y(_cmp)381 b(c)190
b(complex)46 b(reals)g(\(pairs)h(of)g(float)f(values\))191
4464 y(_fixcmp)237 b(fc)142 b(complex)46 b(reals,)g(fixed-format)f
(floating)g(point)191 4577 y(_dblcmp)237 b(m)190 b(double)46
b(precision)g(complex)f(\(pairs)i(of)g(double)f(values\))191
4690 y(_fixdblcmp)93 b(fm)142 b(double)46 b(precision)g(complex,)f
(fixed-format)g(floating)g(point)191 4803 y(_log)381
b(l)190 b(logical)46 b(\(int\))191 4916 y(_str)381 b(s)190
b(character)46 b(string)0 5149 y Fj(The)32 b(logical)j(data)f(t)m(yp)s
(e)f(corresp)s(onds)e(to)j(`in)m(t')f(for)g(logical)i(k)m(eyw)m(ord)e
(v)-5 b(alues,)34 b(and)e(`b)m(yte')i(for)f(logical)i(binary)0
5262 y(table)40 b(columns.)67 b(In)39 b(other)g(w)m(ords,)i(the)f(v)-5
b(alue)39 b(when)g(writing)g(a)h(logical)h(k)m(eyw)m(ord)f(m)m(ust)f(b)
s(e)g(stored)g(in)g(an)0 5375 y(`in)m(t')g(v)-5 b(ariable,)40
b(and)e(m)m(ust)f(b)s(e)g(stored)h(in)g(a)g(`c)m(har')h(arra)m(y)f
(when)f(reading)h(or)f(writing)h(to)h(`L')f(columns)f(in)h(a)0
5488 y(binary)c(table.)56 b(Implicit)35 b(data)h(t)m(yp)s(e)f(con)m(v)m
(ersion)i(is)e(not)g(supp)s(orted)e(for)i(logical)j(table)e(columns,)g
(but)e(is)h(for)0 5601 y(k)m(eyw)m(ords,)30 b(so)f(a)h(logical)h(k)m
(eyw)m(ord)f(ma)m(y)f(b)s(e)g(read)f(and)h(cast)h(to)g(an)m(y)f(n)m
(umerical)h(data)f(t)m(yp)s(e;)h(a)g(returned)d(v)-5
b(alue)0 5714 y(=)30 b(0)h(indicates)g(false,)g(and)f(an)m(y)h(other)f
(v)-5 b(alue)31 b(=)f(true.)p eop end
%%Page: 19 27
TeXDict begin 19 26 bop 0 299 a Fh(4.3.)72 b(FUNCTION)30
b(NAMES)h(AND)g(V)-10 b(ARIABLE)30 b(D)m(A)-8 b(T)g(A)g(TYPES)1409
b Fj(19)0 555 y(The)24 b(`in)m(t')i(data)g(t)m(yp)s(e)f(ma)m(y)h(b)s(e)
e(2)h(b)m(ytes)h(long)f(on)g(some)g(old)g(PC)g(compilers,)h(but)f
(otherwise)g(it)g(is)g(nearly)g(alw)m(a)m(ys)0 668 y(4)i(b)m(ytes)g
(long.)40 b(Some)27 b(64-bit)h(mac)m(hines,)g(lik)m(e)g(the)f
(Alpha/OSF,)g(de\014ne)f(the)h(`short',)h(`in)m(t',)h(and)d(`long')i
(in)m(teger)0 781 y(data)j(t)m(yp)s(es)f(to)i(b)s(e)d(2,)i(4,)g(and)f
(8)h(b)m(ytes)g(long,)g(resp)s(ectiv)m(ely)-8 b(.)0 941
y(Because)40 b(there)e(is)h(no)f(univ)m(ersal)h(C)f(compiler)g
(standard)g(for)g(the)h(name)f(of)h(the)f(8-b)m(yte)i(in)m(teger)g
(datat)m(yp)s(e,)0 1054 y(the)33 b(\014tsio.h)h(include)f(\014le)g(t)m
(yp)s(edef)7 b('s)33 b('LONGLONG')h(to)g(b)s(e)e(equiv)-5
b(alen)m(t)35 b(to)f(an)f(appropriate)g(8-b)m(yte)i(in)m(teger)0
1167 y(data)c(t)m(yp)s(e)g(on)f(eac)m(h)i(supp)s(orted)d(platform.)41
b(F)-8 b(or)31 b(maxim)m(um)f(soft)m(w)m(are)i(p)s(ortabilit)m(y)g(it)f
(is)f(recommended)g(that)0 1280 y(this)g(LONGLONG)g(datat)m(yp)s(e)h(b)
s(e)e(used)g(to)i(de\014ne)e(8-b)m(yte)i(in)m(teger)h(v)-5
b(ariables)30 b(rather)g(than)g(using)f(the)i(nativ)m(e)0
1393 y(data)h(t)m(yp)s(e)g(name)f(on)h(a)f(particular)h(platform.)44
b(On)31 b(most)h(32-bit)g(Unix)g(and)e(Mac)j(OS-X)e(op)s(erating)h
(systems)0 1506 y(LONGLONG)h(is)f(equiv)-5 b(alen)m(t)34
b(to)f(the)g(in)m(trinsic)g('long)g(long')h(8-b)m(yte)g(in)m(teger)f
(datat)m(yp)s(e.)49 b(On)31 b(64-bit)j(systems)0 1619
y(\(whic)m(h)e(curren)m(tly)g(includes)f(Alpha)h(OSF/1,)g(64-bit)h(Sun)
e(Solaris,)h(64-bit)h(SGI)f(MIPS,)f(and)g(64-bit)i(Itanium)0
1732 y(and)28 b(Opteron)g(PC)h(systems\),)g(LONGLONG)g(is)g(simply)f(t)
m(yp)s(edef)7 b('ed)29 b(to)g(b)s(e)g(equiv)-5 b(alen)m(t)30
b(to)f('long'.)42 b(Microsoft)0 1844 y(Visual)33 b(C++)e(V)-8
b(ersion)33 b(6.0)g(do)s(es)f(not)g(de\014ne)g(a)h('long)g(long')g
(data)g(t)m(yp)s(e,)g(so)f(LONGLONG)h(is)f(t)m(yp)s(edef)7
b('ed)32 b(to)0 1957 y(b)s(e)e(equiv)-5 b(alen)m(t)32
b(to)f(the)f(')p 853 1957 28 4 v 887 1957 V 66 w(in)m(t64')i(data)f(t)m
(yp)s(e)g(on)f(32-bit)h(windo)m(ws)f(systems)h(when)e(using)h(Visual)h
(C++.)0 2118 y(A)j(related)h(issue)e(that)i(a\013ects)g(the)f(p)s
(ortabilit)m(y)g(of)g(soft)m(w)m(are)i(is)d(ho)m(w)h(to)h(prin)m(t)e
(out)h(the)g(v)-5 b(alue)34 b(of)g(a)g('LONG-)0 2230
y(LONG')e(v)-5 b(ariable)32 b(with)f(prin)m(tf.)44 b(Dev)m(elop)s(ers)
33 b(ma)m(y)f(\014nd)e(it)i(con)m(v)m(enien)m(t)h(to)g(use)e(the)h
(follo)m(wing)h(prepro)s(cessing)0 2343 y(statemen)m(ts)f(in)e(their)h
(C)f(programs)g(to)h(handle)f(this)g(in)g(a)h(mac)m(hine-p)s(ortable)g
(manner:)0 2593 y Fe(#if)47 b(defined\(_MSC_VER\))c(/*)k(Microsoft)e
(Visual)i(C++)f(*/)477 2706 y(printf\("\045I64d",)e(longlongvalue\);)0
2932 y(#elif)i(\(USE_LL_SUFFIX)e(==)j(1\))477 3045 y
(printf\("\045lld",)d(longlongvalue\);)0 3271 y(#else)477
3384 y(printf\("\045ld",)g(longlongvalue\);)0 3496 y(#endif)0
3746 y Fj(Similarly)-8 b(,)32 b(the)f(name)g(of)g(the)h(C)e(utilit)m(y)
j(routine)e(that)g(con)m(v)m(erts)i(a)e(c)m(haracter)i(string)d(of)i
(digits)f(in)m(to)h(a)g(8-b)m(yte)0 3859 y(in)m(teger)g(v)-5
b(alue)31 b(is)f(platform)g(dep)s(enden)m(t:)0 4109 y
Fe(#if)47 b(defined\(_MSC_VER\))c(/*)k(Microsoft)e(Visual)i(C++)f(*/)
286 4222 y(/*)i(VC++)e(6.0)h(does)g(not)g(seem)f(to)h(have)g(an)g
(8-byte)f(conversion)f(routine)h(*/)0 4448 y(#elif)g(\(USE_LL_SUFFIX)e
(==)j(1\))477 4561 y(longlongvalue)d(=)k(atoll\(*string\);)0
4787 y(#else)477 4899 y(longlongvalue)c(=)k(atol\(*string\);)0
5012 y(#endif)0 5262 y Fj(When)23 b(dealing)h(with)f(the)h(FITS)f(b)m
(yte)h(data)g(t)m(yp)s(e)f(it)h(is)g(imp)s(ortan)m(t)f(to)h(remem)m(b)s
(er)f(that)h(the)g(ra)m(w)f(v)-5 b(alues)24 b(\(b)s(efore)0
5375 y(an)m(y)h(scaling)g(b)m(y)f(the)h(BSCALE)e(and)h(BZER)m(O,)g(or)h
(TSCALn)d(and)i(TZER)m(On)f(k)m(eyw)m(ord)i(v)-5 b(alues\))25
b(in)f(b)m(yte)h(arra)m(ys)0 5488 y(\(BITPIX)37 b(=)f(8\))h(or)f(b)m
(yte)i(columns)e(\(TF)m(ORMn)h(=)f('B'\))h(are)g(in)m(terpreted)g(as)g
(unsigned)e(b)m(ytes)i(with)g(v)-5 b(alues)0 5601 y(ranging)34
b(from)g(0)g(to)h(255.)53 b(Some)34 b(C)g(compilers)h(de\014ne)e(a)h
('c)m(har')h(v)-5 b(ariable)35 b(as)g(signed,)g(so)f(it)h(is)f(imp)s
(ortan)m(t)g(to)0 5714 y(explicitly)e(declare)f(a)g(n)m(umeric)f(c)m
(har)h(v)-5 b(ariable)31 b(as)g('unsigned)e(c)m(har')i(to)g(a)m(v)m
(oid)h(an)m(y)f(am)m(biguit)m(y)p eop end
%%Page: 20 28
TeXDict begin 20 27 bop 0 299 a Fj(20)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)0 555 y Fj(One)22
b(feature)h(of)g(the)g(CFITSIO)e(routines)i(is)f(that)i(they)f(can)g
(op)s(erate)g(on)f(a)h(`X')h(\(bit\))f(column)g(in)f(a)h(binary)f
(table)0 668 y(as)33 b(though)f(it)h(w)m(ere)g(a)g(`B')g(\(b)m(yte\))h
(column.)47 b(F)-8 b(or)33 b(example)g(a)g(`11X')h(data)f(t)m(yp)s(e)g
(column)f(can)h(b)s(e)f(in)m(terpreted)0 781 y(the)c(same)h(as)f(a)g
(`2B')i(column)e(\(i.e.,)i(2)e(unsigned)f(8-bit)i(b)m(ytes\).)41
b(In)27 b(some)i(instances,)g(it)f(can)h(b)s(e)e(more)h(e\016cien)m(t)0
894 y(to)j(read)f(and)g(write)h(whole)f(b)m(ytes)h(at)g(a)g(time,)g
(rather)g(than)f(reading)g(or)h(writing)f(eac)m(h)i(individual)d(bit.)0
1054 y(The)36 b(complex)i(and)e(double)h(precision)g(complex)h(data)g
(t)m(yp)s(es)f(are)g(not)g(directly)h(supp)s(orted)d(in)i(ANSI)f(C)h
(so)0 1167 y(these)g(data)g(t)m(yp)s(es)f(should)f(b)s(e)h(in)m
(terpreted)h(as)f(pairs)g(of)h(\015oat)g(or)f(double)g(v)-5
b(alues,)38 b(resp)s(ectiv)m(ely)-8 b(,)40 b(where)c(the)0
1280 y(\014rst)30 b(v)-5 b(alue)30 b(in)h(eac)m(h)g(pair)f(is)h(the)f
(real)h(part,)g(and)e(the)i(second)f(is)h(the)f(imaginary)h(part.)0
1606 y Ff(4.4)135 b(Supp)t(ort)44 b(for)h(Unsigned)h(In)l(tegers)g(and)
f(Signed)g(Bytes)0 1856 y Fj(Although)33 b(FITS)f(do)s(es)g(not)h
(directly)h(supp)s(ort)d(unsigned)g(in)m(tegers)j(as)f(one)g(of)g(its)h
(fundamen)m(tal)e(data)i(t)m(yp)s(es,)0 1969 y(FITS)27
b(can)h(still)h(b)s(e)e(used)g(to)i(e\016cien)m(tly)h(store)e(unsigned)
f(in)m(teger)i(data)g(v)-5 b(alues)28 b(in)g(images)h(and)e(binary)g
(tables.)0 2082 y(The)42 b(con)m(v)m(en)m(tion)j(used)d(in)g(FITS)g
(\014les)h(is)f(to)i(store)f(the)g(unsigned)e(in)m(tegers)j(as)f
(signed)g(in)m(tegers)h(with)e(an)0 2195 y(asso)s(ciated)34
b(o\013set)f(\(sp)s(eci\014ed)f(b)m(y)g(the)g(BZER)m(O)g(or)g(TZER)m
(On)f(k)m(eyw)m(ord\).)47 b(F)-8 b(or)33 b(example,)g(to)g(store)g
(unsigned)0 2308 y(16-bit)g(in)m(teger)g(v)-5 b(alues)32
b(in)f(a)h(FITS)f(image)i(the)e(image)i(w)m(ould)f(b)s(e)e(de\014ned)h
(as)h(a)g(signed)f(16-bit)i(in)m(teger)g(\(with)0 2421
y(BITPIX)c(k)m(eyw)m(ord)g(=)g(SHOR)-8 b(T)p 1132 2421
28 4 v 32 w(IMG)30 b(=)e(16\))j(with)d(the)i(k)m(eyw)m(ords)f(BSCALE)f
(=)h(1.0)h(and)f(BZER)m(O)g(=)f(32768.)0 2534 y(Th)m(us)34
b(the)h(unsigned)f(v)-5 b(alues)35 b(of)g(0,)i(32768,)h(and)d(65535,)j
(for)d(example,)i(are)e(ph)m(ysically)h(stored)f(in)g(the)g(FITS)0
2647 y(image)40 b(as)e(-32768,)43 b(0,)e(and)d(32767,)k(resp)s(ectiv)m
(ely;)i(CFITSIO)37 b(automatically)k(adds)c(the)i(BZER)m(O)f(o\013set)h
(to)0 2759 y(these)g(v)-5 b(alues)39 b(when)f(they)g(are)h(read.)65
b(Similarly)-8 b(,)42 b(in)c(the)h(case)h(of)e(unsigned)g(32-bit)i(in)m
(tegers)f(the)g(BITPIX)0 2872 y(k)m(eyw)m(ord)c(w)m(ould)f(b)s(e)g
(equal)h(to)h(LONG)p 1392 2872 V 32 w(IMG)f(=)g(32)g(and)f(BZER)m(O)g
(w)m(ould)h(b)s(e)f(equal)h(to)g(2147483648)k(\(i.e.)55
b(2)0 2985 y(raised)30 b(to)h(the)g(31st)g(p)s(o)m(w)m(er\).)0
3145 y(The)j(CFITSIO)g(in)m(terface)i(routines)f(will)g(e\016cien)m
(tly)i(and)d(transparen)m(tly)i(apply)e(the)h(appropriate)g(o\013set)h
(in)0 3258 y(these)29 b(cases)h(so)f(in)g(general)h(application)g
(programs)f(do)g(not)g(need)f(to)i(b)s(e)e(concerned)h(with)g(ho)m(w)g
(the)g(unsigned)0 3371 y(v)-5 b(alues)44 b(are)h(actually)h(stored)e
(in)f(the)i(FITS)e(\014le.)82 b(As)44 b(a)g(con)m(v)m(enience)j(for)c
(users,)k(CFITSIO)c(has)h(sev)m(eral)0 3484 y(prede\014ned)19
b(constan)m(ts)j(for)f(the)g(v)-5 b(alue)21 b(of)g(BITPIX)g(\(USHOR)-8
b(T)p 2189 3484 V 33 w(IMG,)21 b(ULONG)p 2790 3484 V
33 w(IMG\))h(and)e(for)h(the)g(TF)m(ORMn)0 3597 y(v)-5
b(alue)36 b(in)f(the)h(case)g(of)g(binary)f(tables)h(\(`U')h(and)e
(`V'\))h(whic)m(h)f(programmers)g(can)h(use)f(when)g(creating)i(FITS)0
3710 y(\014les)i(con)m(taining)h(unsigned)e(in)m(teger)i(v)-5
b(alues.)66 b(The)39 b(follo)m(wing)h(co)s(de)f(fragmen)m(t)g
(illustrates)h(ho)m(w)f(to)h(write)f(a)0 3823 y(FITS)30
b(1-D)h(primary)f(arra)m(y)g(of)h(unsigned)e(16-bit)j(in)m(tegers:)286
4034 y Fe(unsigned)46 b(short)g(uarray[100];)286 4147
y(int)h(naxis,)f(status;)286 4260 y(long)h(naxes[10],)e(group,)h
(firstelem,)f(nelements;)334 4373 y(...)286 4486 y(status)h(=)i(0;)286
4599 y(naxis)f(=)g(1;)286 4712 y(naxes[0])f(=)h(100;)286
4825 y(fits_create_img\(fptr,)42 b(USHORT_IMG,)j(naxis,)h(naxes,)g
(&status\);)286 5051 y(firstelem)g(=)h(1;)286 5164 y(nelements)f(=)h
(100;)286 5276 y(fits_write_img\(fptr,)c(TUSHORT,)i(firstelem,)g
(nelements,)1241 5389 y(uarray,)h(&status\);)334 5502
y(...)0 5714 y Fj(In)40 b(the)h(ab)s(o)m(v)m(e)i(example,)h(the)e(2nd)e
(parameter)h(in)g(\014ts)p 1998 5714 V 33 w(create)p
2267 5714 V 34 w(img)g(tells)h(CFITSIO)e(to)i(write)f(the)g(header)p
eop end
%%Page: 21 29
TeXDict begin 21 28 bop 0 299 a Fh(4.4.)72 b(SUPPOR)-8
b(T)30 b(F)m(OR)g(UNSIGNED)h(INTEGERS)f(AND)h(SIGNED)f(BYTES)942
b Fj(21)0 555 y(k)m(eyw)m(ords)34 b(appropriate)g(for)f(an)g(arra)m(y)i
(of)e(16-bit)i(unsigned)e(in)m(tegers)i(\(i.e.,)h(BITPIX)d(=)g(16)i
(and)e(BZER)m(O)g(=)0 668 y(32768\).)41 b(Then)23 b(the)h(\014ts)p
834 668 28 4 v 32 w(write)p 1068 668 V 33 w(img)h(routine)f(writes)f
(the)i(arra)m(y)f(of)g(unsigned)f(short)g(in)m(tegers)i(\(uarra)m(y\))g
(in)m(to)g(the)0 781 y(primary)f(arra)m(y)h(of)g(the)g(FITS)f(\014le.)
39 b(Similarly)-8 b(,)27 b(a)e(32-bit)i(unsigned)c(in)m(teger)j(image)h
(ma)m(y)e(b)s(e)f(created)i(b)m(y)f(setting)0 894 y(the)34
b(second)f(parameter)h(in)f(\014ts)p 1130 894 V 33 w(create)p
1399 894 V 34 w(img)h(equal)g(to)g(`ULONG)p 2330 894
V 33 w(IMG')g(and)f(b)m(y)h(calling)g(the)g(\014ts)p
3491 894 V 33 w(write)p 3726 894 V 33 w(img)0 1007 y(routine)j(with)f
(the)h(second)f(parameter)h(=)f(TULONG)h(to)g(write)g(the)f(arra)m(y)h
(of)g(unsigned)f(long)h(image)h(pixel)0 1120 y(v)-5 b(alues.)0
1280 y(An)27 b(analogous)h(set)f(of)g(routines)g(are)g(a)m(v)-5
b(ailable)30 b(for)c(reading)h(or)g(writing)g(unsigned)f(in)m(teger)i
(v)-5 b(alues)28 b(and)e(signed)0 1393 y(b)m(yte)i(v)-5
b(alues)28 b(in)g(a)g(FITS)f(binary)g(table)i(extension.)40
b(When)28 b(sp)s(ecifying)f(the)h(TF)m(ORMn)g(k)m(eyw)m(ord)g(v)-5
b(alue)28 b(whic)m(h)0 1506 y(de\014nes)36 b(the)h(format)g(of)g(a)h
(column,)g(CFITSIO)d(recognized)k(3)e(additional)h(data)f(t)m(yp)s(e)g
(co)s(des)g(b)s(esides)f(those)0 1619 y(already)30 b(de\014ned)f(in)g
(the)h(FITS)f(standard:)40 b(`U')30 b(meaning)g(a)g(16-bit)h(unsigned)e
(in)m(teger)i(column,)f(`V')g(for)g(a)g(32-)0 1732 y(bit)c(unsigned)e
(in)m(teger)j(column,)g(and)e('S')g(for)g(a)h(signed)g(b)m(yte)g
(column.)39 b(These)25 b(non-standard)g(data)h(t)m(yp)s(e)g(co)s(des)0
1844 y(are)36 b(not)g(actually)i(written)e(in)m(to)g(the)g(FITS)g
(\014le)f(but)h(instead)g(are)g(just)f(used)g(in)m(ternally)i(within)e
(CFITSIO.)0 1957 y(The)30 b(follo)m(wing)i(co)s(de)e(fragmen)m(t)h
(illustrates)h(ho)m(w)e(to)h(use)f(these)h(features:)286
2214 y Fe(unsigned)46 b(short)g(uarray[100];)286 2327
y(unsigned)g(int)95 b(varray[100];)286 2552 y(int)47
b(colnum,)f(tfields,)g(status;)286 2665 y(long)h(nrows,)f(firstrow,)f
(firstelem,)g(nelements,)g(pcount;)286 2891 y(char)i(extname[])e(=)j
("Test_table";)521 b(/*)47 b(extension)f(name)g(*/)286
3117 y(/*)i(define)e(the)h(name,)f(data)h(type,)f(and)h(physical)e
(units)i(for)g(the)g(2)g(columns)f(*/)286 3230 y(char)h(*ttype[])f(=)h
({)g("Col_1",)f("Col_2",)g("Col_3")f(};)286 3343 y(char)i(*tform[])f(=)
h({)g("1U",)285 b("1V",)190 b("1S"};)94 b(/*)47 b(special)f(CFITSIO)g
(codes)g(*/)286 3456 y(char)h(*tunit[])f(=)h({)g(")h(",)381
b(")48 b(",)190 b(")47 b(")h(};)334 3569 y(...)525 3794
y(/*)f(write)g(the)f(header)h(keywords)e(*/)286 3907
y(status)94 b(=)48 b(0;)286 4020 y(nrows)142 b(=)48 b(1;)286
4133 y(tfields)e(=)i(3)286 4246 y(pcount)94 b(=)48 b(0;)286
4359 y(fits_create_tbl\(fptr,)42 b(BINARY_TBL,)j(nrows,)h(tfields,)g
(ttype,)g(tform,)764 4472 y(tunit,)g(extname,)f(&status\);)525
4698 y(/*)i(write)g(the)f(unsigned)g(shorts)g(to)h(the)g(1st)g(column)f
(*/)286 4811 y(colnum)190 b(=)47 b(1;)286 4924 y(firstrow)94
b(=)47 b(1;)286 5036 y(firstelem)f(=)h(1;)286 5149 y(nelements)f(=)h
(100;)286 5262 y(fits_write_col\(fptr,)c(TUSHORT,)i(colnum,)h
(firstrow,)f(firstelem,)668 5375 y(nelements,)g(uarray,)h(&status\);)
525 5601 y(/*)h(now)g(write)f(the)h(unsigned)f(longs)g(to)h(the)g(2nd)g
(column)f(*/)286 5714 y(colnum)190 b(=)47 b(2;)p eop
end
%%Page: 22 30
TeXDict begin 22 29 bop 0 299 a Fj(22)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)286 555 y Fe
(fits_write_col\(fptr,)43 b(TUINT,)j(colnum,)g(firstrow,)f(firstelem,)
668 668 y(nelements,)g(varray,)h(&status\);)334 781 y(...)0
1027 y Fj(Note)22 b(that)g(the)f(non-standard)f(TF)m(ORM)h(v)-5
b(alues)21 b(for)g(the)g(3)g(columns,)i(`U')e(and)g(`V',)h(tell)g
(CFITSIO)d(to)j(write)f(the)0 1140 y(k)m(eyw)m(ords)27
b(appropriate)f(for)g(unsigned)f(16-bit)j(and)d(unsigned)h(32-bit)h(in)
m(tegers,)i(resp)s(ectiv)m(ely)e(\(i.e.,)i(TF)m(ORMn)0
1252 y(=)39 b('1I')i(and)e(TZER)m(On)f(=)h(32678)j(for)e(unsigned)e
(16-bit)j(in)m(tegers,)j(and)39 b(TF)m(ORMn)h(=)f('1J')h(and)f(TZER)m
(On)0 1365 y(=)c(2147483648)40 b(for)35 b(unsigned)f(32-bit)i(in)m
(tegers\).)57 b(The)35 b('S')g(TF)m(ORMn)g(v)-5 b(alue)36
b(tells)h(CFITSIO)c(to)j(write)g(the)0 1478 y(k)m(eyw)m(ords)30
b(appropriate)g(for)g(a)g(signed)g(8-bit)h(b)m(yte)f(column)g(with)f
(TF)m(ORMn)h(=)g('1B')h(and)e(TZER)m(On)g(=)g(-128.)0
1591 y(The)h(calls)h(to)h(\014ts)p 628 1591 28 4 v 32
w(write)p 862 1591 V 33 w(col)f(then)f(write)h(the)g(arra)m(ys)f(of)h
(unsigned)e(in)m(teger)j(v)-5 b(alues)31 b(to)g(the)f(columns.)0
1923 y Ff(4.5)135 b(Dealing)47 b(with)e(Character)h(Strings)0
2173 y Fj(The)36 b(c)m(haracter)j(string)d(v)-5 b(alues)38
b(in)e(a)h(FITS)f(header)h(or)g(in)f(an)h(ASCI)s(I)e(column)i(in)f(a)i
(FITS)e(table)h(extension)0 2286 y(are)i(generally)i(padded)d(out)h
(with)g(non-signi\014can)m(t)h(space)f(c)m(haracters)i(\(ASCI)s(I)d
(32\))i(to)g(\014ll)f(up)f(the)h(header)0 2399 y(record)33
b(or)h(the)f(column)h(width.)49 b(When)33 b(reading)h(a)g(FITS)e
(string)i(v)-5 b(alue,)35 b(the)e(CFITSIO)f(routines)i(will)f(strip)0
2512 y(o\013)38 b(these)f(non-signi\014can)m(t)h(trailing)g(spaces)f
(and)g(will)g(return)f(a)i(n)m(ull-terminated)g(string)f(v)-5
b(alue)37 b(con)m(taining)0 2624 y(only)d(the)g(signi\014can)m(t)g(c)m
(haracters.)52 b(Leading)34 b(spaces)g(in)g(a)g(FITS)f(string)g(are)h
(considered)g(signi\014can)m(t.)52 b(If)33 b(the)0 2737
y(string)i(con)m(tains)h(all)g(blanks,)g(then)e(CFITSIO)g(will)h
(return)f(a)h(single)g(blank)g(c)m(haracter,)j(i.e,)f(the)e(\014rst)f
(blank)0 2850 y(is)c(considered)f(to)i(b)s(e)e(signi\014can)m(t,)i
(since)f(it)g(distinguishes)g(the)g(string)f(from)h(a)g(n)m(ull)f(or)h
(unde\014ned)e(string,)i(but)0 2963 y(the)h(remaining)f(trailing)h
(spaces)g(are)g(not)g(signi\014can)m(t.)0 3123 y(Similarly)-8
b(,)41 b(when)c(writing)h(string)g(v)-5 b(alues)38 b(to)h(a)g(FITS)e
(\014le)h(the)g(CFITSIO)f(routines)h(exp)s(ect)g(to)h(get)g(a)g(n)m
(ull-)0 3236 y(terminated)33 b(string)g(as)g(input;)g(CFITSIO)e(will)i
(pad)f(the)h(string)g(with)f(blanks)g(if)h(necessary)g(when)f(writing)g
(it)0 3349 y(to)f(the)g(FITS)e(\014le.)0 3509 y(When)j(calling)i
(CFITSIO)d(routines)i(that)g(return)e(a)i(c)m(haracter)h(string)f(it)g
(is)f(vital)i(that)f(the)g(size)g(of)g(the)g(c)m(har)0
3622 y(arra)m(y)38 b(b)s(e)g(large)h(enough)e(to)i(hold)e(the)h(en)m
(tire)h(string)f(of)g(c)m(haracters,)k(otherwise)c(CFITSIO)e(will)i(o)m
(v)m(erwrite)0 3735 y(whatev)m(er)d(memory)e(lo)s(cations)i(follo)m(w)g
(the)f(c)m(har)h(arra)m(y)-8 b(,)35 b(p)s(ossibly)e(causing)h(the)g
(program)g(to)g(execute)h(incor-)0 3848 y(rectly)-8 b(.)42
b(This)30 b(t)m(yp)s(e)g(of)h(error)f(can)h(b)s(e)f(di\016cult)g(to)h
(debug,)f(so)h(programmers)f(should)f(alw)m(a)m(ys)j(ensure)e(that)h
(the)0 3961 y(c)m(har)c(arra)m(ys)g(are)g(allo)s(cated)i(enough)d
(space)i(to)f(hold)g(the)f(longest)i(p)s(ossible)f(string,)g
Fi(including)h Fj(the)f(terminat-)0 4074 y(ing)k(NULL)g(c)m(haracter.)
45 b(The)30 b(\014tsio.h)h(\014le)h(con)m(tains)g(the)f(follo)m(wing)i
(de\014ned)d(constan)m(ts)i(whic)m(h)f(programmers)0
4187 y(are)g(strongly)g(encouraged)g(to)g(use)f(whenev)m(er)g(they)h
(are)f(allo)s(cating)j(space)e(for)f(c)m(har)h(arra)m(ys:)0
4432 y Fe(#define)46 b(FLEN_FILENAME)e(1025)j(/*)g(max)g(length)f(of)h
(a)g(filename)f(*/)0 4545 y(#define)g(FLEN_KEYWORD)140
b(72)95 b(/*)47 b(max)g(length)f(of)h(a)g(keyword)94
b(*/)0 4658 y(#define)46 b(FLEN_CARD)284 b(81)95 b(/*)47
b(length)f(of)h(a)h(FITS)e(header)g(card)h(*/)0 4771
y(#define)f(FLEN_VALUE)236 b(71)95 b(/*)47 b(max)g(length)f(of)h(a)g
(keyword)f(value)h(string)f(*/)0 4884 y(#define)g(FLEN_COMMENT)140
b(73)95 b(/*)47 b(max)g(length)f(of)h(a)g(keyword)f(comment)g(string)g
(*/)0 4997 y(#define)g(FLEN_ERRMSG)188 b(81)95 b(/*)47
b(max)g(length)f(of)h(a)g(CFITSIO)f(error)h(message)e(*/)0
5110 y(#define)h(FLEN_STATUS)188 b(31)95 b(/*)47 b(max)g(length)f(of)h
(a)g(CFITSIO)f(status)g(text)h(string)f(*/)0 5355 y Fj(F)-8
b(or)23 b(example,)h(when)d(declaring)i(a)f(c)m(har)g(arra)m(y)h(to)f
(hold)g(the)g(v)-5 b(alue)22 b(string)g(of)g(FITS)f(k)m(eyw)m(ord,)k
(use)c(the)h(follo)m(wing)0 5468 y(statemen)m(t:)191
5714 y Fe(char)47 b(value[FLEN_VALUE];)p eop end
%%Page: 23 31
TeXDict begin 23 30 bop 0 299 a Fh(4.6.)72 b(IMPLICIT)29
b(D)m(A)-8 b(T)g(A)32 b(TYPE)e(CONVERSION)1938 b Fj(23)0
555 y(Note)41 b(that)f(FLEN)p 686 555 28 4 v 33 w(KEYW)m(ORD)g(is)f
(longer)h(than)f(needed)g(for)g(the)h(nominal)f(8-c)m(haracter)j(k)m
(eyw)m(ord)e(name)0 668 y(b)s(ecause)30 b(the)h(HIERAR)m(CH)f(con)m(v)m
(en)m(tion)j(supp)s(orts)28 b(longer)j(k)m(eyw)m(ord)g(names.)0
999 y Ff(4.6)135 b(Implicit)46 b(Data)g(T)l(yp)t(e)f(Con)l(v)l(ersion)0
1249 y Fj(The)29 b(CFITSIO)e(routines)i(that)h(read)f(and)f(write)i(n)m
(umerical)f(data)h(can)g(p)s(erform)d(implicit)j(data)g(t)m(yp)s(e)f
(con)m(v)m(er-)0 1362 y(sion.)39 b(This)25 b(means)h(that)g(the)g(data)
g(t)m(yp)s(e)g(of)g(the)g(v)-5 b(ariable)26 b(or)g(arra)m(y)g(in)f(the)
h(program)g(do)s(es)f(not)h(need)f(to)i(b)s(e)e(the)0
1475 y(same)g(as)f(the)h(data)g(t)m(yp)s(e)g(of)f(the)h(v)-5
b(alue)25 b(in)f(the)g(FITS)g(\014le.)39 b(Data)26 b(t)m(yp)s(e)f(con)m
(v)m(ersion)g(is)g(supp)s(orted)d(for)i(n)m(umerical)0
1588 y(and)37 b(string)g(data)g(t)m(yp)s(es)h(\(if)f(the)g(string)g
(con)m(tains)i(a)e(v)-5 b(alid)38 b(n)m(um)m(b)s(er)e(enclosed)h(in)g
(quotes\))h(when)e(reading)i(a)0 1701 y(FITS)30 b(header)h(k)m(eyw)m
(ord)g(v)-5 b(alue)31 b(and)f(for)h(n)m(umeric)g(v)-5
b(alues)31 b(when)f(reading)h(or)f(writing)h(v)-5 b(alues)31
b(in)g(the)g(primary)0 1814 y(arra)m(y)24 b(or)g(a)h(table)f(column.)39
b(CFITSIO)22 b(returns)h(status)h(=)f(NUM)p 2267 1814
V 34 w(O)m(VERFLO)m(W)i(if)e(the)h(con)m(v)m(erted)i(data)e(v)-5
b(alue)0 1927 y(exceeds)33 b(the)g(range)g(of)g(the)f(output)g(data)i
(t)m(yp)s(e.)47 b(Implicit)33 b(data)g(t)m(yp)s(e)g(con)m(v)m(ersion)h
(is)e(not)h(supp)s(orted)d(within)0 2039 y(binary)g(tables)h(for)f
(string,)g(logical,)k(complex,)d(or)f(double)g(complex)h(data)g(t)m(yp)
s(es.)0 2200 y(In)g(addition,)h(an)m(y)f(table)h(column)f(ma)m(y)h(b)s
(e)f(read)g(as)h(if)f(it)h(con)m(tained)g(string)f(v)-5
b(alues.)44 b(In)31 b(the)g(case)i(of)e(n)m(umeric)0
2313 y(columns)f(the)h(returned)e(string)h(will)h(b)s(e)f(formatted)h
(using)e(the)i(TDISPn)e(displa)m(y)i(format)f(if)h(it)g(exists.)0
2643 y Ff(4.7)135 b(Data)46 b(Scaling)0 2894 y Fj(When)38
b(reading)f(n)m(umerical)i(data)f(v)-5 b(alues)38 b(in)f(the)h(primary)
f(arra)m(y)h(or)g(a)g(table)h(column,)h(the)d(v)-5 b(alues)38
b(will)h(b)s(e)0 3006 y(scaled)f(automatically)j(b)m(y)c(the)g(BSCALE)g
(and)g(BZER)m(O)g(\(or)h(TSCALn)e(and)h(TZER)m(On\))f(header)h(v)-5
b(alues)38 b(if)0 3119 y(they)31 b(are)f(presen)m(t)h(in)f(the)g
(header.)41 b(The)30 b(scaled)h(data)g(that)g(is)f(returned)g(to)h(the)
f(reading)h(program)f(will)h(ha)m(v)m(e)382 3361 y Fe(output)46
b(value)g(=)i(\(FITS)e(value\))g(*)i(BSCALE)e(+)h(BZERO)0
3603 y Fj(\(a)30 b(corresp)s(onding)e(form)m(ula)h(using)g(TSCALn)e
(and)i(TZER)m(On)e(is)i(used)g(when)f(reading)h(from)g(table)h
(columns\).)0 3716 y(In)h(the)i(case)g(of)f(in)m(teger)h(output)f(v)-5
b(alues)32 b(the)h(\015oating)g(p)s(oin)m(t)f(scaled)g(v)-5
b(alue)33 b(is)f(truncated)g(to)h(an)f(in)m(teger)h(\(not)0
3828 y(rounded)i(to)j(the)f(nearest)h(in)m(teger\).)62
b(The)36 b(\014ts)p 1673 3828 V 32 w(set)p 1816 3828
V 34 w(bscale)i(and)e(\014ts)p 2430 3828 V 32 w(set)p
2573 3828 V 34 w(tscale)i(routines)f(\(describ)s(ed)f(in)h(the)0
3941 y(`Adv)-5 b(anced')29 b(c)m(hapter\))h(ma)m(y)g(b)s(e)e(used)h(to)
g(o)m(v)m(erride)i(the)e(scaling)h(parameters)f(de\014ned)f(in)h(the)g
(header)g(\(e.g.,)i(to)0 4054 y(turn)e(o\013)i(the)g(scaling)g(so)g
(that)g(the)f(program)g(can)h(read)f(the)h(ra)m(w)f(unscaled)h(v)-5
b(alues)30 b(from)g(the)h(FITS)e(\014le\).)0 4214 y(When)44
b(writing)h(n)m(umerical)g(data)g(to)g(the)g(primary)f(arra)m(y)h(or)f
(to)h(a)g(table)h(column)e(the)h(data)g(v)-5 b(alues)45
b(will)0 4327 y(generally)29 b(b)s(e)f(automatically)j(in)m(v)m(ersely)
f(scaled)f(b)m(y)f(the)g(v)-5 b(alue)29 b(of)f(the)h(BSCALE)e(and)h
(BZER)m(O)g(\(or)h(TSCALn)0 4440 y(and)35 b(TZER)m(On\))f(k)m(eyw)m
(ord)i(v)-5 b(alues)35 b(if)h(they)f(they)g(exist)i(in)e(the)g(header.)
55 b(These)35 b(k)m(eyw)m(ords)h(m)m(ust)f(ha)m(v)m(e)i(b)s(een)0
4553 y(written)31 b(to)h(the)g(header)f(b)s(efore)g(an)m(y)g(data)h(is)
g(written)f(for)g(them)g(to)h(ha)m(v)m(e)h(an)m(y)e(immediate)i
(e\013ect.)45 b(One)30 b(ma)m(y)0 4666 y(also)h(use)g(the)f(\014ts)p
623 4666 V 33 w(set)p 767 4666 V 33 w(bscale)i(and)d(\014ts)p
1367 4666 V 33 w(set)p 1511 4666 V 33 w(tscale)j(routines)f(to)g
(de\014ne)f(or)g(o)m(v)m(erride)i(the)f(scaling)g(k)m(eyw)m(ords)g(in)0
4779 y(the)e(header)g(\(e.g.,)i(to)e(turn)f(o\013)h(the)g(scaling)h(so)
f(that)h(the)f(program)f(can)h(write)g(the)g(ra)m(w)g(unscaled)g(v)-5
b(alues)29 b(in)m(to)0 4892 y(the)d(FITS)g(\014le\).)40
b(If)25 b(scaling)i(is)g(p)s(erformed,)e(the)i(in)m(v)m(erse)g(scaled)g
(output)e(v)-5 b(alue)27 b(that)g(is)f(written)g(in)m(to)h(the)g(FITS)0
5005 y(\014le)j(will)h(ha)m(v)m(e)430 5246 y Fe(FITS)46
b(value)h(=)g(\(\(input)f(value\))g(-)h(BZERO\))f(/)i(BSCALE)0
5488 y Fj(\(a)39 b(corresp)s(onding)d(form)m(ula)i(using)g(TSCALn)e
(and)h(TZER)m(On)g(is)h(used)f(when)f(writing)i(to)h(table)g
(columns\).)0 5601 y(Rounding)34 b(to)i(the)g(nearest)g(in)m(teger,)i
(rather)d(than)g(truncation,)j(is)d(p)s(erformed)f(when)g(writing)h(in)
m(teger)i(data)0 5714 y(t)m(yp)s(es)30 b(to)i(the)e(FITS)g(\014le.)p
eop end
%%Page: 24 32
TeXDict begin 24 31 bop 0 299 a Fj(24)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)0 555 y Ff(4.8)135
b(Supp)t(ort)44 b(for)h(IEEE)h(Sp)t(ecial)f(V)-11 b(alues)0
807 y Fj(The)26 b(ANSI/IEEE-754)h(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s
(er)d(standard)g(de\014nes)h(certain)h(sp)s(ecial)g(v)-5
b(alues)26 b(that)h(are)g(used)e(to)0 920 y(represen)m(t)j(suc)m(h)g
(quan)m(tities)h(as)f(Not-a-Num)m(b)s(er)h(\(NaN\),)h(denormalized,)f
(under\015o)m(w,)e(o)m(v)m(er\015o)m(w,)j(and)d(in\014nit)m(y)-8
b(.)0 1033 y(\(See)29 b(the)f(App)s(endix)e(in)i(the)g(NOST)g(FITS)f
(standard)g(or)h(the)g(NOST)g(FITS)f(User's)h(Guide)g(for)g(a)g(list)h
(of)f(these)0 1146 y(v)-5 b(alues\).)55 b(The)34 b(CFITSIO)f(routines)i
(that)g(read)g(\015oating)g(p)s(oin)m(t)g(data)h(in)e(FITS)g(\014les)h
(recognize)h(these)g(IEEE)0 1259 y(sp)s(ecial)k(v)-5
b(alues)39 b(and)g(b)m(y)g(default)g(in)m(terpret)h(the)f(o)m(v)m
(er\015o)m(w)i(and)d(in\014nit)m(y)h(v)-5 b(alues)40
b(as)f(b)s(eing)g(equiv)-5 b(alen)m(t)41 b(to)f(a)0 1372
y(NaN,)35 b(and)e(con)m(v)m(ert)i(the)f(under\015o)m(w)e(and)h
(denormalized)h(v)-5 b(alues)34 b(in)m(to)h(zeros.)51
b(In)33 b(some)h(cases)h(programmers)0 1485 y(ma)m(y)42
b(w)m(an)m(t)g(access)g(to)g(the)g(ra)m(w)f(IEEE)g(v)-5
b(alues,)44 b(without)d(an)m(y)h(mo)s(di\014cation)g(b)m(y)f(CFITSIO.)f
(This)g(can)i(b)s(e)0 1598 y(done)35 b(b)m(y)h(calling)h(the)e(\014ts)p
935 1598 28 4 v 33 w(read)p 1140 1598 V 32 w(img)h(or)g(\014ts)p
1593 1598 V 32 w(read)p 1797 1598 V 33 w(col)g(routines)g(while)f(sp)s
(ecifying)g(0.0)i(as)f(the)f(v)-5 b(alue)36 b(of)g(the)0
1711 y(NULL)-10 b(V)g(AL)37 b(parameter.)63 b(This)36
b(will)i(force)g(CFITSIO)e(to)i(simply)f(pass)g(the)g(IEEE)g(v)-5
b(alues)38 b(through)f(to)h(the)0 1824 y(application)24
b(program)f(without)g(an)m(y)h(mo)s(di\014cation.)38
b(This)23 b(is)g(not)g(fully)g(supp)s(orted)e(on)i(V)-10
b(AX/VMS)24 b(mac)m(hines,)0 1937 y(ho)m(w)m(ev)m(er,)k(where)c(there)h
(is)g(no)f(easy)i(w)m(a)m(y)g(to)f(b)m(ypass)g(the)g(default)g(in)m
(terpretation)h(of)f(the)g(IEEE)f(sp)s(ecial)h(v)-5 b(alues.)0
2049 y(This)27 b(is)i(also)g(not)f(supp)s(orted)e(when)i(reading)g
(\015oating-p)s(oin)m(t)h(images)g(that)g(ha)m(v)m(e)h(b)s(een)d
(compressed)h(with)g(the)0 2162 y(FITS)33 b(tiled)h(image)g
(compression)f(con)m(v)m(en)m(tion)j(that)e(is)f(discussed)g(in)g
(section)h(5.6;)i(the)e(pixels)f(v)-5 b(alues)34 b(in)f(tile)0
2275 y(compressed)d(images)i(are)f(represen)m(ted)g(b)m(y)g(scaled)g
(in)m(tegers,)h(and)e(a)i(reserv)m(ed)e(in)m(teger)j(v)-5
b(alue)31 b(\(not)g(a)g(NaN\))h(is)0 2388 y(used)e(to)h(represen)m(t)f
(unde\014ned)e(pixels.)0 2732 y Ff(4.9)135 b(Error)46
b(Status)f(V)-11 b(alues)45 b(and)g(the)g(Error)g(Message)h(Stac)l(k)0
2984 y Fj(Nearly)36 b(all)g(the)g(CFITSIO)e(routines)h(return)f(an)h
(error)g(status)h(v)-5 b(alue)35 b(in)g(2)h(w)m(a)m(ys:)51
b(as)36 b(the)f(v)-5 b(alue)36 b(of)g(the)f(last)0 3097
y(parameter)29 b(in)f(the)g(function)g(call,)j(and)d(as)g(the)h
(returned)e(v)-5 b(alue)29 b(of)f(the)h(function)f(itself.)41
b(This)27 b(pro)m(vides)i(some)0 3210 y(\015exibilit)m(y)37
b(in)e(the)h(w)m(a)m(y)h(programmers)e(can)h(test)h(if)f(an)f(error)h
(o)s(ccurred,)g(as)g(illustrated)h(in)e(the)h(follo)m(wing)i(2)0
3323 y(co)s(de)31 b(fragmen)m(ts:)191 3592 y Fe(if)47
b(\()h(fits_write_record\(fptr,)41 b(card,)46 b(&status\))g(\))430
3704 y(printf\(")f(Error)h(occurred)g(while)g(writing)g(keyword."\);)0
3930 y(or,)191 4156 y(fits_write_record\(fptr,)41 b(card,)47
b(&status\);)191 4269 y(if)g(\()h(status)e(\))430 4382
y(printf\(")f(Error)h(occurred)g(while)g(writing)g(keyword."\);)0
4650 y Fj(A)27 b(listing)h(of)g(all)g(the)f(CFITSIO)f(status)i(co)s(de)
f(v)-5 b(alues)28 b(is)f(giv)m(en)h(at)g(the)g(end)e(of)i(this)f(do)s
(cumen)m(t.)39 b(Programmers)0 4763 y(are)33 b(encouraged)g(to)g(use)f
(the)h(sym)m(b)s(olic)f(mnemonics)g(\(de\014ned)g(in)g(\014tsio.h\))h
(rather)f(than)g(the)h(actual)h(in)m(teger)0 4876 y(status)d(v)-5
b(alues)30 b(to)i(impro)m(v)m(e)f(the)f(readabilit)m(y)i(of)f(their)f
(co)s(de.)0 5036 y(The)i(CFITSIO)f(library)g(uses)h(an)g(`inherited)h
(status')g(con)m(v)m(en)m(tion)h(for)e(the)h(status)f(parameter)h(whic)
m(h)f(means)0 5149 y(that)37 b(if)f(a)h(routine)f(is)h(called)g(with)f
(a)h(p)s(ositiv)m(e)g(input)f(v)-5 b(alue)36 b(of)h(the)g(status)f
(parameter)h(as)g(input,)g(then)f(the)0 5262 y(routine)j(will)f(exit)i
(immediately)g(without)e(c)m(hanging)i(the)e(v)-5 b(alue)39
b(of)g(the)g(status)g(parameter.)65 b(Th)m(us,)40 b(if)f(one)0
5375 y(passes)24 b(the)h(status)g(v)-5 b(alue)25 b(returned)f(from)g
(eac)m(h)i(CFITSIO)d(routine)h(as)h(input)f(to)h(the)g(next)g(CFITSIO)e
(routine,)0 5488 y(then)28 b(whenev)m(er)g(an)g(error)g(is)h(detected)g
(all)h(further)d(CFITSIO)f(pro)s(cessing)i(will)h(cease.)42
b(This)27 b(con)m(v)m(en)m(tion)k(can)0 5601 y(simplify)h(the)h(error)f
(c)m(hec)m(king)j(in)d(application)i(programs)e(b)s(ecause)h(it)g(is)g
(not)g(necessary)g(to)g(c)m(hec)m(k)i(the)d(v)-5 b(alue)0
5714 y(of)30 b(the)g(status)h(parameter)f(after)h(ev)m(ery)g(single)f
(CFITSIO)f(routine)h(call.)42 b(If)30 b(a)g(program)g(con)m(tains)h(a)g
(sequence)p eop end
%%Page: 25 33
TeXDict begin 25 32 bop 0 299 a Fh(4.10.)73 b(V)-10 b(ARIABLE-LENGTH)31
b(ARRA)-8 b(YS)30 b(IN)g(BINAR)-8 b(Y)32 b(T)-8 b(ABLES)1327
b Fj(25)0 555 y(of)28 b(sev)m(eral)i(CFITSIO)d(calls,)j(one)e(can)h
(just)e(c)m(hec)m(k)j(the)f(status)f(v)-5 b(alue)29 b(after)g(the)f
(last)h(call.)41 b(Since)29 b(the)f(returned)0 668 y(status)33
b(v)-5 b(alues)33 b(are)g(generally)h(distinctiv)m(e,)h(it)f(should)d
(b)s(e)i(p)s(ossible)f(to)h(determine)g(whic)m(h)g(routine)g
(originally)0 781 y(returned)c(the)i(error)f(status.)0
941 y(CFITSIO)c(also)i(main)m(tains)h(an)e(in)m(ternal)h(stac)m(k)h(of)
f(error)f(messages)h(\(80-c)m(haracter)j(maxim)m(um)c(length\))h(whic)m
(h)0 1054 y(in)36 b(man)m(y)g(cases)h(pro)m(vide)f(a)g(more)g(detailed)
i(explanation)f(of)f(the)g(cause)h(of)f(the)g(error)g(than)f(is)h(pro)m
(vided)g(b)m(y)0 1167 y(the)k(error)e(status)i(n)m(um)m(b)s(er)e
(alone.)69 b(It)39 b(is)h(recommended)f(that)g(the)h(error)f(message)h
(stac)m(k)h(b)s(e)e(prin)m(ted)g(out)0 1280 y(whenev)m(er)g(a)g
(program)g(detects)h(a)f(CFITSIO)e(error.)66 b(The)38
b(function)h(\014ts)p 2653 1280 28 4 v 32 w(rep)s(ort)p
2931 1280 V 32 w(error)g(will)g(prin)m(t)g(out)g(the)0
1393 y(en)m(tire)31 b(error)e(message)h(stac)m(k,)i(or)d(alternativ)m
(ely)k(one)d(ma)m(y)g(call)h(\014ts)p 2376 1393 V 32
w(read)p 2580 1393 V 33 w(errmsg)e(to)h(get)h(the)f(error)f(messages)0
1506 y(one)i(at)g(a)g(time.)0 1879 y Ff(4.10)136 b(V)-11
b(ariable-Length)45 b(Arra)l(ys)g(in)g(Binary)g(T)-11
b(ables)0 2138 y Fj(CFITSIO)33 b(pro)m(vides)i(easy-to-use)h(supp)s
(ort)d(for)i(reading)g(and)f(writing)h(data)g(in)g(v)-5
b(ariable)35 b(length)g(\014elds)g(of)g(a)0 2251 y(binary)g(table.)56
b(The)35 b(v)-5 b(ariable)36 b(length)f(columns)g(ha)m(v)m(e)i(TF)m
(ORMn)e(k)m(eyw)m(ord)h(v)-5 b(alues)35 b(of)h(the)f(form)g
(`1Pt\(len\)')0 2363 y(where)25 b(`t')i(is)e(the)h(data)g(t)m(yp)s(e)g
(co)s(de)g(\(e.g.,)j(I,)c(J,)h(E,)f(D,)i(etc.\))40 b(and)25
b(`len')i(is)e(an)h(in)m(teger)h(sp)s(ecifying)e(the)h(maxim)m(um)0
2476 y(length)k(of)f(the)h(v)m(ector)h(in)e(the)h(table.)41
b(\(CFITSIO)28 b(also)j(supp)s(orts)c(the)j(exp)s(erimen)m(tal)g('Q')g
(datat)m(yp)s(e,)h(whic)m(h)e(is)0 2589 y(iden)m(tical)37
b(to)e(the)g('P')g(t)m(yp)s(e)g(except)h(that)g(is)f(supp)s(orts)e(is)h
(a)i(64-bit)g(address)e(space)h(and)f(hence)h(m)m(uc)m(h)g(larger)0
2702 y(data)28 b(structures\).)40 b(If)27 b(the)h(v)-5
b(alue)28 b(of)g(`len')g(is)f(not)h(sp)s(eci\014ed)f(when)g(the)g
(table)i(is)f(created)g(\(e.g.,)i(if)e(the)g(TF)m(ORM)0
2815 y(k)m(eyw)m(ord)d(v)-5 b(alue)26 b(is)f(simply)g(sp)s(eci\014ed)f
(as)h('1PE')h(instead)f(of)g('1PE\(400\))j(\),)e(then)f(CFITSIO)f(will)
h(automatically)0 2928 y(scan)34 b(the)g(table)h(when)e(it)h(is)g
(closed)h(to)f(determine)g(the)g(maxim)m(um)g(length)h(of)f(the)g(v)m
(ector)h(and)e(will)i(app)s(end)0 3041 y(this)30 b(v)-5
b(alue)31 b(to)g(the)g(TF)m(ORMn)f(v)-5 b(alue.)0 3201
y(The)29 b(same)h(routines)g(that)g(read)f(and)g(write)h(data)g(in)g
(an)f(ordinary)g(\014xed)g(length)h(binary)f(table)h(extension)h(are)0
3314 y(also)41 b(used)d(for)i(v)-5 b(ariable)40 b(length)g(\014elds,)h
(ho)m(w)m(ev)m(er,)j(the)c(routine)f(parameters)h(tak)m(e)h(on)f(a)g
(sligh)m(tly)g(di\013eren)m(t)0 3427 y(in)m(terpretation)32
b(as)e(describ)s(ed)g(b)s(elo)m(w.)0 3587 y(All)37 b(the)f(data)h(in)f
(a)h(v)-5 b(ariable)37 b(length)f(\014eld)g(is)g(written)h(in)m(to)g
(an)f(area)h(called)h(the)e(`heap')g(whic)m(h)g(follo)m(ws)i(the)0
3700 y(main)31 b(\014xed-length)h(FITS)e(binary)h(table.)44
b(The)31 b(size)h(of)f(the)h(heap,)f(in)g(b)m(ytes,)h(is)g(sp)s
(eci\014ed)e(b)m(y)h(the)h(PCOUNT)0 3813 y(k)m(eyw)m(ord)21
b(in)f(the)h(FITS)f(header.)37 b(When)20 b(creating)i(a)f(new)f(binary)
g(table,)j(the)e(initial)h(v)-5 b(alue)21 b(of)f(PCOUNT)g(should)0
3926 y(usually)27 b(b)s(e)h(set)g(to)g(zero.)41 b(CFITSIO)26
b(will)i(recompute)g(the)g(size)g(of)g(the)g(heap)g(as)g(the)g(data)g
(is)g(written)f(and)h(will)0 4039 y(automatically)g(up)s(date)c(the)i
(PCOUNT)e(k)m(eyw)m(ord)h(v)-5 b(alue)26 b(when)e(the)h(table)h(is)f
(closed.)40 b(When)25 b(writing)g(v)-5 b(ariable)0 4152
y(length)34 b(data)g(to)g(a)g(table,)i(CFITSIO)c(will)h(automatically)k
(extend)c(the)h(size)g(of)g(the)g(heap)f(area)h(if)g(necessary)-8
b(,)0 4264 y(so)31 b(that)g(an)m(y)f(follo)m(wing)i(HDUs)f(do)f(not)h
(get)h(o)m(v)m(erwritten.)0 4425 y(By)e(default)f(the)h(heap)f(data)i
(area)f(starts)g(immediately)h(after)f(the)f(last)i(ro)m(w)e(of)h(the)g
(\014xed-length)f(table.)42 b(This)0 4538 y(default)27
b(starting)g(lo)s(cation)i(ma)m(y)e(b)s(e)f(o)m(v)m(erridden)h(b)m(y)g
(the)g(THEAP)f(k)m(eyw)m(ord,)i(but)f(this)f(is)h(not)g(recommended.)0
4650 y(If)34 b(additional)h(ro)m(ws)f(of)g(data)h(are)g(added)e(to)i
(the)f(table,)j(CFITSIO)32 b(will)j(automatically)i(shift)c(the)i(the)f
(heap)0 4763 y(do)m(wn)g(to)i(mak)m(e)f(ro)s(om)g(for)f(the)h(new)f(ro)
m(ws,)i(but)e(it)i(is)e(ob)m(viously)i(b)s(e)e(more)h(e\016cien)m(t)h
(to)f(initially)h(create)h(the)0 4876 y(table)31 b(with)e(the)h
(necessary)g(n)m(um)m(b)s(er)f(of)h(blank)f(ro)m(ws,)h(so)g(that)g(the)
g(heap)g(do)s(es)f(not)h(needed)g(to)g(b)s(e)f(constan)m(tly)0
4989 y(mo)m(v)m(ed.)0 5149 y(When)36 b(writing)g(ro)m(w)g(of)h(data)f
(to)h(a)g(v)-5 b(ariable)37 b(length)f(\014eld)g(the)g(en)m(tire)i
(arra)m(y)e(of)g(v)-5 b(alues)37 b(for)f(a)g(giv)m(en)i(ro)m(w)e(of)0
5262 y(the)30 b(table)h(m)m(ust)e(b)s(e)h(written)g(with)f(a)h(single)h
(call)g(to)f(\014ts)p 1986 5262 V 33 w(write)p 2221 5262
V 33 w(col.)42 b(The)29 b(total)i(length)g(of)f(the)g(arra)m(y)g(is)g
(giv)m(en)0 5375 y(b)m(y)j(nelemen)m(ts)h(+)f(\014rstelem)g(-)g(1.)49
b(Additional)34 b(elemen)m(ts)h(cannot)e(b)s(e)g(app)s(ended)e(to)j(an)
f(existing)h(v)m(ector)h(at)f(a)0 5488 y(later)c(time)g(since)g(an)m(y)
g(attempt)g(to)g(do)g(so)f(will)h(simply)f(o)m(v)m(erwrite)i(all)f(the)
f(previously)h(written)f(data)h(and)f(the)0 5601 y(new)36
b(data)h(will)g(b)s(e)f(written)g(to)h(a)g(new)f(area)h(of)g(the)g
(heap.)58 b(The)36 b(\014ts)p 2496 5601 V 33 w(compress)p
2889 5601 V 32 w(heap)g(routine)h(is)f(pro)m(vided)0
5714 y(to)h(compress)g(the)g(heap)g(and)f(reco)m(v)m(er)i(an)m(y)f(un)m
(used)f(space.)60 b(T)-8 b(o)37 b(a)m(v)m(oid)i(ha)m(ving)e(to)h(deal)f
(with)f(this)h(issue,)h(it)p eop end
%%Page: 26 34
TeXDict begin 26 33 bop 0 299 a Fj(26)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)0 555 y Fj(is)f(recommended)h
(that)g(ro)m(ws)f(in)g(a)h(v)-5 b(ariable)32 b(length)g(\014eld)f
(should)f(only)i(b)s(e)f(written)g(once.)45 b(An)31 b(exception)h(to)0
668 y(this)e(general)h(rule)f(o)s(ccurs)g(when)f(setting)i(elemen)m(ts)
h(of)e(an)g(arra)m(y)g(as)h(unde\014ned.)38 b(It)30 b(is)h(allo)m(w)m
(ed)h(to)e(\014rst)g(write)0 781 y(a)e(dumm)m(y)f(v)-5
b(alue)28 b(in)m(to)h(the)f(arra)m(y)h(with)e(\014ts)p
1534 781 28 4 v 33 w(write)p 1769 781 V 33 w(col,)j(and)d(then)g(call)j
(\014ts)p 2632 781 V 32 w(write)p 2866 781 V 33 w(col)p
3009 781 V 34 w(n)m(ul)d(to)i(\015ag)f(the)g(desired)0
894 y(elemen)m(ts)h(as)f(unde\014ned.)38 b(Note)29 b(that)g(the)f(ro)m
(ws)g(of)g(a)g(table,)i(whether)d(\014xed)g(or)h(v)-5
b(ariable)29 b(length,)g(do)f(not)g(ha)m(v)m(e)0 1007
y(to)j(b)s(e)f(written)g(consecutiv)m(ely)j(and)d(ma)m(y)h(b)s(e)e
(written)i(in)f(an)m(y)h(order.)0 1167 y(When)40 b(writing)h(to)g(a)g
(v)-5 b(ariable)41 b(length)g(ASCI)s(I)e(c)m(haracter)j(\014eld)e
(\(e.g.,)45 b(TF)m(ORM)c(=)f('1P)-8 b(A'\))43 b(only)d(a)h(single)0
1280 y(c)m(haracter)22 b(string)e(can)h(b)s(e)e(written.)38
b(The)20 b(`\014rstelem')g(and)g(`nelemen)m(ts')i(parameter)e(v)-5
b(alues)21 b(in)f(the)g(\014ts)p 3526 1280 V 33 w(write)p
3761 1280 V 33 w(col)0 1393 y(routine)35 b(are)h(ignored)f(and)f(the)i
(n)m(um)m(b)s(er)d(of)j(c)m(haracters)g(to)g(write)f(is)h(simply)e
(determined)h(b)m(y)g(the)g(length)h(of)0 1506 y(the)31
b(input)e(n)m(ull-terminated)i(c)m(haracter)h(string.)0
1666 y(The)21 b(\014ts)p 305 1666 V 33 w(write)p 540
1666 V 33 w(descript)g(routine)h(is)f(useful)g(in)g(situations)i(where)
e(m)m(ultiple)h(ro)m(ws)g(of)g(a)g(v)-5 b(ariable)22
b(length)g(column)0 1779 y(ha)m(v)m(e)32 b(the)e(iden)m(tical)i(arra)m
(y)f(of)g(v)-5 b(alues.)41 b(One)30 b(can)g(simply)g(write)h(the)f
(arra)m(y)h(once)g(for)g(the)f(\014rst)g(ro)m(w,)g(and)g(then)0
1892 y(use)c(\014ts)p 280 1892 V 32 w(write)p 514 1892
V 33 w(descript)g(to)g(write)g(the)g(same)h(descriptor)e(v)-5
b(alues)27 b(in)m(to)g(the)f(other)g(ro)m(ws;)h(all)g(the)f(ro)m(ws)g
(will)g(then)0 2005 y(p)s(oin)m(t)k(to)h(the)g(same)g(storage)h(lo)s
(cation)g(th)m(us)e(sa)m(ving)h(disk)f(space.)0 2165
y(When)35 b(reading)g(from)f(a)i(v)-5 b(ariable)35 b(length)h(arra)m(y)
f(\014eld)g(one)g(can)g(only)h(read)e(as)i(man)m(y)f(elemen)m(ts)h(as)f
(actually)0 2278 y(exist)i(in)e(that)i(ro)m(w)e(of)h(the)g(table;)k
(reading)c(do)s(es)g(not)g(automatically)i(con)m(tin)m(ue)f(with)f(the)
g(next)g(ro)m(w)g(of)g(the)0 2391 y(table)29 b(as)f(o)s(ccurs)g(when)f
(reading)h(an)g(ordinary)g(\014xed)f(length)h(table)h(\014eld.)40
b(A)m(ttempts)29 b(to)g(read)f(more)g(than)g(this)0 2503
y(will)k(cause)h(an)e(error)h(status)g(to)g(b)s(e)f(returned.)44
b(One)32 b(can)g(determine)g(the)g(n)m(um)m(b)s(er)e(of)i(elemen)m(ts)h
(in)f(eac)m(h)h(ro)m(w)0 2616 y(of)e(a)f(v)-5 b(ariable)31
b(column)g(with)f(the)g(\014ts)p 1329 2616 V 33 w(read)p
1534 2616 V 32 w(descript)h(routine.)0 3218 y Ff(4.11)136
b(Multiple)45 b(Access)g(to)g(the)g(Same)h(FITS)d(File)0
3521 y Fj(CFITSIO)35 b(supp)s(orts)g(sim)m(ultaneous)i(read)f(and)g
(write)h(access)g(to)h(m)m(ultiple)f(HDUs)g(in)f(the)h(same)g(FITS)f
(\014le.)0 3634 y(Th)m(us,)26 b(one)f(can)h(op)s(en)f(the)h(same)f
(FITS)g(\014le)h(t)m(wice)h(within)d(a)i(single)g(program)g(and)e(mo)m
(v)m(e)j(to)g(2)e(di\013eren)m(t)h(HDUs)0 3747 y(in)d(the)h(\014le,)h
(and)e(then)g(read)h(and)f(write)h(data)g(or)f(k)m(eyw)m(ords)h(to)h
(the)e(2)h(extensions)g(just)f(as)h(if)g(one)f(w)m(ere)h(accessing)0
3860 y(2)k(completely)h(separate)g(FITS)e(\014les.)40
b(Since)27 b(in)h(general)g(it)g(is)g(not)g(p)s(ossible)f(to)i(ph)m
(ysically)f(op)s(en)f(the)h(same)g(\014le)0 3973 y(t)m(wice)e(and)e
(then)g(exp)s(ect)h(to)g(b)s(e)f(able)h(to)h(sim)m(ultaneously)f(\(or)g
(in)f(alternating)i(succession\))g(write)e(to)i(2)e(di\013eren)m(t)0
4086 y(lo)s(cations)35 b(in)f(the)g(\014le,)h(CFITSIO)d(recognizes)k
(when)d(the)h(\014le)f(to)i(b)s(e)e(op)s(ened)g(\(in)h(the)g(call)h(to)
g(\014ts)p 3499 4086 V 32 w(op)s(en)p 3721 4086 V 32
w(\014le\))0 4199 y(has)29 b(already)g(b)s(een)f(op)s(ened)g(and)h
(instead)g(of)g(actually)h(op)s(ening)e(the)i(\014le)e(again,)j(just)d
(logically)k(links)c(the)h(new)0 4312 y(\014le)e(to)h(the)f(old)h
(\014le.)39 b(\(This)27 b(of)g(course)h(do)s(es)e(not)i(prev)m(en)m(t)f
(the)h(same)f(\014le)g(from)g(b)s(eing)g(sim)m(ultaneously)h(op)s(ened)
0 4425 y(b)m(y)g(more)h(than)f(one)g(program\).)40 b(Then)28
b(b)s(efore)g(CFITSIO)e(reads)i(or)h(writes)f(to)h(either)g
(\(logical\))i(\014le,)e(it)g(mak)m(es)0 4538 y(sure)i(that)h(an)m(y)g
(mo)s(di\014cations)g(made)g(to)g(the)g(other)g(\014le)f(ha)m(v)m(e)i
(b)s(een)e(completely)i(\015ushed)d(from)h(the)h(in)m(ternal)0
4650 y(bu\013ers)f(to)h(the)h(\014le.)45 b(Th)m(us,)31
b(in)h(principle,)g(one)g(could)g(op)s(en)g(a)g(\014le)g(t)m(wice,)i
(in)e(one)g(case)h(p)s(oin)m(ting)f(to)h(the)f(\014rst)0
4763 y(extension)27 b(and)e(in)h(the)g(other)h(p)s(oin)m(ting)f(to)h
(the)f(2nd)f(extension)i(and)f(then)f(write)i(data)f(to)h(b)s(oth)f
(extensions,)h(in)0 4876 y(an)m(y)33 b(order,)f(without)h(danger)f(of)g
(corrupting)g(the)h(\014le.)46 b(There)32 b(ma)m(y)h(b)s(e)f(some)h
(e\016ciency)g(p)s(enalties)g(in)f(doing)0 4989 y(this)26
b(ho)m(w)m(ev)m(er,)j(since)e(CFITSIO)e(has)i(to)g(\015ush)e(all)i(the)
g(in)m(ternal)g(bu\013ers)f(related)h(to)h(one)e(\014le)h(b)s(efore)f
(switc)m(hing)0 5102 y(to)33 b(the)g(other,)h(so)f(it)h(w)m(ould)e
(still)i(b)s(e)e(pruden)m(t)f(to)j(minimize)f(the)g(n)m(um)m(b)s(er)e
(of)i(times)h(one)f(switc)m(hes)g(bac)m(k)h(and)0 5215
y(forth)c(b)s(et)m(w)m(een)h(doing)f(I/O)h(to)g(di\013eren)m(t)g(HDUs)g
(in)f(the)g(same)h(\014le.)0 5375 y(Some)f(restriction)h(apply:)40
b(a)30 b(FITS)f(\014le)h(cannot)g(b)s(e)f(op)s(ened)h(the)g(\014rst)f
(time)h(with)g(READONL)-8 b(Y)30 b(access,)i(and)0 5488
y(then)i(op)s(ened)g(a)h(second)g(time)g(with)g(READ)m(WRITE)g(access,)
i(b)s(ecause)e(this)f(ma)m(y)i(b)s(e)e(ph)m(yically)h(imp)s(ossible)0
5601 y(\(e.g.,)g(if)e(the)g(\014le)f(resides)h(on)f(read-only)h(media)g
(suc)m(h)g(as)g(a)g(CDR)m(OM\).)g(Also,)h(in)f(m)m(ulti-threaded)g(en)m
(virono-)0 5714 y(men)m(ts,)e(one)g(should)e(nev)m(er)i(op)s(en)e(the)i
(same)g(\014le)f(with)g(write)h(access)g(in)g(di\013eren)m(t)f
(threads.)p eop end
%%Page: 27 35
TeXDict begin 27 34 bop 0 299 a Fh(4.12.)73 b(WHEN)31
b(THE)f(FINAL)g(SIZE)f(OF)i(THE)f(FITS)f(HDU)i(IS)f(UNKNO)m(WN)978
b Fj(27)0 555 y Ff(4.12)136 b(When)44 b(the)h(Final)h(Size)f(of)g(the)g
(FITS)f(HDU)h(is)g(Unkno)l(wn)0 816 y Fj(It)27 b(is)h(not)f(required)f
(to)i(kno)m(w)f(the)h(total)h(size)f(of)f(a)h(FITS)e(data)i(arra)m(y)g
(or)f(table)h(b)s(efore)f(b)s(eginning)f(to)i(write)g(the)0
928 y(data)k(to)f(the)g(FITS)f(\014le.)43 b(In)30 b(the)h(case)h(of)f
(the)g(primary)f(arra)m(y)h(or)g(an)f(image)j(extension,)e(one)h
(should)d(initially)0 1041 y(create)i(the)e(arra)m(y)h(with)e(the)i
(size)g(of)f(the)g(highest)g(dimension)g(\(largest)i(NAXISn)d(k)m(eyw)m
(ord\))i(set)g(to)g(a)f(dumm)m(y)0 1154 y(v)-5 b(alue,)26
b(suc)m(h)e(as)g(1.)39 b(Then)23 b(after)i(all)g(the)g(data)f(ha)m(v)m
(e)i(b)s(een)d(written)h(and)g(the)g(true)g(dimensions)g(are)g(kno)m
(wn,)h(then)0 1267 y(the)33 b(NAXISn)f(v)-5 b(alue)33
b(should)f(b)s(e)g(up)s(dated)g(using)g(the)h(\014ts)p
2069 1267 28 4 v 33 w(up)s(date)p 2378 1267 V 32 w(k)m(ey)g(routine)g
(b)s(efore)g(mo)m(ving)g(to)h(another)0 1380 y(extension)d(or)f
(closing)i(the)e(FITS)g(\014le.)0 1540 y(When)f(writing)g(to)g(FITS)g
(tables,)h(CFITSIO)d(automatically)32 b(k)m(eeps)e(trac)m(k)g(of)f(the)
g(highest)h(ro)m(w)f(n)m(um)m(b)s(er)e(that)0 1653 y(is)32
b(written)g(to,)h(and)e(will)h(increase)h(the)f(size)h(of)f(the)g
(table)g(if)g(necessary)-8 b(.)46 b(CFITSIO)30 b(will)i(also)h
(automatically)0 1766 y(insert)j(space)h(in)f(the)g(FITS)f(\014le)i(if)
f(necessary)-8 b(,)39 b(to)e(ensure)e(that)i(the)f(data)h('heap',)h(if)
e(it)h(exists,)h(and/or)f(an)m(y)0 1879 y(additional)29
b(HDUs)g(that)g(follo)m(w)g(the)g(table)g(do)f(not)h(get)g(o)m(v)m
(erwritten)h(as)e(new)g(ro)m(ws)g(are)h(written)f(to)h(the)g(table.)0
2039 y(As)37 b(a)h(general)g(rule)f(it)h(is)f(b)s(est)g(to)h(sp)s
(ecify)f(the)h(initial)g(n)m(um)m(b)s(er)e(of)i(ro)m(ws)f(=)g(0)g(when)
g(the)g(table)h(is)g(created,)0 2152 y(then)g(let)h(CFITSIO)e(k)m(eep)i
(trac)m(k)g(of)g(the)f(n)m(um)m(b)s(er)f(of)i(ro)m(ws)f(that)h(are)f
(actually)i(written.)65 b(The)38 b(application)0 2265
y(program)e(should)f(not)i(man)m(ually)g(up)s(date)e(the)i(n)m(um)m(b)s
(er)e(of)h(ro)m(ws)g(in)g(the)h(table)g(\(as)g(giv)m(en)g(b)m(y)f(the)h
(NAXIS2)0 2378 y(k)m(eyw)m(ord\))j(since)f(CFITSIO)e(do)s(es)i(this)g
(automatically)-8 b(.)69 b(If)38 b(a)i(table)f(is)g(initially)i
(created)f(with)e(more)h(than)0 2491 y(zero)i(ro)m(ws,)j(then)c(this)h
(will)f(usually)h(b)s(e)f(considered)g(as)h(the)g(minim)m(um)f(size)h
(of)g(the)g(table,)j(ev)m(en)d(if)g(few)m(er)0 2604 y(ro)m(ws)30
b(are)g(actually)h(written)f(to)h(the)f(table.)41 b(Th)m(us,)30
b(if)f(a)i(table)f(is)g(initially)h(created)g(with)f(NAXIS2)g(=)g(20,)h
(and)0 2717 y(CFITSIO)g(only)i(writes)f(10)i(ro)m(ws)e(of)h(data)g(b)s
(efore)f(closing)i(the)f(table,)h(then)e(NAXIS2)h(will)g(remain)f
(equal)h(to)0 2829 y(20.)50 b(If)33 b(ho)m(w)m(ev)m(er,)i(30)g(ro)m(ws)
e(of)g(data)h(are)g(written)f(to)h(this)f(table,)i(then)e(NAXIS2)h
(will)f(b)s(e)g(increased)g(from)g(20)0 2942 y(to)f(30.)44
b(The)31 b(one)g(exception)i(to)f(this)f(automatic)i(up)s(dating)d(of)h
(the)h(NAXIS2)f(k)m(eyw)m(ord)h(is)f(if)g(the)h(application)0
3055 y(program)c(directly)g(mo)s(di\014es)f(the)i(v)-5
b(alue)28 b(of)g(NAXIS2)g(\(up)f(or)h(do)m(wn\))g(itself)h(just)e(b)s
(efore)h(closing)h(the)f(table.)41 b(In)0 3168 y(this)28
b(case,)i(CFITSIO)d(do)s(es)h(not)h(up)s(date)e(NAXIS2)i(again,)h
(since)f(it)g(assumes)f(that)h(the)f(application)i(program)0
3281 y(m)m(ust)i(ha)m(v)m(e)h(had)f(a)g(go)s(o)s(d)g(reason)h(for)f(c)m
(hanging)h(the)f(v)-5 b(alue)33 b(directly)-8 b(.)47
b(This)31 b(is)h(not)h(recommended,)f(ho)m(w)m(ev)m(er,)0
3394 y(and)j(is)h(only)g(pro)m(vided)g(for)f(bac)m(kw)m(ard)h
(compatibilit)m(y)i(with)e(soft)m(w)m(are)h(that)g(initially)g(creates)
g(a)f(table)h(with)0 3507 y(a)d(large)h(n)m(um)m(b)s(er)e(of)h(ro)m
(ws,)h(than)f(decreases)g(the)h(NAXIS2)f(v)-5 b(alue)34
b(to)h(the)f(actual)h(smaller)g(v)-5 b(alue)34 b(just)f(b)s(efore)0
3620 y(closing)e(the)g(table.)0 4004 y Ff(4.13)136 b(CFITSIO)44
b(Size)h(Limitations)0 4264 y Fj(CFITSIO)29 b(places)j(v)m(ery)f(few)g
(restrictions)g(on)g(the)g(size)g(of)g(FITS)f(\014les)h(that)g(it)h
(reads)e(or)h(writes.)42 b(There)30 b(are)i(a)0 4377
y(few)e(limits,)h(ho)m(w)m(ev)m(er,)h(that)f(ma)m(y)g(a\013ect)h(some)f
(extreme)g(cases:)0 4538 y(1.)43 b(The)31 b(maxim)m(um)g(n)m(um)m(b)s
(er)f(of)h(FITS)f(\014les)h(that)h(ma)m(y)g(b)s(e)e(sim)m(ultaneously)i
(op)s(ened)f(b)m(y)g(CFITSIO)e(is)i(set)h(b)m(y)0 4650
y(NMAXFILES)i(as)g(de\014ned)f(in)h(\014tsio2.h.)52 b(It)34
b(is)g(curren)m(tly)g(set)h(=)f(300)h(b)m(y)f(default.)52
b(CFITSIO)32 b(will)i(allo)s(cate)0 4763 y(ab)s(out)f(80)g(*)h
(NMAXFILES)f(b)m(ytes)g(of)g(memory)g(for)g(in)m(ternal)g(use.)48
b(Note)34 b(that)g(the)f(underlying)f(C)g(compiler)0
4876 y(or)39 b(op)s(erating)h(system,)j(ma)m(y)d(ha)m(v)m(e)g(a)g
(smaller)g(limit)h(on)e(the)h(n)m(um)m(b)s(er)e(of)i(op)s(ened)e
(\014les.)68 b(The)39 b(C)h(sym)m(b)s(olic)0 4989 y(constan)m(t)31
b(F)m(OPEN)p 690 4989 V 34 w(MAX)f(is)g(in)m(tended)g(to)h(de\014ne)e
(the)i(maxim)m(um)f(n)m(um)m(b)s(er)e(of)j(\014les)f(that)g(ma)m(y)h
(op)s(en)e(at)i(once)0 5102 y(\(including)g(an)m(y)g(other)g(text)h(or)
f(binary)f(\014les)h(that)h(ma)m(y)f(b)s(e)g(op)s(en,)f(not)h(just)g
(FITS)f(\014les\).)43 b(On)30 b(some)h(systems)0 5215
y(it)g(has)f(b)s(een)g(found)f(that)i(gcc)g(supp)s(orts)e(a)h(maxim)m
(um)h(of)f(255)i(op)s(ened)e(\014les.)0 5375 y(2.)67
b(It)40 b(used)e(to)i(b)s(e)e(common)i(for)f(computer)g(systems)g(to)h
(only)f(supp)s(ort)f(disk)g(\014les)h(up)f(to)i(2**31)i(b)m(ytes)d(=)0
5488 y(2.1)k(GB)g(in)f(size,)47 b(but)41 b(most)i(systems)f(no)m(w)g
(supp)s(ort)f(larger)i(\014les.)76 b(CFITSIO)41 b(can)i(optionally)g
(read)g(and)0 5601 y(write)37 b(these)h(so-called)h('large)f(\014les')g
(that)f(are)h(greater)g(than)f(2.1)h(GB)g(on)f(platforms)g(where)g
(they)g(are)h(sup-)0 5714 y(p)s(orted,)43 b(but)d(this)g(usually)h
(requires)f(that)i(sp)s(ecial)f(compiler)g(option)g(\015ags)g(b)s(e)f
(sp)s(eci\014ed)g(to)i(turn)d(on)i(this)p eop end
%%Page: 28 36
TeXDict begin 28 35 bop 0 299 a Fj(28)1763 b Fh(CHAPTER)29
b(4.)112 b(PR)m(OGRAMMING)32 b(GUIDELINES)0 555 y Fj(option.)69
b(On)39 b(lin)m(ux)h(and)f(solaris)i(systems)f(the)g(compiler)g
(\015ags)g(are)g('-D)p 2617 555 28 4 v 34 w(LAR)m(GEFILE)p
3184 555 V 33 w(SOUR)m(CE')f(and)g(`-)0 668 y(D)p 74
668 V 33 w(FILE)p 318 668 V 33 w(OFFSET)p 719 668 V 32
w(BITS=64'.)i(These)29 b(\015ags)h(ma)m(y)g(also)h(w)m(ork)f(on)g
(other)g(platforms)f(but)g(this)h(has)g(not)g(b)s(een)0
781 y(tested.)43 b(Starting)31 b(with)f(v)m(ersion)h(3.0)h(of)f
(CFITSIO,)f(the)h(default)f(Mak)m(e\014le)j(that)e(is)g(distributed)f
(with)g(CFIT-)0 894 y(SIO)h(will)h(include)g(these)g(2)g(compiler)h
(\015ags)f(when)e(building)h(on)h(Solaris)g(and)g(Lin)m(ux)f(PC)g
(systems.)45 b(Users)32 b(on)0 1007 y(other)g(platforms)g(will)g(need)f
(to)i(add)e(these)h(compiler)h(\015ags)f(man)m(ually)g(if)g(they)g(w)m
(an)m(t)g(to)h(supp)s(ort)d(large)j(\014les.)0 1120 y(In)j(most)i
(cases)g(it)g(app)s(ears)e(that)i(it)g(is)f(not)h(necessary)f(to)h
(include)f(these)h(compiler)g(\015ags)f(when)f(compiling)0
1233 y(application)c(co)s(de)e(that)h(call)h(the)e(CFITSIO)f(library)h
(routines.)0 1393 y(When)i(CFITSIO)e(is)i(built)g(with)g(large)h
(\014le)f(supp)s(ort)e(\(e.g.,)35 b(on)d(Solaris)g(and)f(Lin)m(ux)h(PC)
f(system)h(b)m(y)g(default\))0 1506 y(then)e(it)h(can)g(read)f(and)g
(write)g(FITS)g(data)h(\014les)f(on)h(disk)e(that)i(ha)m(v)m(e)h(an)m
(y)f(of)f(these)h(conditions:)136 1766 y Fc(\017)46 b
Fj(FITS)30 b(\014les)g(larger)h(than)f(2.1)i(GB)f(in)f(size)136
1953 y Fc(\017)46 b Fj(FITS)30 b(images)h(con)m(taining)h(greater)g
(than)e(2.1)h(G)g(pixels)136 2141 y Fc(\017)46 b Fj(FITS)34
b(images)i(that)g(ha)m(v)m(e)g(one)f(dimension)f(with)g(more)h(than)g
(2.1)h(G)f(pixels)g(\(as)g(giv)m(en)h(b)m(y)f(one)g(of)g(the)227
2254 y(NAXISn)30 b(k)m(eyw)m(ord\))136 2441 y Fc(\017)46
b Fj(FITS)26 b(tables)h(con)m(taining)g(more)g(than)f(2.1E09)i(ro)m(ws)
e(\(giv)m(en)i(b)m(y)e(the)g(NAXIS2)h(k)m(eyw)m(ord\),)h(or)e(with)g
(ro)m(ws)227 2554 y(that)31 b(are)g(more)g(than)f(2.1)h(GB)g(wide)f
(\(giv)m(en)i(b)m(y)e(the)h(NAXIS1)f(k)m(eyw)m(ord\))136
2742 y Fc(\017)46 b Fj(FITS)36 b(binary)f(tables)i(with)f(a)h(v)-5
b(ariable-length)38 b(arra)m(y)f(heap)f(that)h(is)f(larger)h(than)f
(2.1)h(GB)g(\(giv)m(en)h(b)m(y)227 2855 y(the)31 b(PCOUNT)e(k)m(eyw)m
(ord\))0 3115 y(The)c(curren)m(t)g(maxim)m(um)g(FITS)f(\014le)h(size)h
(supp)s(orted)e(b)m(y)h(CFITSIO)e(is)j(ab)s(out)f(6)g(terab)m(ytes)i
(\(con)m(taining)g(2**31)0 3227 y(FITS)d(blo)s(c)m(ks,)i(eac)m(h)g
(2880)h(b)m(ytes)e(in)f(size\).)40 b(Curren)m(tly)-8
b(,)26 b(supp)s(ort)d(for)i(large)g(\014les)g(in)g(CFITSIO)e(has)h(b)s
(een)g(tested)0 3340 y(on)30 b(the)h(Lin)m(ux,)f(Solaris,)h(and)f(IBM)g
(AIX)h(op)s(erating)g(systems.)0 3501 y(Note)26 b(that)f(when)e
(writing)h(application)i(programs)e(that)h(are)f(in)m(tended)g(to)h
(supp)s(ort)e(large)i(\014les)g(it)f(is)h(imp)s(ortan)m(t)0
3613 y(to)31 b(use)g(64-bit)g(in)m(teger)h(v)-5 b(ariables)31
b(to)h(store)f(quan)m(tities)h(suc)m(h)e(as)h(the)f(dimensions)g(of)h
(images,)h(or)f(the)f(n)m(um)m(b)s(er)0 3726 y(of)38
b(ro)m(ws)f(in)h(a)g(table.)63 b(These)38 b(programs)f(m)m(ust)g(also)i
(call)g(the)f(sp)s(ecial)g(v)m(ersions)g(of)g(some)g(of)g(the)f
(CFITSIO)0 3839 y(routines)28 b(that)h(ha)m(v)m(e)h(b)s(een)d(adapted)i
(to)g(supp)s(ort)e(64-bit)i(in)m(tegers.)42 b(The)27
b(names)i(of)f(these)h(routines)f(end)g(in)g('ll')0 3952
y(\('el')k('el'\))g(to)f(distinguish)e(them)i(from)f(the)g(32-bit)i(in)
m(teger)g(v)m(ersion)e(\(e.g.,)j(\014ts)p 2766 3952 V
32 w(get)p 2918 3952 V 34 w(n)m(um)p 3127 3952 V 32 w(ro)m(wsll\).)p
eop end
%%Page: 29 37
TeXDict begin 29 36 bop 0 1225 a Fg(Chapter)65 b(5)0
1687 y Fm(Basic)77 b(CFITSIO)f(In)-6 b(terface)77 b(Routines)0
2180 y Fj(This)30 b(c)m(hapter)i(describ)s(es)e(the)i(basic)f(routines)
g(in)g(the)g(CFITSIO)e(user)i(in)m(terface)h(that)g(pro)m(vide)f(all)h
(the)g(func-)0 2293 y(tions)j(normally)g(needed)g(to)g(read)g(and)f
(write)h(most)h(FITS)e(\014les.)54 b(It)35 b(is)g(recommended)f(that)i
(these)f(routines)0 2406 y(b)s(e)d(used)g(for)g(most)h(applications)h
(and)e(that)h(the)f(more)h(adv)-5 b(anced)33 b(routines)f(describ)s(ed)
g(in)g(the)h(next)f(c)m(hapter)0 2518 y(only)e(b)s(e)g(used)g(in)g(sp)s
(ecial)h(circumstances)g(when)e(necessary)-8 b(.)0 2679
y(The)30 b(follo)m(wing)i(con)m(v)m(en)m(tions)g(are)f(used)e(in)i
(this)f(c)m(hapter)h(in)f(the)g(description)h(of)f(eac)m(h)i(function:)
0 2839 y(1.)39 b(Most)25 b(functions)e(ha)m(v)m(e)i(2)f(names:)37
b(a)24 b(long)h(descriptiv)m(e)f(name)g(and)f(a)i(short)e(concise)i
(name.)38 b(Both)25 b(names)f(are)0 2952 y(listed)g(on)f(the)g(\014rst)
f(line)i(of)f(the)h(follo)m(wing)g(descriptions,)h(separated)e(b)m(y)h
(a)f(slash)g(\(/\))h(c)m(haracter.)40 b(Programmers)0
3065 y(ma)m(y)27 b(use)g(either)g(name)g(in)f(their)h(programs)g(but)f
(the)h(long)g(names)g(are)g(recommended)f(to)i(help)e(do)s(cumen)m(t)h
(the)0 3177 y(co)s(de)k(and)e(mak)m(e)j(it)f(easier)g(to)g(read.)0
3338 y(2.)42 b(A)30 b(righ)m(t)h(arro)m(w)g(sym)m(b)s(ol)f(\()p
Fb(>)p Fj(\))h(is)g(used)f(in)g(the)h(function)f(descriptions)g(to)i
(separate)f(the)g(input)f(parameters)0 3451 y(from)j(the)g(output)f
(parameters)i(in)f(the)g(de\014nition)g(of)g(eac)m(h)h(routine.)49
b(This)32 b(sym)m(b)s(ol)h(is)g(not)g(actually)i(part)e(of)0
3563 y(the)e(C)f(calling)h(sequence.)0 3724 y(3.)41 b(The)30
b(function)g(parameters)h(are)g(de\014ned)e(in)h(more)g(detail)i(in)e
(the)g(alphab)s(etical)i(listing)f(in)f(App)s(endix)f(B.)0
3884 y(4.)39 b(The)23 b(\014rst)g(argumen)m(t)g(in)h(almost)g(all)h
(the)e(functions)g(is)h(a)g(p)s(oin)m(ter)f(to)h(a)g(structure)f(of)h
(t)m(yp)s(e)g(`\014ts\014le'.)38 b(Memory)0 3997 y(for)26
b(this)g(structure)f(is)h(allo)s(cated)i(b)m(y)e(CFITSIO)e(when)h(the)h
(FITS)g(\014le)g(is)g(\014rst)f(op)s(ened)g(or)h(created)h(and)e(is)h
(freed)0 4110 y(when)j(the)i(FITS)f(\014le)g(is)g(closed.)0
4270 y(5.)53 b(The)34 b(last)h(argumen)m(t)f(in)g(almost)i(all)f(the)f
(functions)g(is)g(the)h(error)f(status)g(parameter.)53
b(It)35 b(m)m(ust)f(b)s(e)f(equal)0 4383 y(to)k(0)g(on)f(input,)h
(otherwise)g(the)f(function)g(will)h(immediately)g(exit)g(without)g
(doing)f(an)m(ything.)59 b(A)36 b(non-zero)0 4496 y(output)27
b(v)-5 b(alue)27 b(indicates)i(that)e(an)g(error)g(o)s(ccurred)g(in)g
(the)g(function.)39 b(In)27 b(most)g(cases)h(the)g(status)f(v)-5
b(alue)28 b(is)f(also)0 4608 y(returned)i(as)i(the)f(v)-5
b(alue)31 b(of)g(the)f(function)g(itself.)0 4935 y Ff(5.1)135
b(CFITSIO)44 b(Error)h(Status)h(Routines)0 5168 y Fi(1)81
b Fj(Return)27 b(a)j(descriptiv)m(e)f(text)h(string)e(\(30)i(c)m(har)f
(max.\))41 b(corresp)s(onding)28 b(to)h(a)g(CFITSIO)e(error)h(status)h
(co)s(de.)95 5385 y Fe(void)47 b(fits_get_errstatus)c(/)k(ffgerr)f
(\(int)h(status,)f(>)h(char)g(*err_text\))0 5601 y Fi(2)81
b Fj(Return)35 b(the)h(top)g(\(oldest\))h(80-c)m(haracter)i(error)c
(message)i(from)e(the)h(in)m(ternal)h(CFITSIO)d(stac)m(k)j(of)f(error)
227 5714 y(messages)45 b(and)e(shift)h(an)m(y)g(remaining)g(messages)h
(on)f(the)g(stac)m(k)h(up)e(one)h(lev)m(el.)83 b(Call)44
b(this)g(routine)1905 5942 y(29)p eop end
%%Page: 30 38
TeXDict begin 30 37 bop 0 299 a Fj(30)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(rep)s(eatedly)c(to)h(get)g(eac)m(h)g
(message)f(in)g(sequence.)39 b(The)26 b(function)f(returns)g(a)h(v)-5
b(alue)26 b(=)f(0)h(and)g(a)g(n)m(ull)f(error)227 668
y(message)32 b(when)d(the)i(error)f(stac)m(k)i(is)e(empt)m(y)-8
b(.)95 923 y Fe(int)47 b(fits_read_errmsg)d(/)j(ffgmsg)f(\(char)h
(*err_msg\))0 1178 y Fi(3)81 b Fj(Prin)m(t)30 b(out)h(the)g(error)f
(message)i(corresp)s(onding)e(to)h(the)g(input)f(status)h(v)-5
b(alue)31 b(and)f(all)i(the)f(error)f(messages)227 1291
y(on)d(the)h(CFITSIO)e(stac)m(k)j(to)f(the)f(sp)s(eci\014ed)g(\014le)g
(stream)h(\(normally)g(to)g(stdout)f(or)g(stderr\).)40
b(If)26 b(the)i(input)227 1404 y(status)j(v)-5 b(alue)31
b(=)f(0)h(then)f(this)g(routine)g(do)s(es)g(nothing.)95
1659 y Fe(void)47 b(fits_report_error)c(/)48 b(ffrprt)e(\(FILE)g
(*stream,)g(status\))0 1914 y Fi(4)81 b Fj(The)44 b(\014ts)p
461 1914 28 4 v 32 w(write)p 695 1914 V 33 w(errmark)g(routine)h(puts)f
(an)h(in)m(visible)g(mark)m(er)g(on)g(the)g(CFITSIO)e(error)h(stac)m
(k.)85 b(The)227 2027 y(\014ts)p 354 2027 V 33 w(clear)p
573 2027 V 34 w(errmark)31 b(routine)i(can)g(then)f(b)s(e)f(used)h(to)h
(delete)h(an)m(y)f(more)f(recen)m(t)i(error)e(messages)h(on)g(the)227
2140 y(stac)m(k,)42 b(bac)m(k)c(to)g(the)g(p)s(osition)g(of)g(the)g
(mark)m(er.)63 b(This)37 b(preserv)m(es)g(an)m(y)h(older)g(error)f
(messages)i(on)f(the)227 2253 y(stac)m(k.)77 b(The)41
b(\014ts)p 855 2253 V 32 w(clear)p 1073 2253 V 34 w(errmsg)g(routine)h
(simply)f(clears)i(all)g(the)f(messages)g(\(and)g(marks\))f(from)h(the)
227 2365 y(stac)m(k.)g(These)31 b(routines)f(are)h(called)g(without)g
(an)m(y)f(argumen)m(ts.)95 2620 y Fe(void)47 b(fits_write_errmark)c(/)k
(ffpmrk)f(\(void\))95 2733 y(void)h(fits_clear_errmark)c(/)k(ffcmrk)f
(\(void\))95 2846 y(void)h(fits_clear_errmsg)c(/)48 b(ffcmsg)e
(\(void\))0 3179 y Ff(5.2)135 b(FITS)44 b(File)i(Access)e(Routines)0
3419 y Fi(1)81 b Fj(Op)s(en)29 b(an)h(existing)h(data)g(\014le.)227
3663 y Fe(int)47 b(fits_open_file)d(/)k(ffopen)418 3776
y(\(fitsfile)d(**fptr,)h(char)h(*filename,)e(int)i(iomode,)f(>)h(int)g
(*status\))227 4002 y(int)g(fits_open_diskfile)c(/)k(ffdkopen)418
4115 y(\(fitsfile)e(**fptr,)h(char)h(*filename,)e(int)i(iomode,)f(>)h
(int)g(*status\))227 4340 y(int)g(fits_open_data)d(/)k(ffdopn)418
4453 y(\(fitsfile)d(**fptr,)h(char)h(*filename,)e(int)i(iomode,)f(>)h
(int)g(*status\))227 4679 y(int)g(fits_open_table)d(/)j(fftopn)418
4792 y(\(fitsfile)e(**fptr,)h(char)h(*filename,)e(int)i(iomode,)f(>)h
(int)g(*status\))227 5018 y(int)g(fits_open_image)d(/)j(ffiopn)418
5131 y(\(fitsfile)e(**fptr,)h(char)h(*filename,)e(int)i(iomode,)f(>)h
(int)g(*status\))227 5375 y Fj(The)41 b(iomo)s(de)h(parameter)g
(determines)g(the)f(read/write)h(access)h(allo)m(w)m(ed)h(in)d(the)g
(\014le)h(and)f(can)h(ha)m(v)m(e)227 5488 y(v)-5 b(alues)32
b(of)g(READONL)-8 b(Y)32 b(\(0\))g(or)g(READ)m(WRITE)g(\(1\).)44
b(The)31 b(\014lename)h(parameter)g(giv)m(es)h(the)e(name)h(of)227
5601 y(the)f(\014le)g(to)g(b)s(e)f(op)s(ened,)h(follo)m(w)m(ed)h(b)m(y)
f(an)f(optional)i(argumen)m(t)f(giving)h(the)f(name)f(or)h(index)f(n)m
(um)m(b)s(er)g(of)227 5714 y(the)d(extension)g(within)g(the)f(FITS)g
(\014le)h(that)g(should)f(b)s(e)g(mo)m(v)m(ed)i(to)f(and)f(op)s(ened)g
(\(e.g.,)k Fe(myfile.fits+3)p eop end
%%Page: 31 39
TeXDict begin 31 38 bop 0 299 a Fh(5.2.)72 b(FITS)30
b(FILE)g(A)m(CCESS)f(R)m(OUTINES)2244 b Fj(31)227 555
y(or)36 b Fe(myfile.fits[3])d Fj(mo)m(v)m(es)k(to)g(the)g(3rd)f
(extension)g(within)g(the)h(\014le,)h(and)d Fe(myfile.fits[events])227
668 y Fj(mo)m(v)m(es)d(to)f(the)g(extension)g(with)f(the)g(k)m(eyw)m
(ord)h(EXTNAME)g(=)f('EVENTS'\).)227 816 y(The)37 b(\014ts)p
548 816 28 4 v 32 w(op)s(en)p 770 816 V 32 w(disk\014le)g(routine)g(is)
g(similar)g(to)h(the)f(\014ts)p 2241 816 V 33 w(op)s(en)p
2464 816 V 32 w(\014le)g(routine)g(except)h(that)f(it)h(do)s(es)f(not)
227 929 y(supp)s(ort)22 b(the)h(extended)h(\014lename)f(syn)m(tax)h(in)
f(the)h(input)e(\014le)i(name.)38 b(This)23 b(routine)g(simply)g(tries)
h(to)g(op)s(en)227 1042 y(the)36 b(sp)s(eci\014ed)e(input)h(\014le)g
(on)g(magnetic)i(disk.)55 b(This)34 b(routine)h(is)h(mainly)f(for)g
(use)g(in)g(cases)h(where)f(the)227 1155 y(\014lename)f(\(or)h
(directory)f(path\))g(con)m(tains)h(square)f(or)g(curly)f(brac)m(k)m
(et)j(c)m(haracters)f(that)f(w)m(ould)g(confuse)227 1268
y(the)d(extended)f(\014lename)h(parser.)227 1416 y(The)i(\014ts)p
544 1416 V 32 w(op)s(en)p 766 1416 V 32 w(data)h(routine)e(is)h
(similar)g(to)h(the)f(\014ts)p 2113 1416 V 32 w(op)s(en)p
2335 1416 V 33 w(\014le)f(routine)h(except)h(that)f(it)h(will)f(mo)m(v)
m(e)h(to)227 1529 y(the)23 b(\014rst)f(HDU)h(con)m(taining)h
(signi\014can)m(t)f(data,)i(if)e(a)g(HDU)g(name)f(or)h(n)m(um)m(b)s(er)
e(to)i(op)s(en)f(w)m(as)h(not)f(explicitly)227 1642 y(sp)s(eci\014ed)37
b(as)g(part)h(of)f(the)h(\014lename.)61 b(In)37 b(this)g(case,)j(it)e
(will)g(lo)s(ok)g(for)f(the)g(\014rst)g(IMA)m(GE)h(HDU)g(with)227
1755 y(NAXIS)29 b(greater)h(than)e(0,)i(or)f(the)f(\014rst)g(table)i
(that)f(do)s(es)g(not)g(con)m(tain)h(the)f(strings)f(`GTI')h(\(Go)s(o)s
(d)g(Time)227 1868 y(In)m(terv)-5 b(al)31 b(extension\))h(or)e(`OBST)-8
b(ABLE')31 b(in)f(the)h(EXTNAME)f(k)m(eyw)m(ord)h(v)-5
b(alue.)227 2016 y(The)25 b(\014ts)p 536 2016 V 32 w(op)s(en)p
758 2016 V 32 w(table)h(and)e(\014ts)p 1305 2016 V 33
w(op)s(en)p 1528 2016 V 32 w(image)i(routines)f(are)g(similar)h(to)f
(\014ts)p 2828 2016 V 33 w(op)s(en)p 3051 2016 V 32 w(data)h(except)f
(they)h(will)227 2129 y(mo)m(v)m(e)h(to)g(the)f(\014rst)f(signi\014can)
m(t)h(table)h(HDU)f(or)g(image)h(HDU)f(in)f(the)h(\014le,)h(resp)s
(ectiv)m(ely)-8 b(,)29 b(if)c(a)h(HDU)h(name)227 2242
y(or)k(n)m(um)m(b)s(er)e(is)h(not)h(sp)s(eci\014ed)e(as)i(part)f(of)h
(the)f(\014lename.)227 2390 y(IRAF)c(images)g(\(.imh)g(format)g
(\014les\))f(and)g(ra)m(w)h(binary)e(data)j(arra)m(ys)e(ma)m(y)h(also)h
(b)s(e)e(op)s(ened)f(with)h(READ-)227 2503 y(ONL)-8 b(Y)37
b(access.)60 b(CFITSIO)35 b(will)i(automatically)i(test)f(if)e(the)h
(input)e(\014le)i(is)f(an)h(IRAF)f(image,)k(and)c(if,)227
2616 y(so)c(will)g(con)m(v)m(ert)h(it)f(on)f(the)h(\015y)f(in)m(to)i(a)
f(virtual)f(FITS)g(image)i(b)s(efore)e(it)h(is)g(op)s(ened)e(b)m(y)i
(the)g(application)227 2729 y(program.)64 b(If)37 b(the)h(input)g
(\014le)g(is)g(a)g(ra)m(w)g(binary)g(data)g(arra)m(y)h(of)f(n)m(um)m(b)
s(ers,)h(then)e(the)i(data)f(t)m(yp)s(e)h(and)227 2842
y(dimensions)d(of)g(the)g(arra)m(y)h(m)m(ust)f(b)s(e)f(sp)s(eci\014ed)g
(in)h(square)g(brac)m(k)m(ets)h(follo)m(wing)h(the)e(name)g(of)h(the)f
(\014le)227 2955 y(\(e.g.)56 b('ra)m(w\014le.dat[i512,512]')40
b(op)s(ens)34 b(a)i(512)g(x)f(512)h(short)e(in)m(teger)j(image\).)56
b(See)35 b(the)g(`Extended)g(File)227 3068 y(Name)k(Syn)m(tax')g(c)m
(hapter)g(for)e(more)i(details)g(on)f(ho)m(w)g(to)h(sp)s(ecify)f(the)g
(ra)m(w)h(\014le)f(name.)64 b(The)38 b(ra)m(w)g(\014le)227
3181 y(is)k(con)m(v)m(erted)g(on)f(the)h(\015y)f(in)m(to)h(a)f(virtual)
h(FITS)e(image)j(in)e(memory)g(that)h(is)f(then)g(op)s(ened)g(b)m(y)g
(the)227 3294 y(application)32 b(program)e(with)g(READONL)-8
b(Y)31 b(access.)227 3442 y(Programs)g(can)g(read)f(the)h(input)e
(\014le)i(from)f(the)h('stdin')f(\014le)h(stream)g(if)f(a)h(dash)f(c)m
(haracter)i(\('-'\))g(is)f(giv)m(en)227 3555 y(as)e(the)f(\014lename.)
40 b(Files)30 b(can)e(also)h(b)s(e)f(op)s(ened)f(o)m(v)m(er)j(the)e
(net)m(w)m(ork)h(using)f(FTP)g(or)g(HTTP)g(proto)s(cols)h(b)m(y)227
3668 y(supplying)g(the)i(appropriate)f(URL)h(as)f(the)h(\014lename.)227
3816 y(The)43 b(input)f(\014le)h(can)h(b)s(e)f(mo)s(di\014ed)f(in)g(v)
-5 b(arious)44 b(w)m(a)m(ys)g(to)g(create)g(a)g(virtual)f(\014le)h
(\(usually)f(stored)g(in)227 3929 y(memory\))31 b(that)g(is)g(then)f
(op)s(ened)f(b)m(y)i(the)f(application)i(program)e(b)m(y)h(supplying)e
(a)i(\014ltering)g(or)f(binning)227 4042 y(sp)s(eci\014er)e(in)g
(square)g(brac)m(k)m(ets)h(follo)m(wing)h(the)e(\014lename.)40
b(Some)29 b(of)f(the)g(more)h(common)f(\014ltering)h(meth-)227
4155 y(o)s(ds)j(are)h(illustrated)h(in)e(the)h(follo)m(wing)i
(paragraphs,)e(but)f(users)g(should)f(refer)i(to)g(the)g('Extended)g
(File)227 4268 y(Name)e(Syn)m(tax')g(c)m(hapter)g(for)f(a)h(complete)h
(description)e(of)h(the)f(full)h(\014le)f(\014ltering)h(syn)m(tax.)227
4416 y(When)c(op)s(ening)f(an)h(image,)h(a)g(rectangular)f(subset)f(of)
h(the)g(ph)m(ysical)g(image)h(ma)m(y)g(b)s(e)e(op)s(ened)f(b)m(y)i
(listing)227 4529 y(the)k(\014rst)e(and)h(last)h(pixel)g(in)f(eac)m(h)i
(dimension)e(\(and)g(optional)h(pixel)g(skipping)f(factor\):)227
4765 y Fe(myimage.fits[101:200,301:)o(400])227 5001 y
Fj(will)g(create)h(and)e(op)s(en)f(a)i(100x100)i(pixel)e(virtual)g
(image)g(of)g(that)g(section)g(of)g(the)f(ph)m(ysical)h(image,)i(and)
227 5114 y Fe(myimage.fits[*,-*])c Fj(op)s(ens)k(a)h(virtual)g(image)h
(that)f(is)g(the)g(same)g(size)h(as)e(the)h(ph)m(ysical)h(image)g(but)
227 5227 y(has)c(b)s(een)g(\015ipp)s(ed)f(in)h(the)g(v)m(ertical)j
(direction.)227 5375 y(When)28 b(op)s(ening)g(a)g(table,)i(the)e
(\014ltering)g(syn)m(tax)h(can)f(b)s(e)f(used)h(to)g(add)g(or)g(delete)
h(columns)f(or)g(k)m(eyw)m(ords)227 5488 y(in)g(the)g(virtual)h(table:)
40 b Fe(myfile.fits[events][col)i(!time;)k(PI)h(=)h(PHA*1.2])26
b Fj(op)s(ens)h(a)h(virtual)h(ta-)227 5601 y(ble)j(in)f(whic)m(h)g(the)
h(TIME)f(column)g(has)g(b)s(een)g(deleted)h(and)f(a)g(new)g(PI)g
(column)h(has)f(b)s(een)g(added)f(with)227 5714 y(a)41
b(v)-5 b(alue)40 b(1.2)i(times)e(that)h(of)f(the)h(PHA)f(column.)70
b(Similarly)-8 b(,)43 b(one)e(can)f(\014lter)h(a)f(table)h(to)g(k)m
(eep)g(only)p eop end
%%Page: 32 40
TeXDict begin 32 39 bop 0 299 a Fj(32)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(those)35 b(ro)m(ws)e(that)i(satisfy)f(a)g
(selection)i(criterion:)48 b Fe(myfile.fits[events][pha)42
b(>)47 b(50])33 b Fj(creates)j(and)227 668 y(op)s(ens)31
b(a)g(virtual)h(table)g(con)m(taining)h(only)e(those)h(ro)m(ws)f(with)g
(a)g(PHA)h(v)-5 b(alue)31 b(greater)i(than)e(50.)44 b(A)31
b(large)227 781 y(n)m(um)m(b)s(er)d(of)h(b)s(o)s(olean)h(and)e
(mathematical)k(op)s(erators)d(can)g(b)s(e)g(used)f(in)h(the)g
(selection)i(expression.)40 b(One)227 894 y(can)25 b(also)g(\014lter)g
(table)g(ro)m(ws)f(using)g('Go)s(o)s(d)h(Time)f(In)m(terv)-5
b(al')26 b(extensions,)g(and)e(spatial)h(region)g(\014lters)g(as)f(in)
227 1007 y Fe(myfile.fits[events][gtifi)o(lter)o(\(\)])14
b Fj(and)19 b Fe(myfile.fits[events][regfil)o(ter)o(\()42
b("stars.rng"\)])p Fj(.)227 1167 y(Finally)-8 b(,)34
b(table)e(columns)f(ma)m(y)h(b)s(e)f(binned)f(or)h(histogrammed)h(to)g
(generate)h(a)e(virtual)h(image.)45 b(F)-8 b(or)32 b(ex-)227
1280 y(ample,)d Fe(myfile.fits[events][bin)41 b(\(X,Y\)=4])26
b Fj(will)h(result)h(in)f(a)h(2-dimensional)g(image)h(calculated)227
1393 y(b)m(y)35 b(binning)e(the)i(X)f(and)g(Y)h(columns)f(in)g(the)h
(ev)m(en)m(t)h(table)f(with)f(a)h(bin)f(size)h(of)g(4)f(in)h(eac)m(h)g
(dimension.)227 1506 y(The)30 b(TLMINn)g(and)f(TLMAXn)h(k)m(eyw)m(ords)
h(will)g(b)s(e)e(used)h(b)m(y)g(default)h(to)g(determine)f(the)h(range)
f(of)h(the)227 1619 y(image.)227 1779 y(A)j(single)g(program)f(can)g
(op)s(en)g(the)h(same)f(FITS)g(\014le)g(more)h(than)f(once)h(and)f
(then)g(treat)h(the)g(resulting)227 1892 y(\014ts\014le)c(p)s(oin)m
(ters)g(as)g(though)g(they)g(w)m(ere)h(completely)h(indep)s(enden)m(t)d
(FITS)g(\014les.)40 b(Using)31 b(this)f(facilit)m(y)-8
b(,)33 b(a)227 2005 y(program)f(can)f(op)s(en)g(a)h(FITS)f(\014le)g(t)m
(wice,)j(mo)m(v)m(e)f(to)f(2)g(di\013eren)m(t)g(extensions)g(within)f
(the)g(\014le,)h(and)f(then)227 2118 y(read)g(and)e(write)i(data)g(in)f
(those)h(extensions)g(in)f(an)m(y)h(order.)0 2397 y Fi(2)81
b Fj(Create)31 b(and)f(op)s(en)f(a)i(new)f(empt)m(y)h(output)f(FITS)f
(\014le.)227 2677 y Fe(int)47 b(fits_create_file)d(/)j(ffinit)418
2790 y(\(fitsfile)e(**fptr,)h(char)h(*filename,)e(>)i(int)g(*status\))
227 3016 y(int)g(fits_create_diskfile)42 b(/)48 b(ffdkinit)418
3129 y(\(fitsfile)d(**fptr,)h(char)h(*filename,)e(>)i(int)g(*status\))
227 3409 y Fj(An)36 b(error)h(will)g(b)s(e)f(returned)f(if)h(the)h(sp)s
(eci\014ed)f(\014le)h(already)g(exists,)i(unless)d(the)h(\014lename)f
(is)h(pre\014xed)227 3522 y(with)30 b(an)g(exclamation)i(p)s(oin)m(t)e
(\(!\).)42 b(In)29 b(that)i(case)g(CFITSIO)d(will)j(o)m(v)m(erwrite)g
(\(delete\))h(an)m(y)f(existing)g(\014le)227 3635 y(with)36
b(the)g(same)h(name.)57 b(Note)38 b(that)e(the)h(exclamation)h(p)s(oin)
m(t)e(is)g(a)h(sp)s(ecial)f(UNIX)g(c)m(haracter)i(so)e(if)g(it)227
3748 y(is)d(used)e(on)h(the)h(command)f(line)h(it)g(m)m(ust)f(b)s(e)g
(preceded)g(b)m(y)g(a)g(bac)m(kslash)h(to)h(force)e(the)h(UNIX)g(shell)
f(to)227 3860 y(accept)g(the)f(c)m(haracter)h(as)e(part)g(of)h(the)g
(\014lename.)227 4021 y(The)26 b(output)h(\014le)g(will)g(b)s(e)f
(written)h(to)g(the)g('stdout')g(\014le)g(stream)g(if)g(a)g(dash)f(c)m
(haracter)i(\('-'\))g(or)f(the)g(string)227 4134 y('stdout')34
b(is)f(giv)m(en)h(as)g(the)f(\014lename.)49 b(Similarly)-8
b(,)35 b('-.gz')g(or)e('stdout.gz')i(will)f(cause)f(the)h(\014le)f(to)h
(b)s(e)e(gzip)227 4247 y(compressed)e(b)s(efore)g(it)h(is)g(written)f
(out)h(to)g(the)f(stdout)h(stream.)227 4407 y(Optionally)-8
b(,)41 b(the)c(name)h(of)f(a)h(template)h(\014le)e(that)h(is)f(used)g
(to)h(de\014ne)f(the)g(structure)g(of)g(the)h(new)f(\014le)227
4520 y(ma)m(y)i(b)s(e)f(sp)s(eci\014ed)f(in)h(paren)m(theses)h(follo)m
(wing)g(the)g(output)e(\014le)i(name.)64 b(The)38 b(template)h(\014le)g
(ma)m(y)g(b)s(e)227 4633 y(another)32 b(FITS)e(\014le,)i(in)f(whic)m(h)
g(case)i(the)e(new)g(\014le,)h(at)g(the)g(time)g(it)f(is)h(op)s(ened,)f
(will)g(b)s(e)g(an)g(exact)i(cop)m(y)227 4746 y(of)38
b(the)g(template)i(\014le)e(except)g(that)h(the)f(data)g(structures)g
(\(images)h(and)e(tables\))i(will)f(b)s(e)g(\014lled)f(with)227
4858 y(zeros.)k(Alternativ)m(ely)-8 b(,)32 b(the)d(template)i(\014le)e
(ma)m(y)g(b)s(e)f(an)h(ASCI)s(I)e(format)i(text)h(\014le)f(con)m
(taining)i(directiv)m(es)227 4971 y(that)e(de\014ne)e(the)h(k)m(eyw)m
(ords)g(to)g(b)s(e)g(created)h(in)e(eac)m(h)i(HDU)g(of)f(the)g(\014le.)
40 b(See)28 b(the)g('Extended)f(File)i(Name)227 5084
y(Syn)m(tax')i(section)h(for)e(a)h(complete)g(description)g(of)f(the)h
(template)h(\014le)e(syn)m(tax.)227 5245 y(The)f(\014ts)p
540 5245 28 4 v 33 w(create)p 809 5245 V 34 w(disk\014le)g(routine)h
(is)g(similar)g(to)g(the)g(\014ts)p 2238 5245 V 32 w(create)p
2506 5245 V 34 w(\014le)g(routine)g(except)g(that)g(it)g(do)s(es)g(not)
227 5357 y(supp)s(ort)36 b(the)i(extended)g(\014lename)g(syn)m(tax)g
(in)g(the)g(input)f(\014le)h(name.)63 b(This)37 b(routine)h(simply)f
(tries)h(to)227 5470 y(create)e(the)e(sp)s(eci\014ed)f(\014le)h(on)f
(magnetic)j(disk.)50 b(This)33 b(routine)h(is)g(mainly)g(for)g(use)f
(in)h(cases)g(where)g(the)227 5583 y(\014lename)g(\(or)h(directory)f
(path\))g(con)m(tains)h(square)f(or)g(curly)f(brac)m(k)m(et)j(c)m
(haracters)f(that)f(w)m(ould)g(confuse)227 5696 y(the)d(extended)f
(\014lename)h(parser.)p eop end
%%Page: 33 41
TeXDict begin 33 40 bop 0 299 a Fh(5.3.)72 b(HDU)31 b(A)m(CCESS)e(R)m
(OUTINES)2488 b Fj(33)0 555 y Fi(3)81 b Fj(Close)28 b(a)f(previously)g
(op)s(ened)g(FITS)g(\014le.)40 b(The)27 b(\014rst)f(routine)i(simply)f
(closes)h(the)g(\014le,)g(whereas)f(the)h(second)227
668 y(one)41 b(also)g(DELETES)e(THE)h(FILE,)g(whic)m(h)g(can)h(b)s(e)e
(useful)h(in)g(cases)h(where)e(a)i(FITS)e(\014le)i(has)f(b)s(een)227
781 y(partially)32 b(created,)f(but)f(then)g(an)g(error)g(o)s(ccurs)g
(whic)m(h)h(prev)m(en)m(ts)f(it)h(from)f(b)s(eing)g(completed.)95
1017 y Fe(int)47 b(fits_close_file)d(/)j(ffclos)g(\(fitsfile)e(*fptr,)h
(>)h(int)g(*status\))95 1243 y(int)g(fits_delete_file)d(/)j(ffdelt)f
(\(fitsfile)g(*fptr,)g(>)h(int)g(*status\))0 1479 y Fi(4)81
b Fj(Return)21 b(the)i(name,)h(I/O)e(mo)s(de)g(\(READONL)-8
b(Y)24 b(or)e(READ)m(WRITE\),)i(and/or)e(the)g(\014le)h(t)m(yp)s(e)f
(\(e.g.)40 b('\014le://',)227 1592 y('ftp://'\))32 b(of)f(the)f(op)s
(ened)g(FITS)g(\014le.)95 1828 y Fe(int)47 b(fits_file_name)d(/)k
(ffflnm)e(\(fitsfile)f(*fptr,)h(>)i(char)e(*filename,)f(int)i
(*status\))95 2054 y(int)g(fits_file_mode)d(/)k(ffflmd)e(\(fitsfile)f
(*fptr,)h(>)i(int)f(*iomode,)e(int)i(*status\))95 2280
y(int)g(fits_url_type)e(/)i(ffurlt)f(\(fitsfile)f(*fptr,)h(>)i(char)f
(*urltype,)e(int)i(*status\))0 2610 y Ff(5.3)135 b(HDU)46
b(Access)e(Routines)0 2860 y Fj(The)30 b(follo)m(wing)i(functions)e(p)s
(erform)f(op)s(erations)h(on)h(Header-Data)h(Units)f(\(HDUs\))h(as)e(a)
h(whole.)0 3096 y Fi(1)81 b Fj(Mo)m(v)m(e)44 b(to)g(a)f(di\013eren)m(t)
g(HDU)g(in)g(the)g(\014le.)77 b(The)43 b(\014rst)f(routine)g(mo)m(v)m
(es)i(to)g(a)f(sp)s(eci\014ed)f(absolute)h(HDU)227 3209
y(n)m(um)m(b)s(er)f(\(starting)h(with)g(1)f(for)h(the)g(primary)e(arra)
m(y\))j(in)e(the)h(FITS)f(\014le,)k(and)c(the)g(second)h(routine)227
3322 y(mo)m(v)m(es)35 b(a)e(relativ)m(e)i(n)m(um)m(b)s(er)d(HDUs)i
(forw)m(ard)e(or)h(bac)m(kw)m(ard)h(from)f(the)g(curren)m(t)g(HDU.)h(A)
f(n)m(ull)g(p)s(oin)m(ter)227 3435 y(ma)m(y)e(b)s(e)f(giv)m(en)h(for)f
(the)g(hdut)m(yp)s(e)f(parameter)i(if)f(it's)h(v)-5 b(alue)31
b(is)f(not)h(needed.)40 b(The)30 b(third)f(routine)i(mo)m(v)m(es)227
3548 y(to)39 b(the)g(\(\014rst\))f(HDU)i(whic)m(h)e(has)g(the)h(sp)s
(eci\014ed)e(extension)i(t)m(yp)s(e)g(and)f(EXTNAME)g(and)g(EXTVER)227
3661 y(k)m(eyw)m(ord)26 b(v)-5 b(alues)26 b(\(or)g(HDUNAME)h(and)e
(HDUVER)h(k)m(eyw)m(ords\).)40 b(The)24 b(hdut)m(yp)s(e)h(parameter)h
(ma)m(y)g(ha)m(v)m(e)227 3774 y(a)d(v)-5 b(alue)22 b(of)g(IMA)m(GE)p
935 3774 28 4 v 34 w(HDU,)h(ASCI)s(I)p 1476 3774 V 31
w(TBL,)f(BINAR)-8 b(Y)p 2101 3774 V 34 w(TBL,)22 b(or)g(ANY)p
2676 3774 V 34 w(HDU)g(where)g(ANY)p 3396 3774 V 33 w(HDU)h(means)227
3887 y(that)33 b(only)g(the)f(extname)i(and)d(extv)m(er)j(v)-5
b(alues)33 b(will)f(b)s(e)g(used)g(to)h(lo)s(cate)h(the)f(correct)g
(extension.)48 b(If)32 b(the)227 4000 y(input)i(v)-5
b(alue)36 b(of)f(extv)m(er)h(is)f(0)h(then)e(the)i(EXTVER)e(k)m(eyw)m
(ord)i(is)f(ignored)g(and)g(the)g(\014rst)f(HDU)i(with)f(a)227
4112 y(matc)m(hing)28 b(EXTNAME)g(\(or)f(HDUNAME\))i(k)m(eyw)m(ord)e
(will)g(b)s(e)g(found.)38 b(If)27 b(no)f(matc)m(hing)i(HDU)g(is)f
(found)227 4225 y(in)f(the)g(\014le)g(then)g(the)g(curren)m(t)g(HDU)g
(will)h(remain)f(unc)m(hanged)f(and)h(a)g(status)g(=)g(BAD)p
3246 4225 V 33 w(HDU)p 3484 4225 V 34 w(NUM)h(will)227
4338 y(b)s(e)j(returned.)95 4574 y Fe(int)47 b(fits_movabs_hdu)d(/)j
(ffmahd)286 4687 y(\(fitsfile)f(*fptr,)g(int)h(hdunum,)e(>)j(int)f
(*hdutype,)e(int)i(*status\))95 4913 y(int)g(fits_movrel_hdu)d(/)j
(ffmrhd)286 5026 y(\(fitsfile)f(*fptr,)g(int)h(nmove,)f(>)h(int)g
(*hdutype,)e(int)i(*status\))95 5252 y(int)g(fits_movnam_hdu)d(/)j
(ffmnhd)286 5365 y(\(fitsfile)f(*fptr,)g(int)h(hdutype,)e(char)i
(*extname,)e(int)i(extver,)f(>)h(int)g(*status\))0 5601
y Fi(2)81 b Fj(Return)38 b(the)i(total)h(n)m(um)m(b)s(er)d(of)i(HDUs)g
(in)f(the)h(FITS)f(\014le.)68 b(This)39 b(returns)f(the)h(n)m(um)m(b)s
(er)g(of)g(completely)227 5714 y(de\014ned)30 b(HDUs)h(in)f(the)h
(\014le.)42 b(If)30 b(a)h(new)f(HDU)h(has)g(just)f(b)s(een)g(added)f
(to)j(the)f(FITS)f(\014le,)h(then)f(that)h(last)p eop
end
%%Page: 34 42
TeXDict begin 34 41 bop 0 299 a Fj(34)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(HDU)g(will)f(only)g(b)s(e)g(coun)m(ted)g(if)
g(it)h(has)e(b)s(een)h(closed,)h(or)f(if)g(data)h(has)e(b)s(een)h
(written)g(to)g(the)g(HDU.)h(The)227 668 y(curren)m(t)g(HDU)i(remains)e
(unc)m(hanged)g(b)m(y)g(this)g(routine.)95 900 y Fe(int)47
b(fits_get_num_hdus)c(/)48 b(ffthdu)286 1013 y(\(fitsfile)e(*fptr,)g(>)
h(int)g(*hdunum,)f(int)h(*status\))0 1246 y Fi(3)81 b
Fj(Return)31 b(the)h(n)m(um)m(b)s(er)f(of)h(the)h(curren)m(t)e(HDU)i
(\(CHDU\))h(in)d(the)i(FITS)e(\014le)h(\(where)g(the)g(primary)g(arra)m
(y)g(=)227 1359 y(1\).)42 b(This)29 b(function)h(returns)g(the)g(HDU)h
(n)m(um)m(b)s(er)e(rather)h(than)h(a)f(status)h(v)-5
b(alue.)95 1591 y Fe(int)47 b(fits_get_hdu_num)d(/)j(ffghdn)286
1704 y(\(fitsfile)f(*fptr,)g(>)h(int)g(*hdunum\))0 1936
y Fi(4)81 b Fj(Return)38 b(the)h(t)m(yp)s(e)h(of)f(the)h(curren)m(t)f
(HDU)h(in)f(the)g(FITS)g(\014le.)67 b(The)39 b(p)s(ossible)g(v)-5
b(alues)39 b(for)g(hdut)m(yp)s(e)f(are:)227 2049 y(IMA)m(GE)p
546 2049 28 4 v 34 w(HDU,)31 b(ASCI)s(I)p 1095 2049 V
32 w(TBL,)f(or)g(BINAR)-8 b(Y)p 1840 2049 V 34 w(TBL.)95
2281 y Fe(int)47 b(fits_get_hdu_type)c(/)48 b(ffghdt)286
2394 y(\(fitsfile)e(*fptr,)g(>)h(int)g(*hdutype,)e(int)i(*status\))0
2626 y Fi(5)81 b Fj(Cop)m(y)24 b(all)h(or)f(part)g(of)g(the)g(HDUs)h
(in)f(the)g(FITS)g(\014le)g(asso)s(ciated)h(with)f(infptr)f(and)h(app)s
(end)e(them)i(to)h(the)g(end)227 2739 y(of)f(the)f(FITS)f(\014le)i
(asso)s(ciated)g(with)f(outfptr.)38 b(If)23 b('previous')g(is)g(true)g
(\(not)h(0\),)i(then)d(an)m(y)g(HDUs)h(preceding)227
2852 y(the)35 b(curren)m(t)f(HDU)g(in)g(the)h(input)e(\014le)h(will)h
(b)s(e)e(copied)i(to)g(the)f(output)g(\014le.)52 b(Similarly)-8
b(,)36 b('curren)m(t')f(and)227 2965 y('follo)m(wing')c(determine)e
(whether)f(the)h(curren)m(t)g(HDU,)g(and/or)g(an)m(y)g(follo)m(wing)h
(HDUs)g(in)e(the)h(input)f(\014le)227 3078 y(will)i(b)s(e)f(copied)i
(to)f(the)g(output)f(\014le.)41 b(Th)m(us,)29 b(if)g(all)i(3)f
(parameters)g(are)g(true,)g(then)g(the)f(en)m(tire)i(input)e(\014le)227
3191 y(will)36 b(b)s(e)e(copied.)56 b(On)35 b(exit,)i(the)f(curren)m(t)
f(HDU)h(in)e(the)i(input)e(\014le)i(will)f(b)s(e)g(unc)m(hanged,)h(and)
f(the)g(last)227 3304 y(HDU)c(in)f(the)h(output)f(\014le)g(will)h(b)s
(e)f(the)g(curren)m(t)h(HDU.)95 3536 y Fe(int)47 b(fits_copy_file)d(/)k
(ffcpfl)286 3649 y(\(fitsfile)e(*infptr,)f(fitsfile)h(*outfptr,)f(int)i
(previous,)e(int)i(current,)477 3762 y(int)g(following,)e(>)j(int)f
(*status\))0 3994 y Fi(6)81 b Fj(Cop)m(y)34 b(the)h(curren)m(t)f(HDU)h
(from)f(the)g(FITS)g(\014le)h(asso)s(ciated)g(with)g(infptr)e(and)h
(app)s(end)e(it)j(to)g(the)g(end)f(of)227 4107 y(the)39
b(FITS)e(\014le)h(asso)s(ciated)i(with)e(outfptr.)64
b(Space)38 b(ma)m(y)h(b)s(e)e(reserv)m(ed)i(for)f(MOREKEYS)f
(additional)227 4220 y(k)m(eyw)m(ords)31 b(in)f(the)h(output)f(header.)
95 4452 y Fe(int)47 b(fits_copy_hdu)e(/)i(ffcopy)286
4565 y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(int)i(morekeys,)e
(>)j(int)f(*status\))0 4798 y Fi(7)81 b Fj(W)-8 b(rite)31
b(the)g(curren)m(t)f(HDU)h(in)f(the)h(input)e(FITS)h(\014le)g(to)h(the)
g(output)f(FILE)g(stream)h(\(e.g.,)h(to)f(stdout\).)95
5030 y Fe(int)47 b(fits_write_hdu)d(/)k(ffwrhdu)286 5143
y(\(fitsfile)e(*infptr,)f(FILE)i(*stream,)e(>)j(int)f(*status\))0
5375 y Fi(8)81 b Fj(Cop)m(y)43 b(the)h(header)g(\(and)f(not)h(the)g
(data\))h(from)e(the)h(CHDU)g(asso)s(ciated)h(with)f(infptr)e(to)j(the)
f(CHDU)227 5488 y(asso)s(ciated)28 b(with)e(outfptr.)39
b(If)26 b(the)h(curren)m(t)f(output)g(HDU)h(is)g(not)f(completely)i
(empt)m(y)-8 b(,)29 b(then)d(the)h(CHDU)227 5601 y(will)35
b(b)s(e)f(closed)h(and)f(a)h(new)f(HDU)h(will)g(b)s(e)f(app)s(ended)e
(to)j(the)g(output)f(\014le.)53 b(An)34 b(empt)m(y)h(output)f(data)227
5714 y(unit)c(will)h(b)s(e)f(created)h(with)f(all)h(v)-5
b(alues)31 b(initially)h(=)e(0\).)p eop end
%%Page: 35 43
TeXDict begin 35 42 bop 0 299 a Fh(5.4.)72 b(HEADER)31
b(KEYW)m(ORD)g(READ/WRITE)g(R)m(OUTINES)1495 b Fj(35)95
555 y Fe(int)47 b(fits_copy_header)d(/)j(ffcphd)286 668
y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(>)i(int)g(*status\))0
942 y Fi(9)81 b Fj(Delete)35 b(the)e(CHDU)h(in)f(the)g(FITS)f(\014le.)
50 b(An)m(y)33 b(follo)m(wing)i(HDUs)e(will)h(b)s(e)e(shifted)h(forw)m
(ard)g(in)g(the)g(\014le,)h(to)227 1054 y(\014ll)k(in)f(the)g(gap)h
(created)g(b)m(y)g(the)f(deleted)h(HDU.)h(In)d(the)i(case)g(of)g
(deleting)g(the)g(primary)e(arra)m(y)i(\(the)227 1167
y(\014rst)30 b(HDU)h(in)f(the)h(\014le\))g(then)f(the)h(curren)m(t)f
(primary)f(arra)m(y)i(will)g(b)s(e)f(replace)h(b)m(y)g(a)g(n)m(ull)f
(primary)f(arra)m(y)227 1280 y(con)m(taining)k(the)f(minim)m(um)e(set)i
(of)g(required)e(k)m(eyw)m(ords)i(and)e(no)i(data.)44
b(If)31 b(there)g(are)h(more)f(extensions)227 1393 y(in)f(the)g(\014le)
g(follo)m(wing)i(the)e(one)g(that)h(is)f(deleted,)h(then)f(the)g(the)g
(CHDU)h(will)f(b)s(e)g(rede\014ned)e(to)j(p)s(oin)m(t)f(to)227
1506 y(the)d(follo)m(wing)h(extension.)41 b(If)26 b(there)h(are)g(no)g
(follo)m(wing)h(extensions)f(then)g(the)g(CHDU)g(will)g(b)s(e)f
(rede\014ned)227 1619 y(to)36 b(p)s(oin)m(t)f(to)g(the)g(previous)f
(HDU.)i(The)e(output)h(hdut)m(yp)s(e)e(parameter)i(returns)f(the)h(t)m
(yp)s(e)g(of)f(the)h(new)227 1732 y(CHDU.)c(A)g(n)m(ull)f(p)s(oin)m
(ter)g(ma)m(y)h(b)s(e)f(giv)m(en)i(for)e(hdut)m(yp)s(e)f(if)h(the)h
(returned)e(v)-5 b(alue)31 b(is)f(not)h(needed.)95 2005
y Fe(int)47 b(fits_delete_hdu)d(/)j(ffdhdu)286 2118 y(\(fitsfile)f
(*fptr,)g(>)h(int)g(*hdutype,)e(int)i(*status\))0 2468
y Ff(5.4)135 b(Header)46 b(Keyw)l(ord)g(Read/W)-11 b(rite)46
b(Routines)0 2722 y Fj(These)35 b(routines)g(read)f(or)h(write)h(k)m
(eyw)m(ords)f(in)g(the)g(Curren)m(t)f(Header)h(Unit)g(\(CHU\).)h(Wild)g
(card)e(c)m(haracters)0 2834 y(\(*,)28 b(?,)g(or)e(#\))h(ma)m(y)g(b)s
(e)f(used)g(when)f(sp)s(ecifying)i(the)g(name)f(of)h(the)g(k)m(eyw)m
(ord)g(to)g(b)s(e)f(read:)39 b(a)27 b(')10 b(?')39 b(will)27
b(matc)m(h)h(an)m(y)0 2947 y(single)35 b(c)m(haracter)g(at)g(that)f(p)s
(osition)g(in)g(the)g(k)m(eyw)m(ord)h(name)f(and)f(a)h('*')h(will)g
(matc)m(h)f(an)m(y)h(length)f(\(including)0 3060 y(zero\))c(string)f
(of)g(c)m(haracters.)42 b(The)28 b('#')h(c)m(haracter)i(will)e(matc)m
(h)h(an)m(y)f(consecutiv)m(e)i(string)e(of)g(decimal)h(digits)f(\(0)0
3173 y(-)35 b(9\).)55 b(When)35 b(a)g(wild)g(card)g(is)g(used)f(the)h
(routine)g(will)g(only)g(searc)m(h)h(for)f(a)g(matc)m(h)h(from)e(the)h
(curren)m(t)g(header)0 3286 y(p)s(osition)27 b(to)h(the)f(end)f(of)h
(the)g(header)g(and)f(will)h(not)g(resume)g(the)g(searc)m(h)g(from)g
(the)g(top)g(of)g(the)g(header)g(bac)m(k)g(to)0 3399
y(the)k(original)i(header)e(p)s(osition)g(as)h(is)f(done)g(when)f(no)h
(wildcards)g(are)h(included)e(in)h(the)g(k)m(eyw)m(ord)h(name.)43
b(The)0 3512 y(\014ts)p 127 3512 28 4 v 32 w(read)p 331
3512 V 33 w(record)29 b(routine)h(ma)m(y)g(b)s(e)f(used)f(to)i(set)g
(the)g(starting)g(p)s(osition)f(when)g(doing)g(wild)g(card)h(searc)m
(hes.)41 b(A)0 3625 y(status)29 b(v)-5 b(alue)30 b(of)f(KEY)p
809 3625 V 32 w(NO)p 980 3625 V 33 w(EXIST)f(is)h(returned)e(if)i(the)g
(sp)s(eci\014ed)f(k)m(eyw)m(ord)i(to)f(b)s(e)g(read)f(is)h(not)h(found)
d(in)i(the)0 3738 y(header.)0 4045 y Fd(5.4.1)112 b(Keyw)m(ord)38
b(Reading)g(Routines)0 4264 y Fi(1)81 b Fj(Return)33
b(the)h(n)m(um)m(b)s(er)e(of)i(existing)h(k)m(eyw)m(ords)g(\(not)f
(coun)m(ting)h(the)f(END)g(k)m(eyw)m(ord\))h(and)e(the)h(amoun)m(t)h
(of)227 4377 y(space)e(curren)m(tly)f(a)m(v)-5 b(ailable)34
b(for)e(more)g(k)m(eyw)m(ords.)46 b(It)32 b(returns)e(morek)m(eys)j(=)f
(-1)g(if)g(the)g(header)g(has)g(not)227 4489 y(y)m(et)27
b(b)s(een)d(closed.)40 b(Note)26 b(that)g(CFITSIO)d(will)j(dynamically)
g(add)e(space)i(if)f(required)f(when)g(writing)h(new)227
4602 y(k)m(eyw)m(ords)32 b(to)g(a)f(header)g(so)h(in)f(practice)h
(there)g(is)f(no)g(limit)h(to)g(the)f(n)m(um)m(b)s(er)f(of)i(k)m(eyw)m
(ords)f(that)h(can)g(b)s(e)227 4715 y(added)e(to)h(a)f(header.)41
b(A)30 b(n)m(ull)g(p)s(oin)m(ter)h(ma)m(y)f(b)s(e)g(en)m(tered)h(for)f
(the)g(morek)m(eys)h(parameter)g(if)f(it's)h(v)-5 b(alue)31
b(is)227 4828 y(not)g(needed.)95 5102 y Fe(int)47 b(fits_get_hdrspace)c
(/)48 b(ffghsp)286 5215 y(\(fitsfile)e(*fptr,)g(>)h(int)g(*keysexist,)e
(int)i(*morekeys,)e(int)i(*status\))0 5488 y Fi(2)81
b Fj(Return)28 b(the)h(sp)s(eci\014ed)f(k)m(eyw)m(ord.)41
b(In)29 b(the)g(\014rst)f(routine,)i(the)f(datat)m(yp)s(e)h(parameter)g
(sp)s(eci\014es)e(the)h(desired)227 5601 y(returned)e(data)h(t)m(yp)s
(e)g(of)g(the)g(k)m(eyw)m(ord)h(v)-5 b(alue)28 b(and)f(can)h(ha)m(v)m
(e)h(one)f(of)g(the)g(follo)m(wing)h(sym)m(b)s(olic)g(constan)m(t)227
5714 y(v)-5 b(alues:)47 b(TSTRING,)33 b(TLOGICAL)f(\(==)h(in)m(t\),)j
(TBYTE,)d(TSHOR)-8 b(T,)33 b(TUSHOR)-8 b(T,)32 b(TINT,)h(TUINT,)p
eop end
%%Page: 36 44
TeXDict begin 36 43 bop 0 299 a Fj(36)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(TLONG,)24 b(TULONG,)g(TLONGLONG,)g(TFLO)m(A)
-8 b(T,)25 b(TDOUBLE,)f(TCOMPLEX,)f(and)h(TDBLCOM-)227
668 y(PLEX.)j(Within)f(the)h(con)m(text)h(of)f(this)g(routine,)g
(TSTRING)f(corresp)s(onds)f(to)i(a)g('c)m(har*')h(data)f(t)m(yp)s(e,)h
(i.e.,)227 781 y(a)k(p)s(oin)m(ter)g(to)g(a)g(c)m(haracter)i(arra)m(y)
-8 b(.)45 b(Data)33 b(t)m(yp)s(e)f(con)m(v)m(ersion)h(will)f(b)s(e)f(p)
s(erformed)f(for)i(n)m(umeric)f(v)-5 b(alues)32 b(if)227
894 y(the)27 b(k)m(eyw)m(ord)g(v)-5 b(alue)27 b(do)s(es)f(not)h(ha)m(v)
m(e)h(the)f(same)g(data)g(t)m(yp)s(e.)40 b(If)26 b(the)h(v)-5
b(alue)27 b(of)g(the)f(k)m(eyw)m(ord)i(is)e(unde\014ned)227
1007 y(\(i.e.,)31 b(the)e(v)-5 b(alue)30 b(\014eld)e(is)h(blank\))g
(then)f(an)h(error)g(status)g(=)f(V)-10 b(ALUE)p 2627
1007 28 4 v 33 w(UNDEFINED)30 b(will)g(b)s(e)e(returned.)227
1156 y(The)c(second)f(routine)h(returns)f(the)h(k)m(eyw)m(ord)g(v)-5
b(alue)24 b(as)g(a)g(c)m(haracter)i(string)d(\(a)i(literal)g(cop)m(y)g
(of)f(what)f(is)h(in)227 1269 y(the)j(v)-5 b(alue)26
b(\014eld\))g(regardless)h(of)f(the)g(in)m(trinsic)h(data)g(t)m(yp)s(e)
f(of)g(the)g(k)m(eyw)m(ord.)40 b(The)26 b(third)f(routine)h(returns)227
1382 y(the)45 b(en)m(tire)h(80-c)m(haracter)i(header)c(record)h(of)g
(the)g(k)m(eyw)m(ord,)k(with)c(an)m(y)g(trailing)h(blank)e(c)m
(haracters)227 1495 y(stripp)s(ed)37 b(o\013.)64 b(The)38
b(fourth)f(routine)h(returns)f(the)h(\(next\))h(header)f(record)g(that)
h(con)m(tains)g(the)f(literal)227 1608 y(string)31 b(of)f(c)m
(haracters)i(sp)s(eci\014ed)e(b)m(y)g(the)g('string')h(argumen)m(t.)227
1757 y(If)f(a)h(NULL)f(commen)m(t)i(p)s(oin)m(ter)e(is)g(supplied)g
(then)g(the)g(commen)m(t)i(string)e(will)h(not)f(b)s(e)g(returned.)95
2013 y Fe(int)47 b(fits_read_key)e(/)i(ffgky)286 2126
y(\(fitsfile)f(*fptr,)g(int)h(datatype,)e(char)i(*keyname,)e(>)i(DTYPE)
g(*value,)334 2238 y(char)g(*comment,)e(int)i(*status\))95
2464 y(int)g(fits_read_keyword)c(/)48 b(ffgkey)286 2577
y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(>)h(char)g(*value,)f(char)g
(*comment,)334 2690 y(int)h(*status\))95 2916 y(int)g(fits_read_card)d
(/)k(ffgcrd)286 3029 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(>)h
(char)g(*card,)f(int)h(*status\))95 3255 y(int)g(fits_read_str)e(/)i
(ffgstr)286 3368 y(\(fitsfile)f(*fptr,)g(char)g(*string,)g(>)h(char)g
(*card,)f(int)h(*status\))0 3623 y Fi(3)81 b Fj(Return)38
b(the)h(n)m(th)f(header)h(record)g(in)f(the)i(CHU.)f(The)f(\014rst)g(k)
m(eyw)m(ord)i(in)e(the)h(header)g(is)g(at)g(k)m(eyn)m(um)g(=)227
3736 y(1;)53 b(if)45 b(k)m(eyn)m(um)g(=)f(0)h(then)g(these)g(routines)g
(simply)f(reset)h(the)h(in)m(ternal)f(CFITSIO)e(p)s(oin)m(ter)i(to)h
(the)227 3849 y(b)s(eginning)35 b(of)h(the)g(header)f(so)h(that)g
(subsequen)m(t)f(k)m(eyw)m(ord)h(op)s(erations)g(will)g(start)g(at)g
(the)g(top)g(of)g(the)227 3962 y(header)26 b(\(e.g.,)j(prior)c(to)h
(searc)m(hing)h(for)f(k)m(eyw)m(ords)g(using)f(wild)g(cards)h(in)f(the)
h(k)m(eyw)m(ord)h(name\).)39 b(The)26 b(\014rst)227 4074
y(routine)32 b(returns)e(the)i(en)m(tire)h(80-c)m(haracter)h(header)e
(record)g(\(with)f(trailing)i(blanks)e(truncated\),)i(while)227
4187 y(the)41 b(second)f(routine)g(parses)g(the)g(record)h(and)e
(returns)g(the)i(name,)i(v)-5 b(alue,)43 b(and)d(commen)m(t)h(\014elds)
f(as)227 4300 y(separate)32 b(\(blank)f(truncated\))g(c)m(haracter)i
(strings.)42 b(If)30 b(a)h(NULL)g(commen)m(t)h(p)s(oin)m(ter)f(is)g
(giv)m(en)h(on)f(input,)227 4413 y(then)f(the)h(commen)m(t)g(string)g
(will)f(not)h(b)s(e)f(returned.)95 4668 y Fe(int)47 b(fits_read_record)
d(/)j(ffgrec)286 4781 y(\(fitsfile)f(*fptr,)g(int)h(keynum,)e(>)j(char)
f(*card,)f(int)h(*status\))95 5007 y(int)g(fits_read_keyn)d(/)k(ffgkyn)
286 5120 y(\(fitsfile)e(*fptr,)g(int)h(keynum,)e(>)j(char)f(*keyname,)e
(char)h(*value,)334 5233 y(char)h(*comment,)e(int)i(*status\))0
5488 y Fi(4)81 b Fj(Return)44 b(the)i(next)g(k)m(eyw)m(ord)g(whose)f
(name)h(matc)m(hes)g(one)g(of)g(the)f(strings)h(in)f('inclist')i(but)e
(do)s(es)g(not)227 5601 y(matc)m(h)31 b(an)m(y)g(of)g(the)f(strings)g
(in)g('exclist'.)43 b(The)30 b(strings)g(in)g(inclist)h(and)f(exclist)i
(ma)m(y)e(con)m(tain)i(wild)e(card)227 5714 y(c)m(haracters)k(\(*,)f
(?,)f(and)f(#\))h(as)g(describ)s(ed)f(at)i(the)f(b)s(eginning)f(of)h
(this)g(section.)46 b(This)31 b(routine)h(searc)m(hes)p
eop end
%%Page: 37 45
TeXDict begin 37 44 bop 0 299 a Fh(5.4.)72 b(HEADER)31
b(KEYW)m(ORD)g(READ/WRITE)g(R)m(OUTINES)1495 b Fj(37)227
555 y(from)35 b(the)g(curren)m(t)g(header)g(p)s(osition)g(to)h(the)f
(end)f(of)h(the)h(header,)g(only)-8 b(,)37 b(and)d(do)s(es)h(not)g(con)
m(tin)m(ue)i(the)227 668 y(searc)m(h)32 b(from)e(the)h(top)g(of)g(the)g
(header)g(bac)m(k)g(to)h(the)f(original)h(p)s(osition.)42
b(The)31 b(curren)m(t)f(header)h(p)s(osition)227 781
y(ma)m(y)e(b)s(e)e(reset)h(with)g(the)g(\013grec)g(routine.)40
b(Note)29 b(that)g(nexc)f(ma)m(y)g(b)s(e)f(set)h(=)g(0)g(if)g(there)g
(are)g(no)g(k)m(eyw)m(ords)227 894 y(to)h(b)s(e)f(excluded.)39
b(This)28 b(routine)g(returns)f(status)h(=)g(KEY)p 2268
894 28 4 v 32 w(NO)p 2439 894 V 33 w(EXIST)f(if)h(a)h(matc)m(hing)g(k)m
(eyw)m(ord)g(is)f(not)227 1007 y(found.)95 1226 y Fe(int)47
b(fits_find_nextkey)c(/)48 b(ffgnxk)286 1339 y(\(fitsfile)e(*fptr,)g
(char)g(**inclist,)f(int)i(ninc,)g(char)f(**exclist,)334
1452 y(int)h(nexc,)f(>)i(char)e(*card,)h(int)94 b(*status\))0
1671 y Fi(5)81 b Fj(Return)25 b(the)h(ph)m(ysical)g(units)g(string)g
(from)f(an)h(existing)h(k)m(eyw)m(ord.)39 b(This)26 b(routine)g(uses)f
(a)h(lo)s(cal)i(con)m(v)m(en)m(tion,)227 1784 y(sho)m(wn)d(in)g(the)g
(follo)m(wing)i(example,)g(in)e(whic)m(h)g(the)h(k)m(eyw)m(ord)f(units)
g(are)h(enclosed)g(in)f(square)g(brac)m(k)m(ets)h(in)227
1896 y(the)k(b)s(eginning)f(of)h(the)g(k)m(eyw)m(ord)g(commen)m(t)g
(\014eld.)40 b(A)30 b(n)m(ull)g(string)f(is)h(returned)e(if)i(no)f
(units)g(are)h(de\014ned)227 2009 y(for)g(the)h(k)m(eyw)m(ord.)239
2228 y Fe(VELOCITY=)809 b(12.3)46 b(/)i([km/s])e(orbital)g(speed)95
2454 y(int)h(fits_read_key_unit)c(/)48 b(ffgunt)286 2567
y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(>)h(char)g(*unit,)f(int)h
(*status\))0 2786 y Fi(6)81 b Fj(Concatenate)39 b(the)f(header)f(k)m
(eyw)m(ords)h(in)g(the)f(CHDU)h(in)m(to)h(a)f(single)g(long)g(string)g
(of)g(c)m(haracters.)64 b(This)227 2899 y(pro)m(vides)28
b(a)h(con)m(v)m(enien)m(t)h(w)m(a)m(y)f(of)g(passing)f(all)h(or)f(part)
g(of)g(the)h(header)f(information)g(in)g(a)h(FITS)e(HDU)i(to)227
3012 y(other)i(subroutines.)39 b(Eac)m(h)31 b(80-c)m(haracter)h
(\014xed-length)f(k)m(eyw)m(ord)f(record)g(is)g(app)s(ended)e(to)j(the)
f(output)227 3125 y(c)m(haracter)j(string,)f(in)f(order,)g(with)g(no)g
(in)m(terv)m(ening)i(separator)f(or)f(terminating)h(c)m(haracters.)45
b(The)31 b(last)227 3238 y(header)e(record)g(is)g(terminated)h(with)f
(a)g(NULL)g(c)m(haracter.)42 b(These)29 b(routine)g(allo)s(cates)j
(memory)d(for)g(the)227 3351 y(returned)k(c)m(haracter)j(arra)m(y)-8
b(,)37 b(so)d(the)h(calling)h(program)e(m)m(ust)g(free)g(the)h(memory)f
(when)f(\014nished.)51 b(The)227 3464 y(cleanest)32 b(w)m(a)m(y)g(to)f
(do)f(this)g(is)h(to)g(call)g(the)g(\014ts)p 1823 3464
V 32 w(free)p 1999 3464 V 33 w(memory)g(routine.)227
3607 y(There)38 b(are)h(2)g(related)g(routines:)57 b(\014ts)p
1581 3607 V 32 w(hdr2str)37 b(simply)h(concatenates)j(all)f(the)e
(existing)i(k)m(eyw)m(ords)e(in)227 3720 y(the)44 b(header;)51
b(\014ts)p 863 3720 V 33 w(con)m(v)m(ert)p 1185 3720
V 34 w(hdr2str)43 b(is)h(similar,)k(except)d(that)f(if)g(the)g(CHDU)h
(is)f(a)g(tile)h(compressed)227 3833 y(image)c(\(stored)f(in)f(a)h
(binary)e(table\))j(then)e(it)h(will)f(\014rst)g(con)m(v)m(ert)i(that)f
(header)f(bac)m(k)h(to)g(that)g(of)g(the)227 3946 y(corresp)s(onding)30
b(normal)g(FITS)g(image)h(b)s(efore)f(concatenating)j(the)e(k)m(eyw)m
(ords.)227 4089 y(Selected)f(k)m(eyw)m(ords)e(ma)m(y)h(b)s(e)e
(excluded)h(from)g(the)g(returned)f(c)m(haracter)j(string.)40
b(If)27 b(the)i(second)f(param-)227 4202 y(eter)h(\(no)s(commen)m(ts\))
g(is)f(TR)m(UE)g(\(nonzero\))h(then)e(an)m(y)i(COMMENT,)f(HISTOR)-8
b(Y,)27 b(or)h(blank)g(k)m(eyw)m(ords)227 4315 y(in)i(the)h(header)f
(will)h(not)f(b)s(e)g(copied)h(to)g(the)g(output)f(string.)227
4458 y(The)25 b('exclist')j(parameter)e(ma)m(y)g(b)s(e)f(used)g(to)h
(supply)e(a)i(list)h(of)e(k)m(eyw)m(ords)h(that)h(are)f(to)g(b)s(e)f
(excluded)g(from)227 4571 y(the)k(output)g(c)m(haracter)h(string.)41
b(Wild)29 b(card)g(c)m(haracters)h(\(*,)g(?,)f(and)g(#\))g(ma)m(y)g(b)s
(e)f(used)g(in)h(the)g(excluded)227 4684 y(k)m(eyw)m(ord)h(names.)41
b(If)29 b(no)g(additional)i(k)m(eyw)m(ords)f(are)g(to)g(b)s(e)f
(excluded,)h(then)f(set)h(nexc)g(=)f(0)h(and)f(sp)s(ecify)227
4797 y(NULL)i(for)f(the)g(the)h(**exclist)i(parameter.)95
5016 y Fe(int)47 b(fits_hdr2str)e(/)i(ffhdr2str)286 5129
y(\(fitsfile)f(*fptr,)g(int)h(nocomments,)d(char)j(**exclist,)e(int)i
(nexc,)286 5242 y(>)h(char)e(**header,)g(int)h(*nkeys,)e(int)i
(*status\))95 5468 y(int)g(fits_convert_hdr2str)c(/)k(ffcnvthdr2str)286
5581 y(\(fitsfile)f(*fptr,)g(int)h(nocomments,)d(char)j(**exclist,)e
(int)i(nexc,)286 5694 y(>)h(char)e(**header,)g(int)h(*nkeys,)e(int)i
(*status\))p eop end
%%Page: 38 46
TeXDict begin 38 45 bop 0 299 a Fj(38)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fd(5.4.2)112 b(Keyw)m(ord)38 b(W)-9
b(riting)37 b(Routines)0 775 y Fi(1)81 b Fj(W)-8 b(rite)32
b(a)g(k)m(eyw)m(ord)g(of)f(the)h(appropriate)f(data)h(t)m(yp)s(e)g(in)m
(to)g(the)g(CHU.)f(The)g(\014rst)g(routine)g(simply)g(app)s(ends)227
888 y(a)j(new)f(k)m(eyw)m(ord)h(whereas)f(the)g(second)h(routine)f
(will)h(up)s(date)e(the)i(v)-5 b(alue)33 b(and)g(commen)m(t)h(\014elds)
f(of)h(the)227 1001 y(k)m(eyw)m(ord)g(if)g(it)g(already)g(exists,)h
(otherwise)f(it)g(app)s(ends)e(a)i(new)f(k)m(eyw)m(ord.)51
b(Note)35 b(that)f(the)g(address)e(to)227 1114 y(the)37
b(v)-5 b(alue,)38 b(and)d(not)i(the)f(v)-5 b(alue)36
b(itself,)j(m)m(ust)d(b)s(e)f(en)m(tered.)59 b(The)35
b(datat)m(yp)s(e)i(parameter)g(sp)s(eci\014es)f(the)227
1227 y(data)25 b(t)m(yp)s(e)f(of)g(the)g(k)m(eyw)m(ord)g(v)-5
b(alue)25 b(with)e(one)h(of)g(the)g(follo)m(wing)i(v)-5
b(alues:)37 b(TSTRING,)23 b(TLOGICAL)g(\(==)227 1340
y(in)m(t\),)38 b(TBYTE,)d(TSHOR)-8 b(T,)34 b(TUSHOR)-8
b(T,)35 b(TINT,)f(TUINT,)h(TLONG,)g(TLONGLONG,)g(TULONG,)227
1452 y(TFLO)m(A)-8 b(T,)24 b(TDOUBLE.)f(Within)h(the)f(con)m(text)i(of)
f(this)f(routine,)i(TSTRING)d(corresp)s(onds)g(to)i(a)g('c)m(har*')227
1565 y(data)j(t)m(yp)s(e,)h(i.e.,)g(a)f(p)s(oin)m(ter)f(to)i(a)e(c)m
(haracter)i(arra)m(y)-8 b(.)41 b(A)26 b(n)m(ull)g(p)s(oin)m(ter)h(ma)m
(y)g(b)s(e)e(en)m(tered)i(for)f(the)h(commen)m(t)227
1678 y(parameter)k(in)f(whic)m(h)g(case)i(the)e(k)m(eyw)m(ord)h(commen)
m(t)h(\014eld)d(will)i(b)s(e)f(unmo)s(di\014ed)e(or)j(left)g(blank.)95
1953 y Fe(int)47 b(fits_write_key)d(/)k(ffpky)286 2066
y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(char)i(*keyname,)e(DTYPE)h
(*value,)477 2179 y(char)h(*comment,)e(>)j(int)f(*status\))95
2404 y(int)g(fits_update_key)d(/)j(ffuky)286 2517 y(\(fitsfile)f
(*fptr,)g(int)h(datatype,)e(char)i(*keyname,)e(DTYPE)h(*value,)477
2630 y(char)h(*comment,)e(>)j(int)f(*status\))0 2905
y Fi(2)81 b Fj(W)-8 b(rite)44 b(a)g(k)m(eyw)m(ord)f(with)g(a)h(n)m(ull)
f(or)g(unde\014ned)e(v)-5 b(alue)43 b(\(i.e.,)48 b(the)c(v)-5
b(alue)43 b(\014eld)g(in)g(the)g(k)m(eyw)m(ord)h(is)f(left)227
3018 y(blank\).)70 b(The)40 b(\014rst)f(routine)h(simply)g(app)s(ends)e
(a)j(new)e(k)m(eyw)m(ord)i(whereas)f(the)g(second)g(routine)h(will)227
3130 y(up)s(date)27 b(the)h(v)-5 b(alue)29 b(and)e(commen)m(t)i
(\014elds)e(of)h(the)g(k)m(eyw)m(ord)g(if)g(it)g(already)h(exists,)g
(otherwise)f(it)h(app)s(ends)227 3243 y(a)g(new)g(k)m(eyw)m(ord.)40
b(A)29 b(n)m(ull)g(p)s(oin)m(ter)g(ma)m(y)g(b)s(e)g(en)m(tered)g(for)g
(the)g(commen)m(t)g(parameter)h(in)e(whic)m(h)h(case)h(the)227
3356 y(k)m(eyw)m(ord)h(commen)m(t)h(\014eld)d(will)i(b)s(e)f(unmo)s
(di\014ed)e(or)j(left)g(blank.)95 3631 y Fe(int)47 b
(fits_write_key_null)c(/)k(ffpkyu)286 3744 y(\(fitsfile)f(*fptr,)g
(char)g(*keyname,)g(char)g(*comment,)g(>)h(int)g(*status\))95
3970 y(int)g(fits_update_key_null)c(/)k(ffukyu)286 4082
y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g(*comment,)g(>)h(int)g
(*status\))0 4357 y Fi(3)81 b Fj(W)-8 b(rite)40 b(\(app)s(end\))e(a)h
(COMMENT)g(or)g(HISTOR)-8 b(Y)38 b(k)m(eyw)m(ord)i(to)f(the)g(CHU.)h
(The)e(commen)m(t)i(or)f(history)227 4470 y(string)31
b(will)f(b)s(e)g(con)m(tin)m(ued)h(o)m(v)m(er)h(m)m(ultiple)f(k)m(eyw)m
(ords)g(if)f(it)h(is)f(longer)h(than)f(70)i(c)m(haracters.)95
4744 y Fe(int)47 b(fits_write_comment)c(/)48 b(ffpcom)286
4857 y(\(fitsfile)e(*fptr,)g(char)g(*comment,)g(>)h(int)g(*status\))95
5083 y(int)g(fits_write_history)c(/)48 b(ffphis)286 5196
y(\(fitsfile)e(*fptr,)g(char)g(*history,)g(>)h(int)g(*status\))0
5470 y Fi(4)81 b Fj(W)-8 b(rite)29 b(the)g(D)m(A)-8 b(TE)29
b(k)m(eyw)m(ord)g(to)g(the)g(CHU.)f(The)g(k)m(eyw)m(ord)h(v)-5
b(alue)29 b(will)f(con)m(tain)i(the)f(curren)m(t)f(system)g(date)227
5583 y(as)k(a)g(c)m(haracter)h(string)e(in)g('yyyy-mm-ddThh:mm:ss')e
(format.)44 b(If)31 b(a)h(D)m(A)-8 b(TE)32 b(k)m(eyw)m(ord)g(already)g
(exists)227 5696 y(in)c(the)f(header,)i(then)e(this)g(routine)h(will)g
(simply)f(up)s(date)g(the)h(k)m(eyw)m(ord)g(v)-5 b(alue)28
b(with)f(the)h(curren)m(t)g(date.)p eop end
%%Page: 39 47
TeXDict begin 39 46 bop 0 299 a Fh(5.4.)72 b(HEADER)31
b(KEYW)m(ORD)g(READ/WRITE)g(R)m(OUTINES)1495 b Fj(39)95
555 y Fe(int)47 b(fits_write_date)d(/)j(ffpdat)286 668
y(\(fitsfile)f(*fptr,)g(>)h(int)g(*status\))0 930 y Fi(5)81
b Fj(W)-8 b(rite)34 b(a)g(user)f(sp)s(eci\014ed)g(k)m(eyw)m(ord)h
(record)f(in)m(to)h(the)g(CHU.)g(This)e(is)i(a)g(lo)m(w{lev)m(el)i
(routine)e(whic)m(h)f(can)h(b)s(e)227 1043 y(used)f(to)h(write)f(an)m
(y)h(arbitrary)f(record)g(in)m(to)i(the)e(header.)50
b(The)32 b(record)i(m)m(ust)f(conform)g(to)h(the)g(all)g(the)227
1156 y(FITS)c(format)h(requiremen)m(ts.)95 1418 y Fe(int)47
b(fits_write_record)c(/)48 b(ffprec)286 1531 y(\(fitsfile)e(*fptr,)g
(char)g(*card,)g(>)i(int)f(*status\))0 1793 y Fi(6)81
b Fj(Up)s(date)34 b(an)g(80-c)m(haracter)j(record)e(in)f(the)g(CHU.)h
(If)f(a)h(k)m(eyw)m(ord)f(with)h(the)f(input)g(name)g(already)h
(exists,)227 1906 y(then)e(it)h(is)f(o)m(v)m(erwritten)h(b)m(y)f(the)g
(v)-5 b(alue)34 b(of)f(card.)49 b(This)32 b(could)h(mo)s(dify)f(the)i
(k)m(eyw)m(ord)f(name)g(as)h(w)m(ell)g(as)227 2019 y(the)c(v)-5
b(alue)30 b(and)e(commen)m(t)j(\014elds.)40 b(If)29 b(the)g(k)m(eyw)m
(ord)h(do)s(esn't)f(already)h(exist)g(then)g(a)f(new)g(k)m(eyw)m(ord)h
(card)227 2132 y(is)h(app)s(ended)d(to)j(the)g(header.)95
2394 y Fe(int)47 b(fits_update_card)d(/)j(ffucrd)286
2507 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g(*card,)g(>)i
(int)f(*status\))0 2769 y Fi(7)81 b Fj(Mo)s(dify)30 b(\(o)m(v)m
(erwrite\))i(the)f(commen)m(t)g(\014eld)f(of)h(an)f(existing)h(k)m(eyw)
m(ord.)95 3031 y Fe(int)47 b(fits_modify_comment)c(/)k(ffmcom)286
3144 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g(*comment,)g(>)h
(int)g(*status\))0 3406 y Fi(8)81 b Fj(W)-8 b(rite)33
b(the)f(ph)m(ysical)h(units)f(string)g(in)m(to)h(an)f(existing)h(k)m
(eyw)m(ord.)46 b(This)32 b(routine)g(uses)g(a)g(lo)s(cal)i(con)m(v)m
(en)m(tion,)227 3519 y(sho)m(wn)e(in)g(the)h(follo)m(wing)h(example,)g
(in)e(whic)m(h)g(the)h(k)m(eyw)m(ord)g(units)f(are)h(enclosed)g(in)f
(square)g(brac)m(k)m(ets)227 3632 y(in)e(the)h(b)s(eginning)f(of)g(the)
h(k)m(eyw)m(ord)g(commen)m(t)g(\014eld.)239 3894 y Fe(VELOCITY=)809
b(12.3)46 b(/)i([km/s])e(orbital)g(speed)95 4120 y(int)h
(fits_write_key_unit)c(/)k(ffpunt)286 4233 y(\(fitsfile)f(*fptr,)g
(char)g(*keyname,)g(char)g(*unit,)g(>)i(int)f(*status\))0
4495 y Fi(9)81 b Fj(Rename)30 b(an)h(existing)g(k)m(eyw)m(ord,)g
(preserving)f(the)g(curren)m(t)h(v)-5 b(alue)30 b(and)g(commen)m(t)i
(\014elds.)95 4757 y Fe(int)47 b(fits_modify_name)d(/)j(ffmnam)286
4870 y(\(fitsfile)f(*fptr,)g(char)g(*oldname,)g(char)g(*newname,)g(>)h
(int)g(*status\))0 5132 y Fi(10)f Fj(Delete)37 b(a)e(k)m(eyw)m(ord)g
(record.)54 b(The)34 b(space)i(o)s(ccupied)e(b)m(y)h(the)g(k)m(eyw)m
(ord)g(is)g(reclaimed)h(b)m(y)e(mo)m(ving)i(all)g(the)227
5245 y(follo)m(wing)e(header)f(records)f(up)g(one)h(ro)m(w)f(in)h(the)f
(header.)48 b(The)32 b(\014rst)g(routine)g(deletes)i(a)f(k)m(eyw)m(ord)
g(at)h(a)227 5357 y(sp)s(eci\014ed)23 b(p)s(osition)h(in)g(the)g
(header)f(\(the)i(\014rst)e(k)m(eyw)m(ord)h(is)g(at)g(p)s(osition)g
(1\),)i(whereas)e(the)g(second)g(routine)227 5470 y(deletes)30
b(a)f(sp)s(eci\014cally)g(named)f(k)m(eyw)m(ord.)41 b(Wild)29
b(card)f(c)m(haracters)i(ma)m(y)f(b)s(e)f(used)g(when)f(sp)s(ecifying)i
(the)227 5583 y(name)23 b(of)g(the)f(k)m(eyw)m(ord)h(to)h(b)s(e)e
(deleted.)38 b(The)22 b(third)g(routine)h(deletes)g(the)g(\(next\))h(k)
m(eyw)m(ord)f(that)g(con)m(tains)227 5696 y(the)31 b(literal)h(c)m
(haracter)g(string)e(sp)s(eci\014ed)g(b)m(y)g(the)h('string')f(argumen)
m(t.)p eop end
%%Page: 40 48
TeXDict begin 40 47 bop 0 299 a Fj(40)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_delete_record)c(/)48
b(ffdrec)286 668 y(\(fitsfile)e(*fptr,)g(int)142 b(keynum,)94
b(>)47 b(int)g(*status\))95 894 y(int)g(fits_delete_key)d(/)j(ffdkey)
286 1007 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(>)h(int)g
(*status\))95 1233 y(int)g(fits_delete_str)d(/)j(ffdstr)286
1346 y(\(fitsfile)f(*fptr,)g(char)g(*string,)g(>)h(int)g(*status\))0
1678 y Ff(5.5)135 b(Primary)46 b(Arra)l(y)f(or)g(IMA)l(GE)f(Extension)i
(I/O)f(Routines)0 1929 y Fj(These)22 b(routines)g(read)h(or)f(write)h
(data)g(v)-5 b(alues)23 b(in)f(the)g(primary)g(data)h(arra)m(y)g
(\(i.e.,)j(the)c(\014rst)g(HDU)h(in)f(a)h(FITS)e(\014le\))0
2042 y(or)32 b(an)g(IMA)m(GE)h(extension.)47 b(There)31
b(are)i(also)g(routines)f(to)h(get)g(information)f(ab)s(out)g(the)g
(data)h(t)m(yp)s(e)g(and)e(size)0 2154 y(of)c(the)g(image.)41
b(Users)27 b(should)f(also)i(read)f(the)g(follo)m(wing)h(c)m(hapter)g
(on)f(the)g(CFITSIO)e(iterator)k(function)d(whic)m(h)0
2267 y(pro)m(vides)33 b(a)h(more)f(`ob)5 b(ject)35 b(orien)m(ted')f
(metho)s(d)f(of)g(reading)g(and)g(writing)g(images.)51
b(The)32 b(iterator)j(function)e(is)0 2380 y(a)e(little)i(more)e
(complicated)h(to)g(use,)f(but)f(the)h(adv)-5 b(an)m(tages)32
b(are)f(that)h(it)f(usually)g(tak)m(es)h(less)f(co)s(de)g(to)g(p)s
(erform)0 2493 y(the)37 b(same)f(op)s(eration,)j(and)c(the)i(resulting)
f(program)g(often)h(runs)e(faster)i(b)s(ecause)f(the)g(FITS)g(\014les)g
(are)h(read)0 2606 y(and)30 b(written)g(using)g(the)h(most)f(e\016cien)
m(t)i(blo)s(c)m(k)f(size.)0 2766 y(C)25 b(programmers)h(should)f(note)h
(that)g(the)h(ordering)e(of)h(arra)m(ys)g(in)g(FITS)f(\014les,)i(and)e
(hence)h(in)g(all)g(the)g(CFITSIO)0 2879 y(calls,)40
b(is)d(more)g(similar)h(to)f(the)h(dimensionalit)m(y)g(of)f(arra)m(ys)g
(in)g(F)-8 b(ortran)38 b(rather)f(than)f(C.)h(F)-8 b(or)38
b(instance)g(if)f(a)0 2992 y(FITS)28 b(image)i(has)e(NAXIS1)h(=)f(100)i
(and)e(NAXIS2)h(=)f(50,)i(then)e(a)h(2-D)h(arra)m(y)f(just)f(large)i
(enough)e(to)i(hold)e(the)0 3105 y(image)k(should)d(b)s(e)h(declared)h
(as)f(arra)m(y[50][100])k(and)c(not)h(as)f(arra)m(y[100][50].)0
3265 y(The)h(`datat)m(yp)s(e')h(parameter)g(sp)s(eci\014es)e(the)i
(data)g(t)m(yp)s(e)f(of)g(the)g(`n)m(ulv)-5 b(al')32
b(and)f(`arra)m(y')h(p)s(oin)m(ters)f(and)f(can)i(ha)m(v)m(e)0
3378 y(one)h(of)g(the)g(follo)m(wing)h(v)-5 b(alues:)46
b(TBYTE,)33 b(TSBYTE,)f(TSHOR)-8 b(T,)32 b(TUSHOR)-8
b(T,)32 b(TINT,)h(TUINT,)f(TLONG,)0 3491 y(TLONGLONG,)26
b(TULONG,)g(TFLO)m(A)-8 b(T,)27 b(TDOUBLE.)f(Automatic)i(data)f(t)m(yp)
s(e)g(con)m(v)m(ersion)g(is)f(p)s(erformed)f(if)0 3604
y(the)j(data)h(t)m(yp)s(e)f(of)f(the)i(FITS)e(arra)m(y)h(\(as)g
(de\014ned)f(b)m(y)h(the)g(BITPIX)f(k)m(eyw)m(ord\))i(di\013ers)e(from)
h(that)g(sp)s(eci\014ed)f(b)m(y)0 3717 y('datat)m(yp)s(e'.)54
b(The)34 b(data)h(v)-5 b(alues)35 b(are)f(also)i(automatically)h
(scaled)e(b)m(y)f(the)h(BSCALE)f(and)f(BZER)m(O)h(k)m(eyw)m(ord)0
3830 y(v)-5 b(alues)31 b(as)f(they)h(are)g(b)s(eing)f(read)g(or)g
(written)h(in)f(the)g(FITS)g(arra)m(y)-8 b(.)0 4084 y
Fi(1)81 b Fj(Get)33 b(the)f(data)h(t)m(yp)s(e)f(or)g(equiv)-5
b(alen)m(t)34 b(data)f(t)m(yp)s(e)f(of)g(the)h(image.)47
b(The)32 b(\014rst)f(routine)h(returns)f(the)h(ph)m(ysical)227
4197 y(data)46 b(t)m(yp)s(e)f(of)h(the)f(FITS)f(image,)51
b(as)45 b(giv)m(en)h(b)m(y)f(the)g(BITPIX)g(k)m(eyw)m(ord,)50
b(with)44 b(allo)m(w)m(ed)j(v)-5 b(alues)46 b(of)227
4310 y(BYTE)p 492 4310 28 4 v 33 w(IMG)23 b(\(8\),)i(SHOR)-8
b(T)p 1215 4310 V 32 w(IMG)23 b(\(16\),)i(LONG)p 1934
4310 V 33 w(IMG)e(\(32\),)i(LONGLONG)p 2921 4310 V 33
w(IMG)e(\(64\),)i(FLO)m(A)-8 b(T)p 3684 4310 V 33 w(IMG)227
4423 y(\(-32\),)31 b(and)c(DOUBLE)p 1043 4423 V 33 w(IMG)h(\(-64\).)42
b(The)27 b(second)h(routine)f(is)h(similar,)h(except)g(that)f(if)g(the)
g(image)h(pixel)227 4536 y(v)-5 b(alues)33 b(are)g(scaled,)g(with)f
(non-default)h(v)-5 b(alues)32 b(for)g(the)h(BZER)m(O)f(and)g(BSCALE)f
(k)m(eyw)m(ords,)j(then)e(the)227 4649 y(routine)j(will)g(return)e(the)
i('equiv)-5 b(alen)m(t')36 b(data)f(t)m(yp)s(e)g(that)g(is)f(needed)h
(to)g(store)g(the)g(scaled)g(v)-5 b(alues.)53 b(F)-8
b(or)227 4762 y(example,)29 b(if)e(BITPIX)g(=)g(16)h(and)f(BSCALE)f(=)h
(0.1)h(then)f(the)h(equiv)-5 b(alen)m(t)28 b(data)g(t)m(yp)s(e)g(is)f
(FLO)m(A)-8 b(T)p 3659 4762 V 33 w(IMG.)227 4875 y(Similarly)25
b(if)f(BITPIX)g(=)g(16,)i(BSCALE)e(=)g(1,)i(and)d(BZER)m(O)h(=)g
(32768,)k(then)c(the)g(the)h(pixel)f(v)-5 b(alues)25
b(span)227 4987 y(the)31 b(range)g(of)f(an)g(unsigned)g(short)g(in)m
(teger)h(and)f(the)h(returned)e(data)i(t)m(yp)s(e)g(will)f(b)s(e)g
(USHOR)-8 b(T)p 3572 4987 V 32 w(IMG.)95 5242 y Fe(int)47
b(fits_get_img_type)c(/)48 b(ffgidt)286 5355 y(\(fitsfile)e(*fptr,)g(>)
h(int)g(*bitpix,)f(int)h(*status\))95 5581 y(int)g
(fits_get_img_equivtype)42 b(/)48 b(ffgiet)286 5694 y(\(fitsfile)e
(*fptr,)g(>)h(int)g(*bitpix,)f(int)h(*status\))p eop
end
%%Page: 41 49
TeXDict begin 41 48 bop 0 299 a Fh(5.5.)72 b(PRIMAR)-8
b(Y)31 b(ARRA)-8 b(Y)31 b(OR)f(IMA)m(GE)h(EXTENSION)f(I/O)g(R)m
(OUTINES)1011 b Fj(41)0 555 y Fi(2)81 b Fj(Get)34 b(the)g(n)m(um)m(b)s
(er)e(of)i(dimensions,)g(and/or)g(the)g(size)g(of)g(eac)m(h)h
(dimension)e(in)g(the)h(image)h(.)50 b(The)33 b(n)m(um)m(b)s(er)227
668 y(of)h(axes)f(in)g(the)g(image)i(is)e(giv)m(en)h(b)m(y)f(naxis,)h
(and)f(the)g(size)h(of)f(eac)m(h)i(dimension)d(is)h(giv)m(en)h(b)m(y)f
(the)h(naxes)227 781 y(arra)m(y)d(\(a)g(maxim)m(um)g(of)f(maxdim)g
(dimensions)g(will)g(b)s(e)g(returned\).)95 1036 y Fe(int)47
b(fits_get_img_dim)d(/)j(ffgidm)286 1149 y(\(fitsfile)f(*fptr,)g(>)h
(int)g(*naxis,)f(int)h(*status\))95 1375 y(int)g(fits_get_img_size)c(/)
48 b(ffgisz)286 1488 y(\(fitsfile)e(*fptr,)g(int)h(maxdim,)e(>)j(long)f
(*naxes,)e(int)i(*status\))95 1714 y(int)g(fits_get_img_sizell)c(/)k
(ffgiszll)286 1827 y(\(fitsfile)f(*fptr,)g(int)h(maxdim,)e(>)j
(LONGLONG)d(*naxes,)h(int)h(*status\))95 2052 y(int)g
(fits_get_img_param)c(/)48 b(ffgipr)286 2165 y(\(fitsfile)e(*fptr,)g
(int)h(maxdim,)e(>)j(int)f(*bitpix,)e(int)i(*naxis,)f(long)h(*naxes,)
334 2278 y(int)g(*status\))95 2504 y(int)g(fits_get_img_paramll)c(/)k
(ffgiprll)286 2617 y(\(fitsfile)f(*fptr,)g(int)h(maxdim,)e(>)j(int)f
(*bitpix,)e(int)i(*naxis,)f(LONGLONG)g(*naxes,)334 2730
y(int)h(*status\))0 2985 y Fi(3)81 b Fj(Create)23 b(a)f(new)g(primary)f
(arra)m(y)i(or)f(IMA)m(GE)i(extension)e(with)g(a)h(sp)s(eci\014ed)f
(data)h(t)m(yp)s(e)f(and)g(size.)38 b(If)22 b(the)h(FITS)227
3098 y(\014le)30 b(is)g(curren)m(tly)f(empt)m(y)h(then)g(a)g(primary)f
(arra)m(y)h(is)g(created,)h(otherwise)f(a)g(new)f(IMA)m(GE)i(extension)
f(is)227 3211 y(app)s(ended)f(to)i(the)g(\014le.)95 3466
y Fe(int)47 b(fits_create_img)d(/)j(ffcrim)286 3579 y(\()h(fitsfile)d
(*fptr,)h(int)h(bitpix,)f(int)h(naxis,)f(long)h(*naxes,)f(>)h(int)g
(*status\))95 3805 y(int)g(fits_create_imgll)c(/)48 b(ffcrimll)286
3918 y(\()g(fitsfile)d(*fptr,)h(int)h(bitpix,)f(int)h(naxis,)f
(LONGLONG)g(*naxes,)g(>)h(int)g(*status\))0 4173 y Fi(4)81
b Fj(Cop)m(y)39 b(an)f(n-dimensional)h(image)h(in)f(a)g(particular)h
(ro)m(w)f(and)f(column)h(of)g(a)g(binary)f(table)i(\(in)f(a)g(v)m
(ector)227 4286 y(column\))31 b(to)g(or)f(from)g(a)h(primary)e(arra)m
(y)i(or)g(image)g(extension.)227 4435 y(The)c('cell2image')k(routine)d
(will)g(app)s(end)e(a)i(new)f(image)i(extension)f(\(or)g(primary)f
(arra)m(y\))h(to)h(the)e(output)227 4548 y(\014le.)43
b(An)m(y)31 b(W)m(CS)g(k)m(eyw)m(ords)g(asso)s(ciated)h(with)f(the)g
(input)f(column)h(image)h(will)f(b)s(e)f(translated)i(in)m(to)g(the)227
4661 y(appropriate)j(form)g(for)g(an)f(image)j(extension.)55
b(An)m(y)35 b(other)g(k)m(eyw)m(ords)g(in)g(the)g(table)h(header)f
(that)h(are)227 4774 y(not)28 b(sp)s(eci\014cally)h(related)f(to)h
(de\014ning)e(the)g(binary)g(table)i(structure)e(or)h(to)g(other)g
(columns)g(in)f(the)h(table)227 4887 y(will)j(also)g(b)s(e)f(copied)h
(to)g(the)g(header)f(of)g(the)h(output)f(image.)227 5036
y(The)i('image2cell')k(routine)c(will)h(cop)m(y)g(the)g(input)e(image)j
(in)m(to)f(the)g(sp)s(eci\014ed)f(ro)m(w)g(and)g(column)g(of)h(the)227
5149 y(curren)m(t)e(binary)g(table)h(in)f(the)h(output)f(\014le.)44
b(The)31 b(binary)f(table)j(HDU)f(m)m(ust)f(exist)h(b)s(efore)f
(calling)i(this)227 5262 y(routine,)h(but)f(it)h(ma)m(y)f(b)s(e)g(empt)
m(y)-8 b(,)35 b(with)e(no)g(ro)m(ws)g(or)g(columns)g(of)g(data.)50
b(The)33 b(sp)s(eci\014ed)f(column)h(\(and)227 5375 y(ro)m(w\))e(will)h
(b)s(e)e(created)h(if)g(it)g(do)s(es)g(not)g(already)g(exist.)43
b(The)30 b('cop)m(yk)m(ey\015ag')j(parameter)e(con)m(trols)h(whic)m(h)
227 5488 y(k)m(eyw)m(ords)26 b(are)g(copied)g(from)f(the)g(input)g
(image)h(to)g(the)g(header)f(of)h(the)f(output)g(table:)39
b(0)26 b(=)f(no)h(k)m(eyw)m(ords)227 5601 y(will)k(b)s(e)g(copied,)g(1)
h(=)e(all)i(k)m(eyw)m(ords)f(will)g(b)s(e)f(copied)h(\(except)i(those)e
(k)m(eyw)m(ords)g(that)h(w)m(ould)e(b)s(e)g(in)m(v)-5
b(alid)227 5714 y(in)30 b(the)h(table)g(header\),)g(and)f(2)g(=)g(cop)m
(y)i(only)e(the)h(W)m(CS)f(k)m(eyw)m(ords.)p eop end
%%Page: 42 50
TeXDict begin 42 49 bop 0 299 a Fj(42)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_copy_cell2image)286
668 y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(char)i(*colname,)e
(long)i(rownum,)334 781 y(>)h(int)e(*status\))95 1007
y(int)h(fits_copy_image2cell)286 1120 y(\(fitsfile)f(*infptr,)f
(fitsfile)h(*outfptr,)f(char)i(*colname,)e(long)i(rownum,)334
1233 y(int)g(copykeyflag)e(>)i(int)g(*status\))0 1474
y Fi(5)81 b Fj(W)-8 b(rite)40 b(a)f(rectangular)g(subimage)g(\(or)g
(the)g(whole)g(image\))h(to)f(the)g(FITS)f(data)h(arra)m(y)-8
b(.)67 b(The)38 b(fpixel)h(and)227 1587 y(lpixel)30 b(arra)m(ys)g(giv)m
(e)h(the)f(co)s(ordinates)g(of)f(the)h(\014rst)f(\(lo)m(w)m(er)i(left)f
(corner\))g(and)f(last)h(\(upp)s(er)e(righ)m(t)i(corner\))227
1700 y(pixels)h(in)f(FITS)g(image)h(to)g(b)s(e)f(written)g(to.)95
1941 y Fe(int)47 b(fits_write_subset)c(/)48 b(ffpss)286
2054 y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(long)i(*fpixel,)e(long)i
(*lpixel,)334 2167 y(DTYPE)f(*array,)g(>)i(int)f(*status\))0
2408 y Fi(6)81 b Fj(W)-8 b(rite)39 b(pixels)g(in)m(to)g(the)g(FITS)f
(data)h(arra)m(y)-8 b(.)66 b('fpixel')39 b(is)f(an)g(arra)m(y)h(of)g
(length)g(NAXIS)f(whic)m(h)g(giv)m(es)i(the)227 2521
y(co)s(ordinate)k(of)f(the)g(starting)g(pixel)g(to)h(b)s(e)e(written)h
(to,)j(suc)m(h)d(that)g(fpixel[0])h(is)f(in)f(the)h(range)g(1)g(to)227
2634 y(NAXIS1,)34 b(fpixel[1])f(is)g(in)f(the)g(range)h(1)g(to)g
(NAXIS2,)g(etc.)48 b(The)32 b(\014rst)g(pair)g(of)h(routines)f(simply)g
(writes)227 2747 y(the)40 b(arra)m(y)g(of)g(pixels)f(to)i(the)e(FITS)g
(\014le)h(\(doing)g(data)g(t)m(yp)s(e)g(con)m(v)m(ersion)h(if)e
(necessary\))h(whereas)g(the)227 2860 y(second)c(routines)g(will)g
(substitute)f(the)h(appropriate)g(FITS)f(n)m(ull)g(v)-5
b(alue)37 b(for)e(an)m(y)h(elemen)m(ts)h(whic)m(h)f(are)227
2973 y(equal)41 b(to)g(the)f(input)g(v)-5 b(alue)40 b(of)h(n)m(ulv)-5
b(al)40 b(\(note)h(that)g(this)f(parameter)h(giv)m(es)h(the)e(address)f
(of)i(the)f(n)m(ull)227 3086 y(v)-5 b(alue,)36 b(not)f(the)f(n)m(ull)g
(v)-5 b(alue)35 b(itself)7 b(\).)53 b(F)-8 b(or)35 b(in)m(teger)h(FITS)
d(arra)m(ys,)j(the)f(FITS)e(n)m(ull)h(v)-5 b(alue)35
b(is)f(de\014ned)f(b)m(y)227 3199 y(the)26 b(BLANK)f(k)m(eyw)m(ord)h
(\(an)g(error)f(is)g(returned)f(if)i(the)f(BLANK)h(k)m(eyw)m(ord)g(do)s
(esn't)f(exist\).)40 b(F)-8 b(or)26 b(\015oating)227
3312 y(p)s(oin)m(t)g(FITS)f(arra)m(ys)h(the)g(sp)s(ecial)g(IEEE)f(NaN)i
(\(Not-a-Num)m(b)s(er\))g(v)-5 b(alue)26 b(will)g(b)s(e)f(written)h(in)
m(to)h(the)f(FITS)227 3425 y(\014le.)66 b(If)38 b(a)h(n)m(ull)f(p)s
(oin)m(ter)h(is)f(en)m(tered)h(for)g(n)m(ulv)-5 b(al,)41
b(then)d(the)h(n)m(ull)f(v)-5 b(alue)39 b(is)g(ignored)g(and)e(this)i
(routine)227 3537 y(b)s(eha)m(v)m(es)31 b(the)g(same)g(as)f(\014ts)p
1189 3537 28 4 v 33 w(write)p 1424 3537 V 33 w(pix.)95
3779 y Fe(int)47 b(fits_write_pix)d(/)k(ffppx)286 3892
y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(long)i(*fpixel,)e(LONGLONG)h
(nelements,)334 4005 y(DTYPE)g(*array,)g(int)h(*status\);)95
4231 y(int)g(fits_write_pixll)d(/)j(ffppxll)286 4343
y(\(fitsfile)f(*fptr,)g(int)h(datatype,)e(LONGLONG)g(*fpixel,)h
(LONGLONG)g(nelements,)334 4456 y(DTYPE)g(*array,)g(int)h(*status\);)95
4682 y(int)g(fits_write_pixnull)c(/)48 b(ffppxn)286 4795
y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(long)i(*fpixel,)e(LONGLONG)h
(nelements,)334 4908 y(DTYPE)g(*array,)g(DTYPE)h(*nulval,)e(>)j(int)f
(*status\);)95 5134 y(int)g(fits_write_pixnullll)c(/)k(ffppxnll)286
5247 y(\(fitsfile)f(*fptr,)g(int)h(datatype,)e(LONGLONG)g(*fpixel,)h
(LONGLONG)g(nelements,)334 5360 y(DTYPE)g(*array,)g(DTYPE)h(*nulval,)e
(>)j(int)f(*status\);)0 5601 y Fi(7)81 b Fj(Set)24 b(FITS)g(data)i
(arra)m(y)f(elemen)m(ts)h(equal)f(to)g(the)g(appropriate)f(n)m(ull)h
(pixel)g(v)-5 b(alue.)39 b(F)-8 b(or)25 b(in)m(teger)h(FITS)e(arra)m
(ys,)227 5714 y(the)34 b(FITS)e(n)m(ull)h(v)-5 b(alue)34
b(is)f(de\014ned)f(b)m(y)h(the)h(BLANK)f(k)m(eyw)m(ord)h(\(an)f(error)g
(is)g(returned)f(if)h(the)h(BLANK)p eop end
%%Page: 43 51
TeXDict begin 43 50 bop 0 299 a Fh(5.5.)72 b(PRIMAR)-8
b(Y)31 b(ARRA)-8 b(Y)31 b(OR)f(IMA)m(GE)h(EXTENSION)f(I/O)g(R)m
(OUTINES)1011 b Fj(43)227 555 y(k)m(eyw)m(ord)23 b(do)s(esn't)g
(exist\).)39 b(F)-8 b(or)23 b(\015oating)g(p)s(oin)m(t)g(FITS)f(arra)m
(ys)g(the)h(sp)s(ecial)g(IEEE)f(NaN)h(\(Not-a-Num)m(b)s(er\))227
668 y(v)-5 b(alue)34 b(will)f(b)s(e)g(written)g(in)m(to)h(the)g(FITS)e
(\014le.)49 b(Note)34 b(that)g('\014rstelem')g(is)f(a)h(scalar)g
(giving)g(the)f(o\013set)h(to)227 781 y(the)d(\014rst)e(pixel)i(to)g(b)
s(e)f(written)g(in)h(the)f(equiv)-5 b(alen)m(t)32 b(1-dimensional)f
(arra)m(y)g(of)g(image)g(pixels.)95 1034 y Fe(int)47
b(fits_write_null_img)c(/)k(ffpprn)286 1147 y(\(fitsfile)f(*fptr,)g
(LONGLONG)f(firstelem,)g(LONGLONG)h(nelements,)f(>)i(int)g(*status\))0
1399 y Fi(8)81 b Fj(Read)33 b(a)h(rectangular)h(subimage)f(\(or)g(the)g
(whole)g(image\))h(from)e(the)h(FITS)f(data)h(arra)m(y)-8
b(.)52 b(The)33 b(fpixel)h(and)227 1512 y(lpixel)c(arra)m(ys)g(giv)m(e)
h(the)f(co)s(ordinates)g(of)f(the)h(\014rst)f(\(lo)m(w)m(er)i(left)f
(corner\))g(and)f(last)h(\(upp)s(er)e(righ)m(t)i(corner\))227
1625 y(pixels)d(to)h(b)s(e)e(read)h(from)g(the)g(FITS)f(image.)41
b(Unde\014ned)25 b(FITS)h(arra)m(y)i(elemen)m(ts)g(will)f(b)s(e)f
(returned)g(with)227 1738 y(a)k(v)-5 b(alue)30 b(=)e(*n)m(ullv)-5
b(al,)31 b(\(note)f(that)g(this)f(parameter)h(giv)m(es)g(the)g(address)
e(of)h(the)h(n)m(ull)f(v)-5 b(alue,)30 b(not)g(the)f(n)m(ull)227
1851 y(v)-5 b(alue)36 b(itself)7 b(\))37 b(unless)e(n)m(ulv)-5
b(al)36 b(=)g(0)g(or)f(*n)m(ulv)-5 b(al)37 b(=)e(0,)j(in)d(whic)m(h)g
(case)i(no)f(c)m(hec)m(ks)h(for)e(unde\014ned)f(pixels)227
1964 y(will)d(b)s(e)f(p)s(erformed.)95 2216 y Fe(int)47
b(fits_read_subset)d(/)j(ffgsv)286 2329 y(\(fitsfile)f(*fptr,)g(int)94
b(datatype,)46 b(long)g(*fpixel,)g(long)g(*lpixel,)g(long)h(*inc,)334
2442 y(DTYPE)f(*nulval,)g(>)h(DTYPE)g(*array,)f(int)h(*anynul,)e(int)i
(*status\))0 2695 y Fi(9)81 b Fj(Read)32 b(pixels)h(from)f(the)g(FITS)g
(data)h(arra)m(y)-8 b(.)48 b('fpixel')33 b(is)g(the)f(starting)h(pixel)
g(lo)s(cation)h(and)e(is)h(an)f(arra)m(y)h(of)227 2808
y(length)h(NAXIS)f(suc)m(h)g(that)h(fpixel[0])g(is)f(in)g(the)h(range)f
(1)h(to)g(NAXIS1,)g(fpixel[1])g(is)g(in)f(the)g(range)h(1)f(to)227
2921 y(NAXIS2,)c(etc.)41 b(The)28 b(nelemen)m(ts)h(parameter)f(sp)s
(eci\014es)g(the)g(n)m(um)m(b)s(er)f(of)h(pixels)h(to)g(read.)39
b(If)28 b(fpixel)g(is)g(set)227 3034 y(to)36 b(the)f(\014rst)f(pixel,)j
(and)e(nelemen)m(ts)g(is)g(set)h(equal)g(to)f(the)g(NAXIS1)h(v)-5
b(alue,)37 b(then)d(this)h(routine)g(w)m(ould)227 3147
y(read)28 b(the)g(\014rst)f(ro)m(w)h(of)g(the)h(image.)41
b(Alternativ)m(ely)-8 b(,)31 b(if)d(nelemen)m(ts)h(is)f(set)g(equal)h
(to)f(NAXIS1)g(*)h(NAXIS2)227 3260 y(then)h(it)h(w)m(ould)f(read)h(an)f
(en)m(tire)h(2D)g(image,)h(or)f(the)f(\014rst)g(plane)g(of)h(a)g(3-D)g
(datacub)s(e.)227 3409 y(The)38 b(\014rst)g(2)h(routines)f(will)h
(return)f(an)m(y)h(unde\014ned)d(pixels)j(in)f(the)h(FITS)e(arra)m(y)i
(equal)g(to)h(the)e(v)-5 b(alue)227 3522 y(of)36 b(*n)m(ullv)-5
b(al)36 b(\(note)g(that)g(this)f(parameter)h(giv)m(es)g(the)g(address)e
(of)i(the)f(n)m(ull)g(v)-5 b(alue,)37 b(not)f(the)f(n)m(ull)g(v)-5
b(alue)227 3634 y(itself)7 b(\))34 b(unless)d(n)m(ulv)-5
b(al)32 b(=)g(0)g(or)h(*n)m(ulv)-5 b(al)32 b(=)g(0,)h(in)f(whic)m(h)g
(case)h(no)f(c)m(hec)m(ks)h(for)f(unde\014ned)e(pixels)i(will)h(b)s(e)
227 3747 y(p)s(erformed.)42 b(The)31 b(second)h(2)f(routines)h(are)f
(similar)h(except)g(that)g(an)m(y)g(unde\014ned)d(pixels)i(will)h(ha)m
(v)m(e)h(the)227 3860 y(corresp)s(onding)d(n)m(ullarra)m(y)g(elemen)m
(t)i(set)f(equal)g(to)g(TR)m(UE)g(\(=)f(1\).)95 4113
y Fe(int)47 b(fits_read_pix)e(/)i(ffgpxv)286 4226 y(\(fitsfile)f
(*fptr,)g(int)94 b(datatype,)46 b(long)g(*fpixel,)g(LONGLONG)f
(nelements,)334 4339 y(DTYPE)h(*nulval,)g(>)h(DTYPE)g(*array,)f(int)h
(*anynul,)e(int)i(*status\))95 4565 y(int)g(fits_read_pixll)d(/)j
(ffgpxvll)286 4677 y(\(fitsfile)f(*fptr,)g(int)94 b(datatype,)46
b(LONGLONG)f(*fpixel,)h(LONGLONG)f(nelements,)334 4790
y(DTYPE)h(*nulval,)g(>)h(DTYPE)g(*array,)f(int)h(*anynul,)e(int)i
(*status\))95 5016 y(int)g(fits_read_pixnull)c(/)48 b(ffgpxf)286
5129 y(\(fitsfile)e(*fptr,)g(int)94 b(datatype,)46 b(long)g(*fpixel,)g
(LONGLONG)f(nelements,)334 5242 y(>)j(DTYPE)e(*array,)g(char)g
(*nullarray,)f(int)i(*anynul,)f(int)g(*status\))95 5468
y(int)h(fits_read_pixnullll)c(/)k(ffgpxfll)286 5581 y(\(fitsfile)f
(*fptr,)g(int)94 b(datatype,)46 b(LONGLONG)f(*fpixel,)h(LONGLONG)f
(nelements,)334 5694 y(>)j(DTYPE)e(*array,)g(char)g(*nullarray,)f(int)i
(*anynul,)f(int)g(*status\))p eop end
%%Page: 44 52
TeXDict begin 44 51 bop 0 299 a Fj(44)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fi(10)46 b Fj(Cop)m(y)36 b(a)g(rectangular)h
(section)g(of)g(an)e(image)j(and)d(write)h(it)h(to)f(a)h(new)e(FITS)g
(primary)g(image)j(or)e(image)227 668 y(extension.)49
b(The)32 b(new)g(image)i(HDU)g(is)e(app)s(ended)f(to)j(the)f(end)f(of)h
(the)g(output)f(\014le;)i(all)g(the)f(k)m(eyw)m(ords)227
781 y(in)39 b(the)f(input)g(image)i(will)f(b)s(e)f(copied)h(to)g(the)g
(output)f(image.)66 b(The)38 b(common)h(W)m(CS)g(k)m(eyw)m(ords)g(will)
227 894 y(b)s(e)34 b(up)s(dated)f(if)i(necessary)g(to)g(corresp)s(ond)e
(to)j(the)e(co)s(ordinates)h(of)g(the)g(section.)54 b(The)34
b(format)h(of)g(the)227 1007 y(section)29 b(expression)e(is)g(same)g
(as)h(sp)s(ecifying)f(an)g(image)h(section)h(using)d(the)i(extended)f
(\014le)g(name)g(syn)m(tax)227 1120 y(\(see)32 b("Image)f(Section")h
(in)e(Chapter)g(10\).)42 b(\(Examples:)f("1:100,1:200",)36
b("1:100:2,)d(1:*:2",)g("*,)f(-*"\).)95 1405 y Fe(int)47
b(fits_copy_image_section)42 b(/)47 b(ffcpimg)286 1518
y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(char)i(*section,)e
(int)i(*status\))0 1881 y Ff(5.6)135 b(Image)46 b(Compression)0
2138 y Fj(CFITSIO)29 b(transparen)m(tly)h(supp)s(orts)f(the)h(2)h
(metho)s(ds)f(of)g(image)i(compression)e(describ)s(ed)g(b)s(elo)m(w.)0
2298 y(1\))45 b(The)f(en)m(tire)i(FITS)e(\014le)h(ma)m(y)g(b)s(e)f
(externally)i(compressed)e(with)g(the)h(gzip)g(or)g(Unix)f(compress)h
(utilit)m(y)0 2411 y(programs,)37 b(pro)s(ducing)d(a)j(*.gz)g(or)f(*.Z)
g(\014le,)h(resp)s(ectiv)m(ely)-8 b(.)59 b(When)36 b(reading)g
(compressed)f(\014les)h(of)g(this)g(t)m(yp)s(e,)0 2524
y(CFITSIO)43 b(\014rst)h(uncompresses)f(the)i(en)m(tire)g(\014le)g(in)m
(to)g(memory)g(b)s(efore)f(p)s(erforming)f(the)i(requested)f(read)0
2636 y(op)s(erations.)c(Output)28 b(\014les)g(can)h(b)s(e)f(directly)i
(written)e(in)g(the)h(gzip)g(compressed)g(format)g(if)f(the)h(user-sp)s
(eci\014ed)0 2749 y(\014lename)35 b(ends)e(with)i(`.gz'.)54
b(In)34 b(this)g(case,)j(CFITSIO)c(initially)j(writes)e(the)h
(uncompressed)e(\014le)i(in)f(memory)0 2862 y(and)j(then)g(compresses)g
(it)h(and)f(writes)g(it)h(to)g(disk)f(when)f(the)i(FITS)f(\014le)g(is)g
(closed,)k(th)m(us)36 b(sa)m(ving)j(user)d(disk)0 2975
y(space.)59 b(Read)36 b(and)g(write)h(access)g(to)g(these)g(compressed)
f(FITS)g(\014les)g(is)g(generally)i(quite)e(fast)h(since)g(all)g(the)0
3088 y(I/O)28 b(is)g(p)s(erformed)e(in)i(memory;)h(the)f(main)g
(limitation)i(with)e(this)f(tec)m(hnique)i(is)f(that)h(there)f(m)m(ust)
g(b)s(e)f(enough)0 3201 y(a)m(v)-5 b(ailable)33 b(memory)d(\(or)h(sw)m
(ap)f(space\))h(to)g(hold)f(the)h(en)m(tire)g(uncompressed)e(FITS)h
(\014le.)0 3361 y(2\))42 b(CFITSIO)d(also)j(supp)s(orts)d(the)j(FITS)e
(tiled)h(image)i(compression)e(con)m(v)m(en)m(tion)i(in)e(whic)m(h)f
(the)i(image)g(is)0 3474 y(sub)s(divided)30 b(in)m(to)j(a)f(grid)g(of)g
(rectangular)i(tiles,)f(and)f(eac)m(h)h(tile)g(of)g(pixels)f(is)g
(individually)g(compressed.)45 b(The)0 3587 y(details)33
b(of)f(this)g(FITS)f(compression)h(con)m(v)m(en)m(tion)j(are)d(describ)
s(ed)f(at)i(the)f(FITS)f(Supp)s(ort)f(O\016ce)i(w)m(eb)g(site)h(at)0
3700 y(h)m(ttp://\014ts.gsfc.nasa.go)m(v/\014ts)p 1114
3700 28 4 v 37 w(registry)-8 b(.h)m(tml)33 b(Basically)-8
b(,)35 b(the)d(compressed)g(image)h(tiles)f(are)h(stored)e(in)h(ro)m
(ws)0 3813 y(of)i(a)h(v)-5 b(ariable)35 b(length)f(arra)m(y)h(column)f
(in)f(a)i(FITS)e(binary)g(table,)k(ho)m(w)m(ev)m(er)e(CFITSIO)e
(recognizes)i(that)g(this)0 3926 y(binary)i(table)i(extension)f(con)m
(tains)h(an)e(image)i(and)e(treats)i(it)f(as)g(if)g(it)g(w)m(ere)g(an)g
(IMA)m(GE)g(extension.)64 b(This)0 4039 y(tile-compressed)37
b(format)f(is)f(esp)s(ecially)i(w)m(ell)g(suited)e(for)h(compressing)f
(v)m(ery)h(large)h(images)g(b)s(ecause)e(a\))i(the)0
4152 y(FITS)28 b(header)h(k)m(eyw)m(ords)h(remain)f(uncompressed)e(for)
i(rapid)g(read)g(access,)h(and)f(b)s(ecause)g(b\))g(it)g(is)h(p)s
(ossible)e(to)0 4264 y(extract)f(and)e(uncompress)g(sections)i(of)f
(the)g(image)h(without)e(ha)m(ving)i(to)f(uncompress)f(the)h(en)m(tire)
g(image.)41 b(This)0 4377 y(format)34 b(is)g(also)h(m)m(uc)m(h)e(more)h
(e\013ectiv)m(e)j(in)c(compressing)h(\015oating)h(p)s(oin)m(t)e(images)
i(than)f(simply)f(compressing)0 4490 y(the)39 b(image)i(using)d(gzip)i
(or)f(compress)g(b)s(ecause)g(it)h(appro)m(ximates)g(the)g(\015oating)g
(p)s(oin)m(t)f(v)-5 b(alues)39 b(with)g(scaled)0 4603
y(in)m(tegers)32 b(whic)m(h)e(can)g(then)g(b)s(e)g(compressed)g(more)h
(e\016cien)m(tly)-8 b(.)0 4763 y(Curren)m(tly)41 b(CFITSIO)e(supp)s
(orts)h(3)h(general)i(purp)s(ose)c(compression)i(algorithms)i(plus)d
(one)i(other)f(sp)s(ecial-)0 4876 y(purp)s(ose)31 b(compression)i(tec)m
(hnique)h(that)f(is)g(designed)g(for)g(data)g(masks)g(with)g(p)s
(ositiv)m(e)h(in)m(teger)g(pixel)f(v)-5 b(alues.)0 4989
y(The)40 b(3)g(general)h(purp)s(ose)e(algorithms)i(are)f(GZIP)-8
b(,)41 b(Rice,)j(and)39 b(HCOMPRESS,)g(and)h(the)g(sp)s(ecial)h(purp)s
(ose)0 5102 y(algorithm)32 b(is)g(the)f(IRAF)h(pixel)f(list)h
(compression)f(tec)m(hnique)h(\(PLIO\).)g(In)e(principle,)i(an)m(y)f(n)
m(um)m(b)s(er)f(of)i(other)0 5215 y(compression)e(algorithms)i(could)e
(also)h(b)s(e)f(supp)s(orted)f(b)m(y)h(the)g(FITS)g(tiled)h(image)h
(compression)e(con)m(v)m(en)m(tion.)0 5375 y(The)35 b(FITS)g(image)h
(can)g(b)s(e)f(sub)s(divided)e(in)m(to)k(an)m(y)f(desired)f
(rectangular)h(grid)f(of)h(compression)f(tiles.)57 b(With)0
5488 y(the)32 b(GZIP)-8 b(,)33 b(Rice,)h(and)e(PLIO)f(algorithms,)j
(the)e(default)h(is)f(to)h(tak)m(e)h(eac)m(h)g(ro)m(w)e(of)h(the)f
(image)i(as)e(a)h(tile.)47 b(The)0 5601 y(HCOMPRESS)25
b(algorithm)i(is)g(inheren)m(tly)f(2-dimensional)h(in)f(nature,)i(so)e
(the)h(default)f(in)g(this)g(case)i(is)e(to)h(tak)m(e)0
5714 y(16)h(ro)m(ws)g(of)f(the)h(image)h(p)s(er)d(tile.)41
b(In)27 b(most)h(cases)g(it)g(mak)m(es)h(little)g(di\013erence)f(what)f
(tiling)i(pattern)f(is)f(used,)h(so)p eop end
%%Page: 45 53
TeXDict begin 45 52 bop 0 299 a Fh(5.6.)72 b(IMA)m(GE)31
b(COMPRESSION)2567 b Fj(45)0 555 y(the)33 b(default)g(tiles)g(are)g
(usually)g(adequate.)48 b(In)32 b(the)h(case)g(of)g(v)m(ery)g(small)g
(images,)i(it)e(could)g(b)s(e)f(more)g(e\016cien)m(t)0
668 y(to)h(compress)f(the)h(whole)f(image)i(as)e(a)h(single)g(tile.)48
b(Note)34 b(that)f(the)f(image)i(dimensions)d(are)i(not)g(required)e
(to)0 781 y(b)s(e)d(an)g(in)m(teger)i(m)m(ultiple)f(of)f(the)h(tile)g
(dimensions;)g(if)f(not,)i(then)e(the)g(tiles)i(at)f(the)f(edges)h(of)g
(the)f(image)i(will)f(b)s(e)0 894 y(smaller)i(than)f(the)h(other)f
(tiles.)0 1054 y(The)41 b(4)g(supp)s(orted)f(image)i(compression)f
(algorithms)h(are)g(all)g('loss-less')h(when)d(applied)h(to)h(in)m
(teger)h(FITS)0 1167 y(images;)25 b(the)c(pixel)g(v)-5
b(alues)20 b(are)h(preserv)m(ed)f(exactly)j(with)d(no)g(loss)h(of)f
(information)h(during)e(the)i(compression)g(and)0 1280
y(uncompression)34 b(pro)s(cess.)54 b(In)34 b(addition,)j(the)e
(HCOMPRESS)f(algorithm)i(supp)s(orts)d(a)i('lossy')h(compression)0
1393 y(mo)s(de)41 b(that)h(will)g(pro)s(duce)f(larger)h(amoun)m(t)g(of)
g(image)h(compression.)74 b(This)41 b(is)g(ac)m(hiev)m(ed)j(b)m(y)d(sp)
s(ecifying)h(a)0 1506 y(non-zero)32 b(v)-5 b(alue)32
b(for)f(the)g(HCOMPRESS)f(\\scale")k(parameter.)44 b(Since)31
b(the)g(amoun)m(t)h(of)g(compression)f(that)h(is)0 1619
y(ac)m(hiev)m(ed)g(dep)s(ends)d(directly)i(on)f(the)h(RMS)f(noise)h(in)
f(the)h(image,)h(it)f(is)g(usually)f(more)g(con)m(v)m(en)m(tion)j(to)e
(sp)s(ecify)0 1732 y(the)f(HCOMPRESS)e(scale)i(factor)h(relativ)m(e)g
(to)f(the)g(RMS)f(noise.)41 b(Setting)30 b(s)f(=)g(2.5)i(means)e(use)g
(a)h(scale)h(factor)0 1844 y(that)h(is)f(2.5)i(times)e(the)h
(calculated)h(RMS)e(noise)h(in)f(the)g(image)i(tile.)44
b(In)31 b(some)g(cases)h(it)g(ma)m(y)g(b)s(e)f(desirable)g(to)0
1957 y(sp)s(ecify)h(the)g(exact)i(scaling)f(to)g(b)s(e)e(used,)h
(instead)h(of)f(sp)s(ecifying)g(it)g(relativ)m(e)j(to)d(the)h
(calculated)h(noise)e(v)-5 b(alue.)0 2070 y(This)37 b(ma)m(y)h(b)s(e)f
(done)g(b)m(y)h(sp)s(ecifying)f(the)h(negativ)m(e)i(of)d(desired)g
(scale)i(v)-5 b(alue)38 b(\(t)m(ypically)i(in)d(the)h(range)g(-2)g(to)0
2183 y(-100\).)0 2343 y(V)-8 b(ery)43 b(high)g(compression)f(factors)i
(\(of)f(100)h(or)f(more\))g(can)g(b)s(e)f(ac)m(hiev)m(ed)j(b)m(y)d
(using)h(large)g(HCOMPRESS)0 2456 y(scale)31 b(v)-5 b(alues,)31
b(ho)m(w)m(ev)m(er,)h(this)e(can)g(pro)s(duce)f(undesirable)g(\\blo)s
(c)m(ky")j(artifacts)f(in)f(the)g(compressed)g(image.)42
b(A)0 2569 y(v)-5 b(ariation)27 b(of)g(the)f(HCOMPRESS)f(algorithm)i
(\(called)h(HSCOMPRESS\))c(can)i(b)s(e)g(used)f(in)h(this)g(case)h(to)g
(apply)0 2682 y(a)f(small)h(amoun)m(t)f(of)h(smo)s(othing)f(of)g(the)g
(image)h(when)e(it)i(is)f(uncompressed)f(to)h(help)g(co)m(v)m(er)i(up)d
(these)h(artifacts.)0 2795 y(This)36 b(smo)s(othing)h(is)g(purely)f
(cosmetic)j(and)d(do)s(es)h(not)g(cause)g(an)m(y)h(signi\014can)m(t)g
(c)m(hange)g(to)f(the)g(image)i(pixel)0 2908 y(v)-5 b(alues.)0
3068 y(Floating)34 b(p)s(oin)m(t)f(FITS)e(images)j(\(whic)m(h)e(ha)m(v)
m(e)i(BITPIX)e(=)g(-32)h(or)g(-64\))g(usually)f(con)m(tain)i(to)s(o)f
(m)m(uc)m(h)g(\\noise")0 3181 y(in)k(the)g(least)i(signi\014can)m(t)f
(bits)f(of)h(the)f(man)m(tissa)h(of)g(the)f(pixel)h(v)-5
b(alues)37 b(to)h(b)s(e)f(e\013ectiv)m(ely)j(compressed)d(with)0
3294 y(an)m(y)d(lossless)g(algorithm.)52 b(Consequen)m(tly)-8
b(,)35 b(\015oating)g(p)s(oin)m(t)e(images)i(are)f(\014rst)f(quan)m
(tized)h(in)m(to)h(scaled)g(in)m(teger)0 3407 y(pixel)26
b(v)-5 b(alues)25 b(\(and)g(th)m(us)g(thro)m(wing)h(a)m(w)m(a)m(y)h(m)m
(uc)m(h)e(of)h(the)f(noise\))h(b)s(efore)f(b)s(eing)g(compressed)g
(with)g(the)h(sp)s(eci\014ed)0 3520 y(algorithm)d(\(either)g(GZIP)-8
b(,)23 b(Rice,)i(or)d(HCOMPRESS\).)f(This)h(tec)m(hnique)h(pro)s(duces)
e(m)m(uc)m(h)h(higher)g(compression)0 3633 y(factors)33
b(than)e(simply)g(using)g(the)h(GZIP)g(utilit)m(y)h(to)f(externally)h
(compress)f(the)f(whole)h(FITS)f(\014le,)i(but)e(it)h(also)0
3745 y(means)d(that)h(the)g(original)g(\015oating)g(v)-5
b(alue)30 b(pixel)f(v)-5 b(alues)30 b(are)g(not)f(exactly)i(preserv)m
(ed.)40 b(When)29 b(done)g(prop)s(erly)-8 b(,)0 3858
y(this)33 b(in)m(teger)h(scaling)f(tec)m(hnique)h(will)f(only)f
(discard)h(the)f(insigni\014can)m(t)i(noise)f(while)g(still)g
(preserving)f(all)i(the)0 3971 y(real)43 b(information)f(in)g(the)h
(image.)77 b(The)42 b(amoun)m(t)g(of)h(precision)f(that)h(is)f
(retained)h(in)e(the)i(pixel)f(v)-5 b(alues)43 b(is)0
4084 y(con)m(trolled)37 b(b)m(y)d(the)i("quan)m(tization)h(lev)m(el")g
(parameter,)g(q.)54 b(Larger)35 b(v)-5 b(alues)36 b(of)f(q)f(will)i
(result)f(in)f(compressed)0 4197 y(images)h(whose)e(pixels)h(more)f
(closely)i(matc)m(h)g(the)e(\015oating)i(p)s(oin)m(t)e(pixel)h(v)-5
b(alues,)35 b(but)e(at)h(the)g(same)g(time)g(the)0 4310
y(amoun)m(t)j(of)f(compression)g(that)h(is)f(ac)m(hiev)m(ed)i(will)f(b)
s(e)e(reduced.)58 b(Users)36 b(should)f(exp)s(erimen)m(t)i(with)e
(di\013eren)m(t)0 4423 y(v)-5 b(alues)25 b(for)g(this)g(parameter)g(to)
h(determine)f(the)g(optimal)h(v)-5 b(alue)25 b(that)h(preserv)m(es)f
(all)h(the)f(useful)f(information)h(in)0 4536 y(the)k(image,)h(without)
f(needlessly)g(preserving)f(all)h(the)g(\\noise")h(whic)m(h)e(will)h(h)
m(urt)f(the)h(compression)f(e\016ciency)-8 b(.)0 4696
y(The)38 b(default)g(v)-5 b(alue)38 b(for)g(the)g(quan)m(tization)i
(scale)g(factor)f(is)f(16.,)j(whic)m(h)d(means)g(that)g(scaled)h(in)m
(teger)h(pixel)0 4809 y(v)-5 b(alues)38 b(will)g(b)s(e)g(quan)m(tized)g
(suc)m(h)g(that)g(the)g(di\013erence)h(b)s(et)m(w)m(een)f(adjacen)m(t)h
(in)m(teger)h(v)-5 b(alues)38 b(will)g(b)s(e)f(1/16th)0
4922 y(of)e(the)h(noise)f(lev)m(el)i(in)e(the)g(image)h(bac)m(kground.)
55 b(CFITSIO)34 b(uses)g(an)h(optimized)h(algorithm)g(to)g(accurately)0
5035 y(estimate)41 b(the)e(noise)h(in)f(the)g(image.)68
b(As)39 b(an)g(example,)k(if)c(the)g(RMS)g(noise)g(in)g(the)h(bac)m
(kground)e(pixels)i(of)0 5148 y(an)35 b(image)h(=)f(32.0,)j(then)d(the)
h(spacing)f(b)s(et)m(w)m(een)h(adjacen)m(t)g(scaled)g(in)m(teger)h
(pixel)e(v)-5 b(alues)36 b(will)f(equal)h(2.0)g(b)m(y)0
5261 y(default.)63 b(Note)38 b(that)h(the)e(RMS)h(noise)g(is)f(indep)s
(enden)m(tly)g(calculated)j(for)d(eac)m(h)i(tile)f(of)g(the)g(image,)j
(so)d(the)0 5373 y(resulting)24 b(in)m(teger)i(scaling)f(factor)g(ma)m
(y)g(\015uctuate)g(sligh)m(tly)g(for)f(eac)m(h)i(tile.)40
b(In)23 b(some)i(cases)g(it)f(ma)m(y)h(b)s(e)f(desirable)0
5486 y(to)29 b(sp)s(ecify)f(the)h(exact)h(quan)m(tization)h(lev)m(el)f
(to)f(b)s(e)f(used,)g(instead)h(of)g(sp)s(ecifying)f(it)h(relativ)m(e)i
(to)e(the)g(calculated)0 5599 y(noise)42 b(v)-5 b(alue.)73
b(This)40 b(ma)m(y)i(b)s(e)f(done)f(b)m(y)h(sp)s(ecifying)g(the)h
(negativ)m(e)h(of)e(desired)g(quan)m(tization)i(lev)m(el)g(for)e(the)0
5712 y(v)-5 b(alue)29 b(of)h(q.)40 b(In)28 b(the)h(previous)g(example,)
h(one)f(could)g(sp)s(ecify)g(q)f(=)h(-2.0)h(so)g(that)f(the)g(quan)m
(tized)h(in)m(teger)g(lev)m(els)p eop end
%%Page: 46 54
TeXDict begin 46 53 bop 0 299 a Fj(46)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fj(di\013er)f(b)m(y)g(2.0.)42 b(Larger)29
b(negativ)m(e)j(v)-5 b(alues)29 b(for)h(q)f(means)g(that)h(the)f(lev)m
(els)i(are)f(more)f(coarsely)i(spaced,)f(and)f(will)0
668 y(pro)s(duce)g(higher)h(compression)h(factors.)0
828 y(There)37 b(are)g(2)h(metho)s(ds)e(for)h(sp)s(ecifying)g(all)h
(the)g(parameters)f(needed)g(to)h(write)f(a)h(FITS)e(image)j(in)d(the)i
(tile)0 941 y(compressed)c(format.)53 b(The)34 b(parameters)h(ma)m(y)g
(either)g(b)s(e)e(sp)s(eci\014ed)h(at)h(run)e(time)i(as)g(part)f(of)h
(the)f(\014le)h(name)0 1054 y(of)41 b(the)g(output)f(compressed)g(FITS)
g(\014le,)k(or)c(the)h(writing)g(program)f(ma)m(y)i(call)g(a)f(set)g
(of)g(help)s(er)e(CFITSIO)0 1167 y(subroutines)29 b(that)i(are)g(pro)m
(vided)f(for)g(sp)s(ecifying)g(the)h(parameter)g(v)-5
b(alues,)31 b(as)f(describ)s(ed)f(b)s(elo)m(w:)0 1327
y(1\))23 b(A)m(t)g(run)e(time,)k(when)c(sp)s(ecifying)h(the)h(name)f
(of)g(the)h(output)f(FITS)f(\014le)i(to)g(b)s(e)e(created,)k(the)e
(user)e(can)i(indicate)0 1440 y(that)32 b(images)g(should)e(b)s(e)h
(written)g(in)g(tile-compressed)i(format)e(b)m(y)h(enclosing)g(the)f
(compression)h(parameters)0 1553 y(in)e(square)g(brac)m(k)m(ets)i
(follo)m(wing)g(the)e(ro)s(ot)h(disk)f(\014le)g(name)h(in)f(the)h
(follo)m(wing)g(format:)191 1809 y Fe([compress)45 b(NAME)i(T1,T2;)f(q)
h(QLEVEL,)f(s)i(HSCALE])0 2064 y Fj(where)191 2320 y
Fe(NAME)142 b(=)47 b(algorithm)f(name:)94 b(GZIP,)46
b(Rice,)h(HCOMPRESS,)e(HSCOMPRSS)g(or)i(PLIO)620 2433
y(may)g(be)h(abbreviated)c(to)j(the)g(first)g(letter)f(\(or)h(HS)g(for)
g(HSCOMPRESS\))191 2546 y(T1,T2)94 b(=)47 b(tile)g(dimension)e(\(e.g.)i
(100,100)f(for)g(square)h(tiles)f(100)h(pixels)f(wide\))191
2659 y(QLEVEL)g(=)h(quantization)e(level)h(for)h(floating)f(point)g
(FITS)h(images)191 2772 y(HSCALE)f(=)h(HCOMPRESS)f(scale)g(factor;)g
(default)g(=)h(0)h(which)e(is)h(lossless.)0 3027 y Fj(Here)31
b(are)g(a)f(few)h(examples)f(of)h(this)f(extended)h(syn)m(tax:)191
3283 y Fe(myfile.fit[compress])185 b(-)48 b(use)f(the)g(default)e
(compression)g(algorithm)g(\(Rice\))1432 3396 y(and)i(the)g(default)e
(tile)i(size)g(\(row)f(by)i(row\))191 3622 y(myfile.fit[compress)42
b(GZIP])47 b(-)g(use)g(the)g(specified)e(compression)g(algorithm;)191
3735 y(myfile.fit[compress)d(Rice])238 b(only)46 b(the)h(first)g
(letter)f(of)h(the)g(algorithm)191 3848 y(myfile.fit[compress)42
b(PLIO])238 b(name)46 b(is)i(required.)191 3960 y(myfile.fit[compress)
42 b(HCOMP])191 4186 y(myfile.fit[compress)g(R)48 b(100,100])141
b(-)47 b(use)g(Rice)g(and)g(100)g(x)g(100)g(pixel)f(tiles)191
4412 y(myfile.fit[compress)c(R;)48 b(q)f(10.0])f(-)i(quantization)c
(level)j(=)g(\(RMS-noise\))e(/)i(10.)191 4525 y(myfile.fit[compress)42
b(HS;)47 b(s)h(2.0])94 b(-)h(HSCOMPRESS)45 b(\(with)i(smoothing\))2005
4638 y(and)f(scale)h(=)g(2.0)g(*)h(RMS-noise)0 4894 y
Fj(2\))29 b(Before)g(calling)g(the)f(CFITSIO)e(routine)i(to)h(write)f
(the)g(image)h(header)f(k)m(eyw)m(ords)g(\(e.g.,)j(\014ts)p
3335 4894 28 4 v 32 w(create)p 3603 4894 V 34 w(image\))0
5007 y(the)37 b(programmer)g(can)g(call)i(the)e(routines)g(describ)s
(ed)f(b)s(elo)m(w)h(to)h(sp)s(ecify)f(the)g(compression)g(algorithm)i
(and)0 5119 y(the)g(tiling)h(pattern)f(that)g(is)g(to)g(b)s(e)f(used.)
65 b(There)38 b(are)i(routines)e(for)h(sp)s(ecifying)f(the)h(v)-5
b(arious)39 b(compression)0 5232 y(parameters)31 b(and)e(similar)i
(routines)f(to)i(return)d(the)h(curren)m(t)h(v)-5 b(alues)30
b(of)h(the)f(parameters:)95 5488 y Fe(int)47 b
(fits_set_compression_type\()o(fit)o(sfil)o(e)42 b(*fptr,)k(int)h
(comptype,)e(int)i(*status\))95 5601 y(int)g
(fits_set_tile_dim\(fitsfile)41 b(*fptr,)46 b(int)h(ndim,)f(long)h
(*tilesize,)e(int)i(*status\))95 5714 y(int)g
(fits_set_quantize_level\(fi)o(tsf)o(ile)41 b(*fptr,)46
b(float)h(qlevel,)f(int)h(*status\))p eop end
%%Page: 47 55
TeXDict begin 47 54 bop 0 299 a Fh(5.6.)72 b(IMA)m(GE)31
b(COMPRESSION)2567 b Fj(47)95 555 y Fe(int)47 b
(fits_set_hcomp_scale\(fitsf)o(ile)41 b(*fptr,)46 b(float)h(scale,)f
(int)h(*status\))95 668 y(int)g(fits_set_hcomp_smooth\(fits)o(fil)o(e)
42 b(*fptr,)k(int)h(smooth,)f(int)h(*status\))668 781
y(Set)g(smooth)f(=)i(1)f(to)g(apply)g(smoothing)e(when)i(uncompressing)
d(the)j(image)95 1007 y(int)g(fits_get_compression_type\()o(fit)o(sfil)
o(e)42 b(*fptr,)k(int)h(*comptype,)e(int)i(*status\))95
1120 y(int)g(fits_get_tile_dim\(fitsfile)41 b(*fptr,)46
b(int)h(ndim,)f(long)h(*tilesize,)e(int)i(*status\))95
1233 y(int)g(fits_get_quantize_level\(fi)o(tsf)o(ile)41
b(*fptr,)46 b(float)h(*level,)f(int)h(*status\))95 1346
y(int)g(fits_get_hcomp_scale\(fitsf)o(ile)41 b(*fptr,)46
b(float)h(*scale,)e(int)i(*status\))95 1458 y(int)g
(fits_get_hcomp_smooth\(fits)o(fil)o(e)42 b(*fptr,)k(int)h(*smooth,)e
(int)i(*status\))0 1719 y Fj(4)24 b(sym)m(b)s(olic)f(constan)m(ts)i
(are)e(de\014ned)f(for)h(use)g(as)g(the)h(v)-5 b(alue)23
b(of)h(the)f(`compt)m(yp)s(e')h(parameter:)38 b(GZIP)p
3447 1719 28 4 v 32 w(1,)25 b(RICE)p 3802 1719 V 32 w(1,)0
1832 y(HCOMPRESS)p 586 1832 V 31 w(1)35 b(or)f(PLIO)p
1035 1832 V 32 w(1.)52 b(En)m(tering)34 b(NULL)g(for)g(compt)m(yp)s(e)h
(will)f(turn)f(o\013)i(the)f(tile-compression)i(and)0
1945 y(cause)31 b(normal)f(FITS)g(images)h(to)g(b)s(e)f(written.)0
2105 y(No)23 b(sp)s(ecial)f(action)i(is)e(required)f(b)m(y)h(soft)m(w)m
(are)i(when)d(read)h(tile-compressed)h(images)g(b)s(ecause)f(all)h(the)
f(CFITSIO)0 2218 y(routines)35 b(that)g(read)g(normal)g(uncompressed)f
(FITS)g(images)i(also)g(transparen)m(tly)g(read)e(images)j(in)d(the)h
(tile-)0 2331 y(compressed)28 b(format;)h(CFITSIO)e(essen)m(tially)j
(treats)f(the)f(binary)g(table)h(that)f(con)m(tains)i(the)e(compressed)
g(tiles)0 2444 y(as)j(if)f(it)h(w)m(ere)g(an)f(IMA)m(GE)h(extension.)0
2604 y(The)f(follo)m(wing)i(2)e(routines)h(are)f(a)m(v)-5
b(ailable)33 b(for)d(compressing)h(or)f(or)g(decompressing)h(an)f
(image:)95 2865 y Fe(int)47 b(fits_img_compress\(fitsfile)41
b(*infptr,)46 b(fitsfile)f(*outfptr,)g(int)i(*status\);)95
2978 y(int)g(fits_img_decompress)c(\(fitsfile)i(*infptr,)h(fitsfile)f
(*outfptr,)h(int)g(*status\);)0 3238 y Fj(Before)30 b(calling)h(the)f
(compression)f(routine,)h(the)g(compression)f(parameters)h(m)m(ust)f
(\014rst)g(b)s(e)g(de\014ned)f(in)h(one)h(of)0 3351 y(the)e(2)h(w)m(a)m
(y)g(describ)s(ed)e(in)h(the)g(previous)g(paragraphs.)39
b(There)28 b(is)g(also)h(a)f(routine)h(to)f(determine)h(if)f(the)g
(curren)m(t)0 3464 y(HDU)j(con)m(tains)h(a)e(tile)i(compressed)e(image)
i(\(it)f(returns)e(1)i(or)f(0\):)95 3725 y Fe(int)47
b(fits_is_compressed_image\(f)o(its)o(file)41 b(*fptr,)46
b(int)h(*status\);)0 3985 y Fj(A)30 b(small)g(example)g(program)f
(called)i('imcop)m(y')f(is)g(included)f(with)g(CFITSIO)f(that)i(can)f
(b)s(e)g(used)g(to)h(compress)0 4098 y(\(or)44 b(uncompress\))g(an)m(y)
g(FITS)g(image.)83 b(This)43 b(program)h(can)h(b)s(e)e(used)h(to)g(exp)
s(erimen)m(t)h(with)f(the)g(v)-5 b(arious)0 4211 y(compression)30
b(options)h(on)f(existing)i(FITS)d(images)j(as)e(sho)m(wn)g(in)g(these)
h(examples:)0 4472 y Fe(1\))95 b(imcopy)46 b(infile.fit)f
('outfile.fit[compress]')334 4698 y(This)i(will)f(use)h(the)g(default)f
(compression)f(algorithm)g(\(Rice\))h(and)h(the)334 4811
y(default)f(tile)h(size)f(\(row)h(by)g(row\))0 5036 y(2\))95
b(imcopy)46 b(infile.fit)f('outfile.fit[compress)d(GZIP]')334
5262 y(This)47 b(will)f(use)h(the)g(GZIP)g(compression)e(algorithm)g
(and)i(the)g(default)334 5375 y(tile)g(size)f(\(row)h(by)g(row\).)94
b(The)47 b(allowed)f(compression)f(algorithms)g(are)334
5488 y(Rice,)h(GZIP,)h(and)g(PLIO.)94 b(Only)46 b(the)h(first)g(letter)
f(of)h(the)g(algorithm)334 5601 y(name)g(needs)f(to)h(be)g(specified.)p
eop end
%%Page: 48 56
TeXDict begin 48 55 bop 0 299 a Fj(48)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fe(3\))95 b(imcopy)46 b(infile.fit)f
('outfile.fit[compress)d(G)47 b(100,100]')334 781 y(This)g(will)f(use)h
(the)g(GZIP)g(compression)e(algorithm)g(and)i(100)g(X)g(100)g(pixel)334
894 y(tiles.)0 1120 y(4\))95 b(imcopy)46 b(infile.fit)f
('outfile.fit[compress)d(R)47 b(100,100;)f(q)h(10.0]')334
1346 y(This)g(will)f(use)h(the)g(Rice)g(compression)e(algorithm,)g(100)
h(X)i(100)f(pixel)334 1458 y(tiles,)f(and)h(quantization)e(level)h(=)h
(RMSnoise)f(/)h(10.0)g(\(assuming)e(the)334 1571 y(input)h(image)h(has)
g(a)g(floating)f(point)g(data)h(type\).)0 1797 y(5\))95
b(imcopy)46 b(infile.fit)f(outfile.fit)334 2023 y(If)i(the)g(input)g
(file)f(is)h(in)h(tile-compressed)43 b(format,)j(then)h(it)g(will)f(be)
334 2136 y(uncompressed)f(to)i(the)g(output)f(file.)94
b(Otherwise,)45 b(it)i(simply)f(copies)334 2249 y(the)h(input)f(image)h
(to)g(the)g(output)f(image.)0 2475 y(6\))95 b(imcopy)46
b('infile.fit[1001:1500,20)o(01:2)o(500])o(')89 b(outfile.fit)334
2700 y(This)47 b(extracts)e(a)j(500)f(X)g(500)g(pixel)f(section)g(of)h
(the)g(much)g(larger)334 2813 y(input)f(image)h(\(which)f(may)h(be)g
(in)g(tile-compressed)d(format\).)93 b(The)334 2926 y(output)46
b(is)h(a)h(normal)e(uncompressed)e(FITS)j(image.)0 3152
y(7\))95 b(imcopy)46 b('infile.fit[1001:1500,20)o(01:2)o(500])o(')89
b(outfile.fit.gz)334 3378 y(Same)47 b(as)g(above,)f(except)g(the)h
(output)f(file)h(is)g(externally)e(compressed)334 3491
y(using)h(the)h(gzip)g(algorithm.)0 3964 y Ff(5.7)135
b(ASCI)t(I)45 b(and)f(Binary)h(T)-11 b(able)45 b(Routines)0
4220 y Fj(These)36 b(routines)g(p)s(erform)f(read)i(and)e(write)i(op)s
(erations)g(on)f(columns)g(of)h(data)g(in)f(FITS)g(ASCI)s(I)e(or)j
(Binary)0 4333 y(tables.)47 b(Note)33 b(that)g(in)e(the)i(follo)m(wing)
g(discussions,)f(the)g(\014rst)g(ro)m(w)g(and)f(column)h(in)g(a)g
(table)h(is)g(at)f(p)s(osition)h(1)0 4446 y(not)e(0.)0
4606 y(Users)k(should)g(also)i(read)e(the)h(follo)m(wing)h(c)m(hapter)g
(on)e(the)h(CFITSIO)e(iterator)j(function)f(whic)m(h)f(pro)m(vides)h(a)
0 4719 y(more)i(`ob)5 b(ject)39 b(orien)m(ted')g(metho)s(d)f(of)g
(reading)g(and)g(writing)g(table)h(columns.)63 b(The)37
b(iterator)j(function)d(is)i(a)0 4832 y(little)e(more)f(complicated)h
(to)f(use,)h(but)e(the)g(adv)-5 b(an)m(tages)38 b(are)d(that)i(it)f
(usually)f(tak)m(es)i(less)e(co)s(de)h(to)g(p)s(erform)0
4945 y(the)h(same)f(op)s(eration,)j(and)c(the)i(resulting)f(program)g
(often)h(runs)e(faster)i(b)s(ecause)f(the)g(FITS)g(\014les)g(are)h
(read)0 5058 y(and)30 b(written)g(using)g(the)h(most)f(e\016cien)m(t)i
(blo)s(c)m(k)f(size.)0 5375 y Fd(5.7.1)112 b(Create)38
b(New)f(T)-9 b(able)0 5601 y Fi(1)81 b Fj(Create)40 b(a)f(new)g(ASCI)s
(I)e(or)i(bin)m(table)h(table)g(extension.)68 b(If)39
b(the)g(FITS)g(\014le)g(is)g(curren)m(tly)g(empt)m(y)h(then)f(a)227
5714 y(dumm)m(y)25 b(primary)f(arra)m(y)i(will)g(b)s(e)f(created)i(b)s
(efore)e(app)s(ending)f(the)i(table)g(extension)h(to)f(it.)40
b(The)25 b(tblt)m(yp)s(e)p eop end
%%Page: 49 57
TeXDict begin 49 56 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(49)227 555 y(parameter)39 b(de\014nes)e(the)h(t)m(yp)s(e)h(of)f
(table)h(and)e(can)i(ha)m(v)m(e)g(v)-5 b(alues)39 b(of)f(ASCI)s(I)p
2924 555 28 4 v 31 w(TBL)g(or)g(BINAR)-8 b(Y)p 3659 555
V 34 w(TBL.)227 668 y(The)29 b(naxis2)g(parameter)h(giv)m(es)g(the)g
(initial)g(n)m(um)m(b)s(er)e(of)h(ro)m(ws)g(to)h(b)s(e)f(created)h(in)f
(the)g(table,)h(and)f(should)227 781 y(normally)h(b)s(e)f(set)h(=)g(0.)
40 b(CFITSIO)29 b(will)h(automatically)i(increase)f(the)e(size)i(of)f
(the)g(table)g(as)g(additional)227 894 y(ro)m(ws)d(are)g(written.)40
b(A)27 b(non-zero)g(n)m(um)m(b)s(er)f(of)h(ro)m(ws)g(ma)m(y)g(b)s(e)f
(sp)s(eci\014ed)g(to)i(reserv)m(e)f(space)h(for)e(that)i(man)m(y)227
1007 y(ro)m(ws,)41 b(ev)m(en)e(if)g(a)g(few)m(er)g(n)m(um)m(b)s(er)e
(of)i(ro)m(ws)f(will)h(b)s(e)f(written.)66 b(The)38 b(tunit)g(and)g
(extname)i(parameters)227 1120 y(are)e(optional)g(and)f(a)h(n)m(ull)f
(p)s(oin)m(ter)g(ma)m(y)h(b)s(e)f(giv)m(en)h(if)g(they)f(are)h(not)f
(de\014ned.)61 b(The)37 b(FITS)f(Standard)227 1233 y(recommends)29
b(that)h(only)g(letters,)h(digits,)g(and)e(the)g(underscore)g(c)m
(haracter)i(b)s(e)e(used)g(in)g(column)g(names)227 1346
y(\(the)c(tt)m(yp)s(e)g(parameter\))g(with)e(no)h(em)m(b)s(edded)f
(spaces.)40 b(T)-8 b(railing)24 b(blank)g(c)m(haracters)i(are)e(not)h
(signi\014can)m(t.)95 1678 y Fe(int)47 b(fits_create_tbl)d(/)j(ffcrtb)
286 1791 y(\(fitsfile)f(*fptr,)g(int)h(tbltype,)e(LONGLONG)h(naxis2,)g
(int)g(tfields,)g(char)h(*ttype[],)334 1904 y(char)g(*tform[],)e(char)i
(*tunit[],)e(char)i(*extname,)e(int)i(*status\))0 2188
y Fd(5.7.2)112 b(Column)39 b(Information)f(Routines)0
2391 y Fi(1)81 b Fj(Get)30 b(the)g(n)m(um)m(b)s(er)e(of)i(ro)m(ws)g(or)
f(columns)g(in)h(the)g(curren)m(t)f(FITS)g(table.)41
b(The)29 b(n)m(um)m(b)s(er)f(of)i(ro)m(ws)g(is)f(giv)m(en)i(b)m(y)227
2503 y(the)j(NAXIS2)f(k)m(eyw)m(ord)h(and)e(the)i(n)m(um)m(b)s(er)e(of)
h(columns)g(is)g(giv)m(en)h(b)m(y)f(the)h(TFIELDS)e(k)m(eyw)m(ord)i(in)
f(the)227 2616 y(header)d(of)h(the)g(table.)95 2836 y
Fe(int)47 b(fits_get_num_rows)c(/)48 b(ffgnrw)286 2949
y(\(fitsfile)e(*fptr,)g(>)h(long)g(*nrows,)f(int)h(*status\);)95
3175 y(int)g(fits_get_num_rowsll)c(/)k(ffgnrwll)286 3288
y(\(fitsfile)f(*fptr,)g(>)h(LONGLONG)f(*nrows,)g(int)g(*status\);)95
3513 y(int)h(fits_get_num_cols)c(/)48 b(ffgncl)286 3626
y(\(fitsfile)e(*fptr,)g(>)h(int)g(*ncols,)f(int)h(*status\);)0
3846 y Fi(2)81 b Fj(Get)25 b(the)f(table)i(column)e(n)m(um)m(b)s(er)f
(\(and)h(name\))h(of)f(the)h(column)f(whose)g(name)g(matc)m(hes)i(an)e
(input)g(template)227 3959 y(name.)48 b(If)32 b(casesen)i(=)e(CASESEN)g
(then)g(the)h(column)f(name)h(matc)m(h)h(will)f(b)s(e)f(case-sensitiv)m
(e,)k(whereas)227 4072 y(if)27 b(casesen)h(=)e(CASEINSEN)g(then)h(the)g
(case)h(will)f(b)s(e)f(ignored.)40 b(As)27 b(a)g(general)h(rule,)f(the)
g(column)g(names)227 4185 y(should)j(b)s(e)f(treated)j(as)e(case)i
(INsensitiv)m(e.)227 4328 y(The)26 b(input)g(column)g(name)g(template)i
(ma)m(y)f(b)s(e)f(either)h(the)g(exact)h(name)e(of)h(the)f(column)g(to)
i(b)s(e)d(searc)m(hed)227 4441 y(for,)k(or)f(it)h(ma)m(y)g(con)m(tain)h
(wild)e(card)g(c)m(haracters)i(\(*,)g(?,)f(or)f(#\),)h(or)f(it)h(ma)m
(y)g(con)m(tain)h(the)e(in)m(teger)i(n)m(um)m(b)s(er)227
4554 y(of)j(the)f(desired)f(column)h(\(with)g(the)h(\014rst)e(column)h
(=)g(1\).)46 b(The)32 b(`*')h(wild)f(card)g(c)m(haracter)h(matc)m(hes)h
(an)m(y)227 4667 y(sequence)h(of)g(c)m(haracters)h(\(including)f(zero)g
(c)m(haracters\))i(and)d(the)h(`?')53 b(c)m(haracter)36
b(matc)m(hes)g(an)m(y)f(single)227 4780 y(c)m(haracter.)42
b(The)29 b(#)h(wildcard)f(will)h(matc)m(h)h(an)m(y)e(consecutiv)m(e)j
(string)e(of)f(decimal)i(digits)f(\(0-9\).)43 b(If)29
b(more)227 4893 y(than)43 b(one)f(column)h(name)f(in)g(the)h(table)h
(matc)m(hes)f(the)g(template)h(string,)i(then)c(the)h(\014rst)e(matc)m
(h)j(is)227 5006 y(returned)28 b(and)h(the)g(status)h(v)-5
b(alue)30 b(will)f(b)s(e)g(set)h(to)g(COL)p 2171 5006
V 32 w(NOT)p 2408 5006 V 32 w(UNIQUE)f(as)h(a)f(w)m(arning)g(that)h(a)g
(unique)227 5119 y(matc)m(h)e(w)m(as)g(not)f(found.)39
b(T)-8 b(o)27 b(\014nd)f(the)h(other)g(cases)h(that)g(matc)m(h)g(the)g
(template,)h(call)f(the)g(routine)f(again)227 5232 y(lea)m(ving)g(the)e
(input)f(status)h(v)-5 b(alue)26 b(equal)f(to)h(COL)p
1950 5232 V 32 w(NOT)p 2187 5232 V 32 w(UNIQUE)f(and)f(the)h(next)h
(matc)m(hing)g(name)f(will)227 5344 y(then)30 b(b)s(e)g(returned.)40
b(Rep)s(eat)30 b(this)h(pro)s(cess)f(un)m(til)g(a)h(status)g(=)f(COL)p
2628 5344 V 32 w(NOT)p 2865 5344 V 32 w(F)m(OUND)i(is)e(returned.)227
5488 y(The)36 b(FITS)g(Standard)g(recommends)g(that)i(only)e(letters,)k
(digits,)f(and)d(the)h(underscore)f(c)m(haracter)j(b)s(e)227
5601 y(used)31 b(in)g(column)g(names)g(\(with)h(no)f(em)m(b)s(edded)f
(spaces\).)45 b(T)-8 b(railing)32 b(blank)f(c)m(haracters)i(are)e(not)h
(signi\014-)227 5714 y(can)m(t.)p eop end
%%Page: 50 58
TeXDict begin 50 57 bop 0 299 a Fj(50)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_get_colnum)d(/)j(ffgcno)286
668 y(\(fitsfile)f(*fptr,)g(int)h(casesen,)e(char)i(*templt,)e(>)j(int)
f(*colnum,)334 781 y(int)g(*status\))95 1007 y(int)g(fits_get_colname)d
(/)j(ffgcnn)286 1120 y(\(fitsfile)f(*fptr,)g(int)h(casesen,)e(char)i
(*templt,)e(>)j(char)e(*colname,)334 1233 y(int)h(*colnum,)f(int)g
(*status\))0 1508 y Fi(3)81 b Fj(Return)30 b(the)i(data)g(t)m(yp)s(e,)h
(v)m(ector)g(rep)s(eat)f(v)-5 b(alue,)32 b(and)f(the)h(width)f(in)g(b)m
(ytes)h(of)g(a)g(column)f(in)g(an)h(ASCI)s(I)e(or)227
1621 y(binary)35 b(table.)56 b(Allo)m(w)m(ed)37 b(v)-5
b(alues)36 b(for)f(the)h(data)g(t)m(yp)s(e)f(in)g(ASCI)s(I)f(tables)i
(are:)51 b(TSTRING,)35 b(TSHOR)-8 b(T,)227 1734 y(TLONG,)36
b(TFLO)m(A)-8 b(T,)36 b(and)f(TDOUBLE.)i(Binary)e(tables)i(also)g(supp)
s(ort)d(these)i(t)m(yp)s(es:)52 b(TLOGICAL,)227 1847
y(TBIT,)38 b(TBYTE,)h(TCOMPLEX)e(and)h(TDBLCOMPLEX.)h(The)f(negativ)m
(e)i(of)f(the)g(data)g(t)m(yp)s(e)g(co)s(de)227 1960
y(v)-5 b(alue)32 b(is)f(returned)f(if)h(it)g(is)h(a)f(v)-5
b(ariable)32 b(length)f(arra)m(y)h(column.)43 b(Note)32
b(that)g(in)e(the)i(case)g(of)f(a)g('J')h(32-bit)227
2073 y(in)m(teger)g(binary)d(table)i(column,)f(this)g(routine)g(will)g
(return)f(data)i(t)m(yp)s(e)f(=)g(TINT32BIT)g(\(whic)m(h)g(in)g(fact)
227 2186 y(is)36 b(equiv)-5 b(alen)m(t)37 b(to)g(TLONG\).)f(With)g
(most)g(curren)m(t)g(C)f(compilers,)j(a)f(v)-5 b(alue)36
b(in)f(a)i('J')f(column)f(has)h(the)227 2299 y(same)29
b(size)g(as)g(an)f('in)m(t')i(v)-5 b(ariable,)30 b(and)d(ma)m(y)j(not)e
(b)s(e)g(equiv)-5 b(alen)m(t)30 b(to)f(a)g('long')g(v)-5
b(ariable,)30 b(whic)m(h)e(is)h(64-bits)227 2412 y(long)i(on)g(an)f
(increasing)h(n)m(um)m(b)s(er)e(of)h(compilers.)227 2570
y(The)22 b('rep)s(eat')h(parameter)g(returns)f(the)g(v)m(ector)i(rep)s
(eat)f(coun)m(t)g(on)f(the)h(binary)f(table)h(TF)m(ORMn)f(k)m(eyw)m
(ord)227 2683 y(v)-5 b(alue.)60 b(\(ASCI)s(I)35 b(table)j(columns)e
(alw)m(a)m(ys)i(ha)m(v)m(e)g(rep)s(eat)e(=)g(1\).)60
b(The)36 b('width')g(parameter)h(returns)f(the)227 2796
y(width)30 b(in)g(b)m(ytes)h(of)g(a)f(single)h(column)g(elemen)m(t)h
(\(e.g.,)g(a)f('10D')h(binary)e(table)h(column)f(will)h(ha)m(v)m(e)h
(width)227 2909 y(=)d(8,)i(an)e(ASCI)s(I)f(table)i('F12.2')i(column)e
(will)g(ha)m(v)m(e)g(width)f(=)g(12,)i(and)e(a)h(binary)e(table'60A')k
(c)m(haracter)227 3022 y(string)44 b(column)g(will)g(ha)m(v)m(e)h
(width)e(=)h(60\);)52 b(Note)45 b(that)f(CFITSIO)f(supp)s(orts)f(the)i
(lo)s(cal)h(con)m(v)m(en)m(tion)227 3135 y(for)d(sp)s(ecifying)f(arra)m
(ys)i(of)f(\014xed)f(length)h(strings)f(within)h(a)g(binary)f(table)h
(c)m(haracter)i(column)d(using)227 3247 y(the)g(syn)m(tax)g(TF)m(ORM)g
(=)g('rAw')f(where)g('r')h(is)g(the)g(total)h(n)m(um)m(b)s(er)d(of)i(c)
m(haracters)h(\(=)f(the)g(width)f(of)227 3360 y(the)f(column\))g(and)e
('w')i(is)f(the)h(width)f(of)g(a)h(unit)f(string)g(within)g(the)h
(column.)65 b(Th)m(us)37 b(if)h(the)h(column)227 3473
y(has)34 b(TF)m(ORM)h(=)f('60A12')j(then)d(this)g(means)g(that)h(eac)m
(h)g(ro)m(w)g(of)f(the)h(table)g(con)m(tains)g(5)g(12-c)m(haracter)227
3586 y(substrings)23 b(within)h(the)g(60-c)m(haracter)j(\014eld,)f(and)
d(th)m(us)h(in)g(this)g(case)h(this)g(routine)f(will)g(return)f(t)m(yp)
s(eco)s(de)227 3699 y(=)f(TSTRING,)g(rep)s(eat)g(=)g(60,)j(and)d(width)
f(=)h(12.)39 b(\(The)22 b(TDIMn)g(k)m(eyw)m(ord)h(ma)m(y)g(also)g(b)s
(e)f(used)f(to)i(sp)s(ecify)227 3812 y(the)29 b(unit)e(string)h
(length;)i(The)e(pair)g(of)g(k)m(eyw)m(ords)g(TF)m(ORMn)g(=)g('60A')i
(and)e(TDIMn)f(=)h('\(12,5\)')j(w)m(ould)227 3925 y(ha)m(v)m(e)g(the)f
(same)g(e\013ect)h(as)e(TF)m(ORMn)h(=)f('60A12'\).)43
b(The)29 b(n)m(um)m(b)s(er)f(of)i(substrings)e(in)h(an)m(y)h(binary)f
(table)227 4038 y(c)m(haracter)36 b(string)e(\014eld)f(can)h(b)s(e)g
(calculated)i(b)m(y)d(\(rep)s(eat/width\).)53 b(A)34
b(n)m(ull)f(p)s(oin)m(ter)h(ma)m(y)h(b)s(e)e(giv)m(en)i(for)227
4151 y(an)m(y)c(of)g(the)f(output)g(parameters)h(that)g(are)g(not)f
(needed.)227 4309 y(The)46 b(second)g(routine,)k(\014t)p
1188 4309 28 4 v 33 w(get)p 1341 4309 V 34 w(eqcolt)m(yp)s(e)d(is)f
(similar)h(except)g(that)f(in)g(the)g(case)i(of)e(scaled)h(in)m(teger)
227 4422 y(columns)35 b(it)g(returns)f(the)h('equiv)-5
b(alen)m(t')37 b(data)f(t)m(yp)s(e)f(that)h(is)f(needed)f(to)i(store)g
(the)f(scaled)h(v)-5 b(alues,)37 b(and)227 4535 y(not)28
b(necessarily)h(the)f(ph)m(ysical)g(data)g(t)m(yp)s(e)g(of)g(the)g
(unscaled)f(v)-5 b(alues)29 b(as)e(stored)h(in)g(the)f(FITS)g(table.)41
b(F)-8 b(or)227 4648 y(example)38 b(if)g(a)g('1I')g(column)f(in)g(a)h
(binary)f(table)h(has)g(TSCALn)d(=)j(1)f(and)g(TZER)m(On)f(=)i(32768,)j
(then)227 4761 y(this)29 b(column)f(e\013ectiv)m(ely)k(con)m(tains)d
(unsigned)f(short)g(in)m(teger)i(v)-5 b(alues,)29 b(and)f(th)m(us)h
(the)f(returned)g(v)-5 b(alue)29 b(of)227 4874 y(t)m(yp)s(eco)s(de)34
b(will)f(b)s(e)g(TUSHOR)-8 b(T,)32 b(not)h(TSHOR)-8 b(T.)33
b(Similarly)-8 b(,)34 b(if)f(a)h(column)f(has)f(TTYPEn)g(=)h('1I')h
(and)227 4986 y(TSCALn)29 b(=)h(0.12,)i(then)e(the)h(returned)e(t)m(yp)
s(eco)s(de)i(will)f(b)s(e)g(TFLO)m(A)-8 b(T.)95 5262
y Fe(int)47 b(fits_get_coltype)d(/)j(ffgtcl)286 5375
y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(>)j(int)f(*typecode,)e(long)h
(*repeat,)334 5488 y(long)h(*width,)f(int)g(*status\))95
5714 y(int)h(fits_get_coltypell)c(/)48 b(ffgtclll)p eop
end
%%Page: 51 59
TeXDict begin 51 58 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(51)286 555 y Fe(\(fitsfile)46 b(*fptr,)g(int)h(colnum,)e(>)j(int)f
(*typecode,)e(LONGLONG)g(*repeat,)334 668 y(LONGLONG)h(*width,)f(int)i
(*status\))95 894 y(int)g(fits_get_eqcoltype)c(/)48 b(ffeqty)286
1007 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(>)j(int)f(*typecode,)e
(long)h(*repeat,)334 1120 y(long)h(*width,)f(int)g(*status\))95
1346 y(int)h(fits_get_eqcoltypell)c(/)k(ffeqtyll)286
1458 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(>)j(int)f(*typecode,)e
(LONGLONG)g(*repeat,)334 1571 y(LONGLONG)h(*width,)f(int)i(*status\))0
1808 y Fi(4)81 b Fj(Return)29 b(the)h(displa)m(y)g(width)f(of)h(a)h
(column.)40 b(This)29 b(is)h(the)g(length)h(of)f(the)g(string)g(that)h
(will)f(b)s(e)f(returned)g(b)m(y)227 1921 y(the)34 b(\014ts)p
514 1921 28 4 v 32 w(read)p 718 1921 V 33 w(col)g(routine)f(when)f
(reading)h(the)h(column)e(as)i(a)f(formatted)h(string.)49
b(The)32 b(displa)m(y)i(width)227 2034 y(is)29 b(determined)g(b)m(y)g
(the)g(TDISPn)f(k)m(eyw)m(ord,)i(if)f(presen)m(t,)h(otherwise)f(b)m(y)g
(the)g(data)h(t)m(yp)s(e)f(of)h(the)f(column.)95 2384
y Fe(int)47 b(fits_get_col_display_width)41 b(/)47 b(ffgcdw)286
2497 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(>)j(int)f(*dispwidth,)e
(int)h(*status\))0 2734 y Fi(5)81 b Fj(Return)27 b(the)i(n)m(um)m(b)s
(er)e(of)i(and)e(size)j(of)e(the)h(dimensions)f(of)g(a)h(table)g
(column)g(in)f(a)g(binary)g(table.)41 b(Normally)227
2847 y(this)28 b(information)h(is)f(giv)m(en)h(b)m(y)f(the)h(TDIMn)f(k)
m(eyw)m(ord,)h(but)e(if)i(this)f(k)m(eyw)m(ord)g(is)g(not)h(presen)m(t)
f(then)g(this)227 2960 y(routine)j(returns)e(naxis)h(=)g(1)h(and)f
(naxes[0])h(equal)g(to)g(the)g(rep)s(eat)f(coun)m(t)h(in)f(the)h(TF)m
(ORM)g(k)m(eyw)m(ord.)95 3197 y Fe(int)47 b(fits_read_tdim)d(/)k
(ffgtdm)286 3309 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(int)i(maxdim,)
f(>)i(int)f(*naxis,)334 3422 y(long)g(*naxes,)f(int)g(*status\))95
3648 y(int)h(fits_read_tdimll)d(/)j(ffgtdmll)286 3761
y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(int)i(maxdim,)f(>)i(int)f
(*naxis,)334 3874 y(LONGLONG)f(*naxes,)f(int)i(*status\))0
4111 y Fi(6)81 b Fj(Deco)s(de)33 b(the)g(input)f(TDIMn)h(k)m(eyw)m(ord)
g(string)f(\(e.g.)50 b('\(100,200\)'\))37 b(and)32 b(return)g(the)h(n)m
(um)m(b)s(er)e(of)i(and)f(size)227 4224 y(of)c(the)g(dimensions)f(of)h
(a)g(binary)f(table)h(column.)40 b(If)27 b(the)h(input)f(tdimstr)g(c)m
(haracter)i(string)f(is)g(n)m(ull,)g(then)227 4337 y(this)d(routine)f
(returns)f(naxis)h(=)h(1)f(and)g(naxes[0])i(equal)e(to)i(the)e(rep)s
(eat)h(coun)m(t)g(in)f(the)g(TF)m(ORM)h(k)m(eyw)m(ord.)227
4450 y(This)30 b(routine)g(is)h(called)g(b)m(y)f(\014ts)p
1350 4450 V 33 w(read)p 1555 4450 V 33 w(tdim.)95 4687
y Fe(int)47 b(fits_decode_tdim)d(/)j(ffdtdm)286 4799
y(\(fitsfile)f(*fptr,)g(char)g(*tdimstr,)g(int)h(colnum,)e(int)i
(maxdim,)f(>)i(int)e(*naxis,)334 4912 y(long)h(*naxes,)f(int)g
(*status\))95 5138 y(int)h(fits_decode_tdimll)c(/)48
b(ffdtdmll)286 5251 y(\(fitsfile)e(*fptr,)g(char)g(*tdimstr,)g(int)h
(colnum,)e(int)i(maxdim,)f(>)i(int)e(*naxis,)334 5364
y(LONGLONG)g(*naxes,)f(int)i(*status\))0 5601 y Fi(7)81
b Fj(W)-8 b(rite)23 b(a)g(TDIMn)f(k)m(eyw)m(ord)h(whose)f(v)-5
b(alue)23 b(has)g(the)f(form)g('\(l,m,n...\)')40 b(where)22
b(l,)i(m,)g(n...)38 b(are)23 b(the)g(dimensions)227 5714
y(of)31 b(a)g(m)m(ultidimensional)g(arra)m(y)g(column)f(in)g(a)h
(binary)e(table.)p eop end
%%Page: 52 60
TeXDict begin 52 59 bop 0 299 a Fj(52)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_write_tdim)d(/)j(ffptdm)286
668 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(int)i(naxis,)f(long)h
(*naxes,)f(>)h(int)g(*status\))95 894 y(int)g(fits_write_tdimll)c(/)48
b(ffptdmll)286 1007 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(int)i
(naxis,)f(LONGLONG)g(*naxes,)g(>)h(int)g(*status\))0
1298 y Fd(5.7.3)112 b(Routines)38 b(to)f(Edit)g(Ro)m(ws)g(or)g(Columns)
0 1508 y Fi(1)81 b Fj(Insert)32 b(or)h(delete)i(ro)m(ws)e(in)g(an)g
(ASCI)s(I)f(or)h(binary)f(table.)50 b(When)33 b(inserting)h(ro)m(ws)f
(all)h(the)f(ro)m(ws)g(follo)m(wing)227 1621 y(ro)m(w)24
b(FR)m(O)m(W)i(are)e(shifted)f(do)m(wn)h(b)m(y)g(NR)m(O)m(WS)g(ro)m
(ws;)j(if)c(FR)m(O)m(W)j(=)d(0)i(then)e(the)h(blank)g(ro)m(ws)g(are)g
(inserted)227 1734 y(at)31 b(the)e(b)s(eginning)g(of)h(the)f(table.)42
b(Note)31 b(that)f(it)g(is)f(*not*)i(necessary)f(to)g(insert)f(ro)m(ws)
h(in)f(a)h(table)g(b)s(efore)227 1846 y(writing)g(data)g(to)g(those)h
(ro)m(ws)e(\(indeed,)h(it)g(w)m(ould)f(b)s(e)g(ine\016cien)m(t)i(to)f
(do)g(so\).)41 b(Instead)29 b(one)h(ma)m(y)g(simply)227
1959 y(write)h(data)g(to)g(an)m(y)g(ro)m(w)f(of)h(the)f(table,)i
(whether)e(that)h(ro)m(w)f(of)h(data)g(already)g(exists)g(or)f(not.)227
2110 y(The)40 b(\014rst)g(delete)i(routine)e(deletes)i(NR)m(O)m(WS)f
(consecutiv)m(e)h(ro)m(ws)f(starting)g(with)f(ro)m(w)g(FIRSTR)m(O)m(W.)
227 2223 y(The)d(second)g(delete)h(routine)f(tak)m(es)h(an)f(input)f
(string)h(that)h(lists)f(the)g(ro)m(ws)g(or)g(ro)m(w)g(ranges)g
(\(e.g.,)k('5-)227 2336 y(10,12,20-30'\),)32 b(whereas)26
b(the)g(third)g(delete)h(routine)f(tak)m(es)h(an)f(input)f(in)m(teger)j
(arra)m(y)e(that)h(sp)s(eci\014es)f(eac)m(h)227 2449
y(individual)35 b(ro)m(w)h(to)g(b)s(e)f(deleted.)58 b(In)35
b(b)s(oth)f(latter)j(cases,)i(the)c(input)g(list)h(of)g(ro)m(ws)g(to)g
(delete)h(m)m(ust)f(b)s(e)227 2562 y(sorted)i(in)g(ascending)g(order.)
62 b(These)38 b(routines)f(up)s(date)g(the)h(NAXIS2)g(k)m(eyw)m(ord)h
(to)f(re\015ect)g(the)g(new)227 2674 y(n)m(um)m(b)s(er)29
b(of)i(ro)m(ws)f(in)g(the)h(table.)95 2935 y Fe(int)47
b(fits_insert_rows)d(/)j(ffirow)286 3048 y(\(fitsfile)f(*fptr,)g
(LONGLONG)f(firstrow,)h(LONGLONG)f(nrows,)h(>)i(int)f(*status\))95
3274 y(int)g(fits_delete_rows)d(/)j(ffdrow)286 3387 y(\(fitsfile)f
(*fptr,)g(LONGLONG)f(firstrow,)h(LONGLONG)f(nrows,)h(>)i(int)f
(*status\))95 3612 y(int)g(fits_delete_rowrange)c(/)k(ffdrrg)286
3725 y(\(fitsfile)f(*fptr,)g(char)g(*rangelist,)f(>)j(int)e(*status\))
95 3951 y(int)h(fits_delete_rowlist)c(/)k(ffdrws)286
4064 y(\(fitsfile)f(*fptr,)g(long)g(*rowlist,)g(long)g(nrows,)g(>)i
(int)f(*status\))95 4290 y(int)g(fits_delete_rowlistll)42
b(/)48 b(ffdrwsll)286 4403 y(\(fitsfile)e(*fptr,)g(LONGLONG)f
(*rowlist,)h(LONGLONG)f(nrows,)h(>)i(int)f(*status\))0
4663 y Fi(2)81 b Fj(Insert)36 b(or)h(delete)i(column\(s\))e(in)g(an)g
(ASCI)s(I)f(or)h(binary)f(table.)62 b(When)37 b(inserting,)i(COLNUM)e
(sp)s(eci\014es)227 4776 y(the)28 b(column)g(n)m(um)m(b)s(er)f(that)h
(the)g(\(\014rst\))g(new)f(column)h(should)f(o)s(ccup)m(y)h(in)g(the)g
(table.)41 b(NCOLS)26 b(sp)s(eci\014es)227 4889 y(ho)m(w)35
b(man)m(y)g(columns)f(are)h(to)g(b)s(e)f(inserted.)53
b(An)m(y)35 b(existing)h(columns)e(from)g(this)h(p)s(osition)f(and)g
(higher)227 5002 y(are)c(shifted)f(o)m(v)m(er)h(to)g(allo)m(w)g(ro)s
(om)f(for)g(the)h(new)e(column\(s\).)41 b(The)29 b(index)f(n)m(um)m(b)s
(er)g(on)h(all)h(the)f(follo)m(wing)227 5115 y(k)m(eyw)m(ords)34
b(will)f(b)s(e)g(incremen)m(ted)h(or)f(decremen)m(ted)h(if)f(necessary)
h(to)g(re\015ect)g(the)f(new)g(p)s(osition)g(of)h(the)227
5228 y(column\(s\))26 b(in)f(the)h(table:)39 b(TBCOLn,)26
b(TF)m(ORMn,)h(TTYPEn,)e(TUNITn,)h(TNULLn,)g(TSCALn,)f(TZE-)227
5341 y(R)m(On,)43 b(TDISPn,)g(TDIMn,)g(TLMINn,)g(TLMAXn,)g(TDMINn,)g
(TDMAXn,)h(TCTYPn,)e(TCRPXn,)227 5453 y(TCR)-10 b(VLn,)29
b(TCDL)-8 b(Tn,)30 b(TCR)m(OTn,)f(and)h(TCUNIn.)95 5714
y Fe(int)47 b(fits_insert_col)d(/)j(fficol)p eop end
%%Page: 53 61
TeXDict begin 53 60 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(53)286 555 y Fe(\(fitsfile)46 b(*fptr,)g(int)h(colnum,)e(char)i
(*ttype,)f(char)h(*tform,)334 668 y(>)h(int)e(*status\))95
894 y(int)h(fits_insert_cols)d(/)j(fficls)286 1007 y(\(fitsfile)f
(*fptr,)g(int)h(colnum,)e(int)i(ncols,)f(char)h(**ttype,)334
1120 y(char)g(**tform,)e(>)j(int)f(*status\))95 1346
y(int)g(fits_delete_col)d(/)j(ffdcol\(fitsfile)d(*fptr,)i(int)h
(colnum,)f(>)h(int)g(*status\))0 1604 y Fi(3)81 b Fj(Cop)m(y)32
b(a)h(column)g(from)f(one)h(HDU)g(to)h(another)e(\(or)h(to)h(the)f
(same)g(HDU\).)h(If)e(create)p 3129 1604 28 4 v 34 w(col)i(=)e(TR)m
(UE,)h(then)227 1717 y(a)40 b(new)e(column)h(will)g(b)s(e)g(inserted)g
(in)f(the)h(output)g(table,)j(at)e(p)s(osition)f(`outcolumn',)j
(otherwise)e(the)227 1830 y(existing)f(output)f(column)f(will)i(b)s(e)e
(o)m(v)m(erwritten)i(\(in)f(whic)m(h)g(case)h(it)f(m)m(ust)g(ha)m(v)m
(e)h(a)f(compatible)h(data)227 1943 y(t)m(yp)s(e\).)i(If)29
b(outcoln)m(um)h(is)f(greater)i(than)e(the)h(n)m(um)m(b)s(er)e(of)h
(column)g(in)g(the)h(table,)h(then)e(the)g(new)g(column)227
2056 y(will)j(b)s(e)f(app)s(ended)f(to)j(the)f(end)f(of)g(the)h(table.)
46 b(Note)33 b(that)f(the)g(\014rst)f(column)g(in)h(a)g(table)g(is)g
(at)h(coln)m(um)227 2169 y(=)j(1.)58 b(The)36 b(standard)f(indexed)g(k)
m(eyw)m(ords)i(that)f(related)h(to)g(the)f(column)g(\(e.g.,)j(TDISPn,)e
(TUNITn,)227 2282 y(TCRPXn,)30 b(TCDL)-8 b(Tn,)29 b(etc.\))43
b(will)30 b(also)i(b)s(e)d(copied.)95 2541 y Fe(int)47
b(fits_copy_col)e(/)i(ffcpcl)286 2654 y(\(fitsfile)f(*infptr,)f
(fitsfile)h(*outfptr,)f(int)i(incolnum,)e(int)i(outcolnum,)334
2767 y(int)g(create_col,)e(>)i(int)g(*status\);)0 3026
y Fi(4)81 b Fj(Cop)m(y)30 b('nro)m(ws')g(consecutiv)m(e)j(ro)m(ws)d
(from)g(one)h(table)g(to)g(another,)g(b)s(eginning)f(with)g(ro)m(w)g
('\014rstro)m(w'.)41 b(These)227 3138 y(ro)m(ws)31 b(will)h(b)s(e)e
(app)s(ended)g(to)i(an)m(y)f(existing)h(ro)m(ws)g(in)e(the)i(output)e
(table.)44 b(Note)33 b(that)f(the)f(\014rst)f(ro)m(w)i(in)f(a)227
3251 y(table)h(is)e(at)h(ro)m(w)g(=)f(1.)95 3510 y Fe(int)47
b(fits_copy_rows)d(/)k(ffcprw)286 3623 y(\(fitsfile)e(*infptr,)f
(fitsfile)h(*outfptr,)f(LONGLONG)h(firstrow,)334 3736
y(LONGLONG)g(nrows,)g(>)h(int)g(*status\);)0 3995 y Fi(5)81
b Fj(Mo)s(dify)37 b(the)g(v)m(ector)i(length)f(of)f(a)h(binary)e(table)
i(column)f(\(e.g.,)k(c)m(hange)e(a)e(column)g(from)g(TF)m(ORMn)g(=)227
4108 y('1E')31 b(to)h('20E'\).)g(The)e(v)m(ector)i(length)e(ma)m(y)h(b)
s(e)f(increased)h(or)f(decreased)h(from)f(the)g(curren)m(t)h(v)-5
b(alue.)95 4367 y Fe(int)47 b(fits_modify_vector_len)42
b(/)48 b(ffmvec)286 4480 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e
(LONGLONG)h(newveclen,)f(>)i(int)g(*status\))0 4770 y
Fd(5.7.4)112 b(Read)38 b(and)h(W)-9 b(rite)36 b(Column)j(Data)e
(Routines)0 4989 y Fj(The)e(follo)m(wing)h(routines)g(write)f(or)g
(read)g(data)h(v)-5 b(alues)36 b(in)f(the)g(curren)m(t)g(ASCI)s(I)f(or)
h(binary)g(table)h(extension.)0 5102 y(If)d(a)g(write)g(op)s(eration)h
(extends)f(b)s(ey)m(ond)f(the)h(curren)m(t)g(size)h(of)f(the)g(table,)i
(then)e(the)g(n)m(um)m(b)s(er)f(of)h(ro)m(ws)g(in)g(the)0
5215 y(table)i(will)g(automatically)i(b)s(e)c(increased)i(and)e(the)i
(NAXIS2)f(k)m(eyw)m(ord)h(v)-5 b(alue)35 b(will)f(b)s(e)g(up)s(dated.)
51 b(A)m(ttempts)0 5328 y(to)31 b(read)f(b)s(ey)m(ond)g(the)h(end)e(of)
i(the)f(table)i(will)e(result)h(in)f(an)g(error.)0 5488
y(Automatic)d(data)e(t)m(yp)s(e)g(con)m(v)m(ersion)h(is)f(p)s(erformed)
f(for)g(n)m(umerical)i(data)f(t)m(yp)s(es)g(\(only\))h(if)f(the)g(data)
h(t)m(yp)s(e)f(of)g(the)0 5601 y(column)34 b(\(de\014ned)f(b)m(y)h(the)
g(TF)m(ORMn)g(k)m(eyw)m(ord\))h(di\013ers)f(from)g(the)g(data)h(t)m(yp)
s(e)f(of)g(the)h(arra)m(y)f(in)g(the)g(calling)0 5714
y(routine.)65 b(ASCI)s(I)37 b(and)h(binary)f(tables)i(supp)s(ort)e(the)
i(follo)m(wing)g(data)h(t)m(yp)s(e)e(v)-5 b(alues:)57
b(TSTRING,)38 b(TBYTE,)p eop end
%%Page: 54 62
TeXDict begin 54 61 bop 0 299 a Fj(54)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fj(TSBYTE,)e(TSHOR)-8 b(T,)27 b(TUSHOR)-8
b(T,)28 b(TINT,)g(TUINT,)g(TLONG,)g(TLONGLONG,)g(TULONG,)g(TFLO)m(A)-8
b(T,)0 668 y(or)25 b(TDOUBLE.)g(Binary)f(tables)i(also)f(supp)s(ort)e
(TLOGICAL)h(\(in)m(ternally)i(mapp)s(ed)d(to)i(the)g(`c)m(har')h(data)f
(t)m(yp)s(e\),)0 781 y(TCOMPLEX,)30 b(and)f(TDBLCOMPLEX.)0
941 y(Note)d(that)g(it)g(is)f(*not*)h(necessary)f(to)h(insert)f(ro)m
(ws)g(in)g(a)g(table)h(b)s(efore)f(writing)g(data)h(to)g(those)f(ro)m
(ws)g(\(indeed,)h(it)0 1054 y(w)m(ould)h(b)s(e)g(ine\016cien)m(t)i(to)f
(do)f(so\).)41 b(Instead,)28 b(one)g(ma)m(y)g(simply)f(write)g(data)h
(to)h(an)m(y)e(ro)m(w)h(of)g(the)f(table,)j(whether)0
1167 y(that)h(ro)m(w)f(of)h(data)g(already)g(exists)g(or)f(not.)0
1327 y(Individual)g(bits)i(in)f(a)h(binary)e(table)i('X')g(or)g('B')g
(column)f(ma)m(y)h(b)s(e)f(read/written)h(to/from)g(a)g(*c)m(har)g
(arra)m(y)g(b)m(y)0 1440 y(sp)s(ecifying)k(the)f(TBIT)h(datat)m(yp)s
(e.)57 b(The)35 b(*c)m(har)i(arra)m(y)f(will)g(b)s(e)f(in)m(terpreted)h
(as)g(an)g(arra)m(y)g(of)g(logical)i(TR)m(UE)0 1553 y(\(1\))d(or)g(F)
-10 b(ALSE)34 b(\(0\))h(v)-5 b(alues)35 b(that)g(corresp)s(ond)e(to)i
(the)g(v)-5 b(alue)35 b(of)f(eac)m(h)i(bit)e(in)g(the)h(FITS)e('X')i
(or)g('B')g(column.)0 1666 y(Alternativ)m(ely)-8 b(,)30
b(the)c(v)-5 b(alues)27 b(in)e(a)i(binary)e(table)i('X')g(column)f(ma)m
(y)h(b)s(e)e(read/written)i(8)f(bits)g(at)h(a)f(time)h(to/from)0
1779 y(an)j(arra)m(y)h(of)g(8-bit)g(in)m(tegers)g(b)m(y)g(sp)s
(ecifying)f(the)h(TBYTE)f(datat)m(yp)s(e.)0 1939 y(Note)25
b(that)g(within)e(the)h(con)m(text)i(of)e(these)g(routines,)i(the)e
(TSTRING)f(data)h(t)m(yp)s(e)g(corresp)s(onds)f(to)h(a)h(C)e('c)m
(har**')0 2052 y(data)35 b(t)m(yp)s(e,)h(i.e.,)h(a)e(p)s(oin)m(ter)f
(to)i(an)e(arra)m(y)h(of)g(p)s(oin)m(ters)f(to)h(an)g(arra)m(y)g(of)g
(c)m(haracters.)54 b(This)34 b(is)g(di\013eren)m(t)h(from)0
2165 y(the)d(k)m(eyw)m(ord)h(reading)f(and)f(writing)h(routines)g
(where)g(TSTRING)f(corresp)s(onds)g(to)h(a)h(C)e('c)m(har*')j(data)f(t)
m(yp)s(e,)0 2278 y(i.e.,)g(a)e(single)h(p)s(oin)m(ter)f(to)h(an)f(arra)
m(y)g(of)g(c)m(haracters.)45 b(When)30 b(reading)i(strings)e(from)h(a)g
(table,)i(the)e(c)m(har)h(arra)m(ys)0 2391 y(ob)m(viously)f(m)m(ust)f
(ha)m(v)m(e)i(b)s(een)e(allo)s(cated)i(long)f(enough)f(to)h(hold)f(the)
h(whole)f(FITS)g(table)h(string.)0 2551 y(Numerical)i(data)g(v)-5
b(alues)33 b(are)g(automatically)j(scaled)d(b)m(y)f(the)h(TSCALn)e(and)
h(TZER)m(On)f(k)m(eyw)m(ord)i(v)-5 b(alues)33 b(\(if)0
2664 y(they)e(exist\).)0 2824 y(In)25 b(the)g(case)i(of)e(binary)g
(tables)h(with)f(v)m(ector)i(elemen)m(ts,)h(the)e('felem')g(parameter)g
(de\014nes)f(the)g(starting)h(elemen)m(t)0 2937 y(\(b)s(eginning)h
(with)g(1,)h(not)g(0\))g(within)f(the)g(cell)i(\(a)f(cell)g(is)f
(de\014ned)f(as)i(the)f(in)m(tersection)i(of)f(a)f(ro)m(w)h(and)e(a)i
(column)0 3050 y(and)e(ma)m(y)h(con)m(tain)h(a)g(single)f(v)-5
b(alue)27 b(or)g(a)g(v)m(ector)h(of)f(v)-5 b(alues\).)40
b(The)26 b(felem)i(parameter)f(is)g(ignored)f(when)g(dealing)0
3163 y(with)34 b(ASCI)s(I)e(tables.)52 b(Similarly)-8
b(,)36 b(in)d(the)i(case)f(of)h(binary)e(tables)h(the)h('nelemen)m(ts')
g(parameter)f(sp)s(eci\014es)g(the)0 3275 y(total)28
b(n)m(um)m(b)s(er)d(of)h(v)m(ector)i(v)-5 b(alues)27
b(to)g(b)s(e)e(read)h(or)h(written)f(\(con)m(tin)m(uing)i(on)e
(subsequen)m(t)f(ro)m(ws)i(if)f(required\))g(and)0 3388
y(not)31 b(the)f(n)m(um)m(b)s(er)f(of)i(table)g(cells.)0
3637 y Fi(1)81 b Fj(W)-8 b(rite)31 b(elemen)m(ts)h(in)m(to)f(an)g(ASCI)
s(I)e(or)h(binary)f(table)j(column.)0 3885 y(The)38 b(\014rst)f
(routine)h(simply)g(writes)g(the)g(arra)m(y)h(of)f(v)-5
b(alues)39 b(to)g(the)f(FITS)g(\014le)g(\(doing)g(data)h(t)m(yp)s(e)g
(con)m(v)m(ersion)0 3998 y(if)h(necessary\))h(whereas)f(the)h(second)f
(routine)h(will)f(substitute)h(the)f(appropriate)g(FITS)g(n)m(ull)g(v)
-5 b(alue)41 b(for)f(all)0 4111 y(elemen)m(ts)34 b(whic)m(h)f(are)g
(equal)h(to)f(the)g(input)f(v)-5 b(alue)34 b(of)f(n)m(ulv)-5
b(al)33 b(\(note)h(that)f(this)g(parameter)g(giv)m(es)i(the)e(address)0
4224 y(of)40 b(n)m(ulv)-5 b(al,)44 b(not)c(the)g(n)m(ull)g(v)-5
b(alue)41 b(itself)7 b(\).)72 b(F)-8 b(or)40 b(in)m(teger)i(columns)e
(the)g(FITS)g(n)m(ull)g(v)-5 b(alue)40 b(is)h(de\014ned)e(b)m(y)h(the)0
4337 y(TNULLn)32 b(k)m(eyw)m(ord)i(\(an)g(error)e(is)i(returned)e(if)h
(the)h(k)m(eyw)m(ord)f(do)s(esn't)g(exist\).)51 b(F)-8
b(or)34 b(\015oating)g(p)s(oin)m(t)f(columns)0 4449 y(the)h(sp)s(ecial)
h(IEEE)f(NaN)h(\(Not-a-Num)m(b)s(er\))h(v)-5 b(alue)35
b(will)f(b)s(e)g(written)g(in)m(to)i(the)e(FITS)g(\014le.)52
b(If)34 b(a)h(n)m(ull)f(p)s(oin)m(ter)0 4562 y(is)f(en)m(tered)g(for)g
(n)m(ulv)-5 b(al,)34 b(then)f(the)g(n)m(ull)g(v)-5 b(alue)33
b(is)g(ignored)g(and)g(this)g(routine)f(b)s(eha)m(v)m(es)i(the)f(same)g
(as)h(the)f(\014rst)0 4675 y(routine.)41 b(The)29 b(third)g(routine)h
(simply)f(writes)h(unde\014ned)d(pixel)k(v)-5 b(alues)30
b(to)g(the)g(column.)41 b(The)29 b(fourth)g(routine)0
4788 y(\014lls)e(ev)m(ery)i(column)e(in)h(the)g(table)g(with)g(n)m(ull)
f(v)-5 b(alues,)29 b(in)e(the)h(sp)s(eci\014ed)f(ro)m(ws)h(\(ignoring)g
(an)m(y)g(columns)g(that)g(do)0 4901 y(not)j(ha)m(v)m(e)g(a)g
(de\014ned)e(n)m(ull)h(v)-5 b(alue\).)95 5149 y Fe(int)47
b(fits_write_col)d(/)k(ffpcl)286 5262 y(\(fitsfile)e(*fptr,)g(int)h
(datatype,)e(int)i(colnum,)f(LONGLONG)f(firstrow,)334
5375 y(LONGLONG)h(firstelem,)f(LONGLONG)g(nelements,)g(DTYPE)i(*array,)
e(>)j(int)f(*status\))95 5601 y(int)g(fits_write_colnull)c(/)48
b(ffpcn)286 5714 y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(int)i
(colnum,)f(LONGLONG)f(firstrow,)p eop end
%%Page: 55 63
TeXDict begin 55 62 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(55)286 555 y Fe(LONGLONG)46 b(firstelem,)f(LONGLONG)g(nelements,)g
(DTYPE)i(*array,)f(DTYPE)g(*nulval,)286 668 y(>)i(int)f(*status\))143
894 y(int)g(fits_write_col_null)c(/)k(ffpclu)334 1007
y(\(fitsfile)e(*fptr,)h(int)h(colnum,)f(LONGLONG)g(firstrow,)f
(LONGLONG)h(firstelem,)382 1120 y(LONGLONG)f(nelements,)g(>)j(int)f
(*status\))143 1346 y(int)g(fits_write_nullrows)c(/)k(ffprwu)334
1458 y(\(fitsfile)e(*fptr,)h(LONGLONG)g(firstrow,)f(LONGLONG)h
(nelements,)f(>)i(int)g(*status\))0 1783 y Fi(2)81 b
Fj(Read)33 b(elemen)m(ts)i(from)e(an)g(ASCI)s(I)f(or)i(binary)e(table)i
(column.)50 b(The)33 b(data)h(t)m(yp)s(e)g(parameter)g(sp)s(eci\014es)f
(the)227 1896 y(data)28 b(t)m(yp)s(e)g(of)g(the)f(`n)m(ulv)-5
b(al')29 b(and)e(`arra)m(y')h(p)s(oin)m(ters;)h(Unde\014ned)c(arra)m(y)
j(elemen)m(ts)h(will)f(b)s(e)f(returned)f(with)227 2009
y(a)k(v)-5 b(alue)30 b(=)e(*n)m(ullv)-5 b(al,)31 b(\(note)f(that)g
(this)f(parameter)h(giv)m(es)g(the)g(address)e(of)h(the)h(n)m(ull)f(v)
-5 b(alue,)30 b(not)g(the)f(n)m(ull)227 2122 y(v)-5 b(alue)31
b(itself)7 b(\))32 b(unless)e(n)m(ulv)-5 b(al)32 b(=)e(0)h(or)g(*n)m
(ulv)-5 b(al)31 b(=)g(0,)g(in)f(whic)m(h)h(case)h(no)e(c)m(hec)m(king)j
(for)d(unde\014ned)f(pixels)227 2235 y(will)34 b(b)s(e)f(p)s(erformed.)
48 b(The)33 b(second)g(routine)h(is)f(similar)h(except)g(that)g(an)m(y)
g(unde\014ned)d(pixels)j(will)g(ha)m(v)m(e)227 2347 y(the)d(corresp)s
(onding)e(n)m(ullarra)m(y)i(elemen)m(t)h(set)f(equal)g(to)g(TR)m(UE)f
(\(=)h(1\).)227 2530 y(An)m(y)c(column,)g(regardless)f(of)g(it's)h(in)m
(trinsic)g(data)g(t)m(yp)s(e,)g(ma)m(y)g(b)s(e)e(read)i(as)f(a)g
(string.)40 b(It)26 b(should)f(b)s(e)h(noted)227 2643
y(ho)m(w)m(ev)m(er)32 b(that)f(reading)f(a)h(n)m(umeric)f(column)g(as)h
(a)g(string)f(is)g(10)i(-)e(100)i(times)f(slo)m(w)m(er)g(than)f
(reading)h(the)227 2756 y(same)22 b(column)g(as)f(a)h(n)m(um)m(b)s(er)e
(due)h(to)i(the)e(large)i(o)m(v)m(erhead)g(in)e(constructing)h(the)g
(formatted)g(strings.)37 b(The)227 2869 y(displa)m(y)26
b(format)g(of)f(the)h(returned)e(strings)h(will)h(b)s(e)f(determined)g
(b)m(y)g(the)h(TDISPn)e(k)m(eyw)m(ord,)j(if)e(it)h(exists,)227
2982 y(otherwise)32 b(b)m(y)f(the)g(data)h(t)m(yp)s(e)f(of)g(the)g
(column.)43 b(The)30 b(length)i(of)f(the)g(returned)f(strings)h(\(not)g
(including)227 3095 y(the)26 b(n)m(ull)f(terminating)i(c)m(haracter\))g
(can)f(b)s(e)f(determined)g(with)g(the)h(\014ts)p 2703
3095 28 4 v 32 w(get)p 2855 3095 V 34 w(col)p 2999 3095
V 34 w(displa)m(y)p 3311 3095 V 33 w(width)f(routine.)227
3208 y(The)30 b(follo)m(wing)i(TDISPn)d(displa)m(y)i(formats)f(are)h
(curren)m(tly)f(supp)s(orted:)418 3554 y Fe(Iw.m)142
b(Integer)418 3667 y(Ow.m)g(Octal)47 b(integer)418 3780
y(Zw.m)142 b(Hexadecimal)45 b(integer)418 3893 y(Fw.d)142
b(Fixed)47 b(floating)e(point)418 4006 y(Ew.d)142 b(Exponential)45
b(floating)h(point)418 4119 y(Dw.d)142 b(Exponential)45
b(floating)h(point)418 4232 y(Gw.d)142 b(General;)46
b(uses)g(Fw.d)h(if)g(significance)e(not)i(lost,)f(else)h(Ew.d)227
4579 y Fj(where)24 b(w)h(is)f(the)h(width)f(in)g(c)m(haracters)i(of)f
(the)g(displa)m(y)m(ed)g(v)-5 b(alues,)27 b(m)d(is)h(the)f(minim)m(um)g
(n)m(um)m(b)s(er)g(of)g(digits)227 4692 y(displa)m(y)m(ed,)29
b(and)e(d)g(is)h(the)f(n)m(um)m(b)s(er)g(of)g(digits)i(to)f(the)g(righ)
m(t)g(of)f(the)h(decimal.)41 b(The)27 b(.m)g(\014eld)g(is)h(optional.)
95 5016 y Fe(int)47 b(fits_read_col)e(/)i(ffgcv)286 5129
y(\(fitsfile)f(*fptr,)g(int)h(datatype,)e(int)i(colnum,)f(LONGLONG)f
(firstrow,)g(LONGLONG)h(firstelem,)334 5242 y(LONGLONG)g(nelements,)f
(DTYPE)h(*nulval,)g(DTYPE)g(*array,)g(int)h(*anynul,)e(int)i(*status\))
95 5468 y(int)g(fits_read_colnull)c(/)48 b(ffgcf)286
5581 y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(int)i(colnum,)f
(LONGLONG)f(firstrow,)g(LONGLONG)h(firstelem,)286 5694
y(LONGLONG)g(nelements,)f(DTYPE)h(*array,)g(char)h(*nullarray,)d(int)j
(*anynul,)f(int)h(*status\))p eop end
%%Page: 56 64
TeXDict begin 56 63 bop 0 299 a Fj(56)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fd(5.7.5)112 b(Ro)m(w)37 b(Selection)h(and)h
(Calculator)f(Routines)0 774 y Fj(These)21 b(routines)f(all)i(parse)f
(and)f(ev)-5 b(aluate)23 b(an)d(input)g(string)h(con)m(taining)i(a)e
(user)f(de\014ned)g(arithmetic)i(expression.)0 887 y(The)29
b(\014rst)f(3)i(routines)f(select)i(ro)m(ws)e(in)g(a)h(FITS)e(table,)j
(based)e(on)g(whether)g(the)g(expression)g(ev)-5 b(aluates)31
b(to)f(true)0 1000 y(\(not)e(equal)f(to)h(zero\))g(or)f(false)h
(\(zero\).)41 b(The)27 b(other)g(routines)g(ev)-5 b(aluate)29
b(the)e(expression)g(and)f(calculate)k(a)d(v)-5 b(alue)0
1113 y(for)26 b(eac)m(h)i(ro)m(w)f(of)g(the)g(table.)40
b(The)26 b(allo)m(w)m(ed)j(expression)d(syn)m(tax)i(is)e(describ)s(ed)g
(in)g(the)h(ro)m(w)g(\014lter)g(section)g(in)g(the)0
1226 y(`Extended)32 b(File)h(Name)g(Syn)m(tax')g(c)m(hapter)g(of)f
(this)g(do)s(cumen)m(t.)46 b(The)32 b(expression)g(ma)m(y)h(also)g(b)s
(e)e(written)i(to)g(a)0 1339 y(text)h(\014le,)h(and)e(the)h(name)f(of)h
(the)f(\014le,)i(prep)s(ended)c(with)i(a)h('@')g(c)m(haracter)h(ma)m(y)
f(b)s(e)f(supplied)f(for)h(the)h('expr')0 1452 y(parameter)d(\(e.g.)42
b('@\014lename.txt'\).)g(The)30 b(expression)g(in)g(the)g(\014le)h(can)
f(b)s(e)g(arbitrarily)g(complex)h(and)f(extend)0 1564
y(o)m(v)m(er)35 b(m)m(ultiple)g(lines)g(of)f(the)g(\014le.)53
b(Lines)33 b(that)i(b)s(egin)f(with)g(2)g(slash)g(c)m(haracters)i
(\('//'\))g(will)f(b)s(e)e(ignored)i(and)0 1677 y(ma)m(y)c(b)s(e)f
(used)f(to)i(add)f(commen)m(ts)h(to)h(the)e(\014le.)0
1925 y Fi(1)81 b Fj(Ev)-5 b(aluate)38 b(a)f(b)s(o)s(olean)g(expression)
g(o)m(v)m(er)h(the)g(indicated)f(ro)m(ws,)i(returning)d(an)h(arra)m(y)h
(of)f(\015ags)g(indicating)227 2038 y(whic)m(h)31 b(ro)m(ws)g(ev)-5
b(aluated)32 b(to)f(TR)m(UE/F)-10 b(ALSE.)31 b(Up)s(on)f(return,)g(*n)p
2518 2038 28 4 v 33 w(go)s(o)s(d)p 2743 2038 V 33 w(ro)m(ws)g(con)m
(tains)i(the)f(n)m(um)m(b)s(er)f(of)227 2151 y(ro)m(ws)h(that)g(ev)-5
b(aluate)32 b(to)f(TR)m(UE.)95 2399 y Fe(int)47 b(fits_find_rows)d(/)k
(fffrow)286 2512 y(\(fitsfile)e(*fptr,)93 b(char)47 b(*expr,)f(long)h
(firstrow,)e(long)i(nrows,)286 2625 y(>)h(long)e(*n_good_rows,)f(char)h
(*row_status,)92 b(int)47 b(*status\))0 2872 y Fi(2)81
b Fj(Find)29 b(the)i(\014rst)f(ro)m(w)g(whic)m(h)g(satis\014es)h(the)g
(input)e(b)s(o)s(olean)h(expression)95 3120 y Fe(int)47
b(fits_find_first_row)c(/)k(ffffrw)286 3233 y(\(fitsfile)f(*fptr,)93
b(char)47 b(*expr,)f(>)i(long)e(*rownum,)g(int)h(*status\))0
3481 y Fi(3)81 b Fj(Ev)-5 b(aluate)35 b(an)f(expression)h(on)f(all)h
(ro)m(ws)g(of)f(a)h(table.)54 b(If)34 b(the)g(input)g(and)g(output)g
(\014les)g(are)h(not)g(the)f(same,)227 3594 y(cop)m(y)i(the)g(TR)m(UE)f
(ro)m(ws)g(to)h(the)f(output)g(\014le;)j(if)d(the)g(output)g(table)h
(is)f(not)h(empt)m(y)-8 b(,)37 b(then)e(this)g(routine)227
3707 y(will)28 b(app)s(end)e(the)i(new)f(selected)i(ro)m(ws)e(after)h
(the)g(existing)h(ro)m(ws.)39 b(If)27 b(the)h(\014les)g(are)f(the)h
(same,)h(delete)g(the)227 3819 y(F)-10 b(ALSE)30 b(ro)m(ws)h(\(preserv)
m(e)f(the)h(TR)m(UE)f(ro)m(ws\).)95 4067 y Fe(int)47
b(fits_select_rows)d(/)j(ffsrow)286 4180 y(\(fitsfile)f(*infptr,)f
(fitsfile)h(*outfptr,)93 b(char)46 b(*expr,)94 b(>)48
b(int)f(*status)e(\))0 4428 y Fi(4)81 b Fj(Calculate)28
b(an)f(expression)f(for)h(the)f(indicated)i(ro)m(ws)e(of)h(a)g(table,)i
(returning)d(the)h(results,)g(cast)h(as)f(datat)m(yp)s(e)227
4541 y(\(TSHOR)-8 b(T,)32 b(TDOUBLE,)h(etc\),)h(in)e(arra)m(y)-8
b(.)48 b(If)31 b(n)m(ulv)-5 b(al==NULL,)33 b(UNDEFs)g(will)f(b)s(e)g
(zero)s(ed)g(out.)47 b(F)-8 b(or)227 4654 y(v)m(ector)37
b(results,)f(the)f(n)m(um)m(b)s(er)e(of)i(elemen)m(ts)i(returned)c(ma)m
(y)j(b)s(e)e(less)h(than)g(nelemen)m(ts)g(if)g(nelemen)m(ts)h(is)227
4767 y(not)c(an)g(ev)m(en)h(m)m(ultiple)f(of)g(the)g(result)g
(dimension.)44 b(Call)33 b(\014ts)p 2392 4767 V 32 w(test)p
2570 4767 V 34 w(expr)e(to)h(obtain)h(the)f(dimensions)f(of)227
4880 y(the)g(results.)95 5127 y Fe(int)47 b(fits_calc_rows)d(/)k
(ffcrow)286 5240 y(\(fitsfile)e(*fptr,)93 b(int)47 b(datatype,)f(char)g
(*expr,)g(long)h(firstrow,)334 5353 y(long)g(nelements,)e(void)h
(*nulval,)g(>)h(void)g(*array,)94 b(int)46 b(*anynul,)g(int)h
(*status\))0 5601 y Fi(5)81 b Fj(Ev)-5 b(aluate)33 b(an)g(expression)f
(and)h(write)f(the)h(result)g(either)g(to)h(a)f(column)f(\(if)h(the)g
(expression)f(is)h(a)g(function)227 5714 y(of)d(other)g(columns)g(in)f
(the)h(table\))h(or)f(to)g(a)h(k)m(eyw)m(ord)f(\(if)g(the)g(expression)
f(ev)-5 b(aluates)32 b(to)e(a)g(constan)m(t)i(and)p eop
end
%%Page: 57 65
TeXDict begin 57 64 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(57)227 555 y(is)31 b(not)f(a)h(function)f(of)h(other)f(columns)h
(in)f(the)g(table\).)42 b(In)30 b(the)h(former)e(case,)j(the)f(parName)
f(parameter)227 668 y(is)40 b(the)g(name)f(of)h(the)g(column)f(\(whic)m
(h)h(ma)m(y)g(or)f(ma)m(y)h(not)g(already)g(exist\))h(in)m(to)f(whic)m
(h)g(to)g(write)g(the)227 781 y(results,)e(and)f(parInfo)e(con)m(tains)
j(an)f(optional)g(TF)m(ORM)g(k)m(eyw)m(ord)g(v)-5 b(alue)38
b(if)e(a)h(new)f(column)h(is)f(b)s(eing)227 894 y(created.)42
b(If)28 b(a)h(TF)m(ORM)h(v)-5 b(alue)29 b(is)g(not)g(sp)s(eci\014ed)g
(then)f(a)i(default)f(format)g(will)h(b)s(e)e(used,)h(dep)s(ending)e
(on)227 1007 y(the)35 b(expression.)54 b(If)34 b(the)h(expression)f(ev)
-5 b(aluates)37 b(to)e(a)g(constan)m(t,)i(then)e(the)g(result)f(will)h
(b)s(e)f(written)h(to)227 1120 y(the)28 b(k)m(eyw)m(ord)g(name)f(giv)m
(en)h(b)m(y)g(the)f(parName)h(parameter,)h(and)d(the)i(parInfo)e
(parameter)i(ma)m(y)g(b)s(e)f(used)227 1233 y(to)k(supply)e(an)h
(optional)i(commen)m(t)f(for)f(the)g(k)m(eyw)m(ord.)42
b(If)29 b(the)i(k)m(eyw)m(ord)g(do)s(es)f(not)g(already)h(exist,)g
(then)227 1346 y(the)f(name)f(of)h(the)g(k)m(eyw)m(ord)g(m)m(ust)f(b)s
(e)g(preceded)g(with)g(a)h('#')f(c)m(haracter,)j(otherwise)e(the)f
(result)h(will)g(b)s(e)227 1458 y(written)h(to)g(a)g(column)f(with)g
(that)h(name.)95 1719 y Fe(int)47 b(fits_calculator)d(/)j(ffcalc)286
1832 y(\(fitsfile)f(*infptr,)f(char)i(*expr,)f(fitsfile)f(*outfptr,)h
(char)g(*parName,)334 1945 y(char)h(*parInfo,)e(>)95
b(int)47 b(*status\))0 2205 y Fi(6)81 b Fj(This)38 b(calculator)k
(routine)e(is)f(similar)h(to)g(the)g(previous)f(routine,)j(except)f
(that)f(the)g(expression)f(is)h(only)227 2318 y(ev)-5
b(aluated)42 b(o)m(v)m(er)f(the)f(sp)s(eci\014ed)g(ro)m(w)g(ranges.)70
b(nranges)39 b(sp)s(eci\014es)h(the)g(n)m(um)m(b)s(er)f(of)h(ro)m(w)h
(ranges,)i(and)227 2431 y(\014rstro)m(w)30 b(and)g(lastro)m(w)h(giv)m
(e)h(the)f(starting)g(and)f(ending)g(ro)m(w)g(n)m(um)m(b)s(er)f(of)i
(eac)m(h)g(range.)95 2691 y Fe(int)47 b(fits_calculator_rng)c(/)k
(ffcalc_rng)286 2804 y(\(fitsfile)f(*infptr,)f(char)i(*expr,)f
(fitsfile)f(*outfptr,)h(char)g(*parName,)334 2917 y(char)h(*parInfo,)e
(int)i(nranges,)e(long)i(*firstrow,)e(long)i(*lastrow)334
3030 y(>)95 b(int)47 b(*status\))0 3290 y Fi(7)81 b Fj(Ev)-5
b(aluate)36 b(the)f(giv)m(en)h(expression)f(and)g(return)f(dimension)g
(and)h(t)m(yp)s(e)g(information)g(on)g(the)h(result.)54
b(The)227 3403 y(returned)37 b(dimensions)f(corresp)s(ond)g(to)j(a)e
(single)i(ro)m(w)e(en)m(try)h(of)f(the)h(requested)f(expression,)j(and)
d(are)227 3516 y(equiv)-5 b(alen)m(t)26 b(to)f(the)g(result)f(of)g
(\014ts)p 1380 3516 28 4 v 33 w(read)p 1585 3516 V 32
w(tdim\(\).)40 b(Note)25 b(that)g(strings)f(are)h(considered)f(to)h(b)s
(e)f(one)g(elemen)m(t)227 3629 y(regardless)31 b(of)g(string)f(length.)
41 b(If)30 b(maxdim)g(==)g(0,)h(then)f(naxes)g(is)h(optional.)95
3889 y Fe(int)47 b(fits_test_expr)d(/)k(fftexp)286 4002
y(\(fitsfile)e(*fptr,)g(char)g(*expr,)g(int)h(maxdim)f(>)i(int)f
(*datatype,)e(long)h(*nelem,)g(int)h(*naxis,)334 4115
y(long)g(*naxes,)f(int)g(*status\))0 4407 y Fd(5.7.6)112
b(Column)39 b(Binning)f(or)f(Histogramming)i(Routines)0
4626 y Fj(The)30 b(follo)m(wing)j(routines)e(ma)m(y)g(b)s(e)g(useful)f
(when)g(p)s(erforming)g(histogramming)h(op)s(erations)h(on)e
(column\(s\))i(of)0 4738 y(a)f(table)g(to)g(generate)h(an)e(image)i(in)
e(a)h(primary)e(arra)m(y)i(or)f(image)i(extension.)0
4999 y Fi(1)81 b Fj(Calculate)27 b(the)e(histogramming)h(parameters)g
(\(min,)h(max,)f(and)f(bin)g(size)h(for)f(eac)m(h)i(axis)f(of)f(the)h
(histogram,)227 5112 y(based)38 b(on)g(a)g(v)-5 b(ariet)m(y)39
b(of)f(p)s(ossible)g(input)f(parameters.)64 b(If)37 b(the)h(input)f
(names)h(of)g(the)g(columns)g(to)h(b)s(e)227 5225 y(binned)d(are)i(n)m
(ull,)h(then)e(the)h(routine)f(will)h(\014rst)f(lo)s(ok)h(for)f(the)h
(CPREF)f(=)g("NAME1,)j(NAME2,)h(...")227 5337 y(k)m(eyw)m(ord)34
b(whic)m(h)f(lists)h(the)g(preferred)e(columns.)50 b(If)32
b(not)i(presen)m(t,)h(then)e(the)g(routine)h(will)g(assume)f(the)227
5450 y(column)d(names)h(X,)f(Y,)h(Z,)f(and)g(T)g(for)g(up)g(to)h(4)f
(axes)h(\(as)g(sp)s(eci\014ed)f(b)m(y)g(the)h(NAXIS)f(parameter\).)227
5601 y(MININ)39 b(and)f(MAXIN)h(are)g(input)e(arra)m(ys)i(that)g(giv)m
(e)h(the)f(minim)m(um)e(and)h(maxim)m(um)h(v)-5 b(alue)39
b(for)f(the)227 5714 y(histogram,)30 b(along)f(eac)m(h)g(axis.)40
b(Alternativ)m(ely)-8 b(,)32 b(the)c(name)g(of)h(k)m(eyw)m(ords)f(that)
h(giv)m(e)g(the)f(min,)h(max,)g(and)p eop end
%%Page: 58 66
TeXDict begin 58 65 bop 0 299 a Fj(58)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(binsize)e(ma)m(y)g(b)s(e)f(giv)m(e)h(with)f
(the)h(MINNAME,)h(MAXNAME,)f(and)f(BINNAME)h(arra)m(y)g(parameters.)40
b(If)227 668 y(the)33 b(v)-5 b(alue)34 b(=)e(DOUBLENULL)-10
b(V)g(ALUE)33 b(and)g(no)f(k)m(eyw)m(ord)i(names)e(are)h(giv)m(en,)i
(then)e(the)g(routine)g(will)227 781 y(use)i(the)f(TLMINn)g(and)g
(TLMAXn)g(k)m(eyw)m(ords,)j(if)d(presen)m(t,)i(or)f(the)f(actual)i(min)
e(and/or)h(max)g(v)-5 b(alues)227 894 y(in)30 b(the)h(column.)227
1046 y(BINSIZEIN)j(is)h(an)g(arra)m(y)g(giving)h(the)f(binsize)g(along)
h(eac)m(h)g(axis.)55 b(If)34 b(the)h(v)-5 b(alue)36 b(=)e(DOUBLENULL-)
227 1159 y(V)-10 b(ALUE,)38 b(and)e(a)i(k)m(eyw)m(ord)f(name)g(is)h
(not)f(sp)s(eci\014ed)f(with)h(BINNAME,)h(then)f(this)g(routine)g(will)
h(\014rst)227 1272 y(lo)s(ok)d(for)f(the)g(TDBINn)g(k)m(eyw)m(ord,)i
(or)f(else)g(will)f(use)g(a)h(binsize)f(=)g(1,)h(or)g(a)f(binsize)g
(that)h(pro)s(duces)e(10)227 1385 y(histogram)e(bins,)f(whic)m(h)g(ev)m
(er)h(is)g(smaller.)95 1649 y Fe(int)47 b(fits_calc_binning)143
1761 y(Input)g(parameters:)239 1874 y(\(fitsfile)e(*fptr,)94
b(/*)47 b(IO)g(-)h(pointer)d(to)j(table)e(to)h(be)g(binned)667
b(*/)286 1987 y(int)47 b(naxis,)333 b(/*)47 b(I)g(-)h(number)e(of)h
(axes/columns)e(in)i(the)g(binned)f(image)94 b(*/)286
2100 y(char)47 b(colname[4][FLEN_VALUE],)137 b(/*)47
b(I)h(-)f(optional)f(column)g(names)428 b(*/)286 2213
y(double)46 b(*minin,)237 b(/*)47 b(I)h(-)f(optional)f(lower)g(bound)h
(value)f(for)h(each)f(axis)95 b(*/)286 2326 y(double)46
b(*maxin,)237 b(/*)47 b(I)h(-)f(optional)f(upper)g(bound)h(value,)f
(for)h(each)f(axis)h(*/)286 2439 y(double)f(*binsizein,)f(/*)i(I)h(-)f
(optional)f(bin)h(size)f(along)h(each)f(axis)429 b(*/)286
2552 y(char)47 b(minname[4][FLEN_VALUE],)41 b(/*)48 b(I)f(-)h(optional)
d(keywords)h(for)h(min)333 b(*/)286 2665 y(char)47 b
(maxname[4][FLEN_VALUE],)41 b(/*)48 b(I)f(-)h(optional)d(keywords)h
(for)h(max)333 b(*/)286 2778 y(char)47 b(binname[4][FLEN_VALUE],)41
b(/*)48 b(I)f(-)h(optional)d(keywords)h(for)h(binsize)141
b(*/)143 2891 y(Output)46 b(parameters:)286 3003 y(int)h(*colnum,)237
b(/*)47 b(O)g(-)h(column)e(numbers,)f(to)j(be)f(binned)f(*/)286
3116 y(long)h(*naxes,)237 b(/*)47 b(O)g(-)h(number)e(of)h(bins)g(in)g
(each)g(histogram)e(axis)h(*/)286 3229 y(float)h(*amin,)237
b(/*)47 b(O)g(-)h(lower)e(bound)h(of)g(the)g(histogram)e(axes)i(*/)286
3342 y(float)g(*amax,)237 b(/*)47 b(O)g(-)h(upper)e(bound)h(of)g(the)g
(histogram)e(axes)i(*/)286 3455 y(float)g(*binsize,)93
b(/*)47 b(O)g(-)h(width)e(of)h(histogram)f(bins/pixels)e(on)k(each)e
(axis)h(*/)286 3568 y(int)g(*status\))0 3832 y Fi(2)81
b Fj(Cop)m(y)26 b(the)h(relev)-5 b(an)m(t)28 b(k)m(eyw)m(ords)f(from)g
(the)g(header)f(of)h(the)g(table)h(that)f(is)g(b)s(eing)f(binned,)h(to)
g(the)g(the)g(header)227 3945 y(of)e(the)h(output)e(histogram)i(image.)
40 b(This)24 b(will)i(not)f(cop)m(y)h(the)f(table)h(structure)f(k)m
(eyw)m(ords)g(\(e.g.,)j(NAXIS,)227 4057 y(TF)m(ORMn,)j(TTYPEn,)f
(etc.\))44 b(nor)31 b(will)g(it)g(cop)m(y)h(the)f(k)m(eyw)m(ords)g
(that)h(apply)e(to)i(other)f(columns)g(of)g(the)227 4170
y(table)g(that)g(are)f(not)h(used)e(to)i(create)g(the)f(histogram.)42
b(This)29 b(routine)h(will)g(translate)h(the)g(names)f(of)g(the)227
4283 y(W)-8 b(orld)27 b(Co)s(ordinate)e(System)h(\(W)m(CS\))g(k)m(eyw)m
(ords)g(for)g(the)g(binned)e(columns)h(in)m(to)i(the)f(form)f(that)h
(is)g(need)227 4396 y(for)h(a)g(FITS)g(image)h(\(e.g.,)h(the)e(TCTYPn)f
(table)i(k)m(eyw)m(ord)f(will)g(b)s(e)g(translated)g(to)h(the)f(CTYPEn)
f(image)227 4509 y(k)m(eyw)m(ord\).)95 4773 y Fe(int)47
b(fits_copy_pixlist2image)286 4886 y(\(fitsfile)f(*infptr,)141
b(/*)47 b(I)g(-)h(pointer)e(to)h(input)f(HDU)h(*/)334
4999 y(fitsfile)f(*outfptr,)93 b(/*)47 b(I)g(-)h(pointer)e(to)h(output)
f(HDU)h(*/)334 5111 y(int)g(firstkey,)332 b(/*)47 b(I)g(-)h(first)e
(HDU)h(keyword)f(to)h(start)f(with)h(*/)334 5224 y(int)g(naxis,)476
b(/*)47 b(I)g(-)h(number)e(of)h(axes)g(in)g(the)g(image)f(*/)334
5337 y(int)h(*colnum,)380 b(/*)47 b(I)g(-)h(numbers)e(of)h(the)g
(columns)e(to)j(be)f(binned)94 b(*/)334 5450 y(int)47
b(*status\))380 b(/*)47 b(IO)g(-)g(error)g(status)f(*/)0
5714 y Fi(3)81 b Fj(W)-8 b(rite)36 b(a)f(set)h(of)f(default)h(W)m(CS)f
(k)m(eyw)m(ords)g(to)h(the)f(histogram)h(header,)g(IF)f(the)g(W)m(CS)g
(k)m(eyw)m(ords)h(do)f(not)p eop end
%%Page: 59 67
TeXDict begin 59 66 bop 0 299 a Fh(5.7.)72 b(ASCI)s(I)29
b(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(R)m(OUTINES)1864
b Fj(59)227 555 y(already)40 b(exist.)69 b(This)38 b(will)i(create)h(a)
e(linear)h(W)m(CS)f(where)g(the)h(co)s(ordinate)g(t)m(yp)s(es)f(are)h
(equal)g(to)g(the)227 668 y(original)32 b(column)e(names.)95
953 y Fe(int)47 b(fits_write_keys_histo)239 1066 y(\(fitsfile)e(*fptr,)
237 b(/*)47 b(I)h(-)f(pointer)f(to)h(table)f(to)i(be)f(binned)666
b(*/)286 1179 y(fitsfile)46 b(*histptr,)93 b(/*)47 b(I)h(-)f(pointer)f
(to)h(output)f(histogram)f(image)i(HDU)285 b(*/)286 1292
y(int)47 b(naxis,)476 b(/*)47 b(I)h(-)f(number)f(of)h(axes)g(in)g(the)g
(histogram)e(image)285 b(*/)286 1405 y(int)47 b(*colnum,)380
b(/*)47 b(I)h(-)f(column)f(numbers)g(of)h(the)g(binned)f(columns)332
b(*/)286 1518 y(int)47 b(*status\))0 1803 y Fi(4)81 b
Fj(Up)s(date)29 b(the)i(W)m(CS)f(k)m(eyw)m(ords)g(in)g(a)g(histogram)h
(image)g(header)f(that)h(giv)m(e)g(the)f(lo)s(cation)i(of)e(the)g
(reference)227 1916 y(pixel)h(\(CRPIXn\),)f(and)g(the)h(pixel)f(size)h
(\(CDEL)-8 b(Tn\),)31 b(in)f(the)h(binned)e(image.)95
2201 y Fe(int)47 b(fits_rebin_wcs)239 2314 y(\(fitsfile)e(*fptr,)237
b(/*)47 b(I)h(-)f(pointer)f(to)h(table)f(to)i(be)f(binned)523
b(*/)286 2426 y(int)47 b(naxis,)476 b(/*)47 b(I)h(-)f(number)f(of)h
(axes)g(in)g(the)g(histogram)e(image)142 b(*/)286 2539
y(float)47 b(*amin,)380 b(/*)47 b(I)h(-)f(first)f(pixel)h(include)f(in)
h(each)f(axis)381 b(*/)286 2652 y(float)47 b(*binsize,)236
b(/*)47 b(I)h(-)f(binning)f(factor)g(for)h(each)f(axis)572
b(*/)286 2765 y(int)47 b(*status\))0 3050 y Fi(5)81 b
Fj(Bin)33 b(the)h(v)-5 b(alues)35 b(in)e(the)h(input)f(table)h
(columns,)h(and)e(write)h(the)g(histogram)h(arra)m(y)f(to)g(the)g
(output)g(FITS)227 3163 y(image)e(\(histptr\).)95 3448
y Fe(int)47 b(fits_make_hist)143 3561 y(\(fitsfile)e(*fptr,)190
b(/*)47 b(I)g(-)h(pointer)e(to)h(table)f(with)h(X)g(and)g(Y)h(cols;)285
b(*/)191 3674 y(fitsfile)45 b(*histptr,)h(/*)h(I)g(-)h(pointer)e(to)h
(output)f(FITS)h(image)619 b(*/)191 3787 y(int)47 b(bitpix,)380
b(/*)47 b(I)g(-)h(datatype)d(for)i(image:)f(16,)h(32,)g(-32,)g(etc)238
b(*/)191 3900 y(int)47 b(naxis,)428 b(/*)47 b(I)g(-)h(number)e(of)h
(axes)g(in)g(the)g(histogram)e(image)190 b(*/)191 4013
y(long)47 b(*naxes,)332 b(/*)47 b(I)g(-)h(size)e(of)i(axes)e(in)h(the)g
(histogram)f(image)285 b(*/)191 4126 y(int)47 b(*colnum,)332
b(/*)47 b(I)g(-)h(column)e(numbers)g(\(array)g(length)g(=)h(naxis\))190
b(*/)191 4238 y(float)46 b(*amin,)333 b(/*)47 b(I)g(-)h(minimum)e
(histogram)f(value,)h(for)h(each)g(axis)142 b(*/)191
4351 y(float)46 b(*amax,)333 b(/*)47 b(I)g(-)h(maximum)e(histogram)f
(value,)h(for)h(each)g(axis)142 b(*/)191 4464 y(float)46
b(*binsize,)189 b(/*)47 b(I)g(-)h(bin)f(size)f(along)h(each)f(axis)811
b(*/)191 4577 y(float)46 b(weight,)285 b(/*)47 b(I)g(-)h(binning)e
(weighting)f(factor)h(\(FLOATNULLVALUE)e(*/)1098 4690
y(/*)238 b(for)47 b(no)g(weighting\))1143 b(*/)191 4803
y(int)47 b(wtcolnum,)284 b(/*)47 b(I)g(-)h(keyword)e(or)h(col)g(for)g
(weight)284 b(\(or)47 b(NULL\))g(*/)191 4916 y(int)g(recip,)428
b(/*)47 b(I)g(-)h(use)f(reciprocal)e(of)i(the)g(weight?)f(0)h(or)g(1)
239 b(*/)191 5029 y(char)47 b(*selectrow,)140 b(/*)47
b(I)g(-)h(optional)d(array)i(\(length)f(=)h(no.)g(of)477
b(*/)1098 5142 y(/*)47 b(rows)g(in)g(the)g(table\).)93
b(If)47 b(the)g(element)f(is)h(true)95 b(*/)1098 5255
y(/*)47 b(then)g(the)f(corresponding)f(row)i(of)g(the)g(table)f(will)h
(*/)1098 5368 y(/*)g(be)g(included)f(in)h(the)g(histogram,)e(otherwise)
g(the)95 b(*/)1098 5480 y(/*)47 b(row)g(will)f(be)i(skipped.)93
b(Ingnored)45 b(if)j(*selectrow)d(*/)1098 5593 y(/*)i(is)g(equal)f(to)i
(NULL.)1335 b(*/)191 5706 y(int)47 b(*status\))p eop
end
%%Page: 60 68
TeXDict begin 60 67 bop 0 299 a Fj(60)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Ff(5.8)135 b(Utilit)l(y)47 b(Routines)0
809 y Fd(5.8.1)112 b(File)39 b(Chec)m(ksum)f(Routines)0
1028 y Fj(The)33 b(follo)m(wing)h(routines)f(either)h(compute)f(or)h(v)
-5 b(alidate)34 b(the)g(c)m(hec)m(ksums)f(for)g(the)h(CHDU.)g(The)e(D)m
(A)-8 b(T)g(ASUM)0 1140 y(k)m(eyw)m(ord)33 b(is)f(used)f(to)i(store)f
(the)h(n)m(umerical)f(v)-5 b(alue)33 b(of)f(the)g(32-bit,)i(1's)f
(complemen)m(t)g(c)m(hec)m(ksum)g(for)f(the)g(data)0
1253 y(unit)26 b(alone.)40 b(If)25 b(there)h(is)h(no)e(data)i(unit)f
(then)f(the)h(v)-5 b(alue)27 b(is)f(set)g(to)h(zero.)40
b(The)26 b(n)m(umerical)g(v)-5 b(alue)27 b(is)f(stored)g(as)g(an)0
1366 y(ASCI)s(I)20 b(string)i(of)h(digits,)h(enclosed)f(in)e(quotes,)k
(b)s(ecause)d(the)g(v)-5 b(alue)23 b(ma)m(y)f(b)s(e)f(to)s(o)i(large)g
(to)g(represen)m(t)f(as)g(a)h(32-bit)0 1479 y(signed)28
b(in)m(teger.)41 b(The)27 b(CHECKSUM)g(k)m(eyw)m(ord)i(is)f(used)f(to)h
(store)h(the)f(ASCI)s(I)e(enco)s(ded)i(COMPLEMENT)f(of)0
1592 y(the)f(c)m(hec)m(ksum)h(for)f(the)h(en)m(tire)g(HDU.)g(Storing)f
(the)h(complemen)m(t,)h(rather)e(than)g(the)h(actual)g(c)m(hec)m(ksum,)
h(forces)0 1705 y(the)k(c)m(hec)m(ksum)h(for)f(the)h(whole)f(HDU)h(to)g
(equal)g(zero.)47 b(If)31 b(the)i(\014le)f(has)g(b)s(een)f(mo)s
(di\014ed)g(since)i(the)f(c)m(hec)m(ksums)0 1818 y(w)m(ere)39
b(computed,)i(then)e(the)g(HDU)g(c)m(hec)m(ksum)h(will)f(usually)f(not)
h(equal)h(zero.)66 b(These)39 b(c)m(hec)m(ksum)g(k)m(eyw)m(ord)0
1931 y(con)m(v)m(en)m(tions)34 b(are)f(based)f(on)g(a)g(pap)s(er)f(b)m
(y)h(Rob)g(Seaman)g(published)f(in)h(the)g(pro)s(ceedings)g(of)g(the)h
(AD)m(ASS)f(IV)0 2044 y(conference)h(in)e(Baltimore)j(in)d(No)m(v)m(em)
m(b)s(er)i(1994)h(and)d(a)h(later)h(revision)f(in)f(June)g(1995.)47
b(See)32 b(App)s(endix)e(B)i(for)0 2157 y(the)f(de\014nition)f(of)g
(the)h(parameters)f(used)g(in)g(these)h(routines.)0 2407
y Fi(1)81 b Fj(Compute)33 b(and)g(write)h(the)g(D)m(A)-8
b(T)g(ASUM)35 b(and)e(CHECKSUM)g(k)m(eyw)m(ord)h(v)-5
b(alues)34 b(for)f(the)h(CHDU)g(in)m(to)h(the)227 2520
y(curren)m(t)d(header.)46 b(If)32 b(the)g(k)m(eyw)m(ords)h(already)g
(exist,)g(their)g(v)-5 b(alues)32 b(will)h(b)s(e)e(up)s(dated)g(only)h
(if)h(necessary)227 2633 y(\(i.e.,)f(if)f(the)f(\014le)h(has)f(b)s(een)
f(mo)s(di\014ed)h(since)g(the)h(original)h(k)m(eyw)m(ord)e(v)-5
b(alues)31 b(w)m(ere)g(computed\).)95 2883 y Fe(int)47
b(fits_write_chksum)c(/)48 b(ffpcks)286 2996 y(\(fitsfile)e(*fptr,)g(>)
h(int)g(*status\))0 3246 y Fi(2)81 b Fj(Up)s(date)28
b(the)h(CHECKSUM)e(k)m(eyw)m(ord)i(v)-5 b(alue)29 b(in)f(the)h(CHDU,)g
(assuming)f(that)h(the)f(D)m(A)-8 b(T)g(ASUM)30 b(k)m(eyw)m(ord)227
3359 y(exists)36 b(and)f(already)h(has)f(the)h(correct)g(v)-5
b(alue.)56 b(This)35 b(routine)g(calculates)j(the)e(new)f(c)m(hec)m
(ksum)h(for)f(the)227 3471 y(curren)m(t)40 b(header)g(unit,)j(adds)c
(it)i(to)g(the)f(data)h(unit)f(c)m(hec)m(ksum,)k(enco)s(des)c(the)g(v)
-5 b(alue)41 b(in)m(to)g(an)f(ASCI)s(I)227 3584 y(string,)31
b(and)f(writes)g(the)h(string)f(to)h(the)g(CHECKSUM)e(k)m(eyw)m(ord.)95
3834 y Fe(int)47 b(fits_update_chksum)c(/)48 b(ffupck)286
3947 y(\(fitsfile)e(*fptr,)g(>)h(int)g(*status\))0 4197
y Fi(3)81 b Fj(V)-8 b(erify)35 b(the)f(CHDU)h(b)m(y)g(computing)f(the)h
(c)m(hec)m(ksums)g(and)f(comparing)h(them)f(with)g(the)h(k)m(eyw)m
(ords.)53 b(The)227 4310 y(data)34 b(unit)f(is)g(v)m(eri\014ed)g
(correctly)h(if)f(the)h(computed)f(c)m(hec)m(ksum)g(equals)h(the)f(v)-5
b(alue)34 b(of)f(the)g(D)m(A)-8 b(T)g(ASUM)227 4423 y(k)m(eyw)m(ord.)64
b(The)37 b(c)m(hec)m(ksum)i(for)f(the)g(en)m(tire)g(HDU)h(\(header)f
(plus)f(data)i(unit\))e(is)h(correct)h(if)f(it)h(equals)227
4536 y(zero.)47 b(The)32 b(output)f(D)m(A)-8 b(T)g(A)m(OK)34
b(and)d(HDUOK)i(parameters)f(in)g(this)g(routine)g(are)g(in)m(tegers)i
(whic)m(h)e(will)227 4649 y(ha)m(v)m(e)k(a)f(v)-5 b(alue)35
b(=)f(1)h(if)f(the)h(data)g(or)f(HDU)h(is)g(v)m(eri\014ed)f(correctly)
-8 b(,)38 b(a)d(v)-5 b(alue)35 b(=)f(0)h(if)f(the)h(D)m(A)-8
b(T)g(ASUM)36 b(or)227 4762 y(CHECKSUM)29 b(k)m(eyw)m(ord)g(is)h(not)f
(presen)m(t,)h(or)f(v)-5 b(alue)30 b(=)f(-1)h(if)f(the)h(computed)f(c)m
(hec)m(ksum)h(is)f(not)h(correct.)95 5125 y Fe(int)47
b(fits_verify_chksum)c(/)48 b(ffvcks)286 5238 y(\(fitsfile)e(*fptr,)g
(>)h(int)g(*dataok,)f(int)h(*hduok,)e(int)i(*status\))0
5488 y Fi(4)81 b Fj(Compute)40 b(and)g(return)g(the)h(c)m(hec)m(ksum)g
(v)-5 b(alues)41 b(for)g(the)g(CHDU)g(without)g(creating)h(or)f(mo)s
(difying)f(the)227 5601 y(CHECKSUM)33 b(and)h(D)m(A)-8
b(T)g(ASUM)35 b(k)m(eyw)m(ords.)52 b(This)33 b(routine)h(is)g(used)f
(in)m(ternally)i(b)m(y)f(\013v)m(c)m(ks,)i(but)d(ma)m(y)227
5714 y(b)s(e)d(useful)g(in)g(other)g(situations)h(as)g(w)m(ell.)p
eop end
%%Page: 61 69
TeXDict begin 61 68 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(61)95 555 y Fe(int)47 b(fits_get_chksum/)d
(/ffgcks)286 668 y(\(fitsfile)i(*fptr,)g(>)h(unsigned)f(long)g
(*datasum,)g(unsigned)f(long)i(*hdusum,)334 781 y(int)g(*status\))0
1022 y Fi(5)81 b Fj(Enco)s(de)23 b(a)h(c)m(hec)m(ksum)g(v)-5
b(alue)24 b(in)m(to)g(a)g(16-c)m(haracter)j(string.)38
b(If)23 b(complm)h(is)f(non-zero)i(\(true\))f(then)f(the)h(32-bit)227
1135 y(sum)30 b(v)-5 b(alue)31 b(will)f(b)s(e)g(complemen)m(ted)h(b)s
(efore)f(enco)s(ding.)95 1376 y Fe(int)47 b(fits_encode_chksum)c(/)48
b(ffesum)286 1489 y(\(unsigned)e(long)g(sum,)h(int)g(complm,)f(>)h
(char)g(*ascii\);)0 1730 y Fi(6)81 b Fj(Deco)s(de)24
b(a)f(16-c)m(haracter)j(c)m(hec)m(ksum)e(string)f(in)m(to)g(a)h
(unsigned)e(long)h(v)-5 b(alue.)39 b(If)23 b(is)g(non-zero)g(\(true\).)
39 b(then)23 b(the)227 1842 y(32-bit)33 b(sum)d(v)-5
b(alue)32 b(will)g(b)s(e)f(complemen)m(ted)h(after)g(deco)s(ding.)44
b(The)31 b(c)m(hec)m(ksum)h(v)-5 b(alue)32 b(is)g(also)g(returned)227
1955 y(as)f(the)f(v)-5 b(alue)31 b(of)g(the)f(function.)95
2196 y Fe(unsigned)46 b(long)h(fits_decode_chksum)42
b(/)48 b(ffdsum)525 2309 y(\(char)e(*ascii,)g(int)h(complm,)f(>)h
(unsigned)f(long)h(*sum\);)0 2597 y Fd(5.8.2)112 b(Date)38
b(and)g(Time)g(Utilit)m(y)f(Routines)0 2816 y Fj(The)29
b(follo)m(wing)i(routines)f(help)f(to)i(construct)f(or)f(parse)h(the)g
(FITS)f(date/time)i(strings.)41 b(Starting)30 b(in)f(the)h(y)m(ear)0
2929 y(2000,)k(the)d(FITS)g(D)m(A)-8 b(TE)32 b(k)m(eyw)m(ord)g(v)-5
b(alues)31 b(\(and)h(the)f(v)-5 b(alues)32 b(of)f(other)h(`D)m(A)-8
b(TE-')33 b(k)m(eyw)m(ords\))f(m)m(ust)f(ha)m(v)m(e)i(the)0
3042 y(form)j('YYYY-MM-DD')k(\(date)e(only\))f(or)g
('YYYY-MM-DDThh:mm:ss.ddd...')61 b(\(date)38 b(and)e(time\))h(where)0
3154 y(the)30 b(n)m(um)m(b)s(er)f(of)i(decimal)g(places)g(in)f(the)g
(seconds)g(v)-5 b(alue)31 b(is)f(optional.)42 b(These)30
b(times)h(are)f(in)g(UTC.)g(The)g(older)0 3267 y('dd/mm/yy')d(date)g
(format)g(ma)m(y)h(not)f(b)s(e)f(used)g(for)h(dates)h(after)f(01)h(Jan)
m(uary)e(2000.)42 b(See)27 b(App)s(endix)e(B)i(for)g(the)0
3380 y(de\014nition)j(of)h(the)f(parameters)h(used)e(in)h(these)h
(routines.)0 3621 y Fi(1)81 b Fj(Get)23 b(the)f(curren)m(t)f(system)i
(date.)38 b(C)22 b(already)g(pro)m(vides)g(standard)f(library)h
(routines)g(for)f(getting)j(the)e(curren)m(t)227 3734
y(date)k(and)e(time,)j(but)d(this)h(routine)g(is)g(pro)m(vided)g(for)f
(compatibilit)m(y)k(with)c(the)h(F)-8 b(ortran)26 b(FITSIO)e(library)-8
b(.)227 3847 y(The)30 b(returned)f(y)m(ear)j(has)e(4)g(digits)h
(\(1999,)i(2000,)g(etc.\))95 4088 y Fe(int)47 b
(fits_get_system_date/ffgsd)o(t)286 4201 y(\()h(>)f(int)g(*day,)g(int)f
(*month,)g(int)h(*year,)f(int)h(*status)f(\))0 4442 y
Fi(2)81 b Fj(Get)34 b(the)g(curren)m(t)g(system)f(date)i(and)e(time)h
(string)g(\('YYYY-MM-DDThh:mm:ss'\).)53 b(The)33 b(time)i(will)f(b)s(e)
227 4555 y(in)26 b(UTC/GMT)g(if)g(a)m(v)-5 b(ailable,)29
b(as)e(indicated)f(b)m(y)g(a)g(returned)f(timeref)h(v)-5
b(alue)27 b(=)e(0.)40 b(If)26 b(the)g(returned)e(v)-5
b(alue)227 4668 y(of)31 b(timeref)g(=)g(1)g(then)f(this)h(indicates)g
(that)h(it)f(w)m(as)g(not)g(p)s(ossible)f(to)h(con)m(v)m(ert)i(the)d
(lo)s(cal)i(time)g(to)f(UTC,)227 4780 y(and)f(th)m(us)g(the)h(lo)s(cal)
g(time)g(w)m(as)g(returned.)95 5021 y Fe(int)47 b
(fits_get_system_time/ffgst)o(m)286 5134 y(\(>)h(char)e(*datestr,)f
(int)95 b(*timeref,)45 b(int)i(*status\))0 5375 y Fi(3)81
b Fj(Construct)26 b(a)i(date)g(string)f(from)g(the)g(input)f(date)i(v)
-5 b(alues.)40 b(If)27 b(the)g(y)m(ear)h(is)g(b)s(et)m(w)m(een)f(1900)i
(and)e(1998,)j(inclu-)227 5488 y(siv)m(e,)38 b(then)c(the)i(returned)d
(date)j(string)f(will)g(ha)m(v)m(e)i(the)e(old)g(FITS)f(format)i
(\('dd/mm/yy'\),)h(otherwise)227 5601 y(the)32 b(date)f(string)g(will)h
(ha)m(v)m(e)g(the)g(new)e(FITS)h(format)g(\('YYYY-MM-DD'\).)36
b(Use)31 b(\014ts)p 3229 5601 28 4 v 33 w(time2str)h(instead)227
5714 y(to)f(alw)m(a)m(ys)h(return)e(a)g(date)h(string)g(using)f(the)g
(new)g(FITS)g(format.)p eop end
%%Page: 62 70
TeXDict begin 62 69 bop 0 299 a Fj(62)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_date2str/ffdt2s)286
668 y(\(int)g(year,)f(int)h(month,)f(int)h(day,)g(>)g(char)g(*datestr,)
e(int)i(*status\))0 928 y Fi(4)81 b Fj(Construct)34 b(a)i(new-format)f
(date)h(+)f(time)h(string)f(\('YYYY-MM-DDThh:mm:ss.ddd...'\).)57
b(If)34 b(the)i(y)m(ear,)227 1041 y(mon)m(th,)d(and)e(da)m(y)h(v)-5
b(alues)32 b(all)h(=)e(0)h(then)g(only)g(the)g(time)g(is)g(enco)s(ded)f
(with)h(format)g('hh:mm:ss.ddd...'.)227 1154 y(The)j(decimals)h
(parameter)g(sp)s(eci\014es)e(ho)m(w)i(man)m(y)f(decimal)h(places)g(of)
f(fractional)i(seconds)e(to)h(include)227 1266 y(in)30
b(the)h(string.)41 b(If)29 b(`decimals')j(is)f(negativ)m(e,)h(then)f
(only)f(the)h(date)g(will)f(b)s(e)g(return)f(\('YYYY-MM-DD'\).)95
1526 y Fe(int)47 b(fits_time2str/fftm2s)286 1639 y(\(int)g(year,)f(int)
h(month,)f(int)h(day,)g(int)g(hour,)f(int)h(minute,)f(double)g(second,)
286 1752 y(int)h(decimals,)f(>)h(char)g(*datestr,)e(int)i(*status\))0
2012 y Fi(5)81 b Fj(Return)44 b(the)g(date)i(as)f(read)f(from)h(the)g
(input)e(string,)49 b(where)44 b(the)h(string)g(ma)m(y)g(b)s(e)f(in)h
(either)g(the)g(old)227 2125 y(\('dd/mm/yy'\))29 b(or)f(new)f
(\('YYYY-MM-DDThh:mm:ss')k(or)d('YYYY-MM-DD'\))j(FITS)d(format.)40
b(Null)227 2237 y(p)s(oin)m(ters)31 b(ma)m(y)f(b)s(e)g(supplied)f(for)h
(an)m(y)h(un)m(w)m(an)m(ted)g(output)f(date)h(parameters.)95
2497 y Fe(int)47 b(fits_str2date/ffs2dt)286 2610 y(\(char)g(*datestr,)e
(>)i(int)g(*year,)f(int)h(*month,)f(int)h(*day,)f(int)h(*status\))0
2870 y Fi(6)81 b Fj(Return)30 b(the)h(date)h(and)f(time)h(as)f(read)g
(from)g(the)h(input)e(string,)h(where)g(the)h(string)f(ma)m(y)h(b)s(e)e
(in)h(either)h(the)227 2983 y(old)d(or)f(new)g(FITS)g(format.)40
b(The)28 b(returned)f(hours,)h(min)m(utes,)h(and)f(seconds)g(v)-5
b(alues)29 b(will)f(b)s(e)g(set)h(to)g(zero)227 3095
y(if)k(the)h(input)e(string)h(do)s(es)g(not)h(include)f(the)g(time)h
(\('dd/mm/yy')f(or)h('YYYY-MM-DD'\))j(.)c(Similarly)-8
b(,)227 3208 y(the)36 b(returned)e(y)m(ear,)j(mon)m(th,)g(and)d(date)i
(v)-5 b(alues)36 b(will)f(b)s(e)g(set)h(to)g(zero)g(if)f(the)g(date)h
(is)f(not)h(included)e(in)227 3321 y(the)29 b(input)f(string)h
(\('hh:mm:ss.ddd...'\).)40 b(Null)29 b(p)s(oin)m(ters)f(ma)m(y)i(b)s(e)
e(supplied)f(for)i(an)m(y)g(un)m(w)m(an)m(ted)g(output)227
3434 y(date)i(and)f(time)h(parameters.)95 3694 y Fe(int)47
b(fits_str2time/ffs2tm)286 3807 y(\(char)g(*datestr,)e(>)i(int)g
(*year,)f(int)h(*month,)f(int)h(*day,)f(int)h(*hour,)286
3920 y(int)g(*minute,)f(double)g(*second,)f(int)i(*status\))0
4210 y Fd(5.8.3)112 b(General)39 b(Utilit)m(y)e(Routines)0
4429 y Fj(The)30 b(follo)m(wing)i(utilit)m(y)f(routines)g(ma)m(y)g(b)s
(e)e(useful)h(for)g(certain)h(applications.)0 4689 y
Fi(1)81 b Fj(Return)30 b(the)h(revision)g(n)m(um)m(b)s(er)f(of)h(the)g
(CFITSIO)f(library)-8 b(.)42 b(The)31 b(revision)g(n)m(um)m(b)s(er)f
(will)h(b)s(e)f(incremen)m(ted)227 4802 y(with)g(eac)m(h)i(new)e
(release)h(of)g(CFITSIO.)95 5061 y Fe(float)47 b(fits_get_version)c(/)
48 b(ffvers)e(\()h(>)h(float)e(*version\))0 5321 y Fi(2)81
b Fj(W)-8 b(rite)34 b(an)g(80-c)m(haracter)i(message)e(to)g(the)g
(CFITSIO)e(error)h(stac)m(k.)51 b(Application)34 b(programs)f(should)g
(not)227 5434 y(normally)e(write)f(to)i(the)e(stac)m(k,)i(but)e(there)g
(ma)m(y)h(b)s(e)f(some)h(situations)g(where)f(this)g(is)h(desirable.)95
5694 y Fe(void)47 b(fits_write_errmsg)c(/)48 b(ffpmsg)e(\(char)g
(*err_msg\))p eop end
%%Page: 63 71
TeXDict begin 63 70 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(63)0 555 y Fi(3)81 b Fj(Con)m(v)m(ert)31
b(a)g(c)m(haracter)h(string)e(to)h(upp)s(ercase)e(\(op)s(erates)j(in)e
(place\).)95 817 y Fe(void)47 b(fits_uppercase)d(/)j(ffupch)g(\(char)f
(*string\))0 1079 y Fi(4)81 b Fj(Compare)43 b(the)i(input)e(template)i
(string)f(against)h(the)g(reference)f(string)g(to)h(see)g(if)f(they)g
(matc)m(h.)82 b(The)227 1192 y(template)36 b(string)f(ma)m(y)g(con)m
(tain)g(wildcard)f(c)m(haracters:)51 b('*')35 b(will)g(matc)m(h)g(an)m
(y)g(sequence)g(of)f(c)m(haracters)227 1305 y(\(including)j(zero)h(c)m
(haracters\))g(and)e(')10 b(?')60 b(will)38 b(matc)m(h)f(an)m(y)g
(single)h(c)m(haracter)g(in)f(the)g(reference)g(string.)227
1418 y(The)e('#')h(c)m(haracter)h(will)f(matc)m(h)g(an)m(y)g
(consecutiv)m(e)h(string)f(of)f(decimal)i(digits)f(\(0)g(-)f(9\).)57
b(If)35 b(casesen)h(=)227 1531 y(CASESEN)c(=)h(TR)m(UE)h(then)f(the)g
(matc)m(h)i(will)e(b)s(e)g(case)h(sensitiv)m(e,)i(otherwise)e(the)f
(case)i(of)e(the)h(letters)227 1644 y(will)g(b)s(e)f(ignored)h(if)g
(casesen)g(=)g(CASEINSEN)e(=)h(F)-10 b(ALSE.)34 b(The)f(returned)f(MA)
-8 b(TCH)34 b(parameter)h(will)227 1757 y(b)s(e)30 b(TR)m(UE)g(if)g
(the)g(2)h(strings)f(matc)m(h,)h(and)f(EXA)m(CT)g(will)g(b)s(e)g(TR)m
(UE)g(if)g(the)g(matc)m(h)h(is)f(exact)i(\(i.e.,)g(if)e(no)227
1870 y(wildcard)k(c)m(haracters)i(w)m(ere)f(used)e(in)h(the)h(matc)m
(h\).)53 b(Both)35 b(strings)g(m)m(ust)f(b)s(e)f(68)j(c)m(haracters)f
(or)g(less)f(in)227 1983 y(length.)95 2245 y Fe(void)47
b(fits_compare_str)c(/)48 b(ffcmps)334 2358 y(\(char)e(*templt,)g(char)
h(*string,)e(int)i(casesen,)f(>)h(int)g(*match,)f(int)h(*exact\))0
2620 y Fi(5)81 b Fj(Split)30 b(a)i(string)f(con)m(taining)h(a)g(list)f
(of)g(names)g(\(t)m(ypically)j(\014le)d(names)g(or)g(column)f(names\))i
(in)m(to)g(individual)227 2733 y(name)23 b(tok)m(ens)g(b)m(y)g(a)g
(sequence)g(of)g(calls)g(to)h(\014ts)p 1814 2733 28 4
v 32 w(split)p 2018 2733 V 33 w(names.)38 b(The)22 b(names)h(in)f(the)h
(list)g(m)m(ust)f(b)s(e)g(delimited)227 2846 y(b)m(y)45
b(a)f(comma)i(and/or)e(spaces.)83 b(This)44 b(routine)g(ignores)h
(spaces)g(and)f(commas)h(that)g(o)s(ccur)f(within)227
2959 y(paren)m(theses,)36 b(brac)m(k)m(ets,)h(or)e(curly)f(brac)m(k)m
(ets.)54 b(It)35 b(also)g(strips)f(an)m(y)h(leading)g(and)f(trailing)h
(blanks)f(from)227 3072 y(the)d(returned)e(name.)227
3223 y(This)h(routine)g(is)h(similar)f(to)h(the)g(ANSI)f(C)g('strtok')h
(function:)227 3374 y(The)37 b(\014rst)f(call)i(to)g(\014ts)p
1033 3374 V 32 w(split)p 1237 3374 V 33 w(names)f(has)g(a)g(non-n)m
(ull)f(input)g(string.)61 b(It)37 b(\014nds)e(the)i(\014rst)f(name)h
(in)g(the)227 3487 y(string)26 b(and)f(terminates)h(it)h(b)m(y)e(o)m(v)
m(erwriting)i(the)f(next)g(c)m(haracter)h(of)f(the)g(string)f(with)h(a)
g(n)m(ull)f(terminator)227 3600 y(and)31 b(returns)g(a)h(p)s(oin)m(ter)
f(to)i(the)e(name.)45 b(Eac)m(h)32 b(subsequen)m(t)f(call,)j(indicated)
e(b)m(y)f(a)h(NULL)g(v)-5 b(alue)32 b(of)g(the)227 3713
y(input)f(string,)i(returns)e(the)h(next)h(name,)f(searc)m(hing)h(from)
f(just)g(past)g(the)g(end)f(of)i(the)f(previous)g(name.)227
3826 y(It)f(returns)e(NULL)h(when)g(no)g(further)f(names)h(are)h
(found.)143 4088 y Fe(char)47 b(*fits_split_names\(char)42
b(*namelist\))0 4350 y Fj(The)30 b(follo)m(wing)i(example)f(sho)m(ws)f
(ho)m(w)g(a)h(string)f(w)m(ould)h(b)s(e)e(split)i(in)m(to)g(3)g(names:)
191 4612 y Fe(myfile[1][bin)44 b(\(x,y\)=4],)h(file2.fits)93
b(file3.fits)191 4725 y(^^^^^^^^^^^^^^^^^^^^^^)c(^^^^^^^^^^)k
(^^^^^^^^^^)382 4838 y(1st)47 b(name)619 b(2nd)47 b(name)190
b(3rd)47 b(name)0 5100 y Fi(6)81 b Fj(T)-8 b(est)34 b(that)g(the)g(k)m
(eyw)m(ord)g(name)f(con)m(tains)i(only)e(legal)j(c)m(haracters)f
(\(A-Z,0-9,)h(h)m(yphen,)d(and)g(underscore\))227 5213
y(or)e(that)g(the)f(k)m(eyw)m(ord)h(record)f(con)m(tains)i(only)e
(legal)i(prin)m(table)f(ASCI)s(I)e(c)m(haracters)95 5475
y Fe(int)47 b(fits_test_keyword)c(/)48 b(fftkey)e(\(char)g(*keyname,)g
(>)h(int)g(*status\))95 5701 y(int)g(fits_test_record)d(/)j(fftrec)f
(\(char)h(*card,)f(>)h(int)g(*status\))p eop end
%%Page: 64 72
TeXDict begin 64 71 bop 0 299 a Fj(64)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fi(7)81 b Fj(T)-8 b(est)25 b(whether)f(the)h
(curren)m(t)f(header)h(con)m(tains)g(an)m(y)g(NULL)g(\(ASCI)s(I)e(0\))j
(c)m(haracters.)40 b(These)24 b(c)m(haracters)j(are)227
668 y(illegal)37 b(in)d(the)h(header,)g(but)f(they)g(will)h(go)g
(undetected)g(b)m(y)f(most)h(of)g(the)f(CFITSIO)f(k)m(eyw)m(ord)i
(header)227 781 y(routines,)29 b(b)s(ecause)f(the)h(n)m(ull)f(is)g(in)m
(terpreted)g(as)h(the)f(normal)g(end-of-string)h(terminator.)41
b(This)27 b(routine)227 894 y(returns)h(the)g(p)s(osition)h(of)g(the)g
(\014rst)f(n)m(ull)g(c)m(haracter)i(in)f(the)f(header,)h(or)g(zero)g
(if)g(there)g(are)g(no)f(n)m(ulls.)40 b(F)-8 b(or)227
1007 y(example)37 b(a)f(returned)f(v)-5 b(alue)37 b(of)f(110)h(w)m
(ould)f(indicate)h(that)g(the)f(\014rst)f(NULL)h(is)g(lo)s(cated)h(in)f
(the)g(30th)227 1120 y(c)m(haracter)28 b(of)f(the)g(second)f(k)m(eyw)m
(ord)h(in)f(the)h(header)f(\(recall)i(that)f(eac)m(h)h(header)e(record)
h(is)f(80)h(c)m(haracters)227 1233 y(long\).)45 b(Note)33
b(that)f(this)g(is)f(one)h(of)g(the)g(few)f(CFITSIO)f(routines)h(in)h
(whic)m(h)f(the)h(returned)e(v)-5 b(alue)32 b(is)g(not)227
1346 y(necessarily)g(equal)e(to)i(the)e(status)h(v)-5
b(alue\).)95 1597 y Fe(int)47 b(fits_null_check)d(/)j(ffnchk)g(\(char)f
(*card,)g(>)h(int)g(*status\))0 1849 y Fi(8)81 b Fj(P)m(arse)25
b(a)g(header)g(k)m(eyw)m(ord)g(record)g(and)f(return)g(the)h(name)g(of)
g(the)g(k)m(eyw)m(ord,)i(and)d(the)h(length)h(of)f(the)g(name.)227
1962 y(The)34 b(k)m(eyw)m(ord)h(name)f(normally)h(o)s(ccupies)f(the)h
(\014rst)e(8)i(c)m(haracters)g(of)g(the)f(record,)i(except)f(under)e
(the)227 2075 y(HIERAR)m(CH)e(con)m(v)m(en)m(tion)h(where)e(the)h(name)
f(can)h(b)s(e)f(up)f(to)i(70)g(c)m(haracters)h(in)e(length.)95
2326 y Fe(int)47 b(fits_get_keyname)d(/)j(ffgknm)286
2439 y(\(char)g(*card,)f(>)h(char)g(*keyname,)e(int)i(*keylength,)e
(int)i(*status\))0 2691 y Fi(9)81 b Fj(P)m(arse)29 b(a)h(header)f(k)m
(eyw)m(ord)h(record,)f(returning)g(the)g(v)-5 b(alue)30
b(\(as)g(a)f(literal)i(c)m(haracter)g(string\))e(and)g(commen)m(t)227
2804 y(strings.)40 b(If)27 b(the)g(k)m(eyw)m(ord)h(has)f(no)g(v)-5
b(alue)28 b(\(columns)f(9-10)i(not)f(equal)f(to)h('=)g('\),)g(then)f(a)
h(n)m(ull)f(v)-5 b(alue)28 b(string)227 2916 y(is)j(returned)e(and)h
(the)g(commen)m(t)i(string)e(is)g(set)h(equal)g(to)g(column)f(9)h(-)g
(80)g(of)g(the)f(input)g(string.)95 3168 y Fe(int)47
b(fits_parse_value)d(/)j(ffpsvc)286 3281 y(\(char)g(*card,)f(>)h(char)g
(*value,)f(char)g(*comment,)g(int)h(*status\))0 3533
y Fi(10)f Fj(Construct)26 b(an)h(arra)m(y)g(indexed)f(k)m(eyw)m(ord)h
(name)f(\(R)m(OOT)g(+)h(nnn\).)38 b(This)26 b(routine)g(app)s(ends)f
(the)i(sequence)227 3645 y(n)m(um)m(b)s(er)i(to)i(the)g(ro)s(ot)g
(string)f(to)h(create)h(a)f(k)m(eyw)m(ord)g(name)f(\(e.g.,)i('NAXIS')f
(+)f(2)h(=)f('NAXIS2'\))95 3897 y Fe(int)47 b(fits_make_keyn)d(/)k
(ffkeyn)286 4010 y(\(char)f(*keyroot,)e(int)i(value,)f(>)h(char)g
(*keyname,)e(int)i(*status\))0 4261 y Fi(11)f Fj(Construct)41
b(a)h(sequence)f(k)m(eyw)m(ord)h(name)g(\(n)f(+)g(R)m(OOT\).)g(This)g
(routine)g(concatenates)j(the)e(sequence)227 4374 y(n)m(um)m(b)s(er)20
b(to)j(the)e(fron)m(t)h(of)g(the)f(ro)s(ot)h(string)g(to)g(create)h(a)f
(k)m(eyw)m(ord)g(name)g(\(e.g.,)j(1)d(+)f('CTYP')g(=)g('1CTYP'\))95
4739 y Fe(int)47 b(fits_make_nkey)d(/)k(ffnkey)286 4852
y(\(int)f(value,)f(char)h(*keyroot,)e(>)i(char)g(*keyname,)e(int)i
(*status\))0 5103 y Fi(12)f Fj(Determine)41 b(the)g(data)f(t)m(yp)s(e)h
(of)f(a)h(k)m(eyw)m(ord)f(v)-5 b(alue)41 b(string.)70
b(This)39 b(routine)i(parses)e(the)i(k)m(eyw)m(ord)f(v)-5
b(alue)227 5216 y(string)28 b(to)h(determine)f(its)g(data)h(t)m(yp)s
(e.)40 b(Returns)27 b('C',)h('L',)h('I',)f('F')h(or)f('X',)g(for)g(c)m
(haracter)i(string,)e(logical,)227 5329 y(in)m(teger,)k(\015oating)g(p)
s(oin)m(t,)e(or)h(complex,)g(resp)s(ectiv)m(ely)-8 b(.)95
5581 y Fe(int)47 b(fits_get_keytype)d(/)j(ffdtyp)286
5694 y(\(char)g(*value,)f(>)h(char)g(*dtype,)e(int)i(*status\))p
eop end
%%Page: 65 73
TeXDict begin 65 72 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(65)0 555 y Fi(13)46 b Fj(Determine)39
b(the)f(in)m(teger)h(data)g(t)m(yp)s(e)f(of)g(an)g(in)m(teger)h(k)m
(eyw)m(ord)f(v)-5 b(alue)39 b(string.)63 b(The)37 b(returned)g(datat)m
(yp)s(e)227 668 y(v)-5 b(alue)36 b(is)f(the)g(minim)m(um)f(in)m(teger)i
(datat)m(yp)s(e)g(\(starting)g(from)f(top)g(of)g(the)g(follo)m(wing)i
(list)e(and)g(w)m(orking)227 781 y(do)m(wn\))c(required)e(to)i(store)g
(the)g(in)m(teger)h(v)-5 b(alue:)191 1045 y Fe(Data)47
b(Type)285 b(Range)239 1158 y(TSBYTE:)236 b(-128)47 b(to)g(127)239
1271 y(TBYTE:)332 b(128)47 b(to)g(255)239 1384 y(TSHORT:)236
b(-32768)46 b(to)i(32767)239 1497 y(TUSHORT:)236 b(32768)46
b(to)i(65535)239 1610 y(TINT)380 b(-2147483648)45 b(to)i(2147483647)239
1722 y(TUINT)380 b(2147483648)45 b(to)i(4294967295)239
1835 y(TLONGLONG)140 b(-9223372036854775808)43 b(to)k
(9223372036854775807)80 2099 y Fj(The)30 b(*neg)h(parameter)g(returns)e
(1)i(if)f(the)h(input)e(v)-5 b(alue)31 b(is)g(negativ)m(e)h(and)e
(returns)f(0)i(if)f(it)h(is)g(non-negativ)m(e.)95 2363
y Fe(int)47 b(fits_get_inttype)d(/)j(ffinttyp)286 2476
y(\(char)g(*value,)f(>)h(int)g(*datatype,)e(int)i(*neg,)f(int)h
(*status\))0 2740 y Fi(14)f Fj(Return)35 b(the)g(class)h(of)g(an)f
(input)g(header)g(record.)56 b(The)35 b(record)g(is)g(classi\014ed)h
(in)m(to)h(one)e(of)h(the)f(follo)m(wing)227 2853 y(categories)d(\(the)
e(class)g(v)-5 b(alues)30 b(are)f(de\014ned)f(in)h(\014tsio.h\).)41
b(Note)31 b(that)e(this)h(is)f(one)h(of)f(the)g(few)g(CFITSIO)227
2966 y(routines)i(that)f(do)s(es)h(not)f(return)f(a)i(status)g(v)-5
b(alue.)334 3230 y Fe(Class)94 b(Value)619 b(Keywords)95
3343 y(TYP_STRUC_KEY)92 b(10)j(SIMPLE,)46 b(BITPIX,)g(NAXIS,)g(NAXISn,)
g(EXTEND,)g(BLOCKED,)1002 3456 y(GROUPS,)g(PCOUNT,)g(GCOUNT,)g(END)1002
3569 y(XTENSION,)g(TFIELDS,)f(TTYPEn,)h(TBCOLn,)g(TFORMn,)g(THEAP,)1002
3681 y(and)h(the)g(first)f(4)i(COMMENT)e(keywords)f(in)i(the)g(primary)
f(array)1002 3794 y(that)h(define)f(the)h(FITS)g(format.)95
3907 y(TYP_CMPRS_KEY)92 b(20)j(The)47 b(experimental)e(keywords)g(used)
i(in)g(the)g(compressed)1002 4020 y(image)g(format)f(ZIMAGE,)g
(ZCMPTYPE,)f(ZNAMEn,)h(ZVALn,)1002 4133 y(ZTILEn,)g(ZBITPIX,)g
(ZNAXISn,)f(ZSCALE,)h(ZZERO,)g(ZBLANK)95 4246 y(TYP_SCAL_KEY)140
b(30)95 b(BSCALE,)46 b(BZERO,)g(TSCALn,)g(TZEROn)95 4359
y(TYP_NULL_KEY)140 b(40)95 b(BLANK,)46 b(TNULLn)95 4472
y(TYP_DIM_KEY)188 b(50)95 b(TDIMn)95 4585 y(TYP_RANG_KEY)140
b(60)95 b(TLMINn,)46 b(TLMAXn,)g(TDMINn,)g(TDMAXn,)g(DATAMIN,)f
(DATAMAX)95 4698 y(TYP_UNIT_KEY)140 b(70)95 b(BUNIT,)46
b(TUNITn)95 4811 y(TYP_DISP_KEY)140 b(80)95 b(TDISPn)95
4924 y(TYP_HDUID_KEY)d(90)j(EXTNAME,)46 b(EXTVER,)g(EXTLEVEL,)f
(HDUNAME,)g(HDUVER,)h(HDULEVEL)95 5036 y(TYP_CKSUM_KEY)f(100)94
b(CHECKSUM,)46 b(DATASUM)95 5149 y(TYP_WCS_KEY)141 b(110)94
b(WCS)47 b(keywords)f(defined)g(in)h(the)g(the)g(WCS)f(papers,)g
(including:)1002 5262 y(CTYPEn,)g(CUNITn,)g(CRVALn,)g(CRPIXn,)g
(CROTAn,)f(CDELTn)1002 5375 y(CDj_is,)h(PVj_ms,)g(LONPOLEs,)f(LATPOLEs)
1002 5488 y(TCTYPn,)h(TCTYns,)g(TCUNIn,)g(TCUNns,)g(TCRVLn,)f(TCRVns,)h
(TCRPXn,)1002 5601 y(TCRPks,)g(TCDn_k,)g(TCn_ks,)g(TPVn_m,)g(TPn_ms,)f
(TCDLTn,)h(TCROTn)1002 5714 y(jCTYPn,)g(jCTYns,)g(jCUNIn,)g(jCUNns,)g
(jCRVLn,)f(jCRVns,)h(iCRPXn,)p eop end
%%Page: 66 74
TeXDict begin 66 73 bop 0 299 a Fj(66)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)1002 555 y Fe(iCRPns,)46 b(jiCDn,)94 b(jiCDns,)46
b(jPVn_m,)g(jPn_ms,)f(jCDLTn,)h(jCROTn)1002 668 y(\(i,j,m,n)g(are)h
(integers,)e(s)i(is)h(any)f(letter\))95 781 y(TYP_REFSYS_KEY)d(120)j
(EQUINOXs,)f(EPOCH,)g(MJD-OBSs,)f(RADECSYS,)g(RADESYSs,)g(DATE-OBS)95
894 y(TYP_COMM_KEY)140 b(130)47 b(COMMENT,)f(HISTORY,)f(\(blank)h
(keyword\))95 1007 y(TYP_CONT_KEY)140 b(140)47 b(CONTINUE)95
1120 y(TYP_USER_KEY)140 b(150)47 b(all)g(other)g(keywords)95
1346 y(int)g(fits_get_keyclass)c(/)48 b(ffgkcl)e(\(char)g(*card\))0
1628 y Fi(15)g Fj(P)m(arse)28 b(the)g('TF)m(ORM')g(binary)f(table)h
(column)g(format)f(string.)40 b(This)27 b(routine)g(parses)g(the)h
(input)f(TF)m(ORM)227 1740 y(c)m(haracter)38 b(string)d(and)g(returns)g
(the)g(in)m(teger)i(data)g(t)m(yp)s(e)f(co)s(de,)h(the)f(rep)s(eat)g
(coun)m(t)g(of)g(the)f(\014eld,)i(and,)227 1853 y(in)e(the)f(case)i(of)
f(c)m(haracter)h(string)f(\014elds,)g(the)g(length)g(of)g(the)g(unit)f
(string.)54 b(See)34 b(App)s(endix)f(B)i(for)g(the)227
1966 y(allo)m(w)m(ed)41 b(v)-5 b(alues)38 b(for)h(the)f(returned)g(t)m
(yp)s(eco)s(de)h(parameter.)65 b(A)39 b(n)m(ull)f(p)s(oin)m(ter)h(ma)m
(y)g(b)s(e)f(giv)m(en)h(for)g(an)m(y)227 2079 y(output)30
b(parameters)h(that)g(are)g(not)f(needed.)143 2361 y
Fe(int)47 b(fits_binary_tform)c(/)48 b(ffbnfm)334 2474
y(\(char)e(*tform,)g(>)i(int)f(*typecode,)e(long)h(*repeat,)g(long)g
(*width,)382 2587 y(int)h(*status\))143 2813 y(int)g
(fits_binary_tformll)c(/)k(ffbnfmll)334 2926 y(\(char)f(*tform,)g(>)i
(int)f(*typecode,)e(LONGLONG)g(*repeat,)h(long)g(*width,)382
3039 y(int)h(*status\))0 3321 y Fi(16)f Fj(P)m(arse)38
b(the)f('TF)m(ORM')h(k)m(eyw)m(ord)g(v)-5 b(alue)37 b(that)h(de\014nes)
e(the)h(column)g(format)h(in)e(an)h(ASCI)s(I)f(table.)62
b(This)227 3434 y(routine)29 b(parses)g(the)g(input)f(TF)m(ORM)h(c)m
(haracter)h(string)f(and)g(returns)e(the)i(data)h(t)m(yp)s(e)f(co)s
(de,)h(the)f(width)227 3546 y(of)f(the)f(column,)h(and)f(\(if)h(it)g
(is)f(a)h(\015oating)g(p)s(oin)m(t)g(column\))f(the)h(n)m(um)m(b)s(er)e
(of)h(decimal)i(places)f(to)g(the)f(righ)m(t)227 3659
y(of)39 b(the)f(decimal)h(p)s(oin)m(t.)65 b(The)38 b(returned)f(data)i
(t)m(yp)s(e)f(co)s(des)g(are)h(the)g(same)f(as)h(for)f(the)g(binary)g
(table,)227 3772 y(with)26 b(the)h(follo)m(wing)h(additional)f(rules:)
38 b(in)m(teger)28 b(columns)e(that)h(are)f(b)s(et)m(w)m(een)h(1)g(and)
f(4)g(c)m(haracters)i(wide)227 3885 y(are)i(de\014ned)e(to)j(b)s(e)d
(short)i(in)m(tegers)g(\(co)s(de)g(=)g(TSHOR)-8 b(T\).)29
b(Wider)g(in)m(teger)i(columns)e(are)h(de\014ned)e(to)j(b)s(e)227
3998 y(regular)39 b(in)m(tegers)g(\(co)s(de)g(=)f(TLONG\).)h(Similarly)
-8 b(,)41 b(Fixed)e(decimal)g(p)s(oin)m(t)f(columns)g(\(with)h(TF)m
(ORM)227 4111 y(=)c('Fw.d'\))g(are)h(de\014ned)d(to)j(b)s(e)e(single)i
(precision)f(reals)h(\(co)s(de)f(=)g(TFLO)m(A)-8 b(T\))35
b(if)g(w)g(is)g(b)s(et)m(w)m(een)g(1)h(and)227 4224 y(7)42
b(c)m(haracters)h(wide,)h(inclusiv)m(e.)75 b(Wider)41
b('F')h(columns)f(will)h(return)e(a)i(double)f(precision)h(data)g(co)s
(de)227 4337 y(\(=)32 b(TDOUBLE\).)h('Ew.d')f(format)g(columns)g(will)g
(ha)m(v)m(e)i(dataco)s(de)f(=)e(TFLO)m(A)-8 b(T,)33 b(and)e('Dw.d')i
(format)227 4450 y(columns)45 b(will)h(ha)m(v)m(e)h(dataco)s(de)f(=)f
(TDOUBLE.)g(A)h(n)m(ull)f(p)s(oin)m(ter)h(ma)m(y)f(b)s(e)g(giv)m(en)i
(for)e(an)m(y)g(output)227 4563 y(parameters)31 b(that)g(are)g(not)f
(needed.)95 4845 y Fe(int)47 b(fits_ascii_tform)d(/)j(ffasfm)286
4958 y(\(char)g(*tform,)f(>)h(int)g(*typecode,)e(long)i(*width,)e(int)i
(*decimals,)334 5070 y(int)g(*status\))0 5352 y Fi(17)f
Fj(Calculate)32 b(the)f(starting)g(column)g(p)s(ositions)f(and)g(total)
i(ASCI)s(I)d(table)j(width)d(based)i(on)f(the)h(input)e(arra)m(y)227
5465 y(of)e(ASCI)s(I)e(table)i(TF)m(ORM)g(v)-5 b(alues.)40
b(The)26 b(SP)-8 b(A)m(CE)27 b(input)e(parameter)i(de\014nes)f(ho)m(w)h
(man)m(y)f(blank)h(spaces)227 5578 y(to)40 b(lea)m(v)m(e)i(b)s(et)m(w)m
(een)e(eac)m(h)g(column)g(\(it)g(is)f(recommended)g(to)h(ha)m(v)m(e)h
(one)e(space)h(b)s(et)m(w)m(een)g(columns)f(for)227 5691
y(b)s(etter)31 b(h)m(uman)e(readabilit)m(y\).)p eop end
%%Page: 67 75
TeXDict begin 67 74 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(67)95 555 y Fe(int)47 b(fits_get_tbcol)d(/)k
(ffgabc)286 668 y(\(int)f(tfields,)f(char)g(**tform,)g(int)h(space,)f
(>)h(long)g(*rowlen,)334 781 y(long)g(*tbcol,)f(int)g(*status\))0
1017 y Fi(18)g Fj(P)m(arse)27 b(a)g(template)h(header)e(record)g(and)g
(return)g(a)g(formatted)h(80-c)m(haracter)j(string)c(suitable)h(for)f
(app)s(end-)227 1129 y(ing)40 b(to)f(\(or)h(deleting)g(from\))f(a)g
(FITS)g(header)g(\014le.)67 b(This)38 b(routine)h(is)g(useful)g(for)f
(parsing)h(lines)g(from)227 1242 y(an)33 b(ASCI)s(I)f(template)i
(\014le)f(and)g(reformatting)h(them)f(in)m(to)h(legal)h(FITS)d(header)h
(records.)49 b(The)32 b(format-)227 1355 y(ted)i(string)g(ma)m(y)g
(then)f(b)s(e)g(passed)h(to)g(the)g(\014ts)p 1880 1355
28 4 v 32 w(write)p 2114 1355 V 33 w(record,)h(\013mcrd,)f(or)g(\014ts)
p 3007 1355 V 32 w(delete)p 3270 1355 V 34 w(k)m(ey)h(routines)e(to)227
1468 y(app)s(end)c(or)h(mo)s(dify)g(a)h(FITS)e(header)h(record.)95
1704 y Fe(int)47 b(fits_parse_template)c(/)k(ffgthd)286
1817 y(\(char)g(*templt,)e(>)j(char)e(*card,)g(int)h(*keytype,)f(int)h
(*status\))0 2052 y Fj(The)31 b(input)g(templt)h(c)m(haracter)h(string)
f(generally)h(should)d(con)m(tain)j(3)f(tok)m(ens:)44
b(\(1\))33 b(the)f(KEYNAME,)g(\(2\))h(the)0 2165 y(V)-10
b(ALUE,)37 b(and)f(\(3\))i(the)f(COMMENT)g(string.)59
b(The)37 b(TEMPLA)-8 b(TE)36 b(string)h(m)m(ust)f(adhere)h(to)h(the)e
(follo)m(wing)0 2278 y(format:)0 2514 y Fi(-)80 b Fj(The)32
b(KEYNAME)h(tok)m(en)h(m)m(ust)f(b)s(egin)f(in)h(columns)f(1-8)i(and)e
(b)s(e)g(a)h(maxim)m(um)g(of)g(8)g(c)m(haracters)h(long.)49
b(A)227 2626 y(legal)30 b(FITS)e(k)m(eyw)m(ord)h(name)f(ma)m(y)h(only)f
(con)m(tain)i(the)f(c)m(haracters)g(A-Z,)g(0-9,)h(and)e('-')h(\(min)m
(us)f(sign\))h(and)227 2739 y(underscore.)40 b(This)27
b(routine)i(will)g(automatically)i(con)m(v)m(ert)f(an)m(y)f(lo)m(w)m
(ercase)i(c)m(haracters)f(to)g(upp)s(ercase)d(in)227
2852 y(the)k(output)f(string.)42 b(If)30 b(the)h(\014rst)f(8)h(c)m
(haracters)h(of)f(the)g(template)h(line)f(are)g(blank)f(then)h(the)g
(remainder)227 2965 y(of)g(the)f(line)h(is)g(considered)f(to)h(b)s(e)f
(a)g(FITS)g(commen)m(t)h(\(with)g(a)g(blank)f(k)m(eyw)m(ord)g(name\).)0
3201 y Fi(-)80 b Fj(The)26 b(V)-10 b(ALUE)26 b(tok)m(en)h(m)m(ust)e(b)s
(e)h(separated)g(from)f(the)i(KEYNAME)f(tok)m(en)h(b)m(y)f(one)g(or)g
(more)g(spaces)g(and/or)227 3314 y(an)g('=')g(c)m(haracter.)41
b(The)25 b(data)h(t)m(yp)s(e)g(of)g(the)g(V)-10 b(ALUE)26
b(tok)m(en)g(\(n)m(umeric,)h(logical,)j(or)c(c)m(haracter)h(string\))f
(is)227 3427 y(automatically)35 b(determined)c(and)h(the)g(output)f
(CARD)h(string)g(is)g(formatted)g(accordingly)-8 b(.)47
b(The)31 b(v)-5 b(alue)227 3539 y(tok)m(en)34 b(ma)m(y)f(b)s(e)f
(forced)g(to)i(b)s(e)e(in)m(terpreted)g(as)h(a)g(string)g(\(e.g.)48
b(if)33 b(it)g(is)f(a)h(string)g(of)f(n)m(umeric)h(digits\))g(b)m(y)227
3652 y(enclosing)g(it)f(in)f(single)h(quotes.)45 b(If)31
b(the)h(v)-5 b(alue)32 b(tok)m(en)g(is)g(a)g(c)m(haracter)h(string)e
(that)i(con)m(tains)f(1)g(or)g(more)227 3765 y(em)m(b)s(edded)39
b(blank)g(space)h(c)m(haracters)h(or)e(slash)h(\('/'\))h(c)m(haracters)
g(then)e(the)g(en)m(tire)i(c)m(haracter)g(string)227
3878 y(m)m(ust)31 b(b)s(e)e(enclosed)i(in)f(single)h(quotes.)0
4114 y Fi(-)80 b Fj(The)28 b(COMMENT)g(tok)m(en)h(is)f(optional,)i(but)
e(if)g(presen)m(t)g(m)m(ust)g(b)s(e)g(separated)g(from)g(the)h(V)-10
b(ALUE)28 b(tok)m(en)h(b)m(y)227 4227 y(a)i(blank)f(space)h(or)f(a)h
('/')g(c)m(haracter.)0 4462 y Fi(-)80 b Fj(One)29 b(exception)h(to)f
(the)g(ab)s(o)m(v)m(e)i(rules)d(is)h(that)g(if)g(the)g(\014rst)g
(non-blank)f(c)m(haracter)i(in)f(the)g(\014rst)f(8)h(c)m(haracters)227
4575 y(of)24 b(the)h(template)g(string)f(is)g(a)g(min)m(us)g(sign)g
(\('-'\))h(follo)m(w)m(ed)h(b)m(y)e(a)g(single)h(tok)m(en,)h(or)e(a)h
(single)f(tok)m(en)h(follo)m(w)m(ed)227 4688 y(b)m(y)k(an)g(equal)h
(sign,)g(then)f(it)g(is)h(in)m(terpreted)f(as)h(the)f(name)g(of)h(a)f
(k)m(eyw)m(ord)h(whic)m(h)f(is)g(to)h(b)s(e)e(deleted)i(from)227
4801 y(the)h(FITS)e(header.)0 5036 y Fi(-)80 b Fj(The)32
b(second)g(exception)h(is)f(that)h(if)f(the)g(template)h(string)f
(starts)h(with)e(a)i(min)m(us)e(sign)h(and)f(is)h(follo)m(w)m(ed)i(b)m
(y)227 5149 y(2)f(tok)m(ens)g(\(without)g(an)f(equals)h(sign)g(b)s(et)m
(w)m(een)g(them\))f(then)g(the)h(second)f(tok)m(en)i(is)e(in)m
(terpreted)h(as)g(the)227 5262 y(new)f(name)h(for)f(the)h(k)m(eyw)m
(ord)g(sp)s(eci\014ed)f(b)m(y)h(\014rst)f(tok)m(en.)48
b(In)32 b(this)g(case)i(the)f(old)g(k)m(eyw)m(ord)g(name)f(\(\014rst)
227 5375 y(tok)m(en\))c(is)e(returned)e(in)i(c)m(haracters)h(1-8)g(of)g
(the)f(returned)e(CARD)j(string,)g(and)e(the)h(new)f(k)m(eyw)m(ord)i
(name)227 5488 y(\(the)35 b(second)e(tok)m(en\))j(is)e(returned)e(in)i
(c)m(haracters)h(41-48)h(of)e(the)g(returned)e(CARD)i(string.)51
b(These)34 b(old)227 5601 y(and)i(new)f(names)h(ma)m(y)h(then)f(b)s(e)f
(passed)g(to)i(the)f(\013mnam)g(routine)g(whic)m(h)g(will)g(c)m(hange)h
(the)f(k)m(eyw)m(ord)227 5714 y(name.)p eop end
%%Page: 68 76
TeXDict begin 68 75 bop 0 299 a Fj(68)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fj(The)g(k)m(eyt)m(yp)s(e)h(output)f(parameter)h
(indicates)g(ho)m(w)g(the)f(returned)g(CARD)g(string)g(should)g(b)s(e)f
(in)m(terpreted:)382 784 y Fe(keytype)857 b(interpretation)382
897 y(-------)475 b(-------------------------)o(----)o(---)o(----)o
(----)o(---)o(----)o(--)525 1010 y(-2)572 b(Rename)46
b(the)h(keyword)f(with)h(name)f(=)i(the)f(first)f(8)h(characters)e(of)j
(CARD)1193 1123 y(to)f(the)g(new)g(name)g(given)f(in)h(characters)e(41)
j(-)f(48)g(of)g(CARD.)525 1349 y(-1)572 b(delete)46 b(the)h(keyword)f
(with)h(this)f(name)h(from)g(the)f(FITS)h(header.)573
1575 y(0)572 b(append)46 b(the)h(CARD)g(string)f(to)h(the)g(FITS)g
(header)f(if)h(the)1193 1688 y(keyword)f(does)h(not)g(already)e(exist,)
h(otherwise)g(update)1193 1801 y(the)h(keyword)f(value)g(and/or)g
(comment)g(field)h(if)g(is)g(already)f(exists.)573 2026
y(1)572 b(This)47 b(is)g(a)g(HISTORY)f(or)h(COMMENT)f(keyword;)g
(append)g(it)h(to)g(the)g(header)573 2252 y(2)572 b(END)47
b(record;)f(do)h(not)g(explicitly)e(write)h(it)i(to)f(the)g(FITS)f
(file.)0 2481 y Fj(EXAMPLES:)30 b(The)g(follo)m(wing)i(lines)e
(illustrate)i(v)-5 b(alid)31 b(input)e(template)j(strings:)286
2710 y Fe(INTVAL)46 b(7)i(/)f(This)g(is)g(an)g(integer)f(keyword)286
2823 y(RVAL)524 b(34.6)142 b(/)239 b(This)46 b(is)i(a)f(floating)f
(point)g(keyword)286 2936 y(EVAL=-12.45E-03)92 b(/)47
b(This)g(is)g(a)g(floating)f(point)g(keyword)g(in)h(exponential)e
(notation)286 3049 y(lval)i(F)g(/)h(This)f(is)g(a)g(boolean)f(keyword)
859 3162 y(This)h(is)g(a)g(comment)f(keyword)g(with)h(a)g(blank)f
(keyword)g(name)286 3275 y(SVAL1)h(=)g('Hello)f(world')142
b(/)95 b(this)47 b(is)g(a)g(string)f(keyword)286 3388
y(SVAL2)94 b('123.5')g(this)47 b(is)g(also)f(a)i(string)e(keyword)286
3501 y(sval3)94 b(123+)h(/)g(this)47 b(is)g(also)f(a)i(string)e
(keyword)g(with)g(the)h(value)g('123+)189 b(')286 3614
y(#)48 b(the)f(following)e(template)h(line)g(deletes)g(the)h(DATE)g
(keyword)286 3727 y(-)h(DATE)286 3840 y(#)g(the)f(following)e(template)
h(line)g(modifies)g(the)h(NAME)f(keyword)g(to)h(OBJECT)286
3952 y(-)h(NAME)e(OBJECT)0 4182 y Fi(19)g Fj(T)-8 b(ranslate)32
b(a)g(k)m(eyw)m(ord)g(name)f(in)m(to)h(a)g(new)f(name,)h(based)f(on)g
(a)h(set)f(of)h(patterns.)43 b(This)31 b(routine)g(is)h(useful)227
4294 y(for)j(translating)h(k)m(eyw)m(ords)g(in)e(cases)i(suc)m(h)f(as)h
(adding)e(or)h(deleting)h(columns)f(in)g(a)g(table,)j(or)d(cop)m(ying)
227 4407 y(a)41 b(column)g(from)f(one)h(table)g(to)g(another,)j(or)c
(extracting)j(an)d(arra)m(y)h(from)f(a)h(cell)h(in)e(a)h(binary)f
(table)227 4520 y(column)31 b(in)m(to)g(an)g(image)g(extension.)42
b(In)30 b(these)h(cases,)h(it)f(is)g(necessary)g(to)g(translate)h(the)f
(names)f(of)h(the)227 4633 y(k)m(eyw)m(ords)f(asso)s(ciated)i(with)d
(the)h(original)h(table)g(column\(s\))f(in)m(to)g(the)g(appropriate)g
(k)m(eyw)m(ord)g(name)g(in)227 4746 y(the)37 b(\014nal)f(\014le.)58
b(F)-8 b(or)37 b(example,)i(if)d(column)h(2)f(is)h(deleted)g(from)e(a)i
(table,)i(then)d(the)h(v)-5 b(alue)36 b(of)h('n')f(in)g(all)227
4859 y(the)c(TF)m(ORMn)g(and)f(TTYPEn)f(k)m(eyw)m(ords)i(for)g(columns)
f(3)h(and)f(higher)h(m)m(ust)f(b)s(e)g(decremen)m(ted)i(b)m(y)e(1.)227
4972 y(Ev)m(en)j(more)g(complex)h(translations)f(are)h(sometimes)f
(needed)g(to)h(con)m(v)m(ert)g(the)f(W)m(CS)g(k)m(eyw)m(ords)g(when)227
5085 y(extracting)e(an)f(image)g(out)g(of)f(a)h(table)g(column)g(cell)g
(in)m(to)h(a)e(separate)i(image)f(extension.)227 5230
y(The)g(user)f(passes)i(an)f(arra)m(y)g(of)h(patterns)f(to)h(b)s(e)e
(matc)m(hed.)44 b(Input)30 b(pattern)h(n)m(um)m(b)s(er)f(i)i(is)f
(pattern[i][0],)227 5343 y(and)j(output)f(pattern)h(n)m(um)m(b)s(er)f
(i)h(is)g(pattern[i][1].)53 b(Keyw)m(ords)34 b(are)g(matc)m(hed)h
(against)g(the)f(input)f(pat-)227 5456 y(terns.)41 b(If)30
b(a)g(matc)m(h)i(is)e(found)f(then)h(the)h(k)m(eyw)m(ord)g(is)f
(re-written)h(according)g(to)g(the)g(output)f(pattern.)227
5601 y(Order)41 b(is)h(imp)s(ortan)m(t.)76 b(The)41 b(\014rst)h(matc)m
(h)h(is)f(accepted.)77 b(The)41 b(fastest)i(matc)m(h)g(will)f(b)s(e)g
(made)g(when)227 5714 y(templates)32 b(with)e(the)h(same)f(\014rst)g(c)
m(haracter)i(are)f(group)s(ed)e(together.)p eop end
%%Page: 69 77
TeXDict begin 69 76 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(69)227 555 y(Sev)m(eral)32 b(c)m(haracters)f
(ha)m(v)m(e)h(sp)s(ecial)f(meanings:)466 772 y Fe(i,j)47
b(-)g(single)f(digits,)g(preserved)f(in)j(output)e(template)466
885 y(n)h(-)h(column)e(number)g(of)h(one)g(or)g(more)g(digits,)f
(preserved)f(in)i(output)f(template)466 998 y(m)h(-)h(generic)e(number)
g(of)h(one)g(or)g(more)g(digits,)e(preserved)h(in)h(output)f(template)
466 1111 y(a)h(-)h(coordinate)d(designator,)g(preserved)g(in)i(output)f
(template)466 1224 y(#)h(-)h(number)e(of)h(one)g(or)g(more)g(digits)466
1337 y(?)g(-)h(any)f(character)466 1450 y(*)g(-)h(only)e(allowed)g(in)h
(first)g(character)e(position,)g(to)j(match)e(all)657
1563 y(keywords;)f(only)i(useful)f(as)h(last)g(pattern)e(in)j(the)f
(list)227 1780 y Fj(i,)31 b(j,)f(n,)g(and)g(m)g(are)h(returned)e(b)m(y)
i(the)f(routine.)227 1926 y(F)-8 b(or)27 b(example,)g(the)f(input)f
(pattern)h("iCTYPn")g(will)g(matc)m(h)h("1CTYP5")g(\(if)f(n)p
3003 1926 28 4 v 32 w(v)-5 b(alue)26 b(is)g(5\);)i(the)e(output)227
2038 y(pattern)31 b("CTYPEi")f(will)h(b)s(e)f(re-written)h(as)f
("CTYPE1".)42 b(Notice)32 b(that)f("i")g(is)g(preserv)m(ed.)227
2184 y(The)f(follo)m(wing)i(output)e(patterns)g(are)h(sp)s(ecial:)227
2330 y("-")h(-)e(do)h(not)f(cop)m(y)h(a)g(k)m(eyw)m(ord)g(that)g(matc)m
(hes)g(the)g(corresp)s(onding)e(input)h(pattern)227 2475
y("+")h(-)g(cop)m(y)g(the)f(input)g(unc)m(hanged)227
2621 y(The)f(inrec)h(string)g(could)g(b)s(e)f(just)g(the)h(8-c)m(har)h
(k)m(eyw)m(ord)f(name,)g(or)f(the)h(en)m(tire)h(80-c)m(har)g(header)f
(record.)227 2734 y(Characters)h(9)g(-)f(80)h(in)g(the)f(input)g
(string)g(simply)g(get)h(app)s(ended)e(to)i(the)g(translated)g(k)m(eyw)
m(ord)f(name.)227 2879 y(If)h(n)p 375 2879 V 33 w(range)g(=)g(0,)i
(then)e(only)h(k)m(eyw)m(ords)f(with)h('n')f(equal)h(to)g(n)p
2410 2879 V 32 w(v)-5 b(alue)32 b(will)g(b)s(e)f(considered)g(as)h(a)g
(pattern)227 2992 y(matc)m(h.)70 b(If)39 b(n)p 722 2992
V 32 w(range)h(=)f(+1,)j(then)e(all)g(v)-5 b(alues)40
b(of)g('n')f(greater)i(than)e(or)h(equal)g(to)g(n)p 3269
2992 V 33 w(v)-5 b(alue)40 b(will)g(b)s(e)f(a)227 3105
y(matc)m(h,)32 b(and)e(if)g(-1,)h(then)f(v)-5 b(alues)31
b(of)g('n')f(less)g(than)h(or)f(equal)h(to)g(n)p 2530
3105 V 32 w(v)-5 b(alue)31 b(will)g(matc)m(h.)0 3337
y Fe(int)47 b(fits_translate_keyword\()286 3450 y(char)g(*inrec,)380
b(/*)47 b(I)h(-)f(input)f(string)g(*/)286 3563 y(char)h(*outrec,)332
b(/*)47 b(O)h(-)f(output)f(converted)f(string,)h(or)h(*/)1241
3676 y(/*)238 b(a)47 b(null)g(string)f(if)h(input)g(does)f(not)95
b(*/)1241 3788 y(/*)238 b(match)46 b(any)h(of)g(the)g(patterns)f(*/)286
3901 y(char)h(*patterns[][2],/*)c(I)48 b(-)f(pointer)f(to)h(input)f(/)i
(output)e(string)g(*/)1241 4014 y(/*)238 b(templates)45
b(*/)286 4127 y(int)i(npat,)524 b(/*)47 b(I)h(-)f(number)f(of)h
(templates)f(passed)g(*/)286 4240 y(int)h(n_value,)380
b(/*)47 b(I)h(-)f(base)g('n')g(template)e(value)h(of)i(interest)d(*/)
286 4353 y(int)i(n_offset,)332 b(/*)47 b(I)h(-)f(offset)f(to)h(be)g
(applied)f(to)h(the)g('n')g(*/)1241 4466 y(/*)238 b(value)46
b(in)i(the)e(output)h(string)f(*/)286 4579 y(int)h(n_range,)380
b(/*)47 b(I)h(-)f(controls)f(range)g(of)h('n')g(template)f(*/)1241
4692 y(/*)238 b(values)46 b(of)h(interest)f(\(-1,0,)g(or)h(+1\))g(*/)
286 4805 y(int)g(*pat_num,)332 b(/*)47 b(O)h(-)f(matched)f(pattern)g
(number)g(\(0)h(based\))f(or)h(-1)g(*/)286 4918 y(int)g(*i,)620
b(/*)47 b(O)h(-)f(value)f(of)i(i,)f(if)g(any,)g(else)f(0)i(*/)286
5031 y(int)f(*j,)620 b(/*)47 b(O)h(-)f(value)f(of)i(j,)f(if)g(any,)g
(else)f(0)i(*/)286 5143 y(int)f(*m,)620 b(/*)47 b(O)h(-)f(value)f(of)i
(m,)f(if)g(any,)g(else)f(0)i(*/)286 5256 y(int)f(*n,)620
b(/*)47 b(O)h(-)f(value)f(of)i(n,)f(if)g(any,)g(else)f(0)i(*/)286
5369 y(int)f(*status\))380 b(/*)47 b(IO)g(-)h(error)e(status)g(*/)80
5601 y Fj(Here)25 b(is)f(an)g(example)g(of)g(some)h(of)f(the)g
(patterns)g(used)f(to)i(con)m(v)m(ert)g(the)f(k)m(eyw)m(ords)h(asso)s
(ciated)g(with)f(an)g(image)227 5714 y(in)30 b(a)h(cell)h(of)e(a)h
(table)g(column)f(in)m(to)i(the)e(k)m(eyw)m(ords)h(appropriate)f(for)h
(an)f(IMA)m(GE)h(extension:)p eop end
%%Page: 70 78
TeXDict begin 70 77 bop 0 299 a Fj(70)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)191 555 y Fe(char)47 b(*patterns[][2])c(=)48
b({{"TSCALn",)92 b("BSCALE")i(},)h(/*)47 b(Standard)e(FITS)i(keywords)e
(*/)143 668 y({"TZEROn",)93 b("BZERO")141 b(},)143 781
y({"TUNITn",)93 b("BUNIT")141 b(},)143 894 y({"TNULLn",)93
b("BLANK")141 b(},)143 1007 y({"TDMINn",)93 b("DATAMIN")45
b(},)143 1120 y({"TDMAXn",)93 b("DATAMAX")45 b(},)143
1233 y({"iCTYPn",)93 b("CTYPEi")g(},)i(/*)47 b(Coordinate)e(labels)h
(*/)143 1346 y({"iCTYna",)93 b("CTYPEia")45 b(},)143
1458 y({"iCUNIn",)93 b("CUNITi")g(},)i(/*)47 b(Coordinate)e(units)i(*/)
143 1571 y({"iCUNna",)93 b("CUNITia")45 b(},)143 1684
y({"iCRVLn",)93 b("CRVALi")g(},)i(/*)47 b(WCS)g(keywords)f(*/)143
1797 y({"iCRVna",)93 b("CRVALia")45 b(},)143 1910 y({"iCDLTn",)93
b("CDELTi")g(},)143 2023 y({"iCDEna",)g("CDELTia")45
b(},)143 2136 y({"iCRPXn",)93 b("CRPIXi")g(},)143 2249
y({"iCRPna",)g("CRPIXia")45 b(},)143 2362 y({"ijPCna",)93
b("PCi_ja")g(},)143 2475 y({"ijCDna",)g("CDi_ja")g(},)143
2588 y({"iVn_ma",)g("PVi_ma")g(},)143 2700 y({"iSn_ma",)g("PSi_ma")g
(},)143 2813 y({"iCRDna",)g("CRDERia")45 b(},)143 2926
y({"iCSYna",)93 b("CSYERia")45 b(},)143 3039 y({"iCROTn",)93
b("CROTAi")g(},)143 3152 y({"WCAXna",)g("WCSAXESa"},)143
3265 y({"WCSNna",)g("WCSNAMEa"}};)0 3517 y Fi(20)46 b
Fj(T)-8 b(ranslate)26 b(the)f(k)m(eyw)m(ords)g(in)g(the)g(input)e(HDU)j
(in)m(to)g(the)f(k)m(eyw)m(ords)g(that)h(are)f(appropriate)g(for)f(the)
h(output)227 3630 y(HDU.)32 b(This)d(is)i(a)f(driv)m(er)h(routine)f
(that)h(calls)g(the)g(previously)f(describ)s(ed)f(routine.)0
3881 y Fe(int)47 b(fits_translate_keywords\()143 3994
y(fitsfile)f(*infptr,)141 b(/*)47 b(I)g(-)h(pointer)e(to)h(input)f(HDU)
h(*/)143 4107 y(fitsfile)f(*outfptr,)93 b(/*)47 b(I)g(-)h(pointer)e(to)
h(output)f(HDU)h(*/)143 4220 y(int)g(firstkey,)332 b(/*)47
b(I)g(-)h(first)e(HDU)h(record)f(number)g(to)h(start)g(with)f(*/)143
4333 y(char)h(*patterns[][2],/*)c(I)k(-)h(pointer)e(to)h(input)f(/)i
(output)e(keyword)g(templates)f(*/)143 4446 y(int)i(npat,)524
b(/*)47 b(I)g(-)h(number)e(of)h(templates)e(passed)h(*/)143
4559 y(int)h(n_value,)380 b(/*)47 b(I)g(-)h(base)e('n')h(template)f
(value)g(of)h(interest)f(*/)143 4672 y(int)h(n_offset,)332
b(/*)47 b(I)g(-)h(offset)e(to)h(be)g(applied)f(to)h(the)g('n')g(*/)1193
4785 y(/*)238 b(value)47 b(in)g(the)g(output)f(string)g(*/)143
4898 y(int)h(n_range,)380 b(/*)47 b(I)g(-)h(controls)d(range)i(of)g
('n')g(template)e(*/)1098 5011 y(/*)238 b(values)46 b(of)h(interest)f
(\(-1,0,)g(or)h(+1\))g(*/)143 5123 y(int)g(*status\))380
b(/*)47 b(IO)g(-)h(error)e(status)g(*/)0 5375 y Fi(21)g
Fj(P)m(arse)35 b(the)g(input)f(string)h(con)m(taining)h(a)f(list)h(of)f
(ro)m(ws)f(or)h(ro)m(w)g(ranges,)h(and)e(return)g(in)m(teger)i(arra)m
(ys)f(con-)227 5488 y(taining)27 b(the)f(\014rst)f(and)g(last)i(ro)m(w)
f(in)f(eac)m(h)i(range.)40 b(F)-8 b(or)26 b(example,)i(if)d(ro)m(wlist)
i(=)e("3-5,)k(6,)e(8-9")h(then)d(it)i(will)227 5601 y(return)34
b(n)m(umranges)h(=)g(3,)h(rangemin)f(=)g(3,)i(6,)g(8)e(and)g(rangemax)g
(=)g(5,)i(6,)g(9.)55 b(A)m(t)36 b(most,)h('maxranges')227
5714 y(n)m(um)m(b)s(er)31 b(of)h(ranges)f(will)h(b)s(e)g(returned.)43
b('maxro)m(ws')32 b(is)g(the)g(maxim)m(um)g(n)m(um)m(b)s(er)e(of)i(ro)m
(ws)g(in)f(the)h(table;)p eop end
%%Page: 71 79
TeXDict begin 71 78 bop 0 299 a Fh(5.8.)72 b(UTILITY)30
b(R)m(OUTINES)2693 b Fj(71)227 555 y(an)m(y)30 b(ro)m(ws)f(or)g(ranges)
g(larger)h(than)f(this)g(will)g(b)s(e)g(ignored.)40 b(The)29
b(ro)m(ws)g(m)m(ust)g(b)s(e)f(sp)s(eci\014ed)h(in)f(increasing)227
668 y(order,)33 b(and)f(the)g(ranges)h(m)m(ust)f(not)g(o)m(v)m(erlap.)
48 b(A)33 b(min)m(us)e(sign)i(ma)m(y)g(b)s(e)e(use)h(to)h(sp)s(ecify)f
(all)h(the)g(ro)m(ws)f(to)227 781 y(the)h(upp)s(er)d(or)j(lo)m(w)m(er)h
(b)s(ound,)d(so)i("50-")h(means)e(all)i(the)f(ro)m(ws)f(from)g(50)h(to)
h(the)e(end)g(of)h(the)f(table,)j(and)227 894 y("-")d(means)e(all)h
(the)g(ro)m(ws)f(in)g(the)h(table,)g(from)f(1)h(-)g(maxro)m(ws.)191
1143 y Fe(int)47 b(fits_parse_range)c(/)48 b(ffrwrg\(char)c(*rowlist,)i
(LONGLONG)f(maxrows,)h(int)h(maxranges,)e(>)334 1256
y(int)i(*numranges,)e(long)h(*rangemin,)f(long)i(*rangemax,)e(int)i
(*status\))191 1481 y(int)g(fits_parse_rangell)c(/)k(ffrwrgll\(char)d
(*rowlist,)i(LONGLONG)f(maxrows,)h(int)h(maxranges,)e(>)334
1594 y(int)i(*numranges,)e(LONGLONG)g(*rangemin,)g(LONGLONG)h
(*rangemax,)f(int)i(*status\))0 1843 y Fi(22)f Fj(Chec)m(k)37
b(that)g(the)g(Header)g(\014ll)g(b)m(ytes)g(\(if)g(an)m(y\))g(are)g
(all)h(blank.)59 b(These)36 b(are)h(the)g(b)m(ytes)g(that)g(ma)m(y)h
(follo)m(w)227 1956 y(END)e(k)m(eyw)m(ord)g(and)f(b)s(efore)g(the)h(b)s
(eginning)f(of)h(data)g(unit,)g(or)g(the)g(end)f(of)g(the)h(HDU)g(if)g
(there)f(is)h(no)227 2069 y(data)31 b(unit.)191 2318
y Fe(int)47 b(ffchfl\(fitsfile)c(*fptr,)k(>)g(int)g(*status\))0
2566 y Fi(23)f Fj(Chec)m(k)30 b(that)g(the)f(Data)i(\014ll)e(b)m(ytes)h
(\(if)g(an)m(y\))g(are)g(all)g(zero)g(\(for)f(IMA)m(GE)i(or)e(BINAR)-8
b(Y)30 b(T)-8 b(able)30 b(HDU\))h(or)e(all)227 2679 y(blanks)g(\(for)g
(ASCI)s(I)f(table)i(HDU\).)g(These)f(\014le)g(b)m(ytes)h(ma)m(y)f(b)s
(e)g(lo)s(cated)h(after)g(the)f(last)h(v)-5 b(alid)29
b(data)h(b)m(yte)227 2792 y(in)g(the)h(HDU)g(and)f(b)s(efore)g(the)g
(ph)m(ysical)h(end)f(of)h(the)f(HDU.)191 3041 y Fe(int)47
b(ffcdfl\(fitsfile)c(*fptr,)k(>)g(int)g(*status\))0 3290
y Fi(24)f Fj(Estimate)35 b(the)e(ro)s(ot-mean-squared)h(\(RMS\))f
(noise)h(in)f(an)g(image.)51 b(These)33 b(routines)g(are)h(mainly)f
(for)g(use)227 3403 y(with)25 b(the)g(Hcompress)g(image)i(compression)e
(algorithm.)40 b(They)24 b(return)g(an)h(estimate)i(of)e(the)h(RMS)f
(noise)227 3515 y(in)38 b(the)f(bac)m(kground)h(pixels)f(of)h(the)g
(image.)64 b(This)36 b(robust)h(algorithm)i(\(written)f(b)m(y)f(Ric)m
(hard)h(White,)227 3628 y(STScI\))e(\014rst)f(attempts)i(to)g(estimate)
h(the)f(RMS)e(v)-5 b(alue)37 b(as)g(1.68)g(times)g(the)f(median)g(of)h
(the)f(absolute)227 3741 y(di\013erences)26 b(b)s(et)m(w)m(een)h
(successiv)m(e)g(pixels)f(in)g(the)g(image.)41 b(If)25
b(the)h(median)g(=)f(0,)j(then)d(the)h(algorithm)h(falls)227
3854 y(bac)m(k)h(to)f(computing)g(the)g(RMS)f(of)h(the)g(di\013erence)g
(b)s(et)m(w)m(een)h(successiv)m(e)g(pixels,)f(after)h(sev)m(eral)g
(N-sigma)227 3967 y(rejection)e(cycles)g(to)g(remo)m(v)m(e)g(extreme)g
(v)-5 b(alues.)39 b(The)25 b(input)e(parameters)j(are:)38
b(the)25 b(arra)m(y)g(of)g(image)i(pixel)227 4080 y(v)-5
b(alues)30 b(\(either)h(\015oat)f(or)g(short)f(v)-5 b(alues\),)31
b(the)f(n)m(um)m(b)s(er)e(of)i(v)-5 b(alues)30 b(in)g(the)g(arra)m(y)-8
b(,)31 b(the)f(v)-5 b(alue)30 b(that)g(is)g(used)227
4193 y(to)h(represen)m(t)g(n)m(ull)f(pixels)h(\(en)m(ter)g(a)g(v)m(ery)
g(large)g(n)m(um)m(b)s(er)e(if)h(there)h(are)g(no)f(n)m(ull)g
(pixels\).)191 4442 y Fe(int)47 b(fits_rms_float)d(\(float)i(fdata[],)f
(int)i(npix,)g(float)f(in_null_value,)907 4555 y(>)h(double)f(*rms,)h
(int)g(*status\))191 4668 y(int)g(fits_rms_short)d(\(short)i(fdata[],)f
(int)i(npix,)g(short)f(in_null_value,)907 4780 y(>)h(double)f(*rms,)h
(int)g(*status\))0 5029 y Fi(25)f Fj(W)-8 b(as)33 b(CFITSIO)d(compiled)
h(with)h(the)f(-D)p 1612 5029 28 4 v 34 w(REENTRANT)g(directiv)m(e)i
(so)e(that)h(it)g(ma)m(y)h(b)s(e)d(safely)j(used)d(in)227
5142 y(m)m(ulti-threaded)d(en)m(vironmen)m(ts?)40 b(The)26
b(follo)m(wing)i(function)e(returns)f(1)i(if)f(y)m(es,)i(0)f(if)f(no.)
40 b(Note,)28 b(ho)m(w)m(ev)m(er,)227 5255 y(that)35
b(ev)m(en)g(if)g(the)f(-D)p 991 5255 V 34 w(REENTRANT)f(directiv)m(e)j
(w)m(as)f(sp)s(eci\014ed,)g(this)f(do)s(es)g(not)h(guaran)m(tee)h(that)
f(the)227 5368 y(CFITSIO)29 b(routines)h(are)h(thread-safe,)g(b)s
(ecause)g(some)f(compilers)h(ma)m(y)g(not)g(supp)s(ort)d(this)j
(feature.)0 5617 y Fe(int)47 b(fits_is_reentrant\(void\))p
eop end
%%Page: 72 80
TeXDict begin 72 79 bop 0 299 a Fj(72)1379 b Fh(CHAPTER)30
b(5.)71 b(BASIC)30 b(CFITSIO)f(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)p eop end
%%Page: 73 81
TeXDict begin 73 80 bop 0 1225 a Fg(Chapter)65 b(6)0
1687 y Fm(The)77 b(CFITSIO)f(Iterator)i(F)-19 b(unction)0
2180 y Fj(The)41 b(\014ts)p 325 2180 28 4 v 33 w(iterate)p
614 2180 V 34 w(data)i(function)e(in)h(CFITSIO)e(pro)m(vides)i(a)g
(unique)e(metho)s(d)i(of)g(executing)h(an)e(arbitrary)0
2293 y(user-supplied)35 b(`w)m(ork')i(function)f(that)h(op)s(erates)g
(on)g(ro)m(ws)f(of)h(data)g(in)f(FITS)g(tables)h(or)f(on)h(pixels)f(in)
h(FITS)0 2406 y(images.)i(Rather)24 b(than)e(explicitly)j(reading)e
(and)g(writing)g(the)g(FITS)g(images)h(or)f(columns)g(of)g(data,)i(one)
f(instead)0 2518 y(calls)36 b(the)g(CFITSIO)d(iterator)k(routine,)g
(passing)e(to)h(it)g(the)f(name)g(of)h(the)f(user's)g(w)m(ork)g
(function)g(that)h(is)f(to)0 2631 y(b)s(e)30 b(executed)h(along)g(with)
f(a)h(list)g(of)f(all)h(the)f(table)i(columns)e(or)g(image)h(arra)m(ys)
g(that)g(are)f(to)h(b)s(e)f(passed)g(to)h(the)0 2744
y(w)m(ork)37 b(function.)61 b(The)37 b(CFITSIO)e(iterator)k(function)e
(then)g(do)s(es)g(all)h(the)f(w)m(ork)g(of)h(allo)s(cating)h(memory)e
(for)0 2857 y(the)28 b(arra)m(ys,)h(reading)f(the)g(input)e(data)j
(from)e(the)h(FITS)f(\014le,)h(passing)g(them)g(to)g(the)g(w)m(ork)g
(function,)g(and)f(then)0 2970 y(writing)36 b(an)m(y)h(output)f(data)h
(bac)m(k)h(to)f(the)f(FITS)g(\014le)g(after)h(the)g(w)m(ork)g(function)
f(exits.)59 b(Because)38 b(it)f(is)g(often)0 3083 y(more)g(e\016cien)m
(t)i(to)f(pro)s(cess)f(only)g(a)h(subset)f(of)g(the)g(total)i(table)g
(ro)m(ws)e(at)h(one)f(time,)j(the)e(iterator)g(function)0
3196 y(can)31 b(determine)f(the)h(optim)m(um)f(amoun)m(t)h(of)f(data)h
(to)g(pass)f(in)g(eac)m(h)i(iteration)f(and)f(rep)s(eatedly)h(call)g
(the)g(w)m(ork)0 3309 y(function)f(un)m(til)h(the)f(en)m(tire)i(table)f
(b)s(een)e(pro)s(cessed.)0 3469 y(F)-8 b(or)37 b(man)m(y)f
(applications)h(this)e(single)i(CFITSIO)d(iterator)k(function)d(can)h
(e\013ectiv)m(ely)j(replace)e(all)g(the)f(other)0 3582
y(CFITSIO)g(routines)i(for)f(reading)h(or)f(writing)h(data)g(in)f(FITS)
g(images)i(or)e(tables.)64 b(Using)37 b(the)h(iterator)h(has)0
3695 y(sev)m(eral)32 b(imp)s(ortan)m(t)e(adv)-5 b(an)m(tages)32
b(o)m(v)m(er)g(the)f(traditional)g(metho)s(d)f(of)h(reading)f(and)g
(writing)g(FITS)g(data)h(\014les:)136 3961 y Fc(\017)46
b Fj(It)33 b(cleanly)h(separates)g(the)f(data)h(I/O)f(from)f(the)h
(routine)g(that)h(op)s(erates)f(on)g(the)g(data.)49 b(This)32
b(leads)h(to)227 4074 y(a)e(more)g(mo)s(dular)e(and)h(`ob)5
b(ject)31 b(orien)m(ted')h(programming)e(st)m(yle.)136
4268 y Fc(\017)46 b Fj(It)27 b(simpli\014es)f(the)h(application)h
(program)f(b)m(y)f(eliminating)i(the)f(need)g(to)g(allo)s(cate)i
(memory)e(for)f(the)h(data)227 4381 y(arra)m(ys)e(and)f(eliminates)i
(most)e(of)h(the)f(calls)i(to)f(the)g(CFITSIO)d(routines)j(that)g
(explicitly)h(read)e(and)g(write)227 4494 y(the)31 b(data.)136
4689 y Fc(\017)46 b Fj(It)32 b(ensures)e(that)i(the)g(data)g(are)g(pro)
s(cessed)f(as)h(e\016cien)m(tly)h(as)e(p)s(ossible.)44
b(This)31 b(is)g(esp)s(ecially)i(imp)s(ortan)m(t)227
4801 y(when)44 b(pro)s(cessing)g(tabular)h(data)h(since)f(the)g
(iterator)h(function)e(will)h(calculate)i(the)e(most)g(e\016cien)m(t)
227 4914 y(n)m(um)m(b)s(er)36 b(of)i(ro)m(ws)g(in)f(the)h(table)g(to)g
(b)s(e)f(passed)g(at)i(one)e(time)i(to)f(the)g(user's)e(w)m(ork)i
(function)f(on)h(eac)m(h)227 5027 y(iteration.)136 5222
y Fc(\017)46 b Fj(Mak)m(es)39 b(it)e(p)s(ossible)g(for)g(larger)h(pro)5
b(jects)37 b(to)h(dev)m(elop)g(a)g(library)e(of)i(w)m(ork)f(functions)f
(that)i(all)g(ha)m(v)m(e)h(a)227 5335 y(uniform)29 b(calling)j
(sequence)f(and)f(are)h(all)g(indep)s(enden)m(t)e(of)i(the)f(details)i
(of)e(the)h(FITS)e(\014le)i(format.)0 5601 y(There)f(are)h(basically)h
(2)g(steps)e(in)h(using)f(the)h(CFITSIO)e(iterator)j(function.)42
b(The)30 b(\014rst)g(step)h(is)g(to)g(design)g(the)0
5714 y(w)m(ork)26 b(function)f(itself)h(whic)m(h)f(m)m(ust)h(ha)m(v)m
(e)g(a)g(prescrib)s(ed)e(set)i(of)g(input)f(parameters.)39
b(One)25 b(of)h(these)g(parameters)1905 5942 y(73)p eop
end
%%Page: 74 82
TeXDict begin 74 81 bop 0 299 a Fj(74)1455 b Fh(CHAPTER)30
b(6.)112 b(THE)30 b(CFITSIO)e(ITERA)-8 b(TOR)30 b(FUNCTION)0
555 y Fj(is)f(a)g(structure)g(con)m(taining)i(p)s(oin)m(ters)d(to)i
(the)f(arra)m(ys)h(of)f(data;)h(the)f(w)m(ork)h(function)e(can)i(p)s
(erform)d(an)m(y)i(desired)0 668 y(op)s(erations)k(on)h(these)f(arra)m
(ys)h(and)e(do)s(es)h(not)g(need)g(to)h(w)m(orry)f(ab)s(out)g(ho)m(w)g
(the)h(input)e(data)i(w)m(ere)f(read)g(from)0 781 y(the)e(\014le)f(or)g
(ho)m(w)h(the)f(output)g(data)h(get)h(written)e(bac)m(k)h(to)h(the)e
(\014le.)0 941 y(The)24 b(second)h(step)g(is)f(to)i(design)e(the)h
(driv)m(er)g(routine)f(that)i(op)s(ens)e(all)h(the)g(necessary)g(FITS)f
(\014les)h(and)f(initializes)0 1054 y(the)41 b(input)g(parameters)g(to)
h(the)g(iterator)g(function.)73 b(The)41 b(driv)m(er)g(program)g(calls)
h(the)g(CFITSIO)e(iterator)0 1167 y(function)30 b(whic)m(h)g(then)g
(reads)g(the)h(data)g(and)f(passes)g(it)h(to)g(the)g(user's)e(w)m(ork)i
(function.)0 1327 y(The)20 b(follo)m(wing)i(2)f(sections)g(describ)s(e)
f(these)h(steps)g(in)f(more)g(detail.)39 b(There)20 b(are)h(also)g(sev)
m(eral)h(example)f(programs)0 1440 y(included)30 b(with)g(the)g
(CFITSIO)f(distribution)h(whic)m(h)g(illustrate)i(ho)m(w)e(to)h(use)f
(the)h(iterator)g(function.)0 1789 y Ff(6.1)135 b(The)45
b(Iterator)h(W)-11 b(ork)45 b(F)-11 b(unction)0 2043
y Fj(The)42 b(user-supplied)f(iterator)j(w)m(ork)f(function)f(m)m(ust)g
(ha)m(v)m(e)i(the)f(follo)m(wing)h(set)f(of)g(input)e(parameters)i
(\(the)0 2156 y(function)30 b(can)h(b)s(e)e(giv)m(en)j(an)m(y)f
(desired)e(name\):)95 2429 y Fe(int)47 b(user_fn\()f(long)h(totaln,)e
(long)i(offset,)f(long)g(firstn,)g(long)h(nvalues,)716
2542 y(int)g(narrays,)e(iteratorCol)g(*data,)94 b(void)47
b(*userPointer)d(\))136 2815 y Fc(\017)i Fj(totaln)24
b({)f(the)f(total)j(n)m(um)m(b)s(er)c(of)h(table)i(ro)m(ws)e(or)g
(image)i(pixels)f(that)g(will)f(b)s(e)g(passed)g(to)h(the)g(w)m(ork)f
(function)227 2928 y(during)29 b(1)i(or)g(more)f(iterations.)136
3129 y Fc(\017)46 b Fj(o\013set)d({)f(the)h(o\013set)f(applied)g(to)h
(the)f(\014rst)f(table)i(ro)m(w)f(or)g(image)h(pixel)f(to)h(b)s(e)e
(passed)g(to)i(the)f(w)m(ork)227 3241 y(function.)55
b(In)34 b(other)i(w)m(ords,)g(this)f(is)g(the)g(n)m(um)m(b)s(er)f(of)h
(ro)m(ws)h(or)f(pixels)g(that)h(are)f(skipp)s(ed)f(o)m(v)m(er)i(b)s
(efore)227 3354 y(starting)30 b(the)g(iterations.)42
b(If)28 b(o\013set)j(=)e(0,)h(then)f(all)h(the)f(table)i(ro)m(ws)e(or)g
(image)i(pixels)e(will)h(b)s(e)e(passed)h(to)227 3467
y(the)i(w)m(ork)f(function.)136 3668 y Fc(\017)46 b Fj(\014rstn)26
b({)i(the)f(n)m(um)m(b)s(er)f(of)i(the)f(\014rst)g(table)h(ro)m(w)f(or)
g(image)i(pixel)e(\(starting)i(with)e(1\))h(that)f(is)h(b)s(eing)e
(passed)227 3781 y(in)k(this)h(particular)f(call)i(to)f(the)g(w)m(ork)f
(function.)136 3982 y Fc(\017)46 b Fj(n)m(v)-5 b(alues)35
b({)g(the)f(n)m(um)m(b)s(er)g(of)g(table)h(ro)m(ws)g(or)f(image)i
(pixels)e(that)h(are)g(b)s(eing)f(passed)g(in)g(this)h(particular)227
4095 y(call)h(to)g(the)f(w)m(ork)f(function.)54 b(n)m(v)-5
b(alues)35 b(will)g(alw)m(a)m(ys)h(b)s(e)e(less)h(than)f(or)h(equal)g
(to)h(totaln)g(and)e(will)h(ha)m(v)m(e)227 4208 y(the)f(same)f(v)-5
b(alue)34 b(on)f(eac)m(h)h(iteration,)i(except)e(p)s(ossibly)f(on)g
(the)g(last)h(call)h(whic)m(h)e(ma)m(y)g(ha)m(v)m(e)i(a)e(smaller)227
4321 y(v)-5 b(alue.)136 4522 y Fc(\017)46 b Fj(narra)m(ys)31
b({)g(the)g(n)m(um)m(b)s(er)f(of)h(arra)m(ys)g(of)g(data)h(that)f(are)g
(b)s(eing)g(passed)f(to)i(the)f(w)m(ork)g(function.)42
b(There)30 b(is)227 4635 y(one)h(arra)m(y)g(for)f(eac)m(h)i(image)f(or)
f(table)i(column.)136 4835 y Fc(\017)46 b Fj(*data)31
b({)e(arra)m(y)h(of)f(structures,)g(one)h(for)f(eac)m(h)h(column)f(or)g
(image.)42 b(Eac)m(h)29 b(structure)g(con)m(tains)h(a)g(p)s(oin)m(ter)
227 4948 y(to)h(the)g(arra)m(y)g(of)f(data)h(as)g(w)m(ell)g(as)g(other)
g(descriptiv)m(e)g(parameters)g(ab)s(out)f(that)h(arra)m(y)-8
b(.)136 5149 y Fc(\017)46 b Fj(*userP)m(oin)m(ter)26
b({)g(a)f(user)f(supplied)g(p)s(oin)m(ter)h(that)h(can)f(b)s(e)f(used)h
(to)g(pass)g(ancillary)h(information)f(from)g(the)227
5262 y(driv)m(er)h(function)g(to)g(the)g(w)m(ork)g(function.)39
b(This)25 b(p)s(oin)m(ter)h(is)g(passed)g(to)g(the)h(CFITSIO)d
(iterator)j(function)227 5375 y(whic)m(h)37 b(then)f(passes)g(it)h(on)g
(to)g(the)f(w)m(ork)h(function)f(without)h(an)m(y)g(mo)s(di\014cation.)
59 b(It)37 b(ma)m(y)g(p)s(oin)m(t)f(to)i(a)227 5488 y(single)29
b(n)m(um)m(b)s(er,)f(to)h(an)f(arra)m(y)h(of)g(v)-5 b(alues,)29
b(to)g(a)g(structure)f(con)m(taining)i(an)e(arbitrary)g(set)h(of)g
(parameters)227 5601 y(of)e(di\013eren)m(t)h(t)m(yp)s(es,)g(or)f(it)h
(ma)m(y)f(b)s(e)g(a)g(n)m(ull)g(p)s(oin)m(ter)g(if)g(it)h(is)f(not)g
(needed.)40 b(The)26 b(w)m(ork)h(function)g(m)m(ust)g(cast)227
5714 y(this)k(p)s(oin)m(ter)f(to)h(the)g(appropriate)f(data)h(t)m(yp)s
(e)g(b)s(efore)f(using)f(it)i(it.)p eop end
%%Page: 75 83
TeXDict begin 75 82 bop 0 299 a Fh(6.1.)72 b(THE)30 b(ITERA)-8
b(TOR)30 b(W)m(ORK)g(FUNCTION)2021 b Fj(75)0 555 y(The)23
b(totaln,)k(o\013set,)g(narra)m(ys,)e(data,)h(and)d(userP)m(oin)m(ter)i
(parameters)f(are)g(guaran)m(teed)h(to)g(ha)m(v)m(e)g(the)f(same)g(v)-5
b(alue)0 668 y(on)35 b(eac)m(h)i(iteration.)57 b(Only)34
b(\014rstn,)i(n)m(v)-5 b(alues,)37 b(and)d(the)i(arra)m(ys)f(of)h(data)
g(p)s(oin)m(ted)f(to)h(b)m(y)f(the)h(data)g(structures)0
781 y(ma)m(y)31 b(c)m(hange)g(on)g(eac)m(h)g(iterativ)m(e)i(call)f(to)f
(the)f(w)m(ork)h(function.)0 941 y(Note)43 b(that)g(the)f(iterator)h
(treats)g(an)f(image)h(as)f(a)g(long)h(1-D)g(arra)m(y)f(of)h(pixels)f
(regardless)g(of)g(it's)h(in)m(trinsic)0 1054 y(dimensionalit)m(y)-8
b(.)52 b(The)33 b(total)j(n)m(um)m(b)s(er)c(of)i(pixels)g(is)g(just)f
(the)h(pro)s(duct)e(of)i(the)g(size)h(of)e(eac)m(h)i(dimension,)g(and)0
1167 y(the)e(order)g(of)g(the)g(pixels)g(is)g(the)g(same)g(as)g(the)h
(order)e(that)h(they)h(are)f(stored)g(in)g(the)g(FITS)f(\014le.)48
b(If)33 b(the)g(w)m(ork)0 1280 y(function)27 b(needs)g(to)h(kno)m(w)f
(the)h(n)m(um)m(b)s(er)e(and)h(size)h(of)g(the)f(image)i(dimensions)d
(then)h(these)h(parameters)g(can)g(b)s(e)0 1393 y(passed)i(via)h(the)f
(userP)m(oin)m(ter)i(structure.)0 1553 y(The)e(iteratorCol)i(structure)
e(is)g(curren)m(tly)h(de\014ned)e(as)h(follo)m(ws:)0
1780 y Fe(typedef)46 b(struct)94 b(/*)47 b(structure)e(for)i(the)g
(iterator)e(function)h(column)g(information)f(*/)0 1893
y({)143 2005 y(/*)i(structure)f(elements)f(required)h(as)h(input)f(to)h
(fits_iterate_data:)c(*/)95 2231 y(fitsfile)j(*fptr;)332
b(/*)48 b(pointer)d(to)j(the)f(HDU)f(containing)f(the)i(column)f(or)i
(image)e(*/)95 2344 y(int)286 b(colnum;)e(/*)48 b(column)e(number)g(in)
h(the)g(table;)f(ignored)g(for)h(images)189 b(*/)95 2457
y(char)238 b(colname[70];)44 b(/*)k(name)e(\(TTYPEn\))g(of)h(the)g
(column;)f(null)g(for)h(images)285 b(*/)95 2570 y(int)h(datatype;)188
b(/*)48 b(output)e(data)g(type)h(\(converted)e(if)i(necessary\))e(*/)95
2683 y(int)286 b(iotype;)e(/*)48 b(type:)e(InputCol,)f(InputOutputCol,)
f(or)j(OutputCol)e(*/)95 2909 y(/*)j(output)e(structure)f(elements)h
(that)g(may)h(be)g(useful)f(for)h(the)g(work)g(function:)e(*/)95
3135 y(void)238 b(*array;)189 b(/*)47 b(pointer)f(to)h(the)g(array)f
(\(and)h(the)g(null)g(value\))f(*/)95 3247 y(long)238
b(repeat;)189 b(/*)47 b(binary)f(table)h(vector)f(repeat)g(value;)g
(set)238 b(*/)1050 3360 y(/*)g(equal)46 b(to)i(1)f(for)g(images)810
b(*/)95 3473 y(long)238 b(tlmin;)f(/*)47 b(legal)g(minimum)e(data)i
(value,)f(if)h(any)477 b(*/)95 3586 y(long)238 b(tlmax;)f(/*)47
b(legal)g(maximum)e(data)i(value,)f(if)h(any)477 b(*/)95
3699 y(char)238 b(unit[70];)93 b(/*)47 b(physical)f(unit)g(string)g
(\(BUNIT)h(or)g(TUNITn\))189 b(*/)95 3812 y(char)238
b(tdisp[70];)45 b(/*)i(suggested)e(display)h(format;)g(null)h(if)g
(none)190 b(*/)0 4038 y(})47 b(iteratorCol;)0 4264 y
Fj(Instead)34 b(of)g(directly)g(reading)g(or)g(writing)g(the)f(elemen)m
(ts)j(in)d(this)h(structure,)g(it)h(is)e(recommended)h(that)g(pro-)0
4377 y(grammers)c(use)g(the)h(access)h(functions)d(that)i(are)g(pro)m
(vided)f(for)g(this)h(purp)s(ose.)0 4538 y(The)25 b(\014rst)g(\014v)m
(e)h(elemen)m(ts)h(in)f(this)f(structure)h(m)m(ust)f(b)s(e)g(initially)
j(de\014ned)c(b)m(y)i(the)g(driv)m(er)f(routine)h(b)s(efore)f(calling)0
4650 y(the)f(iterator)h(routine.)38 b(The)23 b(CFITSIO)f(iterator)j
(routine)f(uses)f(this)g(information)h(to)g(determine)g(what)f(column)0
4763 y(or)32 b(arra)m(y)h(to)h(pass)e(to)h(the)g(w)m(ork)f(function,)h
(and)f(whether)g(the)g(arra)m(y)h(is)g(to)g(b)s(e)f(input)g(to)h(the)f
(w)m(ork)h(function,)0 4876 y(output)g(from)g(the)h(w)m(ork)f
(function,)h(or)g(b)s(oth.)49 b(The)33 b(CFITSIO)f(iterator)i(function)
f(\014lls)h(in)f(the)g(v)-5 b(alues)34 b(of)g(the)0 4989
y(remaining)c(structure)g(elemen)m(ts)i(b)s(efore)e(passing)g(it)h(to)g
(the)g(w)m(ork)f(function.)0 5149 y(The)d(arra)m(y)g(structure)g
(elemen)m(t)i(is)e(a)g(p)s(oin)m(ter)g(to)h(the)g(actual)g(data)g(arra)
m(y)g(and)e(it)i(m)m(ust)f(b)s(e)f(cast)j(to)e(the)h(correct)0
5262 y(data)k(t)m(yp)s(e)f(b)s(efore)f(it)i(is)f(used.)41
b(The)31 b(`rep)s(eat')g(structure)g(elemen)m(t)h(giv)m(e)g(the)g(n)m
(um)m(b)s(er)d(of)i(data)h(v)-5 b(alues)31 b(in)g(eac)m(h)0
5375 y(ro)m(w)f(of)g(the)g(table,)i(so)e(that)h(the)f(total)i(n)m(um)m
(b)s(er)c(of)i(data)h(v)-5 b(alues)30 b(in)g(the)g(arra)m(y)h(is)f(giv)
m(en)h(b)m(y)f(rep)s(eat)g(*)g(n)m(v)-5 b(alues.)0 5488
y(In)36 b(the)g(case)i(of)e(image)i(arra)m(ys)f(and)e(ASCI)s(I)g
(tables,)k(rep)s(eat)e(will)g(alw)m(a)m(ys)g(b)s(e)f(equal)h(to)g(1.)59
b(When)37 b(the)f(data)0 5601 y(t)m(yp)s(e)k(is)f(a)h(c)m(haracter)h
(string,)h(the)e(arra)m(y)g(p)s(oin)m(ter)f(is)h(actually)h(a)f(p)s
(oin)m(ter)f(to)i(an)e(arra)m(y)h(of)g(string)f(p)s(oin)m(ters)0
5714 y(\(i.e.,)31 b(c)m(har)e(**arra)m(y\).)42 b(The)29
b(other)g(output)g(structure)f(elemen)m(ts)j(are)e(pro)m(vided)g(for)f
(con)m(v)m(enience)k(in)c(case)i(that)p eop end
%%Page: 76 84
TeXDict begin 76 83 bop 0 299 a Fj(76)1455 b Fh(CHAPTER)30
b(6.)112 b(THE)30 b(CFITSIO)e(ITERA)-8 b(TOR)30 b(FUNCTION)0
555 y Fj(information)36 b(is)g(needed)f(within)g(the)h(w)m(ork)g
(function.)56 b(An)m(y)35 b(other)h(information)g(ma)m(y)g(b)s(e)f
(passed)h(from)f(the)0 668 y(driv)m(er)30 b(routine)h(to)g(the)f(w)m
(ork)h(function)f(via)h(the)f(userP)m(oin)m(ter)h(parameter.)0
828 y(Up)s(on)g(completion,)j(the)e(w)m(ork)h(routine)f(m)m(ust)g
(return)f(an)h(in)m(teger)h(status)f(v)-5 b(alue,)34
b(with)d(0)i(indicating)g(success)0 941 y(and)e(an)m(y)g(other)g(v)-5
b(alue)32 b(indicating)g(an)f(error)g(whic)m(h)g(will)g(cause)h(the)f
(iterator)i(function)e(to)h(immediately)g(exit)0 1054
y(at)27 b(that)f(p)s(oin)m(t.)39 b(Return)25 b(status)i(v)-5
b(alues)26 b(in)f(the)h(range)h(1)f({)g(1000)i(should)c(b)s(e)i(a)m(v)m
(oided)h(since)f(these)h(are)f(reserv)m(ed)0 1167 y(for)d(use)g(b)m(y)h
(CFITSIO.)e(A)i(return)e(status)i(v)-5 b(alue)24 b(of)g(-1)g(ma)m(y)g
(b)s(e)f(used)f(to)j(force)f(the)f(CFITSIO)f(iterator)j(function)0
1280 y(to)i(stop)g(at)g(that)h(p)s(oin)m(t)e(and)g(return)g(con)m(trol)
i(to)f(the)g(driv)m(er)f(routine)h(after)g(writing)f(an)m(y)h(output)f
(arra)m(ys)h(to)h(the)0 1393 y(FITS)e(\014le.)40 b(CFITSIO)26
b(do)s(es)g(not)i(considered)f(this)g(to)h(b)s(e)e(an)h(error)g
(condition,)i(so)e(an)m(y)g(further)f(pro)s(cessing)h(b)m(y)0
1506 y(the)k(application)g(program)f(will)h(con)m(tin)m(ue)h(normally)
-8 b(.)0 1837 y Ff(6.2)135 b(The)45 b(Iterator)h(Driv)l(er)g(F)-11
b(unction)0 2087 y Fj(The)33 b(iterator)h(driv)m(er)f(function)g(m)m
(ust)h(op)s(en)e(the)i(necessary)f(FITS)g(\014les)g(and)g(p)s(osition)g
(them)g(to)h(the)g(correct)0 2200 y(HDU.)23 b(It)f(m)m(ust)g(also)i
(initialize)g(the)e(follo)m(wing)i(parameters)e(in)g(the)h(iteratorCol)
h(structure)d(\(de\014ned)g(ab)s(o)m(v)m(e\))j(for)0
2313 y(eac)m(h)31 b(column)f(or)g(image)h(b)s(efore)e(calling)j(the)e
(CFITSIO)e(iterator)j(function.)40 b(Sev)m(eral)31 b(`constructor')g
(routines)0 2426 y(are)g(pro)m(vided)f(in)g(CFITSIO)f(for)h(this)g
(purp)s(ose.)136 2670 y Fc(\017)46 b Fj(*fptr)30 b({)h(The)f
(\014ts\014le)g(p)s(oin)m(ter)g(to)i(the)e(table)h(or)g(image.)136
2853 y Fc(\017)46 b Fj(coln)m(um)30 b({)f(the)h(n)m(um)m(b)s(er)e(of)h
(the)h(column)f(in)g(the)g(table.)42 b(This)28 b(v)-5
b(alue)30 b(is)f(ignored)g(in)g(the)h(case)g(of)g(images.)227
2966 y(If)j(coln)m(um)h(equals)g(0,)g(then)g(the)f(column)g(name)h
(will)f(b)s(e)g(used)g(to)h(iden)m(tify)g(the)f(column)h(to)g(b)s(e)e
(passed)227 3079 y(to)f(the)g(w)m(ork)f(function.)136
3261 y Fc(\017)46 b Fj(colname)32 b({)e(the)g(name)h(\(TTYPEn)e(k)m
(eyw)m(ord\))i(of)f(the)h(column.)40 b(This)29 b(is)i(only)f(required)f
(if)h(coln)m(um)h(=)f(0)227 3374 y(and)g(is)g(ignored)h(for)f(images.)
136 3556 y Fc(\017)46 b Fj(datat)m(yp)s(e)29 b({)g(The)e(desired)h
(data)g(t)m(yp)s(e)g(of)h(the)f(arra)m(y)g(to)h(b)s(e)e(passed)h(to)h
(the)f(w)m(ork)g(function.)40 b(F)-8 b(or)28 b(n)m(umer-)227
3669 y(ical)h(data)f(the)f(data)h(t)m(yp)s(e)g(do)s(es)f(not)g(need)g
(to)h(b)s(e)f(the)g(same)h(as)f(the)h(actual)g(data)g(t)m(yp)s(e)g(in)f
(the)g(FITS)g(\014le,)227 3782 y(in)h(whic)m(h)h(case)g(CFITSIO)e(will)
i(do)g(the)f(con)m(v)m(ersion.)42 b(Allo)m(w)m(ed)30
b(v)-5 b(alues)29 b(are:)40 b(TSTRING,)28 b(TLOGICAL,)227
3895 y(TBYTE,)37 b(TSBYTE,)f(TSHOR)-8 b(T,)36 b(TUSHOR)-8
b(T,)37 b(TINT,)f(TLONG,)h(TULONG,)f(TFLO)m(A)-8 b(T,)38
b(TDOU-)227 4008 y(BLE.)33 b(If)g(the)g(input)f(v)-5
b(alue)33 b(of)g(data)h(t)m(yp)s(e)f(equals)g(0,)i(then)d(the)h
(existing)h(data)g(t)m(yp)s(e)f(of)g(the)g(column)g(or)227
4121 y(image)f(will)f(b)s(e)e(used)h(without)g(an)m(y)h(con)m(v)m
(ersion.)136 4303 y Fc(\017)46 b Fj(iot)m(yp)s(e)37 b({)f(de\014nes)e
(whether)h(the)h(data)g(arra)m(y)g(is)g(to)g(b)s(e)f(input)g(to)h(the)g
(w)m(ork)f(function)h(\(i.e,)i(read)d(from)227 4416 y(the)42
b(FITS)e(\014le\),)k(or)d(output)g(from)g(the)g(w)m(ork)g(function)g
(\(i.e.,)k(written)c(to)h(the)f(FITS)g(\014le\))g(or)g(b)s(oth.)227
4529 y(Allo)m(w)m(ed)30 b(v)-5 b(alues)29 b(are)f(InputCol,)g
(OutputCol,)h(or)f(InputOutputCol.)38 b(V)-8 b(ariable-length)30
b(arra)m(y)f(columns)227 4642 y(are)h(supp)s(orted)e(as)i(InputCol)e
(or)i(InputOutputCol)d(t)m(yp)s(es,)j(but)f(ma)m(y)h(not)g(b)s(e)e
(used)h(for)g(an)h(OutputCol)227 4755 y(t)m(yp)s(e.)0
4999 y(After)h(the)f(driv)m(er)g(routine)g(has)g(initialized)j(all)e
(these)f(parameters,)h(it)g(can)g(then)f(call)h(the)g(CFITSIO)e
(iterator)0 5112 y(function:)95 5357 y Fe(int)47 b
(fits_iterate_data\(int)42 b(narrays,)k(iteratorCol)f(*data,)h(long)g
(offset,)286 5470 y(long)h(nPerLoop,)e(int)i(\(*workFn\)\()e(\),)i
(void)g(*userPointer,)d(int)j(*status\);)136 5714 y Fc(\017)f
Fj(narra)m(ys)31 b({)f(the)h(n)m(um)m(b)s(er)e(of)h(columns)g(or)h
(images)g(that)g(are)g(to)g(b)s(e)f(passed)g(to)h(the)f(w)m(ork)h
(function.)p eop end
%%Page: 77 85
TeXDict begin 77 84 bop 0 299 a Fh(6.3.)72 b(GUIDELINES)30
b(F)m(OR)h(USING)f(THE)g(ITERA)-8 b(TOR)30 b(FUNCTION)1200
b Fj(77)136 555 y Fc(\017)46 b Fj(*data)32 b({)f(p)s(oin)m(ter)f(to)h
(arra)m(y)g(of)f(structures)g(con)m(taining)i(information)f(ab)s(out)f
(eac)m(h)h(column)g(or)f(image.)136 736 y Fc(\017)46
b Fj(o\013set)31 b({)f(if)f(p)s(ositiv)m(e,)i(this)f(n)m(um)m(b)s(er)e
(of)i(ro)m(ws)f(at)h(the)g(b)s(eginning)f(of)h(the)f(table)i(\(or)f
(pixels)f(in)h(the)f(image\))227 849 y(will)i(b)s(e)f(skipp)s(ed)f(and)
g(will)i(not)g(b)s(e)e(passed)h(to)h(the)g(w)m(ork)f(function.)136
1030 y Fc(\017)46 b Fj(nP)m(erLo)s(op)38 b(-)h(sp)s(eci\014es)e(the)i
(n)m(um)m(b)s(er)e(of)h(table)h(ro)m(ws)g(\(or)f(n)m(um)m(b)s(er)f(of)i
(image)g(pixels\))g(that)g(are)g(to)g(b)s(e)227 1143
y(passed)29 b(to)h(the)f(w)m(ork)h(function)e(on)h(eac)m(h)i
(iteration.)42 b(If)28 b(nP)m(erLo)s(op)h(=)g(0)g(then)g(CFITSIO)f
(will)i(calculate)227 1256 y(the)22 b(optim)m(um)g(n)m(um)m(b)s(er)e
(for)h(greatest)j(e\016ciency)-8 b(.)39 b(If)21 b(nP)m(erLo)s(op)g(is)h
(negativ)m(e,)k(then)21 b(all)i(the)f(ro)m(ws)f(or)h(pixels)227
1368 y(will)36 b(b)s(e)f(passed)g(at)h(one)g(time,)i(and)c(the)i(w)m
(ork)g(function)f(will)h(only)f(b)s(e)g(called)i(once.)56
b(If)35 b(an)m(y)h(v)-5 b(ariable)227 1481 y(length)33
b(arra)m(ys)g(are)g(b)s(eing)f(pro)s(cessed,)h(then)g(the)f(nP)m(erLo)s
(op)h(v)-5 b(alue)33 b(is)f(ignored,)i(and)e(the)h(iterator)h(will)227
1594 y(alw)m(a)m(ys)e(pro)s(cess)e(one)h(ro)m(w)f(of)h(the)f(table)i
(at)f(a)g(time.)136 1775 y Fc(\017)46 b Fj(*w)m(orkFn)f(-)f(the)h(name)
f(\(actually)i(the)f(address\))f(of)g(the)g(w)m(ork)h(function)f(that)h
(is)f(to)h(b)s(e)f(called)h(b)m(y)227 1888 y(\014ts)p
354 1888 28 4 v 33 w(iterate)p 643 1888 V 34 w(data.)136
2069 y Fc(\017)h Fj(*userP)m(oin)m(ter)34 b(-)f(this)g(is)g(a)g(user)f
(supplied)g(p)s(oin)m(ter)h(that)g(can)g(b)s(e)g(used)f(to)h(pass)g
(ancillary)h(information)227 2182 y(from)f(the)g(driv)m(er)g(routine)g
(to)h(the)f(w)m(ork)g(function.)48 b(It)33 b(ma)m(y)h(p)s(oin)m(t)f(to)
h(a)f(single)h(n)m(um)m(b)s(er,)e(an)h(arra)m(y)-8 b(,)35
b(or)227 2295 y(to)c(a)g(structure)f(con)m(taining)i(an)e(arbitrary)g
(set)h(of)g(parameters.)136 2476 y Fc(\017)46 b Fj(*status)30
b(-)f(The)f(CFITSIO)f(error)h(status.)41 b(Should)27
b(=)h(0)h(on)g(input;)f(a)h(non-zero)h(output)e(v)-5
b(alue)29 b(indicates)227 2588 y(an)i(error.)0 2828 y(When)f(\014ts)p
392 2828 V 32 w(iterate)p 680 2828 V 35 w(data)h(is)f(called)h(it)f
(\014rst)g(allo)s(cates)i(memory)e(to)h(hold)e(all)i(the)f(requested)g
(columns)g(of)g(data)0 2941 y(or)f(image)i(pixel)e(arra)m(ys.)41
b(It)29 b(then)g(reads)g(the)h(input)e(data)i(from)f(the)g(FITS)f
(tables)i(or)g(images)g(in)m(to)g(the)g(arra)m(ys)0 3054
y(then)h(passes)h(the)g(structure)f(with)g(p)s(oin)m(ters)h(to)g(these)
g(data)h(arra)m(ys)f(to)g(the)g(w)m(ork)g(function.)44
b(After)32 b(the)g(w)m(ork)0 3167 y(function)37 b(returns,)g(the)h
(iterator)g(function)f(writes)g(an)m(y)g(output)g(columns)f(of)h(data)h
(or)f(images)h(bac)m(k)g(to)g(the)0 3279 y(FITS)31 b(\014les.)46
b(It)32 b(then)g(rep)s(eats)g(this)g(pro)s(cess)g(for)f(an)m(y)i
(remaining)f(sets)g(of)h(ro)m(ws)f(or)g(image)h(pixels)f(un)m(til)h(it)
f(has)0 3392 y(pro)s(cessed)27 b(the)i(en)m(tire)g(table)f(or)g(image)i
(or)e(un)m(til)g(the)g(w)m(ork)g(function)g(returns)f(a)h(non-zero)h
(status)f(v)-5 b(alue.)40 b(The)0 3505 y(iterator)33
b(then)f(frees)g(the)h(memory)e(that)i(it)g(initially)g(allo)s(cated)h
(and)e(returns)f(con)m(trol)i(to)g(the)f(driv)m(er)g(routine)0
3618 y(that)f(called)h(it.)0 3949 y Ff(6.3)135 b(Guidelines)46
b(for)f(Using)h(the)f(Iterator)h(F)-11 b(unction)0 4199
y Fj(The)34 b(totaln,)i(o\013set,)h(\014rstn,)d(and)f(n)m(v)-5
b(alues)35 b(parameters)f(that)h(are)f(passed)g(to)h(the)f(w)m(ork)g
(function)g(are)h(useful)0 4312 y(for)f(determining)g(ho)m(w)g(m)m(uc)m
(h)g(of)h(the)f(data)h(has)f(b)s(een)f(pro)s(cessed)h(and)f(ho)m(w)h(m)
m(uc)m(h)g(remains)g(left)h(to)g(do.)52 b(On)0 4425 y(the)36
b(v)m(ery)h(\014rst)f(call)h(to)g(the)f(w)m(ork)h(function)f(\014rstn)f
(will)h(b)s(e)g(equal)h(to)g(o\013set)g(+)f(1;)k(the)c(w)m(ork)g
(function)g(ma)m(y)0 4538 y(need)31 b(to)g(p)s(erform)f(v)-5
b(arious)31 b(initialization)i(tasks)f(b)s(efore)e(starting)i(to)f(pro)
s(cess)g(the)g(data.)43 b(Similarly)-8 b(,)32 b(\014rstn)d(+)0
4650 y(n)m(v)-5 b(alues)29 b(-)f(1)h(will)f(b)s(e)g(equal)g(to)h
(totaln)h(on)e(the)g(last)h(iteration,)i(at)e(whic)m(h)f(p)s(oin)m(t)g
(the)g(w)m(ork)h(function)e(ma)m(y)i(need)0 4763 y(to)k(p)s(erform)f
(some)h(clean)h(up)d(op)s(erations)i(b)s(efore)g(exiting)h(for)e(the)h
(last)h(time.)48 b(The)33 b(w)m(ork)f(function)h(can)g(also)0
4876 y(force)e(an)f(early)h(termination)g(of)g(the)g(iterations)g(b)m
(y)g(returning)e(a)i(status)g(v)-5 b(alue)30 b(=)g(-1.)0
5036 y(The)f(narra)m(ys)g(and)g(iteratorCol.datat)m(yp)s(e)j(argumen)m
(ts)e(allo)m(w)g(the)g(w)m(ork)f(function)g(to)h(double)f(c)m(hec)m(k)i
(that)f(the)0 5149 y(n)m(um)m(b)s(er)k(of)i(input)f(arra)m(ys)h(and)f
(their)g(data)i(t)m(yp)s(es)e(ha)m(v)m(e)i(the)f(exp)s(ected)g(v)-5
b(alues.)57 b(The)35 b(iteratorCol.fptr)i(and)0 5262
y(iteratorCol.coln)m(um)d(structure)d(elemen)m(ts)h(can)g(b)s(e)f(used)
f(if)i(the)f(w)m(ork)h(function)f(needs)g(to)h(read)f(or)g(write)h(the)
0 5375 y(v)-5 b(alues)31 b(of)g(other)g(k)m(eyw)m(ords)g(in)g(the)g
(FITS)f(\014le)h(asso)s(ciated)h(with)f(the)g(arra)m(y)-8
b(.)43 b(This)30 b(should)g(generally)i(only)f(b)s(e)0
5488 y(done)j(during)e(the)i(initialization)j(step)c(or)h(during)f(the)
h(clean)g(up)f(step)h(after)g(the)g(last)h(set)f(of)g(data)g(has)g(b)s
(een)0 5601 y(pro)s(cessed.)40 b(Extra)29 b(FITS)f(\014le)h(I/O)g
(during)e(the)i(main)g(pro)s(cessing)g(lo)s(op)g(of)g(the)g(w)m(ork)g
(function)g(can)g(seriously)0 5714 y(degrade)i(the)f(sp)s(eed)g(of)g
(the)h(program.)p eop end
%%Page: 78 86
TeXDict begin 78 85 bop 0 299 a Fj(78)1455 b Fh(CHAPTER)30
b(6.)112 b(THE)30 b(CFITSIO)e(ITERA)-8 b(TOR)30 b(FUNCTION)0
555 y Fj(If)i(v)-5 b(ariable-length)35 b(arra)m(y)e(columns)g(are)g(b)s
(eing)f(pro)s(cessed,)h(then)g(the)g(iterator)h(will)f(op)s(erate)h(on)
f(one)g(ro)m(w)g(of)0 668 y(the)j(table)g(at)g(a)g(time.)57
b(In)34 b(this)i(case)g(the)g(the)f(rep)s(eat)h(elemen)m(t)h(in)e(the)h
(in)m(teratorCol)h(structure)e(will)h(b)s(e)e(set)0 781
y(equal)d(to)g(the)g(n)m(um)m(b)s(er)e(of)h(elemen)m(ts)i(in)e(the)h
(curren)m(t)f(ro)m(w)g(that)h(is)g(b)s(eing)f(pro)s(cessed.)0
941 y(One)j(imp)s(ortan)m(t)g(feature)h(of)f(the)h(iterator)h(is)e
(that)h(the)f(\014rst)g(elemen)m(t)i(in)e(eac)m(h)h(arra)m(y)g(that)g
(is)f(passed)g(to)h(the)0 1054 y(w)m(ork)f(function)g(giv)m(es)h(the)f
(v)-5 b(alue)33 b(that)h(is)f(used)f(to)h(represen)m(t)g(n)m(ull)g(or)g
(unde\014ned)d(v)-5 b(alues)34 b(in)e(the)h(arra)m(y)-8
b(.)49 b(The)0 1167 y(real)41 b(data)g(then)g(b)s(egins)f(with)g(the)g
(second)h(elemen)m(t)h(of)f(the)f(arra)m(y)h(\(i.e.,)k(arra)m(y[1],)g
(not)c(arra)m(y[0]\).)73 b(If)40 b(the)0 1280 y(\014rst)e(arra)m(y)h
(elemen)m(t)h(is)f(equal)g(to)g(zero,)j(then)c(this)g(indicates)i(that)
f(all)h(the)e(arra)m(y)h(elemen)m(ts)h(ha)m(v)m(e)g(de\014ned)0
1393 y(v)-5 b(alues)33 b(and)f(there)h(are)g(no)g(unde\014ned)d(v)-5
b(alues.)48 b(If)33 b(arra)m(y[0])h(is)f(not)g(equal)g(to)g(zero,)i
(then)d(this)h(indicates)g(that)0 1506 y(some)h(of)g(the)g(data)h(v)-5
b(alues)34 b(are)g(unde\014ned)d(and)j(this)f(v)-5 b(alue)35
b(\(arra)m(y[0]\))h(is)d(used)g(to)i(represen)m(t)f(them.)51
b(In)33 b(the)0 1619 y(case)i(of)e(output)g(arra)m(ys)h(\(i.e.,)i
(those)e(arra)m(ys)g(that)g(will)g(b)s(e)f(written)g(bac)m(k)h(to)h
(the)e(FITS)g(\014le)g(b)m(y)h(the)g(iterator)0 1732
y(function)h(after)i(the)f(w)m(ork)f(function)h(exits\))h(the)f(w)m
(ork)g(function)f(m)m(ust)h(set)g(the)g(\014rst)f(arra)m(y)h(elemen)m
(t)h(to)g(the)0 1844 y(desired)g(n)m(ull)g(v)-5 b(alue)37
b(if)g(necessary)-8 b(,)40 b(otherwise)e(the)f(\014rst)g(elemen)m(t)h
(should)e(b)s(e)h(set)g(to)h(zero)g(to)g(indicate)g(that)0
1957 y(there)30 b(are)h(no)e(n)m(ull)h(v)-5 b(alues)31
b(in)e(the)h(output)g(arra)m(y)-8 b(.)42 b(CFITSIO)28
b(de\014nes)h(2)h(v)-5 b(alues,)31 b(FLO)m(A)-8 b(TNULL)e(V)g(ALUE)31
b(and)0 2070 y(DOUBLENULL)-10 b(V)g(ALUE,)37 b(that)f(can)h(b)s(e)e
(used)g(as)i(default)f(n)m(ull)g(v)-5 b(alues)36 b(for)g(\015oat)h(and)
e(double)h(data)h(t)m(yp)s(es,)0 2183 y(resp)s(ectiv)m(ely)-8
b(.)60 b(In)35 b(the)i(case)g(of)f(c)m(haracter)i(string)e(data)h(t)m
(yp)s(es,)h(a)e(n)m(ull)h(string)f(is)g(alw)m(a)m(ys)i(used)d(to)i
(represen)m(t)0 2296 y(unde\014ned)28 b(strings.)0 2456
y(In)33 b(some)h(applications)g(it)g(ma)m(y)g(b)s(e)f(necessary)h(to)g
(recursiv)m(ely)g(call)h(the)f(iterator)h(function.)50
b(An)33 b(example)h(of)0 2569 y(this)27 b(is)g(giv)m(en)h(b)m(y)f(one)h
(of)f(the)h(example)f(programs)g(that)h(is)f(distributed)f(with)h
(CFITSIO:)f(it)i(\014rst)e(calls)i(a)g(w)m(ork)0 2682
y(function)38 b(that)g(writes)h(out)f(a)g(2D)h(histogram)g(image.)65
b(That)38 b(w)m(ork)g(function)g(in)f(turn)g(calls)j(another)e(w)m(ork)
0 2795 y(function)29 b(that)h(reads)g(the)f(`X')i(and)e(`Y')h(columns)f
(in)g(a)h(table)h(to)f(calculate)i(the)d(v)-5 b(alue)31
b(of)e(eac)m(h)i(2D)f(histogram)0 2908 y(image)i(pixel.)41
b(Graphically)-8 b(,)32 b(the)e(program)g(structure)g(can)h(b)s(e)f
(describ)s(ed)f(as:)48 3153 y Fe(driver)46 b(-->)h(iterator)e(-->)i
(work1_fn)f(-->)h(iterator)e(-->)i(work2_fn)0 3399 y
Fj(Finally)-8 b(,)42 b(it)d(should)e(b)s(e)h(noted)g(that)h(the)g
(table)g(columns)f(or)g(image)i(arra)m(ys)f(that)g(are)f(passed)g(to)h
(the)g(w)m(ork)0 3512 y(function)c(do)h(not)g(all)g(ha)m(v)m(e)h(to)f
(come)h(from)e(the)h(same)g(FITS)f(\014le)g(and)g(instead)h(ma)m(y)g
(come)h(from)e(an)m(y)h(com-)0 3625 y(bination)d(of)g(sources)g(as)h
(long)f(as)h(they)f(ha)m(v)m(e)h(the)f(same)h(length.)49
b(The)32 b(length)i(of)f(the)g(\014rst)f(table)i(column)f(or)0
3738 y(image)f(arra)m(y)f(is)f(used)f(b)m(y)i(the)f(iterator)i(if)e
(they)h(do)f(not)h(all)g(ha)m(v)m(e)h(the)e(same)h(length.)0
4069 y Ff(6.4)135 b(Complete)47 b(List)e(of)g(Iterator)i(Routines)0
4319 y Fj(All)36 b(of)f(the)g(iterator)h(routines)f(are)g(listed)h(b)s
(elo)m(w.)54 b(Most)36 b(of)f(these)h(routines)e(do)h(not)g(ha)m(v)m(e)
i(a)e(corresp)s(onding)0 4432 y(short)30 b(function)g(name.)0
4678 y Fi(1)81 b Fj(Iterator)32 b(`constructor')h(functions)e(that)i
(set)f(the)g(v)-5 b(alue)32 b(of)g(elemen)m(ts)h(in)f(the)g
(iteratorCol)h(structure)e(that)227 4791 y(de\014ne)k(the)h(columns)f
(or)h(arra)m(ys.)56 b(These)36 b(set)g(the)g(\014ts\014le)f(p)s(oin)m
(ter,)i(column)e(name,)j(column)d(n)m(um)m(b)s(er,)227
4904 y(datat)m(yp)s(e,)28 b(and)e(iot)m(yp)s(e,)i(resp)s(ectiv)m(ely)-8
b(.)41 b(The)25 b(last)i(2)g(routines)f(allo)m(w)h(all)g(the)f
(parameters)h(to)f(b)s(e)g(set)g(with)227 5017 y(one)31
b(function)f(call)i(\(one)f(supplies)e(the)i(column)f(name,)h(the)f
(other)h(the)f(column)g(n)m(um)m(b)s(er\).)95 5262 y
Fe(int)47 b(fits_iter_set_file\(iterato)o(rCo)o(l)42
b(*col,)k(fitsfile)g(*fptr\);)95 5488 y(int)h
(fits_iter_set_colname\(iter)o(ato)o(rCol)41 b(*col,)46
b(char)h(*colname\);)95 5714 y(int)g(fits_iter_set_colnum\(itera)o(tor)
o(Col)41 b(*col,)47 b(int)g(colnum\);)p eop end
%%Page: 79 87
TeXDict begin 79 86 bop 0 299 a Fh(6.4.)72 b(COMPLETE)29
b(LIST)g(OF)i(ITERA)-8 b(TOR)29 b(R)m(OUTINES)1638 b
Fj(79)95 668 y Fe(int)47 b(fits_iter_set_datatype\(ite)o(rat)o(orCo)o
(l)42 b(*col,)k(int)h(datatype\);)95 894 y(int)g
(fits_iter_set_iotype\(itera)o(tor)o(Col)41 b(*col,)47
b(int)g(iotype\);)95 1120 y(int)g(fits_iter_set_by_name\(iter)o(ato)o
(rCol)41 b(*col,)46 b(fitsfile)g(*fptr,)477 1233 y(char)h(*colname,)e
(int)i(datatype,)93 b(int)47 b(iotype\);)95 1458 y(int)g
(fits_iter_set_by_num\(itera)o(tor)o(Col)41 b(*col,)47
b(fitsfile)e(*fptr,)477 1571 y(int)i(colnum,)f(int)h(datatype,)93
b(int)47 b(iotype\);)0 1820 y Fi(2)81 b Fj(Iterator)38
b(`accessor')h(functions)e(that)g(return)g(the)g(v)-5
b(alue)38 b(of)f(the)g(elemen)m(t)i(in)e(the)g(iteratorCol)i(structure)
227 1933 y(that)31 b(describ)s(es)f(a)h(particular)f(data)h(column)g
(or)f(arra)m(y)95 2181 y Fe(fitsfile)46 b(*)h
(fits_iter_get_file\(iterato)o(rCol)41 b(*col\);)95 2407
y(char)47 b(*)h(fits_iter_get_colname\(i)o(ter)o(ator)o(Col)41
b(*col\);)95 2633 y(int)47 b(fits_iter_get_colnum\(itera)o(tor)o(Col)41
b(*col\);)95 2858 y(int)47 b(fits_iter_get_datatype\(ite)o(rat)o(orCo)o
(l)42 b(*col\);)95 3084 y(int)47 b(fits_iter_get_iotype\(itera)o(tor)o
(Col)41 b(*col\);)95 3310 y(void)47 b(*)h(fits_iter_get_array\(ite)o
(rat)o(orCo)o(l)42 b(*col\);)95 3536 y(long)47 b
(fits_iter_get_tlmin\(itera)o(tor)o(Col)41 b(*col\);)95
3762 y(long)47 b(fits_iter_get_tlmax\(itera)o(tor)o(Col)41
b(*col\);)95 3987 y(long)47 b(fits_iter_get_repeat\(iter)o(ato)o(rCol)
41 b(*col\);)95 4213 y(char)47 b(*)h(fits_iter_get_tunit\(ite)o(rat)o
(orCo)o(l)42 b(*col\);)95 4439 y(char)47 b(*)h
(fits_iter_get_tdisp\(ite)o(rat)o(orCo)o(l)42 b(*col\);)0
4687 y Fi(3)81 b Fj(The)29 b(CFITSIO)g(iterator)j(function)95
4936 y Fe(int)47 b(fits_iterate_data\(int)42 b(narrays,)94
b(iteratorCol)44 b(*data,)i(long)h(offset,)573 5049 y(long)f(nPerLoop,)
573 5161 y(int)h(\(*workFn\)\()e(long)h(totaln,)g(long)h(offset,)f
(long)g(firstn,)1289 5274 y(long)g(nvalues,)g(int)h(narrays,)e
(iteratorCol)g(*data,)1289 5387 y(void)h(*userPointer\),)573
5500 y(void)g(*userPointer,)573 5613 y(int)h(*status\);)p
eop end
%%Page: 80 88
TeXDict begin 80 87 bop 0 299 a Fj(80)1455 b Fh(CHAPTER)30
b(6.)112 b(THE)30 b(CFITSIO)e(ITERA)-8 b(TOR)30 b(FUNCTION)p
eop end
%%Page: 81 89
TeXDict begin 81 88 bop 0 1225 a Fg(Chapter)65 b(7)0
1687 y Fm(W)-19 b(orld)77 b(Co)6 b(ordinate)78 b(System)f(Routines)0
2180 y Fj(The)36 b(FITS)g(comm)m(unit)m(y)h(has)f(adopted)h(a)g(set)g
(of)g(k)m(eyw)m(ord)g(con)m(v)m(en)m(tions)h(that)f(de\014ne)f(the)h
(transformations)0 2293 y(needed)30 b(to)i(con)m(v)m(ert)g(b)s(et)m(w)m
(een)f(pixel)g(lo)s(cations)h(in)e(an)h(image)h(and)e(the)g(corresp)s
(onding)g(celestial)j(co)s(ordinates)0 2406 y(on)25 b(the)h(sky)-8
b(,)27 b(or)e(more)g(generally)-8 b(,)29 b(that)d(de\014ne)e(w)m(orld)h
(co)s(ordinates)i(that)e(are)h(to)g(b)s(e)f(asso)s(ciated)i(with)e(an)m
(y)h(pixel)0 2518 y(lo)s(cation)h(in)e(an)h(n-dimensional)f(FITS)g
(arra)m(y)-8 b(.)40 b(CFITSIO)24 b(is)h(distributed)g(with)g(a)h(a)g
(few)f(self-con)m(tained)i(W)-8 b(orld)0 2631 y(Co)s(ordinate)30
b(System)g(\(W)m(CS\))g(routines,)g(ho)m(w)m(ev)m(er,)i(these)e
(routines)g(DO)f(NOT)h(supp)s(ort)e(all)j(the)f(latest)h(W)m(CS)0
2744 y(con)m(v)m(en)m(tions,)38 b(so)c(it)h(is)g(STR)m(ONGL)-8
b(Y)34 b(RECOMMENDED)h(that)g(soft)m(w)m(are)h(dev)m(elop)s(ers)e(use)g
(a)h(more)g(robust)0 2857 y(external)c(W)m(CS)g(library)-8
b(.)40 b(Sev)m(eral)32 b(recommended)e(libraries)g(are:)95
3138 y Fe(WCSLIB)47 b(-)95 b(supported)45 b(by)i(Mark)g(Calabretta)95
3251 y(WCSTools)f(-)h(supported)f(by)h(Doug)g(Mink)95
3364 y(AST)g(library)f(-)i(developed)d(by)i(the)g(U.K.)g(Starlink)e
(project)0 3644 y Fj(More)30 b(information)f(ab)s(out)g(the)g(W)m(CS)g
(k)m(eyw)m(ord)h(con)m(v)m(en)m(tions)h(and)d(links)h(to)h(all)g(of)f
(these)g(W)m(CS)g(libraries)h(can)0 3757 y(b)s(e)g(found)f(on)h(the)h
(FITS)e(Supp)s(ort)g(O\016ce)h(w)m(eb)g(site)i(at)f(h)m
(ttp://\014ts.gsfc.nasa.go)m(v)j(under)29 b(the)h(W)m(CS)h(link.)0
3917 y(The)40 b(functions)h(pro)m(vided)g(in)f(these)i(external)f(W)m
(CS)g(libraries)h(will)f(need)g(access)h(to)f(the)h(W)m(CS)f(k)m(eyw)m
(ords)0 4030 y(con)m(tained)36 b(in)f(the)h(FITS)e(\014le)i(headers.)55
b(One)35 b(con)m(v)m(enien)m(t)i(w)m(a)m(y)f(to)g(pass)f(this)g
(information)h(to)g(the)f(external)0 4143 y(library)c(is)f(to)i(use)f
(the)g(\014ts)p 942 4143 28 4 v 32 w(hdr2str)f(routine)h(in)g(CFITSIO)e
(\(de\014ned)h(b)s(elo)m(w\))h(to)h(cop)m(y)g(the)f(header)g(k)m(eyw)m
(ords)0 4256 y(in)m(to)k(one)e(long)i(string,)f(and)f(then)g(pass)g
(this)h(string)f(to)i(an)e(in)m(terface)i(routine)f(in)f(the)h
(external)g(library)f(that)0 4369 y(will)d(extract)h(the)f(necessary)f
(W)m(CS)h(information)g(\(e.g.,)h(the)f('w)m(cspih')g(routine)f(in)g
(the)h(W)m(CSLIB)f(library)h(and)0 4482 y(the)h('astFitsChan')g(and)f
('astPutCards')g(functions)g(in)g(the)h(AST)e(library\).)0
4763 y Fi(1)81 b Fj(Concatenate)38 b(the)f(header)f(k)m(eyw)m(ords)h
(in)f(the)g(CHDU)h(in)m(to)h(a)f(single)g(long)g(string)f(of)h(c)m
(haracters.)60 b(Eac)m(h)227 4876 y(80-c)m(haracter)28
b(\014xed-length)c(k)m(eyw)m(ord)h(record)g(is)g(app)s(ended)d(to)k
(the)f(output)f(c)m(haracter)i(string,)g(in)e(order,)227
4989 y(with)h(no)f(in)m(terv)m(ening)i(separator)f(or)g(terminating)h
(c)m(haracters.)40 b(The)24 b(last)i(header)e(record)h(is)f(terminated)
227 5101 y(with)33 b(a)g(NULL)f(c)m(haracter.)49 b(This)32
b(routine)h(allo)s(cates)i(memory)d(for)h(the)g(returned)e(c)m
(haracter)j(arra)m(y)-8 b(,)35 b(so)227 5214 y(the)c(calling)h(program)
e(m)m(ust)g(free)h(the)f(memory)g(when)g(\014nished.)227
5375 y(There)c(are)h(2)f(related)h(routines:)39 b(\014ts)p
1514 5375 V 32 w(hdr2str)25 b(simply)h(concatenates)j(all)e(the)f
(existing)h(k)m(eyw)m(ords)g(in)f(the)227 5488 y(header;)40
b(\014ts)p 682 5488 V 32 w(con)m(v)m(ert)p 1003 5488
V 34 w(hdr2str)35 b(is)i(similar,)h(except)f(that)g(if)f(the)h(CHDU)f
(is)h(a)f(tile)i(compressed)e(image)227 5601 y(\(stored)28
b(in)g(a)f(binary)g(table\))i(then)e(it)h(will)g(\014rst)f(con)m(v)m
(ert)i(that)f(header)g(bac)m(k)g(to)g(that)g(of)g(a)g(normal)g(FITS)227
5714 y(image)k(b)s(efore)e(concatenating)j(the)d(k)m(eyw)m(ords.)1905
5942 y(81)p eop end
%%Page: 82 90
TeXDict begin 82 89 bop 0 299 a Fj(82)1169 b Fh(CHAPTER)29
b(7.)112 b(W)m(ORLD)31 b(COORDINA)-8 b(TE)30 b(SYSTEM)f(R)m(OUTINES)227
555 y Fj(Selected)h(k)m(eyw)m(ords)e(ma)m(y)h(b)s(e)e(excluded)h(from)g
(the)g(returned)f(c)m(haracter)j(string.)40 b(If)27 b(the)i(second)f
(param-)227 668 y(eter)h(\(no)s(commen)m(ts\))g(is)f(TR)m(UE)g
(\(nonzero\))h(then)e(an)m(y)i(COMMENT,)f(HISTOR)-8 b(Y,)27
b(or)h(blank)g(k)m(eyw)m(ords)227 781 y(in)i(the)h(header)f(will)h(not)
f(b)s(e)g(copied)h(to)g(the)g(output)f(string.)227 924
y(The)25 b('exclist')j(parameter)e(ma)m(y)g(b)s(e)f(used)g(to)h(supply)
e(a)i(list)h(of)e(k)m(eyw)m(ords)h(that)h(are)f(to)g(b)s(e)f(excluded)g
(from)227 1037 y(the)k(output)g(c)m(haracter)h(string.)41
b(Wild)29 b(card)g(c)m(haracters)h(\(*,)g(?,)f(and)g(#\))g(ma)m(y)g(b)s
(e)f(used)g(in)h(the)g(excluded)227 1150 y(k)m(eyw)m(ord)h(names.)41
b(If)29 b(no)g(additional)i(k)m(eyw)m(ords)f(are)g(to)g(b)s(e)f
(excluded,)h(then)f(set)h(nexc)g(=)f(0)h(and)f(sp)s(ecify)227
1263 y(NULL)i(for)f(the)g(the)h(**exclist)i(parameter.)95
1478 y Fe(int)47 b(fits_hdr2str)286 1591 y(\(fitsfile)f(*fptr,)g(int)h
(nocomments,)d(char)j(**exclist,)e(int)i(nexc,)286 1704
y(>)h(char)e(**header,)g(int)h(*nkeys,)e(int)i(*status\))95
1930 y(int)g(fits_convert_hdr2str)c(/)k(ffcnvthdr2str)286
2043 y(\(fitsfile)f(*fptr,)g(int)h(nocomments,)d(char)j(**exclist,)e
(int)i(nexc,)286 2155 y(>)h(char)e(**header,)g(int)h(*nkeys,)e(int)i
(*status\))0 2371 y Fi(2)81 b Fj(The)24 b(follo)m(wing)j(CFITSIO)d
(routine)i(is)f(sp)s(eci\014cally)h(designed)f(for)h(use)f(in)g
(conjunction)g(with)g(the)h(W)m(CSLIB)227 2484 y(library)-8
b(.)40 b(It)27 b(is)h(not)f(exp)s(ected)h(that)g(applications)g
(programmers)f(will)h(call)g(this)f(routine)h(directly)-8
b(,)29 b(but)d(it)227 2597 y(is)33 b(do)s(cumen)m(ted)g(here)g(for)g
(completeness.)50 b(This)33 b(routine)g(extracts)h(arra)m(ys)g(from)e
(a)i(binary)e(table)i(that)227 2710 y(con)m(tain)i(W)m(CS)e
(information)h(using)f(the)g(-T)-8 b(AB)36 b(table)f(lo)s(okup)f(con)m
(v)m(en)m(tion.)55 b(See)35 b(the)f(do)s(cumen)m(tation)227
2822 y(pro)m(vided)c(with)g(the)h(W)m(CSLIB)f(library)g(for)g(more)h
(information.)95 3038 y Fe(int)47 b(fits_read_wcstab)334
3151 y(\(fitsfile)e(*fptr,)h(int)h(nwtb,)g(wtbarr)f(*wtb,)g(int)h
(*status\);)0 3477 y Ff(7.1)180 b(Self-con)l(tained)46
b(W)l(CS)f(Routines)0 3728 y Fj(The)21 b(follo)m(wing)i(routines)e(DO)g
(NOT)g(supp)s(ort)f(the)h(more)h(recen)m(t)g(W)m(CS)f(con)m(v)m(en)m
(tions)j(that)d(ha)m(v)m(e)i(b)s(een)e(appro)m(v)m(ed)0
3841 y(as)34 b(part)g(of)g(the)g(FITS)f(standard.)50
b(Consequen)m(tly)-8 b(,)35 b(the)f(follo)m(wing)i(routines)d(ARE)h(NO)
m(W)h(DEPRECA)-8 b(TED.)0 3953 y(It)30 b(is)g(STR)m(ONGL)-8
b(Y)30 b(RECOMMENDED)h(that)g(soft)m(w)m(are)g(dev)m(elop)s(ers)f(not)h
(use)f(these)g(routines,)g(and)g(instead)0 4066 y(use)g(an)g(external)i
(W)m(CS)e(library)-8 b(,)31 b(as)f(describ)s(ed)f(in)i(the)f(previous)g
(section.)0 4227 y(These)21 b(routines)g(are)g(included)f(mainly)h(for)
g(bac)m(kw)m(ard)g(compatibilit)m(y)j(with)c(existing)i(soft)m(w)m
(are.)39 b(They)21 b(supp)s(ort)0 4339 y(the)30 b(follo)m(wing)i
(standard)d(map)g(pro)5 b(jections:)41 b(-SIN,)30 b(-T)-8
b(AN,)31 b(-AR)m(C,)g(-NCP)-8 b(,)30 b(-GLS,)g(-MER,)h(and)e(-AIT)h
(\(these)0 4452 y(are)f(the)g(legal)h(v)-5 b(alues)29
b(for)f(the)h(co)s(ordt)m(yp)s(e)f(parameter\).)41 b(These)28
b(routines)h(are)g(based)f(on)g(similar)h(functions)f(in)0
4565 y(Classic)j(AIPS.)f(All)h(the)g(angular)f(quan)m(tities)i(are)f
(giv)m(en)g(in)f(units)g(of)g(degrees.)0 4781 y Fi(1)81
b Fj(Get)41 b(the)f(v)-5 b(alues)41 b(of)g(the)f(basic)h(set)g(of)f
(standard)g(FITS)f(celestial)k(co)s(ordinate)e(system)g(k)m(eyw)m(ords)
f(from)227 4894 y(the)33 b(header)f(of)h(a)f(FITS)g(image)i(\(i.e.,)g
(the)f(primary)f(arra)m(y)g(or)h(an)f(IMA)m(GE)i(extension\).)47
b(These)33 b(v)-5 b(alues)227 5006 y(ma)m(y)35 b(then)f(b)s(e)g(passed)
f(to)i(the)g(\014ts)p 1462 5006 28 4 v 32 w(pix)p 1618
5006 V 32 w(to)p 1730 5006 V 34 w(w)m(orld)f(and)g(\014ts)p
2321 5006 V 32 w(w)m(orld)p 2573 5006 V 33 w(to)p 2686
5006 V 33 w(pix)g(routines)g(that)h(p)s(erform)e(the)227
5119 y(co)s(ordinate)f(transformations.)42 b(If)30 b(an)m(y)h(or)f(all)
i(of)f(the)g(W)m(CS)f(k)m(eyw)m(ords)h(are)g(not)g(presen)m(t,)g(then)g
(default)227 5232 y(v)-5 b(alues)26 b(will)f(b)s(e)f(returned.)38
b(If)24 b(the)i(\014rst)e(co)s(ordinate)i(axis)f(is)g(the)g
(declination-lik)m(e)j(co)s(ordinate,)f(then)e(this)227
5345 y(routine)31 b(will)f(sw)m(ap)h(them)f(so)h(that)g(the)f
(longitudinal-lik)m(e)j(co)s(ordinate)e(is)f(returned)g(as)g(the)h
(\014rst)e(axis.)227 5488 y(The)34 b(\014rst)g(routine)h(\(\013gics\))h
(returns)e(the)h(primary)f(W)m(CS,)g(whereas)h(the)g(second)g(routine)f
(returns)g(the)227 5601 y(particular)24 b(v)m(ersion)h(of)f(the)g(W)m
(CS)f(sp)s(eci\014ed)g(b)m(y)h(the)g('v)m(ersion')h(parameter,)h(whic)m
(h)d(m)m(uc)m(h)h(b)s(e)f(a)h(c)m(haracter)227 5714 y(ranging)31
b(from)f('A')h(to)g('Z')f(\(or)h(a)g(blank)f(c)m(haracter,)i(whic)m(h)e
(is)g(equiv)-5 b(alen)m(t)32 b(to)f(calling)h(\013gics\).)p
eop end
%%Page: 83 91
TeXDict begin 83 90 bop 0 299 a Fh(7.1.)113 b(SELF-CONT)-8
b(AINED)30 b(W)m(CS)g(R)m(OUTINES)1984 b Fj(83)227 555
y(If)35 b(the)h(\014le)f(uses)g(the)g(new)m(er)h('CDj)p
1454 555 28 4 v 32 w(i')g(W)m(CS)f(transformation)h(matrix)g(k)m(eyw)m
(ords)f(instead)h(of)f(old)h(st)m(yle)227 668 y('CDEL)-8
b(Tn')37 b(and)f('CR)m(OT)-8 b(A2')38 b(k)m(eyw)m(ords,)h(then)e(this)f
(routine)h(will)g(calculate)j(and)c(return)g(the)h(v)-5
b(alues)227 781 y(of)33 b(the)g(equiv)-5 b(alen)m(t)35
b(old-st)m(yle)f(k)m(eyw)m(ords.)49 b(Note)34 b(that)g(the)f(con)m(v)m
(ersion)h(from)e(the)i(new-st)m(yle)g(k)m(eyw)m(ords)227
894 y(to)e(the)f(old-st)m(yle)h(v)-5 b(alues)31 b(is)g(sometimes)g
(only)g(an)g(appro)m(ximation,)h(so)e(if)h(the)g(appro)m(ximation)h(is)
e(larger)227 1007 y(than)37 b(an)h(in)m(ternally)g(de\014ned)e
(threshold)h(lev)m(el,)k(then)c(CFITSIO)f(will)i(still)g(return)e(the)i
(appro)m(ximate)227 1120 y(W)m(CS)32 b(k)m(eyw)m(ord)h(v)-5
b(alues,)33 b(but)e(will)h(also)h(return)e(with)h(status)g(=)f(APPR)m
(O)m(X)p 2908 1120 V 34 w(W)m(CS)p 3149 1120 V 33 w(KEY,)g(to)i(w)m
(arn)f(the)227 1233 y(calling)k(program)e(that)h(appro)m(ximations)g
(ha)m(v)m(e)g(b)s(een)f(made.)52 b(It)35 b(is)f(then)g(up)f(to)i(the)f
(calling)i(program)227 1346 y(to)30 b(decide)g(whether)e(the)h(appro)m
(ximations)h(are)g(su\016cien)m(tly)f(accurate)i(for)e(the)g
(particular)g(application,)227 1458 y(or)46 b(whether)e(more)i(precise)
g(W)m(CS)f(transformations)h(m)m(ust)f(b)s(e)g(p)s(erformed)f(using)g
(new-st)m(yle)j(W)m(CS)227 1571 y(k)m(eyw)m(ords)31 b(directly)-8
b(.)95 1824 y Fe(int)47 b(fits_read_img_coord)c(/)k(ffgics)286
1937 y(\(fitsfile)f(*fptr,)g(>)h(double)f(*xrefval,)g(double)g
(*yrefval,)334 2050 y(double)g(*xrefpix,)f(double)i(*yrefpix,)e(double)
h(*xinc,)g(double)g(*yinc,)334 2163 y(double)g(*rot,)h(char)f
(*coordtype,)f(int)i(*status\))95 2389 y(int)g
(fits_read_img_coord_versio)o(n)42 b(/)47 b(ffgicsa)286
2502 y(\(fitsfile)f(*fptr,)g(char)g(version,)g(>)h(double)f(*xrefval,)g
(double)g(*yrefval,)334 2615 y(double)g(*xrefpix,)f(double)i(*yrefpix,)
e(double)h(*xinc,)g(double)g(*yinc,)334 2728 y(double)g(*rot,)h(char)f
(*coordtype,)f(int)i(*status\))0 2981 y Fi(2)81 b Fj(Get)30
b(the)f(v)-5 b(alues)30 b(of)f(the)h(standard)e(FITS)h(celestial)j(co)s
(ordinate)e(system)f(k)m(eyw)m(ords)h(from)f(the)g(header)g(of)h(a)227
3094 y(FITS)23 b(table)i(where)e(the)h(X)g(and)g(Y)g(\(or)g(RA)g(and)f
(DEC\))h(co)s(ordinates)h(are)f(stored)g(in)f(2)h(separate)h(columns)
227 3207 y(of)30 b(the)f(table)h(\(as)g(in)f(the)h(Ev)m(en)m(t)g(List)g
(table)g(format)f(that)h(is)g(often)f(used)g(b)m(y)g(high)g(energy)g
(astroph)m(ysics)227 3320 y(missions\).)71 b(These)40
b(v)-5 b(alues)40 b(ma)m(y)h(then)f(b)s(e)f(passed)h(to)h(the)f(\014ts)
p 2511 3320 V 33 w(pix)p 2668 3320 V 32 w(to)p 2780 3320
V 34 w(w)m(orld)g(and)g(\014ts)p 3383 3320 V 32 w(w)m(orld)p
3635 3320 V 33 w(to)p 3748 3320 V 33 w(pix)227 3432 y(routines)31
b(that)f(p)s(erform)f(the)i(co)s(ordinate)g(transformations.)95
3685 y Fe(int)47 b(fits_read_tbl_coord)c(/)k(ffgtcs)286
3798 y(\(fitsfile)f(*fptr,)g(int)h(xcol,)f(int)h(ycol,)f(>)i(double)e
(*xrefval,)334 3911 y(double)g(*yrefval,)f(double)i(*xrefpix,)e(double)
h(*yrefpix,)f(double)h(*xinc,)334 4024 y(double)g(*yinc,)g(double)g
(*rot,)h(char)f(*coordtype,)f(int)i(*status\))0 4277
y Fi(3)81 b Fj(Calculate)42 b(the)g(celestial)h(co)s(ordinate)f
(corresp)s(onding)e(to)i(the)f(input)f(X)h(and)g(Y)g(pixel)g(lo)s
(cation)i(in)e(the)227 4390 y(image.)95 4643 y Fe(int)47
b(fits_pix_to_world)c(/)48 b(ffwldp)286 4756 y(\(double)e(xpix,)h
(double)f(ypix,)g(double)g(xrefval,)g(double)g(yrefval,)334
4869 y(double)g(xrefpix,)g(double)g(yrefpix,)f(double)h(xinc,)h(double)
f(yinc,)334 4982 y(double)g(rot,)h(char)f(*coordtype,)f(>)j(double)e
(*xpos,)g(double)g(*ypos,)334 5095 y(int)h(*status\))0
5348 y Fi(4)81 b Fj(Calculate)42 b(the)g(X)f(and)f(Y)h(pixel)h(lo)s
(cation)g(corresp)s(onding)e(to)i(the)f(input)f(celestial)k(co)s
(ordinate)e(in)f(the)227 5461 y(image.)95 5714 y Fe(int)47
b(fits_world_to_pix)c(/)48 b(ffxypx)p eop end
%%Page: 84 92
TeXDict begin 84 91 bop 0 299 a Fj(84)1169 b Fh(CHAPTER)29
b(7.)112 b(W)m(ORLD)31 b(COORDINA)-8 b(TE)30 b(SYSTEM)f(R)m(OUTINES)286
555 y Fe(\(double)46 b(xpos,)h(double)f(ypos,)g(double)g(xrefval,)g
(double)g(yrefval,)334 668 y(double)g(xrefpix,)g(double)g(yrefpix,)f
(double)h(xinc,)h(double)f(yinc,)334 781 y(double)g(rot,)h(char)f
(*coordtype,)f(>)j(double)e(*xpix,)g(double)g(*ypix,)334
894 y(int)h(*status\))p eop end
%%Page: 85 93
TeXDict begin 85 92 bop 0 1225 a Fg(Chapter)65 b(8)0
1687 y Fm(Hierarc)-6 b(hical)76 b(Grouping)h(Routines)0
2180 y Fj(These)34 b(functions)h(allo)m(w)h(for)e(the)h(creation)h(and)
e(manipulation)h(of)g(FITS)f(HDU)h(Groups,)h(as)f(de\014ned)e(in)h("A)0
2293 y(Hierarc)m(hical)f(Grouping)c(Con)m(v)m(en)m(tion)j(for)e(FITS")h
(b)m(y)f(Jennings,)g(P)m(ence,)h(F)-8 b(olk)32 b(and)e(Sc)m(hlesinger:)
0 2453 y(h)m(ttp://\014ts.gsfc.nasa.go)m(v/group.h)m(tml)0
2613 y(A)38 b(group)g(is)g(a)g(collection)j(of)d(HDUs)h(whose)f(asso)s
(ciation)h(is)g(de\014ned)d(b)m(y)i(a)h Fa(gr)-5 b(ouping)40
b(table)p Fj(.)65 b(HDUs)38 b(whic)m(h)0 2726 y(are)46
b(part)f(of)g(a)g(group)g(are)h(referred)e(to)i(as)f
Fa(memb)-5 b(er)47 b(HDUs)d Fj(or)h(simply)g(as)g Fa(memb)-5
b(ers)p Fj(.)86 b(Grouping)45 b(table)0 2839 y(mem)m(b)s(er)40
b(HDUs)i(ma)m(y)f(themselv)m(es)h(b)s(e)f(grouping)f(tables,)45
b(th)m(us)40 b(allo)m(wing)j(for)e(the)g(construction)g(of)g(op)s(en-)0
2952 y(ended)30 b(hierarc)m(hies)h(of)f(HDUs.)0 3112
y(Grouping)c(tables)i(con)m(tain)g(one)f(ro)m(w)g(for)f(eac)m(h)i(mem)m
(b)s(er)e(HDU.)i(The)e(grouping)g(table)i(columns)e(pro)m(vide)h(iden-)
0 3225 y(ti\014cation)i(information)f(that)g(allo)m(ws)h(applications)f
(to)g(reference)g(or)g("p)s(oin)m(t)g(to")g(the)g(mem)m(b)s(er)f(HDUs.)
40 b(Mem-)0 3338 y(b)s(er)27 b(HDUs)h(are)g(exp)s(ected,)h(but)e(not)h
(required,)f(to)i(con)m(tain)g(a)f(set)g(of)g(GRPIDn/GRPLCn)f(k)m(eyw)m
(ords)h(in)f(their)0 3451 y(headers)j(for)h(eac)m(h)g(grouping)g(table)
g(that)g(they)g(are)g(referenced)g(b)m(y)-8 b(.)41 b(In)30
b(this)h(sense,)g(the)g(GRPIDn/GRPLCn)0 3563 y(k)m(eyw)m(ords)d("link")
g(the)g(mem)m(b)s(er)f(HDU)h(bac)m(k)g(to)g(its)g(Grouping)f(table.)41
b(Note)29 b(that)f(a)f(mem)m(b)s(er)g(HDU)h(need)g(not)0
3676 y(reside)i(in)g(the)g(same)g(FITS)f(\014le)i(as)f(its)g(grouping)g
(table,)h(and)e(that)i(a)f(giv)m(en)h(HDU)g(ma)m(y)g(b)s(e)e
(referenced)h(b)m(y)g(up)0 3789 y(to)h(999)h(grouping)e(tables)h(sim)m
(ultaneously)-8 b(.)0 3949 y(Grouping)22 b(tables)i(are)f(implemen)m
(ted)g(as)g(FITS)f(binary)g(tables)h(with)g(up)e(to)j(six)e
(pre-de\014ned)g(column)g(TTYPEn)0 4062 y(v)-5 b(alues:)36
b('MEMBER)p 752 4062 28 4 v 34 w(XTENSION',)20 b('MEMBER)p
1789 4062 V 33 w(NAME',)h('MEMBER)p 2620 4062 V 34 w(VERSION',)f
('MEMBER)p 3590 4062 V 34 w(POSITION',)0 4175 y('MEMBER)p
451 4175 V 34 w(URI)p 653 4175 V 32 w(TYPE')g(and)g('MEMBER)p
1601 4175 V 34 w(LOCA)-8 b(TION'.)20 b(The)f(\014rst)h(three)g(columns)
g(allo)m(w)i(mem)m(b)s(er)e(HDUs)0 4288 y(to)28 b(b)s(e)f(iden)m
(ti\014ed)g(b)m(y)g(reference)h(to)g(their)f(XTENSION,)g(EXTNAME)g(and)
g(EXTVER)g(k)m(eyw)m(ord)g(v)-5 b(alues.)40 b(The)0 4401
y(fourth)29 b(column)h(allo)m(ws)i(mem)m(b)s(er)d(HDUs)i(to)g(b)s(e)f
(iden)m(ti\014ed)g(b)m(y)g(HDU)h(p)s(osition)f(within)g(their)g(FITS)g
(\014le.)40 b(The)0 4514 y(last)f(t)m(w)m(o)g(columns)e(iden)m(tify)h
(the)g(FITS)f(\014le)h(in)f(whic)m(h)h(the)g(mem)m(b)s(er)f(HDU)h
(resides,)i(if)d(di\013eren)m(t)i(from)e(the)0 4627 y(grouping)30
b(table)h(FITS)f(\014le.)0 4787 y(Additional)25 b(user)f(de\014ned)f
("auxiliary")j(columns)e(ma)m(y)h(also)g(b)s(e)f(included)g(with)g(an)m
(y)h(grouping)f(table.)39 b(When)25 b(a)0 4900 y(grouping)i(table)i(is)
f(copied)g(or)f(mo)s(di\014ed)g(the)h(presence)g(of)f(auxiliary)i
(columns)e(is)h(alw)m(a)m(ys)h(tak)m(en)g(in)m(to)f(accoun)m(t)0
5013 y(b)m(y)j(the)g(grouping)g(supp)s(ort)f(functions;)h(ho)m(w)m(ev)m
(er,)i(the)e(grouping)g(supp)s(ort)f(functions)g(cannot)i(directly)g
(mak)m(e)0 5126 y(use)e(of)h(this)f(data.)0 5286 y(If)44
b(a)h(grouping)f(table)h(column)f(is)h(de\014ned)e(but)h(the)g(corresp)
s(onding)g(mem)m(b)s(er)f(HDU)j(information)e(is)h(un-)0
5399 y(a)m(v)-5 b(ailable)41 b(then)c(a)i(n)m(ull)f(v)-5
b(alue)39 b(of)f(the)g(appropriate)h(data)f(t)m(yp)s(e)h(is)f(inserted)
g(in)g(the)g(column)g(\014eld.)64 b(In)m(teger)0 5512
y(columns)26 b(\(MEMBER)p 811 5512 V 34 w(POSITION,)f(MEMBER)p
1771 5512 V 34 w(VERSION\))h(are)h(de\014ned)f(with)g(a)h(TNULLn)f(v)-5
b(alue)27 b(of)g(zero)0 5625 y(\(0\).)41 b(Character)27
b(\014eld)f(columns)h(\(MEMBER)p 1607 5625 V 34 w(XTENSION,)f(MEMBER)p
2600 5625 V 33 w(NAME,)i(MEMBER)p 3388 5625 V 34 w(URI)p
3590 5625 V 32 w(TYPE,)1905 5942 y(85)p eop end
%%Page: 86 94
TeXDict begin 86 93 bop 0 299 a Fj(86)1338 b Fh(CHAPTER)29
b(8.)112 b(HIERAR)m(CHICAL)30 b(GR)m(OUPING)h(R)m(OUTINES)0
555 y Fj(MEMBER)p 426 555 28 4 v 33 w(LOCA)-8 b(TION\))30
b(utilize)i(an)e(ASCI)s(I)f(n)m(ull)h(c)m(haracter)i(to)f(denote)g(a)g
(n)m(ull)f(\014eld)g(v)-5 b(alue.)0 715 y(The)23 b(grouping)g(supp)s
(ort)f(functions)h(b)s(elong)h(to)g(t)m(w)m(o)h(basic)f(categories:)40
b(those)24 b(that)h(w)m(ork)e(with)h(grouping)f(table)0
828 y(HDUs)j(\(\013gt**\))j(and)c(those)h(that)h(w)m(ork)f(with)f(mem)m
(b)s(er)h(HDUs)g(\(\013gm**\).)41 b(Tw)m(o)26 b(functions,)h(\014ts)p
3360 828 V 32 w(cop)m(y)p 3573 828 V 34 w(group\(\))0
941 y(and)40 b(\014ts)p 314 941 V 33 w(remo)m(v)m(e)p
626 941 V 34 w(group\(\),)k(ha)m(v)m(e)e(the)f(option)g(to)h(recursiv)m
(ely)f(cop)m(y/delete)j(en)m(tire)e(groups.)71 b(Care)41
b(should)0 1054 y(b)s(e)33 b(tak)m(en)h(when)f(emplo)m(ying)h(these)g
(functions)f(in)g(recursiv)m(e)h(mo)s(de)f(as)g(p)s(o)s(orly)g
(de\014ned)f(groups)h(could)g(cause)0 1167 y(unpredictable)25
b(results.)39 b(The)25 b(problem)g(of)h(a)g(grouping)f(table)i
(directly)f(or)g(indirectly)g(referencing)g(itself)g(\(th)m(us)0
1280 y(creating)41 b(an)f(in\014nite)f(lo)s(op\))i(is)e(protected)i
(against;)46 b(in)39 b(fact,)44 b(neither)39 b(function)h(will)g
(attempt)h(to)f(cop)m(y)h(or)0 1393 y(delete)32 b(an)e(HDU)h(t)m(wice.)
0 1745 y Ff(8.1)135 b(Grouping)45 b(T)-11 b(able)45 b(Routines)0
1997 y Fi(1)81 b Fj(Create)34 b(\(app)s(end\))f(a)h(grouping)f(table)i
(at)f(the)g(end)f(of)h(the)g(curren)m(t)f(FITS)g(\014le)h(p)s(oin)m
(ted)g(to)g(b)m(y)g(fptr.)49 b(The)227 2110 y(grpname)28
b(parameter)h(pro)m(vides)g(the)g(grouping)f(table)h(name)g(\(GRPNAME)g
(k)m(eyw)m(ord)g(v)-5 b(alue\))29 b(and)f(ma)m(y)227
2223 y(b)s(e)42 b(set)h(to)g(NULL)f(if)g(no)g(group)g(name)g(is)h(to)g
(b)s(e)e(sp)s(eci\014ed.)76 b(The)42 b(groupt)m(yp)s(e)g(parameter)g
(sp)s(eci\014es)227 2336 y(the)c(desired)g(structure)f(of)h(the)g
(grouping)f(table)i(and)e(ma)m(y)i(tak)m(e)g(on)f(the)g(v)-5
b(alues:)56 b(GT)p 3355 2336 V 33 w(ID)p 3490 2336 V
33 w(ALL)p 3705 2336 V 32 w(URI)227 2449 y(\(all)35 b(columns)e
(created\),)j(GT)p 1274 2449 V 33 w(ID)p 1409 2449 V
33 w(REF)d(\(ID)h(b)m(y)g(reference)g(columns\),)g(GT)p
2904 2449 V 33 w(ID)p 3039 2449 V 33 w(POS)e(\(ID)i(b)m(y)g(p)s
(osition)227 2562 y(columns\),)48 b(GT)p 801 2562 V 32
w(ID)p 935 2562 V 33 w(ALL)c(\(ID)g(b)m(y)f(reference)i(and)e(p)s
(osition)g(columns\),)48 b(GT)p 3028 2562 V 32 w(ID)p
3162 2562 V 33 w(REF)p 3383 2562 V 33 w(URI)c(\(ID)g(b)m(y)227
2674 y(reference)35 b(and)e(FITS)g(\014le)i(URI)e(columns\),)j(and)d
(GT)p 2129 2674 V 33 w(ID)p 2264 2674 V 33 w(POS)p 2481
2674 V 32 w(URI)h(\(ID)g(b)m(y)g(p)s(osition)g(and)g(FITS)f(\014le)227
2787 y(URI)e(columns\).)95 3063 y Fe(int)47 b(fits_create_group)c(/)48
b(ffgtcr)286 3176 y(\(fitsfile)e(*fptr,)g(char)g(*grpname,)g(int)h
(grouptype,)e(>)i(int)g(*status\))0 3451 y Fi(2)81 b
Fj(Create)26 b(\(insert\))g(a)f(grouping)g(table)h(just)f(after)h(the)f
(CHDU)h(of)g(the)f(curren)m(t)g(FITS)g(\014le)g(p)s(oin)m(ted)g(to)h(b)
m(y)g(fptr.)227 3564 y(All)k(HDUs)f(b)s(elo)m(w)g(the)g(the)g
(insertion)g(p)s(oin)m(t)f(will)i(b)s(e)e(shifted)g(do)m(wn)m(w)m(ards)
g(to)i(mak)m(e)g(ro)s(om)e(for)g(the)h(new)227 3677 y(HDU.)23
b(The)e(grpname)h(parameter)g(pro)m(vides)f(the)h(grouping)g(table)g
(name)g(\(GRPNAME)h(k)m(eyw)m(ord)f(v)-5 b(alue\))227
3790 y(and)25 b(ma)m(y)i(b)s(e)e(set)h(to)h(NULL)e(if)h(no)g(group)f
(name)h(is)g(to)g(b)s(e)f(sp)s(eci\014ed.)39 b(The)25
b(groupt)m(yp)s(e)h(parameter)g(sp)s(eci-)227 3903 y(\014es)g(the)h
(desired)f(structure)g(of)h(the)f(grouping)g(table)i(and)e(ma)m(y)h
(tak)m(e)h(on)e(the)h(v)-5 b(alues:)39 b(GT)p 3355 3903
V 33 w(ID)p 3490 3903 V 33 w(ALL)p 3705 3903 V 32 w(URI)227
4016 y(\(all)c(columns)e(created\),)j(GT)p 1274 4016
V 33 w(ID)p 1409 4016 V 33 w(REF)d(\(ID)h(b)m(y)g(reference)g
(columns\),)g(GT)p 2904 4016 V 33 w(ID)p 3039 4016 V
33 w(POS)e(\(ID)i(b)m(y)g(p)s(osition)227 4129 y(columns\),)29
b(GT)p 782 4129 V 33 w(ID)p 917 4129 V 33 w(ALL)f(\(ID)g(b)m(y)g
(reference)h(and)e(p)s(osition)h(columns\),)h(GT)p 2897
4129 V 33 w(ID)p 3032 4129 V 33 w(REF)p 3253 4129 V 32
w(URI)f(\(ID)h(b)m(y)f(ref-)227 4242 y(erence)g(and)e(FITS)h(\014le)g
(URI)g(columns\),)h(and)e(GT)p 1976 4242 V 33 w(ID)p
2111 4242 V 33 w(POS)p 2328 4242 V 32 w(URI)h(\(ID)g(b)m(y)g(p)s
(osition)g(and)g(FITS)f(\014le)h(URI)227 4355 y(columns\))k(.)95
4630 y Fe(int)47 b(fits_insert_group)c(/)48 b(ffgtis)286
4743 y(\(fitsfile)e(*fptr,)g(char)g(*grpname,)g(int)h(grouptype,)e(>)i
(int)g(*status\))0 5019 y Fi(3)81 b Fj(Change)20 b(the)h(structure)f
(of)h(an)g(existing)g(grouping)g(table)g(p)s(oin)m(ted)g(to)g(b)m(y)g
(gfptr.)37 b(The)20 b(groupt)m(yp)s(e)g(parameter)227
5132 y(\(see)27 b(\014ts)p 532 5132 V 32 w(create)p 800
5132 V 35 w(group\(\))e(for)h(v)-5 b(alid)26 b(parameter)g(v)-5
b(alues\))26 b(sp)s(eci\014es)g(the)f(new)g(structure)h(of)f(the)h
(grouping)227 5245 y(table.)44 b(This)30 b(function)h(only)g(adds)g(or)
g(remo)m(v)m(es)h(grouping)f(table)h(columns,)f(it)h(do)s(es)f(not)g
(add)g(or)g(delete)227 5357 y(group)26 b(mem)m(b)s(ers)f(\(i.e.,)k
(table)e(ro)m(ws\).)40 b(If)26 b(the)g(grouping)g(table)h(already)g
(has)f(the)h(desired)e(structure)h(then)227 5470 y(no)35
b(op)s(erations)f(are)h(p)s(erformed)e(and)h(function)g(simply)h
(returns)e(with)h(a)h(\(0\))g(success)g(status)g(co)s(de.)53
b(If)227 5583 y(the)32 b(requested)g(structure)g(c)m(hange)h(creates)g
(new)f(grouping)g(table)h(columns,)f(then)g(the)g(column)g(v)-5
b(alues)227 5696 y(for)30 b(all)i(existing)f(mem)m(b)s(ers)f(will)g(b)s
(e)g(\014lled)g(with)g(the)h(n)m(ull)f(v)-5 b(alues)31
b(appropriate)f(to)h(the)g(column)f(t)m(yp)s(e.)p eop
end
%%Page: 87 95
TeXDict begin 87 94 bop 0 299 a Fh(8.1.)72 b(GR)m(OUPING)31
b(T)-8 b(ABLE)31 b(R)m(OUTINES)2235 b Fj(87)95 555 y
Fe(int)47 b(fits_change_group)c(/)48 b(ffgtch)286 668
y(\(fitsfile)e(*gfptr,)f(int)i(grouptype,)e(>)j(int)f(*status\))0
905 y Fi(4)81 b Fj(Remo)m(v)m(e)41 b(the)e(group)g(de\014ned)f(b)m(y)h
(the)h(grouping)f(table)h(p)s(oin)m(ted)f(to)h(b)m(y)g(gfptr,)h(and)e
(optionally)i(all)f(the)227 1018 y(group)29 b(mem)m(b)s(er)f(HDUs.)41
b(The)28 b(rmopt)h(parameter)g(sp)s(eci\014es)g(the)g(action)h(to)g(b)s
(e)e(tak)m(en)i(for)f(all)h(mem)m(b)s(ers)227 1131 y(of)d(the)g(group)g
(de\014ned)e(b)m(y)i(the)g(grouping)g(table.)40 b(V)-8
b(alid)28 b(v)-5 b(alues)27 b(are:)40 b(OPT)p 2848 1131
28 4 v 32 w(RM)p 3030 1131 V 33 w(GPT)26 b(\(delete)j(only)e(the)227
1244 y(grouping)33 b(table\))i(and)e(OPT)p 1259 1244
V 32 w(RM)p 1441 1244 V 33 w(ALL)g(\(recursiv)m(ely)h(delete)h(all)f
(HDUs)g(that)g(b)s(elong)f(to)h(the)g(group\).)227 1357
y(An)m(y)d(groups)g(con)m(taining)i(the)e(grouping)g(table)h(gfptr)e
(as)i(a)f(mem)m(b)s(er)g(are)g(up)s(dated,)f(and)h(if)g(rmopt)g(==)227
1470 y(OPT)p 431 1470 V 32 w(RM)p 613 1470 V 33 w(GPT)21
b(all)h(mem)m(b)s(ers)f(ha)m(v)m(e)h(their)f(GRPIDn)g(and)g(GRPLCn)f(k)
m(eyw)m(ords)h(up)s(dated)f(accordingly)-8 b(.)227 1582
y(If)36 b(rmopt)g(==)g(OPT)p 985 1582 V 32 w(RM)p 1167
1582 V 33 w(ALL,)g(then)g(other)h(groups)e(that)i(con)m(tain)h(the)e
(deleted)h(mem)m(b)s(ers)f(of)g(gfptr)227 1695 y(are)31
b(up)s(dated)e(to)i(re\015ect)g(the)g(deletion)g(accordingly)-8
b(.)95 1932 y Fe(int)47 b(fits_remove_group)c(/)48 b(ffgtrm)286
2045 y(\(fitsfile)e(*gfptr,)f(int)i(rmopt,)f(>)i(int)f(*status\))0
2282 y Fi(5)81 b Fj(Cop)m(y)28 b(\(app)s(end\))g(the)h(group)f
(de\014ned)g(b)m(y)h(the)f(grouping)h(table)h(p)s(oin)m(ted)e(to)i(b)m
(y)e(infptr,)h(and)f(optionally)i(all)227 2395 y(group)g(mem)m(b)s(er)h
(HDUs,)g(to)h(the)f(FITS)f(\014le)g(p)s(oin)m(ted)h(to)h(b)m(y)e
(outfptr.)41 b(The)31 b(cp)s(opt)f(parameter)h(sp)s(eci\014es)227
2508 y(the)c(action)h(to)f(b)s(e)f(tak)m(en)h(for)g(all)g(mem)m(b)s
(ers)f(of)g(the)h(group)f(infptr.)38 b(V)-8 b(alid)28
b(v)-5 b(alues)26 b(are:)40 b(OPT)p 3443 2508 V 32 w(GCP)p
3674 2508 V 32 w(GPT)227 2621 y(\(cop)m(y)d(only)g(the)f(grouping)g
(table\))h(and)e(OPT)p 1887 2621 V 32 w(GCP)p 2118 2621
V 33 w(ALL)h(\(recursiv)m(ely)h(cop)m(y)g(ALL)e(the)i(HDUs)f(that)227
2734 y(b)s(elong)24 b(to)g(the)g(group)f(de\014ned)g(b)m(y)g(infptr\).)
38 b(If)23 b(the)h(cp)s(opt)g(==)f(OPT)p 2618 2734 V
32 w(GCP)p 2849 2734 V 32 w(GPT)h(then)f(the)h(mem)m(b)s(ers)f(of)227
2847 y(infptr)i(ha)m(v)m(e)h(their)g(GRPIDn)f(and)g(GRPLCn)g(k)m(eyw)m
(ords)h(up)s(dated)e(to)i(re\015ect)g(the)g(existence)h(of)f(the)f(new)
227 2960 y(grouping)f(table)g(outfptr,)h(since)f(they)g(no)m(w)g(b)s
(elong)g(to)g(the)g(new)g(group.)38 b(If)23 b(cp)s(opt)h(==)f(OPT)p
3460 2960 V 32 w(GCP)p 3691 2960 V 32 w(ALL)227 3073
y(then)29 b(the)g(new)g(grouping)g(table)h(outfptr)e(only)h(con)m
(tains)i(p)s(oin)m(ters)e(to)h(the)f(copied)g(mem)m(b)s(er)g(HDUs)h
(and)227 3185 y(not)38 b(the)g(original)g(mem)m(b)s(er)f(HDUs)h(of)g
(infptr.)61 b(Note)39 b(that,)h(when)d(cp)s(opt)g(==)g(OPT)p
3301 3185 V 32 w(GCP)p 3532 3185 V 33 w(ALL,)g(all)227
3298 y(mem)m(b)s(ers)h(of)h(the)f(group)g(de\014ned)f(b)m(y)i(infptr)e
(will)i(b)s(e)e(copied)i(to)g(a)g(single)g(FITS)f(\014le)h(p)s(oin)m
(ted)f(to)h(b)m(y)227 3411 y(outfptr)30 b(regardless)h(of)f(their)h
(\014le)f(distribution)g(in)g(the)h(original)g(group.)95
3648 y Fe(int)47 b(fits_copy_group)d(/)j(ffgtcp)286 3761
y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(int)i(cpopt,)f(>)h
(int)g(*status\))0 3998 y Fi(6)81 b Fj(Merge)40 b(the)f(t)m(w)m(o)h
(groups)e(de\014ned)g(b)m(y)h(the)g(grouping)g(table)g(HDUs)h(infptr)e
(and)g(outfptr)h(b)m(y)f(com)m(bining)227 4111 y(their)30
b(mem)m(b)s(ers)f(in)m(to)i(a)f(single)g(grouping)f(table.)42
b(All)30 b(mem)m(b)s(er)f(HDUs)h(\(ro)m(ws\))h(are)f(copied)g(from)f
(infptr)227 4224 y(to)f(outfptr.)39 b(If)26 b(mgopt)i(==)e(OPT)p
1419 4224 V 32 w(MR)m(G)p 1669 4224 V 34 w(COPY)g(then)g(infptr)g(con)m
(tin)m(ues)i(to)g(exist)g(unaltered)e(after)i(the)227
4337 y(merge.)57 b(If)36 b(the)f(mgopt)i(==)e(OPT)p 1474
4337 V 31 w(MR)m(G)p 1723 4337 V 34 w(MO)m(V)i(then)e(infptr)f(is)i
(deleted)h(after)f(the)g(merge.)57 b(In)35 b(b)s(oth)227
4450 y(cases,)d(the)e(GRPIDn)h(and)e(GRPLCn)h(k)m(eyw)m(ords)g(of)h
(the)g(mem)m(b)s(er)e(HDUs)i(are)g(up)s(dated)e(accordingly)-8
b(.)95 4687 y Fe(int)47 b(fits_merge_groups)c(/)48 b(ffgtmg)286
4799 y(\(fitsfile)e(*infptr,)f(fitsfile)h(*outfptr,)f(int)i(mgopt,)f(>)
h(int)g(*status\))0 5036 y Fi(7)81 b Fj("Compact")24
b(the)f(group)g(de\014ned)f(b)m(y)h(grouping)f(table)i(p)s(oin)m(ted)f
(to)h(b)m(y)f(gfptr.)38 b(The)22 b(compaction)j(is)e(ac)m(hiev)m(ed)227
5149 y(b)m(y)37 b(merging)h(\(via)g(\014ts)p 1034 5149
V 32 w(merge)p 1303 5149 V 34 w(groups\(\)\))f(all)h(direct)g(mem)m(b)s
(er)f(HDUs)g(of)h(gfptr)e(that)i(are)g(themselv)m(es)227
5262 y(grouping)i(tables.)70 b(The)40 b(cmopt)g(parameter)h(de\014nes)e
(whether)g(the)i(merged)f(grouping)f(table)i(HDUs)227
5375 y(remain)j(after)h(merging)f(\(cmopt)h(==)f(OPT)p
1852 5375 V 32 w(CMT)p 2099 5375 V 32 w(MBR\))h(or)f(if)g(they)h(are)f
(deleted)h(after)g(merging)227 5488 y(\(cmopt)31 b(==)f(OPT)p
916 5488 V 32 w(CMT)p 1163 5488 V 32 w(MBR)p 1409 5488
V 34 w(DEL\).)g(If)g(the)h(grouping)e(table)j(con)m(tains)f(no)f
(direct)h(mem)m(b)s(er)e(HDUs)227 5601 y(that)i(are)f(themselv)m(es)h
(grouping)e(tables)i(then)e(this)h(function)f(do)s(es)h(nothing.)40
b(Note)31 b(that)g(this)e(function)227 5714 y(is)i(not)f(recursiv)m(e,)
h(i.e.,)h(only)f(the)f(direct)h(mem)m(b)s(er)f(HDUs)h(of)f(gfptr)g(are)
h(considered)f(for)g(merging.)p eop end
%%Page: 88 96
TeXDict begin 88 95 bop 0 299 a Fj(88)1338 b Fh(CHAPTER)29
b(8.)112 b(HIERAR)m(CHICAL)30 b(GR)m(OUPING)h(R)m(OUTINES)95
555 y Fe(int)47 b(fits_compact_group)c(/)48 b(ffgtcm)286
668 y(\(fitsfile)e(*gfptr,)f(int)i(cmopt,)f(>)i(int)f(*status\))0
945 y Fi(8)81 b Fj(V)-8 b(erify)21 b(the)h(in)m(tegrit)m(y)h(of)e(the)g
(grouping)g(table)h(p)s(oin)m(ted)f(to)h(b)m(y)f(gfptr)g(to)h(mak)m(e)g
(sure)e(that)i(all)g(group)f(mem)m(b)s(ers)227 1058 y(are)31
b(accessible)i(and)d(that)h(all)g(links)g(to)g(other)g(grouping)f
(tables)i(are)f(v)-5 b(alid.)42 b(The)30 b(\014rstfailed)g(parameter)
227 1171 y(returns)c(the)i(mem)m(b)s(er)e(ID)h(\(ro)m(w)h(n)m(um)m(b)s
(er\))e(of)i(the)f(\014rst)f(mem)m(b)s(er)h(HDU)h(to)g(fail)g(v)m
(eri\014cation)g(\(if)g(p)s(ositiv)m(e)227 1284 y(v)-5
b(alue\))36 b(or)e(the)h(\014rst)e(group)h(link)g(to)i(fail)f(\(if)f
(negativ)m(e)j(v)-5 b(alue\).)54 b(If)34 b(gfptr)g(is)g(successfully)h
(v)m(eri\014ed)f(then)227 1397 y(\014rstfailed)d(con)m(tains)g(a)g
(return)e(v)-5 b(alue)31 b(of)g(0.)95 1673 y Fe(int)47
b(fits_verify_group)c(/)48 b(ffgtvf)286 1786 y(\(fitsfile)e(*gfptr,)f
(>)j(long)f(*firstfailed,)d(int)j(*status\))0 2063 y
Fi(9)81 b Fj(Op)s(en)23 b(a)j(grouping)f(table)h(that)g(con)m(tains)g
(the)g(mem)m(b)s(er)e(HDU)i(p)s(oin)m(ted)f(to)h(b)m(y)f(mfptr.)38
b(The)25 b(grouping)g(table)227 2176 y(to)39 b(op)s(en)e(is)h
(de\014ned)f(b)m(y)h(the)g(grpid)f(parameter,)j(whic)m(h)e(con)m(tains)
h(the)f(k)m(eyw)m(ord)h(index)e(v)-5 b(alue)39 b(of)f(the)227
2289 y(GRPIDn/GRPLCn)d(k)m(eyw)m(ord\(s\))g(that)h(link)f(the)g(mem)m
(b)s(er)f(HDU)h(mfptr)f(to)i(the)f(grouping)f(table.)55
b(If)227 2402 y(the)30 b(grouping)f(table)h(resides)f(in)h(a)f(\014le)h
(other)f(than)h(the)f(mem)m(b)s(er)g(HDUs)h(\014le)f(then)g(an)h
(attempt)g(is)g(\014rst)227 2515 y(made)f(to)h(op)s(en)e(the)h(\014le)g
(readwrite,)h(and)e(failing)i(that)g(readonly)-8 b(.)40
b(A)29 b(p)s(oin)m(ter)g(to)h(the)f(op)s(ened)f(grouping)227
2628 y(table)k(HDU)f(is)f(returned)f(in)h(gfptr.)227
2786 y(Note)35 b(that)g(it)f(is)g(p)s(ossible,)g(although)h(unlik)m
(ely)f(and)f(undesirable,)h(for)g(the)g(GRPIDn/GRPLCn)f(k)m(ey-)227
2899 y(w)m(ords)k(in)g(a)g(mem)m(b)s(er)g(HDU)h(header)f(to)h(b)s(e)e
(non-con)m(tin)m(uous,)k(e.g.,)g(GRPID1,)g(GRPID2,)g(GRPID5,)227
3012 y(GRPID6.)i(In)29 b(suc)m(h)g(cases,)i(the)f(grpid)f(index)g(v)-5
b(alue)31 b(sp)s(eci\014ed)e(in)g(the)h(function)f(call)j(shall)e(iden)
m(tify)g(the)227 3125 y(\(grpid\)th)36 b(GRPID)f(v)-5
b(alue.)57 b(In)34 b(the)i(ab)s(o)m(v)m(e)h(example,)g(if)f(grpid)e(==)
h(3,)j(then)d(the)g(group)g(sp)s(eci\014ed)g(b)m(y)227
3238 y(GRPID5)c(w)m(ould)g(b)s(e)e(op)s(ened.)95 3515
y Fe(int)47 b(fits_open_group)d(/)j(ffgtop)286 3628 y(\(fitsfile)f
(*mfptr,)f(int)i(group,)f(>)i(fitsfile)d(**gfptr,)h(int)h(*status\))0
3905 y Fi(10)f Fj(Add)38 b(a)h(mem)m(b)s(er)f(HDU)i(to)f(an)g(existing)
g(grouping)g(table)h(p)s(oin)m(ted)e(to)i(b)m(y)e(gfptr.)66
b(The)38 b(mem)m(b)s(er)g(HDU)227 4017 y(ma)m(y)30 b(either)g(b)s(e)f
(p)s(oin)m(ted)g(to)h(mfptr)f(\(whic)m(h)g(m)m(ust)h(b)s(e)e(p)s
(ositioned)i(to)g(the)f(mem)m(b)s(er)g(HDU\))i(or,)f(if)f(mfptr)227
4130 y(==)36 b(NULL,)g(iden)m(ti\014ed)g(b)m(y)g(the)g(hdup)s(os)e
(parameter)i(\(the)h(HDU)g(p)s(osition)f(n)m(um)m(b)s(er,)g(Primary)f
(arra)m(y)227 4243 y(==)f(1\))i(if)f(b)s(oth)f(the)h(grouping)g(table)g
(and)g(the)g(mem)m(b)s(er)f(HDU)h(reside)g(in)g(the)g(same)g(FITS)f
(\014le.)54 b(The)227 4356 y(new)27 b(mem)m(b)s(er)f(HDU)h(shall)g(ha)m
(v)m(e)h(the)f(appropriate)g(GRPIDn)f(and)g(GRPLCn)g(k)m(eyw)m(ords)h
(created)h(in)f(its)227 4469 y(header.)44 b(Note)33 b(that)f(if)g(the)g
(mem)m(b)s(er)e(HDU)j(is)e(already)h(a)g(mem)m(b)s(er)f(of)h(the)g
(group)f(then)g(it)h(will)g(not)g(b)s(e)227 4582 y(added)e(a)h(second)f
(time.)95 4859 y Fe(int)47 b(fits_add_group_member)42
b(/)48 b(ffgtam)286 4972 y(\(fitsfile)e(*gfptr,)f(fitsfile)h(*mfptr,)g
(int)h(hdupos,)f(>)h(int)g(*status\))0 5325 y Ff(8.2)135
b(Group)45 b(Mem)l(b)t(er)f(Routines)0 5578 y Fi(1)81
b Fj(Return)29 b(the)h(n)m(um)m(b)s(er)f(of)i(mem)m(b)s(er)e(HDUs)i(in)
f(a)h(grouping)e(table)j(gfptr.)40 b(The)30 b(n)m(um)m(b)s(er)e(mem)m
(b)s(er)i(HDUs)h(is)227 5691 y(just)f(the)h(NAXIS2)f(v)-5
b(alue)31 b(\(n)m(um)m(b)s(er)f(of)g(ro)m(ws\))h(of)f(the)h(grouping)f
(table.)p eop end
%%Page: 89 97
TeXDict begin 89 96 bop 0 299 a Fh(8.2.)72 b(GR)m(OUP)31
b(MEMBER)g(R)m(OUTINES)2295 b Fj(89)95 555 y Fe(int)47
b(fits_get_num_members)c(/)k(ffgtnm)286 668 y(\(fitsfile)f(*gfptr,)f(>)
j(long)f(*nmembers,)e(int)h(*status\))0 945 y Fi(2)81
b Fj(Return)34 b(the)h(n)m(um)m(b)s(er)f(of)i(groups)e(to)i(whic)m(h)f
(the)g(HDU)h(p)s(oin)m(ted)f(to)h(b)m(y)f(mfptr)f(is)i(link)m(ed,)h(as)
e(de\014ned)f(b)m(y)227 1058 y(the)27 b(n)m(um)m(b)s(er)f(of)h
(GRPIDn/GRPLCn)f(k)m(eyw)m(ord)i(records)e(that)i(app)s(ear)e(in)g(its)
i(header.)39 b(Note)28 b(that)g(eac)m(h)227 1171 y(time)37
b(this)g(function)f(is)g(called,)k(the)c(indices)h(of)g(the)f
(GRPIDn/GRPLCn)g(k)m(eyw)m(ords)h(are)g(c)m(hec)m(k)m(ed)h(to)227
1284 y(mak)m(e)29 b(sure)e(they)g(are)h(con)m(tin)m(uous)g(\(ie)h(no)e
(gaps\))h(and)f(are)h(re-en)m(umerated)g(to)h(eliminate)g(gaps)f(if)f
(found.)95 1674 y Fe(int)47 b(fits_get_num_groups)c(/)k(ffgmng)286
1787 y(\(fitsfile)f(*mfptr,)f(>)j(long)f(*nmembers,)e(int)h(*status\))0
2063 y Fi(3)81 b Fj(Op)s(en)26 b(a)i(mem)m(b)s(er)f(of)h(the)f
(grouping)h(table)g(p)s(oin)m(ted)g(to)g(b)m(y)g(gfptr.)39
b(The)27 b(mem)m(b)s(er)g(to)i(op)s(en)e(is)g(iden)m(ti\014ed)h(b)m(y)
227 2176 y(its)i(ro)m(w)g(n)m(um)m(b)s(er)e(within)h(the)g(grouping)h
(table)g(as)g(giv)m(en)g(b)m(y)g(the)f(parameter)h('mem)m(b)s(er')f
(\(\014rst)h(mem)m(b)s(er)227 2289 y(==)g(1\))g(.)41
b(A)30 b(\014ts\014le)f(p)s(oin)m(ter)h(to)h(the)f(op)s(ened)f(mem)m(b)
s(er)g(HDU)i(is)f(returned)f(as)h(mfptr.)39 b(Note)31
b(that)g(if)f(the)227 2402 y(mem)m(b)s(er)e(HDU)h(resides)g(in)f(a)h
(FITS)f(\014le)g(di\013eren)m(t)h(from)f(the)h(grouping)f(table)h(HDU)h
(then)e(the)h(mem)m(b)s(er)227 2515 y(\014le)i(is)f(\014rst)g(op)s
(ened)f(readwrite)i(and,)f(failing)h(this,)g(op)s(ened)e(readonly)-8
b(.)95 2792 y Fe(int)47 b(fits_open_member)d(/)j(ffgmop)286
2905 y(\(fitsfile)f(*gfptr,)f(long)i(member,)f(>)h(fitsfile)f(**mfptr,)
f(int)i(*status\))0 3182 y Fi(4)81 b Fj(Cop)m(y)27 b(\(app)s(end\))f(a)
i(mem)m(b)s(er)f(HDU)h(of)f(the)h(grouping)e(table)j(p)s(oin)m(ted)e
(to)h(b)m(y)f(gfptr.)39 b(The)27 b(mem)m(b)s(er)g(HDU)h(is)227
3295 y(iden)m(ti\014ed)33 b(b)m(y)g(its)h(ro)m(w)f(n)m(um)m(b)s(er)e
(within)i(the)g(grouping)g(table)g(as)h(giv)m(en)g(b)m(y)e(the)i
(parameter)f('mem)m(b)s(er')227 3408 y(\(\014rst)j(mem)m(b)s(er)f(==)g
(1\).)58 b(The)35 b(cop)m(y)i(of)f(the)g(group)f(mem)m(b)s(er)g(HDU)i
(will)f(b)s(e)f(app)s(ended)f(to)j(the)f(FITS)227 3521
y(\014le)29 b(p)s(oin)m(ted)g(to)g(b)m(y)f(mfptr,)h(and)f(up)s(on)f
(return)g(mfptr)h(shall)h(p)s(oin)m(t)f(to)i(the)f(copied)g(mem)m(b)s
(er)f(HDU.)h(The)227 3633 y(cp)s(opt)e(parameter)h(ma)m(y)g(tak)m(e)h
(on)e(the)g(follo)m(wing)i(v)-5 b(alues:)40 b(OPT)p 2465
3633 28 4 v 32 w(MCP)p 2708 3633 V 32 w(ADD)29 b(whic)m(h)e(adds)f(a)i
(new)f(en)m(try)227 3746 y(in)d(gfptr)g(for)f(the)i(copied)f(mem)m(b)s
(er)g(HDU,)h(OPT)p 1907 3746 V 31 w(MCP)p 2149 3746 V
33 w(NADD)g(whic)m(h)f(do)s(es)g(not)g(add)f(an)h(en)m(try)h(in)e
(gfptr)227 3859 y(for)i(the)h(copied)f(mem)m(b)s(er,)h(and)f(OPT)p
1536 3859 V 32 w(MCP)p 1779 3859 V 32 w(REPL)g(whic)m(h)g(replaces)h
(the)f(original)h(mem)m(b)s(er)f(en)m(try)g(with)227
3972 y(the)31 b(copied)g(mem)m(b)s(er)e(en)m(try)-8 b(.)95
4249 y Fe(int)47 b(fits_copy_member)d(/)j(ffgmcp)286
4362 y(\(fitsfile)f(*gfptr,)f(fitsfile)h(*mfptr,)g(long)g(member,)g
(int)h(cpopt,)f(>)i(int)f(*status\))0 4639 y Fi(5)81
b Fj(T)-8 b(ransfer)34 b(a)i(group)f(mem)m(b)s(er)f(HDU)i(from)f(the)h
(grouping)f(table)h(p)s(oin)m(ted)f(to)h(b)m(y)f(infptr)g(to)h(the)f
(grouping)227 4752 y(table)i(p)s(oin)m(ted)f(to)h(b)m(y)f(outfptr.)58
b(The)35 b(mem)m(b)s(er)h(HDU)h(to)f(transfer)g(is)g(iden)m(ti\014ed)g
(b)m(y)g(its)h(ro)m(w)f(n)m(um)m(b)s(er)227 4865 y(within)42
b(infptr)f(as)i(sp)s(eci\014ed)f(b)m(y)g(the)h(parameter)g('mem)m(b)s
(er')f(\(\014rst)g(mem)m(b)s(er)g(==)f(1\).)78 b(If)42
b(tfopt)h(==)227 4978 y(OPT)p 431 4978 V 32 w(MCP)p 674
4978 V 33 w(ADD)26 b(then)f(the)h(mem)m(b)s(er)e(HDU)i(is)g(made)f(a)h
(mem)m(b)s(er)f(of)g(outfptr)g(and)g(remains)g(a)h(mem)m(b)s(er)227
5091 y(of)34 b(infptr.)51 b(If)34 b(tfopt)g(==)g(OPT)p
1339 5091 V 32 w(MCP)p 1582 5091 V 32 w(MO)m(V)h(then)f(the)g(mem)m(b)s
(er)f(HDU)i(is)f(deleted)h(from)e(infptr)g(after)227
5204 y(the)e(transfer)f(to)h(outfptr.)95 5480 y Fe(int)47
b(fits_transfer_member)c(/)k(ffgmtf)286 5593 y(\(fitsfile)f(*infptr,)f
(fitsfile)h(*outfptr,)f(long)i(member,)e(int)i(tfopt,)334
5706 y(>)h(int)e(*status\))p eop end
%%Page: 90 98
TeXDict begin 90 97 bop 0 299 a Fj(90)1338 b Fh(CHAPTER)29
b(8.)112 b(HIERAR)m(CHICAL)30 b(GR)m(OUPING)h(R)m(OUTINES)0
555 y Fi(6)81 b Fj(Remo)m(v)m(e)31 b(a)e(mem)m(b)s(er)g(HDU)h(from)f
(the)h(grouping)f(table)h(p)s(oin)m(ted)f(to)h(b)m(y)g(gfptr.)40
b(The)29 b(mem)m(b)s(er)f(HDU)i(to)h(b)s(e)227 668 y(deleted)37
b(is)e(iden)m(ti\014ed)h(b)m(y)f(its)h(ro)m(w)g(n)m(um)m(b)s(er)f(in)g
(the)h(grouping)f(table)h(as)g(sp)s(eci\014ed)f(b)m(y)h(the)f
(parameter)227 781 y('mem)m(b)s(er')41 b(\(\014rst)g(mem)m(b)s(er)g(==)
f(1\).)74 b(The)41 b(rmopt)g(parameter)h(ma)m(y)f(tak)m(e)i(on)e(the)h
(follo)m(wing)g(v)-5 b(alues:)227 894 y(OPT)p 431 894
28 4 v 32 w(RM)p 613 894 V 33 w(ENTR)d(Y)34 b(whic)m(h)e(remo)m(v)m(es)
j(the)e(mem)m(b)s(er)g(HDU)h(en)m(try)f(from)g(the)g(grouping)g(table)h
(and)f(up-)227 1007 y(dates)40 b(the)f(mem)m(b)s(er's)f(GRPIDn/GRPLCn)g
(k)m(eyw)m(ords,)k(and)c(OPT)p 2687 1007 V 32 w(RM)p
2869 1007 V 33 w(MBR)h(whic)m(h)g(remo)m(v)m(es)h(the)227
1120 y(mem)m(b)s(er)30 b(HDU)h(en)m(try)g(from)f(the)g(grouping)g
(table)i(and)d(deletes)j(the)e(mem)m(b)s(er)g(HDU)h(itself.)95
1380 y Fe(int)47 b(fits_remove_member)c(/)48 b(ffgmrm)286
1492 y(\(fitsfile)e(*fptr,)g(long)g(member,)g(int)h(rmopt,)f(>)i(int)f
(*status\))p eop end
%%Page: 91 99
TeXDict begin 91 98 bop 0 1225 a Fg(Chapter)65 b(9)0
1687 y Fm(Sp)6 b(ecialized)77 b(CFITSIO)f(In)-6 b(terface)0
1937 y(Routines)0 2429 y Fj(The)28 b(basic)h(in)m(terface)i(routines)e
(describ)s(ed)e(previously)i(are)g(recommended)f(for)h(most)g(uses,)g
(but)f(the)h(routines)0 2542 y(describ)s(ed)h(in)g(this)h(c)m(hapter)g
(are)h(also)f(a)m(v)-5 b(ailable)34 b(if)c(necessary)-8
b(.)43 b(Some)31 b(of)g(these)g(routines)g(p)s(erform)e(more)i(sp)s(e-)
0 2655 y(cialized)e(function)d(that)i(cannot)f(easily)h(b)s(e)e(done)h
(with)f(the)h(basic)h(in)m(terface)g(routines)f(while)f(others)h
(duplicate)0 2767 y(the)j(functionalit)m(y)i(of)e(the)g(basic)h
(routines)f(but)f(ha)m(v)m(e)i(a)g(sligh)m(tly)g(di\013eren)m(t)g
(calling)g(sequence.)41 b(See)31 b(App)s(endix)0 2880
y(B)g(for)f(the)g(de\014nition)g(of)h(eac)m(h)h(function)e(parameter.)0
3210 y Ff(9.1)135 b(FITS)44 b(File)i(Access)e(Routines)0
3446 y Fi(1)81 b Fj(Op)s(en)37 b(an)i(existing)i(FITS)d(\014le)h
(residing)g(in)g(core)h(computer)f(memory)-8 b(.)68 b(This)38
b(routine)h(is)h(analogous)g(to)227 3559 y(\014ts)p 354
3559 28 4 v 33 w(op)s(en)p 577 3559 V 32 w(\014le.)55
b(The)35 b('\014lename')g(is)g(curren)m(tly)h(ignored)f(b)m(y)g(this)g
(routine)g(and)g(ma)m(y)g(b)s(e)g(an)m(y)g(arbitrary)227
3672 y(string.)78 b(In)42 b(general,)47 b(the)c(application)h(m)m(ust)f
(ha)m(v)m(e)h(preallo)s(cated)g(an)e(initial)i(blo)s(c)m(k)g(of)f
(memory)f(to)227 3785 y(hold)i(the)h(FITS)f(\014le)h(prior)f(to)h
(calling)h(this)e(routine:)70 b('memptr')44 b(p)s(oin)m(ts)g(to)i(the)e
(starting)i(address)227 3898 y(and)39 b('memsize')i(giv)m(es)g(the)f
(initial)h(size)f(of)g(the)g(blo)s(c)m(k)g(of)g(memory)-8
b(.)69 b('mem)p 2958 3898 V 33 w(reallo)s(c')41 b(is)f(a)g(p)s(oin)m
(ter)f(to)227 4011 y(an)c(optional)i(function)d(that)i(CFITSIO)e(can)h
(call)h(to)g(allo)s(cate)i(additional)e(memory)-8 b(,)37
b(if)e(needed)f(\(only)227 4124 y(if)41 b(mo)s(de)e(=)h(READ)m
(WRITE\),)i(and)e(is)g(mo)s(deled)g(after)h(the)f(standard)g(C)g
('reallo)s(c')i(function;)j(a)c(n)m(ull)227 4237 y(p)s(oin)m(ter)g(ma)m
(y)g(b)s(e)f(giv)m(en)i(if)e(the)h(initial)h(allo)s(cation)h(of)e
(memory)f(is)h(all)g(that)g(will)g(b)s(e)f(required)g(\(e.g.,)227
4350 y(if)35 b(the)g(\014le)g(is)g(op)s(ened)f(with)h(mo)s(de)f(=)h
(READONL)-8 b(Y\).)36 b(The)e('deltasize')j(parameter)e(ma)m(y)h(b)s(e)
e(used)g(to)227 4463 y(suggest)g(a)f(minim)m(um)f(amoun)m(t)h(of)g
(additional)h(memory)f(that)g(should)f(b)s(e)g(allo)s(cated)j(during)d
(eac)m(h)i(call)227 4575 y(to)d(the)f(memory)f(reallo)s(cation)j
(function.)40 b(By)30 b(default,)g(CFITSIO)e(will)i(reallo)s(cate)j
(enough)c(additional)227 4688 y(space)44 b(to)g(hold)f(the)h(en)m(tire)
g(curren)m(tly)f(de\014ned)g(FITS)f(\014le)i(\(as)f(giv)m(en)i(b)m(y)e
(the)h(NAXISn)e(k)m(eyw)m(ords\))227 4801 y(or)g(1)f(FITS)g(blo)s(c)m
(k)h(\(=)f(2880)i(b)m(ytes\),)i(whic)m(h)d(ev)m(er)g(is)f(larger.)74
b(V)-8 b(alues)43 b(of)e(deltasize)i(less)f(than)f(2880)227
4914 y(will)31 b(b)s(e)f(ignored.)42 b(Since)31 b(the)g(memory)g
(reallo)s(cation)i(op)s(eration)e(can)g(b)s(e)f(computationally)i(exp)s
(ensiv)m(e,)227 5027 y(allo)s(cating)27 b(a)e(larger)g(initial)h(blo)s
(c)m(k)f(of)g(memory)-8 b(,)26 b(and/or)f(sp)s(ecifying)f(a)h(larger)h
(deltasize)g(v)-5 b(alue)25 b(ma)m(y)g(help)227 5140
y(to)i(reduce)f(the)g(n)m(um)m(b)s(er)e(of)i(reallo)s(cation)i(calls)f
(and)f(mak)m(e)h(the)f(application)h(program)f(run)e(faster.)40
b(Note)227 5253 y(that)29 b(v)-5 b(alues)29 b(of)f(the)h(memptr)f(and)f
(memsize)j(p)s(oin)m(ters)e(will)h(b)s(e)e(up)s(dated)g(b)m(y)i
(CFITSIO)d(if)j(the)f(lo)s(cation)227 5366 y(or)j(size)g(of)f(the)h
(FITS)f(\014le)g(in)g(memory)g(should)g(c)m(hange)h(as)g(a)g(result)f
(of)g(allo)s(cating)j(more)e(memory)-8 b(.)95 5601 y
Fe(int)47 b(fits_open_memfile)c(/)48 b(ffomem)286 5714
y(\(fitsfile)e(**fptr,)f(const)i(char)f(*filename,)f(int)i(mode,)g
(void)f(**memptr,)1905 5942 y Fj(91)p eop end
%%Page: 92 100
TeXDict begin 92 99 bop 0 299 a Fj(92)1003 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)334 555 y Fe(size_t)46 b(*memsize,)f(size_t)i(deltasize,)
334 668 y(void)g(*\(*mem_realloc\)\(void)42 b(*p,)47
b(size_t)f(newsize\),)f(int)i(*status\))0 927 y Fi(2)81
b Fj(Create)49 b(a)g(new)f(FITS)g(\014le)h(residing)f(in)h(core)g
(computer)g(memory)-8 b(.)96 b(This)48 b(routine)g(is)h(analogous)h(to)
227 1040 y(\014ts)p 354 1040 28 4 v 33 w(create)p 623
1040 V 34 w(\014le.)40 b(In)29 b(general,)i(the)e(application)h(m)m
(ust)f(ha)m(v)m(e)i(preallo)s(cated)g(an)e(initial)h(blo)s(c)m(k)g(of)f
(memory)227 1152 y(to)38 b(hold)e(the)h(FITS)f(\014le)h(prior)f(to)h
(calling)i(this)d(routine:)54 b('memptr')36 b(p)s(oin)m(ts)h(to)g(the)g
(starting)h(address)227 1265 y(and)h('memsize')i(giv)m(es)g(the)f
(initial)h(size)f(of)g(the)g(blo)s(c)m(k)g(of)g(memory)-8
b(.)69 b('mem)p 2958 1265 V 33 w(reallo)s(c')41 b(is)f(a)g(p)s(oin)m
(ter)f(to)227 1378 y(an)f(optional)g(function)f(that)h(CFITSIO)e(can)i
(call)h(to)f(allo)s(cate)i(additional)e(memory)-8 b(,)40
b(if)d(needed,)j(and)227 1491 y(is)34 b(mo)s(deled)f(after)h(the)g
(standard)f(C)g('reallo)s(c')i(function;)g(a)f(n)m(ull)f(p)s(oin)m(ter)
h(ma)m(y)g(b)s(e)f(giv)m(en)h(if)g(the)g(initial)227
1604 y(allo)s(cation)i(of)d(memory)g(is)h(all)g(that)g(will)f(b)s(e)g
(required.)48 b(The)33 b('deltasize')j(parameter)d(ma)m(y)h(b)s(e)f
(used)f(to)227 1717 y(suggest)i(a)f(minim)m(um)f(amoun)m(t)h(of)g
(additional)h(memory)f(that)g(should)f(b)s(e)g(allo)s(cated)j(during)d
(eac)m(h)i(call)227 1830 y(to)d(the)f(memory)f(reallo)s(cation)j
(function.)40 b(By)30 b(default,)g(CFITSIO)e(will)i(reallo)s(cate)j
(enough)c(additional)227 1943 y(space)41 b(to)g(hold)e(1)i(FITS)e(blo)s
(c)m(k)h(\(=)g(2880)i(b)m(ytes\))f(and)e(v)-5 b(alues)41
b(of)f(deltasize)h(less)g(than)f(2880)h(will)g(b)s(e)227
2056 y(ignored.)f(Since)28 b(the)f(memory)h(reallo)s(cation)i(op)s
(eration)e(can)g(b)s(e)f(computationally)i(exp)s(ensiv)m(e,)g(allo)s
(cat-)227 2169 y(ing)36 b(a)f(larger)h(initial)h(blo)s(c)m(k)e(of)h
(memory)-8 b(,)37 b(and/or)e(sp)s(ecifying)g(a)h(larger)g(deltasize)h
(v)-5 b(alue)36 b(ma)m(y)f(help)g(to)227 2282 y(reduce)f(the)g(n)m(um)m
(b)s(er)e(of)i(reallo)s(cation)i(calls)f(and)e(mak)m(e)i(the)f
(application)h(program)f(run)e(faster.)52 b(Note)227
2395 y(that)29 b(v)-5 b(alues)29 b(of)f(the)h(memptr)f(and)f(memsize)j
(p)s(oin)m(ters)e(will)h(b)s(e)e(up)s(dated)g(b)m(y)i(CFITSIO)d(if)j
(the)f(lo)s(cation)227 2507 y(or)j(size)g(of)f(the)h(FITS)f(\014le)g
(in)g(memory)g(should)g(c)m(hange)h(as)g(a)g(result)f(of)g(allo)s
(cating)j(more)e(memory)-8 b(.)95 2766 y Fe(int)47 b
(fits_create_memfile)c(/)k(ffimem)286 2879 y(\(fitsfile)f(**fptr,)f
(void)i(**memptr,)334 2992 y(size_t)f(*memsize,)f(size_t)i(deltasize,)
334 3105 y(void)g(*\(*mem_realloc\)\(void)42 b(*p,)47
b(size_t)f(newsize\),)f(int)i(*status\))0 3363 y Fi(3)81
b Fj(Reop)s(en)34 b(a)i(FITS)e(\014le)h(that)h(w)m(as)f(previously)g
(op)s(ened)g(with)f(\014ts)p 2414 3363 V 33 w(op)s(en)p
2637 3363 V 32 w(\014le)h(or)g(\014ts)p 3058 3363 V 33
w(create)p 3327 3363 V 34 w(\014le.)55 b(The)34 b(new)227
3476 y(\014ts\014le)i(p)s(oin)m(ter)h(ma)m(y)g(then)f(b)s(e)f(treated)j
(as)e(a)h(separate)g(\014le,)h(and)e(one)h(ma)m(y)g(sim)m(ultaneously)g
(read)f(or)227 3589 y(write)e(to)h(2)f(\(or)g(more\))g(di\013eren)m(t)g
(extensions)g(in)g(the)g(same)g(\014le.)51 b(The)33 b(\014ts)p
2886 3589 V 32 w(op)s(en)p 3108 3589 V 32 w(\014le)h(routine)g(\(ab)s
(o)m(v)m(e\))227 3702 y(automatically)k(detects)f(cases)f(where)e(a)i
(previously)f(op)s(ened)f(\014le)i(is)f(b)s(eing)g(op)s(ened)f(again,)k
(and)c(then)227 3815 y(in)m(ternally)e(call)f(\014ts)p
930 3815 V 33 w(reop)s(en)p 1229 3815 V 32 w(\014le,)g(so)f(programs)g
(should)g(rarely)g(need)g(to)h(explicitly)h(call)g(this)e(routine.)95
4073 y Fe(int)47 b(fits_reopen_file)d(/)j(ffreopen)286
4186 y(\(fitsfile)f(*openfptr,)f(fitsfile)g(**newfptr,)g(>)j(int)f
(*status\))0 4445 y Fi(4)81 b Fj(Create)24 b(a)g(new)f(FITS)g(\014le,)i
(using)e(a)h(template)h(\014le)e(to)i(de\014ne)d(its)i(initial)h(size)g
(and)e(structure.)37 b(The)24 b(template)227 4558 y(ma)m(y)i(b)s(e)f
(another)g(FITS)g(HDU)h(or)f(an)g(ASCI)s(I)f(template)j(\014le.)39
b(If)25 b(the)g(input)g(template)h(\014le)g(name)f(p)s(oin)m(ter)227
4671 y(is)j(n)m(ull,)h(then)e(this)h(routine)f(b)s(eha)m(v)m(es)i(the)f
(same)g(as)g(\014ts)p 2160 4671 V 32 w(create)p 2428
4671 V 35 w(\014le.)40 b(The)27 b(curren)m(tly)h(supp)s(orted)e(format)
227 4784 y(of)33 b(the)g(ASCI)s(I)e(template)j(\014le)e(is)h(describ)s
(ed)e(under)g(the)i(\014ts)p 2350 4784 V 33 w(parse)p
2591 4784 V 32 w(template)h(routine)f(\(in)f(the)h(general)227
4897 y(Utilities)g(section\))95 5155 y Fe(int)47 b
(fits_create_template)c(/)k(fftplt)286 5268 y(\(fitsfile)f(**fptr,)f
(char)i(*filename,)e(char)i(*tpltfile)e(>)i(int)g(*status\))0
5527 y Fi(5)81 b Fj(P)m(arse)31 b(the)f(input)g(\014lename)g(or)g(URL)h
(in)m(to)g(its)g(comp)s(onen)m(t)f(parts,)h(namely:)336
5714 y Fc(\017)46 b Fj(the)31 b(\014le)f(t)m(yp)s(e)h(\(\014le://,)h
(ftp://,)f(h)m(ttp://,)h(etc\),)p eop end
%%Page: 93 101
TeXDict begin 93 100 bop 0 299 a Fh(9.1.)72 b(FITS)30
b(FILE)g(A)m(CCESS)f(R)m(OUTINES)2244 b Fj(93)336 555
y Fc(\017)46 b Fj(the)31 b(base)f(input)g(\014le)g(name,)336
702 y Fc(\017)46 b Fj(the)31 b(name)f(of)h(the)f(output)g(\014le)h
(that)g(the)f(input)g(\014le)g(is)h(to)g(b)s(e)e(copied)i(to)g(prior)f
(to)h(op)s(ening,)336 848 y Fc(\017)46 b Fj(the)31 b(HDU)g(or)f
(extension)h(sp)s(eci\014cation,)336 995 y Fc(\017)46
b Fj(the)31 b(\014ltering)f(sp)s(eci\014er,)336 1141
y Fc(\017)46 b Fj(the)31 b(binning)e(sp)s(eci\014er,)336
1288 y Fc(\017)46 b Fj(the)31 b(column)f(sp)s(eci\014er,)336
1434 y Fc(\017)46 b Fj(and)30 b(the)h(image)g(pixel)g(\014ltering)g(sp)
s(eci\014er.)227 1623 y(A)k(n)m(ull)g(p)s(oin)m(ter)f(\(0\))i(ma)m(y)g
(b)s(e)e(b)s(e)g(sp)s(eci\014ed)g(for)g(an)m(y)h(of)g(the)g(output)g
(string)f(argumen)m(ts)h(that)h(are)f(not)227 1736 y(needed.)52
b(Null)34 b(strings)g(will)g(b)s(e)g(returned)f(for)h(an)m(y)g(comp)s
(onen)m(ts)g(that)h(are)f(not)h(presen)m(t)f(in)g(the)g(input)227
1849 y(\014le)28 b(name.)39 b(The)27 b(calling)i(routine)e(m)m(ust)g
(allo)s(cate)j(su\016cien)m(t)d(memory)g(to)h(hold)f(the)g(returned)f
(c)m(haracter)227 1962 y(strings.)52 b(Allo)s(cating)37
b(the)d(string)g(lengths)h(equal)g(to)g(FLEN)p 2362 1962
28 4 v 33 w(FILENAME)f(is)g(guaran)m(teed)i(to)f(b)s(e)e(safe.)227
2075 y(These)d(routines)h(are)f(mainly)h(for)f(in)m(ternal)h(use)f(b)m
(y)h(other)f(CFITSIO)f(routines.)95 2335 y Fe(int)47
b(fits_parse_input_url)c(/)k(ffiurl)286 2448 y(\(char)g(*filename,)e(>)
i(char)g(*filetype,)e(char)h(*infile,)g(char)h(*outfile,)e(char)334
2561 y(*extspec,)g(char)i(*filter,)f(char)g(*binspec,)f(char)i
(*colspec,)e(int)i(*status\))95 2787 y(int)g(fits_parse_input_filename)
41 b(/)48 b(ffifile)286 2900 y(\(char)f(*filename,)e(>)i(char)g
(*filetype,)e(char)h(*infile,)g(char)h(*outfile,)e(char)334
3013 y(*extspec,)g(char)i(*filter,)f(char)g(*binspec,)f(char)i
(*colspec,)e(char)i(*pixspec,)334 3125 y(int)g(*status\))0
3386 y Fi(6)81 b Fj(P)m(arse)33 b(the)f(input)g(\014lename)h(and)e
(return)h(the)h(HDU)g(n)m(um)m(b)s(er)e(that)i(w)m(ould)f(b)s(e)g(mo)m
(v)m(ed)i(to)f(if)f(the)h(\014le)f(w)m(ere)227 3499 y(op)s(ened)h(with)
g(\014ts)p 878 3499 V 32 w(op)s(en)p 1100 3499 V 32 w(\014le.)49
b(The)33 b(returned)f(HDU)i(n)m(um)m(b)s(er)e(b)s(egins)h(with)g(1)g
(for)g(the)g(primary)g(arra)m(y)-8 b(,)227 3612 y(so)40
b(for)f(example,)k(if)c(the)h(input)e(\014lename)i(=)f(`m)m
(y\014le.\014ts[2]')i(then)e(hdun)m(um)e(=)i(3)h(will)g(b)s(e)f
(returned.)227 3725 y(CFITSIO)j(do)s(es)i(not)g(op)s(en)f(the)g(\014le)
h(to)h(c)m(hec)m(k)g(if)e(the)h(extension)h(actually)g(exists)f(if)g
(an)f(extension)227 3838 y(n)m(um)m(b)s(er)e(is)i(sp)s(eci\014ed.)75
b(If)42 b(an)g(extension)h(name)f(is)h(included)e(in)h(the)h(\014le)f
(name)g(sp)s(eci\014cation)h(\(e.g.)227 3951 y(`m)m
(y\014le.\014ts[EVENTS]')i(then)e(this)h(routine)g(will)h(ha)m(v)m(e)g
(to)f(op)s(en)g(the)g(FITS)f(\014le)h(and)f(lo)s(ok)i(for)f(the)227
4064 y(p)s(osition)31 b(of)f(the)h(named)f(extension,)i(then)e(close)i
(\014le)e(again.)42 b(This)30 b(is)g(not)h(p)s(ossible)f(if)h(the)f
(\014le)h(is)f(b)s(eing)227 4176 y(read)k(from)f(the)h(stdin)f(stream,)
i(and)f(an)f(error)g(will)i(b)s(e)e(returned)f(in)i(this)f(case.)52
b(If)33 b(the)h(\014lename)g(do)s(es)227 4289 y(not)42
b(sp)s(ecify)g(an)g(explicit)h(extension)g(\(e.g.)76
b('m)m(y\014le.\014ts'\))43 b(then)f(hdun)m(um)e(=)h(-99)i(will)g(b)s
(e)e(returned,)227 4402 y(whic)m(h)35 b(is)g(functionally)h(equiv)-5
b(alen)m(t)36 b(to)g(hdun)m(um)d(=)h(1.)55 b(This)34
b(routine)h(is)g(mainly)h(used)e(for)g(bac)m(kw)m(ard)227
4515 y(compatibilit)m(y)39 b(in)e(the)f(fto)s(ols)i(soft)m(w)m(are)g
(pac)m(k)-5 b(age)39 b(and)d(is)g(not)h(recommended)g(for)f(general)i
(use.)59 b(It)37 b(is)227 4628 y(generally)k(b)s(etter)e(and)g(more)g
(e\016cien)m(t)i(to)f(\014rst)e(op)s(en)h(the)g(FITS)g(\014le)g(with)g
(\014ts)p 3125 4628 V 32 w(op)s(en)p 3347 4628 V 33 w(\014le,)i(then)e
(use)227 4741 y(\014ts)p 354 4741 V 33 w(get)p 507 4741
V 34 w(hdu)p 694 4741 V 31 w(n)m(um)c(to)i(determine)g(whic)m(h)f(HDU)h
(in)f(the)h(\014le)f(has)g(b)s(een)g(op)s(ened,)h(rather)f(than)g
(calling)227 4854 y(\014ts)p 354 4854 V 33 w(parse)p
595 4854 V 32 w(input)p 840 4854 V 32 w(url)30 b(follo)m(w)m(ed)i(b)m
(y)e(a)h(call)g(to)h(\014ts)p 1967 4854 V 32 w(op)s(en)p
2189 4854 V 32 w(\014le.)143 5115 y Fe(int)47 b(fits_parse_extnum)c(/)
48 b(ffextn)334 5227 y(\(char)e(*filename,)f(>)j(int)f(*hdunum,)e(int)i
(*status\))0 5488 y Fi(7)81 b Fj(P)m(arse)45 b(the)g(input)e(\014le)i
(name)g(and)f(return)f(the)i(ro)s(ot)g(\014le)g(name.)83
b(The)44 b(ro)s(ot)h(name)g(includes)f(the)h(\014le)227
5601 y(t)m(yp)s(e)35 b(if)g(sp)s(eci\014ed,)h(\(e.g.)56
b('ftp://')37 b(or)e('h)m(ttp://'\))i(and)d(the)h(full)g(path)g(name,)h
(to)g(the)f(exten)m(t)i(that)e(it)h(is)227 5714 y(sp)s(eci\014ed)26
b(in)f(the)i(input)e(\014lename.)39 b(It)26 b(do)s(es)g(not)g(include)g
(the)g(HDU)h(name)f(or)g(n)m(um)m(b)s(er,)g(or)g(an)m(y)h(\014ltering)p
eop end
%%Page: 94 102
TeXDict begin 94 101 bop 0 299 a Fj(94)1003 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(sp)s(eci\014cations.)86 b(The)45
b(calling)h(routine)g(m)m(ust)f(allo)s(cate)i(su\016cien)m(t)f(memory)f
(to)h(hold)f(the)g(returned)227 668 y(ro)s(otname)33
b(c)m(haracter)g(string.)46 b(Allo)s(cating)34 b(the)f(length)f(equal)h
(to)f(FLEN)p 2817 668 28 4 v 33 w(FILENAME)h(is)f(guaran)m(teed)227
781 y(to)f(b)s(e)f(safe.)143 1019 y Fe(int)47 b(fits_parse_rootname)c
(/)k(ffrtnm)334 1132 y(\(char)f(*filename,)f(>)j(char)f(*rootname,)e
(int)h(*status\);)0 1370 y Fi(8)81 b Fj(T)-8 b(est)37
b(if)f(the)h(input)f(\014le)h(or)f(a)h(compressed)g(v)m(ersion)g(of)g
(the)g(\014le)f(\(with)h(a)g(.gz,)j(.Z,)c(.z,)j(or)e(.zip)g
(extension\))227 1483 y(exists)i(on)f(disk.)63 b(The)37
b(returned)g(v)-5 b(alue)38 b(of)g(the)h('exists')g(parameter)f(will)g
(ha)m(v)m(e)i(1)e(of)g(the)g(4)g(follo)m(wing)227 1596
y(v)-5 b(alues:)370 1820 y Fe(2:)95 b(the)47 b(file)g(does)g(not)f
(exist,)h(but)f(a)i(compressed)d(version)h(does)g(exist)370
1933 y(1:)95 b(the)47 b(disk)g(file)g(does)f(exist)370
2046 y(0:)95 b(neither)46 b(the)h(file)g(nor)g(a)g(compressed)e
(version)h(of)h(the)g(file)g(exist)323 2159 y(-1:)94
b(the)47 b(input)g(file)f(name)h(is)g(not)g(a)g(disk)g(file)g(\(could)f
(be)h(a)g(ftp,)g(http,)561 2272 y(smem,)g(or)g(mem)g(file,)f(or)h(a)h
(file)e(piped)h(in)g(on)g(the)g(STDIN)f(stream\))143
2587 y(int)h(fits_file_exists)c(/)48 b(ffexist)334 2700
y(\(char)e(*filename,)f(>)j(int)f(*exists,)e(int)i(*status\);)0
2938 y Fi(9)81 b Fj(Flush)36 b(an)m(y)i(in)m(ternal)g(bu\013ers)e(of)i
(data)g(to)g(the)f(output)g(FITS)g(\014le.)62 b(These)37
b(routines)g(rarely)g(need)g(to)i(b)s(e)227 3051 y(called,)i(but)36
b(can)i(b)s(e)f(useful)f(in)h(cases)i(where)d(other)i(pro)s(cesses)f
(need)g(to)h(access)h(the)f(same)f(FITS)g(\014le)227
3164 y(in)j(real)i(time,)h(either)e(on)g(disk)f(or)g(in)g(memory)-8
b(.)71 b(These)41 b(routines)f(also)h(help)f(to)i(ensure)d(that)i(if)g
(the)227 3277 y(application)c(program)d(subsequen)m(tly)h(ab)s(orts)f
(then)h(the)g(FITS)f(\014le)h(will)g(ha)m(v)m(e)i(b)s(een)d(closed)h
(prop)s(erly)-8 b(.)227 3390 y(The)43 b(\014rst)g(routine,)k(\014ts)p
1110 3390 V 33 w(\015ush)p 1332 3390 V 31 w(\014le)c(is)h(more)f
(rigorous)h(and)f(completely)i(closes,)j(then)c(reop)s(ens,)i(the)227
3503 y(curren)m(t)31 b(HDU,)h(b)s(efore)e(\015ushing)g(the)h(in)m
(ternal)g(bu\013ers,)f(th)m(us)h(ensuring)f(that)h(the)g(output)g(FITS)
f(\014le)h(is)227 3615 y(iden)m(tical)38 b(to)e(what)f(w)m(ould)h(b)s
(e)f(pro)s(duced)f(if)h(the)h(FITS)f(w)m(as)h(closed)g(at)g(that)g(p)s
(oin)m(t)g(\(i.e.,)i(with)e(a)g(call)227 3728 y(to)g(\014ts)p
470 3728 V 33 w(close)p 689 3728 V 34 w(\014le\).)56
b(The)35 b(second)g(routine,)i(\014ts)p 1912 3728 V 33
w(\015ush)p 2134 3728 V 31 w(bu\013er)d(simply)h(\015ushes)f(the)h(in)m
(ternal)h(CFITSIO)227 3841 y(bu\013ers)28 b(of)h(data)h(to)f(the)h
(output)e(FITS)g(\014le,)i(without)f(up)s(dating)f(and)g(closing)i(the)
f(curren)m(t)g(HDU.)h(This)227 3954 y(is)37 b(m)m(uc)m(h)g(faster,)i
(but)e(there)g(ma)m(y)g(b)s(e)f(circumstances)i(where)e(the)h
(\015ushed)f(\014le)h(do)s(es)f(not)h(completely)227
4067 y(re\015ect)31 b(the)g(\014nal)f(state)i(of)e(the)h(\014le)f(as)h
(it)g(will)f(exist)i(when)d(the)h(\014le)h(is)f(actually)i(closed.)227
4214 y(A)f(t)m(ypical)h(use)e(of)h(these)g(routines)f(w)m(ould)g(b)s(e)
g(to)h(\015ush)e(the)h(state)i(of)f(a)g(FITS)e(table)j(to)f(disk)f
(after)h(eac)m(h)227 4327 y(ro)m(w)36 b(of)f(the)h(table)g(is)f
(written.)55 b(It)36 b(is)f(recommend)g(that)h(\014ts)p
2392 4327 V 32 w(\015ush)p 2613 4327 V 32 w(\014le)f(b)s(e)g(called)h
(after)g(the)f(\014rst)g(ro)m(w)227 4440 y(is)k(written,)i(then)d
(\014ts)p 1023 4440 V 32 w(\015ush)p 1244 4440 V 31 w(bu\013er)g(ma)m
(y)h(b)s(e)f(called)h(after)g(eac)m(h)h(subsequen)m(t)e(ro)m(w)g(is)h
(written.)65 b(Note)227 4552 y(that)40 b(this)f(latter)h(routine)f
(will)g(not)g(automatically)j(up)s(date)c(the)h(NAXIS2)g(k)m(eyw)m(ord)
h(whic)m(h)e(records)227 4665 y(the)c(n)m(um)m(b)s(er)d(of)i(ro)m(ws)h
(of)f(data)g(in)g(the)g(table,)i(so)f(this)f(k)m(eyw)m(ord)g(m)m(ust)g
(b)s(e)f(explicitly)j(up)s(dated)d(b)m(y)h(the)227 4778
y(application)f(program)e(after)h(eac)m(h)h(ro)m(w)e(is)g(written.)95
5016 y Fe(int)47 b(fits_flush_file)d(/)j(ffflus)286 5129
y(\(fitsfile)f(*fptr,)g(>)h(int)g(*status\))95 5355 y(int)g
(fits_flush_buffer)c(/)48 b(ffflsh)286 5468 y(\(fitsfile)e(*fptr,)g(0,)
h(>)g(int)g(*status\))286 5694 y(\(Note:)94 b(The)47
b(second)f(argument)g(must)g(be)i(0\).)p eop end
%%Page: 95 103
TeXDict begin 95 102 bop 0 299 a Fh(9.2.)72 b(HDU)31
b(A)m(CCESS)e(R)m(OUTINES)2488 b Fj(95)0 555 y Ff(9.2)135
b(HDU)46 b(Access)e(Routines)0 795 y Fi(1)81 b Fj(Get)28
b(the)f(b)m(yte)h(o\013sets)g(in)f(the)g(FITS)f(\014le)i(to)f(the)h
(start)g(of)f(the)g(header)g(and)g(the)g(start)h(and)e(end)h(of)g(the)g
(data)227 908 y(in)34 b(the)g(CHDU.)g(The)f(di\013erence)h(b)s(et)m(w)m
(een)h(headstart)f(and)f(dataend)h(equals)g(the)g(size)g(of)g(the)g
(CHDU.)227 1021 y(If)e(the)h(CHDU)f(is)h(the)f(last)h(HDU)g(in)f(the)h
(\014le,)g(then)f(dataend)g(is)g(also)i(equal)e(to)h(the)g(size)g(of)g
(the)f(en)m(tire)227 1133 y(FITS)i(\014le.)55 b(Null)35
b(p)s(oin)m(ters)g(ma)m(y)g(b)s(e)f(input)g(for)h(an)m(y)g(of)g(the)g
(address)f(parameters)i(if)e(their)h(v)-5 b(alues)36
b(are)227 1246 y(not)31 b(needed.)95 1502 y Fe(int)47
b(fits_get_hduaddr)d(/)j(ffghad)94 b(\(only)46 b(supports)g(files)g(up)
h(to)h(2.1)f(GB)g(in)g(size\))334 1615 y(\(fitsfile)e(*fptr,)h(>)i
(long)f(*headstart,)d(long)j(*datastart,)e(long)h(*dataend,)382
1728 y(int)h(*status\))95 1953 y(int)g(fits_get_hduaddrll)c(/)48
b(ffghadll)93 b(\(supports)45 b(large)i(files\))334 2066
y(\(fitsfile)e(*fptr,)h(>)i(LONGLONG)d(*headstart,)g(LONGLONG)h
(*datastart,)382 2179 y(LONGLONG)f(*dataend,)h(int)h(*status\))0
2434 y Fi(2)81 b Fj(Create)31 b(\(app)s(end\))f(a)i(new)e(empt)m(y)i
(HDU)f(at)h(the)f(end)f(of)i(the)f(FITS)f(\014le.)42
b(This)31 b(is)g(no)m(w)g(the)g(CHDU)g(but)f(it)227 2547
y(is)i(completely)g(empt)m(y)g(and)f(has)g(no)g(header)g(k)m(eyw)m
(ords.)43 b(It)32 b(is)f(recommended)g(that)h(\014ts)p
3344 2547 28 4 v 32 w(create)p 3612 2547 V 34 w(img)g(or)227
2660 y(\014ts)p 354 2660 V 33 w(create)p 623 2660 V 34
w(tbl)e(b)s(e)g(used)g(instead)g(of)h(this)f(routine.)95
2916 y Fe(int)47 b(fits_create_hdu)d(/)j(ffcrhd)286 3028
y(\(fitsfile)f(*fptr,)g(>)h(int)g(*status\))0 3284 y
Fi(3)81 b Fj(Insert)22 b(a)h(new)g(IMA)m(GE)h(extension)f(immediately)i
(follo)m(wing)f(the)f(CHDU,)h(or)f(insert)g(a)g(new)f(Primary)h(Arra)m
(y)227 3397 y(at)30 b(the)e(b)s(eginning)g(of)h(the)g(\014le.)40
b(An)m(y)29 b(follo)m(wing)h(extensions)f(in)g(the)f(\014le)h(will)g(b)
s(e)f(shifted)g(do)m(wn)h(to)g(mak)m(e)227 3510 y(ro)s(om)36
b(for)h(the)f(new)g(extension.)59 b(If)36 b(the)h(CHDU)g(is)f(the)h
(last)g(HDU)g(in)f(the)h(\014le)f(then)g(the)h(new)f(image)227
3623 y(extension)31 b(will)g(simply)e(b)s(e)h(app)s(ended)e(to)j(the)f
(end)g(of)g(the)g(\014le.)41 b(One)30 b(can)g(force)h(a)g(new)e
(primary)g(arra)m(y)227 3735 y(to)35 b(b)s(e)d(inserted)i(at)g(the)g(b)
s(eginning)f(of)g(the)h(FITS)f(\014le)g(b)m(y)h(setting)h(status)e(=)h
(PREPEND)p 3432 3735 V 32 w(PRIMAR)-8 b(Y)227 3848 y(prior)25
b(to)g(calling)i(the)e(routine.)38 b(In)25 b(this)f(case)i(the)f(old)g
(primary)f(arra)m(y)i(will)f(b)s(e)f(con)m(v)m(erted)j(to)e(an)g(IMA)m
(GE)227 3961 y(extension.)49 b(The)32 b(new)g(extension)i(\(or)f
(primary)f(arra)m(y\))h(will)h(b)s(ecome)f(the)g(CHDU.)g(Refer)g(to)h
(Chapter)227 4074 y(9)d(for)f(a)h(list)g(of)f(pre-de\014ned)f(bitpix)i
(v)-5 b(alues.)95 4329 y Fe(int)47 b(fits_insert_img)d(/)j(ffiimg)286
4442 y(\(fitsfile)f(*fptr,)g(int)h(bitpix,)e(int)i(naxis,)f(long)h
(*naxes,)f(>)h(int)g(*status\))95 4668 y(int)g(fits_insert_imgll)c(/)48
b(ffiimgll)286 4781 y(\(fitsfile)e(*fptr,)g(int)h(bitpix,)e(int)i
(naxis,)f(LONGLONG)g(*naxes,)g(>)h(int)g(*status\))0
5036 y Fi(4)81 b Fj(Insert)30 b(a)g(new)g(ASCI)s(I)f(or)i(binary)f
(table)h(extension)g(immediately)h(follo)m(wing)g(the)f(CHDU.)g(An)m(y)
f(follo)m(wing)227 5149 y(extensions)36 b(will)g(b)s(e)f(shifted)g(do)m
(wn)g(to)h(mak)m(e)g(ro)s(om)g(for)f(the)g(new)g(extension.)57
b(If)35 b(there)h(are)f(no)h(other)227 5262 y(follo)m(wing)c
(extensions)g(then)e(the)h(new)f(table)h(extension)h(will)f(simply)f(b)
s(e)g(app)s(ended)f(to)i(the)g(end)f(of)h(the)227 5375
y(\014le.)42 b(If)30 b(the)h(FITS)f(\014le)g(is)h(curren)m(tly)g(empt)m
(y)g(then)f(this)g(routine)h(will)g(create)h(a)f(dumm)m(y)f(primary)f
(arra)m(y)227 5488 y(b)s(efore)i(app)s(ending)f(the)i(table)h(to)f(it.)
44 b(The)31 b(new)g(extension)i(will)e(b)s(ecome)h(the)g(CHDU.)g(The)f
(tunit)h(and)227 5601 y(extname)39 b(parameters)g(are)f(optional)i(and)
e(a)g(n)m(ull)g(p)s(oin)m(ter)h(ma)m(y)f(b)s(e)g(giv)m(en)h(if)f(they)h
(are)f(not)h(de\014ned.)227 5714 y(When)32 b(inserting)g(an)g(ASCI)s(I)
f(table)i(with)e(\014ts)p 1847 5714 V 33 w(insert)p 2103
5714 V 33 w(atbl,)i(a)f(n)m(ull)g(p)s(oin)m(ter)g(ma)m(y)h(giv)m(en)g
(for)f(the)g(*tb)s(col)p eop end
%%Page: 96 104
TeXDict begin 96 103 bop 0 299 a Fj(96)1003 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(parameter)23 b(in)f(whic)m(h)h(case)g(eac)m
(h)h(column)e(of)h(the)g(table)g(will)g(b)s(e)f(separated)h(b)m(y)f(a)h
(single)g(space)g(c)m(haracter.)227 668 y(Similarly)-8
b(,)29 b(if)d(the)h(input)f(v)-5 b(alue)27 b(of)g(ro)m(wlen)g(is)f(0,)i
(then)f(CFITSIO)e(will)i(calculate)i(the)e(default)f(ro)m(wlength)227
781 y(based)39 b(on)g(the)g(tb)s(col)h(and)e(tt)m(yp)s(e)h(v)-5
b(alues.)67 b(Under)39 b(normal)g(circumstances,)j(the)d(nro)m(ws)f
(paramen)m(ter)227 894 y(should)31 b(ha)m(v)m(e)i(a)f(v)-5
b(alue)32 b(of)f(0;)i(CFITSIO)d(will)i(automatically)j(up)s(date)30
b(the)i(n)m(um)m(b)s(er)e(of)i(ro)m(ws)g(as)g(data)g(is)227
1007 y(written)26 b(to)h(the)f(table.)40 b(When)25 b(inserting)h(a)h
(binary)e(table)h(with)g(\014ts)p 2596 1007 28 4 v 32
w(insert)p 2851 1007 V 33 w(btbl,)g(if)g(there)g(are)g(follo)m(wing)227
1120 y(extensions)f(in)f(the)h(\014le)f(and)g(if)g(the)h(table)g(con)m
(tains)g(v)-5 b(ariable)25 b(length)g(arra)m(y)g(columns)f(then)g(p)s
(coun)m(t)g(m)m(ust)227 1233 y(sp)s(ecify)30 b(the)h(exp)s(ected)g
(\014nal)f(size)h(of)f(the)h(data)g(heap,)f(otherwise)h(p)s(coun)m(t)f
(m)m(ust)h(=)f(0.)95 1490 y Fe(int)47 b(fits_insert_atbl)d(/)j(ffitab)
286 1603 y(\(fitsfile)f(*fptr,)g(LONGLONG)f(rowlen,)h(LONGLONG)g
(nrows,)g(int)h(tfields,)e(char)i(*ttype[],)334 1716
y(long)g(*tbcol,)f(char)g(*tform[],)f(char)i(*tunit[],)e(char)i
(*extname,)e(>)j(int)f(*status\))95 1942 y(int)g(fits_insert_btbl)d(/)j
(ffibin)286 2055 y(\(fitsfile)f(*fptr,)g(LONGLONG)f(nrows,)h(int)h
(tfields,)f(char)g(**ttype,)286 2168 y(char)h(**tform,)f(char)g
(**tunit,)g(char)g(*extname,)g(long)g(pcount,)g(>)i(int)e(*status\))0
2425 y Fi(5)81 b Fj(Mo)s(dify)27 b(the)h(size,)h(dimensions,)f(and/or)f
(data)i(t)m(yp)s(e)f(of)f(the)h(curren)m(t)g(primary)e(arra)m(y)i(or)g
(image)h(extension.)227 2538 y(If)39 b(the)h(new)e(image,)44
b(as)39 b(sp)s(eci\014ed)g(b)m(y)g(the)g(input)g(argumen)m(ts,)j(is)d
(larger)h(than)f(the)h(curren)m(t)f(existing)227 2651
y(image)30 b(in)e(the)g(FITS)g(\014le)g(then)g(zero)h(\014ll)f(data)h
(will)g(b)s(e)f(inserted)g(at)h(the)f(end)g(of)g(the)h(curren)m(t)f
(image)i(and)227 2764 y(an)m(y)35 b(follo)m(wing)h(extensions)f(will)g
(b)s(e)f(mo)m(v)m(ed)i(further)d(bac)m(k)i(in)g(the)f(\014le.)54
b(Similarly)-8 b(,)36 b(if)f(the)g(new)f(image)227 2877
y(is)j(smaller)g(than)g(the)f(curren)m(t)h(image)h(then)e(an)m(y)h
(follo)m(wing)h(extensions)f(will)g(b)s(e)f(shifted)h(up)e(to)m(w)m
(ards)227 2990 y(the)h(b)s(eginning)f(of)h(the)g(FITS)f(\014le)h(and)f
(the)h(image)h(data)f(will)h(b)s(e)e(truncated)g(to)i(the)f(new)f
(size.)58 b(This)227 3103 y(routine)27 b(rewrites)g(the)h(BITPIX,)f
(NAXIS,)g(and)f(NAXISn)g(k)m(eyw)m(ords)i(with)f(the)g(appropriate)g(v)
-5 b(alues)27 b(for)227 3216 y(the)k(new)f(image.)95
3473 y Fe(int)47 b(fits_resize_img)d(/)j(ffrsim)286 3586
y(\(fitsfile)f(*fptr,)g(int)h(bitpix,)e(int)i(naxis,)f(long)h(*naxes,)f
(>)h(int)g(*status\))95 3812 y(int)g(fits_resize_imgll)c(/)48
b(ffrsimll)286 3925 y(\(fitsfile)e(*fptr,)g(int)h(bitpix,)e(int)i
(naxis,)f(LONGLONG)g(*naxes,)g(>)h(int)g(*status\))0
4183 y Fi(6)81 b Fj(Cop)m(y)43 b(the)h(data)h(\(and)e(not)h(the)g
(header\))g(from)f(the)h(CHDU)g(asso)s(ciated)h(with)f(infptr)e(to)j
(the)f(CHDU)227 4295 y(asso)s(ciated)34 b(with)e(outfptr.)47
b(This)32 b(will)g(o)m(v)m(erwrite)i(an)m(y)f(data)g(previously)g(in)f
(the)h(output)f(CHDU.)h(This)227 4408 y(lo)m(w)39 b(lev)m(el)h(routine)
e(is)g(used)f(b)m(y)h(\014ts)p 1510 4408 V 33 w(cop)m(y)p
1724 4408 V 33 w(hdu,)h(but)e(it)i(ma)m(y)f(also)h(b)s(e)f(useful)f(in)
h(certain)h(application)227 4521 y(programs)30 b(that)h(w)m(an)m(t)g
(to)g(cop)m(y)g(the)f(data)h(from)f(one)h(FITS)e(\014le)i(to)g(another)
f(but)f(also)j(w)m(an)m(t)f(to)g(mo)s(dify)227 4634 y(the)h(header)g(k)
m(eyw)m(ords.)46 b(The)32 b(required)f(FITS)g(header)h(k)m(eyw)m(ords)g
(whic)m(h)g(de\014ne)f(the)h(structure)g(of)g(the)227
4747 y(HDU)f(m)m(ust)g(b)s(e)e(written)i(to)g(the)f(output)g(CHDU)h(b)s
(efore)f(calling)i(this)e(routine.)95 5005 y Fe(int)47
b(fits_copy_data)d(/)k(ffcpdt)286 5118 y(\(fitsfile)e(*infptr,)f
(fitsfile)h(*outfptr,)f(>)i(int)g(*status\))0 5375 y
Fi(7)81 b Fj(Read)30 b(or)g(write)g(a)h(sp)s(eci\014ed)e(n)m(um)m(b)s
(er)g(of)i(b)m(ytes)f(starting)h(at)g(the)g(sp)s(eci\014ed)e(b)m(yte)i
(o\013set)g(from)f(the)g(start)h(of)227 5488 y(the)c(extension)g(data)f
(unit.)39 b(These)26 b(lo)m(w)h(lev)m(el)h(routine)e(are)h(in)m(tended)
f(mainly)g(for)g(accessing)i(the)e(data)h(in)227 5601
y(non-standard,)h(conforming)g(extensions,)h(and)e(should)g(not)h(b)s
(e)g(used)f(for)g(standard)g(IMA)m(GE,)i(T)-8 b(ABLE,)227
5714 y(or)31 b(BINT)-8 b(ABLE)31 b(extensions.)p eop
end
%%Page: 97 105
TeXDict begin 97 104 bop 0 299 a Fh(9.3.)72 b(SPECIALIZED)29
b(HEADER)i(KEYW)m(ORD)g(R)m(OUTINES)1510 b Fj(97)95 555
y Fe(int)47 b(fits_read_ext)e(/)i(ffgextn)286 668 y(\(fitsfile)f
(*fptr,)g(LONGLONG)f(offset,)h(LONGLONG)g(nbytes,)f(void)i(*buffer\))95
781 y(int)g(fits_write_ext)d(/)k(ffpextn)286 894 y(\(fitsfile)e(*fptr,)
g(LONGLONG)f(offset,)h(LONGLONG)g(nbytes,)f(void)i(*buffer\))0
1158 y Fi(8)81 b Fj(This)34 b(routine)g(forces)h(CFITSIO)f(to)h(rescan)
g(the)g(curren)m(t)g(header)f(k)m(eyw)m(ords)h(that)g(de\014ne)f(the)h
(structure)227 1271 y(of)f(the)f(HDU)h(\(suc)m(h)g(as)f(the)h(NAXIS)f
(and)g(BITPIX)g(k)m(eyw)m(ords\))h(so)f(that)h(it)g(reinitializes)i
(the)d(in)m(ternal)227 1384 y(bu\013ers)26 b(that)h(describ)s(e)g(the)g
(HDU)g(structure.)39 b(This)26 b(routine)h(is)g(useful)f(for)g
(reinitializing)j(the)e(structure)227 1497 y(of)34 b(an)f(HDU)h(if)f
(an)m(y)h(of)g(the)f(required)g(k)m(eyw)m(ords)g(\(e.g.,)j(NAXISn\))d
(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)48 b(In)33 b(practice)227
1610 y(it)e(should)e(rarely)h(b)s(e)f(necessary)h(to)h(call)g(this)f
(routine)g(b)s(ecause)f(CFITSIO)g(in)m(ternally)i(calls)g(it)f(in)g
(most)227 1723 y(situations.)95 1987 y Fe(int)47 b(fits_set_hdustruc)c
(/)48 b(ffrdef)286 2100 y(\(fitsfile)e(*fptr,)g(>)h(int)g(*status\))141
b(\(DEPRECATED\))0 2439 y Ff(9.3)135 b(Sp)t(ecialized)46
b(Header)g(Keyw)l(ord)f(Routines)0 2693 y Fd(9.3.1)112
b(Header)38 b(Information)h(Routines)0 2906 y Fi(1)81
b Fj(Reserv)m(e)29 b(space)g(in)e(the)i(CHU)f(for)g(MOREKEYS)f(more)h
(header)g(k)m(eyw)m(ords.)41 b(This)27 b(routine)h(ma)m(y)h(b)s(e)f
(called)227 3018 y(to)34 b(allo)s(cate)h(space)e(for)f(additional)i(k)m
(eyw)m(ords)f(at)g(the)g(time)g(the)g(header)f(is)h(created)g(\(prior)g
(to)g(writing)227 3131 y(an)m(y)h(data\).)51 b(CFITSIO)32
b(can)i(dynamically)g(add)f(more)g(space)h(to)g(the)g(header)f(when)f
(needed,)j(ho)m(w)m(ev)m(er)227 3244 y(it)c(is)g(more)f(e\016cien)m(t)i
(to)f(preallo)s(cate)h(the)f(required)f(space)h(if)f(the)g(size)i(is)e
(kno)m(wn)g(in)g(adv)-5 b(ance.)95 3509 y Fe(int)47 b(fits_set_hdrsize)
d(/)j(ffhdef)286 3621 y(\(fitsfile)f(*fptr,)g(int)h(morekeys,)e(>)i
(int)g(*status\))0 3886 y Fi(2)81 b Fj(Return)26 b(the)h(n)m(um)m(b)s
(er)e(of)j(k)m(eyw)m(ords)f(in)f(the)h(header)g(\(not)h(coun)m(ting)g
(the)f(END)g(k)m(eyw)m(ord\))h(and)e(the)h(curren)m(t)227
3999 y(p)s(osition)34 b(in)g(the)g(header.)50 b(The)34
b(p)s(osition)f(is)h(the)g(n)m(um)m(b)s(er)f(of)h(the)g(k)m(eyw)m(ord)g
(record)f(that)i(will)f(b)s(e)f(read)227 4112 y(next)k(\(or)g(one)f
(greater)i(than)e(the)h(p)s(osition)f(of)h(the)g(last)g(k)m(eyw)m(ord)g
(that)g(w)m(as)g(read\).)59 b(A)37 b(v)-5 b(alue)36 b(of)h(1)g(is)227
4224 y(returned)29 b(if)i(the)f(p)s(oin)m(ter)h(is)f(p)s(ositioned)h
(at)g(the)f(b)s(eginning)g(of)g(the)h(header.)95 4489
y Fe(int)47 b(fits_get_hdrpos)d(/)j(ffghps)286 4602 y(\(fitsfile)f
(*fptr,)g(>)h(int)g(*keysexist,)e(int)i(*keynum,)e(int)i(*status\))0
4897 y Fd(9.3.2)112 b(Read)38 b(and)h(W)-9 b(rite)36
b(the)h(Required)h(Keyw)m(ords)0 5110 y Fi(1)81 b Fj(W)-8
b(rite)34 b(the)f(required)g(extension)h(header)e(k)m(eyw)m(ords)i(in)m
(to)g(the)f(CHU.)h(These)f(routines)g(are)g(not)g(required,)227
5223 y(and)g(instead)g(the)g(appropriate)g(header)g(ma)m(y)g(b)s(e)g
(constructed)g(b)m(y)g(writing)g(eac)m(h)h(individual)e(k)m(eyw)m(ord)
227 5336 y(in)e(the)h(prop)s(er)e(sequence.)227 5488
y(The)21 b(simpler)g(\014ts)p 842 5488 28 4 v 33 w(write)p
1077 5488 V 33 w(imghdr)f(routine)i(is)f(equiv)-5 b(alen)m(t)23
b(to)f(calling)h(\014ts)p 2727 5488 V 32 w(write)p 2961
5488 V 33 w(grphdr)d(with)h(the)h(default)227 5601 y(v)-5
b(alues)37 b(of)f(simple)g(=)g(TR)m(UE,)g(p)s(coun)m(t)g(=)g(0,)i
(gcoun)m(t)f(=)f(1,)i(and)e(extend)g(=)f(TR)m(UE.)i(The)e(PCOUNT,)227
5714 y(GCOUNT)43 b(and)g(EXTEND)g(k)m(eyw)m(ords)g(are)h(not)f
(required)f(in)h(the)h(primary)e(header)h(and)f(are)i(only)p
eop end
%%Page: 98 106
TeXDict begin 98 105 bop 0 299 a Fj(98)1003 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(written)38 b(if)f(p)s(coun)m(t)g(is)g(not)h
(equal)f(to)i(zero,)h(gcoun)m(t)e(is)f(not)h(equal)g(to)g(zero)g(or)f
(one,)j(and)c(if)i(extend)f(is)227 668 y(TR)m(UE,)k(resp)s(ectiv)m(ely)
-8 b(.)74 b(When)41 b(writing)g(to)h(an)e(IMA)m(GE)i(extension,)i(the)e
(SIMPLE)e(and)g(EXTEND)227 781 y(parameters)c(are)f(ignored.)56
b(It)35 b(is)g(recommended)g(that)h(\014ts)p 2342 781
28 4 v 32 w(create)p 2610 781 V 35 w(image)g(or)f(\014ts)p
3150 781 V 33 w(create)p 3419 781 V 34 w(tbl)g(b)s(e)g(used)227
894 y(instead)26 b(of)f(these)h(routines)g(to)g(write)f(the)h(required)
e(header)i(k)m(eyw)m(ords.)39 b(The)25 b(general)h(\014ts)p
3377 894 V 33 w(write)p 3612 894 V 33 w(exthdr)227 1007
y(routine)31 b(ma)m(y)g(b)s(e)e(used)h(to)h(write)g(the)f(header)g(of)h
(an)m(y)g(conforming)f(FITS)g(extension.)95 1252 y Fe(int)47
b(fits_write_imghdr)c(/)48 b(ffphps)286 1365 y(\(fitsfile)e(*fptr,)g
(int)h(bitpix,)e(int)i(naxis,)f(long)h(*naxes,)f(>)h(int)g(*status\))95
1591 y(int)g(fits_write_imghdrll)c(/)k(ffphpsll)286 1704
y(\(fitsfile)f(*fptr,)g(int)h(bitpix,)e(int)i(naxis,)f(LONGLONG)g
(*naxes,)g(>)h(int)g(*status\))95 1930 y(int)g(fits_write_grphdr)c(/)48
b(ffphpr)286 2042 y(\(fitsfile)e(*fptr,)g(int)h(simple,)e(int)i
(bitpix,)f(int)h(naxis,)f(long)h(*naxes,)334 2155 y(LONGLONG)f(pcount,)
f(LONGLONG)h(gcount,)g(int)h(extend,)f(>)h(int)g(*status\))95
2381 y(int)g(fits_write_grphdrll)c(/)k(ffphprll)286 2494
y(\(fitsfile)f(*fptr,)g(int)h(simple,)e(int)i(bitpix,)f(int)h(naxis,)f
(LONGLONG)g(*naxes,)334 2607 y(LONGLONG)g(pcount,)f(LONGLONG)h(gcount,)
g(int)h(extend,)f(>)h(int)g(*status\))95 2833 y(int)g
(fits_write_exthdr)c(/ffphext)286 2946 y(\(fitsfile)j(*fptr,)g(char)g
(*xtension,)f(int)i(bitpix,)f(int)h(naxis,)f(long)h(*naxes,)334
3059 y(LONGLONG)f(pcount,)f(LONGLONG)h(gcount,)g(>)h(int)g(*status\))0
3417 y Fi(2)81 b Fj(W)-8 b(rite)30 b(the)g(ASCI)s(I)d(table)k(header)e
(k)m(eyw)m(ords)g(in)m(to)i(the)e(CHU.)h(The)e(optional)j(TUNITn)d(and)
h(EXTNAME)227 3530 y(k)m(eyw)m(ords)f(are)h(written)e(only)h(if)g(the)g
(input)f(p)s(oin)m(ters)h(are)g(not)g(n)m(ull.)40 b(A)27
b(n)m(ull)h(p)s(oin)m(ter)g(ma)m(y)g(giv)m(en)h(for)f(the)227
3643 y(*tb)s(col)37 b(parameter)g(in)f(whic)m(h)g(case)i(a)e(single)h
(space)g(will)g(b)s(e)f(inserted)g(b)s(et)m(w)m(een)h(eac)m(h)g(column)
f(of)h(the)227 3756 y(table.)57 b(Similarly)-8 b(,)37
b(if)f(ro)m(wlen)f(is)h(giv)m(en)g(=)f(0,)i(then)e(CFITSIO)f(will)i
(calculate)h(the)f(default)f(ro)m(wlength)227 3868 y(based)30
b(on)h(the)f(tb)s(col)h(and)f(tt)m(yp)s(e)h(v)-5 b(alues.)95
4114 y Fe(int)47 b(fits_write_atblhdr)c(/)48 b(ffphtb)286
4227 y(\(fitsfile)e(*fptr,)g(LONGLONG)f(rowlen,)h(LONGLONG)g(nrows,)g
(int)h(tfields,)e(char)i(**ttype,)334 4340 y(long)g(*tbcol,)f(char)g
(**tform,)g(char)g(**tunit,)g(char)h(*extname,)e(>)i(int)g(*status\))0
4585 y Fi(3)81 b Fj(W)-8 b(rite)30 b(the)f(binary)g(table)h(header)e(k)
m(eyw)m(ords)i(in)m(to)g(the)f(CHU.)g(The)g(optional)h(TUNITn)e(and)h
(EXTNAME)227 4698 y(k)m(eyw)m(ords)35 b(are)g(written)g(only)g(if)f
(the)h(input)f(p)s(oin)m(ters)g(are)h(not)g(n)m(ull.)53
b(The)35 b(p)s(coun)m(t)f(parameter,)i(whic)m(h)227 4811
y(sp)s(eci\014es)h(the)g(size)g(of)g(the)g(v)-5 b(ariable)38
b(length)f(arra)m(y)g(heap,)h(should)e(initially)i(=)f(0;)j(CFITSIO)c
(will)h(au-)227 4924 y(tomatically)d(up)s(date)d(the)g(PCOUNT)f(k)m
(eyw)m(ord)i(v)-5 b(alue)32 b(if)f(an)m(y)g(v)-5 b(ariable)32
b(length)g(arra)m(y)g(data)g(is)f(written)227 5036 y(to)g(the)e(heap.)
41 b(The)29 b(TF)m(ORM)g(k)m(eyw)m(ord)h(v)-5 b(alue)30
b(for)g(v)-5 b(ariable)30 b(length)g(v)m(ector)h(columns)e(should)g(ha)
m(v)m(e)i(the)227 5149 y(form)c('Pt\(len\)')j(or)d('1Pt\(len\)')j
(where)d(`t')h(is)g(the)g(data)g(t)m(yp)s(e)g(co)s(de)f(letter)i
(\(A,I,J,E,D,)g(etc.\))42 b(and)27 b(`len')h(is)227 5262
y(an)g(in)m(teger)i(sp)s(ecifying)e(the)g(maxim)m(um)g(length)g(of)h
(the)f(v)m(ectors)h(in)f(that)h(column)f(\(len)g(m)m(ust)g(b)s(e)g
(greater)227 5375 y(than)36 b(or)g(equal)h(to)g(the)f(longest)i(v)m
(ector)f(in)f(the)h(column\).)58 b(If)36 b(`len')g(is)h(not)f(sp)s
(eci\014ed)g(when)f(the)h(table)227 5488 y(is)c(created)g(\(e.g.,)h
(the)f(input)e(TF)m(ORMn)h(v)-5 b(alue)32 b(is)f(just)g('1Pt'\))i(then)
e(CFITSIO)f(will)h(scan)h(the)f(column)227 5601 y(when)f(the)h(table)h
(is)f(\014rst)f(closed)h(and)g(will)g(app)s(end)e(the)i(maxim)m(um)g
(length)g(to)g(the)g(TF)m(ORM)g(k)m(eyw)m(ord)227 5714
y(v)-5 b(alue.)41 b(Note)30 b(that)f(if)f(the)h(table)g(is)g(subsequen)
m(tly)f(mo)s(di\014ed)f(to)j(increase)f(the)g(maxim)m(um)f(length)h(of)
g(the)p eop end
%%Page: 99 107
TeXDict begin 99 106 bop 0 299 a Fh(9.3.)72 b(SPECIALIZED)29
b(HEADER)i(KEYW)m(ORD)g(R)m(OUTINES)1510 b Fj(99)227
555 y(v)m(ectors)39 b(then)e(the)g(mo)s(difying)g(program)g(is)g(resp)s
(onsible)g(for)g(also)h(up)s(dating)e(the)i(TF)m(ORM)f(k)m(eyw)m(ord)
227 668 y(v)-5 b(alue.)95 935 y Fe(int)47 b(fits_write_btblhdr)c(/)48
b(ffphbn)286 1048 y(\(fitsfile)e(*fptr,)g(LONGLONG)f(nrows,)h(int)h
(tfields,)f(char)g(**ttype,)334 1161 y(char)h(**tform,)e(char)i
(**tunit,)e(char)i(*extname,)e(LONGLONG)h(pcount,)g(>)h(int)g
(*status\))0 1427 y Fi(4)81 b Fj(Read)30 b(the)h(required)e(k)m(eyw)m
(ords)i(from)f(the)h(CHDU)f(\(image)j(or)d(table\).)42
b(When)30 b(reading)h(from)f(an)g(IMA)m(GE)227 1540 y(extension)24
b(the)g(SIMPLE)e(and)h(EXTEND)g(parameters)h(are)f(ignored.)39
b(A)23 b(n)m(ull)g(p)s(oin)m(ter)h(ma)m(y)g(b)s(e)e(supplied)227
1653 y(for)30 b(an)m(y)h(of)g(the)f(returned)f(parameters)i(that)g(are)
g(not)f(needed.)95 1920 y Fe(int)47 b(fits_read_imghdr)d(/)j(ffghpr)286
2033 y(\(fitsfile)f(*fptr,)g(int)h(maxdim,)e(>)j(int)f(*simple,)e(int)i
(*bitpix,)f(int)h(*naxis,)334 2146 y(long)g(*naxes,)f(long)g(*pcount,)g
(long)g(*gcount,)g(int)h(*extend,)e(int)i(*status\))95
2372 y(int)g(fits_read_imghdrll)c(/)48 b(ffghprll)286
2485 y(\(fitsfile)e(*fptr,)g(int)h(maxdim,)e(>)j(int)f(*simple,)e(int)i
(*bitpix,)f(int)h(*naxis,)334 2598 y(LONGLONG)f(*naxes,)f(long)i
(*pcount,)f(long)g(*gcount,)g(int)h(*extend,)e(int)i(*status\))95
2823 y(int)g(fits_read_atblhdr)c(/)48 b(ffghtb)286 2936
y(\(fitsfile)e(*fptr,int)f(maxdim,)h(>)h(long)g(*rowlen,)e(long)i
(*nrows,)334 3049 y(int)g(*tfields,)e(char)i(**ttype,)e(LONGLONG)h
(*tbcol,)g(char)g(**tform,)g(char)h(**tunit,)334 3162
y(char)g(*extname,)93 b(int)47 b(*status\))95 3388 y(int)g
(fits_read_atblhdrll)c(/)k(ffghtbll)286 3501 y(\(fitsfile)f(*fptr,int)f
(maxdim,)h(>)h(LONGLONG)f(*rowlen,)f(LONGLONG)h(*nrows,)334
3614 y(int)h(*tfields,)e(char)i(**ttype,)e(long)i(*tbcol,)f(char)h
(**tform,)e(char)i(**tunit,)334 3727 y(char)g(*extname,)93
b(int)47 b(*status\))95 3952 y(int)g(fits_read_btblhdr)c(/)48
b(ffghbn)286 4065 y(\(fitsfile)e(*fptr,)g(int)h(maxdim,)e(>)j(long)f
(*nrows,)e(int)i(*tfields,)334 4178 y(char)g(**ttype,)e(char)i
(**tform,)e(char)i(**tunit,)f(char)g(*extname,)334 4291
y(long)h(*pcount,)e(int)i(*status\))95 4517 y(int)g
(fits_read_btblhdrll)c(/)k(ffghbnll)286 4630 y(\(fitsfile)f(*fptr,)g
(int)h(maxdim,)e(>)j(LONGLONG)d(*nrows,)h(int)h(*tfields,)334
4743 y(char)g(**ttype,)e(char)i(**tform,)e(char)i(**tunit,)f(char)g
(*extname,)334 4856 y(long)h(*pcount,)e(int)i(*status\))0
5155 y Fd(9.3.3)112 b(W)-9 b(rite)37 b(Keyw)m(ord)g(Routines)0
5375 y Fj(These)32 b(routines)h(simply)f(app)s(end)f(a)h(new)g(k)m(eyw)
m(ord)h(to)h(the)e(header)h(and)f(do)g(not)h(c)m(hec)m(k)h(to)f(see)g
(if)g(a)f(k)m(eyw)m(ord)0 5488 y(with)d(the)g(same)h(name)f(already)h
(exists.)41 b(In)28 b(general)i(it)g(is)f(preferable)g(to)h(use)f(the)h
(\014ts)p 3009 5488 28 4 v 32 w(up)s(date)p 3317 5488
V 32 w(k)m(ey)g(routine)f(to)0 5601 y(ensure)34 b(that)h(the)g(same)g
(k)m(eyw)m(ord)g(is)f(not)h(written)g(more)g(than)f(once)h(to)h(the)e
(header.)54 b(See)34 b(App)s(endix)f(B)i(for)0 5714 y(the)c
(de\014nition)f(of)g(the)h(parameters)f(used)g(in)g(these)h(routines.)p
eop end
%%Page: 100 108
TeXDict begin 100 107 bop 0 299 a Fj(100)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fi(1)81 b Fj(W)-8 b(rite)30 b(\(app)s(end\))f(a)g
(new)g(k)m(eyw)m(ord)h(of)g(the)f(appropriate)g(data)h(t)m(yp)s(e)g(in)
m(to)g(the)g(CHU.)f(A)h(n)m(ull)f(p)s(oin)m(ter)g(ma)m(y)227
668 y(b)s(e)35 b(en)m(tered)h(for)f(the)h(commen)m(t)h(parameter,)g
(whic)m(h)e(will)h(cause)g(the)g(commen)m(t)g(\014eld)f(of)h(the)f(k)m
(eyw)m(ord)227 781 y(to)43 b(b)s(e)e(left)i(blank.)76
b(The)41 b(\015t,)k(dbl,)f(cmp,)h(and)d(dblcmp)f(v)m(ersions)h(of)g
(this)g(routine)g(ha)m(v)m(e)h(the)g(added)227 894 y(feature)33
b(that)g(if)g(the)f('decimals')i(parameter)f(is)g(negativ)m(e,)i(then)d
(the)h('G')g(displa)m(y)g(format)g(rather)f(then)227
1007 y(the)i('E')f(format)h(will)f(b)s(e)g(used)f(when)g(constructing)i
(the)g(k)m(eyw)m(ord)f(v)-5 b(alue,)35 b(taking)f(the)g(absolute)f(v)-5
b(alue)227 1120 y(of)34 b('decimals')h(for)e(the)h(precision.)51
b(This)33 b(will)h(suppress)d(trailing)k(zeros,)g(and)e(will)h(use)g(a)
g(\014xed)f(format)227 1233 y(rather)e(than)f(an)g(exp)s(onen)m(tial)h
(format,)g(dep)s(ending)e(on)h(the)h(magnitude)f(of)h(the)g(v)-5
b(alue.)95 1478 y Fe(int)47 b(fits_write_key_str)c(/)48
b(ffpkys)286 1591 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(char)g
(*value,)g(char)h(*comment,)334 1704 y(>)h(int)e(*status\))95
1930 y(int)h(fits_write_key_[log,)c(lng])j(/)95 b(ffpky[lj])286
2042 y(\(fitsfile)46 b(*fptr,)g(char)g(*keyname,)g(DTYPE)g(numval,)g
(char)g(*comment,)334 2155 y(>)i(int)e(*status\))95 2381
y(int)h(fits_write_key_[flt,)c(dbl,)j(fixflg,)g(fixdbl])g(/)h
(ffpky[edfg])286 2494 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)
g(numval,)g(int)h(decimals,)286 2607 y(char)g(*comment,)e(>)j(int)f
(*status\))95 2833 y(int)g(fits_write_key_[cmp,)c(dblcmp,)i(fixcmp,)h
(fixdblcmp])f(/)j(ffpk[yc,ym,fc,fm])286 2946 y(\(fitsfile)e(*fptr,)g
(char)g(*keyname,)g(DTYPE)g(*numval,)g(int)g(decimals,)286
3059 y(char)h(*comment,)e(>)j(int)f(*status\))0 3304
y Fi(2)81 b Fj(W)-8 b(rite)30 b(\(app)s(end\))e(a)i(string)f(v)-5
b(alued)29 b(k)m(eyw)m(ord)h(in)m(to)g(the)f(CHU)h(whic)m(h)e(ma)m(y)i
(b)s(e)f(longer)h(than)e(68)i(c)m(haracters)227 3417
y(in)43 b(length.)80 b(This)42 b(uses)h(the)g(Long)h(String)e(Keyw)m
(ord)h(con)m(v)m(en)m(tion)j(that)d(is)h(describ)s(ed)e(in)h(the`Lo)s
(cal)227 3530 y(FITS)38 b(Con)m(v)m(en)m(tions')i(section)g(in)f
(Chapter)f(4.)66 b(Since)38 b(this)h(uses)f(a)h(non-standard)f(FITS)g
(con)m(v)m(en)m(tion)227 3643 y(to)45 b(enco)s(de)f(the)g(long)h(k)m
(eyw)m(ord)f(string,)k(programs)43 b(whic)m(h)h(use)g(this)g(routine)g
(should)f(also)h(call)i(the)227 3756 y(\014ts)p 354 3756
28 4 v 33 w(write)p 589 3756 V 33 w(k)m(ey)p 755 3756
V 33 w(longw)m(arn)26 b(routine)f(to)h(add)f(some)h(COMMENT)f(k)m(eyw)m
(ords)g(to)h(w)m(arn)f(users)g(of)g(the)h(FITS)227 3868
y(\014le)43 b(that)h(this)e(con)m(v)m(en)m(tion)j(is)e(b)s(eing)f
(used.)78 b(The)42 b(\014ts)p 2220 3868 V 32 w(write)p
2454 3868 V 33 w(k)m(ey)p 2620 3868 V 34 w(longw)m(arn)h(routine)g
(also)h(writes)f(a)227 3981 y(k)m(eyw)m(ord)29 b(called)g(LONGSTRN)e
(to)i(record)f(the)g(v)m(ersion)h(of)f(the)g(longstring)h(con)m(v)m(en)
m(tion)h(that)f(has)f(b)s(een)227 4094 y(used,)35 b(in)f(case)i(a)f
(new)e(con)m(v)m(en)m(tion)k(is)e(adopted)f(at)h(some)g(p)s(oin)m(t)f
(in)h(the)f(future.)52 b(If)34 b(the)h(LONGSTRN)227 4207
y(k)m(eyw)m(ord)43 b(is)g(already)g(presen)m(t)g(in)g(the)f(header,)k
(then)d(\014ts)p 2332 4207 V 32 w(write)p 2566 4207 V
33 w(k)m(ey)p 2732 4207 V 34 w(longw)m(arn)g(will)g(simply)f(return)227
4320 y(without)31 b(doing)f(an)m(ything.)95 4565 y Fe(int)47
b(fits_write_key_longstr)42 b(/)48 b(ffpkls)286 4678
y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(char)g(*longstr,)g(char)g
(*comment,)334 4791 y(>)i(int)e(*status\))95 5017 y(int)h
(fits_write_key_longwarn)42 b(/)47 b(ffplsw)286 5130
y(\(fitsfile)f(*fptr,)g(>)h(int)g(*status\))0 5375 y
Fi(3)81 b Fj(W)-8 b(rite)38 b(\(app)s(end\))d(a)i(n)m(um)m(b)s(ered)e
(sequence)i(of)g(k)m(eyw)m(ords)g(in)m(to)g(the)g(CHU.)g(The)f
(starting)h(index)f(n)m(um)m(b)s(er)227 5488 y(\(nstart\))30
b(m)m(ust)e(b)s(e)g(greater)i(than)f(0.)40 b(One)28 b(ma)m(y)i(app)s
(end)d(the)h(same)i(commen)m(t)f(to)h(ev)m(ery)f(k)m(eyw)m(ord)g(\(and)
227 5601 y(eliminate)35 b(the)f(need)f(to)h(ha)m(v)m(e)g(an)f(arra)m(y)
h(of)f(iden)m(tical)j(commen)m(t)e(strings,)g(one)f(for)h(eac)m(h)g(k)m
(eyw)m(ord\))g(b)m(y)227 5714 y(including)24 b(the)h(amp)s(ersand)e(c)m
(haracter)j(as)e(the)h(last)g(non-blank)f(c)m(haracter)i(in)e(the)g
(\(\014rst\))h(COMMENTS)p eop end
%%Page: 101 109
TeXDict begin 101 108 bop 0 299 a Fh(9.3.)72 b(SPECIALIZED)29
b(HEADER)i(KEYW)m(ORD)g(R)m(OUTINES)1465 b Fj(101)227
555 y(string)23 b(parameter.)38 b(This)22 b(same)h(string)f(will)h
(then)f(b)s(e)g(used)f(for)h(the)h(commen)m(t)g(\014eld)f(in)g(all)i
(the)e(k)m(eyw)m(ords.)227 668 y(One)32 b(ma)m(y)h(also)g(en)m(ter)f(a)
h(n)m(ull)f(p)s(oin)m(ter)g(for)g(the)g(commen)m(t)h(parameter)g(to)f
(lea)m(v)m(e)j(the)d(commen)m(t)h(\014eld)f(of)227 781
y(the)f(k)m(eyw)m(ord)g(blank.)95 995 y Fe(int)47 b
(fits_write_keys_str)c(/)k(ffpkns)286 1107 y(\(fitsfile)f(*fptr,)g
(char)g(*keyroot,)g(int)h(nstart,)e(int)i(nkeys,)334
1220 y(char)g(**value,)e(char)i(**comment,)e(>)i(int)g(*status\))95
1446 y(int)g(fits_write_keys_[log,)42 b(lng])47 b(/)g(ffpkn[lj])286
1559 y(\(fitsfile)f(*fptr,)g(char)g(*keyroot,)g(int)h(nstart,)e(int)i
(nkeys,)334 1672 y(DTYPE)f(*numval,)g(char)h(**comment,)e(int)i
(*status\))95 1898 y(int)g(fits_write_keys_[flt,)42 b(dbl,)47
b(fixflg,)f(fixdbl])g(/)h(ffpkne[edfg])286 2011 y(\(fitsfile)f(*fptr,)g
(char)g(*keyroot,)g(int)h(nstart,)e(int)i(nkey,)334 2124
y(DTYPE)f(*numval,)g(int)h(decimals,)e(char)i(**comment,)e(>)i(int)g
(*status\))0 2337 y Fi(4)81 b Fj(Cop)m(y)21 b(an)h(indexed)f(k)m(eyw)m
(ord)i(from)e(one)h(HDU)h(to)f(another,)i(mo)s(difying)e(the)g(index)f
(n)m(um)m(b)s(er)f(of)i(the)g(k)m(eyw)m(ord)227 2450
y(name)37 b(in)f(the)g(pro)s(cess.)58 b(F)-8 b(or)37
b(example,)i(this)d(routine)h(could)f(read)g(the)h(TLMIN3)f(k)m(eyw)m
(ord)h(from)f(the)227 2563 y(input)30 b(HDU)h(\(b)m(y)g(giving)h(k)m
(eyro)s(ot)f(=)g(`TLMIN')g(and)f(inn)m(um)f(=)h(3\))i(and)e(write)h(it)
g(to)g(the)g(output)f(HDU)227 2676 y(with)36 b(the)g(k)m(eyw)m(ord)h
(name)f(TLMIN4)g(\(b)m(y)g(setting)i(outn)m(um)d(=)h(4\).)58
b(If)36 b(the)g(input)f(k)m(eyw)m(ord)i(do)s(es)f(not)227
2789 y(exist,)c(then)e(this)g(routine)g(simply)g(returns)f(without)i
(indicating)g(an)f(error.)95 3002 y Fe(int)47 b(fits_copy_key)e(/)i
(ffcpky)286 3115 y(\(fitsfile)f(*infptr,)f(fitsfile)h(*outfptr,)f(int)i
(innum,)f(int)h(outnum,)334 3228 y(char)g(*keyroot,)e(>)i(int)g
(*status\))0 3442 y Fi(5)81 b Fj(W)-8 b(rite)30 b(\(app)s(end\))f(a)h
(`triple)f(precision')h(k)m(eyw)m(ord)g(in)m(to)g(the)g(CHU)f(in)g
(F28.16)j(format.)41 b(The)29 b(\015oating)h(p)s(oin)m(t)227
3555 y(k)m(eyw)m(ord)g(v)-5 b(alue)30 b(is)f(constructed)h(b)m(y)f
(concatenating)j(the)d(input)g(in)m(teger)i(v)-5 b(alue)29
b(with)g(the)h(input)e(double)227 3668 y(precision)35
b(fraction)f(v)-5 b(alue)35 b(\(whic)m(h)f(m)m(ust)g(ha)m(v)m(e)i(a)e
(v)-5 b(alue)35 b(b)s(et)m(w)m(een)f(0.0)i(and)d(1.0\).)53
b(The)34 b(\013gkyt)h(routine)227 3781 y(should)d(b)s(e)h(used)f(to)i
(read)f(this)g(k)m(eyw)m(ord)h(v)-5 b(alue,)35 b(b)s(ecause)e(the)g
(other)h(k)m(eyw)m(ord)f(reading)h(routines)f(will)227
3893 y(not)e(preserv)m(e)f(the)h(full)f(precision)h(of)f(the)h(v)-5
b(alue.)95 4107 y Fe(int)47 b(fits_write_key_triple)42
b(/)48 b(ffpkyt)286 4220 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g
(long)g(intval,)g(double)g(frac,)334 4333 y(char)h(*comment,)e(>)i(int)
g(*status\))0 4546 y Fi(6)81 b Fj(W)-8 b(rite)37 b(k)m(eyw)m(ords)f(to)
h(the)f(CHDU)g(that)h(are)f(de\014ned)f(in)h(an)g(ASCI)s(I)e(template)j
(\014le.)58 b(The)35 b(format)i(of)f(the)227 4659 y(template)c(\014le)f
(is)f(describ)s(ed)f(under)g(the)i(\014ts)p 1788 4659
28 4 v 32 w(parse)p 2028 4659 V 33 w(template)g(routine.)95
4873 y Fe(int)47 b(fits_write_key_template)42 b(/)47
b(ffpktp)286 4986 y(\(fitsfile)f(*fptr,)g(const)g(char)h(*filename,)e
(>)i(int)g(*status\))0 5269 y Fd(9.3.4)112 b(Insert)38
b(Keyw)m(ord)f(Routines)0 5488 y Fj(These)42 b(insert)h(routines)f(are)
h(somewhat)g(less)f(e\016cien)m(t)i(than)f(the)f(`up)s(date')g(or)h
(`write')g(k)m(eyw)m(ord)g(routines)0 5601 y(b)s(ecause)30
b(the)g(follo)m(wing)i(k)m(eyw)m(ords)e(in)g(the)g(header)g(m)m(ust)g
(b)s(e)f(shifted)h(do)m(wn)f(to)i(mak)m(e)g(ro)s(om)f(for)g(the)g
(inserted)0 5714 y(k)m(eyw)m(ord.)41 b(See)31 b(App)s(endix)d(B)j(for)f
(the)h(de\014nition)f(of)g(the)h(parameters)g(used)e(in)h(these)h
(routines.)p eop end
%%Page: 102 110
TeXDict begin 102 109 bop 0 299 a Fj(102)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fi(1)81 b Fj(Insert)26 b(a)h(new)f(k)m(eyw)m(ord)
h(record)g(in)m(to)g(the)g(CHU)g(at)g(the)g(sp)s(eci\014ed)f(p)s
(osition)h(\(i.e.,)i(immediately)f(preceding)227 668
y(the)j(\(k)m(eyn)m(um\)th)g(k)m(eyw)m(ord)g(in)f(the)g(header.\))95
921 y Fe(int)47 b(fits_insert_record)c(/)48 b(ffirec)286
1034 y(\(fitsfile)e(*fptr,)g(int)h(keynum,)e(char)i(*card,)f(>)i(int)f
(*status\))0 1286 y Fi(2)81 b Fj(Insert)24 b(a)h(new)g(k)m(eyw)m(ord)g
(in)m(to)h(the)f(CHU.)g(The)g(new)f(k)m(eyw)m(ord)i(is)f(inserted)f
(immediately)j(follo)m(wing)f(the)f(last)227 1399 y(k)m(eyw)m(ord)i
(that)f(has)f(b)s(een)h(read)f(from)h(the)g(header.)39
b(The)25 b(`longstr')i(v)m(ersion)f(has)f(the)h(same)g(functionalit)m
(y)227 1512 y(as)33 b(the)g(`str')f(v)m(ersion)h(except)h(that)f(it)g
(also)g(supp)s(orts)e(the)h(lo)s(cal)i(long)f(string)g(k)m(eyw)m(ord)g
(con)m(v)m(en)m(tion)h(for)227 1625 y(strings)29 b(longer)g(than)g(68)h
(c)m(haracters.)41 b(A)29 b(n)m(ull)g(p)s(oin)m(ter)g(ma)m(y)g(b)s(e)g
(en)m(tered)g(for)g(the)g(commen)m(t)g(parameter)227
1738 y(whic)m(h)d(will)f(cause)h(the)g(commen)m(t)h(\014eld)e(to)h(b)s
(e)f(left)h(blank.)39 b(The)25 b(\015t,)h(dbl,)g(cmp,)h(and)e(dblcmp)f
(v)m(ersions)i(of)227 1851 y(this)k(routine)g(ha)m(v)m(e)h(the)e(added)
g(feature)i(that)f(if)g(the)g('decimals')h(parameter)f(is)g(negativ)m
(e,)i(then)d(the)h('G')227 1964 y(displa)m(y)g(format)g(rather)f(then)g
(the)h('E')f(format)h(will)g(b)s(e)f(used)f(when)h(constructing)h(the)f
(k)m(eyw)m(ord)h(v)-5 b(alue,)227 2077 y(taking)27 b(the)g(absolute)g
(v)-5 b(alue)26 b(of)h('decimals')g(for)f(the)h(precision.)39
b(This)26 b(will)g(suppress)e(trailing)k(zeros,)g(and)227
2189 y(will)37 b(use)g(a)g(\014xed)f(format)h(rather)g(than)f(an)h(exp)
s(onen)m(tial)g(format,)i(dep)s(ending)c(on)i(the)g(magnitude)g(of)227
2302 y(the)31 b(v)-5 b(alue.)95 2555 y Fe(int)47 b(fits_insert_card)d
(/)j(ffikey)286 2668 y(\(fitsfile)f(*fptr,)g(char)g(*card,)g(>)i(int)f
(*status\))95 2894 y(int)g(fits_insert_key_[str,)42 b(longstr])k(/)h
(ffi[kys,)f(kls])286 3007 y(\(fitsfile)g(*fptr,)g(char)g(*keyname,)g
(char)g(*value,)g(char)h(*comment,)334 3120 y(>)h(int)e(*status\))95
3345 y(int)h(fits_insert_key_[log,)42 b(lng])47 b(/)g(ffiky[lj])286
3458 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)g(numval,)g(char)
g(*comment,)334 3571 y(>)i(int)e(*status\))95 3797 y(int)h
(fits_insert_key_[flt,)42 b(fixflt,)k(dbl,)h(fixdbl])f(/)h(ffiky[edfg])
286 3910 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)g(numval,)g
(int)h(decimals,)334 4023 y(char)g(*comment,)e(>)i(int)g(*status\))95
4249 y(int)g(fits_insert_key_[cmp,)42 b(dblcmp,)k(fixcmp,)g(fixdblcmp])
f(/)i(ffik[yc,ym,fc,fm])286 4362 y(\(fitsfile)f(*fptr,)g(char)g
(*keyname,)g(DTYPE)g(*numval,)g(int)g(decimals,)334 4474
y(char)h(*comment,)e(>)i(int)g(*status\))0 4727 y Fi(3)81
b Fj(Insert)32 b(a)i(new)f(k)m(eyw)m(ord)h(with)f(an)h(unde\014ned,)e
(or)h(n)m(ull,)h(v)-5 b(alue)34 b(in)m(to)h(the)e(CHU.)h(The)f(v)-5
b(alue)34 b(string)f(of)h(the)227 4840 y(k)m(eyw)m(ord)d(is)g(left)g
(blank)f(in)g(this)g(case.)95 5093 y Fe(int)47 b(fits_insert_key_null)c
(/)k(ffikyu)286 5205 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g
(*comment,)g(>)h(int)g(*status\))0 5495 y Fd(9.3.5)112
b(Read)38 b(Keyw)m(ord)g(Routines)0 5714 y Fj(Wild)31
b(card)f(c)m(haracters)i(ma)m(y)f(b)s(e)f(used)f(when)h(sp)s(ecifying)g
(the)g(name)h(of)f(the)h(k)m(eyw)m(ord)g(to)g(b)s(e)f(read.)p
eop end
%%Page: 103 111
TeXDict begin 103 110 bop 0 299 a Fh(9.3.)72 b(SPECIALIZED)29
b(HEADER)i(KEYW)m(ORD)g(R)m(OUTINES)1465 b Fj(103)0 555
y Fi(1)81 b Fj(Read)43 b(a)h(k)m(eyw)m(ord)g(v)-5 b(alue)43
b(\(with)h(the)f(appropriate)h(data)g(t)m(yp)s(e\))g(and)e(commen)m(t)j
(from)e(the)g(CHU.)h(If)f(a)227 668 y(NULL)32 b(commen)m(t)h(p)s(oin)m
(ter)f(is)h(giv)m(en)g(on)f(input,)f(then)h(the)g(commen)m(t)i(string)e
(will)g(not)g(b)s(e)g(returned.)44 b(If)227 781 y(the)32
b(v)-5 b(alue)33 b(of)f(the)g(k)m(eyw)m(ord)g(is)g(not)h(de\014ned)d
(\(i.e.,)k(the)e(v)-5 b(alue)33 b(\014eld)e(is)h(blank\))g(then)g(an)g
(error)f(status)h(=)227 894 y(V)-10 b(ALUE)p 545 894
28 4 v 33 w(UNDEFINED)29 b(will)f(b)s(e)g(returned)e(and)h(the)h(input)
f(v)-5 b(alue)28 b(will)h(not)f(b)s(e)f(c)m(hanged)h(\(except)h(that)
227 1007 y(\013gkys)i(will)g(reset)g(the)f(v)-5 b(alue)31
b(to)g(a)g(n)m(ull)f(string\).)95 1252 y Fe(int)47 b(fits_read_key_str)
c(/)48 b(ffgkys)286 1365 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(>)h
(char)g(*value,)f(char)g(*comment,)334 1478 y(int)h(*status\);)95
1704 y(NOTE:)g(after)f(calling)g(the)h(following)e(routine,)h(programs)
f(must)i(explicitly)e(free)382 1817 y(the)i(memory)f(allocated)f(for)i
('longstr')e(after)i(it)g(is)g(no)g(longer)f(needed)g(or)382
1930 y(call)g(fits_free_memory.)95 2155 y(int)h(fits_read_key_longstr)
42 b(/)48 b(ffgkls)286 2268 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g
(>)h(char)g(**longstr,)e(char)h(*comment,)620 2381 y(int)h(*status\))95
2607 y(int)g(fits_free_memory)d(/)j(fffree)286 2720 y(\(char)g
(*longstr,)e(int)i(*status\);)95 2946 y(int)g(fits_read_key_[log,)c
(lng,)k(flt,)f(dbl,)h(cmp,)f(dblcmp])g(/)i(ffgky[ljedcm])286
3059 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(>)h(DTYPE)f(*numval,)g
(char)h(*comment,)334 3172 y(int)g(*status\))95 3397
y(int)g(fits_read_key_lnglng)c(/)k(ffgkyjj)286 3510 y(\(fitsfile)f
(*fptr,)g(char)g(*keyname,)g(>)h(LONGLONG)f(*numval,)f(char)i
(*comment,)334 3623 y(int)g(*status\))0 3868 y Fi(2)81
b Fj(Read)36 b(a)h(sequence)f(of)h(indexed)e(k)m(eyw)m(ord)i(v)-5
b(alues)37 b(\(e.g.,)i(NAXIS1,)g(NAXIS2,)f(...\).)59
b(The)36 b(input)f(starting)227 3981 y(index)j(n)m(um)m(b)s(er)e
(\(nstart\))j(m)m(ust)f(b)s(e)f(greater)i(than)e(0.)64
b(If)37 b(the)h(v)-5 b(alue)38 b(of)g(an)m(y)h(of)f(the)g(k)m(eyw)m
(ords)g(is)g(not)227 4094 y(de\014ned)c(\(i.e.,)j(the)e(v)-5
b(alue)35 b(\014eld)f(is)h(blank\))g(then)f(an)g(error)h(status)g(=)f
(V)-10 b(ALUE)p 3009 4094 V 33 w(UNDEFINED)36 b(will)f(b)s(e)227
4207 y(returned)21 b(and)h(the)h(input)e(v)-5 b(alue)23
b(for)f(the)g(unde\014ned)e(k)m(eyw)m(ord\(s\))k(will)e(not)h(b)s(e)e
(c)m(hanged.)39 b(These)22 b(routines)227 4320 y(do)j(not)h(supp)s(ort)
d(wild)i(card)h(c)m(haracters)g(in)f(the)h(ro)s(ot)f(name.)39
b(If)25 b(there)h(are)f(no)g(indexed)g(k)m(eyw)m(ords)h(in)f(the)227
4433 y(header)35 b(with)f(the)h(input)e(ro)s(ot)i(name)g(then)f(these)h
(routines)g(do)f(not)h(return)e(a)i(non-zero)h(status)e(v)-5
b(alue)227 4546 y(and)30 b(instead)h(simply)f(return)f(nfound)f(=)i(0.)
95 4791 y Fe(int)47 b(fits_read_keys_str)c(/)48 b(ffgkns)286
4904 y(\(fitsfile)e(*fptr,)g(char)g(*keyname,)g(int)h(nstart,)e(int)i
(nkeys,)334 5017 y(>)h(char)e(**value,)g(int)h(*nfound,)93
b(int)47 b(*status\))95 5243 y(int)g(fits_read_keys_[log,)c(lng,)j
(flt,)h(dbl])g(/)g(ffgkn[ljed])286 5356 y(\(fitsfile)f(*fptr,)g(char)g
(*keyname,)g(int)h(nstart,)e(int)i(nkeys,)334 5469 y(>)h(DTYPE)e
(*numval,)f(int)i(*nfound,)f(int)h(*status\))0 5714 y
Fi(3)81 b Fj(Read)37 b(the)h(v)-5 b(alue)38 b(of)g(a)g(\015oating)g(p)s
(oin)m(t)g(k)m(eyw)m(ord,)i(returning)d(the)h(in)m(teger)h(and)e
(fractional)i(parts)e(of)h(the)p eop end
%%Page: 104 112
TeXDict begin 104 111 bop 0 299 a Fj(104)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(v)-5 b(alue)35 b(in)e(separate)i(routine)f
(argumen)m(ts.)52 b(This)33 b(routine)h(ma)m(y)g(b)s(e)f(used)h(to)g
(read)g(an)m(y)g(k)m(eyw)m(ord)h(but)e(is)227 668 y(esp)s(ecially)f
(useful)d(for)i(reading)f(the)h('triple)g(precision')f(k)m(eyw)m(ords)h
(written)g(b)m(y)f(\013pkyt.)95 929 y Fe(int)47 b(fits_read_key_triple)
c(/)k(ffgkyt)286 1042 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(>)h
(long)g(*intval,)e(double)h(*frac,)334 1155 y(char)h(*comment,)e(int)i
(*status\))0 1446 y Fd(9.3.6)112 b(Mo)s(dify)39 b(Keyw)m(ord)e
(Routines)0 1666 y Fj(These)31 b(routines)h(mo)s(dify)f(the)h(v)-5
b(alue)32 b(of)g(an)g(existing)g(k)m(eyw)m(ord.)46 b(An)31
b(error)g(is)h(returned)e(if)i(the)g(k)m(eyw)m(ord)g(do)s(es)0
1778 y(not)43 b(exist.)77 b(Wild)43 b(card)g(c)m(haracters)h(ma)m(y)f
(b)s(e)f(used)f(when)h(sp)s(ecifying)g(the)h(name)f(of)h(the)f(k)m(eyw)
m(ord)h(to)h(b)s(e)0 1891 y(mo)s(di\014ed.)c(See)30 b(App)s(endix)f(B)i
(for)f(the)g(de\014nition)g(of)h(the)f(parameters)h(used)f(in)g(these)h
(routines.)0 2152 y Fi(1)81 b Fj(Mo)s(dify)30 b(\(o)m(v)m(erwrite\))i
(the)f(n)m(th)f(80-c)m(haracter)j(header)d(record)h(in)f(the)g(CHU.)95
2413 y Fe(int)47 b(fits_modify_record)c(/)48 b(ffmrec)286
2526 y(\(fitsfile)e(*fptr,)g(int)h(keynum,)e(char)i(*card,)f(>)i(int)f
(*status\))0 2786 y Fi(2)81 b Fj(Mo)s(dify)37 b(\(o)m(v)m(erwrite\))j
(the)e(80-c)m(haracter)j(header)c(record)h(for)f(the)h(named)f(k)m(eyw)
m(ord)h(in)g(the)g(CHU.)g(This)227 2899 y(can)31 b(b)s(e)f(used)f(to)i
(o)m(v)m(erwrite)h(the)f(name)f(of)h(the)f(k)m(eyw)m(ord)h(as)g(w)m
(ell)g(as)g(its)g(v)-5 b(alue)30 b(and)g(commen)m(t)i(\014elds.)95
3160 y Fe(int)47 b(fits_modify_card)d(/)j(ffmcrd)286
3273 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g(*card,)g(>)i
(int)f(*status\))0 3534 y Fi(5)81 b Fj(Mo)s(dify)30 b(the)g(v)-5
b(alue)31 b(and)e(commen)m(t)i(\014elds)f(of)g(an)g(existing)h(k)m(eyw)
m(ord)g(in)f(the)g(CHU.)h(The)e(`longstr')i(v)m(ersion)227
3647 y(has)41 b(the)h(same)f(functionalit)m(y)i(as)e(the)h(`str')f(v)m
(ersion)h(except)g(that)g(it)g(also)g(supp)s(orts)d(the)j(lo)s(cal)g
(long)227 3760 y(string)29 b(k)m(eyw)m(ord)h(con)m(v)m(en)m(tion)h(for)
e(strings)f(longer)i(than)f(68)h(c)m(haracters.)41 b(Optionally)-8
b(,)31 b(one)e(ma)m(y)h(mo)s(dify)227 3872 y(only)e(the)g(v)-5
b(alue)28 b(\014eld)g(and)f(lea)m(v)m(e)j(the)e(commen)m(t)h(\014eld)e
(unc)m(hanged)h(b)m(y)g(setting)g(the)g(input)f(COMMENT)227
3985 y(parameter)c(equal)h(to)f(the)g(amp)s(ersand)e(c)m(haracter)j
(\(&\))f(or)g(b)m(y)g(en)m(tering)g(a)g(n)m(ull)g(p)s(oin)m(ter)g(for)f
(the)h(commen)m(t)227 4098 y(parameter.)40 b(The)24 b(\015t,)i(dbl,)g
(cmp,)f(and)g(dblcmp)e(v)m(ersions)j(of)f(this)g(routine)g(ha)m(v)m(e)h
(the)f(added)f(feature)h(that)227 4211 y(if)h(the)h('decimals')g
(parameter)g(is)f(negativ)m(e,)k(then)c(the)g('G')h(displa)m(y)f
(format)h(rather)f(then)g(the)g('E')h(format)227 4324
y(will)i(b)s(e)f(used)f(when)h(constructing)h(the)f(k)m(eyw)m(ord)h(v)
-5 b(alue,)30 b(taking)f(the)g(absolute)g(v)-5 b(alue)29
b(of)f('decimals')i(for)227 4437 y(the)37 b(precision.)60
b(This)35 b(will)i(suppress)e(trailing)i(zeros,)i(and)d(will)h(use)g(a)
g(\014xed)e(format)i(rather)g(than)f(an)227 4550 y(exp)s(onen)m(tial)c
(format,)f(dep)s(ending)d(on)j(the)f(magnitude)h(of)f(the)h(v)-5
b(alue.)95 4811 y Fe(int)47 b(fits_modify_key_[str,)42
b(longstr])k(/)h(ffm[kys,)f(kls])286 4924 y(\(fitsfile)g(*fptr,)g(char)
g(*keyname,)g(char)g(*value,)g(char)h(*comment,)334 5036
y(>)h(int)e(*status\);)95 5262 y(int)h(fits_modify_key_[log,)42
b(lng])47 b(/)g(ffmky[lj])286 5375 y(\(fitsfile)f(*fptr,)g(char)g
(*keyname,)g(DTYPE)g(numval,)g(char)g(*comment,)334 5488
y(>)i(int)e(*status\))95 5714 y(int)h(fits_modify_key_[flt,)42
b(dbl,)47 b(fixflt,)f(fixdbl])g(/)h(ffmky[edfg])p eop
end
%%Page: 105 113
TeXDict begin 105 112 bop 0 299 a Fh(9.3.)72 b(SPECIALIZED)29
b(HEADER)i(KEYW)m(ORD)g(R)m(OUTINES)1465 b Fj(105)286
555 y Fe(\(fitsfile)46 b(*fptr,)g(char)g(*keyname,)g(DTYPE)g(numval,)g
(int)h(decimals,)334 668 y(char)g(*comment,)e(>)i(int)g(*status\))95
894 y(int)g(fits_modify_key_[cmp,)42 b(dblcmp,)k(fixcmp,)g(fixdblcmp])f
(/)i(ffmk[yc,ym,fc,fm])286 1007 y(\(fitsfile)f(*fptr,)g(char)g
(*keyname,)g(DTYPE)g(*numval,)g(int)g(decimals,)334 1120
y(char)h(*comment,)e(>)i(int)g(*status\))0 1431 y Fi(6)81
b Fj(Mo)s(dify)22 b(the)g(v)-5 b(alue)23 b(of)f(an)g(existing)i(k)m
(eyw)m(ord)e(to)h(b)s(e)f(unde\014ned,)g(or)g(n)m(ull.)38
b(The)22 b(v)-5 b(alue)22 b(string)h(of)f(the)g(k)m(eyw)m(ord)227
1544 y(is)30 b(set)h(to)g(blank.)40 b(Optionally)-8 b(,)31
b(one)f(ma)m(y)h(lea)m(v)m(e)h(the)f(commen)m(t)g(\014eld)e(unc)m
(hanged)h(b)m(y)g(setting)h(the)f(input)227 1657 y(COMMENT)f(parameter)
g(equal)g(to)g(the)g(amp)s(ersand)e(c)m(haracter)k(\(&\))e(or)f(b)m(y)h
(en)m(tering)g(a)g(n)m(ull)g(p)s(oin)m(ter.)95 1968 y
Fe(int)47 b(fits_modify_key_null)c(/)k(ffmkyu)286 2081
y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(char)g(*comment,)g(>)h(int)g
(*status\))0 2433 y Fd(9.3.7)112 b(Up)s(date)39 b(Keyw)m(ord)e
(Routines)0 2680 y Fi(1)81 b Fj(These)29 b(up)s(date)g(routines)h(mo)s
(dify)f(the)g(v)-5 b(alue,)31 b(and)e(optionally)i(the)f(commen)m(t)h
(\014eld,)f(of)g(the)g(k)m(eyw)m(ord)g(if)f(it)227 2793
y(already)34 b(exists,)g(otherwise)f(the)g(new)f(k)m(eyw)m(ord)h(is)f
(app)s(ended)f(to)j(the)f(header.)47 b(A)33 b(separate)g(routine)g(is)
227 2906 y(pro)m(vided)c(for)g(eac)m(h)h(k)m(eyw)m(ord)f(data)h(t)m(yp)
s(e.)41 b(The)28 b(`longstr')i(v)m(ersion)g(has)e(the)i(same)f
(functionalit)m(y)h(as)g(the)227 3019 y(`str')h(v)m(ersion)g(except)h
(that)g(it)f(also)h(supp)s(orts)c(the)j(lo)s(cal)h(long)g(string)e(k)m
(eyw)m(ord)i(con)m(v)m(en)m(tion)h(for)d(strings)227
3132 y(longer)i(than)f(68)h(c)m(haracters.)45 b(A)31
b(n)m(ull)g(p)s(oin)m(ter)h(ma)m(y)f(b)s(e)g(en)m(tered)h(for)f(the)g
(commen)m(t)i(parameter)e(whic)m(h)227 3245 y(will)i(lea)m(v)m(e)h(the)
f(commen)m(t)g(\014eld)f(unc)m(hanged)g(or)g(blank.)46
b(The)31 b(\015t,)i(dbl,)f(cmp,)h(and)e(dblcmp)g(v)m(ersions)i(of)227
3357 y(this)d(routine)g(ha)m(v)m(e)h(the)e(added)g(feature)i(that)f(if)
g(the)g('decimals')h(parameter)f(is)g(negativ)m(e,)i(then)d(the)h('G')
227 3470 y(displa)m(y)g(format)g(rather)f(then)g(the)h('E')f(format)h
(will)g(b)s(e)f(used)f(when)h(constructing)h(the)f(k)m(eyw)m(ord)h(v)-5
b(alue,)227 3583 y(taking)27 b(the)g(absolute)g(v)-5
b(alue)26 b(of)h('decimals')g(for)f(the)h(precision.)39
b(This)26 b(will)g(suppress)e(trailing)k(zeros,)g(and)227
3696 y(will)37 b(use)g(a)g(\014xed)f(format)h(rather)g(than)f(an)h(exp)
s(onen)m(tial)g(format,)i(dep)s(ending)c(on)i(the)g(magnitude)g(of)227
3809 y(the)31 b(v)-5 b(alue.)95 4121 y Fe(int)47 b
(fits_update_key_[str,)42 b(longstr])k(/)h(ffu[kys,)f(kls])286
4233 y(\(fitsfile)g(*fptr,)g(char)g(*keyname,)g(char)g(*value,)g(char)h
(*comment,)334 4346 y(>)h(int)e(*status\))95 4572 y(int)h
(fits_update_key_[log,)42 b(lng])47 b(/)g(ffuky[lj])286
4685 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)g(numval,)g(char)
g(*comment,)334 4798 y(>)i(int)e(*status\))95 5024 y(int)h
(fits_update_key_[flt,)42 b(dbl,)47 b(fixflt,)f(fixdbl])g(/)h
(ffuky[edfg])286 5137 y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)
g(numval,)g(int)h(decimals,)334 5250 y(char)g(*comment,)e(>)i(int)g
(*status\))95 5475 y(int)g(fits_update_key_[cmp,)42 b(dblcmp,)k
(fixcmp,)g(fixdblcmp])f(/)i(ffuk[yc,ym,fc,fm])286 5588
y(\(fitsfile)f(*fptr,)g(char)g(*keyname,)g(DTYPE)g(*numval,)g(int)g
(decimals,)334 5701 y(char)h(*comment,)e(>)i(int)g(*status\))p
eop end
%%Page: 106 114
TeXDict begin 106 113 bop 0 299 a Fj(106)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Ff(9.4)135 b(De\014ne)45 b(Data)h(Scaling)g(and)e
(Unde\014ned)h(Pixel)h(P)l(arameters)0 805 y Fj(These)37
b(routines)g(set)h(or)f(mo)s(dify)g(the)g(in)m(ternal)h(parameters)g
(used)e(b)m(y)i(CFITSIO)d(to)j(either)g(scale)h(the)e(data)0
918 y(or)f(to)h(represen)m(t)f(unde\014ned)d(pixels.)58
b(Generally)37 b(CFITSIO)d(will)j(scale)g(the)f(data)h(according)g(to)f
(the)h(v)-5 b(alues)0 1031 y(of)35 b(the)f(BSCALE)g(and)g(BZER)m(O)h
(\(or)g(TSCALn)d(and)i(TZER)m(On\))g(k)m(eyw)m(ords,)i(ho)m(w)m(ev)m
(er)g(these)f(routines)f(ma)m(y)0 1144 y(b)s(e)e(used)h(to)h(o)m(v)m
(erride)g(the)f(k)m(eyw)m(ord)h(v)-5 b(alues.)49 b(This)32
b(ma)m(y)i(b)s(e)f(useful)f(when)g(one)i(w)m(an)m(ts)f(to)h(read)f(or)g
(write)h(the)0 1257 y(ra)m(w)e(unscaled)g(v)-5 b(alues)33
b(in)f(the)g(FITS)f(\014le.)47 b(Similarly)-8 b(,)33
b(CFITSIO)e(generally)i(uses)f(the)g(v)-5 b(alue)33 b(of)f(the)h(BLANK)
0 1370 y(or)40 b(TNULLn)f(k)m(eyw)m(ord)h(to)h(signify)e(an)h
(unde\014ned)e(pixel,)43 b(but)c(these)h(routines)g(ma)m(y)g(b)s(e)f
(used)g(to)i(o)m(v)m(erride)0 1483 y(this)32 b(v)-5 b(alue.)48
b(These)32 b(routines)g(do)h(not)f(create)i(or)f(mo)s(dify)e(the)i
(corresp)s(onding)e(header)i(k)m(eyw)m(ord)f(v)-5 b(alues.)48
b(See)0 1596 y(App)s(endix)29 b(B)h(for)h(the)f(de\014nition)g(of)h
(the)f(parameters)h(used)e(in)i(these)f(routines.)0 1827
y Fi(1)81 b Fj(Reset)26 b(the)g(scaling)g(factors)g(in)f(the)h(primary)
f(arra)m(y)h(or)f(image)i(extension;)h(do)s(es)d(not)g(c)m(hange)i(the)
f(BSCALE)227 1940 y(and)i(BZER)m(O)g(k)m(eyw)m(ord)h(v)-5
b(alues)28 b(and)g(only)g(a\013ects)i(the)e(automatic)j(scaling)e(p)s
(erformed)e(when)g(the)h(data)227 2053 y(elemen)m(ts)f(are)f
(written/read)g(to/from)g(the)g(FITS)f(\014le.)39 b(When)25
b(reading)h(from)f(a)h(FITS)f(\014le)g(the)h(returned)227
2166 y(data)i(v)-5 b(alue)28 b(=)f(\(the)h(v)-5 b(alue)28
b(giv)m(en)h(in)e(the)g(FITS)g(arra)m(y\))h(*)g(BSCALE)f(+)g(BZER)m(O.)
g(The)g(in)m(v)m(erse)i(form)m(ula)227 2279 y(is)i(used)e(when)h
(writing)g(data)h(v)-5 b(alues)31 b(to)g(the)f(FITS)g(\014le.)95
2511 y Fe(int)47 b(fits_set_bscale)d(/)j(ffpscl)286 2624
y(\(fitsfile)f(*fptr,)g(double)g(scale,)g(double)g(zero,)g(>)i(int)f
(*status\))0 2856 y Fi(2)81 b Fj(Reset)39 b(the)f(scaling)i(parameters)
e(for)h(a)f(table)h(column;)k(do)s(es)38 b(not)g(c)m(hange)i(the)e
(TSCALn)f(or)h(TZER)m(On)227 2968 y(k)m(eyw)m(ord)29
b(v)-5 b(alues)29 b(and)e(only)i(a\013ects)g(the)g(automatic)h(scaling)
f(p)s(erformed)e(when)g(the)i(data)g(elemen)m(ts)h(are)227
3081 y(written/read)i(to/from)g(the)g(FITS)f(\014le.)44
b(When)31 b(reading)g(from)g(a)h(FITS)f(\014le)g(the)h(returned)e(data)
i(v)-5 b(alue)227 3194 y(=)25 b(\(the)i(v)-5 b(alue)26
b(giv)m(en)g(in)f(the)h(FITS)f(arra)m(y\))h(*)g(TSCAL)e(+)i(TZER)m(O.)e
(The)h(in)m(v)m(erse)i(form)m(ula)f(is)f(used)g(when)227
3307 y(writing)31 b(data)g(v)-5 b(alues)30 b(to)i(the)e(FITS)g(\014le.)
95 3539 y Fe(int)47 b(fits_set_tscale)d(/)j(fftscl)286
3652 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(double)i(scale,)f(double)g
(zero,)334 3765 y(>)i(int)e(*status\))0 3997 y Fi(3)81
b Fj(De\014ne)36 b(the)g(in)m(teger)i(v)-5 b(alue)36
b(to)h(b)s(e)e(used)h(to)h(signify)f(unde\014ned)e(pixels)i(in)g(the)g
(primary)f(arra)m(y)i(or)f(image)227 4109 y(extension.)54
b(This)34 b(is)g(only)h(used)f(if)g(BITPIX)g(=)h(8,)h(16,)g(or)f(32.)54
b(This)34 b(do)s(es)g(not)h(create)h(or)e(c)m(hange)i(the)227
4222 y(v)-5 b(alue)31 b(of)g(the)f(BLANK)h(k)m(eyw)m(ord)g(in)f(the)g
(header.)95 4454 y Fe(int)47 b(fits_set_imgnull)d(/)j(ffpnul)286
4567 y(\(fitsfile)f(*fptr,)g(LONGLONG)f(nulval,)h(>)i(int)e(*status\))0
4799 y Fi(4)81 b Fj(De\014ne)36 b(the)g(string)g(to)g(b)s(e)f(used)g
(to)i(signify)f(unde\014ned)e(pixels)i(in)f(a)h(column)g(in)g(an)f
(ASCI)s(I)g(table.)58 b(This)227 4912 y(do)s(es)30 b(not)h(create)h(or)
e(c)m(hange)i(the)e(v)-5 b(alue)31 b(of)g(the)f(TNULLn)g(k)m(eyw)m
(ord.)95 5143 y Fe(int)47 b(fits_set_atblnull)c(/)48
b(ffsnul)286 5256 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(char)i
(*nulstr,)f(>)h(int)g(*status\))0 5488 y Fi(5)81 b Fj(De\014ne)34
b(the)h(v)-5 b(alue)34 b(to)h(b)s(e)f(used)g(to)h(signify)f
(unde\014ned)e(pixels)j(in)f(an)g(in)m(teger)i(column)e(in)g(a)g
(binary)g(table)227 5601 y(\(where)29 b(TF)m(ORMn)f(=)g('B',)i('I',)f
(or)f('J'\).)i(This)d(do)s(es)i(not)f(create)j(or)d(c)m(hange)i(the)e
(v)-5 b(alue)29 b(of)g(the)g(TNULLn)227 5714 y(k)m(eyw)m(ord.)p
eop end
%%Page: 107 115
TeXDict begin 107 114 bop 0 299 a Fh(9.5.)72 b(SPECIALIZED)29
b(FITS)g(PRIMAR)-8 b(Y)31 b(ARRA)-8 b(Y)32 b(OR)d(IMA)m(GE)j(EXTENSION)
d(I/O)h(R)m(OUTINES)80 b Fj(107)95 555 y Fe(int)47 b(fits_set_btblnull)
c(/)48 b(fftnul)286 668 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e
(LONGLONG)h(nulval,)g(>)h(int)g(*status\))0 995 y Ff(9.5)135
b(Sp)t(ecialized)61 b(FITS)e(Primary)i(Arra)l(y)f(or)h(IMA)l(GE)e
(Extension)j(I/O)306 1144 y(Routines)0 1394 y Fj(These)27
b(routines)h(read)f(or)h(write)g(data)g(v)-5 b(alues)28
b(in)g(the)f(primary)g(data)h(arra)m(y)h(\(i.e.,)g(the)f(\014rst)f(HDU)
i(in)e(the)h(FITS)0 1507 y(\014le\))37 b(or)g(an)f(IMA)m(GE)h
(extension.)60 b(Automatic)39 b(data)e(t)m(yp)s(e)g(con)m(v)m(ersion)g
(is)g(p)s(erformed)e(for)h(if)h(the)g(data)g(t)m(yp)s(e)0
1620 y(of)c(the)g(FITS)f(arra)m(y)h(\(as)g(de\014ned)f(b)m(y)g(the)h
(BITPIX)g(k)m(eyw)m(ord\))g(di\013ers)g(from)f(the)h(data)g(t)m(yp)s(e)
g(of)g(the)g(arra)m(y)g(in)0 1733 y(the)c(calling)i(routine.)40
b(The)28 b(data)i(v)-5 b(alues)29 b(are)h(automatically)i(scaled)d(b)m
(y)g(the)h(BSCALE)e(and)g(BZER)m(O)h(header)0 1846 y(v)-5
b(alues)25 b(as)h(they)f(are)g(b)s(eing)g(written)g(or)g(read)f(from)h
(the)g(FITS)f(arra)m(y)-8 b(.)40 b(Unlik)m(e)26 b(the)f(basic)h
(routines)e(describ)s(ed)g(in)0 1959 y(the)31 b(previous)g(c)m(hapter,)
i(most)e(of)h(these)g(routines)f(sp)s(eci\014cally)h(supp)s(ort)d(the)j
(FITS)e(random)h(groups)f(format.)0 2072 y(See)h(App)s(endix)d(B)j(for)
f(the)h(de\014nition)f(of)g(the)h(parameters)g(used)e(in)h(these)h
(routines.)0 2232 y(The)24 b(more)h(primitiv)m(e)h(reading)f(and)f
(writing)h(routines)f(\(i.)40 b(e.,)26 b(\013ppr)p 2364
2232 28 4 v 32 w(,)g(\013ppn)p 2653 2232 V 31 w(,)g(\013ppn,)f(\013gp)m
(v)p 3185 2232 V 33 w(,)h(or)f(\013gpf)p 3552 2232 V
32 w(\))g(simply)0 2345 y(treat)g(the)g(primary)e(arra)m(y)i(as)f(a)h
(long)g(1-dimensional)g(arra)m(y)g(of)f(pixels,)i(ignoring)f(the)f(in)m
(trinsic)h(dimensionalit)m(y)0 2458 y(of)30 b(the)g(arra)m(y)-8
b(.)42 b(When)30 b(dealing)h(with)e(a)i(2D)g(image,)g(for)f(example,)h
(the)f(application)i(program)e(m)m(ust)g(calculate)0
2571 y(the)i(pixel)g(o\013set)g(in)f(the)h(1-D)h(arra)m(y)f(that)g
(corresp)s(onds)e(to)i(an)m(y)g(particular)g(X,)g(Y)f(co)s(ordinate)i
(in)e(the)g(image.)0 2684 y(C)25 b(programmers)h(should)f(note)h(that)g
(the)h(ordering)e(of)h(arra)m(ys)g(in)g(FITS)f(\014les,)i(and)e(hence)h
(in)g(all)g(the)g(CFITSIO)0 2797 y(calls,)40 b(is)d(more)g(similar)h
(to)f(the)h(dimensionalit)m(y)g(of)f(arra)m(ys)g(in)g(F)-8
b(ortran)38 b(rather)f(than)f(C.)h(F)-8 b(or)38 b(instance)g(if)f(a)0
2910 y(FITS)28 b(image)i(has)e(NAXIS1)h(=)f(100)i(and)e(NAXIS2)h(=)f
(50,)i(then)e(a)h(2-D)h(arra)m(y)f(just)f(large)i(enough)e(to)i(hold)e
(the)0 3022 y(image)k(should)d(b)s(e)h(declared)h(as)f(arra)m
(y[50][100])k(and)c(not)h(as)f(arra)m(y[100][50].)0 3183
y(F)-8 b(or)30 b(con)m(v)m(enience,)i(higher-lev)m(el)g(routines)d(are)
h(also)h(pro)m(vided)e(to)h(sp)s(eci\014cally)h(deal)f(with)f(2D)i
(images)f(\(\013p2d)p 3872 3183 V 0 3296 a(and)c(\013g2d)p
372 3296 V 33 w(\))h(and)f(3D)i(data)f(cub)s(es)f(\(\013p3d)p
1467 3296 V 59 w(and)g(\013g3d)p 1893 3296 V 33 w(\).)40
b(The)26 b(dimensionalit)m(y)i(of)f(the)g(FITS)f(image)i(is)e(passed)0
3408 y(b)m(y)36 b(the)h(naxis1,)h(naxis2,)h(and)d(naxis3)h(parameters)f
(and)g(the)h(declared)f(dimensions)g(of)h(the)f(program)g(arra)m(y)0
3521 y(are)30 b(passed)g(in)f(the)h(dim1)g(and)f(dim2)h(parameters.)41
b(Note)31 b(that)f(the)g(dimensions)f(of)h(the)g(program)g(arra)m(y)g
(ma)m(y)0 3634 y(b)s(e)35 b(larger)h(than)f(the)h(dimensions)f(of)h
(the)g(FITS)e(arra)m(y)-8 b(.)58 b(F)-8 b(or)36 b(example)g(if)g(a)g
(FITS)e(image)j(with)e(NAXIS1)h(=)0 3747 y(NAXIS2)g(=)g(400)h(is)f
(read)g(in)m(to)h(a)g(program)f(arra)m(y)g(whic)m(h)g(is)g(dimensioned)
f(as)i(512)g(x)f(512)h(pixels,)h(then)e(the)0 3860 y(image)g(will)f
(just)f(\014ll)g(the)h(lo)m(w)m(er)h(left)f(corner)f(of)h(the)g(arra)m
(y)g(with)f(pixels)h(in)f(the)h(range)g(1)g(-)g(400)g(in)g(the)f(X)h
(an)0 3973 y(Y)g(directions.)54 b(This)34 b(has)h(the)g(e\013ect)h(of)f
(taking)g(a)h(con)m(tiguous)f(set)h(of)f(pixel)g(v)-5
b(alue)35 b(in)f(the)h(FITS)f(arra)m(y)i(and)0 4086 y(writing)30
b(them)g(to)h(a)f(non-con)m(tiguous)h(arra)m(y)g(in)e(program)h(memory)
g(\(i.e.,)i(there)e(are)h(no)m(w)f(some)g(blank)g(pixels)0
4199 y(around)f(the)i(edge)g(of)g(the)f(image)i(in)e(the)g(program)g
(arra)m(y\).)0 4359 y(The)k(most)i(general)f(set)h(of)f(routines)f
(\(\013pss)p 1560 4359 V 33 w(,)i(\013gsv)p 1836 4359
V 33 w(,)g(and)e(\013gsf)p 2273 4359 V 33 w(\))h(ma)m(y)h(b)s(e)e(used)
g(to)h(transfer)g(a)g(rectangular)0 4472 y(subset)27
b(of)h(the)g(pixels)f(in)h(a)g(FITS)f(N-dimensional)h(image)h(to)f(or)g
(from)f(an)g(arra)m(y)i(whic)m(h)e(has)g(b)s(een)g(declared)h(in)0
4585 y(the)h(calling)h(program.)40 b(The)28 b(fpixel)h(and)f(lpixel)h
(parameters)g(are)g(in)m(teger)h(arra)m(ys)f(whic)m(h)f(sp)s(ecify)g
(the)h(starting)0 4698 y(and)k(ending)f(pixel)i(co)s(ordinate)g(in)f
(eac)m(h)h(dimension)f(\(starting)h(with)f(1,)h(not)g(0\))g(of)f(the)g
(FITS)g(image)h(that)g(is)0 4811 y(to)f(b)s(e)e(read)g(or)h(written.)45
b(It)32 b(is)g(imp)s(ortan)m(t)g(to)h(note)f(that)h(these)f(are)g(the)g
(starting)h(and)e(ending)g(pixels)h(in)g(the)0 4924 y(FITS)i(image,)k
(not)d(in)f(the)h(declared)h(arra)m(y)f(in)f(the)h(program.)54
b(The)35 b(arra)m(y)g(parameter)g(in)g(these)g(routines)g(is)0
5036 y(treated)f(simply)e(as)h(a)f(large)i(one-dimensional)g(arra)m(y)f
(of)f(the)h(appropriate)g(data)g(t)m(yp)s(e)g(con)m(taining)h(the)f
(pixel)0 5149 y(v)-5 b(alues;)37 b(The)d(pixel)h(v)-5
b(alues)35 b(in)g(the)f(FITS)g(arra)m(y)h(are)g(read/written)g(from/to)
h(this)e(program)h(arra)m(y)g(in)f(strict)0 5262 y(sequence)d(without)f
(an)m(y)h(gaps;)g(it)g(is)f(up)f(to)j(the)e(calling)i(routine)e(to)i
(correctly)f(in)m(terpret)g(the)g(dimensionalit)m(y)0
5375 y(of)d(this)f(arra)m(y)-8 b(.)41 b(The)27 b(t)m(w)m(o)i(FITS)e
(reading)h(routines)f(\(\013gsv)p 2018 5375 V 61 w(and)g(\013gsf)p
2415 5375 V 61 w(\))h(also)g(ha)m(v)m(e)h(an)f(`inc')g(parameter)g
(whic)m(h)0 5488 y(de\014nes)33 b(the)h(data)h(sampling)f(in)m(terv)-5
b(al)36 b(in)d(eac)m(h)j(dimension)d(of)h(the)h(FITS)e(arra)m(y)-8
b(.)53 b(F)-8 b(or)35 b(example,)h(if)e(inc[0]=2)0 5601
y(and)i(inc[1]=3)j(when)d(reading)h(a)g(2-dimensional)h(FITS)e(image,)
41 b(then)36 b(only)h(ev)m(ery)h(other)f(pixel)h(in)e(the)i(\014rst)0
5714 y(dimension)30 b(and)g(ev)m(ery)h(3rd)f(pixel)g(in)g(the)h(second)
f(dimension)g(will)h(b)s(e)f(returned)f(to)i(the)f('arra)m(y')i
(parameter.)p eop end
%%Page: 108 116
TeXDict begin 108 115 bop 0 299 a Fj(108)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fj(Tw)m(o)f(t)m(yp)s(es)h(of)f(routines)g(are)h
(pro)m(vided)e(to)i(read)f(the)h(data)g(arra)m(y)f(whic)m(h)g(di\013er)
g(in)g(the)h(w)m(a)m(y)g(unde\014ned)d(pixels)0 668 y(are)38
b(handled.)60 b(The)37 b(\014rst)g(t)m(yp)s(e)g(of)g(routines)h
(\(e.g.,)i(\013gp)m(v)p 2059 668 28 4 v 34 w(\))d(simply)g(return)f(an)
h(arra)m(y)h(of)g(data)g(elemen)m(ts)g(in)0 781 y(whic)m(h)30
b(unde\014ned)f(pixels)h(are)h(set)g(equal)g(to)h(a)f(v)-5
b(alue)31 b(sp)s(eci\014ed)e(b)m(y)i(the)g(user)e(in)i(the)f(`n)m(ulv)
-5 b(al')32 b(parameter.)41 b(An)0 894 y(additional)30
b(feature)f(of)g(these)h(routines)e(is)h(that)h(if)f(the)g(user)f(sets)
h(n)m(ulv)-5 b(al)29 b(=)g(0,)h(then)e(no)h(c)m(hec)m(ks)h(for)f
(unde\014ned)0 1007 y(pixels)c(will)g(b)s(e)g(p)s(erformed,)f(th)m(us)h
(reducing)f(the)h(amoun)m(t)h(of)f(CPU)f(pro)s(cessing.)39
b(The)24 b(second)h(t)m(yp)s(e)g(of)g(routines)0 1120
y(\(e.g.,)36 b(\013gpf)p 413 1120 V 32 w(\))e(returns)e(the)i(data)g
(elemen)m(t)g(arra)m(y)g(and,)g(in)f(addition,)h(a)g(c)m(har)g(arra)m
(y)f(that)h(indicates)h(whether)0 1233 y(the)f(v)-5 b(alue)34
b(of)g(the)f(corresp)s(onding)g(data)h(pixel)g(is)g(unde\014ned)d(\(=)j
(1\))g(or)g(de\014ned)e(\(=)i(0\).)51 b(The)33 b(latter)i(t)m(yp)s(e)f
(of)0 1346 y(routines)d(ma)m(y)h(b)s(e)e(more)i(con)m(v)m(enien)m(t)h
(to)f(use)f(in)g(some)g(circumstances,)i(ho)m(w)m(ev)m(er,)g(it)e
(requires)g(an)g(additional)0 1458 y(arra)m(y)g(of)f(logical)j(v)-5
b(alues)31 b(whic)m(h)f(can)h(b)s(e)e(un)m(wieldy)h(when)g(w)m(orking)g
(with)g(large)i(data)f(arra)m(ys.)0 1732 y Fi(1)81 b
Fj(W)-8 b(rite)31 b(elemen)m(ts)h(in)m(to)f(the)g(FITS)f(data)h(arra)m
(y)-8 b(.)95 2005 y Fe(int)47 b(fits_write_img)d(/)k(ffppr)286
2117 y(\(fitsfile)e(*fptr,)g(int)h(datatype,)e(LONGLONG)g(firstelem,)g
(LONGLONG)h(nelements,)334 2230 y(DTYPE)g(*array,)g(int)h(*status\);)95
2456 y(int)g(fits_write_img_[byt,)c(sht,)j(usht,)h(int,)f(uint,)h(lng,)
f(ulng,)h(lnglng,)e(flt,)i(dbl])g(/)286 2569 y
(ffppr[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286 2682 y(\(fitsfile)f(*fptr,)g
(long)g(group,)g(LONGLONG)g(firstelem,)f(LONGLONG)h(nelements,)334
2795 y(DTYPE)g(*array,)g(>)i(int)f(*status\);)95 3021
y(int)g(fits_write_imgnull)c(/)48 b(ffppn)286 3134 y(\(fitsfile)e
(*fptr,)g(int)h(datatype,)e(LONGLONG)g(firstelem,)g(LONGLONG)h
(nelements,)334 3247 y(DTYPE)g(*array,)g(DTYPE)h(*nulval,)e(>)j(int)f
(*status\);)95 3472 y(int)g(fits_write_imgnull_[byt,)42
b(sht,)k(usht,)h(int,)f(uint,)h(lng,)f(ulng,)h(lnglng,)e(flt,)i(dbl])g
(/)286 3585 y(ffppn[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286
3698 y(\(fitsfile)f(*fptr,)g(long)g(group,)g(LONGLONG)g(firstelem,)525
3811 y(LONGLONG)g(nelements,)f(DTYPE)h(*array,)g(DTYPE)g(nulval,)g(>)h
(int)g(*status\);)0 4084 y Fi(2)81 b Fj(Set)30 b(data)h(arra)m(y)g
(elemen)m(ts)h(as)e(unde\014ned.)95 4357 y Fe(int)47
b(fits_write_img_null)c(/)k(ffppru)286 4470 y(\(fitsfile)f(*fptr,)g
(long)g(group,)g(LONGLONG)g(firstelem,)f(LONGLONG)h(nelements,)334
4583 y(>)i(int)e(*status\))0 4856 y Fi(3)81 b Fj(W)-8
b(rite)32 b(v)-5 b(alues)30 b(in)m(to)i(group)e(parameters.)42
b(This)30 b(routine)g(only)h(applies)g(to)g(the)g(`Random)f(Group)s
(ed')g(FITS)227 4969 y(format)22 b(whic)m(h)f(has)g(b)s(een)f(used)h
(for)g(applications)h(in)f(radio)h(in)m(terferometry)-8
b(,)25 b(but)20 b(is)h(o\016cially)i(deprecated)227 5082
y(for)30 b(future)g(use.)95 5355 y Fe(int)47 b(fits_write_grppar_[byt,)
42 b(sht,)k(usht,)h(int,)f(uint,)h(lng,)f(ulng,)h(lnglng,)f(flt,)g
(dbl])h(/)286 5468 y(ffpgp[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286
5581 y(\(fitsfile)f(*fptr,)g(long)g(group,)g(long)h(firstelem,)e(long)i
(nelements,)334 5694 y(>)h(DTYPE)e(*array,)g(int)h(*status\))p
eop end
%%Page: 109 117
TeXDict begin 109 116 bop 0 299 a Fh(9.5.)72 b(SPECIALIZED)29
b(FITS)g(PRIMAR)-8 b(Y)31 b(ARRA)-8 b(Y)32 b(OR)d(IMA)m(GE)j(EXTENSION)
d(I/O)h(R)m(OUTINES)80 b Fj(109)0 555 y Fi(4)h Fj(W)-8
b(rite)31 b(a)g(2-D)h(or)e(3-D)h(image)h(in)m(to)f(the)g(data)g(arra)m
(y)-8 b(.)95 776 y Fe(int)47 b(fits_write_2d_[byt,)c(sht,)k(usht,)f
(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)g(dbl])h(/)286
889 y(ffp2d[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286 1002 y(\(fitsfile)f
(*fptr,)g(long)g(group,)g(LONGLONG)g(dim1,)g(LONGLONG)g(naxis1,)334
1115 y(LONGLONG)g(naxis2,)f(DTYPE)i(*array,)f(>)h(int)g(*status\))95
1341 y(int)g(fits_write_3d_[byt,)c(sht,)k(usht,)f(int,)h(uint,)f(lng,)h
(ulng,)f(lnglng,)g(flt,)g(dbl])h(/)286 1453 y
(ffp3d[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286 1566 y(\(fitsfile)f(*fptr,)g
(long)g(group,)g(LONGLONG)g(dim1,)g(LONGLONG)g(dim2,)g(LONGLONG)g
(naxis1,)334 1679 y(LONGLONG)g(naxis2,)f(LONGLONG)h(naxis3,)g(DTYPE)g
(*array,)g(>)h(int)g(*status\))0 1900 y Fi(5)81 b Fj(W)-8
b(rite)31 b(an)g(arbitrary)f(data)h(subsection)f(in)m(to)i(the)e(data)h
(arra)m(y)-8 b(.)95 2121 y Fe(int)47 b(fits_write_subset_[byt,)42
b(sht,)k(usht,)h(int,)f(uint,)h(lng,)f(ulng,)h(lnglng,)f(flt,)g(dbl])h
(/)286 2234 y(ffpss[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286
2347 y(\(fitsfile)f(*fptr,)g(long)g(group,)g(long)h(naxis,)f(long)h
(*naxes,)334 2460 y(long)g(*fpixel,)e(long)i(*lpixel,)e(DTYPE)i
(*array,)f(>)h(int)g(*status\))0 2680 y Fi(6)81 b Fj(Read)30
b(elemen)m(ts)i(from)e(the)g(FITS)g(data)h(arra)m(y)-8
b(.)95 2901 y Fe(int)47 b(fits_read_img)e(/)i(ffgpv)286
3014 y(\(fitsfile)f(*fptr,)g(int)94 b(datatype,)46 b(long)g(firstelem,)
f(long)i(nelements,)334 3127 y(DTYPE)f(*nulval,)g(>)h(DTYPE)g(*array,)f
(int)h(*anynul,)e(int)i(*status\))95 3353 y(int)g(fits_read_img_[byt,)c
(sht,)k(usht,)f(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)g(dbl])h
(/)286 3466 y(ffgpv[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286
3579 y(\(fitsfile)f(*fptr,)g(long)g(group,)g(long)h(firstelem,)e(long)i
(nelements,)334 3692 y(DTYPE)f(nulval,)g(>)i(DTYPE)e(*array,)g(int)h
(*anynul,)e(int)i(*status\))95 3917 y(int)g(fits_read_imgnull)c(/)48
b(ffgpf)286 4030 y(\(fitsfile)e(*fptr,)g(int)94 b(datatype,)46
b(long)g(firstelem,)f(long)i(nelements,)334 4143 y(>)h(DTYPE)e(*array,)
g(char)g(*nullarray,)f(int)i(*anynul,)f(int)g(*status\))95
4369 y(int)95 b(fits_read_imgnull_[byt,)42 b(sht,)k(usht,)h(int,)f
(uint,)h(lng,)f(ulng,)h(flt,)f(dbl])h(/)334 4482 y
(ffgpf[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334 4595 y(\(fitsfile)e(*fptr,)h
(long)h(group,)f(long)h(firstelem,)e(long)h(nelements,)334
4708 y(>)i(DTYPE)e(*array,)g(char)g(*nullarray,)f(int)i(*anynul,)f(int)
g(*status\))0 4929 y Fi(7)81 b Fj(Read)29 b(v)-5 b(alues)31
b(from)e(group)g(parameters.)41 b(This)29 b(routine)g(only)h(applies)g
(to)h(the)e(`Random)h(Group)s(ed')f(FITS)227 5041 y(format)22
b(whic)m(h)f(has)g(b)s(een)f(used)h(for)g(applications)h(in)f(radio)h
(in)m(terferometry)-8 b(,)25 b(but)20 b(is)h(o\016cially)i(deprecated)
227 5154 y(for)30 b(future)g(use.)95 5375 y Fe(int)95
b(fits_read_grppar_[byt,)42 b(sht,)k(usht,)h(int,)f(uint,)h(lng,)f
(ulng,)h(lnglng,)f(flt,)g(dbl])h(/)334 5488 y
(ffggp[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334 5601 y(\(fitsfile)e(*fptr,)h
(long)h(group,)f(long)h(firstelem,)e(long)h(nelements,)334
5714 y(>)i(DTYPE)e(*array,)g(int)h(*status\))p eop end
%%Page: 110 118
TeXDict begin 110 117 bop 0 299 a Fj(110)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fi(8)81 b Fj(Read)37 b(2-D)h(or)g(3-D)g(image)g
(from)f(the)g(data)h(arra)m(y)-8 b(.)62 b(Unde\014ned)36
b(pixels)i(in)e(the)i(arra)m(y)g(will)f(b)s(e)g(set)g(equal)227
668 y(to)32 b(the)g(v)-5 b(alue)31 b(of)h('n)m(ulv)-5
b(al',)32 b(unless)f(n)m(ulv)-5 b(al=0)31 b(in)g(whic)m(h)g(case)h(no)f
(testing)i(for)e(unde\014ned)e(pixels)i(will)h(b)s(e)227
781 y(p)s(erformed.)95 1049 y Fe(int)95 b(fits_read_2d_[byt,)43
b(sht,)k(usht,)f(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)g(dbl])h
(/)334 1162 y(ffg2d[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334
1275 y(\(fitsfile)e(*fptr,)h(long)h(group,)f(DTYPE)h(nulval,)e
(LONGLONG)h(dim1,)g(LONGLONG)g(naxis1,)334 1387 y(LONGLONG)g(naxis2,)f
(>)j(DTYPE)e(*array,)g(int)h(*anynul,)f(int)g(*status\))95
1613 y(int)95 b(fits_read_3d_[byt,)43 b(sht,)k(usht,)f(int,)h(uint,)f
(lng,)h(ulng,)f(lnglng,)g(flt,)g(dbl])h(/)334 1726 y
(ffg3d[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334 1839 y(\(fitsfile)e(*fptr,)h
(long)h(group,)f(DTYPE)h(nulval,)e(LONGLONG)h(dim1,)334
1952 y(LONGLONG)g(dim2,)g(LONGLONG)g(naxis1,)f(LONGLONG)h(naxis2,)g
(LONGLONG)f(naxis3,)334 2065 y(>)j(DTYPE)e(*array,)g(int)h(*anynul,)e
(int)i(*status\))0 2333 y Fi(9)81 b Fj(Read)30 b(an)g(arbitrary)h(data)
g(subsection)f(from)g(the)g(data)i(arra)m(y)-8 b(.)95
2600 y Fe(int)95 b(fits_read_subset_[byt,)42 b(sht,)k(usht,)h(int,)f
(uint,)h(lng,)f(ulng,)h(lnglng,)f(flt,)g(dbl])h(/)334
2713 y(ffgsv[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334 2826
y(\(fitsfile)e(*fptr,)h(int)h(group,)f(int)h(naxis,)f(long)h(*naxes,)
334 2939 y(long)g(*fpixel,)e(long)i(*lpixel,)e(long)i(*inc,)f(DTYPE)h
(nulval,)334 3052 y(>)h(DTYPE)e(*array,)g(int)h(*anynul,)e(int)i
(*status\))95 3278 y(int)95 b(fits_read_subsetnull_[byt)o(,)42
b(sht,)k(usht,)h(int,)f(uint,)h(lng,)f(ulng,)h(lnglng,)f(flt,)g(dbl])h
(/)334 3391 y(ffgsf[b,i,ui,k,uk,j,uj,jj)o(,e,)o(d])334
3504 y(\(fitsfile)e(*fptr,)h(int)h(group,)f(int)h(naxis,)f(long)h
(*naxes,)334 3617 y(long)g(*fpixel,)e(long)i(*lpixel,)e(long)i(*inc,)f
(>)i(DTYPE)e(*array,)334 3730 y(char)h(*nullarray,)d(int)j(*anynul,)f
(int)h(*status\))0 4073 y Ff(9.6)135 b(Sp)t(ecialized)46
b(FITS)e(ASCI)t(I)g(and)g(Binary)h(T)-11 b(able)45 b(Routines)0
4328 y Fd(9.6.1)112 b(General)39 b(Column)f(Routines)0
4543 y Fi(1)81 b Fj(Get)31 b(information)f(ab)s(out)g(an)g(existing)h
(ASCI)s(I)d(or)i(binary)f(table)i(column.)41 b(A)30 b(n)m(ull)g(p)s
(oin)m(ter)g(ma)m(y)h(b)s(e)e(giv)m(en)227 4656 y(for)40
b(an)m(y)h(of)f(the)h(output)f(parameters)g(that)h(are)g(not)f(needed.)
70 b(D)m(A)-8 b(T)g(A)g(TYPE)42 b(is)e(a)h(c)m(haracter)h(string)227
4769 y(whic)m(h)d(returns)e(the)i(data)g(t)m(yp)s(e)g(of)g(the)f
(column)h(as)g(de\014ned)e(b)m(y)i(the)f(TF)m(ORMn)h(k)m(eyw)m(ord)g
(\(e.g.,)j('I',)227 4882 y('J','E',)28 b('D',)g(etc.\).)41
b(In)27 b(the)g(case)g(of)g(an)g(ASCI)s(I)f(c)m(haracter)i(column,)g(t)
m(yp)s(eco)s(de)f(will)g(ha)m(v)m(e)h(a)f(v)-5 b(alue)28
b(of)f(the)227 4994 y(form)g('An')g(where)f('n')h(is)g(an)g(in)m(teger)
i(expressing)d(the)h(width)g(of)g(the)g(\014eld)g(in)f(c)m(haracters.)
41 b(F)-8 b(or)28 b(example,)227 5107 y(if)g(TF)m(ORM)h(=)e('160A8')k
(then)d(\013gb)s(cl)g(will)g(return)f(t)m(yp)s(ec)m(har='A8')j(and)d
(rep)s(eat=20.)41 b(All)29 b(the)f(returned)227 5220
y(parameters)j(are)g(scalar)g(quan)m(tities.)95 5488
y Fe(int)47 b(fits_get_acolparms)c(/)48 b(ffgacl)191
5601 y(\(fitsfile)d(*fptr,)h(int)h(colnum,)f(>)h(char)g(*ttype,)f(long)
h(*tbcol,)239 5714 y(char)f(*tunit,)g(char)h(*tform,)f(double)g
(*scale,)f(double)i(*zero,)p eop end
%%Page: 111 119
TeXDict begin 111 118 bop 0 299 a Fh(9.6.)72 b(SPECIALIZED)29
b(FITS)g(ASCI)s(I)g(AND)i(BINAR)-8 b(Y)32 b(T)-8 b(ABLE)30
b(R)m(OUTINES)933 b Fj(111)239 555 y Fe(char)46 b(*nulstr,)g(char)g
(*tdisp,)g(int)h(*status\))95 781 y(int)g(fits_get_bcolparms)c(/)48
b(ffgbcl)286 894 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(>)j(char)f
(*ttype,)e(char)i(*tunit,)334 1007 y(char)g(*typechar,)e(long)h
(*repeat,)g(double)g(*scale,)g(double)g(*zero,)334 1120
y(long)h(*nulval,)e(char)i(*tdisp,)f(int)94 b(*status\))95
1346 y(int)47 b(fits_get_bcolparmsll)c(/)k(ffgbclll)286
1458 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(>)j(char)f(*ttype,)e(char)
i(*tunit,)334 1571 y(char)g(*typechar,)e(LONGLONG)g(*repeat,)h(double)g
(*scale,)g(double)g(*zero,)334 1684 y(LONGLONG)g(*nulval,)f(char)i
(*tdisp,)f(int)94 b(*status\))0 1937 y Fi(2)81 b Fj(Return)27
b(optimal)i(n)m(um)m(b)s(er)e(of)h(ro)m(ws)g(to)h(read)f(or)g(write)g
(at)h(one)f(time)h(for)f(maxim)m(um)g(I/O)f(e\016ciency)-8
b(.)42 b(Refer)227 2050 y(to)25 b(the)g(\\Optimizing)g(Co)s(de")f
(section)i(in)e(Chapter)g(5)g(for)g(more)h(discussion)f(on)g(ho)m(w)g
(to)h(use)f(this)h(routine.)95 2416 y Fe(int)47 b(fits_get_rowsize)d(/)
j(ffgrsz)286 2529 y(\(fitsfile)f(*fptr,)g(long)g(*nrows,)g(*status\))0
2782 y Fi(3)81 b Fj(De\014ne)22 b(the)g(zero)i(indexed)d(b)m(yte)i
(o\013set)g(of)g(the)f('heap')h(measured)e(from)h(the)h(start)g(of)f
(the)g(binary)g(table)h(data.)227 2895 y(By)30 b(default)g(the)f(heap)h
(is)f(assumed)g(to)h(start)g(immediately)h(follo)m(wing)g(the)f
(regular)f(table)i(data,)f(i.e.,)h(at)227 3008 y(lo)s(cation)38
b(NAXIS1)f(x)g(NAXIS2.)59 b(This)36 b(routine)g(is)h(only)f(relev)-5
b(an)m(t)38 b(for)e(binary)g(tables)h(whic)m(h)g(con)m(tain)227
3121 y(v)-5 b(ariable)25 b(length)g(arra)m(y)g(columns)f(\(with)g(TF)m
(ORMn)g(=)g('Pt'\).)40 b(This)23 b(routine)i(also)g(automatically)i
(writes)227 3234 y(the)35 b(v)-5 b(alue)35 b(of)g(theap)f(to)h(a)g(k)m
(eyw)m(ord)g(in)g(the)f(extension)h(header.)53 b(This)34
b(routine)g(m)m(ust)h(b)s(e)f(called)h(after)227 3347
y(the)c(required)e(k)m(eyw)m(ords)h(ha)m(v)m(e)i(b)s(een)d(written)h
(\(with)g(\013ph)m(bn\))f(but)h(b)s(efore)f(an)m(y)i(data)g(is)f
(written)g(to)h(the)227 3460 y(table.)95 3713 y Fe(int)47
b(fits_write_theap)d(/)j(ffpthp)286 3826 y(\(fitsfile)f(*fptr,)g(long)g
(theap,)g(>)i(int)f(*status\))0 4079 y Fi(4)81 b Fj(T)-8
b(est)37 b(the)f(con)m(ten)m(ts)i(of)f(the)g(binary)e(table)j(v)-5
b(ariable)37 b(arra)m(y)g(heap,)h(returning)e(the)g(size)h(of)g(the)g
(heap,)h(the)227 4192 y(n)m(um)m(b)s(er)30 b(of)h(un)m(used)e(b)m(ytes)
j(that)f(are)g(not)g(curren)m(tly)g(p)s(oin)m(ted)g(to)h(b)m(y)e(an)m
(y)i(of)f(the)g(descriptors,)g(and)f(the)227 4304 y(n)m(um)m(b)s(er)d
(of)h(b)m(ytes)h(whic)m(h)f(are)g(p)s(oin)m(ted)g(to)h(b)m(y)f(m)m
(ultiple)h(descriptors.)40 b(It)28 b(also)h(returns)e(v)-5
b(alid)29 b(=)e(F)-10 b(ALSE)227 4417 y(if)31 b(an)m(y)f(of)h(the)f
(descriptors)h(p)s(oin)m(t)f(to)h(in)m(v)-5 b(alid)31
b(addresses)f(out)g(of)h(range)g(of)f(the)h(heap.)95
4670 y Fe(int)47 b(fits_test_heap)d(/)k(fftheap)286 4783
y(\(fitsfile)e(*fptr,)g(>)h(LONGLONG)f(*heapsize,)f(LONGLONG)g
(*unused,)h(LONGLONG)f(*overlap,)334 4896 y(int)i(*validheap,)e(int)i
(*status\))0 5149 y Fi(5)81 b Fj(Re-pac)m(k)33 b(the)f(v)m(ectors)h(in)
e(the)h(binary)f(table)i(v)-5 b(ariable)32 b(arra)m(y)g(heap)g(to)g
(reco)m(v)m(er)i(an)m(y)e(un)m(used)e(space.)45 b(Nor-)227
5262 y(mally)-8 b(,)40 b(when)d(a)g(v)m(ector)i(in)e(a)g(v)-5
b(ariable)38 b(length)g(arra)m(y)f(column)g(is)g(rewritten)h(the)f
(previously)g(written)227 5375 y(arra)m(y)d(remains)e(in)h(the)g(heap)f
(as)h(w)m(asted)h(un)m(used)d(space.)49 b(This)32 b(routine)g(will)i
(repac)m(k)f(the)g(arra)m(ys)g(that)227 5488 y(are)h(still)g(in)f(use,)
h(th)m(us)f(eliminating)h(an)m(y)g(b)m(ytes)g(in)f(the)g(heap)g(that)h
(are)g(no)f(longer)h(in)f(use.)49 b(Note)34 b(that)227
5601 y(if)f(sev)m(eral)h(v)m(ectors)g(p)s(oin)m(t)e(to)i(the)e(same)h
(b)m(ytes)g(in)g(the)f(heap,)i(then)e(this)g(routine)h(will)g(mak)m(e)g
(duplicate)227 5714 y(copies)e(of)g(the)g(b)m(ytes)f(for)h(eac)m(h)g(v)
m(ector,)h(whic)m(h)e(will)h(actually)h(expand)e(the)g(size)i(of)e(the)
h(heap.)p eop end
%%Page: 112 120
TeXDict begin 112 119 bop 0 299 a Fj(112)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)95 555 y Fe(int)47 b(fits_compress_heap)c(/)48
b(ffcmph)286 668 y(\(fitsfile)e(*fptr,)g(>)h(int)g(*status\))0
976 y Fd(9.6.2)112 b(Lo)m(w-Lev)m(el)39 b(T)-9 b(able)38
b(Access)f(Routines)0 1198 y Fj(The)g(follo)m(wing)j(2)e(routines)f
(pro)m(vide)h(lo)m(w-lev)m(el)j(access)e(to)g(the)f(data)g(in)g(ASCI)s
(I)e(or)i(binary)f(tables)h(and)g(are)0 1311 y(mainly)29
b(useful)f(as)i(an)f(e\016cien)m(t)h(w)m(a)m(y)g(to)g(cop)m(y)g(all)g
(or)f(part)g(of)g(a)g(table)h(from)f(one)g(lo)s(cation)i(to)f(another.)
40 b(These)0 1424 y(routines)24 b(simply)g(read)g(or)h(write)f(the)h
(sp)s(eci\014ed)e(n)m(um)m(b)s(er)g(of)i(consecutiv)m(e)h(b)m(ytes)f
(in)f(an)g(ASCI)s(I)f(or)h(binary)g(table,)0 1537 y(without)g(regard)g
(for)f(column)h(b)s(oundaries)e(or)i(the)g(ro)m(w)g(length)g(in)f(the)h
(table.)40 b(These)23 b(routines)h(do)f(not)h(p)s(erform)0
1650 y(an)m(y)36 b(mac)m(hine)h(dep)s(enden)m(t)e(data)i(con)m(v)m
(ersion)g(or)g(b)m(yte)f(sw)m(apping.)58 b(See)36 b(App)s(endix)e(B)j
(for)f(the)g(de\014nition)g(of)0 1763 y(the)31 b(parameters)f(used)g
(in)g(these)h(routines.)0 2037 y Fi(1)81 b Fj(Read)30
b(or)h(write)f(a)h(consecutiv)m(e)h(arra)m(y)f(of)g(b)m(ytes)f(from)g
(an)h(ASCI)s(I)d(or)j(binary)e(table)95 2311 y Fe(int)47
b(fits_read_tblbytes)c(/)48 b(ffgtbb)286 2424 y(\(fitsfile)e(*fptr,)g
(LONGLONG)f(firstrow,)h(LONGLONG)f(firstchar,)g(LONGLONG)h(nchars,)334
2537 y(>)i(unsigned)d(char)i(*values,)e(int)i(*status\))95
2763 y(int)g(fits_write_tblbytes)c(/)k(ffptbb)286 2876
y(\(fitsfile)f(*fptr,)g(LONGLONG)f(firstrow,)h(LONGLONG)f(firstchar,)g
(LONGLONG)h(nchars,)334 2989 y(unsigned)g(char)g(*values,)g(>)h(int)g
(*status\))0 3296 y Fd(9.6.3)112 b(W)-9 b(rite)37 b(Column)h(Data)g
(Routines)0 3516 y Fi(1)81 b Fj(W)-8 b(rite)28 b(elemen)m(ts)h(in)m(to)
f(an)g(ASCI)s(I)d(or)j(binary)e(table)j(column)e(\(in)g(the)h(CDU\).)g
(The)f(data)h(t)m(yp)s(e)f(of)h(the)f(arra)m(y)227 3629
y(is)k(implied)f(b)m(y)g(the)h(su\016x)e(of)i(the)f(routine)h(name.)95
3903 y Fe(int)47 b(fits_write_col_str)c(/)48 b(ffpcls)286
4016 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstelem,)334 4129 y(LONGLONG)g(nelements,)f(char)h
(**array,)g(>)h(int)g(*status\))95 4355 y(int)g
(fits_write_col_[log,byt,sh)o(t,u)o(sht,)o(int,)o(uin)o(t,ln)o(g,ul)o
(ng,)o(lngl)o(ng,f)o(lt,)o(dbl,)o(cmp,)o(dbl)o(cmp])41
b(/)286 4468 y(ffpcl[l,b,i,ui,k,uk,j,uj,j)o(j,e)o(,d,c)o(,m])286
4581 y(\(fitsfile)46 b(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)
525 4694 y(LONGLONG)g(firstelem,)f(LONGLONG)g(nelements,)g(DTYPE)h
(*array,)g(>)i(int)f(*status\))0 4968 y Fi(2)81 b Fj(W)-8
b(rite)36 b(elemen)m(ts)h(in)m(to)g(an)e(ASCI)s(I)f(or)i(binary)e
(table)j(column)e(substituting)g(the)h(appropriate)f(FITS)g(n)m(ull)227
5081 y(v)-5 b(alue)31 b(for)f(an)m(y)h(elemen)m(ts)h(that)f(are)f
(equal)h(to)g(the)g(n)m(ulv)-5 b(al)31 b(parameter.)95
5355 y Fe(int)47 b(fits_write_colnull_[log,)42 b(byt,)k(sht,)h(usht,)f
(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)h(dbl])f(/)286
5468 y(ffpcn[l,b,i,ui,k,uk,j,uj,j)o(j,e)o(,d])286 5581
y(\(fitsfile)g(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstelem,)334 5694 y(LONGLONG)g(nelements,)f(DTYPE)h
(*array,)g(DTYPE)g(nulval,)g(>)h(int)g(*status\))p eop
end
%%Page: 113 121
TeXDict begin 113 120 bop 0 299 a Fh(9.6.)72 b(SPECIALIZED)29
b(FITS)g(ASCI)s(I)g(AND)i(BINAR)-8 b(Y)32 b(T)-8 b(ABLE)30
b(R)m(OUTINES)933 b Fj(113)0 555 y Fi(3)81 b Fj(W)-8
b(rite)27 b(string)g(elemen)m(ts)h(in)m(to)f(a)g(binary)f(table)h
(column)f(\(in)h(the)f(CDU\))i(substituting)e(the)g(FITS)g(n)m(ull)g(v)
-5 b(alue)227 668 y(for)30 b(an)m(y)h(elemen)m(ts)h(that)f(are)g(equal)
f(to)i(the)e(n)m(ulstr)g(string.)95 921 y Fe(int)47 b
(fits_write_colnull_str)42 b(/)48 b(ffpcns)286 1034 y(\(fitsfile)e
(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f(LONGLONG)h(firstelem,)
334 1147 y(LONGLONG)g(nelements,)f(char)h(**array,)g(char)g(*nulstr,)g
(>)h(int)g(*status\))0 1399 y Fi(4)81 b Fj(W)-8 b(rite)34
b(bit)f(v)-5 b(alues)33 b(in)m(to)h(a)g(binary)e(b)m(yte)h(\('B'\))i
(or)e(bit)g(\('X'\))h(table)g(column)f(\(in)g(the)g(CDU\).)h(Larra)m(y)
f(is)g(an)227 1512 y(arra)m(y)25 b(of)g(c)m(haracters)h(corresp)s
(onding)e(to)h(the)g(sequence)g(of)f(bits)h(to)g(b)s(e)f(written.)39
b(If)24 b(an)g(elemen)m(t)i(of)f(larra)m(y)227 1625 y(is)k(true)g
(\(not)h(equal)f(to)h(zero\))g(then)f(the)g(corresp)s(onding)f(bit)h
(in)g(the)g(FITS)f(table)i(is)f(set)h(to)g(1,)g(otherwise)227
1738 y(the)37 b(bit)g(is)g(set)g(to)g(0.)60 b(The)37
b('X')g(column)f(in)h(a)g(FITS)f(table)h(is)g(alw)m(a)m(ys)h(padded)e
(out)h(to)g(a)g(m)m(ultiple)h(of)227 1851 y(8)f(bits)f(where)g(the)g
(bit)h(arra)m(y)f(starts)h(with)f(the)h(most)f(signi\014can)m(t)h(bit)g
(of)f(the)h(b)m(yte)g(and)e(w)m(orks)h(do)m(wn)227 1964
y(to)m(w)m(ards)h(the)g(1's)f(bit.)59 b(F)-8 b(or)37
b(example,)i(a)d('4X')h(arra)m(y)-8 b(,)39 b(with)d(the)h(\014rst)e
(bit)i(=)e(1)i(and)f(the)g(remaining)h(3)227 2077 y(bits)31
b(=)g(0)h(is)f(equiv)-5 b(alen)m(t)33 b(to)f(the)g(8-bit)g(unsigned)e
(b)m(yte)i(decimal)g(v)-5 b(alue)32 b(of)g(128)g(\('1000)i(0000B'\).)g
(In)d(the)227 2189 y(case)h(of)f('X')g(columns,)g(CFITSIO)f(can)h
(write)g(to)g(all)h(8)f(bits)g(of)g(eac)m(h)h(b)m(yte)f(whether)f(they)
h(are)g(formally)227 2302 y(v)-5 b(alid)34 b(or)f(not.)50
b(Th)m(us)32 b(if)i(the)f(column)g(is)h(de\014ned)e(as)h('4X',)i(and)e
(one)g(calls)i(\013p)s(clx)e(with)g(\014rstbit=1)g(and)227
2415 y(n)m(bits=8,)i(then)f(all)g(8)h(bits)e(will)h(b)s(e)g(written)g
(in)m(to)g(the)g(\014rst)f(b)m(yte)i(\(as)f(opp)s(osed)f(to)i(writing)e
(the)h(\014rst)g(4)227 2528 y(bits)28 b(in)m(to)h(the)e(\014rst)g(ro)m
(w)h(and)f(then)h(the)g(next)g(4)g(bits)f(in)m(to)i(the)f(next)g(ro)m
(w\),)h(ev)m(en)f(though)f(the)h(last)h(4)f(bits)227
2641 y(of)j(eac)m(h)g(b)m(yte)g(are)f(formally)h(not)f(de\014ned)f(and)
h(should)f(all)i(b)s(e)e(set)i(=)f(0.)41 b(It)30 b(should)f(also)j(b)s
(e)d(noted)h(that)227 2754 y(it)k(is)e(more)h(e\016cien)m(t)i(to)e
(write)g('X')h(columns)e(an)h(en)m(tire)h(b)m(yte)f(at)h(a)f(time,)h
(instead)f(of)g(bit)g(b)m(y)g(bit.)48 b(An)m(y)227 2867
y(of)31 b(the)g(CFITSIO)e(routines)h(that)i(write)f(to)g(columns)f
(\(e.g.)43 b(\014ts)p 2481 2867 28 4 v 33 w(write)p 2716
2867 V 33 w(col)p 2859 2867 V 33 w(b)m(yt\))32 b(ma)m(y)f(b)s(e)f(used)
g(for)g(this)227 2980 y(purp)s(ose.)60 b(These)36 b(routines)i(will)f
(in)m(terpret)h('X')f(columns)g(as)g(though)g(they)h(w)m(ere)f('B')h
(columns)f(\(e.g.,)227 3093 y('1X')32 b(through)d('8X')j(is)e(equiv)-5
b(alen)m(t)32 b(to)f('1B',)h(and)e('9X')h(through)f('16X')i(is)e(equiv)
-5 b(alen)m(t)32 b(to)f('2B'\).)95 3345 y Fe(int)47 b
(fits_write_col_bit)c(/)48 b(ffpclx)286 3458 y(\(fitsfile)e(*fptr,)g
(int)h(colnum,)e(LONGLONG)h(firstrow,)f(long)i(firstbit,)334
3571 y(long)g(nbits,)f(char)g(*larray,)g(>)h(int)g(*status\))0
3824 y Fi(5)81 b Fj(W)-8 b(rite)35 b(the)f(descriptor)g(for)f(a)h(v)-5
b(ariable)35 b(length)f(column)g(in)f(a)i(binary)e(table.)52
b(This)33 b(routine)g(can)i(b)s(e)e(used)227 3937 y(in)h(conjunction)g
(with)f(\013gdes)h(to)h(enable)f(2)g(or)g(more)g(arra)m(ys)h(to)f(p)s
(oin)m(t)g(to)h(the)f(same)g(storage)h(lo)s(cation)227
4050 y(to)c(sa)m(v)m(e)h(storage)g(space)f(if)f(the)h(arra)m(ys)g(are)g
(iden)m(tical.)191 4302 y Fe(int)47 b(fits_write_descript)42
b(/)48 b(ffpdes)382 4415 y(\(fitsfile)d(*fptr,)h(int)h(colnum,)f
(LONGLONG)f(rownum,)h(LONGLONG)g(repeat,)430 4528 y(LONGLONG)f(offset,)
h(>)h(int)g(*status\))0 4818 y Fd(9.6.4)112 b(Read)38
b(Column)h(Data)f(Routines)0 5036 y Fj(Tw)m(o)28 b(t)m(yp)s(es)f(of)h
(routines)f(are)h(pro)m(vided)f(to)h(get)h(the)e(column)h(data)g(whic)m
(h)f(di\013er)g(in)g(the)h(w)m(a)m(y)h(unde\014ned)c(pixels)0
5149 y(are)40 b(handled.)66 b(The)39 b(\014rst)g(set)h(of)f(routines)g
(\(\013gcv\))i(simply)e(return)f(an)h(arra)m(y)h(of)g(data)g(elemen)m
(ts)g(in)f(whic)m(h)0 5262 y(unde\014ned)28 b(pixels)j(are)g(set)g
(equal)g(to)g(a)g(v)-5 b(alue)31 b(sp)s(eci\014ed)f(b)m(y)h(the)f(user)
g(in)g(the)h('n)m(ullv)-5 b(al')32 b(parameter.)41 b(If)30
b(n)m(ullv)-5 b(al)0 5375 y(=)22 b(0,)j(then)d(no)g(c)m(hec)m(ks)i(for)
e(unde\014ned)e(pixels)j(will)g(b)s(e)f(p)s(erformed,)g(th)m(us)g
(increasing)i(the)e(sp)s(eed)g(of)g(the)h(program.)0
5488 y(The)36 b(second)g(set)g(of)h(routines)e(\(\013gcf)7
b(\))38 b(returns)d(the)h(data)h(elemen)m(t)g(arra)m(y)g(and)e(in)h
(addition)g(a)h(logical)h(arra)m(y)0 5601 y(of)33 b(\015ags)f(whic)m(h)
g(de\014nes)g(whether)g(the)g(corresp)s(onding)g(data)h(pixel)f(is)h
(unde\014ned.)44 b(See)33 b(App)s(endix)e(B)i(for)f(the)0
5714 y(de\014nition)e(of)h(the)f(parameters)h(used)e(in)h(these)h
(routines.)p eop end
%%Page: 114 122
TeXDict begin 114 121 bop 0 299 a Fj(114)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)0 555 y Fj(An)m(y)39 b(column,)h(regardless)f(of)g(it's)g
(in)m(trinsic)g(data)h(t)m(yp)s(e,)h(ma)m(y)e(b)s(e)f(read)g(as)h(a)g
(string.)66 b(It)38 b(should)g(b)s(e)g(noted)0 668 y(ho)m(w)m(ev)m(er)
32 b(that)f(reading)f(a)h(n)m(umeric)f(column)g(as)h(a)f(string)h(is)f
(10)h(-)g(100)g(times)g(slo)m(w)m(er)h(than)e(reading)g(the)h(same)0
781 y(column)g(as)h(a)g(n)m(um)m(b)s(er)e(due)h(to)h(the)g(large)h(o)m
(v)m(erhead)f(in)g(constructing)g(the)g(formatted)g(strings.)44
b(The)31 b(displa)m(y)0 894 y(format)26 b(of)g(the)h(returned)d
(strings)i(will)g(b)s(e)g(determined)f(b)m(y)h(the)g(TDISPn)f(k)m(eyw)m
(ord,)j(if)d(it)i(exists,)h(otherwise)e(b)m(y)0 1007
y(the)h(data)g(t)m(yp)s(e)f(of)h(the)f(column.)39 b(The)26
b(length)h(of)g(the)f(returned)f(strings)h(\(not)h(including)f(the)h(n)
m(ull)f(terminating)0 1120 y(c)m(haracter\))38 b(can)e(b)s(e)g
(determined)f(with)h(the)g(\014ts)p 1722 1120 28 4 v
33 w(get)p 1875 1120 V 34 w(col)p 2019 1120 V 33 w(displa)m(y)p
2330 1120 V 33 w(width)g(routine.)57 b(The)36 b(follo)m(wing)h(TDISPn)0
1233 y(displa)m(y)31 b(formats)f(are)h(curren)m(tly)f(supp)s(orted:)191
1490 y Fe(Iw.m)142 b(Integer)191 1603 y(Ow.m)g(Octal)46
b(integer)191 1716 y(Zw.m)142 b(Hexadecimal)45 b(integer)191
1829 y(Fw.d)142 b(Fixed)46 b(floating)g(point)191 1942
y(Ew.d)142 b(Exponential)45 b(floating)g(point)191 2055
y(Dw.d)142 b(Exponential)45 b(floating)g(point)191 2168
y(Gw.d)142 b(General;)46 b(uses)g(Fw.d)h(if)g(significance)d(not)j
(lost,)g(else)f(Ew.d)0 2425 y Fj(where)37 b(w)h(is)g(the)g(width)f(in)h
(c)m(haracters)h(of)f(the)h(displa)m(y)m(ed)f(v)-5 b(alues,)41
b(m)c(is)h(the)g(minim)m(um)g(n)m(um)m(b)s(er)e(of)i(digits)0
2538 y(displa)m(y)m(ed,)31 b(and)f(d)g(is)g(the)h(n)m(um)m(b)s(er)e(of)
h(digits)h(to)g(the)g(righ)m(t)g(of)g(the)f(decimal.)42
b(The)30 b(.m)g(\014eld)g(is)g(optional.)0 2796 y Fi(1)81
b Fj(Read)29 b(elemen)m(ts)i(from)e(an)g(ASCI)s(I)f(or)i(binary)f
(table)h(column)f(\(in)h(the)f(CDU\).)i(These)e(routines)g(return)g
(the)227 2909 y(v)-5 b(alues)30 b(of)g(the)g(table)h(column)f(arra)m(y)
g(elemen)m(ts.)42 b(Unde\014ned)28 b(arra)m(y)j(elemen)m(ts)g(will)f(b)
s(e)f(returned)g(with)h(a)227 3022 y(v)-5 b(alue)30 b(=)e(n)m(ulv)-5
b(al,)30 b(unless)e(n)m(ulv)-5 b(al)29 b(=)f(0)i(\(or)f(=)f(')h(')g
(for)g(\013gcvs\))g(in)g(whic)m(h)f(case)i(no)f(c)m(hec)m(king)i(for)d
(unde\014ned)227 3135 y(v)-5 b(alues)28 b(will)g(b)s(e)f(p)s(erformed.)
39 b(The)27 b(ANYF)h(parameter)g(is)g(set)g(to)g(true)g(if)g(an)m(y)f
(of)h(the)g(returned)f(elemen)m(ts)227 3247 y(are)k(unde\014ned.)95
3505 y Fe(int)47 b(fits_read_col_str)c(/)48 b(ffgcvs)286
3618 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstelem,)334 3731 y(LONGLONG)g(nelements,)f(char)h
(*nulstr,)g(>)h(char)g(**array,)e(int)i(*anynul,)334
3844 y(int)g(*status\))95 4070 y(int)g(fits_read_col_[log,byt,sht)o
(,us)o(ht,i)o(nt,u)o(int)o(,lng)o(,uln)o(g,)41 b(lnglng,)46
b(flt,)h(dbl,)g(cmp,)f(dblcmp])g(/)286 4183 y
(ffgcv[l,b,i,ui,k,uk,j,uj,j)o(j,e)o(,d,c)o(,m])286 4295
y(\(fitsfile)g(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstelem,)334 4408 y(LONGLONG)g(nelements,)f(DTYPE)h
(nulval,)g(>)h(DTYPE)g(*array,)e(int)i(*anynul,)334 4521
y(int)g(*status\))0 4779 y Fi(2)81 b Fj(Read)39 b(elemen)m(ts)i(and)e
(n)m(ull)h(\015ags)g(from)f(an)g(ASCI)s(I)g(or)g(binary)g(table)i
(column)e(\(in)h(the)g(CHDU\).)g(These)227 4892 y(routines)29
b(return)e(the)i(v)-5 b(alues)29 b(of)g(the)g(table)h(column)e(arra)m
(y)i(elemen)m(ts.)41 b(An)m(y)29 b(unde\014ned)d(arra)m(y)k(elemen)m
(ts)227 5005 y(will)k(ha)m(v)m(e)h(the)f(corresp)s(onding)e(n)m
(ullarra)m(y)i(elemen)m(t)h(set)f(equal)g(to)g(TR)m(UE.)g(The)f(an)m
(yn)m(ul)h(parameter)g(is)227 5118 y(set)d(to)g(true)f(if)h(an)m(y)g
(of)f(the)h(returned)e(elemen)m(ts)j(are)e(unde\014ned.)95
5375 y Fe(int)47 b(fits_read_colnull_str)42 b(/)48 b(ffgcfs)286
5488 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstelem,)334 5601 y(LONGLONG)g(nelements,)f(>)i(char)g
(**array,)e(char)i(*nullarray,)e(int)i(*anynul,)334 5714
y(int)g(*status\))p eop end
%%Page: 115 123
TeXDict begin 115 122 bop 0 299 a Fh(9.6.)72 b(SPECIALIZED)29
b(FITS)g(ASCI)s(I)g(AND)i(BINAR)-8 b(Y)32 b(T)-8 b(ABLE)30
b(R)m(OUTINES)933 b Fj(115)95 668 y Fe(int)47 b
(fits_read_colnull_[log,byt)o(,sh)o(t,us)o(ht,i)o(nt,)o(uint)o(,lng)o
(,ul)o(ng,l)o(ngln)o(g,f)o(lt,d)o(bl,c)o(mp,)o(dblc)o(mp])41
b(/)286 781 y(ffgcf[l,b,i,ui,k,uk,j,uj,j)o(j,e)o(,d,c)o(,m])286
894 y(\(fitsfile)46 b(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)334
1007 y(LONGLONG)g(firstelem,)f(LONGLONG)g(nelements,)g(>)j(DTYPE)e
(*array,)334 1120 y(char)h(*nullarray,)d(int)j(*anynul,)f(int)h
(*status\))0 1384 y Fi(3)81 b Fj(Read)24 b(an)g(arbitrary)g(data)h
(subsection)f(from)g(an)g(N-dimensional)h(arra)m(y)g(in)f(a)g(binary)g
(table)h(v)m(ector)h(column.)227 1497 y(Unde\014ned)21
b(pixels)i(in)f(the)h(arra)m(y)g(will)g(b)s(e)f(set)h(equal)h(to)f(the)
g(v)-5 b(alue)23 b(of)g('n)m(ulv)-5 b(al',)25 b(unless)d(n)m(ulv)-5
b(al=0)23 b(in)f(whic)m(h)227 1610 y(case)37 b(no)e(testing)h(for)f
(unde\014ned)e(pixels)i(will)h(b)s(e)f(p)s(erformed.)53
b(The)35 b(\014rst)g(and)f(last)i(ro)m(ws)g(in)f(the)g(table)227
1722 y(to)30 b(b)s(e)e(read)h(are)g(sp)s(eci\014ed)g(b)m(y)g
(fpixel\(naxis+1\))g(and)g(lpixel\(naxis+1\),)i(and)d(hence)h(are)h
(treated)g(as)f(the)227 1835 y(next)38 b(higher)f(dimension)g(of)h(the)
f(FITS)g(N-dimensional)h(arra)m(y)-8 b(.)63 b(The)37
b(INC)h(parameter)g(sp)s(eci\014es)f(the)227 1948 y(sampling)31
b(in)m(terv)-5 b(al)31 b(in)f(eac)m(h)i(dimension)e(b)s(et)m(w)m(een)h
(the)f(data)h(elemen)m(ts)h(that)f(will)g(b)s(e)e(returned.)95
2212 y Fe(int)47 b(fits_read_subset_[byt,)42 b(sht,)47
b(usht,)f(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)h(dbl])f(/)286
2325 y(ffgsv[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286 2438
y(\(fitsfile)g(*fptr,)g(int)h(colnum,)e(int)i(naxis,)f(long)h(*naxes,)f
(long)h(*fpixel,)334 2551 y(long)g(*lpixel,)e(long)i(*inc,)f(DTYPE)h
(nulval,)e(>)j(DTYPE)e(*array,)g(int)h(*anynul,)334 2664
y(int)g(*status\))0 2928 y Fi(4)81 b Fj(Read)24 b(an)g(arbitrary)g
(data)h(subsection)f(from)g(an)g(N-dimensional)h(arra)m(y)g(in)f(a)g
(binary)g(table)h(v)m(ector)h(column.)227 3041 y(An)m(y)34
b(Unde\014ned)e(pixels)i(in)g(the)f(arra)m(y)i(will)f(ha)m(v)m(e)h(the)
f(corresp)s(onding)e('n)m(ullarra)m(y')j(elemen)m(t)g(set)f(equal)227
3154 y(to)40 b(TR)m(UE.)e(The)h(\014rst)e(and)h(last)i(ro)m(ws)e(in)h
(the)f(table)i(to)f(b)s(e)f(read)h(are)g(sp)s(eci\014ed)e(b)m(y)i
(fpixel\(naxis+1\))227 3267 y(and)i(lpixel\(naxis+1\),)47
b(and)41 b(hence)h(are)g(treated)g(as)g(the)g(next)g(higher)g
(dimension)f(of)h(the)g(FITS)f(N-)227 3379 y(dimensional)i(arra)m(y)-8
b(.)78 b(The)41 b(INC)h(parameter)h(sp)s(eci\014es)f(the)h(sampling)f
(in)m(terv)-5 b(al)44 b(in)e(eac)m(h)i(dimension)227
3492 y(b)s(et)m(w)m(een)31 b(the)g(data)g(elemen)m(ts)h(that)f(will)f
(b)s(e)g(returned.)95 3756 y Fe(int)47 b(fits_read_subsetnull_[byt,)41
b(sht,)47 b(usht,)f(int,)h(uint,)f(lng,)h(ulng,)f(lnglng,)g(flt,)g
(dbl])h(/)286 3869 y(ffgsf[b,i,ui,k,uk,j,uj,jj,)o(e,d)o(])286
3982 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(int)i(naxis,)f(long)h
(*naxes,)334 4095 y(long)g(*fpixel,)e(long)i(*lpixel,)e(long)i(*inc,)f
(>)i(DTYPE)e(*array,)334 4208 y(char)h(*nullarray,)d(int)j(*anynul,)f
(int)h(*status\))0 4472 y Fi(5)81 b Fj(Read)35 b(bit)g(v)-5
b(alues)35 b(from)g(a)g(b)m(yte)h(\('B'\))g(or)f(bit)g(\(`X`\))h(table)
g(column)f(\(in)g(the)g(CDU\).)h(Larra)m(y)g(is)f(an)f(arra)m(y)227
4585 y(of)g(logical)i(v)-5 b(alues)34 b(corresp)s(onding)f(to)h(the)g
(sequence)g(of)g(bits)g(to)g(b)s(e)f(read.)51 b(If)33
b(larra)m(y)h(is)g(true)f(then)h(the)227 4698 y(corresp)s(onding)i(bit)
h(w)m(as)g(set)h(to)f(1,)j(otherwise)d(the)g(bit)g(w)m(as)g(set)h(to)f
(0.)61 b(The)37 b('X')g(column)g(in)f(a)i(FITS)227 4811
y(table)e(is)e(alw)m(a)m(ys)i(padded)e(out)h(to)g(a)g(m)m(ultiple)g(of)
g(8)g(bits)f(where)g(the)h(bit)g(arra)m(y)g(starts)g(with)f(the)h(most)
227 4924 y(signi\014can)m(t)j(bit)e(of)h(the)g(b)m(yte)g(and)f(w)m
(orks)g(do)m(wn)h(to)m(w)m(ards)g(the)g(1's)g(bit.)59
b(F)-8 b(or)37 b(example,)i(a)e('4X')h(arra)m(y)-8 b(,)227
5036 y(with)33 b(the)h(\014rst)e(bit)i(=)f(1)h(and)e(the)i(remaining)f
(3)h(bits)f(=)g(0)h(is)f(equiv)-5 b(alen)m(t)35 b(to)f(the)g(8-bit)g
(unsigned)e(b)m(yte)227 5149 y(v)-5 b(alue)31 b(of)f(128.)42
b(Note)31 b(that)g(in)e(the)i(case)g(of)f('X')g(columns,)g(CFITSIO)f
(can)h(read)g(all)h(8)f(bits)g(of)g(eac)m(h)h(b)m(yte)227
5262 y(whether)h(they)h(are)g(formally)g(v)-5 b(alid)33
b(or)f(not.)48 b(Th)m(us)31 b(if)i(the)f(column)h(is)f(de\014ned)f(as)i
('4X',)h(and)e(one)h(calls)227 5375 y(\013gcx)d(with)f(\014rstbit=1)f
(and)h(n)m(bits=8,)g(then)g(all)h(8)f(bits)g(will)g(b)s(e)g(read)g
(from)f(the)h(\014rst)g(b)m(yte)g(\(as)h(opp)s(osed)227
5488 y(to)39 b(reading)f(the)g(\014rst)g(4)g(bits)g(from)g(the)g
(\014rst)f(ro)m(w)h(and)g(then)f(the)i(\014rst)e(4)h(bits)g(from)g(the)
g(next)g(ro)m(w\),)227 5601 y(ev)m(en)g(though)f(the)g(last)i(4)e(bits)
g(of)h(eac)m(h)g(b)m(yte)g(are)f(formally)h(not)g(de\014ned.)60
b(It)37 b(should)f(also)i(b)s(e)f(noted)227 5714 y(that)f(it)f(is)h
(more)f(e\016cien)m(t)h(to)g(read)f('X')h(columns)e(an)h(en)m(tire)h(b)
m(yte)g(at)g(a)f(time,)i(instead)e(of)h(bit)f(b)m(y)g(bit.)p
eop end
%%Page: 116 124
TeXDict begin 116 123 bop 0 299 a Fj(116)958 b Fh(CHAPTER)30
b(9.)112 b(SPECIALIZED)28 b(CFITSIO)h(INTERF)-10 b(A)m(CE)30
b(R)m(OUTINES)227 555 y Fj(An)m(y)f(of)g(the)h(CFITSIO)d(routines)i
(that)g(read)g(columns)g(\(e.g.)42 b(\014ts)p 2520 555
28 4 v 32 w(read)p 2724 555 V 33 w(col)p 2867 555 V 34
w(b)m(yt\))29 b(ma)m(y)h(b)s(e)e(used)g(for)h(this)227
668 y(purp)s(ose.)60 b(These)36 b(routines)i(will)f(in)m(terpret)h('X')
f(columns)g(as)g(though)g(they)h(w)m(ere)f('B')h(columns)f(\(e.g.,)227
781 y('8X')32 b(is)e(equiv)-5 b(alen)m(t)32 b(to)f('1B',)h(and)e('16X')
i(is)e(equiv)-5 b(alen)m(t)32 b(to)f('2B'\).)95 1041
y Fe(int)47 b(fits_read_col_bit)c(/)48 b(ffgcx)286 1154
y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(firstbit,)334 1267 y(LONGLONG)g(nbits,)g(>)h(char)g
(*larray,)e(int)i(*status\))0 1526 y Fi(6)81 b Fj(Read)31
b(an)m(y)h(consecutiv)m(e)i(set)e(of)g(bits)f(from)h(an)f('X')h(or)g
('B')h(column)e(and)g(in)m(terpret)h(them)g(as)f(an)h(unsigned)227
1639 y(n-bit)h(in)m(teger.)48 b(n)m(bits)33 b(m)m(ust)f(b)s(e)g(less)h
(than)g(16)g(or)g(32)g(in)f(\013gcxui)i(and)d(\013gcxuk,)j(resp)s
(ectiv)m(ely)-8 b(.)49 b(If)32 b(nro)m(ws)227 1752 y(is)c(greater)h
(than)f(1,)h(then)e(the)h(same)h(set)f(of)g(bits)g(will)g(b)s(e)f(read)
h(from)f(eac)m(h)i(ro)m(w,)g(starting)g(with)e(\014rstro)m(w.)227
1865 y(The)j(bits)g(are)h(n)m(um)m(b)s(ered)e(with)h(1)h(=)f(the)h
(most)f(signi\014can)m(t)i(bit)e(of)h(the)f(\014rst)g(elemen)m(t)i(of)e
(the)h(column.)95 2125 y Fe(int)47 b(fits_read_col_bit_[usht,)42
b(uint])k(/)h(ffgcx[ui,uk])286 2238 y(\(fitsfile)f(*fptr,)g(int)h
(colnum,)e(LONGLONG)h(firstrow,)f(LONGLONG,)h(nrows,)334
2351 y(long)h(firstbit,)e(long)i(nbits,)f(>)h(DTYPE)g(*array,)e(int)i
(*status\))0 2611 y Fi(7)81 b Fj(Return)27 b(the)i(descriptor)f(for)h
(a)g(v)-5 b(ariable)29 b(length)g(column)f(in)h(a)g(binary)e(table.)41
b(The)28 b(descriptor)h(consists)g(of)227 2723 y(2)j(in)m(teger)g
(parameters:)42 b(the)31 b(n)m(um)m(b)s(er)f(of)h(elemen)m(ts)i(in)d
(the)h(arra)m(y)h(and)e(the)h(starting)h(o\013set)g(relativ)m(e)h(to)
227 2836 y(the)c(start)h(of)e(the)h(heap.)40 b(The)29
b(\014rst)f(pair)g(of)h(routine)g(returns)e(a)i(single)h(descriptor)e
(whereas)h(the)g(second)227 2949 y(pair)34 b(of)h(routine)f(returns)g
(the)g(descriptors)g(for)g(a)h(range)g(of)f(ro)m(ws)h(in)f(the)g
(table.)54 b(The)34 b(only)g(di\013erence)227 3062 y(b)s(et)m(w)m(een)
42 b(the)f(2)g(routines)f(in)h(eac)m(h)h(pair)e(is)h(that)g(one)g
(returns)f(the)h(parameters)g(as)g('long')g(in)m(tegers,)227
3175 y(whereas)30 b(the)h(other)g(returns)e(the)h(v)-5
b(alues)31 b(as)g(64-bit)g('LONGLONG')g(in)m(tegers.)95
3435 y Fe(int)47 b(fits_read_descript)c(/)48 b(ffgdes)286
3548 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e(LONGLONG)h(rownum,)g(>)h
(long)g(*repeat,)525 3661 y(long)g(*offset,)e(int)i(*status\))95
3886 y(int)g(fits_read_descriptll)c(/)k(ffgdesll)286
3999 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(LONGLONG)h(rownum,)g(>)h
(LONGLONG)f(*repeat,)525 4112 y(LONGLONG)g(*offset,)f(int)i(*status\))
95 4338 y(int)g(fits_read_descripts)c(/)k(ffgdess)286
4451 y(\(fitsfile)f(*fptr,)g(int)h(colnum,)e(LONGLONG)h(firstrow,)f
(LONGLONG)h(nrows)334 4564 y(>)i(long)e(*repeat,)g(long)g(*offset,)g
(int)h(*status\))95 4790 y(int)g(fits_read_descriptsll)42
b(/)48 b(ffgdessll)286 4903 y(\(fitsfile)e(*fptr,)g(int)h(colnum,)e
(LONGLONG)h(firstrow,)f(LONGLONG)h(nrows)334 5016 y(>)i(LONGLONG)d
(*repeat,)h(LONGLONG)f(*offset,)h(int)h(*status\))p eop
end
%%Page: 117 125
TeXDict begin 117 124 bop 0 1225 a Fg(Chapter)65 b(10)0
1687 y Fm(Extended)77 b(File)g(Name)g(Syn)-6 b(tax)0
2216 y Ff(10.1)136 b(Ov)l(erview)0 2466 y Fj(CFITSIO)30
b(supp)s(orts)f(an)j(extended)f(syn)m(tax)h(when)f(sp)s(ecifying)g(the)
h(name)f(of)h(the)g(data)g(\014le)f(to)h(b)s(e)f(op)s(ened)g(or)0
2579 y(created)g(that)g(includes)f(the)h(follo)m(wing)h(features:)136
2813 y Fc(\017)46 b Fj(CFITSIO)40 b(can)i(read)f(IRAF)h(format)g
(images)g(whic)m(h)f(ha)m(v)m(e)i(header)e(\014le)h(names)f(that)h(end)
f(with)g(the)227 2926 y('.imh')d(extension,)i(as)e(w)m(ell)g(as)g
(reading)f(and)g(writing)g(FITS)g(\014les,)i(This)e(feature)h(is)f
(implemen)m(ted)h(in)227 3039 y(CFITSIO)29 b(b)m(y)i(\014rst)e(con)m(v)
m(erting)k(the)d(IRAF)h(image)h(in)m(to)f(a)g(temp)s(orary)f(FITS)g
(format)h(\014le)f(in)g(memory)-8 b(,)227 3152 y(then)35
b(op)s(ening)f(the)h(FITS)f(\014le.)54 b(An)m(y)35 b(of)g(the)g(usual)f
(CFITSIO)g(routines)g(then)h(ma)m(y)g(b)s(e)f(used)g(to)i(read)227
3265 y(the)31 b(image)g(header)f(or)h(data.)41 b(Similarly)-8
b(,)31 b(ra)m(w)f(binary)g(data)h(arra)m(ys)f(can)h(b)s(e)f(read)g(b)m
(y)g(con)m(v)m(erting)i(them)227 3378 y(on)f(the)f(\015y)g(in)m(to)h
(virtual)g(FITS)f(images.)136 3557 y Fc(\017)46 b Fj(FITS)37
b(\014les)g(on)g(the)g(In)m(ternet)h(can)f(b)s(e)g(read)g(\(and)g
(sometimes)h(written\))f(using)g(the)g(FTP)-8 b(,)38
b(HTTP)-8 b(,)37 b(or)227 3670 y(R)m(OOT)30 b(proto)s(cols.)136
3849 y Fc(\017)46 b Fj(FITS)30 b(\014les)g(can)h(b)s(e)f(pip)s(ed)f(b)s
(et)m(w)m(een)i(tasks)f(on)h(the)f(stdin)g(and)g(stdout)g(streams.)136
4028 y Fc(\017)46 b Fj(FITS)36 b(\014les)h(can)g(b)s(e)f(read)h(and)f
(written)h(in)g(shared)f(memory)-8 b(.)60 b(This)36 b(can)h(p)s(oten)m
(tially)i(ac)m(hiev)m(e)g(b)s(etter)227 4141 y(data)26
b(I/O)e(p)s(erformance)g(compared)h(to)h(reading)f(and)f(writing)g(the)
h(same)h(FITS)e(\014les)g(on)h(magnetic)h(disk.)136 4320
y Fc(\017)46 b Fj(Compressed)30 b(FITS)f(\014les)i(in)f(gzip)h(or)f
(Unix)g(COMPRESS)f(format)h(can)h(b)s(e)f(directly)h(read.)136
4499 y Fc(\017)46 b Fj(Output)28 b(FITS)h(\014les)g(can)g(b)s(e)g
(written)g(directly)h(in)e(compressed)h(gzip)h(format,)g(th)m(us)e(sa)m
(ving)i(disk)f(space.)136 4678 y Fc(\017)46 b Fj(FITS)26
b(table)h(columns)f(can)h(b)s(e)f(created,)i(mo)s(di\014ed,)f(or)f
(deleted)h('on-the-\015y')g(as)g(the)g(table)g(is)f(op)s(ened)g(b)m(y)
227 4791 y(CFITSIO.)32 b(This)h(creates)i(a)e(virtual)h(FITS)f(\014le)g
(con)m(taining)i(the)f(mo)s(di\014cations)f(that)h(is)g(then)f(op)s
(ened)227 4904 y(b)m(y)e(the)f(application)i(program.)136
5083 y Fc(\017)46 b Fj(T)-8 b(able)29 b(ro)m(ws)e(ma)m(y)i(b)s(e)e
(selected,)j(or)e(\014ltered)g(out,)g(on)g(the)g(\015y)f(when)g(the)h
(table)h(is)f(op)s(ened)f(b)m(y)g(CFITSIO,)227 5196 y(based)22
b(on)f(an)g(user-sp)s(eci\014ed)g(expression.)38 b(Only)21
b(ro)m(ws)g(for)g(whic)m(h)h(the)g(expression)f(ev)-5
b(aluates)23 b(to)f('TR)m(UE')227 5309 y(are)31 b(retained)g(in)f(the)g
(cop)m(y)i(of)e(the)h(table)g(that)g(is)f(op)s(ened)g(b)m(y)g(the)h
(application)g(program.)136 5488 y Fc(\017)46 b Fj(Histogram)28
b(images)g(ma)m(y)f(b)s(e)f(created)h(on)f(the)h(\015y)f(b)m(y)g
(binning)g(the)g(v)-5 b(alues)27 b(in)f(table)i(columns,)f(resulting)
227 5601 y(in)36 b(a)g(virtual)h(N-dimensional)f(FITS)g(image.)59
b(The)35 b(application)i(program)f(then)g(only)g(sees)g(the)h(FITS)227
5714 y(image)32 b(\(in)e(the)h(primary)e(arra)m(y\))j(instead)e(of)h
(the)f(original)i(FITS)d(table.)1882 5942 y(117)p eop
end
%%Page: 118 126
TeXDict begin 118 125 bop 0 299 a Fj(118)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(The)39 b(latter)i(3)f(table)h(\014ltering)f(features)g(in)f
(particular)h(add)f(v)m(ery)h(p)s(o)m(w)m(erful)f(data)i(pro)s(cessing)
e(capabilities)0 668 y(directly)33 b(in)m(to)g(CFITSIO,)e(and)h(hence)h
(in)m(to)g(ev)m(ery)g(task)g(that)g(uses)f(CFITSIO)f(to)i(read)f(or)h
(write)f(FITS)g(\014les.)0 781 y(F)-8 b(or)29 b(example,)g(these)f
(features)h(transform)e(a)h(v)m(ery)g(simple)g(program)g(that)g(just)g
(copies)g(an)g(input)f(FITS)g(\014le)h(to)0 894 y(a)c(new)f(output)h
(\014le)g(\(lik)m(e)h(the)f(`\014tscop)m(y')h(program)e(that)i(is)e
(distributed)g(with)h(CFITSIO\))e(in)m(to)j(a)f(m)m(ultipurp)s(ose)0
1007 y(FITS)33 b(\014le)g(pro)s(cessing)g(to)s(ol.)51
b(By)33 b(app)s(ending)f(fairly)i(simple)f(quali\014ers)g(on)m(to)h
(the)g(name)f(of)h(the)f(input)g(FITS)0 1120 y(\014le,)45
b(the)d(user)f(can)h(p)s(erform)e(quite)i(complex)h(table)f(editing)h
(op)s(erations)f(\(e.g.,)k(create)d(new)e(columns,)k(or)0
1233 y(\014lter)32 b(out)h(ro)m(ws)f(in)g(a)g(table\))i(or)e(create)i
(FITS)d(images)j(b)m(y)e(binning)f(or)h(histogramming)h(the)g(v)-5
b(alues)32 b(in)g(table)0 1346 y(columns.)47 b(In)32
b(addition,)h(these)g(functions)f(ha)m(v)m(e)i(b)s(een)e(co)s(ded)g
(using)g(new)g(state-of-the)j(art)e(algorithms)g(that)0
1458 y(are,)e(in)f(some)h(cases,)g(10)h(-)e(100)i(times)f(faster)g
(than)f(previous)g(widely)g(used)f(implemen)m(tations.)0
1619 y(Before)34 b(describing)f(the)h(complete)h(syn)m(tax)f(for)f(the)
h(extended)f(FITS)g(\014le)g(names)g(in)g(the)h(next)g(section,)h(here)
0 1732 y(are)c(a)g(few)f(examples)h(of)f(FITS)g(\014le)g(names)h(that)f
(giv)m(e)i(a)f(quic)m(k)g(o)m(v)m(erview)h(of)f(the)f(allo)m(w)m(ed)i
(syn)m(tax:)136 2005 y Fc(\017)46 b Fe(myfile.fits)p
Fj(:)38 b(the)30 b(simplest)h(case)g(of)g(a)g(FITS)e(\014le)i(on)f
(disk)g(in)g(the)h(curren)m(t)f(directory)-8 b(.)136
2207 y Fc(\017)46 b Fe(myfile.imh)p Fj(:)i(op)s(ens)34
b(an)h(IRAF)g(format)g(image)i(\014le)e(and)f(con)m(v)m(erts)j(it)e(on)
g(the)g(\015y)g(in)m(to)h(a)f(temp)s(orary)227 2320 y(FITS)30
b(format)h(image)g(in)f(memory)h(whic)m(h)f(can)g(then)g(b)s(e)g(read)g
(with)g(an)m(y)h(other)g(CFITSIO)e(routine.)136 2521
y Fc(\017)46 b Fe(rawfile.dat[i512,512])p Fj(:)35 b(op)s(ens)30
b(a)g(ra)m(w)h(binary)e(data)i(arra)m(y)g(\(a)g(512)g(x)f(512)i(short)e
(in)m(teger)h(arra)m(y)g(in)227 2634 y(this)i(case\))i(and)d(con)m(v)m
(erts)j(it)e(on)g(the)g(\015y)g(in)m(to)h(a)f(temp)s(orary)g(FITS)f
(format)h(image)i(in)d(memory)h(whic)m(h)227 2747 y(can)e(then)f(b)s(e)
g(read)g(with)g(an)m(y)h(other)f(CFITSIO)f(routine.)136
2948 y Fc(\017)46 b Fe(myfile.fits.gz)p Fj(:)d(if)33
b(this)g(is)g(the)g(name)g(of)h(a)f(new)g(output)g(\014le,)h(the)f
('.gz')i(su\016x)d(will)h(cause)h(it)g(to)g(b)s(e)227
3061 y(compressed)c(in)g(gzip)h(format)g(when)e(it)i(is)g(written)f(to)
h(disk.)136 3263 y Fc(\017)46 b Fe(myfile.fits.gz[events,)c(2])p
Fj(:)35 b(op)s(ens)20 b(and)f(uncompresses)g(the)i(gzipp)s(ed)f(\014le)
g(m)m(y\014le.\014ts)h(then)f(mo)m(v)m(es)227 3376 y(to)31
b(the)g(extension)g(with)f(the)h(k)m(eyw)m(ords)f(EXTNAME)h(=)f
('EVENTS')g(and)g(EXTVER)g(=)g(2.)136 3577 y Fc(\017)46
b Fe(-)p Fj(:)40 b(a)30 b(dash)f(\(min)m(us)g(sign\))h(signi\014es)g
(that)g(the)g(input)f(\014le)g(is)h(to)g(b)s(e)f(read)h(from)f(the)h
(stdin)f(\014le)h(stream,)g(or)227 3690 y(that)d(the)g(output)f(\014le)
h(is)f(to)h(b)s(e)f(written)h(to)g(the)g(stdout)f(stream.)40
b(See)27 b(also)g(the)g(stream://)h(driv)m(er)e(whic)m(h)227
3803 y(pro)m(vides)37 b(a)f(more)h(e\016cien)m(t,)i(but)d(more)g
(restricted)h(metho)s(d)f(of)h(reading)f(or)g(writing)h(to)g(the)f
(stdin)g(or)227 3916 y(stdout)31 b(streams.)136 4117
y Fc(\017)46 b Fe(ftp://legacy.gsfc.nasa.go)o(v/te)o(st/v)o(ela)o(.fit)
o(s)p Fj(:)k(FITS)37 b(\014les)h(in)g(an)m(y)h(ftp)e(arc)m(hiv)m(e)j
(site)f(on)f(the)227 4230 y(In)m(ternet)31 b(ma)m(y)g(b)s(e)f(directly)
h(op)s(ened)e(with)h(read-only)h(access.)136 4432 y Fc(\017)46
b Fe(http://legacy.gsfc.nasa.g)o(ov/s)o(oftw)o(are)o(/tes)o(t.fi)o(ts)p
Fj(:)33 b(an)m(y)27 b(v)-5 b(alid)28 b(URL)f(to)h(a)g(FITS)e(\014le)i
(on)f(the)227 4545 y(W)-8 b(eb)31 b(ma)m(y)g(b)s(e)f(op)s(ened)g(with)g
(read-only)g(access.)136 4746 y Fc(\017)46 b Fe
(root://legacy.gsfc.nasa.g)o(ov/t)o(est/)o(vel)o(a.fi)o(ts)p
Fj(:)e(similar)36 b(to)g(ftp)f(access)i(except)f(that)g(it)g(pro-)227
4859 y(vides)30 b(write)h(as)f(w)m(ell)h(as)g(read)f(access)h(to)g(the)
f(\014les)h(across)f(the)h(net)m(w)m(ork.)41 b(This)29
b(uses)h(the)h(ro)s(ot)f(proto)s(col)227 4972 y(dev)m(elop)s(ed)h(at)g
(CERN.)136 5174 y Fc(\017)46 b Fe(shmem://h2[events])p
Fj(:)j(op)s(ens)36 b(the)i(FITS)e(\014le)h(in)g(a)g(shared)f(memory)h
(segmen)m(t)h(and)f(mo)m(v)m(es)h(to)g(the)227 5287 y(EVENTS)30
b(extension.)136 5488 y Fc(\017)46 b Fe(mem://)p Fj(:)65
b(creates)44 b(a)g(scratc)m(h)g(output)f(\014le)g(in)g(core)h(computer)
f(memory)-8 b(.)79 b(The)43 b(resulting)g('\014le')h(will)227
5601 y(disapp)s(ear)25 b(when)f(the)i(program)f(exits,)i(so)f(this)f
(is)h(mainly)f(useful)g(for)g(testing)i(purp)s(oses)c(when)i(one)g(do)s
(es)227 5714 y(not)31 b(w)m(an)m(t)g(a)g(p)s(ermanen)m(t)f(cop)m(y)h
(of)f(the)h(output)f(\014le.)p eop end
%%Page: 119 127
TeXDict begin 119 126 bop 0 299 a Fh(10.1.)73 b(O)m(VER)-10
b(VIEW)2995 b Fj(119)136 555 y Fc(\017)46 b Fe(myfile.fits[3;)e
(Images\(10\)])p Fj(:)c(op)s(ens)30 b(a)i(cop)m(y)g(of)g(the)g(image)g
(con)m(tained)h(in)e(the)h(10th)g(ro)m(w)f(of)h(the)227
668 y('Images')38 b(column)f(in)g(the)g(binary)f(table)i(in)e(the)h
(3th)g(extension)h(of)f(the)g(FITS)f(\014le.)60 b(The)37
b(virtual)g(\014le)227 781 y(that)31 b(is)g(op)s(ened)e(b)m(y)i(the)f
(application)i(just)e(con)m(tains)h(this)f(single)h(image)h(in)e(the)h
(primary)e(arra)m(y)-8 b(.)136 973 y Fc(\017)46 b Fe
(myfile.fits[1:512:2,)d(1:512:2])p Fj(:)c(op)s(ens)30
b(a)h(section)h(of)g(the)f(input)f(image)i(ranging)f(from)f(the)h(1st)
227 1086 y(to)k(the)f(512th)h(pixel)f(in)g(X)g(and)g(Y,)g(and)f
(selects)j(ev)m(ery)e(second)g(pixel)h(in)e(b)s(oth)g(dimensions,)i
(resulting)227 1198 y(in)30 b(a)h(256)h(x)e(256)i(pixel)e(input)g
(image)h(in)g(this)f(case.)136 1390 y Fc(\017)46 b Fe
(myfile.fits[EVENTS][col)c(Rad)47 b(=)g(sqrt\(X**2)e(+)j(Y**2\)])p
Fj(:)36 b(creates)27 b(and)d(op)s(ens)h(a)g(virtual)h(\014le)f(on)227
1503 y(the)h(\015y)f(that)i(is)f(iden)m(tical)h(to)g(m)m
(y\014le.\014ts)f(except)g(that)h(it)f(will)g(con)m(tain)h(a)f(new)g
(column)f(in)h(the)g(EVENTS)227 1616 y(extension)41 b(called)h('Rad')f
(whose)f(v)-5 b(alue)41 b(is)g(computed)f(using)h(the)f(indicated)h
(expression)g(whic)m(h)f(is)h(a)227 1729 y(function)30
b(of)h(the)f(v)-5 b(alues)31 b(in)f(the)h(X)f(and)g(Y)h(columns.)136
1920 y Fc(\017)46 b Fe(myfile.fits[EVENTS][PHA)c(>)47
b(5])p Fj(:)41 b(creates)33 b(and)d(op)s(ens)g(a)i(virtual)f(FITS)f
(\014les)h(that)g(is)g(iden)m(tical)i(to)227 2033 y('m)m
(y\014le.\014ts')40 b(except)h(that)f(the)f(EVENTS)g(table)h(will)g
(only)f(con)m(tain)i(the)e(ro)m(ws)h(that)g(ha)m(v)m(e)g(v)-5
b(alues)40 b(of)227 2146 y(the)34 b(PHA)g(column)g(greater)h(than)e(5.)
52 b(In)33 b(general,)j(an)m(y)e(arbitrary)g(b)s(o)s(olean)f
(expression)h(using)f(a)i(C)e(or)227 2259 y(F)-8 b(ortran-lik)m(e)31
b(syn)m(tax,)e(whic)m(h)f(ma)m(y)h(com)m(bine)g(AND)g(and)f(OR)f(op)s
(erators,)i(ma)m(y)g(b)s(e)f(used)f(to)i(select)h(ro)m(ws)227
2372 y(from)g(a)h(table.)136 2564 y Fc(\017)46 b Fe
(myfile.fits[EVENTS][bin)c(\(X,Y\)=1,2048,4])p Fj(:)34
b(creates)26 b(a)g(temp)s(orary)f(FITS)g(primary)f(arra)m(y)i(im-)227
2677 y(age)38 b(whic)m(h)e(is)h(computed)f(on)g(the)h(\015y)f(b)m(y)g
(binning)f(\(i.e,)40 b(computing)c(the)h(2-dimensional)g(histogram\))
227 2789 y(of)d(the)f(v)-5 b(alues)34 b(in)f(the)h(X)g(and)e(Y)i
(columns)f(of)h(the)f(EVENTS)g(extension.)50 b(In)33
b(this)g(case)i(the)e(X)h(and)f(Y)227 2902 y(co)s(ordinates)h(range)g
(from)f(1)h(to)g(2048)h(and)e(the)h(image)g(pixel)g(size)g(is)g(4)f
(units)g(in)g(b)s(oth)g(dimensions,)h(so)227 3015 y(the)d(resulting)f
(image)i(is)e(512)i(x)e(512)i(pixels)f(in)f(size.)136
3207 y Fc(\017)46 b Fj(The)31 b(\014nal)g(example)i(com)m(bines)f(man)m
(y)f(of)h(these)g(feature)g(in)m(to)g(one)g(complex)g(expression)f
(\(it)i(is)e(brok)m(en)227 3320 y(in)m(to)h(sev)m(eral)f(lines)g(for)f
(clarit)m(y\):)370 3576 y Fe(ftp://legacy.gsfc.nasa.gov)o(/dat)o(a/s)o
(ampl)o(e.fi)o(ts.)o(gz[E)o(VENT)o(S])370 3689 y([col)47
b(phacorr)f(=)h(pha)g(*)h(1.1)f(-)g(0.3][phacorr)e(>=)i(5.0)g(&&)g
(phacorr)f(<=)h(14.0])370 3801 y([bin)g(\(X,Y\)=32])227
4057 y Fj(In)37 b(this)h(case,)j(CFITSIO)36 b(\(1\))j(copies)g(and)e
(uncompresses)g(the)h(FITS)f(\014le)h(from)f(the)h(ftp)f(site)i(on)f
(the)227 4170 y(legacy)g(mac)m(hine,)h(\(2\))e(mo)m(v)m(es)g(to)g(the)g
('EVENTS')f(extension,)i(\(3\))f(calculates)i(a)d(new)g(column)g
(called)227 4283 y('phacorr',)30 b(\(4\))f(selects)h(the)f(ro)m(ws)g
(in)f(the)h(table)h(that)f(ha)m(v)m(e)h(phacorr)e(in)g(the)h(range)g(5)
g(to)h(14,)g(and)e(\014nally)227 4396 y(\(5\))35 b(bins)d(the)h
(remaining)g(ro)m(ws)g(on)h(the)f(X)g(and)g(Y)g(column)g(co)s
(ordinates,)i(using)d(a)i(pixel)f(size)h(=)f(32)h(to)227
4509 y(create)d(a)f(2D)g(image.)42 b(All)30 b(this)f(pro)s(cessing)g
(is)h(completely)h(transparen)m(t)e(to)i(the)e(application)i(program,)
227 4622 y(whic)m(h)f(simply)g(sees)h(the)g(\014nal)f(2-D)h(image)h(in)
e(the)g(primary)g(arra)m(y)h(of)f(the)h(op)s(ened)f(\014le.)0
4886 y(The)c(full)h(extended)g(CFITSIO)e(FITS)h(\014le)h(name)g(can)g
(con)m(tain)h(sev)m(eral)g(di\013eren)m(t)g(comp)s(onen)m(ts)f(dep)s
(ending)e(on)0 4998 y(the)31 b(con)m(text.)42 b(These)30
b(comp)s(onen)m(ts)h(are)g(describ)s(ed)e(in)h(the)g(follo)m(wing)i
(sections:)0 5262 y Fe(When)47 b(creating)e(a)j(new)f(file:)143
5375 y(filetype://BaseFilename\(t)o(empl)o(ate)o(Name)o(\)[co)o(mpr)o
(ess])0 5601 y(When)g(opening)e(an)j(existing)d(primary)h(array)g(or)i
(image)e(HDU:)143 5714 y(filetype://BaseFilename\(o)o(utNa)o(me\))o
([HDU)o(loca)o(tio)o(n][I)o(mage)o(Sec)o(tion)o(][pi)o(xFi)o(lter)o(])p
eop end
%%Page: 120 128
TeXDict begin 120 127 bop 0 299 a Fj(120)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
668 y Fe(When)47 b(opening)e(an)j(existing)d(table)i(HDU:)143
781 y(filetype://BaseFilename\(o)o(utNa)o(me\))o([HDU)o(loca)o(tio)o
(n][c)o(olFi)o(lte)o(r][r)o(owFi)o(lte)o(r][b)o(inSp)o(ec])0
1010 y Fj(The)35 b(\014let)m(yp)s(e,)j(BaseFilename,)h(outName,)g
(HDUlo)s(cation,)g(ImageSection,)g(and)c(pixFilter)i(comp)s(onen)m(ts,)
g(if)0 1123 y(presen)m(t,)27 b(m)m(ust)f(b)s(e)g(giv)m(en)h(in)f(that)g
(order,)h(but)e(the)i(colFilter,)i(ro)m(wFilter,)g(and)c(binSp)s(ec)g
(sp)s(eci\014ers)g(ma)m(y)i(follo)m(w)0 1236 y(in)j(an)m(y)h(order.)42
b(Regardless)31 b(of)g(the)g(order,)f(ho)m(w)m(ev)m(er,)i(the)f
(colFilter)i(sp)s(eci\014er,)e(if)f(presen)m(t,)h(will)g(b)s(e)f(pro)s
(cessed)0 1349 y(\014rst)g(b)m(y)g(CFITSIO,)f(follo)m(w)m(ed)j(b)m(y)e
(the)h(ro)m(wFilter)h(sp)s(eci\014er,)e(and)f(\014nally)i(b)m(y)f(the)g
(binSp)s(ec)f(sp)s(eci\014er.)0 1678 y Ff(10.2)136 b(Filet)l(yp)t(e)0
1928 y Fj(The)37 b(t)m(yp)s(e)g(of)g(\014le)g(determines)g(the)g
(medium)f(on)h(whic)m(h)g(the)g(\014le)g(is)h(lo)s(cated)g(\(e.g.,)i
(disk)d(or)g(net)m(w)m(ork\))h(and,)0 2041 y(hence,)f(whic)m(h)e(in)m
(ternal)h(device)g(driv)m(er)f(is)g(used)f(b)m(y)h(CFITSIO)f(to)i(read)
f(and/or)g(write)g(the)g(\014le.)56 b(Curren)m(tly)0
2154 y(supp)s(orted)29 b(t)m(yp)s(es)h(are)382 2383 y
Fe(file://)93 b(-)48 b(file)e(on)i(local)e(magnetic)g(disk)g
(\(default\))430 2496 y(ftp://)93 b(-)48 b(a)f(readonly)f(file)g
(accessed)g(with)h(the)g(anonymous)e(FTP)i(protocol.)907
2609 y(It)g(also)g(supports)93 b(ftp://username:password@)o(host)o(nam)
o(e/..)o(.)907 2722 y(for)47 b(accessing)e(password-protected)e(ftp)k
(sites.)382 2835 y(http://)93 b(-)48 b(a)f(readonly)f(file)g(accessed)g
(with)h(the)g(HTTP)f(protocol.)93 b(It)907 2948 y(supports)45
b(username:password)e(just)k(like)g(the)g(ftp)g(driver.)907
3060 y(Proxy)f(HTTP)h(servers)f(are)h(supported)e(using)h(the)h
(http_proxy)907 3173 y(environment)e(variable)g(\(see)i(following)e
(note\).)286 3286 y(stream://)93 b(-)48 b(special)e(driver)g(to)h(read)
g(an)g(input)f(FITS)h(file)f(from)h(the)g(stdin)907 3399
y(stream,)f(and/or)g(write)g(an)h(output)f(FITS)h(file)g(to)g(the)g
(stdout)143 3512 y(stream.)94 b(This)46 b(driver)g(is)i(fragile)d(and)i
(has)g(limited)143 3625 y(functionality)d(\(see)j(the)g(following)e
(note\).)286 3738 y(gsiftp://)93 b(-)48 b(access)e(files)g(on)h(a)h
(computational)c(grid)j(using)f(the)h(gridftp)907 3851
y(protocol)e(in)j(the)e(Globus)h(toolkit)e(\(see)i(following)e(note\).)
382 3964 y(root://)93 b(-)48 b(uses)e(the)h(CERN)g(root)g(protocol)e
(for)i(writing)f(as)h(well)g(as)907 4077 y(reading)f(files)g(over)h
(the)g(network)e(\(see)i(following)e(note\).)334 4190
y(shmem://)93 b(-)48 b(opens)e(or)h(creates)f(a)i(file)e(which)h
(persists)e(in)i(the)g(computer's)907 4302 y(shared)f(memory)g(\(see)h
(following)e(note\).)430 4415 y(mem://)93 b(-)48 b(opens)e(a)i
(temporary)d(file)i(in)g(core)f(memory.)94 b(The)47 b(file)907
4528 y(disappears)e(when)h(the)h(program)f(exits)h(so)g(this)f(is)i
(mainly)907 4641 y(useful)e(for)h(test)f(purposes)g(when)h(a)g
(permanent)e(output)h(file)907 4754 y(is)h(not)g(desired.)0
4983 y Fj(If)35 b(the)h(\014let)m(yp)s(e)g(is)f(not)h(sp)s(eci\014ed,)h
(then)e(t)m(yp)s(e)h(\014le://)h(is)e(assumed.)56 b(The)35
b(double)g(slashes)h('//')h(are)f(optional)0 5096 y(and)30
b(ma)m(y)h(b)s(e)e(omitted)j(in)e(most)h(cases.)0 5382
y Fd(10.2.1)113 b(Notes)36 b(ab)s(out)j(HTTP)d(pro)m(xy)i(serv)m(ers)0
5601 y Fj(A)32 b(pro)m(xy)g(HTTP)f(serv)m(er)h(ma)m(y)h(b)s(e)e(used)g
(b)m(y)h(de\014ning)f(the)h(address)f(\(URL\))i(and)e(p)s(ort)g(n)m(um)
m(b)s(er)g(of)h(the)g(pro)m(xy)0 5714 y(serv)m(er)f(with)f(the)g(h)m
(ttp)p 801 5714 28 4 v 33 w(pro)m(xy)g(en)m(vironmen)m(t)h(v)-5
b(ariable.)42 b(F)-8 b(or)31 b(example)p eop end
%%Page: 121 129
TeXDict begin 121 128 bop 0 299 a Fh(10.2.)73 b(FILETYPE)3037
b Fj(121)191 555 y Fe(setenv)46 b(http_proxy)f
(http://heasarc.gsfc.nasa)o(.gov)o(:312)o(8)0 793 y Fj(will)38
b(cause)g(CFITSIO)f(to)h(use)g(p)s(ort)f(3128)i(on)f(the)g(heasarc)g
(pro)m(xy)g(serv)m(er)g(whenev)m(er)g(reading)g(a)g(FITS)f(\014le)0
906 y(with)30 b(HTTP)-8 b(.)0 1194 y Fd(10.2.2)113 b(Notes)36
b(ab)s(out)j(the)e(stream)h(\014let)m(yp)s(e)g(driv)m(er)0
1413 y Fj(The)e(stream)h(driv)m(er)f(can)h(b)s(e)f(used)g(to)h
(e\016cien)m(tly)i(read)d(a)h(FITS)f(\014le)h(from)f(the)h(stdin)f
(\014le)g(stream)h(or)g(write)0 1525 y(a)44 b(FITS)e(to)i(the)g(stdout)
f(\014le)g(stream.)80 b(Ho)m(w)m(ev)m(er,)49 b(b)s(ecause)43
b(these)h(input)e(and)h(output)g(streams)g(m)m(ust)h(b)s(e)0
1638 y(accessed)30 b(sequen)m(tially)-8 b(,)31 b(the)e(FITS)f(\014le)g
(reading)h(or)f(writing)h(application)h(m)m(ust)e(also)i(read)e(and)g
(write)h(the)g(\014le)0 1751 y(sequen)m(tially)-8 b(,)33
b(at)e(least)g(within)f(the)h(tolerances)h(describ)s(ed)d(b)s(elo)m(w.)
0 1911 y(CFITSIO)34 b(supp)s(orts)f(2)j(di\013eren)m(t)f(metho)s(ds)g
(for)g(accessing)i(FITS)d(\014les)h(on)h(the)f(stdin)g(and)f(stdout)h
(streams.)0 2024 y(The)c(original)i(metho)s(d,)f(whic)m(h)f(is)h(in)m
(v)m(ok)m(ed)h(b)m(y)f(sp)s(ecifying)f(a)h(dash)f(c)m(haracter,)j("-",)
g(as)d(the)h(name)g(of)g(the)g(\014le)0 2137 y(when)g(op)s(ening)g(or)h
(creating)h(it,)g(w)m(orks)e(b)m(y)h(storing)g(a)g(complete)h(cop)m(y)g
(of)f(the)g(en)m(tire)g(FITS)f(\014le)h(in)f(memory)-8
b(.)0 2250 y(In)35 b(this)g(case,)k(when)34 b(reading)i(from)f(stdin,)i
(CFITSIO)d(will)i(cop)m(y)h(the)e(en)m(tire)i(stream)f(in)m(to)h
(memory)e(b)s(efore)0 2363 y(doing)c(an)m(y)h(pro)s(cessing)f(of)h(the)
f(\014le.)44 b(Similarly)-8 b(,)32 b(when)f(writing)g(to)h(stdout,)g
(CFITSIO)d(will)j(create)h(a)f(cop)m(y)g(of)0 2476 y(the)h(en)m(tire)g
(FITS)f(\014le)g(in)h(memory)-8 b(,)33 b(b)s(efore)f(\014nally)h
(\015ushing)e(it)i(out)f(to)i(the)e(stdout)h(stream)g(when)e(the)i
(FITS)0 2589 y(\014le)g(is)g(closed.)49 b(Bu\013ering)33
b(the)g(en)m(tire)h(FITS)e(\014le)h(in)g(this)f(w)m(a)m(y)i(allo)m(ws)g
(the)f(application)i(to)e(randomly)g(access)0 2702 y(an)m(y)h(part)f
(of)h(the)f(FITS)g(\014le,)i(in)e(an)m(y)h(order,)f(but)g(it)h(also)h
(requires)e(that)h(the)f(user)g(ha)m(v)m(e)i(su\016cien)m(t)f(a)m(v)-5
b(ailable)0 2815 y(memory)30 b(\(or)g(virtual)g(memory\))g(to)h(store)f
(the)g(en)m(tire)h(\014le,)f(whic)m(h)f(ma)m(y)i(not)f(b)s(e)f(p)s
(ossible)g(in)h(the)g(case)h(of)f(v)m(ery)0 2928 y(large)h(\014les.)0
3088 y(The)e(new)m(er)g(stream)h(\014let)m(yp)s(e)g(pro)m(vides)f(a)h
(more)f(memory-e\016cien)m(t)i(metho)s(d)e(of)h(accessing)h(FITS)d
(\014les)h(on)h(the)0 3201 y(stdin)37 b(or)h(stdout)g(streams.)64
b(Instead)38 b(of)g(storing)g(a)g(cop)m(y)h(of)f(the)g(en)m(tire)h
(FITS)e(\014le)h(in)g(memory)-8 b(,)40 b(CFITSIO)0 3314
y(only)32 b(uses)g(a)g(set)h(of)f(in)m(ternal)h(bu\013er)e(whic)m(h)h
(b)m(y)g(default)g(can)g(store)h(40)g(FITS)e(blo)s(c)m(ks,)i(or)g(ab)s
(out)e(100K)i(b)m(ytes)0 3427 y(of)f(the)f(FITS)g(\014le.)43
b(The)31 b(application)i(program)e(m)m(ust)g(pro)s(cess)g(the)h(FITS)e
(\014le)i(sequen)m(tially)h(from)e(b)s(eginning)0 3539
y(to)h(end,)e(within)g(this)h(100K)h(bu\013er.)41 b(Generally)32
b(sp)s(eaking)f(the)g(application)h(program)f(m)m(ust)f(conform)h(to)h
(the)0 3652 y(follo)m(wing)g(restrictions:)136 3891 y
Fc(\017)46 b Fj(The)36 b(program)f(m)m(ust)h(\014nish)e(reading)i(or)g
(writing)f(the)h(header)g(k)m(eyw)m(ords)g(b)s(efore)f(reading)h(or)g
(writing)227 4004 y(an)m(y)31 b(data)g(in)f(the)h(HDU.)136
4184 y Fc(\017)46 b Fj(The)24 b(HDU)h(can)f(con)m(tain)i(at)e(most)h
(ab)s(out)f(1400)h(header)f(k)m(eyw)m(ords.)39 b(This)24
b(is)g(the)g(maxim)m(um)g(that)h(can)f(\014t)227 4297
y(in)g(the)g(nominal)h(40)g(FITS)e(blo)s(c)m(k)i(bu\013er.)37
b(In)24 b(principle,)h(this)f(limit)h(could)f(b)s(e)g(increased)g(b)m
(y)g(recompiling)227 4410 y(CFITSIO)29 b(with)h(a)h(larger)g(bu\013er)e
(limit,)j(whic)m(h)e(is)g(set)h(b)m(y)f(the)h(NIOBUF)g(parameter)g(in)f
(\014tsio2.h.)136 4590 y Fc(\017)46 b Fj(The)32 b(program)g(m)m(ust)f
(read)h(or)g(write)h(the)f(data)g(in)g(a)g(sequen)m(tial)i(manner)d
(from)h(the)g(b)s(eginning)f(to)i(the)227 4703 y(end)26
b(of)g(the)h(HDU.)g(Note)h(that)f(CFITSIO's)e(in)m(ternal)i(100K)g
(bu\013er)e(allo)m(ws)j(a)e(little)j(latitude)e(in)f(meeting)227
4816 y(this)31 b(requiremen)m(t.)136 4997 y Fc(\017)46
b Fj(The)30 b(program)g(cannot)h(mo)m(v)m(e)h(bac)m(k)f(to)g(a)g
(previous)f(HDU)h(in)f(the)h(FITS)e(\014le.)136 5177
y Fc(\017)46 b Fj(Reading)c(or)f(writing)f(of)h(v)-5
b(ariable)42 b(length)f(arra)m(y)h(columns)e(in)h(binary)f(tables)i(is)
f(not)g(supp)s(orted)e(on)227 5290 y(streams,)29 b(b)s(ecause)f(this)g
(requires)g(mo)m(ving)g(bac)m(k)h(and)f(forth)f(b)s(et)m(w)m(een)i(the)
f(\014xed-length)g(p)s(ortion)g(of)g(the)227 5403 y(binary)i(table)h
(and)f(the)g(follo)m(wing)i(heap)e(area)i(where)e(the)g(arra)m(ys)h
(are)g(actually)h(stored.)136 5583 y Fc(\017)46 b Fj(Reading)25
b(or)g(writing)f(of)h(tile-compressed)h(images)g(is)e(not)h(supp)s
(orted)e(on)h(streams,)i(b)s(ecause)f(the)g(images)227
5696 y(are)31 b(in)m(ternally)g(stored)g(using)f(v)-5
b(ariable)31 b(length)g(arra)m(ys.)p eop end
%%Page: 122 130
TeXDict begin 122 129 bop 0 299 a Fj(122)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fd(10.2.3)113 b(Notes)36 b(ab)s(out)j(the)e(gsiftp)h(\014let)m
(yp)s(e)0 774 y Fj(DEPENDENCIES:)c(Globus)h(to)s(olkit)h(\(2.4.3)g(or)f
(higher\))f(\(GT\))h(should)f(b)s(e)g(installed.)53 b(There)34
b(are)h(t)m(w)m(o)h(dif-)0 887 y(feren)m(t)31 b(w)m(a)m(ys)g(to)g
(install)g(GT:)0 1047 y(1\))43 b(goto)h(the)f(globus)f(to)s(olkit)i(w)m
(eb)e(page)i(www.globus.org)e(and)g(follo)m(w)h(the)g(do)m(wnload)g
(and)e(compilation)0 1160 y(instructions;)0 1320 y(2\))j(goto)i(the)d
(Virtual)i(Data)g(T)-8 b(o)s(olkit)45 b(w)m(eb)e(page)i(h)m
(ttp://vdt.cs.wisc.edu/)g(and)e(follo)m(w)i(the)f(instructions)0
1433 y(\(STR)m(ONGL)-8 b(Y)31 b(SUGGESTED\);)0 1593 y(Once)23
b(a)h(globus)f(clien)m(t)h(has)f(b)s(een)g(installed)h(in)e(y)m(our)i
(system)f(with)g(a)g(sp)s(eci\014c)g(\015a)m(v)m(our)h(it)f(is)g(p)s
(ossible)g(to)h(compile)0 1706 y(and)30 b(install)h(the)g(CFITSIO)d
(libraries.)41 b(Sp)s(eci\014c)30 b(con\014guration)h(\015ags)f(m)m
(ust)h(b)s(e)e(used:)0 1866 y(1\))21 b({with-gsiftp[[=P)-8
b(A)g(TH]])22 b(Enable)f(Globus)f(T)-8 b(o)s(olkit)21
b(gsiftp)g(proto)s(col)g(supp)s(ort)d(P)-8 b(A)g(TH=GLOBUS)p
3532 1866 28 4 v 33 w(LOCA)g(TION)0 1979 y(i.e.)42 b(the)30
b(lo)s(cation)i(of)f(y)m(our)f(globus)g(installation)0
2139 y(2\))h({with-gsiftp-\015a)m(v)m(our[[=P)-8 b(A)g(TH])33
b(de\014nes)d(the)g(sp)s(eci\014c)g(Globus)h(\015a)m(v)m(our)f(ex.)41
b(gcc32)0 2300 y(Both)31 b(the)g(\015ags)f(m)m(ust)g(b)s(e)g(used)g
(and)f(it)i(is)g(mandatory)f(to)h(set)g(b)s(oth)f(the)g(P)-8
b(A)g(TH)31 b(and)f(the)h(\015a)m(v)m(our.)0 2460 y(USA)m(GE:)g(T)-8
b(o)31 b(access)h(\014les)e(on)g(a)h(gridftp)f(serv)m(er)g(it)h(is)g
(necessary)f(to)i(use)e(a)g(gsiftp)h(pre\014x:)0 2620
y(example:)41 b(gsiftp://remote)p 1003 2620 V 35 w(serv)m(er)p
1271 2620 V 34 w(fqhn/directory/\014lename)0 2780 y(The)f(gridftp)g
(driv)m(er)g(uses)g(a)g(lo)s(cal)i(bu\013er)d(on)i(a)f(temp)s(orary)g
(\014le)h(the)f(\014le)h(is)f(lo)s(cated)i(in)e(the)g(/tmp)h(direc-)0
2893 y(tory)-8 b(.)73 b(If)40 b(y)m(ou)h(ha)m(v)m(e)h(sp)s(ecial)g(p)s
(ermissions)d(on)i(/tmp)g(or)g(y)m(ou)g(do)f(not)i(ha)m(v)m(e)g(a)f
(/tmp)g(directory)-8 b(,)44 b(it)e(is)e(p)s(os-)0 3006
y(sible)d(to)h(force)g(another)g(lo)s(cation)g(setting)h(the)e(GSIFTP)p
2068 3006 V 32 w(TMPFILE)g(en)m(vironmen)m(t)h(v)-5 b(ariable)38
b(\(ex.)62 b(exp)s(ort)0 3119 y(GSIFTP)p 347 3119 V 32
w(TMPFILE=/y)m(our/lo)s(cation/y)m(ourtmp\014le\).)0
3279 y(Grid)34 b(FTP)g(supp)s(orts)f(m)m(ulti)h(c)m(hannel)h(transfer.)
52 b(By)35 b(default)f(a)h(single)g(c)m(hannel)g(transmission)f(is)g(a)
m(v)-5 b(ailable.)0 3392 y(Ho)m(w)m(ev)m(er,)34 b(it)d(is)h(p)s
(ossible)e(to)i(mo)s(dify)e(this)i(b)s(eha)m(vior)f(setting)h(the)f
(GSIFTP)p 2691 3392 V 33 w(STREAMS)f(en)m(vironmen)m(t)h(v)-5
b(ari-)0 3505 y(able)31 b(\(ex.)41 b(exp)s(ort)30 b(GSIFTP)p
1016 3505 V 33 w(STREAMS=8\).)0 3790 y Fd(10.2.4)113
b(Notes)36 b(ab)s(out)j(the)e(ro)s(ot)g(\014let)m(yp)s(e)0
4009 y Fj(The)20 b(original)j(ro)s(otd)d(serv)m(er)h(can)h(b)s(e)e
(obtained)h(from:)36 b Fe(ftp://root.cern.ch/root)o(/roo)o(td.t)o(ar.)o
(gz)15 b Fj(but,)22 b(for)0 4122 y(it)33 b(to)h(w)m(ork)f(correctly)h
(with)e(CFITSIO)g(one)h(has)f(to)i(use)e(a)i(mo)s(di\014ed)d(v)m
(ersion)j(whic)m(h)e(supp)s(orts)f(a)i(command)0 4235
y(to)41 b(return)d(the)j(length)f(of)g(the)g(\014le.)70
b(This)39 b(mo)s(di\014ed)f(v)m(ersion)j(is)f(a)m(v)-5
b(ailable)42 b(in)e(ro)s(otd)f(sub)s(directory)g(in)h(the)0
4348 y(CFITSIO)29 b(ftp)h(area)h(at)286 4577 y Fe
(ftp://legacy.gsfc.nasa.gov)o(/so)o(ftwa)o(re/f)o(its)o(io/c)o(/roo)o
(t/r)o(ootd)o(.tar)o(.gz)o(.)0 4805 y Fj(This)j(small)g(serv)m(er)h(is)
g(started)f(either)h(b)m(y)g(inetd)f(when)f(a)i(clien)m(t)h(requests)e
(a)h(connection)h(to)f(a)f(ro)s(otd)h(serv)m(er)0 4918
y(or)30 b(b)m(y)g(hand)f(\(i.e.)42 b(from)30 b(the)g(command)g(line\).)
42 b(The)29 b(ro)s(otd)h(serv)m(er)h(w)m(orks)f(with)g(the)g(R)m(OOT)g
(TNetFile)i(class.)0 5031 y(It)e(allo)m(ws)g(remote)h(access)f(to)h(R)m
(OOT)e(database)h(\014les)f(in)g(either)h(read)g(or)f(write)h(mo)s(de.)
40 b(By)30 b(default)f(TNetFile)0 5144 y(assumes)38 b(p)s(ort)g(432)h
(\(whic)m(h)f(requires)g(ro)s(otd)g(to)h(b)s(e)f(started)h(as)f(ro)s
(ot\).)65 b(T)-8 b(o)39 b(run)e(ro)s(otd)h(via)h(inetd)f(add)g(the)0
5257 y(follo)m(wing)32 b(line)f(to)g(/etc/services:)95
5485 y Fe(rootd)238 b(432/tcp)0 5714 y Fj(and)30 b(to)h
(/etc/inetd.conf,)i(add)d(the)g(follo)m(wing)i(line:)p
eop end
%%Page: 123 131
TeXDict begin 123 130 bop 0 299 a Fh(10.2.)73 b(FILETYPE)3037
b Fj(123)95 555 y Fe(rootd)47 b(stream)f(tcp)h(nowait)f(root)h
(/user/rdm/root/bin/root)o(d)42 b(rootd)k(-i)0 829 y
Fj(F)-8 b(orce)30 b(inetd)e(to)h(reread)f(its)h(conf)f(\014le)g(with)g
Fe(kill)47 b(-HUP)g(<pid)f(inetd>)p Fj(.)39 b(Y)-8 b(ou)28
b(can)h(also)g(start)g(ro)s(otd)f(b)m(y)g(hand)0 942
y(running)35 b(directly)i(under)d(y)m(our)j(priv)-5 b(ate)37
b(accoun)m(t)g(\(no)g(ro)s(ot)g(system)f(privileges)h(needed\).)59
b(F)-8 b(or)37 b(example)g(to)0 1054 y(start)e(ro)s(otd)g(listening)g
(on)g(p)s(ort)f(5151)j(just)d(t)m(yp)s(e:)49 b Fe(rootd)e(-p)g(5151)33
b Fj(Notice)k(that)f(no)e(&)h(is)f(needed.)54 b(Ro)s(otd)0
1167 y(will)31 b(go)g(in)m(to)g(bac)m(kground)f(b)m(y)h(itself.)95
1441 y Fe(Rootd)47 b(arguments:)191 1554 y(-i)763 b(says)47
b(we)g(were)f(started)g(by)h(inetd)191 1667 y(-p)g(port#)476
b(specifies)45 b(a)j(different)d(port)i(to)g(listen)f(on)191
1780 y(-d)h(level)476 b(level)46 b(of)i(debug)e(info)h(written)e(to)j
(syslog)1050 1893 y(0)f(=)h(no)f(debug)f(\(default\))1050
2005 y(1)h(=)h(minimum)1050 2118 y(2)f(=)h(medium)1050
2231 y(3)f(=)h(maximum)0 2505 y Fj(Ro)s(otd)29 b(can)f(also)h(b)s(e)f
(con\014gured)g(for)g(anon)m(ymous)g(usage)h(\(lik)m(e)h(anon)m(ymous)e
(ftp\).)40 b(T)-8 b(o)29 b(setup)f(ro)s(otd)g(to)h(accept)0
2618 y(anon)m(ymous)h(logins)h(do)g(the)f(follo)m(wing)i(\(while)f(b)s
(eing)f(logged)i(in)e(as)g(ro)s(ot\):)143 2891 y Fe(-)48
b(Add)f(the)f(following)g(line)g(to)i(/etc/passwd:)239
3117 y(rootd:*:71:72:Anonymous)41 b(rootd:/var/spool/rootd:/b)o(in/)o
(fals)o(e)239 3343 y(where)46 b(you)h(may)g(modify)f(the)h(uid,)f(gid)h
(\(71,)g(72\))g(and)g(the)g(home)f(directory)239 3456
y(to)h(suite)f(your)h(system.)143 3681 y(-)h(Add)f(the)f(following)g
(line)g(to)i(/etc/group:)239 3907 y(rootd:*:72:rootd)239
4133 y(where)e(the)h(gid)g(must)f(match)h(the)g(gid)g(in)g
(/etc/passwd.)143 4359 y(-)h(Create)e(the)h(directories:)239
4585 y(mkdir)f(/var/spool/rootd)239 4698 y(mkdir)g
(/var/spool/rootd/tmp)239 4811 y(chmod)g(777)h(/var/spool/rootd/tmp)239
5036 y(Where)f(/var/spool/rootd)d(must)k(match)f(the)h(rootd)g(home)f
(directory)g(as)239 5149 y(specified)f(in)i(the)g(rootd)f(/etc/passwd)f
(entry.)143 5375 y(-)j(To)f(make)f(writeable)g(directories)e(for)j
(anonymous)f(do,)h(for)f(example:)239 5601 y(mkdir)g
(/var/spool/rootd/pub)239 5714 y(chown)g(rootd:rootd)f
(/var/spool/rootd/pub)p eop end
%%Page: 124 132
TeXDict begin 124 131 bop 0 299 a Fj(124)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(That's)42 b(all.)76 b(Sev)m(eral)43 b(additional)g(remarks:)64
b(y)m(ou)42 b(can)g(login)h(to)g(an)f(anon)m(ymous)f(serv)m(er)i
(either)f(with)g(the)0 668 y(names)31 b("anon)m(ymous")h(or)f("ro)s
(otd".)43 b(The)31 b(passw)m(ord)f(should)g(b)s(e)h(of)g(t)m(yp)s(e)g
(user@host.do.main.)43 b(Only)30 b(the)h(@)0 781 y(is)e(enforced)f(for)
h(the)f(time)i(b)s(eing.)39 b(In)28 b(anon)m(ymous)h(mo)s(de)f(the)g
(top)h(of)g(the)g(\014le)f(tree)i(is)e(set)h(to)h(the)e(ro)s(otd)h
(home)0 894 y(directory)-8 b(,)39 b(therefore)e(only)f(\014les)h(b)s
(elo)m(w)f(the)h(home)f(directory)h(can)f(b)s(e)g(accessed.)60
b(Anon)m(ymous)36 b(mo)s(de)g(only)0 1007 y(w)m(orks)30
b(when)g(the)g(serv)m(er)h(is)f(started)h(via)g(inetd.)0
1296 y Fd(10.2.5)113 b(Notes)36 b(ab)s(out)j(the)e(shmem)i(\014let)m
(yp)s(e:)0 1515 y Fj(Shared)34 b(memory)h(\014les)g(are)g(curren)m(tly)
g(supp)s(orted)e(on)i(most)h(Unix)f(platforms,)h(where)f(the)g(shared)f
(memory)0 1627 y(segmen)m(ts)d(are)g(managed)g(b)m(y)f(the)g(op)s
(erating)h(system)g(k)m(ernel)f(and)g(`liv)m(e')i(indep)s(enden)m(tly)d
(of)i(pro)s(cesses.)40 b(They)0 1740 y(are)34 b(not)g(deleted)h(\(b)m
(y)f(default\))g(when)f(the)h(pro)s(cess)f(whic)m(h)h(created)h(them)f
(terminates,)h(although)g(they)f(will)0 1853 y(disapp)s(ear)e(if)h(the)
h(system)f(is)g(reb)s(o)s(oted.)49 b(Applications)34
b(can)g(create)h(shared)d(memory)h(\014les)g(in)g(CFITSIO)f(b)m(y)0
1966 y(calling:)143 2214 y Fe(fit_create_file\(&fitsfile)o(ptr,)41
b("shmem://h2",)j(&status\);)0 2462 y Fj(where)25 b(the)g(ro)s(ot)h
(`\014le')f(names)h(are)f(curren)m(tly)g(restricted)h(to)g(b)s(e)f
('h0',)i('h1',)g('h2',)g('h3',)f(etc.,)i(up)d(to)g(a)h(maxim)m(um)0
2575 y(n)m(um)m(b)s(er)20 b(de\014ned)f(b)m(y)i(the)g(the)g(v)-5
b(alue)22 b(of)f(SHARED)p 1746 2575 28 4 v 33 w(MAXSEG)g(\(equal)h(to)f
(16)h(b)m(y)f(default\).)38 b(This)20 b(is)h(a)g(protot)m(yp)s(e)0
2688 y(implemen)m(tation)30 b(of)f(the)g(shared)f(memory)g(in)m
(terface)i(and)e(a)h(more)g(robust)f(in)m(terface,)j(whic)m(h)d(will)h
(ha)m(v)m(e)h(few)m(er)0 2801 y(restrictions)h(on)f(the)h(n)m(um)m(b)s
(er)e(of)i(\014les)f(and)g(on)g(their)g(names,)h(ma)m(y)g(b)s(e)f(dev)m
(elop)s(ed)g(in)g(the)h(future.)0 2961 y(When)23 b(op)s(ening)h(an)f
(already)h(existing)h(FITS)e(\014le)h(in)f(shared)g(memory)h(one)g
(calls)g(the)g(usual)g(CFITSIO)e(routine:)143 3209 y
Fe(fits_open_file\(&fitsfilep)o(tr,)41 b("shmem://h7",)j(mode,)j
(&status\))0 3457 y Fj(The)26 b(\014le)h(mo)s(de)g(can)g(b)s(e)f(READ)m
(WRITE)h(or)g(READONL)-8 b(Y)28 b(just)e(as)h(with)f(disk)h(\014les.)39
b(More)28 b(than)e(one)h(pro)s(cess)0 3570 y(can)35 b(op)s(erate)g(on)f
(READONL)-8 b(Y)35 b(mo)s(de)f(\014les)h(at)g(the)f(same)h(time.)54
b(CFITSIO)33 b(supp)s(orts)f(prop)s(er)h(\014le)i(lo)s(c)m(king)0
3682 y(\(b)s(oth)27 b(in)h(READONL)-8 b(Y)29 b(and)e(READ)m(WRITE)h(mo)
s(des\),)h(so)f(calls)h(to)f(\014ts)p 2572 3682 V 33
w(op)s(en)p 2795 3682 V 32 w(\014le)g(ma)m(y)g(b)s(e)f(lo)s(c)m(k)m(ed)
j(out)e(un)m(til)0 3795 y(another)j(other)f(pro)s(cess)g(closes)i(the)e
(\014le.)0 3956 y(When)g(an)g(application)i(is)e(\014nished)f
(accessing)j(a)e(FITS)g(\014le)g(in)g(a)h(shared)e(memory)h(segmen)m
(t,)i(it)f(ma)m(y)g(close)g(it)0 4068 y(\(and)j(the)g(\014le)g(will)g
(remain)f(in)h(the)g(system\))g(with)g(\014ts)p 1955
4068 V 32 w(close)p 2173 4068 V 34 w(\014le,)h(or)f(delete)h(it)g(with)
e(\014ts)p 3191 4068 V 33 w(delete)p 3455 4068 V 34 w(\014le.)51
b(Ph)m(ys-)0 4181 y(ical)36 b(deletion)g(is)f(p)s(ostp)s(oned)e(un)m
(til)j(the)f(last)g(pro)s(cess)g(calls)h(\013clos/\013delt.)56
b(\014ts)p 2801 4181 V 32 w(delete)p 3064 4181 V 34 w(\014le)35
b(tries)h(to)f(obtain)h(a)0 4294 y(READ)m(WRITE)e(lo)s(c)m(k)g(on)f
(the)g(\014le)h(to)g(b)s(e)e(deleted,)j(th)m(us)e(it)h(can)f(b)s(e)g
(blo)s(c)m(k)m(ed)h(if)f(the)h(ob)5 b(ject)34 b(w)m(as)f(not)h(op)s
(ened)0 4407 y(in)c(READ)m(WRITE)h(mo)s(de.)0 4567 y(A)i(shared)f
(memory)h(managemen)m(t)h(utilit)m(y)g(program)f(called)h(`smem',)f(is)
g(included)f(with)h(the)g(CFITSIO)e(dis-)0 4680 y(tribution.)39
b(It)27 b(can)g(b)s(e)f(built)h(b)m(y)g(t)m(yping)g(`mak)m(e)h(smem';)g
(then)f(t)m(yp)s(e)g(`smem)f(-h')h(to)h(get)g(a)f(list)g(of)g(v)-5
b(alid)27 b(options.)0 4793 y(Executing)37 b(smem)f(without)g(an)m(y)h
(options)g(causes)f(it)h(to)g(list)g(all)g(the)g(shared)e(memory)i
(segmen)m(ts)g(curren)m(tly)0 4906 y(residing)c(in)g(the)g(system)h
(and)e(managed)i(b)m(y)f(the)h(shared)e(memory)h(driv)m(er.)49
b(T)-8 b(o)34 b(get)g(a)g(list)g(of)f(all)h(the)g(shared)0
5019 y(memory)c(ob)5 b(jects,)32 b(run)d(the)h(system)h(utilit)m(y)g
(program)f(`ip)s(cs)h([-a]'.)0 5351 y Ff(10.3)136 b(Base)45
b(Filename)0 5601 y Fj(The)31 b(base)g(\014lename)h(is)f(the)h(name)f
(of)h(the)f(\014le)h(optionally)g(including)f(the)h(director/sub)s
(directory)f(path,)h(and)0 5714 y(in)e(the)h(case)g(of)g(`ftp',)f(`h)m
(ttp',)i(and)d(`ro)s(ot')j(\014let)m(yp)s(es,)e(the)h(mac)m(hine)g
(iden)m(ti\014er.)41 b(Examples:)p eop end
%%Page: 125 133
TeXDict begin 125 132 bop 0 299 a Fh(10.3.)73 b(BASE)30
b(FILENAME)2739 b Fj(125)191 555 y Fe(myfile.fits)191
668 y(!data.fits)191 781 y(/data/myfile.fits)191 894
y(fits.gsfc.nasa.gov/ftp/s)o(ampl)o(eda)o(ta/m)o(yfil)o(e.f)o(its.)o
(gz)0 1120 y Fj(When)29 b(creating)h(a)f(new)f(output)h(\014le)g(on)g
(magnetic)h(disk)e(\(of)i(t)m(yp)s(e)f(\014le://\))h(if)f(the)g(base)g
(\014lename)g(b)s(egins)f(with)0 1233 y(an)34 b(exclamation)j(p)s(oin)m
(t)d(\(!\))54 b(then)34 b(an)m(y)g(existing)i(\014le)e(with)g(that)h
(same)g(basename)g(will)g(b)s(e)e(deleted)i(prior)f(to)0
1346 y(creating)h(the)f(new)g(FITS)f(\014le.)51 b(Otherwise)34
b(if)g(the)g(\014le)g(to)g(b)s(e)g(created)h(already)f(exists,)i(then)d
(CFITSIO)g(will)0 1459 y(return)g(an)h(error)f(and)g(will)i(not)f(o)m
(v)m(erwrite)h(the)f(existing)h(\014le.)52 b(Note)35
b(that)g(the)f(exclamation)i(p)s(oin)m(t,)f(')10 b(!',)36
b(is)e(a)0 1572 y(sp)s(ecial)28 b(UNIX)g(c)m(haracter,)j(so)d(if)f(it)i
(is)f(used)f(on)g(the)h(command)g(line)g(rather)g(than)f(en)m(tered)h
(at)h(a)f(task)h(prompt,)0 1685 y(it)j(m)m(ust)f(b)s(e)g(preceded)g(b)m
(y)h(a)g(bac)m(kslash)g(to)g(force)g(the)g(UNIX)g(shell)f(to)h(pass)f
(it)i(v)m(erbatim)f(to)g(the)g(application)0 1798 y(program.)0
1958 y(If)24 b(the)i(output)e(disk)h(\014le)g(name)g(ends)f(with)g(the)
h(su\016x)f('.gz',)k(then)d(CFITSIO)e(will)i(compress)g(the)g(\014le)g
(using)g(the)0 2071 y(gzip)g(compression)f(algorithm)h(b)s(efore)f
(writing)g(it)h(to)g(disk.)38 b(This)23 b(can)i(reduce)f(the)g(amoun)m
(t)h(of)f(disk)g(space)h(used)0 2184 y(b)m(y)34 b(the)h(\014le.)53
b(Note)36 b(that)f(this)g(feature)g(requires)f(that)h(the)f
(uncompressed)g(\014le)g(b)s(e)g(constructed)h(in)f(memory)0
2297 y(b)s(efore)c(it)h(is)f(compressed)g(and)g(written)h(to)g(disk,)f
(so)g(it)h(can)g(fail)g(if)f(there)h(is)f(insu\016cien)m(t)h(a)m(v)-5
b(ailable)33 b(memory)-8 b(.)0 2457 y(An)45 b(input)g(FITS)f(\014le)i
(ma)m(y)g(b)s(e)f(compressed)g(with)h(the)f(gzip)h(or)g(Unix)f
(compress)h(algorithms,)k(in)45 b(whic)m(h)0 2570 y(case)38
b(CFITSIO)e(will)i(uncompress)e(the)i(\014le)g(on)f(the)h(\015y)e(in)m
(to)j(a)f(temp)s(orary)f(\014le)g(\(in)h(memory)f(or)g(on)h(disk\).)0
2683 y(Compressed)32 b(\014les)i(ma)m(y)g(only)f(b)s(e)g(op)s(ened)f
(with)h(read-only)h(p)s(ermission.)49 b(When)33 b(sp)s(ecifying)g(the)h
(name)f(of)h(a)0 2796 y(compressed)h(FITS)g(\014le)h(it)g(is)g(not)g
(necessary)g(to)g(app)s(end)e(the)i(\014le)g(su\016x)e(\(e.g.,)39
b(`.gz')e(or)f(`.Z'\).)g(If)f(CFITSIO)0 2908 y(cannot)24
b(\014nd)e(the)h(input)f(\014le)i(name)f(without)g(the)g(su\016x,)h
(then)f(it)h(will)g(automatically)i(searc)m(h)e(for)f(a)g(compressed)0
3021 y(\014le)36 b(with)f(the)h(same)g(ro)s(ot)g(name.)57
b(In)35 b(the)h(case)h(of)f(reading)g(ftp)f(and)g(h)m(ttp)h(t)m(yp)s(e)
g(\014les,)h(CFITSIO)e(generally)0 3134 y(lo)s(oks)j(for)g(a)g
(compressed)g(v)m(ersion)g(of)g(the)g(\014le)g(\014rst,)h(b)s(efore)e
(trying)h(to)h(op)s(en)e(the)h(uncompressed)e(\014le.)64
b(By)0 3247 y(default,)37 b(CFITSIO)e(copies)h(\(and)g(uncompressed)e
(if)i(necessary\))g(the)g(ftp)f(or)h(h)m(ttp)g(FITS)f(\014le)g(in)m(to)
i(memory)0 3360 y(on)f(the)g(lo)s(cal)h(mac)m(hine)f(b)s(efore)g(op)s
(ening)f(it.)58 b(This)35 b(will)h(fail)g(if)g(the)g(lo)s(cal)h(mac)m
(hine)g(do)s(es)e(not)h(ha)m(v)m(e)h(enough)0 3473 y(memory)g(to)h
(hold)f(the)g(whole)h(FITS)e(\014le,)k(so)d(in)g(this)g(case,)k(the)c
(output)g(\014lename)g(sp)s(eci\014er)g(\(see)h(the)g(next)0
3586 y(section\))32 b(can)f(b)s(e)e(used)h(to)h(further)e(con)m(trol)j
(ho)m(w)e(CFITSIO)f(reads)h(ftp)g(and)g(h)m(ttp)g(\014les.)0
3746 y(If)i(the)h(input)f(\014le)h(is)g(an)g(IRAF)g(image)h(\014le)f
(\(*.imh)g(\014le\))h(then)e(CFITSIO)f(will)j(automatically)h(con)m(v)m
(ert)g(it)e(on)0 3859 y(the)27 b(\015y)g(in)m(to)h(a)g(virtual)f(FITS)f
(image)j(b)s(efore)e(it)g(is)g(op)s(ened)g(b)m(y)g(the)g(application)i
(program.)39 b(IRAF)27 b(images)i(can)0 3972 y(only)h(b)s(e)g(op)s
(ened)g(with)g(READONL)-8 b(Y)31 b(\014le)f(access.)0
4132 y(Similarly)-8 b(,)32 b(if)f(the)g(input)f(\014le)i(is)f(a)g(ra)m
(w)g(binary)f(data)i(arra)m(y)-8 b(,)33 b(then)d(CFITSIO)g(will)h(con)m
(v)m(ert)i(it)e(on)g(the)h(\015y)e(in)m(to)0 4245 y(a)38
b(virtual)g(FITS)g(image)h(with)e(the)h(basic)h(set)f(of)g(required)f
(header)h(k)m(eyw)m(ords)g(b)s(efore)g(it)g(is)g(op)s(ened)f(b)m(y)h
(the)0 4358 y(application)32 b(program)f(\(with)g(READONL)-8
b(Y)31 b(access\).)44 b(In)30 b(this)h(case)h(the)f(data)g(t)m(yp)s(e)g
(and)g(dimensions)f(of)h(the)0 4471 y(image)d(m)m(ust)f(b)s(e)f(sp)s
(eci\014ed)g(in)h(square)g(brac)m(k)m(ets)h(follo)m(wing)g(the)f
(\014lename)g(\(e.g.)41 b(ra)m(w\014le.dat[ib512,512]\).)j(The)0
4584 y(\014rst)30 b(c)m(haracter)i(\(case)f(insensitiv)m(e\))h
(de\014nes)e(the)g(data)h(t)m(yp)s(e)g(of)f(the)h(arra)m(y:)239
4810 y Fe(b)429 b(8-bit)46 b(unsigned)g(byte)239 4923
y(i)381 b(16-bit)46 b(signed)g(integer)239 5036 y(u)381
b(16-bit)46 b(unsigned)g(integer)239 5149 y(j)381 b(32-bit)46
b(signed)g(integer)239 5262 y(r)h(or)g(f)143 b(32-bit)46
b(floating)g(point)239 5375 y(d)381 b(64-bit)46 b(floating)g(point)0
5601 y Fj(An)40 b(optional)h(second)f(c)m(haracter)i(sp)s(eci\014es)e
(the)h(b)m(yte)f(order)g(of)g(the)h(arra)m(y)g(v)-5 b(alues:)60
b(b)40 b(or)g(B)h(indicates)g(big)0 5714 y(endian)30
b(\(as)g(in)g(FITS)f(\014les)h(and)f(the)h(nativ)m(e)i(format)e(of)g
(SUN)g(UNIX)g(w)m(orkstations)h(and)f(Mac)h(PCs\))e(and)h(l)g(or)p
eop end
%%Page: 126 134
TeXDict begin 126 133 bop 0 299 a Fj(126)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(L)27 b(indicates)i(little)g(endian)e(\(nativ)m(e)j(format)d
(of)h(DEC)g(OSF)f(w)m(orkstations)h(and)f(IBM)h(PCs\).)40
b(If)27 b(this)g(c)m(haracter)0 668 y(is)f(omitted)g(then)f(the)h(arra)
m(y)g(is)g(assumed)f(to)h(ha)m(v)m(e)h(the)f(nativ)m(e)g(b)m(yte)h
(order)e(of)h(the)f(lo)s(cal)i(mac)m(hine.)40 b(These)25
b(data)0 781 y(t)m(yp)s(e)35 b(c)m(haracters)h(are)g(then)e(follo)m(w)m
(ed)j(b)m(y)d(a)i(series)f(of)g(one)g(or)g(more)g(in)m(teger)h(v)-5
b(alues)35 b(separated)h(b)m(y)e(commas)0 894 y(whic)m(h)41
b(de\014ne)f(the)h(size)h(of)f(eac)m(h)h(dimension)f(of)g(the)g(ra)m(w)
g(arra)m(y)-8 b(.)74 b(Arra)m(ys)41 b(with)f(up)g(to)i(5)f(dimensions)g
(are)0 1007 y(curren)m(tly)31 b(supp)s(orted.)41 b(Finally)-8
b(,)33 b(a)e(b)m(yte)h(o\013set)g(to)g(the)f(p)s(osition)h(of)f(the)g
(\014rst)f(pixel)i(in)f(the)g(data)h(\014le)f(ma)m(y)h(b)s(e)0
1120 y(sp)s(eci\014ed)h(b)m(y)g(separating)i(it)f(with)f(a)h(':')48
b(from)33 b(the)h(last)g(dimension)f(v)-5 b(alue.)51
b(If)33 b(omitted,)j(it)e(is)f(assumed)g(that)0 1233
y(the)i(o\013set)h(=)f(0.)54 b(This)35 b(parameter)g(ma)m(y)h(b)s(e)e
(used)g(to)i(skip)e(o)m(v)m(er)i(an)m(y)g(header)e(information)i(in)e
(the)h(\014le)g(that)0 1346 y(precedes)30 b(the)h(binary)f(data.)41
b(F)-8 b(urther)30 b(examples:)95 1603 y Fe(raw.dat[b10000])521
b(1-dimensional)45 b(10000)h(pixel)g(byte)h(array)95
1715 y(raw.dat[rb400,400,12])233 b(3-dimensional)45 b(floating)g(point)
h(big-endian)f(array)95 1828 y(img.fits[ib512,512:2880])89
b(reads)47 b(the)g(512)g(x)g(512)g(short)f(integer)g(array)g(in)1336
1941 y(a)i(FITS)e(file,)h(skipping)e(over)i(the)g(2880)g(byte)f(header)
0 2198 y Fj(One)25 b(sp)s(ecial)g(case)h(of)f(input)f(\014le)h(is)g
(where)g(the)g(\014lename)g(=)g(`-')h(\(a)f(dash)g(or)g(min)m(us)f
(sign\))h(or)g('stdin')g(or)g('stdout',)0 2311 y(whic)m(h)d
(signi\014es)h(that)h(the)f(input)e(\014le)i(is)g(to)h(b)s(e)e(read)g
(from)h(the)g(stdin)f(stream,)j(or)e(written)f(to)i(the)f(stdout)g
(stream)0 2424 y(if)34 b(a)g(new)g(output)f(\014le)h(is)g(b)s(eing)g
(created.)52 b(In)33 b(the)h(case)h(of)f(reading)h(from)e(stdin,)h
(CFITSIO)f(\014rst)g(copies)i(the)0 2537 y(whole)g(stream)h(in)m(to)g
(a)f(temp)s(orary)g(FITS)f(\014le)i(\(in)f(memory)g(or)g(on)g(disk\),)h
(and)f(subsequen)m(t)f(reading)h(of)h(the)0 2650 y(FITS)c(\014le)h(o)s
(ccurs)g(in)f(this)h(cop)m(y)-8 b(.)49 b(When)33 b(writing)g(to)g
(stdout,)h(CFITSIO)d(\014rst)h(constructs)h(the)g(whole)g(\014le)g(in)0
2763 y(memory)h(\(since)i(random)d(access)j(is)e(required\),)i(then)e
(\015ushes)f(it)i(out)g(to)g(the)f(stdout)h(stream)g(when)e(the)i
(\014le)0 2876 y(is)30 b(closed.)42 b(In)29 b(addition,)i(if)f(the)g
(output)g(\014lename)g(=)g('-.gz')i(or)e('stdout.gz')h(then)f(it)h
(will)f(b)s(e)g(gzip)g(compressed)0 2989 y(b)s(efore)g(b)s(eing)g
(written)g(to)h(stdout.)0 3149 y(This)25 b(abilit)m(y)j(to)e(read)g
(and)f(write)h(on)g(the)g(stdin)g(and)f(stdout)h(steams)g(allo)m(ws)i
(FITS)d(\014les)h(to)g(b)s(e)g(pip)s(ed)e(b)s(et)m(w)m(een)0
3262 y(tasks)42 b(in)f(memory)g(rather)g(than)h(ha)m(ving)g(to)g
(create)h(temp)s(orary)e(in)m(termediate)i(FITS)d(\014les)i(on)f(disk.)
73 b(F)-8 b(or)0 3375 y(example)28 b(if)e(task1)i(creates)h(an)e
(output)f(FITS)g(\014le,)i(and)f(task2)g(reads)g(an)g(input)f(FITS)g
(\014le,)i(the)f(FITS)f(\014le)h(ma)m(y)0 3487 y(b)s(e)j(pip)s(ed)f(b)s
(et)m(w)m(een)i(the)f(2)h(tasks)g(b)m(y)f(sp)s(ecifying)143
3744 y Fe(task1)47 b(-)g(|)g(task2)g(-)0 4001 y Fj(where)30
b(the)h(v)m(ertical)i(bar)e(is)f(the)h(Unix)g(piping)f(sym)m(b)s(ol.)42
b(This)30 b(assumes)g(that)i(the)f(2)g(tasks)g(read)g(the)g(name)g(of)0
4114 y(the)g(FITS)e(\014le)i(o\013)f(of)h(the)g(command)f(line.)0
4448 y Ff(10.4)136 b(Output)44 b(File)i(Name)f(when)g(Op)t(ening)g(an)g
(Existing)h(File)0 4698 y Fj(An)36 b(optional)i(output)e(\014lename)h
(ma)m(y)h(b)s(e)e(sp)s(eci\014ed)g(in)g(paren)m(theses)h(immediately)h
(follo)m(wing)g(the)f(base)g(\014le)0 4811 y(name)28
b(to)h(b)s(e)f(op)s(ened.)39 b(This)28 b(is)g(mainly)g(useful)g(in)g
(those)g(cases)i(where)d(CFITSIO)g(creates)j(a)e(temp)s(orary)g(cop)m
(y)0 4924 y(of)i(the)f(input)g(FITS)f(\014le)i(b)s(efore)f(it)h(is)f
(op)s(ened)g(and)f(passed)h(to)h(the)g(application)h(program.)40
b(This)28 b(happ)s(ens)g(b)m(y)0 5036 y(default)i(when)g(op)s(ening)g
(a)g(net)m(w)m(ork)h(FTP)g(or)f(HTTP-t)m(yp)s(e)g(\014le,)h(when)e
(reading)h(a)h(compressed)f(FITS)g(\014le)g(on)0 5149
y(a)36 b(lo)s(cal)h(disk,)g(when)e(reading)h(from)g(the)g(stdin)f
(stream,)j(or)d(when)g(a)i(column)e(\014lter,)j(ro)m(w)e(\014lter,)h
(or)f(binning)0 5262 y(sp)s(eci\014er)29 b(is)g(included)g(as)h(part)f
(of)g(the)h(input)f(\014le)g(sp)s(eci\014cation.)41 b(By)30
b(default)g(this)f(temp)s(orary)g(\014le)g(is)h(created)0
5375 y(in)g(memory)-8 b(.)41 b(If)29 b(there)h(is)g(not)g(enough)g
(memory)g(to)h(create)g(the)g(\014le)f(cop)m(y)-8 b(,)31
b(then)f(CFITSIO)e(will)i(exit)h(with)f(an)0 5488 y(error.)45
b(In)32 b(these)g(cases)h(one)g(can)f(force)h(a)f(p)s(ermanen)m(t)g
(\014le)g(to)h(b)s(e)e(created)i(on)f(disk,)g(instead)h(of)f(a)g(temp)s
(orary)0 5601 y(\014le)38 b(in)f(memory)-8 b(,)40 b(b)m(y)d(supplying)f
(the)i(name)g(in)f(paren)m(theses)h(immediately)h(follo)m(wing)g(the)e
(base)h(\014le)g(name.)0 5714 y(The)30 b(output)g(\014lename)g(can)h
(include)f(the)h(')10 b(!')41 b(clobb)s(er)30 b(\015ag.)p
eop end
%%Page: 127 135
TeXDict begin 127 134 bop 0 299 a Fh(10.4.)73 b(OUTPUT)29
b(FILE)h(NAME)h(WHEN)g(OPENING)f(AN)h(EXISTING)f(FILE)876
b Fj(127)0 555 y(Th)m(us,)48 b(if)d(the)g(input)f(\014lename)h(to)g
(CFITSIO)f(is:)70 b Fe(file1.fits.gz\(file2.fit)o(s\))39
b Fj(then)44 b(CFITSIO)g(will)0 668 y(uncompress)39 b
(`\014le1.\014ts.gz')j(in)m(to)f(the)f(lo)s(cal)h(disk)e(\014le)h
(`\014le2.\014ts')h(b)s(efore)f(op)s(ening)f(it.)70 b(CFITSIO)38
b(do)s(es)i(not)0 781 y(automatically)33 b(delete)f(the)e(output)g
(\014le,)h(so)g(it)g(will)f(still)i(exist)f(after)g(the)f(application)i
(program)e(exits.)0 941 y(The)i(output)h(\014lename)g("mem://")i(is)e
(also)h(allo)m(w)m(ed,)i(whic)m(h)c(will)i(write)f(the)g(output)f
(\014le)h(in)m(to)h(memory)-8 b(,)35 b(and)0 1054 y(also)28
b(allo)m(w)g(write)f(access)h(to)g(the)f(\014le.)39 b(This)26
b('\014le')i(will)f(disapp)s(ear)f(when)g(it)h(is)g(closed,)h(but)e
(this)h(ma)m(y)h(b)s(e)e(useful)0 1167 y(for)k(some)h(applications)g
(whic)m(h)g(only)f(need)g(to)h(mo)s(dify)f(a)h(temp)s(orary)f(cop)m(y)h
(of)f(the)h(\014le.)0 1327 y(In)k(some)i(cases,)h(sev)m(eral)f
(di\013eren)m(t)g(temp)s(orary)e(FITS)h(\014les)g(will)g(b)s(e)f
(created)i(in)f(sequence,)i(for)e(instance,)i(if)0 1440
y(one)f(op)s(ens)g(a)g(remote)h(\014le)f(using)g(FTP)-8
b(,)37 b(then)g(\014lters)g(ro)m(ws)g(in)g(a)h(binary)e(table)i
(extension,)i(then)c(create)j(an)0 1553 y(image)f(b)m(y)f(binning)f(a)h
(pair)g(of)g(columns.)60 b(In)36 b(this)h(case,)j(the)d(remote)h
(\014le)f(will)g(b)s(e)f(copied)h(to)h(a)f(temp)s(orary)0
1666 y(lo)s(cal)j(\014le,)h(then)d(a)h(second)f(temp)s(orary)h(\014le)f
(will)h(b)s(e)f(created)i(con)m(taining)g(the)e(\014ltered)h(ro)m(ws)f
(of)h(the)g(table,)0 1779 y(and)c(\014nally)g(a)h(third)e(temp)s(orary)
h(\014le)h(con)m(taining)g(the)g(binned)e(image)i(will)g(b)s(e)f
(created.)57 b(In)34 b(cases)i(lik)m(e)h(this)0 1892
y(where)28 b(m)m(ultiple)h(\014les)f(are)h(created,)h(the)e(out\014le)h
(sp)s(eci\014er)f(will)g(b)s(e)g(in)m(terpreted)h(the)f(name)g(of)h
(the)f(\014nal)g(\014le)h(as)0 2005 y(describ)s(ed)g(b)s(elo)m(w,)i(in)
f(descending)g(priorit)m(y:)136 2266 y Fc(\017)46 b Fj(as)29
b(the)g(name)g(of)g(the)g(\014nal)f(image)i(\014le)f(if)f(an)h(image)h
(within)e(a)h(single)g(binary)f(table)i(cell)g(is)e(op)s(ened)g(or)h
(if)227 2379 y(an)i(image)g(is)g(created)g(b)m(y)f(binning)g(a)g(table)
i(column.)136 2568 y Fc(\017)46 b Fj(as)33 b(the)f(name)h(of)f(the)h
(\014le)f(con)m(taining)i(the)e(\014ltered)g(table)i(if)e(a)h(column)f
(\014lter)g(and/or)g(a)h(ro)m(w)f(\014lter)h(are)227
2681 y(sp)s(eci\014ed.)136 2870 y Fc(\017)46 b Fj(as)31
b(the)f(name)h(of)f(the)h(lo)s(cal)h(cop)m(y)f(of)f(the)h(remote)g(FTP)
f(or)h(HTTP)e(\014le.)136 3059 y Fc(\017)46 b Fj(as)31
b(the)g(name)g(of)g(the)f(uncompressed)g(v)m(ersion)h(of)g(the)f(FITS)g
(\014le,)h(if)g(a)g(compressed)f(FITS)g(\014le)h(on)g(lo)s(cal)227
3172 y(disk)f(has)g(b)s(een)g(op)s(ened.)136 3361 y Fc(\017)46
b Fj(otherwise,)31 b(the)g(output)f(\014lename)g(is)h(ignored.)0
3622 y(The)e(output)f(\014le)h(sp)s(eci\014er)g(is)g(useful)f(when)g
(reading)h(FTP)g(or)g(HTTP-t)m(yp)s(e)g(FITS)f(\014les)h(since)g(it)h
(can)f(b)s(e)g(used)0 3735 y(to)34 b(create)i(a)e(lo)s(cal)h(disk)e
(cop)m(y)i(of)f(the)g(\014le)f(that)i(can)f(b)s(e)f(reused)g(in)g(the)h
(future.)50 b(If)33 b(the)h(output)g(\014le)f(name)h(=)0
3848 y(`*')i(then)e(a)i(lo)s(cal)g(\014le)f(with)g(the)g(same)g(name)g
(as)g(the)h(net)m(w)m(ork)f(\014le)g(will)h(b)s(e)e(created.)56
b(Note)36 b(that)f(CFITSIO)0 3961 y(will)30 b(b)s(eha)m(v)m(e)g
(di\013eren)m(tly)h(dep)s(ending)d(on)i(whether)f(the)h(remote)g
(\014le)g(is)g(compressed)f(or)h(not)g(as)g(sho)m(wn)f(b)m(y)h(the)0
4074 y(follo)m(wing)i(examples:)136 4309 y Fc(\017)46
b Fe(ftp://remote.machine/tmp/)o(myfi)o(le.f)o(its)o(.gz\()o(*\))28
b Fj(-)35 b(the)g(remote)h(compressed)e(\014le)h(is)g(copied)g(to)227
4422 y(the)d(lo)s(cal)h(compressed)f(\014le)g(`m)m(y\014le.\014ts.gz',)
i(whic)m(h)d(is)h(then)g(uncompressed)e(in)i(lo)s(cal)h(memory)e(b)s
(efore)227 4535 y(b)s(eing)f(op)s(ened)g(and)g(passed)f(to)j(the)e
(application)i(program.)136 4724 y Fc(\017)46 b Fe
(ftp://remote.machine/tmp/)o(myfi)o(le.f)o(its)o(.gz\()o(myfi)o(le.)o
(fits)o(\))33 b Fj(-)39 b(the)g(remote)h(compressed)f(\014le)227
4837 y(is)d(copied)g(and)f(uncompressed)g(in)m(to)h(the)g(lo)s(cal)h
(\014le)f(`m)m(y\014le.\014ts'.)57 b(This)35 b(example)h(requires)g
(less)g(lo)s(cal)227 4950 y(memory)21 b(than)g(the)g(previous)f
(example)i(since)f(the)g(\014le)g(is)g(uncompressed)e(on)i(disk)g
(instead)g(of)g(in)f(memory)-8 b(.)136 5139 y Fc(\017)46
b Fe(ftp://remote.machine/tmp/)o(myfi)o(le.f)o(its)o(\(myf)o(ile.)o
(fit)o(s.gz)o(\))24 b Fj(-)30 b(this)g(will)g(usually)g(pro)s(duce)f
(an)227 5252 y(error)h(since)h(CFITSIO)e(itself)i(cannot)g(compress)f
(\014les.)0 5488 y(The)36 b(exact)i(b)s(eha)m(vior)e(of)h(CFITSIO)e(in)
h(the)h(latter)g(case)h(dep)s(ends)c(on)j(the)f(t)m(yp)s(e)h(of)g(ftp)f
(serv)m(er)g(running)f(on)0 5601 y(the)c(remote)g(mac)m(hine)g(and)f
(ho)m(w)g(it)h(is)f(con\014gured.)40 b(In)30 b(some)h(cases,)g(if)f
(the)h(\014le)f(`m)m(y\014le.\014ts.gz')j(exists)e(on)f(the)0
5714 y(remote)38 b(mac)m(hine,)h(then)e(the)g(serv)m(er)g(will)h(cop)m
(y)f(it)h(to)f(the)h(lo)s(cal)g(mac)m(hine.)61 b(In)36
b(other)h(cases)h(the)f(ftp)g(serv)m(er)p eop end
%%Page: 128 136
TeXDict begin 128 135 bop 0 299 a Fj(128)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(will)36 b(automatically)j(create)e(and)f(transmit)g(a)g
(compressed)g(v)m(ersion)g(of)g(the)g(\014le)g(if)g(only)g(the)g
(uncompressed)0 668 y(v)m(ersion)27 b(exists.)41 b(This)26
b(can)h(get)h(rather)f(confusing,)h(so)f(users)f(should)g(use)h(a)g
(certain)h(amoun)m(t)g(of)f(caution)h(when)0 781 y(using)34
b(the)h(output)f(\014le)h(sp)s(eci\014er)f(with)h(FTP)f(or)h(HTTP)f
(\014le)h(t)m(yp)s(es,)h(to)f(mak)m(e)h(sure)e(they)h(get)h(the)f(b)s
(eha)m(vior)0 894 y(that)c(they)g(exp)s(ect.)0 1250 y
Ff(10.5)136 b(T)-11 b(emplate)45 b(File)h(Name)g(when)e(Creating)j(a)e
(New)g(File)0 1504 y Fj(When)38 b(a)h(new)f(FITS)g(\014le)h(is)g
(created)g(with)g(a)f(call)i(to)g(\014ts)p 2101 1504
28 4 v 32 w(create)p 2369 1504 V 35 w(\014le,)g(the)f(name)g(of)g(a)g
(template)h(\014le)e(ma)m(y)0 1617 y(b)s(e)h(supplied)g(in)h(paren)m
(theses)g(immediately)h(follo)m(wing)g(the)g(name)f(of)g(the)g(new)f
(\014le)h(to)h(b)s(e)e(created.)71 b(This)0 1730 y(template)27
b(is)e(used)g(to)h(de\014ne)f(the)h(structure)f(of)h(one)f(or)h(more)g
(HDUs)g(in)f(the)h(new)f(\014le.)39 b(The)25 b(template)i(\014le)e(ma)m
(y)0 1843 y(b)s(e)32 b(another)h(FITS)f(\014le,)i(in)f(whic)m(h)f(case)
i(the)f(newly)g(created)h(\014le)f(will)g(ha)m(v)m(e)h(exactly)h(the)e
(same)g(k)m(eyw)m(ords)g(in)0 1956 y(eac)m(h)25 b(HDU)g(as)g(in)f(the)g
(template)i(FITS)d(\014le,)j(but)d(all)j(the)e(data)h(units)e(will)i(b)
s(e)f(\014lled)g(with)f(zeros.)40 b(The)24 b(template)0
2069 y(\014le)i(ma)m(y)h(also)g(b)s(e)e(an)h(ASCI)s(I)e(text)j(\014le,)
g(where)f(eac)m(h)h(line)f(\(in)g(general\))i(describ)s(es)d(one)h
(FITS)f(k)m(eyw)m(ord)i(record.)0 2182 y(The)j(format)h(of)f(the)h
(ASCI)s(I)e(template)i(\014le)g(is)f(describ)s(ed)f(in)i(the)f(follo)m
(wing)i(T)-8 b(emplate)31 b(Files)h(c)m(hapter.)0 2538
y Ff(10.6)136 b(Image)46 b(Tile-Compression)g(Sp)t(eci\014cation)0
2792 y Fj(When)28 b(sp)s(ecifying)g(the)h(name)g(of)f(the)h(output)f
(FITS)g(\014le)g(to)h(b)s(e)f(created,)i(the)f(user)f(can)g(indicate)i
(that)f(images)0 2905 y(should)d(b)s(e)h(written)g(in)g
(tile-compressed)h(format)g(\(see)g(section)g(5.5,)h(\\Primary)e(Arra)m
(y)h(or)f(IMA)m(GE)h(Extension)0 3018 y(I/O)f(Routines"\))i(b)m(y)e
(enclosing)h(the)g(compression)f(parameters)h(in)f(square)g(brac)m(k)m
(ets)i(follo)m(wing)g(the)f(ro)s(ot)f(disk)0 3131 y(\014le)j(name.)41
b(Here)31 b(are)g(some)g(examples)g(of)f(the)h(syn)m(tax)g(for)f(sp)s
(ecifying)g(tile-compressed)i(output)e(images:)191 3410
y Fe(myfile.fit[compress])185 b(-)48 b(use)f(Rice)f(algorithm)g(and)h
(default)e(tile)i(size)191 3636 y(myfile.fit[compress)42
b(GZIP])47 b(-)g(use)g(the)g(specified)e(compression)g(algorithm;)191
3748 y(myfile.fit[compress)d(Rice])238 b(only)46 b(the)h(first)g
(letter)f(of)h(the)g(algorithm)191 3861 y(myfile.fit[compress)42
b(PLIO])238 b(name)46 b(is)i(required.)191 4087 y(myfile.fit[compress)
42 b(Rice)47 b(100,100])141 b(-)48 b(use)e(100)h(x)h(100)f(pixel)f
(tile)h(size)191 4200 y(myfile.fit[compress)42 b(Rice)47
b(100,100;2])e(-)j(as)f(above,)f(and)h(use)g(noisebits)e(=)i(2)0
4556 y Ff(10.7)136 b(HDU)45 b(Lo)t(cation)g(Sp)t(eci\014cation)0
4811 y Fj(The)c(optional)h(HDU)h(lo)s(cation)g(sp)s(eci\014er)d
(de\014nes)h(whic)m(h)g(HDU)h(\(Header-Data)i(Unit,)h(also)d(kno)m(wn)f
(as)h(an)0 4924 y(`extension'\))36 b(within)d(the)i(FITS)e(\014le)h(to)
h(initially)h(op)s(en.)51 b(It)34 b(m)m(ust)g(immediately)i(follo)m(w)f
(the)f(base)h(\014le)f(name)0 5036 y(\(or)g(the)g(output)g(\014le)g
(name)f(if)h(presen)m(t\).)52 b(If)33 b(it)h(is)g(not)g(sp)s(eci\014ed)
g(then)f(the)h(\014rst)f(HDU)i(\(the)f(primary)f(arra)m(y\))0
5149 y(is)g(op)s(ened.)46 b(The)32 b(HDU)h(lo)s(cation)h(sp)s
(eci\014er)e(is)h(required)f(if)g(the)h(colFilter,)i(ro)m(wFilter,)g
(or)e(binSp)s(ec)e(sp)s(eci\014ers)0 5262 y(are)f(presen)m(t,)f(b)s
(ecause)h(the)f(primary)f(arra)m(y)i(is)f(not)h(a)f(v)-5
b(alid)30 b(HDU)g(for)f(these)g(op)s(erations.)41 b(The)29
b(HDU)h(ma)m(y)g(b)s(e)0 5375 y(sp)s(eci\014ed)e(either)i(b)m(y)e
(absolute)i(p)s(osition)f(n)m(um)m(b)s(er,)f(starting)i(with)e(0)i(for)
e(the)h(primary)f(arra)m(y)-8 b(,)31 b(or)e(b)m(y)f(reference)0
5488 y(to)h(the)g(HDU)g(name,)g(and)f(optionally)-8 b(,)31
b(the)e(v)m(ersion)g(n)m(um)m(b)s(er)e(and)h(the)h(HDU)g(t)m(yp)s(e)g
(of)f(the)h(desired)f(extension.)0 5601 y(The)k(lo)s(cation)h(of)f(an)g
(image)i(within)d(a)i(single)f(cell)i(of)e(a)g(binary)g(table)h(ma)m(y)
f(also)h(b)s(e)f(sp)s(eci\014ed,)g(as)g(describ)s(ed)0
5714 y(b)s(elo)m(w.)p eop end
%%Page: 129 137
TeXDict begin 129 136 bop 0 299 a Fh(10.7.)73 b(HDU)31
b(LOCA)-8 b(TION)29 b(SPECIFICA)-8 b(TION)2019 b Fj(129)0
555 y(The)26 b(absolute)h(p)s(osition)f(of)g(the)h(extension)g(is)f(sp)
s(eci\014ed)f(either)i(b)m(y)f(enclosed)h(the)g(n)m(um)m(b)s(er)e(in)h
(square)f(brac)m(k)m(ets)0 668 y(\(e.g.,)k(`[1]')g(=)d(the)h(\014rst)f
(extension)h(follo)m(wing)i(the)e(primary)e(arra)m(y\))j(or)f(b)m(y)f
(preceded)h(the)g(n)m(um)m(b)s(er)e(with)i(a)g(plus)0
781 y(sign)37 b(\(`+1'\).)63 b(T)-8 b(o)38 b(sp)s(ecify)f(the)g(HDU)h
(b)m(y)g(name,)h(giv)m(e)g(the)e(name)h(of)f(the)h(desired)f(HDU)h
(\(the)f(v)-5 b(alue)38 b(of)g(the)0 894 y(EXTNAME)e(or)g(HDUNAME)h(k)m
(eyw)m(ord\))g(and)f(optionally)h(the)f(extension)h(v)m(ersion)f(n)m
(um)m(b)s(er)f(\(v)-5 b(alue)37 b(of)f(the)0 1007 y(EXTVER)27
b(k)m(eyw)m(ord\))i(and)e(the)h(extension)h(t)m(yp)s(e)e(\(v)-5
b(alue)29 b(of)f(the)g(XTENSION)f(k)m(eyw)m(ord:)40 b(IMA)m(GE,)29
b(ASCI)s(I)d(or)0 1120 y(T)-8 b(ABLE,)36 b(or)f(BINT)-8
b(ABLE\),)36 b(separated)f(b)m(y)g(commas)h(and)e(all)i(enclosed)g(in)f
(square)g(brac)m(k)m(ets.)56 b(If)34 b(the)h(v)-5 b(alue)0
1233 y(of)34 b(EXTVER)f(and)f(XTENSION)h(are)h(not)f(sp)s(eci\014ed,)h
(then)f(the)h(\014rst)e(extension)j(with)e(the)g(correct)i(v)-5
b(alue)34 b(of)0 1346 y(EXTNAME)39 b(is)g(op)s(ened.)67
b(The)38 b(extension)i(name)f(and)f(t)m(yp)s(e)i(are)f(not)h(case)g
(sensitiv)m(e,)j(and)38 b(the)h(extension)0 1458 y(t)m(yp)s(e)29
b(ma)m(y)g(b)s(e)f(abbreviated)h(to)g(a)g(single)g(letter)h(\(e.g.,)h
(I)d(=)g(IMA)m(GE)i(extension)f(or)f(primary)g(arra)m(y)-8
b(,)30 b(A)f(or)f(T)g(=)0 1571 y(ASCI)s(I)d(table)i(extension,)h(and)e
(B)h(=)f(binary)g(table)h(BINT)-8 b(ABLE)27 b(extension\).)41
b(If)26 b(the)g(HDU)h(lo)s(cation)i(sp)s(eci\014er)0
1684 y(is)h(equal)h(to)g(`[PRIMAR)-8 b(Y]')32 b(or)f(`[P]',)g(then)f
(the)h(primary)e(arra)m(y)i(\(the)g(\014rst)f(HDU\))h(will)g(b)s(e)f
(op)s(ened.)0 1844 y(An)36 b(optional)j(p)s(ound)34 b(sign)j(c)m
(haracter)i(\("#"\))f(ma)m(y)f(b)s(e)g(app)s(ended)e(to)i(the)g
(extension)h(name)f(or)g(n)m(um)m(b)s(er)e(to)0 1957
y(signify)e(that)h(an)m(y)g(other)f(extensions)h(in)f(the)g(\014le)g
(should)g(b)s(e)f(ignored)h(during)f(an)m(y)i(subsequen)m(t)e(\014le)i
(\014ltering)0 2070 y(op)s(erations.)83 b(F)-8 b(or)45
b(example,)k(when)43 b(doing)i(ro)m(w)f(\014ltering)h(op)s(erations)f
(on)h(a)f(table)i(extension,)i(CFITSIO)0 2183 y(normally)27
b(creates)i(a)e(cop)m(y)h(of)f(the)g(\014ltered)g(table)h(in)f(memory)
-8 b(,)28 b(along)h(with)d(a)i(v)m(erbatim)f(cop)m(y)h(of)f(all)h(the)g
(other)0 2296 y(extensions)h(in)g(the)g(input)f(FITS)g(\014le.)41
b(If)28 b(the)h(p)s(ound)e(sign)i(is)g(app)s(ended)e(to)j(the)f(table)h
(extension)g(name,)f(then)0 2409 y(only)34 b(that)g(extension,)i(and)d
(none)h(of)g(the)g(other)g(extensions)g(in)f(the)h(\014le,)h(will)g(b)m
(y)e(copied)h(to)h(memory)-8 b(,)35 b(as)f(in)0 2522
y(the)d(follo)m(wing)g(example:)143 2773 y Fe(myfile.fit[events#][TIME)
41 b(>)48 b(10000])0 3024 y Fj(FITS)34 b(images)i(are)f(most)h
(commonly)f(stored)g(in)g(the)g(primary)f(arra)m(y)h(or)g(an)g(image)h
(extension,)h(but)d(images)0 3137 y(can)d(also)h(b)s(e)e(stored)h(as)h
(a)f(v)m(ector)h(in)f(a)g(single)h(cell)g(of)f(a)h(binary)e(table)i
(\(i.e.)43 b(eac)m(h)32 b(ro)m(w)f(of)g(the)h(v)m(ector)g(column)0
3250 y(con)m(tains)d(a)g(di\013eren)m(t)f(image\).)42
b(Suc)m(h)27 b(an)h(image)i(can)e(b)s(e)g(op)s(ened)f(with)h(CFITSIO)e
(b)m(y)i(sp)s(ecifying)g(the)g(desired)0 3363 y(column)k(name)g(and)f
(the)h(ro)m(w)g(n)m(um)m(b)s(er)f(after)h(the)g(binary)f(table)i(HDU)g
(sp)s(eci\014er)e(as)h(sho)m(wn)g(in)f(the)h(follo)m(wing)0
3476 y(examples.)71 b(The)40 b(column)g(name)h(is)f(separated)h(from)f
(the)h(HDU)g(sp)s(eci\014er)f(b)m(y)g(a)h(semicolon)g(and)f(the)h(ro)m
(w)0 3589 y(n)m(um)m(b)s(er)29 b(is)h(enclosed)h(in)e(paren)m(theses.)
41 b(In)30 b(this)g(case)h(CFITSIO)d(copies)j(the)f(image)i(from)d(the)
i(table)g(cell)g(in)m(to)0 3702 y(a)h(temp)s(orary)e(primary)h(arra)m
(y)g(b)s(efore)g(it)h(is)f(op)s(ened.)43 b(The)30 b(application)j
(program)e(then)g(just)g(sees)g(the)h(image)0 3815 y(in)i(the)h
(primary)e(arra)m(y)-8 b(,)37 b(without)d(an)m(y)h(extensions.)53
b(The)34 b(particular)g(ro)m(w)h(to)g(b)s(e)e(op)s(ened)h(ma)m(y)h(b)s
(e)f(sp)s(eci\014ed)0 3927 y(either)28 b(b)m(y)f(giving)h(an)f
(absolute)h(in)m(teger)h(ro)m(w)f(n)m(um)m(b)s(er)e(\(starting)i(with)f
(1)h(for)f(the)g(\014rst)g(ro)m(w\),)i(or)e(b)m(y)g(sp)s(ecifying)0
4040 y(a)33 b(b)s(o)s(olean)f(expression)g(that)h(ev)-5
b(aluates)34 b(to)f(TR)m(UE)g(for)f(the)g(desired)g(ro)m(w.)47
b(The)32 b(\014rst)f(ro)m(w)i(that)g(satis\014es)g(the)0
4153 y(expression)28 b(will)g(b)s(e)g(used.)39 b(The)28
b(ro)m(w)g(selection)i(expression)e(has)g(the)g(same)g(syn)m(tax)h(as)f
(describ)s(ed)f(in)h(the)g(Ro)m(w)0 4266 y(Filter)k(Sp)s(eci\014er)d
(section,)j(b)s(elo)m(w.)0 4426 y(Examples:)143 4677
y Fe(myfile.fits[3])44 b(-)k(open)e(the)h(3rd)g(HDU)g(following)e(the)i
(primary)f(array)143 4790 y(myfile.fits+3)92 b(-)48 b(same)e(as)h
(above,)f(but)h(using)g(the)g(FTOOLS-style)d(notation)143
4903 y(myfile.fits[EVENTS])f(-)k(open)g(the)g(extension)e(that)i(has)g
(EXTNAME)e(=)j('EVENTS')143 5016 y(myfile.fits[EVENTS,)43
b(2])95 b(-)47 b(same)g(as)g(above,)f(but)h(also)g(requires)e(EXTVER)h
(=)i(2)143 5129 y(myfile.fits[events,2,b])42 b(-)47 b(same,)f(but)h
(also)g(requires)f(XTENSION)f(=)j('BINTABLE')143 5242
y(myfile.fits[3;)c(images\(17\)])h(-)i(opens)g(the)g(image)f(in)h(row)g
(17)g(of)g(the)g('images')1527 5355 y(column)f(in)i(the)e(3rd)h
(extension)f(of)h(the)g(file.)143 5468 y(myfile.fits[3;)d
(images\(exposure)g(>)j(100\)])g(-)g(as)g(above,)f(but)h(opens)g(the)f
(image)907 5581 y(in)h(the)g(first)f(row)h(that)g(has)g(an)g
('exposure')e(column)h(value)907 5694 y(greater)g(than)g(100.)p
eop end
%%Page: 130 138
TeXDict begin 130 137 bop 0 299 a Fj(130)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Ff(10.8)136 b(Image)46 b(Section)0 811 y Fj(A)41
b(virtual)g(\014le)f(con)m(taining)i(a)f(rectangular)h(subsection)e(of)
h(an)g(image)g(can)g(b)s(e)f(extracted)i(and)e(op)s(ened)g(b)m(y)0
924 y(sp)s(ecifying)32 b(the)h(range)g(of)g(pixels)g(\(start:end\))g
(along)h(eac)m(h)g(axis)f(to)g(b)s(e)f(extracted)i(from)e(the)h
(original)g(image.)0 1037 y(One)d(can)h(also)h(sp)s(ecify)e(an)h
(optional)h(pixel)f(incremen)m(t)g(\(start:end:step\))h(for)f(eac)m(h)h
(axis)f(of)g(the)g(input)e(image.)0 1149 y(A)f(pixel)f(step)h(=)f(1)h
(will)g(b)s(e)f(assumed)f(if)i(it)g(is)f(not)h(sp)s(eci\014ed.)39
b(If)27 b(the)h(start)g(pixel)g(is)f(larger)i(then)e(the)h(end)e
(pixel,)0 1262 y(then)32 b(the)g(image)h(will)f(b)s(e)f(\015ipp)s(ed)f
(\(pro)s(ducing)h(a)h(mirror)g(image\))h(along)g(that)f(dimension.)45
b(An)32 b(asterisk,)h('*',)0 1375 y(ma)m(y)39 b(b)s(e)e(used)h(to)h(sp)
s(ecify)f(the)g(en)m(tire)h(range)g(of)f(an)h(axis,)i(and)c('-*')j
(will)e(\015ip)g(the)g(en)m(tire)h(axis.)65 b(The)38
b(input)0 1488 y(image)31 b(can)f(b)s(e)f(in)g(the)h(primary)f(arra)m
(y)-8 b(,)31 b(in)e(an)g(image)i(extension,)g(or)f(con)m(tained)g(in)g
(a)g(v)m(ector)h(cell)g(of)f(a)g(binary)0 1601 y(table.)40
b(In)25 b(the)h(later)h(2)f(cases)h(the)f(extension)h(name)f(or)f(n)m
(um)m(b)s(er)g(m)m(ust)h(b)s(e)f(sp)s(eci\014ed)g(b)s(efore)h(the)g
(image)h(section)0 1714 y(sp)s(eci\014er.)0 1874 y(Examples:)95
2157 y Fe(myfile.fits[1:512:2,)43 b(2:512:2])i(-)95 b(open)47
b(a)h(256x256)d(pixel)i(image)668 2270 y(consisting)e(of)i(the)g(odd)g
(numbered)f(columns)g(\(1st)g(axis\))h(and)668 2383 y(the)g(even)g
(numbered)e(rows)i(\(2nd)g(axis\))f(of)h(the)g(image)f(in)i(the)668
2496 y(primary)e(array)g(of)i(the)e(file.)95 2721 y(myfile.fits[*,)e
(512:256])i(-)h(open)g(an)g(image)g(consisting)e(of)i(all)g(the)g
(columns)668 2834 y(in)g(the)g(input)g(image,)f(but)h(only)f(rows)h
(256)g(through)f(512.)668 2947 y(The)h(image)f(will)h(be)g(flipped)f
(along)g(the)h(2nd)g(axis)g(since)668 3060 y(the)g(starting)f(pixel)g
(is)h(greater)f(than)h(the)g(ending)f(pixel.)95 3286
y(myfile.fits[*:2,)e(512:256:2])h(-)i(same)g(as)g(above)f(but)h
(keeping)f(only)668 3399 y(every)h(other)f(row)h(and)g(column)f(in)h
(the)g(input)f(image.)95 3625 y(myfile.fits[-*,)e(*])j(-)h(copy)e(the)h
(entire)f(image,)g(flipping)g(it)h(along)668 3738 y(the)g(first)f
(axis.)95 3963 y(myfile.fits[3][1:256,1:256)o(])c(-)47
b(opens)g(a)g(subsection)e(of)i(the)g(image)g(that)668
4076 y(is)g(in)h(the)e(3rd)h(extension)f(of)h(the)g(file.)95
4302 y(myfile.fits[4;)d(images\(12\)][1:10,1:10])e(-)48
b(open)e(an)h(image)g(consisting)286 4415 y(of)h(the)e(first)h(10)g
(pixels)f(in)h(both)g(dimensions.)e(The)i(original)286
4528 y(image)g(resides)f(in)h(the)g(12th)f(row)h(of)g(the)g('images')f
(vector)286 4641 y(column)g(in)i(the)f(table)f(in)h(the)g(4th)g
(extension)e(of)i(the)g(file.)0 4924 y Fj(When)23 b(CFITSIO)f(op)s(ens)
h(an)g(image)h(section)h(it)f(\014rst)f(creates)h(a)g(temp)s(orary)f
(\014le)h(con)m(taining)h(the)e(image)i(section)0 5036
y(plus)30 b(a)h(cop)m(y)h(of)f(an)m(y)g(other)g(HDUs)g(in)g(the)g
(\014le.)42 b(\(If)31 b(a)g(`#')g(c)m(haracter)h(is)f(app)s(ended)e(to)
j(the)f(name)f(or)h(n)m(um)m(b)s(er)0 5149 y(of)i(the)g(image)i(HDU,)e
(as)h(in)e("m)m(y\014le.\014ts[1#][1:200,1:200)q(]",)40
b(then)33 b(the)g(other)g(HDUs)h(in)e(the)h(input)g(\014le)g(will)0
5262 y(not)j(b)s(e)f(copied)i(in)m(to)f(memory\).)58
b(This)35 b(temp)s(orary)g(\014le)h(is)g(then)f(op)s(ened)h(b)m(y)f
(the)h(application)h(program,)h(so)0 5375 y(it)32 b(is)g(not)f(p)s
(ossible)h(to)g(write)g(to)g(or)f(mo)s(dify)g(the)h(input)e(\014le)i
(when)f(sp)s(ecifying)g(an)g(image)i(section.)45 b(Note)33
b(that)0 5488 y(CFITSIO)27 b(automatically)32 b(up)s(dates)c(the)h(w)m
(orld)f(co)s(ordinate)i(system)f(k)m(eyw)m(ords)g(in)f(the)h(header)g
(of)g(the)g(image)0 5601 y(section,)h(if)f(they)g(exist,)h(so)f(that)g
(the)g(co)s(ordinate)h(asso)s(ciated)g(with)e(eac)m(h)i(pixel)f(in)g
(the)g(image)h(section)g(will)f(b)s(e)0 5714 y(computed)h(correctly)-8
b(.)p eop end
%%Page: 131 139
TeXDict begin 131 138 bop 0 299 a Fh(10.9.)73 b(IMA)m(GE)31
b(TRANSF)m(ORM)f(FIL)-8 b(TERS)2147 b Fj(131)0 555 y
Ff(10.9)136 b(Image)46 b(T)-11 b(ransform)44 b(Filters)0
807 y Fj(CFITSIO)33 b(can)h(apply)g(a)h(user-sp)s(eci\014ed)e
(mathematical)j(function)e(to)h(the)g(v)-5 b(alue)34
b(of)h(ev)m(ery)g(pixel)f(in)g(a)h(FITS)0 920 y(image,)29
b(th)m(us)e(creating)h(a)g(new)e(virtual)h(image)i(in)d(computer)h
(memory)g(that)h(is)f(then)f(op)s(ened)h(and)f(read)h(b)m(y)g(the)0
1033 y(application)32 b(program.)40 b(The)30 b(original)i(FITS)d(image)
j(is)e(not)h(mo)s(di\014ed)e(b)m(y)h(this)h(pro)s(cess.)0
1193 y(The)20 b(image)j(transformation)e(sp)s(eci\014er)f(is)h(app)s
(ended)e(to)j(the)f(input)f(FITS)h(\014le)g(name)g(and)f(is)h(enclosed)
h(in)e(square)0 1306 y(brac)m(k)m(ets.)42 b(It)29 b(b)s(egins)f(with)h
(the)g(letters)i('PIX')e(to)h(distinguish)e(it)i(from)e(other)i(t)m(yp)
s(es)f(of)g(FITS)f(\014le)h(\014lters)g(that)0 1419 y(are)36
b(recognized)i(b)m(y)e(CFITSIO.)e(The)i(image)h(transforming)f
(function)f(ma)m(y)i(use)f(an)m(y)g(of)g(the)h(mathematical)0
1532 y(op)s(erators)44 b(listed)h(in)f(the)h(follo)m(wing)h('Ro)m(w)f
(Filtering)g(Sp)s(eci\014cation')g(section)h(of)e(this)h(do)s(cumen)m
(t.)82 b(Some)0 1645 y(examples)31 b(of)f(image)i(transform)e
(\014lters)g(are:)48 1913 y Fe([pix)46 b(X)i(*)f(2.0])715
b(-)48 b(multiply)d(each)i(pixel)f(by)h(2.0)48 2026 y([pix)f
(sqrt\(X\)])714 b(-)48 b(take)e(the)h(square)f(root)h(of)g(each)g
(pixel)48 2139 y([pix)f(X)i(+)f(#ZEROPT)571 b(-)48 b(add)e(the)h(value)
g(of)g(the)g(ZEROPT)f(keyword)48 2252 y([pix)g(X>0)h(?)h(log10\(X\))d
(:)j(-99.])e(-)i(if)f(the)g(pixel)f(value)g(is)i(greater)1480
2365 y(than)e(0,)h(compute)f(the)h(base)g(10)g(log,)1480
2478 y(else)f(set)h(the)g(pixel)f(=)i(-99.)0 2746 y Fj(Use)24
b(the)g(letter)h('X')f(in)f(the)h(expression)g(to)g(represen)m(t)g(the)
g(curren)m(t)f(pixel)h(v)-5 b(alue)24 b(in)f(the)h(image.)40
b(The)23 b(expression)0 2859 y(is)38 b(ev)-5 b(aluated)39
b(indep)s(enden)m(tly)e(for)g(eac)m(h)i(pixel)f(in)g(the)g(image)h(and)
e(ma)m(y)h(b)s(e)g(a)g(function)f(of)h(1\))h(the)f(original)0
2971 y(pixel)32 b(v)-5 b(alue,)32 b(2\))g(the)f(v)-5
b(alue)32 b(of)f(other)h(pixels)f(in)g(the)g(image)i(at)f(a)f(giv)m(en)
i(relativ)m(e)g(o\013set)f(from)f(the)g(p)s(osition)h(of)0
3084 y(the)d(pixel)f(that)h(is)g(b)s(eing)f(ev)-5 b(aluated,)30
b(and)e(3\))h(the)g(v)-5 b(alue)29 b(of)f(an)m(y)h(header)f(k)m(eyw)m
(ords.)41 b(Header)29 b(k)m(eyw)m(ord)g(v)-5 b(alues)0
3197 y(are)31 b(represen)m(ted)f(b)m(y)g(the)h(name)f(of)h(the)f(k)m
(eyw)m(ord)h(preceded)f(b)m(y)h(the)f('#')h(sign.)0 3357
y(T)-8 b(o)35 b(access)h(the)f(the)g(v)-5 b(alue)35 b(of)g(adjacen)m(t)
h(pixels)f(in)f(the)h(image,)i(sp)s(ecify)e(the)g(\(1-D\))h(o\013set)g
(from)e(the)h(curren)m(t)0 3470 y(pixel)c(in)f(curly)g(brac)m(k)m(ets.)
42 b(F)-8 b(or)31 b(example)48 3738 y Fe([pix)94 b(\(x{-1})46
b(+)i(x)f(+)h(x{+1}\))e(/)h(3])0 4006 y Fj(will)25 b(replace)g(eac)m(h)
h(pixel)f(v)-5 b(alue)25 b(with)f(the)h(running)e(mean)i(of)f(the)h(v)
-5 b(alues)25 b(of)g(that)g(pixel)g(and)f(it's)h(2)g(neigh)m(b)s(oring)
0 4119 y(pixels.)40 b(Note)30 b(that)g(in)e(this)g(notation)i(the)f
(image)h(is)f(treated)g(as)g(a)g(1-D)h(arra)m(y)-8 b(,)30
b(where)e(eac)m(h)i(ro)m(w)f(of)g(the)g(image)0 4232
y(\(or)c(higher)f(dimensional)g(cub)s(e\))h(is)f(app)s(ended)f(one)h
(after)h(another)g(in)f(one)h(long)g(arra)m(y)g(of)f(pixels.)39
b(It)25 b(is)f(p)s(ossible)0 4345 y(to)35 b(refer)f(to)h(pixels)f(in)g
(the)g(ro)m(ws)g(ab)s(o)m(v)m(e)h(or)g(b)s(elo)m(w)f(the)g(curren)m(t)g
(pixel)h(b)m(y)f(using)f(the)h(v)-5 b(alue)35 b(of)f(the)h(NAXIS1)0
4458 y(header)30 b(k)m(eyw)m(ord.)41 b(F)-8 b(or)32 b(example)48
4726 y Fe([pix)46 b(\(x{-#NAXIS1})f(+)i(x)h(+)f(x{#NAXIS1}\))e(/)i(3])0
4994 y Fj(will)34 b(compute)f(the)h(mean)f(of)g(eac)m(h)i(image)f
(pixel)g(and)e(the)i(pixels)f(immediately)i(ab)s(o)m(v)m(e)f(and)f(b)s
(elo)m(w)g(it)h(in)f(the)0 5107 y(adjacen)m(t)27 b(ro)m(ws)f(of)g(the)f
(image.)41 b(The)25 b(follo)m(wing)i(more)f(complex)h(example)f
(creates)h(a)f(smo)s(othed)g(virtual)g(image)0 5220 y(where)k(eac)m(h)h
(pixel)g(is)g(a)f(3)h(x)f(3)h(b)s(o)m(xcar)g(a)m(v)m(erage)i(of)d(the)h
(input)e(image)j(pixels:)95 5488 y Fe([pix)47 b(\(X)g(+)h(X{-1})e(+)i
(X{+1})286 5601 y(+)g(X{-#NAXIS1})d(+)i(X{-#NAXIS1)e(-)i(1})h(+)f
(X{-#NAXIS1)e(+)j(1})286 5714 y(+)g(X{#NAXIS1})d(+)i(X{#NAXIS1)f(-)h
(1})g(+)h(X{#NAXIS1)d(+)i(1}\))g(/)h(9.])p eop end
%%Page: 132 140
TeXDict begin 132 139 bop 0 299 a Fj(132)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(If)31 b(the)h(pixel)g(o\013set)h(extends)f(b)s(ey)m(ond)f(the)
h(\014rst)f(or)h(last)h(pixel)f(in)f(the)h(image,)i(the)e(function)g
(will)g(ev)-5 b(aluate)33 b(to)0 668 y(unde\014ned,)28
b(or)j(NULL.)0 828 y(F)-8 b(or)39 b(complex)g(or)g(commonly)g(used)e
(image)j(\014ltering)f(op)s(erations,)i(one)d(can)h(write)g(the)f
(expression)h(in)m(to)g(an)0 941 y(external)i(text)h(\014le)f(and)f
(then)g(imp)s(ort)g(it)h(in)m(to)h(the)e(\014lter)h(using)f(the)h(syn)m
(tax)g('[pix)g(@\014lename.txt]'.)72 b(The)0 1054 y(mathematical)29
b(expression)e(can)g(extend)g(o)m(v)m(er)i(m)m(ultiple)e(lines)g(of)h
(text)g(in)e(the)h(\014le.)40 b(An)m(y)27 b(lines)g(in)g(the)g
(external)0 1167 y(text)h(\014le)e(that)i(b)s(egin)e(with)g(2)h(slash)f
(c)m(haracters)i(\('//'\))h(will)e(b)s(e)f(ignored)h(and)f(ma)m(y)h(b)s
(e)f(used)g(to)h(add)f(commen)m(ts)0 1280 y(in)m(to)31
b(the)g(\014le.)0 1440 y(By)c(default,)g(the)f(datat)m(yp)s(e)i(of)e
(the)g(resulting)h(image)g(will)g(b)s(e)e(the)i(same)f(as)h(the)f
(original)i(image,)g(but)e(one)g(ma)m(y)0 1553 y(force)31
b(a)g(di\013eren)m(t)g(datat)m(yp)s(e)g(b)m(y)f(app)s(ended)f(a)h(co)s
(de)h(letter)h(to)f(the)f('pix')h(k)m(eyw)m(ord:)286
1786 y Fe(pixb)95 b(-)g(8-bit)46 b(byte)190 b(image)46
b(with)h(BITPIX)f(=)143 b(8)286 1898 y(pixi)95 b(-)47
b(16-bit)f(integer)g(image)g(with)h(BITPIX)f(=)95 b(16)286
2011 y(pixj)g(-)47 b(32-bit)f(integer)g(image)g(with)h(BITPIX)f(=)95
b(32)286 2124 y(pixr)g(-)47 b(32-bit)f(float)142 b(image)46
b(with)h(BITPIX)f(=)i(-32)286 2237 y(pixd)95 b(-)47 b(64-bit)f(float)
142 b(image)46 b(with)h(BITPIX)f(=)i(-64)0 2470 y Fj(Also)23
b(b)m(y)f(default,)j(an)m(y)d(other)h(HDUs)g(in)f(the)g(input)g(\014le)
g(will)h(b)s(e)e(copied)i(without)g(c)m(hange)g(to)g(the)g(output)f
(virtual)0 2583 y(FITS)k(\014le,)h(but)f(one)g(ma)m(y)h(discard)f(the)h
(other)f(HDUs)h(b)m(y)f(adding)g(the)h(n)m(um)m(b)s(er)e('1')i(to)g
(the)g('pix')f(k)m(eyw)m(ord)h(\(and)0 2696 y(follo)m(wing)32
b(an)m(y)f(optional)g(datat)m(yp)s(e)g(co)s(de)g(letter\).)42
b(F)-8 b(or)32 b(example:)239 2928 y Fe(myfile.fits[3][pixr1)90
b(sqrt\(X\)])0 3161 y Fj(will)23 b(create)i(a)e(virtual)g(FITS)f
(\014le)h(con)m(taining)h(only)f(a)g(primary)f(arra)m(y)i(image)g(with)
e(32-bit)i(\015oating)g(p)s(oin)m(t)f(pixels)0 3274 y(that)29
b(ha)m(v)m(e)h(a)f(v)-5 b(alue)30 b(equal)f(to)g(the)g(square)g(ro)s
(ot)g(of)g(the)g(pixels)f(in)h(the)g(image)h(that)f(is)g(in)f(the)h
(3rd)f(extension)i(of)0 3387 y(the)h('m)m(y\014le.\014ts')g(\014le.)0
3716 y Ff(10.10)136 b(Column)45 b(and)g(Keyw)l(ord)g(Filtering)h(Sp)t
(eci\014cation)0 3966 y Fj(The)27 b(optional)i(column/k)m(eyw)m(ord)g
(\014ltering)f(sp)s(eci\014er)f(is)h(used)f(to)i(mo)s(dify)e(the)h
(column)g(structure)f(and/or)h(the)0 4079 y(header)38
b(k)m(eyw)m(ords)h(in)f(the)h(HDU)g(that)h(w)m(as)f(selected)h(with)e
(the)h(previous)f(HDU)h(lo)s(cation)h(sp)s(eci\014er.)65
b(This)0 4192 y(\014ltering)42 b(sp)s(eci\014er)f(m)m(ust)h(b)s(e)f
(enclosed)i(in)e(square)h(brac)m(k)m(ets)h(and)e(can)h(b)s(e)f
(distinguished)g(from)h(a)g(general)0 4305 y(ro)m(w)d(\014lter)g(sp)s
(eci\014er)f(\(describ)s(ed)g(b)s(elo)m(w\))h(b)m(y)g(the)g(fact)h
(that)f(it)g(b)s(egins)f(with)h(the)g(string)g('col)h(')f(and)f(is)h
(not)0 4418 y(immediately)30 b(follo)m(w)m(ed)g(b)m(y)e(an)g(equals)h
(sign.)40 b(The)28 b(original)h(\014le)f(is)h(not)f(c)m(hanged)h(b)m(y)
f(this)h(\014ltering)f(op)s(eration,)0 4531 y(and)c(instead)h(the)g(mo)
s(di\014cations)g(are)g(made)g(on)f(a)h(cop)m(y)h(of)e(the)h(input)f
(FITS)g(\014le)h(\(usually)g(in)f(memory\),)i(whic)m(h)0
4644 y(also)31 b(con)m(tains)g(a)g(cop)m(y)g(of)f(all)h(the)f(other)g
(HDUs)h(in)f(the)g(\014le.)41 b(\(If)30 b(a)g(`#')h(c)m(haracter)g(is)f
(app)s(ended)f(to)i(the)f(name)0 4757 y(or)d(n)m(um)m(b)s(er)e(of)i
(the)g(table)g(HDU)h(then)e(only)h(the)g(primary)f(arra)m(y)-8
b(,)28 b(and)e(none)h(of)g(the)f(other)h(HDUs)h(in)e(the)h(input)0
4869 y(\014le)i(will)f(b)s(e)g(copied)h(in)m(to)g(memory\).)41
b(This)27 b(temp)s(orary)h(\014le)h(is)f(passed)g(to)h(the)g
(application)h(program)e(and)g(will)0 4982 y(p)s(ersist)e(only)i(un)m
(til)f(the)g(\014le)g(is)h(closed)f(or)g(un)m(til)h(the)f(program)g
(exits,)i(unless)d(the)h(out\014le)h(sp)s(eci\014er)e(\(see)i(ab)s(o)m
(v)m(e\))0 5095 y(is)i(also)i(supplied.)0 5255 y(The)f(column/k)m(eyw)m
(ord)h(\014lter)f(can)g(b)s(e)g(used)f(to)i(p)s(erform)e(the)i(follo)m
(wing)g(op)s(erations.)44 b(More)32 b(than)f(one)g(op)s(er-)0
5368 y(ation)g(ma)m(y)g(b)s(e)f(sp)s(eci\014ed)g(b)m(y)g(separating)h
(them)f(with)h(commas)f(or)h(semi-colons.)136 5601 y
Fc(\017)46 b Fj(Cop)m(y)36 b(only)g(a)g(sp)s(eci\014ed)g(list)g(of)g
(columns)g(columns)f(to)i(the)f(\014ltered)g(input)f(\014le.)57
b(The)36 b(list)g(of)g(column)227 5714 y(name)c(should)f(b)s(e)h
(separated)g(b)m(y)g(semi-colons.)48 b(Wild)32 b(card)g(c)m(haracters)i
(ma)m(y)e(b)s(e)g(used)f(in)h(the)g(column)p eop end
%%Page: 133 141
TeXDict begin 133 140 bop 0 299 a Fh(10.10.)73 b(COLUMN)30
b(AND)h(KEYW)m(ORD)g(FIL)-8 b(TERING)31 b(SPECIFICA)-8
b(TION)984 b Fj(133)227 555 y(names)37 b(to)h(matc)m(h)g(m)m(ultiple)g
(columns.)61 b(If)37 b(the)g(expression)g(con)m(tains)i(b)s(oth)d(a)i
(list)f(of)h(columns)f(to)h(b)s(e)227 668 y(included)h(and)f(columns)h
(to)g(b)s(e)g(deleted,)j(then)c(all)i(the)f(columns)g(in)g(the)g
(original)h(table)g(except)g(the)227 781 y(explicitly)32
b(deleted)f(columns)f(will)g(app)s(ear)g(in)g(the)g(\014ltered)g(table)
h(\(i.e.,)h(there)e(is)h(no)f(need)f(to)i(explicitly)227
894 y(list)g(the)g(columns)f(to)h(b)s(e)f(included)f(if)i(an)m(y)f
(columns)g(are)h(b)s(eing)f(deleted\).)136 1102 y Fc(\017)46
b Fj(Delete)32 b(a)d(column)g(or)g(k)m(eyw)m(ord)h(b)m(y)f(listing)h
(the)f(name)g(preceded)g(b)m(y)g(a)g(min)m(us)g(sign)g(or)g(an)g
(exclamation)227 1215 y(mark)c(\(!\),)h(e.g.,)i('-TIME')d(will)g
(delete)h(the)e(TIME)h(column)f(if)g(it)i(exists,)g(otherwise)f(the)g
(TIME)f(k)m(eyw)m(ord.)227 1328 y(An)35 b(error)f(is)h(returned)e(if)i
(neither)f(a)i(column)e(nor)g(k)m(eyw)m(ord)h(with)g(this)f(name)h
(exists.)54 b(Note)36 b(that)g(the)227 1441 y(exclamation)27
b(p)s(oin)m(t,)g(')10 b(!',)27 b(is)e(a)g(sp)s(ecial)h(UNIX)f(c)m
(haracter,)j(so)d(if)g(it)h(is)f(used)f(on)h(the)g(command)g(line)g
(rather)227 1554 y(than)33 b(en)m(tered)h(at)g(a)g(task)g(prompt,)f(it)
h(m)m(ust)f(b)s(e)g(preceded)g(b)m(y)g(a)h(bac)m(kslash)g(to)g(force)g
(the)f(UNIX)h(shell)227 1666 y(to)d(ignore)g(it.)136
1874 y Fc(\017)46 b Fj(Rename)29 b(an)g(existing)g(column)f(or)h(k)m
(eyw)m(ord)g(with)f(the)h(syn)m(tax)g('NewName)h(==)e(OldName'.)40
b(An)28 b(error)227 1987 y(is)j(returned)e(if)h(neither)h(a)f(column)g
(nor)g(k)m(eyw)m(ord)h(with)f(this)h(name)f(exists.)136
2195 y Fc(\017)46 b Fj(App)s(end)37 b(a)j(new)f(column)f(or)i(k)m(eyw)m
(ord)f(to)h(the)f(table.)68 b(T)-8 b(o)40 b(create)g(a)g(column,)h(giv)
m(e)g(the)e(new)g(name,)227 2308 y(optionally)c(follo)m(w)m(ed)f(b)m(y)
f(the)g(data)h(t)m(yp)s(e)f(in)f(paren)m(theses,)i(follo)m(w)m(ed)h(b)m
(y)e(a)g(single)h(equals)f(sign)g(and)f(an)227 2421 y(expression)j(to)h
(b)s(e)e(used)g(to)i(compute)f(the)g(v)-5 b(alue)35 b(\(e.g.,)j('new)m
(col\(1J\))f(=)e(0')g(will)h(create)g(a)f(new)g(32-bit)227
2534 y(in)m(teger)i(column)d(called)j('new)m(col')f(\014lled)f(with)g
(zeros\).)55 b(The)35 b(data)g(t)m(yp)s(e)h(is)f(sp)s(eci\014ed)f
(using)g(the)i(same)227 2647 y(syn)m(tax)j(that)g(is)f(allo)m(w)m(ed)i
(for)e(the)g(v)-5 b(alue)39 b(of)f(the)g(FITS)f(TF)m(ORMn)h(k)m(eyw)m
(ord)h(\(e.g.,)j('I',)d('J',)f('E',)h('D',)227 2760 y(etc.)66
b(for)38 b(binary)f(tables,)42 b(and)37 b('I8',)k(F12.3',)i('E20.12',)g
(etc.)65 b(for)38 b(ASCI)s(I)f(tables\).)66 b(If)37 b(the)i(data)g(t)m
(yp)s(e)227 2873 y(is)c(not)g(sp)s(eci\014ed)f(then)g(an)g(appropriate)
h(data)g(t)m(yp)s(e)g(will)g(b)s(e)f(c)m(hosen)h(dep)s(ending)e(on)h
(the)h(form)f(of)h(the)227 2986 y(expression)44 b(\(ma)m(y)g(b)s(e)f(a)
h(c)m(haracter)i(string,)h(logical,)j(bit,)d(long)d(in)m(teger,)49
b(or)43 b(double)h(column\).)80 b(An)227 3099 y(appropriate)39
b(v)m(ector)i(coun)m(t)e(\(in)g(the)g(case)h(of)f(binary)f(tables\))i
(will)f(also)h(b)s(e)e(added)g(if)h(not)g(explicitly)227
3212 y(sp)s(eci\014ed.)227 3372 y(When)26 b(creating)h(a)f(new)f(k)m
(eyw)m(ord,)j(the)e(k)m(eyw)m(ord)g(name)g(m)m(ust)g(b)s(e)f(preceded)g
(b)m(y)h(a)g(p)s(ound)e(sign)h('#',)j(and)227 3485 y(the)h(expression)f
(m)m(ust)g(ev)-5 b(aluate)30 b(to)f(a)g(scalar)g(\(i.e.,)h(cannot)f(ha)
m(v)m(e)h(a)f(column)f(name)g(in)g(the)h(expression\).)227
3598 y(The)j(commen)m(t)i(string)f(for)f(the)h(k)m(eyw)m(ord)h(ma)m(y)f
(b)s(e)f(sp)s(eci\014ed)g(in)g(paren)m(theses)h(immediately)h(follo)m
(wing)227 3711 y(the)27 b(k)m(eyw)m(ord)g(name)f(\(instead)h(of)g
(supplying)e(a)i(data)g(t)m(yp)s(e)g(as)f(in)g(the)h(case)g(of)g
(creating)h(a)f(new)f(column\).)227 3824 y(If)e(the)h(k)m(eyw)m(ord)g
(name)f(ends)g(with)g(a)h(p)s(ound)d(sign)i('#',)i(then)e(c\014tsio)i
(will)e(substitute)h(the)f(n)m(um)m(b)s(er)f(of)i(the)227
3937 y(most)31 b(recen)m(tly)h(referenced)e(column)h(for)f(the)h(#)f(c)
m(haracter)i(.)41 b(This)29 b(is)i(esp)s(ecially)h(useful)d(when)h
(writing)227 4049 y(a)c(column-related)g(k)m(eyw)m(ord)g(lik)m(e)g
(TUNITn)e(for)h(a)h(newly)f(created)h(column,)g(as)g(sho)m(wn)e(in)h
(the)g(follo)m(wing)227 4162 y(examples.)136 4370 y Fc(\017)46
b Fj(Recompute)f(\(o)m(v)m(erwrite\))i(the)d(v)-5 b(alues)44
b(in)g(an)g(existing)i(column)e(or)g(k)m(eyw)m(ord)g(b)m(y)g(giving)i
(the)e(name)227 4483 y(follo)m(w)m(ed)32 b(b)m(y)f(an)f(equals)h(sign)f
(and)g(an)g(arithmetic)i(expression.)0 4763 y(The)23
b(expression)g(that)i(is)e(used)g(when)g(app)s(ending)f(or)h
(recomputing)h(columns)f(or)h(k)m(eyw)m(ords)g(can)g(b)s(e)f
(arbitrarily)0 4876 y(complex)36 b(and)g(ma)m(y)g(b)s(e)f(a)h(function)
g(of)g(other)g(header)g(k)m(eyw)m(ord)g(v)-5 b(alues)36
b(and)f(other)h(columns)g(\(in)g(the)g(same)0 4989 y(ro)m(w\).)63
b(The)37 b(full)g(syn)m(tax)i(and)e(a)m(v)-5 b(ailable)40
b(functions)d(for)g(the)h(expression)f(are)h(describ)s(ed)f(b)s(elo)m
(w)h(in)f(the)h(ro)m(w)0 5102 y(\014lter)30 b(sp)s(eci\014cation)i
(section.)0 5262 y(If)27 b(the)h(expression)g(con)m(tains)g(b)s(oth)f
(a)h(list)h(of)f(columns)f(to)h(b)s(e)g(included)e(and)i(columns)f(to)h
(b)s(e)f(deleted,)j(then)d(all)0 5375 y(the)34 b(columns)g(in)g(the)g
(original)h(table)g(except)g(the)f(explicitly)i(deleted)f(columns)e
(will)i(app)s(ear)e(in)h(the)g(\014ltered)0 5488 y(table.)40
b(If)26 b(no)g(columns)f(to)i(b)s(e)f(deleted)g(are)h(sp)s(eci\014ed,)f
(then)g(only)g(the)h(columns)e(that)i(are)f(explicitly)i(listed)f(will)
0 5601 y(b)s(e)k(included)g(in)g(the)h(\014ltered)f(output)h(table.)45
b(T)-8 b(o)32 b(include)f(all)i(the)e(columns,)h(add)f(the)h('*')g
(wildcard)g(sp)s(eci\014er)0 5714 y(at)f(the)g(end)e(of)i(the)f(list,)i
(as)e(sho)m(wn)g(in)g(the)h(examples.)p eop end
%%Page: 134 142
TeXDict begin 134 141 bop 0 299 a Fj(134)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(F)g(or)33 b(complex)f(or)g(commonly)h(used)e(op)s(erations,)i
(one)f(can)h(place)g(the)f(op)s(erations)g(in)m(to)h(an)f(external)h
(text)g(\014le)0 668 y(and)39 b(imp)s(ort)h(it)g(in)m(to)h(the)f
(column)g(\014lter)g(using)f(the)h(syn)m(tax)h('[col)g
(@\014lename.txt]'.)71 b(The)39 b(op)s(erations)i(can)0
781 y(extend)26 b(o)m(v)m(er)i(m)m(ultiple)f(lines)g(of)f(the)h
(\014le,)h(but)d(m)m(ultiple)i(op)s(erations)g(m)m(ust)f(still)i(b)s(e)
d(separated)i(b)m(y)g(semicolons.)0 894 y(An)m(y)h(lines)h(in)f(the)g
(external)i(text)f(\014le)f(that)h(b)s(egin)f(with)g(2)h(slash)f(c)m
(haracters)i(\('//'\))g(will)f(b)s(e)e(ignored)i(and)e(ma)m(y)0
1007 y(b)s(e)j(used)f(to)i(add)f(commen)m(ts)h(in)m(to)h(the)e(\014le.)
0 1167 y(Examples:)143 1407 y Fe([col)47 b(Time;)f(rate])667
b(-)47 b(only)g(the)g(Time)g(and)g(rate)f(columns)g(will)1670
1520 y(appear)h(in)g(the)g(filtered)e(input)i(file.)143
1746 y([col)g(Time,)f(*raw])667 b(-)47 b(include)f(the)h(Time)g(column)
f(and)h(any)g(other)1670 1859 y(columns)f(whose)h(name)f(ends)h(with)g
('raw'.)143 2085 y([col)g(-TIME;)f(Good)h(==)g(STATUS])141
b(-)47 b(deletes)f(the)h(TIME)g(column)f(and)1670 2197
y(renames)g(the)h(status)f(column)g(to)i('Good')143 2423
y([col)f(PI=PHA)f(*)h(1.1)g(+)h(0.2;)e(#TUNIT#\(column)e(units\))i(=)i
('counts';*])1575 2536 y(-)f(creates)f(new)h(PI)g(column)f(from)h(PHA)g
(values)1670 2649 y(and)g(also)g(writes)f(the)h(TUNITn)f(keyword)1670
2762 y(for)h(the)g(new)g(column.)94 b(The)47 b(final)f('*')1670
2875 y(expression)f(means)i(preserve)e(all)i(the)1670
2988 y(columns)f(in)h(the)g(input)g(table)f(in)h(the)1670
3101 y(virtual)f(output)g(table;)94 b(without)46 b(the)h('*')1670
3214 y(the)g(output)f(table)h(would)f(only)h(contain)1670
3327 y(the)g(single)f('PI')h(column.)143 3552 y([col)g(rate)f(=)i
(rate/exposure;)c(TUNIT#\(&\))h(=)j('counts/s';*])1575
3665 y(-)f(recomputes)e(the)i(rate)g(column)f(by)h(dividing)1670
3778 y(it)h(by)f(the)g(EXPOSURE)e(keyword)h(value.)g(This)1670
3891 y(also)h(modifies)f(the)h(value)f(of)h(the)g(TUNITn)1670
4004 y(keyword)f(for)h(this)g(column.)f(The)h(use)f(of)i(the)1670
4117 y('&')f(character)f(for)h(the)f(keyword)g(comment)1670
4230 y(string)h(means)f(preserve)f(the)i(existing)1670
4343 y(comment)f(string)g(for)h(that)g(keyword.)e(The)1670
4456 y(final)i('*')g(preserves)e(all)i(the)g(columns)1670
4569 y(in)h(the)f(input)f(table)g(in)h(the)g(virtual)1670
4681 y(output)g(table.)0 5012 y Ff(10.11)136 b(Ro)l(w)46
b(Filtering)g(Sp)t(eci\014cation)0 5262 y Fj(When)29
b(en)m(tering)h(the)f(name)g(of)g(a)g(FITS)f(table)i(that)g(is)e(to)i
(b)s(e)e(op)s(ened)h(b)m(y)f(a)i(program,)f(an)g(optional)h(ro)m(w)f
(\014lter)0 5375 y(ma)m(y)i(b)s(e)g(sp)s(eci\014ed)f(to)h(select)h(a)g
(subset)e(of)h(the)g(ro)m(ws)f(in)h(the)g(table.)43 b(A)31
b(temp)s(orary)f(new)g(FITS)g(\014le)h(is)g(created)0
5488 y(on)40 b(the)f(\015y)g(whic)m(h)h(con)m(tains)h(only)e(those)h
(ro)m(ws)g(for)f(whic)m(h)h(the)g(ro)m(w)f(\014lter)h(expression)f(ev)
-5 b(aluates)42 b(to)e(true.)0 5601 y(The)29 b(primary)f(arra)m(y)i
(and)f(an)m(y)g(other)h(extensions)g(in)f(the)g(input)g(\014le)g(are)h
(also)g(copied)g(to)g(the)g(temp)s(orary)f(\014le.)0
5714 y(\(If)35 b(a)h(`#')f(c)m(haracter)i(is)e(app)s(ended)e(to)j(the)g
(name)f(or)g(n)m(um)m(b)s(er)f(of)h(the)g(table)h(HDU)g(then)f(only)g
(the)h(primary)p eop end
%%Page: 135 143
TeXDict begin 135 142 bop 0 299 a Fh(10.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)31 b(SPECIFICA)-8 b(TION)1936 b Fj(135)0
555 y(arra)m(y)-8 b(,)37 b(and)d(none)h(of)g(the)g(other)g(HDUs)h(in)e
(the)i(input)e(\014le)g(will)i(b)s(e)e(copied)h(in)m(to)h(the)f(temp)s
(orary)g(\014le\).)54 b(The)0 668 y(original)30 b(FITS)f(\014le)g(is)g
(closed)h(and)e(the)i(new)e(virtual)i(\014le)f(is)g(op)s(ened)f(b)m(y)h
(the)h(application)g(program.)40 b(The)29 b(ro)m(w)0
781 y(\014lter)37 b(expression)g(is)h(enclosed)g(in)f(square)g(brac)m
(k)m(ets)i(follo)m(wing)g(the)e(\014le)h(name)f(and)g(extension)h(name)
f(\(e.g.,)0 894 y('\014le.\014ts[ev)m(en)m(ts][GRADE==50]')29
b(selects)d(only)f(those)h(ro)m(ws)f(where)f(the)h(GRADE)h(column)f(v)
-5 b(alue)25 b(equals)g(50\).)0 1007 y(When)33 b(dealing)h(with)f
(tables)g(where)g(eac)m(h)h(ro)m(w)f(has)g(an)g(asso)s(ciated)i(time)f
(and/or)f(2D)g(spatial)i(p)s(osition,)f(the)0 1120 y(ro)m(w)e(\014lter)
h(expression)e(can)i(also)g(b)s(e)f(used)f(to)i(select)h(ro)m(ws)e
(based)g(on)g(the)g(times)h(in)f(a)g(Go)s(o)s(d)g(Time)g(In)m(terv)-5
b(als)0 1233 y(\(GTI\))31 b(extension,)g(or)f(on)h(spatial)g(p)s
(osition)g(as)f(giv)m(en)i(in)e(a)g(SA)m(O-st)m(yle)i(region)f(\014le.)
0 1558 y Fd(10.11.1)113 b(General)38 b(Syn)m(tax)0 1784
y Fj(The)32 b(ro)m(w)h(\014ltering)g(expression)g(can)g(b)s(e)f(an)h
(arbitrarily)g(complex)g(series)g(of)g(op)s(erations)g(p)s(erformed)f
(on)g(con-)0 1897 y(stan)m(ts,)39 b(k)m(eyw)m(ord)e(v)-5
b(alues,)38 b(and)e(column)g(data)i(tak)m(en)f(from)f(the)h(sp)s
(eci\014ed)e(FITS)h(T)-8 b(ABLE)37 b(extension.)59 b(The)0
2010 y(expression)37 b(m)m(ust)h(ev)-5 b(aluate)39 b(to)g(a)f(b)s(o)s
(olean)g(v)-5 b(alue)38 b(for)f(eac)m(h)i(ro)m(w)f(of)g(the)f(table,)k
(where)c(a)h(v)-5 b(alue)39 b(of)e(F)-10 b(ALSE)0 2123
y(means)30 b(that)h(the)g(ro)m(w)f(will)h(b)s(e)f(excluded.)0
2283 y(F)-8 b(or)34 b(complex)g(or)g(commonly)f(used)g(\014lters,)h
(one)g(can)g(place)g(the)g(expression)f(in)m(to)h(a)g(text)g(\014le)g
(and)f(imp)s(ort)f(it)0 2396 y(in)m(to)38 b(the)e(ro)m(w)h(\014lter)g
(using)f(the)h(syn)m(tax)g('[@\014lename.txt]'.)61 b(The)36
b(expression)h(can)f(b)s(e)g(arbitrarily)h(complex)0
2509 y(and)27 b(extend)i(o)m(v)m(er)g(m)m(ultiple)g(lines)f(of)g(the)h
(\014le.)40 b(An)m(y)28 b(lines)g(in)g(the)g(external)h(text)g(\014le)f
(that)h(b)s(egin)f(with)g(2)g(slash)0 2622 y(c)m(haracters)k(\('//'\))g
(will)f(b)s(e)f(ignored)g(and)g(ma)m(y)h(b)s(e)f(used)f(to)i(add)f
(commen)m(ts)h(in)m(to)h(the)e(\014le.)0 2782 y(Keyw)m(ord)37
b(and)f(column)g(data)i(are)f(referenced)g(b)m(y)g(name.)60
b(An)m(y)37 b(string)f(of)h(c)m(haracters)i(not)e(surrounded)d(b)m(y)0
2895 y(quotes)41 b(\(ie,)j(a)d(constan)m(t)h(string\))f(or)f(follo)m(w)
m(ed)i(b)m(y)f(an)f(op)s(en)g(paren)m(theses)h(\(ie,)j(a)d(function)f
(name\))h(will)g(b)s(e)0 3008 y(initially)d(in)m(terpreted)e(as)h(a)g
(column)f(name)g(and)g(its)h(con)m(ten)m(ts)h(for)e(the)h(curren)m(t)f
(ro)m(w)g(inserted)g(in)m(to)i(the)e(ex-)0 3121 y(pression.)k(If)28
b(no)h(suc)m(h)g(column)g(exists,)h(a)g(k)m(eyw)m(ord)f(of)h(that)f
(name)g(will)h(b)s(e)e(searc)m(hed)i(for)f(and)f(its)i(v)-5
b(alue)29 b(used,)0 3234 y(if)36 b(found.)55 b(T)-8 b(o)36
b(force)g(the)g(name)g(to)h(b)s(e)e(in)m(terpreted)h(as)g(a)g(k)m(eyw)m
(ord)g(\(in)g(case)g(there)g(is)g(b)s(oth)f(a)h(column)g(and)0
3347 y(k)m(eyw)m(ord)41 b(with)e(the)i(same)f(name\),)j(precede)d(the)h
(k)m(eyw)m(ord)f(name)g(with)g(a)h(single)f(p)s(ound)e(sign,)43
b('#',)g(as)d(in)0 3460 y('#NAXIS2'.)g(Due)27 b(to)g(the)f
(generalities)j(of)d(FITS)g(column)g(and)g(k)m(eyw)m(ord)h(names,)g(if)
f(the)h(column)f(or)g(k)m(eyw)m(ord)0 3572 y(name)33
b(con)m(tains)h(a)f(space)h(or)f(a)g(c)m(haracter)h(whic)m(h)f(migh)m
(t)h(app)s(ear)e(as)h(an)g(arithmetic)h(term)f(then)g(enclose)h(the)0
3685 y(name)c(in)g('$')i(c)m(haracters)g(as)e(in)g($MAX)i(PHA$)f(or)f
(#$MAX-PHA$.)43 b(Names)31 b(are)f(case)i(insensitiv)m(e.)0
3846 y(T)-8 b(o)32 b(access)g(a)g(table)g(en)m(try)g(in)f(a)h(ro)m(w)f
(other)h(than)f(the)g(curren)m(t)g(one,)h(follo)m(w)h(the)e(column's)h
(name)f(with)g(a)h(ro)m(w)0 3958 y(o\013set)37 b(within)e(curly)g
(braces.)57 b(F)-8 b(or)36 b(example,)i('PHA)p Fc(f)p
Fj(-3)p Fc(g)p Fj(')g(will)e(ev)-5 b(aluate)38 b(to)e(the)g(v)-5
b(alue)36 b(of)g(column)f(PHA,)i(3)0 4071 y(ro)m(ws)28
b(ab)s(o)m(v)m(e)i(the)e(ro)m(w)h(curren)m(tly)f(b)s(eing)g(pro)s
(cessed.)40 b(One)28 b(cannot)h(sp)s(ecify)f(an)g(absolute)h(ro)m(w)f
(n)m(um)m(b)s(er,)g(only)h(a)0 4184 y(relativ)m(e)j(o\013set.)42
b(Ro)m(ws)31 b(that)g(fall)g(outside)g(the)f(table)h(will)g(b)s(e)f
(treated)h(as)g(unde\014ned,)d(or)j(NULLs.)0 4344 y(Bo)s(olean)h(op)s
(erators)f(can)g(b)s(e)f(used)f(in)i(the)f(expression)h(in)f(either)h
(their)g(F)-8 b(ortran)31 b(or)f(C)h(forms.)40 b(The)30
b(follo)m(wing)0 4457 y(b)s(o)s(olean)g(op)s(erators)h(are)g(a)m(v)-5
b(ailable:)191 4747 y Fe("equal")428 b(.eq.)46 b(.EQ.)h(==)95
b("not)46 b(equal")476 b(.ne.)94 b(.NE.)h(!=)191 4860
y("less)46 b(than")238 b(.lt.)46 b(.LT.)h(<)143 b("less)46
b(than/equal")188 b(.le.)94 b(.LE.)h(<=)47 b(=<)191 4973
y("greater)e(than")95 b(.gt.)46 b(.GT.)h(>)143 b("greater)45
b(than/equal")g(.ge.)94 b(.GE.)h(>=)47 b(=>)191 5086
y("or")572 b(.or.)46 b(.OR.)h(||)95 b("and")762 b(.and.)46
b(.AND.)h(&&)191 5199 y("negation")236 b(.not.)46 b(.NOT.)h(!)95
b("approx.)45 b(equal\(1e-7\)")92 b(~)0 5488 y Fj(Note)32
b(that)g(the)f(exclamation)i(p)s(oin)m(t,)e(')10 b(!',)33
b(is)e(a)g(sp)s(ecial)g(UNIX)h(c)m(haracter,)h(so)e(if)g(it)g(is)g
(used)f(on)h(the)g(command)0 5601 y(line)i(rather)f(than)h(en)m(tered)g
(at)g(a)g(task)g(prompt,)g(it)g(m)m(ust)f(b)s(e)g(preceded)h(b)m(y)f(a)
h(bac)m(kslash)g(to)h(force)f(the)g(UNIX)0 5714 y(shell)e(to)g(ignore)g
(it.)p eop end
%%Page: 136 144
TeXDict begin 136 143 bop 0 299 a Fj(136)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(The)32 b(expression)g(ma)m(y)i(also)f(include)f(arithmetic)i
(op)s(erators)f(and)f(functions.)47 b(T)-8 b(rigonometric)34
b(functions)e(use)0 668 y(radians,)23 b(not)g(degrees.)38
b(The)22 b(follo)m(wing)h(arithmetic)g(op)s(erators)g(and)e(functions)g
(can)i(b)s(e)e(used)g(in)h(the)g(expression)0 781 y(\(function)38
b(names)f(are)h(case)g(insensitiv)m(e\).)64 b(A)37 b(n)m(ull)h(v)-5
b(alue)38 b(will)f(b)s(e)g(returned)g(in)g(case)h(of)g(illegal)i(op)s
(erations)0 894 y(suc)m(h)30 b(as)h(divide)f(b)m(y)g(zero,)i
(sqrt\(negativ)m(e\))h(log\(negativ)m(e\),)h(log10\(negativ)m(e\),)i
(arccos\(.gt.)43 b(1\),)32 b(arcsin\(.gt.)42 b(1\).)191
1144 y Fe("addition")474 b(+)j("subtraction")d(-)191
1257 y("multiplication")186 b(*)477 b("division")618
b(/)191 1370 y("negation")474 b(-)j("exponentiation")330
b(**)143 b(^)191 1483 y("absolute)45 b(value")189 b(abs\(x\))237
b("cosine")762 b(cos\(x\))191 1596 y("sine")666 b(sin\(x\))237
b("tangent")714 b(tan\(x\))191 1709 y("arc)47 b(cosine")379
b(arccos\(x\))93 b("arc)47 b(sine")667 b(arcsin\(x\))191
1822 y("arc)47 b(tangent")331 b(arctan\(x\))93 b("arc)47
b(tangent")523 b(arctan2\(y,x\))191 1935 y("hyperbolic)45
b(cos")189 b(cosh\(x\))g("hyperbolic)45 b(sin")381 b(sinh\(x\))191
2047 y("hyperbolic)45 b(tan")189 b(tanh\(x\))g("round)47
b(to)g(nearest)f(int")94 b(round\(x\))191 2160 y("round)46
b(down)h(to)g(int")f(floor\(x\))141 b("round)47 b(up)g(to)g(int")333
b(ceil\(x\))191 2273 y("exponential")d(exp\(x\))237 b("square)46
b(root")524 b(sqrt\(x\))191 2386 y("natural)45 b(log")333
b(log\(x\))237 b("common)46 b(log")572 b(log10\(x\))191
2499 y("modulus")522 b(x)48 b(\045)f(y)286 b("random)46
b(#)i([0.0,1.0\)")188 b(random\(\))191 2612 y("random)46
b(Gaussian")140 b(randomn\(\))93 b("random)46 b(Poisson")380
b(randomp\(x\))191 2725 y("minimum")522 b(min\(x,y\))141
b("maximum")714 b(max\(x,y\))191 2838 y("cumulative)45
b(sum")189 b(accum\(x\))141 b("sequential)45 b(difference")g
(seqdiff\(x\))191 2951 y("if-then-else")282 b(b?x:y)191
3064 y("angular)45 b(separation")93 b(angsep\(ra1,dec1,ra2,de2\))41
b(\(all)47 b(in)g(degrees\))191 3177 y("substring")283
b(strmid\(s,p,n\))44 b("string)i(search")428 b(strstr\(s,r\))0
3427 y Fj(Three)30 b(di\013eren)m(t)h(random)f(n)m(um)m(b)s(er)f
(functions)h(are)h(pro)m(vided:)41 b(random\(\),)30 b(with)h(no)f
(argumen)m(ts,)h(pro)s(duces)f(a)0 3540 y(uniform)g(random)f(deviate)k
(b)s(et)m(w)m(een)e(0)g(and)f(1;)i(randomn\(\),)e(also)i(with)e(no)h
(argumen)m(ts,)g(pro)s(duces)f(a)h(normal)0 3653 y(\(Gaussian\))k
(random)e(deviate)j(with)e(zero)h(mean)f(and)g(unit)f(standard)h
(deviation;)j(randomp\(x\))d(pro)s(duces)f(a)0 3766 y(P)m(oisson)27
b(random)f(deviate)h(whose)f(exp)s(ected)h(n)m(um)m(b)s(er)e(of)h(coun)
m(ts)h(is)g(X.)f(X)h(ma)m(y)g(b)s(e)e(an)m(y)i(p)s(ositiv)m(e)g(real)g
(n)m(um)m(b)s(er)0 3878 y(of)k(exp)s(ected)f(coun)m(ts,)h(including)f
(fractional)i(v)-5 b(alues,)31 b(but)f(the)g(return)g(v)-5
b(alue)31 b(is)f(an)g(in)m(teger.)0 4039 y(When)d(the)g(random)g
(functions)f(are)i(used)e(in)h(a)h(v)m(ector)g(expression,)g(b)m(y)f
(default)h(the)f(same)h(random)e(v)-5 b(alue)28 b(will)0
4152 y(b)s(e)g(used)f(when)h(ev)-5 b(aluating)30 b(eac)m(h)f(elemen)m
(t)h(of)f(the)g(v)m(ector.)41 b(If)28 b(di\013eren)m(t)h(random)f(n)m
(um)m(b)s(ers)f(are)i(desired,)f(then)0 4264 y(the)37
b(name)g(of)g(a)g(v)m(ector)i(column)e(should)e(b)s(e)i(supplied)e(as)i
(the)h(single)f(argumen)m(t)g(to)h(the)f(random)f(function)0
4377 y(\(e.g.,)31 b("\015ux)c(+)h(0.1)h(*)g(random\(\015ux\)",)f(where)
g("\015ux')g(is)g(the)g(name)h(of)f(a)h(v)m(ector)h(column\).)40
b(This)27 b(will)i(create)h(a)0 4490 y(v)m(ector)d(of)f(random)f(n)m
(um)m(b)s(ers)f(that)i(will)g(b)s(e)f(used)f(in)i(sequence)g(when)e(ev)
-5 b(aluating)27 b(eac)m(h)g(elemen)m(t)g(of)f(the)f(v)m(ector)0
4603 y(expression.)0 4763 y(An)31 b(alternate)i(syn)m(tax)f(for)f(the)g
(min)g(and)g(max)g(functions)g(has)g(only)g(a)h(single)g(argumen)m(t)g
(whic)m(h)f(should)f(b)s(e)h(a)0 4876 y(v)m(ector)g(v)-5
b(alue)30 b(\(see)g(b)s(elo)m(w\).)41 b(The)29 b(result)g(will)h(b)s(e)
e(the)i(minim)m(um/maxim)m(um)f(elemen)m(t)h(con)m(tained)h(within)e
(the)0 4989 y(v)m(ector.)0 5149 y(The)35 b(accum\(x\))i(function)f
(forms)f(the)h(cum)m(ulativ)m(e)i(sum)d(of)h(x,)h(elemen)m(t)h(b)m(y)e
(elemen)m(t.)58 b(V)-8 b(ector)38 b(columns)e(are)0 5262
y(supp)s(orted)h(simply)h(b)m(y)g(p)s(erforming)f(the)i(summation)g
(pro)s(cess)f(through)f(all)j(the)f(v)-5 b(alues.)65
b(Null)39 b(v)-5 b(alues)39 b(are)0 5375 y(treated)30
b(as)f(0.)41 b(The)29 b(seqdi\013\(x\))h(function)e(forms)h(the)g
(sequen)m(tial)i(di\013erence)e(of)h(x,)f(elemen)m(t)i(b)m(y)e(elemen)m
(t.)41 b(The)0 5488 y(\014rst)36 b(v)-5 b(alue)38 b(of)f(seqdi\013)g
(is)g(the)g(\014rst)g(v)-5 b(alue)37 b(of)g(x.)61 b(A)37
b(single)h(n)m(ull)f(v)-5 b(alue)38 b(in)e(x)h(causes)h(a)f(pair)g(of)g
(n)m(ulls)g(in)g(the)0 5601 y(output.)55 b(The)35 b(seqdi\013)g(and)g
(accum)g(functions)g(are)h(functional)f(in)m(v)m(erses,)j(i.e.,)g
(seqdi\013\(accum\(x\)\))f(==)e(x)g(as)0 5714 y(long)c(as)g(no)f(n)m
(ull)g(v)-5 b(alues)31 b(are)g(presen)m(t.)p eop end
%%Page: 137 145
TeXDict begin 137 144 bop 0 299 a Fh(10.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)31 b(SPECIFICA)-8 b(TION)1936 b Fj(137)0
555 y(In)36 b(the)h(if-then-else)i(expression,)f("b?x:y",)i(b)c(is)h
(an)g(explicit)h(b)s(o)s(olean)f(v)-5 b(alue)37 b(or)g(expression.)61
b(There)36 b(is)h(no)0 668 y(automatic)d(t)m(yp)s(e)e(con)m(v)m(ersion)
h(from)e(n)m(umeric)h(to)g(b)s(o)s(olean)g(v)-5 b(alues,)33
b(so)f(one)g(needs)f(to)i(use)e("iV)-8 b(al!=0")35 b(instead)0
781 y(of)30 b(merely)g("iV)-8 b(al")32 b(as)e(the)g(b)s(o)s(olean)g
(argumen)m(t.)41 b(x)30 b(and)f(y)h(can)g(b)s(e)f(an)m(y)h(scalar)h
(data)g(t)m(yp)s(e)f(\(including)f(string\).)0 941 y(The)22
b(angsep)g(function)f(computes)i(the)f(angular)g(separation)h(in)e
(degrees)i(b)s(et)m(w)m(een)g(2)f(celestial)j(p)s(ositions,)e(where)0
1054 y(the)36 b(\014rst)f(2)h(parameters)g(giv)m(e)h(the)f(RA-lik)m(e)i
(and)d(Dec-lik)m(e)j(co)s(ordinates)f(\(in)f(decimal)g(degrees\))h(of)f
(the)g(\014rst)0 1167 y(p)s(osition,)31 b(and)e(the)i(3rd)f(and)g(4th)g
(parameters)h(giv)m(e)h(the)e(co)s(ordinates)i(of)e(the)h(second)f(p)s
(osition.)0 1327 y(The)38 b(substring)f(function)i(strmid\(S,P)-8
b(,N\))39 b(extracts)g(a)g(substring)f(from)g(S,)g(starting)h(at)g
(string)g(p)s(osition)f(P)-8 b(,)0 1440 y(with)33 b(a)h(substring)f
(length)h(N.)g(The)f(\014rst)g(c)m(haracter)j(p)s(osition)d(in)h(S)f
(is)h(lab)s(eled)g(as)g(1.)51 b(If)33 b(P)g(is)h(0,)h(or)f(refers)f(to)
0 1553 y(a)i(p)s(osition)g(b)s(ey)m(ond)f(the)h(end)e(of)i(S,)g(then)f
(the)h(extracted)h(substring)d(will)i(b)s(e)f(NULL.)h(S,)f(P)-8
b(,)36 b(and)e(N)g(ma)m(y)i(b)s(e)0 1666 y(functions)30
b(of)g(other)h(columns.)0 1826 y(The)39 b(string)h(searc)m(h)h
(function)e(strstr\(S,R\))h(searc)m(hes)h(for)f(the)g(\014rst)f(o)s
(ccurrence)h(of)g(the)g(substring)f(R)h(in)f(S.)0 1939
y(The)c(result)h(is)f(an)h(in)m(teger,)i(indicating)f(the)e(c)m
(haracter)i(p)s(osition)f(of)g(the)g(\014rst)e(matc)m(h)j(\(where)e(1)h
(is)g(the)g(\014rst)0 2052 y(c)m(haracter)c(p)s(osition)e(of)h(S\).)f
(If)g(no)h(matc)m(h)g(is)f(found,)g(then)g(strstr\(\))g(returns)f(a)i
(NULL)f(v)-5 b(alue.)0 2212 y(The)38 b(follo)m(wing)i(t)m(yp)s(e)f
(casting)h(op)s(erators)f(are)g(a)m(v)-5 b(ailable,)44
b(where)38 b(the)h(inclosing)h(paren)m(theses)f(are)g(required)0
2325 y(and)30 b(tak)m(en)h(from)f(the)h(C)f(language)h(usage.)42
b(Also,)31 b(the)g(in)m(teger)g(to)h(real)f(casts)g(v)-5
b(alues)30 b(to)i(double)e(precision:)764 2545 y Fe("real)46
b(to)h(integer")189 b(\(int\))46 b(x)239 b(\(INT\))46
b(x)764 2658 y("integer)f(to)i(real")190 b(\(float\))46
b(i)143 b(\(FLOAT\))45 b(i)0 2878 y Fj(In)30 b(addition,)g(sev)m(eral)i
(constan)m(ts)g(are)f(built)f(in)g(for)g(use)g(in)g(n)m(umerical)h
(expressions:)382 3098 y Fe(#pi)667 b(3.1415...)284 b(#e)620
b(2.7182...)382 3211 y(#deg)f(#pi/180)380 b(#row)524
b(current)46 b(row)h(number)382 3324 y(#null)428 b(undefined)45
b(value)142 b(#snull)428 b(undefined)45 b(string)0 3544
y Fj(A)40 b(string)f(constan)m(t)i(m)m(ust)e(b)s(e)g(enclosed)h(in)g
(quotes)g(as)f(in)h('Crab'.)67 b(The)39 b("n)m(ull")i(constan)m(ts)f
(are)g(useful)f(for)0 3657 y(conditionally)g(setting)g(table)g(v)-5
b(alues)38 b(to)g(a)g(NULL,)g(or)g(unde\014ned,)f(v)-5
b(alue)39 b(\(eg.,)i("col1==-99)f(?)62 b(#NULL)38 b(:)0
3770 y(col1"\).)0 3930 y(There)27 b(is)g(also)i(a)e(function)g(for)h
(testing)g(if)f(t)m(w)m(o)i(v)-5 b(alues)28 b(are)g(close)g(to)h(eac)m
(h)f(other,)h(i.e.,)g(if)e(they)h(are)g("near")g(eac)m(h)0
4043 y(other)c(to)h(within)e(a)h(user)g(sp)s(eci\014ed)f(tolerance.)40
b(The)24 b(argumen)m(ts,)h(v)-5 b(alue)p 2502 4043 28
4 v 34 w(1)24 b(and)f(v)-5 b(alue)p 2979 4043 V 33 w(2)25
b(can)f(b)s(e)f(in)m(teger)i(or)f(real)0 4156 y(and)32
b(represen)m(t)h(the)g(t)m(w)m(o)h(v)-5 b(alues)33 b(who's)f(pro)m
(ximit)m(y)i(is)f(b)s(eing)f(tested)h(to)h(b)s(e)e(within)g(the)h(sp)s
(eci\014ed)f(tolerance,)0 4269 y(also)f(an)g(in)m(teger)g(or)g(real:)
955 4489 y Fe(near\(value_1,)44 b(value_2,)h(tolerance\))0
4709 y Fj(When)24 b(a)i(NULL,)e(or)h(unde\014ned,)f(v)-5
b(alue)25 b(is)g(encoun)m(tered)g(in)g(the)f(FITS)g(table,)j(the)e
(expression)g(will)g(ev)-5 b(aluate)26 b(to)0 4822 y(NULL)31
b(unless)f(the)h(unde\014ned)e(v)-5 b(alue)31 b(is)g(not)g(actually)h
(required)e(for)h(ev)-5 b(aluation,)33 b(e.g.)43 b("TR)m(UE)31
b(.or.)43 b(NULL")0 4935 y(ev)-5 b(aluates)32 b(to)f(TR)m(UE.)g(The)f
(follo)m(wing)h(t)m(w)m(o)h(functions)e(allo)m(w)i(some)f(NULL)f
(detection)i(and)e(handling:)430 5155 y Fe("a)47 b(null)f(value?")667
b(ISNULL\(x\))430 5268 y("define)45 b(a)j(value)e(for)h(null")190
b(DEFNULL\(x,y\))0 5488 y Fj(The)36 b(former)h(returns)e(a)i(b)s(o)s
(olean)g(v)-5 b(alue)37 b(of)g(TR)m(UE)g(if)g(the)g(argumen)m(t)g(x)g
(is)g(NULL.)g(The)f(later)i("de\014nes")f(a)0 5601 y(v)-5
b(alue)35 b(to)g(b)s(e)e(substituted)h(for)g(NULL)g(v)-5
b(alues;)37 b(it)e(returns)e(the)h(v)-5 b(alue)35 b(of)f(x)g(if)g(x)h
(is)f(not)g(NULL,)h(otherwise)f(it)0 5714 y(returns)29
b(the)i(v)-5 b(alue)31 b(of)f(y)-8 b(.)p eop end
%%Page: 138 146
TeXDict begin 138 145 bop 0 299 a Fj(138)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fd(10.11.2)113 b(Bit)36 b(Masks)0 774 y Fj(Bit)g(masks)f(can)h(b)
s(e)f(used)f(to)i(select)h(out)e(ro)m(ws)h(from)e(bit)i(columns)f(\(TF)
m(ORMn)g(=)g(#X\))h(in)f(FITS)f(\014les.)55 b(T)-8 b(o)0
887 y(represen)m(t)30 b(the)h(mask,)g(binary)-8 b(,)30
b(o)s(ctal,)i(and)e(hex)g(formats)g(are)h(allo)m(w)m(ed:)811
1141 y Fe(binary:)142 b(b0110xx1010000101xxxx00)o(01)811
1254 y(octal:)190 b(o720x1)46 b(->)h(\(b111010000xxx001\))811
1367 y(hex:)286 b(h0FxD)94 b(->)47 b(\(b00001111xxxx1101\))0
1621 y Fj(In)22 b(all)i(the)f(represen)m(tations,)j(an)c(x)h(or)g(X)g
(is)g(allo)m(w)m(ed)i(in)d(the)h(mask)g(as)g(a)h(wild)e(card.)38
b(Note)25 b(that)e(the)g(x)g(represen)m(ts)0 1734 y(a)k(di\013eren)m(t)
h(n)m(um)m(b)s(er)e(of)h(wild)f(card)h(bits)g(in)g(eac)m(h)h(represen)m
(tation.)41 b(All)27 b(represen)m(tations)h(are)g(case)g(insensitiv)m
(e.)0 1894 y(T)-8 b(o)28 b(construct)g(the)g(b)s(o)s(olean)f
(expression)h(using)f(the)h(mask)f(as)h(the)g(b)s(o)s(olean)f(equal)h
(op)s(erator)g(describ)s(ed)f(ab)s(o)m(v)m(e)0 2007 y(on)34
b(a)h(bit)g(table)h(column.)53 b(F)-8 b(or)35 b(example,)i(if)d(y)m(ou)
h(had)f(a)h(7)g(bit)g(column)f(named)g(\015ags)h(in)f(a)h(FITS)f(table)
i(and)0 2119 y(w)m(an)m(ted)31 b(all)g(ro)m(ws)g(ha)m(ving)g(the)f(bit)
h(pattern)f(0010011,)k(the)c(selection)j(expression)d(w)m(ould)g(b)s
(e:)1336 2373 y Fe(flags)47 b(==)g(b0010011)191 2486
y(or)1336 2599 y(flags)g(.eq.)f(b10011)0 2853 y Fj(It)35
b(is)g(also)h(p)s(ossible)e(to)i(test)g(if)f(a)g(range)g(of)g(bits)g
(is)g(less)g(than,)h(less)f(than)g(equal,)i(greater)f(than)e(and)h
(greater)0 2966 y(than)30 b(equal)h(to)g(a)g(particular)g(b)s(o)s
(olean)f(v)-5 b(alue:)1336 3220 y Fe(flags)47 b(<=)g(bxxx010xx)1336
3333 y(flags)g(.gt.)f(bxxx100xx)1336 3446 y(flags)h(.le.)f(b1xxxxxxx)0
3700 y Fj(Notice)32 b(the)f(use)f(of)h(the)f(x)g(bit)h(v)-5
b(alue)31 b(to)g(limit)g(the)f(range)h(of)g(bits)f(b)s(eing)g
(compared.)0 3860 y(It)i(is)h(not)f(necessary)h(to)g(sp)s(ecify)f(the)h
(leading)g(\(most)g(signi\014can)m(t\))h(zero)f(\(0\))g(bits)f(in)g
(the)h(mask,)g(as)g(sho)m(wn)e(in)0 3973 y(the)g(second)f(expression)g
(ab)s(o)m(v)m(e.)0 4133 y(Bit)44 b(wise)f(AND,)h(OR)e(and)g(NOT)h(op)s
(erations)g(are)g(also)h(p)s(ossible)e(on)h(t)m(w)m(o)h(or)f(more)g
(bit)g(\014elds)f(using)h(the)0 4246 y('&'\(AND\),)35
b(')p Fc(j)p Fj('\(OR\),)g(and)e(the)h(')10 b(!'\(NOT\))34
b(op)s(erators.)51 b(All)34 b(of)f(these)h(op)s(erators)g(result)f(in)h
(a)g(bit)f(\014eld)g(whic)m(h)0 4359 y(can)e(then)f(b)s(e)f(used)h
(with)g(the)h(equal)g(op)s(erator.)41 b(F)-8 b(or)31
b(example:)1241 4613 y Fe(\(!flags\))45 b(==)j(b1101100)1241
4726 y(\(flags)e(&)h(b1000001\))f(==)h(bx000001)0 4979
y Fj(Bit)35 b(\014elds)f(can)g(b)s(e)f(app)s(ended)g(as)h(w)m(ell)h
(using)f(the)g('+')g(op)s(erator.)53 b(Strings)33 b(can)i(b)s(e)e
(concatenated)j(this)e(w)m(a)m(y)-8 b(,)0 5092 y(to)s(o.)0
5382 y Fd(10.11.3)113 b(V)-9 b(ector)36 b(Columns)0 5601
y Fj(V)-8 b(ector)37 b(columns)e(can)h(also)g(b)s(e)f(used)f(in)h
(building)g(the)g(expression.)56 b(No)36 b(sp)s(ecial)g(syn)m(tax)f(is)
h(required)e(if)i(one)0 5714 y(w)m(an)m(ts)46 b(to)f(op)s(erate)h(on)f
(all)h(elemen)m(ts)g(of)f(the)h(v)m(ector.)86 b(Simply)44
b(use)h(the)g(column)g(name)g(as)g(for)g(a)g(scalar)p
eop end
%%Page: 139 147
TeXDict begin 139 146 bop 0 299 a Fh(10.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)31 b(SPECIFICA)-8 b(TION)1936 b Fj(139)0
555 y(column.)42 b(V)-8 b(ector)32 b(columns)f(can)g(b)s(e)f(freely)h
(in)m(termixed)h(with)e(scalar)i(columns)e(or)h(constan)m(ts)h(in)f
(virtually)g(all)0 668 y(expressions.)40 b(The)29 b(result)g(will)g(b)s
(e)g(of)g(the)g(same)h(dimension)e(as)i(the)f(v)m(ector.)42
b(Tw)m(o)29 b(v)m(ectors)i(in)e(an)g(expression,)0 781
y(though,)h(need)g(to)i(ha)m(v)m(e)f(the)g(same)g(n)m(um)m(b)s(er)e(of)
h(elemen)m(ts)i(and)e(ha)m(v)m(e)h(the)g(same)g(dimensions.)0
941 y(Arithmetic)24 b(and)e(logical)k(op)s(erations)d(are)h(all)g(p)s
(erformed)d(on)i(an)g(elemen)m(t)h(b)m(y)f(elemen)m(t)i(basis.)38
b(Comparing)23 b(t)m(w)m(o)0 1054 y(v)m(ector)32 b(columns,)e(eg)h
("COL1)f(==)g(COL2",)g(th)m(us)g(results)g(in)g(another)g(v)m(ector)i
(of)e(b)s(o)s(olean)h(v)-5 b(alues)30 b(indicating)0
1167 y(whic)m(h)g(elemen)m(ts)i(of)e(the)h(t)m(w)m(o)h(v)m(ectors)f
(are)g(equal.)0 1327 y(Eigh)m(t)g(functions)f(are)h(a)m(v)-5
b(ailable)33 b(that)e(op)s(erate)g(on)f(a)h(v)m(ector)h(and)d(return)h
(a)g(scalar)i(result:)191 1570 y Fe("minimum")284 b(MIN\(V\))475
b("maximum")714 b(MAX\(V\))191 1683 y("average")284 b(AVERAGE\(V\))f
("median")762 b(MEDIAN\(V\))191 1796 y("summation")188
b(SUM\(V\))475 b("standard)46 b(deviation")188 b(STDDEV\(V\))191
1909 y("#)47 b(of)g(values")94 b(NELEM\(V\))379 b("#)48
b(of)f(non-null)e(values")94 b(NVALID\(V\))0 2151 y Fj(where)40
b(V)h(represen)m(ts)g(the)g(name)g(of)h(a)f(v)m(ector)h(column)f(or)g
(a)h(man)m(ually)f(constructed)g(v)m(ector)i(using)d(curly)0
2264 y(brac)m(k)m(ets)27 b(as)f(describ)s(ed)e(b)s(elo)m(w.)39
b(The)25 b(\014rst)g(6)h(of)g(these)g(functions)f(ignore)h(an)m(y)g(n)m
(ull)f(v)-5 b(alues)26 b(in)f(the)h(v)m(ector)h(when)0
2377 y(computing)k(the)f(result.)41 b(The)30 b(STDDEV\(\))h(function)g
(computes)f(the)h(sample)g(standard)e(deviation,)j(i.e.)42
b(it)31 b(is)0 2490 y(prop)s(ortional)f(to)h(1/SQR)-8
b(T\(N-1\))32 b(instead)f(of)g(1/SQR)-8 b(T\(N\),)31
b(where)f(N)h(is)f(NV)-10 b(ALID\(V\).)0 2650 y(The)31
b(SUM)h(function)f(literally)j(sums)d(all)h(the)g(elemen)m(ts)h(in)f
(x,)g(returning)f(a)h(scalar)h(v)-5 b(alue.)45 b(If)31
b(V)h(is)g(a)g(b)s(o)s(olean)0 2763 y(v)m(ector,)40 b(SUM)c(returns)f
(the)h(n)m(um)m(b)s(er)f(of)i(TR)m(UE)f(elemen)m(ts.)60
b(The)36 b(NELEM)g(function)g(returns)f(the)h(n)m(um)m(b)s(er)0
2876 y(of)h(elemen)m(ts)g(in)g(v)m(ector)h(V)e(whereas)h(NV)-10
b(ALID)36 b(return)g(the)h(n)m(um)m(b)s(er)e(of)h(non-n)m(ull)g(elemen)
m(ts)i(in)e(the)h(v)m(ector.)0 2989 y(\(NELEM)28 b(also)h(op)s(erates)f
(on)g(bit)f(and)g(string)h(columns,)g(returning)f(their)h(column)f
(widths.\))40 b(As)27 b(an)h(example,)0 3102 y(to)42
b(test)g(whether)f(all)h(elemen)m(ts)h(of)f(t)m(w)m(o)g(v)m(ectors)h
(satisfy)f(a)g(giv)m(en)g(logical)i(comparison,)g(one)e(can)g(use)f
(the)0 3215 y(expression)668 3457 y Fe(SUM\()47 b(COL1)f(>)i(COL2)f(\))
g(==)g(NELEM\()f(COL1)h(\))0 3700 y Fj(whic)m(h)32 b(will)g(return)f
(TR)m(UE)h(if)g(all)h(elemen)m(ts)g(of)f(COL1)g(are)g(greater)h(than)f
(their)g(corresp)s(onding)f(elemen)m(ts)i(in)0 3813 y(COL2.)0
3973 y(T)-8 b(o)32 b(sp)s(ecify)f(a)i(single)f(elemen)m(t)h(of)f(a)g(v)
m(ector,)i(giv)m(e)f(the)f(column)f(name)h(follo)m(w)m(ed)h(b)m(y)f(a)g
(comma-separated)h(list)0 4086 y(of)c(co)s(ordinates)g(enclosed)h(in)e
(square)h(brac)m(k)m(ets.)41 b(F)-8 b(or)30 b(example,)g(if)e(a)h(v)m
(ector)i(column)d(named)h(PHAS)f(exists)h(in)0 4199 y(the)e(table)g(as)
g(a)g(one)g(dimensional,)h(256)g(comp)s(onen)m(t)f(list)g(of)g(n)m(um)m
(b)s(ers)e(from)h(whic)m(h)h(y)m(ou)g(w)m(an)m(ted)g(to)g(select)i(the)
0 4312 y(57th)j(comp)s(onen)m(t)g(for)f(use)g(in)g(the)h(expression,)f
(then)h(PHAS[57])g(w)m(ould)f(do)h(the)f(tric)m(k.)45
b(Higher)32 b(dimensional)0 4425 y(arra)m(ys)41 b(of)h(data)f(ma)m(y)h
(app)s(ear)f(in)f(a)i(column.)73 b(But)41 b(in)g(order)f(to)i(in)m
(terpret)f(them,)j(the)e(TDIMn)e(k)m(eyw)m(ord)0 4538
y(m)m(ust)34 b(app)s(ear)g(in)g(the)g(header.)52 b(Assuming)34
b(that)h(a)f(\(4,4,4,4\))k(arra)m(y)c(is)h(pac)m(k)m(ed)g(in)m(to)g
(eac)m(h)h(ro)m(w)e(of)g(a)h(column)0 4650 y(named)26
b(ARRA)-8 b(Y4D,)28 b(the)f(\(1,2,3,4\))i(comp)s(onen)m(t)e(elemen)m(t)
g(of)g(eac)m(h)g(ro)m(w)g(is)f(accessed)i(b)m(y)e(ARRA)-8
b(Y4D[1,2,3,4].)0 4763 y(Arra)m(ys)33 b(up)e(to)j(dimension)e(5)h(are)f
(curren)m(tly)h(supp)s(orted.)46 b(Eac)m(h)33 b(v)m(ector)h(index)e
(can)h(itself)g(b)s(e)f(an)h(expression,)0 4876 y(although)39
b(it)g(m)m(ust)g(ev)-5 b(aluate)40 b(to)f(an)g(in)m(teger)h(v)-5
b(alue)39 b(within)f(the)h(b)s(ounds)d(of)j(the)g(v)m(ector.)67
b(V)-8 b(ector)40 b(columns)0 4989 y(whic)m(h)31 b(con)m(tain)h(spaces)
g(or)f(arithmetic)h(op)s(erators)g(m)m(ust)f(ha)m(v)m(e)h(their)f
(names)g(enclosed)h(in)f("$")h(c)m(haracters)h(as)0 5102
y(with)d($ARRA)-8 b(Y-4D$[1,2,3,4].)0 5262 y(A)45 b(more)f(C-lik)m(e)i
(syn)m(tax)g(for)e(sp)s(ecifying)g(v)m(ector)j(indices)d(is)h(also)h(a)
m(v)-5 b(ailable.)85 b(The)45 b(elemen)m(t)h(used)d(in)i(the)0
5375 y(preceding)28 b(example)h(alternativ)m(ely)i(could)d(b)s(e)g(sp)s
(eci\014ed)g(with)f(the)i(syn)m(tax)g(ARRA)-8 b(Y4D[4][3][2][1].)45
b(Note)30 b(the)0 5488 y(rev)m(erse)40 b(order)f(of)h(indices)f(\(as)h
(in)f(C\),)h(as)f(w)m(ell)i(as)e(the)h(fact)g(that)g(the)g(v)-5
b(alues)40 b(are)f(still)i(ones-based)e(\(as)h(in)0 5601
y(F)-8 b(ortran)39 b({)g(adopted)g(to)g(a)m(v)m(oid)h(am)m(biguit)m(y)g
(for)f(1D)g(v)m(ectors\).)67 b(With)39 b(this)g(syn)m(tax,)i(one)e(do)s
(es)f(not)h(need)f(to)0 5714 y(sp)s(ecify)30 b(all)h(of)g(the)f
(indices.)41 b(T)-8 b(o)31 b(extract)h(a)f(3D)g(slice)g(of)g(this)f(4D)
h(arra)m(y)-8 b(,)32 b(use)e(ARRA)-8 b(Y4D[4].)p eop
end
%%Page: 140 148
TeXDict begin 140 147 bop 0 299 a Fj(140)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(V)g(ariable-length)33 b(v)m(ector)f(columns)e(are)g(not)h
(supp)s(orted.)0 715 y(V)-8 b(ectors)24 b(can)e(b)s(e)f(man)m(ually)h
(constructed)h(within)e(the)h(expression)g(using)f(a)h(comma-separated)
i(list)f(of)f(elemen)m(ts)0 828 y(surrounded)35 b(b)m(y)j(curly)g
(braces)h(\(')p Fc(fg)p Fj('\).)66 b(F)-8 b(or)38 b(example,)j(')p
Fc(f)p Fj(1,3,6,1)p Fc(g)p Fj(')h(is)d(a)f(4-elemen)m(t)i(v)m(ector)g
(con)m(taining)g(the)0 941 y(v)-5 b(alues)26 b(1,)h(3,)g(6,)g(and)e(1.)
40 b(The)25 b(v)m(ector)i(can)f(con)m(tain)h(only)f(b)s(o)s(olean,)g
(in)m(teger,)j(and)c(real)h(v)-5 b(alues)26 b(\(or)g(expressions\).)0
1054 y(The)c(elemen)m(ts)i(will)f(b)s(e)f(promoted)h(to)g(the)g
(highest)g(data)g(t)m(yp)s(e)g(presen)m(t.)38 b(An)m(y)22
b(elemen)m(ts)i(whic)m(h)f(are)g(themselv)m(es)0 1167
y(v)m(ectors,)40 b(will)d(b)s(e)f(expanded)g(out)h(with)g(eac)m(h)g(of)
g(its)g(elemen)m(ts)i(b)s(ecoming)d(an)h(elemen)m(t)h(in)f(the)g
(constructed)0 1280 y(v)m(ector.)0 1567 y Fd(10.11.4)113
b(Go)s(o)s(d)38 b(Time)g(In)m(terv)-6 b(al)37 b(Filtering)0
1786 y Fj(A)44 b(common)g(\014ltering)h(metho)s(d)e(in)m(v)m(olv)m(es)j
(selecting)g(ro)m(ws)e(whic)m(h)f(ha)m(v)m(e)j(a)e(time)h(v)-5
b(alue)44 b(whic)m(h)g(lies)g(within)0 1899 y(what)37
b(is)g(called)i(a)f(Go)s(o)s(d)f(Time)g(In)m(terv)-5
b(al)38 b(or)f(GTI.)g(The)g(time)h(in)m(terv)-5 b(als)38
b(are)g(de\014ned)e(in)h(a)g(separate)i(FITS)0 2012 y(table)i
(extension)g(whic)m(h)e(con)m(tains)i(2)g(columns)f(giving)g(the)h
(start)f(and)g(stop)g(time)g(of)g(eac)m(h)i(go)s(o)s(d)e(in)m(terv)-5
b(al.)0 2124 y(The)34 b(\014ltering)h(op)s(eration)h(accepts)g(only)e
(those)i(ro)m(ws)e(of)h(the)g(input)f(table)i(whic)m(h)e(ha)m(v)m(e)i
(an)f(asso)s(ciated)h(time)0 2237 y(whic)m(h)f(falls)i(within)e(one)h
(of)g(the)g(time)g(in)m(terv)-5 b(als)37 b(de\014ned)e(in)g(the)h(GTI)g
(extension.)57 b(A)36 b(high)g(lev)m(el)h(function,)0
2350 y(gti\014lter\(a,b,c,d\),)44 b(is)c(a)m(v)-5 b(ailable)42
b(whic)m(h)d(ev)-5 b(aluates)41 b(eac)m(h)g(ro)m(w)e(of)h(the)f(input)g
(table)h(and)f(returns)f(TR)m(UE)i(or)0 2463 y(F)-10
b(ALSE)30 b(dep)s(ending)f(whether)h(the)g(ro)m(w)h(is)f(inside)g(or)g
(outside)h(the)g(go)s(o)s(d)f(time)h(in)m(terv)-5 b(al.)42
b(The)30 b(syn)m(tax)h(is)286 2700 y Fe(gtifilter\()45
b([)j("gtifile")d([,)i(expr)g([,)g("STARTCOL",)e("STOPCOL")g(])j(])f(])
g(\))191 2812 y(or)286 2925 y(gtifilter\()e([)j('gtifile')d([,)i(expr)g
([,)g('STARTCOL',)e('STOPCOL')g(])j(])f(])g(\))0 3162
y Fj(where)20 b(eac)m(h)h("[]")h(demarks)e(optional)h(parameters.)38
b(Note)21 b(that)g(the)g(quotes)f(around)g(the)g(gti\014le)i(and)d(ST)
-8 b(AR)g(T/STOP)0 3275 y(column)33 b(are)h(required.)50
b(Either)34 b(single)g(or)g(double)f(quotes)h(ma)m(y)g(b)s(e)f(used.)50
b(In)33 b(cases)h(where)g(this)f(expression)0 3387 y(is)d(en)m(tered)g
(on)g(the)g(Unix)g(command)g(line,)g(enclose)h(the)f(en)m(tire)h
(expression)f(in)f(double)h(quotes,)g(and)g(then)f(use)0
3500 y(single)c(quotes)g(within)e(the)i(expression)f(to)h(enclose)g
(the)g('gti\014le')h(and)d(other)i(terms.)38 b(It)25
b(is)f(also)h(usually)f(p)s(ossible)0 3613 y(to)38 b(do)e(the)h(rev)m
(erse,)j(and)c(enclose)i(the)f(whole)g(expression)g(in)f(single)i
(quotes)f(and)f(then)h(use)f(double)g(quotes)0 3726 y(within)d(the)g
(expression.)50 b(The)33 b(gti\014le,)i(if)f(sp)s(eci\014ed,)f(can)h(b)
s(e)f(blank)g(\(""\))i(whic)m(h)e(will)g(mean)h(to)g(use)f(the)h
(\014rst)0 3839 y(extension)g(with)g(the)f(name)h("*GTI*")h(in)f(the)f
(curren)m(t)h(\014le,)h(a)f(plain)f(extension)h(sp)s(eci\014er)f(\(eg,)
j("+2",)g("[2]",)0 3952 y(or)30 b("[STDGTI]"\))i(whic)m(h)e(will)h(b)s
(e)f(used)f(to)j(select)g(an)e(extension)h(in)f(the)h(curren)m(t)f
(\014le,)h(or)f(a)h(regular)g(\014lename)0 4065 y(with)f(or)h(without)f
(an)h(extension)g(sp)s(eci\014er)f(whic)m(h)g(in)g(the)h(latter)h(case)
f(will)g(mean)f(to)i(use)e(the)h(\014rst)e(extension)0
4178 y(with)37 b(an)g(extension)g(name)h("*GTI*".)62
b(Expr)36 b(can)h(b)s(e)g(an)m(y)g(arithmetic)i(expression,)f
(including)f(simply)g(the)0 4291 y(time)f(column)g(name.)57
b(A)36 b(v)m(ector)h(time)g(expression)e(will)h(pro)s(duce)f(a)h(v)m
(ector)h(b)s(o)s(olean)f(result.)57 b(ST)-8 b(AR)g(TCOL)0
4404 y(and)27 b(STOPCOL)f(are)i(the)g(names)g(of)g(the)g(ST)-8
b(AR)g(T/STOP)26 b(columns)i(in)f(the)h(GTI)g(extension.)41
b(If)27 b(one)h(of)g(them)0 4517 y(is)i(sp)s(eci\014ed,)g(they)h(b)s
(oth)f(m)m(ust)g(b)s(e.)0 4677 y(In)21 b(its)h(simplest)g(form,)i(no)d
(parameters)h(need)g(to)h(b)s(e)e(pro)m(vided)g({)h(default)g(v)-5
b(alues)22 b(will)h(b)s(e)e(used.)37 b(The)21 b(expression)0
4790 y("gti\014lter\(\)")33 b(is)e(equiv)-5 b(alen)m(t)31
b(to)334 5026 y Fe(gtifilter\()45 b("",)i(TIME,)f("*START*",)f
("*STOP*")h(\))0 5262 y Fj(This)31 b(will)g(searc)m(h)h(the)g(curren)m
(t)f(\014le)g(for)g(a)h(GTI)f(extension,)h(\014lter)g(the)f(TIME)g
(column)g(in)g(the)h(curren)m(t)f(table,)0 5375 y(using)j(ST)-8
b(AR)g(T/STOP)34 b(times)i(tak)m(en)f(from)g(columns)f(in)h(the)g(GTI)g
(extension)g(with)g(names)f(con)m(taining)j(the)0 5488
y(strings)32 b("ST)-8 b(AR)g(T")33 b(and)e("STOP".)46
b(The)32 b(wildcards)f(\('*'\))j(allo)m(w)g(sligh)m(t)f(v)-5
b(ariations)33 b(in)f(naming)g(con)m(v)m(en)m(tions)0
5601 y(suc)m(h)38 b(as)g("TST)-8 b(AR)g(T")39 b(or)f("ST)-8
b(AR)g(TTIME".)65 b(The)37 b(same)i(default)g(v)-5 b(alues)38
b(apply)g(for)g(unsp)s(eci\014ed)f(parame-)0 5714 y(ters)f(when)f(the)h
(\014rst)f(one)i(or)f(t)m(w)m(o)h(parameters)f(are)h(sp)s(eci\014ed.)56
b(The)36 b(function)f(automatically)k(searc)m(hes)e(for)p
eop end
%%Page: 141 149
TeXDict begin 141 148 bop 0 299 a Fh(10.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)31 b(SPECIFICA)-8 b(TION)1936 b Fj(141)0
555 y(TIMEZER)m(O/I/F)37 b(k)m(eyw)m(ords)f(in)g(the)h(curren)m(t)f
(and)g(GTI)g(extensions,)i(applying)f(a)f(relativ)m(e)j(time)e
(o\013set,)i(if)0 668 y(necessary)-8 b(.)0 958 y Fd(10.11.5)113
b(Spatial)38 b(Region)g(Filtering)0 1177 y Fj(Another)g(common)g
(\014ltering)g(metho)s(d)f(selects)i(ro)m(ws)f(based)g(on)f(whether)h
(the)g(spatial)h(p)s(osition)e(asso)s(ciated)0 1290 y(with)32
b(eac)m(h)i(ro)m(w)e(is)h(lo)s(cated)h(within)e(a)h(giv)m(en)g
(2-dimensional)g(region.)48 b(The)32 b(syn)m(tax)h(for)f(this)h
(high-lev)m(el)h(\014lter)0 1403 y(is)334 1659 y Fe(regfilter\()45
b("regfilename")f([)k(,)f(Xexpr,)f(Yexpr)h([)g(,)h("wcs)e(cols")h(])g
(])g(\))0 1915 y Fj(where)22 b(eac)m(h)i("[]")g(demarks)e(optional)i
(parameters.)38 b(The)22 b(region)h(\014le)g(name)f(is)h(required)f
(and)g(m)m(ust)g(b)s(e)g(enclosed)0 2028 y(in)34 b(quotes.)51
b(The)33 b(remaining)h(parameters)h(are)f(optional.)52
b(There)33 b(are)i(2)f(supp)s(orted)e(formats)i(for)f(the)h(region)0
2141 y(\014le:)62 b(ASCI)s(I)39 b(\014le)h(or)h(FITS)f(binary)g(table.)
73 b(The)40 b(region)h(\014le)g(con)m(tains)h(a)f(list)g(of)g(one)g(or)
g(more)g(geometric)0 2254 y(shap)s(es)30 b(\(circle,)j(ellipse,)g(b)s
(o)m(x,)e(etc.\))44 b(whic)m(h)31 b(de\014nes)f(a)i(region)g(on)f(the)g
(celestial)j(sphere)c(or)h(an)g(area)h(within)f(a)0 2367
y(particular)36 b(2D)g(image.)57 b(The)35 b(region)h(\014le)f(is)g(t)m
(ypically)j(generated)e(using)f(an)g(image)i(displa)m(y)e(program)g
(suc)m(h)0 2480 y(as)e(fv/PO)m(W)g(\(distribute)f(b)m(y)h(the)f(HEASAR)
m(C\),)h(or)g(ds9)f(\(distributed)g(b)m(y)g(the)h(Smithsonian)f
(Astroph)m(ysical)0 2593 y(Observ)-5 b(atory\).)69 b(Users)39
b(should)g(refer)g(to)h(the)g(do)s(cumen)m(tation)h(pro)m(vided)e(with)
g(these)h(programs)f(for)h(more)0 2706 y(details)29 b(on)f(the)g(syn)m
(tax)h(used)e(in)h(the)h(region)f(\014les.)40 b(The)28
b(FITS)f(region)i(\014le)f(format)h(is)f(de\014ned)f(in)h(a)g(do)s
(cumen)m(t)0 2819 y(a)m(v)-5 b(ailable)33 b(from)d(the)g(FITS)g(Supp)s
(ort)e(O\016ce)j(at)g(h)m(ttp://\014ts.gsfc.nasa.go)m(v/)k(registry/)c
(region.h)m(tml)0 2979 y(In)21 b(its)h(simplest)g(form,)i(\(e.g.,)h
(reg\014lter\("region.reg"\))h(\))c(the)g(co)s(ordinates)g(in)g(the)g
(default)g('X')h(and)e('Y')h(columns)0 3092 y(will)43
b(b)s(e)g(used)f(to)i(determine)f(if)g(eac)m(h)h(ro)m(w)f(is)g(inside)g
(or)g(outside)g(the)g(area)h(sp)s(eci\014ed)e(in)h(the)g(region)h
(\014le.)0 3204 y(Alternate)32 b(p)s(osition)e(column)g(names,)h(or)f
(expressions,)h(ma)m(y)g(b)s(e)e(en)m(tered)i(if)g(needed,)f(as)h(in)
382 3461 y Fe(regfilter\("region.reg",)41 b(XPOS,)47
b(YPOS\))0 3717 y Fj(Region)37 b(\014ltering)f(can)g(b)s(e)f(applied)g
(most)h(unam)m(biguously)f(if)h(the)g(p)s(ositions)g(in)f(the)h(region)
g(\014le)g(and)f(in)h(the)0 3830 y(table)g(to)g(b)s(e)e(\014ltered)h
(are)h(b)s(oth)e(giv)m(e)j(in)e(terms)g(of)g(absolute)h(celestial)i(co)
s(ordinate)e(units.)54 b(In)35 b(this)g(case)h(the)0
3943 y(lo)s(cations)26 b(and)d(sizes)i(of)g(the)f(geometric)i(shap)s
(es)e(in)g(the)g(region)h(\014le)f(are)h(sp)s(eci\014ed)f(in)g(angular)
g(units)g(on)g(the)g(sky)0 4056 y(\(e.g.,)32 b(p)s(ositions)e(giv)m(en)
i(in)e(R.A.)g(and)g(Dec.)42 b(and)30 b(sizes)h(in)f(arcseconds)g(or)h
(arcmin)m(utes\).)41 b(Similarly)-8 b(,)31 b(eac)m(h)h(ro)m(w)0
4168 y(of)h(the)h(\014ltered)f(table)h(will)f(ha)m(v)m(e)i(a)e
(celestial)j(co)s(ordinate)e(asso)s(ciated)g(with)f(it.)50
b(This)32 b(asso)s(ciation)j(is)e(usually)0 4281 y(implemen)m(ted)39
b(using)e(a)i(set)g(of)f(so-called)i('W)-8 b(orld)39
b(Co)s(ordinate)g(System')f(\(or)h(W)m(CS\))f(FITS)g(k)m(eyw)m(ords)g
(that)0 4394 y(de\014ne)27 b(the)g(co)s(ordinate)h(transformation)g
(that)g(m)m(ust)f(b)s(e)f(applied)h(to)h(the)g(v)-5 b(alues)27
b(in)g(the)h('X')g(and)e('Y')i(columns)0 4507 y(to)j(calculate)i(the)d
(co)s(ordinate.)0 4667 y(Alternativ)m(ely)-8 b(,)30 b(one)d(can)g(p)s
(erform)e(spatial)j(\014ltering)e(using)g(unitless)h('pixel')g(co)s
(ordinates)h(for)e(the)h(regions)g(and)0 4780 y(ro)m(w)33
b(p)s(ositions.)49 b(In)33 b(this)g(case)h(the)f(user)g(m)m(ust)g(b)s
(e)f(careful)h(to)h(ensure)f(that)g(the)h(p)s(ositions)f(in)g(the)g(2)g
(\014les)h(are)0 4893 y(self-consisten)m(t.)54 b(A)34
b(t)m(ypical)i(problem)d(is)h(that)h(the)f(region)h(\014le)f(ma)m(y)h
(b)s(e)e(generated)j(using)d(a)i(binned)d(image,)0 5006
y(but)g(the)h(un)m(binned)e(co)s(ordinates)i(are)g(giv)m(en)h(in)e(the)
h(ev)m(en)m(t)i(table.)48 b(The)32 b(R)m(OSA)-8 b(T)33
b(ev)m(en)m(ts)h(\014les,)g(for)e(example,)0 5119 y(ha)m(v)m(e)f(X)f
(and)f(Y)g(pixel)h(co)s(ordinates)g(that)h(range)f(from)f(1)h(-)g
(15360.)42 b(These)30 b(co)s(ordinates)g(are)g(t)m(ypically)h(binned)0
5232 y(b)m(y)i(a)h(factor)g(of)f(32)h(to)g(pro)s(duce)e(a)i(480x480)i
(pixel)d(image.)51 b(If)32 b(one)i(then)f(uses)g(a)g(region)h(\014le)f
(generated)h(from)0 5345 y(this)c(image)i(\(in)f(image)g(pixel)g
(units\))g(to)g(\014lter)f(the)h(R)m(OSA)-8 b(T)30 b(ev)m(en)m(ts)i
(\014le,)f(then)f(the)h(X)g(and)f(Y)g(column)h(v)-5 b(alues)0
5458 y(m)m(ust)30 b(b)s(e)g(con)m(v)m(erted)i(to)f(corresp)s(onding)e
(pixel)i(units)f(as)g(in:)382 5714 y Fe(regfilter\("rosat.reg",)42
b(X/32.+.5,)j(Y/32.+.5\))p eop end
%%Page: 142 150
TeXDict begin 142 149 bop 0 299 a Fj(142)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(Note)46 b(that)f(this)f(binning)f(con)m(v)m(ersion)j(is)e(not)
h(necessary)g(if)f(the)h(region)g(\014le)f(is)h(sp)s(eci\014ed)e(using)
h(celestial)0 668 y(co)s(ordinate)h(units)f(instead)g(of)g(pixel)h
(units)f(b)s(ecause)g(CFITSIO)e(is)j(then)e(able)i(to)g(directly)g
(compare)g(the)0 781 y(celestial)30 b(co)s(ordinate)f(of)e(eac)m(h)i
(ro)m(w)f(in)f(the)h(table)g(with)g(the)f(celestial)k(co)s(ordinates)d
(in)f(the)h(region)g(\014le)g(without)0 894 y(ha)m(ving)j(to)g(kno)m(w)
f(an)m(ything)h(ab)s(out)f(ho)m(w)h(the)f(image)i(ma)m(y)f(ha)m(v)m(e)g
(b)s(een)f(binned.)0 1054 y(The)f(last)h("w)m(cs)g(cols")h(parameter)f
(should)e(rarely)h(b)s(e)g(needed.)40 b(If)29 b(supplied,)f(this)i
(string)f(con)m(tains)i(the)e(names)0 1167 y(of)37 b(the)g(2)h(columns)
f(\(space)h(or)f(comma)g(separated\))h(whic)m(h)f(ha)m(v)m(e)h(the)g
(asso)s(ciated)g(W)m(CS)f(k)m(eyw)m(ords.)61 b(If)37
b(not)0 1280 y(supplied,)f(the)g(\014lter)g(will)h(scan)f(the)g(X)g
(and)f(Y)h(expressions)g(for)g(column)f(names.)58 b(If)35
b(only)h(one)h(is)f(found)e(in)0 1393 y(eac)m(h)e(expression,)e(those)h
(columns)f(will)h(b)s(e)e(used,)h(otherwise)h(an)f(error)g(will)h(b)s
(e)f(returned.)0 1553 y(These)g(region)h(shap)s(es)f(are)g(supp)s
(orted)f(\(names)h(are)h(case)h(insensitiv)m(e\):)334
1817 y Fe(Point)428 b(\()48 b(X1,)f(Y1)g(\))715 b(<-)48
b(One)f(pixel)f(square)g(region)334 1930 y(Line)476 b(\()48
b(X1,)f(Y1,)g(X2,)f(Y2)i(\))333 b(<-)48 b(One)f(pixel)f(wide)h(region)
334 2043 y(Polygon)332 b(\()48 b(X1,)f(Y1,)g(X2,)f(Y2,)h(...)g(\))95
b(<-)48 b(Rest)e(are)h(interiors)e(with)334 2156 y(Rectangle)236
b(\()48 b(X1,)f(Y1,)g(X2,)f(Y2,)h(A)h(\))334 b(|)47 b(boundaries)e
(considered)334 2269 y(Box)524 b(\()48 b(Xc,)f(Yc,)g(Wdth,)f(Hght,)g(A)
i(\))143 b(V)47 b(within)f(the)h(region)334 2382 y(Diamond)332
b(\()48 b(Xc,)f(Yc,)g(Wdth,)f(Hght,)g(A)i(\))334 2494
y(Circle)380 b(\()48 b(Xc,)f(Yc,)g(R)g(\))334 2607 y(Annulus)332
b(\()48 b(Xc,)f(Yc,)g(Rin,)f(Rout)h(\))334 2720 y(Ellipse)332
b(\()48 b(Xc,)f(Yc,)g(Rx,)f(Ry,)h(A)h(\))334 2833 y(Elliptannulus)c(\()
k(Xc,)f(Yc,)g(Rinx,)f(Riny,)g(Routx,)g(Routy,)g(Ain,)h(Aout)g(\))334
2946 y(Sector)380 b(\()48 b(Xc,)f(Yc,)g(Amin,)f(Amax)h(\))0
3210 y Fj(where)28 b(\(Xc,Yc\))j(is)d(the)h(co)s(ordinate)h(of)e(the)h
(shap)s(e's)f(cen)m(ter;)j(\(X#,Y#\))e(are)g(the)g(co)s(ordinates)g(of)
g(the)g(shap)s(e's)0 3323 y(edges;)39 b(Rxxx)c(are)g(the)h(shap)s(es')f
(v)-5 b(arious)35 b(Radii)h(or)f(semima)5 b(jor/minor)36
b(axes;)i(and)d(Axxx)g(are)h(the)g(angles)g(of)0 3436
y(rotation)d(\(or)e(b)s(ounding)f(angles)i(for)f(Sector\))h(in)f
(degrees.)44 b(F)-8 b(or)32 b(rotated)h(shap)s(es,)e(the)g(rotation)i
(angle)f(can)g(b)s(e)0 3549 y(left)g(o\013,)h(indicating)f(no)f
(rotation.)46 b(Common)31 b(alternate)i(names)e(for)h(the)f(regions)h
(can)g(also)h(b)s(e)d(used:)43 b(rotb)s(o)m(x)0 3662
y(=)29 b(b)s(o)m(x;)g(rotrectangle)i(=)e(rectangle;)i(\(rot\)rhom)m
(bus)e(=)f(\(rot\)diamond;)j(and)d(pie)h(=)f(sector.)42
b(When)28 b(a)i(shap)s(e's)0 3775 y(name)e(is)g(preceded)f(b)m(y)h(a)g
(min)m(us)g(sign,)g('-',)i(the)e(de\014ned)e(region)j(is)f(instead)g
(the)g(area)h(*outside*)g(its)f(b)s(oundary)0 3888 y(\(ie,)36
b(the)e(region)h(is)f(in)m(v)m(erted\).)53 b(All)34 b(the)g(shap)s(es)f
(within)h(a)g(single)h(region)f(\014le)h(are)f(OR'd)f(together)j(to)e
(create)0 4000 y(the)29 b(region,)i(and)d(the)i(order)f(is)g
(signi\014can)m(t.)41 b(The)29 b(o)m(v)m(erall)i(w)m(a)m(y)g(of)e(lo)s
(oking)h(at)g(region)g(\014les)f(is)g(that)h(if)f(the)h(\014rst)0
4113 y(region)f(is)g(an)g(excluded)g(region)g(then)f(a)i(dumm)m(y)d
(included)h(region)i(of)f(the)g(whole)g(detector)h(is)f(inserted)f(in)h
(the)0 4226 y(fron)m(t.)40 b(Then)25 b(eac)m(h)j(region)f(sp)s
(eci\014cation)h(as)f(it)g(is)g(pro)s(cessed)f(o)m(v)m(errides)h(an)m
(y)g(selections)i(inside)d(of)h(that)g(region)0 4339
y(sp)s(eci\014ed)36 b(b)m(y)g(previous)g(regions.)59
b(Another)37 b(w)m(a)m(y)g(of)g(thinking)f(ab)s(out)g(this)g(is)h(that)
g(if)f(a)h(previous)f(excluded)0 4452 y(region)31 b(is)f(completely)i
(inside)f(of)f(a)h(subsequen)m(t)e(included)h(region)h(the)g(excluded)f
(region)h(is)f(ignored.)0 4612 y(The)44 b(p)s(ositional)i(co)s
(ordinates)g(ma)m(y)f(b)s(e)g(giv)m(en)h(either)f(in)g(pixel)g(units,)j
(decimal)e(degrees)g(or)f(hh:mm:ss.s,)0 4725 y(dd:mm:ss.s)25
b(units.)38 b(The)26 b(shap)s(e)f(sizes)i(ma)m(y)f(b)s(e)g(giv)m(en)h
(in)e(pixels,)j(degrees,)f(arcmin)m(utes,)h(or)e(arcseconds.)40
b(Lo)s(ok)0 4838 y(at)31 b(examples)g(of)f(region)h(\014le)g(pro)s
(duced)d(b)m(y)i(fv/PO)m(W)h(or)g(ds9)f(for)g(further)f(details)i(of)g
(the)f(region)h(\014le)f(format.)0 4998 y(There)h(are)g(three)h(lo)m
(w-lev)m(el)i(functions)d(that)g(are)h(primarily)f(for)g(use)g(with)g
(reg\014lter)g(function,)h(but)e(they)i(can)0 5111 y(b)s(e)j(called)i
(directly)-8 b(.)59 b(They)35 b(return)g(a)h(b)s(o)s(olean)g(true)g(or)
g(false)h(dep)s(ending)d(on)i(whether)f(a)i(t)m(w)m(o)g(dimensional)0
5224 y(p)s(oin)m(t)30 b(is)h(in)f(the)g(region)h(or)g(not.)41
b(The)30 b(p)s(ositional)h(co)s(ordinates)g(m)m(ust)f(b)s(e)g(giv)m(en)
h(in)f(pixel)h(units:)191 5488 y Fe("point)46 b(in)h(a)h(circular)d
(region")477 5601 y(circle\(xcntr,ycntr,radius)o(,Xco)o(lumn)o(,Yc)o
(olum)o(n\))p eop end
%%Page: 143 151
TeXDict begin 143 150 bop 0 299 a Fh(10.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)31 b(SPECIFICA)-8 b(TION)1936 b Fj(143)191
555 y Fe("point)46 b(in)h(an)g(elliptical)e(region")430
668 y(ellipse\(xcntr,ycntr,xhl)o(f_w)o(dth,)o(yhlf)o(_wd)o(th,r)o(otat)
o(ion)o(,Xco)o(lumn)o(,Yc)o(olum)o(n\))191 894 y("point)h(in)h(a)h
(rectangular)c(region")620 1007 y(box\(xcntr,ycntr,xfll_wdth,)o(yfll)o
(_wd)o(th,r)o(otat)o(ion)o(,Xco)o(lumn)o(,Yc)o(olum)o(n\))191
1233 y(where)334 1346 y(\(xcntr,ycntr\))g(are)j(the)g(\(x,y\))f
(position)g(of)h(the)g(center)f(of)h(the)g(region)334
1458 y(\(xhlf_wdth,yhlf_wdth\))42 b(are)47 b(the)g(\(x,y\))f(half)h
(widths)f(of)h(the)g(region)334 1571 y(\(xfll_wdth,yfll_wdth\))42
b(are)47 b(the)g(\(x,y\))f(full)h(widths)f(of)h(the)g(region)334
1684 y(\(radius\))f(is)h(half)f(the)h(diameter)f(of)h(the)g(circle)334
1797 y(\(rotation\))e(is)i(the)g(angle\(degrees\))d(that)j(the)g
(region)f(is)h(rotated)f(with)620 1910 y(respect)g(to)h
(\(xcntr,ycntr\))334 2023 y(\(Xcoord,Ycoord\))d(are)j(the)g(\(x,y\))f
(coordinates)f(to)i(test,)f(usually)g(column)620 2136
y(names)334 2249 y(NOTE:)g(each)h(parameter)e(can)i(itself)f(be)i(an)f
(expression,)d(not)j(merely)f(a)620 2362 y(column)h(name)f(or)h
(constant.)0 2669 y Fd(10.11.6)113 b(Example)38 b(Ro)m(w)f(Filters)191
2891 y Fe([)47 b(binary)f(&&)i(mag)f(<=)g(5.0])380 b(-)48
b(Extract)e(all)h(binary)f(stars)g(brighter)1766 3004
y(than)94 b(fifth)47 b(magnitude)e(\(note)h(that)1766
3117 y(the)h(initial)f(space)g(is)h(necessary)e(to)1766
3230 y(prevent)h(it)h(from)g(being)f(treated)g(as)h(a)1766
3343 y(binning)f(specification\))191 3569 y([#row)g(>=)h(125)g(&&)h
(#row)e(<=)h(175])142 b(-)48 b(Extract)e(row)h(numbers)e(125)i(through)
f(175)191 3794 y([IMAGE[4,5])f(.gt.)h(100])476 b(-)48
b(Extract)e(all)h(rows)f(that)h(have)g(the)1766 3907
y(\(4,5\))f(component)g(of)h(the)g(IMAGE)f(column)1766
4020 y(greater)g(than)g(100)191 4246 y([abs\(sin\(theta)e(*)j(#deg\)\))
f(<)i(0.5])e(-)i(Extract)e(all)h(rows)f(having)g(the)1766
4359 y(absolute)f(value)i(of)g(the)g(sine)g(of)g(theta)1766
4472 y(less)94 b(than)47 b(a)g(half)g(where)f(the)h(angles)1766
4585 y(are)g(tabulated)e(in)i(degrees)191 4811 y([SUM\()f(SPEC)h(>)g
(3*BACKGRND)e(\)>=1])94 b(-)48 b(Extract)e(all)h(rows)f(containing)f(a)
1766 4924 y(spectrum,)g(held)i(in)g(vector)f(column)1766
5036 y(SPEC,)g(with)h(at)g(least)f(one)h(value)g(3)1766
5149 y(times)f(greater)g(than)h(the)g(background)1766
5262 y(level)f(held)h(in)g(a)h(keyword,)d(BACKGRND)191
5488 y([VCOL=={1,4,2}])759 b(-)48 b(Extract)e(all)h(rows)f(whose)h
(vector)f(column)1766 5601 y(VCOL)h(contains)e(the)i(3-elements)e(1,)i
(4,)g(and)1766 5714 y(2.)p eop end
%%Page: 144 152
TeXDict begin 144 151 bop 0 299 a Fj(144)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)191
668 y Fe([@rowFilter.txt])711 b(-)48 b(Extract)e(rows)g(using)h(the)g
(expression)1766 781 y(contained)e(within)h(the)h(text)g(file)1766
894 y(rowFilter.txt)191 1120 y([gtifilter\(\)])855 b(-)48
b(Search)e(the)h(current)f(file)g(for)h(a)h(GTI)239 1233
y(extension,)92 b(filter)i(the)47 b(TIME)239 1346 y(column)f(in)h(the)g
(current)f(table,)g(using)239 1458 y(START/STOP)f(times)h(taken)g(from)
239 1571 y(columns)f(in)j(the)f(GTI)94 b(extension)191
1797 y([regfilter\("pow.reg"\)])423 b(-)48 b(Extract)e(rows)g(which)h
(have)f(a)i(coordinate)1766 1910 y(\(as)f(given)f(in)h(the)g(X)h(and)f
(Y)g(columns\))1766 2023 y(within)f(the)h(spatial)f(region)g(specified)
1766 2136 y(in)h(the)g(pow.reg)f(region)g(file.)191 2362
y([regfilter\("pow.reg",)c(Xs,)47 b(Ys\)])f(-)i(Same)f(as)g(above,)f
(except)g(that)h(the)1766 2475 y(Xs)g(and)g(Ys)g(columns)f(will)h(be)g
(used)f(to)1766 2588 y(determine)f(the)i(coordinate)e(of)i(each)1766
2700 y(row)g(in)g(the)g(table.)0 3027 y Ff(10.12)181
b(Binning)44 b(or)h(Histogramming)i(Sp)t(eci\014cation)0
3277 y Fj(The)22 b(optional)i(binning)e(sp)s(eci\014er)g(is)h(enclosed)
h(in)f(square)f(brac)m(k)m(ets)j(and)d(can)h(b)s(e)f(distinguished)g
(from)h(a)g(general)0 3390 y(ro)m(w)32 b(\014lter)h(sp)s(eci\014cation)
g(b)m(y)f(the)h(fact)g(that)g(it)g(b)s(egins)f(with)g(the)g(k)m(eyw)m
(ord)h('bin')f(not)h(immediately)g(follo)m(w)m(ed)0 3503
y(b)m(y)41 b(an)f(equals)i(sign.)72 b(When)41 b(binning)e(is)i(sp)s
(eci\014ed,)i(a)e(temp)s(orary)g(N-dimensional)g(FITS)f(primary)g(arra)
m(y)0 3615 y(is)j(created)h(b)m(y)f(computing)h(the)f(histogram)h(of)f
(the)g(v)-5 b(alues)44 b(in)e(the)i(sp)s(eci\014ed)e(columns)h(of)g(a)h
(FITS)e(table)0 3728 y(extension.)f(After)30 b(the)f(histogram)h(is)g
(computed)f(the)h(input)e(FITS)h(\014le)h(con)m(taining)h(the)e(table)i
(is)e(then)g(closed)0 3841 y(and)34 b(the)h(temp)s(orary)f(FITS)g
(primary)g(arra)m(y)h(is)g(op)s(ened)f(and)g(passed)g(to)h(the)g
(application)h(program.)54 b(Th)m(us,)0 3954 y(the)39
b(application)h(program)f(nev)m(er)g(sees)g(the)g(original)h(FITS)e
(table)i(and)e(only)h(sees)h(the)f(image)h(in)e(the)h(new)0
4067 y(temp)s(orary)32 b(\014le)h(\(whic)m(h)g(has)f(no)h(additional)g
(extensions\).)49 b(Ob)m(viously)-8 b(,)34 b(the)f(application)h
(program)e(m)m(ust)h(b)s(e)0 4180 y(exp)s(ecting)e(to)g(op)s(en)f(a)h
(FITS)e(image)j(and)e(not)g(a)h(FITS)f(table)h(in)f(this)g(case.)0
4340 y(The)g(data)h(t)m(yp)s(e)f(of)h(the)f(FITS)g(histogram)g(image)i
(ma)m(y)f(b)s(e)f(sp)s(eci\014ed)f(b)m(y)h(app)s(ending)f('b')h(\(for)h
(8-bit)g(b)m(yte\),)g('i')0 4453 y(\(for)g(16-bit)g(in)m(tegers\),)h
('j')f(\(for)g(32-bit)g(in)m(teger\),)i('r')d(\(for)h(32-bit)g
(\015oating)h(p)s(oin)m(ts\),)e(or)h('d')f(\(for)h(64-bit)g(double)0
4566 y(precision)j(\015oating)i(p)s(oin)m(t\))e(to)h(the)g('bin')f(k)m
(eyw)m(ord)h(\(e.g.)54 b('[binr)33 b(X]')i(creates)h(a)f(real)g
(\015oating)g(p)s(oin)m(t)f(image\).)0 4679 y(If)g(the)i(data)f(t)m(yp)
s(e)g(is)g(not)h(explicitly)g(sp)s(eci\014ed)e(then)h(a)g(32-bit)i(in)m
(teger)f(image)g(will)f(b)s(e)g(created)h(b)m(y)e(default,)0
4792 y(unless)24 b(the)i(w)m(eigh)m(ting)g(option)g(is)f(also)h(sp)s
(eci\014ed)e(in)h(whic)m(h)g(case)h(the)f(image)i(will)e(ha)m(v)m(e)h
(a)g(32-bit)g(\015oating)g(p)s(oin)m(t)0 4905 y(data)31
b(t)m(yp)s(e)g(b)m(y)f(default.)0 5065 y(The)24 b(histogram)g(image)i
(ma)m(y)f(ha)m(v)m(e)g(from)f(1)g(to)h(4)g(dimensions)e(\(axes\),)k
(dep)s(ending)c(on)h(the)g(n)m(um)m(b)s(er)f(of)h(columns)0
5178 y(that)31 b(are)g(sp)s(eci\014ed.)40 b(The)30 b(general)h(form)f
(of)g(the)h(binning)e(sp)s(eci\014cation)i(is:)48 5389
y Fe([bin{bijrd})92 b(Xcol=min:max:binsize,)42 b(Ycol=)47
b(...,)f(Zcol=...,)f(Tcol=...;)h(weight])0 5601 y Fj(in)39
b(whic)m(h)g(up)f(to)i(4)g(columns,)h(eac)m(h)f(corresp)s(onding)e(to)i
(an)g(axis)f(of)h(the)f(image,)k(are)d(listed.)67 b(The)39
b(column)0 5714 y(names)27 b(are)h(case)h(insensitiv)m(e,)g(and)e(the)h
(column)f(n)m(um)m(b)s(er)f(ma)m(y)i(b)s(e)f(giv)m(en)h(instead)g(of)g
(the)g(name,)g(preceded)f(b)m(y)p eop end
%%Page: 145 153
TeXDict begin 145 152 bop 0 299 a Fh(10.12.)113 b(BINNING)32
b(OR)e(HISTOGRAMMING)g(SPECIFICA)-8 b(TION)1223 b Fj(145)0
555 y(a)32 b(p)s(ound)e(sign)i(\(e.g.,)i([bin)d(#4=1:512]\).)47
b(If)31 b(the)h(column)g(name)g(is)f(not)h(sp)s(eci\014ed,)g(then)f
(CFITSIO)g(will)h(\014rst)0 668 y(try)37 b(to)h(use)f(the)g('preferred)
f(column')i(as)f(sp)s(eci\014ed)g(b)m(y)g(the)g(CPREF)g(k)m(eyw)m(ord)h
(if)f(it)g(exists)h(\(e.g.,)j('CPREF)0 781 y(=)i('DETX,DETY'\),)h
(otherwise)g(column)f(names)g('X',)h('Y',)g('Z',)f(and)f('T')i(will)f
(b)s(e)f(assumed)h(for)g(eac)m(h)h(of)0 894 y(the)37
b(4)h(axes,)i(resp)s(ectiv)m(ely)-8 b(.)62 b(In)37 b(cases)h(where)e
(the)i(column)f(name)g(could)g(b)s(e)f(confused)h(with)g(an)g
(arithmetic)0 1007 y(expression,)30 b(enclose)i(the)f(column)f(name)g
(in)g(paren)m(theses)h(to)g(force)g(the)f(name)h(to)g(b)s(e)f(in)m
(terpreted)g(literally)-8 b(.)0 1167 y(Eac)m(h)33 b(column)f(name)g(ma)
m(y)h(b)s(e)f(follo)m(w)m(ed)h(b)m(y)g(an)f(equals)g(sign)h(and)e(then)
h(the)g(lo)m(w)m(er)i(and)e(upp)s(er)e(range)i(of)h(the)0
1280 y(histogram,)f(and)e(the)h(size)h(of)f(the)g(histogram)h(bins,)e
(separated)h(b)m(y)g(colons.)43 b(Spaces)31 b(are)g(allo)m(w)m(ed)i(b)s
(efore)e(and)0 1393 y(after)e(the)g(equals)g(sign)f(but)g(not)h(within)
f(the)h('min:max:binsize')g(string.)40 b(The)29 b(min,)f(max)h(and)f
(binsize)h(v)-5 b(alues)0 1506 y(ma)m(y)32 b(b)s(e)e(in)m(teger)i(or)f
(\015oating)h(p)s(oin)m(t)f(n)m(um)m(b)s(ers,)f(or)h(they)g(ma)m(y)g(b)
s(e)g(the)g(names)g(of)g(k)m(eyw)m(ords)g(in)g(the)g(header)g(of)0
1619 y(the)g(table.)41 b(If)30 b(the)h(latter,)h(then)e(the)g(v)-5
b(alue)31 b(of)g(that)g(k)m(eyw)m(ord)f(is)h(substituted)f(in)m(to)h
(the)g(expression.)0 1779 y(Default)37 b(v)-5 b(alues)36
b(for)g(the)g(min,)h(max)f(and)g(binsize)g(quan)m(tities)h(will)f(b)s
(e)f(used)h(if)f(not)i(explicitly)g(giv)m(en)g(in)f(the)0
1892 y(binning)29 b(expression)h(as)h(sho)m(wn)f(in)g(these)h
(examples:)191 2118 y Fe([bin)47 b(x)g(=)g(:512:2])94
b(-)47 b(use)g(default)f(minimum)g(value)191 2231 y([bin)h(x)g(=)g
(1::2])190 b(-)47 b(use)g(default)f(maximum)g(value)191
2344 y([bin)h(x)g(=)g(1:512])142 b(-)47 b(use)g(default)f(bin)h(size)
191 2457 y([bin)g(x)g(=)g(1:])286 b(-)47 b(use)g(default)f(maximum)g
(value)g(and)h(bin)g(size)191 2570 y([bin)g(x)g(=)g(:512])190
b(-)47 b(use)g(default)f(minimum)g(value)g(and)h(bin)g(size)191
2682 y([bin)g(x)g(=)g(2])334 b(-)47 b(use)g(default)f(minimum)g(and)h
(maximum)f(values)191 2795 y([bin)h(x])524 b(-)47 b(use)g(default)f
(minimum,)g(maximum)g(and)g(bin)h(size)191 2908 y([bin)g(4])524
b(-)47 b(default)f(2-D)h(image,)f(bin)h(size)g(=)g(4)h(in)f(both)g
(axes)191 3021 y([bin])619 b(-)47 b(default)f(2-D)h(image)0
3247 y Fj(CFITSIO)31 b(will)i(use)f(the)h(v)-5 b(alue)33
b(of)g(the)g(TLMINn,)f(TLMAXn,)h(and)f(TDBINn)h(k)m(eyw)m(ords,)h(if)e
(they)h(exist,)h(for)0 3360 y(the)j(default)f(min,)i(max,)g(and)e
(binsize,)i(resp)s(ectiv)m(ely)-8 b(.)61 b(If)36 b(they)h(do)f(not)h
(exist)g(then)f(CFITSIO)f(will)i(use)f(the)0 3473 y(actual)d(minim)m
(um)e(and)h(maxim)m(um)g(v)-5 b(alues)32 b(in)g(the)g(column)f(for)h
(the)g(histogram)h(min)e(and)h(max)g(v)-5 b(alues.)45
b(The)0 3586 y(default)34 b(binsize)f(will)h(b)s(e)f(set)h(to)h(1,)g
(or)e(\(max)h(-)g(min\))f(/)h(10.,)i(whic)m(hev)m(er)e(is)g(smaller,)h
(so)e(that)i(the)e(histogram)0 3699 y(will)e(ha)m(v)m(e)g(at)g(least)h
(10)f(bins)f(along)h(eac)m(h)h(axis.)0 3859 y(A)41 b(shortcut)g
(notation)h(is)f(allo)m(w)m(ed)i(if)e(all)h(the)f(columns/axes)h(ha)m
(v)m(e)g(the)f(same)g(binning)f(sp)s(eci\014cation.)74
b(In)0 3972 y(this)33 b(case)g(all)h(the)f(column)f(names)h(ma)m(y)g(b)
s(e)f(listed)h(within)f(paren)m(theses,)i(follo)m(w)m(ed)h(b)m(y)d(the)
h(\(single\))h(binning)0 4085 y(sp)s(eci\014cation,)d(as)g(in:)191
4311 y Fe([bin)47 b(\(X,Y\)=1:512:2])191 4424 y([bin)g(\(X,Y\))f(=)h
(5])0 4650 y Fj(The)31 b(optional)i(w)m(eigh)m(ting)h(factor)e(is)g
(the)g(last)g(item)h(in)e(the)h(binning)f(sp)s(eci\014er)g(and,)h(if)f
(presen)m(t,)i(is)e(separated)0 4763 y(from)38 b(the)g(list)h(of)f
(columns)g(b)m(y)g(a)h(semi-colon.)65 b(As)39 b(the)f(histogram)h(is)f
(accum)m(ulated,)k(this)c(w)m(eigh)m(t)i(is)e(used)0
4876 y(to)d(incremen)m(ted)f(the)g(v)-5 b(alue)35 b(of)f(the)g
(appropriated)f(bin)h(in)f(the)h(histogram.)52 b(If)34
b(the)g(w)m(eigh)m(ting)i(factor)f(is)f(not)0 4989 y(sp)s(eci\014ed,)24
b(then)f(the)g(default)g(w)m(eigh)m(t)i(=)d(1)i(is)f(assumed.)37
b(The)23 b(w)m(eigh)m(ting)i(factor)f(ma)m(y)f(b)s(e)g(a)g(constan)m(t)
i(in)m(teger)f(or)0 5102 y(\015oating)30 b(p)s(oin)m(t)f(n)m(um)m(b)s
(er,)f(or)h(the)g(name)g(of)g(a)g(k)m(eyw)m(ord)h(con)m(taining)g(the)g
(w)m(eigh)m(ting)g(v)-5 b(alue.)41 b(Or)28 b(the)h(w)m(eigh)m(ting)0
5215 y(factor)g(ma)m(y)g(b)s(e)e(the)h(name)g(of)h(a)f(table)h(column)f
(in)g(whic)m(h)f(case)j(the)e(v)-5 b(alue)28 b(in)g(that)h(column,)f
(on)g(a)h(ro)m(w)f(b)m(y)g(ro)m(w)0 5328 y(basis,)i(will)h(b)s(e)f
(used.)0 5488 y(In)35 b(some)h(cases,)i(the)d(column)h(or)f(k)m(eyw)m
(ord)h(ma)m(y)g(giv)m(e)h(the)f(recipro)s(cal)g(of)g(the)g(actual)h(w)m
(eigh)m(t)g(v)-5 b(alue)36 b(that)g(is)0 5601 y(needed.)49
b(In)32 b(this)h(case,)i(precede)e(the)h(w)m(eigh)m(t)g(k)m(eyw)m(ord)g
(or)f(column)g(name)g(b)m(y)g(a)g(slash)g('/')h(to)g(tell)g(CFITSIO)0
5714 y(to)d(use)f(the)h(recipro)s(cal)g(of)f(the)h(v)-5
b(alue)31 b(when)e(constructing)i(the)g(histogram.)p
eop end
%%Page: 146 154
TeXDict begin 146 153 bop 0 299 a Fj(146)1528 b Fh(CHAPTER)29
b(10.)113 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fj(F)g(or)25 b(complex)g(or)f(commonly)g(used)g(histograms,)i
(one)e(can)h(also)g(place)g(its)f(description)g(in)m(to)h(a)g(text)g
(\014le)f(and)g(im-)0 668 y(p)s(ort)e(it)g(in)m(to)h(the)g(binning)e
(sp)s(eci\014cation)i(using)e(the)i(syn)m(tax)f([bin)g
(@\014lename.txt].)39 b(The)22 b(\014le's)g(con)m(ten)m(ts)i(can)e(ex-)
0 781 y(tend)h(o)m(v)m(er)i(m)m(ultiple)f(lines,)h(although)f(it)g(m)m
(ust)f(still)h(conform)f(to)h(the)g(no-spaces)g(rule)f(for)g(the)h
(min:max:binsize)0 894 y(syn)m(tax)35 b(and)f(eac)m(h)h(axis)g(sp)s
(eci\014cation)h(m)m(ust)e(still)h(b)s(e)f(comma-separated.)55
b(An)m(y)34 b(lines)h(in)f(the)h(external)g(text)0 1007
y(\014le)27 b(that)g(b)s(egin)g(with)f(2)i(slash)e(c)m(haracters)j
(\('//'\))g(will)e(b)s(e)f(ignored)h(and)f(ma)m(y)i(b)s(e)e(used)g(to)i
(add)e(commen)m(ts)i(in)m(to)0 1120 y(the)j(\014le.)0
1280 y(Examples:)191 1540 y Fe([bini)46 b(detx,)h(dety])762
b(-)47 b(2-D,)g(16-bit)f(integer)g(histogram)1861 1653
y(of)i(DETX)e(and)h(DETY)g(columns,)e(using)1861 1766
y(default)h(values)g(for)h(the)g(histogram)1861 1878
y(range)g(and)g(binsize)191 2104 y([bin)g(\(detx,)f(dety\)=16;)f
(/exposure])g(-)i(2-D,)g(32-bit)f(real)h(histogram)e(of)i(DETX)1861
2217 y(and)g(DETY)g(columns)f(with)g(a)i(bin)f(size)f(=)i(16)1861
2330 y(in)g(both)e(axes.)h(The)f(histogram)g(values)1861
2443 y(are)h(divided)f(by)h(the)g(EXPOSURE)f(keyword)1861
2556 y(value.)191 2782 y([bin)h(time=TSTART:TSTOP:0.1])280
b(-)47 b(1-D)g(lightcurve,)e(range)h(determined)f(by)1861
2895 y(the)i(TSTART)f(and)h(TSTOP)g(keywords,)1861 3008
y(with)g(0.1)g(unit)g(size)f(bins.)191 3233 y([bin)h(pha,)f
(time=8000.:8100.:0.1])90 b(-)47 b(2-D)g(image)g(using)f(default)g
(binning)1861 3346 y(of)i(the)e(PHA)h(column)f(for)h(the)g(X)h(axis,)
1861 3459 y(and)f(1000)g(bins)g(in)g(the)g(range)1861
3572 y(8000.)g(to)g(8100.)f(for)h(the)g(Y)h(axis.)191
3798 y([bin)f(@binFilter.txt])616 b(-)47 b(Use)g(the)g(contents)f(of)h
(the)g(text)f(file)1861 3911 y(binFilter.txt)f(for)h(the)h(binning)1861
4024 y(specifications.)p eop end
%%Page: 147 155
TeXDict begin 147 154 bop 0 1225 a Fg(Chapter)65 b(11)0
1687 y Fm(T)-19 b(emplate)76 b(Files)0 2180 y Fj(When)38
b(a)h(new)f(FITS)g(\014le)h(is)g(created)g(with)g(a)f(call)i(to)g
(\014ts)p 2101 2180 28 4 v 32 w(create)p 2369 2180 V
35 w(\014le,)g(the)f(name)g(of)g(a)g(template)h(\014le)e(ma)m(y)0
2293 y(b)s(e)h(supplied)g(in)h(paren)m(theses)g(immediately)h(follo)m
(wing)g(the)g(name)f(of)g(the)g(new)f(\014le)h(to)h(b)s(e)e(created.)71
b(This)0 2406 y(template)27 b(is)e(used)g(to)h(de\014ne)f(the)h
(structure)f(of)h(one)f(or)h(more)g(HDUs)g(in)f(the)h(new)f(\014le.)39
b(The)25 b(template)i(\014le)e(ma)m(y)0 2518 y(b)s(e)32
b(another)h(FITS)f(\014le,)i(in)f(whic)m(h)f(case)i(the)f(newly)g
(created)h(\014le)f(will)g(ha)m(v)m(e)h(exactly)h(the)e(same)g(k)m(eyw)
m(ords)g(in)0 2631 y(eac)m(h)25 b(HDU)g(as)g(in)f(the)g(template)i
(FITS)d(\014le,)j(but)d(all)j(the)e(data)h(units)e(will)i(b)s(e)f
(\014lled)g(with)f(zeros.)40 b(The)24 b(template)0 2744
y(\014le)i(ma)m(y)h(also)g(b)s(e)e(an)h(ASCI)s(I)e(text)j(\014le,)g
(where)f(eac)m(h)h(line)f(\(in)g(general\))i(describ)s(es)d(one)h(FITS)
f(k)m(eyw)m(ord)i(record.)0 2857 y(The)j(format)h(of)f(the)h(ASCI)s(I)e
(template)i(\014le)g(is)f(describ)s(ed)f(in)i(the)f(follo)m(wing)i
(sections.)0 3188 y Ff(11.1)136 b(Detailed)46 b(T)-11
b(emplate)46 b(Line)f(F)-11 b(ormat)0 3438 y Fj(The)30
b(format)h(of)f(eac)m(h)i(ASCI)s(I)c(template)k(line)f(closely)h(follo)
m(ws)f(the)g(format)g(of)f(a)h(FITS)f(k)m(eyw)m(ord)g(record:)95
3682 y Fe(KEYWORD)46 b(=)i(KEYVALUE)d(/)j(COMMENT)0 3926
y Fj(except)22 b(that)g(free)g(format)f(ma)m(y)h(b)s(e)f(used)f
(\(e.g.,)25 b(the)d(equals)f(sign)h(ma)m(y)f(app)s(ear)g(at)h(an)m(y)g
(p)s(osition)f(in)g(the)h(line\))g(and)0 4039 y(T)-8
b(AB)34 b(c)m(haracters)g(are)g(allo)m(w)m(ed)h(and)e(are)g(treated)h
(the)g(same)f(as)h(space)f(c)m(haracters.)51 b(The)33
b(KEYV)-10 b(ALUE)33 b(and)0 4152 y(COMMENT)d(\014elds)g(are)h
(optional.)43 b(The)30 b(equals)h(sign)f(c)m(haracter)j(is)d(also)i
(optional,)g(but)e(it)h(is)f(recommended)0 4264 y(that)42
b(it)f(b)s(e)g(included)f(for)h(clarit)m(y)-8 b(.)75
b(An)m(y)41 b(template)i(line)e(that)h(b)s(egins)f(with)f(the)i(p)s
(ound)d('#')i(c)m(haracter)i(is)0 4377 y(ignored)30 b(b)m(y)h(the)f
(template)i(parser)e(and)g(ma)m(y)h(b)s(e)e(use)h(to)h(insert)g(commen)
m(ts)g(in)m(to)g(the)g(template)h(\014le)e(itself.)0
4538 y(The)c(KEYW)m(ORD)g(name)g(\014eld)g(is)g(limited)h(to)g(8)f(c)m
(haracters)h(in)f(length)h(and)e(only)h(the)g(letters)i(A-Z,)e(digits)h
(0-9,)0 4650 y(and)h(the)g(h)m(yphen)f(and)h(underscore)g(c)m
(haracters)h(ma)m(y)g(b)s(e)f(used,)g(without)h(an)m(y)f(em)m(b)s
(edded)g(spaces.)40 b(Lo)m(w)m(ercase)0 4763 y(letters)22
b(in)f(the)h(template)g(k)m(eyw)m(ord)g(name)f(will)g(b)s(e)g(con)m(v)m
(erted)i(to)f(upp)s(ercase.)36 b(Leading)22 b(spaces)f(in)g(the)h
(template)0 4876 y(line)k(preceding)g(the)f(k)m(eyw)m(ord)h(name)g(are)
g(generally)h(ignored,)g(except)f(if)g(the)g(\014rst)f(8)h(c)m
(haracters)h(of)f(a)g(template)0 4989 y(line)f(are)h(all)g(blank,)g
(then)f(the)g(en)m(tire)h(line)g(is)f(treated)h(as)f(a)h(FITS)e(commen)
m(t)i(k)m(eyw)m(ord)g(\(with)f(a)h(blank)e(k)m(eyw)m(ord)0
5102 y(name\))31 b(and)f(is)g(copied)h(v)m(erbatim)g(in)m(to)g(the)g
(FITS)e(header.)0 5262 y(The)37 b(KEYV)-10 b(ALUE)37
b(\014eld)g(ma)m(y)h(ha)m(v)m(e)g(an)m(y)g(allo)m(w)m(ed)h(FITS)e(data)
h(t)m(yp)s(e:)54 b(c)m(haracter)39 b(string,)h(logical,)h(in)m(teger,)0
5375 y(real,)34 b(complex)f(in)m(teger,)i(or)d(complex)i(real.)47
b(The)32 b(c)m(haracter)j(string)d(v)-5 b(alues)33 b(need)f(not)h(b)s
(e)f(enclosed)h(in)f(single)0 5488 y(quote)d(c)m(haracters)h(unless)e
(they)g(are)h(necessary)g(to)g(distinguish)e(the)i(string)f(from)g(a)h
(di\013eren)m(t)g(data)g(t)m(yp)s(e)f(\(e.g.)0 5601 y(2.0)h(is)e(a)h
(real)h(but)e('2.0')i(is)f(a)g(string\).)40 b(The)27
b(k)m(eyw)m(ord)h(has)f(an)h(unde\014ned)d(\(n)m(ull\))j(v)-5
b(alue)29 b(if)e(the)h(template)h(record)0 5714 y(only)h(con)m(tains)i
(blanks)e(follo)m(wing)i(the)e("=")h(or)g(b)s(et)m(w)m(een)g(the)f("=")
h(and)f(the)g("/")i(commen)m(t)g(\014eld)d(delimiter.)1882
5942 y(147)p eop end
%%Page: 148 156
TeXDict begin 148 155 bop 0 299 a Fj(148)2250 b Fh(CHAPTER)29
b(11.)72 b(TEMPLA)-8 b(TE)30 b(FILES)0 555 y Fj(String)c(k)m(eyw)m(ord)
h(v)-5 b(alues)27 b(longer)g(than)f(68)h(c)m(haracters)h(\(the)f(maxim)
m(um)f(length)h(that)g(will)g(\014t)f(in)g(a)h(single)g(FITS)0
668 y(k)m(eyw)m(ord)41 b(record\))g(are)g(p)s(ermitted)f(using)g(the)h
(CFITSIO)e(long)i(string)g(con)m(v)m(en)m(tion.)74 b(They)40
b(can)h(either)g(b)s(e)0 781 y(sp)s(eci\014ed)28 b(as)i(a)f(single)h
(long)f(line)h(in)e(the)i(template,)h(or)e(b)m(y)f(using)h(m)m(ultiple)
h(lines)f(where)f(the)i(con)m(tin)m(uing)g(lines)0 894
y(con)m(tain)i(the)e('CONTINUE')g(k)m(eyw)m(ord,)h(as)g(in)f(this)g
(example:)95 1139 y Fe(LONGKEY)46 b(=)i('This)e(is)h(a)h(long)e(string)
g(value)h(that)f(is)i(contin&')95 1252 y(CONTINUE)94
b('ued)46 b(over)h(2)g(records')f(/)h(comment)f(field)h(goes)f(here)0
1497 y Fj(The)29 b(format)h(of)g(template)h(lines)e(with)h(CONTINUE)e
(k)m(eyw)m(ord)i(is)g(v)m(ery)g(strict:)41 b(3)30 b(spaces)g(m)m(ust)f
(follo)m(w)i(CON-)0 1610 y(TINUE)f(and)g(the)g(rest)h(of)f(the)h(line)g
(is)f(copied)h(v)m(erbatim)g(to)g(the)g(FITS)e(\014le.)0
1771 y(The)i(start)h(of)g(the)f(optional)i(COMMENT)e(\014eld)g(m)m(ust)
h(b)s(e)e(preceded)i(b)m(y)f("/",)i(whic)m(h)e(is)h(used)f(to)h
(separate)g(it)0 1883 y(from)e(the)g(k)m(eyw)m(ord)h(v)-5
b(alue)30 b(\014eld.)41 b(Exceptions)30 b(are)h(if)f(the)h(KEYW)m(ORD)g
(name)f(\014eld)g(con)m(tains)h(COMMENT,)0 1996 y(HISTOR)-8
b(Y,)30 b(CONTINUE,)g(or)g(if)g(the)h(\014rst)f(8)g(c)m(haracters)i(of)
f(the)f(template)i(line)f(are)g(blanks.)0 2157 y(More)c(than)f(one)h
(Header-Data)i(Unit)e(\(HDU\))g(ma)m(y)g(b)s(e)f(de\014ned)f(in)h(the)h
(template)h(\014le.)39 b(The)26 b(start)h(of)g(an)f(HDU)0
2269 y(de\014nition)k(is)g(denoted)h(with)f(a)h(SIMPLE)e(or)i(XTENSION)
e(template)j(line:)0 2430 y(1\))i(SIMPLE)f(b)s(egins)g(a)h(Primary)g
(HDU)g(de\014nition.)50 b(SIMPLE)33 b(ma)m(y)h(only)g(app)s(ear)f(as)h
(the)g(\014rst)f(k)m(eyw)m(ord)h(in)0 2543 y(the)e(template)i(\014le.)
45 b(If)32 b(the)g(template)i(\014le)e(b)s(egins)f(with)h(XTENSION)f
(instead)h(of)g(SIMPLE,)g(then)f(a)i(default)0 2655 y(empt)m(y)d
(Primary)e(HDU)i(is)g(created,)h(and)d(the)i(template)h(is)e(then)g
(assumed)f(to)i(de\014ne)f(the)h(k)m(eyw)m(ords)f(starting)0
2768 y(with)h(the)h(\014rst)e(extension)i(follo)m(wing)h(the)f(Primary)
f(HDU.)0 2928 y(2\))35 b(XTENSION)e(marks)g(the)i(b)s(eginning)e(of)h
(a)h(new)e(extension)i(HDU)f(de\014nition.)52 b(The)33
b(previous)h(HDU)h(will)0 3041 y(b)s(e)30 b(closed)h(at)g(this)f(p)s
(oin)m(t)h(and)e(pro)s(cessing)i(of)f(the)h(next)f(extension)h(b)s
(egins.)0 3373 y Ff(11.2)136 b(Auto-indexing)45 b(of)g(Keyw)l(ords)0
3623 y Fj(If)31 b(a)h(template)g(k)m(eyw)m(ord)g(name)f(ends)g(with)g
(a)g("#")h(c)m(haracter,)i(it)e(is)f(said)g(to)h(b)s(e)f
('auto-indexed'.)44 b(Eac)m(h)32 b("#")0 3736 y(c)m(haracter)i(will)f
(b)s(e)f(replaced)i(b)m(y)e(the)h(curren)m(t)g(in)m(teger)h(index)e(v)
-5 b(alue,)34 b(whic)m(h)f(gets)g(reset)h(=)e(1)h(at)h(the)e(start)i
(of)0 3849 y(eac)m(h)h(new)f(HDU)g(in)g(the)g(\014le)g(\(or)g(7)h(in)e
(the)h(sp)s(ecial)h(case)g(of)f(a)g(GR)m(OUP)h(de\014nition\).)51
b(The)33 b(FIRST)g(indexed)0 3962 y(k)m(eyw)m(ord)c(in)f(eac)m(h)h
(template)h(HDU)f(de\014nition)f(is)g(used)f(as)i(the)f('incremen)m
(tor';)j(eac)m(h)e(subsequen)m(t)f(o)s(ccurrence)0 4075
y(of)k(this)f(SAME)g(k)m(eyw)m(ord)h(will)g(cause)g(the)g(index)f(v)-5
b(alue)32 b(to)g(b)s(e)f(incremen)m(ted.)44 b(This)31
b(b)s(eha)m(vior)g(can)h(b)s(e)f(rather)0 4188 y(subtle,)d(as)g
(illustrated)h(in)e(the)h(follo)m(wing)h(examples)f(in)f(whic)m(h)h
(the)g(TTYPE)e(k)m(eyw)m(ord)i(is)g(the)g(incremen)m(tor)g(in)0
4300 y(b)s(oth)i(cases:)95 4546 y Fe(TTYPE#)47 b(=)g(TIME)95
4659 y(TFORM#)g(=)g(1D)95 4772 y(TTYPE#)g(=)g(RATE)95
4884 y(TFORM#)g(=)g(1E)0 5130 y Fj(will)26 b(create)i(TTYPE1,)e(TF)m
(ORM1,)i(TTYPE2,)f(and)e(TF)m(ORM2)i(k)m(eyw)m(ords.)40
b(But)26 b(if)g(the)g(template)h(lo)s(oks)f(lik)m(e,)95
5375 y Fe(TTYPE#)47 b(=)g(TIME)95 5488 y(TTYPE#)g(=)g(RATE)95
5601 y(TFORM#)g(=)g(1D)95 5714 y(TFORM#)g(=)g(1E)p eop
end
%%Page: 149 157
TeXDict begin 149 156 bop 0 299 a Fh(11.3.)73 b(TEMPLA)-8
b(TE)30 b(P)-8 b(ARSER)30 b(DIRECTIVES)1982 b Fj(149)0
555 y(this)31 b(results)f(in)h(a)g(FITS)f(\014les)h(with)f(TTYPE1,)h
(TTYPE2,)g(TF)m(ORM2,)h(and)e(TF)m(ORM2,)i(whic)m(h)f(is)g(probably)0
668 y(not)g(what)f(w)m(as)h(in)m(tended!)0 1000 y Ff(11.3)136
b(T)-11 b(emplate)45 b(P)l(arser)h(Directiv)l(es)0 1251
y Fj(In)29 b(addition)i(to)f(the)g(template)i(lines)e(whic)m(h)g
(de\014ne)f(individual)h(k)m(eyw)m(ords,)g(the)g(template)i(parser)d
(recognizes)0 1363 y(3)h(sp)s(ecial)h(directiv)m(es)g(whic)m(h)f(are)g
(eac)m(h)h(preceded)f(b)m(y)f(the)h(bac)m(kslash)h(c)m(haracter:)90
b Fe(\\include,)45 b(\\group)p Fj(,)29 b(and)48 1476
y Fe(\\end)p Fj(.)0 1637 y(The)37 b('include')h(directiv)m(e)i(m)m(ust)
d(b)s(e)h(follo)m(w)m(ed)h(b)m(y)f(a)g(\014lename.)63
b(It)38 b(forces)g(the)g(parser)f(to)i(temp)s(orarily)f(stop)0
1749 y(reading)d(the)g(curren)m(t)g(template)h(\014le)f(and)f(b)s(egin)
h(reading)g(the)g(include)f(\014le.)55 b(Once)35 b(the)g(parser)f(reac)
m(hes)i(the)0 1862 y(end)f(of)h(the)g(include)f(\014le)h(it)g(con)m
(tin)m(ues)g(parsing)g(the)f(curren)m(t)h(template)h(\014le.)56
b(Include)35 b(\014les)h(can)g(b)s(e)f(nested,)0 1975
y(and)30 b(HDU)h(de\014nitions)f(can)g(span)g(m)m(ultiple)h(template)h
(\014les.)0 2135 y(The)f(start)h(of)g(a)g(GR)m(OUP)h(de\014nition)e(is)
h(denoted)g(with)f(the)h('group')g(directiv)m(e,)h(and)f(the)f(end)h
(of)f(a)i(GR)m(OUP)0 2248 y(de\014nition)k(is)h(denoted)f(with)g(the)h
('end')f(directiv)m(e.)63 b(Eac)m(h)39 b(GR)m(OUP)e(con)m(tains)i(0)f
(or)f(more)h(mem)m(b)s(er)f(blo)s(c)m(ks)0 2361 y(\(HDUs)44
b(or)f(GR)m(OUPs\).)79 b(Mem)m(b)s(er)42 b(blo)s(c)m(ks)i(of)f(t)m(yp)s
(e)g(GR)m(OUP)g(can)g(con)m(tain)h(their)f(o)m(wn)g(mem)m(b)s(er)f(blo)
s(c)m(ks.)0 2474 y(The)32 b(GR)m(OUP)g(de\014nition)g(itself)h(o)s
(ccupies)g(one)f(FITS)g(\014le)g(HDU)h(of)f(sp)s(ecial)h(t)m(yp)s(e)f
(\(GR)m(OUP)h(HDU\),)h(so)e(if)h(a)0 2587 y(template)f(sp)s(eci\014es)e
(1)h(group)e(with)h(1)h(mem)m(b)s(er)f(HDU)h(lik)m(e:)0
2838 y Fe(\\group)0 2951 y(grpdescr)46 b(=)h('demo')0
3064 y(xtension)f(bintable)0 3177 y(#)h(this)g(bintable)f(has)h(0)g
(cols,)f(0)i(rows)0 3290 y(\\end)0 3541 y Fj(then)30
b(the)h(parser)e(creates)j(a)f(FITS)f(\014le)g(with)g(3)h(HDUs)g(:)0
3792 y Fe(1\))47 b(dummy)g(PHDU)0 3905 y(2\))g(GROUP)g(HDU)f(\(has)h(1)
h(member,)d(which)i(is)g(bintable)e(in)j(HDU)f(number)f(3\))0
4018 y(3\))h(bintable)f(\(member)g(of)h(GROUP)f(in)h(HDU)g(number)f
(2\))0 4269 y Fj(T)-8 b(ec)m(hnically)32 b(sp)s(eaking,)e(the)f(GR)m
(OUP)i(HDU)f(is)g(a)g(BINT)-8 b(ABLE)30 b(with)g(6)g(columns.)40
b(Applications)31 b(can)f(de\014ne)0 4382 y(additional)23
b(columns)f(in)f(a)i(GR)m(OUP)f(HDU)h(using)f(TF)m(ORMn)f(and)h(TTYPEn)
f(\(where)g(n)h(is)g(7,)i(8,)h(....\))39 b(k)m(eyw)m(ords)0
4494 y(or)30 b(their)h(auto-indexing)g(equiv)-5 b(alen)m(ts.)0
4655 y(F)d(or)26 b(a)f(more)g(complicated)h(example)f(of)g(a)h
(template)g(\014le)f(using)f(the)h(group)f(directiv)m(es,)k(lo)s(ok)d
(at)g(the)g(sample.tpl)0 4767 y(\014le)30 b(that)h(is)g(included)e(in)i
(the)f(CFITSIO)f(distribution.)0 5100 y Ff(11.4)136 b(F)-11
b(ormal)45 b(T)-11 b(emplate)46 b(Syn)l(tax)0 5350 y
Fj(The)30 b(template)i(syn)m(tax)f(can)f(formally)h(b)s(e)f(de\014ned)f
(as)i(follo)m(ws:)191 5601 y Fe(TEMPLATE)45 b(=)j(BLOCK)e([)i(BLOCK)e
(...)h(])p eop end
%%Page: 150 158
TeXDict begin 150 157 bop 0 299 a Fj(150)2250 b Fh(CHAPTER)29
b(11.)72 b(TEMPLA)-8 b(TE)30 b(FILES)334 555 y Fe(BLOCK)46
b(=)i({)f(HDU)g(|)h(GROUP)e(})334 781 y(GROUP)g(=)i(\\GROUP)e([)h
(BLOCK)g(...)g(])g(\\END)430 1007 y(HDU)f(=)i(XTENSION)d([)j(LINE)f
(...)f(])i({)f(XTENSION)f(|)h(\\GROUP)f(|)i(\\END)f(|)g(EOF)g(})382
1233 y(LINE)f(=)i([)f(KEYWORD)f([)i(=)f(])h(])f([)g(VALUE)g(])g([)h(/)f
(COMMENT)f(])191 1458 y(X)h(...)238 b(-)48 b(X)f(can)g(be)g(present)f
(1)h(or)h(more)e(times)191 1571 y({)h(X)h(|)f(Y)h(})f(-)h(X)f(or)g(Y)
191 1684 y([)g(X)h(])238 b(-)48 b(X)f(is)g(optional)0
1937 y Fj(A)m(t)34 b(the)f(topmost)g(lev)m(el,)i(the)e(template)i
(de\014nes)c(1)j(or)e(more)h(template)h(blo)s(c)m(ks.)49
b(Blo)s(c)m(ks)34 b(can)f(b)s(e)f(either)h(HDU)0 2050
y(\(Header)27 b(Data)h(Unit\))g(or)e(a)h(GR)m(OUP)-8
b(.)28 b(F)-8 b(or)27 b(eac)m(h)g(blo)s(c)m(k)g(the)g(parser)f(creates)
i(1)f(\(or)g(more)f(for)h(GR)m(OUPs\))g(FITS)0 2163 y(\014le)j(HDUs.)0
2495 y Ff(11.5)136 b(Errors)0 2745 y Fj(In)24 b(general)h(the)f(\014ts)
p 692 2745 28 4 v 33 w(execute)p 1019 2745 V 34 w(template\(\))i
(function)e(tries)h(to)g(b)s(e)f(as)g(atomic)i(as)f(p)s(ossible,)g(so)f
(either)h(ev)m(erything)0 2858 y(is)f(done)g(or)g(nothing)f(is)h(done.)
39 b(If)23 b(an)h(error)f(o)s(ccurs)h(during)f(parsing)g(of)h(the)g
(template,)j(\014ts)p 3125 2858 V 33 w(execute)p 3452
2858 V 34 w(template\(\))0 2971 y(will)k(\(try)g(to\))h(delete)g(the)f
(top)g(lev)m(el)h(BLOCK)e(\(with)h(all)g(its)h(c)m(hildren)e(if)h(an)m
(y\))g(in)g(whic)m(h)f(the)h(error)f(o)s(ccurred,)0 3084
y(then)g(it)h(will)g(stop)f(reading)h(the)f(template)i(\014le)e(and)g
(it)h(will)g(return)e(with)h(an)g(error.)0 3417 y Ff(11.6)136
b(Examples)0 3667 y Fj(1.)54 b(This)34 b(template)i(\014le)f(will)g
(create)h(a)f(200)h(x)e(300)i(pixel)f(image,)j(with)c(4-b)m(yte)i(in)m
(teger)g(pixel)f(v)-5 b(alues,)36 b(in)f(the)0 3780 y(primary)29
b(HDU:)95 4032 y Fe(SIMPLE)47 b(=)g(T)95 4145 y(BITPIX)g(=)g(32)95
4258 y(NAXIS)g(=)g(2)239 b(/)47 b(number)f(of)h(dimensions)95
4371 y(NAXIS1)g(=)g(100)95 b(/)47 b(length)f(of)h(first)g(axis)95
4484 y(NAXIS2)g(=)g(200)95 b(/)47 b(length)f(of)h(second)f(axis)95
4597 y(OBJECT)h(=)g(NGC)g(253)g(/)g(name)g(of)g(observed)f(object)0
4850 y Fj(The)35 b(allo)m(w)m(ed)i(v)-5 b(alues)36 b(of)f(BITPIX)g(are)
h(8,)h(16,)h(32,)g(-32,)g(or)d(-64,)j(represen)m(ting,)f(resp)s(ectiv)m
(ely)-8 b(,)39 b(8-bit)d(in)m(teger,)0 4962 y(16-bit)c(in)m(teger,)g
(32-bit)f(in)m(teger,)h(32-bit)g(\015oating)f(p)s(oin)m(t,)g(or)f(64)h
(bit)g(\015oating)g(p)s(oin)m(t)f(pixels.)0 5123 y(2.)39
b(T)-8 b(o)23 b(create)h(a)f(FITS)e(table,)26 b(the)c(template)i
(\014rst)e(needs)g(to)i(include)e(XTENSION)g(=)g(T)-8
b(ABLE)23 b(or)f(BINT)-8 b(ABLE)0 5235 y(to)31 b(de\014ne)e(whether)g
(it)h(is)g(an)f(ASCI)s(I)g(or)g(binary)g(table,)i(and)f(NAXIS2)g(to)g
(de\014ne)f(the)h(n)m(um)m(b)s(er)f(of)h(ro)m(ws)f(in)h(the)0
5348 y(table.)50 b(Tw)m(o)34 b(template)g(lines)g(are)g(then)f(needed)f
(to)i(de\014ne)f(the)g(name)h(\(TTYPEn\))e(and)h(FITS)g(data)h(format)0
5461 y(\(TF)m(ORMn\))d(of)f(the)h(columns,)f(as)h(in)f(this)g(example:)
95 5714 y Fe(xtension)46 b(=)h(bintable)p eop end
%%Page: 151 159
TeXDict begin 151 158 bop 0 299 a Fh(11.6.)73 b(EXAMPLES)2993
b Fj(151)95 555 y Fe(naxis2)47 b(=)g(40)95 668 y(ttype#)g(=)g(Name)95
781 y(tform#)g(=)g(10a)95 894 y(ttype#)g(=)g(Npoints)95
1007 y(tform#)g(=)g(j)95 1120 y(ttype#)g(=)g(Rate)95
1233 y(tunit#)g(=)g(counts/s)95 1346 y(tform#)g(=)g(e)0
1605 y Fj(The)26 b(ab)s(o)m(v)m(e)j(example)e(de\014nes)f(a)i(n)m(ull)f
(primary)f(arra)m(y)h(follo)m(w)m(ed)i(b)m(y)e(a)g(40-ro)m(w)h(binary)e
(table)i(extension)g(with)f(3)0 1718 y(columns)h(called)h('Name',)h
('Np)s(oin)m(ts',)f(and)f('Rate',)i(with)e(data)h(formats)f(of)g('10A')
i(\(ASCI)s(I)d(c)m(haracter)i(string\),)0 1831 y('1J')k(\(in)m(teger\))
i(and)d('1E')i(\(\015oating)f(p)s(oin)m(t\),)h(resp)s(ectiv)m(ely)-8
b(.)50 b(Note)34 b(that)f(the)g(other)g(required)f(FITS)g(k)m(eyw)m
(ords)0 1944 y(\(BITPIX,)37 b(NAXIS,)g(NAXIS1,)h(PCOUNT,)e(GCOUNT,)h
(TFIELDS,)f(and)g(END\))h(do)g(not)g(need)f(to)h(b)s(e)f(ex-)0
2057 y(plicitly)j(de\014ned)d(in)i(the)f(template)i(b)s(ecause)f(their)
g(v)-5 b(alues)38 b(can)g(b)s(e)f(inferred)f(from)i(the)f(other)h(k)m
(eyw)m(ords)g(in)0 2170 y(the)d(template.)55 b(This)34
b(example)i(also)g(illustrates)f(that)h(the)f(templates)h(are)f
(generally)h(case-insensitiv)m(e)h(\(the)0 2283 y(k)m(eyw)m(ord)29
b(names)g(and)g(TF)m(ORMn)f(v)-5 b(alues)30 b(are)f(con)m(v)m(erted)i
(to)e(upp)s(er-case)g(in)f(the)h(FITS)g(\014le\))g(and)f(that)i(string)
0 2396 y(k)m(eyw)m(ord)h(v)-5 b(alues)31 b(generally)g(do)f(not)h(need)
f(to)h(b)s(e)f(enclosed)h(in)f(quotes.)p eop end
%%Page: 152 160
TeXDict begin 152 159 bop 0 299 a Fj(152)2250 b Fh(CHAPTER)29
b(11.)72 b(TEMPLA)-8 b(TE)30 b(FILES)p eop end
%%Page: 153 161
TeXDict begin 153 160 bop 0 1225 a Fg(Chapter)65 b(12)0
1687 y Fm(Lo)6 b(cal)78 b(FITS)e(Con)-6 b(v)g(en)g(tions)0
2180 y Fj(CFITSIO)25 b(supp)s(orts)g(sev)m(eral)j(lo)s(cal)f(FITS)f
(con)m(v)m(en)m(tions)j(whic)m(h)d(are)h(not)g(de\014ned)e(in)h(the)h
(o\016cial)h(NOST)e(FITS)0 2293 y(standard)k(and)g(whic)m(h)h(are)g
(not)g(necessarily)g(recognized)h(or)f(supp)s(orted)e(b)m(y)i(other)g
(FITS)f(soft)m(w)m(are)i(pac)m(k)-5 b(ages.)0 2406 y(Programmers)36
b(should)f(b)s(e)g(cautious)i(ab)s(out)e(using)h(these)g(features,)i
(esp)s(ecially)f(if)f(the)g(FITS)f(\014les)h(that)h(are)0
2518 y(pro)s(duced)31 b(are)i(exp)s(ected)g(to)g(b)s(e)f(pro)s(cessed)g
(b)m(y)h(other)f(soft)m(w)m(are)i(systems)f(whic)m(h)f(do)h(not)f(use)h
(the)f(CFITSIO)0 2631 y(in)m(terface.)0 2990 y Ff(12.1)136
b(64-Bit)45 b(Long)g(In)l(tegers)0 3246 y Fj(CFITSIO)37
b(supp)s(orts)g(reading)i(and)f(writing)h(FITS)f(images)i(or)f(table)h
(columns)e(con)m(taining)i(64-bit)h(in)m(teger)0 3359
y(data)26 b(v)-5 b(alues.)40 b(Supp)s(ort)23 b(for)i(64-bit)i(in)m
(tegers)g(w)m(as)f(added)e(to)j(the)e(o\016cial)i(FITS)e(Standard)f(in)
i(Decem)m(b)s(er)g(2005.)0 3472 y(FITS)g(64-bit)i(images)g(ha)m(v)m(e)g
(BITPIX)e(=)h(64,)h(and)e(the)h(64-bit)h(binary)e(table)i(columns)f(ha)
m(v)m(e)h(TF)m(ORMn)e(=)h('K'.)0 3584 y(CFITSIO)35 b(also)i(supp)s
(orts)e(the)i('Q')f(v)-5 b(ariable-length)38 b(arra)m(y)f(table)h
(column)e(format)h(whic)m(h)f(is)g(analogous)i(to)0 3697
y(the)31 b('P')f(column)g(format)h(except)g(that)g(the)g(arra)m(y)g
(descriptor)f(is)h(stored)f(as)h(a)f(pair)h(of)f(64-bit)i(in)m(tegers.)
0 3858 y(F)-8 b(or)33 b(the)f(con)m(v)m(enience)i(of)f(C)e
(programmers,)h(the)h(\014tsio.h)f(include)g(\014le)g(de\014nes)f
(\(with)h(a)h(t)m(yp)s(edef)f(statemen)m(t\))0 3970 y(the)39
b('LONGLONG')g(datat)m(yp)s(e)h(to)f(b)s(e)f(equiv)-5
b(alen)m(t)40 b(to)f(an)g(appropriate)g(64-bit)h(in)m(teger)g(datat)m
(yp)s(e)f(on)g(eac)m(h)0 4083 y(platform.)g(Since)27
b(there)f(is)g(curren)m(tly)g(no)g(univ)m(ersal)h(standard)e(for)h(the)
g(name)g(of)h(the)f(64-bit)h(in)m(teger)h(datat)m(yp)s(e)0
4196 y(\(it)33 b(migh)m(t)f(b)s(e)f(de\014ned)g(as)h('long)g(long',)i
('long',)f(or)f(')p 1832 4196 28 4 v 1865 4196 V 66 w(in)m(t64')h(dep)s
(ending)d(on)i(the)g(platform\))g(C)g(programmers)0 4309
y(ma)m(y)24 b(prefer)f(to)i(use)e(the)h('LONGLONG')h(datat)m(yp)s(e)f
(when)f(declaring)i(or)e(allo)s(cating)j(64-bit)f(in)m(teger)h(quan)m
(tities)0 4422 y(when)33 b(writing)h(co)s(de)g(whic)m(h)f(needs)h(to)h
(run)d(on)i(m)m(ultiple)g(platforms.)52 b(Note)35 b(that)f(CFITSIO)f
(will)h(implicitly)0 4535 y(con)m(v)m(ert)h(the)e(datat)m(yp)s(e)h
(when)f(reading)g(or)g(writing)h(FITS)e(64-bit)j(in)m(teger)f(images)h
(and)d(columns)h(with)g(data)0 4648 y(arra)m(ys)40 b(of)h(a)f
(di\013eren)m(t)h(in)m(teger)g(or)f(\015oating)h(p)s(oin)m(t)f(datat)m
(yp)s(e,)k(but)c(there)g(is)g(an)g(increased)g(risk)g(of)g(loss)h(of)0
4761 y(n)m(umerical)31 b(precision)f(or)h(n)m(umerical)g(o)m(v)m
(er\015o)m(w)h(in)e(this)g(case.)0 5120 y Ff(12.2)136
b(Long)44 b(String)i(Keyw)l(ord)f(V)-11 b(alues.)0 5375
y Fj(The)43 b(length)i(of)f(a)g(standard)g(FITS)f(string)h(k)m(eyw)m
(ord)g(is)g(limited)h(to)g(68)f(c)m(haracters)i(b)s(ecause)e(it)g(m)m
(ust)g(\014t)0 5488 y(en)m(tirely)35 b(within)e(a)h(single)h(FITS)e
(header)g(k)m(eyw)m(ord)i(record.)50 b(In)33 b(some)i(instances)f(it)g
(is)g(necessary)g(to)h(enco)s(de)0 5601 y(strings)29
b(longer)i(than)e(this)g(limit,)i(so)f(CFITSIO)e(supp)s(orts)g(a)h(lo)s
(cal)i(con)m(v)m(en)m(tion)h(in)d(whic)m(h)h(the)f(string)h(v)-5
b(alue)30 b(is)0 5714 y(con)m(tin)m(ued)36 b(o)m(v)m(er)g(m)m(ultiple)f
(k)m(eyw)m(ords.)55 b(This)34 b(con)m(tin)m(uation)i(con)m(v)m(en)m
(tion)h(uses)e(an)f(amp)s(ersand)g(c)m(haracter)i(at)1882
5942 y(153)p eop end
%%Page: 154 162
TeXDict begin 154 161 bop 0 299 a Fj(154)1741 b Fh(CHAPTER)30
b(12.)112 b(LOCAL)29 b(FITS)h(CONVENTIONS)0 555 y Fj(the)c(end)f(of)h
(eac)m(h)g(substring)f(to)h(indicate)h(that)f(it)h(is)e(con)m(tin)m
(ued)i(on)e(the)h(next)g(k)m(eyw)m(ord,)h(and)e(the)h(con)m(tin)m
(uation)0 668 y(k)m(eyw)m(ords)40 b(all)h(ha)m(v)m(e)g(the)f(name)g
(CONTINUE)f(without)h(an)g(equal)g(sign)g(in)g(column)g(9.)69
b(The)40 b(string)f(v)-5 b(alue)0 781 y(ma)m(y)33 b(b)s(e)f(con)m(tin)m
(ued)h(in)g(this)f(w)m(a)m(y)h(o)m(v)m(er)h(as)f(man)m(y)g(additional)g
(CONTINUE)f(k)m(eyw)m(ords)h(as)f(is)h(required.)46 b(The)0
894 y(follo)m(wing)37 b(lines)e(illustrate)h(this)f(con)m(tin)m(uation)
i(con)m(v)m(en)m(tion)h(whic)m(h)c(is)i(used)e(in)h(the)g(v)-5
b(alue)36 b(of)f(the)g(STRKEY)0 1007 y(k)m(eyw)m(ord:)0
1297 y Fe(LONGSTRN=)45 b('OGIP)i(1.0')189 b(/)48 b(The)f(OGIP)f(Long)h
(String)f(Convention)f(may)i(be)g(used.)0 1410 y(STRKEY)94
b(=)47 b('This)g(is)g(a)g(very)g(long)g(string)f(keyword&')93
b(/)47 b(Optional)f(Comment)0 1523 y(CONTINUE)93 b(')48
b(value)e(that)h(is)g(continued)e(over)i(3)g(keywords)f(in)h(the)g(&)95
b(')0 1636 y(CONTINUE)e('FITS)47 b(header.')e(/)j(This)e(is)h(another)f
(optional)g(comment.)0 1926 y Fj(It)29 b(is)g(recommended)f(that)h(the)
g(LONGSTRN)f(k)m(eyw)m(ord,)i(as)f(sho)m(wn)f(here,)h(alw)m(a)m(ys)i(b)
s(e)d(included)g(in)g(an)m(y)h(HDU)0 2039 y(that)i(uses)f(this)g
(longstring)h(con)m(v)m(en)m(tion)i(as)e(a)f(w)m(arning)h(to)g(an)m(y)g
(soft)m(w)m(are)g(that)g(m)m(ust)g(read)f(the)h(k)m(eyw)m(ords.)41
b(A)0 2152 y(routine)d(called)g(\014ts)p 712 2152 28
4 v 33 w(write)p 947 2152 V 33 w(k)m(ey)p 1113 2152 V
33 w(longw)m(arn)g(has)f(b)s(een)g(pro)m(vided)g(in)h(CFITSIO)d(to)k
(write)e(this)h(k)m(eyw)m(ord)g(if)f(it)0 2265 y(do)s(es)30
b(not)h(already)g(exist.)0 2425 y(This)f(long)h(string)f(con)m(v)m(en)m
(tion)i(is)f(supp)s(orted)d(b)m(y)j(the)f(follo)m(wing)i(CFITSIO)d
(routines:)191 2716 y Fe(fits_write_key_longstr)89 b(-)48
b(write)e(a)i(long)e(string)g(keyword)g(value)191 2829
y(fits_insert_key_longstr)41 b(-)48 b(insert)e(a)h(long)g(string)f
(keyword)g(value)191 2942 y(fits_modify_key_longstr)41
b(-)48 b(modify)e(a)h(long)g(string)f(keyword)g(value)191
3054 y(fits_update_key_longstr)41 b(-)48 b(modify)e(a)h(long)g(string)f
(keyword)g(value)191 3167 y(fits_read_key_longstr)137
b(-)48 b(read)94 b(a)48 b(long)e(string)g(keyword)g(value)191
3280 y(fits_delete_key)425 b(-)48 b(delete)e(a)h(keyword)0
3571 y Fj(The)36 b(\014ts)p 320 3571 V 32 w(read)p 524
3571 V 33 w(k)m(ey)p 690 3571 V 34 w(longstr)g(routine)h(is)f(unique)f
(among)i(all)h(the)e(CFITSIO)f(routines)h(in)g(that)h(it)g(in)m
(ternally)0 3684 y(allo)s(cates)f(memory)d(for)h(the)f(long)h(string)g
(v)-5 b(alue;)36 b(all)e(the)g(other)g(CFITSIO)e(routines)h(that)h
(deal)g(with)g(arra)m(ys)0 3797 y(require)39 b(that)h(the)g(calling)h
(program)e(pre-allo)s(cate)j(adequate)e(space)g(to)g(hold)f(the)h(arra)
m(y)g(of)f(data.)69 b(Conse-)0 3909 y(quen)m(tly)-8 b(,)31
b(programs)f(whic)m(h)g(use)g(the)g(\014ts)p 1443 3909
V 32 w(read)p 1647 3909 V 33 w(k)m(ey)p 1813 3909 V 34
w(longstr)g(routine)g(m)m(ust)g(b)s(e)g(careful)g(to)h(free)g(the)f
(allo)s(cated)0 4022 y(memory)g(for)g(the)h(string)f(when)g(it)h(is)f
(no)g(longer)h(needed.)0 4183 y(The)f(follo)m(wing)i(2)e(routines)h
(also)g(ha)m(v)m(e)h(limited)f(supp)s(ort)d(for)i(this)h(long)g(string)
f(con)m(v)m(en)m(tion,)286 4473 y Fe(fits_modify_key_str)43
b(-)k(modify)f(an)i(existing)d(string)h(keyword)g(value)286
4586 y(fits_update_key_str)d(-)k(update)f(a)i(string)e(keyword)g(value)
0 4876 y Fj(in)24 b(that)h(they)f(will)h(correctly)g(o)m(v)m(erwrite)h
(an)e(existing)h(long)g(string)f(v)-5 b(alue,)27 b(but)c(the)h(new)g
(string)g(v)-5 b(alue)25 b(is)f(limited)0 4989 y(to)31
b(a)g(maxim)m(um)f(of)h(68)g(c)m(haracters)h(in)e(length.)0
5149 y(The)f(more)h(commonly)h(used)e(CFITSIO)f(routines)i(to)g(write)g
(string)g(v)-5 b(alued)30 b(k)m(eyw)m(ords)g(\(\014ts)p
3254 5149 V 33 w(up)s(date)p 3563 5149 V 32 w(k)m(ey)h(and)0
5262 y(\014ts)p 127 5262 V 32 w(write)p 361 5262 V 33
w(k)m(ey\))j(do)e(not)h(supp)s(ort)d(this)i(long)h(string)g(con)m(v)m
(en)m(tion)h(and)e(only)g(supp)s(ort)f(strings)h(up)f(to)i(68)g(c)m
(har-)0 5375 y(acters)g(in)f(length.)48 b(This)31 b(has)h(b)s(een)g
(done)g(delib)s(erately)h(to)g(prev)m(en)m(t)g(programs)f(from)g(inadv)
m(erten)m(tly)i(writing)0 5488 y(k)m(eyw)m(ords)25 b(using)f(this)h
(non-standard)e(con)m(v)m(en)m(tion)k(without)e(the)g(explicit)h(in)m
(ten)m(t)g(of)f(the)f(programmer)h(or)f(user.)0 5601
y(The)36 b(\014ts)p 320 5601 V 32 w(write)p 554 5601
V 33 w(k)m(ey)p 720 5601 V 34 w(longstr)h(routine)f(m)m(ust)h(b)s(e)f
(called)i(instead)e(to)i(write)e(long)h(strings.)59 b(This)36
b(routine)h(can)0 5714 y(also)31 b(b)s(e)f(used)g(to)h(write)f
(ordinary)g(string)g(v)-5 b(alues)31 b(less)g(than)f(68)h(c)m
(haracters)h(in)e(length.)p eop end
%%Page: 155 163
TeXDict begin 155 162 bop 0 299 a Fh(12.3.)73 b(ARRA)-8
b(YS)30 b(OF)h(FIXED-LENGTH)g(STRINGS)e(IN)h(BINAR)-8
b(Y)32 b(T)-8 b(ABLES)871 b Fj(155)0 555 y Ff(12.3)136
b(Arra)l(ys)45 b(of)g(Fixed-Length)g(Strings)g(in)g(Binary)f(T)-11
b(ables)0 820 y Fj(CFITSIO)25 b(supp)s(orts)g(2)i(w)m(a)m(ys)g(to)g(sp)
s(ecify)f(that)i(a)f(c)m(haracter)h(column)e(in)g(a)h(binary)f(table)i
(con)m(tains)f(an)g(arra)m(y)g(of)0 933 y(\014xed-length)32
b(strings.)46 b(The)32 b(\014rst)f(w)m(a)m(y)-8 b(,)34
b(whic)m(h)e(is)g(o\016cially)i(supp)s(orted)c(b)m(y)i(the)h(FITS)e
(Standard)g(do)s(cumen)m(t,)0 1046 y(uses)38 b(the)g(TDIMn)g(k)m(eyw)m
(ord.)65 b(F)-8 b(or)39 b(example,)i(if)d(TF)m(ORMn)g(=)g('60A')h(and)f
(TDIMn)g(=)g('\(12,5\)')i(then)e(that)0 1159 y(column)30
b(will)h(b)s(e)f(in)m(terpreted)g(as)h(con)m(taining)h(an)e(arra)m(y)h
(of)g(5)f(strings,)h(eac)m(h)g(12)g(c)m(haracters)h(long.)0
1319 y(CFITSIO)j(also)j(supp)s(orts)c(a)j(lo)s(cal)h(con)m(v)m(en)m
(tion)h(for)d(the)h(format)g(of)g(the)f(TF)m(ORMn)h(k)m(eyw)m(ord)g(v)
-5 b(alue)37 b(of)g(the)0 1432 y(form)42 b('rAw')g(where)g('r')g(is)h
(an)f(in)m(teger)i(sp)s(ecifying)e(the)g(total)j(width)c(in)h(c)m
(haracters)i(of)f(the)f(column,)k(and)0 1545 y('w')36
b(is)g(an)g(in)m(teger)h(sp)s(ecifying)f(the)g(\(\014xed\))g(length)h
(of)f(an)g(individual)f(unit)h(string)f(within)h(the)g(v)m(ector.)59
b(F)-8 b(or)0 1658 y(example,)29 b(TF)m(ORM1)f(=)f('120A10')j(w)m(ould)
d(indicate)h(that)g(the)f(binary)g(table)h(column)f(is)g(120)i(c)m
(haracters)f(wide)0 1771 y(and)42 b(consists)h(of)f(12)h(10-c)m
(haracter)i(length)e(strings.)77 b(This)41 b(con)m(v)m(en)m(tion)k(is)d
(recognized)i(b)m(y)e(the)g(CFITSIO)0 1884 y(routines)26
b(that)h(read)e(or)h(write)h(strings)e(in)h(binary)f(tables.)40
b(The)26 b(Binary)g(T)-8 b(able)27 b(de\014nition)e(do)s(cumen)m(t)h
(sp)s(eci\014es)0 1996 y(that)i(other)f(optional)h(c)m(haracters)h(ma)m
(y)e(follo)m(w)i(the)e(data)h(t)m(yp)s(e)f(co)s(de)g(in)g(the)g(TF)m
(ORM)h(k)m(eyw)m(ord,)g(so)g(this)f(lo)s(cal)0 2109 y(con)m(v)m(en)m
(tion)f(is)d(in)h(compliance)h(with)e(the)h(FITS)e(standard)h(although)
h(other)g(FITS)f(readers)g(ma)m(y)h(not)g(recognize)0
2222 y(this)30 b(con)m(v)m(en)m(tion.)0 2382 y(The)25
b(Binary)h(T)-8 b(able)27 b(de\014nition)e(do)s(cumen)m(t)h(that)h(w)m
(as)f(appro)m(v)m(ed)g(b)m(y)g(the)g(IA)m(U)g(in)g(1994)i(con)m(tains)f
(an)e(app)s(endix)0 2495 y(describing)d(an)h(alternate)h(con)m(v)m(en)m
(tion)h(for)e(sp)s(ecifying)f(arra)m(ys)h(of)g(\014xed)f(or)h(v)-5
b(ariable)24 b(length)f(strings)f(in)h(a)g(binary)0 2608
y(table)35 b(c)m(haracter)g(column)f(\(with)g(the)h(form)e
('rA:SSTRw/nnn\)'.)50 b(This)33 b(app)s(endix)f(w)m(as)j(not)f
(o\016cially)i(v)m(oted)0 2721 y(on)30 b(b)m(y)h(the)f(IA)m(U)h(and)f
(hence)g(is)h(still)g(pro)m(visional.)42 b(CFITSIO)29
b(do)s(es)h(not)g(curren)m(tly)h(supp)s(ort)d(this)j(prop)s(osal.)0
3129 y Ff(12.4)136 b(Keyw)l(ord)45 b(Units)h(Strings)0
3394 y Fj(One)37 b(limitation)j(of)d(the)h(curren)m(t)g(FITS)e
(Standard)h(is)h(that)g(it)g(do)s(es)f(not)h(de\014ne)f(a)h(sp)s
(eci\014c)f(con)m(v)m(en)m(tion)j(for)0 3507 y(recording)30
b(the)g(ph)m(ysical)h(units)f(of)g(a)g(k)m(eyw)m(ord)h(v)-5
b(alue.)41 b(The)30 b(TUNITn)f(k)m(eyw)m(ord)h(can)g(b)s(e)g(used)f(to)
i(sp)s(ecify)f(the)0 3620 y(ph)m(ysical)36 b(units)f(of)g(the)h(v)-5
b(alues)36 b(in)f(a)g(table)i(column,)f(but)f(there)g(is)h(no)f
(analogous)i(con)m(v)m(en)m(tion)g(for)e(k)m(eyw)m(ord)0
3732 y(v)-5 b(alues.)42 b(The)30 b(commen)m(t)h(\014eld)g(of)f(the)h(k)
m(eyw)m(ord)g(is)g(often)g(used)f(for)g(this)g(purp)s(ose,)g(but)f(the)
i(units)f(are)h(usually)0 3845 y(not)g(sp)s(eci\014ed)e(in)h(a)h(w)m
(ell)g(de\014ned)f(format)g(that)h(FITS)f(readers)g(can)h(easily)g
(recognize)h(and)e(extract.)0 4006 y(T)-8 b(o)27 b(solv)m(e)i(this)d
(problem,)i(CFITSIO)d(uses)i(a)g(lo)s(cal)h(con)m(v)m(en)m(tion)h(in)e
(whic)m(h)f(the)i(k)m(eyw)m(ord)f(units)f(are)i(enclosed)f(in)0
4118 y(square)20 b(brac)m(k)m(ets)j(as)e(the)f(\014rst)g(tok)m(en)i(in)
f(the)f(k)m(eyw)m(ord)i(commen)m(t)f(\014eld;)j(more)d(sp)s
(eci\014cally)-8 b(,)24 b(the)d(op)s(ening)f(square)0
4231 y(brac)m(k)m(et)28 b(immediately)g(follo)m(ws)f(the)g(slash)f('/')
h(commen)m(t)h(\014eld)e(delimiter)h(and)f(a)g(single)h(space)g(c)m
(haracter.)41 b(The)0 4344 y(follo)m(wing)32 b(examples)f(illustrate)g
(k)m(eyw)m(ords)g(that)g(use)f(this)g(con)m(v)m(en)m(tion:)0
4667 y Fe(EXPOSURE=)713 b(1800.0)47 b(/)g([s])g(elapsed)f(exposure)f
(time)0 4780 y(V_HELIO)h(=)763 b(16.23)47 b(/)g([km)g(s**\(-1\)])e
(heliocentric)g(velocity)0 4893 y(LAMBDA)94 b(=)763 b(5400.)47
b(/)g([angstrom])e(central)h(wavelength)0 5005 y(FLUX)190
b(=)47 b(4.9033487787637465E-30)42 b(/)47 b([J/cm**2/s])e(average)h
(flux)0 5328 y Fj(In)28 b(general,)h(the)g(units)e(named)h(in)g(the)h
(IA)m(U\(1988\))i(St)m(yle)e(Guide)f(are)h(recommended,)f(with)g(the)h
(main)f(excep-)0 5441 y(tion)j(that)g(the)f(preferred)g(unit)f(for)i
(angle)g(is)f('deg')i(for)e(degrees.)0 5601 y(The)38
b(\014ts)p 322 5601 28 4 v 33 w(read)p 527 5601 V 33
w(k)m(ey)p 693 5601 V 33 w(unit)h(and)f(\014ts)p 1234
5601 V 32 w(write)p 1468 5601 V 33 w(k)m(ey)p 1634 5601
V 34 w(unit)g(routines)h(in)g(CFITSIO)e(read)i(and)f(write,)k(resp)s
(ectiv)m(ely)-8 b(,)0 5714 y(the)31 b(k)m(eyw)m(ord)f(unit)g(strings)h
(in)f(an)g(existing)h(k)m(eyw)m(ord.)p eop end
%%Page: 156 164
TeXDict begin 156 163 bop 0 299 a Fj(156)1741 b Fh(CHAPTER)30
b(12.)112 b(LOCAL)29 b(FITS)h(CONVENTIONS)0 555 y Ff(12.5)136
b(HIERAR)l(CH)46 b(Con)l(v)l(en)l(tion)g(for)f(Extended)h(Keyw)l(ord)f
(Names)0 805 y Fj(CFITSIO)c(supp)s(orts)g(the)i(HIERAR)m(CH)g(k)m(eyw)m
(ord)g(con)m(v)m(en)m(tion)i(whic)m(h)e(allo)m(ws)h(k)m(eyw)m(ord)f
(names)g(that)h(are)0 918 y(longer)34 b(then)e(8)i(c)m(haracters)g(and)
f(ma)m(y)h(con)m(tain)g(the)f(full)g(range)g(of)h(prin)m(table)f(ASCI)s
(I)e(text)j(c)m(haracters.)51 b(This)0 1031 y(con)m(v)m(en)m(tion)39
b(w)m(as)f(dev)m(elop)s(ed)f(at)h(the)f(Europ)s(ean)f(Southern)g
(Observ)-5 b(atory)37 b(\(ESO\))f(to)i(supp)s(ort)d(hierarc)m(hical)0
1144 y(FITS)30 b(k)m(eyw)m(ord)g(suc)m(h)h(as:)0 1395
y Fe(HIERARCH)46 b(ESO)g(INS)h(FOCU)g(POS)g(=)g(-0.00002500)e(/)j
(Focus)e(position)0 1646 y Fj(Basically)-8 b(,)55 b(this)47
b(con)m(v)m(en)m(tion)j(uses)d(the)h(FITS)f(k)m(eyw)m(ord)h('HIERAR)m
(CH')h(to)f(indicate)h(that)f(this)f(con)m(v)m(en-)0
1759 y(tion)e(is)f(b)s(eing)g(used,)j(then)d(the)g(actual)i(k)m(eyw)m
(ord)e(name)h(\()p Fe('ESO)i(INS)f(FOCU)h(POS')c Fj(in)h(this)g
(example\))h(b)s(e-)0 1872 y(gins)40 b(in)f(column)g(10)i(and)e(can)h
(con)m(tain)g(an)m(y)g(prin)m(table)g(ASCI)s(I)e(text)j(c)m(haracters,)
i(including)d(spaces.)68 b(The)0 1985 y(equals)44 b(sign)h(marks)e(the)
h(end)g(of)g(the)g(k)m(eyw)m(ord)h(name)f(and)f(is)i(follo)m(w)m(ed)g
(b)m(y)f(the)g(usual)g(v)-5 b(alue)45 b(and)e(com-)0
2098 y(men)m(t)31 b(\014elds)f(just)g(as)h(in)f(standard)g(FITS)g(k)m
(eyw)m(ords.)41 b(F)-8 b(urther)30 b(details)i(of)f(this)f(con)m(v)m
(en)m(tion)j(are)e(describ)s(ed)e(at)0 2211 y(h)m
(ttp://arcdev.hq.eso.org/dicb/dicd/dic-1-1.4.)q(h)m(tml)36
b(\(searc)m(h)c(for)e(HIERAR)m(CH\).)0 2371 y(This)43
b(con)m(v)m(en)m(tion)k(allo)m(ws)f(a)e(m)m(uc)m(h)h(broader)e(range)i
(of)f(k)m(eyw)m(ord)h(names)f(than)h(is)f(allo)m(w)m(ed)i(b)m(y)e(the)h
(FITS)0 2484 y(Standard.)40 b(Here)30 b(are)h(more)g(examples)g(of)f
(suc)m(h)g(k)m(eyw)m(ords:)0 2735 y Fe(HIERARCH)46 b(LongKeyword)e(=)k
(47.5)e(/)i(Keyword)e(has)h(>)g(8)g(characters,)e(and)i(mixed)f(case)0
2848 y(HIERARCH)g(XTE$TEMP)f(=)j(98.6)e(/)i(Keyword)d(contains)h(the)h
('$')g(character)0 2961 y(HIERARCH)f(Earth)g(is)h(a)h(star)e(=)i(F)f(/)
h(Keyword)d(contains)h(embedded)f(spaces)0 3212 y Fj(CFITSIO)40
b(will)i(transparen)m(tly)g(read)g(and)f(write)g(these)i(k)m(eyw)m
(ords,)i(so)d(application)h(programs)e(do)g(not)h(in)0
3325 y(general)33 b(need)f(to)h(kno)m(w)f(an)m(ything)h(ab)s(out)f(the)
g(sp)s(eci\014c)g(implemen)m(tation)i(details)f(of)g(the)f(HIERAR)m(CH)
g(con-)0 3438 y(v)m(en)m(tion.)50 b(In)32 b(particular,)j(application)f
(programs)e(do)h(not)h(need)e(to)i(sp)s(ecify)f(the)g(`HIERAR)m(CH')h
(part)f(of)g(the)0 3551 y(k)m(eyw)m(ord)g(name)f(when)g(reading)g(or)g
(writing)h(k)m(eyw)m(ords)f(\(although)h(it)g(ma)m(y)g(b)s(e)f
(included)f(if)i(desired\).)46 b(When)0 3664 y(writing)35
b(a)g(k)m(eyw)m(ord,)h(CFITSIO)d(\014rst)h(c)m(hec)m(ks)i(to)f(see)g
(if)g(the)g(k)m(eyw)m(ord)g(name)f(is)h(legal)h(as)f(a)g(standard)f
(FITS)0 3776 y(k)m(eyw)m(ord)k(\(no)g(more)f(than)h(8)g(c)m(haracters)h
(long)f(and)f(con)m(taining)i(only)e(letters,)k(digits,)f(or)e(a)g(min)
m(us)e(sign)i(or)0 3889 y(underscore\).)68 b(If)39 b(so)h(it)g(writes)g
(it)g(as)f(a)h(standard)f(FITS)g(k)m(eyw)m(ord,)k(otherwise)d(it)g
(uses)f(the)h(hierarc)m(h)f(con-)0 4002 y(v)m(en)m(tion)34
b(to)f(write)g(the)f(k)m(eyw)m(ord.)48 b(The)32 b(maxim)m(um)g(k)m(eyw)
m(ord)h(name)f(length)h(is)g(67)g(c)m(haracters,)i(whic)m(h)d(lea)m(v)m
(es)0 4115 y(only)c(1)h(space)g(for)f(the)h(v)-5 b(alue)29
b(\014eld.)39 b(A)29 b(more)f(practical)i(limit)f(is)g(ab)s(out)f(40)h
(c)m(haracters,)i(whic)m(h)d(lea)m(v)m(es)i(enough)0
4228 y(ro)s(om)e(for)h(most)f(k)m(eyw)m(ord)h(v)-5 b(alues.)41
b(CFITSIO)27 b(returns)g(an)h(error)h(if)f(there)h(is)f(not)h(enough)f
(ro)s(om)h(for)f(b)s(oth)g(the)0 4341 y(k)m(eyw)m(ord)k(name)f(and)f
(the)i(k)m(eyw)m(ord)f(v)-5 b(alue)32 b(on)f(the)h(80-c)m(haracter)h
(card,)f(except)g(for)f(string-v)-5 b(alued)32 b(k)m(eyw)m(ords)0
4454 y(whic)m(h)h(are)g(simply)f(truncated)h(so)g(that)h(the)f(closing)
h(quote)g(c)m(haracter)g(falls)f(in)g(column)g(80.)49
b(In)32 b(the)h(curren)m(t)0 4567 y(implemen)m(tation,)e(CFITSIO)c
(preserv)m(es)i(the)g(case)h(of)f(the)g(letters)h(when)e(writing)h(the)
g(k)m(eyw)m(ord)g(name,)g(but)f(it)0 4680 y(is)d(case-insensitiv)m(e)i
(when)d(reading)h(or)g(searc)m(hing)h(for)f(a)g(k)m(eyw)m(ord.)40
b(The)24 b(curren)m(t)h(implemen)m(tation)h(allo)m(ws)h(an)m(y)0
4793 y(ASCI)s(I)i(text)j(c)m(haracter)h(\(ASCI)s(I)c(32)j(to)f(ASCI)s
(I)f(126\))i(in)f(the)g(k)m(eyw)m(ord)g(name)g(except)h(for)e(the)h
('=')g(c)m(haracter.)0 4906 y(A)f(space)h(is)g(also)g(required)f(on)g
(either)h(side)f(of)h(the)f(equal)h(sign.)0 5238 y Ff(12.6)136
b(Tile-Compressed)46 b(Image)g(F)-11 b(ormat)0 5488 y
Fj(CFITSIO)36 b(supp)s(orts)f(a)j(con)m(v)m(en)m(tion)i(for)d
(compressing)h(n-dimensional)f(images)h(and)f(storing)h(the)g
(resulting)0 5601 y(b)m(yte)i(stream)g(in)f(a)h(v)-5
b(ariable-length)41 b(column)e(in)g(a)h(FITS)f(binary)f(table.)69
b(The)39 b(general)i(principle)e(used)f(in)0 5714 y(this)c(con)m(v)m
(en)m(tion)j(is)d(to)h(\014rst)f(divide)g(the)h(n-dimensional)f(image)i
(in)m(to)f(a)g(rectangular)g(grid)f(of)h(subimages)f(or)p
eop end
%%Page: 157 165
TeXDict begin 157 164 bop 0 299 a Fh(12.6.)73 b(TILE-COMPRESSED)28
b(IMA)m(GE)j(F)m(ORMA)-8 b(T)1838 b Fj(157)0 555 y(`tiles'.)57
b(Eac)m(h)35 b(tile)i(is)e(then)g(compressed)g(as)g(a)h(con)m(tin)m
(uous)g(blo)s(c)m(k)f(of)h(data,)h(and)e(the)g(resulting)g(compressed)0
668 y(b)m(yte)i(stream)h(is)f(stored)g(in)f(a)h(ro)m(w)g(of)g(a)h(v)-5
b(ariable)37 b(length)g(column)g(in)g(a)g(FITS)f(binary)g(table.)61
b(By)37 b(dividing)0 781 y(the)j(image)g(in)m(to)g(tiles)h(it)f(is)f
(generally)i(p)s(ossible)e(to)h(extract)h(and)d(uncompress)g
(subsections)i(of)f(the)h(image)0 894 y(without)d(ha)m(ving)h(to)g
(uncompress)e(the)h(whole)g(image.)62 b(The)37 b(default)g(tiling)h
(pattern)g(treats)g(eac)m(h)g(ro)m(w)f(of)h(a)0 1007
y(2-dimensional)e(image)g(\(or)f(higher)f(dimensional)h(cub)s(e\))g(as)
g(a)g(tile,)j(suc)m(h)c(that)i(eac)m(h)g(tile)g(con)m(tains)g(NAXIS1)0
1120 y(pixels)29 b(\(except)h(the)f(default)g(with)g(the)g(HCOMPRESS)e
(algorithm)j(is)f(to)h(compress)f(the)g(whole)g(2D)h(image)g(as)0
1233 y(a)35 b(single)g(tile\).)56 b(An)m(y)34 b(other)h(rectangular)h
(tiling)g(pattern)f(ma)m(y)g(also)h(b)s(e)e(de\014ned.)52
b(In)34 b(the)h(case)h(of)f(relativ)m(ely)0 1346 y(small)25
b(images)h(it)f(ma)m(y)g(b)s(e)f(su\016cien)m(t)h(to)h(compress)e(the)h
(en)m(tire)g(image)h(as)f(a)g(single)h(tile,)h(resulting)d(in)h(an)f
(output)0 1458 y(binary)29 b(table)i(with)f(1)g(ro)m(w.)41
b(In)29 b(the)h(case)h(of)f(3-dimensional)h(data)g(cub)s(es,)e(it)i(ma)
m(y)f(b)s(e)f(adv)-5 b(an)m(tageous)32 b(to)f(treat)0
1571 y(eac)m(h)i(plane)f(of)g(the)g(cub)s(e)f(as)h(a)g(separate)h(tile)
g(if)f(application)h(soft)m(w)m(are)h(t)m(ypically)f(needs)f(to)g
(access)i(the)e(cub)s(e)0 1684 y(on)e(a)h(plane)f(b)m(y)h(plane)f
(basis.)0 1844 y(See)41 b(section)g(5.6)h(\\Image)f(Compression")f(for)
g(more)h(information)g(on)f(using)g(this)g(tile-compressed)i(image)0
1957 y(format.)p eop end
%%Page: 158 166
TeXDict begin 158 165 bop 0 299 a Fj(158)1741 b Fh(CHAPTER)30
b(12.)112 b(LOCAL)29 b(FITS)h(CONVENTIONS)p eop end
%%Page: 159 167
TeXDict begin 159 166 bop 0 1225 a Fg(Chapter)65 b(13)0
1687 y Fm(Optimizing)76 b(Programs)0 2180 y Fj(CFITSIO)22
b(has)h(b)s(een)f(carefully)i(designed)f(to)h(obtain)g(the)f(highest)h
(p)s(ossible)e(sp)s(eed)h(when)f(reading)h(and)g(writing)0
2293 y(FITS)33 b(\014les.)51 b(In)33 b(order)h(to)g(ac)m(hiev)m(e)i
(the)e(b)s(est)g(p)s(erformance,)g(ho)m(w)m(ev)m(er,)i(application)g
(programmers)d(m)m(ust)h(b)s(e)0 2406 y(careful)24 b(to)h(call)g(the)f
(CFITSIO)f(routines)g(appropriately)i(and)e(in)h(an)f(e\016cien)m(t)j
(sequence;)h(inappropriate)c(usage)0 2518 y(of)31 b(CFITSIO)d(routines)
j(can)f(greatly)i(slo)m(w)f(do)m(wn)f(the)h(execution)g(sp)s(eed)f(of)g
(a)h(program.)0 2679 y(The)f(maxim)m(um)h(p)s(ossible)f(I/O)h(sp)s(eed)
f(of)h(CFITSIO)e(dep)s(ends)g(of)i(course)g(on)f(the)h(t)m(yp)s(e)g(of)
g(computer)g(system)0 2791 y(that)g(it)f(is)g(running)e(on.)41
b(As)30 b(a)g(rough)g(guide,)g(the)g(curren)m(t)g(generation)h(of)f(w)m
(orkstations)h(can)g(ac)m(hiev)m(e)h(sp)s(eeds)0 2904
y(of)j(2)g({)g(10)g(MB/s)h(when)e(reading)h(or)f(writing)h(FITS)f
(images)i(and)e(similar,)i(or)f(sligh)m(tly)h(slo)m(w)m(er)g(sp)s(eeds)
d(with)0 3017 y(FITS)c(binary)h(tables.)41 b(Reading)31
b(of)f(FITS)g(\014les)g(can)h(o)s(ccur)f(at)h(ev)m(en)f(higher)g(rates)
h(\(30MB/s)i(or)d(more\))h(if)f(the)0 3130 y(FITS)c(\014le)h(is)f
(still)i(cac)m(hed)g(in)e(system)h(memory)f(follo)m(wing)j(a)e
(previous)f(read)g(or)h(write)g(op)s(eration)g(on)g(the)g(same)0
3243 y(\014le.)44 b(T)-8 b(o)32 b(more)g(accurately)h(predict)e(the)h
(b)s(est)f(p)s(erformance)g(that)h(is)f(p)s(ossible)g(on)h(an)m(y)g
(particular)f(system,)i(a)0 3356 y(diagnostic)h(program)f(called)h
(\\sp)s(eed.c")f(is)g(included)f(with)h(the)g(CFITSIO)e(distribution)h
(whic)m(h)h(can)g(b)s(e)f(run)0 3469 y(to)f(appro)m(ximately)h(measure)
e(the)h(maxim)m(um)f(p)s(ossible)g(sp)s(eed)f(of)i(writing)f(and)g
(reading)h(a)f(test)i(FITS)d(\014le.)0 3629 y(The)k(follo)m(wing)h(2)g
(sections)g(pro)m(vide)g(some)f(bac)m(kground)g(on)h(ho)m(w)f(CFITSIO)f
(in)m(ternally)i(manages)g(the)f(data)0 3742 y(I/O)g(and)g(describ)s
(es)f(some)i(strategies)h(that)f(ma)m(y)g(b)s(e)e(used)h(to)h(optimize)
g(the)g(pro)s(cessing)f(sp)s(eed)f(of)h(soft)m(w)m(are)0
3855 y(that)e(uses)f(CFITSIO.)0 4271 y Ff(13.1)136 b(Ho)l(w)45
b(CFITSIO)f(Manages)i(Data)g(I/O)0 4538 y Fj(Man)m(y)22
b(CFITSIO)e(op)s(erations)i(in)m(v)m(olv)m(e)i(transferring)d(only)h(a)
g(small)g(n)m(um)m(b)s(er)f(of)h(b)m(ytes)g(to)g(or)g(from)f(the)h
(FITS)f(\014le)0 4650 y(\(e.g,)31 b(reading)e(a)g(k)m(eyw)m(ord,)h(or)f
(writing)g(a)g(ro)m(w)g(in)f(a)h(table\);)i(it)f(w)m(ould)e(b)s(e)g(v)m
(ery)i(ine\016cien)m(t)g(to)f(ph)m(ysically)h(read)0
4763 y(or)i(write)h(suc)m(h)f(small)g(blo)s(c)m(ks)h(of)f(data)h
(directly)g(in)f(the)g(FITS)g(\014le)g(on)g(disk,)h(therefore)f
(CFITSIO)f(main)m(tains)0 4876 y(a)38 b(set)g(of)g(in)m(ternal)h
(Input{Output)c(\(IO\))j(bu\013ers)f(in)g(RAM)h(memory)g(that)g(eac)m
(h)h(con)m(tain)g(one)f(FITS)f(blo)s(c)m(k)0 4989 y(\(2880)27
b(b)m(ytes\))f(of)f(data.)40 b(Whenev)m(er)25 b(CFITSIO)f(needs)g(to)i
(access)g(data)g(in)f(the)g(FITS)f(\014le,)j(it)e(\014rst)f(transfers)h
(the)0 5102 y(FITS)30 b(blo)s(c)m(k)h(con)m(taining)h(those)f(b)m(ytes)
g(in)m(to)g(one)g(of)f(the)h(IO)f(bu\013ers)f(in)h(memory)-8
b(.)42 b(The)30 b(next)g(time)h(CFITSIO)0 5215 y(needs)36
b(to)g(access)i(b)m(ytes)e(in)g(the)g(same)h(blo)s(c)m(k)f(it)h(can)f
(then)g(go)h(to)f(the)h(fast)f(IO)f(bu\013er)g(rather)h(than)g(using)g
(a)0 5328 y(m)m(uc)m(h)c(slo)m(w)m(er)i(system)e(disk)g(access)h
(routine.)46 b(The)32 b(n)m(um)m(b)s(er)f(of)h(a)m(v)-5
b(ailable)35 b(IO)d(bu\013ers)f(is)h(determined)g(b)m(y)g(the)0
5441 y(NIOBUF)f(parameter)g(\(in)f(\014tsio2.h\))h(and)f(is)h(curren)m
(tly)f(set)h(to)g(40)g(b)m(y)g(default.)0 5601 y(Whenev)m(er)24
b(CFITSIO)f(reads)g(or)h(writes)g(data)g(it)h(\014rst)e(c)m(hec)m(ks)i
(to)g(see)f(if)g(that)g(blo)s(c)m(k)h(of)f(the)g(FITS)f(\014le)g(is)h
(already)0 5714 y(loaded)33 b(in)m(to)g(one)f(of)g(the)g(IO)g
(bu\013ers.)44 b(If)32 b(not,)h(and)e(if)h(there)g(is)g(an)g(empt)m(y)h
(IO)e(bu\013er)g(a)m(v)-5 b(ailable,)35 b(then)d(it)h(will)1882
5942 y(159)p eop end
%%Page: 160 168
TeXDict begin 160 167 bop 0 299 a Fj(160)1876 b Fh(CHAPTER)30
b(13.)112 b(OPTIMIZING)29 b(PR)m(OGRAMS)0 555 y Fj(load)k(that)h(blo)s
(c)m(k)f(in)m(to)g(the)g(IO)g(bu\013er)e(\(when)h(reading)h(a)g(FITS)f
(\014le\))h(or)g(will)g(initialize)i(a)e(new)f(blo)s(c)m(k)i(\(when)0
668 y(writing)j(to)h(a)g(FITS)f(\014le\).)62 b(If)37
b(all)h(the)g(IO)e(bu\013ers)h(are)g(already)h(full,)h(it)f(m)m(ust)g
(decide)f(whic)m(h)g(one)h(to)g(reuse)0 781 y(\(generally)c(the)f(one)g
(that)g(has)f(b)s(een)g(accessed)i(least)f(recen)m(tly\),)i(and)d
(\015ush)f(the)i(con)m(ten)m(ts)h(bac)m(k)g(to)f(disk)f(if)g(it)0
894 y(has)e(b)s(een)g(mo)s(di\014ed)f(b)s(efore)h(loading)h(the)g(new)f
(blo)s(c)m(k.)0 1054 y(The)g(one)g(ma)5 b(jor)30 b(exception)i(to)f
(the)f(ab)s(o)m(v)m(e)h(pro)s(cess)f(o)s(ccurs)g(whenev)m(er)g(a)g
(large)i(con)m(tiguous)f(set)g(of)f(b)m(ytes)h(are)0
1167 y(accessed,)37 b(as)d(migh)m(t)i(o)s(ccur)e(when)f(reading)i(or)f
(writing)g(a)h(FITS)f(image.)54 b(In)34 b(this)g(case)h(CFITSIO)e(b)m
(ypasses)0 1280 y(the)i(in)m(ternal)h(IO)f(bu\013ers)f(and)g(simply)h
(reads)g(or)g(writes)h(the)f(desired)g(b)m(ytes)g(directly)h(in)f(the)g
(disk)g(\014le)g(with)0 1393 y(a)i(single)g(call)g(to)g(a)g(lo)m(w-lev)
m(el)i(\014le)d(read)g(or)h(write)f(routine.)58 b(The)36
b(minim)m(um)g(threshold)f(for)h(the)h(n)m(um)m(b)s(er)e(of)0
1506 y(b)m(ytes)40 b(to)g(read)f(or)g(write)g(this)h(w)m(a)m(y)g(is)f
(set)h(b)m(y)f(the)g(MINDIRECT)g(parameter)h(and)e(is)i(curren)m(tly)f
(set)h(to)g(3)0 1619 y(FITS)28 b(blo)s(c)m(ks)g(=)g(8640)i(b)m(ytes.)41
b(This)28 b(is)g(the)g(most)h(e\016cien)m(t)h(w)m(a)m(y)f(to)g(read)g
(or)f(write)h(large)g(c)m(h)m(unks)f(of)g(data)i(and)0
1732 y(can)37 b(ac)m(hiev)m(e)i(IO)d(transfer)g(rates)h(of)g(5)g({)g
(10MB/s)i(or)d(greater.)61 b(Note)38 b(that)f(this)g(fast)g(direct)g
(IO)f(pro)s(cess)g(is)0 1844 y(not)29 b(applicable)g(when)e(accessing)j
(columns)f(of)f(data)h(in)f(a)h(FITS)f(table)h(b)s(ecause)g(the)f(b)m
(ytes)h(are)g(generally)h(not)0 1957 y(con)m(tiguous)g(since)f(they)g
(are)h(in)m(terlea)m(v)m(ed)h(b)m(y)e(the)g(other)g(columns)g(of)g
(data)g(in)g(the)g(table.)41 b(This)28 b(explains)h(wh)m(y)0
2070 y(the)i(sp)s(eed)e(for)h(accessing)i(FITS)e(tables)h(is)f
(generally)i(slo)m(w)m(er)f(than)g(accessing)g(FITS)f(images.)0
2230 y(Giv)m(en)i(this)g(bac)m(kground)f(information,)h(the)g(general)g
(strategy)h(for)e(e\016cien)m(tly)i(accessing)g(FITS)e(\014les)g
(should)0 2343 y(b)s(e)e(apparen)m(t:)41 b(when)28 b(dealing)j(with)e
(FITS)g(images,)i(read)e(or)h(write)g(large)g(c)m(h)m(unks)g(of)g(data)
g(at)g(a)g(time)g(so)g(that)0 2456 y(the)25 b(direct)g(IO)f(mec)m
(hanism)g(will)h(b)s(e)f(in)m(v)m(ok)m(ed;)k(when)c(accessing)i(FITS)e
(headers)g(or)g(FITS)g(tables,)j(on)d(the)h(other)0 2569
y(hand,)35 b(once)g(a)g(particular)g(FITS)f(blo)s(c)m(k)i(has)e(b)s
(een)g(loading)i(in)m(to)f(one)g(of)g(the)g(IO)f(bu\013ers,)h(try)g(to)
g(access)h(all)0 2682 y(the)30 b(needed)g(information)g(in)g(that)g
(blo)s(c)m(k)h(b)s(efore)f(it)g(gets)h(\015ushed)d(out)j(of)f(the)g(IO)
f(bu\013er.)40 b(It)30 b(is)g(imp)s(ortan)m(t)g(to)0
2795 y(a)m(v)m(oid)e(the)f(situation)g(where)f(the)h(same)g(FITS)e(blo)
s(c)m(k)i(is)g(b)s(eing)f(read)g(then)g(\015ushed)f(from)h(a)h(IO)f
(bu\013er)f(m)m(ultiple)0 2908 y(times.)0 3068 y(The)30
b(follo)m(wing)i(section)f(giv)m(es)h(more)e(sp)s(eci\014c)h
(suggestions)g(for)f(optimizing)i(the)e(use)g(of)h(CFITSIO.)0
3411 y Ff(13.2)136 b(Optimization)46 b(Strategies)0 3663
y Fj(1.)d(Because)32 b(the)f(data)g(in)g(FITS)f(\014les)h(is)g(alw)m(a)
m(ys)h(stored)f(in)g("big-endian")h(b)m(yte)f(order,)g(where)f(the)h
(\014rst)f(b)m(yte)0 3776 y(of)g(n)m(umeric)h(v)-5 b(alues)30
b(con)m(tains)i(the)e(most)h(signi\014can)m(t)g(bits)f(and)g(the)g
(last)i(b)m(yte)e(con)m(tains)i(the)e(least)i(signi\014can)m(t)0
3889 y(bits,)e(CFITSIO)f(m)m(ust)h(sw)m(ap)g(the)g(order)f(of)h(the)h
(b)m(ytes)f(when)f(reading)h(or)g(writing)g(FITS)g(\014les)g(when)f
(running)0 4002 y(on)k(little-endian)i(mac)m(hines)f(\(e.g.,)i(Lin)m
(ux)d(and)g(Microsoft)i(Windo)m(ws)e(op)s(erating)h(systems)g(running)d
(on)j(PCs)0 4115 y(with)c(x86)h(CPUs\).)0 4275 y(On)i(fairly)h(new)f
(CPUs)g(that)i(supp)s(ort)d("SSSE3")h(mac)m(hine)h(instructions)g
(\(e.g.,)i(starting)f(with)e(In)m(tel)i(Core)f(2)0 4388
y(CPUs)21 b(in)h(2007,)j(and)d(in)f(AMD)i(CPUs)e(b)s(eginning)g(in)h
(2011\))i(signi\014can)m(tly)f(faster)f(4-b)m(yte)h(and)e(8-b)m(yte)i
(sw)m(apping)0 4501 y(algorithms)k(are)g(a)m(v)-5 b(ailable.)42
b(These)26 b(faster)h(b)m(yte)g(sw)m(apping)f(functions)g(are)h(not)g
(used)e(b)m(y)i(default)f(in)g(CFITSIO)0 4614 y(\(b)s(ecause)c(of)f
(the)h(p)s(oten)m(tial)g(co)s(de)g(p)s(ortablilit)m(y)g(issues\),)i
(but)c(users)h(can)g(enable)h(them)f(on)h(supp)s(orted)d(platforms)0
4727 y(b)m(y)38 b(adding)f(the)h(appropriate)f(compiler)i(\015ags)e
(\(-mssse3)i(with)e(gcc)i(or)f(icc)g(on)g(lin)m(ux\))g(when)e
(compiling)j(the)0 4840 y(sw)m(appro)s(c.c)30 b(source)g(\014le,)g
(whic)m(h)g(will)g(allo)m(w)i(the)e(compiler)g(to)h(generate)h(co)s(de)
e(using)f(the)h(SSSE3)f(instruction)0 4952 y(set.)41
b(A)28 b(con)m(v)m(enien)m(t)i(w)m(a)m(y)f(to)g(do)g(this)f(is)g(to)h
(con\014gure)f(the)g(CFITSIO)f(library)h(with)g(the)g(follo)m(wing)i
(command:)95 5220 y Fe(>)96 b(./configure)44 b(--enable-ssse3)0
5488 y Fj(Note,)37 b(ho)m(w)m(ev)m(er,)h(that)d(a)g(binary)f
(executable)j(\014le)e(that)g(is)g(created)h(using)e(these)h(faster)g
(functions)g(will)g(only)0 5601 y(run)c(on)h(mac)m(hines)g(that)h(supp)
s(ort)d(the)i(SSSE3)f(mac)m(hine)i(instructions.)45 b(It)33
b(will)f(crash)g(on)g(mac)m(hines)g(that)h(do)0 5714
y(not)e(supp)s(ort)d(them.)p eop end
%%Page: 161 169
TeXDict begin 161 168 bop 0 299 a Fh(13.2.)73 b(OPTIMIZA)-8
b(TION)29 b(STRA)-8 b(TEGIES)2186 b Fj(161)0 555 y(F)-8
b(or)36 b(faster)f(2-b)m(yte)i(sw)m(aps)e(on)g(virtually)g(all)h
(x86-64)h(CPUs)e(\(ev)m(en)h(those)g(that)f(do)g(not)h(supp)s(ort)d
(SSSE3\),)j(a)0 668 y(v)-5 b(arian)m(t)26 b(using)e(only)g(SSE2)g
(instructions)h(exists.)39 b(SSE2)24 b(is)h(enabled)f(b)m(y)h(default)g
(on)f(x86)p 3066 668 28 4 v 34 w(64)h(CPUs)f(with)h(64-bit)0
781 y(op)s(erating)30 b(systems)f(\(and)g(is)g(also)i(automatically)h
(enabled)d(b)m(y)g(the)g({enable-ssse3)i(\015ag\).)41
b(When)30 b(running)d(on)0 894 y(x86)p 143 894 V 34 w(64)k(CPUs)g(with)
f(32-bit)i(op)s(erating)g(systems,)f(these)g(faster)h(2-b)m(yte)g(sw)m
(apping)f(algorithms)g(are)h(not)f(used)0 1007 y(b)m(y)f(default)h(in)f
(CFITSIO,)f(but)h(can)g(b)s(e)g(enabled)g(explicitly)i(with:)0
1233 y Fe(./configure)45 b(--enable-sse2)0 1460 y Fj(Preliminary)f
(testing)h(indicates)g(that)g(these)f(SSSE3)f(and)g(SSE2)g(based)h(b)m
(yte-sw)m(apping)h(algorithms)g(can)0 1573 y(b)s(o)s(ost)31
b(the)h(CFITSIO)e(p)s(erformance)h(when)f(reading)i(or)f(writing)h
(FITS)f(images)h(b)m(y)g(20\045)g(-)g(30\045)g(or)f(more.)45
b(It)0 1686 y(is)36 b(imp)s(ortan)m(t)g(to)g(note,)i(ho)m(w)m(ev)m(er,)
h(that)d(compiler)g(optimization)i(m)m(ust)e(b)s(e)f(turned)f(on)i
(\(e.g.,)j(b)m(y)d(using)f(the)0 1799 y(-O1)f(or)g(-O2)g(\015ags)g(in)g
(gcc\))h(when)e(building)g(programs)h(that)g(use)g(these)g(fast)g(b)m
(yte-sw)m(apping)h(algorithms)f(in)0 1912 y(order)d(to)h(reap)f(the)h
(full)f(b)s(ene\014t)g(of)g(the)h(SSSE3)e(and)h(SSE2)g(instructions;)h
(without)f(optimization,)j(the)e(co)s(de)0 2025 y(ma)m(y)f(actually)h
(run)d(slo)m(w)m(er)i(than)f(when)g(using)g(more)g(traditional)i(b)m
(yte-sw)m(apping)f(tec)m(hniques.)0 2185 y(2.)54 b(When)34
b(dealing)h(with)g(a)g(FITS)e(primary)h(arra)m(y)h(or)g(IMA)m(GE)g
(extension,)i(it)e(is)f(more)h(e\016cien)m(t)h(to)f(read)g(or)0
2298 y(write)c(large)g(c)m(h)m(unks)f(of)g(the)h(image)g(at)h(a)e(time)
h(\(at)h(least)f(3)g(FITS)f(blo)s(c)m(ks)g(=)g(8640)i(b)m(ytes\))f(so)g
(that)g(the)f(direct)0 2411 y(IO)j(mec)m(hanism)h(will)f(b)s(e)g(used)g
(as)g(describ)s(ed)g(in)g(the)g(previous)g(section.)51
b(Smaller)34 b(c)m(h)m(unks)f(of)g(data)h(are)g(read)0
2524 y(or)d(written)g(via)h(the)f(IO)f(bu\013ers,)g(whic)m(h)h(is)g
(somewhat)g(less)g(e\016cien)m(t)i(b)s(ecause)e(of)g(the)g(extra)h(cop)
m(y)f(op)s(eration)0 2636 y(and)26 b(additional)h(b)s(o)s(okk)m(eeping)
g(steps)g(that)g(are)g(required.)39 b(In)26 b(principle)g(it)h(is)g
(more)f(e\016cien)m(t)i(to)g(read)e(or)h(write)0 2749
y(as)i(big)g(an)g(arra)m(y)h(of)f(image)h(pixels)f(at)h(one)f(time)g
(as)h(p)s(ossible,)f(ho)m(w)m(ev)m(er,)h(if)f(the)h(arra)m(y)f(b)s
(ecomes)g(so)g(large)h(that)0 2862 y(the)i(op)s(erating)g(system)f
(cannot)h(store)g(it)g(all)h(in)e(RAM,)h(then)f(the)h(p)s(erformance)f
(ma)m(y)h(b)s(e)f(degraded)g(b)s(ecause)0 2975 y(of)g(the)f(increased)h
(sw)m(apping)f(of)g(virtual)h(memory)f(to)h(disk.)0 3135
y(3.)51 b(When)33 b(dealing)i(with)e(FITS)g(tables,)j(the)e(most)g(imp)
s(ortan)m(t)g(e\016ciency)g(factor)h(in)e(the)h(soft)m(w)m(are)h
(design)f(is)0 3248 y(to)j(read)f(or)g(write)g(the)g(data)h(in)f(the)g
(FITS)g(\014le)g(in)g(a)g(single)h(pass)f(through)f(the)h(\014le.)58
b(An)36 b(example)h(of)f(p)s(o)s(or)0 3361 y(program)g(design)h(w)m
(ould)f(b)s(e)g(to)h(read)g(a)f(large,)k(3-column)d(table)g(b)m(y)g
(sequen)m(tially)h(reading)f(the)f(en)m(tire)i(\014rst)0
3474 y(column,)25 b(then)f(going)h(bac)m(k)f(to)h(read)e(the)h(2nd)g
(column,)h(and)e(\014nally)h(the)g(3rd)f(column;)j(this)e(ob)m(viously)
g(requires)0 3587 y(3)j(passes)g(through)g(the)g(\014le)g(whic)m(h)g
(could)g(triple)g(the)h(execution)g(time)g(of)f(an)g(IO)f(limited)i
(program.)40 b(F)-8 b(or)27 b(small)0 3700 y(tables)k(this)f(is)h(not)f
(imp)s(ortan)m(t,)h(but)f(when)f(reading)h(m)m(ulti-megab)m(yte)j
(sized)e(tables)g(these)g(ine\016ciencies)h(can)0 3813
y(b)s(ecome)d(signi\014can)m(t.)41 b(The)28 b(more)h(e\016cien)m(t)h
(pro)s(cedure)d(in)i(this)f(case)i(is)e(to)i(read)e(or)h(write)g(only)f
(as)h(man)m(y)g(ro)m(ws)0 3926 y(of)j(the)g(table)g(as)g(will)g(\014t)g
(in)m(to)g(the)g(a)m(v)-5 b(ailable)34 b(in)m(ternal)e(IO)f(bu\013ers,)
h(then)f(access)i(all)f(the)g(necessary)g(columns)0 4039
y(of)f(data)h(within)e(that)i(range)f(of)g(ro)m(ws.)43
b(Then)29 b(after)j(the)f(program)g(is)g(completely)h(\014nished)e
(with)g(the)i(data)f(in)0 4152 y(those)i(ro)m(ws)e(it)i(can)f(mo)m(v)m
(e)i(on)e(to)g(the)h(next)f(range)g(of)g(ro)m(ws)g(that)h(will)f(\014t)
g(in)g(the)g(bu\013ers,)f(con)m(tin)m(uing)i(in)f(this)0
4264 y(w)m(a)m(y)c(un)m(til)f(the)f(en)m(tire)i(\014le)f(has)f(b)s(een)
g(pro)s(cessed.)39 b(By)27 b(using)f(this)h(pro)s(cedure)e(of)i
(accessing)h(all)g(the)e(columns)h(of)0 4377 y(a)j(table)g(in)f
(parallel)h(rather)f(than)g(sequen)m(tially)-8 b(,)32
b(eac)m(h)e(blo)s(c)m(k)g(of)g(the)f(FITS)g(\014le)g(will)g(only)h(b)s
(e)e(read)i(or)f(written)0 4490 y(once.)0 4650 y(The)g(optimal)h(n)m
(um)m(b)s(er)e(of)i(ro)m(ws)f(to)i(read)e(or)g(write)h(at)g(one)g(time)
g(in)f(a)h(giv)m(en)g(table)h(dep)s(ends)c(on)j(the)f(width)g(of)0
4763 y(the)c(table)h(ro)m(w)f(and)f(on)h(the)g(n)m(um)m(b)s(er)e(of)i
(IO)g(bu\013ers)e(that)j(ha)m(v)m(e)g(b)s(een)e(allo)s(cated)j(in)e
(CFITSIO.)e(The)h(CFITSIO)0 4876 y(Iterator)h(routine)f(will)g
(automatically)j(use)c(the)h(optimal-sized)i(bu\013er,)e(but)g(there)g
(is)g(also)g(a)h(CFITSIO)d(routine)0 4989 y(that)31 b(will)g(return)f
(the)h(optimal)h(n)m(um)m(b)s(er)d(of)i(ro)m(ws)g(for)f(a)h(giv)m(en)h
(table:)43 b(\014ts)p 2629 4989 V 32 w(get)p 2781 4989
V 34 w(ro)m(wsize.)g(It)31 b(is)g(not)g(critical)h(to)0
5102 y(use)h(exactly)j(the)e(v)-5 b(alue)34 b(of)g(nro)m(ws)f(returned)
f(b)m(y)i(this)g(routine,)g(as)g(long)h(as)f(one)g(do)s(es)f(not)h
(exceed)h(it.)51 b(Using)0 5215 y(a)37 b(v)m(ery)g(small)g(v)-5
b(alue)37 b(ho)m(w)m(ev)m(er)h(can)f(also)g(lead)g(to)h(p)s(o)s(or)d(p)
s(erformance)h(b)s(ecause)g(of)h(the)g(o)m(v)m(erhead)h(from)e(the)0
5328 y(larger)31 b(n)m(um)m(b)s(er)e(of)i(subroutine)e(calls.)0
5488 y(The)36 b(optimal)h(n)m(um)m(b)s(er)e(of)h(ro)m(ws)g(returned)f
(b)m(y)i(\014ts)p 1829 5488 V 32 w(get)p 1981 5488 V
34 w(ro)m(wsize)g(is)g(v)-5 b(alid)36 b(only)g(as)h(long)g(as)f(the)h
(application)0 5601 y(program)27 b(is)g(only)g(reading)h(or)f(writing)g
(data)h(in)f(the)g(sp)s(eci\014ed)f(table.)41 b(An)m(y)27
b(other)g(calls)i(to)f(access)g(data)g(in)f(the)0 5714
y(table)i(header)f(w)m(ould)f(cause)i(additional)g(blo)s(c)m(ks)f(of)g
(data)g(to)h(b)s(e)e(loaded)i(in)m(to)g(the)f(IO)f(bu\013ers)g
(displacing)h(data)p eop end
%%Page: 162 170
TeXDict begin 162 169 bop 0 299 a Fj(162)1876 b Fh(CHAPTER)30
b(13.)112 b(OPTIMIZING)29 b(PR)m(OGRAMS)0 555 y Fj(from)34
b(the)h(original)h(table,)h(and)d(should)f(b)s(e)h(a)m(v)m(oided)i
(during)e(the)h(critical)h(p)s(erio)s(d)e(while)g(the)h(table)h(is)e(b)
s(eing)0 668 y(read)c(or)h(written.)0 828 y(4.)39 b(Use)25
b(the)g(CFITSIO)e(Iterator)j(routine.)39 b(This)24 b(routine)h(pro)m
(vides)f(a)i(more)e(`ob)5 b(ject)26 b(orien)m(ted')g(w)m(a)m(y)g(of)f
(reading)0 941 y(and)34 b(writing)g(FITS)g(\014les)g(whic)m(h)h
(automatically)i(uses)d(the)g(most)h(appropriate)g(data)g(bu\013er)e
(size)i(to)h(ac)m(hiev)m(e)0 1054 y(the)31 b(maxim)m(um)f(I/O)g
(throughput.)0 1214 y(5.)39 b(Use)24 b(binary)f(table)h(extensions)g
(rather)f(than)h(ASCI)s(I)e(table)i(extensions)g(for)f(b)s(etter)h
(e\016ciency)h(when)d(dealing)0 1327 y(with)37 b(tabular)h(data.)62
b(The)37 b(I/O)g(to)h(ASCI)s(I)e(tables)i(is)g(slo)m(w)m(er)g(b)s
(ecause)g(of)f(the)h(o)m(v)m(erhead)h(in)e(formatting)h(or)0
1440 y(parsing)32 b(the)g(ASCI)s(I)f(data)i(\014elds)f(and)g(b)s
(ecause)g(ASCI)s(I)f(tables)i(are)g(ab)s(out)f(t)m(wice)i(as)f(large)g
(as)g(binary)e(tables)0 1553 y(that)g(ha)m(v)m(e)h(the)e(same)h
(information)g(con)m(ten)m(t.)0 1713 y(6.)64 b(Design)39
b(soft)m(w)m(are)g(so)g(that)f(it)h(reads)f(the)g(FITS)f(header)h(k)m
(eyw)m(ords)g(in)g(the)g(same)h(order)e(in)h(whic)m(h)g(they)0
1826 y(o)s(ccur)28 b(in)h(the)g(\014le.)40 b(When)28
b(reading)h(k)m(eyw)m(ords,)h(CFITSIO)d(searc)m(hes)i(forw)m(ard)g
(starting)g(from)f(the)h(p)s(osition)g(of)0 1939 y(the)g(last)i(k)m
(eyw)m(ord)e(that)h(w)m(as)g(read.)40 b(If)29 b(it)g(reac)m(hes)i(the)e
(end)g(of)g(the)h(header)f(without)g(\014nding)f(the)h(k)m(eyw)m(ord,)h
(it)0 2052 y(then)j(go)s(es)h(bac)m(k)g(to)h(the)e(start)h(of)g(the)g
(header)f(and)g(con)m(tin)m(ues)h(the)g(searc)m(h)g(do)m(wn)f(to)h(the)
g(p)s(osition)f(where)g(it)0 2165 y(started.)41 b(In)30
b(practice,)i(as)e(long)h(as)g(the)f(en)m(tire)i(FITS)d(header)h(can)h
(\014t)f(at)h(one)g(time)g(in)f(the)g(a)m(v)-5 b(ailable)33
b(in)m(ternal)0 2278 y(IO)23 b(bu\013ers,)i(then)e(the)i(header)e(k)m
(eyw)m(ord)i(access)g(will)f(b)s(e)g(relativ)m(ely)i(fast)e(and)g(it)g
(mak)m(es)h(little)h(di\013erence)e(whic)m(h)0 2391 y(order)30
b(they)g(are)h(accessed.)0 2551 y(7.)40 b(Av)m(oid)29
b(the)e(use)h(of)f(scaling)i(\(b)m(y)f(using)f(the)h(BSCALE)e(and)h
(BZER)m(O)h(or)f(TSCAL)g(and)g(TZER)m(O)f(k)m(eyw)m(ords\))0
2664 y(in)35 b(FITS)f(\014les)g(since)i(the)f(scaling)h(op)s(erations)f
(add)f(to)i(the)f(pro)s(cessing)f(time)i(needed)e(to)i(read)f(or)g
(write)g(the)0 2777 y(data.)k(In)24 b(some)h(cases)h(it)f(ma)m(y)g(b)s
(e)f(more)g(e\016cien)m(t)i(to)g(temp)s(orarily)e(turn)g(o\013)h(the)f
(scaling)i(\(using)e(\014ts)p 3490 2777 28 4 v 33 w(set)p
3634 2777 V 33 w(bscale)0 2889 y(or)30 b(\014ts)p 238
2889 V 33 w(set)p 382 2889 V 33 w(tscale\))j(and)c(then)h(read)h(or)f
(write)h(the)f(ra)m(w)h(unscaled)f(v)-5 b(alues)31 b(in)f(the)g(FITS)g
(\014le.)0 3050 y(8.)77 b(Av)m(oid)43 b(using)f(the)h(`implicit)g(data)
h(t)m(yp)s(e)e(con)m(v)m(ersion')i(capabilit)m(y)g(in)e(CFITSIO.)f(F)-8
b(or)44 b(instance,)i(when)0 3163 y(reading)28 b(a)g(FITS)f(image)i
(with)e(BITPIX)h(=)f(-32)i(\(32-bit)g(\015oating)g(p)s(oin)m(t)f
(pixels\),)h(read)e(the)h(data)g(in)m(to)h(a)f(single)0
3275 y(precision)40 b(\015oating)h(p)s(oin)m(t)f(data)h(arra)m(y)f(in)g
(the)g(program.)69 b(F)-8 b(orcing)41 b(CFITSIO)e(to)i(con)m(v)m(ert)g
(the)f(data)h(to)g(a)0 3388 y(di\013eren)m(t)31 b(data)g(t)m(yp)s(e)f
(can)h(slo)m(w)g(the)g(program.)0 3548 y(9.)57 b(Where)36
b(feasible,)i(design)e(FITS)f(binary)g(tables)h(using)f(v)m(ector)j
(column)d(elemen)m(ts)i(so)f(that)g(the)g(data)h(are)0
3661 y(written)30 b(as)g(a)g(con)m(tiguous)h(set)f(of)g(b)m(ytes,)g
(rather)g(than)f(as)h(single)g(elemen)m(ts)h(in)f(m)m(ultiple)g(ro)m
(ws.)41 b(F)-8 b(or)30 b(example,)0 3774 y(it)36 b(is)g(faster)g(to)g
(access)h(the)f(data)h(in)e(a)h(table)h(that)f(con)m(tains)h(a)f
(single)g(ro)m(w)g(and)f(2)h(columns)f(with)h(TF)m(ORM)0
3887 y(k)m(eyw)m(ords)d(equal)h(to)g('10000E')h(and)e('10000J',)j(than)
d(it)g(is)g(to)h(access)g(the)g(same)f(amoun)m(t)h(of)f(data)h(in)f(a)g
(table)0 4000 y(with)40 b(10000)j(ro)m(ws)d(whic)m(h)h(has)f(columns)g
(with)g(the)h(TF)m(ORM)g(k)m(eyw)m(ords)g(equal)g(to)g('1E')h(and)e
('1J'.)h(In)f(the)0 4113 y(former)27 b(case)i(the)f(10000)i(\015oating)
f(p)s(oin)m(t)f(v)-5 b(alues)28 b(in)g(the)g(\014rst)f(column)h(are)g
(all)h(written)f(in)f(a)h(con)m(tiguous)h(blo)s(c)m(k)0
4226 y(of)d(the)f(\014le)h(whic)m(h)f(can)h(b)s(e)f(read)g(or)g
(written)h(quic)m(kly)-8 b(,)28 b(whereas)d(in)g(the)h(second)f(case)i
(eac)m(h)g(\015oating)f(p)s(oin)m(t)f(v)-5 b(alue)0 4339
y(in)34 b(the)g(\014rst)f(column)g(is)h(in)m(terlea)m(v)m(ed)j(with)c
(the)h(in)m(teger)i(v)-5 b(alue)34 b(in)g(the)g(second)g(column)f(of)h
(the)g(same)h(ro)m(w)f(so)0 4452 y(CFITSIO)29 b(has)h(to)h(explicitly)h
(mo)m(v)m(e)g(to)f(the)g(p)s(osition)f(of)h(eac)m(h)g(elemen)m(t)h(to)f
(b)s(e)f(read)g(or)g(written.)0 4612 y(10.)45 b(Av)m(oid)33
b(the)f(use)f(of)h(v)-5 b(ariable)32 b(length)g(v)m(ector)h(columns)f
(in)f(binary)g(tables,)i(since)f(an)m(y)g(reading)f(or)h(writing)0
4725 y(of)h(these)g(data)g(requires)f(that)h(CFITSIO)f(\014rst)f(lo)s
(ok)j(up)d(or)i(compute)g(the)f(starting)i(address)e(of)g(eac)m(h)i(ro)
m(w)f(of)0 4838 y(data)e(in)f(the)h(heap.)40 b(In)30
b(practice,)i(this)e(is)g(probably)g(not)h(a)f(signi\014can)m(t)i
(e\016ciency)f(issue.)0 4998 y(11.)73 b(When)40 b(cop)m(ying)i(data)g
(from)e(one)h(FITS)f(table)i(to)f(another,)j(it)e(is)e(faster)i(to)f
(transfer)g(the)f(ra)m(w)h(b)m(ytes)0 5111 y(instead)28
b(of)h(reading)f(then)g(writing)g(eac)m(h)h(column)f(of)g(the)g(table.)
41 b(The)28 b(CFITSIO)e(routines)i(\014ts)p 3349 5111
V 33 w(read)p 3554 5111 V 32 w(tblb)m(ytes)0 5224 y(and)36
b(\014ts)p 310 5224 V 32 w(write)p 544 5224 V 33 w(tblb)m(ytes)i(will)f
(p)s(erform)e(lo)m(w-lev)m(el)k(reads)e(or)f(writes)h(of)g(an)m(y)g
(con)m(tiguous)g(range)g(of)g(b)m(ytes)g(in)0 5337 y(a)d(table)g
(extension.)51 b(These)33 b(routines)h(can)f(b)s(e)g(used)g(to)h(read)f
(or)h(write)g(a)f(whole)h(ro)m(w)g(\(or)g(m)m(ultiple)g(ro)m(ws)f(for)0
5450 y(ev)m(en)e(greater)h(e\016ciency\))h(of)e(a)g(table)h(with)e(a)h
(single)h(function)e(call.)43 b(These)31 b(routines)g(are)g(fast)g(b)s
(ecause)g(they)0 5562 y(b)m(ypass)36 b(all)h(the)g(usual)f(data)h
(scaling,)i(error)d(c)m(hec)m(king)i(and)e(mac)m(hine)h(dep)s(enden)m
(t)e(data)i(con)m(v)m(ersion)h(that)f(is)0 5675 y(normally)g(done)g(b)m
(y)f(CFITSIO,)g(and)g(they)h(allo)m(w)h(the)g(program)e(to)i(write)f
(the)g(data)g(to)h(the)f(output)f(\014le)h(in)p eop end
%%Page: 163 171
TeXDict begin 163 170 bop 0 299 a Fh(13.2.)73 b(OPTIMIZA)-8
b(TION)29 b(STRA)-8 b(TEGIES)2186 b Fj(163)0 555 y(exactly)30
b(the)e(same)h(b)m(yte)g(order.)40 b(F)-8 b(or)29 b(these)f(same)h
(reasons,)g(these)g(routines)f(can)g(corrupt)g(the)g(FITS)g(data)h
(\014le)0 668 y(if)36 b(used)e(incorrectly)j(b)s(ecause)f(no)f(v)-5
b(alidation)37 b(or)f(mac)m(hine)g(dep)s(enden)m(t)e(con)m(v)m(ersion)j
(is)f(p)s(erformed)e(b)m(y)h(these)0 781 y(routines.)55
b(These)35 b(routines)g(are)h(only)f(recommended)g(for)g(optimizing)h
(critical)h(pieces)f(of)g(co)s(de)f(and)g(should)0 894
y(only)e(b)s(e)g(used)g(b)m(y)g(programmers)g(who)g(thoroughly)g
(understand)e(the)j(in)m(ternal)g(format)g(of)f(the)h(FITS)e(tables)0
1007 y(they)f(are)f(reading)h(or)f(writing.)0 1167 y(12.)41
b(Another)30 b(strategy)g(for)g(impro)m(ving)f(the)h(sp)s(eed)e(of)i
(writing)g(a)f(FITS)g(table,)i(similar)f(to)g(the)f(previous)g(one,)0
1280 y(is)j(to)g(directly)h(construct)f(the)f(en)m(tire)i(b)m(yte)f
(stream)g(for)g(a)g(whole)g(table)g(ro)m(w)g(\(or)g(m)m(ultiple)h(ro)m
(ws\))f(within)f(the)0 1393 y(application)g(program)e(and)g(then)h
(write)g(it)g(to)g(the)g(FITS)f(\014le)h(with)f(\014ts)p
2520 1393 28 4 v 32 w(write)p 2754 1393 V 33 w(tblb)m(ytes.)41
b(This)29 b(a)m(v)m(oids)i(all)g(the)0 1506 y(o)m(v)m(erhead)f
(normally)g(presen)m(t)f(in)g(the)h(column-orien)m(ted)g(CFITSIO)e
(write)h(routines.)40 b(This)29 b(tec)m(hnique)h(should)0
1619 y(only)35 b(b)s(e)e(used)h(for)g(critical)i(applications)g(b)s
(ecause)e(it)h(mak)m(es)h(the)e(co)s(de)h(more)f(di\016cult)h(to)g
(understand)e(and)0 1732 y(main)m(tain,)38 b(and)d(it)h(mak)m(es)g(the)
g(co)s(de)f(more)h(system)g(dep)s(enden)m(t)e(\(e.g.,)39
b(do)c(the)h(b)m(ytes)g(need)f(to)h(b)s(e)f(sw)m(app)s(ed)0
1844 y(b)s(efore)30 b(writing)g(to)h(the)g(FITS)f(\014le?\).)0
2005 y(13.)40 b(Finally)-8 b(,)29 b(external)e(factors)g(suc)m(h)e(as)i
(the)f(sp)s(eed)f(of)i(the)f(data)h(storage)g(device,)h(the)f(size)g
(of)f(the)g(data)h(cac)m(he,)0 2118 y(the)34 b(amoun)m(t)h(of)f(disk)g
(fragmen)m(tation,)j(and)c(the)i(amoun)m(t)f(of)h(RAM)f(a)m(v)-5
b(ailable)37 b(on)d(the)g(system)g(can)h(all)g(ha)m(v)m(e)0
2230 y(a)k(signi\014can)m(t)g(impact)g(on)f(o)m(v)m(erall)j(I/O)d
(e\016ciency)-8 b(.)66 b(F)-8 b(or)39 b(critical)h(applications,)i(the)
c(en)m(tire)i(hardw)m(are)e(and)0 2343 y(soft)m(w)m(are)32
b(system)e(should)g(b)s(e)f(review)m(ed)i(to)h(iden)m(tify)e(an)m(y)h
(p)s(oten)m(tial)h(I/O)e(b)s(ottlenec)m(ks.)p eop end
%%Page: 164 172
TeXDict begin 164 171 bop 0 299 a Fj(164)1876 b Fh(CHAPTER)30
b(13.)112 b(OPTIMIZING)29 b(PR)m(OGRAMS)p eop end
%%Page: 165 173
TeXDict begin 165 172 bop 0 1225 a Fg(App)5 b(endix)64
b(A)0 1687 y Fm(Index)77 b(of)h(Routines)50 2154 y Fj(\014ts)p
177 2154 28 4 v 32 w(add)p 356 2154 V 32 w(group)p 616
2154 V 33 w(mem)m(b)s(er)245 b(88)50 2267 y(\014ts)p
177 2267 V 32 w(ascii)p 380 2267 V 34 w(tform)579 b(66)50
2380 y(\014ts)p 177 2380 V 32 w(binary)p 465 2380 V 32
w(tform)496 b(66)50 2493 y(\014ts)p 177 2493 V 32 w(calculator)617
b(57)50 2606 y(\014ts)p 177 2606 V 32 w(calculator)p
596 2606 V 35 w(rng)450 b(57)50 2719 y(\014ts)p 177 2719
V 32 w(calc)p 359 2719 V 35 w(binning)520 b(58)50 2832
y(\014ts)p 177 2832 V 32 w(calc)p 359 2832 V 35 w(ro)m(ws)639
b(56)50 2945 y(\014ts)p 177 2945 V 32 w(c)m(hange)p 478
2945 V 34 w(group)473 b(86)50 3057 y(\014ts)p 177 3057
V 32 w(clear)p 395 3057 V 34 w(errmark)467 b(30)50 3170
y(\014ts)p 177 3170 V 32 w(clear)p 395 3170 V 34 w(errmsg)515
b(30)50 3283 y(\014ts)p 177 3283 V 32 w(close)p 395 3283
V 34 w(\014le)668 b(33)50 3396 y(\014ts)p 177 3396 V
32 w(compact)p 541 3396 V 34 w(group)410 b(87)50 3509
y(\014ts)p 177 3509 V 32 w(compare)p 542 3509 V 34 w(str)530
b(63)50 3622 y(\014ts)p 177 3622 V 32 w(compress)p 569
3622 V 33 w(heap)379 b(111)50 3735 y(\014ts)p 177 3735
V 32 w(con)m(v)m(ert)p 498 3735 V 35 w(hdr2str)244 b(37,)31
b(82)50 3848 y(\014ts)p 177 3848 V 32 w(cop)m(y)p 390
3848 V 34 w(cell2image)383 b(41)50 3961 y(\014ts)p 177
3961 V 32 w(cop)m(y)p 390 3961 V 34 w(col)679 b(53)50
4074 y(\014ts)p 177 4074 V 32 w(cop)m(y)p 390 4074 V
34 w(data)613 b(96)50 4187 y(\014ts)p 177 4187 V 32 w(cop)m(y)p
390 4187 V 34 w(\014le)673 b(34)50 4299 y(\014ts)p 177
4299 V 32 w(cop)m(y)p 390 4299 V 34 w(group)561 b(87)50
4412 y(\014ts)p 177 4412 V 32 w(cop)m(y)p 390 4412 V
34 w(hdu)636 b(34)50 4525 y(\014ts)p 177 4525 V 32 w(cop)m(y)p
390 4525 V 34 w(header)526 b(34)50 4638 y(\014ts)p 177
4638 V 32 w(cop)m(y)p 390 4638 V 34 w(image2cell)383
b(41)50 4751 y(\014ts)p 177 4751 V 32 w(cop)m(y)p 390
4751 V 34 w(image)p 655 4751 V 34 w(section)252 b(44)50
4864 y(\014ts)p 177 4864 V 32 w(cop)m(y)p 390 4864 V
34 w(k)m(ey)611 b(101)50 4977 y(\014ts)p 177 4977 V 32
w(cop)m(y)p 390 4977 V 34 w(mem)m(b)s(er)470 b(89)50
5090 y(\014ts)p 177 5090 V 32 w(cop)m(y)p 390 5090 V
34 w(pixlist2image)268 b(58)50 5203 y(\014ts)p 177 5203
V 32 w(cop)m(y)p 390 5203 V 34 w(ro)m(ws)609 b(53)50
5316 y(\014ts)p 177 5316 V 32 w(create)p 445 5316 V 35
w(disk\014le)457 b(32)50 5429 y(\014ts)p 177 5429 V 32
w(create)p 445 5429 V 35 w(\014le)617 b(32)50 5541 y(\014ts)p
177 5541 V 32 w(create)p 445 5541 V 35 w(group)505 b(86)50
5654 y(\014ts)p 177 5654 V 32 w(create)p 445 5654 V 35
w(hdu)580 b(95)1419 2154 y(\014ts)p 1546 2154 V 32 w(create)p
1814 2154 V 35 w(img)565 b(41)1419 2267 y(\014ts)p 1546
2267 V 32 w(create)p 1814 2267 V 35 w(mem\014le)403 b(92)1419
2380 y(\014ts)p 1546 2380 V 32 w(create)p 1814 2380 V
35 w(tbl)600 b(49)1419 2493 y(\014ts)p 1546 2493 V 32
w(create)p 1814 2493 V 35 w(template)364 b(92)1419 2606
y(\014ts)p 1546 2606 V 32 w(date2str)659 b(61)1419 2719
y(\014ts)p 1546 2719 V 32 w(deco)s(de)p 1848 2719 V 33
w(c)m(hksum)380 b(61)1419 2832 y(\014ts)p 1546 2832 V
32 w(deco)s(de)p 1848 2832 V 33 w(tdim)492 b(51)1419
2945 y(\014ts)p 1546 2945 V 32 w(delete)p 1809 2945 V
34 w(col)607 b(52)1419 3057 y(\014ts)p 1546 3057 V 32
w(delete)p 1809 3057 V 34 w(\014le)601 b(33)1419 3170
y(\014ts)p 1546 3170 V 32 w(delete)p 1809 3170 V 34 w(hdu)564
b(35)1419 3283 y(\014ts)p 1546 3283 V 32 w(delete)p 1809
3283 V 34 w(k)m(ey)584 b(39)1419 3396 y(\014ts)p 1546
3396 V 32 w(delete)p 1809 3396 V 34 w(record)469 b(39)1419
3509 y(\014ts)p 1546 3509 V 32 w(delete)p 1809 3509 V
34 w(ro)m(wlist)452 b(52)1419 3622 y(\014ts)p 1546 3622
V 32 w(delete)p 1809 3622 V 34 w(ro)m(wrange)356 b(52)1419
3735 y(\014ts)p 1546 3735 V 32 w(delete)p 1809 3735 V
34 w(ro)m(ws)537 b(52)1419 3848 y(\014ts)p 1546 3848
V 32 w(delete)p 1809 3848 V 34 w(str)610 b(39)1419 3961
y(\014ts)p 1546 3961 V 32 w(enco)s(de)p 1848 3961 V 33
w(c)m(hksum)380 b(61)1419 4074 y(\014ts)p 1546 4074 V
32 w(\014le)p 1694 4074 V 33 w(exists)613 b(94)1419 4187
y(\014ts)p 1546 4187 V 32 w(\014le)p 1694 4187 V 33 w(mo)s(de)618
b(33)1419 4299 y(\014ts)p 1546 4299 V 32 w(\014le)p 1694
4299 V 33 w(name)j(33)1419 4412 y(\014ts)p 1546 4412
V 32 w(\014nd)p 1731 4412 V 32 w(\014rst)p 1921 4412
V 32 w(ro)m(w)463 b(56)1419 4525 y(\014ts)p 1546 4525
V 32 w(\014nd)p 1731 4525 V 32 w(nextk)m(ey)490 b(37)1419
4638 y(\014ts)p 1546 4638 V 32 w(\014nd)p 1731 4638 V
32 w(ro)m(ws)617 b(56)1419 4751 y(\014ts)p 1546 4751
V 32 w(\015ush)p 1767 4751 V 32 w(bu\013er)530 b(94)1419
4864 y(\014ts)p 1546 4864 V 32 w(\015ush)p 1767 4864
V 32 w(\014le)645 b(94)1419 4977 y(\014ts)p 1546 4977
V 32 w(free)p 1722 4977 V 33 w(memory)438 b(103)1419
5090 y(\014ts)p 1546 5090 V 32 w(get)p 1698 5090 V 34
w(acolparms)383 b(110)1419 5203 y(\014ts)p 1546 5203
V 32 w(get)p 1698 5203 V 34 w(b)s(colparms)374 b(110)1419
5316 y(\014ts)p 1546 5316 V 32 w(get)p 1698 5316 V 34
w(c)m(hksum)529 b(60)1419 5429 y(\014ts)p 1546 5429 V
32 w(get)p 1698 5429 V 34 w(col)p 1842 5429 V 34 w(displa)m(y)p
2154 5429 V 33 w(width)145 b(51)1419 5541 y(\014ts)p
1546 5541 V 32 w(get)p 1698 5541 V 34 w(colname)506 b(49)1419
5654 y(\014ts)p 1546 5654 V 32 w(get)p 1698 5654 V 34
w(coln)m(um)543 b(49)2765 2154 y(\014ts)p 2892 2154 V
33 w(get)p 3045 2154 V 34 w(colt)m(yp)s(e)650 b(50)2765
2267 y(\014ts)p 2892 2267 V 33 w(get)p 3045 2267 V 34
w(compression)p 3560 2267 V 32 w(t)m(yp)s(e)247 b(46)2765
2380 y(\014ts)p 2892 2380 V 33 w(get)p 3045 2380 V 34
w(eqcolt)m(yp)s(e)562 b(50)2765 2493 y(\014ts)p 2892
2493 V 33 w(get)p 3045 2493 V 34 w(errstatus)584 b(29)2765
2606 y(\014ts)p 2892 2606 V 33 w(get)p 3045 2606 V 34
w(hdrp)s(os)661 b(97)2765 2719 y(\014ts)p 2892 2719 V
33 w(get)p 3045 2719 V 34 w(hdrspace)584 b(35)2765 2832
y(\014ts)p 2892 2832 V 33 w(get)p 3045 2832 V 34 w(hdu)p
3232 2832 V 31 w(n)m(um)575 b(34)2765 2945 y(\014ts)p
2892 2945 V 33 w(get)p 3045 2945 V 34 w(hdu)p 3232 2945
V 31 w(t)m(yp)s(e)h(34)2765 3057 y(\014ts)p 2892 3057
V 33 w(get)p 3045 3057 V 34 w(hduaddr)598 b(95)2765 3170
y(\014ts)p 2892 3170 V 33 w(get)p 3045 3170 V 34 w(hduaddrll)548
b(95)2765 3283 y(\014ts)p 2892 3283 V 33 w(get)p 3045
3283 V 34 w(img)p 3225 3283 V 33 w(dim)603 b(41)2765
3396 y(\014ts)p 2892 3396 V 33 w(get)p 3045 3396 V 34
w(img)p 3225 3396 V 33 w(equivt)m(yp)s(e)369 b(40)2765
3509 y(\014ts)p 2892 3509 V 33 w(get)p 3045 3509 V 34
w(img)p 3225 3509 V 33 w(param)502 b(41)2765 3622 y(\014ts)p
2892 3622 V 33 w(get)p 3045 3622 V 34 w(img)p 3225 3622
V 33 w(size)614 b(41)2765 3735 y(\014ts)p 2892 3735 V
33 w(get)p 3045 3735 V 34 w(img)p 3225 3735 V 33 w(t)m(yp)s(e)581
b(40)2765 3848 y(\014ts)p 2892 3848 V 33 w(get)p 3045
3848 V 34 w(in)m(tt)m(yp)s(e)652 b(65)2765 3961 y(\014ts)p
2892 3961 V 33 w(get)p 3045 3961 V 34 w(k)m(eyclass)619
b(65)2765 4074 y(\014ts)p 2892 4074 V 33 w(get)p 3045
4074 V 34 w(k)m(eyname)589 b(64)2765 4187 y(\014ts)p
2892 4187 V 33 w(get)p 3045 4187 V 34 w(k)m(eyt)m(yp)s(e)627
b(64)2765 4299 y(\014ts)p 2892 4299 V 33 w(get)p 3045
4299 V 34 w(noise)p 3276 4299 V 33 w(bits)557 b(46)2765
4412 y(\014ts)p 2892 4412 V 33 w(get)p 3045 4412 V 34
w(n)m(um)p 3254 4412 V 32 w(cols)581 b(49)2765 4525 y(\014ts)p
2892 4525 V 33 w(get)p 3045 4525 V 34 w(n)m(um)p 3254
4525 V 32 w(groups)463 b(89)2765 4638 y(\014ts)p 2892
4638 V 33 w(get)p 3045 4638 V 34 w(n)m(um)p 3254 4638
V 32 w(hdus)538 b(34)2765 4751 y(\014ts)p 2892 4751 V
33 w(get)p 3045 4751 V 34 w(n)m(um)p 3254 4751 V 32 w(mem)m(b)s(ers)372
b(88)2765 4864 y(\014ts)p 2892 4864 V 33 w(get)p 3045
4864 V 34 w(n)m(um)p 3254 4864 V 32 w(ro)m(ws)547 b(49)2765
4977 y(\014ts)p 2892 4977 V 33 w(get)p 3045 4977 V 34
w(ro)m(wsize)603 b(111)2765 5090 y(\014ts)p 2892 5090
V 33 w(get)p 3045 5090 V 34 w(system)p 3350 5090 V 33
w(time)454 b(61)2765 5203 y(\014ts)p 2892 5203 V 33 w(get)p
3045 5203 V 34 w(tile)p 3204 5203 V 34 w(dim)623 b(46)2765
5316 y(\014ts)p 2892 5316 V 33 w(get)p 3045 5316 V 34
w(tb)s(col)735 b(66)2765 5429 y(\014ts)p 2892 5429 V
33 w(get)p 3045 5429 V 34 w(v)m(ersion)656 b(62)2765
5541 y(\014ts)p 2892 5541 V 33 w(hdr2str)651 b(37,)32
b(82)2765 5654 y(\014ts)p 2892 5654 V 33 w(insert)p 3148
5654 V 32 w(atbl)677 b(96)1882 5942 y(165)p eop end
%%Page: 166 174
TeXDict begin 166 173 bop 0 299 a Fj(166)2084 b Fh(APPENDIX)31
b(A.)61 b(INDEX)31 b(OF)f(R)m(OUTINES)50 543 y Fj(\014ts)p
177 543 28 4 v 32 w(insert)p 432 543 V 33 w(btbl)541
b(96)50 656 y(\014ts)p 177 656 V 32 w(insert)p 432 656
V 33 w(col)593 b(52)50 769 y(\014ts)p 177 769 V 32 w(insert)p
432 769 V 33 w(cols)557 b(52)50 882 y(\014ts)p 177 882
V 32 w(insert)p 432 882 V 33 w(group)475 b(86)50 995
y(\014ts)p 177 995 V 32 w(insert)p 432 995 V 33 w(img)557
b(95)50 1107 y(\014ts)p 177 1107 V 32 w(insert)p 432
1107 V 33 w(k)m(ey)p 598 1107 V 34 w(n)m(ull)342 b(102)50
1220 y(\014ts)p 177 1220 V 32 w(insert)p 432 1220 V 33
w(k)m(ey)p 598 1220 V 34 w(TYP)295 b(102)50 1333 y(\014ts)p
177 1333 V 32 w(insert)p 432 1333 V 33 w(record)410 b(102)50
1446 y(\014ts)p 177 1446 V 32 w(insert)p 432 1446 V 33
w(ro)m(ws)523 b(52)50 1559 y(\014ts)p 177 1559 V 32 w(is)p
270 1559 V 33 w(reen)m(tran)m(t)502 b(71)50 1672 y(\014ts)p
177 1672 V 32 w(iterate)p 465 1672 V 35 w(data)492 b(79)50
1785 y(\014ts)p 177 1785 V 32 w(mak)m(e)p 415 1785 V
34 w(hist)572 b(59)50 1898 y(\014ts)p 177 1898 V 32 w(mak)m(e)p
415 1898 V 34 w(k)m(eyn)535 b(64)50 2011 y(\014ts)p 177
2011 V 32 w(mak)m(e)p 415 2011 V 34 w(nk)m(ey)g(64)50
2124 y(\014ts)p 177 2124 V 32 w(merge)p 446 2124 V 34
w(groups)424 b(87)50 2237 y(\014ts)p 177 2237 V 32 w(mo)s(dify)p
485 2237 V 32 w(card)434 b(104)50 2349 y(\014ts)p 177
2349 V 32 w(mo)s(dify)p 485 2349 V 32 w(commen)m(t)291
b(39)50 2462 y(\014ts)p 177 2462 V 32 w(mo)s(dify)p 485
2462 V 32 w(k)m(ey)p 650 2462 V 34 w(n)m(ull)f(105)50
2575 y(\014ts)p 177 2575 V 32 w(mo)s(dify)p 485 2575
V 32 w(k)m(ey)p 650 2575 V 34 w(TYP)243 b(104)50 2688
y(\014ts)p 177 2688 V 32 w(mo)s(dify)p 485 2688 V 32
w(name)439 b(39)50 2801 y(\014ts)p 177 2801 V 32 w(mo)s(dify)p
485 2801 V 32 w(record)358 b(104)50 2914 y(\014ts)p 177
2914 V 32 w(mo)s(dify)p 485 2914 V 32 w(v)m(ector)p 758
2914 V 35 w(len)259 b(53)50 3027 y(\014ts)p 177 3027
V 32 w(mo)m(v)-5 b(abs)p 502 3027 V 33 w(hdu)480 b(33)50
3140 y(\014ts)p 177 3140 V 32 w(mo)m(vnam)p 547 3140
V 33 w(hdu)435 b(33)50 3253 y(\014ts)p 177 3253 V 32
w(mo)m(vrel)p 476 3253 V 34 w(hdu)505 b(33)50 3366 y(\014ts)p
177 3366 V 32 w(n)m(ull)p 358 3366 V 33 w(c)m(hec)m(k)564
b(64)50 3479 y(\014ts)p 177 3479 V 32 w(op)s(en)p 399
3479 V 32 w(data)d(30)50 3591 y(\014ts)p 177 3591 V 32
w(op)s(en)p 399 3591 V 32 w(disk\014le)461 b(30)50 3704
y(\014ts)p 177 3704 V 32 w(op)s(en)p 399 3704 V 32 w(\014le)621
b(30)50 3817 y(\014ts)p 177 3817 V 32 w(op)s(en)p 399
3817 V 32 w(image)506 b(30)50 3930 y(\014ts)p 177 3930
V 32 w(op)s(en)p 399 3930 V 32 w(table)541 b(30)50 4043
y(\014ts)p 177 4043 V 32 w(op)s(en)p 399 4043 V 32 w(group)509
b(88)50 4156 y(\014ts)p 177 4156 V 32 w(op)s(en)p 399
4156 V 32 w(mem)m(b)s(er)418 b(89)50 4269 y(\014ts)p
177 4269 V 32 w(op)s(en)p 399 4269 V 32 w(mem\014le)429
b(91)50 4382 y(\014ts)p 177 4382 V 32 w(parse)p 417 4382
V 33 w(extn)m(um)420 b(93)50 4495 y(\014ts)p 177 4495
V 32 w(parse)p 417 4495 V 33 w(input)p 663 4495 V 32
w(\014lename)145 b(93)50 4608 y(\014ts)p 177 4608 V 32
w(parse)p 417 4608 V 33 w(input)p 663 4608 V 32 w(url)361
b(93)50 4721 y(\014ts)p 177 4721 V 32 w(parse)p 417 4721
V 33 w(range)501 b(71)50 4833 y(\014ts)p 177 4833 V 32
w(parse)p 417 4833 V 33 w(ro)s(otname)342 b(94)50 4946
y(\014ts)p 177 4946 V 32 w(parse)p 417 4946 V 33 w(template)371
b(67)50 5059 y(\014ts)p 177 5059 V 32 w(parse)p 417 5059
V 33 w(v)-5 b(alue)514 b(64)50 5172 y(\014ts)p 177 5172
V 32 w(pix)p 333 5172 V 33 w(to)p 446 5172 V 33 w(w)m(orld)469
b(83)50 5285 y(\014ts)p 177 5285 V 32 w(read)p 381 5285
V 33 w(2d)p 510 5285 V 33 w(TYP)384 b(110)50 5398 y(\014ts)p
177 5398 V 32 w(read)p 381 5398 V 33 w(3d)p 510 5398
V 33 w(TYP)g(110)50 5511 y(\014ts)p 177 5511 V 32 w(read)p
381 5511 V 33 w(atblhdr)460 b(99)50 5624 y(\014ts)p 177
5624 V 32 w(read)p 381 5624 V 33 w(btblhdr)454 b(99)50
5737 y(\014ts)p 177 5737 V 32 w(read)p 381 5737 V 33
w(card)582 b(36)50 5850 y(\014ts)p 177 5850 V 32 w(read)p
381 5850 V 33 w(col)644 b(55)1374 543 y(\014ts)p 1501
543 V 32 w(read)p 1705 543 V 33 w(col)p 1848 543 V 34
w(bit)p 1993 543 V 639 w(116)1374 656 y(\014ts)p 1501
656 V 32 w(read)p 1705 656 V 33 w(col)p 1848 656 V 34
w(TYP)554 b(114)1374 769 y(\014ts)p 1501 769 V 32 w(read)p
1705 769 V 33 w(coln)m(ull)680 b(55)1374 882 y(\014ts)p
1501 882 V 32 w(read)p 1705 882 V 33 w(coln)m(ull)p 1997
882 V 34 w(TYP)405 b(114)1374 995 y(\014ts)p 1501 995
V 32 w(read)p 1705 995 V 33 w(descript)580 b(116)1374
1107 y(\014ts)p 1501 1107 V 32 w(read)p 1705 1107 V 33
w(descripts)544 b(116)1374 1220 y(\014ts)p 1501 1220
V 32 w(read)p 1705 1220 V 33 w(errmsg)670 b(30)1374 1333
y(\014ts)p 1501 1333 V 32 w(read)p 1705 1333 V 33 w(ext)816
b(96)1374 1446 y(\014ts)p 1501 1446 V 32 w(read)p 1705
1446 V 33 w(grppar)p 2002 1446 V 32 w(TYP)402 b(109)1374
1559 y(\014ts)p 1501 1559 V 32 w(read)p 1705 1559 V 33
w(img)748 b(109)1374 1672 y(\014ts)p 1501 1672 V 32 w(read)p
1705 1672 V 33 w(img)p 1884 1672 V 33 w(co)s(ord)540
b(83)1374 1785 y(\014ts)p 1501 1785 V 32 w(read)p 1705
1785 V 33 w(img)p 1884 1785 V 33 w(TYP)519 b(109)1374
1898 y(\014ts)p 1501 1898 V 32 w(read)p 1705 1898 V 33
w(imghdr)655 b(99)1374 2011 y(\014ts)p 1501 2011 V 32
w(read)p 1705 2011 V 33 w(imgn)m(ull)599 b(109)1374 2124
y(\014ts)p 1501 2124 V 32 w(read)p 1705 2124 V 33 w(imgn)m(ull)p
2033 2124 V 33 w(TYP)370 b(109)1374 2237 y(\014ts)p 1501
2237 V 32 w(read)p 1705 2237 V 33 w(k)m(ey)806 b(36)1374
2349 y(\014ts)p 1501 2349 V 32 w(read)p 1705 2349 V 33
w(k)m(ey)p 1871 2349 V 33 w(longstr)455 b(103)1374 2462
y(\014ts)p 1501 2462 V 32 w(read)p 1705 2462 V 33 w(k)m(ey)p
1871 2462 V 33 w(triple)516 b(104)1374 2575 y(\014ts)p
1501 2575 V 32 w(read)p 1705 2575 V 33 w(k)m(ey)p 1871
2575 V 33 w(unit)611 b(37)1374 2688 y(\014ts)p 1501 2688
V 32 w(read)p 1705 2688 V 33 w(k)m(ey)p 1871 2688 V 33
w(TYP)532 b(103)1374 2801 y(\014ts)p 1501 2801 V 32 w(read)p
1705 2801 V 33 w(k)m(eyn)755 b(36)1374 2914 y(\014ts)p
1501 2914 V 32 w(read)p 1705 2914 V 33 w(k)m(eys)p 1907
2914 V 33 w(TYP)496 b(103)1374 3027 y(\014ts)p 1501 3027
V 32 w(read)p 1705 3027 V 33 w(k)m(eyw)m(ord)611 b(36)1374
3140 y(\014ts)p 1501 3140 V 32 w(read)p 1705 3140 V 33
w(pix)815 b(43)1374 3253 y(\014ts)p 1501 3253 V 32 w(read)p
1705 3253 V 33 w(pixn)m(ull)666 b(43)1374 3366 y(\014ts)p
1501 3366 V 32 w(read)p 1705 3366 V 33 w(record)691 b(36)1374
3479 y(\014ts)p 1501 3479 V 32 w(read)p 1705 3479 V 33
w(str)832 b(36)1374 3591 y(\014ts)p 1501 3591 V 32 w(read)p
1705 3591 V 33 w(subset)p 1987 3591 V 32 w(TYP)250 b(110)32
b(115)1374 3704 y(\014ts)p 1501 3704 V 32 w(read)p 1705
3704 V 33 w(subsetn)m(ull)p 2136 3704 V 32 w(TYP)101
b(110)32 b(115)1374 3817 y(\014ts)p 1501 3817 V 32 w(read)p
1705 3817 V 33 w(tbl)p 1849 3817 V 33 w(co)s(ord)575
b(83)1374 3930 y(\014ts)p 1501 3930 V 32 w(read)p 1705
3930 V 33 w(tblb)m(ytes)h(112)1374 4043 y(\014ts)p 1501
4043 V 32 w(read)p 1705 4043 V 33 w(tdim)752 b(51)1374
4156 y(\014ts)p 1501 4156 V 32 w(read)p 1705 4156 V 33
w(w)m(cstab)669 b(82)1374 4269 y(\014ts)p 1501 4269 V
32 w(rebin)p 1736 4269 V 32 w(w)m(cs)770 b(59)1374 4382
y(\014ts)p 1501 4382 V 32 w(remo)m(v)m(e)p 1812 4382
V 34 w(group)603 b(87)1374 4495 y(\014ts)p 1501 4495
V 32 w(remo)m(v)m(e)p 1812 4495 V 34 w(mem)m(b)s(er)512
b(90)1374 4608 y(\014ts)p 1501 4608 V 32 w(reop)s(en)p
1799 4608 V 32 w(\014le)730 b(92)1374 4721 y(\014ts)p
1501 4721 V 32 w(rep)s(ort)p 1779 4721 V 32 w(error)673
b(30)1374 4833 y(\014ts)p 1501 4833 V 32 w(resize)p 1750
4833 V 34 w(img)747 b(96)1374 4946 y(\014ts)p 1501 4946
V 32 w(rms)p 1681 4946 V 32 w(\015oat)788 b(71)1374 5059
y(\014ts)p 1501 5059 V 32 w(rms)p 1681 5059 V 32 w(short)761
b(71)1374 5172 y(\014ts)p 1501 5172 V 32 w(select)p 1749
5172 V 35 w(ro)m(ws)713 b(56)1374 5285 y(\014ts)p 1501
5285 V 32 w(set)p 1644 5285 V 34 w(atbln)m(ull)649 b(106)1374
5398 y(\014ts)p 1501 5398 V 32 w(set)p 1644 5398 V 34
w(bscale)717 b(106)1374 5511 y(\014ts)p 1501 5511 V 32
w(set)p 1644 5511 V 34 w(btbln)m(ull)643 b(106)1374 5624
y(\014ts)p 1501 5624 V 32 w(set)p 1644 5624 V 34 w(compression)p
2159 5624 V 32 w(t)m(yp)s(e)312 b(46)1374 5737 y(\014ts)p
1501 5737 V 32 w(set)p 1644 5737 V 34 w(hdrsize)720 b(97)1374
5850 y(\014ts)p 1501 5850 V 32 w(set)p 1644 5850 V 34
w(hdustruc)648 b(97)2883 543 y(\014ts)p 3010 543 V 33
w(set)p 3154 543 V 33 w(imgn)m(ull)408 b(106)2883 656
y(\014ts)p 3010 656 V 33 w(set)p 3154 656 V 33 w(noise)p
3384 656 V 33 w(bits)372 b(46)2883 769 y(\014ts)p 3010
769 V 33 w(set)p 3154 769 V 33 w(tile)p 3312 769 V 34
w(dim)438 b(46)2883 882 y(\014ts)p 3010 882 V 33 w(set)p
3154 882 V 33 w(tscale)482 b(106)2883 995 y(\014ts)p
3010 995 V 33 w(split)p 3215 995 V 32 w(names)441 b(63)2883
1107 y(\014ts)p 3010 1107 V 33 w(str2date)570 b(61)2883
1220 y(\014ts)p 3010 1220 V 33 w(str2time)565 b(61)2883
1333 y(\014ts)p 3010 1333 V 33 w(test)p 3189 1333 V 33
w(expr)539 b(57)2883 1446 y(\014ts)p 3010 1446 V 33 w(test)p
3189 1446 V 33 w(heap)481 b(111)2883 1559 y(\014ts)p
3010 1559 V 33 w(test)p 3189 1559 V 33 w(k)m(eyw)m(ord)386
b(63)2883 1672 y(\014ts)p 3010 1672 V 33 w(test)p 3189
1672 V 33 w(record)466 b(63)2883 1785 y(\014ts)p 3010
1785 V 33 w(time2str)565 b(61)2883 1898 y(\014ts)p 3010
1898 V 33 w(transfer)p 3350 1898 V 32 w(mem)m(b)s(er)235
b(89)2883 2011 y(\014ts)p 3010 2011 V 33 w(translate)p
3391 2011 V 33 w(k)m(eyw)m(ord)184 b(69)2883 2124 y(\014ts)p
3010 2124 V 33 w(up)s(date)p 3319 2124 V 31 w(card)414
b(39)2883 2237 y(\014ts)p 3010 2237 V 33 w(up)s(date)p
3319 2237 V 31 w(c)m(hksum)287 b(60)2883 2349 y(\014ts)p
3010 2349 V 33 w(up)s(date)p 3319 2349 V 31 w(k)m(ey)453
b(38)2883 2462 y(\014ts)p 3010 2462 V 33 w(up)s(date)p
3319 2462 V 31 w(k)m(ey)p 3483 2462 V 34 w(longstr)100
b(105)2883 2575 y(\014ts)p 3010 2575 V 33 w(up)s(date)p
3319 2575 V 31 w(k)m(ey)p 3483 2575 V 34 w(n)m(ull)270
b(38)2883 2688 y(\014ts)p 3010 2688 V 33 w(up)s(date)p
3319 2688 V 31 w(k)m(ey)p 3483 2688 V 34 w(TYP)177 b(105)2883
2801 y(\014ts)p 3010 2801 V 33 w(upp)s(ercase)500 b(63)2883
2914 y(\014ts)p 3010 2914 V 33 w(url)p 3155 2914 V 32
w(t)m(yp)s(e)575 b(33)2883 3027 y(\014ts)p 3010 3027
V 33 w(v)m(erify)p 3265 3027 V 33 w(c)m(hksum)339 b(60)2883
3140 y(\014ts)p 3010 3140 V 33 w(v)m(erify)p 3265 3140
V 33 w(group)410 b(88)2883 3253 y(\014ts)p 3010 3253
V 33 w(w)m(orld)p 3263 3253 V 32 w(to)p 3375 3253 V 34
w(pix)403 b(83)2883 3366 y(\014ts)p 3010 3366 V 33 w(write)p
3245 3366 V 33 w(2d)p 3374 3366 V 32 w(TYP)288 b(109)2883
3479 y(\014ts)p 3010 3479 V 33 w(write)p 3245 3479 V
33 w(3d)p 3374 3479 V 32 w(TYP)g(109)2883 3591 y(\014ts)p
3010 3591 V 33 w(write)p 3245 3591 V 33 w(atblhdr)364
b(98)2883 3704 y(\014ts)p 3010 3704 V 33 w(write)p 3245
3704 V 33 w(btblhdr)358 b(99)2883 3817 y(\014ts)p 3010
3817 V 33 w(write)p 3245 3817 V 33 w(c)m(hksum)h(60)2883
3930 y(\014ts)p 3010 3930 V 33 w(write)p 3245 3930 V
33 w(col)548 b(54)2883 4043 y(\014ts)p 3010 4043 V 33
w(write)p 3245 4043 V 33 w(col)p 3388 4043 V 33 w(bit)358
b(113)2883 4156 y(\014ts)p 3010 4156 V 33 w(write)p 3245
4156 V 33 w(col)p 3388 4156 V 33 w(TYP)273 b(112)2883
4269 y(\014ts)p 3010 4269 V 33 w(write)p 3245 4269 V
33 w(col)p 3388 4269 V 33 w(n)m(ull)366 b(54)2883 4382
y(\014ts)p 3010 4382 V 33 w(write)p 3245 4382 V 33 w(coln)m(ull)399
b(54)2883 4495 y(\014ts)p 3010 4495 V 33 w(write)p 3245
4495 V 33 w(coln)m(ull)p 3537 4495 V 33 w(TYP)124 b(112)2883
4608 y(\014ts)p 3010 4608 V 33 w(write)p 3245 4608 V
33 w(commen)m(t)298 b(38)2883 4721 y(\014ts)p 3010 4721
V 33 w(write)p 3245 4721 V 33 w(date)487 b(38)2883 4833
y(\014ts)p 3010 4833 V 33 w(write)p 3245 4833 V 33 w(descript)298
b(113)2883 4946 y(\014ts)p 3010 4946 V 33 w(write)p 3245
4946 V 33 w(errmark)341 b(30)2883 5059 y(\014ts)p 3010
5059 V 33 w(write)p 3245 5059 V 33 w(errmsg)389 b(62)2883
5172 y(\014ts)p 3010 5172 V 33 w(write)p 3245 5172 V
33 w(ext)535 b(96)2883 5285 y(\014ts)p 3010 5285 V 33
w(write)p 3245 5285 V 33 w(exthdr)397 b(98)2883 5398
y(\014ts)p 3010 5398 V 33 w(write)p 3245 5398 V 33 w(grphdr)388
b(98)2883 5511 y(\014ts)p 3010 5511 V 33 w(write)p 3245
5511 V 33 w(grppar)p 3542 5511 V 31 w(TYP)121 b(108)2883
5624 y(\014ts)p 3010 5624 V 33 w(write)p 3245 5624 V
33 w(hdu)505 b(34)2883 5737 y(\014ts)p 3010 5737 V 33
w(write)p 3245 5737 V 33 w(history)382 b(38)2883 5850
y(\014ts)p 3010 5850 V 33 w(write)p 3245 5850 V 33 w(img)466
b(108)p eop end
%%Page: 167 175
TeXDict begin 167 174 bop 3764 299 a Fj(167)50 543 y(\014ts)p
177 543 28 4 v 32 w(write)p 411 543 V 33 w(img)p 590
543 V 33 w(n)m(ull)300 b(108)50 656 y(\014ts)p 177 656
V 32 w(write)p 411 656 V 33 w(img)p 590 656 V 33 w(TYP)253
b(108)50 769 y(\014ts)p 177 769 V 32 w(write)p 411 769
V 33 w(imghdr)389 b(98)50 882 y(\014ts)p 177 882 V 32
w(write)p 411 882 V 33 w(imgn)m(ull)333 b(108)50 995
y(\014ts)p 177 995 V 32 w(write)p 411 995 V 33 w(imgn)m(ull)p
739 995 V 33 w(TYP)104 b(108)50 1107 y(\014ts)p 177 1107
V 32 w(write)p 411 1107 V 33 w(k)m(ey)540 b(38)50 1220
y(\014ts)p 177 1220 V 32 w(write)p 411 1220 V 33 w(k)m(ey)p
577 1220 V 34 w(longstr)188 b(100)50 1333 y(\014ts)p
177 1333 V 32 w(write)p 411 1333 V 33 w(k)m(ey)p 577
1333 V 34 w(longw)m(arn)100 b(100)50 1446 y(\014ts)p
177 1446 V 32 w(write)p 411 1446 V 33 w(k)m(ey)p 577
1446 V 34 w(n)m(ull)357 b(38)50 1559 y(\014ts)p 177 1559
V 32 w(write)p 411 1559 V 33 w(k)m(ey)p 577 1559 V 34
w(template)114 b(101)50 1672 y(\014ts)p 177 1672 V 32
w(write)p 411 1672 V 33 w(k)m(ey)p 577 1672 V 34 w(triple)249
b(101)50 1785 y(\014ts)p 177 1785 V 32 w(write)p 411
1785 V 33 w(k)m(ey)p 577 1785 V 34 w(unit)344 b(39)50
1898 y(\014ts)p 177 1898 V 32 w(write)p 411 1898 V 33
w(k)m(ey)p 577 1898 V 34 w(TYP)265 b(100)50 2011 y(\014ts)p
177 2011 V 32 w(write)p 411 2011 V 33 w(k)m(eys)p 613
2011 V 34 w(TYP)229 b(101)50 2124 y(\014ts)p 177 2124
V 32 w(write)p 411 2124 V 33 w(k)m(eys)p 613 2124 V 34
w(histo)278 b(59)50 2237 y(\014ts)p 177 2237 V 32 w(write)p
411 2237 V 33 w(n)m(ull)p 593 2237 V 33 w(img)345 b(43)50
2349 y(\014ts)p 177 2349 V 32 w(write)p 411 2349 V 33
w(n)m(ullro)m(ws)f(54)50 2462 y(\014ts)p 177 2462 V 32
w(write)p 411 2462 V 33 w(pix)549 b(42)50 2575 y(\014ts)p
177 2575 V 32 w(write)p 411 2575 V 33 w(pixn)m(ull)400
b(42)50 2688 y(\014ts)p 177 2688 V 32 w(write)p 411 2688
V 33 w(record)425 b(39)50 2801 y(\014ts)p 177 2801 V
32 w(write)p 411 2801 V 33 w(subset)f(42)50 2914 y(\014ts)p
177 2914 V 32 w(write)p 411 2914 V 33 w(subset)p 693
2914 V 32 w(TYP)151 b(109)50 3027 y(\014ts)p 177 3027
V 32 w(write)p 411 3027 V 33 w(tblb)m(ytes)310 b(112)50
3140 y(\014ts)p 177 3140 V 32 w(write)p 411 3140 V 33
w(tdim)486 b(51)50 3253 y(\014ts)p 177 3253 V 32 w(write)p
411 3253 V 33 w(theap)406 b(111)p eop end
%%Page: 168 176
TeXDict begin 168 175 bop 0 299 a Fj(168)2084 b Fh(APPENDIX)31
b(A.)61 b(INDEX)31 b(OF)f(R)m(OUTINES)50 543 y Fj(\013asfm)276
b(66)50 656 y(\013bnfm)255 b(66)50 769 y(\013calc)311
b(57)50 882 y(\013calc)p 258 882 28 4 v 34 w(rng)145
b(57)50 995 y(\013clos)315 b(33)50 1107 y(\013cmph)197
b(111)50 1220 y(\013cmps)258 b(63)50 1333 y(\013cmrk)j(30)50
1446 y(\013cmsg)j(30)50 1559 y(\013cop)m(y)280 b(34)50
1672 y(\013cp)s(cl)302 b(53)50 1785 y(\013cp)s(dt)281
b(96)50 1898 y(\013cp\015)319 b(34)50 2011 y(\013cphd)268
b(34)50 2124 y(\013cpimg)224 b(44)50 2237 y(\013cpky)k(101)50
2349 y(\013cprw)268 b(53)50 2462 y(\013crhd)283 b(95)50
2575 y(\013crim)h(41)50 2688 y(\013cro)m(w)277 b(56)50
2801 y(\013crtb)299 b(49)50 2914 y(\013dcol)h(52)50 3027
y(\013delt)310 b(33)50 3140 y(\013dhdu)257 b(35)50 3253
y(\013dk)m(ey)277 b(39)50 3366 y(\013dkinit)226 b(32)50
3479 y(\013dk)m(op)s(en)175 b(30)50 3591 y(\013dopn)263
b(30)50 3704 y(\013drec)294 b(39)50 3817 y(\013dro)m(w)266
b(52)50 3930 y(\013drrg)293 b(52)50 4043 y(\013drws)272
b(52)50 4156 y(\013dstr)303 b(39)50 4269 y(\013dsum)247
b(61)50 4382 y(\013dt2s)294 b(61)50 4495 y(\013dtdm)248
b(51)50 4608 y(\013dt)m(yp)279 b(64)50 4721 y(\013eqt)m(y)293
b(50)50 4833 y(\013esum)258 b(61)50 4946 y(\013exest)k(94)50
5059 y(\013extn)287 b(93)50 5172 y(\013\013rw)306 b(56)50
5285 y(\013\015md)283 b(33)50 5398 y(\013\015nm)g(33)50
5511 y(\013\015sh)323 b(94)50 5624 y(\013\015us)g(94)50
5737 y(\013free)271 b(103)50 5850 y(\013fro)m(w)289 b(56)785
543 y(\013g2d)p 984 543 V 191 w(110)785 656 y(\013g3d)p
984 656 V 191 w(110)785 769 y(\013gab)s(c)193 b(66)785
882 y(\013gacl)177 b(110)785 995 y(\013gb)s(cl)168 b(110)785
1107 y(\013gcdw)175 b(51)785 1220 y(\013gcf)264 b(55)785
1333 y(\013gcf)p 956 1333 V 219 w(114)785 1446 y(\013gc)m(ks)211
b(60)785 1559 y(\013gcnn)190 b(49)785 1672 y(\013gcno)196
b(49)785 1785 y(\013gcrd)205 b(36)785 1898 y(\013gcv)244
b(55)785 2011 y(\013gcv)p 976 2011 V 199 w(114)785 2124
y(\013gcx)199 b(116)785 2237 y(\013gdes)160 b(116)785
2349 y(\013gdess)124 b(116)785 2462 y(\013gerr)220 b(29)785
2575 y(\013gextn)158 b(96)785 2688 y(\013ggp)p 984 2688
V 191 w(109)785 2801 y(\013ghad)185 b(95)785 2914 y(\013gh)m(bn)d(99)
785 3027 y(\013ghdn)d(34)785 3140 y(\013ghdt)195 b(34)785
3253 y(\013ghpr)f(99)785 3366 y(\013ghps)g(97)785 3479
y(\013ghsp)g(35)785 3591 y(\013gh)m(tb)k(99)785 3704
y(\013gics)231 b(83)785 3817 y(\013gidm)180 b(41)785
3930 y(\013gidt)221 b(40)785 4043 y(\013giet)232 b(40)785
4156 y(\013gipr)220 b(41)785 4269 y(\013gisz)231 b(41)785
4382 y(\013gk)m(cl)222 b(65)785 4495 y(\013gk)m(ey)199
b(36)785 4608 y(\013gkls)178 b(103)785 4721 y(\013gkn)p
987 4721 V 188 w(103)785 4833 y(\013gknm)157 b(64)785
4946 y(\013gky)236 b(36)785 5059 y(\013gkyn)185 b(36)785
5172 y(\013gkyt)156 b(104)785 5285 y(\013gky)p 984 5285
V 191 w(103)785 5398 y(\013gmcp)165 b(89)785 5511 y(\013gmng)160
b(89)785 5624 y(\013gmop)g(89)785 5737 y(\013gmrm)144
b(90)785 5850 y(\013gmsg)175 b(30)1436 543 y(\013gm)m(tf)368
b(89)1436 656 y(\013gncl)388 b(49)1436 769 y(\013gnrw)351
b(49)1436 882 y(\013gnxk)357 b(37)1436 995 y(\013gpf)380
b(109)1436 1107 y(\013gpf)p 1618 1107 V 380 w(109)1436
1220 y(\013gp)m(v)363 b(109)1436 1333 y(\013gp)m(v)p
1635 1333 V 363 w(109)1436 1446 y(\013gp)m(xv)d(43)1436
1559 y(\013gp)m(xf)380 b(43)1436 1672 y(\013grec)388
b(36)1436 1785 y(\013grsz)347 b(111)1436 1898 y(\013gsdt)382
b(61)1436 2011 y(\013gsf)p 1603 2011 V 228 w(110)32 b(115)1436
2124 y(\013gstm)357 b(61)1436 2237 y(\013gstr)397 b(36)1436
2349 y(\013gsv)p 1623 2349 V 208 w(110)32 b(115)1436
2462 y(\013gtam)348 b(88)1436 2575 y(\013gtbb)322 b(112)1436
2688 y(\013gtc)m(h)381 b(86)1436 2801 y(\013gtcl)404
b(50)1436 2914 y(\013gtcm)353 b(87)1436 3027 y(\013gtcp)378
b(87)1436 3140 y(\013gtcr)393 b(86)1436 3253 y(\013gtcs)g(83)1436
3366 y(\013gtdm)342 b(51)1436 3479 y(\013gthd)367 b(67)1436
3591 y(\013gtis)408 b(86)1436 3704 y(\013gtmg)348 b(87)1436
3817 y(\013gtnm)342 b(88)1436 3930 y(\013gtop)373 b(88)1436
4043 y(\013gtrm)357 b(87)1436 4156 y(\013gtvf)393 b(88)1436
4269 y(\013gun)m(t)370 b(37)1436 4382 y(\013hdef)379
b(97)1436 4495 y(\016bin)399 b(96)1436 4608 y(\016cls)425
b(52)1436 4721 y(\016col)416 b(52)1436 4833 y(\016\014le)410
b(93)1436 4946 y(\016img)380 b(95)1436 5059 y(\016kls)372
b(102)1436 5172 y(\016kyu)334 b(102)1436 5285 y(\016ky)p
1613 5285 V 385 w(102)1436 5398 y(\016mem)g(92)1436 5511
y(\016nit)415 b(32)1436 5624 y(\016n)m(tt)m(yp)312 b(65)1436
5737 y(\016opn)379 b(30)1436 5850 y(\016rec)365 b(102)2259
543 y(\016ro)m(w)226 b(52)2259 656 y(\016tab)239 b(96)2259
769 y(\016ter)259 b(79)2259 882 y(\016url)f(93)2259 995
y(\013k)m(eyn)209 b(64)2259 1107 y(\013mahd)170 b(33)2259
1220 y(\013mcom)156 b(39)2259 1333 y(\013mcrd)144 b(104)2259
1446 y(\013mkls)162 b(104)2259 1559 y(\013mkyu)124 b(105)2259
1672 y(\013mky)p 2489 1672 V 175 w(104)2259 1785 y(\013mnam)145
b(39)2259 1898 y(\013mnhd)164 b(33)2259 2011 y(\013mrec)155
b(104)2259 2124 y(\013mrhd)179 b(33)2259 2237 y(\013m)m(v)m(ec)195
b(53)2259 2349 y(\013nc)m(hk)206 b(64)2259 2462 y(\013nk)m(ey)j(64)2259
2575 y(\013omem)156 b(91)2259 2688 y(\013op)s(en)203
b(30)2259 2801 y(\013p2d)p 2464 2801 V 200 w(109)2259
2914 y(\013p3d)p 2464 2914 V 200 w(109)2259 3027 y(\013p)s(c)m(ks)218
b(60)2259 3140 y(\013p)s(cl)274 b(54)2259 3253 y(\013p)s(cls)192
b(112)2259 3366 y(\013p)s(cl)p 2436 3366 V 228 w(113)2259
3479 y(\013p)s(clu)223 b(54)2259 3591 y(\013p)s(cn)248
b(54)2259 3704 y(\013p)s(cn)p 2462 3704 V 202 w(112)2259
3817 y(\013p)s(com)178 b(38)2259 3930 y(\013p)s(dat)208
b(38)2259 4043 y(\013p)s(des)166 b(113)2259 4156 y(\013p)s(extn)f(96)
2259 4269 y(\013pgp)p 2464 4269 V 200 w(108)2259 4382
y(\013ph)m(bn)192 b(99)2259 4495 y(\013phext)168 b(98)2259
4608 y(\013phis)230 b(38)2259 4721 y(\013phpr)204 b(98)2259
4833 y(\013phps)g(98)2259 4946 y(\013ph)m(tb)k(98)2259
5059 y(\013pkls)187 b(100)2259 5172 y(\013pkn)p 2467
5172 V 197 w(101)2259 5285 y(\013pktp)162 b(101)2259
5398 y(\013pky)246 b(38)2259 5511 y(\013pkyt)165 b(101)2259
5624 y(\013pkyu)195 b(38)2259 5737 y(\013pky)p 2464 5737
V 200 w(100)2259 5850 y(\013plsw)169 b(100)2926 543 y(\013pmrk)199
b(30)2926 656 y(\013pmsg)j(62)2926 769 y(\013pn)m(ul)190
b(106)2926 882 y(\013ppn)212 b(108)2926 995 y(\013ppn)p
3137 995 V 212 w(108)2926 1107 y(\013ppr)227 b(108)2926
1220 y(\013pprn)221 b(43)2926 1333 y(\013ppru)176 b(108)2926
1446 y(\013ppr)p 3122 1446 V 227 w(108)2926 1559 y(\013pp)m(x)263
b(42)2926 1672 y(\013pp)m(xn)212 b(42)2926 1785 y(\013prec)243
b(39)2926 1898 y(\013prwu)206 b(54)2926 2011 y(\013pscl)213
b(106)2926 2124 y(\013pss)287 b(42)2926 2237 y(\013pss)p
3107 2237 V 242 w(109)2926 2349 y(\013psv)m(c)238 b(64)2926
2462 y(\013ptbb)177 b(112)2926 2575 y(\013ptdm)197 b(51)2926
2688 y(\013pthp)177 b(111)2926 2801 y(\013pun)m(t)225
b(39)2926 2914 y(\013rdef)255 b(97)2926 3027 y(\013reop)s(en)144
b(92)2926 3140 y(\013rprt)252 b(30)2926 3253 y(\013rsim)237
b(96)2926 3366 y(\013rtnm)212 b(94)2926 3479 y(\013rwrg)227
b(71)2926 3591 y(\013s2dt)243 b(61)2926 3704 y(\013s2tm)218
b(61)2926 3817 y(\013sn)m(ul)205 b(106)2926 3930 y(\013sro)m(w)230
b(56)2926 4043 y(\013texp)236 b(57)2926 4156 y(\013thdu)222
b(34)2926 4269 y(\013theap)143 b(111)2926 4382 y(\013tk)m(ey)242
b(63)2926 4495 y(\013tm2s)218 b(61)2926 4608 y(\013tn)m(ul)206
b(106)2926 4721 y(\013topn)228 b(30)2926 4833 y(\013tplt)264
b(92)2926 4946 y(\013trec)259 b(63)2926 5059 y(\013tscl)229
b(106)2926 5172 y(\013ucrd)j(39)2926 5285 y(\013ukls)205
b(105)2926 5398 y(\013uky)263 b(38)2926 5511 y(\013ukyu)212
b(38)2926 5624 y(\013uky)p 3131 5624 V 218 w(105)2926
5737 y(\013up)s(c)m(h)217 b(63)2926 5850 y(\013up)s(c)m(k)j(60)p
eop end
%%Page: 169 177
TeXDict begin 169 176 bop 3764 299 a Fj(169)50 543 y(\013urlt)205
b(33)50 656 y(\013v)m(c)m(ks)186 b(60)50 769 y(\013v)m(ers)195
b(62)50 882 y(\013wldp)159 b(83)50 995 y(\013wrhdu)97
b(34)50 1107 y(\013xyp)m(x)160 b(83)p eop end
%%Page: 170 178
TeXDict begin 170 177 bop 0 299 a Fj(170)2084 b Fh(APPENDIX)31
b(A.)61 b(INDEX)31 b(OF)f(R)m(OUTINES)p eop end
%%Page: 171 179
TeXDict begin 171 178 bop 0 1225 a Fg(App)5 b(endix)64
b(B)0 1687 y Fm(P)-6 b(arameter)77 b(De\014nitions)0
2180 y Fe(anynul)142 b(-)47 b(set)g(to)g(TRUE)g(\(=1\))f(if)i(any)e
(returned)g(values)g(are)h(undefined,)e(else)i(FALSE)0
2293 y(array)190 b(-)47 b(array)f(of)i(numerical)d(data)h(values)h(to)g
(read)f(or)i(write)0 2406 y(ascii)190 b(-)47 b(encoded)f(checksum)f
(string)0 2518 y(binspec)94 b(-)47 b(the)g(input)f(table)h(binning)e
(specifier)0 2631 y(bitpix)142 b(-)47 b(bits)g(per)g(pixel.)f(The)h
(following)e(symbolic)g(mnemonics)h(are)h(predefined:)716
2744 y(BYTE_IMG)141 b(=)i(8)47 b(\(unsigned)f(char\))716
2857 y(SHORT_IMG)93 b(=)i(16)47 b(\(signed)f(short)g(integer\))716
2970 y(LONG_IMG)141 b(=)95 b(32)47 b(\(signed)f(long)h(integer\))716
3083 y(LONGLONG_IMG)d(=)96 b(64)47 b(\(signed)f(long)g(64-bit)g
(integer\))716 3196 y(FLOAT_IMG)93 b(=)47 b(-32)g(\(float\))716
3309 y(DOUBLE_IMG)e(=)i(-64)g(\(double\).)525 3422 y(The)g
(LONGLONG_IMG)d(type)j(is)g(experimental)e(and)i(is)g(not)g(officially)
525 3535 y(recognized)e(in)i(the)g(FITS)g(Standard)e(document.)525
3648 y(Two)i(additional)e(values,)h(USHORT_IMG)f(and)i(ULONG_IMG)e(are)
i(also)f(available)525 3760 y(for)h(creating)e(unsigned)h(integer)g
(images.)93 b(These)47 b(are)g(equivalent)e(to)525 3873
y(creating)h(a)h(signed)f(integer)g(image)g(with)h(BZERO)f(offset)g
(keyword)g(values)525 3986 y(of)h(32768)g(or)g(2147483648,)d
(respectively,)h(which)h(is)h(the)g(convention)e(that)525
4099 y(FITS)i(uses)f(to)h(store)g(unsigned)e(integers.)0
4212 y(card)238 b(-)47 b(header)f(record)g(to)h(be)h(read)e(or)h
(written)f(\(80)h(char)g(max,)f(null-terminated\))0 4325
y(casesen)94 b(-)47 b(CASESEN)f(\(=1\))g(for)h(case-sensitive)d(string)
i(matching,)g(else)g(CASEINSEN)g(\(=0\))0 4438 y(cmopt)190
b(-)47 b(grouping)f(table)g("compact")f(option)h(parameter.)f(Allowed)h
(values)g(are:)525 4551 y(OPT_CMT_MBR)f(and)i(OPT_CMT_MBR_DEL.)0
4664 y(colname)94 b(-)47 b(name)g(of)g(the)g(column)f
(\(null-terminated\))0 4777 y(colnum)142 b(-)47 b(column)f(number)g
(\(first)g(column)g(=)i(1\))0 4890 y(colspec)94 b(-)47
b(the)g(input)f(file)h(column)f(specification;)e(used)j(to)g(delete,)f
(create,)f(or)j(rename)525 5002 y(table)e(columns)0 5115
y(comment)94 b(-)47 b(the)g(keyword)f(comment)g(field)g(\(72)h(char)f
(max,)h(null-terminated\))0 5228 y(complm)142 b(-)47
b(should)f(the)h(checksum)f(be)h(complemented?)0 5341
y(comptype)f(-)h(compression)e(algorithm)g(to)i(use:)g(GZIP_1,)f
(RICE_1,)f(HCOMPRESS_1,)g(or)i(PLIO_1)0 5454 y(coordtype-)e(type)i(of)g
(coordinate)e(projection)g(\(-SIN,)h(-TAN,)g(-ARC,)h(-NCP,)525
5567 y(-GLS,)f(-MER,)h(or)g(-AIT\))0 5680 y(cpopt)190
b(-)47 b(grouping)f(table)g(copy)h(option)f(parameter.)f(Allowed)g
(values)i(are:)1882 5942 y Fj(171)p eop end
%%Page: 172 180
TeXDict begin 172 179 bop 0 299 a Fj(172)1822 b Fh(APPENDIX)31
b(B.)61 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)525 555 y
Fe(OPT_GCP_GPT,)44 b(OPT_GCP_MBR,)h(OPT_GCP_ALL,)f(OPT_MCP_ADD,)h
(OPT_MCP_NADD,)525 668 y(OPT_MCP_REPL,)f(amd)j(OPT_MCP_MOV.)0
781 y(create_col-)e(If)i(TRUE,)f(then)h(insert)f(a)h(new)g(column)f(in)
i(the)f(table,)f(otherwise)525 894 y(overwrite)f(the)i(existing)f
(column.)0 1007 y(current)94 b(-)47 b(if)g(TRUE,)g(then)f(the)h
(current)f(HDU)h(will)f(be)i(copied)0 1120 y(dataok)142
b(-)47 b(was)g(the)g(data)f(unit)h(verification)e(successful)g(\(=1\))h
(or)525 1233 y(not)h(\(=)g(-1\).)94 b(Equals)47 b(zero)f(if)h(the)g
(DATASUM)f(keyword)g(is)h(not)g(present.)0 1346 y(datasum)94
b(-)47 b(32-bit)f(1's)h(complement)e(checksum)h(for)g(the)h(data)g
(unit)0 1458 y(dataend)94 b(-)47 b(address)f(\(in)h(bytes\))f(of)h(the)
g(end)g(of)g(the)g(HDU)0 1571 y(datastart-)e(address)h(\(in)h(bytes\))f
(of)h(the)g(start)f(of)h(the)g(data)g(unit)0 1684 y(datatype)f(-)h
(specifies)e(the)i(data)g(type)f(of)i(the)f(value.)93
b(Allowed)46 b(value)h(are:)94 b(TSTRING,)525 1797 y(TLOGICAL,)45
b(TBYTE,)h(TSBYTE,)g(TSHORT,)g(TUSHORT,)g(TINT,)g(TUINT,)g(TLONG,)g
(TULONG,)525 1910 y(TFLOAT,)g(TDOUBLE,)f(TCOMPLEX,)h(and)h(TDBLCOMPLEX)
0 2023 y(datestr)94 b(-)47 b(FITS)g(date/time)e(string:)h
('YYYY-MM-DDThh:mm:ss.dd)o(d',)41 b('YYYY-MM-dd',)525
2136 y(or)47 b('dd/mm/yy')0 2249 y(day)286 b(-)47 b(calendar)f(day)g
(\(UTC\))h(\(1-31\))0 2362 y(decimals)f(-)h(number)f(of)h(decimal)f
(places)g(to)h(be)h(displayed)0 2475 y(deltasize)d(-)j(increment)d(for)
i(allocating)e(more)i(memory)0 2588 y(dim1)238 b(-)47
b(declared)f(size)g(of)h(the)g(first)g(dimension)e(of)i(the)g(image)f
(or)i(cube)e(array)0 2700 y(dim2)238 b(-)47 b(declared)f(size)g(of)h
(the)g(second)f(dimension)g(of)h(the)g(data)f(cube)h(array)0
2813 y(dispwidth)e(-)j(display)e(width)g(of)h(a)h(column)e(=)h(length)f
(of)h(string)f(that)h(will)g(be)g(read)0 2926 y(dtype)190
b(-)47 b(data)g(type)f(of)h(the)g(keyword)f(\('C',)h('L',)f('I',)h('F')
g(or)g('X'\))764 3039 y(C)g(=)h(character)d(string)764
3152 y(L)i(=)h(logical)764 3265 y(I)f(=)h(integer)764
3378 y(F)f(=)h(floating)d(point)h(number)764 3491 y(X)h(=)h(complex,)d
(e.g.,)h("\(1.23,)g(-4.56\)")0 3604 y(err_msg)94 b(-)47
b(error)f(message)g(on)h(the)g(internal)f(stack)g(\(80)h(chars)f(max\))
0 3717 y(err_text)g(-)h(error)f(message)g(string)g(corresponding)e(to)k
(error)e(number)g(\(30)h(chars)f(max\))0 3830 y(exact)190
b(-)47 b(TRUE)g(\(=1\))f(if)h(the)g(strings)f(match)h(exactly;)525
3942 y(FALSE)f(\(=0\))h(if)g(wildcards)e(are)i(used)0
4055 y(exclist)94 b(-)47 b(array)f(of)i(pointers)d(to)i(keyword)f
(names)g(to)i(be)f(excluded)e(from)i(search)0 4168 y(exists)142
b(-)47 b(flag)g(indicating)e(whether)g(the)i(file)g(or)g(compressed)e
(file)i(exists)f(on)h(disk)0 4281 y(expr)238 b(-)47 b(boolean)f(or)h
(arithmetic)e(expression)0 4394 y(extend)142 b(-)47 b(TRUE)g(\(=1\))f
(if)h(FITS)g(file)g(may)g(have)f(extensions,)f(else)i(FALSE)f(\(=0\))0
4507 y(extname)94 b(-)47 b(value)f(of)i(the)e(EXTNAME)g(keyword)g
(\(null-terminated\))0 4620 y(extspec)94 b(-)47 b(the)g(extension)e(or)
i(HDU)g(specifier;)e(a)j(number)e(or)h(name,)f(version,)g(and)h(type)0
4733 y(extver)142 b(-)47 b(value)f(of)i(the)e(EXTVER)h(keyword)e(=)j
(integer)e(version)f(number)0 4846 y(filename)h(-)h(full)g(name)f(of)h
(the)g(FITS)g(file,)f(including)g(optional)f(HDU)i(and)g(filtering)e
(specs)0 4959 y(filetype)h(-)h(type)g(of)g(file)f(\(file://,)g(ftp://,)
g(http://,)f(etc.\))0 5072 y(filter)142 b(-)47 b(the)g(input)f(file)h
(filtering)e(specifier)0 5185 y(firstchar-)g(starting)h(byte)g(in)h
(the)g(row)g(\(first)f(byte)h(of)g(row)g(=)g(1\))0 5297
y(firstfailed)e(-)i(member)f(HDU)h(ID)g(\(if)g(positive\))f(or)h
(grouping)e(table)i(GRPIDn)f(index)525 5410 y(value)g(\(if)h
(negative\))f(that)g(failed)g(grouping)g(table)g(verification.)0
5523 y(firstelem-)f(first)h(element)g(in)h(a)h(vector)e(\(ignored)f
(for)i(ASCII)g(tables\))0 5636 y(firstrow)f(-)h(starting)f(row)g
(number)h(\(first)f(row)h(of)g(table)f(=)i(1\))p eop
end
%%Page: 173 181
TeXDict begin 173 180 bop 3764 299 a Fj(173)0 555 y Fe(following-)45
b(if)i(TRUE,)g(any)f(HDUs)h(following)e(the)i(current)f(HDU)h(will)g
(be)g(copied)0 668 y(fpixel)142 b(-)47 b(coordinate)e(of)i(the)g(first)
f(pixel)h(to)g(be)g(read)g(or)g(written)f(in)h(the)525
781 y(FITS)g(array.)93 b(The)47 b(array)g(must)f(be)i(of)f(length)f
(NAXIS)g(and)h(have)g(values)f(such)525 894 y(that)h(fpixel[0])e(is)i
(in)g(the)g(range)g(1)g(to)g(NAXIS1,)f(fpixel[1])f(is)i(in)h(the)525
1007 y(range)e(1)i(to)f(NAXIS2,)f(etc.)0 1120 y(fptr)238
b(-)47 b(pointer)f(to)h(a)g('fitsfile')e(structure)h(describing)f(the)i
(FITS)f(file.)0 1233 y(frac)238 b(-)47 b(factional)e(part)i(of)g(the)g
(keyword)f(value)0 1346 y(gcount)142 b(-)47 b(number)f(of)h(groups)f
(in)i(the)e(primary)g(array)h(\(usually)e(=)j(1\))0 1458
y(gfptr)190 b(-)47 b(fitsfile*)e(pointer)h(to)h(a)h(grouping)d(table)i
(HDU.)0 1571 y(group)190 b(-)47 b(GRPIDn/GRPLCn)d(index)j(value)f
(identifying)f(a)i(grouping)f(table)g(HDU,)h(or)525 1684
y(data)g(group)f(number)g(\(=0)h(for)g(non-grouped)e(data\))0
1797 y(grouptype)g(-)j(Grouping)d(table)i(parameter)e(that)i(specifies)
e(the)i(columns)f(to)h(be)525 1910 y(created)f(in)h(a)g(grouping)f
(table)g(HDU.)h(Allowed)f(values)g(are:)h(GT_ID_ALL_URI,)525
2023 y(GT_ID_REF,)e(GT_ID_POS,)g(GT_ID_ALL,)g(GT_ID_REF_URI,)f(and)j
(GT_ID_POS_URI.)0 2136 y(grpname)94 b(-)47 b(value)f(to)i(use)e(for)h
(the)g(GRPNAME)f(keyword)g(value.)0 2249 y(hdunum)142
b(-)47 b(sequence)f(number)g(of)h(the)g(HDU)g(\(Primary)e(array)i(=)g
(1\))0 2362 y(hduok)190 b(-)47 b(was)g(the)g(HDU)g(verification)d
(successful)h(\(=1\))i(or)525 2475 y(not)g(\(=)g(-1\).)94
b(Equals)47 b(zero)f(if)h(the)g(CHECKSUM)f(keyword)g(is)h(not)g
(present.)0 2588 y(hdusum)142 b(-)47 b(32)g(bit)g(1's)g(complement)e
(checksum)h(for)g(the)h(entire)f(CHDU)0 2700 y(hdutype)94
b(-)47 b(HDU)g(type:)f(IMAGE_HDU)g(\(0\),)g(ASCII_TBL)f(\(1\),)i
(BINARY_TBL)e(\(2\),)i(ANY_HDU)f(\(-1\))0 2813 y(header)142
b(-)47 b(returned)f(character)f(string)h(containing)f(all)i(the)g
(keyword)f(records)0 2926 y(headstart-)f(starting)h(address)f(\(in)i
(bytes\))f(of)i(the)e(CHDU)0 3039 y(heapsize)g(-)h(size)g(of)g(the)g
(binary)f(table)g(heap,)h(in)g(bytes)0 3152 y(history)94
b(-)47 b(the)g(HISTORY)f(keyword)g(comment)f(string)h(\(70)h(char)g
(max,)g(null-terminated\))0 3265 y(hour)238 b(-)47 b(hour)g(within)f
(day)h(\(UTC\))f(\(0)h(-)h(23\))0 3378 y(inc)286 b(-)47
b(sampling)f(interval)f(for)i(pixels)f(in)h(each)g(FITS)g(dimension)0
3491 y(inclist)94 b(-)47 b(array)f(of)i(pointers)d(to)i(matching)f
(keyword)g(names)0 3604 y(incolnum)g(-)h(input)f(column)g(number;)g
(range)h(=)g(1)h(to)f(TFIELDS)0 3717 y(infile)142 b(-)47
b(the)g(input)f(filename,)g(including)f(path)h(if)i(specified)0
3830 y(infptr)142 b(-)47 b(pointer)f(to)h(a)g('fitsfile')e(structure)h
(describing)f(the)i(input)f(FITS)h(file.)0 3942 y(intval)142
b(-)47 b(integer)f(part)g(of)i(the)f(keyword)e(value)0
4055 y(iomode)142 b(-)47 b(file)g(access)f(mode:)g(either)g(READONLY)g
(\(=0\))g(or)i(READWRITE)d(\(=1\))0 4168 y(keyname)94
b(-)47 b(name)g(of)g(a)g(keyword)f(\(8)h(char)g(max,)g
(null-terminated\))0 4281 y(keynum)142 b(-)47 b(position)f(of)h
(keyword)f(in)h(header)f(\(1st)g(keyword)g(=)i(1\))0
4394 y(keyroot)94 b(-)47 b(root)g(string)f(for)h(the)g(keyword)e(name)i
(\(5)g(char)g(max,)f(null-terminated\))0 4507 y(keysexist-)f(number)h
(of)h(existing)f(keyword)g(records)f(in)j(the)f(CHU)0
4620 y(keytype)94 b(-)47 b(header)f(record)g(type:)h(-1=delete;)92
b(0=append)46 b(or)h(replace;)907 4733 y(1=append;)e(2=this)h(is)h(the)
g(END)g(keyword)0 4846 y(longstr)94 b(-)47 b(arbitrarily)e(long)h
(string)g(keyword)g(value)h(\(null-terminated\))0 4959
y(lpixel)142 b(-)47 b(coordinate)e(of)i(the)g(last)g(pixel)f(to)h(be)g
(read)g(or)g(written)f(in)h(the)525 5072 y(FITS)g(array.)93
b(The)47 b(array)g(must)f(be)i(of)f(length)f(NAXIS)g(and)h(have)g
(values)f(such)525 5185 y(that)h(lpixel[0])e(is)i(in)g(the)g(range)g(1)
g(to)g(NAXIS1,)f(lpixel[1])f(is)i(in)h(the)525 5297 y(range)e(1)i(to)f
(NAXIS2,)f(etc.)0 5410 y(match)190 b(-)47 b(TRUE)g(\(=1\))f(if)h(the)g
(2)h(strings)e(match,)g(else)g(FALSE)h(\(=0\))0 5523
y(maxdim)142 b(-)47 b(maximum)f(number)g(of)h(values)f(to)h(return)0
5636 y(member)142 b(-)47 b(row)g(number)f(of)h(a)h(grouping)d(table)i
(member)f(HDU.)p eop end
%%Page: 174 182
TeXDict begin 174 181 bop 0 299 a Fj(174)1822 b Fh(APPENDIX)31
b(B.)61 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)0 555 y Fe(memptr)142
b(-)47 b(pointer)f(to)h(the)g(a)g(FITS)g(file)g(in)g(memory)0
668 y(mem_realloc)e(-)i(pointer)f(to)h(a)h(function)d(for)i
(reallocating)e(more)h(memory)0 781 y(memsize)94 b(-)47
b(size)g(of)g(the)g(memory)f(block)g(allocated)f(for)i(the)g(FITS)g
(file)0 894 y(mfptr)190 b(-)47 b(fitsfile*)e(pointer)h(to)h(a)h
(grouping)d(table)i(member)f(HDU.)0 1007 y(mgopt)190
b(-)47 b(grouping)f(table)g(merge)g(option)g(parameter.)f(Allowed)h
(values)g(are:)525 1120 y(OPT_MRG_COPY,)e(and)j(OPT_MRG_MOV.)0
1233 y(minute)142 b(-)47 b(minute)f(within)g(hour)h(\(UTC\))f(\(0)h(-)h
(59\))0 1346 y(month)190 b(-)47 b(calendar)f(month)g(\(UTC\))g(\(1)h(-)
h(12\))0 1458 y(morekeys)e(-)h(space)f(in)i(the)e(header)h(for)f(this)h
(many)g(more)f(keywords)0 1571 y(n_good_rows)f(-)i(number)f(of)h(rows)g
(evaluating)e(to)i(TRUE)0 1684 y(namelist)f(-)h(string)f(containing)f
(a)j(comma)e(or)h(space)f(delimited)g(list)g(of)i(names)0
1797 y(naxes)190 b(-)47 b(size)g(of)g(each)f(dimension)g(in)h(the)g
(FITS)f(array)0 1910 y(naxis)190 b(-)47 b(number)f(of)h(dimensions)e
(in)i(the)g(FITS)g(array)0 2023 y(naxis1)142 b(-)47 b(length)f(of)h
(the)g(X/first)f(axis)h(of)g(the)g(FITS)f(array)0 2136
y(naxis2)142 b(-)47 b(length)f(of)h(the)g(Y/second)f(axis)g(of)i(the)e
(FITS)h(array)0 2249 y(naxis3)142 b(-)47 b(length)f(of)h(the)g(Z/third)
f(axis)h(of)g(the)g(FITS)f(array)0 2362 y(nbytes)142
b(-)47 b(number)f(of)h(bytes)g(or)g(characters)e(to)i(read)g(or)g
(write)0 2475 y(nchars)142 b(-)47 b(number)f(of)h(characters)e(to)i
(read)g(or)g(write)0 2588 y(nelements-)e(number)h(of)h(data)g(elements)
e(to)j(read)e(or)h(write)0 2700 y(newfptr)94 b(-)47 b(returned)f
(pointer)f(to)j(the)e(reopened)g(file)0 2813 y(newveclen-)f(new)i
(value)f(for)h(the)g(column)f(vector)g(repeat)g(parameter)0
2926 y(nexc)238 b(-)47 b(number)f(of)h(names)g(in)g(the)g(exclusion)e
(list)i(\(may)f(=)i(0\))0 3039 y(nfound)142 b(-)47 b(number)f(of)h
(keywords)f(found)g(\(highest)g(keyword)g(number\))0
3152 y(nkeys)190 b(-)47 b(number)f(of)h(keywords)f(in)h(the)g(sequence)
0 3265 y(ninc)238 b(-)47 b(number)f(of)h(names)g(in)g(the)g(inclusion)e
(list)0 3378 y(nmembers)h(-)h(Number)f(of)h(grouping)f(table)g(members)
g(\(NAXIS2)g(value\).)0 3491 y(nmove)190 b(-)47 b(number)f(of)h(HDUs)g
(to)g(move)g(\(+)g(or)g(-\),)g(relative)f(to)h(current)f(position)0
3604 y(nocomments)f(-)i(if)h(equal)e(to)h(TRUE,)g(then)f(no)h
(commentary)e(keywords)h(will)h(be)g(copied)0 3717 y(noisebits-)e
(number)h(of)h(bits)g(to)g(ignore)f(when)h(compressing)e(floating)g
(point)h(images)0 3830 y(nrows)190 b(-)47 b(number)f(of)h(rows)g(in)g
(the)g(table)0 3942 y(nstart)142 b(-)47 b(first)f(integer)g(value)0
4055 y(nullarray-)f(set)i(to)g(TRUE)g(\(=1\))f(if)i(corresponding)c
(data)i(element)g(is)h(undefined)0 4168 y(nulval)142
b(-)47 b(numerical)e(value)i(to)g(represent)e(undefined)g(pixels)0
4281 y(nulstr)142 b(-)47 b(character)e(string)h(used)h(to)g(represent)e
(undefined)h(values)g(in)h(ASCII)f(table)0 4394 y(numval)142
b(-)47 b(numerical)e(data)i(value,)f(of)h(the)g(appropriate)e(data)h
(type)0 4507 y(offset)142 b(-)47 b(byte)g(offset)f(in)h(the)g(heap)f
(or)i(data)e(unit)h(to)g(the)g(first)f(element)g(of)h(the)g(vector)0
4620 y(openfptr)f(-)h(pointer)f(to)h(a)g(currently)f(open)g(FITS)h
(file)0 4733 y(overlap)94 b(-)47 b(number)f(of)h(bytes)g(in)g(the)g
(binary)f(table)g(heap)h(pointed)f(to)h(by)g(more)g(than)f(1)525
4846 y(descriptor)0 4959 y(outcolnum-)f(output)h(column)g(number;)g
(range)g(=)i(1)f(to)g(TFIELDS)f(+)i(1)0 5072 y(outfile)94
b(-)47 b(and)g(optional)e(output)i(filename;)e(the)i(input)f(file)h
(will)f(be)i(copied)e(to)h(this)f(prior)525 5185 y(to)h(opening)f(the)h
(file)0 5297 y(outfptr)94 b(-)47 b(pointer)f(to)h(a)g('fitsfile')e
(structure)h(describing)f(the)i(output)f(FITS)g(file.)0
5410 y(pcount)142 b(-)47 b(value)f(of)i(the)e(PCOUNT)h(keyword)e(=)j
(size)e(of)i(binary)e(table)g(heap)0 5523 y(previous)g(-)h(if)g(TRUE,)g
(any)f(previous)g(HDUs)h(in)g(the)g(input)f(file)h(will)f(be)i(copied.)
0 5636 y(repeat)142 b(-)47 b(length)f(of)h(column)f(vector)g(\(e.g.)h
(12J\);)f(==)h(1)h(for)f(ASCII)f(table)p eop end
%%Page: 175 183
TeXDict begin 175 182 bop 3764 299 a Fj(175)0 555 y Fe(rmopt)190
b(-)47 b(grouping)f(table)g(remove)g(option)g(parameter.)f(Allowed)h
(values)g(are:)525 668 y(OPT_RM_GPT,)f(OPT_RM_ENTRY,)f(OPT_RM_MBR,)h
(and)i(OPT_RM_ALL.)0 781 y(rootname)f(-)h(root)g(filename,)e(minus)h
(any)h(extension)e(or)j(filtering)d(specifications)0
894 y(rot)286 b(-)47 b(celestial)e(coordinate)g(rotation)h(angle)g
(\(degrees\))0 1007 y(rowlen)142 b(-)47 b(length)f(of)h(a)h(table)e
(row,)h(in)g(characters)e(or)i(bytes)0 1120 y(rowlist)94
b(-)47 b(sorted)f(list)h(of)g(row)g(numbers)f(to)h(be)g(deleted)f(from)
g(the)h(table)0 1233 y(rownum)142 b(-)47 b(number)f(of)h(the)g(row)g
(\(first)f(row)h(=)h(1\))0 1346 y(rowrange)e(-)h(list)g(of)g(rows)f(or)
i(row)f(ranges:)e('3,6-8,12,56-80')f(or)j('500-')0 1458
y(row_status)e(-)i(array)g(of)g(True/False)e(results)h(for)h(each)f
(row)h(that)g(was)g(evaluated)0 1571 y(scale)190 b(-)47
b(linear)f(scaling)g(factor;)g(true)g(value)h(=)g(\(FITS)g(value\))f(*)
h(scale)f(+)i(zero)0 1684 y(second)142 b(-)47 b(second)f(within)g
(minute)g(\(0)h(-)h(60.9999999999\))c(\(leap)i(second!\))0
1797 y(section)94 b(-)47 b(section)f(of)h(image)f(to)i(be)f(copied)f
(\(e.g.)g(21:80,101:200\))0 1910 y(simple)142 b(-)47
b(TRUE)g(\(=1\))f(if)h(FITS)g(file)g(conforms)e(to)i(the)g(Standard,)f
(else)g(FALSE)h(\(=0\))0 2023 y(space)190 b(-)47 b(number)f(of)h(blank)
g(spaces)f(to)h(leave)f(between)g(ASCII)g(table)h(columns)0
2136 y(status)142 b(-)47 b(returned)f(error)g(status)g(code)h(\(0)g(=)g
(OK\))0 2249 y(sum)286 b(-)47 b(32)g(bit)g(unsigned)f(checksum)f(value)
0 2362 y(tbcol)190 b(-)47 b(byte)g(position)e(in)i(row)g(to)g(start)g
(of)g(column)f(\(1st)h(col)g(has)g(tbcol)f(=)h(1\))0
2475 y(tdisp)190 b(-)47 b(Fortran)f(style)g(display)g(format)g(for)h
(the)g(table)f(column)0 2588 y(tdimstr)94 b(-)47 b(the)g(value)f(of)h
(the)g(TDIMn)g(keyword)0 2700 y(templt)142 b(-)47 b(template)f(string)g
(used)g(in)h(comparison)e(\(null-terminated\))0 2813
y(tfields)94 b(-)47 b(number)f(of)h(fields)f(\(columns\))g(in)h(the)g
(table)0 2926 y(tfopt)190 b(-)47 b(grouping)f(table)g(member)g
(transfer)g(option)g(parameter.)f(Allowed)g(values)i(are:)525
3039 y(OPT_MCP_ADD,)d(and)j(OPT_MCP_MOV.)0 3152 y(tform)190
b(-)47 b(format)f(of)h(the)g(column)f(\(null-terminated\);)d(allowed)j
(values)g(are:)525 3265 y(ASCII)g(tables:)94 b(Iw,)47
b(Aw,)g(Fww.dd,)f(Eww.dd,)f(or)j(Dww.dd)525 3378 y(Binary)e(tables:)g
(rL,)h(rX,)g(rB,)g(rI,)g(rJ,)f(rA,)h(rAw,)g(rE,)g(rD,)g(rC,)g(rM)525
3491 y(where)f('w'=width)g(of)h(the)g(field,)f('d'=no.)g(of)h
(decimals,)e('r'=repeat)g(count.)525 3604 y(Variable)h(length)g(array)g
(columns)g(are)h(denoted)f(by)h(a)g('1P')g(before)f(the)h(data)f(type)
525 3717 y(character)f(\(e.g.,)h('1PJ'\).)94 b(When)47
b(creating)e(a)j(binary)e(table,)g(2)h(addition)f(tform)525
3830 y(data)h(type)f(codes)h(are)g(recognized)e(by)i(CFITSIO:)e('rU')i
(and)g('rV')f(for)h(unsigned)525 3942 y(16-bit)f(and)h(unsigned)f
(32-bit)g(integer,)f(respectively.)0 4168 y(theap)190
b(-)47 b(zero)g(indexed)e(byte)i(offset)f(of)h(starting)f(address)g(of)
h(the)g(heap)525 4281 y(relative)f(to)h(the)g(beginning)e(of)i(the)g
(binary)f(table)g(data)0 4394 y(tilesize)g(-)h(array)f(of)i(length)e
(NAXIS)g(that)h(specifies)e(the)i(dimensions)e(of)525
4507 y(the)i(image)f(compression)f(tiles)0 4620 y(ttype)190
b(-)47 b(label)f(or)i(name)e(for)h(table)f(column)h
(\(null-terminated\))0 4733 y(tunit)190 b(-)47 b(physical)f(unit)g(for)
h(table)f(column)h(\(null-terminated\))0 4846 y(typechar)f(-)h
(symbolic)f(code)g(of)h(the)g(table)g(column)f(data)g(type)0
4959 y(typecode)g(-)h(data)g(type)f(code)h(of)g(the)g(table)f(column.)
94 b(The)47 b(negative)e(of)525 5072 y(the)i(value)f(indicates)g(a)h
(variable)f(length)g(array)g(column.)764 5185 y(Datatype)618
b(typecode)189 b(Mnemonic)764 5297 y(bit,)46 b(X)907
b(1)381 b(TBIT)764 5410 y(byte,)46 b(B)811 b(11)381 b(TBYTE)764
5523 y(logical,)45 b(L)668 b(14)381 b(TLOGICAL)764 5636
y(ASCII)46 b(character,)f(A)286 b(16)381 b(TSTRING)p
eop end
%%Page: 176 184
TeXDict begin 176 183 bop 0 299 a Fj(176)1822 b Fh(APPENDIX)31
b(B.)61 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)764 555 y
Fe(short)46 b(integer,)g(I)381 b(21)g(TSHORT)764 668
y(integer,)45 b(J)668 b(41)381 b(TINT32BIT)46 b(\(same)g(as)h(TLONG\))
764 781 y(long)f(long)h(integer,)e(K)191 b(81)381 b(TLONGLONG)764
894 y(real,)46 b(E)811 b(42)381 b(TFLOAT)764 1007 y(double)46
b(precision,)f(D)238 b(82)381 b(TDOUBLE)764 1120 y(complex,)45
b(C)668 b(83)381 b(TCOMPLEX)764 1233 y(double)46 b(complex,)f(M)286
b(163)381 b(TDBLCOMPLEX)0 1346 y(unit)238 b(-)47 b(the)g(physical)e
(unit)i(string)f(\(e.g.,)g('km/s'\))g(for)h(a)g(keyword)0
1458 y(unused)142 b(-)47 b(number)f(of)h(unused)f(bytes)h(in)g(the)g
(binary)f(table)g(heap)0 1571 y(urltype)94 b(-)47 b(the)g(file)g(type)f
(of)h(the)g(FITS)g(file)g(\(file://,)e(ftp://,)h(mem://,)f(etc.\))0
1684 y(validheap-)g(returned)h(value)g(=)h(FALSE)g(if)g(any)g(of)g(the)
g(variable)e(length)i(array)525 1797 y(address)f(are)h(outside)f(the)g
(valid)h(range)f(of)h(addresses)f(in)h(the)g(heap)0 1910
y(value)190 b(-)47 b(the)g(keyword)f(value)g(string)g(\(70)h(char)g
(max,)f(null-terminated\))0 2023 y(version)94 b(-)47
b(current)f(version)g(number)g(of)h(the)g(CFITSIO)f(library)0
2136 y(width)190 b(-)47 b(width)f(of)i(the)e(character)g(string)g
(field)0 2249 y(xcol)238 b(-)47 b(number)f(of)h(the)g(column)f
(containing)f(the)i(X)h(coordinate)d(values)0 2362 y(xinc)238
b(-)47 b(X)g(axis)g(coordinate)e(increment)g(at)j(reference)d(pixel)h
(\(deg\))0 2475 y(xpix)238 b(-)47 b(X)g(axis)g(pixel)f(location)0
2588 y(xpos)238 b(-)47 b(X)g(axis)g(celestial)e(coordinate)g(\(usually)
h(RA\))h(\(deg\))0 2700 y(xrefpix)94 b(-)47 b(X)g(axis)g(reference)e
(pixel)i(array)f(location)0 2813 y(xrefval)94 b(-)47
b(X)g(axis)g(coordinate)e(value)h(at)i(the)f(reference)e(pixel)h
(\(deg\))0 2926 y(ycol)238 b(-)47 b(number)f(of)h(the)g(column)f
(containing)f(the)i(X)h(coordinate)d(values)0 3039 y(year)238
b(-)47 b(calendar)f(year)g(\(e.g.)h(1999,)f(2000,)g(etc\))0
3152 y(yinc)238 b(-)47 b(Y)g(axis)g(coordinate)e(increment)g(at)j
(reference)d(pixel)h(\(deg\))0 3265 y(ypix)238 b(-)47
b(y)g(axis)g(pixel)f(location)0 3378 y(ypos)238 b(-)47
b(y)g(axis)g(celestial)e(coordinate)g(\(usually)h(DEC\))h(\(deg\))0
3491 y(yrefpix)94 b(-)47 b(Y)g(axis)g(reference)e(pixel)i(array)f
(location)0 3604 y(yrefval)94 b(-)47 b(Y)g(axis)g(coordinate)e(value)h
(at)i(the)f(reference)e(pixel)h(\(deg\))0 3717 y(zero)238
b(-)47 b(scaling)f(offset;)g(true)g(value)h(=)g(\(FITS)f(value\))h(*)g
(scale)f(+)i(zero)p eop end
%%Page: 177 185
TeXDict begin 177 184 bop 0 1225 a Fg(App)5 b(endix)64
b(C)0 1687 y Fm(CFITSIO)76 b(Error)h(Status)h(Co)6 b(des)0
2180 y Fj(The)28 b(follo)m(wing)h(table)g(lists)g(all)g(the)f(error)g
(status)g(co)s(des)g(used)f(b)m(y)h(CFITSIO.)f(Programmers)h(are)g
(encouraged)0 2293 y(to)37 b(use)e(the)h(sym)m(b)s(olic)h(mnemonics)e
(\(de\014ned)g(in)h(the)g(\014le)g(\014tsio.h\))h(rather)e(than)h(the)g
(actual)h(in)m(teger)h(status)0 2406 y(v)-5 b(alues)31
b(to)g(impro)m(v)m(e)g(the)g(readabilit)m(y)g(of)g(their)f(co)s(de.)48
2665 y Fe(Symbolic)45 b(Const)190 b(Value)237 b(Meaning)48
2778 y(--------------)187 b(-----)94 b(------------------------)o(----)
o(---)o(----)o(----)o(--)1002 2891 y(0)191 b(OK,)47 b(no)g(error)48
3004 y(SAME_FILE)427 b(101)190 b(input)46 b(and)h(output)f(files)h(are)
g(the)f(same)48 3117 y(TOO_MANY_FILES)187 b(103)j(tried)46
b(to)h(open)g(too)g(many)g(FITS)f(files)h(at)g(once)48
3230 y(FILE_NOT_OPENED)139 b(104)190 b(could)46 b(not)h(open)g(the)g
(named)f(file)48 3343 y(FILE_NOT_CREATED)91 b(105)190
b(could)46 b(not)h(create)f(the)h(named)g(file)48 3456
y(WRITE_ERROR)331 b(106)190 b(error)46 b(writing)g(to)h(FITS)g(file)48
3569 y(END_OF_FILE)331 b(107)190 b(tried)46 b(to)h(move)g(past)g(end)g
(of)g(file)48 3681 y(READ_ERROR)379 b(108)190 b(error)46
b(reading)g(from)h(FITS)f(file)48 3794 y(FILE_NOT_CLOSED)139
b(110)190 b(could)46 b(not)h(close)g(the)f(file)48 3907
y(ARRAY_TOO_BIG)235 b(111)190 b(array)46 b(dimensions)f(exceed)h
(internal)g(limit)48 4020 y(READONLY_FILE)235 b(112)190
b(Cannot)46 b(write)g(to)i(readonly)d(file)48 4133 y(MEMORY_ALLOCATION)
e(113)190 b(Could)46 b(not)h(allocate)f(memory)48 4246
y(BAD_FILEPTR)331 b(114)190 b(invalid)46 b(fitsfile)f(pointer)48
4359 y(NULL_INPUT_PTR)187 b(115)j(NULL)47 b(input)f(pointer)g(to)h
(routine)48 4472 y(SEEK_ERROR)379 b(116)190 b(error)46
b(seeking)g(position)g(in)h(file)48 4698 y(BAD_URL_PREFIX)235
b(121)142 b(invalid)46 b(URL)h(prefix)f(on)h(file)g(name)48
4811 y(TOO_MANY_DRIVERS)139 b(122)j(tried)46 b(to)h(register)f(too)h
(many)g(IO)g(drivers)48 4924 y(DRIVER_INIT_FAILED)c(123)142
b(driver)46 b(initialization)e(failed)48 5036 y(NO_MATCHING_DRIVER)f
(124)142 b(matching)45 b(driver)i(is)g(not)g(registered)48
5149 y(URL_PARSE_ERROR)187 b(125)142 b(failed)46 b(to)h(parse)g(input)f
(file)h(URL)48 5262 y(RANGE_PARSE_ERROR)91 b(126)142
b(parse)46 b(error)h(in)g(range)f(list)48 5488 y(SHARED_BADARG)235
b(151)190 b(bad)47 b(argument)e(in)j(shared)e(memory)g(driver)48
5601 y(SHARED_NULPTR)235 b(152)190 b(null)47 b(pointer)e(passed)h(as)i
(an)f(argument)48 5714 y(SHARED_TABFULL)187 b(153)j(no)47
b(more)g(free)f(shared)g(memory)h(handles)1882 5942 y
Fj(177)p eop end
%%Page: 178 186
TeXDict begin 178 185 bop 0 299 a Fj(178)1589 b Fh(APPENDIX)31
b(C.)61 b(CFITSIO)29 b(ERR)m(OR)h(ST)-8 b(A)g(TUS)30
b(CODES)48 555 y Fe(SHARED_NOTINIT)187 b(154)j(shared)46
b(memory)g(driver)g(is)h(not)g(initialized)48 668 y(SHARED_IPCERR)235
b(155)190 b(IPC)47 b(error)f(returned)g(by)h(a)g(system)f(call)48
781 y(SHARED_NOMEM)283 b(156)190 b(no)47 b(memory)f(in)h(shared)f
(memory)h(driver)48 894 y(SHARED_AGAIN)283 b(157)190
b(resource)45 b(deadlock)h(would)g(occur)48 1007 y(SHARED_NOFILE)235
b(158)190 b(attempt)46 b(to)h(open/create)e(lock)h(file)h(failed)48
1120 y(SHARED_NORESIZE)139 b(159)190 b(shared)46 b(memory)g(block)g
(cannot)h(be)g(resized)f(at)h(the)g(moment)48 1346 y(HEADER_NOT_EMPTY)
91 b(201)190 b(header)46 b(already)g(contains)f(keywords)48
1458 y(KEY_NO_EXIST)283 b(202)190 b(keyword)46 b(not)h(found)f(in)h
(header)48 1571 y(KEY_OUT_BOUNDS)187 b(203)j(keyword)46
b(record)g(number)g(is)h(out)g(of)g(bounds)48 1684 y(VALUE_UNDEFINED)
139 b(204)190 b(keyword)46 b(value)g(field)g(is)i(blank)48
1797 y(NO_QUOTE)475 b(205)190 b(string)46 b(is)h(missing)f(the)h
(closing)f(quote)48 1910 y(BAD_INDEX_KEY)235 b(206)190
b(illegal)46 b(indexed)g(keyword)f(name)i(\(e.g.)f('TFORM1000'\))48
2023 y(BAD_KEYCHAR)331 b(207)190 b(illegal)46 b(character)f(in)i
(keyword)f(name)h(or)g(card)48 2136 y(BAD_ORDER)427 b(208)190
b(required)45 b(keywords)h(out)h(of)g(order)48 2249 y(NOT_POS_INT)331
b(209)190 b(keyword)46 b(value)g(is)h(not)g(a)h(positive)d(integer)48
2362 y(NO_END)571 b(210)190 b(couldn't)45 b(find)i(END)g(keyword)48
2475 y(BAD_BITPIX)379 b(211)190 b(illegal)46 b(BITPIX)g(keyword)g
(value)48 2588 y(BAD_NAXIS)427 b(212)190 b(illegal)46
b(NAXIS)g(keyword)g(value)48 2700 y(BAD_NAXES)427 b(213)190
b(illegal)46 b(NAXISn)g(keyword)g(value)48 2813 y(BAD_PCOUNT)379
b(214)190 b(illegal)46 b(PCOUNT)g(keyword)g(value)48
2926 y(BAD_GCOUNT)379 b(215)190 b(illegal)46 b(GCOUNT)g(keyword)g
(value)48 3039 y(BAD_TFIELDS)331 b(216)190 b(illegal)46
b(TFIELDS)g(keyword)f(value)48 3152 y(NEG_WIDTH)427 b(217)190
b(negative)45 b(table)i(row)g(size)48 3265 y(NEG_ROWS)475
b(218)190 b(negative)45 b(number)i(of)g(rows)f(in)i(table)48
3378 y(COL_NOT_FOUND)235 b(219)190 b(column)46 b(with)h(this)f(name)h
(not)g(found)f(in)h(table)48 3491 y(BAD_SIMPLE)379 b(220)190
b(illegal)46 b(value)g(of)h(SIMPLE)f(keyword)48 3604
y(NO_SIMPLE)427 b(221)190 b(Primary)46 b(array)g(doesn't)g(start)g
(with)h(SIMPLE)48 3717 y(NO_BITPIX)427 b(222)190 b(Second)46
b(keyword)g(not)h(BITPIX)48 3830 y(NO_NAXIS)475 b(223)190
b(Third)46 b(keyword)g(not)h(NAXIS)48 3942 y(NO_NAXES)475
b(224)190 b(Couldn't)45 b(find)i(all)g(the)g(NAXISn)f(keywords)48
4055 y(NO_XTENSION)331 b(225)190 b(HDU)47 b(doesn't)f(start)g(with)h
(XTENSION)e(keyword)48 4168 y(NOT_ATABLE)379 b(226)190
b(the)47 b(CHDU)f(is)i(not)f(an)g(ASCII)f(table)g(extension)48
4281 y(NOT_BTABLE)379 b(227)190 b(the)47 b(CHDU)f(is)i(not)f(a)g
(binary)f(table)g(extension)48 4394 y(NO_PCOUNT)427 b(228)190
b(couldn't)45 b(find)i(PCOUNT)f(keyword)48 4507 y(NO_GCOUNT)427
b(229)190 b(couldn't)45 b(find)i(GCOUNT)f(keyword)48
4620 y(NO_TFIELDS)379 b(230)190 b(couldn't)45 b(find)i(TFIELDS)f
(keyword)48 4733 y(NO_TBCOL)475 b(231)190 b(couldn't)45
b(find)i(TBCOLn)f(keyword)48 4846 y(NO_TFORM)475 b(232)190
b(couldn't)45 b(find)i(TFORMn)f(keyword)48 4959 y(NOT_IMAGE)427
b(233)190 b(the)47 b(CHDU)f(is)i(not)f(an)g(IMAGE)f(extension)48
5072 y(BAD_TBCOL)427 b(234)190 b(TBCOLn)46 b(keyword)g(value)g(<)i(0)f
(or)g(>)h(rowlength)48 5185 y(NOT_TABLE)427 b(235)190
b(the)47 b(CHDU)f(is)i(not)f(a)g(table)48 5297 y(COL_TOO_WIDE)283
b(236)190 b(column)46 b(is)h(too)g(wide)g(to)g(fit)g(in)g(table)48
5410 y(COL_NOT_UNIQUE)187 b(237)j(more)47 b(than)f(1)i(column)e(name)g
(matches)g(template)48 5523 y(BAD_ROW_WIDTH)235 b(241)190
b(sum)47 b(of)g(column)f(widths)g(not)h(=)h(NAXIS1)48
5636 y(UNKNOWN_EXT)331 b(251)190 b(unrecognizable)44
b(FITS)i(extension)g(type)p eop end
%%Page: 179 187
TeXDict begin 179 186 bop 3764 299 a Fj(179)48 555 y
Fe(UNKNOWN_REC)331 b(252)190 b(unknown)46 b(record;)g(1st)g(keyword)g
(not)h(SIMPLE)f(or)h(XTENSION)48 668 y(END_JUNK)475 b(253)190
b(END)47 b(keyword)f(is)h(not)g(blank)48 781 y(BAD_HEADER_FILL)139
b(254)190 b(Header)46 b(fill)h(area)f(contains)g(non-blank)f(chars)48
894 y(BAD_DATA_FILL)235 b(255)190 b(Illegal)46 b(data)g(fill)h(bytes)f
(\(not)h(zero)g(or)g(blank\))48 1007 y(BAD_TFORM)427
b(261)190 b(illegal)46 b(TFORM)g(format)g(code)48 1120
y(BAD_TFORM_DTYPE)139 b(262)190 b(unrecognizable)44 b(TFORM)i(data)h
(type)f(code)48 1233 y(BAD_TDIM)475 b(263)190 b(illegal)46
b(TDIMn)g(keyword)g(value)48 1346 y(BAD_HEAP_PTR)283
b(264)190 b(invalid)46 b(BINTABLE)f(heap)i(pointer)f(is)h(out)g(of)g
(range)48 1571 y(BAD_HDU_NUM)331 b(301)190 b(HDU)47 b(number)f(<)h(1)48
1684 y(BAD_COL_NUM)331 b(302)190 b(column)46 b(number)g(<)i(1)f(or)g(>)
h(tfields)48 1797 y(NEG_FILE_POS)283 b(304)190 b(tried)46
b(to)h(move)g(to)g(negative)f(byte)g(location)g(in)h(file)48
1910 y(NEG_BYTES)427 b(306)190 b(tried)46 b(to)h(read)g(or)g(write)g
(negative)e(number)h(of)h(bytes)48 2023 y(BAD_ROW_NUM)331
b(307)190 b(illegal)46 b(starting)f(row)i(number)f(in)h(table)48
2136 y(BAD_ELEM_NUM)283 b(308)190 b(illegal)46 b(starting)f(element)h
(number)g(in)h(vector)48 2249 y(NOT_ASCII_COL)235 b(309)190
b(this)47 b(is)g(not)g(an)g(ASCII)f(string)g(column)48
2362 y(NOT_LOGICAL_COL)139 b(310)190 b(this)47 b(is)g(not)g(a)g
(logical)f(data)h(type)f(column)48 2475 y(BAD_ATABLE_FORMAT)d(311)190
b(ASCII)46 b(table)h(column)f(has)h(wrong)f(format)48
2588 y(BAD_BTABLE_FORMAT)d(312)190 b(Binary)46 b(table)g(column)g(has)h
(wrong)g(format)48 2700 y(NO_NULL)523 b(314)190 b(null)47
b(value)f(has)h(not)g(been)f(defined)48 2813 y(NOT_VARI_LEN)283
b(317)190 b(this)47 b(is)g(not)g(a)g(variable)f(length)g(column)48
2926 y(BAD_DIMEN)427 b(320)190 b(illegal)46 b(number)g(of)h(dimensions)
e(in)i(array)48 3039 y(BAD_PIX_NUM)331 b(321)190 b(first)46
b(pixel)h(number)f(greater)g(than)g(last)h(pixel)48 3152
y(ZERO_SCALE)379 b(322)190 b(illegal)46 b(BSCALE)g(or)h(TSCALn)f
(keyword)g(=)h(0)48 3265 y(NEG_AXIS)475 b(323)190 b(illegal)46
b(axis)g(length)g(<)i(1)48 3491 y(NOT_GROUP_TABLE)330
b(340)142 b(Grouping)46 b(function)f(error)48 3604 y
(HDU_ALREADY_MEMBER)186 b(341)48 3717 y(MEMBER_NOT_FOUND)282
b(342)48 3830 y(GROUP_NOT_FOUND)330 b(343)48 3942 y(BAD_GROUP_ID)474
b(344)48 4055 y(TOO_MANY_HDUS_TRACKED)42 b(345)48 4168
y(HDU_ALREADY_TRACKED)138 b(346)48 4281 y(BAD_OPTION)570
b(347)48 4394 y(IDENTICAL_POINTERS)186 b(348)48 4507
y(BAD_GROUP_ATTACH)282 b(349)48 4620 y(BAD_GROUP_DETACH)g(350)48
4846 y(NGP_NO_MEMORY)426 b(360)238 b(malloc)46 b(failed)48
4959 y(NGP_READ_ERR)474 b(361)238 b(read)46 b(error)h(from)f(file)48
5072 y(NGP_NUL_PTR)522 b(362)238 b(null)46 b(pointer)g(passed)g(as)h
(an)g(argument.)1575 5185 y(Passing)f(null)g(pointer)g(as)h(a)h(name)f
(of)1575 5297 y(template)f(file)g(raises)g(this)h(error)48
5410 y(NGP_EMPTY_CURLINE)234 b(363)k(line)46 b(read)h(seems)f(to)h(be)h
(empty)e(\(used)1575 5523 y(internally\))48 5636 y
(NGP_UNREAD_QUEUE_FULL)c(364)238 b(cannot)46 b(unread)g(more)g(then)h
(1)g(line)g(\(or)g(single)p eop end
%%Page: 180 188
TeXDict begin 180 187 bop 0 299 a Fj(180)1589 b Fh(APPENDIX)31
b(C.)61 b(CFITSIO)29 b(ERR)m(OR)h(ST)-8 b(A)g(TUS)30
b(CODES)1575 555 y Fe(line)47 b(twice\))48 668 y(NGP_INC_NESTING)330
b(365)238 b(too)46 b(deep)h(include)f(file)h(nesting)e(\(infinite)1575
781 y(loop,)h(template)g(includes)f(itself)i(?\))48 894
y(NGP_ERR_FOPEN)426 b(366)238 b(fopen\(\))45 b(failed,)h(cannot)g(open)
h(template)e(file)48 1007 y(NGP_EOF)714 b(367)238 b(end)46
b(of)i(file)e(encountered)f(and)i(not)g(expected)48 1120
y(NGP_BAD_ARG)522 b(368)238 b(bad)46 b(arguments)g(passed.)g(Usually)f
(means)1575 1233 y(internal)h(parser)g(error.)g(Should)g(not)h(happen)
48 1346 y(NGP_TOKEN_NOT_EXPECT)90 b(369)238 b(token)46
b(not)h(expected)e(here)48 1571 y(BAD_I2C)523 b(401)190
b(bad)47 b(int)g(to)g(formatted)e(string)h(conversion)48
1684 y(BAD_F2C)523 b(402)190 b(bad)47 b(float)f(to)h(formatted)f
(string)g(conversion)48 1797 y(BAD_INTKEY)379 b(403)190
b(can't)46 b(interpret)g(keyword)f(value)i(as)g(integer)48
1910 y(BAD_LOGICALKEY)187 b(404)j(can't)46 b(interpret)g(keyword)f
(value)i(as)g(logical)48 2023 y(BAD_FLOATKEY)283 b(405)190
b(can't)46 b(interpret)g(keyword)f(value)i(as)g(float)48
2136 y(BAD_DOUBLEKEY)235 b(406)190 b(can't)46 b(interpret)g(keyword)f
(value)i(as)g(double)48 2249 y(BAD_C2I)523 b(407)190
b(bad)47 b(formatted)e(string)h(to)h(int)g(conversion)48
2362 y(BAD_C2F)523 b(408)190 b(bad)47 b(formatted)e(string)h(to)h
(float)g(conversion)48 2475 y(BAD_C2D)523 b(409)190 b(bad)47
b(formatted)e(string)h(to)h(double)f(conversion)48 2588
y(BAD_DATATYPE)283 b(410)190 b(illegal)46 b(datatype)f(code)i(value)48
2700 y(BAD_DECIM)427 b(411)190 b(bad)47 b(number)f(of)h(decimal)f
(places)g(specified)48 2813 y(NUM_OVERFLOW)283 b(412)190
b(overflow)45 b(during)i(data)f(type)h(conversion)48
2926 y(DATA_COMPRESSION_ERR)137 b(413)95 b(error)46 b(compressing)f
(image)48 3039 y(DATA_DECOMPRESSION_ERR)c(414)95 b(error)46
b(uncompressing)f(image)48 3265 y(BAD_DATE)475 b(420)190
b(error)46 b(in)h(date)g(or)g(time)g(conversion)48 3491
y(PARSE_SYNTAX_ERR)91 b(431)190 b(syntax)46 b(error)g(in)i(parser)e
(expression)48 3604 y(PARSE_BAD_TYPE)187 b(432)j(expression)45
b(did)i(not)g(evaluate)e(to)i(desired)f(type)48 3717
y(PARSE_LRG_VECTOR)91 b(433)190 b(vector)46 b(result)g(too)h(large)f
(to)i(return)e(in)h(array)48 3830 y(PARSE_NO_OUTPUT)139
b(434)190 b(data)47 b(parser)f(failed)g(not)h(sent)f(an)h(out)g(column)
48 3942 y(PARSE_BAD_COL)235 b(435)190 b(bad)47 b(data)f(encounter)g
(while)g(parsing)g(column)48 4055 y(PARSE_BAD_OUTPUT)91
b(436)190 b(Output)46 b(file)h(not)g(of)g(proper)f(type)48
4281 y(ANGLE_TOO_BIG)235 b(501)190 b(celestial)45 b(angle)i(too)f
(large)h(for)g(projection)48 4394 y(BAD_WCS_VAL)331 b(502)190
b(bad)47 b(celestial)e(coordinate)g(or)i(pixel)g(value)48
4507 y(WCS_ERROR)427 b(503)190 b(error)46 b(in)h(celestial)f
(coordinate)f(calculation)48 4620 y(BAD_WCS_PROJ)283
b(504)190 b(unsupported)45 b(type)h(of)h(celestial)f(projection)48
4733 y(NO_WCS_KEY)379 b(505)190 b(celestial)45 b(coordinate)g(keywords)
h(not)h(found)48 4846 y(APPROX_WCS_KEY)187 b(506)j(approximate)45
b(wcs)i(keyword)e(values)h(were)h(returned)p eop end
%%Trailer

userdict /end-hook known{end-hook}if
%%EOF