path: root/vendor/cfitsio/fitsio.ps

%!PS-Adobe-2.0
%%Creator: dvips(k) 5.96.1 Copyright 2007 Radical Eye Software
%%Title: fitsio.dvi
%%CreationDate: Wed Jul 18 13:51:22 2012
%%Pages: 136
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
%%DocumentFonts: CMBX12 CMR12 CMR10 CMBX10 CMSL10 CMTT10 CMSY10 CMMI10
%%DocumentPaperSizes: Letter
%%EndComments
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -o fitsio.ps fitsio.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: 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: 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 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
30F40A9C74C8E7773BE601C0E245E7FC10C02939848C3D28D823057B3EA23EC9
E2BFF7851FB65FB12A4318A21D2C88EF9245D4C7BF21C81C4FC4CE0149E96278
48F7BF97A5C3691E6CE038033AF54DE91D320EABF2B2E98617FD4145BFE5EBBF
1A5634DA07B00257A51966FFC009CA416D37AD30F4BEE6D72AB64CB2D62466F0
42D66D6D33EF9107272835EA9C1C8FA04562864BE684FD5F8E6DF19916FF8346
F39F3E1FA2975B5CED24EB160FEF6149954F76C359E9D15A209EDD7445BB6303
6AFF9E1373CDD50B93DB137F3896D282F5C04AF0AC84AA02D5421A73E3AFB735
80EBE676C2870822BA89F4BA85034D6431BC4A44CC264DDD10EA146913E9063B
038BD787A659C6A88C42FD5FBC51234664A8A1621A38C73ACB7199592AA5EA84
B78BB5DBA7CA43E30CA8D3957CFF478712556EEAB1990C97B9BAB47ADB75E327
B361D3039A3629B09EB84CF814773858F1D354AD8D526E85EAFD50944CBCE042
367D1153D7B4EC4DD597DB0F57379DD63304869DEA4FA008D411E30ECFD62E41
29F51841A9E07E066F06BB4829F87B7722562686FB801D6690F73233053B2EEC
473B9899F284296BB634358A22DBF361C2A57C59438C429EFB04B80BE083E238
A6749D6AAD1F17F318B880D26D230B86F80A99C27B87F7605DE40A0848543DE2
4AF7D5BF61CA6B00FA156DBB9ABE7BB0EC79CE8FD5A2FC5BE17050F2A74E8905
75A9982E12698B289E2213DAFAAE40DD22B424562D7417E8B82A5E3DDA814669
D4CC949397B0DD2B0787016CB8FDFD09318719D7C47DB72E094C12C6DF3EDE88
663D6357CE7BFE51FD4A93887F022E3A22DCBE39CA86E104CE54C05AA0B5E469
0AB9DA29D19ED5E783225ECD1122BFFF5E4E63488FF215A9F555C190ECDAF130
B34E6BFC66AB1F7D000CC09CA9872299E23EC9B0A8ED04135C982978B9D7C4E5
F9C7968B540837CC667196C7B40F579E8258C8C7AC569AB787BB112C046D0068
86AEC034183A3DE02FB82C2CD3E252746C012F2385493F59DDEFD5AA95A26C61
BA64D85CE90339A0C19F538C6E0516513B9E7661505AB81F45AEA04618CEB379
12F6BB94E2812F2B3C69BAFC9135B439D74C6A94C0317E1B2A2EA514536AA990
7B94105AF7DA13148A807CB2F679DBDEE10B09BDCC8BDC7365166C910AA450C7
4FD88CA8BB639F1BA53A4B108D2E1633C5DB38E64DF4881E0FC1118559A078E8
52A0E2A87F98461EE7B0B56DFB6C3F340430E3D5C41C12141E4332951B4DF03A
6824E8CEEA4AE8AC9F51981184287EC2710E4A51DB5E09DCFF4DFCE6B82A0B5C
D2E658D38FA7B2854778650A78AF230E97A4C195865C404EC18A5FA99EA30FE8
755EE5B11397D3CCAECD81EE3F3D1EE1A1B1FD6B669270912948134ECBA3D5B3
011CD3286DD6729DBCFC9A8FC93356BC70A876AB636E5C8EFA89881D3A6E0592
D4CDDBBD21A67033AB3354BA1333206874D2F7D0E571AAD845A96057F005F730
C98EBDFB006EF8874CC386A0B611389F9CF5204C65AD951306B0E090BB287EF9
CB7DB38F2A58E2ED6813F2138922E28FA44792E5C57A70C6152B4A6E73462F8C
869886D1E5718C85F1CD5E7EC4BD73C6A4E3218A7118D42CFE42BB83A6B72729
0E096EA902F81330771203309DEA91A560B56DE63911EBB6147600BB9B6A5166
A818B7B8CE58279E22D776B2CF423897110CFF24807319C84A2063CA464C7616
8260B36124AFE08188795E334864712574CC3DE12C3F0962D51734A44289BFE2
2525F5D641EF82F25C1EAEA56C621525EC86FB6D09D99941D18094B7D77719E0
3957294DBF2D221A49807B44323098D816A21C8F1BB888BC1075E2D6FD770014
829050B6F8E297853701C467BFE76C1E52E8AFD5AF67B3FAD5A608C23E925F0A
87E7F56B0D05F4D4276CE619190A983BB19417E280B53060AF777BCEA0D1F4D1
B803687D9C2050D0B2EBF3EFCB9FE42E02AFFA5233A49D27550BF8B32B1A3A3D
A8F58FC0FEC58439D12CC87CEEBED10BB6D9BE84DDDA7FE7A7283D2639212CEE
2DA539DE06298BF452F896FE103A4BF864E5399C3F220FFFD82AF1975FCFA69B
8C9782842F016682EFAE7269A34FDC5ED188E3E6E24FAA0345D9558B19521D16
9FB47306CD1D15F36C9386347FCC9906A5420F4F6E030B007DF4D311B8E102DA
A653AB0BA300D9467B092165B016C6F28E8D417E1B93A6A176329A67C5E0FF79
167F9CD8E2EDD33D5B11348EC7BF4C88C3226377DBA6C4723CBE67A7118F3CBA
34EF78E08A4211C39205325D138840E3F3FAA9CCEE74569B8F59CCE7E7D35D3A
0999DB04EC83483BA245883D764A3CF556949BE4B121C6483ED26D192405EBFF
089A97C4BA9649916F1A922F48CD04B7338EABDAEADAC52F42CF48272EAB9192
C17906F59CD98D5A54443BD474385AF6B51B9C14EA8AEA27AE3473DC12DE901B
42DC378872B001B2C929C54117E6EDAC6202BF1028AD2793FEA3620935539071
9BA89FBFB98229EF30B0382D9D603BB451634BFD08901432F16B31C9245D3645
28456E44DC8B6C9C052B9446107116AFCC2EC0F39F0CC7B5E146FD9E995594A2
DDDE2BD3DDAE13B9659969623BDE57219731BD3893B63B77D5218B94FF535FAF
2595C30EB0A003B144461C8115C5EC93595B4FAC2BC0D084E326E1F2CD14AC0D
D9B4C1467961E2FFC04BD2DCDC1A16E9582653B1CECD98AEB6ABF1E88086FD2F
347774D628A4E70B6803EA481996C07D6D84661D003CF3C92D32791A06405C2D
BDDED14EA55744AA956D04CADD4B2F5A0FBA5D29CFC84CC54CBCA53B19FBB69B
6199174100938FC1E16E7EC73BF85B058E235E282B17116250CC9965706D80F4
EAE76E2F7E96E901CE29AFBDE9CF9E19CC2432DE75B4E67DBB7BF62C6A3A0C4A
1800F457B745F18AAAACAB8DEA973869EFED9464631EA2CBE95F78133B4DA06D
394AB1CB50B6EED8E868AEA0EABDB783EFB7F0431A450D9C48492A04BFE3A0A7
9BFDE3B9DB2235EE46EF0D3E754F95819B6FD407E974856C83228A3C2A076966
02E3F0F2F27CAE5C820FCF3AC5FF38C715B3DC3CE9AC77FB13382D2B606F469F
768D1B82CE3D66F1AB552902B3BFC8E1B3A5A45D3C3D914D304070AAB6C49393
028CD984C44C2D8DEDEB61AB45A4B2237A236C0D3088AAC5A7F89EDFF9A09639
8B1887E2CB29D9E9B5630A45879069E58DA52E5603D026339E637D7B83E6550E
CBD4349FB018A01749E171C987C30F8C36651501653A4421869F04A9B8BF792F
41B8D1E9F9101B658EF726DE26BA616A20A667FE7B571F68FF3BC77B127EF315
64D1D39C07799B45A40CA2D4FD81633368EC9654282A91B8F38066B3D781E8EF
3DCF9CB050096E84E8DE000568251ADFB56AB4AECF2D29BB47110D277E5A1634
D2813F9239951645D505C53CA91481C2B0F9DB72CC4C3EBB12D2BEB7B4201C23
BE8EFE99CCC6A0D520F6282F0876E6A69CF5ED38AAA9066196A9456C5DEC58F3
341797EFFF3040BB65E2479165581DD67AD36EDF24DA29DE341106F258C5FEA2
D538201FBB6C0C3A132487E01488FAF2EE5A61E7079547278DFA812C5D822454
F5B0E67620BEBAED135E63C8A55B29F685CA3CCCCBA06E2AEEECBD92E29B985A
23B93078BF8A6F41125529C1C171D7A8C1AFD9017CC089570E45E873E74D7FEA
7193C263492D4A6E73C65531C324FEA1CF9C4EBB6E501562EAA0EC4DA6C5FF7C
49DAFA4DA93D9F35F06616002A66468D7ABF3B3CAFE293A7CE0D1034B971B063
EF162C62E480D259E5AD6383DDCCB0F2CE0059E7E04681106CA6378D59F3EEE7
0AF84F11FCB538E4155CEB05D48678FBADF22F99B9D6589629FAAA181F78BD79
9D97F53E9FC10919970EF6CECCC6464540FB4A8EAD144B5662A4B0BAD31DEFA4
9C1F280C18BBB0FB005896075E3F4C52C9F11A2C0DD60CFE581C771A72273053
796AB48AD2500600E3355CE0C91E26DBF8C135C6B12FB3B2E89B9011CCAA3D2C
AF8E2F38BE8D2BD82966B0037DA0B64A955AFC5181D3F2DA0F4FAE47875B5D3B
ABCF48A2C3D1ADF69F5A3BB51D456B19085363318C3D371221A7319EDA644EA0
C30EB56AF819CAE5DEA47A7495B463E388562FB76C94621CA7F0DF9FA6C080EC
9F8AFC21AAAEAE2359869EFEFC8BCC433B683EE1DBE927463CEB19CCBE08ACA5
B925E88AB69BF8EB7A0781F57FADC2111659F9A480B8B4158806CDBFD950C4A7
0D792235486658CF8A96B0FDA2EE36468788225B794AE541683D2F5568B1239B
2956E585AE96E5C0FEF1D632895B3A0E0FCC57EEDBAF40F395547F77D7F4F6D5
23066F8B08FD44B1F26E89083C70FF24CE2AA2168AA8B09BDFD763286A243BC3
0431A22C8CC88A524E2C3DB01F1B65A1540A8C2EF5CEA9303DFC3F3CDB20EA23
600F870EC83EF9992A976ABA1D086EE4018DD3F7004301A7A431694DAAB46B29
538000BA28F999C70C3F72C1DB5CD7B1A4FDE6A0A87BA98332EDD260D30CE677
7176F2FE3D12C3434985AB6CC12AB6BD4872F5376AE6E6CA9C4871007D6DEF15
6D15C96C0433ACFD3AD8DB22100ED3D696FFA7DEDDA0449A14F435E9868DC2CB
8C1306330A68C38FCC010442A51DDC47BBFC474BCBA5A404A5705A0812B1DDB6
CDE7EFD4D833C7DB0D4C91561C7369AEF96E849D23FBC55429427FDAF7E2DEFD
18E2BA193293C0BF21F7241626E30573F2BB36C0BDF9A1065B2AE02DCE822156
0AD58921ED46E65C40FE54C0F9C58AD8531536208F5A6F538836B74090AD8191
486F29CED44DF9C4A547FDE7C40F833887845BDDCC68D84F2F445CD4D871FE87
52681595A6D0DC3FE1E2B00C53AD686E866FEFC39F6C7FFCAFF8191C13F7598D
3EBDCD33CA548FE31C67AA26568BE071A4D5750F9246695A4184042DB2FB0680
C0E1FF57CF2E9E360828CCE1C7F22D5CC921A995DBAE0D2469D4C5147D607923
455D9390580E120416B814A310E5588A0D54160728CCE53712D266C090F7175D
96725CE1CF85B0E3772347D9DB0CB282F04A2CE1A1358675ADAB4F5504554189
B141B5FA5BE5D2DD4FD88C91AE99E6504365853F95620C378657DBC98D06A4F0
38DAC9CB25A11D8A9D224C9CAD1369245B4A8E19AA55523BA8402CF056FA7818
DA762A53F9A2F02F17E23C97A38C14ECC34B985B1EABF9900698E122F11EB4AA
E5524C3DA713271DAB8969B693A7CBD313F28120C7A68F4B3037AC043C992D7E
F5829F11930CA70B580A161635228ECF20C5BA4D3B1587FD7A1D52C2530FAF7D
C2C9431C7B4521296D391A3436642230E0E5D74E6D5E94277373513DC443B09C
0BC80C1EA1F22A7F2F4CE3627E852B5A636DEC22ECE7FE76F53FFC41AAF1B490
15E8060C6448F07997AE8D012B640630D72B11D77FBFF41F65B6EE2D70345A6D
E6137355349A55DEA19D1DF5551B54F1E2F57E85568954AF23B2CA6D60859F11
2BCF6FB935BC106B9BBCD8E8DD551D82C7D348E03B71BD4E052686F1A0D59091
EE647EC64FBF77F558358129B938993D0F75673B45F41D2EDE54FACD6DDEF68A
A8D55C257CEFC0E0D382C60A73C49DEC67AC68E5066749A1C00AE616A2C71A4E
14A95123F58FB1D940E2A0E51EFA67C2F2BDEFF85376D211DD8F15D43F2CCE7B
47B0CE25CEF1D450EFE17476BC3CFF661C1EFFC82E80E0A69FCCB25F39E51454
E53912FF49EBFB3CD9593F6FAE81F1F0A9E167282286F8407F9F0023538D75E5
76171E5A7005F053ECA82809C7073A1A480198BAE0085BA9BD1EF107D4324B24
F96E24BB4FDD80B195546854618282F770631B5F3FEFDC035E6954AE76304038
9ED525495644EA353E32F65140DEDEF41CD343B5333954D3A4C413BC3365B0B7
3ED0DB1A27C60237A0E82407753C1F9817C4A0D7F07D328FE2216B34CB8A233D
FC5A420704C8F1D42B57E69424267E5BFA8C2AE65BA324262DDA2812D893050F
7D50D4487A5BBE53D7CF041DA6EF76A659DE8EE07DE413E940AC2160C994648A
6D0D0A59860B4080977C18CF6540B5F5B3B4DB52EE9CDE105D965E9FE5999208
02CFC8639767B033A3EBC2C42066F6E7CE3B8D6E2F25030D14957F7FA8E59A7A
5685A8A8479545C373DE7778A5A65D7ED6139A2C8FADBE8AACD08D56C42D11E2
CF01E2D78D4301556A8D7AFFF7642B10A36E93546EC8B2059870C472F5CD463C
DE1DBB211CFF689095891B9980D9C9438FF7EC687DA72C548502B5EA0FFDFEE8
D982B934E7A9F4D62428FC6719894C0ED4B0040BBA5D0FCBD0E3D80F2E245513
4C78489DB71F2EDF17CEF7784370D080B75122290F59D4B4CAA0484A809CAD27
94FE9EDD79994079695C3DC4440C6B2FE4AB0129F2514EFFD8615425F7E74567
D93EADD0FB68FD8C6B9E3C1275F4FD32B8CFF3D8D04B185E2D702E46289456E7
F6A2A0D83DCF29862BD08AD7AF05E3380AEE207F44E5B8C11A89E954AE0BAB81
C5A8D1449693A0E5AE02D0AC8D1BF1CD96DBA29A747CF41292027ED8C05DD325
8B92300CFA2FD33F14CEE073F8CA93E33BB952B2E58E666B1E12CB5634136777
6D155B1855064842120EF87ED8B1CB6C95D74EF97C0B85DE90E266DD14793F70
27038C774A64E5757DE6FFFDE5CCB2BFA4B771BD7D02FCF0530E0768DB74FA39
2BE1C80A37A77AAC1B4972AA0335A6E51787781D482D01CCE8CD8FC732BFB1CD
69E5BF80E44F7F484277E5D8B9611B8614ABB9C8865F26DA08108D355EA7B451
2364F41F4EA9BA074CFD14377B092F4274F18F42B30C83ACFAF87513E8CC9716
7ADFE45917E3B9D034F4ECE1455318BA74C68CD534B7DA3E3C1C94A10E7F5738
46EF5ABAA7F58C0CB25A1F78F8FCF83DC2FA4F74B7F01E3141E1886C457FD285
A44A1A57E968358BC29CAC2BC79CD14FEF92F522C9873ECFE82A01BC4191BAA4
5D5212A7AFACEF600F738F4E6C691BD5D8D6F494187F43D42B1E876E6B12A02E
8357B376CA901EF9945D7703E28549C291731B78BC185AB2D3EA810CAB3A500E
2D2DF7934A616B3B0705F0928D97A742DB11392C51901CAB772C44113F1A5873
54C74B49EA48DE55089AFFB75B288185955DFEF25610BEFF0789A40381A1ADFB
95628B44B810062EF1AE97D6101B13B020276040FD886422F69A92254B222986
500384843D82F4A706D5160CE4E35556253C2B73B539D101F166873974CB1819
26D751F2E4DDA3D93FC7128C2515A75C676ACCAF8C07E2863951ACED319EB268
87C5802B7C54317A414BF9DA26EA1B53C5A8A9536F54FBA1699E1FEC82403359
66741ED2B98756BD5DE594C8CB2E0C24BB372EB2EE6F7910940CE6EE8D2770DE
6343C52B4065B6AC1B3DE9C4575B8061DE6F05961E68FE6527BA66EC51AF4948
8CEEC967F6E376BAA1DCCC8D50DC72C76DEE3644F890D4DFAD6E4B9115F43F9F
25CB66AE9E46331F5233609A390523BFD6D642F6BEA65B7500C3F7C28D03C2D8
A3B5C7ACCEB8147C62865F8DD2F844F294E8AA932F5D9482FE0A1461EF74BA57
BF1848B7CE0CD572A583A6837F9D27B6844E62DB08DF1AC678861485877454E2
FADCD5C87B57340824621B978982092C1334625551D36494A1E0246336B4104C
B823C8ECEB49EAC4F8360867BA86FA2929918ABFEBC195C559BAF28B2396DE2C
5A550C3A17CDB40C4E2A4683590B0BBE2031F525216083CA6D9DE3247D0B77A7
7348225427CBD78F4C8DD795D010D66B5D16F513066C021F54DB36BC6902190E
53470B96270C8DCE6AA8F836F926EC56E5A4C69BA37EEAAF22AB1D09860279BF
97935068A4D11319146344CA8CA2B87E81D08345C699A81F0F4BAF56E39969AF
A8094449E595CFFAF5CEC0540940DBBF79273B13D1A884BB2C354509CA95E582
34284D9EE6992D5F3D2FCC09F99D1B8B31B59E651C17A174D98E2AE214332D44
9F3769402AE4D2E6707450545C6A5322637648488BDE496DFA32BEBA617BDE88
D07982B6948B94C91247FAAE6AC69A8727FD4AF3154C5F6B435379119898DC8C
3110AC36907AA6653E28D292D7AFE2C3E54B6D29800BC7176B4F0D00E09904D2
F5DF5805E4C8E4348F017ACB5C62DD8EE155F56AB87315F95BF1A7AF147B71B6
AE4952942EE6676E491E9CA622504DCE2ADC678AABB16886ED89B6309EEEEE6E
08D8133000ECFE0BE713E5D144DF17E98DDFC61C688E9A89302773835DDF9254
A4985D6567AF8DFEB4335E1CD6B9D7DE23B009A7BEEED3BE0D7F77BEFB5BF2A1
07A44B1F9CEF1EEB6D3F49804D6BC47AE26DF2F878E8ED4861FA691AF085A254
688418486DAF652BE04054A8A8CE7EB42C5B30146C3ACC47502AD1BFB1A92DEE
B3D317D4D2FB276BF7C4F11678AC10CBB01C3DA178A5C101BA5B995D18136261
EE1EDCBF883B6BA4335CC33BCBB116EE70B1372E01E64DCFD534672D9C84FBDD
79C8D2BDDE8D5C55F852E41FB5C1076D91B0D5C0E13F70B66904E08243EB3287
C6257181962EF755E7A603AA23D63BCABF36F18684582182CC20CEA4F1DA0665
1A8F1A4AF7C09F0351460919B10537E19A0ECA06DD9C00368137115979D3058F
635AEB09C1C561D020B5E19358F216B8D17582A518FDEB4AD7735FFA2C746D5F
163CA092531649865A1DA92CC8FDA32490826FAF4A9BA50653C2C3667F61D880
D6523745251E5BADE8DB233EF3A62E7C92F21AA31618EB0A08D47F406FC07C54
FC04404F5BF9DF6D2D53334DC93138323AE39E95F9CB2260995970E173C997B3
414701687EFD2B2088E50ECBDF14FBCC612AEF323683D2800DC9B9EB054B8CF9
3295728A29DFA6E22A98540806D6C89C34B188C29723DF52C50BBD4EF02C887B
335A72FCC0F7C358AE98D26FF44F1632CAA1774AE6F8852EE8BC262FF77A2E24
8B8833B7C9F9C65F94C889A06095776BC75361EA184FB5C5C8BA401A8D2D9771
D0D71BEADEDFD70EF617B92FE12FEAEAFA5F6013A28DA3C666BEE78D103C8947
3901E3B368BEE322935020EEE395B9701F65615D510809D8AF431537805E0B5A
908D1B2C659582D0E54294B5BAFDF5FF482712179CE8F6820C3E72A73EE0A4C2
43F792139AE3F8AB7A8D22A6D4C222B2B63CE37F0431157AD317A63E05067704
85F00AD9B822B1506DA0551ED23099D53CF6E5127B5AB291B33EFBD26C21E9AA
4096BA233B76B87EEFBBF8721EA8C37B933C5D901C4E451C1B05A5920CDAC618
F9431CEED497EA77D36CDF497354E158B9016CC888DDE52EF00302C140B29C1E
392F5974EF8EB272C054F3906F5D0B493C2478AEB0A83E469850BF76AE766B4C
884B10B49EDB704B33AA96020522C5218D7258210572E8B274FBB05B51380F5F
DD14C84263128C4D037314263E8B1ED48C816F06B39E32D5A894E114F9B1A2EA
F255A824E41E768E70ABBB14964CA00C9C3EC281D14BCFB681BDC943BCF320C3
0DB0B18DB7FDE42A3A2DEBF1746BE74E18BC0A8081DFAFDBCD64050ABBBF3A66
72D0D7CA15E88ADD7F0A1E1F70D397D838AFECE3352FAF0B149D5DA940B518FA
9594FF7171A2A6B77CD9CF96143DF0B708EF569CC135A2240343B3B50633437B
BFCB0416AE4AADA1A480CFC134C1DBB9472279C4966B99B473272AF27150B683
09C57E73A83E7339B022F0388640EF9561C518AF312EBF0EF120CDFFF9F193AC
FD6FCCCC337922405224C8015431BA7610EDE19CE9176A6C1F552AC7413ABFCF
EAE1FC65D1F56917B125E498E37D2E7AD170F0DB13DFD8D430523B774DF5B2B9
971F0F78F0931E81A848B1E2D901BA1A011957B56831AA755DE617F8A40B843B
470D96140340CA72B45C2BF0C0CB635A6D7B25A084AAD2830288ACFA119C3AF9
5ACBEE18F38B244B7FD29210A7BF1D3A5EBD17E2B268C36CF439120B1947EBC2
CF769AD003B5C178F5FBC3AB5D901682CAF6AEC1D66B3F3DF730C27F09430EF3
81F32BE8B781338BCA00F8BB26B89804E750BEB587E558F48AE34A0516B1B4F8
342A97EEE51D352EB39C2819A200790E5BEBBC50EF4FC2DB326FB61F969EC2C0
98CD4F78F741C11D2744F26B443302392316A5C80A9ED122C7D27C1C89D098E3
ED365F63F5F2DB3889A4EF86587722E0059123D95D3C471751D8D8E84941BB5A
D14766DF319F648FB6FC6B39E94450BBAD6F83E43B92B72B5D4F6804031782D9
9E40AAF10A291F048E4A0B6E726B1E81942615DD0A862087048BD3B261E8F8A4
25D82D60D90E58A9F3C03CCF9593F0A8738F397E058AC523438F58B2AD206B85
98B61EB8536BDEE0219867CD40F10F622EABC2D52297B257EA0DD929B0BB7938
158C6A6BA70514C27CAD1F310C493FEFC4EBCA10CE4F77686C374E1125F69855
9869DB3887046E82DA5EDDBDECABBEF1E050B26A91A6CF23D3F06B4206D5573F
EDC6CB4DA302A355CD3CF80B54B270FA1844FB5DA988D08A754D30CC5F8DB71A
5AFF8F08A67CF1DF916E3370D961EBC802E2AE36B25F0B2BD2F01DDC9D52E45E
18D579D5C4A750F27262D2364A1CB2BB36B116626A9C1B6E35E22E81FF695E1F
713B9461726F5427EBABD116AF543A84981796A6FB49F72BB7AEAB3ED5E771EC
D1823DCED5EE170126069B5369BFBE2C1225EF0E5757B2ECC2360F8EB34EE3F2
5F39660B7F714A82EFF3A61B7C9D26A32FD4C6EEEFABDB9914BF7DD6FB240198
81F121394D0C2386738E343645A9CE8585145ED6957EB06466D5037B1FB3210D
CF0E79E0920167C5DBD605FDF8A66F96CE741DA7DD85D629280681BFFCEF027D
C9390E2EE59F24B714AE30A802F112BCA54AB3FCF419F65B4B27CB7A543B55ED
350D9BE596B15AD6F79730DC86D82DD075390869201CD6FA2D22F77FEF7619AE
6FB42C939079757BDD06BE3B8A7CE60AEA6D1B753658F858AA2584D4A4CBAF7F
0D701BBC0379973E5753B848BCB7CF56FF30E5AC9D2E83F33B4D87DA222F1306
1877A2D810123D951F5CE12B17862EFDD5A86DA3A3987D973F70541D70B0CB3D
0F214AD4B1FFFA21A29E5C7856CE49FA93528E6D53570E3D8D6B17FA27B28AB3
FD2BBCC63139FD7F86DE6A84A2204CB30FD14080D45EA14EA784A5471ADE8A70
2864A204F10AA5B2A2C870521B97AD75CE3F6C078F1BACC99BBFC0E2F2387022
6F72BF44DDB62051E1B81A1419CF2F033B77FE46C2208E7DA22F83392EC97328
9A5E3DEF8BD6323E16D1D14FCFC890BEFAAC9F879198703CC9FD0FEEAA639EC1
B787D77B325A213B71ED56F1ED09DAB41AD4F8E314FA8154BAACF480F110B939
86477401D4ADE8FB386CE8959027A8B91C56C53028C7AD7EEB61DD986D303572
86324689E1AFF282E10F789421EC2BBFC5637C18936B1F2B4D02C8C8D5039503
D425992185042BA95E50C1ADD6563F3C661AAAF32E29F9A4BD3ADBA7A55962F9
ADD1CA560CDF1D0BEF0C57E4EA11587CD17CAB65D9DD830CB738549C6F614612
FACA8E3031BBF29682324D9E12BD792F9F3A24D7250D2AB55FC984C6CDBE070F
5F6282F51C4DEAD075EFA1820E044174FDBFE9AABB68E6254F4B59E8F442DBCF
D2AE8ED7ACAFDD486DD36530A71F9A0D9FF91B19FAF723B4909C9F99D5CB29F6
2CB6384D6A3544359AE23E09770F82FF7C9327BD392BD0F6B607897B6D826C50
B84B2E0722B0E27ADD479E5607B4500B8ED238B99C40B2BB47F02352BDACAD22
262DBFBD38A9D4D1BAB79053F4F172397F8F7C00CBD37164A0C89B7E31EDB3C2
25D32798F7F83582CCA56EC0F419316EDB2F3299E40BFFFE63C5C2A0ACDE3C9A
414C2BF9F341F40FD4C8A5B1950EA05A26DD6CE187E181E6AA167F26AF6A4E5D
6E4AE9430E0069749299D2B9D8ED6A3E647BF2707948B8F6D16D4DFBBC71BF61
5EBDC349EAA9EC847880990795B75B118423D9153B05D5D6BF0D20E909F8B22D
0DC9A8CD8CA5B43D92F4CB54344B375926EEFA5BF058B7BAB54B5C97BD5653FC
F05BB1A5991B068C26B0420DECA3F1943D093997A3A8BB061BB25CFFC0CA1DCD
D85CB203491D176C4C183BB124F22D57678841F08419028F250C30D1237A0213
E5A392E60B27D2BE5240346B99EAFF9B57F108DA66B6AB826546C6411864F7CD
FE404BEE7D58F28580C448AAB599D12B00A3FDB2BB93737971A5E13FD7CFA970
656D45145A54DB1BDD0701097445ACF73861FEEB01835F35790E98EF162D5F37
E1A5617CB2BC22074305FBDC8024E741C7BB0FA0E17F123AF953742E01AF56A0
AFF35515ED55F9621AAA309D36964B0187F56FE1F02662B7DFD745F2F3BCCC43
23C8FFD86F382E99DFF681A7D22CD133153C40C3FCBDF86DBED11FD36F9B6B3F
C5FDBEFB72496F3C209BD61EB9558CB2BB1672CAD20F8086DF3492147770C0F5
95444F8731D0A1F6036C3099DAC1993B2C838794554E8A3B96614090077BAB84
A5954FF123B90550E1D1A4AB2CA6E8214C473B3CF56746959C062AB6C28EC09B
F22096BF7FB6321338085C726C42745088742C6C55D4EA9854CAA71E7BAFEC70
A29302F3C909A6E193ACDC6496F7929713DDD1F4B813D73E794377CC0B956B9C
2D07F5AF8C01D7D9F932F114547E4EBB953ADCED8B20E83FF41B1F4FA5A02915
0C63DC0619BD7E3B5E6FA60157A21794D7299C5774C0FF7D929FE9BC1EABB7F3
193E83584567271D2123E6B069DC23889B93CBF2ECE77CD8CCD649AE853784CE
A79337DC93FB835373CAB6E183F5CFEDCE41C418E8C0C48D02BDDDC0CD3D3B4B
285195948E36529F28A6F925FDF16248F9331CBF5A08DC0ECDE2C36FB0A0AB89
2DC0EA84D93C834DDC1BF962D89153901ED7784D9E68BD06357F279CCB7C602B
CCF4F389CD7CB4197D2A9271D65097AC31DC2FFEF76884D0910639237DD0C020
F0DDBBAD4C2883ED7313DFA0539D989C1FABB6A5ED54FC791B196AFE787363DE
6688123AAD777F27E4DD19C32B7FAFB9E8E0552DE8DA00570B1AC3E8CA4C7866
6CDE42B4CB89FA30F0AC964EC7F2F77D3F1980313330F26E545BC7A8F5072AA3
2FB0329361BC8BE2C2B48FD060C89CAED6DD9BF6462BEE5FBA59C569D8EEEEFD
8C1BBEA3B73A537D1256C7D6CC73A9CFA3DDB34252A3A4509536D62802A615DA
4AC07C441743B45A15D85181482717316C5B12F6E52BF9A1C287801F3677CFEA
6B60F505F9234792D6E82DCE04C72C308C0D17B80B14B291AA4B437DB7CE5E35
436CC41F868ED6162F25BE5C9FE406FE656FAAA39A72CD5DE07569F21C55198E
54678E869AB6959798013ED6CB2D9CAF568F43D2624ED5F602B7F16F9D27C12D
48EE40743E1DA97E6702FC3634CEE0AF9E6FB3C4587346219C4CDC0B6CCF7F99
E40B48B6C7F5BB21DA0656B683E71A4CC310B001A180D9E00BE05215B170D2B5
C93C2636B61BA3A840076A5F41B8DB3E0B2A38C3848DB0CCD419E5E14DCD1397
AD9811172CE82D7CC7D825B6722205E0072FC807FB647E0442333D42CF799579
C7B7406D147A69C59E03536C8D2EF372AD9C374B977CE1A0784C83073742008E
480EC148196F146C5278FF1EC8252E708B9042389C11547351F093CA8488DC3E
1D5126DF92EB568240BBBDD84B2129B6E8FD6999651566BFB632984240E14F4A
E8F5BC9C04ACFB19B327E5246E5BA5B73A0A308D930A588E57174574ED2FE506
9512E3CD02D75AFDC1A36BFB585493E4164F3894679FA602BEDD8CE9E821D187
47CD38794364E336B65126F61CD3CA861F9919F24CDD410E5F03AAFC4E45E30A
486F6CB28CE7A6A2125C55CCCC11BA659E72234CE9D5F6
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: 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 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 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
2E080C10DE923C1F7BD11CA700DA95F7E94C4C77EB24EFB7D5DD39CF43896343
AD32237117AD4B4C24EF2B9AAB4228720C9F9EDA61ECC327D71641E9657DB045
3E35C6ED9AFD4B88FBBC287F2B08E20CD064866D01062364E81E3594D85A3216
396597A1DFC0BE35873C5BF3B12F115AE64354DE66EACD29A904A98FB23A530A
64D6DBD4198DF302D6EC7460A65E40609374E2031E0A3E8A3CB33C9823F1CEDA
6857069DCB4384BD963FE143AB8C46C2A6953B5EE8CA955E084517BDEB8A6EAE
7004A47347A65802F42FB1C3E2BCDFEED75859F600C521207B1F12360D8B5B5E
BCDDD9A8B43BE2886777EAB5A7006AB74FE08677A20579E5E0B6B949759F8346
347F3AF2C105AF9A10341270B338AB4FDC2288B79D98A54F8457205DF24ED632
B28F3773A7D9B85113CB50A9C472C537EC2F2AEC0243B6211664D78DE60EB3C9
717285D76DD931E6BFC44864BFC7F99BFDB8A2954BF0C5712F21B490CD7E416F
12EBFE13341161A9053FF78435759B60B0F54888463C4B456CBAC7490988317F
17CCF703B1298BFF7B8F1002A86171BD2B7E9D8C4E20D426C132E7A9A1020653
B82A9B932ADB1C912AB90997600AF5D56DBCE887D79EB994466A78D9040C2034
1E537DA15822B32E17DA808628519B5D964B961125D6CE8158FD72D84EC1021C
68FB5F28CCC9FC14CA321D290B9A2F8A9196B06F787DC618E6C1957AE2DD8C3F
C2D2BE2A46B8A2CB9BA13255AA74ECFAAB942328B176D6E13C3810CF28B976BA
58E89F16B00B2BE618A07955CC9C46A95F5A07FB240D95452CE799C8709D45A1
85994D7BAB6792B58694594B881C240F3C36129EFBFA4AC5B5074E390AB2E39F
CE9E366EA4E95A5DFF8CA2E144E2F0050F512414FBDA7A7EA24D2804D22FAA04
C2261EE07DD605953453B94243250098753EC7FAF186A2BB5FD481DE92D3A6B1
E03DCF5C2E2EB80A30D0569ED52550B5ACB2BBF67A86D4F4E65D868B2178AC94
14C344582F4ADB60E79ED161C0B7DB7CC6FF8C391FC1B2A290B33DEAB127C200
C309335A5601E10DA4BE03730AF8297EF872B08C54110804CE0FAD959F416B9D
5E13E390C820F540C109F6D0F71AF41B0587CA7450810019F8CAEC40CFC3C617
5D0163AAAF368C1DDC966CAE0BC65A31083D01CA513CAA2A5D3FDD301A557CAD
148344C2463CD950F033DF4686BC452D6206760EDB2EB00026F5318440AC8795
D1F9C0595F392BC030B70806C8FEE3DE6C140547CA3CAE9B4B3F1663CFDB5519
6F2790055E57B004E48FDCEC080F8C8417FCB849E34D5C85CDE82D435089956A
C0F3E924EB2C4328CBFDA7D115BDBC58716D98B4F49A6F2E841AD8B31F2148D1
34A68D8E23ED7AF5D891A520ADE49714ACD727EE708BCB6668939DCE322AF08E
53F071980E0077FC9BA5A10B3BF911664F61327233022B59E72F38B2A64E90AA
C858FEFC4476C42C6398128D10F889CB7E0B96E4D13EFE60CD99998388CCB554
C7561FCCE0BC98152D9E4FB1D7AB69A5BBB87CE684CB2795F90A682210E75F9A
539CADFF715672E0122236E42A8F54DD833D4F99E672B390CB63849D911943E4
CB0C6C9693751380E7ED446DADB9C7CD98E042FEA6E76E473AB981D8A5CED403
9A06577BF4960204938151DACE2CB21BA653A580DC8E57500B172839CBDE3751
8A48345DD78508B4D5B35083973E026272994D3D58C6BC0F505BFCF708388ECA
514F0DB510FF93CF4673EF0A19A89B0E08F3235BABE22638A843CD1B92DC72F6
7EF613DCA9053AE8177BF3650C44CCCE8F1B7CCE6EE269F54F8857B5576BA1D7
8403538A00B1675276C38CD38CBC7B73906FAA9A34DE35A9F03CE84A0E60B499
CFBA23F6C2EB6580B07EF12D68446359FF50E039E0AC2186499E9B589B6DD483
0D432890F26241863A182314369ABE41338B2883A7CCA07439FE96465A5DE153
490D3DDFEC94DFE203CA50520AB3553F6FF5630404C2A2BCA0E65935210CFDDD
433842A96E7646942824D43D0F9F5DDA9195850737EDE2D65B769292D5427023
AEB225160606F8D821F08AB9B33E8C30D492E1C57A3259B1CFC1C56C5747EFE4
792D365BD95A08758383C496F6D2729EDD5297E8C1571C2711F65FD6D6BA0126
BCC6FCADF50C3075B9339D9194E79A4377D728EFD1E597635425407FD3BF22E1
062866AC4580ED0DCE3329BD884F5E022385FB0D020CAD3ACBB9B0F696C4C911
8C26C714194A606A95441101F427247208E296212B4FDF1E68CD054122C64CD6
C0CD1EE077F2630FC30DA75EA8C3DEB388418C004557EBE97A136308B2E8F079
2A225D5684449EC17A1A288265CDC0A0FAE05DF0F03AC4C61B13C2AF9C5AEB97
4E63BB904FC564A28601A9F79E43155F3560A67B2B49EBDB1399962A2C0F55ED
73FC547D024FE86F65FE2AB8EE5B65377F9458077B0C6D31BE033B258B87E1DE
2C9646601F49B17A69341E8064F6DF881046488C2FA69AA0F9BD635057256127
C4DC77D9D71C895D3040F9E6EF7653BE1F904978749D5F98F531C5564FE02F4D
000DB6DF12C17EB6B9C13726B0DD1D8A23F5CA8B984A350DE453F808963140E4
3248089231E94E9B298DC62B46610176ECF3B8A1C77064CA3E90480C27FB8B01
5E06A2CC70485242DE5CAD12DBE8037433E39E978DCA6D59923C557FDEBCBAFA
48B435C528845F0B7BEED2323CB3622C19816F2AAD6BC7027E36BE571A1C8FF9
F2090A806CCA9B4A869E5E15EB363C608EDFD82C88A11E6644978790A0AD0647
A786BDC3B6F0531B1D5F01AD551C3C759EFAF72E146CC7BB125ACD1DD6197DC5
2B3AAA053519F55E433569CEECBA8009C20B4AAFDE97B8EA362C8639ADB0F771
0D7AFD709E4E16C1CCAC746A2307505A462F77B1B977F4EF3BC32CD87968D463
C7B02975D3269F1E3AB3CB1565CBE061F928AB2943B43408891B9D3C6FF864B8
FD69D33E79951101FACE7C635F8B2BD3F45C27F4E2F119C969F552EC2C5D047D
EC3D0C212AA56F51240DB8861DF7398C3897B8DD8F1B2400FB49197AED7803AA
FC07426EF806A7CB2DD05B8978996754E72BD2A3078E578191221EC40C71F050
79257CA1E7B0EAACB2C0DEEF23C4B2BCA93AF1BB58D94BCA90BC12A50FF9FC32
253C51DC821ED1FA42318788342A8C1812EB45E1A1AA66D9CCFE0D7A107638CD
EFB007C6A6BE3D58B81AA688D787F7D0553677EFE62A3E59C2874A88D5719E8F
9F1E12B507D39FF42589C1475DC5F0974B423DB8DBCBA2C04075518EF5CD747D
C582F0DEFE4F674617DE189EF2030FB38194C08D3FF6D0CC1969494D86A74342
337F5A3EAB685175FCF927B27E00F69A3F0B5B65E6FCB9C310ABBD731CA8D647
F87D8B2BAC0D46E4CB24290D064B536CC0FEE46BE2E0982DC832F17A8668A78D
313F9943C5CE466123BC3B80122B69278A3B61FD4C5ACEFFA8B62EB6A1DA2AEC
7A7FB0D4B1A5D3B59235430FA156F45CA682AD86F3FF33D94C0867AD1E1D7AD8
7439A4E3ABE919C6E3DE041175E0E3A1F2A878CF7144ADD7091DC52E5BE98830
0AB8869740D57C6013C92CF23FE175EBD5C26330CA8B83F1B3EA50228085651E
64F36D1E8B1FEC84FE96CD2BC8AF45198C9CD8388301B1BAE9926BD8A014CEAC
3F8D5AA5C6DD2232A3F2FEB58E86F2835FB055ABA8567A3E53D0D7DD404E0D99
7F2D19678CF28BBC35AFDD80DA0F1F47060CBCEA4EC5358FA8B000C570169AA7
6718FF6DD3EA7622AB8725FD764C2EC14E2DCDA0548EB94981931C0A2FBFE083
37D342A73ADF7BD3282E25390EA45D5AE7052C058AD6780ED90AA5007669AD9D
839B78DBC708D312C5E109E7756AE6D7D6BB2191FE1B6EC56B0721E6A53C8CB1
6519FB1F37A8F38EC33E4A5766672E4785475A0F8431CEE6D66FDFA4680BCB28
4EFAAC29A37BC21D9B884F508738D5F0225ABCDF34CEBD4D173321E328F877E8
590DA7057B8EC485BC92A14DFAA31A63A6244D1AF09F29F0E36C6F9CFF260EED
10CC0D2730237B4C7D32BFDD509B6E3502A463284271A3991982887CF56DD662
0654E725CE1642E0816092D6EA59CB60244DE99E733C2C8E990EF76B70B20B00
734092F47103AE3ADD001D19F588546D8F9E8405290CA23BB3D3FA81F034EE89
EEC731F922E6F28BBF12798A0A4D6856DC7D1987829310C32CB81B5F85B92FA4
3DBA34BD1950E4E4ADD08B54F12F923A36195790A7D91447E91C75DB1D17F351
D2FE11A9158534ADF9D06E2CA4BC2F11E9914AE70550D52C5667DE9DCDDEEF24
E57C9F372DE435F3FFBB3BD498BD0B56B1B53534CE9F74BDF113E06268AA1050
CC6D925F17CE2F7AF499C5DA843EFE205E640079F47F5B5BA0F8FA27FB30DBBC
3D3F95DE3D72DA6E726F7D599AB903EA90506732D051B5541C5952D522F354EB
F8B4E8C34660F9A53F9299DABF9C0CB5EE6F0685E522042814F58A0C5B54E0CE
58BB142FF89520E7DCD0321598AEEBB393008EFC4774E2B3BAA16C714BA68DE0
C8814BDE1B37E87B1F7D4E8177A23C793F8D3F6CBC6833848CCC0885D01F20C2
479E8F80CD07715EDB2BA7139837DB3E090F2FF71A66016E6805C6CACB18BA97
035C6F33D8CB3CEB57D55B07AB10FBD469B14933299737F2535C97643662868E
41B46920C640A039A4DCE141371BCA56E66A2A6C0FF74A4CF52A851291B7B674
8B7B676307320B1DE482A28741FE51E8FCCCB79DF636DDD2CCD73F2B46C29C2B
6B32C6C58AD847A41486323E5B75AB58BCF81FAB2E7D794191D6C66F1DD1F742
6B0D0356D9460AE3287B98D3613E576238C10B6D18D4FC4FF25ED3A7A85EEDD7
5FACEAB91FB2F0E6ABB6499AE02C3B1E6D2032BDF5E1ACC575620FD8199058DD
499B758C1B5C0B69F930F3A4C73E2E363168FD7E03352DBAA3FAEB32B29C34EB
7DB8B049FE0C20AE7B36DA2F783F8AF72CFBDFC698CEC9362FB188DE13CF08B4
830993A117A1F06996B000787DDFBEDA484266BF6956FB0B27CF5613CF11DF1C
2BB3677E8CD75742BE2DF91F646817E1EC1F60EE24AC8B116CA297F57CF6317D
0F098301800B7664C0C19D12BC6C85688F105D3C91F18C6166EB9E586980FD40
1928B4190E3DFCFB858DCFB0B8A536D14B9AF13BA62BD71969E9141ADEEDAB35
1DA0931BF97D7749C4F93577D4DFFE52B373D4E88D85BE4F9E87B858AB32C26F
D4417FCA56EA2EBD9C96D3596D09781E09AFFFB1B4441293EA965FE8F78487A0
5B327A789E1104D30C62248A62660C3F5710E0DE61F6F5DF848507F1CB7DCCDA
5F4D645939ABBAE1472F2704FEBF7AE27D7075946A02E322D43DB7A48F75A467
5E081127E8CC6C1F4E674A6A8883E67BF4CD67DC016F0734DB7D2D1CA01FCEE6
DD0B05A18A0FE8D678524A936B4AC20E512606DC99F412B589DE60841A0B67D0
82F5F8202C1C561A60CD6779FB9DB36D5C210973BC6460EF7A01271CDB1F1D63
FADD31E847C3B1EB0B9D4803A59CF6101D2178B0C68660E5078DCE5079FCCEEE
1DBE1E9FB0ACC7C973CD013E06A8D0D99B73E863987676E852F08756EE0DC548
D2ACE7C12532CF8A53253722C0AC57FAA8E9B95916E30B46A8481C6607CC8979
012E32098D7BF25586677CF9349456D708D37D676AB9E72877A4AA616389EACC
D4568F515BFDA5F56938455FD44F42AED19E9933930F0BE06B999D82C9A1A37E
BBB23B6F155C8DF5CD9374D76DE34F099B42DD6DE794BF68684DB697EA5ACDED
49880D90DBEC3E5E2F5EC08F1EA04B29174D918F6DA252FDF531D7873BF74871
224BCB8A5AD6D87583AEEB673FB02EADFE76CFB7D08ADD021FC30DDE27E77D7F
50F3B5D09196AB64CE919D4E991D84D1D583763D5ED14EF6B106399908DBAED0
D3900D1E15205C0F4B5AFF9104926FEAF219FEB0690552827DC496C10556441F
60FB15A6D64B52B2F84C6E49DFDF59816D67553AD81ED5573B000FDD6519864D
C384B3D60EEF2B1BB5C1141764AD6807DBF37BE031D670AF8632BE22A7076AA9
99555DE31320B458C792EBD69279F58EC7317B1A52D0E51E950D76FB2C254C11
CF91B8EB98EA650ACCE188585E642D17A211DA2574E509EB4E87EBFE313CBFDE
51F501C45B182D75EBFEA3EC9B95691E097E46D792BC095C6B0BD266B097BAB7
9B8ED5797C17FDDB538AA00DB25482823B875CCD6E5EE55A76FCECAFFE8631B5
3E4C3E9EC1E5408A2A2010FF96502D1CB940350524C797A89A5FF8E6AB47E4D2
80BBE24B89EC689BFB00B9C5B469620DBB2F0281B757FF3AD2E84EFD0CA3D456
A481978D788B40C8EF363A41B2C85E0AE198216E29A17D67D0FB19919879EA31
57B62FA6123AC99A36840C6432895DC4528BE0D2FB5FE4F24F5DE3DFC5CE5E57
CA4BE5EC998712BE30C680B8DD1F730CED756221598A0A8E5C448800491D8907
A80C58E0D78D4A53C7B651177453802785A39C887AD73E87908D1E6AF244C67A
9A5029E17CA9F1BAFCC5802E842C33B39275F046C809F2AC427279361B3FCA39
154E1175EFDB43DCD748DC7ABC240C8AED3F4FD78FF4C7AA684AADCEDC564AED
B35CF787921E74B51F4BAF2A8EC4BB2C3A78D2CD697BBAF16A14236BF7607F81
6093A211924ECEBC1AA68511F7D9963DEC9689E801CA25DB41B89782A6471A62
92965E950E21D5E41CE5496D95553FE6B9BDD94424914A3DA9F878A28BCF77B3
BDA77E647D03250DFF74A2D17CD59BCC2763171F0EFA759C453A435F0AFC814E
D64E3EDD354A334150402AC48A6F84693B2C10E91C67537B45A5308502E96460
871481EB917739EB412DC4262012D9ADED07CA03BABCACDD04A6C3A87F4938CD
6EE57009BB556DBCAA1E208D1B2C03F01E47EC0826C99C8A8DFB89212193E8A0
2B2865539F8B7888664DE8CD3E5A193E6320EE7E111EF5A3EB73DF7ED921E4E7
A26B1B1D18D92D78858086F7133DF3ECC8A80E499C576DAFFA25DA530769829D
FC01632F7E18C5F481DB0006621F7DD4320ACEF939AEF57A41A11E6BF8A183DC
6B2380A390E5F3568AAA53ED30292C6B28EC7EC45C17F471229E37FB8C1E5582
B480FA1B647B69280035A0823C512F4AA0286201B2C9B7CA85D5FA65648F1479
C86882D06BAFC16E0BE7EF0F4E16FBC4ADED7F49A2DCC9E151E26F1502748B2C
0BC4FECC8B11398034491060133041AF08BF8EF5B1103852F3834F6DD659494D
4AFD896D3E85560664B0F1F031ADACC315BC6140CF38668BBDEC82C202890144
64BB345B4866F14CABC63D744F3E158AEEB004AC1A550502C2AD5F9595170EC0
BE4A0A8D1232E0DEDA7F829B0D1A599BAD2007F9111EC24F1E08022168C2C34A
B1DBC6A844531D7A8D21731C042A7B380A1FB1D6B82E6EA341B123F8CC078324
95A5049CC0C46392EB9116A03FE0F1B6168D272D96D8281A1527CA80A16A7449
F31C1948E9D6A0E6550B686D985786CB6AC7B58DB428755875CFAE0572D2FD6F
7AA794CEC2AF0B7099AFC1DA5B3ABB479A7530B8EB9BCE9688BCE0276BA736BA
E88737ACD9E781828D687114ED67DCAFD4E7404C7C0E924A9141CC27692BEBE9
5E8660B935A6F18F321E0AFA5B606F67A4D8CDDE5B424E504D52B2CB8E831A5D
F77DCCA96FC7D75E24F2D44D897FBBC3E35C98EFC52875E149E2C583AF6C10CA
BEDDD89A099F97D70AD5CA26C0CCF9E65352819C2FA1174C157E69D48AB817FC
007ED04651DDEB2FF2D8D7D405B401DAEBCE6151353441860A41731CE520F75F
6FA578EAFE5631925738B325F8AF2B0E15A5B84E9E1E203119ADF574989F3B33
84404AF0FF3EF287A226E8C9877DAAFB358E5F1A5F5420767C0B6836FFE901F7
CD1DF68CA5778B4649759E1F3F9FB5C5748E295ACD163EBF1EFB64785625ECB7
A5060407B009B0CBEF3FF5935CB10233BD332B73F9C69AF4ADF799CFA08EF25C
A6CCCA840FAEBBC99C8639A75667BF652CF3FC25542FA6D873AEDC7AE369BB1E
C15BEB51ACB928C61F97E45559FDC572003885B999B4B91F66459BA96082C763
A9F7A5C7C7F27B9CFAE1E80ADA4570300158A71016DA3600579434AF7F35AE65
8B267F947E13216E437A98485CCBC940389CFDB05BA3E663DACF32F21978FDB5
18528E1CB7AE189E007FA0778D62B9D05592E25559747E578C17156BB507D6DF
4B4198BED9F33ABD6E93F7D084DB0824F0C351F8D820BD9530CBC821CBDB276A
8C58D133DB076D9BB5689DCA2257FBC741C5F59AECB0BAFF81E0B899291B6F72
5CAF3CE6A729BABE19AD5E6C31A790ACE92E952E82638B6AE9C0F61FF3A30003
22F75DD843E2317CBA51FEC548525A4C8EDE18D2FEA0F6D8FC00B33E44938D2E
88663593AC4D1652680D51F1DACC46413C43902F77790B1C2E266293EBFB9C78
833A274EDBF9BC80D19212D2635532B935766D0006697A7EC775AA3657152D72
53540266F89330E3E19671E73E4BBB5F9A716EB13CD23FEC5B5358C7E004F101
6100FEBFBE124B765BE98D24BF2E89AAD4A27C75A3549CD3907BD582E577B1C9
1543C1AA7625E5AC9AFFCA8BEB637E5EA8C2BEAA30C8A7741D954422171D5086
07E87A41204D0CCBD3A22E2D5184764921F19ED5981C52B539B06EDFF7A3EC02
DF85F0132F038BE6CA49DB6A4F5A17CD5FA0AEC05478BE9605A3F7BA1159A76F
03A38668E6F2C72AA7E4DDE730641216CF7B9A61BFEA6EF937A54F2A2962A320
9498FD339342ECD80A0FB71DE820AE65B80A5B7A8E9196D2530B8DEB0A1FB8C7
15EAAD601F6836A6C8C0605BBB6A336A523A6CAF13B064D04F48F002B579266A
A46A47426ADB627668386804EB7AA726E1D65249F6440447BEC02306368C6B9B
0C736C4E5BD2362B7C9F0F7540B5DEBF391141BAE24EE7995303C1967B3DA371
E0E052DB1D5259725163265BDFEAD1798D71912B4C7AE63BA1CEF08FB8A15E3A
25D67D9E3A70A040AFC254086D02FCDA5BCC1EF37450BA967EA9AA5C952AB4F2
64F3D7487617B261CB8DDA5AD34429E3474A5C12D7DABD9F7053B22935909AE7
D1D554D0C24436476ED68B1D209DD7AA80A6A547E045178D1763D596A5CA7AC6
4E38DFD247A13D54EE7F2FF5A3442EDDF7F4894CA301A05ADD6E9C5020076497
F2BF7F15BC210DFCE1A8DB7DB5ECA33EC5A7D635C089620177BD3E1F981D9CBA
B1299C0CFB41F53253A367F7B05C110C3702C570EE29503EFCAB28EAE54FC81C
922A0A80EC12E1A5D7C191603CCEB1FC7F41B06F2D91DADB13716D2D1F6BBB2F
927AB0F59DEA31F198D5422989AF7AE03D5F4AEF146323F8977F79540DC4200A
89615E702B72127B7FAFEA8152B53EA8ED9BE3BE7EE935B61ABD0B9C3DFE96E5
B1A47626E4B62D96A9AEA785524FE73F68FA218DD58918D55E8338000DF0F5AC
6ECC8E6ED15AF45B45E74AED4F06C132E8076E21C79F6D313494BA23EAC84742
2F778B9948CAD5BA1D589A3EA21516EC56A5E40D4CC0A5919180C2736D6570CC
FC03087BB9333C11310C8E5D814CB9AE8EC2D2973437F8B80C8CF48930E228B1
4B35BFF4A7423DFD51D881829038D15AA5E3AC6AB976D3549CCBBD59034F1E7B
A539B629EB8C2FD450677510A7056C1D6184C20AE04B8BE7525526C9B19BC64B
1B3F6BFFB675B7D218D58C8D87F4EB1A28082A923D404CC58859AE55F0F8F433
3063E52630170B2CB806BC95469581FB149AC66F00C26466ED3E1BA6459309DF
AE6050F36FEF2453D0CDB3DDAED0FD1E5C7B21A9469E62E9CC09
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 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 73 /I 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 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
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
9F9926F541DDE4E9B734A985F9054493508C5F7EF9ADE372C520840F15F705D2
51826A537FD158C4105443E38116307A1D4608E9C6FEC3353F57E65E150EAC0D
B923BA82331D83E41C97ECAD6F8F32242DFB52EAFE2209B9F41DE483C8549B97
407186E3A04011C8301B6C9A6D36D8170F40523FEBA5E498B8E5B7BB28581B5A
08892C2894316068537336338E46F5113462AEA9DA7102ADD13EFD2EBFBC27EF
00B38C25E4E23843C50C888B22BE1C76AC3F85CE148B7EA0F47D72E56726D13C
ADE5A5D539A8379887352298B7ED202D909C8BBFAA0BBE7CD378B80488333B88
E38B1C3C8DD17F32583A642A1D0A4408B0C244185C1376364E723D83803813BF
106524811B9116A47F0A3205513EB80A4F798B330C9C4560F98FC3A2FA181680
C83D6BA02AEB9E57310A60C39D31D5BC8AE28BB3171F90B69C11688521BA0845
3F7D6E4CDB496E3F8B46D080156669BE81DE017A70B3B7D5EFD202F26514335E
E06DF49F24576733B1BC191480D8C4E613537A80FBB7C408E7562D31833E3405
2C16297EFEA28E55E929640DDC8D9C12D15A89A03C8637336BDD0D712AD5A2EE
34012D38FD1AC70D13C3833B0A055B545F9EE98A463A2B3B424CC138AF6CA929
A7BD80C3A804D5F80153DCA086B862A7D621B47F109EB93D67A73934B066B546
BF15F27517D10CB8C83F7B319F423C16B42AA435231B9C4A05053D7109715804
660B7052FAC3EF49E66AA763DCF07FD1AEFB5ADBC9913D3329AF36A7C5359038
963383D68357C48B254DC2508706B1D5B71B66E2589214A336ACB11EA0E4070E
3F993DACD86186718E488D4734F024DB314643A9488841654924DF275A1A2221
2FCDFDB677FC3FB49409A644CEB01B260A4210613C0AB3FA3BBA7CFD4CF2867B
B261875B9C592124D8A5609FCE7B376A39F6AC86E94F40587F69BE0E8B4C2E64
DDBFADD699BCAA66A856556CDE4620A3C104EE29F9523D0ECBE6552A1B8211CF
66D12AFAA3E9611858D51B46039B5EF0F3E9A020A6370B34E80F83195A643F15
86934B5BA8B60ECCD0D3C9496F8D32E70ABE513FCBB85A77D992E73AF8B955DD
5AE1FDC1CD972E81DF6816DBBDB583FC1410D2486F7479F1A466182482EFFE44
DAC31E1F059370329DE19FE4629F33433576C1E3E6B49F122F2F7333C36AC744
BA663E209AB384C9AC13B5AF8E9D0D7182D5F4D1EA874AE24DBA41DDB6586535
8CA487EE4084602F3F2A7A46A1DEF17DE9B98728FB8113FD1BC2A62D3EAF7F83
EEB13A260689B6BC369064D027601C48AF68CF0B507BD5AA8426833B11D5F086
E0759BF00A3044F0719679D27D8D8AFA8FC303917255FBE6C1317702DAAB2C88
4669AE63FDC111F7FDF28CDBADD14E9D82CB39340F567FFDFA4716CB99CED1C5
871E005ED9EF2A8C3BD948CAD403F180EC8649FA7C4258DB0E1CA5F1ACA24DBD
B59A2D1D7D920103457822D0F03F7D4CA5FA2D944B13FAFE51C031FC9416E5E3
4987815ABCD52F279B7E1A86F659576B57860004E6E22A6FF097760138E683C0
638CA1E808E4B88CE859772171D8F864F99FA82FBB5909E75603C5010D49C62F
256EF48E28DB392A15716DCDEE0993D3C8B9D7A8DEE99AF3401FA9A39521767B
F04344EBC10A08F880FE13DB7E11AFE3372B8691EA9807B11BAE3C4B7536B7CC
B58A3DED042A85AE55ADA24E74A0A50BC5747F9C8E816A132CBB3987FAEBF451
22FE85DD817E8E6B9DA980F189103C5E972614AE92FD7506CC61589B2284BC84
A4486A73B619585F82FDE4410A3841729C2A26E7E6FD5052FEEAEFF792EC1B58
0131564B3C5FF80F3FDB1132BC1D83FD8D0B4961AA68000BFB9A0989036BB0E2
CDDB585566EADC55623BDEA1F218DFD343324776DD201CDC9AEE023DF5B98195
AD23DE4BB8EC522DDC094D15A76FD38B85964AAAD1E2DF9513B87281F7106032
D833B6E2019EA1E9D05C7AB6CB34DA376FD9BA187E8BDA5DF7EE06134DA2F577
115F6E891601CAE2BFDB23FEB902E2B1A43F7A834632B6A7784EF9E9A659DE56
5E7E66BD19DC11ED276BC0E117C8968E955629700B639BAE108F342BF38220BC
A4C110641D1F70F6843206711275F5C33A6100CD20825B2ECE39EBA78631E349
FAAB77A671146B5A712B40F644B86BB1BF3EE8F75E49ABBC757485C1A53BD9B9
34BCFF603FFF6AE40A641E9626B0F9259F79B06BA573D6A42DCFA21A7D69BF63
E1BCCFE3816EB1247C9F6DFC07A59656D89D69DB5DAB731BC84B77EFE8860EE2
AD317C5F30763FF2C1B9C00C0FD480282FC591C84D7E5AB2A795B1D2B3E50E5D
6061F96ADC97AA2DA0B04E96F8E3961CCE37109474963F05E9C15FDF55214DD5
210DD9C43391D12018AE5480429C9D0738CCB2B0178A8824968536C99CB0BE77
B649AB272EDCF07F46DE28AC2DB08DEABD47C1EADB1B2193EB614BC26FF58583
B4543394A1C8DCB80606EE803B273D8E313179922EA334B26E58EDA4C2BDFF7D
3A7D83E0EE66A4FC9C6BC9863F8F9752D66CD473F28194B9F26D624F30FF8DBC
77A700D39436E16839628F46B0F3637AA4E8BF1B6F5B95CFECD5626B13634939
C46CE51287BCD099E31DADA771D251961E311640C0623956B2AADBD1F18A5F74
8DAFFBD0C0AD49F4EF2880A60AE0DF30AD1425B79DB0CDCF9472D2EA009E9829
56EA40DF5941215E176B1AF92C6374AF78D9E6622CB915537EB9F5DD807EFE7C
9749B43CD46272AE2101C1172A5210A4F71421E75C874046540050485E27FC7E
C4A5DF6E3679343F161F3BDEDE5BF274D8B052224E987F4A135D2D8FE7F84EE1
E0BF07ACF7C40DC3A9C50CEDFB0EB5EDE8FE341E696ADC8710EFA61526629305
AC390632DE1B80CBE8B55B2A9600D8B94CBB43F4E0728C08B250A8F4FE484720
E6A260E226D420DE06A87617A3264792743639A0FE4A2ED4D9627E78B0222991
A583A5A87AEA5D695EBEF083D770C5771D7304E17ED5FDA30485E82FC8C41B86
4D68C82CC51D87AF64B277E0DF3E97BD5887C7E1D913185D2FA7F29FF0BEC2BE
14A3E6D029DEA2D9DB4A08B5B3ED8157FEDA81F552EF0918ADCDE7580C48FD58
B0FC972EE053225A5B2264685C7A14AFF0706B13EA016721DAE4F8525B8C1E80
A3213A33114A3007B7EA5CD2B1AF43487F191D22A5C106D3BA83A22673131EE2
5B370CC9430E2FCA3B5E3D181FF1FE29DF3A9E6823F243708D19260EC2BF31CB
BCBF8684B4E663F3B93AE10A636CC9E2F075C29F2AC4951E85DEE75B87FE2438
C389B91443C821D4183C0C35E916FF970B51856FB04B61FF8A265206898EA5AB
CF60214736A9A0A9C320F462E7B6F7CB43C084589B88DF4217C69434107D8DFB
A9F3D9C248D26EC0F1225F842581F27265516AFCD19B9FDB23A18ACBEDA6AE5B
0C8445E30DA6F2611E3173B7E7A6C2BE8BCEE2FC8D688AE82CA35AA85B47C48D
A64FDC522636F50ABFC0B2EA41EA35D67B308CBF6C2A86B0CCB58A025DEF703B
FD186ED17A94B64DE3F9830621D11F0D94F518030A232D7C5927625B2B61F414
ECEC88EC56CE35BD4AC7F7D4257BA661D2856B8043F236CE60FBAC9186E0B245
9CA6DAA942CB5E4D5A4A59A48AEDE5EB78FE118F766FA9A16ECBB6CDEB641421
7267F61338AEC49F83A9DEA6DD1F7FBC53ECF8DF0C6C2EB871518A94CD832E53
1DA38A4390638D9115136C9D7E3FF7494DD7C2033D39D21FAC65512164664997
785058E339CBD84ADC911F1FF4633667B7C172748F83235C241EF9083A29B907
AC96C96B45CB517099E62B7E1DFC89390DBF51D02F1BF2A1AFD3AE38E3026990
5E9F5A6FA9746C9E61DB1A6EB4F484C4EFCEC8F915F46E196ADBA0D2FDB82E3B
1A97DA40A76874B349BA4D480C360FEC74B1CC187C76128624D1C063D077BB8D
F3E50D3CB072C7ACA0F3346BFB1D112EBED706BC035F8C8A6A23474BC914E551
1CA4FA8B354772352F7A0EEBDBCE9CBD523CC03E2C5C03084FD372DC9F7113A8
8ACEBCDA2378AD0570714AD3879C7A05F120D18DC6C0AC7C5950117B9C8D24A1
D59CBFEAAC8E439E52FE8438B59A7164CAF45C78E8396FE323FF38EA05B2107C
F20D2000F220EDF53987710F0C0E2DF4230391E545C2D21CC810A8E902323A2B
BA82A938A9221298D214BA068ACA55C690B7B7A508BD6595860E880F7AA9F030
27E4243410CAFFD55BA49F5CA06A8FF416F194D3E3AB7192ACF871C7478DF987
16540ABBB52520CBAEEB922BF441D940E813995D4ED3D8DD707A631707D5F553
D73223CDE27A4699C2B377C319C1A0896AA544018FE978F5E65B24B278A108B9
8F3D7FAEFB97C51F9AC0CC60BD9CC620B315C91027B83F0153BA8F7CF627934D
6D44536CE65F562ABF7A46DD66401FA9158F3B603ED6EE02C14B1919613FEC58
8243E4215173307F4EAE1FDAB515F26419DE06FF2DF62D0E0E60563BCA2A7634
4B58344AFFA0F104229A6BBAAB5CC149573A19C5903CBC58009807EB095ED97F
BFC664A073337252DFCF946620B1679778D6EEA5C1015B0F73E4DBC798F90AE1
5CC47F90690314CDAAF1FA54C47C9DA655DAD56FE577468C6199C346CE0D5C14
F3190325FEE8CD9F9545625F5F00EBA1B449F55FDD4E53FAE7C5286468677ED6
2F324DB5A9C804C8A2BEA08625C37E2341E5C5A49C06C15F23BBBD08D56FA07D
2E6FDF1CCB9143BDD8EF3C48079B16324FA502C29DB5120878BDAD0A783CFF92
19AF72D3844B77A18BF1D2BCE1C41134761176794957AF3B8634D9C5A269671F
5676B9D71F99E56EF7F84374F15099EB73515268827EAE0B114A10FDA6171656
249A963A32C88761299004EC6848BD76B6D8D68379EB302D2528ABBEB85CA4DB
DCB6B0C376D86530F4FE8E17B93952C50D2136CDFB1E217748CEBF8AA6B46BAB
73034165C62F02628CA60EACBEE01864323CD45EAC63832BDACEE0C39BF6952C
A07095AD3D82C80E2875ED7B998F8D9F5D26D7416AA70E53760C04D2F07CF734
E9AC0CBE98C1642B93075D96E35AF27717A52EEB4898F148BCD6F792194681E5
F0A396D7E2FC5676FA380A34EFC2085A7D0A5DDBA1476D0823BB77CEF027B833
A144BC9D0DDD83A6986D4153664226DEEA70796247B400AB0C53148D61BC69C6
BA4C4A288ABD172909EDEDB5CE6494B4F86A42572D0BCBCF857A64A13503EC6E
4B495640064B9C4299C0B6AE174DEEB07DB173AB3CD0A00F03E9545386A3AE24
717387668FD6EDFB94402E3512A7A6F14ED8F079ABD4E161D42B40BE5027E3E4
22D8EFD20D83D85AEDA43557FC14973ABDA50ED56948FAC97B44BF6EBBB6DAB2
E05C768D80E843837DAAFE5F4781812CE3364155672C77AB66301A94E2A9E6DB
85EF7C07FA61CB474C2CFC6A2F7D90962B4C0D9B95F391420EA0938BFA21461F
B979C547DD7144D2C73A0DB184D4E1152F82A559F09EBF4620BC1B9313E03FEC
0CA4C8D1EBDE10514F3ED772C73E76E67E3B20805A93BBC4E9646827276C758F
B57CEE6AF20227134072637C357683DE58A7830FA2227FA344860C2E4B332268
22E6346071A229CA44AF26E180BA8AF72645D356C8AC2DD443F8C9E4775316D4
F832981E22EBCC3D707DF08F12114D104341F83E27734D81A56005E5C0AA55F9
DBF4FB0D4B17BDBBDDB80B3EAA35925C70B846BC4C49D0ACFDDAAB55280E838E
A962BB1FB63870089E1670EA0F1E6F810830E100D00759E16688AF88C5E832A7
01EBEAB36927754AD34FBCF10F6B787B6CB1F90EE1C119A62E88B81BA82E71B2
97ED389F742FEF4B76CE6A17D0516BCFBEFE6F7185A54397B3538E190CC19E2E
4CCB233AD9126D64977FF2E89C12CBA5EB2ABF6E91289728CEB3CF67950765BD
B6CB85DDBC55A6F452561F0AF5350DFEFAC063CE5F25C6F00C7D2CEF0B880324
A82CBFF49C6796AA0C943440218E59C2A98E43C2D2764CAD05C0C5C4EA10F598
F97288CCEE303179D86191444516A79AE6C4FD1E9E60615E3B547CAB7D471F32
0CD1AF2B3F69C8C047FE1A01845D1F1A6EFED268601F87F8A92211BAB650913A
0A2D98053C511FA63A8B3813E2E2B3FEDC870C5E6206101C4DD70AD1CA223A32
FB276691EDF2421D12A4B330C4BC655A1218AAF015A384B8057A71B8696FBC73
CFA6A9CCEC4AD7B0789E290F483E96E741325E6062C5F0B37C50F75A81D00344
966F1FFDB35329F1653AC58EEE4C4B9E97F89EE4A3DAC15D67B6FA4C814A0995
7460E20953FBD68438F0FCC139724701242D7C45AD30C72141A695453D003D72
AFC26291C1F4BF991BEA7404DD85C825B840301B9215060870B1E5177D0AF621
83FE4365ADF6FF293B7F9627ABA242F0A3E4A608570E46682A0CCF1284961F63
B3E68FAD31F3452B5ACE03F95505B3BC194C783DE0F8BF66CAB795BAC0544191
4D98F68ED7E13FA2A535722B667F6DA5E91E74A01D815F8F3CCFB5B4820E0797
3553604F9341EC1B735D9F96457879D61A216A449D7B8A94C928154358253459
AF775289AD8E86DA52D05A2C58387ADC92B18E1F0D1C04CFBEE4877F49953FF2
42A7654DC8812CB057B305A68B6C22C8BAAE86855EC1ADFF0B3E00D60C853807
20B98B49E7B0A9E1583E685716F6C2CC58162127FC8558AB128B53554A679763
512DC6999BE36C0110423659F580491D0071B4AC2374D5D305AB506B24E63E44
BBD84371A903BF4CC762A0E0D3142BAF794A332B629C0C8F87366F0130FB6E7B
84BF4D812759F2AC831D1E3703177215908039D66CF07D17258BA2B34EBC5D68
E86A5F0252A7FD1EDACB59639A56C710049D5612818EBEE157A773D8AF209CD4
4A6816A6BA050D5C23B85C53E6C50CD2ACE0B218C8F87A54671E271EA0A8477F
4A1DD5D223C0C644580373A57CD67EF1CCF7FADAFCD53843526AA357F666B835
4BB78097E85D4D9211DD8F506380056F03D9C9DD9EF63EE9AE3A5FF0F74C654A
EDB34C3E9894E6248A583032501A0C4B3816262300859EDDEFC8B4B095130B91
A0E583759F16CB9E5B38C42CE172DE2DE760A9E994233F006CD772964A621DDD
686F4DE3DAA62A937ADCE746FADF3BEF3FC2F90C3661FCCCFAD07CD4C22A2F8C
4DF29BEC9C4ED7FB3006301DE829E18EC81C8B7F27EE3AEBE4292548C844523D
A6F07705F4F16891D5C310B62BC698014846F9887925163C732666B6595A19CF
4344B5391DC011EDA337BB0D00891E6CAA8A6DC61C87C467181950BDCF13A7E7
BECB71FBD2BFCD3D93135D5A508D172C3F63394A741E1F6764735A61B90353F7
B67797C681A1AB28131E8E29CD12906A9EE1E2844451FE9DD9B0228AB93C7310
F2FC310DDABB8418B1C29DB475E42233826FD9D0800196D6A825F380165E27EB
EE33F99FCEC55AB289E5D5BC4B02DE34008BA722EF503608673CAEEFC884E36B
2D2BF1B6410DE582CE243523ACDBBBDF75A886CA62C634F99A8216AAC0B762BC
4312371C42DF685CD54923B02A5C7610CFBC2F1AA39F0FB7EEE423B787308DE5
634071E08F7659C70A6EBB94826EFF8C817AD6A01B13E91F0F15F43100B0DB6D
052DB9CED475535E482A58E3528B50D66BF785454A17DA4E4280AAF58F6441FF
0D18F744E745FCD33024713DA26FD532E640E9BAB1195BCA469E9FF2476E9008
AEF4A4A68B5114A7C2A29448DB7A9E93AD6B06429D760AAD16B48FD9D5395480
36315FE778F795CD7B4F4F5081F8636FE81681E643BBE83740B8393E22293B6D
008C845E6B3B5F518B34337644792AC0169B793093D308641F4A4DD3DE51AABE
95E16160C170D0DCA01374D0EF9C0C1138AB40F2DF6E4E7E5C45C8707182F8DD
DD59586336662C831FD0228595D89E5818A85E6D2C461A252BC1A2DC5895D28F
C2CF0BCE8DE71A094B7BFB56A0640AF9274CDF166B0AA5F9E32C5F595ED7CECE
10F6DE434D4CE74211A93C88625E508546DD3715A18800E4829D27A0F1067F0A
31BF17B596F13E728FBCC9FC0EA5D01AA51B5CD8B76258FC9A283D7E7B8CF14C
80D2EAE16E5F6BFE3F773B6609BA7473B9431C7DF9560AD9FC6E4D64DCE17C7E
9AA26089E18C5AD0FCB8F1838E58124B0028B2C2E4D5CDE965D02195C16E968C
51714CCF9206576B6D07128DE08529C4D94A1E2986E9060CCBF3AD61C605035B
F78A0F954F3E1E5227526C47631375202CE7B71F014053C68652EC5DD89001E2
780310E4BDBE74B38CDABB12B604CA278AF003A951F7361A607A3AF0E1CD8C8D
065668CB80022EB608FFD13A49FFF3DDE556B4F8BB7D8B379120AAB86D71AD8E
64CFFB848D698536EF379DF427309125FDCAF1F521A767B8722DDC88A64F50AF
EA8043686A2BF63A8B447B6B588ED2985C773661881ABC98E09DE56F7F1FA305
78055AB3C1C99FB40A4FAA548BD9CA0B95C29D74E6A32F3058EBD42AC47B427B
98D24AEEBDC0F957EB5887100659B402AB542EB5EC0A4CD278ACAC36BD87798C
C41B89E8888E23552B06434635D39D6E4011F9E155D648029FBB2D9F8837774D
BB8A7D722A8EBAF520E0CCB55EF124E5E189BD7332E0EA5A90B10AB63FE405A1
6A40F4B356482ABADD9EFE8E7D2876F5BEE9405EAA684BEFCD179271C29AF089
097C485E4D7911EDA8997D29A67B9C225D592EE5B3B79C3F8931FD7B1A6E3960
328E1E2718E7F999714A6439F2DD59B5FA553106F3CA3F82D7247F61020C7440
F88FE379239A75D25FE3B3F20EAADEE28864FE249EE86664C792D92FB6E0EB6A
9D3F154EE8B06501A347761BEAE8929E122790A718E2389AF824728904A8D449
8DC150E294B5C9F4607019120F7255944A9A8D269ADB25FA6CF19FC52B50FE7C
B86962C94561EC3386D0D54E476AE255B82A242DF5676D26242C59391D0796E8
63039DC728F0787DAD489F3DD3F7DE89561892A5E8A38A3B28B7E942CD331E9C
DA010D80EE13169C73F055F2941462B954C1602E2BA63DAD5578DA5ED29F68C5
50A869EBA6FCE2683FBF6A22EC68D25B306A27B79AAF8E889E82E2986A8088DA
7934ACB4168DF49CB75BDA561940C8DD8A7800E4D0A7C1DA6A23C48AA319FFC9
3AD59846534F647DA0263EAB436564B6A501473795D2E5B5BD1E071292F958F0
909A4247E8714F06A959A5FD8407A4B5D701CAAA3D7AA7931E091EADA1821DB9
A795A21744000A01933981BC2C3382CC6C2878BE0F3C91DAD353C9182ECD3DE0
C8A7B8921F87CEF6A6124BEA3D7F77A4AE68731C0AA996A9BFD86D7E78BC99F7
E6B1BA1CB38EB0F4F36CE7537C3476E85123D3DCFE3B925BD5564705E204B101
FD0DBF5377E44978B52DBA6BCA2780DC42620ADB6EFCB026C148EFDE93DAE351
9388DCF162AD385FD4F9F3A671FB07570878A52DE86C00255E93B45D928449A0
36A0E59C8881CC43A72ABF81819AE18FBBACECB668E0F062591EE485CEEEE60D
F4F218CB633F7A0260B4884CF2EECF06E5705A197D2990DA5D9A7456129FB40F
C0C6B3B6B2FC22D4264BB48337A98C375DFCBF80080DF4AA0753293E91C96FA5
12A0B8136C7C4C80FB032C68EA75660EBD1FFB27491B7A6D984054D35FECA9D1
5FCCE108B2F3C4C23202CBF5B85BEE7F0F420FCD74CC5D558A016874EEE3B5D7
8E046B303D46468BEAB588ED948712DE467C5ED1F42DF22C9B402C596D24B72D
2F609E7CACDD293B5BF0C9553D22C47EA88339AFD06EB3AE466EC2333C1C85A1
00CA808A4264FFC89A485AAD982CE70C5EB9070BE28B380BC239FEE14C455994
726DD99D74920AFA174CE979BF410E72A22D151FD7BAC732B7BDD1A4142BDB99
70B521BAFCA51DED5829A9A36F7FAE6E41BFA981FF2F209C9F3DDD617890BA28
E2CDAB7E51D49C22F338ECAE92B418855FC59577F8F199F5E372AF73701CD030
273B84196E718BA54284A26D724ABF7E698A94A47CE3917467540AEC57B31E4D
3B8691B200EAEE8444AD5BA8C24A602B7EFAFDE2EF05BE950222229FE68CF9D2
7B5F40456B0C5A884385AE655B9AA57095B4A0B0199E7C787CCE1E0C1CAB4E18
506587C792DC259D0EA306972DB6170F008FC9582D4930BEC21D5DEED3670071
85EB62A3BA27A30C9245F0380F3FD20A085DD77661C3408378172F830AE09837
8380D1C07DA549314DFA349E9566259888581E212CCABA00BBAFF7FEABD4F848
6672980B30A1968293CC7E8A6D7DE4A5CFC7BA3708A76122A3D2552F69B6E79C
0D6C120A098404EC2B2B67E80DE56BE7BAC2A05FA3EE6B68596E98E3A997303A
D0A072D846360D0321F3F856A8C7007F489B82BE253435DE87C8163ECD0489E7
585ECEC657A0E040A9C1FF28C94BE2B2471AE2C5966778FAA120DB1DE340E3BB
9164EB236F63D8663566C306F263A79D03FA3C26F0A3A6DA8D0AA119EF05A515
CECB66F7D06EE72C00E2AE1363D5DA802AE6FDD5DC07F994B332332FC17A7AB7
258A0328BEC8F828CD3833F6066DADB4B62C42FE93F07E35D1C8483D12D52954
42795EB0130CF2A6A2600FEDED32D288DFFEB25FBA5EB70E4B78601A0A653162
5F6A3D4DB999E0AE48E8CAB9E332048EDE4ED293CC62B7867F3159C28D6D73B1
3A951C22096D1A77A68E37C2F6CDF58FBA5CE7D6B4E5E3FA78AC2B0845F7CE15
A27B284DEEAB751B1088C9E190F4B90D3D9E068AFE56EB07ED0C8E332A49E8B4
65570124F18665724A3E52A204BDB06D68B452A4D63F4B0CA4DFA3CED2FEEA1A
D86ABA5D4B3EC7943FA2DDB74F93D3D4A1CF559D2EB3CBA0B986E939137EE099
42CB3160219BB791799DDB079A10836EC5AC37E12137FC33266A7A6273987E57
C97EC1F6207AE4517CA2D4E08CA90A5DD27015C65D22DADC6D06DEBC6BA5989E
F64BB70FC214E1536882F72ECCF238CB5BE51A261CE55661ABA44D00DBDAE487
ABFE21C5178A131B5CB3
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 60 /exclamdown put
dup 61 /equal put
dup 62 /questiondown 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
653026524A2D101334AA3DF02A3CFA410836E6001561C00FB34AB04FF97302F0
7CCD024F8C61577E82FF229A45F7FE22ACEDD95AE8052044A41EDF46B8F84346
7275F5423171DF88188EE93BCFE0A84AE5C999E9C774A32B7A2826CEA8A8560B
2F61A42F967BCBE2081DCA5547D9EC53467ACF8A6AADFC54CEDB7305DD661ECC
3FE33D8C93D2425ED57BA83F360A384F6B94023EF8938DC136ED1F66CDB618EA
F40377CDEE0F17653E011F5CDE11C81A3FA5F7168681C02167B275AC0F73EF89
521A152823FCFC811C71E5D05D99094EB69E5724B34217D101BAA302B5BFDDF1
4DE66F7887BFD458C2A97A835C72E7A6EC2500577B0B057BA1B4773094EA1954
589FE5B1D1B4520FFBEFB6ECD015B606A244E605E78D39EDC316D97D99862CCE
898341583D28F141A02877B76050B07694737E9F107F153E5A5C7393CD479A09
114F07D12DE0185B971BD526301914EBAE20A38DC804C2319EFF3C8C4186630D
C91141528F408EEB02C718A0A3E0D39D1C9853F71113AC07DD209828B4873031
3E7A4E45D95025D9C558CC0C313BA3333EFCEB2D95B7BDA88C062E5243DFBD99
744C678DF4AE3478C68B4F7BF5C52DFD8A81DA0BD2C95229BA43D15986717CB8
A925638049C2A15A6913B9819B3642F68A07C4FDB2552C97D29211FAE2F16E40
076342D4C5A72E0D5185CE8EFB7A8D87D7F345E776512E8B41609794052B9A08
87EE0DECF203189379B9DEFB8DEC9585DEF2B44C7F64B4DEE827C74B975BD1F0
82D7E511A5A0FEBD52702F7E68157B509F303378B191BAFFB4229495AE65C558
D72D9AC8286E61633B29CF90917E4A01030D6B82CBF263751BCA8AB219284B04
80A8F4B34D0592EEAB82D64F9A5EB6A08A6CC5A7F3D3EE2B61710DB386AEA658
7A059E9633123EFEC39FADEA37C4205112063F7BD3D2F8319A30DA796E55BA23
00DE2B3C15511F87044ABDD9DDA9247B5E785A01A05B39F1A395E36AEA4D3D4E
ACACCB99E99DDB1AD1329069714FF050311B274E495FFE43D33DB3BE958098AC
61150EBC4F9DB7BFC8F6C81047DF0BABBBE67970D14524C82334B693724A0818
0007E4E848CE4AC8F07E72F02D74CC5C06DE0A67A63156F9567DEB913E874E56
B993FF1EF6774A9C582D8DABECD1EE1D1731457305A989E9BCCE8CCA4872B3C7
7635D840A0FC8FD9A40CB7B2FAAAFAE3274A2BD0CF7F681E877830103D2DD3DB
761F3D925AED45E0427BCCF205201BF0DFC16C0109A4389F37F25AC6E4E70C85
1BF6A47B91F62079EAD1D983BDD249D0EF82B21F89FE58CCF2612BA50EA48901
6757149BA3C3FE22E61F80F62CCB355082A71F1C85E8819E71E8997CAD75ABB6
070F0CEE40E3A9CDBCDE24D59F2DDEA887568EBE585EA8D40BB4D0677097E73C
1C76DE3BD95B2BD843B1522540C5CDBBE4E1E6FA4A77F93E724F4942757B50C4
40E316CA4DAD1D9D36823BDAA73E3BEC72B03F6DB2E99C89D2C3F840C15CBBAA
0EC7330D23A3EC2780813F0C1F56C891FC040B958C7861DCA654743DB8FFCE0C
EF4EDF238CD820A3EC97CA497B2C2504E43B9F29707D7F92114E8053CE90C494
4C3E681028257FAE5E2C60C3E1A33E40A7C5920A8E6FBCD4686135296590D866
1359BCA5B650EF33AB7582BC61158A573F93C4ACD4BE3D0E36EF1A7683B85438
1FFA47955F8C1EBB80BEBC9427F239EFB50BA42D8C72AC0F77A511AF3832F819
FC3576C4A28B6154B8B14B9B88A84B2E9DD9AECEC59A9CD717151FAA26CACA64
FF6B2A5F561F77E9DBD2285695F0B1DD8D1D174EC5ED48DA7324EE88698105B1
E28FB0EDB30067AAAB1AE5EF6527DD1A83DA04B50E5E2B7F2A63F0E8F924B2B3
734ED216DFF4E41E2C074741FEBDBB01A103B5A68961A12C571A0A35CEDB11E7
DB6C9046AA97B45F756EF5B32CD3E1446C9616BB8A7F57308679AD7E5368648C
37F5CB0CB4C95D49C8DF2D30A8C17D8870BE3C4D9A077BAC5EDF794050C793D8
D26A5DBAB2025FBE4841308D5FFCD592C37514D1EA9F7286EE8789D41BD9E38A
905038AD5FA8405AA7568F9B34F43DD17FD575EAB5067147CAD8E9C0A454B292
74635B10585CE8D8F891A07360DEED0DAFE9836B006C3ED2B6E10674CC17CD8C
9A862C5C51EFEFB1AA02F313DB95969B90714C62F32BBE3062E2D805989EDA55
0684402A5FFD3B330B194B1EE4490D05044859619A7A6A7AFEB4909B63CBE907
34CA9F2B19D27DC59F737344E1298EF87FD4210D08FF55E143319DDDF5E94582
1FD4C58EFB00CB9C840ACF598F300B9F6BBC4C83A89E7CBDE9F37C0EBC924777
9337FD42AE2B208FC6CA3E0D9FF9AA07BF7BB68ED07EE307267BE7547020AF1B
B3D65F802A95A69A2CC366B51AD5771EC679B23253F21CDF12E8584ABEA58D92
38F3B4710D434F5F967A9868BCAB5C4B57F5E1650356F9509050F03FAD247F06
607D717C4C183CE793BA995DCC37C836BC994465C1785517466DED4A2CCA2AB3
32F2D92C7DA918D720341298C650B4ECC780A457CF6CFB2120313BEE25A34AD9
3B2C2B587AA791104E38D27C117C3B4255791862E6750FEC3C32A5B965D72FB6
E333DBAA452661F88B7CFBF442A9CF467D01B1AEFE817317BE81CE3479E17E71
6C24D0A6C08978B3DB9EA09567FFD14118259E858E88648222DFEB2A655E0A0A
98F08F3D13539005E85DDFD0B1CA60E48C0DC80FE0AF9550344B07548E9B3039
E9ACAE903B7A3AB6FE24324319DD792FC5140A2A368D233140DA5690D5A8DE57
A42AB04F6E9D167CC3D0348FA7CB3EB537AEF89B99C7C93F398C9360A0B1E2CB
CC7E403B1E439CE040F958BAA50E36980FB3EA7F789FDA23F4292E566BCBB731
38BCA4A234E2A205D815FE2A450DB6586D56E8C1AC62A50DCA49CB76E122D050
E1A3413CE5BA8BF96F34990DCA2668FCA06BA66D9031AD98650EFF39D881929A
28D99CFCA94FDB163F970F29F3A2617F83F4894EB997EA7AFB67A6293A08E00F
37D5A50FC0C360BC4B7F9C876A6351F9D4B3279C1083D6DC79F5A63EA48CD5F7
02FB3C581F446AA9F19603AC165BAEE2EAA7B2574268947479540B5801FFB122
AEA27CE208AE86BFE14B8D139C16ADFD5D7ECED40EB0E258B38E509A8A1E07F6
EFEED540300ED1EF27AEA5A9B1B0FCF027F626B7258F4485B8A17399188CEDB4
8CCD037D55F8EE4BA5D2E876DF7083409DCD95F644F43778567B61F3A41894B5
485A87B1381E9E98C713E2BDE4594977B85C7A4F58D542C634F9F76B9403E23A
87D1091723B30E53CBB97A1406EBB78A7E06DA949505FA40F0D5CD0675EC4B6B
207B7210210E7145ED707377A9A1534FF7ABD8395083EC23928A03E3016F636D
1697B161377879568A752DDBE939BECABDE106790248103F1C6D75D474584F85
33DD684D3E4927EAE6DA1C2020EB78B226A43708351B8844E4A491E82D018AA5
AB46821A444373FF2CF81F996193D0C6AC98E2302BD0D7909BE77D97F1A6CC58
959CDBFE69014EA8F95224F2D2EC70DFCF8A38EDFA77581CABF0921B863A6544
24740A40AC91E315E97FAAB8D490AD44AE6805A9C7471AE945A40886A2DA1F03
7B94629ACBFD5C307ECACB6DE6FDD477F439CDBAC935A94679F037F1FD6DEDA4
F4EABA6C9837CD7679DCF343E823FE70D065D0379ED0EA0C51DF0700B7F97775
4EEDBD920782FF119223FAA23689358F35C8A68566DA0D9097C6D0FBF163EE2F
656EEE4291F0DF40C5F4910DBBF3A9A33A0B349A2FF1D01811857F9335FF04B6
EDDCEDA0172528348FED69047FFA80E2EEDB6A612082134CED2E167A061EB226
CAB50190F731B40DAB9650D4BC581BFEE93A2CEB9E9BBF5860760405127A1E3E
7FBEC40343D0D2E8EB80083B354C095C483A8405B7BC144FCC23E8F25E745A4E
8C527635AC995A1065A7FCFD805C6CA7CF611C06845EEE14D07B81E3B404E727
20CCC5BD3657D1575949FF993A71F5F8C5236135963F13D8C09B1F3B08CAB6B3
58460385AE220AE727B0CB9C05020EB678240921E0735D7A28E6C17CE22AE05E
6C9DE888DC5D3E24C60BB94289910B3723F60A74A8B48ADD5E03B6886044DE90
69236204BB7411A3D9119333D328F3A7BC446AE7C2C4C529D5E3D501EB99C900
D040D670DA581CF03FE6243093192F5E91A13B79BEF60D605A2EF3BB93B569A6
9C533A1AAE2CC70151A0BB5992A5B8269472E626D299F66D3DC25952AD9CC205
25572F56F774E156EB78B0406C4DE584660E1AC7E629DADC0BC41E725BACEE76
FE217A7B0190A4CB69E9F32F4F7A184BF53EED2B1659DAC33A2EE695A88D9F07
D076E3ABCEA448A576DB7B0C5549A5A2D63710141F4E539DECF167EFAD871552
7BC24AE52DF04152173D6E4CA827DEEDEFB7E9C3E72B5934C5DF97BC1EB23749
F776539AD43E9200A04341EC0594EAB62A0C7050DCA43945E58C4890350F3ECE
5BA67C3D716D5360A5C1FCB6EAE1EC00D59B46402B16B14B821EEAB4758701D4
4CECA59735D67B099AD9CC4BFF50B846CFE14E35E4D3D1F5A3ED2641ED940775
0067986ABE6AA117DA321122636AF7FA88AF53A473BDC12A4844F46F43D94ED9
CBB72CF2CCB37469C2E63661BCA5A298D5E9C6BD3D41853FB4867DF938DF0391
2F7ADC04FD1B0D6B0D5478581D4A2E51BDA015A4FAA53378696FB50A3297DD3D
20C365B963BBEAC22789E0073AA921F0640F63DE0833764999F02B66E800991A
438223368F1AD8FADC75E2C5130F76148FBB0ABCE3B1270C6F1CAB55259B5290
A10A1CD5419F9254ACE5834A4B8A71B8068EC21E6C4AFE9E790C74EDF7411289
3AEF976BB7A42A7CC1AABE4634CC1700272E6B272BC6CA5F1549F3172537FED6
C4047BBA4FE5776BEB53E8AA82BB17AB4796C1F91264A7B7E95EC14C0F74710F
9E9CFD51DB71C3CFA152D6BAD9E60B38D688C7CC5B587F37BC2301C2938DE2E7
88E1607E5B0CE6AFD63989315A9AE3BACA1E0C0E0F6CBAFF02685282033A7532
3E5B0AFB7AF6F4E3FB5801D175D02551F9746503A2E50AE9AA8AB56DE79BDE79
74B4550F3890818AE801957A3B6A822614EB8D12FCA584EA8C41B814D30856A5
97C3ABB9F665D1B72B8D19C4D2BEA46AE1332F8BD2A6FD2C2A1183E48F62C4DF
4175B4CD65A9B145D400D1CAD7E00D0D154182126764BFD3A267F85BC623A575
92FFC5A063A9205A02C89CA4B40C4D489F17D383FAF081A3C0B2C94E21BAED8B
1D06A4495F917C37F8B04070E9A90F60AFE3A8F0073086F00C5A707A96D4E1D2
BE5A637EC1C614997446262573426452FA5872FF661B519E24A34E3C58D4A07E
BBB6C294D4DED3EE01A853EF8E153D905B0598241F97301CA600C09B7D116901
77EA1F6C40CBF7CAD5991EAF92890305BC710270FBD575B626A59EBEBE2A9A21
D02700440C57557225CEAD5FC1EBA1763746A061A7F4DFF5558F6CF9160F7CD8
7C84BE7407ED508BEB2338DE3C5207A7804FF21C4E0FEED254C0DE812FC8DFF3
4B5B890B24BE5AC7C00DC1C193C88A6B33A442E184B4F5EFF79F4CACB8A56DC4
05098C620D63A0135F8FE2959A396398A421FC16F8AFF99F702C1B10F92ECFC2
2D86DB2489887879926E2AD34DB4F7A9CC460E12812C24FAB08ED0F2C3DF3FCF
AB41034C07225F20ADA5B5AD6AF5349319D3F937DD64B2E0A0887B880BE636CD
F814C498584F19BBB3FC146035E4EB4A3B7EB436E7713D968B24840EE00C019E
D08263764CF0839260BE71F875E5408AF4A8AB1603F7F694C2DB705F6E13E1C9
4CCB224D0E2B610FDC729EE8E33366D0AFB0A014C3AAC6B915C2268C27A65624
261E38226363108AB1C12BA960649782D0A02F87404350EB7F58C6C54463C1B1
334F936DDA18C96B577D4409F18E63A79F708A816096A6FA1071B1FBBA3DD470
C00F032534140440012988D81DBFFEDD0F6B02827CF76A92F638A685BB1686E5
D0624C445A765E6527B4D2FA2B8BBF035D9B0BEAA0CA35D937FA9B4A79224387
CD974CC0A052A5C78C4CA12379413303DBFD11DC6B78507875E6643D36679EC8
3CBB213B5116E5A262300890D85018D550C69365D717BD3AD5579C906F8BA35F
1C07EE6B17F394FDEEDFF5340A86E28FDA9ABD8803D832117A74BA868326A1D3
4004DE8942437EC0123075F2C6B97B306AA3C806FBCE7CAFC83C2CBC77E25C3A
082DFAD7D69D36ACE654CD17916062449BDA3C3AF3806416B16C718128326DDB
062CC9FFDE6FEC2D0451C4994F5C681A18D7E5310917B2994756AC8FD055F7D6
92FBD23FF685754DC09F36AD98201040626C381FBC63217DDDF511ADE6D13101
0043EFEBFB8C49652EF4FED438B5322D83C6B998BB46BD5B5F31BA2DADD76B78
ECB3D44A2AD40518C22914CF53AC408E8015F2E828F6F4908FE0C85DFE30B8AF
7A1E91B6AC7E25BE17F971DEE8271DF880E440EC95E45A6C909AB0DD6259AFAE
35B3AF9B04936FCE351DA6D244D34EF22D0B8156A583845423E93A3E5C827287
EEB8E89E19E4FA0D6406506B73285484A75082DF8E0219FB5543B57AAF63C47A
0C5616682F22DEE96A8CBC70BEB556DF3E719CE0E70FEAB87448B0FBF45EA6E0
2006416E39CAAC51A4568736D8F0270144CEAA8CFF832AD16907E09E49444BC2
80306B769125A50595838E76514A7FB0F1392AFE209D8817FDBCA2DBC8CBF8C8
5948F7E471B6B94D7FAFC382B02824888D3C5860D1AF18F729678899932A1AB6
A6A7A3FAC08BFFEC6FFA3CD9543D36AECD2AED91B0D8674EBD6A9728FE8BAB6B
4D3E8E175D0941775B3F96144DEA873B48F3F6B7B6A30D2FAB960AB555AA441E
69DA76ACF6894AEFF47BE6BCC094E42D735EC1B9D65474C31F0468FDD3CEAAF4
333F60053CFEEAABF43569FD1C216FFD77EDD13C344A0024CBDBFAB9CEDEC95C
115192A65A818C166A5C4441FBC0A1379D0F3FE58922EE49BB91857A03BCA8F4
0067F324EFA67755AC0943EA80D0EED33A817BCE9D5676F9963844F6A2DDA48E
C9B3D9B1E9F8CA3FF805CEE70807B028510D0AC5B13259280021D06260FAB24A
0143CFCEE0C3FDDD6D817C717DF925DF5022C37A19FF63F77D464F699F585E93
CF29D5AC1F2CD04E992E5E714C1EEA2FD56400E45A42813E4BBF87BF0849834C
F54A730E4B399FF3BB4E14D9CBAAACD79CF06AF35C128CEFCA1C43C8A5ADC1BC
3AB187E52F70A2562F7A705C58396C3B9198C78AFB0BCAD890956F7D463C70FC
0DD0AD6AF96D778AEE93A3A79A514A16C0324421D5DD3F7BD1002252E0F24DDA
3EDB1856E47B979C235BCFE8D6B2FF68864FBAF0CCBC3BCA811760643E0B2E73
551BA0BCDC4037F497911B8A5CCEA5AC79B2C8229F317B690108ED2C52E7429C
01DFA8C97FD5FF794EA69BCE240C02A9640CB5194CA6AE598C605AA92086AC82
C983661FE88DB62A3B732F78F43B93E9C22A09B29FCD79E41053D4E27CE6F3EA
FF365338B03B87AA0D48063D02B8E4C88075FB2354A05EC177E3FC76FE4E4DB7
7337F0AA30608A6775C928A39A515C20A285D0C4541A2A6F06E6844A6CA428B1
68D522A3EA084A2EFD17E3FE423F2F55C9F19E842D2E30CB79026C2D2DA9CAEB
8C4DE6394771D9C2D071F1B17047FC66A2ADA0FDEFECD6FAD63EA5F2196CCBEA
A4DB2C62A0948DD2A8A0D30E7F6808FCB912704E647E1FCB8E54D27039F67009
4E995339D198156D3F6522EC70AEB3F22ABD6699C36386B98E0992A57FD9BED5
D9EBCD492CE373E46A35A906C17AD2C4C490A9F74039075C8AFD8EB52C9631F4
0CAFAAF50E8C6B4C565D859F6DEB844846D560318367C21967D6100DBE5D3A1B
DD12DF6B8A3633BBD59EE865445D2F1E8814D8D64C3BC913183B59DF20361B66
6F3DC614B9AC2C2CA4C30E1A01C1C2A2054FB4BE7D58C6BFFEFAA4E13087C434
ADC6D8F1185F68B2003E7EA12A991128037E54D2A88EEA2E794D89BF531E107C
54278EE82F49454FC13638CD0B83C142BA3E0F5462CF92FDF0FA223EBF69D12F
3D99BA804FC467F40945B1B0AC23DF88BE1BDE21E296A82870F6322630C06823
27629EA02637E6E3E10F16747B3EB3E479AB8A347FD46D581608D453684278A4
AA58BC490F673269CBE7356CA4F9E523CDC3F5D98EA1B95CB686BCD17366B609
72BB6B2167EAA0D66E36EF6A1170EA56A8485A659E55C8D50108F6455F1C4227
6CB5DED36763E54089C6C04BE71D5B762254EA4374C136F98900F25B239652FA
71A14A43F046EC8171C490A5755F90DE4ED09F8AE5EA1A6A98EC026B612BCC35
6879F1942C6B45DF7A50F4E49B8C8013164CA04DAC46F1D799071BA6402EDCD8
F55BC6B064A2264A37D4BFE59754703B2C13BC4C2586A61EE4A9F9915F00FC13
05072451125EB001CE97BE3933239DF6501A664B45FFB5E63467CDA463A5AA14
504AFA4C8D4A976B459D8B41046615E06DD43760FFB72488397A34C4648C8B4F
C56454126529C50AB1D3B328136D31F79EFA1EA011C8C6FD6AC27FF2D4218B34
3F99304558FE4B1C81BBF4807AA89ACF653EB74E9A2C85D8DEAE86F1A7B3B5F4
077D09031A32E48C069539410F68EEE2A7ACE7B200CA099BE59009268219DB52
27A2D68DE15C91ADBB30775AD1701708749754BC4F0BADF52540EFEBCEEA9FC0
E00ED70078142201E897E93EEB6B8C033B2B21617162BB54060D3A14BA41D481
9B2BCBFA81A176BF324C8425310DE6C313113A9DA8A950C6439996C957ECD22A
BEC6631437954D043A5F0F83508A7EB24EBE9058841DC13E42E5A817928965A1
0566C3B7A4593733E519AB17F3995C6702E3378822FA575A537E720BF26BD14E
D08755D999FA4AF6D0BBC2A54CBC279C8E75514733DF7F2C19B84F043A4C9A03
979FEF3A622C92ADC58FE94C3C6C6ED45472D1E48290173613F991036368E036
1F8A871A66BE125074CAC7887A69AD92D96F157BE10A6604CE0647E5D2F6E4B0
8E3CB6AD0E830C18B4C239094238357D1D371F643F50E81CAF234EC88E0CD6C7
BF0B0626895B812E489153B01F94C0D86769A239879CEDBCF2402894B6E79566
1AA9B48033407926F18C7399C641C3B0C898AC99AE6595E865726374CCE03954
92D48AD6A336888DC372676F0E1BB9821F638924976163976175D2A687324741
912DF146F8C7F6EA428814DF6F235728386BD3558CD588BB1699B43C1DD6B4E5
CC4E75E69FE0158E8666CD4E86BE2E79148680287615041E559DF70923831A27
63D40F0F873B3DCFCE27E0BA3F396EF61417E77DE37C0D11902FD961CF5174EE
8EB1DBC17A1B0FED2BB385C9475096D7EF37BE12B0D75F6C1883229F3A62A679
828645A2E71DC2818B037613531463FFB0F84EBC614F6A9C3BDD29807805E580
0200984E41C66B9C99A62EED7E91DF58C72EEA135B03B08292FF4532728086CB
5ADD2170758529CCFD0E652138B55D545DBFB5C1DD4FFEFFA87DB31F24DCECDC
203A0B9D242B8F0ABFA7484545FA7BC22CC5F30C28629086ABD681555FD8C060
00F4B5444B0C79EA2F1EBA2CBF0C45689B6D4B09A1292DE9F6E92A9C52A4F601
924EBAEDC0F478330826DC36A3E3AC35DE0B82145E378108A75D4DB79B78A713
4A54643465AB3D1127B69467DF7AAB30EA92ECF0B5C475FD5922EE8310F8913B
7B1AD24A93EE946C8E6DAF09C3697934E94DD0074D8DB4582D26F9807786CD8C
D8CF959020822AA23D57077A73126BC5716FCFBFC6271C9F1BBEE9730198EDDC
41BF84898B24CD5A42D6D060C281B1810B323C5AC6032870041F007EFF54BD07
63F24FED3250E1F67F98E4B73678A5BEFAB99103F09E59E5E80D4BC9A2977FE4
3AE53E66D4185F52A001E6CFE374CB6A934187664F782F63E3C3359C66017383
99693E9A5AF425BE05A681BF7073A3108C77C2A31A9ABFCB24384010E36CDAB1
86219786B68AB2A6A7065167EF57C5EB79D790824A459A137E7CAE466F1EFF55
8BA7CF2E9382C1BDBBEDB381E7BFF677DF252886AF2BF19B2E2D8C44E0C35957
A0491E4723DA85E67BC6182EA0803EDF4BAFE302BFD52D84BB888A70232F7D64
3CA598EF660B77E88A6A8A4A4D63AAEBB88E400D20581F2DB42ED3B2B184DF15
6DC8E586726B5074EE71F347494C84B2365830A932A4F05F3EF70FAD933EE655
12834498F3A58AC270D74CBAEF756CB8A499D3EA9B99C37DBD8D84970B188530
82AFCAE63D692E6A72777CB1BB9523C75F9EBD4DC7F6E5D6F39862BB1D7AE93E
5BBD3E135E919421C3DE94A2EF81914B6EC5224906F83EF47292301C59C3836C
3F359945C40C61D9FC0AEA5A88A9A93DE5CB8DD195725FE145E79B7DF33B1FAA
F14A457C39D12AA5881FE5607251BADC4CA3A1FD901BEB971C765D568803D1D9
832D5444A1D8332E125B7D865D5B28CD78C7043D8A86AB4DCFA769A183FB4B05
749DFD67A669B7DBF6A6283CA516B94704D74F64C3FBEEAC15CD1A2D939CCF23
3A7837791AA06E6167291EC2DB0C34846D7D158EF594C6499288ECB69EDFD50B
4AA7F1E37993781A3933174BDB9F8EA0D41BDF7896BECC4BD9E6FE17738AE1F5
FC0B9D80D6247E861AA03A36B3BC648FC8610203AB27DB18B48BD494A5798406
BD74B5D1631C2844DE39ABECFC6518C45A89E117D7C498348FAB6C512DE91210
1C07826D1D6131AFC8B138B595641D80C8753C45ABA3EA94D2B175F382508B1D
B85D1133FAB93F41187C9399ECA60142A1356B1E5CFD821108C347CEA7ADBF08
0B124290E9D736E2043039D49D7D297ECF51BB2D2A9BF589761AB8C1E7249722
BB558C01661AFF993684BEEBD24DA09D0184440581B53FF4BF3C0129422E8F94
F214FD0FE66F14DE284435437600C6B9CBB80CF7CBD3CECB34757BAC210DA30A
2DE252E3DE81792D101F032EFD210853B4D37CCAF643D71C4733C81202D5212E
4E75DE6E19A3F1905A22B668DEED9A8BCABC2365A1B2C6DA539FFC709B85038F
99A65DE1C6782F0C757D402F59F11968695061FD1EB1293BD54FC33E1C2CA4BB
AEA897043AA9FE619649D835D131E18DF17A9D1ED6163BBA1A9DD12B9BB42A74
F67DEBE8DAED8AEA55A7F022159138F97FF379566A42354358FD09DC88FA9EAA
5CF2ED8B4D13C1339C07D398E96D0287FFCECA5C5C32218BB43BFE08196D3D1E
23973D34833CD9BACE28436A5FFD4816542473B7CEAAE489D7FC0F5012BCE6F8
4D28102E67187E50603942FE7514770BB9157E67F1459F77B2D8FBAAE9A4C987
295D1DACC6AD96A0818C9E875FEB5354BC2A1D28E2A1F45C8628D8D5B0C58651
5083D10F070C42724CB17BD93D598ACE9762EB5060E2687FF9EFB1F58A95A5CA
1AF7B72010131F0618EF48E9BFD21C17B297812190CC427B569313B025C39843
57E25E37934EA128680771B49E7A3F1978B3A6238EA54D83CFB84EC2A296791E
3990AC7AA99A9A5EC4A560E59F27DE1680C81E5930C136A83E8E7B4ACE6AAAB5
57DFB10D605F501081A8808BBE3F6E297A90F5E09A3CDF26FC387399EF4D5C70
E7A3E9AD46B0305E86DA98263A7F44357D4E950A63D7BEEB9D2E3DF3D066A6B7
9E940CC10E8007B2CEA1C11521D2095EED15F3152F92B10E0B4E9AB74138F241
4303245DED32F590E1FA35275F2A0A26FC74F9A04F1CE9280B9A5F136644B77E
9F4A7CD818309F8FF436B07EECB4E6D4168501F32B348446AB6D693C81FBA667
80FCA9390E36759B14F7A406E66F7BFE7E91BCD495A53097E55EEAD39F8A89DC
FB4CFB345F075FA37C763528DCC7D80FAD8F674B107E60FA76597DE95BAEB3C9
A3BA95633F1A44F20A2679BAC5D867A8ADE1270B3A87CF973424372BAF552056
C9C37ED61E8A791D32997F15AA52A1F259FD02267DD7F43A218224DA371093A2
2945C99A06AE36A43107BEA63FE56A9A2FC0EFDB46DF08C2752AF493035A5595
EA90BD9847126368DF8E22FE380E50A893FB21914E78BAED3AE5F9F03F7027DC
D10B91264F4459B8D0136A8C4139C416C64E304128104B6EBB0F3978C69FBF5B
E090B5C295B98578A79FAD2AF4233821A08C375DF4C4429C93623C43907B99D4
527E67CE7A73786E4D2F817A612AAC7B4D9E3F4A79BF382F15008DE76A9A8DF3
47C60F100B09D971EC4690B1A04173A1CB66A2269BE80708FC29D82C552151CC
385F1F179889059D5D70D252C99D0F84D12FDC13FFDFADC11A731262BC8E2AAC
FD8FA176352F9D114322CAAC7278113C9B48C869D5EACE4215CD50A125EFAC99
88312CF4E12FC1DA63029140E8EB1BFE1D79A7A338BA2188B599A1C224A0FBA1
3CF40EFC11D7D3333FF371DED67318D2F6DC8B5F34A5728233AC9BB2EF214D67
B3F2D0FDAA10F2C932F7AAC4EF557E31909175A3F61B0804CA0C762C53F20A83
53A8A6FFC37E002EFC441614A8E540921635FE855CBF1338431AC8F66FB1E17E
6770C99ACCE479A366F00211F8915AEF2940F44E43FBDAB05FE2D64565BD2584
59F65129BD9695C4787C6CEF7FBA70E2E0FE4FB7051F65AA824782F9887E5F96
DF2527C15E39CD1D5BDDD48765BC0C528037F69F8C5F168810DFC2D974AA0E62
20104E3F291DB79BFE816FAAC5765BA298797EA491EF82AF07769675D60F4E4D
F088426BF9CF41B0DF5D840BEA5ACFB5382015DD26ABB0851AC610B12553BBD1
788032FDFAF98C64AF5E2FD0B08FDB9582CDBCCFDA38F256930349697AF7566D
F980076F5E072279EF92BE37DB65AC1D702B0E85C856482A8BA9B44CC43BF3EB
BB7504F1F2696B597A0FB8085E3F6E3BF178837363F750679CF2CCF7B01027F8
747E1DA4597C8F93CE8F07D304FA72C64972CF08CD8B8F3331285EB0ECEDF8B0
64B53AD633C6D90340797802DFB81D424DB73D68BADB7811765D83C2C57E3BAB
F543E327CB8B0356D4A84CA1BF0AAAD57FB9EA0E5C70090A04745C916A3EA2E9
2AEFBFC64AECCA2DDA387A3A8AE1D27C6B031A28E8FB3F871576BBBBF7217CB5
4ECD354B391D4661B278B1DAD9B3AA0F39883F31537E158075D73A5C4D37FAD0
4181846C724986DA122D84914611B7C50DC964E21B40ECBCDE2FBCCA5A30E11C
5AF792173E502843DB785CD34583FF25251C712087589EA26D73257EB7B9D484
72FCB8988317B1F886C5EB9791F4688F087DC8D2D0B82B5EC38CC026C45C406F
F0BDC2C47011AAAFC765C2E520BF3C90C85E0D4AD3D59E75585FA2AD70B3C527
2383D7582779217F435224718C04EC8467BA8C9319F99F3F033B148B24CA80C8
C2A35C0B3BB874DE6AA03D3DBED072A45DBC5C8A746F83ABB578F872D535EC21
D16BE93537193CD36DFCAA9BC9FA95033EECDB3853532452385A71D1E92D12A3
9AE044E7142F0911125B2C2C881678886AA4E924B5718172A3161C790E2E6F04
9A28709CB38269D8D460A8415E68F64D6BD3C9ED9D9744DB7AE04B9F19B8DB63
EF85CEF8DA88F8442E2AC150FDD3A15BCF9740CAE7FFA1DE92E2571CF2C0E0F6
90F13F5ECB3CB88FE13D4B8963B51ABFB9040A25ACC10B08166441D7275106C7
D5F58C5A80F4F5472181D985237B431B8DED88BFBE1215B6DB506B7838A26C4E
C129AADF9C36C4177C76930CF6008104E0B5E3A387A13CBBBB8109AEA38FC35B
E7DF40B4734AAF9A7CB819D94DFE944E994DD21EE7E9BC4014BA7F0A1FD7C098
6F7A699E77867DA25507D723B6CF9174782B58AB59D89BAE119F145D61F83687
2C2A1653B501E71415A0978D2FF39468686E2481CE4F06B981FC398F93555A87
E93A098C9FF28BDCBAF0637CD63BEE7FA448538FACC04B11C068A16E687BAF4B
5D722363F7E1EF39B8DDCE5C947DC2A69DF4A4FCF40C397FB446A37E74502E49
571846E8951AED1102A7B67B7038EA1C7ED210A077D83222E988C0E5D2B88BF2
C71DF6C9F4400104F2E8DEA364D3A45CA1C1E6651C3972E89E5CF31881322FFE
AED481E2602E19D31A735C14F3C7A8D585C46ABF0C5C64BDD64EDD35D0ACF67A
5C91C26E2D53C47EEE126FCCAC1F7E9A67A0A02DBAC2C3EDFC15F55DD73EE385
A7A32431AE18BD4F2C612FD5F5AF4380A259C0C38D22FEEE403A7B9CCC4EF62A
6CCFE803F270AA5FB5C4DF8419CCBF6AC611A721688ED51B82C1E5647F2B988E
2B84B5343C26D8495A23908A6EAB2D2376DB03F96D493A892B6548E0369988CA
A2ABCECD47663BFE45F4F3F910952056A5314843DBF4A8862ECF20B9C6427E86
E90CF8132B2A03E1A0109C2C1973B5830B9AADC952F41D92EC44FA3E79C77155
AD89D10EA1E3B30126889BA190C86ADD788045D0F933226A4AC2FF91A9406F6F
976F337400FF3921D372AD11C929109E7F2D7C2A494888CD85BD790C8119681D
83B11275991898106C693C0EDF1C19B8731A84A94470D2BF52F0123E5BB89E56
39D5CCA023BF0625DA16DE7DB7611108CEA00E3CD4B8C03F31787EE00A94B542
A88B4369139836FAFCFDA51CDD5ACCD351C567663F1140357C1414E3301174F9
0FAAF917EC9C19DDA2F41C671B3175F49DA30593FA6C93A067560053822D9A9D
0A440C3DE6C4422E0EB2F7E86082F7734BA83D02C30EDA9A22354D1DCBC8D186
6A43BF3DDC5209DD661A87CEDF97BA43262C6D418DAFFD943846120FC5E1A06A
5C7D847154E41CDBE66B0538189C130DC4094D7F1709F15460AA982DC438F380
766D6937A65D1E01B70FC903E2D906FC31448FEBDB937051BD538019D849F81D
9C28FD74ADCA7996C9F319EA011A00AD195FFB5149F1B0B550ACB239D6D161A9
E45FC9F9018F471885D62869831C55EBC118920B864BE49244DAE14794EACD02
A096A5D16B4800B0A1AF3EAD075EA2476743425FE2214BDE468A20749C6FA35C
9CAC2363798D17891339B28F8BB6D0BE628DB425FAE39D65D3C034D041BBF7CF
4EF74A6AB6F656144930C034E57F02C528E054F65828BDE71083109F43FAF0FF
E520EB4BF5D92932BDE44D54797E58DFAFCBF5C819474A7B9282D087F819AFA7
F13B47F2CDD0BDDA2D8ABE8D6A0886407EB8550B96844FEE859BB61C799975C7
056361974EBA586DB2D3DDC859CFA0FF493C5C8DA81B2673AE6C94CAEECE4B0B
498E9F060E9948D0CB5C47040265075BBF6B40382EC26C5822DF3632F1F24973
DE14BBECF72DD8535F05BF15276DBCD457432FDA386EA8131FE695CF61F11B37
1C917751B54637348823C481D4C2B0DD4C98671BF1EB42919C6E11554D86490B
8E2823073B9F1DB5B04EE262840352032E1B9E4B688FCFB1144E43BFE455AE25
F914AD37E6A694900C5CEA010A04631BA180B9D126989E46566101B868EF178B
6BDE396797925C90780A1840369DD3F7AFA7C6A2D46FFC8024B12C356D5FEEA7
9270B37CD936AF7AA2F041836B00D3DA2F190F4E8C97FB7E9903446F8847BE6D
32A1772991AB24ADD997BB3B97452F21A25591459AA9F15A0B5395DE1D23B038
07D3B35338E4BA1214570B83D730F9FE2F0C0695A331B8E391D1FD879FA2174D
3F83FCAE5E1441C51B7CC7AE625CE6F6EE29604FAFF1DD5C1FFA48599AA073E4
E54E56028BD64FDACB47C715566D193332542E7A45F27F87F9BD0E7CFEC8EDD0
C604549AA0831EE8CA7C68A8A4A6549B1E7C0BF2B6EEA70AFE13024C41557568
D11E69C2F8D7962F5FFB6367016D93125A92DA39E25F30D5E4B85F66D34B0528
DCD0D71BB767B7EC0A58272DBB90D0D0D0F661B783F724929CAAD9843E044752
C5D1F2F6DBA6CBC67410623EC23D7C7EF15B18484315CEA679FC1526B576F54E
D1DFDD0E8ED5F2B1449A05501D0110DB989F62F815A30E84BCB0042A0FA14855
77D07A326FA8F2B85E67E20935F9DF0068B107572BA80DCFFD90F922B79A85C9
821363FF5AD881CF7C0212B2E6238B49813FEDCE319FC0FE40A42797235DFCA2
0F1B939645B97D26A23CC5D1ED56CA253AA1E5C8E88E93C74F410835E3D5C2C9
731649584619ECCBF3A50F95DD7EF36A8C1B5F63222863F0D8223CB787B88027
54835558B8E4CD6FA1BD7E4024B6C7267C1266AE9E7D7CACD4448342BEDE1EA2
717FD60DE846878BA67710AF4508F33E2D8D1827B7AD0A8C94531079BF2550BB
87B73A3848857F32B5D7AF2CC07DF0590D6090B7D820D701E669ACA06BA8F194
02672D01ECD7E2BD4E29FE18176D8317BF9523D2900B7CCACE98E9B46DEDE394
0CB3B65538418147C93E77FADEB94B66FD048E47A0F1C3BC92A51633F83E68EE
D239C0F2F5EB9EC68A048EB809B5B9F2DFE41F815CD33623CC2F6AA0C06C9F53
ADF903E40B50945A7A288A016839EBA12CA78156F617ECF3BFC8AC106A0B1CD9
9E2474C0DE1B88B5B18117CC68187DF5EF78C5B1AAE36D39946EEE1D931E704A
9D0A315054F5362FDE90A0C04F159F93715B4082554A6FBBC03AC4C2BB6E3A33
8563FB20B664A350BE0CED555FF8DCF2AEF4FADEE74A09522BC31CF7E4FFA014
DCA45475437866FAD01AAC47DA6951197066B69E6E850D4076C0F8B3F04355B0
E26711458BA45DA22AB577B6D71C8697816ACCDCA0C59E1BD92FA8C730D09863
ACFA216600EEE43FC54E9BBBCB873C64D0C9FE41DDCC573AEDA8A699F780950E
A63B8EA80A78E89724BC77DE5F7ED67FA860EE16D7E847FCFC198CFACF6FD4F5
7A25146DD526769E6A4080E908C16F7CEB0EBEC4778A6A888414FD67BC2593FA
6D0111E37BE74CA96748A43A7345622CEDA9D1DD5482E8119DBA73E73A35FA0D
ADA16A14CDDB54D76DE1D407BB39C00AB23EA1CECAC9C4DBD64DB5AEC80AC9D7
FAB6A1A3C4CA84F630A8D3A143A3490818A7BF0C8F16F6220BBEC2B8CCD528A3
4A5F899039BB3E21B9554E3BD873E2C1DAE37F0700B43CD1939CE5D16773520E
7A915895E74BB21222996FB5623FC6F077F44AAB49FD6E8B6AE3C8A9A93DA0C3
445FCFA9EC73F98378C5B4EF3E67978B7FED5FED1EDA85BBD4D0108D3E059E63
28E11EC677315B68DD63C517853C1A65967BF1B859A9203DBC2F03C4AF6A20AA
E17C7103917CDB42303D88E4A1997B34201FCC208C941249624D039D069C2977
B28AB8D215B245CC115024E3FD2ACB74184C8548DCE81F4D65D4CE268E360C03
FB719F335050EFE6B13EAB0B9580437C6067F0251660588FB519409390F94326
97C1C7A485E28C199DFB746BFD1CECE61C6F66D20946A54D9F05CC7F14BC7BE5
9F0C229CD87F1A35D1AB547EBE307B0A5CB61F8E7661DFE503FF2EB3344EF7B1
FED24165DAC30B5B6F39D1D1FA414A19E7FFEFCDF93808EDD4493AFDCA0BE31D
03EC07BBF75FFF1654E5D3AA64DAA505454A499E398C2F53DCB93BF548451764
3E4D7004D97DEA315CB51588F654CDF6FEABADA788D6DCABAC86E3DC9BB7E42B
FBC1381C47277801E353B58400F9B9AA4DE2E1BF4E6433688C8569182F0F4568
6D5E7931C695A5CC181A815B3D3252AFE7F25EAFCD8B07FB7B127731A25D951F
51506723A896F8DA4027296D11DD4123FE93BCC81914409D2E6381F1F2840852
4214BDD7C2671B85AB24BF24F895E67A91DF23E21C5663797F049467329F3DB0
A74763B8C6458A5C9FF1157F9DD08C37351A6F074E1E5A05F9827AC15FFF4A68
93E1D010E02D82B63C1661BBF9113D415052C4C5070E6542E5E07223745355F7
3DD76EDECF1C5328A29473B07BDEB0D4223C5D3DAA6BF3E639C2FF860AADA0EF
05A9BBEAABD8389112937B0F282A0D6C50A7CFFB0D214523EB8618583DF0EFBB
D98086ABDF5EC23F57F1101E86AFFD2CE314B4240380C6FFBE4530E6576180C2
3A3695E4D70DAC730C2057578AA0CF3E8E464500C0F2C7ADFADCB41E1DB62D83
86DAD27D800C797B01D3A701C62A3A1D0E1C18D76CEE1AC9F581CC1C697A6E50
62053E7EB21754BA9D9763654CD7FC08B53A12408A4CD4B99F4061C41FD06922
ADCD8518DFA056B825A24965B576EF1DE31E3A4E2E54AEFBAFC8BDF5E833AE8C
929405416A91A45AF0977E396ACE32C969C87FC93DEA7888A35B7C9E8ECCC350
C9388F9953925A208E63514E9BCBDB99BD47D146DE4EEF08810C81DD6DC06EBB
DC1F0035A6DA0D99F32696E8B4A226435376E26C0ADC8846D28C8B875BD03663
73592B3FB5D5A0C927140F27B6CFC0FE2A8DBDC77CBEE70C0E2005EBBAFB8BD0
5B24447CEC27AD4225DB0DC1CBBBE69AE423F9622A4A8BBD9466962FB54B64AE
726060F18B3EC8D945009E8FB6C2ECA462758A78BE369F00AA4FB8534468F700
A9376FB42130ED96EF9DA17B7B9589474D1427D0D8FF5152F6306527B12D4329
3CF929105E04AF564DE552C4F06B466F16A8724945CDA9E098AB31A032CB2D05
BBC3CD225A51D818A9695D6E32DA429E702632B32FECC25722652F67165695E6
D9819D5B200EB3626FAE8FF7376DED2B1720CABD8AE2BC1A0A39B7BA427BCEFA
936F934DC88685CAAC7DE19929C9F99984CA938BE0044FB341AED41B19F97F41
2C31E2C4DB232FF90BC0D15F1991DB60E7E944D90F7FF591136E1F260D3764C8
8BA791589D455192A19ECEB8A9E80FB5506A479EE444322C4E8E8FF0DD9BCB8F
749C69C488E816625DF57EF673DB1A85BFB19D960461EA8E6718A1325D878D37
FC7BC693F15D8A85AAF4C42216490BEA3D1638BE006CA2EC9D4DDEBE3C641754
A78F6EB4B71D7517351A91A711CEE1FFC4FD57B0EF71E2959EAF82AB5494234D
FAAB49B1EC4DA7A2F3657458CC1CF6229901C2AF5339E2E36F92197762A8E446
5F8F9D24A57B80850DE4264FA9F23C947C35801C2B557CFF02B15637D5B9B059
9994ACD938E826E4DAAF9581A63EE82995E793ADE573CB2B9628BD7B899A1C1F
D437749137278A36B921206B70495E0DF379B7B7315FC02058EAC7F9128A3B4A
30E20BCFEEE17A99CFC9795F193E4356AEF6DB94A7CAC8880FAC9227A0BF78D8
B7BC18F6DAC8E5CBA63996CFD5E4F78461AFECE7EF62C585B5E5DD40789AEAD2
597E24874B3BA77799D67DF746E70FC9DA4CCD9BF40F9897092352B3A12682E9
4A5A92795C8B52E212FBE7323349E867ED8FE78B8B42325C6AD4BEC036BC891F
0AFDCBDA2A75DB64EDD020A39A4AF0387B68D64BFED1C5FC11C58919C6FA0C96
F617CA7860D5C10188376F31F1E323A95AB36138D4C8AEABFFF46CB6A3618ED2
88C3BEC6184BDC2522388424FCAC44EC1DCF68E6B0A19B01A223BD7193EED9C3
F5B838BE944E6C4CFEE7742EEFCCCF9F60EF632849E3306B990B2CA74B8F6AF3
465A0BF22E1E59798302338B06682323B19C4E44FEFE84C0A210031F132E015E
E74264B3B0DA6E09E116572E707C45FE7010C8D291BE49657248E416B4F244F6
E557295AC3633C4B84B5638EDA1B2767D0FD770654C2667EBE9494B1DC28825E
C12B1244900CF0F45EDD038BD90A98497250F897F1221A1733DBD4540D1B374F
827C8C10FA84F5A1F6A4C921426BCD3EAFB1B8C654131F15B4BA3E8D489F00EA
9BCECF58E9D15BFC1B16E4A08F0D5459D26559144278DD721DAC117E4C0F6EE3
19930DF91DEDD9664287F11ADAD823DBAB597729C554DA905BC72A6686481108
7FA7B78D41FFEDE9830955C6309749DE1ABD705BD346019D4ABC4C340C9A2A9D
CA7D20D6CEB59E8B7836043C49D33C86469D27CA62851DBB00E6B8F4E28714C4
B5F277CC2CFF502F0E47352F296EE242318D73197E754E4620A9B7DBD075C93E
5225C68C47BAC50FCB58A6D33E1B55A39D131DBDD4E014C126DD320293BA9748
4712E66FBBA2BA24BC8F4B1A285AA123F7B8146F4684CD922EBD333A7B493CE4
F9C7BDE8FEC45429EC26DF8569130F0898C3D43F7CA90C210B103117911B27C1
A14E0068595867748609ED646B5E08485E7467C36A528C738C1B7CFA362CA720
C088CB808926A1D895DDFA944468AB702AA7F91D8A4BFA372E6D7640A8E24273
75C1C8466DA13AC7BC57CC6ADAEC27CDCCB29BFA5473CED983B9E2EC94132E18
6D77798D59EDAA1BA98A0618A1066374D655D55066BCF81FAB2E4511E1928ED7
C77FB148D57D8EA24EE0720AB527AA3A76285B696FD2FF3546901E849A5B3802
F21F7205C80F9A4A102DFE192C5C5A5403C6A8AE106C10746A550F7CDFC992DB
E3A64BE4A2726AF22D403EAD6AC921F48D6535E9E850BEC1E5B0AC79AF04502A
1FBD5043391104C6DD0B09CAA3654A7A21A52D6164FA2E7A4FDBE9CB328C3A53
05406F4A2F45A1FD4B2CF998E94B7DAF2E3CB584A8AD83CB32844979EA560E0F
6EB5215F705141320F1BAF1504E210D3690FBC58830BACA500624F7A7ED3EEA2
789738814E197DAAF6DA815029368B28818561F044171ADDCB73B6DE459C3E9B
64196B66F8A12A1BE100124EF86CAB8B7A10822DF4951766AF568D826E0B91E5
E640EB8D3D8B188912C510D456231E46972B177019A807DA6AE89E76400E82B4
EF3EC27BCD8F879A5A7A04BB4D5E290514EF7ED3A976A5B2D5B4F9359B283DE1
1D7BFB356B3F3F02BB45FA93F0B442330A9AA29F8680260D1071BC27829EA312
0ED69BFF2730E0F550F35CF2CF16AEC7D8CFDECE336F95789FA1C76B4C6BECB4
D6400166ECB6FA2A44C587F15DD55F55A1F7FFD8F07CA99EDD2052218828B191
D52CFD56538ECE62E946AF57C39CDAED30DE6FE58491181ED84E700092A061BC
821B6A5C32A0F436DA74826E0790EBC7D55F14223DDA0234680D41A5BAC55EBD
8D657911A3C10F9537AC9D3388EBBD5856F043A544AF4E60CA7243DA6D38BB28
4646E77BF92BFA763150C7E4543E844B01097CEA61AF0CA802CD8055BEDD63C0
6D91EE700452A400496DCAB0632DBC58C5285E8722F9BEB4860842B48B1D9FAE
B266B6381548CA943B5EEF047A6805D99AF761A42AA6850CC458E1C147E3ACC4
E41653EE36F6BF8C938DF808E8DF9220690A1E36BF5C7924DE8944C261955F25
A7976C3FF10C79A10D8EACBEE51C00E961588131E35B08BD2B07962EF33769D8
8A7FA9BA8EA90C38B846963030FB463511992396C25B4F83D6E6842BB7408064
B979DF1E0A1C20719C8F9430C1F46B36DAD548471A37B4328DDA480F3274900C
E33879F1C6AE71A76437DA0F6712297CE10B14552768C06315EB48500514BC14
AD86EF94E5AE2390B6D9ABC097BF1A9CB666988EC3797A3464930867433F7F95
D26D8DED9791F0C49EE8AEB9017CCBA02B4B68D639B58C864EAD6067B3D1FD22
E989551D11DB9BF2A8D833391D25109F007D9E3F7ECDE5F21C64AAE0B0D4C4CC
C511D9E7251286551308E976F1C69422457B9F6544A768188EC36C7964D158C5
09ED5CF20C62955EEBFB0C4A851943CB1BEDEFC216A5F11051C9074C8971A13C
59EF979D9C6C90E545E7569F16A202E0488548C6AAD14AA2D3F5C15E5807F39A
00752DDE0B2537CEF6F67A921342CD30B85CD65841BA2B92156F2ABA110F9193
1D8F5C3E7BC15D1F2A1B45FC37DA6EB07B9D77EC0C8F507F49599A3CFFA76C0F
4EE4037576BE710FD8D22424899D80D389FF23B8760FFDCB88B5BBB17345D278
42286B59AFC25036261678551AF7CB98432D66CB6C49E3ABE73B47B0568839B0
9820B34D98B0B2312CE07F438A94F7DC4C5D50066AF6FC3399BB9D58AF4E4F7B
8271B178FB44B6C9A286FF4925C920DBC35D5AF5E24B60C5637C4D1343312EE2
FA5625B6AD5ED764EA7D670761365EFDB46FB8153E23072885C3225ED394EFAE
6B319D543ABA7005821D8B857D06235F83FED9697FDB48074BE3E797D96811F0
10BC6392B1B9D4A896B3993C0A77E94B57CBBE264C12463687BCEAE30C575B1E
16DE09B2D92E58155BC5AF9339C62F48DC0C66831B7F519B236A7F1AD6E2EF6C
7216A0304F415B8C95E46AC28A0C2EED00A5E22B193338BA67F78735D8C26F7A
994D25DD5FBD72BD3B1DCA1E2B0F7151439313824FA3811C01FEDE345439CC7D
604ED31A684426939CB3F2B9DB05D509A7B0EAAB0583662991FC3ADB4C50A515
3B881A40DB960A9D6226C4B8BE7DE1CE38363BBF3537A68E269787913EF43FE0
AEFBCFA0C199AD0337F48564CCA04DBB0442A4C8BC13B0072BE782817F59C8D7
4A052705029F8986F888C498825819171C12E4CD2A33BEF7FAFC3447FB5CE42B
B3BC34F3F2B61E0E43048E32522CE84FBFD8B7E36F9C83320D5C8692AED52588
A2359603E13A2F2E43B310D433B83713F94D77557C9C8EFBA9B5E5419B75BE5C
25E87490EFF8A2C54734079826AC3CC2B77B982F3D11141FEA98B417603EFE94
240F453DD6E62737EFCD0A104ED9009B009C4A62A2188A7FAAA0778F36E3CC25
D3E6D192B338E69B6C6A63ECB42EB981B08D2B65646EBF09DBCE03940135D76A
E22D04BA3C8293534A9BEC2969B54A12B346AD976FACA36C07376C9A8F2A198E
BF0BE85F63EE43845F761274E0D9CB7531C451516EF085BDF6A02833E38B8B87
D141D8C9F39F6F032880A6E39022707C2D318613A800E1F5A312B300115EF120
744D58CFF4C7BD46757945D541C1349225F2C0BB4ED39A2457B7D8E3DBE1C5D1
D150794D5EB2081B8F4C13F73ED220A7FCF5E2DAB5CD77926FB66CE3063A21DB
1B76BDC2C8B2AA374B9F362404AA707E3E4751848540E83B712DEA3423FE49B6
0AE4D96AAFCB9D6198918EF460E585BBC2A37B3318643CECF4D3F865E14692D9
74267716BA6CC117B13CF185717F6FA0C8602041CE79E696CCA1FECA4AA4CD31
A06916B369B7FAEA1F66AE081DF3D44236F012C557C8076772576CB116783153
C2DEAB8CD542F0B08C75E00AC57C816B372E20C2660374BF09AC498FB3AC9A3E
1BE52953FA41686599DC7213845478725D54DA531A0375CEC8BA1827C27DBAFD
6555A364CD1AEDA1A5DB57
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 77 /M put
dup 86 /V put
dup 97 /a put
dup 101 /e put
dup 105 /i put
dup 110 /n put
dup 111 /o put
dup 114 /r put
dup 115 /s put
dup 121 /y 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
CB208A9B3B26699B201DD3662676B77C66EAFD20FAEB3021619FC123433D1CAE
53B0EDF00827F374A95DA1E89A01226DB951EC0F09366357A5A86C4DA2AD2A5A
0CCCB8304C4CDB9CDBA1068E98B2CCD4671E960ED12921F7B41100ABD48768C1
BD5863591593D6ED9E604857B67D08C0CBE36A2E3D2EF5A9451345693A2F2FC1
617F954916295D06A6A0805CA62EF2DAB67BC449674B238CCFAB92D628617FDB
9B3BA7FEE1FF29E7BB9CD5FEAB8F27E592B511CCFF9FDF4271CEF44F73CAA97A
30DDA0FE944A6C4B23D82797C4D2B53BE303031FC99A32D20F03D840E42BD088
143E95C4E0CDA56BF86846A476E84C1ACC34A64C3A1EBC0A2B53380DEAB37DAB
692D21B1C485FD1D08080F8F3909C512F013BC14572FF66CF1ED026E2E81B3D9
091D0C7196E99F937B4C2FB4719E8ACE48810BFAC898677969B176250A019DA8
27BE209FCC3A0CD35219C47CC18E771C0A8E49B03CF3DD19F4118287DBC7C4A2
2B23D2250E0C97C4C6EF38AF4960BB4E8963DBC38A11ACE3B46E1A3A36799FAE
3D53A874A1323CFBFF769064B7698CD5289E648D1B3968A48452362C9806DEA7
D51B4C18267A88BE072D1C05B697417503C36206260DAFC1E4B989FDEA80FE19
196EBF09046E43DD0138B1DFF846C34C7F14A126675BE530B671D23F3D5B4EF9
9DE0484411942D59073707193132040B3786C02AF197A9520EF649BC55EAAFE1
3F974A85D1FCA84BFE5B214F555C7F5F939977945559616160776D4369DBEE13
0486617F2E364E8846175E02FE51D16728C08342DC1D8BC09C69A769E7165954
A609FFD0174EA5236FE01BA8EF1BA4F43020C81683F9D83C7460A6B73650D81F
840A5085455A0CBBD4C148F065433693096FA50A32823F9E9CFE73921FE7A89B
4465255C2DE2722F176A410C0ABEC6619B7E5E2877B5F71DD65E1D83FD3AEBF1
174CDEF7792366D9D8F965D7B894514552C8689AD98C3D47A5BDF0B62BE36A5E
EC4FED48090B02FADADE831409D8A12BF26C59DCED4FAB2D855B0AADE1E1E92D
7C12F644051C522C64DDC7D78663241BCD0077D29498143804A43C8D239B8240
D27B1DC8264A08A7FD490BDB994C5F76175297570508141E3CA66C464E803F35
3E203A80B56E0EF34C6CF7DF41E926F0B1C65C963E2EEFF7223D0F23C6637662
8AD35E5E3DC3916E386945DE7F9459DEB136996E1DCD2C52EACD7EA23FEBD7FB
B2EE5067521FB56F7AB6A3DD411866A469FE6BAED525316A9E397096CCD9AD60
227ED9887B9E199242512AE8A30ADB1647CA80A3DAF4F37367EE3A2D6E10B10F
20B04AADE3FB78AC92BDEFED7C7FEC071596FF33D00B9DF125BFD3E1A23F3E28
06B1FB28E40FD8B9F7F56326F61D6F0ACC6B5BB5075FE00BF27D077531C87910
7AC03290749574181B95B7968C79076CB25308FEC5F1D2E2D5EEE5EA026F841A
E1D347FA7149FAB5C64EF67A2A17C885D51C665DE67793C9E0E025A9AEC6C958
EFBDD6E9C13CDF596CC58E28E284F6FE9700505C5B0F5D85501EB8C8668AF610
5FF15864D7DA8F3A06CBEA58045321141099EF4FB952F9EF8848AF3A722646A8
74336EF9927DC3451C787C2760E768DF4AD19EF9FCC27057C4602193DA5CBAF6
404BE06ED2FF9DE5FDE00A9F2488A4FC0CAB5CE4A5C7767BAC50F2C84ADB20A6
D0DB2AC57A490F7D0290664FC560202C2DBB5911BE6018945FC455FCA992F301
C93F454A189878A215CEB421930E0CA6BC0C48CD297980CBAF9283B8D973078C
D40886E0C31CB1F44C36BFAC44CEA466011B72BC301552153893ABB2D2CB11B8
AA14FB14B20E897D2A04D4B0643558B9247B8C9304286C4C26E8375258639E55
8B004CD7B7CCE046DC730087543B0237A363C7A6B9A6D3CAB81310E2557CC57A
D43F163D5D81ADB9EB797C88E685E0E11C88400E3B0106DB9B8637B361A4FE44
B911AAE93675C201493B5F2B24FA53A5D40E2CB99727AEE3740A620531C377CC
C9BF247FA8551E1B7AB95BA669C7EB321FE9950998496ECD49EB4131E352D217
826587C051273B13878588F410EBB4C02820B8ECBA8FB7C860998B57FABE9C1F
816B32CE914F150EBCDF989A257F79F76F3603C9F891C2349909C87BF56EC7E7
E7017616EDCEBE98B60C0F678D3B0F1DC838FF0A543E6A094F82A15EAA55987C
2A261E4CA71933EC92CBBCBB0E3F560659B6C3E402EBAF480B509892EC9242B6
BFB23B9F70902A2AB6CCFED2E8FCA63DBC53244116C7612A94F198F36BA097C2
7B63D740677C4B229AEF0256E6860F15FB800E60B522F9E70B0455D9C1871F22
BDB77851B3885608E4FB1A8F830159DA098DE17C0EC61E54822DC61E21CD6C3B
288884430EE3017B35E742553AD08A264B38A42F3EFA5A709AB46563FF56CBF8
73909325C6AF397E9524997CFBFA89376D9997D8EA7009A7D4433A73FFC98D13
DBEDB05B41908A6D74CE3E28F5ECA3D8
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000
cleartomark
%%EndFont 
TeXDict begin 40258431 52099146 1000 600 600 (fitsio.dvi)
@start /Fa 193[71 62[{}1 90.9091 /CMMI10 rf /Fb 133[50
59 59 81 59 62 44 44 46 1[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 84 88 106
67 88 1[42 88 88 70 74 86 81 80 85 6[31 1[56 56 56 56
56 56 56 56 1[56 31 37 32[62 12[{}58 99.6264 /CMBX12
rf /Fc 149[25 2[45 45 86[45 15[{}4 90.9091 /CMSY10 rf
/Fd 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 6[37 67 67 67 67 67 67 67 67 67 67 67 37 45 3[52
52 27[75 78 11[{}63 119.552 /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 139[75 1[79 1[108
7[108 2[88 3[94 29[140 9[97 97 97 97 97 97 97 97 97 97
48[{}17 172.188 /CMBX12 rf /Fg 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 6[25 45 45 45 45 45 45 45 45 45 45 45 25 30 45[{}38
90.9091 /CMSL10 rf /Fh 134[55 55 1[55 58 41 41 43 1[58
52 58 87 29 2[29 58 52 32 48 58 46 58 51 11[80 73 58
78 1[71 79 82 4[40 1[82 66 69 80 76 74 79 7[52 52 52
52 52 52 52 52 52 52 52 1[35 32[58 12[{}49 90.9091 /CMBX10
rf /Fi 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 43 71 25 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[{}93 90.9091 /CMR10 rf
/Fj 134[62 5[46 46 2[59 65 4[33 3[52 3[59 10[88 8[107
25[59 59 59 59 1[33 46[{}15 119.552 /CMR12 rf /Fk 138[90
63 64 66 2[81 90 134 45 2[45 1[81 49 74 1[72 90 78 12[112
90 2[110 6[60 2[101 4[122 65[{}21 143.462 /CMBX12 rf
/Fl 134[123 123 1[123 129 90 92 95 1[129 116 129 194
65 2[65 129 116 71 106 129 103 129 113 11[179 162 129
173 1[159 175 182 4[87 1[183 146 153 178 168 165 175
17[116 1[77 5[65 26[129 12[{}40 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 861 1940 a Fl(FITSIO)76 b(User's)g(Guide)356
2399 y Fk(A)54 b(Subroutine)d(In)l(terface)i(to)g(FITS)h(F)-13
b(ormat)54 b(Files)1055 2659 y(for)g(F)-13 b(ortran)53
b(Programmers)1667 3155 y Fj(V)-10 b(ersion)38 b(3.0)1727
4058 y Fi(HEASAR)m(C)1764 4170 y(Co)s(de)30 b(662)1363
4283 y(Go)s(ddard)f(Space)i(Fligh)m(t)h(Cen)m(ter)1522
4396 y(Green)m(b)s(elt,)f(MD)h(20771)1857 4509 y(USA)1701
5298 y Fj(Ma)m(y)39 b(2011)p eop end
%%Page: 2 2
TeXDict begin 2 1 bop 0 299 a Fi(ii)p eop end
%%Page: 3 3
TeXDict begin 3 2 bop 0 1267 a Fl(Con)-6 b(ten)g(ts)0
1858 y Fh(1)84 b(In)m(tro)s(duction)3136 b(1)0 2118 y(2)119
b(Creating)34 b(FITSIO/CFITSIO)2405 b(3)136 2280 y Fi(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(3)136 2442
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(6)136 2604 y(2.3)94 b(Linking)31 b(Programs)f(with)g(FITSIO)40
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(.)131
b(8)136 2766 y(2.4)94 b(Getting)32 b(Started)f(with)f(FITSIO)55
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(.)131
b(8)136 2928 y(2.5)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(.)131 b(8)136 3090 y(2.6)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(.)85 b(10)136 3252 y(2.7)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(.)85 b(10)0
3511 y Fh(3)119 b(A)35 b(FITS)f(Primer)2918 b(13)0 3771
y(4)84 b(FITSIO)34 b(Con)m(v)m(en)m(tions)h(and)g(Guidelines)1993
b(15)136 3933 y Fi(4.1)94 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(15)136 4095 y(4.2)94 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(16)136
4257 y(4.3)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(16)136 4419
y(4.4)94 b(Subroutine)29 b(Names)79 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(16)136
4581 y(4.5)94 b(Subroutine)29 b(F)-8 b(amilies)33 b(and)c(Datat)m(yp)s
(es)44 b(.)i(.)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(17)136
4742 y(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(17)136 4904 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(18)136 5066 y(4.8)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(18)136 5228 y(4.9)94 b(V)-8 b(ariable-Length)33
b(Arra)m(y)d(F)-8 b(acilit)m(y)34 b(in)c(Binary)g(T)-8
b(ables)26 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(19)136 5390 y(4.10)49
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(20)136
5552 y(4.11)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(21)136 5714 y(4.12)49
b(Lo)s(cal)32 b(FITS)d(Con)m(v)m(en)m(tions)j(supp)s(orted)c(b)m(y)j
(FITSIO)72 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(21)1912 5942 y(iii)p
eop end
%%Page: 4 4
TeXDict begin 4 3 bop 0 299 a Fi(iv)3311 b Fg(CONTENTS)345
555 y Fi(4.12.1)61 b(Supp)s(ort)29 b(for)h(Long)g(String)g(Keyw)m(ord)g
(V)-8 b(alues.)62 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(21)345 716 y(4.12.2)61
b(Arra)m(ys)31 b(of)f(Fixed-Length)h(Strings)f(in)g(Binary)h(T)-8
b(ables)70 b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g
(.)f(.)85 b(22)345 876 y(4.12.3)61 b(Keyw)m(ord)30 b(Units)h(Strings)i
(.)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(23)345 1037 y(4.12.4)61 b(HIERAR)m(CH)31 b(Con)m(v)m(en)m(tion)h(for)
e(Extended)g(Keyw)m(ord)g(Names)83 b(.)45 b(.)h(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)f(.)85 b(23)136 1197 y(4.13)49 b(Optimizing)31
b(Co)s(de)f(for)g(Maxim)m(um)h(Pro)s(cessing)g(Sp)s(eed)44
b(.)i(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h
(.)g(.)f(.)85 b(24)345 1358 y(4.13.1)61 b(Bac)m(kground)31
b(Information:)41 b(Ho)m(w)31 b(CFITSIO)e(Manages)j(Data)g(I/O)91
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(25)345 1518
y(4.13.2)61 b(Optimization)32 b(Strategies)69 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(25)0
1771 y Fh(5)119 b(Basic)36 b(In)m(terface)e(Routines)2504
b(29)136 1931 y Fi(5.1)94 b(FITSIO)30 b(Error)f(Status)h(Routines)84
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(29)136 2092 y(5.2)94 b(File)32 b(I/O)e(Routines)e(.)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(.)85 b(30)136 2252 y(5.3)94 b(Keyw)m(ord)31 b(I/O)f(Routines)36
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(32)136 2412 y(5.4)94 b(Data)32 b(I/O)f(Routines)53
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(33)0 2665 y Fh(6)119 b(Adv)-6 b(anced)36
b(In)m(terface)e(Subroutines)2159 b(35)136 2826 y Fi(6.1)94
b(FITS)30 b(File)i(Op)s(en)d(and)g(Close)i(Subroutines:)76
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(35)136 2986 y(6.2)94
b(HDU-Lev)m(el)33 b(Op)s(erations)108 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(.)85 b(38)136 3146
y(6.3)94 b(De\014ne)31 b(or)f(Rede\014ne)g(the)h(structure)f(of)g(the)h
(CHDU)99 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f
(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(41)136 3307 y(6.4)94
b(FITS)30 b(Header)h(I/O)f(Subroutines)i(.)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(43)345 3467 y(6.4.1)106
b(Header)31 b(Space)g(and)f(P)m(osition)h(Routines)60
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)f(.)85 b(43)345 3628 y(6.4.2)106
b(Read)31 b(or)f(W)-8 b(rite)32 b(Standard)d(Header)i(Routines)67
b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)
h(.)g(.)f(.)85 b(43)345 3788 y(6.4.3)106 b(W)-8 b(rite)32
b(Keyw)m(ord)e(Subroutines)116 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(45)345 3949 y(6.4.4)106 b(Insert)30 b(Keyw)m(ord)g(Subroutines)108
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(47)345 4109
y(6.4.5)106 b(Read)31 b(Keyw)m(ord)f(Subroutines)64 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(47)345 4270
y(6.4.6)106 b(Mo)s(dify)30 b(Keyw)m(ord)h(Subroutines)55
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(49)345 4430
y(6.4.7)106 b(Up)s(date)31 b(Keyw)m(ord)f(Subroutines)116
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(50)345 4591
y(6.4.8)106 b(Delete)33 b(Keyw)m(ord)d(Subroutines)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(50)136 4751
y(6.5)94 b(Data)32 b(Scaling)g(and)d(Unde\014ned)g(Pixel)i(P)m
(arameters)113 b(.)46 b(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g
(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(51)136 4912 y(6.6)94
b(FITS)30 b(Primary)g(Arra)m(y)h(or)f(IMA)m(GE)h(Extension)g(I/O)f
(Subroutines)117 b(.)46 b(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f
(.)85 b(52)136 5072 y(6.7)94 b(FITS)30 b(ASCI)s(I)f(and)h(Binary)g(T)-8
b(able)31 b(Data)h(I/O)e(Subroutines)d(.)46 b(.)g(.)g(.)f(.)h(.)g(.)f
(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)f(.)85 b(55)345
5232 y(6.7.1)106 b(Column)30 b(Information)g(Subroutines)121
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(55)345 5393 y(6.7.2)106
b(Lo)m(w-Lev)m(el)33 b(T)-8 b(able)31 b(Access)g(Subroutines)60
b(.)46 b(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)h(.)g(.)f(.)h(.)g(.)g(.)f(.)
h(.)g(.)f(.)h(.)g(.)f(.)85 b(58)345 5553 y(6.7.3)106
b(Edit)31 b(Ro)m(ws)f(or)h(Columns)106 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(58)345 5714 y(6.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(60)p eop end
%%Page: 5 5
TeXDict begin 5 4 bop 0 299 a Fg(CONTENTS)3334 b Fi(v)136
555 y(6.8)94 b(Ro)m(w)31 b(Selection)h(and)e(Calculator)i(Routines)95
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(64)136 717 y(6.9)94
b(Celestial)33 b(Co)s(ordinate)d(System)g(Subroutines)98
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(65)136 879 y(6.10)49
b(File)32 b(Chec)m(ksum)e(Subroutines)75 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(.)85 b(67)136 1041 y(6.11)80
b(Date)32 b(and)d(Time)i(Utilit)m(y)h(Routines)69 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(68)136
1204 y(6.12)49 b(General)32 b(Utilit)m(y)g(Subroutines)61
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(.)85
b(69)0 1464 y Fh(7)119 b(The)35 b(CFITSIO)e(Iterator)g(F)-9
b(unction)2154 b(75)0 1725 y(8)119 b(Extended)35 b(File)f(Name)h(Syn)m
(tax)2330 b(77)136 1887 y Fi(8.1)94 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(.)85 b(77)136 2049 y(8.2)94
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(.)85
b(80)345 2211 y(8.2.1)106 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(.)85 b(80)345
2373 y(8.2.2)106 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(.)85 b(81)345 2536
y(8.2.3)106 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(.)85 b(82)345 2698
y(8.2.4)106 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(.)85 b(82)345 2860
y(8.2.5)106 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(.)85 b(84)136 3022 y(8.3)94
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(.)85 b(84)136
3184 y(8.4)94 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(.)85 b(86)136 3346 y(8.5)94
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(.)85 b(88)136 3508 y(8.6)94 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(.)85 b(88)136 3670 y(8.7)94 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(.)85 b(88)136 3832 y(8.8)94 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(.)85 b(89)136 3994 y(8.9)94 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(.)85 b(90)136 4156 y(8.10)49
b(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(.)85 b(92)136 4318 y(8.11)49 b(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(.)85 b(94)345 4481 y(8.11.1)61
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(.)85 b(94)345 4643 y(8.11.2)61
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(.)85 b(97)345 4805 y(8.11.3)61
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(.)85 b(98)345 4967 y(8.11.4)61
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(.)85 b(99)345 5129
y(8.11.5)61 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(100)345
5291 y(8.11.6)61 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(103)136 5453 y(8.12)80 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(104)0
5714 y Fh(9)84 b(T)-9 b(emplate)35 b(Files)2933 b(107)p
eop end
%%Page: 6 6
TeXDict begin 6 5 bop 0 299 a Fi(vi)3311 b Fg(CONTENTS)136
555 y Fi(9.1)94 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(107)136 715 y(9.2)94 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(108)136 876 y(9.3)94 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(109)136 1036 y(9.4)94 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(109)136 1196 y(9.5)94 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(110)136 1356 y(9.6)94
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(110)0
1607 y Fh(10)67 b(Summary)36 b(of)f(all)f(FITSIO)g(User-In)m(terface)h
(Subroutines)1215 b(113)0 1858 y(11)67 b(P)m(arameter)35
b(De\014nitions)2563 b(121)0 2109 y(12)67 b(FITSIO)33
b(Error)i(Status)g(Co)s(des)2295 b(127)p eop end
%%Page: 1 7
TeXDict begin 1 6 bop 0 1225 a Ff(Chapter)65 b(1)0 1687
y Fl(In)-6 b(tro)6 b(duction)0 2180 y Fi(This)33 b(do)s(cumen)m(t)i
(describ)s(es)e(the)h(F)-8 b(ortran-callable)38 b(subroutine)33
b(in)m(terface)j(that)f(is)f(pro)m(vided)g(as)g(part)g(of)h(the)0
2293 y(CFITSIO)f(library)h(\(whic)m(h)h(is)g(written)g(in)f(ANSI)g
(C\).)h(This)f(is)h(a)g(companion)g(do)s(cumen)m(t)f(to)i(the)e
(CFITSIO)0 2406 y(User's)k(Guide)f(whic)m(h)h(should)e(b)s(e)h
(consulted)h(for)f(further)g(information)h(ab)s(out)f(the)h(underlying)
e(CFITSIO)0 2518 y(library)-8 b(.)50 b(In)32 b(the)i(remainder)f(of)g
(this)h(do)s(cumen)m(t,)g(the)g(terms)f(FITSIO)f(and)h(CFITSIO)f(are)i
(in)m(terc)m(hangeable)0 2631 y(and)c(refer)g(to)h(the)g(same)f
(library)-8 b(.)0 2791 y(FITSIO/CFITSIO)31 b(is)j(a)f(mac)m(hine-indep)
s(enden)m(t)g(library)g(of)h(routines)f(for)g(reading)h(and)f(writing)g
(data)h(\014les)0 2904 y(in)c(the)g(FITS)g(\(Flexible)i(Image)f(T)-8
b(ransp)s(ort)29 b(System\))h(data)h(format.)41 b(It)31
b(can)f(also)h(read)g(IRAF)f(format)h(image)0 3017 y(\014les)40
b(and)e(ra)m(w)i(binary)f(data)h(arra)m(ys)g(b)m(y)g(con)m(v)m(erting)h
(them)e(on)h(the)g(\015y)f(in)m(to)h(a)g(virtual)g(FITS)f(format)h
(\014le.)0 3130 y(This)32 b(library)h(w)m(as)g(written)g(to)h(pro)m
(vide)f(a)h(p)s(o)m(w)m(erful)f(y)m(et)h(simple)f(in)m(terface)h(for)f
(accessing)i(FITS)d(\014les)h(whic)m(h)0 3243 y(will)j(run)e(on)h(most)
h(commonly)g(used)e(computers)h(and)g(w)m(orkstations.)57
b(FITSIO)34 b(supp)s(orts)g(all)i(the)g(features)0 3356
y(describ)s(ed)21 b(in)i(the)f(o\016cial)i(NOST)e(de\014nition)g(of)h
(the)f(FITS)g(format)h(and)f(can)h(read)f(and)g(write)h(all)g(the)g
(curren)m(tly)0 3469 y(de\014ned)40 b(t)m(yp)s(es)h(of)g(extensions,)j
(including)d(ASCI)s(I)e(tables)j(\(T)-8 b(ABLE\),)42
b(Binary)f(tables)h(\(BINT)-8 b(ABLE\))43 b(and)0 3582
y(IMA)m(GE)36 b(extensions.)56 b(The)34 b(FITSIO)g(subroutines)g
(insulate)i(the)f(programmer)g(from)g(ha)m(ving)h(to)g(deal)f(with)0
3695 y(the)25 b(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 3808 y(kno)m(wledge)31 b(ab)s(out)f(the)h
(structure)f(and)g(usage)h(of)f(FITS)g(\014les.)0 3968
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 4081 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 4194 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
4307 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 4419 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 4532 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 4645 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 4805 y(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 4918
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:)382 5178 y Fe(http://heasarc.gsfc.nasa)o(.go)o
(v/fi)o(tsio)382 5291 y(ftp://legacy.gsfc.nasa.g)o(ov/)o(soft)o(ware)o
(/fi)o(tsio)o(/c)1927 5942 y Fi(1)p eop end
%%Page: 2 8
TeXDict begin 2 7 bop 0 299 a Fi(2)2452 b Fg(CHAPTER)30
b(1.)71 b(INTR)m(ODUCTION)0 555 y Fi(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 668
y(sen)m(t)k(to)g(the)g(primary)e(author:)382 928 y Fe(Dr.)47
b(William)f(Pence)810 b(Telephone:)92 b(\(301\))47 b(286-4599)382
1041 y(HEASARC,)e(Code)i(662)811 b(E-mail:)45 b
(William.D.Pence@nasa.gov)382 1154 y(NASA/Goddard)f(Space)j(Flight)f
(Center)382 1267 y(Greenbelt,)f(MD)i(20771,)f(USA)0 1526
y Fi(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
1639 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 1752 y(FITS)h(Supp)s(ort)f(O\016ce)i
(at)g Fe(http://fits.gsfc.nasa.gov)o Fi(.)42 b(In)32
b(particular,)i(the)f('NOST)f(FITS)g(Standard')0 1865
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
1978 y(additional)d(historical)h(bac)m(kground)e(and)g(practical)i
(advice)f(on)f(using)g(FITS)g(\014les.)0 2138 y(CFITSIO)j(users)g(ma)m
(y)h(also)h(b)s(e)f(in)m(terested)h(in)f(the)g(FTOOLS)f(pac)m(k)-5
b(age)36 b(of)e(programs)g(that)g(can)h(b)s(e)e(used)g(to)0
2251 y(manipulate)k(and)e(analyze)j(FITS)e(format)g(\014les.)59
b(Information)36 b(ab)s(out)g(FTOOLS)f(can)i(b)s(e)f(obtained)g(on)h
(the)0 2364 y(W)-8 b(eb)31 b(or)f(via)h(anon)m(ymous)g(ftp)f(at:)382
2624 y Fe(http://heasarc.gsfc.nasa)o(.go)o(v/ft)o(ools)382
2737 y(ftp://legacy.gsfc.nasa.g)o(ov/)o(soft)o(ware)o(/ft)o(ools)o
(/rel)o(eas)o(e)p eop end
%%Page: 3 9
TeXDict begin 3 8 bop 0 1225 a Ff(Chapter)65 b(2)0 1687
y Fl(Creating)77 b(FITSIO/CFITSIO)0 2216 y Fd(2.1)135
b(Building)45 b(the)h(Library)0 2467 y Fi(T)-8 b(o)43
b(use)g(the)g(FITSIO)f(subroutines)f(one)j(m)m(ust)e(\014rst)g(build)g
(the)h(CFITSIO)f(library)-8 b(,)46 b(whic)m(h)d(requires)f(a)h(C)0
2580 y(compiler.)73 b(gcc)43 b(is)e(ideal,)j(or)d(most)h(other)f
(ANSI-C)g(compilers)g(will)h(also)g(w)m(ork.)73 b(The)40
b(CFITSIO)g(co)s(de)h(is)0 2692 y(con)m(tained)25 b(in)f(ab)s(out)f(40)
i(C)f(source)g(\014les)f(\(*.c\))j(and)d(header)h(\014les)g(\(*.h\).)39
b(On)23 b(V)-10 b(AX/VMS)25 b(systems)f(2)g(assem)m(bly-)0
2805 y(co)s(de)31 b(\014les)f(\(vmsieeed.mar)h(and)f(vmsieeer.mar\))h
(are)g(also)g(needed.)0 2965 y(The)45 b(F)-8 b(ortran)46
b(in)m(terface)g(subroutines)e(to)i(the)f(C)g(CFITSIO)f(routines)h(are)
g(lo)s(cated)i(in)e(the)g(f77)p 3538 2965 28 4 v 33 w(wrap1.c,)0
3078 y(through)22 b(f77)p 459 3078 V 33 w(wrap4.c)h(\014les.)38
b(These)22 b(are)h(relativ)m(ely)i(simple)d('wrapp)s(ers')f(that)i
(translate)h(the)f(argumen)m(ts)g(in)f(the)0 3191 y(F)-8
b(ortran)26 b(subroutine)e(in)m(to)j(the)e(appropriate)h(format)g(for)f
(the)g(corresp)s(onding)g(C)g(routine.)39 b(This)24 b(translation)j(is)
0 3304 y(p)s(erformed)19 b(transparen)m(tly)i(to)g(the)g(user)f(b)m(y)g
(a)h(set)h(of)e(C)h(macros)g(lo)s(cated)h(in)e(the)h(cfortran.h)f
(\014le.)38 b(Unfortunately)0 3417 y(cfortran.h)28 b(do)s(es)g(not)g
(supp)s(ort)f(ev)m(ery)h(com)m(bination)i(of)e(C)g(and)f(F)-8
b(ortran)29 b(compilers)g(so)f(the)h(F)-8 b(ortran)28
b(in)m(terface)0 3530 y(is)i(not)h(supp)s(orted)e(on)h(all)h
(platforms.)41 b(\(see)31 b(further)e(notes)i(b)s(elo)m(w\).)0
3690 y(A)f(standard)f(com)m(bination)j(of)e(C)f(and)h(F)-8
b(ortran)30 b(compilers)h(will)f(b)s(e)f(assumed)h(b)m(y)f(default,)i
(but)e(one)h(ma)m(y)h(also)0 3803 y(sp)s(ecify)f(a)h(particular)f(F)-8
b(ortran)32 b(compiler)e(b)m(y)h(doing:)48 4064 y Fe(>)95
b(setenv)46 b(CFLAGS)g(-DcompilerName=1)0 4324 y Fi(\(where)33
b('compilerName')h(is)f(the)g(name)f(of)h(the)g(compiler\))h(b)s(efore)
e(running)f(the)i(con\014gure)f(command.)47 b(The)0 4437
y(curren)m(tly)30 b(recognized)i(compiler)f(names)f(are:)48
4698 y Fe(g77Fortran)48 4811 y(IBMR2Fortran)48 4924 y(CLIPPERFortran)48
5036 y(pgiFortran)48 5149 y(NAGf90Fortran)48 5262 y(f2cFortran)48
5375 y(hpuxFortran)48 5488 y(apolloFortran)48 5601 y(sunFortran)48
5714 y(CRAYFortran)1927 5942 y Fi(3)p eop end
%%Page: 4 10
TeXDict begin 4 9 bop 0 299 a Fi(4)1896 b Fg(CHAPTER)30
b(2.)111 b(CREA)-8 b(TING)31 b(FITSIO/CFITSIO)48 555
y Fe(mipsFortran)48 668 y(DECFortran)48 781 y(vmsFortran)48
894 y(CONVEXFortran)48 1007 y(PowerStationFortran)48
1120 y(AbsoftUNIXFortran)48 1233 y(AbsoftProFortran)48
1346 y(SXFortran)0 1609 y Fi(Alternativ)m(ely)-8 b(,)42
b(one)c(ma)m(y)g(edit)g(the)f(CFLA)m(GS)h(line)f(in)h(the)f(Mak)m
(e\014le)i(to)f(add)f(the)h('-DcompilerName')i(\015ag)0
1722 y(after)31 b(running)e(the)h('./con\014gure')h(command.)0
1882 y(The)f(CFITSIO)f(library)h(is)g(built)g(on)h(Unix)f(systems)g(b)m
(y)g(t)m(yping:)48 2146 y Fe(>)95 b(./configure)45 b
([--prefix=/target/insta)o(llat)o(ion)o(/pat)o(h])764
2259 y([--enable-sse2])e([--enable-ssse3])48 2372 y(>)95
b(make)476 b(\(or)95 b('make)46 b(shared'\))48 2485 y(>)95
b(make)47 b(install)93 b(\(this)46 b(step)h(is)g(optional\))0
2749 y Fi(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 2861 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
2974 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 3087 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 3200 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 3313 y('mak)m(e)j(install')f
(command.)41 b(F)-8 b(or)31 b(example,)143 3577 y Fe(>)48
b(./configure)c(--prefix=/usr1/local)0 3841 y Fi(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 3953 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 4066 y(to)f(write)g(to)g(these)g(directories\).)
0 4227 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 4339 y(using)31 b(faster)h(b)m(yte-sw)m(apping)g
(algorithms.)46 b(See)32 b(the)g("Optimizing)g(Programs")g(section)h
(of)f(this)f(man)m(ual)h(for)0 4452 y(more)f(information)f(ab)s(out)g
(these)h(options.)0 4613 y(By)37 b(default,)i(the)f(Mak)m(e\014le)g
(will)g(b)s(e)e(con\014gured)g(to)i(build)e(the)h(set)h(of)f(F)-8
b(ortran-callable)40 b(wrapp)s(er)35 b(routines)0 4725
y(whose)30 b(calling)i(sequences)f(are)f(describ)s(ed)g(later)h(in)f
(this)g(do)s(cumen)m(t.)0 4886 y(The)e('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 4999 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 5111
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 5111 28
4 v 33 w(LIBRAR)-8 b(Y)p 3514 5111 V 34 w(P)g(A)g(TH)28
b(or)0 5224 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
5488 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 5601 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
5714 y(library)f(is)h(running)f(at)h(the)g(same)g(time)f(since)h(the)g
(system)f(is)h(smart)p eop end
%%Page: 5 11
TeXDict begin 5 10 bop 0 299 a Fg(2.1.)72 b(BUILDING)31
b(THE)f(LIBRAR)-8 b(Y)2507 b Fi(5)334 555 y Fe(enough)46
b(to)h(share)g(copies)f(of)h(the)g(shared)f(library)g(at)h(run)g(time.)
143 668 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 781 y(library)f(can)h(be)g(installed)
e(without)h(relinking)f(all)i(the)g(software)334 894
y(that)g(uses)f(it)i(\(as)e(long)h(as)g(the)g(subroutine)e(names)i(and)
f(calling)334 1007 y(sequences)f(remain)h(unchanged\).)143
1120 y(4.)95 b(No)47 b(run-time)f(penalty.)0 1346 y Fi(The)30
b(disadv)-5 b(an)m(tages)32 b(are:)143 1572 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 1685 y(specially)f(or)h(have)f
(LD_LIBRARY_PATH)e(set)j(right.)143 1798 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 1911 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 2024 y(either)f(really)h(slow)f
(or)h(really)f(heavily)g(loaded.)0 2250 y Fi(On)30 b(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 2363
y(\014gure)h(to)h(enable)g("extended)g(ANSI")f(features.)0
2523 y(It)j(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 2636 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 2749
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 2862 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
3022 y(On)c(V)-10 b(AX/VMS)31 b(and)d(ALPHA/VMS)i(systems)f(the)h(mak)m
(e)p 2100 3022 28 4 v 34 w(g\015oat.com)h(command)e(\014le)g(ma)m(y)h
(b)s(e)f(executed)h(to)0 3135 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 3248
y(The)37 b(mak)m(e)p 405 3248 V 33 w(d\015oat.com)i(and)d(mak)m(e)p
1279 3248 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 3361 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 3474 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 3587 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
3747 y(On)25 b(Windo)m(ws)h(IBM-PC)g(t)m(yp)s(e)g(platforms)f(the)h
(situation)h(is)e(more)h(complicated)i(b)s(ecause)d(of)h(the)g(wide)g
(v)-5 b(ariet)m(y)0 3860 y(of)43 b(F)-8 b(ortran)43 b(compilers)h(that)
f(are)g(a)m(v)-5 b(ailable)45 b(and)d(b)s(ecause)h(of)g(the)g(inheren)m
(t)g(complexities)i(of)d(calling)j(the)0 3973 y(CFITSIO)25
b(C)g(routines)h(from)g(F)-8 b(ortran.)40 b(Tw)m(o)26
b(di\013eren)m(t)h(v)m(ersions)f(of)g(the)h(CFITSIO)d(dll)i(library)g
(are)g(a)m(v)-5 b(ailable,)0 4085 y(compiled)28 b(with)e(the)i(Borland)
f(C++)f(compiler)i(and)e(the)i(Microsoft)g(Visual)g(C++)e(compiler,)i
(resp)s(ectiv)m(ely)-8 b(,)30 b(in)0 4198 y(the)g(\014les)g(c\014tsio)s
(dll)p 679 4198 V 33 w(2xxx)p 901 4198 V 34 w(b)s(orland.zip)f(and)g
(c\014tsio)s(dll)p 1924 4198 V 33 w(3xxx)p 2146 4198
V 33 w(v)m(cc.zip,)j(where)e('3xxx')h(represen)m(ts)f(the)g(curren)m(t)
0 4311 y(release)44 b(n)m(um)m(b)s(er.)76 b(Both)43 b(these)g(dll)g
(libraries)g(con)m(tain)h(a)f(set)g(of)f(F)-8 b(ortran)44
b(wrapp)s(er)d(routines)h(whic)m(h)g(ma)m(y)0 4424 y(b)s(e)37
b(compatible)i(with)e(some,)j(but)d(probably)g(not)g(all,)k(a)m(v)-5
b(ailable)40 b(F)-8 b(ortran)38 b(compilers.)63 b(T)-8
b(o)38 b(test)g(if)g(they)g(are)0 4537 y(compatible,)29
b(compile)f(the)f(program)g(testf77.f)h(and)f(try)f(linking)i(to)f
(these)h(dll)e(libraries.)40 b(If)27 b(these)g(libraries)g(do)0
4650 y(not)i(w)m(ork)g(with)f(a)h(particular)g(F)-8 b(ortran)30
b(compiler,)g(then)e(there)h(are)g(2)g(p)s(ossible)g(solutions.)40
b(The)28 b(\014rst)g(solution)0 4763 y(w)m(ould)h(b)s(e)h(to)g(mo)s
(dify)f(the)h(\014le)f(cfortran.h)h(for)f(that)i(particular)f(com)m
(bination)h(of)f(C)f(and)g(F)-8 b(ortran)30 b(compilers,)0
4876 y(and)k(then)g(rebuild)f(the)i(CFITSIO)d(dll)j(library)-8
b(.)52 b(This)34 b(will)h(require,)g(ho)m(w)m(ev)m(er,)i(a)e(some)f
(exp)s(ertise)h(in)f(mixed)0 4989 y(language)e(programming.)40
b(The)30 b(other)h(solution)f(is)h(to)g(use)f(the)g(older)h(v5.03)h(F)
-8 b(ortran-77)32 b(implemen)m(tation)g(of)0 5102 y(FITSIO)25
b(that)h(is)g(still)h(a)m(v)-5 b(ailable)28 b(from)d(the)h(FITSIO)f(w)m
(eb-site.)40 b(This)25 b(v)m(ersion)h(is)g(no)g(longer)g(supp)s(orted,)
f(but)g(it)0 5215 y(do)s(es)k(pro)m(vide)h(the)g(basic)h(functions)e
(for)g(reading)h(and)f(writing)h(FITS)f(\014les)h(and)f(should)g(b)s(e)
g(compatible)i(with)0 5327 y(most)g(F)-8 b(ortran)31
b(compilers.)0 5488 y(CFITSIO)e(has)h(curren)m(tly)g(b)s(een)g(tested)h
(on)f(the)h(follo)m(wing)h(platforms:)95 5714 y Fe(OPERATING)46
b(SYSTEM)523 b(COMPILER)p eop end
%%Page: 6 12
TeXDict begin 6 11 bop 0 299 a Fi(6)1896 b Fg(CHAPTER)30
b(2.)111 b(CREA)-8 b(TING)31 b(FITSIO/CFITSIO)143 555
y Fe(Sun)47 b(OS)1002 b(gcc)47 b(and)g(cc)g(\(3.0.1\))143
668 y(Sun)g(Solaris)762 b(gcc)47 b(and)g(cc)143 781 y(Silicon)f
(Graphics)g(IRIX)285 b(gcc)47 b(and)g(cc)143 894 y(Silicon)f(Graphics)g
(IRIX64)189 b(MIPS)143 1007 y(Dec)47 b(Alpha)f(OSF/1)572
b(gcc)47 b(and)g(cc)143 1120 y(DECstation)93 b(Ultrix)428
b(gcc)143 1233 y(Dec)47 b(Alpha)f(OpenVMS)476 b(cc)143
1346 y(DEC)47 b(VAX/VMS)762 b(gcc)47 b(and)g(cc)143 1458
y(HP-UX)1049 b(gcc)143 1571 y(IBM)47 b(AIX)954 b(gcc)143
1684 y(Linux)1049 b(gcc)143 1797 y(MkLinux)953 b(DR3)143
1910 y(Windows)46 b(95/98/NT)523 b(Borland)46 b(C++)h(V4.5)143
2023 y(Windows)f(95/98/NT/ME/XP)235 b(Microsoft/Compaq)43
b(Visual)j(C++)h(v5.0,)g(v6.0)143 2136 y(Windows)f(95/98/NT)523
b(Cygwin)46 b(gcc)143 2249 y(OS/2)1097 b(gcc)47 b(+)g(EMX)143
2362 y(MacOS)g(7.1)f(or)i(greater)332 b(Metrowerks)45
b(10.+)0 2591 y Fi(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 2704 y(supp)s(orted.)0 3033 y Fd(2.2)135
b(T)-11 b(esting)46 b(the)f(Library)0 3283 y Fi(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
3396 y(included)30 b(with)g(the)g(release.)42 b(On)30
b(Unix)g(systems)g(t)m(yp)s(e:)191 3625 y Fe(\045)47
b(make)g(testprog)191 3738 y(\045)g(testprog)f(>)h(testprog.lis)191
3850 y(\045)g(diff)g(testprog.lis)d(testprog.out)191
3963 y(\045)j(cmp)g(testprog.fit)e(testprog.std)0 4192
y Fi(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 4421
y Fe($)47 b(cc)h(testprog.c)191 4534 y($)f(link)g(testprog,)e
(cfitsio/lib,)g(alpha$library:vaxcrtl/l)o(ib)191 4647
y($)i(run)g(testprog)0 4876 y Fi(The)30 b(testprog)h(program)g(should)e
(pro)s(duce)g(a)i(FITS)f(\014le)g(called)i(`testprog.\014t')g(that)f
(is)f(iden)m(tical)j(to)e(the)f(`test-)0 4989 y(prog.std')25
b(FITS)f(\014le)g(included)g(with)g(this)h(release.)40
b(The)24 b(diagnostic)i(messages)g(\(whic)m(h)e(w)m(ere)h(pip)s(ed)f
(to)h(the)g(\014le)0 5102 y(testprog.lis)h(in)e(the)h(Unix)f(example\))
i(should)d(b)s(e)h(iden)m(tical)j(to)e(the)g(listing)g(con)m(tained)h
(in)e(the)h(\014le)f(testprog.out.)0 5215 y(The)30 b('di\013)7
b(')31 b(and)e('cmp')i(commands)f(sho)m(wn)g(ab)s(o)m(v)m(e)h(should)f
(not)g(rep)s(ort)g(an)m(y)h(di\013erences)g(in)f(the)g(\014les.)41
b(\(There)0 5328 y(ma)m(y)35 b(b)s(e)e(some)h(minor)g(formatting)g
(di\013erences,)i(suc)m(h)d(as)i(the)f(presence)g(or)g(absence)g(of)g
(leading)h(zeros,)h(or)e(3)0 5441 y(digit)d(exp)s(onen)m(ts)f(in)g(n)m
(um)m(b)s(ers,)g(whic)m(h)g(can)g(b)s(e)g(ignored\).)0
5601 y(The)f(F)-8 b(ortran)31 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.)40
b(On)29 b(Unix)h(systems)g(the)0 5714 y(fortran)g(compilation)i(and)e
(link)g(command)g(ma)m(y)h(b)s(e)f(called)h('f77')h(or)e('g77',)j(dep)s
(ending)c(on)h(the)g(system.)p eop end
%%Page: 7 13
TeXDict begin 7 12 bop 0 299 a Fg(2.2.)72 b(TESTING)29
b(THE)h(LIBRAR)-8 b(Y)2555 b Fi(7)143 555 y Fe(\045)48
b(f77)f(-o)g(testf77)f(testf77.f)f(-L.)i(-lcfitsio)e(-lnsl)h(-lsocket)
48 668 y(or)143 781 y(\045)i(f77)f(-f)g(-o)g(testf77)f(testf77.f)f(-L.)
i(-lcfitsio)188 b(\(under)46 b(SUN)h(O/S\))48 894 y(or)143
1007 y(\045)h(f77)f(-o)g(testf77)f(testf77.f)f(-Wl,-L.)h(-lcfitsio)f
(-lm)i(-lnsl)f(-lsocket)g(\(HP/UX\))48 1120 y(or)143
1233 y(\045)i(g77)f(-o)g(testf77)f(-s)h(testf77.f)e(-lcfitsio)g
(-lcc_dynamic)g(-lncurses)g(\(Mac)i(OS-X\))143 1458 y(\045)h(testf77)d
(>)j(testf77.lis)143 1571 y(\045)g(diff)e(testf77.lis)f(testf77.out)143
1684 y(\045)j(cmp)f(testf77.fit)d(testf77.std)0 1934
y Fi(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 2047 y(double)24 b(precision)g(v)-5
b(ariables)25 b(to)g(b)s(e)e(aligned)i(on)f(8-b)m(yte)i(b)s(oundaries)c
(to)j(mak)m(e)g(the)g(fortran-declared)f(v)-5 b(ariables)0
2160 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 2273 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 2386 y(v)-5
b(ariables.)0 2546 y(On)27 b(Windo)m(ws)h(platforms,)g(linking)g(F)-8
b(ortran)28 b(programs)f(with)h(a)g(C)f(library)g(often)h(dep)s(ends)e
(on)i(the)g(particular)0 2659 y(compilers)40 b(in)m(v)m(olv)m(ed.)71
b(Some)40 b(users)f(ha)m(v)m(e)i(found)d(the)i(follo)m(wing)i(commands)
d(w)m(ork)h(when)f(using)g(the)h(In)m(tel)0 2772 y(F)-8
b(ortran)31 b(compiler:)0 3022 y Fe(ifort)46 b(/libs.dll)g(cfitsio.lib)
e(/MD)j(testf77.f)f(/Gm)0 3247 y(or)h(possibly,)0 3473
y(ifort)f(/libs:dll)g(cfitsio.lib)e(/MD)j(/fpp)g
(/extfpp:cfortran.h,fitsi)o(o.h)191 3586 y(/iface:cvf)e(testf77.f)0
3836 y Fi(Also)32 b(note)h(that)f(on)g(some)g(systems)f(the)h(output)g
(listing)g(of)g(the)g(testf77)h(program)f(ma)m(y)g(di\013er)f(sligh)m
(tly)i(from)0 3949 y(the)f(testf77.std)i(template)g(if)e(leading)h
(zeros)g(are)g(not)g(prin)m(ted)e(b)m(y)i(default)f(b)s(efore)g(the)g
(decimal)i(p)s(oin)m(t)e(when)0 4062 y(using)e(F)h(format.)0
4222 y(A)f(few)h(other)f(utilit)m(y)i(programs)e(are)h(included)e(with)
h(CFITSIO:)191 4472 y Fe(speed)46 b(-)i(measures)d(the)i(maximum)f
(throughput)f(\(in)i(MB)g(per)g(second\))668 4585 y(for)g(writing)f
(and)h(reading)f(FITS)g(files)h(with)f(CFITSIO)191 4811
y(listhead)f(-)j(lists)e(all)h(the)g(header)f(keywords)g(in)h(any)g
(FITS)f(file)191 5036 y(fitscopy)f(-)j(copies)e(any)h(FITS)g(file)f
(\(especially)f(useful)h(in)h(conjunction)811 5149 y(with)g(the)g
(CFITSIO's)e(extended)h(input)g(filename)g(syntax\))191
5375 y(cookbook)f(-)j(a)f(sample)f(program)g(that)h(performs)e(common)i
(read)f(and)811 5488 y(write)h(operations)e(on)i(a)g(FITS)g(file.)191
5714 y(iter_a,)f(iter_b,)g(iter_c)g(-)h(examples)f(of)h(the)g(CFITSIO)f
(iterator)f(routine)p eop end
%%Page: 8 14
TeXDict begin 8 13 bop 0 299 a Fi(8)1896 b Fg(CHAPTER)30
b(2.)111 b(CREA)-8 b(TING)31 b(FITSIO/CFITSIO)0 555 y
Fi(The)f(\014rst)f(4)i(of)g(these)g(utilit)m(y)g(programs)f(can)h(b)s
(e)f(compiled)h(and)e(link)m(ed)i(b)m(y)f(t)m(yping)143
816 y Fe(\045)95 b(make)47 b(program_name)0 1151 y Fd(2.3)135
b(Linking)45 b(Programs)h(with)f(FITSIO)0 1402 y Fi(When)31
b(linking)g(applications)i(soft)m(w)m(are)f(with)f(the)g(FITSIO)f
(library)-8 b(,)32 b(sev)m(eral)h(system)e(libraries)g(usually)g(need)0
1515 y(to)26 b(b)s(e)f(sp)s(eci\014ed)g(on)g(the)h(link)g(comman)f
(Unix)h(systems,)h(the)e(most)h(reliable)h(w)m(a)m(y)f(to)h(determine)e
(what)h(libraries)0 1627 y(are)32 b(required)f(is)g(to)i(t)m(yp)s(e)e
('mak)m(e)i(testprog')g(and)e(see)h(what)f(libraries)h(the)g
(con\014gure)f(script)h(has)f(added.)43 b(The)0 1740
y(t)m(ypical)25 b(libraries)f(that)g(ma)m(y)g(need)f(to)h(b)s(e)f
(added)g(are)g(-lm)h(\(the)g(math)f(library\))h(and)f(-lnsl)g(and)g
(-lso)s(c)m(k)m(et)j(\(needed)0 1853 y(only)h(for)f(FTP)g(and)g(HTTP)g
(\014le)h(access\).)41 b(These)26 b(latter)i(2)f(libraries)g(are)g(not)
g(needed)f(on)g(VMS)h(and)f(Windo)m(ws)0 1966 y(platforms,)31
b(b)s(ecause)f(FTP)g(\014le)h(access)g(is)g(not)f(curren)m(tly)h(supp)s
(orted)d(on)i(those)h(platforms.)0 2126 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 2239 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
2574 y Fd(2.4)135 b(Getting)46 b(Started)g(with)f(FITSIO)0
2825 y Fi(In)32 b(order)h(to)h(e\013ectiv)m(ely)i(use)d(the)g(FITSIO)f
(library)h(as)h(quic)m(kly)g(as)f(p)s(ossible,)h(it)g(is)f(recommended)
g(that)g(new)0 2938 y(users)d(follo)m(w)h(these)g(steps:)0
3098 y(1.)62 b(Read)38 b(the)f(follo)m(wing)i(`FITS)e(Primer')g(c)m
(hapter)h(for)g(a)f(brief)g(o)m(v)m(erview)i(of)f(the)g(structure)e(of)
i(FITS)f(\014les.)0 3211 y(This)25 b(is)h(esp)s(ecially)h(imp)s(ortan)m
(t)g(for)e(users)h(who)f(ha)m(v)m(e)i(not)g(previously)e(dealt)i(with)f
(the)g(FITS)f(table)i(and)f(image)0 3324 y(extensions.)0
3484 y(2.)41 b(W)-8 b(rite)32 b(a)f(simple)f(program)g(to)h(read)g(or)f
(write)g(a)h(FITS)f(\014le)g(using)g(the)h(Basic)g(In)m(terface)h
(routines.)0 3644 y(3.)41 b(Refer)28 b(to)i(the)f(co)s(okb)s(o)s(ok.f)g
(program)f(that)i(is)f(included)f(with)g(this)h(release)h(for)e
(examples)i(of)f(routines)f(that)0 3757 y(p)s(erform)h(v)-5
b(arious)30 b(common)h(FITS)f(\014le)g(op)s(erations.)0
3917 y(4.)52 b(Read)34 b(Chapters)g(4)g(and)f(5)i(to)g(b)s(ecome)f
(familiar)h(with)e(the)i(con)m(v)m(en)m(tions)h(and)d(adv)-5
b(anced)34 b(features)h(of)f(the)0 4030 y(FITSIO)29 b(in)m(terface.)0
4190 y(5.)47 b(Scan)32 b(through)f(the)h(more)h(extensiv)m(e)g(set)g
(of)g(routines)f(that)g(are)h(pro)m(vided)f(in)g(the)g(`Adv)-5
b(anced)32 b(In)m(terface'.)0 4303 y(These)22 b(routines)f(p)s(erform)g
(more)h(sp)s(ecialized)h(functions)e(than)g(are)i(pro)m(vided)e(b)m(y)h
(the)g(Basic)h(In)m(terface)g(routines.)0 4638 y Fd(2.5)135
b(Example)46 b(Program)0 4888 y Fi(The)32 b(follo)m(wing)i(listing)f
(sho)m(ws)f(an)g(example)i(of)e(ho)m(w)h(to)g(use)f(the)g(FITSIO)g
(routines)g(in)g(a)h(F)-8 b(ortran)33 b(program.)0 5001
y(Refer)38 b(to)h(the)g(co)s(okb)s(o)s(ok.f)f(program)g(that)h(is)f
(included)f(with)h(the)h(FITSIO)e(distribution)g(for)h(examples)h(of)0
5114 y(other)31 b(FITS)e(programs.)286 5375 y Fe(program)46
b(writeimage)0 5601 y(C)238 b(Create)46 b(a)i(FITS)f(primary)e(array)i
(containing)e(a)i(2-D)g(image)p eop end
%%Page: 9 15
TeXDict begin 9 14 bop 0 299 a Fg(2.5.)72 b(EXAMPLE)31
b(PR)m(OGRAM)2664 b Fi(9)286 555 y Fe(integer)46 b
(status,unit,blocksize,bit)o(pix,)o(nax)o(is,n)o(axes)o(\(2\))286
668 y(integer)g(i,j,group,fpixel,nelement)o(s,ar)o(ray)o(\(300)o(,200)o
(\))286 781 y(character)g(filename*80)286 894 y(logical)g
(simple,extend)286 1120 y(status=0)0 1233 y(C)238 b(Name)47
b(of)g(the)g(FITS)g(file)f(to)i(be)f(created:)286 1346
y(filename='ATESTFILE.FITS')0 1571 y(C)238 b(Get)47 b(an)g(unused)g
(Logical)e(Unit)i(Number)f(to)h(use)g(to)g(create)f(the)h(FITS)g(file)
286 1684 y(call)g(ftgiou\(unit,status\))0 1910 y(C)238
b(create)46 b(the)h(new)g(empty)g(FITS)f(file)286 2023
y(blocksize=1)286 2136 y(call)h(ftinit\(unit,filename,blo)o(cksi)o
(ze,s)o(tat)o(us\))0 2362 y(C)238 b(initialize)45 b(parameters)g(about)
i(the)g(FITS)f(image)h(\(300)f(x)i(200)f(16-bit)f(integers\))286
2475 y(simple=.true.)286 2588 y(bitpix=16)286 2700 y(naxis=2)286
2813 y(naxes\(1\)=300)286 2926 y(naxes\(2\)=200)286 3039
y(extend=.true.)0 3265 y(C)238 b(write)47 b(the)g(required)e(header)h
(keywords)286 3378 y(call)h(ftphpr\(unit,simple,bitpi)o(x,na)o(xis,)o
(nax)o(es,0)o(,1,e)o(xte)o(nd,s)o(tatu)o(s\))0 3604 y(C)238
b(initialize)45 b(the)i(values)f(in)i(the)e(image)h(with)f(a)i(linear)e
(ramp)h(function)286 3717 y(do)h(j=1,naxes\(2\))477 3830
y(do)f(i=1,naxes\(1\))668 3942 y(array\(i,j\)=i+j)477
4055 y(end)g(do)286 4168 y(end)g(do)0 4394 y(C)238 b(write)47
b(the)g(array)f(to)h(the)g(FITS)g(file)286 4507 y(group=1)286
4620 y(fpixel=1)286 4733 y(nelements=naxes\(1\)*naxes\(2)o(\))286
4846 y(call)g(ftpprj\(unit,group,fpixel)o(,nel)o(emen)o(ts,)o(arra)o
(y,st)o(atu)o(s\))0 5072 y(C)238 b(write)47 b(another)f(optional)f
(keyword)h(to)h(the)g(header)286 5185 y(call)g
(ftpkyj\(unit,'EXPOSURE',1)o(500,)o('Tot)o(al)41 b(Exposure)46
b(Time',status\))0 5410 y(C)238 b(close)47 b(the)g(file)f(and)h(free)g
(the)g(unit)f(number)286 5523 y(call)h(ftclos\(unit,)d(status\))286
5636 y(call)j(ftfiou\(unit,)d(status\))p eop end
%%Page: 10 16
TeXDict begin 10 15 bop 0 299 a Fi(10)1851 b Fg(CHAPTER)30
b(2.)111 b(CREA)-8 b(TING)31 b(FITSIO/CFITSIO)286 555
y Fe(end)0 948 y Fd(2.6)135 b(Legal)46 b(Stu\013)0 1210
y Fi(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 1323 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 1436 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 1596 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
1709 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 1822 y(copies.)0 1982 y(DISCLAIMER:)0
2142 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
2255 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 2368 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 2481 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 2594 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
2707 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 2819 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
2932 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 3045 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
3158 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 3271 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 3384 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 3497
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 3610 y(VICES)29 b(PR)m(O)m(VIDED)j(HEREUNDER.")0
4002 y Fd(2.7)135 b(Ac)l(kno)l(wledgmen)l(ts)0 4264 y
Fi(The)29 b(dev)m(elopmen)m(t)h(of)g(man)m(y)f(of)h(the)f(p)s(o)m(w)m
(erful)g(features)g(in)g(CFITSIO)f(w)m(as)i(made)f(p)s(ossible)g
(through)f(collab-)0 4377 y(orations)35 b(with)f(man)m(y)h(p)s(eople)f
(or)h(organizations)h(from)e(around)f(the)i(w)m(orld.)52
b(The)34 b(follo)m(wing,)j(in)d(particular,)0 4490 y(ha)m(v)m(e)e(made)
e(esp)s(ecially)i(signi\014can)m(t)f(con)m(tributions:)0
4650 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 4763 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 4876 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 4989
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 5102 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 5215 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 5328 y(and)30 b(R)m(OOT)g(proto)s(cols.)0
5488 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
5601 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 5714 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.)
p eop end
%%Page: 11 17
TeXDict begin 11 16 bop 0 299 a Fg(2.7.)72 b(A)m(CKNO)m(WLEDGMENTS)2577
b Fi(11)0 555 y(Uw)m(e)25 b(Lammers)e(\(XMM/ESA/ESTEC,)h(The)g
(Netherlands\))g(designed)g(the)g(high-p)s(erformance)f(lexical)j
(pars-)0 668 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 781 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
894 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 1007 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 1120 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 1233
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 1346 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 1458 y(enhancemen)m(ts)j(to)g(the)g(lexical)h(parser.)0
1619 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 1732 y(Access)31 b(La)m(y)m(er.)0 1892 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
2005 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 2165 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 2278 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 2391 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 2503 y(description)30 b(of)h(the)g(AXAF)g(Data)h
(Mo)s(del.)0 2664 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 2777 y(Jean-loup)30 b(Gailly)i(and)e
(others.)0 2937 y(Doug)h(Mink,)g(SA)m(O,)f(pro)m(vided)g(the)h
(routines)f(for)g(con)m(v)m(erting)i(IRAF)f(format)g(images)g(in)m(to)g
(FITS)f(format.)0 3097 y(Martin)j(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 3210 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 3323 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 3483 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
3596 y(SSSE3)g(mac)m(hine)i(instructions)f(a)m(v)-5 b(ailable)33
b(on)d(x86)p 1784 3596 28 4 v 34 w(64)h(CPUs.)0 3756
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 3869 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 4029 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 4142 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 4255 y(Gan,)g(Emily)e(Greene,)i(Jo)
s(e)f(Harrington,)h(Cheng)e(Ho,)i(Phil)e(Ho)s(dge,)i(Jim)f(Ingham,)g(Y)
-8 b(oshitak)j(a)29 b(Ishisaki,)f(Diab)0 4368 y(Jerius,)j(Mark)h
(Levine,)g(T)-8 b(o)s(dd)30 b(Karak)-5 b(askian,)32 b(Edw)m(ard)f
(King,)g(Scott)i(Ko)s(c)m(h,)e(Claire)h(Larkin,)f(Rob)h(Managan,)0
4481 y(Eric)38 b(Mandel,)i(John)d(Matto)m(x,)43 b(Carsten)37
b(Mey)m(er,)42 b(Emi)37 b(Miy)m(ata,)43 b(Stefan)38 b(Mo)s(c)m(hnac)m
(ki,)j(Mik)m(e)f(Noble,)g(Oliv)m(er)0 4594 y(Ob)s(erdorf,)c(Cliv)m(e)i
(P)m(age,)i(Arvind)35 b(P)m(armar,)j(Je\013)f(P)m(edelt)m(y)-8
b(,)40 b(Tim)c(P)m(earson,)j(Maren)e(Purv)m(es,)h(Scott)f(Randall,)0
4706 y(Chris)d(Rogers,)j(Arnold)e(Rots,)i(Barry)f(Sc)m(hlesinger,)h
(Robin)e(Stebbins,)g(Andrew)f(Szymk)m(o)m(wiak,)k(Allyn)e(T)-8
b(en-)0 4819 y(nan)m(t,)31 b(P)m(eter)g(T)-8 b(eub)s(en,)30
b(James)g(Theiler,)h(Doug)g(T)-8 b(o)s(dy)g(,)31 b(Shiro)e(Ueno,)j
(Stev)m(e)f(W)-8 b(alton,)33 b(Arc)m(hie)e(W)-8 b(arno)s(c)m(k,)32
b(Alan)0 4932 y(W)-8 b(atson,)32 b(Dan)f(Whipple,)f(Wim)h(Wimmers,)g(P)
m(eter)g(Y)-8 b(oung,)31 b(Jianjun)e(Xu,)h(and)g(Nelson)h(Zarate.)p
eop end
%%Page: 12 18
TeXDict begin 12 17 bop 0 299 a Fi(12)1851 b Fg(CHAPTER)30
b(2.)111 b(CREA)-8 b(TING)31 b(FITSIO/CFITSIO)p eop end
%%Page: 13 19
TeXDict begin 13 18 bop 0 1225 a Ff(Chapter)65 b(3)0
1687 y Fl(A)78 b(FITS)f(Primer)0 2180 y Fi(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)37
b(w)m(as)g(\014rst)g(dev)m(elop)s(ed)h(in)f(the)g(late)i(1970's)g(as)f
(a)f(standard)g(data)h(in)m(terc)m(hange)h(format)f(b)s(et)m(w)m(een)g
(v)-5 b(ar-)0 2679 y(ious)38 b(astronomical)h(observ)-5
b(atories.)64 b(Since)37 b(then)g(FITS)g(has)h(b)s(ecome)g(the)g
(defacto)g(standard)f(data)i(format)0 2791 y(supp)s(orted)29
b(b)m(y)h(most)h(astronomical)h(data)f(analysis)g(soft)m(w)m(are)g(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,)32
b(suc)m(h)g(as)f(a)h(1-D)h(sp)s(ectrum,)e(a)h(2-D)h(image,)g(or)f(a)g
(3-D)g(data)h(cub)s(e.)43 b(Six)31 b(di\013eren)m(t)h(primary)f(datat)m
(yp)s(es)0 3290 y(are)g(supp)s(orted:)39 b(Unsigned)30
b(8-bit)h(b)m(ytes,)g(16,)g(32,)h(and)e(64-bit)h(signed)g(in)m(tegers,)
h(and)d(32)j(and)d(64-bit)j(\015oating)0 3403 y(p)s(oin)m(t)d(reals.)41
b(FITS)29 b(also)i(has)e(a)h(con)m(v)m(en)m(tion)h(for)e(storing)h
(unsigned)f(in)m(tegers)h(\(see)h(the)e(later)i(section)f(en)m(titled)0
3516 y(`Unsigned)h(In)m(tegers')h(for)f(more)g(details\).)43
b(The)31 b(primary)f(HDU)i(ma)m(y)f(also)h(consist)g(of)f(only)g(a)g
(header)g(with)g(a)0 3629 y(n)m(ull)f(arra)m(y)h(con)m(taining)h(no)e
(data)h(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 Fi(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 Fi(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 Fi(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 Fi(13)p eop end
%%Page: 14 20
TeXDict begin 14 19 bop 0 299 a Fi(14)2398 b Fg(CHAPTER)30
b(3.)112 b(A)30 b(FITS)g(PRIMER)0 555 y Fi(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.)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\))h(so)h(it)g(is)f(b)s(etter)h(to)g(rely)g(on)f
(standard)g(in)m(terface)i(soft)m(w)m(are)g(lik)m(e)g(FITSIO)d(to)j
(correctly)g(construct)0 1619 y(or)d(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 Fi(BITPIX)33
b({)h(de\014nes)e(the)i(datat)m(yp)s(e)g(of)f(the)g(arra)m(y:)47
b(8,)35 b(16,)g(32,)g(64,)g(-32,)g(-64)g(for)e(unsigned)f(8{bit)i(b)m
(yte,)227 3284 y(16{bit)27 b(signed)e(in)m(teger,)i(32{bit)g(signed)e
(in)m(teger,)j(64{bit)e(signed)f(in)m(teger,)j(32{bit)e(IEEE)f
(\015oating)h(p)s(oin)m(t,)227 3397 y(and)k(64{bit)i(IEEE)e(double)f
(precision)i(\015oating)g(p)s(oin)m(t,)g(resp)s(ectiv)m(ely)-8
b(.)136 3585 y Fc(\017)46 b Fi(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 Fi(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 Fi(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 Fi(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
Fi(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 Fi(TF)m(ORMn)31 b({)f(the)h(datat)m(yp)s(e)g(of)g
(the)f(column)136 5106 y Fc(\017)46 b Fi(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 Fi(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 21
TeXDict begin 15 20 bop 0 1225 a Ff(Chapter)65 b(4)0
1687 y Fl(FITSIO)76 b(Con)-6 b(v)g(en)g(tions)76 b(and)h(Guidelines)0
2216 y Fd(4.1)135 b(CFITSIO)44 b(Size)h(Limitations)0
2524 y Fi(CFITSIO)31 b(places)i(few)g(restrictions)g(on)g(the)f(size)i
(of)e(FITS)g(\014les)h(that)g(it)g(reads)f(or)h(writes.)47
b(There)32 b(are)h(a)g(few)0 2636 y(limits,)e(ho)m(w)m(ev)m(er,)h(whic)
m(h)e(ma)m(y)h(a\013ect)h(some)f(extreme)g(cases:)0 2797
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 2910 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 3022
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
3135 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 3248 y(constan)m(t)31
b(F)m(OPEN)p 690 3248 28 4 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 3361 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
3474 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 3634
y(2.)54 b(By)35 b(default,)h(CFITSIO)d(can)i(handle)g(FITS)f(\014les)g
(up)g(to)h(2.1)h(GB)g(in)e(size)i(\(2**31)h(b)m(ytes\).)54
b(This)34 b(\014le)h(size)0 3747 y(limit)41 b(is)g(often)f(imp)s(osed)g
(b)m(y)g(32-bit)i(op)s(erating)e(systems.)71 b(More)41
b(recen)m(tly)-8 b(,)45 b(as)c(64-bit)g(op)s(erating)g(systems)0
3860 y(b)s(ecome)33 b(more)g(common,)g(an)g(industry-wide)e(standard)h
(\(at)i(least)f(on)g(Unix)f(systems\))h(has)g(b)s(een)f(dev)m(elop)s
(ed)0 3973 y(to)39 b(supp)s(ort)d(larger)i(sized)h(\014les)f(\(see)g(h)
m(ttp://ftp.sas.com/standards/large.\014le/\).)69 b(Starting)38
b(with)f(v)m(ersion)0 4086 y(2.1)45 b(of)e(CFITSIO,)f(larger)i(FITS)f
(\014les)g(up)g(to)h(6)g(terab)m(ytes)h(in)e(size)h(ma)m(y)g(b)s(e)f
(read)g(and)g(written)h(on)f(sup-)0 4199 y(p)s(orted)f(platforms.)76
b(In)42 b(order)g(to)h(supp)s(ort)e(these)h(larger)h(\014les,)j
(CFITSIO)41 b(m)m(ust)h(b)s(e)g(compiled)h(with)f(the)0
4312 y('-D)p 129 4312 V 34 w(LAR)m(GEFILE)p 696 4312
V 33 w(SOUR)m(CE')g(and)g(`-D)p 1491 4312 V 34 w(FILE)p
1736 4312 V 33 w(OFFSET)p 2137 4312 V 32 w(BITS=64')h(compiler)g
(\015ags.)78 b(Some)43 b(platforms)0 4425 y(ma)m(y)c(also)g(require)f
(the)g(`-D)p 1002 4425 V 34 w(LAR)m(GE)p 1358 4425 V
33 w(FILES')g(compiler)h(\015ag.)64 b(This)38 b(causes)g(the)h
(compiler)g(to)g(allo)s(cate)h(8-)0 4538 y(b)m(ytes)k(instead)g(of)g
(4-b)m(ytes)h(for)f(the)g(`o\013)p 1473 4538 V 33 w(t')g(datat)m(yp)s
(e)h(whic)m(h)f(is)f(used)g(to)i(store)f(\014le)g(o\013set)h(p)s
(ositions.)81 b(It)0 4650 y(app)s(ears)31 b(that)i(in)e(most)i(cases)g
(it)f(is)g(not)g(necessary)h(to)f(also)h(include)f(these)g(compiler)h
(\015ags)f(when)f(compiling)0 4763 y(programs)f(that)h(link)f(to)h(the)
g(CFITSIO)e(library)-8 b(.)0 4924 y(If)21 b(CFITSIO)e(is)i(compiled)h
(with)f(the)g(-D)p 1386 4924 V 33 w(LAR)m(GEFILE)p 1952
4924 V 34 w(SOUR)m(CE)f(and)g(-D)p 2654 4924 V 34 w(FILE)p
2899 4924 V 33 w(OFFSET)p 3300 4924 V 32 w(BITS=64)h(\015ags)0
5036 y(on)36 b(a)g(platform)g(that)g(supp)s(orts)e(large)j(\014les,)h
(then)d(it)i(can)f(read)g(and)f(write)h(FITS)f(\014les)h(that)g(con)m
(tain)h(up)e(to)0 5149 y(2**31)k(2880-b)m(yte)g(FITS)d(records,)j(or)d
(appro)m(ximately)i(6)f(terab)m(ytes)h(in)f(size.)60
b(It)37 b(is)g(still)h(required)d(that)j(the)0 5262 y(v)-5
b(alue)30 b(of)f(the)g(NAXISn)f(and)h(PCOUNT)f(k)m(eyw)m(ords)h(in)g
(eac)m(h)h(extension)g(b)s(e)e(within)h(the)g(range)h(of)f(a)g(signed)g
(4-)0 5375 y(b)m(yte)c(in)m(teger)h(\(max)f(v)-5 b(alue)26
b(=)e(2,147,483,648\).)44 b(Th)m(us,)25 b(eac)m(h)h(dimension)e(of)h
(an)f(image)i(\(giv)m(en)g(b)m(y)f(the)g(NAXISn)0 5488
y(k)m(eyw)m(ords\),)32 b(the)f(total)i(width)d(of)h(a)g(table)h
(\(NAXIS1)g(k)m(eyw)m(ord\),)g(the)f(n)m(um)m(b)s(er)f(of)h(ro)m(ws)g
(in)f(a)h(table)h(\(NAXIS2)0 5601 y(k)m(eyw)m(ord\),)c(and)d(the)h
(total)i(size)f(of)f(the)g(v)-5 b(ariable-length)28 b(arra)m(y)e(heap)g
(in)g(binary)f(tables)i(\(PCOUNT)e(k)m(eyw)m(ord\))0
5714 y(m)m(ust)30 b(b)s(e)g(less)h(than)f(this)g(limit.)1905
5942 y(15)p eop end
%%Page: 16 22
TeXDict begin 16 21 bop 0 299 a Fi(16)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(Curren)m(tly)-8 b(,)31 b(supp)s(ort)e(for)i(large)h(\014les)f
(within)f(CFITSIO)f(has)i(b)s(een)f(tested)i(on)f(the)g(Lin)m(ux,)g
(Solaris,)g(and)f(IBM)0 668 y(AIX)g(op)s(erating)h(systems.)0
1133 y Fd(4.2)135 b(Multiple)46 b(Access)e(to)i(the)f(Same)g(FITS)f
(File)0 1409 y Fi(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 1522 y(Th)m(us,)43 b(one)e(can)h(op)s(en)e(the)h
(same)h(FITS)e(\014le)h(t)m(wice)i(within)d(a)i(single)f(program)g(and)
g(mo)m(v)m(e)h(to)g(2)f(di\013eren)m(t)0 1635 y(HDUs)30
b(in)f(the)h(\014le,)g(and)f(then)g(read)h(and)e(write)i(data)g(or)g(k)
m(eyw)m(ords)g(to)g(the)g(2)f(extensions)i(just)d(as)i(if)g(one)f(w)m
(ere)0 1748 y(accessing)f(2)f(completely)h(separate)f(FITS)f(\014les.)
39 b(Since)27 b(in)f(general)h(it)g(is)g(not)g(p)s(ossible)f(to)h(ph)m
(ysically)g(op)s(en)f(the)0 1861 y(same)36 b(\014le)g(t)m(wice)h(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)0 1974 y(to)e(2)f(di\013eren)m
(t)h(lo)s(cations)h(in)d(the)i(\014le,)g(CFITSIO)e(recognizes)j(when)d
(the)h(\014le)g(to)h(b)s(e)f(op)s(ened)f(\(in)h(the)h(call)g(to)0
2087 y(\014ts)p 127 2087 28 4 v 32 w(op)s(en)p 349 2087
V 33 w(\014le\))29 b(has)f(already)h(b)s(een)f(op)s(ened)g(and)g
(instead)h(of)g(actually)h(op)s(ening)e(the)h(\014le)g(again,)h(just)e
(logically)0 2199 y(links)i(the)h(new)f(\014le)h(to)g(the)g(old)f
(\014le.)42 b(\(This)30 b(only)h(applies)f(if)h(the)g(\014le)f(is)h(op)
s(ened)f(more)g(than)g(once)i(within)e(the)0 2312 y(same)e(program,)g
(and)f(do)s(es)h(not)f(prev)m(en)m(t)i(the)f(same)g(\014le)f(from)g(b)s
(eing)h(sim)m(ultaneously)g(op)s(ened)f(b)m(y)g(more)h(than)0
2425 y(one)h(program\).)40 b(Then)28 b(b)s(efore)g(CFITSIO)f(reads)h
(or)h(writes)g(to)g(either)g(\(logical\))j(\014le,)d(it)g(mak)m(es)h
(sure)d(that)j(an)m(y)0 2538 y(mo)s(di\014cations)i(made)f(to)h(the)g
(other)g(\014le)f(ha)m(v)m(e)i(b)s(een)e(completely)i(\015ushed)c(from)
i(the)h(in)m(ternal)g(bu\013ers)f(to)h(the)0 2651 y(\014le.)44
b(Th)m(us,)30 b(in)h(principle,)h(one)f(could)g(op)s(en)g(a)h(\014le)f
(t)m(wice,)i(in)e(one)h(case)g(p)s(oin)m(ting)g(to)g(the)f(\014rst)g
(extension)h(and)0 2764 y(in)i(the)h(other)g(p)s(oin)m(ting)f(to)i(the)
e(2nd)g(extension)i(and)d(then)i(write)f(data)i(to)f(b)s(oth)f
(extensions,)i(in)e(an)m(y)h(order,)0 2877 y(without)25
b(danger)h(of)f(corrupting)h(the)f(\014le,)i(There)e(ma)m(y)h(b)s(e)f
(some)h(e\016ciency)g(p)s(enalties)g(in)f(doing)h(this)f(ho)m(w)m(ev)m
(er,)0 2990 y(since)j(CFITSIO)f(has)h(to)h(\015ush)d(all)j(the)f(in)m
(ternal)h(bu\013ers)e(related)i(to)g(one)f(\014le)g(b)s(efore)g(switc)m
(hing)g(to)h(the)f(other,)0 3103 y(so)i(it)h(w)m(ould)f(still)h(b)s(e)f
(pruden)m(t)f(to)i(minimize)g(the)f(n)m(um)m(b)s(er)f(of)i(times)f(one)
h(switc)m(hes)g(bac)m(k)g(and)e(forth)h(b)s(et)m(w)m(een)0
3216 y(doing)g(I/O)h(to)g(di\013eren)m(t)g(HDUs)g(in)f(the)g(same)h
(\014le.)0 3680 y Fd(4.3)135 b(Curren)l(t)46 b(Header)f(Data)h(Unit)g
(\(CHDU\))0 3957 y Fi(In)32 b(general,)j(a)f(FITS)e(\014le)i(can)f(con)
m(tain)h(m)m(ultiple)g(Header)g(Data)h(Units,)f(also)g(called)g
(extensions.)49 b(CFITSIO)0 4070 y(only)38 b(op)s(erates)h(within)f
(one)g(HDU)h(at)g(an)m(y)g(giv)m(en)g(time,)i(and)d(the)g(curren)m(tly)
g(selected)i(HDU)f(is)f(called)i(the)0 4183 y(Curren)m(t)f(Header)h
(Data)h(Unit)f(\(CHDU\).)h(When)f(a)g(FITS)f(\014le)h(is)f(\014rst)g
(created)i(or)f(op)s(ened)f(the)h(CHDU)g(is)0 4295 y(automatically)28
b(de\014ned)23 b(to)j(b)s(e)e(the)h(\014rst)f(HDU)i(\(i.e.,)h(the)e
(primary)f(arra)m(y\).)40 b(CFITSIO)23 b(routines)i(are)g(pro)m(vided)0
4408 y(to)36 b(mo)m(v)m(e)h(to)g(and)e(op)s(en)g(an)m(y)h(other)g
(existing)g(HDU)h(within)e(the)h(FITS)f(\014le)g(or)h(to)g(app)s(end)e
(or)i(insert)f(a)h(new)0 4521 y(HDU)31 b(in)f(the)h(FITS)e(\014le)i
(whic)m(h)f(then)g(b)s(ecomes)h(the)f(CHDU.)0 4986 y
Fd(4.4)135 b(Subroutine)45 b(Names)0 5262 y Fi(All)26
b(FITSIO)f(subroutine)g(names)h(b)s(egin)f(with)h(the)g(letters)h('ft')
f(to)h(distinguish)e(them)h(from)f(other)h(subroutines)0
5375 y(and)34 b(are)h(5)g(or)f(6)h(c)m(haracters)h(long.)54
b(Users)34 b(should)g(not)g(name)h(their)g(o)m(wn)f(subroutines)f(b)s
(eginning)h(with)g('ft')0 5488 y(to)e(a)m(v)m(oid)i(con\015icts.)45
b(\(The)32 b(SPP)f(in)m(terface)i(routines)e(all)i(b)s(egin)e(with)h
('fs'\).)45 b(Subroutines)30 b(whic)m(h)h(read)h(or)g(get)0
5601 y(information)e(from)g(the)h(FITS)e(\014le)h(ha)m(v)m(e)i(names)e
(b)s(eginning)f(with)h('ftg...'.)43 b(Subroutines)28
b(whic)m(h)i(write)g(or)h(put)0 5714 y(information)g(in)m(to)g(the)g
(FITS)e(\014le)i(ha)m(v)m(e)g(names)g(b)s(eginning)e(with)h('ftp...'.)p
eop end
%%Page: 17 23
TeXDict begin 17 22 bop 0 299 a Fg(4.5.)72 b(SUBR)m(OUTINE)30
b(F)-10 b(AMILIES)30 b(AND)h(D)m(A)-8 b(T)g(A)g(TYPES)1697
b Fi(17)0 555 y Fd(4.5)135 b(Subroutine)45 b(F)-11 b(amilies)46
b(and)f(Datat)l(yp)t(es)0 805 y Fi(Man)m(y)h(of)g(the)g(subroutines)e
(come)j(in)e(families)h(whic)m(h)g(di\013er)f(only)h(in)f(the)h(datat)m
(yp)s(e)g(of)g(the)f(asso)s(ciated)0 918 y(parameter\(s\))34
b(.)47 b(The)32 b(datat)m(yp)s(e)i(of)f(these)g(subroutines)e(is)i
(indicated)g(b)m(y)g(the)g(last)g(letter)h(of)f(the)g(subroutine)0
1031 y(name)d(\(e.g.,)j('j')d(in)g('ftpkyj'\))h(as)f(follo)m(ws:)382
1284 y Fe(x)47 b(-)h(bit)382 1397 y(b)f(-)h(character*1)c(\(unsigned)i
(byte\))382 1510 y(i)h(-)h(short)e(integer)g(\(I*2\))382
1623 y(j)h(-)h(integer)e(\(I*4,)g(32-bit)g(integer\))382
1735 y(k)h(-)h(long)e(long)h(integer)f(\(I*8,)g(64-bit)g(integer\))382
1848 y(e)h(-)h(real)e(exponential)f(floating)h(point)g(\(R*4\))382
1961 y(f)h(-)h(real)e(fixed-format)f(floating)g(point)i(\(R*4\))382
2074 y(d)g(-)h(double)e(precision)f(real)i(floating-point)d(\(R*8\))382
2187 y(g)j(-)h(double)e(precision)f(fixed-format)g(floating)g(point)h
(\(R*8\))382 2300 y(c)h(-)h(complex)e(reals)g(\(pairs)g(of)h(R*4)g
(values\))382 2413 y(m)g(-)h(double)e(precision)f(complex)h(\(pairs)g
(of)h(R*8)g(values\))382 2526 y(l)g(-)h(logical)e(\(L*4\))382
2639 y(s)h(-)h(character)d(string)0 2891 y Fi(When)23
b(dealing)h(with)f(the)g(FITS)g(b)m(yte)g(datat)m(yp)s(e,)j(it)e(is)f
(imp)s(ortan)m(t)h(to)f(remem)m(b)s(er)g(that)h(the)f(ra)m(w)g(v)-5
b(alues)24 b(\(b)s(efore)0 3004 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
3117 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 3230 y(ranging)40 b(from)f(0)i(to)f(255.)71
b(Some)40 b(F)-8 b(ortran)40 b(compilers)h(supp)s(ort)d(a)i
(non-standard)f(b)m(yte)h(datat)m(yp)s(e)h(suc)m(h)f(as)0
3343 y(INTEGER*1,)34 b(LOGICAL*1,)g(or)f(BYTE,)g(whic)m(h)f(can)h
(sometimes)h(b)s(e)e(used)g(instead)h(of)g(CHARA)m(CTER*1)0
3456 y(v)-5 b(ariables.)39 b(Man)m(y)23 b(mac)m(hines)g(p)s(ermit)g
(passing)f(a)h(n)m(umeric)g(datat)m(yp)s(e)g(\(suc)m(h)g(as)g
(INTEGER*1\))h(to)f(the)g(FITSIO)0 3569 y(subroutines)41
b(whic)m(h)i(are)g(exp)s(ecting)g(a)g(CHARA)m(CTER*1)h(datat)m(yp)s(e,)
j(but)42 b(this)g(tec)m(hnically)j(violates)g(the)0 3682
y(F)-8 b(ortran-77)29 b(standard)d(and)g(is)h(not)g(supp)s(orted)e(on)i
(all)h(mac)m(hines)f(\(e.g.,)j(on)c(a)i(V)-10 b(AX/VMS)27
b(mac)m(hine)h(one)f(m)m(ust)0 3795 y(use)j(the)h(V)-10
b(AX-sp)s(eci\014c)31 b(\045DESCR)e(function\).)0 3955
y(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 4068 y(as)35 b(though)e(it)i(w)m(ere)g(a)g(`B')g(\(b)m(yte\))g
(column.)53 b(F)-8 b(or)35 b(example)g(a)f(`11X')i(datat)m(yp)s(e)f
(column)f(can)h(b)s(e)f(in)m(terpreted)0 4181 y(the)28
b(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 4294 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 4454 y(The)41 b(double)h(precision)g(complex)g
(datat)m(yp)s(e)h(is)f(not)g(a)g(standard)f(F)-8 b(ortran-77)43
b(datat)m(yp)s(e.)76 b(If)41 b(a)i(particular)0 4567
y(F)-8 b(ortran)35 b(compiler)g(do)s(es)f(not)h(directly)g(supp)s(ort)e
(this)i(datat)m(yp)s(e,)h(then)f(one)f(ma)m(y)h(instead)g(pass)f(an)h
(arra)m(y)g(of)0 4680 y(pairs)d(of)h(double)f(precision)h(v)-5
b(alues)32 b(to)i(these)f(subroutines.)45 b(The)33 b(\014rst)e(v)-5
b(alue)33 b(in)f(eac)m(h)i(pair)e(is)h(the)g(real)g(part,)0
4792 y(and)d(the)g(second)h(is)f(the)h(imaginary)g(part.)0
5125 y Fd(4.6)135 b(Implicit)46 b(Data)g(T)l(yp)t(e)f(Con)l(v)l(ersion)
0 5375 y Fi(The)22 b(FITSIO)g(routines)h(that)h(read)e(and)h(write)g(n)
m(umerical)g(data)h(can)f(p)s(erform)f(implicit)i(data)f(t)m(yp)s(e)g
(con)m(v)m(ersion.)0 5488 y(This)i(means)g(that)h(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)
f(do)s(es)g(not)h(need)g(to)g(b)s(e)f(the)h(same)0 5601
y(as)i(the)f(data)h(t)m(yp)s(e)g(of)f(the)h(v)-5 b(alue)28
b(in)f(the)g(FITS)g(\014le.)40 b(Data)28 b(t)m(yp)s(e)g(con)m(v)m
(ersion)h(is)e(supp)s(orted)f(for)h(n)m(umerical)h(and)0
5714 y(string)33 b(data)h(t)m(yp)s(es)f(\(if)h(the)g(string)f(con)m
(tains)h(a)g(v)-5 b(alid)33 b(n)m(um)m(b)s(er)f(enclosed)i(in)f
(quotes\))h(when)f(reading)g(a)h(FITS)p eop end
%%Page: 18 24
TeXDict begin 18 23 bop 0 299 a Fi(18)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(header)g(k)m(eyw)m(ord)g(v)-5 b(alue)31 b(and)g(for)f(n)m
(umeric)h(v)-5 b(alues)31 b(when)f(reading)h(or)g(writing)g(v)-5
b(alues)31 b(in)f(the)h(primary)f(arra)m(y)0 668 y(or)40
b(a)h(table)h(column.)70 b(CFITSIO)39 b(returns)h(status)g(=)h(NUM)p
2185 668 28 4 v 33 w(O)m(VERFLO)m(W)g(if)g(the)f(con)m(v)m(erted)i
(data)f(v)-5 b(alue)0 781 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
894 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 1054 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 1167 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 1496 y Fd(4.7)135 b(Data)46 b(Scaling)0 1746
y Fi(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 1859 y(scaled)f(automatically)j(b)m(y)c
(the)h(BSCALE)f(and)g(BZER)m(O)h(\(or)g(TSCALn)d(and)i(TZER)m(On\))g
(header)g(k)m(eyw)m(ord)0 1972 y(v)-5 b(alues)33 b(if)f(they)g(are)h
(presen)m(t)g(in)f(the)g(header.)47 b(The)31 b(scaled)j(data)f(that)g
(is)f(returned)f(to)i(the)g(reading)f(program)0 2085
y(will)f(ha)m(v)m(e)382 2316 y Fe(output)46 b(value)g(=)i(\(FITS)e
(value\))g(*)i(BSCALE)e(+)h(BZERO)0 2546 y Fi(\(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
2659 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
2772 y(rounded)38 b(to)i(the)g(nearest)g(in)m(teger\).)70
b(The)39 b(ftpscl)g(and)g(fttscl)i(subroutines)d(ma)m(y)i(b)s(e)f(used)
g(to)h(o)m(v)m(erride)h(the)0 2885 y(scaling)30 b(parameters)f
(de\014ned)e(in)h(the)h(header)f(\(e.g.,)j(to)e(turn)f(o\013)h(the)f
(scaling)i(so)f(that)g(the)g(program)f(can)h(read)0 2998
y(the)i(ra)m(w)f(unscaled)g(v)-5 b(alues)31 b(from)f(the)g(FITS)g
(\014le\).)0 3158 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 3271 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 3384 y(and)h(TZER)m(On\))g
(header)g(k)m(eyw)m(ord)h(v)-5 b(alues)31 b(if)g(they)g(they)g(exist)g
(in)f(the)h(header.)42 b(These)30 b(k)m(eyw)m(ords)h(m)m(ust)g(ha)m(v)m
(e)0 3497 y(b)s(een)f(written)h(to)h(the)g(header)e(b)s(efore)h(an)m(y)
h(data)f(is)g(written)h(for)e(them)i(to)f(ha)m(v)m(e)i(an)m(y)e
(e\013ect.)44 b(Otherwise,)32 b(one)0 3610 y(ma)m(y)i(use)f(the)g
(ftpscl)g(and)g(fttscl)h(subroutines)d(to)j(de\014ne)f(or)g(o)m(v)m
(erride)h(the)f(scaling)i(k)m(eyw)m(ords)e(in)g(the)g(header)0
3723 y(\(e.g.,)h(to)f(turn)d(o\013)j(the)f(scaling)h(so)f(that)g(the)g
(program)g(can)g(write)g(the)g(ra)m(w)g(unscaled)g(v)-5
b(alues)32 b(in)m(to)h(the)f(FITS)0 3836 y(\014le\).)43
b(If)30 b(scaling)i(is)f(p)s(erformed,)e(the)i(in)m(v)m(erse)h(scaled)g
(output)e(v)-5 b(alue)32 b(that)f(is)g(written)g(in)m(to)h(the)f(FITS)f
(\014le)h(will)0 3949 y(ha)m(v)m(e)430 4179 y Fe(FITS)46
b(value)h(=)g(\(\(input)f(value\))g(-)h(BZERO\))f(/)i(BSCALE)0
4410 y Fi(\(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 4523 y(Rounding)19 b(to)i(the)g(nearest)g(in)m(teger,)i
(rather)e(than)f(truncation,)j(is)d(p)s(erformed)f(when)g(writing)h(in)
m(teger)i(datat)m(yp)s(es)0 4636 y(to)31 b(the)g(FITS)e(\014le.)0
4965 y Fd(4.8)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 5215 y Fi(The)33
b(last)i(parameter)f(in)g(nearly)g(ev)m(ery)g(FITSIO)f(subroutine)g(is)
h(the)g(error)f(status)h(v)-5 b(alue)35 b(whic)m(h)e(is)h(b)s(oth)f(an)
0 5328 y(input)j(and)f(an)i(output)f(parameter.)60 b(A)36
b(returned)f(p)s(ositiv)m(e)j(v)-5 b(alue)37 b(for)f(this)h(parameter)g
(indicates)g(an)f(error)0 5441 y(w)m(as)31 b(detected.)42
b(A)30 b(listing)h(of)g(all)g(the)g(FITSIO)e(status)i(co)s(de)f(v)-5
b(alues)31 b(is)f(giv)m(en)i(at)f(the)f(end)g(of)h(this)f(do)s(cumen)m
(t.)0 5601 y(The)22 b(FITSIO)g(library)g(uses)h(an)f(`inherited)h
(status')g(con)m(v)m(en)m(tion)i(for)e(the)g(status)g(parameter)g(whic)
m(h)g(means)f(that)0 5714 y(if)i(a)h(subroutine)f(is)g(called)i(with)e
(a)h(p)s(ositiv)m(e)g(input)f(v)-5 b(alue)25 b(of)g(the)f(status)h
(parameter,)h(then)f(the)f(subroutine)g(will)p eop end
%%Page: 19 25
TeXDict begin 19 24 bop 0 299 a Fg(4.9.)72 b(V)-10 b(ARIABLE-LENGTH)31
b(ARRA)-8 b(Y)31 b(F)-10 b(A)m(CILITY)30 b(IN)h(BINAR)-8
b(Y)31 b(T)-8 b(ABLES)956 b Fi(19)0 555 y(exit)26 b(immediately)f
(without)g(c)m(hanging)h(the)e(v)-5 b(alue)25 b(of)g(the)g(status)g
(parameter.)39 b(Th)m(us,)25 b(if)g(one)f(passes)h(the)g(status)0
668 y(v)-5 b(alue)31 b(returned)e(from)h(eac)m(h)i(FITSIO)d(routine)h
(as)h(input)f(to)h(the)f(next)h(FITSIO)e(subroutine,)h(then)g(whenev)m
(er)0 781 y(an)39 b(error)g(is)h(detected)g(all)h(further)d(FITSIO)g
(pro)s(cessing)h(will)h(cease.)69 b(This)39 b(con)m(v)m(en)m(tion)i
(can)f(simplify)f(the)0 894 y(error)30 b(c)m(hec)m(king)j(in)d
(application)i(programs)f(b)s(ecause)g(it)g(is)g(not)g(necessary)g(to)g
(c)m(hec)m(k)i(the)e(v)-5 b(alue)31 b(of)g(the)g(status)0
1007 y(parameter)j(after)g(ev)m(ery)g(single)h(FITSIO)d(subroutine)g
(call.)52 b(If)33 b(a)h(program)f(con)m(tains)i(a)f(sequence)g(of)g
(sev)m(eral)0 1120 y(FITSIO)23 b(calls,)j(one)e(can)g(just)g(c)m(hec)m
(k)h(the)f(status)g(v)-5 b(alue)24 b(after)h(the)f(last)g(call.)40
b(Since)24 b(the)g(returned)e(status)j(v)-5 b(alues)0
1233 y(are)36 b(generally)h(distinctiv)m(e,)i(it)d(should)f(b)s(e)g(p)s
(ossible)g(to)h(determine)g(whic)m(h)f(subroutine)g(originally)i
(returned)0 1346 y(the)31 b(error)f(status.)0 1506 y(FITSIO)i(also)i
(main)m(tains)f(an)g(in)m(ternal)h(stac)m(k)g(of)f(error)g(messages)h
(\(80-c)m(haracter)i(maxim)m(um)d(length\))g(whic)m(h)0
1619 y(in)j(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 1732 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 1844 y(whenev)m(er)31
b(a)h(program)g(detects)g(a)g(FITSIO)e(error.)44 b(T)-8
b(o)32 b(do)f(this,)h(call)h(the)f(FTGMSG)g(routine)f(rep)s(eatedly)h
(to)0 1957 y(get)h(the)g(successiv)m(e)g(messages)h(on)e(the)g(stac)m
(k.)48 b(When)32 b(the)h(stac)m(k)g(is)g(empt)m(y)f(FTGMSG)h(will)g
(return)e(a)h(blank)0 2070 y(string.)41 b(Note)31 b(that)g(this)f(is)g
(a)g(`First)h(In)e({)i(First)f(Out')g(stac)m(k,)i(so)e(the)h(oldest)g
(error)e(message)j(is)e(returned)f(\014rst)0 2183 y(b)m(y)h(ftgmsg.)0
2557 y Fd(4.9)135 b(V)-11 b(ariable-Length)46 b(Arra)l(y)f(F)-11
b(acilit)l(y)46 b(in)f(Binary)g(T)-11 b(ables)0 2815
y Fi(FITSIO)38 b(pro)m(vides)i(easy-to-use)h(supp)s(ort)d(for)h
(reading)g(and)g(writing)h(data)g(in)f(v)-5 b(ariable)40
b(length)g(\014elds)f(of)h(a)0 2928 y(binary)35 b(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 3041 y(or)30 b(`1Qt\(len\)')h(where)f(`t')g(is)g(the)g
(datat)m(yp)s(e)h(co)s(de)f(\(e.g.,)i(I,)e(J,)f(E,)h(D,)h(etc.\))42
b(and)29 b(`len')h(is)g(an)g(in)m(teger)h(sp)s(ecifying)0
3154 y(the)f(maxim)m(um)g(length)g(of)g(the)g(v)m(ector)h(in)f(the)g
(table.)41 b(If)30 b(the)g(v)-5 b(alue)30 b(of)g(`len')g(is)g(not)g(sp)
s(eci\014ed)f(when)g(the)h(table)0 3267 y(is)j(created)g(\(e.g.,)i(if)e
(the)f(TF)m(ORM)h(k)m(eyw)m(ord)g(v)-5 b(alue)33 b(is)g(simply)f(sp)s
(eci\014ed)g(as)h('1PE')g(instead)g(of)f('1PE\(400\))j(\),)0
3380 y(then)28 b(FITSIO)f(will)h(automatically)k(scan)c(the)g(table)h
(when)f(it)g(is)h(closed)g(to)g(determine)f(the)g(maxim)m(um)h(length)0
3493 y(of)i(the)f(v)m(ector)i(and)e(will)h(app)s(end)d(this)j(v)-5
b(alue)30 b(to)i(the)e(TF)m(ORMn)g(v)-5 b(alue.)0 3653
y(The)25 b(same)h(routines)g(whic)m(h)f(read)h(and)f(write)h(data)g(in)
f(an)h(ordinary)f(\014xed)g(length)h(binary)f(table)h(extension)h(are)0
3766 y(also)k(used)e(for)h(v)-5 b(ariable)31 b(length)g(\014elds,)e(ho)
m(w)m(ev)m(er,)j(the)e(subroutine)f(parameters)i(tak)m(e)h(on)e(a)g
(sligh)m(tly)h(di\013eren)m(t)0 3878 y(in)m(terpretation)h(as)e
(describ)s(ed)g(b)s(elo)m(w.)0 4039 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
4152 y(main)26 b(\014xed-length)g(FITS)f(binary)h(table.)40
b(The)25 b(size)i(of)g(the)f(heap,)h(in)f(b)m(ytes,)h(is)f(sp)s
(eci\014ed)g(with)f(the)i(PCOUNT)0 4264 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
4377 y(usually)31 b(b)s(e)f(set)i(to)g(zero.)44 b(FITSIO)30
b(will)h(recompute)h(the)f(size)h(of)g(the)f(heap)g(as)g(the)h(data)g
(is)f(written)g(and)g(will)0 4490 y(automatically)d(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 4603
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 4716 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 4876 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 4989 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
5102 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 5215 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 5328 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
5441 y(mo)m(v)m(ed.)0 5601 y(When)40 b(writing)h(to)g(a)g(v)-5
b(ariable)41 b(length)g(\014eld,)i(the)e(en)m(tire)h(arra)m(y)f(of)f(v)
-5 b(alues)41 b(for)f(a)h(giv)m(en)h(ro)m(w)f(of)f(the)h(table)0
5714 y(m)m(ust)36 b(b)s(e)g(written)g(with)g(a)g(single)h(call)h(to)f
(FTPCLx.)57 b(The)36 b(total)i(length)f(of)f(the)g(arra)m(y)h(is)f
(calculated)i(from)p eop end
%%Page: 20 26
TeXDict begin 20 25 bop 0 299 a Fi(20)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(\(NELEM+FELEM-1\).)44 b(One)30 b(cannot)i(app)s(end)d(more)i
(elemen)m(ts)h(to)g(an)e(existing)i(\014eld)f(at)g(a)h(later)g(time;)g
(an)m(y)0 668 y(attempt)j(to)f(do)g(so)g(will)g(simply)f(o)m(v)m
(erwrite)j(all)e(the)g(data)h(whic)m(h)e(w)m(as)h(previously)g
(written.)51 b(Note)35 b(also)f(that)0 781 y(the)g(new)g(data)g(will)h
(b)s(e)e(written)h(to)h(a)f(new)g(area)g(of)g(the)h(heap)e(and)h(the)g
(heap)g(space)g(used)f(b)m(y)h(the)g(previous)0 894 y(write)j(cannot)h
(b)s(e)e(reclaimed.)62 b(F)-8 b(or)38 b(this)f(reason)g(it)h(is)f
(advised)g(that)h(eac)m(h)g(ro)m(w)f(of)h(a)f(v)-5 b(ariable)38
b(length)f(\014eld)0 1007 y(only)c(b)s(e)g(written)g(once.)50
b(An)33 b(exception)h(to)g(this)f(general)h(rule)f(o)s(ccurs)g(when)f
(setting)i(elemen)m(ts)h(of)e(an)g(arra)m(y)0 1120 y(as)38
b(unde\014ned.)63 b(One)37 b(m)m(ust)i(\014rst)e(write)h(a)h(dumm)m(y)e
(v)-5 b(alue)39 b(in)m(to)g(the)g(arra)m(y)f(with)g(FTPCLx,)i(and)e
(then)g(call)0 1233 y(FTPCLU)33 b(to)i(\015ag)f(the)f(desired)h(elemen)
m(ts)h(as)e(unde\014ned.)49 b(\(Do)35 b(not)f(use)f(the)h(FTPCNx)f
(family)h(of)g(routines)0 1346 y(with)28 b(v)-5 b(ariable)30
b(length)f(\014elds\).)40 b(Note)30 b(that)f(the)g(ro)m(ws)g(of)g(a)g
(table,)h(whether)e(\014xed)g(or)h(v)-5 b(ariable)29
b(length,)h(do)f(not)0 1458 y(ha)m(v)m(e)j(to)f(b)s(e)e(written)i
(consecutiv)m(ely)h(and)e(ma)m(y)h(b)s(e)f(written)g(in)g(an)m(y)h
(order.)0 1619 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
1732 y(c)m(haracter)33 b(string)f(written.)44 b(FTPCLS)30
b(writes)i(the)g(whole)f(length)h(of)g(the)g(input)e(string)i(\(min)m
(us)f(an)m(y)h(trailing)0 1844 y(blank)37 b(c)m(haracters\),)42
b(th)m(us)37 b(the)h(NELEM)f(and)g(FELEM)h(parameters)g(are)g(ignored.)
62 b(If)37 b(the)h(input)e(string)i(is)0 1957 y(completely)28
b(blank)f(then)f(FITSIO)g(will)h(write)g(one)g(blank)f(c)m(haracter)j
(to)e(the)g(FITS)f(\014le.)40 b(Similarly)-8 b(,)28 b(FTGCVS)0
2070 y(and)35 b(FTGCFS)g(read)g(the)h(en)m(tire)g(string)g(\(truncated)
f(to)i(the)e(width)g(of)g(the)h(c)m(haracter)h(string)e(argumen)m(t)h
(in)0 2183 y(the)31 b(subroutine)e(call\))j(and)e(also)h(ignore)g(the)f
(NELEM)h(and)f(FELEM)g(parameters.)0 2343 y(The)35 b(FTPDES)h
(subroutine)e(is)i(useful)f(in)g(situations)i(where)e(m)m(ultiple)i(ro)
m(ws)e(of)h(a)g(v)-5 b(ariable)37 b(length)f(column)0
2456 y(ha)m(v)m(e)c(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 2569 y(use)36
b(FTPDES)g(to)h(write)g(the)f(same)h(descriptor)g(v)-5
b(alues)36 b(in)m(to)i(the)e(other)h(ro)m(ws)f(\(use)h(the)f(FTGDES)h
(routine)0 2682 y(to)f(read)f(the)h(\014rst)f(descriptor)g(v)-5
b(alue\);)39 b(all)d(the)g(ro)m(ws)f(will)h(then)f(p)s(oin)m(t)g(to)h
(the)g(same)f(storage)i(lo)s(cation)g(th)m(us)0 2795
y(sa)m(ving)31 b(disk)f(space.)0 2955 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
3068 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 3181 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 3294 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
3407 y(of)e(a)f(v)-5 b(ariable)31 b(column)g(with)f(the)g(FTGDES)h
(subroutine.)0 3859 y Fd(4.10)136 b(Supp)t(ort)44 b(for)h(IEEE)g(Sp)t
(ecial)h(V)-11 b(alues)0 4133 y Fi(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
4246 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 4359 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 4472 y(v)-5 b(alues\).)41
b(The)30 b(FITSIO)f(subroutines)g(that)i(read)f(\015oating)i(p)s(oin)m
(t)e(data)h(in)f(FITS)f(\014les)i(recognize)h(these)f(IEEE)0
4585 y(sp)s(ecial)40 b(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
4698 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 4811 y(ma)m(y)d(w)m(an)m(t)g
(access)g(to)g(the)g(ra)m(w)f(IEEE)g(v)-5 b(alues,)32
b(without)f(an)m(y)h(mo)s(di\014cation)f(b)m(y)g(FITSIO.)g(This)f(can)i
(b)s(e)e(done)0 4924 y(b)m(y)k(calling)j(the)d(FTGPVx)h(or)g(FTGCVx)g
(routines)f(while)h(sp)s(ecifying)f(0.0)i(as)f(the)f(v)-5
b(alue)35 b(of)g(the)g(NULL)-10 b(V)g(AL)0 5036 y(parameter.)72
b(This)39 b(will)i(force)g(FITSIO)e(to)j(simply)e(pass)g(the)g(IEEE)g
(v)-5 b(alues)41 b(through)f(to)h(the)g(application)0
5149 y(program,)30 b(without)g(an)m(y)g(mo)s(di\014cation.)41
b(This)30 b(do)s(es)f(not)h(w)m(ork)g(for)g(double)g(precision)g(v)-5
b(alues)30 b(on)g(V)-10 b(AX/VMS)0 5262 y(mac)m(hines,)38
b(ho)m(w)m(ev)m(er,)h(where)d(there)g(is)g(no)g(easy)g(w)m(a)m(y)h(to)g
(b)m(ypass)f(the)g(default)g(in)m(terpretation)h(of)f(the)h(IEEE)0
5375 y(sp)s(ecial)45 b(v)-5 b(alues.)83 b(This)44 b(is)h(also)g(not)g
(supp)s(orted)d(when)i(reading)h(\015oating-p)s(oin)m(t)g(images)h
(that)f(ha)m(v)m(e)h(b)s(een)0 5488 y(compressed)29 b(with)h(the)f
(FITS)g(tiled)i(image)f(compression)g(con)m(v)m(en)m(tion)i(that)e(is)g
(discussed)e(in)i(section)h(5.6;)g(the)0 5601 y(pixels)k(v)-5
b(alues)35 b(in)g(tile)g(compressed)g(images)h(are)f(represen)m(ted)g
(b)m(y)f(scaled)i(in)m(tegers,)h(and)d(a)i(reserv)m(ed)f(in)m(teger)0
5714 y(v)-5 b(alue)31 b(\(not)g(a)g(NaN\))g(is)f(used)g(to)h(represen)m
(t)g(unde\014ned)d(pixels.)p eop end
%%Page: 21 27
TeXDict begin 21 26 bop 0 299 a Fg(4.11.)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 Fi(21)0 555 y Fd(4.11)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 805 y Fi(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
918 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 1031 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 1144 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 1257 y(the)31 b(NAXISn)e(v)-5 b(alue)31
b(should)f(b)s(e)g(up)s(dated)f(using)h(the)h(\014ts)p
2051 1257 28 4 v 62 w(up)s(date)p 2389 1257 V 32 w(k)m(ey)h(routine)e
(b)s(efore)g(mo)m(ving)i(to)f(another)0 1370 y(extension)g(or)f
(closing)i(the)e(FITS)g(\014le.)0 1530 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 1643 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 1756 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 1869 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
2029 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 2142 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 2255
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 2368 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 2481 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 2594 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 2706 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 2819 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 2932 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
3045 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 3158 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
3271 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
3384 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 3497 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
3610 y(closing)e(the)g(table.)0 3941 y Fd(4.12)136 b(Lo)t(cal)45
b(FITS)e(Con)l(v)l(en)l(tions)k(supp)t(orted)d(b)l(y)h(FITSIO)0
4191 y Fi(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 4304 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 4417 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
4530 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 4642 y(in)m(terface.)0 4930 y Fb(4.12.1)113
b(Supp)s(ort)37 b(for)h(Long)g(String)f(Keyw)m(ord)h(V)-9
b(alues.)0 5149 y Fi(The)23 b(length)i(of)f(a)g(standard)f(FITS)g
(string)h(k)m(eyw)m(ord)g(is)g(limited)h(to)f(68)h(c)m(haracters)g(b)s
(ecause)f(it)g(m)m(ust)g(\014t)g(en)m(tirely)0 5262 y(within)35
b(a)h(single)h(FITS)e(header)h(k)m(eyw)m(ord)g(record.)57
b(In)35 b(some)h(instances)g(it)h(is)e(necessary)i(to)f(enco)s(de)g
(strings)0 5375 y(longer)27 b(than)f(this)g(limit,)i(so)e(FITSIO)f
(supp)s(orts)f(a)j(lo)s(cal)g(con)m(v)m(en)m(tion)h(in)e(whic)m(h)g
(the)g(string)g(v)-5 b(alue)27 b(is)f(con)m(tin)m(ued)0
5488 y(o)m(v)m(er)34 b(m)m(ultiple)g(k)m(eyw)m(ords.)49
b(This)32 b(con)m(tin)m(uation)j(con)m(v)m(en)m(tion)h(uses)c(an)h(amp)
s(ersand)f(c)m(haracter)i(at)g(the)f(end)g(of)0 5601
y(eac)m(h)c(substring)d(to)i(indicate)h(that)f(it)g(is)g(con)m(tin)m
(ued)g(on)f(the)h(next)g(k)m(eyw)m(ord,)h(and)d(the)i(con)m(tin)m
(uation)i(k)m(eyw)m(ords)0 5714 y(all)44 b(ha)m(v)m(e)h(the)f(name)f
(CONTINUE)g(without)g(an)h(equal)g(sign)f(in)g(column)h(9.)80
b(The)43 b(string)h(v)-5 b(alue)43 b(ma)m(y)i(b)s(e)p
eop end
%%Page: 22 28
TeXDict begin 22 27 bop 0 299 a Fi(22)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(con)m(tin)m(ued)e(in)f(this)h(w)m(a)m(y)g(o)m(v)m(er)h(as)e
(man)m(y)h(additional)g(CONTINUE)f(k)m(eyw)m(ords)g(as)h(is)f
(required.)40 b(The)27 b(follo)m(wing)0 668 y(lines)k(illustrate)g
(this)f(con)m(tin)m(uation)j(con)m(v)m(en)m(tion)f(whic)m(h)e(is)h
(used)e(in)h(the)h(v)-5 b(alue)31 b(of)f(the)h(STRKEY)e(k)m(eyw)m(ord:)
0 920 y Fe(LONGSTRN=)45 b('OGIP)i(1.0')524 b(/)47 b(The)g(OGIP)g(Long)f
(String)g(Convention)f(may)i(be)g(used.)0 1033 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 1146 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 1259 y(CONTINUE)e('FITS)47 b(header.')e(/)j(This)e(is)h(another)f
(optional)g(comment.)0 1511 y Fi(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 1624 y(that)f(uses)e(this)h
(longstring)h(con)m(v)m(en)m(tion.)42 b(A)27 b(subroutine)f(called)i
(FTPLSW)f(has)g(b)s(een)f(pro)m(vided)h(in)f(CFITSIO)0
1737 y(to)31 b(write)g(this)f(k)m(eyw)m(ord)h(if)f(it)h(do)s(es)f(not)h
(already)g(exist.)0 1897 y(This)23 b(long)i(string)g(con)m(v)m(en)m
(tion)h(is)e(supp)s(orted)f(b)m(y)h(the)g(follo)m(wing)i(FITSIO)d
(subroutines)g(that)i(deal)g(with)f(string-)0 2010 y(v)-5
b(alued)30 b(k)m(eyw)m(ords:)286 2262 y Fe(ftgkys)46
b(-)i(read)f(a)g(string)f(keyword)286 2375 y(ftpkls)g(-)i(write)e
(\(append\))g(a)h(string)f(keyword)286 2488 y(ftikls)g(-)i(insert)e(a)h
(string)g(keyword)286 2601 y(ftmkls)f(-)i(modify)e(the)h(value)f(of)h
(an)h(existing)d(string)h(keyword)286 2714 y(ftukls)g(-)i(update)e(an)h
(existing)f(keyword,)f(or)i(write)g(a)g(new)g(keyword)286
2827 y(ftdkey)f(-)i(delete)e(a)h(keyword)0 3079 y Fi(These)41
b(routines)f(will)h(transparen)m(tly)g(read,)j(write,)g(or)d(delete)h
(a)f(long)g(string)g(v)-5 b(alue)41 b(in)g(the)g(FITS)f(\014le,)k(so)0
3192 y(programmers)36 b(in)g(general)h(do)f(not)h(ha)m(v)m(e)g(to)g(b)s
(e)f(concerned)g(ab)s(out)g(the)g(details)i(of)e(the)h(con)m(v)m(en)m
(tion)h(that)f(is)0 3304 y(used)32 b(to)i(enco)s(de)f(the)g(long)g
(string)g(in)g(the)g(FITS)f(header.)48 b(When)33 b(reading)g(a)g(long)h
(string,)g(one)f(m)m(ust)g(ensure)0 3417 y(that)h(the)f(c)m(haracter)i
(string)f(parameter)g(used)e(in)h(these)h(subroutine)e(calls)j(has)e(b)
s(een)f(declared)i(long)g(enough)0 3530 y(to)d(hold)f(the)h(en)m(tire)g
(string,)g(otherwise)f(the)h(returned)e(string)h(v)-5
b(alue)31 b(will)g(b)s(e)f(truncated.)0 3690 y(Note)d(that)e(the)h
(more)f(commonly)h(used)e(FITSIO)g(subroutine)h(to)h(write)f(string)g
(v)-5 b(alued)25 b(k)m(eyw)m(ords)h(\(FTPKYS\))0 3803
y(do)s(es)38 b(NOT)g(supp)s(ort)f(this)h(long)h(string)g(con)m(v)m(en)m
(tion)h(and)e(only)h(supp)s(orts)d(strings)i(up)g(to)h(68)g(c)m
(haracters)h(in)0 3916 y(length.)i(This)30 b(has)g(b)s(een)g(done)h
(delib)s(erately)g(to)h(prev)m(en)m(t)f(programs)g(from)f(inadv)m
(erten)m(tly)i(writing)f(k)m(eyw)m(ords)0 4029 y(using)38
b(this)h(non-standard)e(con)m(v)m(en)m(tion)k(without)e(the)f(explicit)
i(in)m(ten)m(t)g(of)f(the)g(programmer)f(or)h(user.)64
b(The)0 4142 y(FTPKLS)28 b(subroutine)g(m)m(ust)h(b)s(e)g(called)h
(instead)g(to)g(write)f(long)h(strings.)40 b(This)28
b(routine)i(can)f(also)h(b)s(e)f(used)f(to)0 4255 y(write)j(ordinary)e
(string)i(v)-5 b(alues)30 b(less)h(than)f(68)h(c)m(haracters)h(in)e
(length.)0 4544 y Fb(4.12.2)113 b(Arra)m(ys)37 b(of)g(Fixed-Length)j
(Strings)e(in)f(Binary)h(T)-9 b(ables)0 4763 y Fi(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 4876 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
4989 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 5102 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 5262 y(FITSIO)40
b(also)i(supp)s(orts)d(a)i(lo)s(cal)h(con)m(v)m(en)m(tion)h(for)e(the)g
(format)h(of)f(the)g(TF)m(ORMn)g(k)m(eyw)m(ord)g(v)-5
b(alue)42 b(of)f(the)0 5375 y(form)h('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 5488 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
5601 y(example,)47 b(TF)m(ORM1)d(=)f('120A10')j(w)m(ould)d(indicate)h
(that)f(the)h(binary)e(table)i(column)f(is)g(120)h(c)m(haracters)0
5714 y(wide)32 b(and)g(consists)h(of)g(12)g(10-c)m(haracter)i(length)e
(strings.)47 b(This)31 b(con)m(v)m(en)m(tion)k(is)d(recognized)i(b)m(y)
e(the)h(FITSIO)p eop end
%%Page: 23 29
TeXDict begin 23 28 bop 0 299 a Fg(4.12.)73 b(LOCAL)29
b(FITS)h(CONVENTIONS)f(SUPPOR)-8 b(TED)29 b(BY)i(FITSIO)1168
b Fi(23)0 555 y(subroutines)40 b(that)h(read)g(or)g(write)g(strings)f
(in)h(binary)f(tables.)73 b(The)40 b(Binary)h(T)-8 b(able)42
b(de\014nition)e(do)s(cumen)m(t)0 668 y(sp)s(eci\014es)31
b(that)i(other)e(optional)i(c)m(haracters)g(ma)m(y)g(follo)m(w)g(the)e
(datat)m(yp)s(e)i(co)s(de)f(in)f(the)h(TF)m(ORM)g(k)m(eyw)m(ord,)h(so)0
781 y(this)j(lo)s(cal)i(con)m(v)m(en)m(tion)h(is)e(in)f(compliance)i
(with)e(the)h(FITS)f(standard,)h(although)g(other)g(FITS)f(readers)h
(are)0 894 y(not)31 b(required)e(to)i(recognize)h(this)f(con)m(v)m(en)m
(tion.)0 1054 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 1167 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 1280 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 1393 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(FITSIO)29
b(do)s(es)h(not)h(curren)m(tly)f(supp)s(ort)f(this)h(prop)s(osal.)0
1687 y Fb(4.12.3)113 b(Keyw)m(ord)37 b(Units)h(Strings)0
1907 y Fi(One)f(de\014ciency)h(of)g(the)g(curren)m(t)g(FITS)f(Standard)
f(is)i(that)h(it)f(do)s(es)f(not)h(de\014ne)f(a)i(sp)s(eci\014c)e(con)m
(v)m(en)m(tion)j(for)0 2020 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
2133 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 2246 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 2359 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 2519 y(T)-8 b(o)28 b(solv)m(e)h(this)e(de\014ciency)-8
b(,)30 b(FITSIO)c(uses)h(a)h(lo)s(cal)h(con)m(v)m(en)m(tion)h(in)d
(whic)m(h)g(the)h(k)m(eyw)m(ord)g(units)f(are)h(enclosed)g(in)0
2632 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
2745 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 2858 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
3121 y Fe(EXPOSURE=)713 b(1800.0)47 b(/)g([s])g(elapsed)f(exposure)f
(time)0 3234 y(V_HELIO)h(=)763 b(16.23)47 b(/)g([km)g(s**\(-1\)])e
(heliocentric)g(velocity)0 3347 y(LAMBDA)94 b(=)763 b(5400.)47
b(/)g([angstrom])e(central)h(wavelength)0 3460 y(FLUX)190
b(=)47 b(4.9033487787637465E-30)42 b(/)47 b([J/cm**2/s])e(average)h
(flux)0 3723 y Fi(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 3836 y(tion)j(that)g(the)f(preferred)g(unit)f(for)i
(angle)g(is)f('deg')i(for)e(degrees.)0 3996 y(The)24
b(FTPUNT)g(and)g(FTGUNT)h(subroutines)f(in)g(FITSIO)f(write)i(and)f
(read,)i(resp)s(ectiv)m(ely)-8 b(,)28 b(the)c(k)m(eyw)m(ord)h(unit)0
4109 y(strings)30 b(in)g(an)h(existing)g(k)m(eyw)m(ord.)0
4403 y Fb(4.12.4)113 b(HIERAR)m(CH)34 b(Con)m(v)m(en)m(tion)k(for)f
(Extended)h(Keyw)m(ord)f(Names)0 4623 y Fi(CFITSIO)k(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 4736 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 4849 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 4962
y(FITS)30 b(k)m(eyw)m(ord)g(suc)m(h)h(as:)0 5225 y Fe(HIERARCH)46
b(ESO)g(INS)h(FOCU)g(POS)g(=)g(-0.00002500)e(/)j(Focus)e(position)0
5488 y Fi(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 5601 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 Fi(in)h(this)g(example\))h(b)s(e-)0 5714 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)p eop end
%%Page: 24 30
TeXDict begin 24 29 bop 0 299 a Fi(24)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(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 668 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
781 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 941 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 1054 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 1296 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
1409 y(HIERARCH)g(XTE$TEMP)f(=)j(98.6)e(/)i(Keyword)d(contains)h(the)h
('$')g(character)0 1522 y(HIERARCH)f(Earth)g(is)h(a)h(star)e(=)i(F)f(/)
h(Keyword)d(contains)h(embedded)f(spaces)0 1764 y Fi(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
1877 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 1990 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 2103 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 2216 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 2328 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 2441 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 2554 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 2667 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
2780 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 2893 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
3006 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 3119 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 3232 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
3345 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 3458 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 3788 y Fd(4.13)136
b(Optimizing)45 b(Co)t(de)g(for)h(Maxim)l(um)f(Pro)t(cessing)g(Sp)t
(eed)0 4039 y Fi(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 4152 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
4264 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 4377 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 4538 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 4650 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 4763
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 4876 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 4989 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
5102 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 5215 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 5328 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 5488 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 5601 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
5714 y(that)e(uses)f(CFITSIO.)p eop end
%%Page: 25 31
TeXDict begin 25 30 bop 0 299 a Fg(4.13.)73 b(OPTIMIZING)29
b(CODE)h(F)m(OR)h(MAXIMUM)g(PR)m(OCESSING)f(SPEED)971
b Fi(25)0 555 y Fb(4.13.1)113 b(Bac)m(kground)38 b(Information:)50
b(Ho)m(w)37 b(CFITSIO)h(Manages)h(Data)f(I/O)0 776 y
Fi(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 889 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 1002 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 1115 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 1228
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 1341 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
1454 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 1567 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
1680 y(NIOBUF)f(parameter)g(\(in)f(\014tsio2.h\))h(and)f(is)h(curren)m
(tly)f(set)h(to)g(40.)0 1840 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
1953 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)0 2066 y(load)g(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
2179 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 2291 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
2404 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 2565 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
2677 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 2790 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 2903 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
3016 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 3129 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
3242 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 3355 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 3468 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
3581 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
3741 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 3854 y(no)m(w)36 b(b)s(e)g(apparen)m(t:)52
b(when)35 b(dealing)i(with)f(FITS)g(images,)j(read)d(or)g(write)g
(large)i(c)m(h)m(unks)e(of)g(data)h(at)g(a)f(time)0 3967
y(so)30 b(that)h(the)f(direct)h(IO)e(mec)m(hanism)h(will)h(b)s(e)e(in)m
(v)m(ok)m(ed;)j(when)d(accessing)j(FITS)d(headers)h(or)g(FITS)f
(tables,)i(on)0 4080 y(the)k(other)g(hand,)g(once)g(a)g(particular)h
(FITS)e(blo)s(c)m(k)h(has)f(b)s(een)g(loading)i(in)m(to)g(one)f(of)g
(the)f(IO)h(bu\013ers,)g(try)f(to)0 4193 y(access)39
b(all)f(the)f(needed)g(information)h(in)f(that)h(blo)s(c)m(k)g(b)s
(efore)f(it)h(gets)g(\015ushed)d(out)j(of)g(the)f(IO)g(bu\013er.)60
b(It)38 b(is)0 4305 y(imp)s(ortan)m(t)31 b(to)h(a)m(v)m(oid)g(the)f
(situation)h(where)f(the)g(same)g(FITS)f(blo)s(c)m(k)i(is)f(b)s(eing)f
(read)h(then)g(\015ushed)e(from)h(a)h(IO)0 4418 y(bu\013er)e(m)m
(ultiple)i(times.)0 4578 y(The)f(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 4881 y Fb(4.13.2)113 b(Optimization)38
b(Strategies)0 5102 y Fi(1.)43 b(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 5215 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 5328 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 5441 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 5554 y(with)c(x86)h(CPUs\).)0 5714
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)p
eop end
%%Page: 26 32
TeXDict begin 26 31 bop 0 299 a Fi(26)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(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 668 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
781 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 894 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 1007 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
1120 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 1386 y Fe(>)96 b(./configure)44
b(--enable-ssse3)0 1652 y Fi(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 1765 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
1878 y(not)e(supp)s(ort)d(them.)0 2038 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
2151 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 2151 28 4 v 34 w(64)h(CPUs)f(with)h(64-bit)0 2264
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 2377 y(x86)p 143 2377 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
2490 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 2756 y Fe(./configure)45 b(--enable-sse2)0
3022 y Fi(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
3135 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 3248 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 3361 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
3474 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 3587 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
3747 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 3860 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 3973 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
4086 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 4199 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 4312
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 4425 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 4538 y(of)g(the)f(increased)h
(sw)m(apping)f(of)g(virtual)h(memory)f(to)h(disk.)0 4698
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 4811 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 4924 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
5036 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 5149 y(3)h(passes)f(through)f(the)i(\014le)f(whic)m(h)g
(could)h(triple)f(the)h(execution)g(time)g(of)g(an)f(I/O)g(limited)h
(program.)38 b(F)-8 b(or)25 b(small)0 5262 y(tables)31
b(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
5375 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 5488 y(of)g(the)g(table)h(as)f(will)h
(\014t)e(in)m(to)i(the)g(a)m(v)-5 b(ailable)31 b(in)m(ternal)f(I/O)f
(bu\013ers,)f(then)h(access)h(all)g(the)f(necessary)g(columns)0
5601 y(of)i(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 5714 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)p
eop end
%%Page: 27 33
TeXDict begin 27 32 bop 0 299 a Fg(4.13.)73 b(OPTIMIZING)29
b(CODE)h(F)m(OR)h(MAXIMUM)g(PR)m(OCESSING)f(SPEED)971
b Fi(27)0 555 y(w)m(a)m(y)28 b(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
668 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 781 y(once.)0 941
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 1054 y(the)j(table)h(ro)m(w,)g(on)f(the)g(n)m(um)m
(b)s(er)f(of)h(I/O)g(bu\013ers)f(that)i(ha)m(v)m(e)g(b)s(een)e(allo)s
(cated)j(in)e(FITSIO,)f(and)h(also)h(on)f(the)0 1167
y(n)m(um)m(b)s(er)27 b(of)i(other)f(FITS)g(\014les)g(that)h(are)g(op)s
(en)f(at)h(the)g(same)g(time)g(\(since)g(one)g(I/O)f(bu\013er)f(is)i
(alw)m(a)m(ys)h(reserv)m(ed)0 1280 y(for)k(eac)m(h)h(op)s(en)f(FITS)f
(\014le\).)53 b(F)-8 b(ortunately)g(,)37 b(a)e(FITSIO)e(routine)h(is)h
(a)m(v)-5 b(ailable)36 b(that)f(will)f(return)g(the)g(optimal)0
1393 y(n)m(um)m(b)s(er)e(of)i(ro)m(ws)g(for)g(a)g(giv)m(en)g(table:)49
b(call)35 b(ftgrsz\(unit,)g(nro)m(ws,)f(status\).)52
b(It)34 b(is)g(not)g(critical)h(to)g(use)e(exactly)0
1506 y(the)f(v)-5 b(alue)32 b(of)f(nro)m(ws)g(returned)g(b)m(y)g(this)g
(routine,)h(as)g(long)g(as)g(one)g(do)s(es)f(not)h(exceed)g(it.)45
b(Using)32 b(a)g(v)m(ery)f(small)0 1619 y(v)-5 b(alue)32
b(ho)m(w)m(ev)m(er)i(can)e(also)h(lead)f(to)h(p)s(o)s(or)e(p)s
(erformance)g(b)s(ecause)h(of)g(the)g(o)m(v)m(erhead)h(from)f(the)g
(larger)g(n)m(um)m(b)s(er)0 1732 y(of)f(subroutine)e(calls.)0
1892 y(The)36 b(optimal)h(n)m(um)m(b)s(er)f(of)g(ro)m(ws)h(returned)e
(b)m(y)h(ftgrsz)h(is)g(v)-5 b(alid)37 b(only)f(as)h(long)g(as)g(the)f
(application)i(program)0 2005 y(is)c(only)h(reading)g(or)f(writing)g
(data)h(in)g(the)f(sp)s(eci\014ed)g(table.)54 b(An)m(y)34
b(other)h(calls)g(to)g(access)h(data)f(in)f(the)h(table)0
2118 y(header)26 b(w)m(ould)f(cause)i(additional)f(blo)s(c)m(ks)h(of)f
(data)g(to)h(b)s(e)e(loaded)h(in)m(to)h(the)f(I/O)g(bu\013ers)f
(displacing)h(data)g(from)0 2230 y(the)j(original)h(table,)g(and)e
(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)g(read)h(or)0
2343 y(written.)0 2503 y(4.)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 2616 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
2729 y(parsing)30 b(the)h(ASCI)s(I)f(data)h(\014elds,)g(and)f(b)s
(ecause)h(ASCI)s(I)e(tables)i(are)g(ab)s(out)g(t)m(wice)h(as)f(large)h
(as)f(binary)f(tables)0 2842 y(with)g(the)h(same)f(information)h(con)m
(ten)m(t.)0 3002 y(5.)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 3115 y(o)s(ccur)33 b(in)g(the)g
(\014le.)49 b(When)32 b(reading)i(k)m(eyw)m(ords,)g(FITSIO)e(searc)m
(hes)i(forw)m(ard)e(starting)i(from)e(the)i(p)s(osition)f(of)0
3228 y(the)c(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 3341 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
3454 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 3567 y(I/O)g(bu\013ers,)h(then)f
(the)h(header)f(k)m(eyw)m(ord)h(access)h(will)e(b)s(e)g(v)m(ery)h(fast)
g(and)f(it)h(mak)m(es)g(little)h(di\013erence)f(whic)m(h)0
3680 y(order)c(they)g(are)h(accessed.)0 3840 y(6.)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 3953 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 4066 y(data.)60 b(In)36 b(some)i(cases)f(it)g(ma)m
(y)h(b)s(e)e(more)h(e\016cien)m(t)h(to)f(temp)s(orarily)g(turn)f(o\013)
h(the)g(scaling)h(\(using)e(ftpscl)h(or)0 4179 y(fttscl\))32
b(and)d(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 4339 y(7.)40
b(Av)m(oid)27 b(using)g(the)g('implicit)h(datat)m(yp)s(e)f(con)m(v)m
(ersion')h(capabilit)m(y)h(in)d(FITSIO.)g(F)-8 b(or)28
b(instance,)g(when)e(reading)0 4452 y(a)f(FITS)e(image)j(with)e(BITPIX)
g(=)g(-32)i(\(32-bit)g(\015oating)f(p)s(oin)m(t)f(pixels\),)j(read)d
(the)h(data)g(in)m(to)g(a)g(single)g(precision)0 4565
y(\015oating)e(p)s(oin)m(t)e(data)i(arra)m(y)f(in)g(the)g(program.)37
b(F)-8 b(orcing)23 b(FITSIO)e(to)h(con)m(v)m(ert)i(the)e(data)g(to)h(a)
f(di\013eren)m(t)g(datat)m(yp)s(e)0 4678 y(can)31 b(signi\014can)m(tly)
g(slo)m(w)g(the)g(program.)0 4838 y(8.)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
4951 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 5064 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
5176 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 5289 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 5402 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
5515 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 5628
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)p eop end
%%Page: 28 34
TeXDict begin 28 33 bop 0 299 a Fi(28)1277 b Fg(CHAPTER)29
b(4.)72 b(FITSIO)29 b(CONVENTIONS)g(AND)i(GUIDELINES)0
555 y Fi(CFITSIO)e(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 715 y(9.)52 b(Av)m(oid)35 b(the)g(use)e(of)i(v)-5
b(ariable)34 b(length)h(v)m(ector)h(columns)d(in)h(binary)g(tables,)i
(since)e(an)m(y)h(reading)f(or)g(writing)0 828 y(of)f(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
941 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
1101 y(10.)39 b(When)24 b(cop)m(ying)h(data)f(from)f(one)i(FITS)e
(table)h(to)h(another,)g(it)g(is)f(faster)g(to)g(transfer)f(the)h(ra)m
(w)g(b)m(ytes)h(instead)0 1214 y(of)h(reading)g(then)g(writing)g(eac)m
(h)h(column)e(of)i(the)f(table.)40 b(The)25 b(FITSIO)g(subroutines)g
(FTGTBS)g(and)h(FTPTBS)0 1327 y(\(for)i(ASCI)s(I)f(tables\),)j(and)d
(FTGTBB)i(and)e(FTPTBB)i(\(for)f(binary)f(tables\))i(will)g(p)s(erform)
d(lo)m(w-lev)m(el)31 b(reads)d(or)0 1440 y(writes)34
b(of)h(an)m(y)f(con)m(tiguous)i(range)f(of)f(b)m(ytes)h(in)f(a)h(table)
g(extension.)53 b(These)34 b(routines)g(can)h(b)s(e)e(used)h(to)h(read)
0 1553 y(or)29 b(write)g(a)g(whole)g(ro)m(w)f(\(or)i(m)m(ultiple)f(ro)m
(ws\))g(of)g(a)g(table)h(with)e(a)h(single)g(subroutine)f(call.)41
b(These)29 b(routines)g(are)0 1666 y(fast)38 b(b)s(ecause)f(they)h(b)m
(ypass)f(all)h(the)g(usual)f(data)h(scaling,)j(error)c(c)m(hec)m(king)i
(and)e(mac)m(hine)h(dep)s(enden)m(t)e(data)0 1779 y(con)m(v)m(ersion)41
b(that)g(is)e(normally)i(done)e(b)m(y)h(FITSIO,)f(and)g(they)h(allo)m
(w)h(the)f(program)g(to)h(write)f(the)g(data)g(to)0 1892
y(the)34 b(output)g(\014le)g(in)g(exactly)i(the)e(same)h(b)m(yte)g
(order.)51 b(F)-8 b(or)35 b(these)g(same)f(reasons,)i(use)e(of)g(these)
h(routines)f(can)0 2005 y(b)s(e)f(somewhat)h(risky)f(b)s(ecause)g(no)g
(v)-5 b(alidation)35 b(or)f(mac)m(hine)g(dep)s(enden)m(t)e(con)m(v)m
(ersion)j(is)e(p)s(erformed)f(b)m(y)h(these)0 2118 y(routines.)40
b(In)27 b(general)h(these)h(routines)e(are)h(only)g(recommended)f(for)h
(optimizing)h(critical)g(pieces)g(of)f(co)s(de)g(and)0
2230 y(should)e(only)i(b)s(e)f(used)f(b)m(y)i(programmers)e(who)h
(thoroughly)h(understand)d(the)j(in)m(ternal)g(b)m(yte)g(structure)f
(of)h(the)0 2343 y(FITS)i(tables)h(they)f(are)h(reading)g(or)f
(writing.)0 2503 y(11.)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 2616 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 2729
y(application)k(program)f(and)g(then)f(write)i(it)f(to)h(the)f(FITS)f
(\014le)i(with)e(ftptbb.)51 b(This)33 b(a)m(v)m(oids)j(all)f(the)f(o)m
(v)m(erhead)0 2842 y(normally)g(presen)m(t)g(in)f(the)h(column-orien)m
(ted)h(CFITSIO)d(write)i(routines.)51 b(This)33 b(tec)m(hnique)h
(should)f(only)h(b)s(e)0 2955 y(used)26 b(for)h(critical)i
(applications,)g(b)s(ecause)d(it)i(mak)m(es)g(the)f(co)s(de)g(more)g
(di\016cult)g(to)g(understand)e(and)i(main)m(tain,)0
3068 y(and)d(it)h(mak)m(es)h(the)f(co)s(de)g(more)f(system)h(dep)s
(enden)m(t)f(\(e.g.,)k(do)c(the)h(b)m(ytes)g(need)g(to)g(b)s(e)f(sw)m
(app)s(ed)g(b)s(efore)g(writing)0 3181 y(to)31 b(the)g(FITS)e
(\014le?\).)0 3341 y(12.)53 b(Finally)-8 b(,)37 b(external)e(factors)h
(suc)m(h)e(as)g(the)h(t)m(yp)s(e)f(of)h(magnetic)g(disk)f(con)m
(troller)i(\(SCSI)d(or)i(IDE\),)g(the)f(size)0 3454 y(of)h(the)g(disk)g
(cac)m(he,)j(the)d(a)m(v)m(erage)i(seek)f(sp)s(eed)e(of)h(the)g(disk,)h
(the)f(amoun)m(t)h(of)f(disk)f(fragmen)m(tation,)k(and)d(the)0
3567 y(amoun)m(t)29 b(of)g(RAM)f(a)m(v)-5 b(ailable)31
b(on)e(the)f(system)h(can)g(all)g(ha)m(v)m(e)h(a)f(signi\014can)m(t)g
(impact)h(on)e(o)m(v)m(erall)j(I/O)d(e\016ciency)-8 b(.)0
3680 y(F)g(or)36 b(critical)h(applications,)g(a)f(system)f
(administrator)g(should)f(review)h(the)h(prop)s(osed)d(system)j(hardw)m
(are)e(to)0 3793 y(iden)m(tify)d(an)m(y)g(p)s(oten)m(tial)g(I/O)g(b)s
(ottlenec)m(ks.)p eop end
%%Page: 29 35
TeXDict begin 29 34 bop 0 1225 a Ff(Chapter)65 b(5)0
1687 y Fl(Basic)77 b(In)-6 b(terface)77 b(Routines)0
2180 y Fi(This)27 b(section)h(de\014nes)f(a)h(basic)g(set)g(of)g
(subroutines)e(that)i(can)g(b)s(e)f(used)g(to)h(p)s(erform)e(the)i
(most)g(common)g(t)m(yp)s(es)0 2293 y(of)d(read)g(and)f(write)h(op)s
(erations)g(on)g(FITS)f(\014les.)39 b(New)25 b(users)f(should)g(start)h
(with)g(these)g(subroutines)f(and)g(then,)0 2406 y(as)33
b(needed,)h(explore)f(the)h(more)f(adv)-5 b(ance)33 b(routines)g
(describ)s(ed)f(in)h(the)g(follo)m(wing)i(c)m(hapter)e(to)h(p)s(erform)
e(more)0 2518 y(complex)f(or)f(sp)s(ecialized)i(op)s(erations.)0
2679 y(A)e(righ)m(t)g(arro)m(w)g(sym)m(b)s(ol)f(\()p
Fa(>)p Fi(\))h(is)g(used)f(to)h(separate)h(the)e(input)g(parameters)h
(from)f(the)h(output)f(parameters)h(in)0 2791 y(the)i(de\014nition)f
(of)g(eac)m(h)i(routine.)44 b(This)30 b(sym)m(b)s(ol)i(is)f(not)h
(actually)h(part)e(of)h(the)f(calling)i(sequence.)45
b(Note)32 b(that)0 2904 y(the)f(status)h(parameter)g(is)f(b)s(oth)g(an)
g(input)f(and)h(an)g(output)g(parameter)h(and)e(m)m(ust)h(b)s(e)g
(initialized)i(=)e(0)h(prior)0 3017 y(to)f(calling)h(the)f(FITSIO)e
(subroutines.)0 3177 y(Refer)h(to)i(Chapter)d(9)i(for)f(the)h
(de\014nition)f(of)g(all)i(the)e(parameters)h(used)e(b)m(y)i(these)g
(in)m(terface)g(routines.)0 3525 y Fd(5.1)135 b(FITSIO)44
b(Error)h(Status)h(Routines)0 3773 y Fh(1)81 b Fi(Return)24
b(the)i(curren)m(t)f(v)m(ersion)h(n)m(um)m(b)s(er)e(of)i(the)f
(\014tsio)h(library)-8 b(.)39 b(The)25 b(v)m(ersion)h(n)m(um)m(b)s(er)e
(will)i(b)s(e)e(incremen)m(ted)227 3886 y(with)30 b(eac)m(h)i(new)e
(release)h(of)g(CFITSIO.)382 4157 y Fe(FTVERS\()46 b(>)h(version\))0
4429 y Fh(2)81 b Fi(Return)45 b(the)i(descriptiv)m(e)g(text)g(string)g
(corresp)s(onding)e(to)i(a)g(FITSIO)e(error)h(status)h(co)s(de.)89
b(The)46 b(30-)227 4541 y(c)m(haracter)32 b(length)f(string)f(con)m
(tains)i(a)f(brief)f(description)g(of)g(the)h(cause)g(of)f(the)h
(error.)382 4813 y Fe(FTGERR\(status,)44 b(>)j(errtext\))0
5084 y Fh(3)81 b Fi(Return)40 b(the)h(top)g(\(oldest\))h(80-c)m
(haracter)i(error)c(message)i(from)f(the)g(in)m(ternal)g(FITSIO)f(stac)
m(k)i(of)f(error)227 5197 y(messages)29 b(and)f(shift)g(an)m(y)g
(remaining)g(messages)h(on)f(the)g(stac)m(k)i(up)d(one)h(lev)m(el.)42
b(An)m(y)28 b(FITSIO)f(error)h(will)227 5310 y(generate)h(one)e(or)g
(more)h(messages)g(on)f(the)g(stac)m(k.)41 b(Call)28
b(this)f(routine)g(rep)s(eatedly)g(to)h(get)h(eac)m(h)f(message)227
5422 y(in)i(sequence.)41 b(The)30 b(error)g(stac)m(k)i(is)f(empt)m(y)f
(when)g(a)g(blank)g(string)h(is)f(returned.)382 5694
y Fe(FTGMSG\()46 b(>)h(errmsg\))1905 5942 y Fi(29)p eop
end
%%Page: 30 36
TeXDict begin 30 35 bop 0 299 a Fi(30)1747 b Fg(CHAPTER)30
b(5.)111 b(BASIC)30 b(INTERF)-10 b(A)m(CE)30 b(R)m(OUTINES)0
555 y Fh(4)81 b Fi(The)33 b(FTPMRK)h(routine)g(puts)g(an)g(in)m
(visible)h(mark)m(er)f(on)g(the)h(CFITSIO)d(error)i(stac)m(k.)54
b(The)33 b(FTCMRK)227 668 y(routine)41 b(can)g(then)g(b)s(e)f(used)g
(to)h(delete)h(an)m(y)f(more)g(recen)m(t)h(error)e(messages)i(on)f(the)
g(stac)m(k,)k(bac)m(k)c(to)227 781 y(the)32 b(p)s(osition)f(of)g(the)g
(mark)m(er.)43 b(This)31 b(preserv)m(es)g(an)m(y)g(older)h(error)e
(messages)i(on)f(the)h(stac)m(k.)44 b(FTCMSG)227 894
y(simply)23 b(clears)g(the)g(en)m(tire)h(error)e(message)i(stac)m(k.)40
b(These)23 b(routines)f(are)h(called)h(without)f(an)m(y)g(argumen)m
(ts.)382 1152 y Fe(FTPMRK)382 1265 y(FTCMRK)382 1378
y(FTCMSG)0 1637 y Fh(5)81 b Fi(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 1750
y(on)g(the)h(FITSIO)e(stac)m(k)i(to)g(the)g(sp)s(eci\014ed)e(\014le)i
(stream)f(\(stream)h(can)g(b)s(e)e(either)i(the)f(string)g('STDOUT')227
1863 y(or)h('STDERR'\).)f(If)g(the)h(input)e(status)i(v)-5
b(alue)31 b(=)f(0)h(then)f(this)g(routine)g(do)s(es)g(nothing.)334
2121 y Fe(FTRPRT)46 b(\(stream,)g(>)h(status\))0 2380
y Fh(6)81 b Fi(W)-8 b(rite)39 b(an)f(80-c)m(haracter)j(message)e(to)g
(the)f(FITSIO)f(error)h(stac)m(k.)65 b(Application)39
b(programs)f(should)f(not)227 2493 y(normally)31 b(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.)382 2751 y Fe(FTPMSG\(errmsg\))0
3085 y Fd(5.2)135 b(File)46 b(I/O)f(Routines)0 3325 y
Fh(1)81 b Fi(Op)s(en)34 b(an)h(existing)i(FITS)d(\014le)i(with)f
(readonly)h(or)f(readwrite)h(access.)58 b(This)34 b(routine)i(alw)m(a)m
(ys)h(op)s(ens)e(the)227 3438 y(primary)30 b(arra)m(y)i(\(the)f
(\014rst)f(HDU\))i(of)f(the)h(\014le,)f(and)f(do)s(es)h(not)g(mo)m(v)m
(e)h(to)g(a)f(follo)m(wing)i(extension,)f(if)f(one)227
3551 y(w)m(as)c(sp)s(eci\014ed)f(as)g(part)h(of)f(the)h(\014lename.)39
b(Use)27 b(the)g(FTNOPN)f(routine)g(to)h(automatically)j(mo)m(v)m(e)e
(to)f(the)227 3664 y(extension.)44 b(This)31 b(routine)g(will)h(also)g
(op)s(en)f(IRAF)g(images)i(\(.imh)e(format)h(\014les\))g(and)e(ra)m(w)i
(binary)e(data)227 3776 y(arra)m(ys)e(with)f(READONL)-8
b(Y)28 b(access)h(b)m(y)e(\014rst)g(con)m(v)m(erting)i(them)e(on)g(the)
h(\015y)f(in)m(to)h(virtual)g(FITS)f(images.)227 3889
y(See)39 b(the)f(`Extended)g(File)h(Name)g(Syn)m(tax')f(c)m(hapter)h
(for)f(more)g(details.)65 b(The)38 b(FTDK)m(OPEN)g(routine)227
4002 y(simply)f(op)s(ens)g(the)h(sp)s(eci\014ed)f(\014le)h(without)f
(trying)h(to)g(in)m(terpret)g(the)g(\014lename)g(using)f(the)h
(extended)227 4115 y(\014lename)31 b(syn)m(tax.)382 4374
y Fe(FTOPEN\(unit,filename,rwm)o(ode)o(,)42 b(>)47 b
(blocksize,status\))382 4487 y(FTDKOPEN\(unit,filename,r)o(wmo)o(de,)41
b(>)48 b(blocksize,status\))0 4745 y Fh(2)81 b Fi(Op)s(en)24
b(an)i(existing)h(FITS)e(\014le)h(with)f(readonly)h(or)g(readwrite)g
(access)h(and)f(mo)m(v)m(e)h(to)f(a)h(follo)m(wing)g(extension,)227
4858 y(if)38 b(one)g(w)m(as)g(sp)s(eci\014ed)g(as)g(part)f(of)h(the)h
(\014lename.)63 b(\(e.g.,)42 b('\014lename.\014ts+2')c(or)g
('\014lename.\014ts[2]')i(will)227 4971 y(mo)m(v)m(e)e(to)g(the)e(3rd)g
(HDU)i(in)e(the)h(\014le\).)60 b(Note)37 b(that)h(this)e(routine)h
(di\013ers)f(from)g(FTOPEN)g(in)g(that)h(it)227 5084
y(do)s(es)30 b(not)h(ha)m(v)m(e)h(the)e(redundan)m(t)f(blo)s(c)m(ksize)
j(argumen)m(t.)382 5342 y Fe(FTNOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))0 5601 y Fh(3)81 b Fi(Op)s(en)31 b(an)h(existing)h
(FITS)f(\014le)g(with)g(readonly)h(or)f(readwrite)h(access)g(and)f
(then)g(mo)m(v)m(e)i(to)f(the)g(\014rst)e(HDU)227 5714
y(con)m(taining)c(signi\014can)m(t)g(data,)g(if)e(a\))i(an)e(HDU)h
(name)g(or)f(n)m(um)m(b)s(er)f(to)i(op)s(en)f(w)m(as)h(not)g
(explicitly)h(sp)s(eci\014ed)p eop end
%%Page: 31 37
TeXDict begin 31 36 bop 0 299 a Fg(5.2.)72 b(FILE)30
b(I/O)h(R)m(OUTINES)2693 b Fi(31)227 555 y(as)31 b(part)g(of)g(the)g
(\014lename,)h(and)e(b\))h(if)g(the)g(FITS)f(\014le)h(con)m(tains)h(a)g
(n)m(ull)e(primary)g(arra)m(y)i(\(i.e.,)h(NAXIS)d(=)227
668 y(0\).)41 b(In)26 b(this)i(case,)h(it)f(will)g(lo)s(ok)g(for)f(the)
h(\014rst)e(IMA)m(GE)j(HDU)f(with)f(NAXIS)g(>)h(0,)g(or)g(the)f
(\014rst)g(table)h(that)227 781 y(do)s(es)g(not)g(con)m(tain)g(the)g
(strings)g(`GTI')g(\(Go)s(o)s(d)f(Time)h(In)m(terv)-5
b(al\))29 b(or)f(`OBST)-8 b(ABLE')28 b(in)f(the)h(EXTNAME)227
894 y(k)m(eyw)m(ord)37 b(v)-5 b(alue.)61 b(FTTOPN)36
b(is)g(similar,)j(except)f(it)f(will)g(mo)m(v)m(e)i(to)e(the)g(\014rst)
f(signi\014can)m(t)i(table)f(HDU)227 1007 y(\(skipping)26
b(o)m(v)m(er)g(an)m(y)g(image)h(HDUs\))g(in)e(the)h(\014le)g(if)f(a)h
(sp)s(eci\014c)g(HDU)g(name)g(or)g(n)m(um)m(b)s(er)e(is)i(not)f(sp)s
(eci\014ed.)227 1120 y(FTIOPN)30 b(will)h(mo)m(v)m(e)h(to)f(the)f
(\014rst)g(non-n)m(ull)g(image)i(HDU,)f(skipping)f(o)m(v)m(er)h(an)m(y)
g(tables.)382 1376 y Fe(FTDOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 1489 y(FTTOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 1602 y(FTIOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))0 1858 y Fh(4)81 b Fi(Op)s(en)38 b(and)i(initialize)j
(a)e(new)e(empt)m(y)i(FITS)f(\014le.)70 b(A)41 b(template)h(\014le)e
(ma)m(y)h(also)g(b)s(e)f(sp)s(eci\014ed)g(to)h(de\014ne)227
1971 y(the)34 b(structure)e(of)h(the)h(new)e(\014le)h(\(see)h(section)g
(4.2.4\).)51 b(The)33 b(FTDKINIT)g(routine)g(simply)f(creates)j(the)227
2084 y(sp)s(eci\014ed)30 b(\014le)g(without)h(trying)f(to)h(in)m
(terpret)g(the)g(\014lename)f(using)g(the)h(extended)f(\014lename)h
(syn)m(tax.)382 2340 y Fe(FTINIT\(unit,filename,blo)o(cks)o(ize,)41
b(>)48 b(status\))382 2453 y(FTDKINIT\(unit,filename,b)o(loc)o(ksiz)o
(e,)42 b(>)47 b(status\))0 2709 y Fh(5)81 b Fi(Close)31
b(a)f(FITS)g(\014le)g(previously)g(op)s(ened)g(with)g(ftop)s(en)g(or)g
(ftinit)382 2965 y Fe(FTCLOS\(unit,)44 b(>)k(status\))0
3221 y Fh(6)81 b Fi(Mo)m(v)m(e)32 b(to)f(a)g(sp)s(eci\014ed)f
(\(absolute\))h(HDU)g(in)g(the)f(FITS)g(\014le)g(\(nhdu)f(=)h(1)h(for)f
(the)g(FITS)g(primary)f(arra)m(y\))382 3478 y Fe(FTMAHD\(unit,nhdu,)43
b(>)k(hdutype,status\))0 3734 y Fh(7)81 b Fi(Create)30
b(a)f(primary)f(arra)m(y)i(\(if)g(none)f(already)g(exists\),)i(or)e
(insert)g(a)h(new)f(IMA)m(GE)h(extension)g(immediately)227
3847 y(follo)m(wing)25 b(the)e(CHDU,)g(or)g(insert)g(a)g(new)g(Primary)
f(Arra)m(y)h(at)h(the)f(b)s(eginning)f(of)h(the)g(\014le.)38
b(An)m(y)23 b(follo)m(wing)227 3960 y(extensions)29 b(in)g(the)g
(\014le)f(will)h(b)s(e)f(shifted)h(do)m(wn)f(to)h(mak)m(e)h(ro)s(om)e
(for)h(the)g(new)f(extension.)40 b(If)29 b(the)g(CHDU)227
4072 y(is)h(the)g(last)g(HDU)g(in)g(the)f(\014le)h(then)f(the)h(new)f
(image)i(extension)f(will)g(simply)f(b)s(e)g(app)s(ended)f(to)i(the)g
(end)227 4185 y(of)k(the)h(\014le.)52 b(One)33 b(can)h(force)h(a)g(new)
e(primary)g(arra)m(y)i(to)g(b)s(e)e(inserted)h(at)h(the)f(b)s(eginning)
f(of)h(the)h(FITS)227 4298 y(\014le)29 b(b)m(y)f(setting)i(status)e(=)h
(-9)g(prior)e(to)j(calling)g(the)e(routine.)40 b(In)28
b(this)g(case)i(the)e(existing)i(primary)d(arra)m(y)227
4411 y(will)f(b)s(e)f(con)m(v)m(erted)i(to)g(an)e(IMA)m(GE)h
(extension.)40 b(The)25 b(new)g(extension)i(\(or)f(primary)e(arra)m
(y\))j(will)f(b)s(ecome)227 4524 y(the)32 b(CHDU.)f(The)g(FTI)s(IMGLL)f
(routine)i(is)f(iden)m(tical)i(to)e(the)h(FTI)s(IMG)f(routine)g(except)
h(that)f(the)h(4th)227 4637 y(parameter)25 b(\(the)g(length)g(of)f(eac)
m(h)h(axis\))g(is)g(an)f(arra)m(y)h(of)f(64-bit)i(in)m(tegers)f(rather)
f(than)g(an)g(arra)m(y)h(of)g(32-bit)227 4750 y(in)m(tegers.)382
5006 y Fe(FTIIMG\(unit,bitpix,naxis)o(,na)o(xes,)41 b(>)48
b(status\))382 5119 y(FTIIMGLL\(unit,bitpix,nax)o(is,)o(naxe)o(sll,)41
b(>)47 b(status\))0 5375 y Fh(8)81 b Fi(Insert)30 b(a)i(new)f(ASCI)s(I)
f(T)-8 b(ABLE)31 b(extension)h(immediately)h(follo)m(wing)f(the)g
(CHDU.)g(An)m(y)f(follo)m(wing)i(exten-)227 5488 y(sions)26
b(will)g(b)s(e)f(shifted)g(do)m(wn)g(to)h(mak)m(e)h(ro)s(om)e(for)h
(the)f(new)g(extension.)40 b(If)25 b(there)h(are)g(no)g(other)f(follo)m
(wing)227 5601 y(extensions)32 b(then)f(the)h(new)f(table)h(extension)g
(will)g(simply)f(b)s(e)g(app)s(ended)f(to)i(the)f(end)g(of)h(the)f
(\014le.)44 b(The)227 5714 y(new)33 b(extension)h(will)f(b)s(ecome)h
(the)f(CHDU.)h(The)f(FTIT)-8 b(ABLL)33 b(routine)g(is)g(iden)m(tical)i
(to)f(the)g(FTIT)-8 b(AB)p eop end
%%Page: 32 38
TeXDict begin 32 37 bop 0 299 a Fi(32)1747 b Fg(CHAPTER)30
b(5.)111 b(BASIC)30 b(INTERF)-10 b(A)m(CE)30 b(R)m(OUTINES)227
555 y Fi(routine)36 b(except)g(that)g(the)f(2nd)g(and)g(3rd)g
(parameters)g(\(that)i(giv)m(e)g(the)e(size)h(of)g(the)f(table\))i(are)
f(64-bit)227 668 y(in)m(tegers)43 b(rather)f(than)f(32-bit)i(in)m
(tegers.)76 b(Under)41 b(normal)g(circumstances,)46 b(the)c(nro)m(ws)f
(and)g(nro)m(wsll)227 781 y(paramen)m(ters)f(should)e(ha)m(v)m(e)j(a)f
(v)-5 b(alue)40 b(of)f(0;)45 b(CFITSIO)38 b(will)h(automatically)k(up)s
(date)38 b(the)i(n)m(um)m(b)s(er)e(of)227 894 y(ro)m(ws)31
b(as)f(data)h(is)g(written)f(to)h(the)g(table.)382 1158
y Fe(FTITAB\(unit,rowlen,nrows)o(,tf)o(ield)o(s,tt)o(ype)o(,tbc)o(ol,t)
o(for)o(m,tu)o(nit,)o(ext)o(name)o(,)42 b(>)716 1271
y(status\))382 1384 y(FTITABLL\(unit,rowlenll,n)o(row)o(sll,)o(tfie)o
(lds)o(,tty)o(pe,t)o(bco)o(l,tf)o(orm,)o(tun)o(it,e)o(xtna)o(me,)f(>)
716 1497 y(status\))0 1761 y Fh(9)81 b Fi(Insert)26 b(a)h(new)g(binary)
f(table)h(extension)h(immediately)g(follo)m(wing)h(the)e(CHDU.)g(An)m
(y)g(follo)m(wing)h(extensions)227 1874 y(will)39 b(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.)66
b(If)38 b(there)h(are)f(no)h(other)f(follo)m(wing)227
1987 y(extensions)f(then)g(the)f(new)g(bin)m(table)h(extension)h(will)f
(simply)f(b)s(e)g(app)s(ended)e(to)k(the)e(end)g(of)h(the)g(\014le.)227
2100 y(The)23 b(new)g(extension)h(will)f(b)s(ecome)h(the)f(CHDU.)h(The)
f(FTIBINLL)g(routine)g(is)g(iden)m(tical)i(to)f(the)g(FTIBIN)227
2213 y(routine)30 b(except)i(that)e(the)h(2nd)e(parameter)i(\(that)g
(giv)m(es)g(the)g(length)f(of)h(the)f(table\))h(is)g(a)f(64-bit)i(in)m
(teger)227 2325 y(rather)24 b(than)g(a)g(32-bit)h(in)m(teger.)40
b(Under)23 b(normal)h(circumstances,)i(the)e(nro)m(ws)f(and)h(nro)m
(wsll)g(paramen)m(ters)227 2438 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
2551 y(written)f(to)g(the)f(table.)382 2815 y Fe
(FTIBIN\(unit,nrows,tfield)o(s,t)o(type)o(,tfo)o(rm,)o(tuni)o(t,ex)o
(tna)o(me,v)o(arid)o(at)41 b(>)48 b(status\))382 2928
y(FTIBINLL\(unit,nrowsll,tf)o(iel)o(ds,t)o(type)o(,tf)o(orm,)o(tuni)o
(t,e)o(xtna)o(me,v)o(ari)o(dat)41 b(>)48 b(status\))0
3380 y Fd(5.3)135 b(Keyw)l(ord)46 b(I/O)f(Routines)0
3624 y Fh(1)81 b Fi(Put)30 b(\(app)s(end\))f(an)h(80-c)m(haracter)j
(record)e(in)m(to)g(the)g(CHU.)382 3888 y Fe(FTPREC\(unit,card,)43
b(>)k(status\))0 4152 y Fh(2)81 b Fi(Put)28 b(\(app)s(end\))g(a)h(new)g
(k)m(eyw)m(ord)g(of)g(the)g(appropriate)g(datat)m(yp)s(e)h(in)m(to)g
(the)f(CHU.)g(The)f(E)h(and)f(D)i(v)m(ersions)227 4265
y(of)24 b(this)f(routine)g(ha)m(v)m(e)h(the)g(added)e(feature)i(that)g
(if)f(the)g('decimals')i(parameter)f(is)f(negativ)m(e,)k(then)c(the)g
('G')227 4378 y(displa)m(y)30 b(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 4490 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
4603 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
4716 y(the)31 b(v)-5 b(alue.)382 4980 y Fe(FTPKY[JKLS]\(unit,keyword)o
(,ke)o(yval)o(,com)o(men)o(t,)42 b(>)47 b(status\))382
5093 y(FTPKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o
(omme)o(nt,)41 b(>)48 b(status\))0 5357 y Fh(3)81 b Fi(Get)37
b(the)f(n)m(th)f(80-c)m(haracter)k(header)d(record)g(from)f(the)h(CHU.)
h(The)e(\014rst)g(k)m(eyw)m(ord)i(in)e(the)h(header)g(is)g(at)227
5470 y(k)m(ey)p 365 5470 28 4 v 34 w(no)42 b(=)f(1;)49
b(if)42 b(k)m(ey)p 996 5470 V 34 w(no)g(=)f(0)i(then)e(this)h
(subroutine)f(simple)h(mo)m(v)m(es)i(the)e(in)m(ternal)h(p)s(oin)m(ter)
f(to)h(the)227 5583 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 5696 y(header;)31 b(it)g(also)g(returns)e(a)i
(blank)f(card)g(v)-5 b(alue)31 b(in)f(this)g(case.)p
eop end
%%Page: 33 39
TeXDict begin 33 38 bop 0 299 a Fg(5.4.)72 b(D)m(A)-8
b(T)g(A)32 b(I/O)f(R)m(OUTINES)2650 b Fi(33)382 555 y
Fe(FTGREC\(unit,key_no,)42 b(>)48 b(card,status\))0 804
y Fh(4)81 b Fi(Get)31 b(a)g(k)m(eyw)m(ord)g(v)-5 b(alue)30
b(\(with)h(the)f(appropriate)h(datat)m(yp)s(e\))g(and)f(commen)m(t)i
(from)e(the)g(CHU)382 1052 y Fe(FTGKY[EDJKLS]\(unit,keywo)o(rd,)41
b(>)48 b(keyval,comment,status\))0 1301 y Fh(5)81 b Fi(Delete)32
b(an)e(existing)i(k)m(eyw)m(ord)f(record.)382 1550 y
Fe(FTDKEY\(unit,keyword,)42 b(>)48 b(status\))0 1881
y Fd(5.4)135 b(Data)46 b(I/O)g(Routines)0 2132 y Fi(The)32
b(follo)m(wing)i(routines)e(read)h(or)f(write)h(data)g(v)-5
b(alues)33 b(in)f(the)h(curren)m(t)f(HDU)i(of)e(the)h(FITS)f(\014le.)47
b(Automatic)0 2245 y(datat)m(yp)s(e)28 b(con)m(v)m(ersion)h(will)e(b)s
(e)g(attempted)h(for)g(n)m(umerical)f(datat)m(yp)s(es)i(if)e(the)g(sp)s
(eci\014ed)g(datat)m(yp)s(e)h(is)f(di\013eren)m(t)0 2357
y(from)j(the)g(actual)i(datat)m(yp)s(e)g(of)e(the)h(FITS)e(arra)m(y)i
(or)f(table)i(column.)0 2606 y Fh(1)81 b Fi(W)-8 b(rite)31
b(elemen)m(ts)h(in)m(to)f(the)g(primary)e(data)j(arra)m(y)e(or)h(image)
g(extension.)382 2855 y Fe(FTPPR[BIJKED]\(unit,group)o(,fp)o(ixel)o
(,nel)o(eme)o(nts,)o(valu)o(es,)41 b(>)48 b(status\))0
3103 y Fh(2)81 b Fi(Read)30 b(elemen)m(ts)j(from)d(the)h(primary)e
(data)j(arra)m(y)f(or)g(image)h(extension.)42 b(Unde\014ned)29
b(arra)m(y)j(elemen)m(ts)g(will)227 3216 y(b)s(e)f(returned)f(with)h(a)
h(v)-5 b(alue)31 b(=)g(n)m(ullv)-5 b(al,)33 b(unless)d(n)m(ullv)-5
b(al)32 b(=)f(0)h(in)f(whic)m(h)g(case)h(no)f(c)m(hec)m(ks)i(for)e
(unde\014ned)227 3329 y(pixels)h(will)f(b)s(e)f(p)s(erformed.)42
b(The)30 b(an)m(yf)i(parameter)f(is)g(set)h(to)g(true)f(\(=)g(.true.\))
43 b(if)31 b(an)m(y)h(of)f(the)g(returned)227 3442 y(elemen)m(ts)h(w)m
(ere)f(unde\014ned.)382 3691 y Fe(FTGPV[BIJKED]\(unit,group)o(,fp)o
(ixel)o(,nel)o(eme)o(nts,)o(null)o(val)o(,)42 b(>)47
b(values,anyf,status\))0 3939 y Fh(3)81 b Fi(W)-8 b(rite)36
b(elemen)m(ts)h(in)m(to)f(an)f(ASCI)s(I)e(or)i(binary)g(table)h
(column.)54 b(The)35 b(`felem')h(parameter)g(applies)f(only)g(to)227
4052 y(v)m(ector)d(columns)e(in)g(binary)g(tables)h(and)f(is)g(ignored)
h(when)e(writing)i(to)g(ASCI)s(I)d(tables.)382 4301 y
Fe(FTPCL[SLBIJKEDCM]\(unit,c)o(oln)o(um,f)o(row,)o(fel)o(em,n)o(elem)o
(ent)o(s,va)o(lues)o(,)42 b(>)47 b(status\))0 4549 y
Fh(4)81 b Fi(Read)22 b(elemen)m(ts)h(from)e(an)g(ASCI)s(I)g(or)g
(binary)g(table)i(column.)38 b(Unde\014ned)20 b(arra)m(y)i(elemen)m(ts)
h(will)f(b)s(e)f(returned)227 4662 y(with)32 b(a)h(v)-5
b(alue)33 b(=)f(n)m(ullv)-5 b(al,)34 b(unless)e(n)m(ullv)-5
b(al)32 b(=)h(0)f(\(or)h(=)f(')h(')f(for)g(ftgcvs\))i(in)e(whic)m(h)g
(case)i(no)e(c)m(hec)m(king)i(for)227 4775 y(unde\014ned)23
b(v)-5 b(alues)25 b(will)g(b)s(e)g(p)s(erformed.)37 b(The)24
b(ANYF)i(parameter)f(is)g(set)h(to)f(true)g(if)g(an)m(y)g(of)g(the)g
(returned)227 4888 y(elemen)m(ts)32 b(are)f(unde\014ned.)227
5036 y(An)m(y)d(column,)h(regardless)f(of)g(it's)h(in)m(trinsic)f
(datat)m(yp)s(e,)i(ma)m(y)e(b)s(e)f(read)h(as)g(a)h(string.)40
b(It)28 b(should)e(b)s(e)i(noted)227 5149 y(ho)m(w)m(ev)m(er)k(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
5262 y(same)36 b(column)f(as)h(a)g(n)m(um)m(b)s(er)e(due)g(to)j(the)e
(large)i(o)m(v)m(erhead)f(in)f(constructing)h(the)g(formatted)g
(strings.)227 5375 y(The)i(displa)m(y)g(format)g(of)g(the)g(returned)f
(strings)g(will)h(b)s(e)g(determined)f(b)m(y)h(the)g(TDISPn)f(k)m(eyw)m
(ord,)j(if)227 5488 y(it)d(exists,)h(otherwise)f(b)m(y)f(the)g(datat)m
(yp)s(e)h(of)f(the)h(column.)57 b(The)36 b(length)g(of)h(the)f
(returned)f(strings)h(can)227 5601 y(b)s(e)29 b(determined)f(with)h
(the)g(ftgcdw)g(routine.)40 b(The)28 b(follo)m(wing)j(TDISPn)c(displa)m
(y)j(formats)f(are)g(curren)m(tly)227 5714 y(supp)s(orted:)p
eop end
%%Page: 34 40
TeXDict begin 34 39 bop 0 299 a Fi(34)1747 b Fg(CHAPTER)30
b(5.)111 b(BASIC)30 b(INTERF)-10 b(A)m(CE)30 b(R)m(OUTINES)418
555 y Fe(Iw.m)142 b(Integer)418 668 y(Ow.m)g(Octal)47
b(integer)418 781 y(Zw.m)142 b(Hexadecimal)45 b(integer)418
894 y(Fw.d)142 b(Fixed)47 b(floating)e(point)418 1007
y(Ew.d)142 b(Exponential)45 b(floating)h(point)418 1120
y(Dw.d)142 b(Exponential)45 b(floating)h(point)418 1233
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 1483 y Fi(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 1595 y(displa)m(y)m(ed,)31 b(and)e(d)h(is)f(the)i(n)m(um)m
(b)s(er)d(of)i(digits)g(to)h(the)f(righ)m(t)h(of)f(the)g(decimal.)41
b(The)29 b(.m)h(\014eld)g(is)g(optional.)382 1855 y Fe
(FTGCV[SBIJKEDCM]\(unit,co)o(lnu)o(m,fr)o(ow,f)o(ele)o(m,ne)o(leme)o
(nts)o(,nul)o(lval)o(,)42 b(>)1098 1968 y(values,anyf,status\))0
2228 y Fh(5)81 b Fi(Get)42 b(the)g(table)h(column)e(n)m(um)m(b)s(er)g
(and)g(full)g(name)h(of)g(the)f(column)h(whose)f(name)h(matc)m(hes)h
(the)f(input)227 2341 y(template)35 b(string.)48 b(See)33
b(the)h(`Adv)-5 b(anced)33 b(In)m(terface)h(Routines')f(c)m(hapter)h
(for)f(a)g(full)g(description)g(of)g(this)227 2454 y(routine.)382
2714 y Fe(FTGCNN\(unit,casesen,colt)o(emp)o(late)o(,)42
b(>)47 b(colname,colnum,status\))p eop end
%%Page: 35 41
TeXDict begin 35 40 bop 0 1225 a Ff(Chapter)65 b(6)0
1687 y Fl(Adv)-13 b(anced)78 b(In)-6 b(terface)77 b(Subroutines)0
2180 y Fi(This)31 b(c)m(hapter)h(de\014nes)f(all)h(the)g(a)m(v)-5
b(ailable)34 b(subroutines)d(in)g(the)h(FITSIO)e(user)h(in)m(terface.)
46 b(F)-8 b(or)33 b(completeness,)0 2293 y(the)43 b(basic)g
(subroutines)e(describ)s(ed)g(in)i(the)f(previous)h(c)m(hapter)g(are)g
(also)g(rep)s(eated)g(here.)77 b(A)43 b(righ)m(t)g(arro)m(w)0
2406 y(sym)m(b)s(ol)29 b(is)f(used)g(here)h(to)g(separate)h(the)f
(input)f(parameters)h(from)f(the)h(output)g(parameters)g(in)f(the)h
(de\014nition)0 2518 y(of)k(eac)m(h)h(subroutine.)47
b(This)32 b(sym)m(b)s(ol)h(is)g(not)g(actually)i(part)d(of)h(the)h
(calling)g(sequence.)49 b(An)32 b(alphab)s(etical)i(list)0
2631 y(and)c(de\014nition)g(of)g(all)i(the)e(parameters)h(is)f(giv)m
(en)i(at)f(the)f(end)g(of)h(this)f(section.)0 2961 y
Fd(6.1)135 b(FITS)44 b(File)i(Op)t(en)e(and)h(Close)h(Subroutines:)0
3197 y Fh(1)81 b Fi(Op)s(en)25 b(an)i(existing)h(FITS)f(\014le)g(with)g
(readonly)g(or)g(readwrite)g(access.)41 b(The)27 b(FTDK)m(OPEN)g
(routine)g(simply)227 3310 y(op)s(ens)32 b(the)g(sp)s(eci\014ed)g
(\014le)h(without)f(trying)h(to)g(in)m(terpret)g(the)f(\014lename)h
(using)f(the)g(extended)h(\014lename)227 3423 y(syn)m(tax.)41
b(FTDOPN)28 b(op)s(ens)e(the)i(\014le)g(and)f(also)i(mo)m(v)m(es)g(to)g
(the)f(\014rst)f(HDU)h(con)m(taining)h(signi\014can)m(t)g(data,)227
3536 y(if)35 b(no)h(sp)s(eci\014c)f(HDU)h(is)f(sp)s(eci\014ed)f(as)i
(part)f(of)g(the)h(\014lename.)55 b(FTTOPN)35 b(and)f(FTIOPN)h(are)h
(similar)227 3649 y(except)26 b(that)f(they)g(will)g(mo)m(v)m(e)h(to)g
(the)f(\014rst)f(table)h(HDU)h(or)e(image)i(HDU,)g(resp)s(ectiv)m(ely)
-8 b(,)28 b(if)c(a)h(HDU)h(name)227 3762 y(or)31 b(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.)382
3996 y Fe(FTOPEN\(unit,filename,rwm)o(ode)o(,)42 b(>)47
b(blocksize,status\))382 4108 y(FTDKOPEN\(unit,filename,r)o(wmo)o(de,)
41 b(>)48 b(blocksize,status\))382 4334 y(FTDOPN\(unit,filename,rwm)o
(ode)o(,)42 b(>)47 b(status\))382 4447 y(FTTOPN\(unit,filename,rwm)o
(ode)o(,)42 b(>)47 b(status\))382 4560 y(FTIOPN\(unit,filename,rwm)o
(ode)o(,)42 b(>)47 b(status\))0 4794 y Fh(2)81 b Fi(Op)s(en)24
b(an)i(existing)h(FITS)e(\014le)h(with)f(readonly)h(or)g(readwrite)g
(access)h(and)f(mo)m(v)m(e)h(to)f(a)h(follo)m(wing)g(extension,)227
4907 y(if)38 b(one)g(w)m(as)g(sp)s(eci\014ed)g(as)g(part)f(of)h(the)h
(\014lename.)63 b(\(e.g.,)42 b('\014lename.\014ts+2')c(or)g
('\014lename.\014ts[2]')i(will)227 5020 y(mo)m(v)m(e)e(to)g(the)e(3rd)g
(HDU)i(in)e(the)h(\014le\).)60 b(Note)37 b(that)h(this)e(routine)h
(di\013ers)f(from)g(FTOPEN)g(in)g(that)h(it)227 5133
y(do)s(es)30 b(not)h(ha)m(v)m(e)h(the)e(redundan)m(t)f(blo)s(c)m(ksize)
j(argumen)m(t.)382 5367 y Fe(FTNOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))0 5601 y Fh(3)81 b Fi(Reop)s(en)38
b(a)i(FITS)e(\014le)i(that)f(w)m(as)h(previously)f(op)s(ened)f(with)h
(FTOPEN,)g(FTNOPN,)g(or)h(FTINIT.)e(The)227 5714 y(newunit)f(n)m(um)m
(b)s(er)f(ma)m(y)j(then)e(b)s(e)g(treated)i(as)f(a)g(separate)g
(\014le,)i(and)d(one)h(ma)m(y)h(sim)m(ultaneously)f(read)1905
5942 y(35)p eop end
%%Page: 36 42
TeXDict begin 36 41 bop 0 299 a Fi(36)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)227 555 y Fi(or)36 b(write)g(to)g(2)g(\(or)g(more\))g
(di\013eren)m(t)g(extensions)g(in)f(the)h(same)g(\014le.)56
b(The)35 b(FTOPEN)g(and)g(FTNOPN)227 668 y(routines)f(\(ab)s(o)m(v)m
(e\))h(automatically)h(detects)f(cases)g(where)e(a)g(previously)h(op)s
(ened)e(\014le)i(is)g(b)s(eing)f(op)s(ened)227 781 y(again,)c(and)e
(then)g(in)m(ternally)h(call)g(FTREOPEN,)f(so)h(programs)e(should)h
(rarely)g(need)g(to)h(explicitly)h(call)227 894 y(this)i(routine.)334
1136 y Fe(FTREOPEN\(unit,)44 b(>)j(newunit,)f(status\))0
1377 y Fh(4)81 b Fi(Op)s(en)24 b(and)g(initialize)k(a)e(new)f(empt)m(y)
g(FITS)g(\014le.)39 b(The)25 b(FTDKINIT)g(routine)g(simply)g(creates)i
(the)f(sp)s(eci\014ed)227 1490 y(\014le)31 b(without)f(trying)h(to)g
(in)m(terpret)f(the)h(\014lename)g(using)e(the)i(extended)f(\014lename)
h(syn)m(tax.)334 1732 y Fe(FTINIT\(unit,filename,bloc)o(ksi)o(ze,)41
b(>)48 b(status\))334 1845 y(FTDKINIT\(unit,filename,bl)o(ock)o(size)o
(,)42 b(>)47 b(status\))0 2087 y Fh(5)81 b Fi(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 2199 y(ma)m(y)39 b(b)s(e)f(another)h(FITS)e
(HDU)i(or)g(an)f(ASCI)s(I)f(template)j(\014le.)64 b(If)38
b(the)h(input)e(template)j(\014le)e(name)h(is)227 2312
y(blank,)28 b(then)f(this)g(routine)g(b)s(eha)m(v)m(es)h(the)f(same)h
(as)f(FTINIT.)g(The)f(curren)m(tly)i(supp)s(orted)d(format)i(of)h(the)
227 2425 y(ASCI)s(I)c(template)j(\014le)f(is)f(describ)s(ed)g(under)f
(the)i(\014ts)p 2037 2425 28 4 v 32 w(parse)p 2277 2425
V 33 w(template)g(routine)g(\(in)g(the)f(general)i(Utilities)227
2538 y(section\),)32 b(but)e(this)g(ma)m(y)h(c)m(hange)h(sligh)m(tly)g
(later)f(releases)g(of)g(CFITSIO.)334 2780 y Fe(FTTPLT\(unit,)45
b(filename,)g(tplfilename,)f(>)k(status\))0 3022 y Fh(6)81
b Fi(Flush)33 b(in)m(ternal)h(bu\013ers)f(of)h(data)g(to)g(the)g
(output)g(FITS)f(\014le)h(previously)f(op)s(ened)g(with)g(ftop)s(en)h
(or)f(ftinit.)227 3135 y(The)j(routine)h(usually)f(nev)m(er)h(needs)f
(to)i(b)s(e)e(called,)j(but)d(doing)h(so)g(will)g(ensure)f(that)h(if)f
(the)h(program)227 3247 y(subsequen)m(tly)30 b(ab)s(orts,)g(then)h(the)
f(FITS)g(\014le)g(will)h(ha)m(v)m(e)h(at)f(least)g(b)s(een)f(closed)h
(prop)s(erly)-8 b(.)382 3489 y Fe(FTFLUS\(unit,)44 b(>)k(status\))0
3731 y Fh(7)81 b Fi(Close)31 b(a)f(FITS)g(\014le)g(previously)g(op)s
(ened)g(with)g(ftop)s(en)g(or)g(ftinit)382 3973 y Fe(FTCLOS\(unit,)44
b(>)k(status\))0 4214 y Fh(8)81 b Fi(Close)34 b(and)f(DELETE)g(a)h
(FITS)f(\014le)h(previously)f(op)s(ened)g(with)g(ftop)s(en)g(or)h
(ftinit.)51 b(This)33 b(routine)g(ma)m(y)i(b)s(e)227
4327 y(useful)29 b(in)h(cases)g(where)g(a)g(FITS)f(\014le)g(is)h
(created,)h(but)e(an)h(error)f(o)s(ccurs)h(whic)m(h)f(prev)m(en)m(ts)i
(the)e(complete)227 4440 y(\014le)i(from)f(b)s(eing)g(written.)382
4682 y Fe(FTDELT\(unit,)44 b(>)k(status\))0 4924 y Fh(9)81
b Fi(Get)31 b(the)g(v)-5 b(alue)31 b(of)f(an)g(un)m(used)g(I/O)g(unit)g
(n)m(um)m(b)s(er)f(whic)m(h)h(ma)m(y)h(then)f(b)s(e)g(used)g(as)g
(input)g(to)h(FTOPEN)f(or)227 5036 y(FTINIT.)36 b(This)f(routine)h
(searc)m(hes)h(for)f(the)g(\014rst)f(un)m(used)g(unit)g(n)m(um)m(b)s
(er)g(in)g(the)i(range)f(from)f(with)h(99)227 5149 y(do)m(wn)d(to)h
(50.)50 b(This)32 b(routine)h(just)g(k)m(eeps)h(an)f(in)m(ternal)h
(list)f(of)h(the)f(allo)s(cated)i(unit)e(n)m(um)m(b)s(ers)f(and)g(do)s
(es)227 5262 y(not)26 b(ph)m(ysically)g(c)m(hec)m(k)g(that)g(the)g(F)-8
b(ortran)25 b(unit)g(is)g(a)m(v)-5 b(ailable)28 b(\(to)e(b)s(e)f
(compatible)h(with)f(the)g(SPP)f(v)m(ersion)227 5375
y(of)35 b(FITSIO\).)g(Th)m(us)f(users)g(m)m(ust)h(not)g(indep)s(enden)m
(tly)f(allo)s(cate)j(an)m(y)f(unit)e(n)m(um)m(b)s(ers)g(in)h(the)g
(range)g(50)227 5488 y(-)42 b(99)g(if)f(this)g(routine)g(is)g(also)h
(to)g(b)s(e)f(used)f(in)h(the)g(same)h(program.)73 b(This)40
b(routine)h(is)g(pro)m(vided)g(for)227 5601 y(con)m(v)m(enience)34
b(only)-8 b(,)32 b(and)e(it)i(is)f(not)h(required)e(that)i(the)f(unit)g
(n)m(um)m(b)s(ers)f(used)g(b)m(y)h(FITSIO)f(b)s(e)h(allo)s(cated)227
5714 y(b)m(y)g(this)f(routine.)p eop end
%%Page: 37 43
TeXDict begin 37 42 bop 0 299 a Fg(6.1.)72 b(FITS)30
b(FILE)g(OPEN)g(AND)h(CLOSE)e(SUBR)m(OUTINES:)1561 b
Fi(37)382 555 y Fe(FTGIOU\()46 b(>)h(iounit,)f(status\))0
807 y Fh(10)g Fi(F)-8 b(ree)34 b(\(deallo)s(cate\))i(an)d(I/O)g(unit)f
(n)m(um)m(b)s(er)g(whic)m(h)g(w)m(as)h(previously)g(allo)s(cated)i
(with)e(FTGIOU.)g(All)g(pre-)227 919 y(viously)28 b(allo)s(cated)i
(unit)d(n)m(um)m(b)s(ers)f(ma)m(y)i(b)s(e)f(deallo)s(cated)j(at)e(once)
h(b)m(y)e(calling)i(FTFIOU)f(with)f(iounit)h(=)227 1032
y(-1.)382 1284 y Fe(FTFIOU\(iounit,)44 b(>)j(status\))0
1535 y Fh(11)f Fi(Return)30 b(the)h(F)-8 b(ortran)31
b(unit)g(n)m(um)m(b)s(er)e(that)i(corresp)s(onds)f(to)h(the)g(C)g
(\014ts\014le)f(p)s(oin)m(ter)h(v)-5 b(alue,)32 b(or)e(vice)i(v)m
(ersa.)227 1648 y(These)37 b(2)h(C)f(routines)g(ma)m(y)g(b)s(e)g
(useful)f(in)h(mixed)g(language)i(programs)e(where)f(b)s(oth)h(C)g(and)
f(F)-8 b(ortran)227 1761 y(subroutines)25 b(need)g(to)i(access)g(the)f
(same)g(\014le.)40 b(F)-8 b(or)26 b(example,)i(if)e(a)g(FITS)f(\014le)h
(is)g(op)s(ened)f(with)g(unit)g(12)i(b)m(y)227 1874 y(a)k(F)-8
b(ortran)31 b(subroutine,)f(then)g(a)h(C)f(routine)h(within)f(the)g
(same)h(program)g(could)f(get)i(the)e(\014t\014le)h(p)s(oin)m(ter)227
1987 y(v)-5 b(alue)39 b(to)f(access)h(the)f(same)h(\014le)f(b)m(y)f
(calling)j('fptr)d(=)h(CUnit2FITS\(12\)'.)64 b(These)38
b(routines)g(return)f(a)227 2100 y(v)-5 b(alue)31 b(of)g(zero)g(if)f
(an)g(error)g(o)s(ccurs.)286 2351 y Fe(int)334 b(CFITS2Unit\(fitsfile)
42 b(*ptr\);)286 2464 y(fitsfile*)k(CUnit2FITS\(int)e(unit\);)0
2715 y Fh(11)i Fi(P)m(arse)32 b(the)g(input)e(\014lename)i(and)f
(return)f(the)i(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 2828 y(op)s(ened)i(with)
g(FTNOPN.)g(The)f(returned)g(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(,)35 b(so)227
2941 y(for)d(example,)g(if)g(the)g(input)f(\014lename)g(=)h(`m)m
(y\014le.\014ts[2]')h(then)e(hdun)m(um)e(=)j(3)g(will)g(b)s(e)f
(returned.)43 b(FIT-)227 3054 y(SIO)35 b(do)s(es)h(not)g(op)s(en)g(the)
g(\014le)g(to)h(c)m(hec)m(k)h(if)e(the)g(extension)h(actually)h(exists)
e(if)h(an)e(extension)i(n)m(um)m(b)s(er)227 3167 y(is)43
b(sp)s(eci\014ed.)75 b(If)42 b(an)g(extension)h(*name*)g(is)f(included)
g(in)g(the)g(\014le)g(name)h(sp)s(eci\014cation)g(\(e.g.)77
b(`m)m(y-)227 3280 y(\014le.\014ts[EVENTS]')30 b(then)f(this)h(routine)
g(will)g(ha)m(v)m(e)h(to)f(op)s(en)f(the)h(FITS)f(\014le)h(and)f(lo)s
(ok)h(for)g(the)g(p)s(osition)227 3393 y(of)38 b(the)h(named)e
(extension,)k(then)d(close)h(\014le)f(again.)64 b(This)38
b(is)g(not)g(p)s(ossible)f(if)h(the)g(\014le)g(is)g(b)s(eing)g(read)227
3506 y(from)e(the)g(stdin)f(stream,)j(and)d(an)h(error)f(will)h(b)s(e)g
(returned)e(in)i(this)g(case.)58 b(If)35 b(the)h(\014lename)g(do)s(es)g
(not)227 3619 y(sp)s(ecify)29 b(an)g(explicit)h(extension)g(\(e.g.)42
b('m)m(y\014le.\014ts'\))30 b(then)f(hdun)m(um)e(=)h(-99)j(will)e(b)s
(e)g(returned,)f(whic)m(h)h(is)227 3731 y(functionally)34
b(equiv)-5 b(alen)m(t)35 b(to)g(hdun)m(um)c(=)i(1.)50
b(This)33 b(routine)g(is)h(mainly)g(used)e(for)i(bac)m(kw)m(ard)g
(compati-)227 3844 y(bilit)m(y)g(in)e(the)g(fto)s(ols)h(soft)m(w)m(are)
h(pac)m(k)-5 b(age)34 b(and)e(is)g(not)g(recommended)g(for)g(general)i
(use.)46 b(It)32 b(is)h(generally)227 3957 y(b)s(etter)i(and)g(more)g
(e\016cien)m(t)h(to)g(\014rst)e(op)s(en)g(the)h(FITS)f(\014le)h(with)g
(FTNOPN,)g(then)g(use)f(FTGHDN)i(to)227 4070 y(determine)30
b(whic)m(h)g(HDU)g(in)f(the)h(\014le)g(has)g(b)s(een)f(op)s(ened,)g
(rather)g(than)h(calling)h(FTEXTN)f(follo)m(w)m(ed)h(b)m(y)227
4183 y(a)g(call)h(to)f(FTNOPN.)382 4434 y Fe(FTEXTN\(filename,)43
b(>)48 b(nhdu,)e(status\))0 4686 y Fh(12)g Fi(Return)30
b(the)g(name)h(of)f(the)h(op)s(ened)e(FITS)h(\014le.)382
4937 y Fe(FTFLNM\(unit,)44 b(>)k(filename,)d(status\))0
5188 y Fh(13)h Fi(Return)30 b(the)g(I/O)g(mo)s(de)g(of)h(the)g(op)s(en)
e(FITS)h(\014le)g(\(READONL)-8 b(Y)32 b(=)e(0,)h(READ)m(WRITE)g(=)f
(1\).)382 5440 y Fe(FTFLMD\(unit,)44 b(>)k(iomode,)e(status\))0
5691 y Fh(14)g Fi(Return)30 b(the)g(\014le)h(t)m(yp)s(e)f(of)h(the)f
(op)s(ened)g(FITS)g(\014le)g(\(e.g.)42 b('\014le://',)32
b('ftp://',)g(etc.\).)p eop end
%%Page: 38 44
TeXDict begin 38 43 bop 0 299 a Fi(38)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTURLT\(unit,)44 b(>)k(urltype,)d
(status\))0 819 y Fh(15)h Fi(P)m(arse)27 b(the)f(input)f(\014lename)i
(or)f(URL)g(in)m(to)h(its)g(comp)s(onen)m(t)f(parts:)39
b(the)26 b(\014le)g(t)m(yp)s(e)h(\(\014le://,)h(ftp://,)g(h)m(ttp://,)
227 932 y(etc\),)34 b(the)e(base)g(input)e(\014le)i(name,)g(the)g(name)
g(of)g(the)g(output)f(\014le)h(that)g(the)g(input)f(\014le)g(is)h(to)g
(b)s(e)f(copied)227 1045 y(to)38 b(prior)e(to)h(op)s(ening,)h(the)f
(HDU)g(or)f(extension)i(sp)s(eci\014cation,)h(the)e(\014ltering)f(sp)s
(eci\014er,)i(the)f(binning)227 1157 y(sp)s(eci\014er,)e(and)e(the)i
(column)f(sp)s(eci\014er.)51 b(Blank)34 b(strings)g(will)h(b)s(e)e
(returned)g(for)h(an)m(y)g(comp)s(onen)m(ts)g(that)227
1270 y(are)d(not)g(presen)m(t)f(in)g(the)h(input)e(\014le)i(name.)334
1534 y Fe(FTIURL\(filename,)43 b(>)48 b(filetype,)d(infile,)h(outfile,)
g(extspec,)f(filter,)716 1647 y(binspec,)g(colspec,)h(status\))0
1910 y Fh(16)g Fi(P)m(arse)e(the)g(input)f(\014le)h(name)f(and)g
(return)g(the)h(ro)s(ot)g(\014le)f(name.)81 b(The)43
b(ro)s(ot)h(name)g(includes)f(the)h(\014le)227 2023 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 2136 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)227 2249 y(sp)s(eci\014cations.)334
2513 y Fe(FTRTNM\(filename,)43 b(>)48 b(rootname,)d(status\))0
2776 y Fh(16)h Fi(T)-8 b(est)36 b(if)g(the)g(input)f(\014le)h(or)f(a)i
(compressed)e(v)m(ersion)h(of)g(the)g(\014le)g(\(with)g(a)g(.gz,)i(.Z,)
e(.z,)i(or)e(.zip)g(extension\))227 2889 y(exists)j(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
3002 y(v)-5 b(alues:)370 3257 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
3370 y(1:)95 b(the)47 b(disk)g(file)g(does)f(exist)370
3483 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 3596 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 3709 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\))286
3973 y(FTEXIST\(filename,)d(>)48 b(exists,)e(status\);)0
4311 y Fd(6.2)135 b(HDU-Lev)l(el)47 b(Op)t(erations)0
4562 y Fi(When)30 b(a)h(FITS)f(\014le)g(is)h(\014rst)e(op)s(ened)h(or)g
(created,)i(the)f(in)m(ternal)g(bu\013ers)e(in)h(FITSIO)f
(automatically)34 b(p)s(oin)m(t)c(to)0 4675 y(the)g(\014rst)g(HDU)h(in)
f(the)g(\014le.)41 b(The)29 b(follo)m(wing)j(routines)e(ma)m(y)h(b)s(e)
e(used)h(to)h(mo)m(v)m(e)g(to)g(another)f(HDU)h(in)f(the)h(\014le.)0
4788 y(Note)j(that)f(the)g(HDU)g(n)m(um)m(b)s(ering)f(con)m(v)m(en)m
(tion)i(used)e(in)g(FITSIO)g(denotes)h(the)f(primary)g(arra)m(y)h(as)g
(the)g(\014rst)0 4901 y(HDU,)e(the)g(\014rst)f(extension)h(in)f(a)g
(FITS)g(\014le)g(is)h(the)f(second)h(HDU,)g(and)f(so)h(on.)0
5164 y Fh(1)81 b Fi(Mo)m(v)m(e)32 b(to)f(a)g(sp)s(eci\014ed)f
(\(absolute\))h(HDU)g(in)g(the)f(FITS)g(\014le)g(\(nhdu)f(=)h(1)h(for)f
(the)g(FITS)g(primary)f(arra)m(y\))382 5428 y Fe(FTMAHD\(unit,nhdu,)43
b(>)k(hdutype,status\))0 5691 y Fh(2)81 b Fi(Mo)m(v)m(e)32
b(to)f(a)g(new)f(\(existing\))i(HDU)f(forw)m(ard)f(or)g(bac)m(kw)m
(ards)h(relativ)m(e)h(to)f(the)g(CHDU)p eop end
%%Page: 39 45
TeXDict begin 39 44 bop 0 299 a Fg(6.2.)72 b(HDU-LEVEL)31
b(OPERA)-8 b(TIONS)2414 b Fi(39)382 555 y Fe(FTMRHD\(unit,nmove,)43
b(>)k(hdutype,status\))0 788 y Fh(3)81 b Fi(Mo)m(v)m(e)22
b(to)f(the)f(\(\014rst\))h(HDU)g(whic)m(h)f(has)g(the)g(sp)s(eci\014ed)
g(extension)h(t)m(yp)s(e)f(and)g(EXTNAME)g(\(or)h(HDUNAME\))227
901 y(and)34 b(EXTVER)g(k)m(eyw)m(ord)h(v)-5 b(alues.)53
b(The)34 b(hdut)m(yp)s(e)f(parameter)i(ma)m(y)g(ha)m(v)m(e)g(a)g(v)-5
b(alue)35 b(of)f(IMA)m(GE)p 3665 901 28 4 v 34 w(HDU)227
1014 y(\(0\),)43 b(ASCI)s(I)p 669 1014 V 31 w(TBL)c(\(1\),)j(BINAR)-8
b(Y)p 1468 1014 V 34 w(TBL)39 b(\(2\),)j(or)d(ANY)p 2234
1014 V 34 w(HDU)g(\(-1\))i(where)d(ANY)p 3173 1014 V
34 w(HDU)h(means)g(that)227 1127 y(only)30 b(the)g(extname)h(and)e
(extv)m(er)i(v)-5 b(alues)30 b(will)g(b)s(e)f(used)g(to)i(lo)s(cate)g
(the)f(correct)h(extension.)42 b(If)29 b(the)h(input)227
1240 y(v)-5 b(alue)27 b(of)f(extv)m(er)h(is)f(0)g(then)g(the)g(EXTVER)g
(k)m(eyw)m(ord)g(is)g(ignored)g(and)g(the)g(\014rst)f(HDU)i(with)e(a)i
(matc)m(hing)227 1353 y(EXTNAME)g(\(or)g(HDUNAME\))h(k)m(eyw)m(ord)f
(will)g(b)s(e)f(found.)38 b(If)26 b(no)h(matc)m(hing)h(HDU)f(is)g
(found)e(in)h(the)h(\014le)227 1466 y(then)i(the)g(curren)m(t)g(HDU)h
(will)f(remain)g(unc)m(hanged)g(and)g(a)g(status)g(=)g(BAD)p
2884 1466 V 34 w(HDU)p 3123 1466 V 33 w(NUM)h(\(301\))h(will)f(b)s(e)
227 1578 y(returned.)382 1811 y Fe(FTMNHD\(unit,)44 b(hdutype,)i
(extname,)f(extver,)h(>)i(status\))0 2044 y Fh(4)81 b
Fi(Get)31 b(the)g(n)m(um)m(b)s(er)e(of)h(the)h(curren)m(t)f(HDU)h(in)f
(the)h(FITS)e(\014le)i(\(primary)f(arra)m(y)g(=)g(1\))382
2277 y Fe(FTGHDN\(unit,)44 b(>)k(nhdu\))0 2510 y Fh(5)81
b Fi(Return)39 b(the)i(t)m(yp)s(e)g(of)g(the)g(curren)m(t)f(HDU)i(in)e
(the)h(FITS)f(\014le.)71 b(The)41 b(p)s(ossible)f(v)-5
b(alues)41 b(for)f(hdut)m(yp)s(e)g(are)227 2623 y(IMA)m(GE)p
546 2623 V 34 w(HDU)31 b(\(0\),)h(ASCI)s(I)p 1242 2623
V 31 w(TBL)e(\(1\),)i(or)e(BINAR)-8 b(Y)p 2133 2623 V
34 w(TBL)30 b(\(2\).)382 2856 y Fe(FTGHDT\(unit,)44 b(>)k(hdutype,)d
(status\))0 3089 y Fh(6)81 b Fi(Return)29 b(the)i(total)h(n)m(um)m(b)s
(er)d(of)i(HDUs)f(in)h(the)f(FITS)g(\014le.)41 b(The)29
b(CHDU)i(remains)f(unc)m(hanged.)382 3322 y Fe(FTTHDU\(unit,)44
b(>)k(hdunum,)e(status\))0 3554 y Fh(7)81 b Fi(Create)36
b(\(app)s(end\))e(a)h(new)g(empt)m(y)g(HDU)h(follo)m(wing)h(the)e(last)
h(extension)g(that)g(has)f(b)s(een)f(previously)h(ac-)227
3667 y(cessed)41 b(b)m(y)f(the)g(program.)70 b(This)40
b(will)g(o)m(v)m(erwrite)i(an)m(y)f(extensions)g(in)e(an)i(existing)g
(FITS)e(\014le)i(if)f(the)227 3780 y(program)31 b(has)g(not)g(already)h
(mo)m(v)m(ed)g(to)f(that)h(\(or)f(a)h(later\))g(extension)g(using)e
(the)h(FTMAHD)h(or)f(FTM-)227 3893 y(RHD)24 b(routines.)38
b(F)-8 b(or)25 b(example,)g(if)f(an)f(existing)h(FITS)f(\014le)g(con)m
(tains)i(a)f(primary)e(arra)m(y)i(and)f(5)g(extensions)227
4006 y(and)31 b(a)h(program)f(\(1\))h(op)s(ens)f(the)g(FITS)g(\014le,)h
(\(2\))g(mo)m(v)m(es)h(to)f(extension)g(4,)g(\(3\))g(mo)m(v)m(es)h(bac)
m(k)f(to)g(the)f(pri-)227 4119 y(mary)36 b(arra)m(y)-8
b(,)38 b(and)e(\(4\))h(then)e(calls)i(FTCRHD,)f(then)g(the)g(new)g
(extension)g(will)g(b)s(e)g(written)f(follo)m(wing)227
4232 y(the)c(4th)f(extension,)i(o)m(v)m(erwriting)g(the)e(existing)h
(5th)g(extension.)382 4465 y Fe(FTCRHD\(unit,)44 b(>)k(status\))0
4698 y Fh(8)81 b Fi(Create)30 b(a)f(primary)f(arra)m(y)i(\(if)g(none)f
(already)g(exists\),)i(or)e(insert)g(a)h(new)f(IMA)m(GE)h(extension)g
(immediately)227 4811 y(follo)m(wing)25 b(the)e(CHDU,)g(or)g(insert)g
(a)g(new)g(Primary)f(Arra)m(y)h(at)h(the)f(b)s(eginning)f(of)h(the)g
(\014le.)38 b(An)m(y)23 b(follo)m(wing)227 4924 y(extensions)29
b(in)g(the)g(\014le)f(will)h(b)s(e)f(shifted)h(do)m(wn)f(to)h(mak)m(e)h
(ro)s(om)e(for)h(the)g(new)f(extension.)40 b(If)29 b(the)g(CHDU)227
5036 y(is)h(the)g(last)g(HDU)g(in)g(the)f(\014le)h(then)f(the)h(new)f
(image)i(extension)f(will)g(simply)f(b)s(e)g(app)s(ended)f(to)i(the)g
(end)227 5149 y(of)k(the)h(\014le.)52 b(One)33 b(can)h(force)h(a)g(new)
e(primary)g(arra)m(y)i(to)g(b)s(e)e(inserted)h(at)h(the)f(b)s(eginning)
f(of)h(the)h(FITS)227 5262 y(\014le)29 b(b)m(y)f(setting)i(status)e(=)h
(-9)g(prior)e(to)j(calling)g(the)e(routine.)40 b(In)28
b(this)g(case)i(the)e(existing)i(primary)d(arra)m(y)227
5375 y(will)f(b)s(e)f(con)m(v)m(erted)i(to)g(an)e(IMA)m(GE)h
(extension.)40 b(The)25 b(new)g(extension)i(\(or)f(primary)e(arra)m
(y\))j(will)f(b)s(ecome)227 5488 y(the)32 b(CHDU.)f(The)g(FTI)s(IMGLL)f
(routine)i(is)f(iden)m(tical)i(to)e(the)h(FTI)s(IMG)f(routine)g(except)
h(that)f(the)h(4th)227 5601 y(parameter)25 b(\(the)g(length)g(of)f(eac)
m(h)h(axis\))g(is)g(an)f(arra)m(y)h(of)f(64-bit)i(in)m(tegers)f(rather)
f(than)g(an)g(arra)m(y)h(of)g(32-bit)227 5714 y(in)m(tegers.)p
eop end
%%Page: 40 46
TeXDict begin 40 45 bop 0 299 a Fi(40)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTIIMG\(unit,bitpix,naxis)o(,na)o(xes,)41
b(>)48 b(status\))382 668 y(FTIIMGLL\(unit,bitpix,nax)o(is,)o(naxe)o
(sll,)41 b(>)47 b(status\))0 921 y Fh(9)81 b Fi(Insert)30
b(a)i(new)f(ASCI)s(I)f(T)-8 b(ABLE)31 b(extension)h(immediately)h
(follo)m(wing)f(the)g(CHDU.)g(An)m(y)f(follo)m(wing)i(exten-)227
1034 y(sions)26 b(will)g(b)s(e)f(shifted)g(do)m(wn)g(to)h(mak)m(e)h(ro)
s(om)e(for)h(the)f(new)g(extension.)40 b(If)25 b(there)h(are)g(no)g
(other)f(follo)m(wing)227 1147 y(extensions)32 b(then)f(the)h(new)f
(table)h(extension)g(will)g(simply)f(b)s(e)g(app)s(ended)f(to)i(the)f
(end)g(of)h(the)f(\014le.)44 b(The)227 1260 y(new)33
b(extension)h(will)f(b)s(ecome)h(the)f(CHDU.)h(The)f(FTIT)-8
b(ABLL)33 b(routine)g(is)g(iden)m(tical)i(to)f(the)g(FTIT)-8
b(AB)227 1373 y(routine)36 b(except)g(that)g(the)f(2nd)g(and)g(3rd)g
(parameters)g(\(that)i(giv)m(e)g(the)e(size)h(of)g(the)f(table\))i(are)
f(64-bit)227 1486 y(in)m(tegers)c(rather)e(than)g(32-bit)i(in)m
(tegers.)382 1739 y Fe(FTITAB\(unit,rowlen,nrows)o(,tf)o(ield)o(s,tt)o
(ype)o(,tbc)o(ol,t)o(for)o(m,tu)o(nit,)o(ext)o(name)o(,)42
b(>)716 1852 y(status\))382 1965 y(FTITABLL\(unit,rowlenll,n)o(row)o
(sll,)o(tfie)o(lds)o(,tty)o(pe,t)o(bco)o(l,tf)o(orm,)o(tun)o(it,e)o
(xtna)o(me,)f(>)716 2077 y(status\))0 2331 y Fh(10)46
b Fi(Insert)25 b(a)h(new)f(binary)f(table)j(extension)f(immediately)g
(follo)m(wing)h(the)f(CHDU.)g(An)m(y)g(follo)m(wing)g(extensions)227
2443 y(will)39 b(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.)66 b(If)38 b(there)h(are)f(no)h(other)f
(follo)m(wing)227 2556 y(extensions)f(then)g(the)f(new)g(bin)m(table)h
(extension)h(will)f(simply)f(b)s(e)g(app)s(ended)e(to)k(the)e(end)g(of)
h(the)g(\014le.)227 2669 y(The)23 b(new)g(extension)h(will)f(b)s(ecome)
h(the)f(CHDU.)h(The)f(FTIBINLL)g(routine)g(is)g(iden)m(tical)i(to)f
(the)g(FTIBIN)227 2782 y(routine)30 b(except)i(that)e(the)h(2nd)e
(parameter)i(\(that)g(giv)m(es)g(the)g(length)f(of)h(the)f(table\))h
(is)g(a)f(64-bit)i(in)m(teger)227 2895 y(rather)f(than)f(a)g(32-bit)i
(in)m(teger.)382 3148 y Fe(FTIBIN\(unit,nrows,tfield)o(s,t)o(type)o
(,tfo)o(rm,)o(tuni)o(t,ex)o(tna)o(me,v)o(arid)o(at)41
b(>)48 b(status\))382 3261 y(FTIBINLL\(unit,nrowsll,tf)o(iel)o(ds,t)o
(type)o(,tf)o(orm,)o(tuni)o(t,e)o(xtna)o(me,v)o(ari)o(dat)41
b(>)48 b(status\))0 3627 y Fh(11)e Fi(Resize)26 b(an)e(image)i(b)m(y)e
(mo)s(di\014ng)f(the)i(size,)i(dimensions,)e(and/or)f(datat)m(yp)s(e)h
(of)g(the)g(curren)m(t)f(primary)f(arra)m(y)227 3740
y(or)29 b(image)i(extension.)40 b(If)29 b(the)g(new)g(image,)i(as)e(sp)
s(eci\014ed)f(b)m(y)h(the)g(input)f(argumen)m(ts,)i(is)f(larger)h(than)
f(the)227 3853 y(curren)m(t)34 b(existing)h(image)g(in)f(the)g(FITS)f
(\014le)h(then)f(zero)i(\014ll)f(data)h(will)f(b)s(e)f(inserted)h(at)g
(the)g(end)g(of)g(the)227 3966 y(curren)m(t)25 b(image)h(and)e(an)m(y)i
(follo)m(wing)g(extensions)g(will)f(b)s(e)f(mo)m(v)m(ed)i(further)e
(bac)m(k)h(in)g(the)g(\014le.)39 b(Similarly)-8 b(,)27
b(if)227 4079 y(the)h(new)e(image)j(is)e(smaller)h(than)f(the)g(curren)
m(t)g(image)h(then)f(an)m(y)h(follo)m(wing)h(extensions)e(will)h(b)s(e)
e(shifted)227 4192 y(up)32 b(to)m(w)m(ards)i(the)g(b)s(eginning)e(of)h
(the)h(FITS)e(\014le)h(and)g(the)g(image)h(data)g(will)g(b)s(e)e
(truncated)h(to)h(the)f(new)227 4304 y(size.)41 b(This)25
b(routine)h(rewrites)h(the)f(BITPIX,)h(NAXIS,)f(and)g(NAXISn)g(k)m(eyw)
m(ords)g(with)g(the)h(appropriate)227 4417 y(v)-5 b(alues)37
b(for)f(new)h(image.)60 b(The)36 b(FTRSIMLL)g(routine)g(is)h(iden)m
(tical)h(to)g(the)e(FTRSIM)g(routine)h(except)227 4530
y(that)30 b(the)g(4th)g(parameter)g(\(the)g(length)g(of)f(eac)m(h)i
(axis\))f(is)g(an)f(arra)m(y)h(of)g(64-bit)h(in)m(tegers)f(rather)g
(than)f(an)227 4643 y(arra)m(y)i(of)g(32-bit)g(in)m(tegers.)382
4896 y Fe(FTRSIM\(unit,bitpix,naxis)o(,na)o(xes,)o(stat)o(us\))382
5009 y(FTRSIMLL\(unit,bitpix,nax)o(is,)o(naxe)o(sll,)o(sta)o(tus\))0
5262 y Fh(12)46 b Fi(Delete)34 b(the)f(CHDU)g(in)f(the)g(FITS)f
(\014le.)47 b(An)m(y)32 b(follo)m(wing)i(HDUs)f(will)g(b)s(e)e(shifted)
h(forw)m(ard)g(in)g(the)g(\014le,)h(to)227 5375 y(\014ll)38
b(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
5488 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 5601 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 5714 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)p
eop end
%%Page: 41 47
TeXDict begin 41 46 bop 0 299 a Fg(6.3.)72 b(DEFINE)31
b(OR)f(REDEFINE)h(THE)f(STR)m(UCTURE)f(OF)h(THE)g(CHDU)1042
b Fi(41)227 555 y(the)27 b(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 668 y(to)35 b(p)s(oin)m(t)f(to)h
(the)f(previous)f(HDU.)i(The)e(output)h(HDUTYPE)g(parameter)h
(indicates)f(the)h(t)m(yp)s(e)f(of)g(the)227 781 y(new)c(CHDU)h(after)g
(the)f(previous)g(CHDU)h(has)f(b)s(een)g(deleted.)382
1001 y Fe(FTDHDU\(unit,)44 b(>)k(hdutype,status\))0 1222
y Fh(13)e Fi(Cop)m(y)36 b(all)h(or)f(part)g(of)g(the)g(input)f(FITS)g
(\014le)h(and)g(app)s(end)e(it)i(to)h(the)f(end)g(of)g(the)g(output)g
(FITS)f(\014le.)57 b(If)227 1335 y('previous')39 b(\(an)g(in)m(teger)h
(parameter\))g(is)f(not)g(equal)g(to)h(0,)h(then)e(an)m(y)g(HDUs)g
(preceding)g(the)g(curren)m(t)227 1448 y(HDU)f(in)e(the)h(input)e
(\014le)i(will)g(b)s(e)f(copied)h(to)g(the)g(output)f(\014le.)60
b(Similarly)-8 b(,)39 b('curren)m(t')e(and)f('follo)m(wing')227
1561 y(determine)j(whether)f(the)h(curren)m(t)g(HDU,)h(and/or)e(an)m(y)
i(follo)m(wing)g(HDUs)f(in)g(the)g(input)f(\014le)g(will)i(b)s(e)227
1674 y(copied)32 b(to)g(the)g(output)f(\014le.)43 b(If)31
b(all)h(3)g(parameters)g(are)g(not)f(equal)h(to)g(zero,)h(then)e(the)g
(en)m(tire)h(input)f(\014le)227 1786 y(will)g(b)s(e)e(copied.)41
b(On)30 b(return,)f(the)h(curren)m(t)g(HDU)h(in)f(the)g(input)f(\014le)
h(will)h(b)s(e)e(unc)m(hanged,)h(and)g(the)g(last)227
1899 y(copied)h(HDU)g(will)g(b)s(e)f(the)g(curren)m(t)g(HDU)i(in)e(the)
g(output)g(\014le.)382 2120 y Fe(FTCPFL\(iunit,)44 b(ounit,)i
(previous,)f(current,)h(following,)f(>)i(status\))0 2340
y Fh(14)f Fi(Cop)m(y)35 b(the)f(en)m(tire)i(CHDU)f(from)f(the)g(FITS)g
(\014le)h(asso)s(ciated)h(with)e(IUNIT)g(to)i(the)e(CHDU)h(of)g(the)g
(FITS)227 2453 y(\014le)g(asso)s(ciated)h(with)e(OUNIT.)g(The)g(output)
g(HDU)h(m)m(ust)f(b)s(e)g(empt)m(y)h(and)e(not)i(already)g(con)m(tain)h
(an)m(y)227 2566 y(k)m(eyw)m(ords.)41 b(Space)29 b(will)g(b)s(e)g
(reserv)m(ed)g(for)g(MOREKEYS)f(additional)h(k)m(eyw)m(ords)h(in)e(the)
i(output)e(header)227 2679 y(if)j(there)f(is)h(not)f(already)h(enough)f
(space.)382 2899 y Fe(FTCOPY\(iunit,ounit,morek)o(eys)o(,)42
b(>)47 b(status\))0 3120 y Fh(15)f Fi(Cop)m(y)27 b(the)h(header)f
(\(and)g(not)g(the)g(data\))i(from)d(the)i(CHDU)g(asso)s(ciated)g(with)
f(in)m(unit)g(to)h(the)f(CHDU)h(asso-)227 3233 y(ciated)f(with)e
(outunit.)39 b(If)25 b(the)g(curren)m(t)h(output)f(HDU)h(is)f(not)h
(completely)h(empt)m(y)-8 b(,)27 b(then)e(the)h(CHDU)g(will)227
3346 y(b)s(e)e(closed)i(and)e(a)i(new)e(HDU)h(will)h(b)s(e)e(app)s
(ended)f(to)j(the)f(output)f(\014le.)39 b(This)24 b(routine)h(will)g
(automatically)227 3459 y(transform)31 b(the)g(necessary)h(k)m(eyw)m
(ords)f(when)g(cop)m(ying)h(a)f(primary)g(arra)m(y)h(to)f(and)g(image)i
(extension,)f(or)227 3572 y(an)27 b(image)h(extension)f(to)g(a)h
(primary)d(arra)m(y)-8 b(.)41 b(An)26 b(empt)m(y)h(output)f(data)i
(unit)e(will)h(b)s(e)f(created)i(\(all)g(v)-5 b(alues)227
3684 y(=)30 b(0\).)382 3905 y Fe(FTCPHD\(inunit,)44 b(outunit,)h(>)j
(status\))0 4125 y Fh(16)e Fi(Cop)m(y)d(just)g(the)g(data)h(from)f(the)
g(CHDU)h(asso)s(ciated)g(with)f(IUNIT)g(to)h(the)f(CHDU)h(asso)s
(ciated)g(with)227 4238 y(OUNIT.)26 b(This)f(will)h(o)m(v)m(erwrite)h
(an)m(y)f(data)g(previously)g(in)f(the)h(OUNIT)f(CHDU.)h(This)f(lo)m(w)
i(lev)m(el)g(routine)227 4351 y(is)g(used)e(b)m(y)i(FTCOPY,)f(but)g(it)
g(ma)m(y)i(also)f(b)s(e)f(useful)f(in)i(certain)g(application)h
(programs)e(whic)m(h)g(w)m(an)m(t)h(to)227 4464 y(cop)m(y)j(the)f(data)
h(from)f(one)g(FITS)f(\014le)h(to)h(another)f(but)g(also)h(w)m(an)m(t)g
(to)g(mo)s(dify)e(the)h(header)g(k)m(eyw)m(ords)g(in)227
4577 y(the)j(pro)s(cess.)44 b(all)33 b(the)f(required)f(header)g(k)m
(eyw)m(ords)h(m)m(ust)g(b)s(e)f(written)h(to)g(the)g(OUNIT)f(CHDU)h(b)s
(efore)227 4690 y(calling)g(this)e(routine)382 4910 y
Fe(FTCPDT\(iunit,ounit,)42 b(>)48 b(status\))0 5238 y
Fd(6.3)135 b(De\014ne)45 b(or)g(Rede\014ne)h(the)f(structure)g(of)g
(the)g(CHDU)0 5488 y Fi(It)32 b(should)f(rarely)h(b)s(e)g(necessary)g
(to)h(call)g(the)f(subroutines)f(in)g(this)h(section.)47
b(FITSIO)30 b(in)m(ternally)j(calls)g(these)0 5601 y(routines)h(whenev)
m(er)g(necessary)-8 b(,)36 b(so)e(an)m(y)g(calls)h(to)g(these)f
(routines)g(b)m(y)g(application)h(programs)f(will)g(lik)m(ely)i(b)s(e)0
5714 y(redundan)m(t.)p eop end
%%Page: 42 48
TeXDict begin 42 47 bop 0 299 a Fi(42)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fh(1)81 b Fi(This)36 b(routine)h(forces)h
(FITSIO)e(to)i(scan)f(the)g(curren)m(t)g(header)g(k)m(eyw)m(ords)h
(that)f(de\014ne)g(the)g(structure)g(of)227 668 y(the)31
b(HDU)f(\(suc)m(h)g(as)h(the)f(NAXISn,)g(PCOUNT)f(and)g(GCOUNT)h(k)m
(eyw)m(ords\))h(so)f(that)h(it)f(can)h(initialize)227
781 y(the)36 b(in)m(ternal)g(bu\013ers)e(that)i(describ)s(e)f(the)h
(HDU)g(structure.)55 b(This)35 b(routine)h(ma)m(y)g(b)s(e)e(used)h
(instead)h(of)227 894 y(the)j(more)g(complicated)i(calls)f(to)f(ftp)s
(def,)h(ftadef)f(or)g(ftb)s(def.)65 b(This)38 b(routine)h(is)g(also)h
(v)m(ery)f(useful)f(for)227 1007 y(reinitializing)e(the)e(structure)g
(of)g(an)f(HDU,)i(if)f(the)g(n)m(um)m(b)s(er)e(of)i(ro)m(ws)g(in)g(a)g
(table,)i(as)e(sp)s(eci\014ed)f(b)m(y)h(the)227 1120
y(NAXIS2)d(k)m(eyw)m(ord,)g(has)f(b)s(een)g(mo)s(di\014ed)f(from)h(its)
h(initial)g(v)-5 b(alue.)382 1361 y Fe(FTRDEF\(unit,)44
b(>)k(status\))141 b(\(DEPRECATED\))0 1602 y Fh(2)81
b Fi(De\014ne)27 b(the)g(structure)g(of)g(the)g(primary)f(arra)m(y)i
(or)f(IMA)m(GE)h(extension.)40 b(When)27 b(writing)g(GR)m(OUP)m(ed)h
(FITS)227 1715 y(\014les)43 b(that)h(b)m(y)e(con)m(v)m(en)m(tion)k(set)
d(the)g(NAXIS1)g(k)m(eyw)m(ord)h(equal)f(to)h(0,)i(ftp)s(def)c(m)m(ust)
h(b)s(e)f(called)i(with)227 1828 y(naxes\(1\))27 b(=)e(1,)i(NOT)e(0,)i
(otherwise)f(FITSIO)e(will)i(rep)s(ort)f(an)g(error)g(status=308)i
(when)d(trying)i(to)g(write)227 1941 y(data)31 b(to)g(a)g(group.)40
b(Note:)i(it)31 b(is)g(usually)f(simpler)g(to)h(call)h(FTRDEF)e(rather)
h(than)f(this)g(routine.)382 2182 y Fe(FTPDEF\(unit,bitpix,naxis)o(,na)
o(xes,)o(pcou)o(nt,)o(gcou)o(nt,)41 b(>)48 b(status\))93
b(\(DEPRECATED\))0 2424 y Fh(3)81 b Fi(De\014ne)32 b(the)h(structure)f
(of)g(an)h(ASCI)s(I)e(table)i(\(T)-8 b(ABLE\))33 b(extension.)48
b(Note:)e(it)33 b(is)f(usually)g(simpler)g(to)i(call)227
2537 y(FTRDEF)d(rather)f(than)h(this)f(routine.)382 2778
y Fe(FTADEF\(unit,rowlen,tfiel)o(ds,)o(tbco)o(l,tf)o(orm)o(,nro)o(ws)42
b(>)47 b(status\))f(\(DEPRECATED\))0 3019 y Fh(4)81 b
Fi(De\014ne)35 b(the)h(structure)f(of)g(a)h(binary)f(table)h(\(BINT)-8
b(ABLE\))37 b(extension.)56 b(Note:)d(it)36 b(is)f(usually)g(simpler)g
(to)227 3132 y(call)d(FTRDEF)f(rather)f(than)g(this)g(routine.)382
3373 y Fe(FTBDEF\(unit,tfields,tfor)o(m,v)o(arid)o(at,n)o(row)o(s)42
b(>)47 b(status\))f(\(DEPRECATED\))0 3615 y Fh(5)81 b
Fi(De\014ne)34 b(the)g(size)h(of)f(the)g(Curren)m(t)f(Data)i(Unit,)h(o)
m(v)m(erriding)e(the)g(length)h(of)f(the)g(data)h(unit)e(as)h
(previously)227 3728 y(de\014ned)e(b)m(y)h(ftp)s(def,)g(ftadef,)i(or)e
(ftb)s(def.)48 b(This)33 b(is)g(useful)f(if)i(one)f(do)s(es)g(not)h
(kno)m(w)f(the)g(total)i(size)f(of)g(the)227 3841 y(data)f(unit)f(un)m
(til)h(after)f(the)h(data)g(ha)m(v)m(e)g(b)s(een)f(written.)46
b(The)32 b(size)h(\(in)f(b)m(ytes\))h(of)g(an)f(ASCI)s(I)f(or)h(Binary)
227 3954 y(table)27 b(is)f(giv)m(en)g(b)m(y)g(NAXIS1)g(*)g(NAXIS2.)40
b(\(Note)27 b(that)f(to)h(determine)f(the)f(v)-5 b(alue)27
b(of)f(NAXIS1)f(it)i(is)f(often)227 4066 y(more)32 b(con)m(v)m(enien)m
(t)h(to)f(read)f(the)g(v)-5 b(alue)32 b(of)f(the)h(NAXIS1)f(k)m(eyw)m
(ord)h(from)e(the)i(output)e(\014le,)i(rather)f(than)227
4179 y(computing)f(the)g(ro)m(w)g(length)h(directly)f(from)f(all)i(the)
f(TF)m(ORM)h(k)m(eyw)m(ord)f(v)-5 b(alues\).)41 b(Note:)h(it)30
b(is)g(usually)227 4292 y(simpler)g(to)h(call)h(FTRDEF)f(rather)f(than)
g(this)g(routine.)382 4534 y Fe(FTDDEF\(unit,bytlen,)42
b(>)48 b(status\))e(\(DEPRECATED\))0 4775 y Fh(6)81 b
Fi(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 4888 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 5001 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 5114
y(v)-5 b(ariable)36 b(length)g(arra)m(y)f(columns)g(\(with)h(TF)m(ORMn)
f(=)f('Pt'\).)57 b(This)34 b(subroutine)g(also)i(automatically)227
5227 y(writes)23 b(the)g(v)-5 b(alue)23 b(of)g(theap)g(to)h(a)f(k)m
(eyw)m(ord)g(in)g(the)g(extension)g(header.)38 b(This)22
b(subroutine)g(m)m(ust)h(b)s(e)f(called)227 5339 y(after)27
b(the)f(required)f(k)m(eyw)m(ords)i(ha)m(v)m(e)g(b)s(een)e(written)h
(\(with)g(ftph)m(bn\))f(and)h(after)g(the)h(table)g(structure)e(has)227
5452 y(b)s(een)30 b(de\014ned)f(\(with)h(ftb)s(def)7
b(\))30 b(but)g(b)s(efore)g(an)m(y)g(data)h(is)g(written)f(to)h(the)g
(table.)382 5694 y Fe(FTPTHP\(unit,theap,)43 b(>)k(status\))p
eop end
%%Page: 43 49
TeXDict begin 43 48 bop 0 299 a Fg(6.4.)72 b(FITS)30
b(HEADER)h(I/O)f(SUBR)m(OUTINES)2086 b Fi(43)0 555 y
Fd(6.4)135 b(FITS)44 b(Header)i(I/O)f(Subroutines)0 809
y Fb(6.4.1)112 b(Header)38 b(Space)h(and)f(P)m(osition)f(Routines)0
1019 y Fh(1)81 b Fi(Reserv)m(e)37 b(space)g(in)f(the)h(CHU)f(for)h
(MOREKEYS)e(more)i(header)f(k)m(eyw)m(ords.)59 b(This)36
b(subroutine)f(ma)m(y)j(b)s(e)227 1132 y(called)e(to)g(reserv)m(e)g
(space)f(for)g(k)m(eyw)m(ords)g(whic)m(h)g(are)g(to)h(b)s(e)e(written)h
(at)g(a)h(later)g(time,)h(after)e(the)g(data)227 1245
y(unit)h(or)g(subsequen)m(t)f(extensions)h(ha)m(v)m(e)h(b)s(een)e
(written)h(to)h(the)f(FITS)f(\014le.)58 b(If)35 b(this)h(subroutine)f
(is)h(not)227 1358 y(explicitly)29 b(called,)g(then)e(the)g(initial)i
(size)e(of)h(the)f(FITS)f(header)h(will)h(b)s(e)e(limited)i(to)g(the)f
(space)h(a)m(v)-5 b(ailable)227 1471 y(at)24 b(the)g(time)g(that)g(the)
g(\014rst)f(data)h(is)g(written)f(to)h(the)g(asso)s(ciated)h(data)f
(unit.)38 b(FITSIO)22 b(has)i(the)f(abilit)m(y)i(to)227
1584 y(dynamically)g(add)e(more)h(space)h(to)g(the)f(header)g(if)g
(needed,)h(ho)m(w)m(ev)m(er)g(it)g(is)f(more)g(e\016cien)m(t)h(to)g
(preallo)s(cate)227 1697 y(the)31 b(required)e(space)i(if)g(the)f(size)
h(is)g(kno)m(wn)f(in)g(adv)-5 b(ance.)382 1958 y Fe
(FTHDEF\(unit,morekeys,)42 b(>)47 b(status\))0 2219 y
Fh(2)81 b Fi(Return)23 b(the)i(n)m(um)m(b)s(er)e(of)h(existing)i(k)m
(eyw)m(ords)e(in)h(the)f(CHU)g(\(NOT)h(including)f(the)g(END)h(k)m(eyw)
m(ord)g(whic)m(h)f(is)227 2332 y(not)g(considered)f(a)g(real)h(k)m(eyw)
m(ord\))g(and)f(the)g(remaining)h(space)f(a)m(v)-5 b(ailable)26
b(to)e(write)f(additional)i(k)m(eyw)m(ords)227 2445 y(in)39
b(the)h(CHU.)f(\(returns)f(KEYSADD)i(=)f(-1)h(if)f(the)g(header)g(has)g
(not)h(y)m(et)g(b)s(een)e(closed\).)69 b(Note)40 b(that)227
2558 y(FITSIO)23 b(will)i(attempt)g(to)g(dynamically)g(add)e(space)i
(for)f(more)g(k)m(eyw)m(ords)h(if)f(required)f(when)g(app)s(ending)227
2671 y(new)30 b(k)m(eyw)m(ords)h(to)g(a)g(header.)382
2932 y Fe(FTGHSP\(iunit,)44 b(>)j(keysexist,keysadd,status\))0
3194 y Fh(3)81 b Fi(Return)38 b(the)i(n)m(um)m(b)s(er)e(of)h(k)m(eyw)m
(ords)h(in)f(the)g(header)g(and)g(the)g(curren)m(t)h(p)s(osition)f(in)g
(the)g(header.)68 b(This)227 3307 y(returns)37 b(the)g(n)m(um)m(b)s(er)
f(of)i(the)g(k)m(eyw)m(ord)g(record)f(that)h(will)g(b)s(e)f(read)g
(next)h(\(or)g(one)g(greater)g(than)g(the)227 3420 y(p)s(osition)29
b(of)f(the)h(last)g(k)m(eyw)m(ord)g(that)g(w)m(as)f(read)g(or)h
(written\).)40 b(A)29 b(v)-5 b(alue)28 b(of)h(1)g(is)f(returned)f(if)h
(the)h(p)s(oin)m(ter)227 3533 y(is)i(p)s(ositioned)f(at)h(the)g(b)s
(eginning)e(of)i(the)g(header.)382 3794 y Fe(FTGHPS\(iunit,)44
b(>)j(keysexist,key_no,status\))0 4086 y Fb(6.4.2)112
b(Read)38 b(or)f(W)-9 b(rite)37 b(Standard)i(Header)e(Routines)0
4306 y Fi(These)31 b(subroutines)e(pro)m(vide)i(a)g(simple)g(metho)s(d)
f(of)h(reading)g(or)g(writing)g(most)g(of)g(the)g(k)m(eyw)m(ord)g(v)-5
b(alues)31 b(that)0 4419 y(are)d(normally)g(required)f(in)h(a)g(FITS)f
(\014les.)40 b(These)27 b(subroutines)g(are)h(pro)m(vided)f(for)h(con)m
(v)m(enience)h(only)f(and)g(are)0 4532 y(not)36 b(required)e(to)i(b)s
(e)f(used.)55 b(If)35 b(preferred,)h(users)e(ma)m(y)i(call)h(the)f(lo)m
(w)m(er-lev)m(el)i(subroutines)c(describ)s(ed)h(in)g(the)0
4644 y(previous)30 b(section)i(to)g(individually)f(read)f(or)h(write)g
(the)g(required)f(k)m(eyw)m(ords.)43 b(Note)32 b(that)g(in)e(most)i
(cases,)g(the)0 4757 y(required)26 b(k)m(eyw)m(ords)h(suc)m(h)g(as)g
(NAXIS,)f(TFIELD,)h(TTYPEn,)g(etc,)i(whic)m(h)d(de\014ne)g(the)h
(structure)f(of)h(the)g(HDU)0 4870 y(m)m(ust)j(b)s(e)g(written)g(to)i
(the)e(header)g(b)s(efore)g(an)m(y)h(data)g(can)g(b)s(e)e(written)i(to)
g(the)g(image)g(or)g(table.)0 5132 y Fh(1)81 b Fi(Put)37
b(the)i(primary)e(header)h(or)g(IMA)m(GE)h(extension)f(k)m(eyw)m(ords)h
(in)m(to)g(the)f(CHU.)g(There)g(are)g(2)h(a)m(v)-5 b(ailable)227
5245 y(routines:)39 b(The)27 b(simpler)f(FTPHPS)h(routine)g(is)g(equiv)
-5 b(alen)m(t)29 b(to)e(calling)i(ftphpr)c(with)i(the)g(default)h(v)-5
b(alues)227 5357 y(of)35 b(SIMPLE)f(=)g(true,)i(p)s(coun)m(t)e(=)g(0,)i
(gcoun)m(t)g(=)e(1,)i(and)e(EXTEND)h(=)f(true.)53 b(PCOUNT,)34
b(GCOUNT)227 5470 y(and)23 b(EXTEND)h(k)m(eyw)m(ords)g(are)h(not)f
(required)f(in)g(the)h(primary)f(header)g(and)h(are)g(only)g(written)g
(if)f(p)s(coun)m(t)227 5583 y(is)31 b(not)g(equal)h(to)g(zero,)g(gcoun)
m(t)g(is)f(not)g(equal)g(to)h(zero)g(or)f(one,)g(and)g(if)g(extend)g
(is)g(TR)m(UE,)g(resp)s(ectiv)m(ely)-8 b(.)227 5696 y(When)30
b(writing)h(to)g(an)f(IMA)m(GE)i(extension,)f(the)f(SIMPLE)g(and)g
(EXTEND)g(parameters)h(are)g(ignored.)p eop end
%%Page: 44 50
TeXDict begin 44 49 bop 0 299 a Fi(44)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTPHPS\(unit,bitpix,naxis)o(,na)o(xes,)41
b(>)48 b(status\))382 781 y(FTPHPR\(unit,simple,bitpi)o(x,n)o(axis)o
(,nax)o(es,)o(pcou)o(nt,g)o(cou)o(nt,e)o(xten)o(d,)41
b(>)48 b(status\))0 1082 y Fh(2)81 b Fi(Get)44 b(primary)e(header)h(or)
h(IMA)m(GE)g(extension)g(k)m(eyw)m(ords)g(from)f(the)g(CHU.)h(When)f
(reading)g(from)g(an)227 1195 y(IMA)m(GE)32 b(extension)f(the)f(SIMPLE)
g(and)f(EXTEND)i(parameters)g(are)f(ignored.)382 1495
y Fe(FTGHPR\(unit,maxdim,)42 b(>)48 b(simple,bitpix,naxis,naxe)o(s,p)o
(coun)o(t,gc)o(oun)o(t,ex)o(tend)o(,)716 1608 y(status\))0
1909 y Fh(3)81 b Fi(Put)34 b(the)h(ASCI)s(I)f(table)i(header)f(k)m(eyw)
m(ords)g(in)m(to)h(the)f(CHU.)h(The)e(optional)i(TUNITn)e(and)h
(EXTNAME)227 2021 y(k)m(eyw)m(ords)c(are)g(written)f(only)h(if)f(the)h
(input)e(string)h(v)-5 b(alues)31 b(are)g(not)f(blank.)382
2322 y Fe(FTPHTB\(unit,rowlen,nrows)o(,tf)o(ield)o(s,tt)o(ype)o(,tbc)o
(ol,t)o(for)o(m,tu)o(nit,)o(ext)o(name)o(,)42 b(>)716
2435 y(status\))0 2736 y Fh(4)81 b Fi(Get)31 b(the)g(ASCI)s(I)d(table)k
(header)e(k)m(eyw)m(ords)h(from)e(the)i(CHU)382 3036
y Fe(FTGHTB\(unit,maxdim,)42 b(>)48 b(rowlen,nrows,tfields,tty)o(pe,)o
(tbco)o(l,tf)o(orm)o(,tun)o(it,)716 3149 y(extname,status\))0
3450 y Fh(5)81 b Fi(Put)34 b(the)h(binary)f(table)i(header)e(k)m(eyw)m
(ords)i(in)m(to)f(the)g(CHU.)g(The)g(optional)h(TUNITn)e(and)g(EXTNAME)
227 3563 y(k)m(eyw)m(ords)i(are)g(written)f(only)g(if)h(the)f(input)f
(string)i(v)-5 b(alues)35 b(are)h(not)f(blank.)55 b(The)35
b(p)s(coun)m(t)g(parameter,)227 3675 y(whic)m(h)f(sp)s(eci\014es)g(the)
h(size)g(of)g(the)f(v)-5 b(ariable)35 b(length)g(arra)m(y)g(heap,)g
(should)f(initially)h(=)f(0;)j(FITSIO)d(will)227 3788
y(automatically)27 b(up)s(date)c(the)h(PCOUNT)f(k)m(eyw)m(ord)h(v)-5
b(alue)24 b(if)g(an)m(y)g(v)-5 b(ariable)25 b(length)f(arra)m(y)h(data)
f(is)g(written)227 3901 y(to)31 b(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 4014 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 4127 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
4240 y(than)j(or)h(equal)f(to)i(the)e(longest)i(v)m(ector)f(in)f(the)h
(column\).)44 b(If)30 b(`len')i(is)g(not)f(sp)s(eci\014ed)g(when)f(the)
i(table)g(is)227 4353 y(created)27 b(\(e.g.,)i(the)d(input)f(TF)m(ORMn)
h(v)-5 b(alue)26 b(is)g(just)f('1Pt'\))j(then)d(FITSIO)g(will)h(scan)g
(the)g(column)g(when)227 4466 y(the)k(table)g(is)f(\014rst)g(closed)h
(and)f(will)g(app)s(end)f(the)h(maxim)m(um)h(length)f(to)h(the)g(TF)m
(ORM)f(k)m(eyw)m(ord)h(v)-5 b(alue.)227 4579 y(Note)28
b(that)e(if)g(the)g(table)h(is)f(subsequen)m(tly)g(mo)s(di\014ed)f(to)i
(increase)f(the)h(maxim)m(um)f(length)g(of)g(the)g(v)m(ectors)227
4692 y(then)k(the)h(mo)s(difying)f(program)g(is)g(resp)s(onsible)g(for)
g(also)h(up)s(dating)e(the)i(TF)m(ORM)g(k)m(eyw)m(ord)g(v)-5
b(alue.)382 4992 y Fe(FTPHBN\(unit,nrows,tfield)o(s,t)o(type)o(,tfo)o
(rm,)o(tuni)o(t,ex)o(tna)o(me,v)o(arid)o(at,)41 b(>)48
b(status\))0 5293 y Fh(6)81 b Fi(Get)31 b(the)g(binary)e(table)i
(header)g(k)m(eyw)m(ords)f(from)g(the)h(CHU)382 5593
y Fe(FTGHBN\(unit,maxdim,)42 b(>)48 b(nrows,tfields,ttype,tfor)o(m,t)o
(unit)o(,ext)o(nam)o(e,va)o(rida)o(t,)716 5706 y(status\))p
eop end
%%Page: 45 51
TeXDict begin 45 50 bop 0 299 a Fg(6.4.)72 b(FITS)30
b(HEADER)h(I/O)f(SUBR)m(OUTINES)2086 b Fi(45)0 555 y
Fb(6.4.3)112 b(W)-9 b(rite)37 b(Keyw)m(ord)g(Subroutines)0
764 y Fh(1)81 b Fi(Put)30 b(\(app)s(end\))f(an)h(80-c)m(haracter)j
(record)e(in)m(to)g(the)g(CHU.)382 1020 y Fe(FTPREC\(unit,card,)43
b(>)k(status\))0 1276 y Fh(2)81 b Fi(Put)36 b(\(app)s(end\))g(a)i
(COMMENT)f(k)m(eyw)m(ord)g(in)m(to)h(the)g(CHU.)f(Multiple)h(COMMENT)f
(k)m(eyw)m(ords)g(will)h(b)s(e)227 1389 y(written)31
b(if)f(the)h(input)e(commen)m(t)i(string)g(is)f(longer)h(than)f(72)i(c)
m(haracters.)382 1645 y Fe(FTPCOM\(unit,comment,)42 b(>)48
b(status\))0 1901 y Fh(3)81 b Fi(Put)24 b(\(app)s(end\))g(a)h(HISTOR)-8
b(Y)25 b(k)m(eyw)m(ord)g(in)m(to)h(the)f(CHU.)g(Multiple)h(HISTOR)-8
b(Y)24 b(k)m(eyw)m(ords)h(will)h(b)s(e)e(written)227
2014 y(if)31 b(the)f(input)g(history)g(string)g(is)h(longer)g(than)f
(72)h(c)m(haracters.)382 2270 y Fe(FTPHIS\(unit,history,)42
b(>)48 b(status\))0 2526 y Fh(4)81 b Fi(Put)36 b(\(app)s(end\))f(the)h
(D)m(A)-8 b(TE)38 b(k)m(eyw)m(ord)f(in)m(to)g(the)f(CHU.)h(The)f(k)m
(eyw)m(ord)g(v)-5 b(alue)37 b(will)g(con)m(tain)h(the)e(curren)m(t)227
2639 y(system)c(date)g(as)g(a)f(c)m(haracter)i(string)f(in)f
('dd/mm/yy')g(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 2752 y(in)j(the)g(header,)i
(then)d(this)h(subroutine)f(will)i(simply)e(up)s(date)h(the)g(k)m(eyw)m
(ord)g(v)-5 b(alue)36 b(in-place)g(with)f(the)227 2865
y(curren)m(t)30 b(date.)382 3121 y Fe(FTPDAT\(unit,)44
b(>)k(status\))0 3377 y Fh(5)81 b Fi(Put)22 b(\(app)s(end\))f(a)i(new)f
(k)m(eyw)m(ord)h(of)g(the)f(appropriate)h(datat)m(yp)s(e)g(in)m(to)h
(the)e(CHU.)h(Note)h(that)f(FTPKYS)f(will)227 3490 y(only)33
b(write)g(string)f(v)-5 b(alues)33 b(up)e(to)j(68)f(c)m(haracters)h(in)
e(length;)i(longer)f(strings)g(will)f(b)s(e)g(truncated.)47
b(The)227 3603 y(FTPKLS)27 b(routine)h(can)h(b)s(e)f(used)f(to)i(write)
f(longer)h(strings,)g(using)e(a)i(non-standard)e(FITS)h(con)m(v)m(en)m
(tion.)227 3716 y(The)23 b(E)h(and)f(D)h(v)m(ersions)g(of)g(this)f
(routine)h(ha)m(v)m(e)h(the)f(added)f(feature)h(that)g(if)g(the)g
('decimals')h(parameter)f(is)227 3829 y(negativ)m(e,)i(then)20
b(the)i('G')g(displa)m(y)f(format)g(rather)g(then)g(the)g('E')h(format)
f(will)h(b)s(e)e(used)g(when)g(constructing)227 3942
y(the)25 b(k)m(eyw)m(ord)f(v)-5 b(alue,)26 b(taking)f(the)g(absolute)g
(v)-5 b(alue)24 b(of)h('decimals')g(for)f(the)g(precision.)39
b(This)23 b(will)i(suppress)227 4055 y(trailing)35 b(zeros,)h(and)d
(will)i(use)e(a)i(\014xed)e(format)h(rather)g(than)f(an)h(exp)s(onen)m
(tial)h(format,)h(dep)s(ending)c(on)227 4168 y(the)f(magnitude)f(of)h
(the)f(v)-5 b(alue.)382 4424 y Fe(FTPKY[JKLS]\(unit,keyword)o(,ke)o
(yval)o(,com)o(men)o(t,)42 b(>)47 b(status\))382 4537
y(FTPKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o(omme)o
(nt,)41 b(>)48 b(status\))0 4793 y Fh(6)81 b Fi(Put)33
b(\(app)s(end\))h(a)g(string)g(v)-5 b(alued)34 b(k)m(eyw)m(ord)h(in)m
(to)g(the)g(CHU)f(whic)m(h)g(ma)m(y)g(b)s(e)g(longer)h(than)e(68)i(c)m
(haracters)227 4906 y(in)j(length.)64 b(This)37 b(uses)h(the)g(Long)g
(String)g(Keyw)m(ord)g(con)m(v)m(en)m(tion)i(that)e(is)g(describ)s(ed)f
(in)h(the)g("Usage)227 5019 y(Guidelines)33 b(and)e(Suggestions")j
(section)f(of)g(this)f(do)s(cumen)m(t.)46 b(Since)33
b(this)f(uses)g(a)g(non-standard)g(FITS)227 5132 y(con)m(v)m(en)m(tion)
38 b(to)d(enco)s(de)h(the)f(long)h(k)m(eyw)m(ord)f(string,)i(programs)d
(whic)m(h)h(use)g(this)g(routine)g(should)f(also)227
5245 y(call)e(the)e(FTPLSW)g(routine)h(to)g(add)e(some)i(COMMENT)f(k)m
(eyw)m(ords)h(to)g(w)m(arn)f(users)f(of)i(the)f(FITS)g(\014le)227
5357 y(that)36 b(this)f(con)m(v)m(en)m(tion)j(is)d(b)s(eing)g(used.)55
b(FTPLSW)35 b(also)h(writes)g(a)f(k)m(eyw)m(ord)h(called)h(LONGSTRN)d
(to)227 5470 y(record)c(the)h(v)m(ersion)f(of)h(the)f(longstring)h(con)
m(v)m(en)m(tion)h(that)f(has)f(b)s(een)g(used,)f(in)h(case)h(a)g(new)f
(con)m(v)m(en)m(tion)227 5583 y(is)f(adopted)g(at)g(some)g(p)s(oin)m(t)
f(in)h(the)f(future.)40 b(If)28 b(the)g(LONGSTRN)g(k)m(eyw)m(ord)h(is)g
(already)g(presen)m(t)f(in)h(the)227 5696 y(header,)i(then)f(FTPLSW)g
(will)g(simply)g(return)g(and)f(will)i(not)g(write)f(duplicate)h(k)m
(eyw)m(ords.)p eop end
%%Page: 46 52
TeXDict begin 46 51 bop 0 299 a Fi(46)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTPKLS\(unit,keyword,keyv)o(al,)o(comm)o
(ent,)41 b(>)47 b(status\))382 668 y(FTPLSW\(unit,)d(>)k(status\))0
889 y Fh(7)81 b Fi(Put)30 b(\(app)s(end\))g(a)h(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)31
b(in)m(to)h(the)f(CHU.)g(The)f(v)-5 b(alue)31 b(string)227
1002 y(of)g(the)f(k)m(eyw)m(ord)h(is)g(left)g(blank)f(in)g(this)g
(case.)382 1223 y Fe(FTPKYU\(unit,keyword,comm)o(ent)o(,)42
b(>)47 b(status\))0 1445 y Fh(8)81 b Fi(Put)41 b(\(app)s(end\))g(a)i(n)
m(um)m(b)s(ered)d(sequence)j(of)f(k)m(eyw)m(ords)g(in)m(to)h(the)g
(CHU.)f(One)f(ma)m(y)i(app)s(end)d(the)j(same)227 1558
y(commen)m(t)37 b(to)g(ev)m(ery)g(k)m(eyw)m(ord)g(\(and)f(eliminate)h
(the)g(need)f(to)h(ha)m(v)m(e)g(an)f(arra)m(y)h(of)f(iden)m(tical)i
(commen)m(t)227 1670 y(strings,)g(one)e(for)g(eac)m(h)h(k)m(eyw)m
(ord\))g(b)m(y)f(including)g(the)g(amp)s(ersand)e(c)m(haracter)k(as)e
(the)h(last)g(non-blank)227 1783 y(c)m(haracter)g(in)e(the)h
(\(\014rst\))f(COMMENTS)f(string)h(parameter.)56 b(This)35
b(same)g(string)h(will)f(then)g(b)s(e)g(used)227 1896
y(for)30 b(the)g(commen)m(t)h(\014eld)f(in)f(all)i(the)f(k)m(eyw)m
(ords.)41 b(\(Note)32 b(that)e(the)g(SPP)f(v)m(ersion)i(of)f(these)g
(routines)g(only)227 2009 y(supp)s(orts)f(a)i(single)g(commen)m(t)g
(string\).)382 2230 y Fe(FTPKN[JKLS]\(unit,keyroot)o(,st)o(artn)o(o,no)
o(_ke)o(ys,k)o(eyva)o(ls,)o(comm)o(ents)o(,)42 b(>)47
b(status\))382 2343 y(FTPKN[EDFG]\(unit,keyroot)o(,st)o(artn)o(o,no)o
(_ke)o(ys,k)o(eyva)o(ls,)o(deci)o(mals)o(,co)o(mmen)o(ts,)41
b(>)907 2456 y(status\))0 2677 y Fh(9)81 b Fi(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 2790 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 2903 y(input)28 b(HDU)h(\(b)m(y)f(giving)h
(k)m(eyro)s(ot)h(=)d("TLMIN")i(and)f(inn)m(um)f(=)h(3\))h(and)f(write)g
(it)h(to)g(the)f(output)g(HDU)227 3016 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
3129 y(exist,)c(then)e(this)g(routine)g(simply)g(returns)f(without)i
(indicating)g(an)f(error.)382 3350 y Fe(FTCPKY\(inunit,)44
b(outunit,)h(innum,)h(outnum,)g(keyroot,)g(>)h(status\))0
3571 y Fh(10)f Fi(Put)33 b(\(app)s(end\))f(a)h('triple)h(precision')g
(k)m(eyw)m(ord)f(in)m(to)h(the)g(CHU)f(in)g(F28.16)i(format.)49
b(The)33 b(\015oating)h(p)s(oin)m(t)227 3684 y(k)m(eyw)m(ord)c(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
3797 y(precision)22 b(fraction)h(v)-5 b(alue)23 b(\(whic)m(h)f(m)m(ust)
g(ha)m(v)m(e)h(a)f(v)-5 b(alue)23 b(b)s(et)m(w)m(een)g(0.0)g(and)e
(1.0\).)40 b(The)21 b(FTGKYT)h(routine)227 3910 y(should)35
b(b)s(e)h(used)f(to)i(read)f(this)f(k)m(eyw)m(ord)i(v)-5
b(alue,)38 b(b)s(ecause)e(the)g(other)h(k)m(eyw)m(ord)f(reading)g
(subroutines)227 4023 y(will)31 b(not)g(preserv)m(e)f(the)h(full)f
(precision)g(of)h(the)f(v)-5 b(alue.)382 4244 y Fe
(FTPKYT\(unit,keyword,intv)o(al,)o(dblv)o(al,c)o(omm)o(ent,)41
b(>)48 b(status\))0 4466 y Fh(11)e Fi(W)-8 b(rite)36
b(k)m(eyw)m(ords)g(to)f(the)h(CHDU)f(that)h(are)f(de\014ned)f(in)g(an)h
(ASCI)s(I)f(template)i(\014le.)55 b(The)34 b(format)i(of)f(the)227
4578 y(template)d(\014le)f(is)f(describ)s(ed)f(under)g(the)i(ftgthd)f
(routine)g(b)s(elo)m(w.)382 4800 y Fe(FTPKTP\(unit,)44
b(filename,)i(>)h(status\))0 5021 y Fh(12)f Fi(App)s(end)28
b(the)i(ph)m(ysical)g(units)g(string)g(to)g(an)g(existing)h(k)m(eyw)m
(ord.)41 b(This)29 b(routine)h(uses)f(a)h(lo)s(cal)i(con)m(v)m(en)m
(tion,)227 5134 y(sho)m(wn)g(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 5247 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 5468 y Fe(VELOCITY=)809
b(12.3)46 b(/)i([km/s])e(orbital)g(speed)382 5694 y
(FTPUNT\(unit,keyword,unit)o(s,)41 b(>)48 b(status\))p
eop end
%%Page: 47 53
TeXDict begin 47 52 bop 0 299 a Fg(6.4.)72 b(FITS)30
b(HEADER)h(I/O)f(SUBR)m(OUTINES)2086 b Fi(47)0 555 y
Fb(6.4.4)112 b(Insert)38 b(Keyw)m(ord)f(Subroutines)0
762 y Fh(1)81 b Fi(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 875 y(the)34 b(\(k)m(eyno\)th)g(k)m(eyw)m
(ord)g(in)f(the)h(header.\))49 b(This)33 b('insert)g(record')h
(subroutine)e(is)h(somewhat)h(less)g(e\016-)227 988 y(cien)m(t)28
b(then)f(the)g('app)s(end)e(record')i(subroutine)f(\(FTPREC\))g
(describ)s(ed)g(ab)s(o)m(v)m(e)i(b)s(ecause)f(the)g(remaining)227
1101 y(k)m(eyw)m(ords)k(in)f(the)h(header)f(ha)m(v)m(e)h(to)g(b)s(e)f
(shifted)g(do)m(wn)g(one)h(slot.)382 1349 y Fe
(FTIREC\(unit,key_no,card,)41 b(>)47 b(status\))0 1598
y Fh(2)81 b Fi(Insert)36 b(a)h(new)f(k)m(eyw)m(ord)i(in)m(to)g(the)f
(CHU.)g(The)f(new)g(k)m(eyw)m(ord)i(is)f(inserted)f(immediately)i
(follo)m(wing)h(the)227 1711 y(last)27 b(k)m(eyw)m(ord)g(that)f(has)g
(b)s(een)g(read)g(from)f(the)h(header.)40 b(The)25 b(FTIKLS)g
(subroutine)g(w)m(orks)h(the)g(same)h(as)227 1824 y(the)h(FTIKYS)e
(subroutine,)h(except)i(it)f(also)g(supp)s(orts)e(long)i(string)f(v)-5
b(alues)28 b(greater)g(than)f(68)h(c)m(haracters)227
1937 y(in)36 b(length.)59 b(These)36 b('insert)g(k)m(eyw)m(ord')h
(subroutines)e(are)i(somewhat)g(less)f(e\016cien)m(t)i(then)e(the)g
('app)s(end)227 2049 y(k)m(eyw)m(ord')30 b(subroutines)e(describ)s(ed)g
(ab)s(o)m(v)m(e)i(b)s(ecause)f(the)g(remaining)h(k)m(eyw)m(ords)f(in)g
(the)g(header)g(ha)m(v)m(e)h(to)227 2162 y(b)s(e)g(shifted)g(do)m(wn)g
(one)h(slot.)382 2411 y Fe(FTIKEY\(unit,)44 b(card,)j(>)g(status\))382
2524 y(FTIKY[JKLS]\(unit,keyword)o(,ke)o(yval)o(,com)o(men)o(t,)42
b(>)47 b(status\))382 2637 y(FTIKLS\(unit,keyword,keyv)o(al,)o(comm)o
(ent,)41 b(>)47 b(status\))382 2750 y(FTIKY[EDFG]\(unit,keyword)o(,ke)o
(yval)o(,dec)o(ima)o(ls,c)o(omme)o(nt,)41 b(>)48 b(status\))0
2998 y Fh(3)81 b Fi(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 3111 y(k)m(eyw)m(ord)d
(is)g(left)g(blank)f(in)g(this)g(case.)382 3359 y Fe
(FTIKYU\(unit,keyword,comm)o(ent)o(,)42 b(>)47 b(status\))0
3648 y Fb(6.4.5)112 b(Read)38 b(Keyw)m(ord)g(Subroutines)0
3867 y Fi(These)29 b(routines)f(return)g(the)h(v)-5 b(alue)29
b(of)g(the)g(sp)s(eci\014ed)f(k)m(eyw)m(ord\(s\).)41
b(Wild)30 b(card)e(c)m(haracters)i(\(*,)h(?,)e(or)g(#\))f(ma)m(y)0
3980 y(b)s(e)f(used)h(when)f(sp)s(ecifying)h(the)g(name)g(of)g(the)g(k)
m(eyw)m(ord)h(to)g(b)s(e)e(read:)39 b(a)29 b(')10 b(?')40
b(will)28 b(matc)m(h)h(an)m(y)g(single)f(c)m(haracter)0
4093 y(at)38 b(that)g(p)s(osition)f(in)g(the)h(k)m(eyw)m(ord)g(name)f
(and)g(a)g('*')i(will)e(matc)m(h)h(an)m(y)g(length)g(\(including)f
(zero\))h(string)g(of)0 4206 y(c)m(haracters.)65 b(The)37
b('#')h(c)m(haracter)h(will)f(matc)m(h)h(an)m(y)f(consecutiv)m(e)i
(string)e(of)g(decimal)h(digits)f(\(0)h(-)f(9\).)64 b(Note)0
4319 y(that)30 b(when)f(a)g(wild)g(card)h(is)f(used)g(in)g(the)h(input)
e(k)m(eyw)m(ord)i(name,)g(the)g(routine)f(will)h(only)g(searc)m(h)g
(for)f(a)h(matc)m(h)0 4432 y(from)h(the)h(curren)m(t)g(header)g(p)s
(osition)g(to)g(the)h(end)e(of)h(the)g(header.)45 b(It)32
b(will)g(not)g(resume)g(the)g(searc)m(h)g(from)g(the)0
4545 y(top)i(of)h(the)f(header)g(bac)m(k)h(to)g(the)f(original)h
(header)f(p)s(osition)g(as)h(is)f(done)g(when)f(no)h(wildcards)f(are)i
(included)0 4657 y(in)f(the)g(k)m(eyw)m(ord)h(name.)52
b(If)33 b(the)h(desired)g(k)m(eyw)m(ord)h(string)f(is)g(8-c)m
(haracters)i(long)f(\(the)f(maxim)m(um)g(length)h(of)0
4770 y(a)h(k)m(eyw)m(ord)g(name\))g(then)g(a)g('*')g(ma)m(y)h(b)s(e)e
(app)s(ended)f(as)h(the)h(nin)m(th)g(c)m(haracter)h(of)f(the)f(input)g
(name)h(to)g(force)0 4883 y(the)31 b(k)m(eyw)m(ord)g(searc)m(h)h(to)f
(stop)g(at)g(the)g(end)f(of)h(the)g(header)g(\(e.g.,)i('COMMENT)d(*')i
(will)f(searc)m(h)g(for)g(the)g(next)0 4996 y(COMMENT)37
b(k)m(eyw)m(ord\).)64 b(The)37 b(\013grec)i(routine)f(ma)m(y)g(b)s(e)f
(used)g(to)i(set)f(the)g(starting)g(p)s(osition)g(when)f(doing)0
5109 y(wild)30 b(card)g(searc)m(hes.)0 5357 y Fh(1)81
b Fi(Get)37 b(the)f(n)m(th)f(80-c)m(haracter)k(header)d(record)g(from)f
(the)h(CHU.)h(The)e(\014rst)g(k)m(eyw)m(ord)i(in)e(the)h(header)g(is)g
(at)227 5470 y(k)m(ey)p 365 5470 28 4 v 34 w(no)42 b(=)f(1;)49
b(if)42 b(k)m(ey)p 996 5470 V 34 w(no)g(=)f(0)i(then)e(this)h
(subroutine)f(simple)h(mo)m(v)m(es)i(the)e(in)m(ternal)h(p)s(oin)m(ter)
f(to)h(the)227 5583 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 5696 y(header;)31 b(it)g(also)g(returns)e(a)i
(blank)f(card)g(v)-5 b(alue)31 b(in)f(this)g(case.)p
eop end
%%Page: 48 54
TeXDict begin 48 53 bop 0 299 a Fi(48)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTGREC\(unit,key_no,)42
b(>)48 b(card,status\))0 817 y Fh(2)81 b Fi(Get)31 b(the)g(name,)f(v)-5
b(alue)31 b(\(as)g(a)g(string\),)g(and)f(commen)m(t)i(of)e(the)h(n)m
(th)f(k)m(eyw)m(ord)h(in)f(CHU.)h(This)f(routine)g(also)227
930 y(c)m(hec)m(ks)h(that)f(the)g(returned)e(k)m(eyw)m(ord)i(name)f
(\(KEYW)m(ORD\))i(con)m(tains)g(only)e(legal)i(ASCI)s(I)d(c)m
(haracters.)227 1043 y(Call)j(FTGREC)f(and)g(FTPSV)m(C)g(to)h(b)m
(ypass)f(this)g(error)g(c)m(hec)m(k.)382 1305 y Fe
(FTGKYN\(unit,key_no,)42 b(>)48 b(keyword,value,comment,st)o(atu)o(s\))
0 1568 y Fh(3)81 b Fi(Get)31 b(the)g(80-c)m(haracter)i(header)d(record)
g(for)g(the)h(named)f(k)m(eyw)m(ord)382 1830 y Fe
(FTGCRD\(unit,keyword,)42 b(>)48 b(card,status\))0 2092
y Fh(4)81 b Fi(Get)26 b(the)f(next)h(k)m(eyw)m(ord)f(whose)g(name)h
(matc)m(hes)g(one)f(of)h(the)f(strings)g(in)g('inclist')i(but)d(do)s
(es)h(not)g(matc)m(h)i(an)m(y)227 2205 y(of)32 b(the)f(strings)g(in)g
('exclist'.)45 b(The)30 b(strings)h(in)g(inclist)h(and)f(exclist)h(ma)m
(y)g(con)m(tain)h(wild)d(card)h(c)m(haracters)227 2318
y(\(*,)38 b(?,)e(and)e(#\))i(as)f(describ)s(ed)f(at)i(the)f(b)s
(eginning)f(of)i(this)f(section.)56 b(This)34 b(routine)h(searc)m(hes)h
(from)f(the)227 2431 y(curren)m(t)28 b(header)f(p)s(osition)h(to)g(the)
g(end)f(of)h(the)g(header,)g(only)-8 b(,)29 b(and)e(do)s(es)g(not)h
(con)m(tin)m(ue)h(the)f(searc)m(h)g(from)227 2544 y(the)41
b(top)g(of)g(the)g(header)g(bac)m(k)h(to)f(the)g(original)h(p)s
(osition.)73 b(The)40 b(curren)m(t)h(header)f(p)s(osition)h(ma)m(y)h(b)
s(e)227 2657 y(reset)33 b(with)e(the)h(ftgrec)h(routine.)44
b(Note)33 b(that)g(nexc)f(ma)m(y)g(b)s(e)f(set)h(=)g(0)g(if)f(there)h
(are)g(no)g(k)m(eyw)m(ords)g(to)h(b)s(e)227 2769 y(excluded.)41
b(This)29 b(routine)i(returns)e(status)i(=)f(202)h(if)g(a)f(matc)m
(hing)i(k)m(eyw)m(ord)f(is)f(not)h(found.)382 3032 y
Fe(FTGNXK\(unit,inclist,ninc)o(,ex)o(clis)o(t,ne)o(xc,)41
b(>)48 b(card,status\))0 3294 y Fh(5)81 b Fi(Get)30 b(the)g(literal)i
(k)m(eyw)m(ord)e(v)-5 b(alue)30 b(as)g(a)g(c)m(haracter)i(string.)40
b(Regardless)31 b(of)f(the)g(datat)m(yp)s(e)g(of)g(the)g(k)m(eyw)m
(ord,)227 3407 y(this)37 b(routine)g(simply)g(returns)f(the)h(string)g
(of)g(c)m(haracters)i(in)d(the)i(v)-5 b(alue)37 b(\014eld)g(of)g(the)g
(k)m(eyw)m(ord)h(along)227 3520 y(with)30 b(the)h(commen)m(t)g
(\014eld.)382 3782 y Fe(FTGKEY\(unit,keyword,)42 b(>)48
b(value,comment,status\))0 4044 y Fh(6)81 b Fi(Get)31
b(a)g(k)m(eyw)m(ord)g(v)-5 b(alue)30 b(\(with)h(the)f(appropriate)h
(datat)m(yp)s(e\))g(and)f(commen)m(t)i(from)e(the)g(CHU)382
4306 y Fe(FTGKY[EDJKLS]\(unit,keywo)o(rd,)41 b(>)48 b
(keyval,comment,status\))0 4568 y Fh(7)81 b Fi(Get)24
b(a)g(sequence)g(of)g(n)m(um)m(b)s(ered)e(k)m(eyw)m(ord)i(v)-5
b(alues.)38 b(These)24 b(routines)f(do)g(not)h(supp)s(ort)e(wild)h
(card)g(c)m(haracters)227 4681 y(in)30 b(the)h(ro)s(ot)g(name.)382
4943 y Fe(FTGKN[EDJKLS]\(unit,keyro)o(ot,)o(star)o(tno,)o(max)o(_key)o
(s,)42 b(>)47 b(keyvals,nfound,status\))0 5206 y Fh(8)81
b Fi(Get)27 b(the)f(v)-5 b(alue)26 b(of)h(a)f(\015oating)h(p)s(oin)m(t)
f(k)m(eyw)m(ord,)i(returning)d(the)h(in)m(teger)h(and)f(fractional)h
(parts)f(of)g(the)g(v)-5 b(alue)227 5319 y(in)32 b(separate)g
(subroutine)f(argumen)m(ts.)45 b(This)31 b(subroutine)f(ma)m(y)j(b)s(e)
e(used)g(to)h(read)g(an)m(y)g(k)m(eyw)m(ord)g(but)f(is)227
5431 y(esp)s(ecially)h(useful)d(for)i(reading)f(the)h('triple)g
(precision')f(k)m(eyw)m(ords)h(written)g(b)m(y)f(FTPKYT.)382
5694 y Fe(FTGKYT\(unit,keyword,)42 b(>)48 b(intval,dblval,comment,s)o
(tat)o(us\))p eop end
%%Page: 49 55
TeXDict begin 49 54 bop 0 299 a Fg(6.4.)72 b(FITS)30
b(HEADER)h(I/O)f(SUBR)m(OUTINES)2086 b Fi(49)0 555 y
Fh(9)81 b Fi(Get)24 b(the)g(ph)m(ysical)h(units)e(string)g(in)h(an)f
(existing)i(k)m(eyw)m(ord.)39 b(This)23 b(routine)h(uses)f(a)h(lo)s
(cal)h(con)m(v)m(en)m(tion,)j(sho)m(wn)227 668 y(in)33
b(the)h(follo)m(wing)g(example,)h(in)e(whic)m(h)g(the)g(k)m(eyw)m(ord)h
(units)f(are)g(enclosed)h(in)f(square)g(brac)m(k)m(ets)i(in)e(the)227
781 y(b)s(eginning)h(of)h(the)g(k)m(eyw)m(ord)g(commen)m(t)h(\014eld.)
53 b(A)35 b(blank)g(string)f(is)h(returned)f(if)g(no)h(units)f(are)h
(de\014ned)227 894 y(for)30 b(the)h(k)m(eyw)m(ord.)191
1132 y Fe(VELOCITY=)809 b(12.3)46 b(/)i([km/s])e(orbital)g(speed)382
1358 y(FTGUNT\(unit,keyword,)c(>)48 b(units,status\))0
1645 y Fb(6.4.6)112 b(Mo)s(dify)39 b(Keyw)m(ord)e(Subroutines)0
1864 y Fi(Wild)32 b(card)f(c)m(haracters,)j(as)e(describ)s(ed)e(in)h
(the)h(Read)g(Keyw)m(ord)f(section,)i(ab)s(o)m(v)m(e,)g(ma)m(y)g(b)s(e)
d(used)h(when)g(sp)s(eci-)0 1977 y(fying)f(the)h(name)f(of)h(the)f(k)m
(eyw)m(ord)h(to)g(b)s(e)f(mo)s(di\014ed.)0 2215 y Fh(1)81
b Fi(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)382 2453
y Fe(FTMREC\(unit,key_no,card,)41 b(>)47 b(status\))0
2692 y Fh(2)81 b Fi(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 2805 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.)382
3043 y Fe(FTMCRD\(unit,keyword,card)o(,)42 b(>)47 b(status\))0
3281 y Fh(3)81 b Fi(Mo)s(dify)33 b(\(o)m(v)m(erwrite\))k(the)d(name)g
(of)h(an)f(existing)h(k)m(eyw)m(ord)f(in)g(the)h(CHU)f(preserving)f
(the)i(curren)m(t)e(v)-5 b(alue)227 3394 y(and)30 b(commen)m(t)h
(\014elds.)382 3632 y Fe(FTMNAM\(unit,oldkey,keywo)o(rd,)41
b(>)48 b(status\))0 3870 y Fh(4)81 b Fi(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)g(in)f(the)h(CHU)382 4108 y
Fe(FTMCOM\(unit,keyword,comm)o(ent)o(,)42 b(>)47 b(status\))0
4347 y Fh(5)81 b Fi(Mo)s(dify)24 b(the)h(v)-5 b(alue)25
b(and)f(commen)m(t)i(\014elds)e(of)h(an)f(existing)i(k)m(eyw)m(ord)f
(in)f(the)h(CHU.)g(The)f(FTMKLS)g(subrou-)227 4459 y(tine)35
b(w)m(orks)e(the)h(same)h(as)f(the)g(FTMKYS)f(subroutine,)h(except)h
(it)g(also)f(supp)s(orts)e(long)j(string)f(v)-5 b(alues)227
4572 y(greater)38 b(than)f(68)h(c)m(haracters)g(in)f(length.)60
b(Optionally)-8 b(,)40 b(one)d(ma)m(y)h(mo)s(dify)e(only)h(the)g(v)-5
b(alue)37 b(\014eld)g(and)227 4685 y(lea)m(v)m(e)32 b(the)d(commen)m(t)
i(\014eld)e(unc)m(hanged)g(b)m(y)g(setting)h(the)g(input)e(COMMENT)h
(parameter)h(equal)g(to)g(the)227 4798 y(amp)s(ersand)f(c)m(haracter)k
(\(&\).)42 b(The)30 b(E)g(and)g(D)h(v)m(ersions)g(of)g(this)g(routine)f
(ha)m(v)m(e)i(the)f(added)f(feature)h(that)227 4911 y(if)26
b(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
5024 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 5137 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 5250 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.)382 5488 y Fe(FTMKY[JKLS]\(unit,keyword)o(,ke)o(yval)o(,com)o
(men)o(t,)42 b(>)47 b(status\))382 5601 y(FTMKLS\(unit,keyword,keyv)o
(al,)o(comm)o(ent,)41 b(>)47 b(status\))382 5714 y
(FTMKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o(omme)o
(nt,)41 b(>)48 b(status\))p eop end
%%Page: 50 56
TeXDict begin 50 55 bop 0 299 a Fi(50)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fh(6)81 b Fi(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 668 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 781 y(COMMENT)g(parameter)h(equal)g(to)g(the)g(amp)s(ersand)e(c)m
(haracter)j(\(&\).)382 1034 y Fe(FTMKYU\(unit,keyword,comm)o(ent)o(,)42
b(>)47 b(status\))0 1324 y Fb(6.4.7)112 b(Up)s(date)39
b(Keyw)m(ord)e(Subroutines)0 1532 y Fh(1)81 b Fi(Up)s(date)36
b(an)g(80-c)m(haracter)j(record)d(in)g(the)h(CHU.)f(If)g(the)g(sp)s
(eci\014ed)g(k)m(eyw)m(ord)h(already)f(exists)h(then)f(that)227
1645 y(header)j(record)f(will)h(b)s(e)f(replaced)i(with)e(the)h(input)f
(CARD)g(string.)66 b(If)38 b(it)i(do)s(es)e(not)h(exist)g(then)g(the)
227 1758 y(new)f(record)g(will)g(b)s(e)f(added)h(to)g(the)g(header.)64
b(The)37 b(FTUKLS)g(subroutine)g(w)m(orks)h(the)g(same)h(as)f(the)227
1870 y(FTUKYS)28 b(subroutine,)g(except)i(it)f(also)h(supp)s(orts)c
(long)j(string)g(v)-5 b(alues)29 b(greater)h(than)e(68)h(c)m(haracters)
h(in)227 1983 y(length.)382 2237 y Fe(FTUCRD\(unit,keyword,card)o(,)42
b(>)47 b(status\))0 2490 y Fh(2)81 b Fi(Up)s(date)44
b(the)i(v)-5 b(alue)45 b(and)g(commen)m(t)h(\014elds)e(of)h(a)h(k)m
(eyw)m(ord)f(in)g(the)g(CHU.)h(The)e(sp)s(eci\014ed)g(k)m(eyw)m(ord)i
(is)227 2603 y(mo)s(di\014ed)38 b(if)g(it)h(already)g(exists)g(\(b)m(y)
g(calling)h(FTMKYx\))f(otherwise)f(a)h(new)f(k)m(eyw)m(ord)h(is)g
(created)g(b)m(y)227 2716 y(calling)f(FTPKYx.)58 b(The)36
b(E)g(and)f(D)i(v)m(ersions)f(of)h(this)f(routine)g(ha)m(v)m(e)h(the)g
(added)e(feature)i(that)g(if)f(the)227 2828 y('decimals')c(parameter)g
(is)f(negativ)m(e,)i(then)d(the)h('G')h(displa)m(y)f(format)g(rather)g
(then)f(the)h('E')g(format)h(will)227 2941 y(b)s(e)41
b(used)f(when)h(constructing)h(the)f(k)m(eyw)m(ord)h(v)-5
b(alue,)45 b(taking)d(the)f(absolute)h(v)-5 b(alue)42
b(of)g('decimals')g(for)227 3054 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 3167 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.)382 3420 y Fe(FTUKY[JKLS]\(unit,keyword)o(,ke)o(yval)o(,com)o
(men)o(t,)42 b(>)47 b(status\))382 3533 y(FTUKLS\(unit,keyword,keyv)o
(al,)o(comm)o(ent,)41 b(>)47 b(status\))382 3646 y
(FTUKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o(omme)o
(nt,)41 b(>)48 b(status\))0 3899 y Fh(3)81 b Fi(Up)s(date)23
b(the)g(v)-5 b(alue)24 b(of)g(an)f(existing)i(k)m(eyw)m(ord)f(to)g(b)s
(e)f(unde\014ned,)f(or)i(n)m(ull,)h(or)e(insert)h(a)f(new)g
(unde\014ned-v)-5 b(alue)227 4012 y(k)m(eyw)m(ord)30
b(if)f(it)h(do)s(esn't)f(already)h(exist.)41 b(The)29
b(v)-5 b(alue)30 b(string)f(of)g(the)h(k)m(eyw)m(ord)f(is)h(left)g
(blank)f(in)f(this)i(case.)382 4265 y Fe(FTUKYU\(unit,keyword,comm)o
(ent)o(,)42 b(>)47 b(status\))0 4555 y Fb(6.4.8)112 b(Delete)38
b(Keyw)m(ord)f(Subroutines)0 4763 y Fh(1)81 b Fi(Delete)32
b(an)e(existing)h(k)m(eyw)m(ord)g(record.)40 b(The)30
b(space)h(previously)f(o)s(ccupied)g(b)m(y)g(the)g(k)m(eyw)m(ord)h(is)f
(reclaimed)227 4876 y(b)m(y)c(mo)m(ving)h(all)g(the)f(follo)m(wing)i
(header)e(records)g(up)f(one)h(ro)m(w)h(in)e(the)i(header.)39
b(The)25 b(\014rst)h(routine)g(deletes)227 4989 y(a)34
b(k)m(eyw)m(ord)f(at)h(a)g(sp)s(eci\014ed)e(p)s(osition)h(in)g(the)g
(header)g(\(the)h(\014rst)e(k)m(eyw)m(ord)i(is)f(at)h(p)s(osition)f
(1\),)i(whereas)227 5102 y(the)d(second)g(routine)g(deletes)h(a)f(sp)s
(eci\014cally)g(named)f(k)m(eyw)m(ord.)46 b(Wild)32 b(card)f(c)m
(haracters,)j(as)e(describ)s(ed)227 5215 y(in)f(the)g(Read)g(Keyw)m
(ord)f(section,)i(ab)s(o)m(v)m(e,)g(ma)m(y)g(b)s(e)e(used)g(when)f(sp)s
(ecifying)i(the)g(name)g(of)g(the)f(k)m(eyw)m(ord)227
5328 y(to)h(b)s(e)f(deleted)h(\(b)s(e)f(careful!\).)382
5581 y Fe(FTDREC\(unit,key_no,)42 b(>)48 b(status\))382
5694 y(FTDKEY\(unit,keyword,)42 b(>)48 b(status\))p eop
end
%%Page: 51 57
TeXDict begin 51 56 bop 0 299 a Fg(6.5.)72 b(D)m(A)-8
b(T)g(A)32 b(SCALING)e(AND)h(UNDEFINED)h(PIXEL)e(P)-8
b(ARAMETERS)1083 b Fi(51)0 555 y Fd(6.5)135 b(Data)46
b(Scaling)g(and)e(Unde\014ned)h(Pixel)h(P)l(arameters)0
805 y Fi(These)24 b(subroutines)f(de\014ne)h(or)h(mo)s(dify)e(the)i(in)
m(ternal)g(parameters)g(used)f(b)m(y)g(FITSIO)g(to)h(either)g(scale)h
(the)e(data)0 918 y(or)33 b(to)i(represen)m(t)e(unde\014ned)e(pixels.)
50 b(Generally)35 b(FITSIO)d(will)i(scale)g(the)g(data)g(according)g
(to)g(the)g(v)-5 b(alues)34 b(of)0 1031 y(the)e(BSCALE)g(and)f(BZER)m
(O)h(\(or)h(TSCALn)d(and)i(TZER)m(On\))f(k)m(eyw)m(ords,)i(ho)m(w)m(ev)
m(er)h(these)e(subroutines)f(ma)m(y)0 1144 y(b)s(e)h(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)c(unscaled)f(v)-5 b(alues)29
b(in)h(the)f(FITS)g(\014le.)40 b(Similarly)-8 b(,)31
b(FITSIO)d(generally)j(uses)e(the)g(v)-5 b(alue)30 b(of)g(the)f(BLANK)h
(or)0 1370 y(TNULLn)35 b(k)m(eyw)m(ord)h(to)g(signify)f(an)h
(unde\014ned)d(pixel,)k(but)e(these)h(routines)g(ma)m(y)g(b)s(e)e(used)
h(to)h(o)m(v)m(erride)h(this)0 1483 y(v)-5 b(alue.)41
b(These)30 b(subroutines)f(do)i(not)f(create)i(or)f(mo)s(dify)e(the)i
(corresp)s(onding)e(header)h(k)m(eyw)m(ord)h(v)-5 b(alues.)0
1727 y Fh(1)81 b Fi(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 1840 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 1953 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
2066 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 2179 y(is)34 b(used)f(when)g
(writing)h(data)h(v)-5 b(alues)34 b(to)g(the)g(FITS)g(\014le.)51
b(\(NOTE:)34 b(BSCALE)f(and)g(BZER)m(O)h(m)m(ust)g(b)s(e)227
2292 y(declared)d(as)g(Double)g(Precision)g(v)-5 b(ariables\).)382
2536 y Fe(FTPSCL\(unit,bscale,bzero)o(,)42 b(>)47 b(status\))0
2780 y Fh(2)81 b Fi(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 2893 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 3006 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
3119 y(=)40 b(\(the)h(v)-5 b(alue)40 b(giv)m(en)h(in)f(the)g(FITS)g
(arra)m(y\))g(*)h(TSCAL)e(+)g(TZER)m(O.)h(The)f(in)m(v)m(erse)i(form)m
(ula)g(is)f(used)227 3232 y(when)33 b(writing)h(data)h(v)-5
b(alues)35 b(to)f(the)h(FITS)e(\014le.)52 b(\(NOTE:)34
b(TSCAL)f(and)g(TZER)m(O)g(m)m(ust)h(b)s(e)f(declared)227
3345 y(as)e(Double)g(Precision)g(v)-5 b(ariables\).)382
3589 y Fe(FTTSCL\(unit,colnum,tscal)o(,tz)o(ero,)41 b(>)48
b(status\))0 3833 y Fh(3)81 b Fi(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 3946
y(extension.)59 b(This)35 b(is)h(only)g(used)g(if)g(BITPIX)g(=)f(8,)j
(16,)h(32.)59 b(or)36 b(64)h(This)e(do)s(es)h(not)g(create)i(or)e(c)m
(hange)227 4059 y(the)27 b(v)-5 b(alue)28 b(of)f(the)g(BLANK)g(k)m(eyw)
m(ord)h(in)e(the)i(header.)39 b(FTPNULLL)27 b(is)g(iden)m(tical)h(to)g
(FTPNUL)f(except)227 4172 y(that)k(the)g(blank)f(v)-5
b(alue)31 b(is)f(a)h(64-bit)g(in)m(teger)h(instead)f(of)f(a)h(32-bit)h
(in)m(teger.)382 4416 y Fe(FTPNUL\(unit,blank,)43 b(>)k(status\))382
4529 y(FTPNULLL\(unit,blankll,)42 b(>)47 b(status\))0
4774 y Fh(4)81 b Fi(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 4887 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.)382 5131 y Fe(FTSNUL\(unit,colnum,snull)41 b(>)47
b(status\))0 5375 y Fh(5)81 b Fi(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
5488 y(\(where)42 b(TF)m(ORMn)f(=)g('B',)i('I',)f('J',)f(or)h('K'\).)g
(This)f(do)s(es)g(not)h(create)h(or)e(c)m(hange)i(the)e(v)-5
b(alue)42 b(of)g(the)227 5601 y(TNULLn)d(k)m(eyw)m(ord.)71
b(FTTNULLL)39 b(is)i(iden)m(tical)h(to)e(FTTNUL)g(except)h(that)g(the)f
(tn)m(ull)h(v)-5 b(alue)40 b(is)h(a)227 5714 y(64-bit)32
b(in)m(teger)g(instead)e(of)h(a)g(32-bit)g(in)m(teger.)p
eop end
%%Page: 52 58
TeXDict begin 52 57 bop 0 299 a Fi(52)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTTNUL\(unit,colnum,tnull)41
b(>)47 b(status\))382 668 y(FTTNULLL\(unit,colnum,tnu)o(lll)o(l)42
b(>)47 b(status\))0 1001 y Fd(6.6)135 b(FITS)44 b(Primary)h(Arra)l(y)g
(or)g(IMA)l(GE)g(Extension)h(I/O)f(Subroutines)0 1251
y Fi(These)26 b(subroutines)f(put)h(or)h(get)g(data)h(v)-5
b(alues)26 b(in)h(the)f(primary)g(data)h(arra)m(y)g(\(i.e.,)i(the)e
(\014rst)f(HDU)h(in)f(the)h(FITS)0 1364 y(\014le\))35
b(or)g(an)f(IMA)m(GE)i(extension.)54 b(The)34 b(data)i(arra)m(y)f(is)f
(represen)m(ted)h(as)g(a)g(single)g(one-dimensional)h(arra)m(y)f(of)0
1477 y(pixels)h(regardless)h(of)f(the)g(actual)h(dimensionalit)m(y)g
(of)g(the)f(arra)m(y)-8 b(,)38 b(and)e(the)g(FPIXEL)g(parameter)g(giv)m
(es)i(the)0 1590 y(p)s(osition)28 b(within)e(this)i(1-D)g(arra)m(y)g
(of)g(the)g(\014rst)e(pixel)i(to)g(read)g(or)f(write.)40
b(Automatic)29 b(data)f(t)m(yp)s(e)g(con)m(v)m(ersion)h(is)0
1703 y(p)s(erformed)g(for)i(n)m(umeric)g(data)g(\(except)i(for)d
(complex)i(data)f(t)m(yp)s(es\))h(if)f(the)g(data)g(t)m(yp)s(e)g(of)g
(the)g(primary)f(arra)m(y)0 1816 y(\(de\014ned)e(b)m(y)g(the)h(BITPIX)f
(k)m(eyw)m(ord\))h(di\013ers)g(from)f(the)g(data)i(t)m(yp)s(e)e(of)h
(the)g(arra)m(y)g(in)f(the)h(calling)h(subroutine.)0
1929 y(The)41 b(data)i(v)-5 b(alues)42 b(are)g(also)h(scaled)f(b)m(y)g
(the)g(BSCALE)f(and)g(BZER)m(O)h(header)f(v)-5 b(alues)42
b(as)g(they)g(are)g(b)s(eing)0 2042 y(written)32 b(or)g(read)g(from)g
(the)g(FITS)g(arra)m(y)-8 b(.)47 b(The)31 b(ftpscl)i(subroutine)e(MUST)
g(b)s(e)h(called)h(to)g(de\014ne)e(the)i(scaling)0 2155
y(parameters)h(when)e(writing)i(data)g(to)g(the)g(FITS)f(arra)m(y)h(or)
f(to)h(o)m(v)m(erride)h(the)f(default)f(scaling)i(v)-5
b(alue)34 b(giv)m(en)g(in)0 2267 y(the)d(header)f(when)f(reading)i(the)
f(FITS)g(arra)m(y)-8 b(.)0 2428 y(Tw)m(o)41 b(sets)f(of)h(subroutines)e
(are)i(pro)m(vided)f(to)h(read)g(the)f(data)i(arra)m(y)f(whic)m(h)f
(di\013er)g(in)g(the)h(w)m(a)m(y)g(unde\014ned)0 2541
y(pixels)35 b(are)h(handled.)55 b(The)35 b(\014rst)f(set)i(of)g
(routines)f(\(FTGPVx\))h(simply)f(return)f(an)h(arra)m(y)h(of)g(data)g
(elemen)m(ts)0 2653 y(in)c(whic)m(h)g(unde\014ned)e(pixels)i(are)h(set)
f(equal)h(to)g(a)g(v)-5 b(alue)32 b(sp)s(eci\014ed)g(b)m(y)g(the)g
(user)g(in)g(the)g('n)m(ullv)-5 b(al')33 b(parameter.)0
2766 y(An)h(additional)i(feature)f(of)f(these)h(subroutines)f(is)g
(that)i(if)e(the)h(user)f(sets)h(n)m(ullv)-5 b(al)35
b(=)f(0,)i(then)f(no)f(c)m(hec)m(ks)i(for)0 2879 y(unde\014ned)d
(pixels)j(will)g(b)s(e)e(p)s(erformed,)i(th)m(us)f(increasing)h(the)g
(sp)s(eed)e(of)i(the)g(program.)55 b(The)35 b(second)h(set)g(of)0
2992 y(routines)31 b(\(FTGPFx\))i(returns)d(the)i(data)g(elemen)m(t)h
(arra)m(y)f(and,)f(in)h(addition,)g(a)g(logical)i(arra)m(y)e(whic)m(h)f
(de\014nes)0 3105 y(whether)40 b(the)g(corresp)s(onding)f(data)i(pixel)
g(is)f(unde\014ned.)69 b(The)39 b(latter)j(set)f(of)f(subroutines)f(ma)
m(y)i(b)s(e)f(more)0 3218 y(con)m(v)m(enien)m(t)33 b(to)g(use)e(in)g
(some)g(circumstances,)i(ho)m(w)m(ev)m(er,)g(it)f(requires)f(an)g
(additional)h(arra)m(y)g(of)g(logical)i(v)-5 b(alues)0
3331 y(whic)m(h)36 b(can)g(b)s(e)g(un)m(wieldy)f(when)h(w)m(orking)g
(with)g(large)h(data)g(arra)m(ys.)58 b(Also)37 b(for)f(programmer)g
(con)m(v)m(enience,)0 3444 y(sets)j(of)g(subroutines)f(to)h(directly)h
(read)e(or)h(write)g(2)g(and)g(3)g(dimensional)g(arra)m(ys)g(ha)m(v)m
(e)h(b)s(een)e(pro)m(vided,)j(as)0 3557 y(w)m(ell)31
b(as)f(a)g(set)g(of)g(subroutines)e(to)i(read)g(or)g(write)f(an)m(y)h
(con)m(tiguous)h(rectangular)g(subset)e(of)h(pixels)g(within)f(the)0
3670 y(n-dimensional)h(arra)m(y)-8 b(.)0 3925 y Fh(1)81
b Fi(Get)39 b(the)g(data)h(t)m(yp)s(e)e(of)h(the)g(image)h(\(=)f
(BITPIX)f(v)-5 b(alue\).)67 b(P)m(ossible)39 b(returned)f(v)-5
b(alues)39 b(are:)58 b(8,)41 b(16,)h(32,)227 4038 y(64,)36
b(-32,)h(or)d(-64)h(corresp)s(onding)e(to)h(unsigned)f(b)m(yte,)j
(signed)e(2-b)m(yte)h(in)m(teger,)i(signed)d(4-b)m(yte)h(in)m(teger,)
227 4151 y(signed)c(8-b)m(yte)g(in)m(teger,)h(real,)g(and)d(double.)227
4300 y(The)d(second)f(subroutine)g(is)h(similar)g(to)g(FTGIDT,)h
(except)f(that)h(if)f(the)f(image)j(pixel)e(v)-5 b(alues)26
b(are)g(scaled,)227 4413 y(with)h(non-default)g(v)-5
b(alues)27 b(for)g(the)h(BZER)m(O)f(and)f(BSCALE)g(k)m(eyw)m(ords,)j
(then)e(this)g(routine)g(will)g(return)227 4526 y(the)32
b('equiv)-5 b(alen)m(t')33 b(data)e(t)m(yp)s(e)h(that)f(is)g(needed)g
(to)h(store)g(the)f(scaled)h(v)-5 b(alues.)43 b(F)-8
b(or)32 b(example,)g(if)f(BITPIX)227 4639 y(=)39 b(16)g(and)g(BSCALE)f
(=)g(0.1)i(then)f(the)g(equiv)-5 b(alen)m(t)40 b(data)f(t)m(yp)s(e)g
(is)g(\015oating)h(p)s(oin)m(t,)h(and)d(-32)i(will)g(b)s(e)227
4752 y(returned.)65 b(There)39 b(are)g(2)g(sp)s(ecial)h(cases:)58
b(if)39 b(the)g(image)h(con)m(tains)g(unsigned)e(2-b)m(yte)i(in)m
(teger)g(v)-5 b(alues,)227 4865 y(with)40 b(BITPIX)g(=)f(16,)44
b(BSCALE)39 b(=)h(1,)j(and)c(BZER)m(O)h(=)g(32768,)45
b(then)39 b(this)h(routine)g(will)h(return)e(a)227 4978
y(non-standard)26 b(v)-5 b(alue)27 b(of)g(20)h(for)f(the)g(bitpix)g(v)
-5 b(alue.)40 b(Similarly)27 b(if)f(the)i(image)g(con)m(tains)g
(unsigned)e(4-b)m(yte)227 5091 y(in)m(tegers,)32 b(then)e(bitpix)g
(will)h(b)s(e)f(returned)f(with)h(a)h(v)-5 b(alue)31
b(of)f(40.)382 5346 y Fe(FTGIDT\(unit,)44 b(>)k(bitpix,status\))382
5459 y(FTGIET\(unit,)c(>)k(bitpix,status\))0 5714 y Fh(2)81
b Fi(Get)31 b(the)g(dimension)e(\(n)m(um)m(b)s(er)h(of)g(axes)h(=)f
(NAXIS\))h(of)f(the)h(image)p eop end
%%Page: 53 59
TeXDict begin 53 58 bop 0 299 a Fg(6.6.)72 b(FITS)30
b(PRIMAR)-8 b(Y)31 b(ARRA)-8 b(Y)31 b(OR)f(IMA)m(GE)h(EXTENSION)e(I/O)i
(SUBR)m(OUTINES)589 b Fi(53)382 555 y Fe(FTGIDM\(unit,)44
b(>)k(naxis,status\))0 807 y Fh(3)81 b Fi(Get)38 b(the)f(size)h(of)f
(all)h(the)f(dimensions)g(of)g(the)g(image.)62 b(The)37
b(FTGISZLL)e(routine)i(returns)f(an)h(arra)m(y)h(of)227
920 y(64-bit)32 b(in)m(tegers)g(instead)e(of)h(32-bit)g(in)m(tegers.)
382 1172 y Fe(FTGISZ\(unit,)44 b(maxdim,)i(>)i(naxes,status\))382
1285 y(FTGISZLL\(unit,)c(maxdim,)i(>)h(naxesll,status\))0
1537 y Fh(4)81 b Fi(Get)35 b(the)f(parameters)g(that)h(de\014ne)e(the)h
(t)m(yp)s(e)g(and)g(size)g(of)h(the)f(image.)53 b(This)33
b(routine)h(simply)f(com)m(bines)227 1649 y(calls)40
b(to)f(the)g(ab)s(o)m(v)m(e)h(3)f(routines.)65 b(The)38
b(FTGIPRLL)g(routine)h(returns)e(an)i(arra)m(y)g(of)g(64-bit)h(in)m
(tegers)227 1762 y(instead)31 b(of)f(32-bit)i(in)m(tegers.)382
2014 y Fe(FTGIPR\(unit,)44 b(maxdim,)i(>)i(bitpix,)d(naxis,)h(naxes,)h
(int)f(*status\))382 2127 y(FTGIPRLL\(unit,)e(maxdim,)i(>)h(bitpix,)f
(naxis,)g(naxesll,)f(int)i(*status\))0 2379 y Fh(5)81
b Fi(Put)30 b(elemen)m(ts)h(in)m(to)h(the)e(data)h(arra)m(y)382
2631 y Fe(FTPPR[BIJKED]\(unit,group)o(,fp)o(ixel)o(,nel)o(eme)o(nts,)o
(valu)o(es,)41 b(>)48 b(status\))0 2883 y Fh(6)81 b Fi(Put)30
b(elemen)m(ts)i(in)m(to)f(the)g(data)g(arra)m(y)-8 b(,)32
b(substituting)e(the)g(appropriate)h(FITS)f(n)m(ull)g(v)-5
b(alue)31 b(for)f(all)i(elemen)m(ts)227 2996 y(whic)m(h)c(are)f(equal)i
(to)f(the)f(v)-5 b(alue)28 b(of)g(NULL)-10 b(V)g(AL.)28
b(F)-8 b(or)28 b(in)m(teger)h(FITS)e(arra)m(ys,)i(the)e(n)m(ull)h(v)-5
b(alue)28 b(de\014ned)e(b)m(y)227 3109 y(the)k(previous)f(call)i(to)g
(FTPNUL)e(will)h(b)s(e)f(substituted;)h(for)f(\015oating)i(p)s(oin)m(t)
f(FITS)f(arra)m(ys)h(\(BITPIX)f(=)227 3221 y(-32)j(or)e(-64\))i(then)e
(the)h(sp)s(ecial)g(IEEE)e(NaN)i(\(Not-a-Num)m(b)s(er\))h(v)-5
b(alue)31 b(will)g(b)s(e)f(substituted.)382 3473 y Fe
(FTPPN[BIJKED]\(unit,group)o(,fp)o(ixel)o(,nel)o(eme)o(nts,)o(valu)o
(es,)o(null)o(val)41 b(>)48 b(status\))0 3725 y Fh(7)81
b Fi(Set)30 b(data)h(arra)m(y)g(elemen)m(ts)h(as)e(unde\014ned)382
3977 y Fe(FTPPRU\(unit,group,fpixel)o(,ne)o(leme)o(nts,)41
b(>)47 b(status\))0 4229 y Fh(8)81 b Fi(Get)36 b(elemen)m(ts)g(from)f
(the)g(data)h(arra)m(y)-8 b(.)55 b(Unde\014ned)34 b(arra)m(y)h(elemen)m
(ts)i(will)e(b)s(e)g(returned)f(with)g(a)i(v)-5 b(alue)35
b(=)227 4342 y(n)m(ullv)-5 b(al,)31 b(unless)f(n)m(ullv)-5
b(al)31 b(=)f(0)h(in)f(whic)m(h)g(case)h(no)g(c)m(hec)m(ks)g(for)g
(unde\014ned)d(pixels)i(will)h(b)s(e)f(p)s(erformed.)382
4594 y Fe(FTGPV[BIJKED]\(unit,group)o(,fp)o(ixel)o(,nel)o(eme)o(nts,)o
(null)o(val)o(,)42 b(>)47 b(values,anyf,status\))0 4845
y Fh(9)81 b Fi(Get)32 b(elemen)m(ts)g(and)f(n)m(ull\015ags)g(from)g
(data)h(arra)m(y)-8 b(.)44 b(An)m(y)32 b(unde\014ned)d(arra)m(y)i
(elemen)m(ts)i(will)e(ha)m(v)m(e)i(the)e(corre-)227 4958
y(sp)s(onding)e(\015agv)-5 b(als)31 b(elemen)m(t)h(set)f(equal)g(to)g
(.TR)m(UE.)382 5210 y Fe(FTGPF[BIJKED]\(unit,group)o(,fp)o(ixel)o(,nel)
o(eme)o(nts,)41 b(>)48 b(values,flagvals,anyf,st)o(atu)o(s\))0
5462 y Fh(10)e Fi(Put)30 b(v)-5 b(alues)31 b(in)m(to)g(group)f
(parameters)382 5714 y Fe(FTPGP[BIJKED]\(unit,group)o(,fp)o(arm,)o
(npar)o(m,v)o(alue)o(s,)42 b(>)47 b(status\))p eop end
%%Page: 54 60
TeXDict begin 54 59 bop 0 299 a Fi(54)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fh(11)46 b Fi(Get)31 b(v)-5
b(alues)31 b(from)f(group)g(parameters)382 809 y Fe
(FTGGP[BIJKED]\(unit,group)o(,fp)o(arm,)o(npar)o(m,)41
b(>)48 b(values,status\))0 1062 y Fi(The)32 b(follo)m(wing)h(4)g
(subroutines)e(transfer)g(FITS)h(images)h(with)f(2)g(or)g(3)h
(dimensions)e(to)i(or)f(from)g(a)h(data)f(arra)m(y)0
1175 y(whic)m(h)h(has)g(b)s(een)g(declared)g(in)g(the)h(calling)h
(program.)49 b(The)33 b(dimensionalit)m(y)h(of)g(the)f(FITS)g(image)h
(is)f(passed)0 1288 y(b)m(y)26 b(the)g(naxis1,)h(naxis2,)h(and)d
(naxis3)i(parameters)f(and)f(the)h(declared)h(dimensions)e(of)h(the)g
(program)g(arra)m(y)h(are)0 1401 y(passed)k(in)f(the)i(dim1)e(and)h
(dim2)g(parameters.)43 b(Note)32 b(that)g(the)f(program)g(arra)m(y)g
(do)s(es)g(not)g(ha)m(v)m(e)i(to)e(ha)m(v)m(e)i(the)0
1514 y(same)28 b(dimensions)f(as)h(the)g(FITS)e(arra)m(y)-8
b(,)30 b(but)d(m)m(ust)g(b)s(e)g(at)i(least)f(as)g(big.)40
b(F)-8 b(or)29 b(example)f(if)f(a)h(FITS)f(image)i(with)0
1627 y(NAXIS1)i(=)f(NAXIS2)h(=)f(400)i(is)e(read)h(in)m(to)g(a)g
(program)f(arra)m(y)h(whic)m(h)f(is)h(dimensioned)f(as)g(512)i(x)f(512)
g(pixels,)0 1739 y(then)d(the)g(image)i(will)e(just)g(\014ll)g(the)h
(lo)m(w)m(er)g(left)g(corner)f(of)h(the)f(arra)m(y)h(with)f(pixels)g
(in)g(the)h(range)f(1)h(-)f(400)i(in)e(the)0 1852 y(X)k(an)g(Y)h
(directions.)47 b(This)31 b(has)h(the)h(e\013ect)g(of)g(taking)g(a)g
(con)m(tiguous)g(set)g(of)f(pixel)h(v)-5 b(alue)33 b(in)e(the)i(FITS)e
(arra)m(y)0 1965 y(and)k(writing)g(them)g(to)h(a)g(non-con)m(tiguous)g
(arra)m(y)f(in)g(program)g(memory)g(\(i.e.,)j(there)e(are)f(no)m(w)h
(some)f(blank)0 2078 y(pixels)c(around)e(the)h(edge)i(of)e(the)h(image)
g(in)f(the)h(program)f(arra)m(y\).)0 2332 y Fh(11)46
b Fi(Put)30 b(2-D)i(image)f(in)m(to)h(the)e(data)h(arra)m(y)382
2585 y Fe(FTP2D[BIJKED]\(unit,group)o(,di)o(m1,n)o(axis)o(1,n)o(axis)o
(2,im)o(age)o(,)42 b(>)47 b(status\))0 2838 y Fh(12)f
Fi(Put)30 b(3-D)i(cub)s(e)d(in)m(to)j(the)e(data)h(arra)m(y)382
3092 y Fe(FTP3D[BIJKED]\(unit,group)o(,di)o(m1,d)o(im2,)o(nax)o(is1,)o
(naxi)o(s2,)o(naxi)o(s3,c)o(ube)o(,)42 b(>)47 b(status\))0
3345 y Fh(13)f Fi(Get)29 b(2-D)f(image)h(from)f(the)f(data)i(arra)m(y)
-8 b(.)41 b(Unde\014ned)26 b(pixels)h(in)h(the)g(arra)m(y)g(will)g(b)s
(e)f(set)h(equal)g(to)h(the)e(v)-5 b(alue)227 3458 y(of)31
b('n)m(ullv)-5 b(al',)31 b(unless)f(n)m(ullv)-5 b(al=0)31
b(in)f(whic)m(h)g(case)i(no)e(testing)i(for)e(unde\014ned)e(pixels)i
(will)h(b)s(e)f(p)s(erformed.)382 3712 y Fe(FTG2D[BIJKED]\(unit,group)o
(,nu)o(llva)o(l,di)o(m1,)o(naxi)o(s1,n)o(axi)o(s2,)41
b(>)48 b(image,anyf,status\))0 3965 y Fh(14)e Fi(Get)31
b(3-D)h(cub)s(e)e(from)g(the)g(data)h(arra)m(y)-8 b(.)42
b(Unde\014ned)29 b(pixels)i(in)f(the)g(arra)m(y)h(will)g(b)s(e)f(set)h
(equal)g(to)g(the)f(v)-5 b(alue)227 4078 y(of)31 b('n)m(ullv)-5
b(al',)31 b(unless)f(n)m(ullv)-5 b(al=0)31 b(in)f(whic)m(h)g(case)i(no)
e(testing)i(for)e(unde\014ned)e(pixels)i(will)h(b)s(e)f(p)s(erformed.)
382 4331 y Fe(FTG3D[BIJKED]\(unit,group)o(,nu)o(llva)o(l,di)o(m1,)o
(dim2)o(,nax)o(is1)o(,nax)o(is2,)o(nax)o(is3,)41 b(>)1002
4444 y(cube,anyf,status\))0 4698 y Fi(The)i(follo)m(wing)h(subroutines)
e(transfer)h(a)h(rectangular)g(subset)e(of)i(the)f(pixels)g(in)g(a)h
(FITS)e(N-dimensional)0 4811 y(image)31 b(to)g(or)f(from)f(an)h(arra)m
(y)g(whic)m(h)g(has)g(b)s(een)f(declared)h(in)g(the)g(calling)i
(program.)40 b(The)29 b(fpixels)h(and)f(lpixels)0 4924
y(parameters)e(are)h(in)m(teger)g(arra)m(ys)g(whic)m(h)f(sp)s(ecify)f
(the)i(starting)g(and)e(ending)h(pixels)g(in)g(eac)m(h)h(dimension)e
(of)i(the)0 5036 y(FITS)36 b(image)i(that)f(are)g(to)h(b)s(e)e(read)g
(or)h(written.)60 b(\(Note)38 b(that)g(these)f(are)g(the)g(starting)g
(and)f(ending)h(pixels)0 5149 y(in)d(the)h(FITS)f(image,)k(not)d(in)f
(the)h(declared)g(arra)m(y\).)55 b(The)34 b(arra)m(y)i(parameter)f(is)g
(treated)g(simply)g(as)g(a)g(large)0 5262 y(one-dimensional)c(arra)m(y)
f(of)h(the)f(appropriate)g(datat)m(yp)s(e)h(con)m(taining)h(the)e
(pixel)g(v)-5 b(alues;)31 b(The)e(pixel)i(v)-5 b(alues)30
b(in)0 5375 y(the)c(FITS)f(arra)m(y)i(are)f(read/written)g(from/to)h
(this)f(program)f(arra)m(y)i(in)e(strict)i(sequence)f(without)g(an)m(y)
h(gaps;)g(it)0 5488 y(is)i(up)e(to)j(the)f(calling)h(routine)f(to)g
(correctly)h(in)m(terpret)f(the)g(dimensionalit)m(y)h(of)f(this)g(arra)
m(y)-8 b(.)41 b(The)28 b(t)m(w)m(o)i(families)0 5601
y(of)d(FITS)g(reading)g(routines)g(\(FTGSVx)g(and)g(FTGSFx)g
(subroutines\))f(also)j(ha)m(v)m(e)f(an)f('incs')h(parameter)f(whic)m
(h)0 5714 y(de\014nes)j(the)h(data)h(sampling)e(in)m(terv)-5
b(al)32 b(in)f(eac)m(h)h(dimension)e(of)h(the)g(FITS)f(arra)m(y)-8
b(.)43 b(F)-8 b(or)32 b(example,)g(if)f(incs\(1\)=2)p
eop end
%%Page: 55 61
TeXDict begin 55 60 bop 0 299 a Fg(6.7.)72 b(FITS)30
b(ASCI)s(I)f(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(D)m(A)-8
b(T)g(A)32 b(I/O)e(SUBR)m(OUTINES)979 b Fi(55)0 555 y(and)33
b(incs\(2\)=3)h(when)f(reading)g(a)h(2-dimensional)g(FITS)f(image,)i
(then)e(only)h(ev)m(ery)g(other)f(pixel)h(in)f(the)h(\014rst)0
668 y(dimension)e(and)h(ev)m(ery)h(3rd)e(pixel)i(in)f(the)g(second)g
(dimension)f(will)i(b)s(e)e(returned)g(in)h(the)g('arra)m(y')h
(parameter.)0 781 y([Note:)39 b(the)25 b(FTGSSx)f(family)i(of)e
(routines)h(whic)m(h)g(w)m(ere)g(presen)m(t)g(in)f(previous)g(v)m
(ersions)h(of)g(FITSIO)f(ha)m(v)m(e)i(b)s(een)0 894 y(sup)s(erseded)i
(b)m(y)j(the)f(more)h(general)g(FTGSVx)f(family)h(of)g(routines.])0
1152 y Fh(15)46 b Fi(Put)30 b(an)g(arbitrary)g(data)h(subsection)g(in)m
(to)g(the)g(data)g(arra)m(y)-8 b(.)382 1411 y Fe
(FTPSS[BIJKED]\(unit,group)o(,na)o(xis,)o(naxe)o(s,f)o(pixe)o(ls,l)o
(pix)o(els,)o(arra)o(y,)41 b(>)48 b(status\))0 1669 y
Fh(16)e Fi(Get)30 b(an)e(arbitrary)g(data)i(subsection)e(from)g(the)h
(data)g(arra)m(y)-8 b(.)42 b(Unde\014ned)27 b(pixels)h(in)h(the)f(arra)
m(y)i(will)e(b)s(e)g(set)227 1782 y(equal)k(to)h(the)e(v)-5
b(alue)33 b(of)e('n)m(ullv)-5 b(al',)33 b(unless)e(n)m(ullv)-5
b(al=0)33 b(in)e(whic)m(h)g(case)i(no)e(testing)i(for)e(unde\014ned)f
(pixels)227 1895 y(will)h(b)s(e)f(p)s(erformed.)382 2154
y Fe(FTGSV[BIJKED]\(unit,group)o(,na)o(xis,)o(naxe)o(s,f)o(pixe)o(ls,l)
o(pix)o(els,)o(incs)o(,nu)o(llva)o(l,)42 b(>)1002 2266
y(array,anyf,status\))0 2525 y Fh(17)k Fi(Get)34 b(an)f(arbitrary)g
(data)g(subsection)g(from)g(the)g(data)g(arra)m(y)-8
b(.)50 b(An)m(y)33 b(Unde\014ned)e(pixels)i(in)g(the)g(arra)m(y)h(will)
227 2638 y(ha)m(v)m(e)e(the)e(corresp)s(onding)g('\015agv)-5
b(als')31 b(elemen)m(t)h(set)f(equal)g(to)g(.TR)m(UE.)382
2896 y Fe(FTGSF[BIJKED]\(unit,group)o(,na)o(xis,)o(naxe)o(s,f)o(pixe)o
(ls,l)o(pix)o(els,)o(incs)o(,)42 b(>)1002 3009 y
(array,flagvals,anyf,statu)o(s\))0 3343 y Fd(6.7)135
b(FITS)44 b(ASCI)t(I)g(and)h(Binary)g(T)-11 b(able)45
b(Data)h(I/O)f(Subroutines)0 3596 y Fb(6.7.1)112 b(Column)39
b(Information)f(Subroutines)0 3805 y Fh(1)81 b Fi(Get)37
b(the)f(n)m(um)m(b)s(er)f(of)i(ro)m(ws)f(or)g(columns)g(in)g(the)h
(curren)m(t)f(FITS)g(table.)59 b(The)36 b(n)m(um)m(b)s(er)f(of)h(ro)m
(ws)h(is)f(giv)m(en)227 3918 y(b)m(y)f(the)h(NAXIS2)f(k)m(eyw)m(ord)h
(and)f(the)g(n)m(um)m(b)s(er)f(of)h(columns)g(is)g(giv)m(en)h(b)m(y)g
(the)f(TFIELDS)g(k)m(eyw)m(ord)g(in)227 4031 y(the)d(header)f(of)h(the)
g(table.)45 b(The)31 b(FTGNR)-10 b(WLL)32 b(routine)g(is)f(iden)m
(tical)i(to)g(FTGNR)-10 b(W)32 b(except)h(that)f(the)227
4144 y(n)m(um)m(b)s(er)d(of)i(ro)m(ws)f(is)h(returned)e(as)h(a)h
(64-bit)h(in)m(teger)g(rather)e(than)g(a)h(32-bit)g(in)m(teger.)382
4402 y Fe(FTGNRW\(unit,)44 b(>)k(nrows,)e(status\))382
4515 y(FTGNRWLL\(unit,)e(>)j(nrowsll,)f(status\))382
4628 y(FTGNCL\(unit,)e(>)k(ncols,)e(status\))0 4886 y
Fh(2)81 b Fi(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 4999 y(name.)38 b(The)21 b(table)i(column)e(names)h(are)g
(de\014ned)e(b)m(y)i(the)g(TTYPEn)e(k)m(eyw)m(ords)i(in)f(the)h(FITS)f
(header.)37 b(If)22 b(a)227 5112 y(column)i(do)s(es)g(not)g(ha)m(v)m(e)
h(a)f(TTYPEn)f(k)m(eyw)m(ord,)j(then)d(these)h(routines)g(assume)g
(that)g(the)h(name)e(consists)227 5225 y(of)i(all)h(blank)f(c)m
(haracters.)40 b(These)25 b(2)g(subroutines)e(p)s(erform)h(the)h(same)g
(function)g(except)h(that)f(FTGCNO)227 5338 y(only)j(returns)e(the)h(n)
m(um)m(b)s(er)f(of)h(the)g(matc)m(hing)i(column)e(whereas)g(FTGCNN)g
(also)h(returns)e(the)i(name)f(of)227 5451 y(the)k(column.)40
b(If)30 b(CASESEN)f(=)h(.true.)41 b(then)30 b(the)h(column)f(name)g
(matc)m(h)i(will)e(b)s(e)g(case-sensitiv)m(e.)227 5601
y(The)41 b(input)e(column)i(name)g(template)h(\(COL)-8
b(TEMPLA)g(TE\))41 b(is)g(\(1\))g(either)h(the)f(exact)h(name)f(of)g
(the)227 5714 y(column)36 b(to)i(b)s(e)d(searc)m(hed)i(for,)h(or)e
(\(2\))i(it)f(ma)m(y)g(con)m(tain)g(wild)f(cards)g(c)m(haracters)i
(\(*,)h(?,)f(or)e(#\),)i(or)f(\(3\))p eop end
%%Page: 56 62
TeXDict begin 56 61 bop 0 299 a Fi(56)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)227 555 y Fi(it)k(ma)m(y)g(con)m(tain)g(the)f(n)m(um)m
(b)s(er)f(of)h(the)g(desired)g(column)g(\(where)g(the)g(n)m(um)m(b)s
(er)f(is)h(expressed)f(as)h(ASCI)s(I)227 668 y(digits\).)41
b(The)28 b(\014rst)g(2)h(wild)f(cards)g(b)s(eha)m(v)m(e)h(similarly)g
(to)g(UNIX)g(\014lename)g(matc)m(hing:)40 b(the)29 b('*')g(c)m
(haracter)227 781 y(matc)m(hes)e(an)m(y)g(sequence)f(of)h(c)m
(haracters)g(\(including)f(zero)h(c)m(haracters\))h(and)d(the)i(')10
b(?')39 b(c)m(haracter)28 b(matc)m(hes)227 894 y(an)m(y)40
b(single)h(c)m(haracter.)71 b(The)39 b(#)h(wildcard)f(will)h(matc)m(h)h
(an)m(y)f(consecutiv)m(e)i(string)e(of)g(decimal)g(digits)227
1007 y(\(0-9\).)45 b(As)31 b(an)g(example,)h(the)f(template)h(strings)f
('AB?DE',)h('AB*E',)h(and)d('AB*CDE')j(will)e(all)h(matc)m(h)227
1120 y(the)26 b(string)g('ABCDE'.)i(If)d(more)h(than)g(one)g(column)g
(name)g(in)g(the)g(table)h(matc)m(hes)g(the)f(template)i(string,)227
1233 y(then)33 b(the)h(\014rst)f(matc)m(h)h(is)f(returned)g(and)f(the)i
(status)g(v)-5 b(alue)34 b(will)f(b)s(e)g(set)h(to)g(237)h(as)f(a)f(w)m
(arning)h(that)g(a)227 1346 y(unique)g(matc)m(h)i(w)m(as)f(not)g
(found.)53 b(T)-8 b(o)35 b(\014nd)f(the)h(other)g(cases)g(that)h(matc)m
(h)g(the)f(template,)i(simply)e(call)227 1458 y(the)27
b(subroutine)f(again)i(lea)m(ving)h(the)e(input)f(status)h(v)-5
b(alue)28 b(equal)f(to)h(237)g(and)f(the)g(next)g(matc)m(hing)h(name)
227 1571 y(will)k(then)g(b)s(e)f(returned.)43 b(Rep)s(eat)32
b(this)g(pro)s(cess)f(un)m(til)h(a)g(status)g(=)g(219)h(\(column)e
(name)h(not)g(found\))f(is)227 1684 y(returned.)40 b(If)30
b(these)h(subroutines)e(fail)i(to)g(matc)m(h)g(the)g(template)h(to)f
(an)m(y)g(of)f(the)h(columns)f(in)g(the)h(table,)227
1797 y(they)i(lastly)g(c)m(hec)m(k)h(if)f(the)f(template)i(can)f(b)s(e)
e(in)m(terpreted)i(as)g(a)g(simple)f(p)s(ositiv)m(e)h(in)m(teger)h
(\(e.g.,)h('7',)f(or)227 1910 y('512'\))i(and)d(if)g(so,)i(they)f
(return)e(that)j(column)e(n)m(um)m(b)s(er.)49 b(If)33
b(no)g(matc)m(hes)i(are)f(found)e(then)h(a)h(status)g(=)227
2023 y(219)e(error)e(is)g(returned.)227 2187 y(Note)h(that)e(the)h
(FITS)e(Standard)g(recommends)g(that)i(only)f(letters,)i(digits,)f(and)
f(the)g(underscore)f(c)m(har-)227 2300 y(acter)44 b(b)s(e)e(used)g(in)h
(column)f(names)h(\(with)g(no)f(em)m(b)s(edded)g(spaces)h(in)g(the)g
(name\).)78 b(T)-8 b(railing)43 b(blank)227 2412 y(c)m(haracters)32
b(are)f(not)f(signi\014can)m(t.)382 2699 y Fe
(FTGCNO\(unit,casesen,colt)o(emp)o(late)o(,)42 b(>)47
b(colnum,status\))382 2812 y(FTGCNN\(unit,casesen,colt)o(emp)o(late)o
(,)42 b(>)47 b(colname,colnum,status\))0 3098 y Fh(3)81
b Fi(Get)39 b(the)g(datat)m(yp)s(e)h(of)e(a)h(column)g(in)f(an)g(ASCI)s
(I)g(or)g(binary)g(table.)66 b(This)38 b(routine)h(returns)e(an)i(in)m
(teger)227 3211 y(co)s(de)34 b(v)-5 b(alue)33 b(corresp)s(onding)f(to)i
(the)g(datat)m(yp)s(e)g(of)f(the)g(column.)49 b(\(See)34
b(the)f(FTBNFM)i(and)d(FT)-8 b(ASFM)227 3324 y(subroutines)27
b(in)h(the)g(Utilities)j(section)e(of)f(this)g(do)s(cumen)m(t)g(for)g
(a)h(list)g(of)f(the)h(co)s(de)f(v)-5 b(alues\).)41 b(The)27
b(v)m(ector)227 3437 y(rep)s(eat)38 b(coun)m(t)g(\(whic)m(h)g(is)g(alw)
m(a)m(y)h(1)f(for)g(ASCI)s(I)e(table)i(columns\))g(is)g(also)g
(returned.)62 b(If)37 b(the)h(sp)s(eci\014ed)227 3550
y(column)32 b(has)f(an)g(ASCI)s(I)f(c)m(haracter)j(datat)m(yp)s(e)g
(\(co)s(de)f(=)f(16\))i(then)e(the)h(width)e(of)i(a)g(unit)f(string)h
(in)f(the)227 3663 y(column)i(is)g(also)h(returned.)48
b(Note)34 b(that)g(this)e(routine)h(supp)s(orts)f(the)h(lo)s(cal)h(con)
m(v)m(en)m(tion)h(for)e(sp)s(ecifying)227 3776 y(arra)m(ys)f(of)f
(strings)g(within)f(a)i(binary)e(table)i(c)m(haracter)g(column,)g
(using)e(the)h(syn)m(tax)h(TF)m(ORM)f(=)g('rAw')227 3889
y(where)f('r')g(is)h(the)f(total)i(n)m(um)m(b)s(er)d(of)i(c)m
(haracters)g(\(=)g(the)f(width)g(of)g(the)g(column\))h(and)f('w')g(is)g
(the)h(width)227 4002 y(of)39 b(a)f(unit)g(string)g(within)g(the)g
(column.)64 b(Th)m(us)37 b(if)h(the)g(column)g(has)g(TF)m(ORM)h(=)f
('60A12')i(then)e(this)227 4114 y(routine)29 b(will)g(return)f(dataco)s
(de)i(=)e(16,)i(rep)s(eat)f(=)f(60,)j(and)d(width)g(=)g(12.)41
b(\(The)29 b(TDIMn)f(k)m(eyw)m(ord)h(ma)m(y)227 4227
y(also)35 b(b)s(e)e(used)g(to)h(sp)s(ecify)f(the)h(unit)f(string)h
(length;)i(The)d(pair)g(of)h(k)m(eyw)m(ords)g(TF)m(ORMn)f(=)g('60A')j
(and)227 4340 y(TDIMn)30 b(=)g('\(12,5\)')j(w)m(ould)e(ha)m(v)m(e)g
(the)g(same)g(e\013ect)g(as)g(TF)m(ORMn)f(=)g('60A12'\).)227
4504 y(The)h(second)h(routine,)g(FTEQTY)f(is)g(similar)h(except)h(that)
f(in)f(the)h(case)g(of)g(scaled)g(in)m(teger)h(columns)e(it)227
4617 y(returns)23 b(the)h('equiv)-5 b(alen)m(t')25 b(data)f(t)m(yp)s(e)
g(that)h(is)e(needed)h(to)g(store)g(the)g(scaled)g(v)-5
b(alues,)26 b(and)d(not)h(necessarily)227 4730 y(the)38
b(ph)m(ysical)h(data)f(t)m(yp)s(e)g(of)g(the)g(unscaled)g(v)-5
b(alues)38 b(as)g(stored)g(in)g(the)g(FITS)f(table.)64
b(F)-8 b(or)38 b(example)h(if)227 4843 y(a)c('1I')g(column)f(in)g(a)g
(binary)g(table)h(has)f(TSCALn)f(=)g(1)i(and)f(TZER)m(On)f(=)g(32768,)
38 b(then)c(this)g(column)227 4956 y(e\013ectiv)m(ely)27
b(con)m(tains)e(unsigned)e(short)g(in)m(teger)j(v)-5
b(alues,)25 b(and)f(th)m(us)f(the)h(returned)f(v)-5 b(alue)24
b(of)g(t)m(yp)s(eco)s(de)h(will)227 5068 y(b)s(e)32 b(the)h(co)s(de)g
(for)g(an)f(unsigned)g(short)g(in)m(teger,)j(not)e(a)g(signed)g(short)f
(in)m(teger.)49 b(Similarly)-8 b(,)34 b(if)f(a)g(column)227
5181 y(has)d(TTYPEn)g(=)g('1I')h(and)f(TSCALn)e(=)i(0.12,)j(then)d(the)
g(returned)g(t)m(yp)s(eco)s(de)g(will)h(b)s(e)f(the)h(co)s(de)f(for)h
(a)227 5294 y('real')h(column.)382 5581 y Fe(FTGTCL\(unit,colnum,)42
b(>)48 b(datacode,repeat,width,st)o(atu)o(s\))382 5694
y(FTEQTY\(unit,colnum,)42 b(>)48 b(datacode,repeat,width,st)o(atu)o
(s\))p eop end
%%Page: 57 63
TeXDict begin 57 62 bop 0 299 a Fg(6.7.)72 b(FITS)30
b(ASCI)s(I)f(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(D)m(A)-8
b(T)g(A)32 b(I/O)e(SUBR)m(OUTINES)979 b Fi(57)0 555 y
Fh(4)81 b Fi(Return)22 b(the)i(displa)m(y)g(width)f(of)g(a)h(column.)39
b(This)22 b(is)i(the)g(length)g(of)f(the)h(string)g(that)g(will)g(b)s
(e)f(returned)f(when)227 668 y(reading)33 b(the)g(column)g(as)g(a)g
(formatted)g(string.)48 b(The)32 b(displa)m(y)h(width)f(is)h
(determined)g(b)m(y)f(the)h(TDISPn)227 781 y(k)m(eyw)m(ord,)e(if)g
(presen)m(t,)f(otherwise)h(b)m(y)f(the)h(data)g(t)m(yp)s(e)g(of)f(the)h
(column.)382 1012 y Fe(FTGCDW\(unit,)44 b(colnum,)i(>)i(dispwidth,)d
(status\))0 1243 y Fh(5)81 b Fi(Get)29 b(information)f(ab)s(out)g(an)g
(existing)h(ASCI)s(I)e(table)i(column.)40 b(\(NOTE:)28
b(TSCAL)f(and)g(TZER)m(O)h(m)m(ust)g(b)s(e)227 1356 y(declared)j(as)g
(Double)g(Precision)g(v)-5 b(ariables\).)41 b(All)31
b(the)g(returned)e(parameters)i(are)f(scalar)i(quan)m(tities.)382
1586 y Fe(FTGACL\(unit,colnum,)42 b(>)716 1699 y
(ttype,tbcol,tunit,tform,)o(tsca)o(l,t)o(zero)o(,snu)o(ll,)o(tdis)o
(p,st)o(atu)o(s\))0 1930 y Fh(6)81 b Fi(Get)29 b(information)f(ab)s
(out)f(an)h(existing)h(binary)e(table)i(column.)40 b(\(NOTE:)28
b(TSCAL)e(and)i(TZER)m(O)f(m)m(ust)h(b)s(e)227 2043 y(declared)j(as)f
(Double)g(Precision)h(v)-5 b(ariables\).)41 b(D)m(A)-8
b(T)g(A)g(TYPE)32 b(is)e(a)g(c)m(haracter)i(string)d(whic)m(h)h
(returns)f(the)227 2156 y(datat)m(yp)s(e)35 b(of)g(the)f(column)g(as)g
(de\014ned)f(b)m(y)h(the)g(TF)m(ORMn)g(k)m(eyw)m(ord)h(\(e.g.,)i('I',)e
('J','E',)g('D',)g(etc.\).)54 b(In)227 2269 y(the)27
b(case)g(of)g(an)f(ASCI)s(I)f(c)m(haracter)j(column,)f(D)m(A)-8
b(T)g(A)g(TYPE)29 b(will)d(ha)m(v)m(e)i(a)f(v)-5 b(alue)27
b(of)f(the)h(form)f('An')g(where)227 2382 y('n')34 b(is)g(an)g(in)m
(teger)i(expressing)e(the)g(width)f(of)h(the)h(\014eld)e(in)h(c)m
(haracters.)53 b(F)-8 b(or)35 b(example,)h(if)e(TF)m(ORM)g(=)227
2495 y('160A8')39 b(then)e(FTGBCL)f(will)h(return)f(D)m(A)-8
b(T)g(A)g(TYPE='A8')39 b(and)d(REPEA)-8 b(T=20.)60 b(All)37
b(the)g(returned)227 2608 y(parameters)31 b(are)g(scalar)g(quan)m
(tities.)382 2838 y Fe(FTGBCL\(unit,colnum,)42 b(>)716
2951 y(ttype,tunit,datatype,rep)o(eat,)o(tsc)o(al,t)o(zero)o(,tn)o
(ull,)o(tdis)o(p,s)o(tatu)o(s\))0 3182 y Fh(7)81 b Fi(Put)31
b(\(app)s(end\))g(a)i(TDIMn)f(k)m(eyw)m(ord)g(whose)g(v)-5
b(alue)33 b(has)f(the)g(form)g('\(l,m,n...\)')47 b(where)32
b(l,)h(m,)f(n...)46 b(are)33 b(the)227 3295 y(dimensions)d(of)g(a)h(m)m
(ultidimensional)g(arra)m(y)g(column)f(in)g(a)h(binary)f(table.)382
3526 y Fe(FTPTDM\(unit,colnum,naxis)o(,na)o(xes,)41 b(>)48
b(status\))0 3757 y Fh(8)81 b Fi(Return)29 b(the)h(n)m(um)m(b)s(er)e
(of)i(and)g(size)g(of)g(the)g(dimensions)g(of)g(a)g(table)h(column.)40
b(Normally)31 b(this)f(information)227 3870 y(is)h(giv)m(en)h(b)m(y)f
(the)g(TDIMn)f(k)m(eyw)m(ord,)i(but)e(if)h(this)g(k)m(eyw)m(ord)g(is)g
(not)g(presen)m(t)g(then)g(this)f(routine)h(returns)227
3983 y(NAXIS)f(=)g(1)h(and)f(NAXES\(1\))h(equal)g(to)g(the)g(rep)s(eat)
g(coun)m(t)g(in)f(the)g(TF)m(ORM)h(k)m(eyw)m(ord.)382
4213 y Fe(FTGTDM\(unit,colnum,maxdi)o(m,)41 b(>)48 b
(naxis,naxes,status\))0 4444 y Fh(9)81 b Fi(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 4557 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 4670 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 4783 y(This)30 b(routine)g(is)h
(called)g(b)m(y)f(FTGTDM.)382 5014 y Fe(FTDTDM\(unit,tdimstr,coln)o
(um,)o(maxd)o(im,)41 b(>)48 b(naxis,naxes,)c(status\))0
5245 y Fh(10)i Fi(Return)32 b(the)h(optimal)h(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)e(maxim)m(um)
h(I/O)g(e\016ciency)-8 b(.)227 5358 y(Refer)31 b(to)g(the)g
(\\Optimizing)g(Co)s(de")f(section)i(in)e(Chapter)g(5)g(for)h(more)f
(discussion)g(on)g(ho)m(w)h(to)g(use)f(this)227 5470
y(routine.)382 5701 y Fe(FFGRSZ\(unit,)44 b(>)k(nrows,status\))p
eop end
%%Page: 58 64
TeXDict begin 58 63 bop 0 299 a Fi(58)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fb(6.7.2)112 b(Lo)m(w-Lev)m(el)39
b(T)-9 b(able)38 b(Access)f(Subroutines)0 774 y Fi(The)d(follo)m(wing)h
(subroutines)e(pro)m(vide)i(lo)m(w-lev)m(el)i(access)e(to)g(the)g(data)
g(in)f(ASCI)s(I)e(or)i(binary)g(tables)h(and)f(are)0
887 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 1000 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
1113 y(without)37 b(regard)g(for)f(column)h(b)s(oundaries)e(or)i(the)g
(ro)m(w)g(length)h(in)e(the)h(table.)61 b(The)37 b(\014rst)f(t)m(w)m(o)
i(subroutines)0 1226 y(read)29 b(or)h(write)g(consecutiv)m(e)h(b)m
(ytes)f(in)f(a)h(table)g(to)h(or)e(from)g(a)h(c)m(haracter)h(string)e
(v)-5 b(ariable,)31 b(while)f(the)f(last)i(t)m(w)m(o)0
1339 y(subroutines)f(read)i(or)g(write)g(consecutiv)m(e)h(b)m(ytes)g
(to)f(or)g(from)f(a)h(v)-5 b(ariable)33 b(declared)f(as)g(a)g(n)m
(umeric)f(data)i(t)m(yp)s(e)0 1452 y(\(e.g.,)40 b(INTEGER,)d
(INTEGER*2,)i(REAL,)d(DOUBLE)h(PRECISION\).)f(These)g(routines)h(do)f
(not)h(p)s(erform)0 1564 y(an)m(y)c(mac)m(hine)g(dep)s(enden)m(t)f
(data)i(con)m(v)m(ersion)g(or)e(b)m(yte)i(sw)m(apping,)f(except)h(that)
f(con)m(v)m(ersion)h(to/from)f(ASCI)s(I)0 1677 y(format)d(is)g(p)s
(erformed)e(b)m(y)h(the)h(FTGTBS)f(and)g(FTPTBS)g(routines)h(on)f(mac)m
(hines)h(whic)m(h)g(do)f(not)h(use)f(ASCI)s(I)0 1790
y(c)m(haracter)j(co)s(des)e(in)g(the)h(in)m(ternal)g(data)g(represen)m
(tations)h(\(e.g.,)g(on)e(IBM)h(mainframe)f(computers\).)0
2049 y Fh(1)81 b Fi(Read)26 b(a)h(consecutiv)m(e)h(string)f(of)f(c)m
(haracters)i(from)e(an)g(ASCI)s(I)f(table)i(in)m(to)h(a)e(c)m(haracter)
i(v)-5 b(ariable)28 b(\(spanning)227 2162 y(columns)k(and)g(m)m
(ultiple)h(ro)m(ws)f(if)g(necessary\))h(This)f(routine)g(should)f(not)i
(b)s(e)e(used)h(with)g(binary)f(tables)227 2275 y(b)s(ecause)g(of)f
(complications)i(related)g(to)f(passing)f(string)g(v)-5
b(ariables)31 b(b)s(et)m(w)m(een)g(C)f(and)g(F)-8 b(ortran.)382
2533 y Fe(FTGTBS\(unit,frow,startch)o(ar,)o(ncha)o(rs,)41
b(>)48 b(string,status\))0 2792 y Fh(2)81 b Fi(W)-8 b(rite)31
b(a)g(consecutiv)m(e)h(string)e(of)h(c)m(haracters)g(to)g(an)f(ASCI)s
(I)f(table)i(from)f(a)h(c)m(haracter)h(v)-5 b(ariable)31
b(\(spanning)227 2905 y(columns)h(and)g(m)m(ultiple)h(ro)m(ws)f(if)g
(necessary\))h(This)f(routine)g(should)f(not)i(b)s(e)e(used)h(with)g
(binary)f(tables)227 3018 y(b)s(ecause)g(of)f(complications)i(related)g
(to)f(passing)f(string)g(v)-5 b(ariables)31 b(b)s(et)m(w)m(een)g(C)f
(and)g(F)-8 b(ortran.)382 3277 y Fe(FTPTBS\(unit,frow,startch)o(ar,)o
(ncha)o(rs,s)o(tri)o(ng,)41 b(>)48 b(status\))0 3535
y Fh(3)81 b Fi(Read)27 b(a)h(consecutiv)m(e)i(arra)m(y)e(of)g(b)m(ytes)
g(from)f(an)g(ASCI)s(I)f(or)i(binary)e(table)j(in)m(to)f(a)g(n)m
(umeric)g(v)-5 b(ariable)28 b(\(span-)227 3648 y(ning)k(columns)f(and)h
(m)m(ultiple)g(ro)m(ws)g(if)g(necessary\).)46 b(The)32
b(arra)m(y)g(parameter)g(ma)m(y)h(b)s(e)e(declared)h(as)h(an)m(y)227
3761 y(n)m(umerical)i(datat)m(yp)s(e)g(as)g(long)g(as)g(the)f(arra)m(y)
h(is)f(at)h(least)h('nc)m(hars')f(b)m(ytes)f(long,)j(e.g.,)f(if)f(nc)m
(hars)f(=)g(17,)227 3874 y(then)c(declare)i(the)e(arra)m(y)h(as)g
(INTEGER*4)g(ARRA)-8 b(Y\(5\).)382 4133 y Fe(FTGTBB\(unit,frow,startch)
o(ar,)o(ncha)o(rs,)41 b(>)48 b(array,status\))0 4391
y Fh(4)81 b Fi(W)-8 b(rite)32 b(a)f(consecutiv)m(e)i(arra)m(y)f(of)f(b)
m(ytes)g(to)h(an)e(ASCI)s(I)g(or)h(binary)f(table)i(from)e(a)i(n)m
(umeric)e(v)-5 b(ariable)32 b(\(span-)227 4504 y(ning)j(columns)f(and)g
(m)m(ultiple)h(ro)m(ws)g(if)f(necessary\))i(The)e(arra)m(y)h(parameter)
g(ma)m(y)h(b)s(e)e(declared)h(as)g(an)m(y)227 4617 y(n)m(umerical)g
(datat)m(yp)s(e)g(as)g(long)g(as)g(the)f(arra)m(y)h(is)f(at)h(least)h
('nc)m(hars')f(b)m(ytes)f(long,)j(e.g.,)f(if)f(nc)m(hars)f(=)g(17,)227
4730 y(then)c(declare)i(the)e(arra)m(y)h(as)g(INTEGER*4)g(ARRA)-8
b(Y\(5\).)382 4989 y Fe(FTPTBB\(unit,frow,startch)o(ar,)o(ncha)o(rs,a)o
(rra)o(y,)42 b(>)47 b(status\))0 5279 y Fb(6.7.3)112
b(Edit)37 b(Ro)m(ws)g(or)h(Columns)0 5488 y Fh(1)81 b
Fi(Insert)26 b(blank)h(ro)m(ws)h(in)m(to)g(an)f(existing)h(ASCI)s(I)e
(or)h(binary)g(table)h(\(in)g(the)f(CDU\).)h(All)g(the)g(ro)m(ws)f(F)m
(OLLO)m(W-)227 5601 y(ING)35 b(ro)m(w)g(FR)m(O)m(W)g(are)g(shifted)f
(do)m(wn)g(b)m(y)h(NR)m(O)m(WS)g(ro)m(ws.)53 b(If)34
b(FR)m(O)m(W)i(or)e(FR)m(O)m(WLL)i(equals)e(0)h(then)227
5714 y(the)27 b(blank)f(ro)m(ws)h(are)g(inserted)f(at)h(the)g(b)s
(eginning)f(of)g(the)h(table.)41 b(These)26 b(routines)g(mo)s(dify)g
(the)h(NAXIS2)p eop end
%%Page: 59 65
TeXDict begin 59 64 bop 0 299 a Fg(6.7.)72 b(FITS)30
b(ASCI)s(I)f(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(D)m(A)-8
b(T)g(A)32 b(I/O)e(SUBR)m(OUTINES)979 b Fi(59)227 555
y(k)m(eyw)m(ord)35 b(to)h(re\015ect)f(the)g(new)f(n)m(um)m(b)s(er)f(of)
i(ro)m(ws)g(in)f(the)h(table.)54 b(Note)36 b(that)f(it)h(is)e(*not*)i
(necessary)f(to)227 668 y(insert)c(ro)m(ws)f(in)g(a)h(table)g(b)s
(efore)f(writing)g(data)i(to)f(those)g(ro)m(ws)f(\(indeed,)g(it)h(w)m
(ould)g(b)s(e)e(ine\016cien)m(t)j(to)f(do)227 781 y(so\).)54
b(Instead,)35 b(one)g(ma)m(y)g(simply)f(write)h(data)g(to)g(an)m(y)g
(ro)m(w)f(of)h(the)g(table,)h(whether)e(that)h(ro)m(w)g(of)f(data)227
894 y(already)d(exists)g(or)g(not.)382 1116 y Fe
(FTIROW\(unit,frow,nrows,)41 b(>)48 b(status\))382 1229
y(FTIROWLL\(unit,frowll,nro)o(wsl)o(l,)42 b(>)47 b(status\))0
1451 y Fh(2)81 b Fi(Delete)25 b(ro)m(ws)f(from)f(an)g(existing)i(ASCI)s
(I)c(or)j(binary)f(table)h(\(in)f(the)h(CDU\).)g(The)f(NR)m(O)m(WS)h
(\(or)g(NR)m(O)m(WSLL\))227 1564 y(is)e(the)g(n)m(um)m(b)s(er)f(of)h
(ro)m(ws)g(are)g(deleted,)i(starting)f(with)f(ro)m(w)g(FR)m(O)m(W)h
(\(or)f(FR)m(O)m(WLL\),)h(and)f(an)m(y)g(remaining)227
1677 y(ro)m(ws)f(in)g(the)f(table)i(are)f(shifted)g(up)e(to)j(\014ll)f
(in)f(the)h(space.)38 b(These)21 b(routines)f(mo)s(dify)g(the)h(NAXIS2)
g(k)m(eyw)m(ord)227 1790 y(to)31 b(re\015ect)g(the)g(new)f(n)m(um)m(b)s
(er)f(of)h(ro)m(ws)h(in)f(the)g(table.)382 2012 y Fe
(FTDROW\(unit,frow,nrows,)41 b(>)48 b(status\))382 2125
y(FTDROWLL\(unit,frowll,nro)o(wsl)o(l,)42 b(>)47 b(status\))0
2348 y Fh(3)81 b Fi(Delete)26 b(a)f(list)g(of)g(ro)m(ws)f(from)g(an)h
(ASCI)s(I)e(or)h(binary)g(table)h(\(in)g(the)f(CDU\).)i(In)e(the)g
(\014rst)g(routine,)i('ro)m(wrange')227 2461 y(is)i(a)g(c)m(haracter)h
(string)f(listing)h(the)f(ro)m(ws)f(or)h(ro)m(w)g(ranges)g(to)g(delete)
h(\(e.g.,)i('2-4,)e(5,)g(8-9'\).)42 b(In)27 b(the)h(second)227
2574 y(routine,)37 b('ro)m(wlist')f(is)f(an)f(in)m(teger)j(arra)m(y)e
(of)g(ro)m(w)g(n)m(um)m(b)s(ers)e(to)j(b)s(e)e(deleted)i(from)e(the)h
(table.)56 b(nro)m(ws)34 b(is)227 2686 y(the)e(n)m(um)m(b)s(er)e(of)h
(ro)m(w)h(n)m(um)m(b)s(ers)e(in)h(the)g(list.)45 b(The)31
b(\014rst)f(ro)m(w)i(in)f(the)g(table)i(is)e(1)h(not)f(0.)44
b(The)31 b(list)h(of)g(ro)m(w)227 2799 y(n)m(um)m(b)s(ers)d(m)m(ust)h
(b)s(e)g(sorted)h(in)f(ascending)g(order.)382 3022 y
Fe(FTDRRG\(unit,rowrange,)42 b(>)47 b(status\))382 3135
y(FTDRWS\(unit,rowlist,nrow)o(s,)41 b(>)48 b(status\))0
3357 y Fh(4)81 b Fi(Insert)43 b(a)i(blank)f(column)h(\(or)f(columns\))h
(in)m(to)g(an)f(existing)i(ASCI)s(I)d(or)h(binary)g(table)h(\(in)g(the)
f(CDU\).)227 3470 y(COLNUM)c(sp)s(eci\014es)g(the)h(column)f(n)m(um)m
(b)s(er)f(that)i(the)f(\(\014rst\))g(new)g(column)g(should)f(o)s(ccup)m
(y)i(in)f(the)227 3583 y(table.)58 b(NCOLS)34 b(sp)s(eci\014es)h(ho)m
(w)h(man)m(y)g(columns)f(are)h(to)g(b)s(e)f(inserted.)57
b(An)m(y)35 b(existing)i(columns)e(from)227 3696 y(this)k(p)s(osition)f
(and)g(higher)g(are)h(mo)m(v)m(ed)g(o)m(v)m(er)h(to)f(allo)m(w)h(ro)s
(om)e(for)h(the)f(new)g(column\(s\).)65 b(The)38 b(index)227
3808 y(n)m(um)m(b)s(er)j(on)h(all)h(the)f(follo)m(wing)h(k)m(eyw)m
(ords)g(will)f(b)s(e)f(incremen)m(ted)i(if)f(necessary)g(to)h
(re\015ect)f(the)g(new)227 3921 y(p)s(osition)32 b(of)f(the)g
(column\(s\))h(in)f(the)g(table:)43 b(TBCOLn,)30 b(TF)m(ORMn,)i
(TTYPEn,)e(TUNITn,)h(TNULLn,)227 4034 y(TSCALn,)22 b(TZER)m(On,)g
(TDISPn,)g(TDIMn,)h(TLMINn,)g(TLMAXn,)f(TDMINn,)i(TDMAXn,)f(TCTYPn,)227
4147 y(TCRPXn,)30 b(TCR)-10 b(VLn,)29 b(TCDL)-8 b(Tn,)30
b(TCR)m(OTn,)f(and)g(TCUNIn.)382 4370 y Fe(FTICOL\(unit,colnum,ttype)o
(,tf)o(orm,)41 b(>)48 b(status\))382 4482 y(FTICLS\(unit,colnum,ncols)o
(,tt)o(ype,)o(tfor)o(m,)41 b(>)48 b(status\))0 4705 y
Fh(5)81 b Fi(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 4818 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.)382 5040 y Fe(FTMVEC\(unit,colnum,newve)o(cle)o(n,)42
b(>)47 b(status\))0 5262 y Fh(6)81 b Fi(Delete)29 b(a)f(column)g(from)f
(an)g(existing)i(ASCI)s(I)d(or)i(binary)e(table)j(\(in)f(the)f(CDU\).)i
(The)e(index)g(n)m(um)m(b)s(er)f(of)i(all)227 5375 y(the)k(k)m(eyw)m
(ords)h(listed)f(ab)s(o)m(v)m(e)i(\(for)e(FTICOL\))f(will)h(b)s(e)g
(decremen)m(ted)g(if)g(necessary)h(to)g(re\015ect)f(the)g(new)227
5488 y(p)s(osition)26 b(of)g(the)g(column\(s\))g(in)f(the)h(table.)40
b(Those)26 b(index)f(k)m(eyw)m(ords)h(that)g(refer)f(to)i(the)f
(deleted)g(column)227 5601 y(will)33 b(also)g(b)s(e)f(deleted.)47
b(Note)33 b(that)g(the)g(ph)m(ysical)g(size)g(of)f(the)h(FITS)e(\014le)
i(will)f(not)h(b)s(e)e(reduced)h(b)m(y)g(this)227 5714
y(op)s(eration,)e(and)e(the)h(empt)m(y)g(FITS)f(blo)s(c)m(ks)h(if)g(an)
m(y)g(at)g(the)g(end)f(of)h(the)g(\014le)g(will)g(b)s(e)f(padded)g
(with)g(zeros.)p eop end
%%Page: 60 66
TeXDict begin 60 65 bop 0 299 a Fi(60)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTDCOL\(unit,colnum,)42
b(>)48 b(status\))0 795 y Fh(7)81 b Fi(Cop)m(y)30 b(a)g(column)g(from)g
(one)g(HDU)h(to)g(another)f(\(or)h(to)g(the)f(same)h(HDU\).)g(If)f
(createcol)j(=)c(TR)m(UE,)i(then)f(a)227 908 y(new)20
b(column)g(will)h(b)s(e)f(inserted)g(in)g(the)h(output)f(table,)k(at)d
(p)s(osition)f(`outcolumn',)j(otherwise)e(the)g(existing)227
1021 y(output)29 b(column)f(will)h(b)s(e)f(o)m(v)m(erwritten)i(\(in)f
(whic)m(h)f(case)i(it)f(m)m(ust)f(ha)m(v)m(e)i(a)f(compatible)h(datat)m
(yp)s(e\).)42 b(Note)227 1134 y(that)31 b(the)g(\014rst)e(column)i(in)f
(a)g(table)i(is)e(at)h(coln)m(um)g(=)f(1.)382 1373 y
Fe(FTCPCL\(inunit,outunit,in)o(col)o(num,)o(outc)o(oln)o(um,c)o(reat)o
(eco)o(l,)42 b(>)47 b(status\);)0 1661 y Fb(6.7.4)112
b(Read)38 b(and)h(W)-9 b(rite)36 b(Column)j(Data)e(Routines)0
1880 y Fi(These)22 b(subroutines)f(put)h(or)g(get)i(data)f(v)-5
b(alues)22 b(in)g(the)h(curren)m(t)f(ASCI)s(I)f(or)h(Binary)g(table)i
(extension.)38 b(Automatic)0 1992 y(data)21 b(t)m(yp)s(e)g(con)m(v)m
(ersion)g(is)f(p)s(erformed)f(for)h(n)m(umerical)h(data)g(t)m(yp)s(es)g
(\(B,I,J,E,D\))h(if)e(the)h(data)g(t)m(yp)s(e)f(of)h(the)f(column)0
2105 y(\(de\014ned)32 b(b)m(y)i(the)f(TF)m(ORM)h(k)m(eyw)m(ord\))g
(di\013ers)f(from)f(the)i(data)g(t)m(yp)s(e)f(of)h(the)f(calling)i
(subroutine.)48 b(The)33 b(data)0 2218 y(v)-5 b(alues)30
b(are)h(also)g(scaled)f(b)m(y)g(the)g(TSCALn)f(and)g(TZER)m(On)g
(header)h(v)-5 b(alues)30 b(as)g(they)g(are)h(b)s(eing)e(written)h(to)h
(or)0 2331 y(read)j(from)f(the)h(FITS)f(arra)m(y)-8 b(.)51
b(The)33 b(fttscl)i(subroutine)d(MUST)i(b)s(e)f(used)g(to)h(de\014ne)f
(the)h(scaling)h(parameters)0 2444 y(when)d(writing)h(data)h(to)g(the)f
(table)h(or)f(to)h(o)m(v)m(erride)g(the)g(default)f(scaling)h(v)-5
b(alues)34 b(giv)m(en)g(in)f(the)g(header)g(when)0 2557
y(reading)27 b(from)g(the)g(table.)40 b(Note)29 b(that)e(it)h(is)f
(*not*)h(necessary)f(to)h(insert)f(ro)m(ws)g(in)f(a)i(table)g(b)s
(efore)e(writing)h(data)0 2670 y(to)j(those)h(ro)m(ws)e(\(indeed,)h(it)
g(w)m(ould)g(b)s(e)f(ine\016cien)m(t)i(to)f(do)g(so\).)41
b(Instead,)30 b(one)g(ma)m(y)g(simply)f(write)h(data)g(to)h(an)m(y)0
2783 y(ro)m(w)f(of)h(the)g(table,)g(whether)f(that)h(ro)m(w)f(of)h
(data)g(already)g(exists)g(or)f(not.)0 2943 y(In)i(the)i(case)g(of)f
(binary)g(tables)h(with)f(v)m(ector)h(elemen)m(ts,)i(the)d('felem')h
(parameter)g(de\014nes)e(the)i(starting)g(pixel)0 3056
y(within)k(the)g(elemen)m(t)i(v)m(ector.)65 b(This)38
b(parameter)g(is)g(ignored)h(with)e(ASCI)s(I)g(tables.)65
b(Similarly)-8 b(,)41 b(in)d(the)g(case)0 3169 y(of)45
b(binary)e(tables)i(the)g('nelemen)m(ts')h(parameter)f(sp)s(eci\014es)f
(the)g(total)i(n)m(um)m(b)s(er)d(of)i(v)m(ector)h(v)-5
b(alues)45 b(read)f(or)0 3282 y(written)36 b(\(con)m(tin)m(uing)h(on)f
(subsequen)m(t)f(ro)m(ws)g(if)h(required\))f(and)h(not)g(the)g(n)m(um)m
(b)s(er)e(of)i(table)h(elemen)m(ts.)58 b(Tw)m(o)0 3395
y(sets)36 b(of)f(subroutines)g(are)g(pro)m(vided)g(to)i(get)f(the)g
(column)f(data)h(whic)m(h)f(di\013er)g(in)h(the)f(w)m(a)m(y)i
(unde\014ned)c(pixels)0 3508 y(are)f(handled.)42 b(The)31
b(\014rst)g(set)h(of)f(routines)h(\(FTGCV\))g(simply)f(return)f(an)h
(arra)m(y)h(of)f(data)h(elemen)m(ts)h(in)e(whic)m(h)0
3620 y(unde\014ned)41 b(pixels)j(are)g(set)g(equal)g(to)h(a)f(v)-5
b(alue)44 b(sp)s(eci\014ed)f(b)m(y)g(the)h(user)f(in)g(the)h('n)m(ullv)
-5 b(al')44 b(parameter.)81 b(An)0 3733 y(additional)44
b(feature)g(of)g(these)g(subroutines)e(is)i(that)g(if)f(the)h(user)e
(sets)i(n)m(ullv)-5 b(al)44 b(=)f(0,)48 b(then)43 b(no)g(c)m(hec)m(ks)i
(for)0 3846 y(unde\014ned)33 b(pixels)j(will)g(b)s(e)e(p)s(erformed,)i
(th)m(us)f(increasing)h(the)g(sp)s(eed)e(of)i(the)g(program.)55
b(The)35 b(second)h(set)g(of)0 3959 y(routines)h(\(FTGCF\))h(returns)d
(the)i(data)h(elemen)m(t)g(arra)m(y)g(and)e(in)h(addition)g(a)g
(logical)j(arra)m(y)d(of)g(\015ags)g(whic)m(h)0 4072
y(de\014nes)29 b(whether)h(the)h(corresp)s(onding)e(data)i(pixel)g(is)f
(unde\014ned.)0 4232 y(An)m(y)41 b(column,)i(regardless)e(of)g(it's)g
(in)m(trinsic)g(datat)m(yp)s(e,)k(ma)m(y)c(b)s(e)f(read)h(as)g(a)g
(string.)71 b(It)41 b(should)f(b)s(e)g(noted)0 4345 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
4458 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 4571 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 4684
y(the)i(datat)m(yp)s(e)h(of)g(the)f(column.)40 b(The)28
b(length)g(of)h(the)f(returned)f(strings)h(can)g(b)s(e)g(determined)g
(with)f(the)i(ftgcdw)0 4797 y(routine.)41 b(The)30 b(follo)m(wing)h
(TDISPn)f(displa)m(y)g(formats)h(are)f(curren)m(tly)h(supp)s(orted:)191
5036 y Fe(Iw.m)142 b(Integer)191 5149 y(Ow.m)g(Octal)46
b(integer)191 5262 y(Zw.m)142 b(Hexadecimal)45 b(integer)191
5375 y(Fw.d)142 b(Fixed)46 b(floating)g(point)191 5488
y(Ew.d)142 b(Exponential)45 b(floating)g(point)191 5601
y(Dw.d)142 b(Exponential)45 b(floating)g(point)191 5714
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)p eop end
%%Page: 61 67
TeXDict begin 61 66 bop 0 299 a Fg(6.7.)72 b(FITS)30
b(ASCI)s(I)f(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(D)m(A)-8
b(T)g(A)32 b(I/O)e(SUBR)m(OUTINES)979 b Fi(61)0 555 y(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 668 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 920 y Fh(1)81
b Fi(Put)30 b(elemen)m(ts)i(in)m(to)g(an)e(ASCI)s(I)f(or)i(binary)f
(table)i(column)e(\(in)h(the)g(CDU\).)g(\(The)g(SPP)f(FSPCLS)f(routine)
227 1033 y(has)38 b(an)f(additional)i(in)m(teger)g(argumen)m(t)f(after)
h(the)f(V)-10 b(ALUES)37 b(c)m(haracter)i(string)f(whic)m(h)f(sp)s
(eci\014es)h(the)227 1145 y(size)31 b(of)g(the)g(1st)g(dimension)e(of)i
(this)f(2-D)i(CHAR)e(arra)m(y\).)227 1294 y(The)24 b(alternate)i(v)m
(ersion)f(of)g(these)g(routines,)h(whose)e(names)g(end)g(in)g('LL')h
(after)g(the)g(datat)m(yp)s(e)g(c)m(haracter,)227 1407
y(supp)s(ort)34 b(large)j(tables)f(with)g(more)f(then)h(2*31)h(ro)m
(ws.)57 b(When)35 b(calling)i(these)f(routines,)h(the)f(fro)m(w)g(and)
227 1520 y(felem)31 b(parameters)g(*m)m(ust*)g(b)s(e)f(64-bit)h(in)m
(teger*8)i(v)-5 b(ariables,)31 b(instead)g(of)g(normal)f(4-b)m(yte)i
(in)m(tegers.)382 1772 y Fe(FTPCL[SLBIJKEDCM]\(unit,c)o(oln)o(um,f)o
(row,)o(fel)o(em,n)o(elem)o(ent)o(s,va)o(lues)o(,)42
b(>)47 b(status\))382 1885 y(FTPCL[LBIJKEDCM]LL\(unit,)o(col)o(num,)o
(frow)o(,fe)o(lem,)o(nele)o(men)o(ts,v)o(alue)o(s,)41
b(>)48 b(status\))0 2136 y Fh(2)81 b Fi(Put)29 b(elemen)m(ts)i(in)m(to)
g(an)f(ASCI)s(I)e(or)i(binary)f(table)i(column)e(\(in)h(the)g(CDU\))g
(substituting)g(the)g(appropriate)227 2249 y(FITS)c(n)m(ull)g(v)-5
b(alue)26 b(for)g(an)m(y)h(elemen)m(ts)g(that)g(are)f(equal)h(to)g
(NULL)-10 b(V)g(AL.)26 b(F)-8 b(or)27 b(ASCI)s(I)e(T)-8
b(ABLE)26 b(extensions,)227 2362 y(the)31 b(n)m(ull)f(v)-5
b(alue)31 b(de\014ned)e(b)m(y)h(the)g(previous)g(call)i(to)f(FTSNUL)f
(will)g(b)s(e)g(substituted;)g(F)-8 b(or)31 b(in)m(teger)h(FITS)227
2475 y(columns,)39 b(in)e(a)h(binary)f(table)h(the)f(n)m(ull)h(v)-5
b(alue)37 b(de\014ned)g(b)m(y)g(the)g(previous)g(call)i(to)f(FTTNUL)f
(will)h(b)s(e)227 2588 y(substituted;)28 b(F)-8 b(or)28
b(\015oating)h(p)s(oin)m(t)e(FITS)f(columns)h(a)h(sp)s(ecial)g(IEEE)f
(NaN)h(\(Not-a-Num)m(b)s(er\))h(v)-5 b(alue)28 b(will)227
2701 y(b)s(e)i(substituted.)227 2850 y(The)24 b(alternate)i(v)m(ersion)
f(of)g(these)g(routines,)h(whose)e(names)g(end)g(in)g('LL')h(after)g
(the)g(datat)m(yp)s(e)g(c)m(haracter,)227 2963 y(supp)s(ort)34
b(large)j(tables)f(with)g(more)f(then)h(2*31)h(ro)m(ws.)57
b(When)35 b(calling)i(these)f(routines,)h(the)f(fro)m(w)g(and)227
3075 y(felem)31 b(parameters)g(*m)m(ust*)g(b)s(e)f(64-bit)h(in)m
(teger*8)i(v)-5 b(ariables,)31 b(instead)g(of)g(normal)f(4-b)m(yte)i
(in)m(tegers.)382 3327 y Fe(FTPCN[SBIJKED]\(unit,coln)o(um,)o(frow)o
(,fel)o(em,)o(nele)o(ment)o(s,v)o(alue)o(s,nu)o(llv)o(al)42
b(>)47 b(status\))382 3440 y(FTPCN[SBIJKED]LL\(unit,co)o(lnu)o(m,\(I)o
(*8\))41 b(frow,\(I*8\))k(felem,nelements,values,)764
3553 y(nullval)g(>)j(status\))0 3804 y Fh(3)81 b Fi(Put)37
b(bit)h(v)-5 b(alues)38 b(in)m(to)h(a)f(binary)f(b)m(yte)h(\('B'\))i
(or)d(bit)h(\('X'\))h(table)g(column)f(\(in)f(the)h(CDU\).)h(LRA)-8
b(Y)38 b(is)g(an)227 3917 y(arra)m(y)c(of)g(logical)h(v)-5
b(alues)34 b(corresp)s(onding)e(to)i(the)g(sequence)f(of)h(bits)f(to)h
(b)s(e)f(written.)49 b(If)33 b(LRA)-8 b(Y)34 b(is)f(true)227
4030 y(then)f(the)g(corresp)s(onding)f(bit)h(is)g(set)g(to)h(1,)g
(otherwise)f(the)g(bit)g(is)g(set)h(to)g(0.)45 b(Note)34
b(that)e(in)g(the)g(case)h(of)227 4143 y('X')g(columns,)g(FITSIO)e
(will)i(write)f(to)h(all)g(8)g(bits)f(of)g(eac)m(h)i(b)m(yte)f(whether)
e(they)i(are)g(formally)f(v)-5 b(alid)33 b(or)227 4256
y(not.)46 b(Th)m(us)31 b(if)h(the)g(column)g(is)f(de\014ned)g(as)h
('4X',)i(and)d(one)h(calls)h(FTPCLX)f(with)f(fbit=1)h(and)f(n)m(bit=8,)
227 4369 y(then)j(all)h(8)f(bits)g(will)g(b)s(e)f(written)h(in)m(to)h
(the)f(\014rst)g(b)m(yte)g(\(as)h(opp)s(osed)e(to)i(writing)e(the)i
(\014rst)e(4)h(bits)g(in)m(to)227 4482 y(the)d(\014rst)f(ro)m(w)g(and)g
(then)g(the)h(next)f(4)h(bits)f(in)m(to)i(the)e(next)h(ro)m(w\),)g(ev)m
(en)g(though)f(the)h(last)g(4)g(bits)f(of)h(eac)m(h)227
4595 y(b)m(yte)g(are)g(formally)g(not)g(de\014ned.)382
4846 y Fe(FTPCLX\(unit,colnum,frow,)o(fbi)o(t,nb)o(it,l)o(ray)o(,)42
b(>)47 b(status\))0 5098 y Fh(4)81 b Fi(Set)30 b(table)h(elemen)m(ts)h
(in)e(a)h(column)f(as)h(unde\014ned)382 5349 y Fe
(FTPCLU\(unit,colnum,frow,)o(fel)o(em,n)o(elem)o(ent)o(s,)42
b(>)47 b(status\))0 5601 y Fh(5)81 b Fi(Get)34 b(elemen)m(ts)g(from)f
(an)g(ASCI)s(I)f(or)h(binary)g(table)h(column)f(\(in)g(the)g(CDU\).)i
(These)e(routines)g(return)f(the)227 5714 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)p eop end
%%Page: 62 68
TeXDict begin 62 67 bop 0 299 a Fi(62)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)227 555 y Fi(v)-5 b(alue)26 b(=)g(n)m(ullv)-5
b(al,)27 b(unless)e(n)m(ullv)-5 b(al)26 b(=)f(0)h(\(or)g(=)f(')h(')g
(for)f(ftgcvs\))i(in)e(whic)m(h)g(case)i(no)e(c)m(hec)m(king)j(for)d
(unde\014ned)227 668 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 781 y(are)f(unde\014ned.)37
b(\(Note:)i(the)26 b(ftgcl)g(routine)f(simple)g(gets)h(an)g(arra)m(y)f
(of)g(logical)j(data)e(v)-5 b(alues)25 b(without)h(an)m(y)227
894 y(c)m(hec)m(ks)39 b(for)e(unde\014ned)e(v)-5 b(alues;)41
b(use)c(the)g(ftgc\015)h(routine)f(to)h(c)m(hec)m(k)g(for)f
(unde\014ned)e(logical)40 b(elemen)m(ts\).)227 1007 y(\(The)29
b(SPP)f(FSGCVS)g(routine)g(has)h(an)f(additional)i(in)m(teger)g
(argumen)m(t)f(after)g(the)g(V)-10 b(ALUES)28 b(c)m(haracter)227
1120 y(string)j(whic)m(h)f(sp)s(eci\014es)g(the)g(size)i(of)e(the)h
(1st)g(dimension)e(of)i(this)f(2-D)i(CHAR)e(arra)m(y\).)227
1272 y(The)24 b(alternate)i(v)m(ersion)f(of)g(these)g(routines,)h
(whose)e(names)g(end)g(in)g('LL')h(after)g(the)g(datat)m(yp)s(e)g(c)m
(haracter,)227 1385 y(supp)s(ort)34 b(large)j(tables)f(with)g(more)f
(then)h(2*31)h(ro)m(ws.)57 b(When)35 b(calling)i(these)f(routines,)h
(the)f(fro)m(w)g(and)227 1498 y(felem)31 b(parameters)g(*m)m(ust*)g(b)s
(e)f(64-bit)h(in)m(teger*8)i(v)-5 b(ariables,)31 b(instead)g(of)g
(normal)f(4-b)m(yte)i(in)m(tegers.)382 1761 y Fe
(FTGCL\(unit,colnum,frow,f)o(ele)o(m,ne)o(leme)o(nts)o(,)42
b(>)47 b(values,status\))382 1874 y(FTGCV[SBIJKEDCM]\(unit,co)o(lnu)o
(m,fr)o(ow,f)o(ele)o(m,ne)o(leme)o(nts)o(,nul)o(lval)o(,)42
b(>)1098 1987 y(values,anyf,status\))382 2100 y
(FTGCV[BIJKEDCM]LL\(unit,c)o(oln)o(um,\()o(I*8\))f(frow,)46
b(\(I*8\))h(felem,)f(nelements,)716 2213 y(nullval,)f(>)j
(values,anyf,status\))0 2476 y Fh(6)81 b Fi(Get)44 b(elemen)m(ts)h(and)
d(n)m(ull)i(\015ags)f(from)g(an)h(ASCI)s(I)d(or)j(binary)e(table)j
(column)e(\(in)g(the)h(CHDU\).)g(These)227 2589 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 2702 y(will)37 b(ha)m(v)m(e)h(the)f(corresp)s(onding)f(\015agv)
-5 b(als)37 b(elemen)m(t)i(set)e(equal)g(to)h(.TR)m(UE.)f(The)f(ANYF)i
(parameter)f(is)227 2815 y(set)30 b(to)g(true)g(if)f(an)m(y)h(of)f(the)
h(returned)e(elemen)m(ts)j(are)f(unde\014ned.)38 b(\(The)29
b(SPP)f(FSGCFS)h(routine)h(has)f(an)227 2928 y(additional)e(in)m(teger)
h(argumen)m(t)e(after)h(the)f(V)-10 b(ALUES)26 b(c)m(haracter)i(string)
e(whic)m(h)f(sp)s(eci\014es)h(the)h(size)f(of)h(the)227
3041 y(1st)k(dimension)f(of)h(this)f(2-D)h(CHAR)g(arra)m(y\).)227
3193 y(The)24 b(alternate)i(v)m(ersion)f(of)g(these)g(routines,)h
(whose)e(names)g(end)g(in)g('LL')h(after)g(the)g(datat)m(yp)s(e)g(c)m
(haracter,)227 3306 y(supp)s(ort)34 b(large)j(tables)f(with)g(more)f
(then)h(2*31)h(ro)m(ws.)57 b(When)35 b(calling)i(these)f(routines,)h
(the)f(fro)m(w)g(and)227 3418 y(felem)31 b(parameters)g(*m)m(ust*)g(b)s
(e)f(64-bit)h(in)m(teger*8)i(v)-5 b(ariables,)31 b(instead)g(of)g
(normal)f(4-b)m(yte)i(in)m(tegers.)382 3682 y Fe
(FTGCF[SLBIJKEDCM]\(unit,c)o(oln)o(um,f)o(row,)o(fel)o(em,n)o(elem)o
(ent)o(s,)42 b(>)1193 3795 y(values,flagvals,anyf,stat)o(us\))382
3908 y(FTGCF[BIJKED]LL\(unit,col)o(num)o(,)g(\(I*8\))k(frow,)h(\(I*8\))
f(felem,nelements,)d(>)1193 4021 y(values,flagvals,anyf,stat)o(us\))0
4284 y Fh(7)81 b Fi(Get)29 b(an)f(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 4397 y(Unde\014ned)k(pixels)h(in)g(the)h(arra)m(y)g(will)f
(b)s(e)g(set)h(equal)f(to)h(the)g(v)-5 b(alue)36 b(of)f('n)m(ullv)-5
b(al',)38 b(unless)c(n)m(ullv)-5 b(al=0)36 b(in)227 4510
y(whic)m(h)d(case)i(no)e(testing)i(for)e(unde\014ned)e(pixels)j(will)f
(b)s(e)g(p)s(erformed.)49 b(The)32 b(\014rst)h(and)g(last)h(ro)m(ws)g
(in)f(the)227 4623 y(table)28 b(to)f(b)s(e)f(read)g(are)h(sp)s
(eci\014ed)e(b)m(y)i(fpixels\(naxis+1\))g(and)f(lpixels\(naxis+1\),)j
(and)d(hence)g(are)h(treated)227 4736 y(as)f(the)f(next)h(higher)f
(dimension)g(of)g(the)h(FITS)e(N-dimensional)i(arra)m(y)-8
b(.)40 b(The)25 b(INCS)f(parameter)i(sp)s(eci\014es)227
4848 y(the)31 b(sampling)f(in)m(terv)-5 b(al)32 b(in)e(eac)m(h)h
(dimension)f(b)s(et)m(w)m(een)h(the)g(data)g(elemen)m(ts)g(that)g(will)
g(b)s(e)f(returned.)382 5112 y Fe(FTGSV[BIJKED]\(unit,colnu)o(m,n)o
(axis)o(,nax)o(es,)o(fpix)o(els,)o(lpi)o(xels)o(,inc)o(s,n)o(ullv)o
(al,)41 b(>)1002 5225 y(array,anyf,status\))0 5488 y
Fh(8)81 b Fi(Get)29 b(an)f(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 5601 y(An)m(y)39 b(Unde\014ned)e(pixels)i(in)g(the)g(arra)
m(y)g(will)g(ha)m(v)m(e)h(the)f(corresp)s(onding)f('\015agv)-5
b(als')40 b(elemen)m(t)g(set)f(equal)227 5714 y(to)d(.TR)m(UE.)f(The)f
(\014rst)g(and)g(last)i(ro)m(ws)f(in)f(the)h(table)h(to)f(b)s(e)g(read)
f(are)h(sp)s(eci\014ed)f(b)m(y)h(fpixels\(naxis+1\))p
eop end
%%Page: 63 69
TeXDict begin 63 68 bop 0 299 a Fg(6.7.)72 b(FITS)30
b(ASCI)s(I)f(AND)i(BINAR)-8 b(Y)31 b(T)-8 b(ABLE)31 b(D)m(A)-8
b(T)g(A)32 b(I/O)e(SUBR)m(OUTINES)979 b Fi(63)227 555
y(and)39 b(lpixels\(naxis+1\),)k(and)38 b(hence)i(are)f(treated)i(as)e
(the)g(next)h(higher)f(dimension)f(of)i(the)f(FITS)g(N-)227
668 y(dimensional)g(arra)m(y)-8 b(.)66 b(The)38 b(INCS)g(parameter)h
(sp)s(eci\014es)f(the)g(sampling)h(in)m(terv)-5 b(al)40
b(in)e(eac)m(h)i(dimension)227 781 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.)382
1028 y Fe(FTGSF[BIJKED]\(unit,colnu)o(m,n)o(axis)o(,nax)o(es,)o(fpix)o
(els,)o(lpi)o(xels)o(,inc)o(s,)41 b(>)1002 1141 y
(array,flagvals,anyf,statu)o(s\))0 1389 y Fh(9)81 b Fi(Get)33
b(bit)g(v)-5 b(alues)34 b(from)e(a)h(b)m(yte)h(\('B'\))g(or)f(bit)g
(\(`X`\))h(table)g(column)f(\(in)g(the)g(CDU\).)g(LRA)-8
b(Y)34 b(is)f(an)f(arra)m(y)i(of)227 1502 y(logical)41
b(v)-5 b(alues)39 b(corresp)s(onding)f(to)h(the)g(sequence)f(of)h(bits)
g(to)g(b)s(e)f(read.)65 b(If)38 b(LRA)-8 b(Y)39 b(is)f(true)h(then)f
(the)227 1615 y(corresp)s(onding)c(bit)g(w)m(as)g(set)h(to)g(1,)h
(otherwise)f(the)f(bit)h(w)m(as)f(set)h(to)g(0.)53 b(Note)35
b(that)g(in)f(the)h(case)g(of)f('X')227 1728 y(columns,)41
b(FITSIO)d(will)h(read)f(all)i(8)f(bits)g(of)g(eac)m(h)h(b)m(yte)f
(whether)f(they)h(are)g(formally)h(v)-5 b(alid)39 b(or)f(not.)227
1840 y(Th)m(us)c(if)g(the)h(column)f(is)g(de\014ned)f(as)i('4X',)h(and)
d(one)i(calls)h(FTGCX)e(with)g(fbit=1)h(and)e(n)m(bit=8,)j(then)227
1953 y(all)30 b(8)g(bits)f(will)g(b)s(e)g(read)g(from)g(the)g(\014rst)f
(b)m(yte)i(\(as)g(opp)s(osed)e(to)i(reading)f(the)h(\014rst)e(4)i(bits)
f(from)f(the)i(\014rst)227 2066 y(ro)m(w)g(and)e(then)h(the)h(\014rst)e
(4)i(bits)f(from)g(the)g(next)g(ro)m(w\),)i(ev)m(en)f(though)f(the)g
(last)h(4)g(bits)f(of)g(eac)m(h)i(b)m(yte)f(are)227 2179
y(formally)h(not)g(de\014ned.)382 2427 y Fe(FTGCX\(unit,colnum,frow,f)o
(bit)o(,nbi)o(t,)42 b(>)47 b(lray,status\))0 2674 y Fh(10)f
Fi(Read)31 b(an)m(y)g(consecutiv)m(e)h(set)f(of)g(bits)g(from)f(an)g
('X')i(or)e('B')i(column)e(and)g(in)m(terpret)h(them)g(as)g(an)f
(unsigned)227 2787 y(n-bit)k(in)m(teger.)54 b(NBIT)35
b(m)m(ust)f(b)s(e)f(less)i(than)f(or)g(equal)h(to)g(16)g(when)f
(calling)h(FTGCXI,)g(and)f(less)g(than)227 2900 y(or)e(equal)g(to)g(32)
g(when)e(calling)j(FTGCXJ;)f(there)f(is)h(no)f(limit)h(on)g(the)f(v)-5
b(alue)32 b(of)g(NBIT)f(for)g(FTGCXD,)227 3013 y(but)38
b(the)h(returned)e(double)i(precision)f(v)-5 b(alue)39
b(only)g(has)f(48)i(bits)e(of)h(precision)g(on)f(most)h(32-bit)h(w)m
(ord)227 3126 y(mac)m(hines.)64 b(The)37 b(NBITS)g(bits)h(are)g(in)m
(terpreted)g(as)g(an)g(unsigned)e(in)m(teger)k(unless)d(NBITS)g(=)g(16)
i(\(in)227 3239 y(FTGCXI\))e(or)g(32)g(\(in)g(FTGCXJ\))f(in)g(whic)m(h)
h(case)g(the)g(string)g(of)f(bits)h(are)g(in)m(terpreted)f(as)h(16-bit)
h(or)227 3352 y(32-bit)j(2's)f(complemen)m(t)h(signed)e(in)m(tegers.)69
b(If)39 b(NR)m(O)m(WS)i(is)e(greater)i(than)e(1)h(then)f(the)h(same)g
(set)g(of)227 3464 y(bits)34 b(will)g(b)s(e)f(read)h(from)f(sequen)m
(tial)i(ro)m(ws)f(in)f(the)h(table)g(starting)h(with)e(ro)m(w)h(FR)m(O)
m(W.)h(Note)g(that)g(the)227 3577 y(n)m(um)m(b)s(ering)27
b(con)m(v)m(en)m(tion)j(used)d(here)g(for)h(the)g(FBIT)f(parameter)i
(adopts)e(1)h(for)g(the)g(\014rst)f(elemen)m(t)i(of)f(the)227
3690 y(v)m(ector)k(of)f(bits;)f(this)h(is)f(the)h(Most)g(Signi\014can)m
(t)g(Bit)g(of)g(the)f(in)m(teger)i(v)-5 b(alue.)382 3938
y Fe(FTGCX[IJD]\(unit,colnum,f)o(row)o(,nro)o(ws,f)o(bit)o(,nbi)o(t,)42
b(>)47 b(array,status\))0 4185 y Fh(11)f Fi(Get)37 b(the)e(descriptor)h
(for)f(a)h(v)-5 b(ariable)37 b(length)f(column)f(in)g(a)h(binary)f
(table.)57 b(The)35 b(descriptor)h(consists)g(of)227
4298 y(2)c(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 4411 y(the)28 b(start)f(of)g(the)h(heap.)39
b(The)27 b(\014rst)f(routine)h(returns)f(a)h(single)h(descriptor)f
(whereas)g(the)g(second)g(routine)227 4524 y(returns)i(the)i
(descriptors)f(for)g(a)h(range)g(of)f(ro)m(ws)h(in)f(the)g(table.)382
4771 y Fe(FTGDES\(unit,colnum,rownu)o(m,)41 b(>)48 b
(nelements,offset,status\))382 4884 y(FTGDESLL\(unit,colnum,row)o(num)o
(,)42 b(>)47 b(nelementsll,offsetll,statu)o(s\))382 5110
y(FFGDESS\(unit,colnum,firs)o(tro)o(w,nr)o(ows)41 b(>)48
b(nelements,offset,)43 b(status\))382 5223 y(FFGDESSLL\(unit,colnum,fi)
o(rst)o(row,)o(nrow)o(s)f(>)47 b(nelementsll,offsetll,)42
b(status\))0 5470 y Fh(12)k Fi(W)-8 b(rite)33 b(the)f(descriptor)g(for)
f(a)i(v)-5 b(ariable)32 b(length)g(column)g(in)f(a)i(binary)e(table.)45
b(These)32 b(subroutines)e(can)j(b)s(e)227 5583 y(used)f(in)h
(conjunction)g(with)g(FTGDES)g(to)g(enable)h(2)f(or)g(more)g(arra)m(ys)
h(to)f(p)s(oin)m(t)g(to)h(the)f(same)g(storage)227 5696
y(lo)s(cation)f(to)f(sa)m(v)m(e)h(storage)g(space)f(if)f(the)h(arra)m
(ys)g(are)g(iden)m(tical.)p eop end
%%Page: 64 70
TeXDict begin 64 69 bop 0 299 a Fi(64)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)382 555 y Fe(FTPDES\(unit,colnum,rownu)o(m,n)o(elem)o
(ents)o(,of)o(fset)o(,)42 b(>)47 b(status\))382 668 y
(FTPDESLL\(unit,colnum,row)o(num)o(,nel)o(emen)o(tsl)o(l,of)o(fset)o
(ll,)41 b(>)48 b(status\))0 1001 y Fd(6.8)135 b(Ro)l(w)46
b(Selection)g(and)f(Calculator)h(Routines)0 1252 y Fi(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 1365 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 1477 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 1590 y(for)35 b(eac)m(h)h(ro)m(w)g(of)f(the)h(table.)56
b(The)35 b(allo)m(w)m(ed)i(expression)e(syn)m(tax)g(is)h(describ)s(ed)e
(in)h(the)g(ro)m(w)h(\014lter)f(section)h(in)0 1703 y(the)h(earlier)h
(`Extended)e(File)i(Name)f(Syn)m(tax')g(c)m(hapter)h(of)f(this)f(do)s
(cumen)m(t.)60 b(The)36 b(expression)h(ma)m(y)g(also)h(b)s(e)0
1816 y(written)28 b(to)i(a)e(text)i(\014le,)f(and)f(the)h(name)f(of)h
(the)f(\014le,)h(prep)s(ended)e(with)h(a)h('@')f(c)m(haracter)i(ma)m(y)
f(b)s(e)f(supplied)f(for)0 1929 y(the)34 b('expr')g(parameter)g(\(e.g.)
53 b('@\014lename.txt'\).)f(The)34 b(expression)f(in)h(the)g(\014le)g
(can)g(b)s(e)f(arbitrarily)h(complex)0 2042 y(and)h(extend)h(o)m(v)m
(er)h(m)m(ultiple)f(lines)g(of)g(the)f(\014le.)57 b(Lines)36
b(that)g(b)s(egin)f(with)g(2)h(slash)g(c)m(haracters)h(\('//'\))h(will)
e(b)s(e)0 2155 y(ignored)30 b(and)g(ma)m(y)h(b)s(e)f(used)g(to)h(add)e
(commen)m(ts)j(to)f(the)f(\014le.)0 2412 y Fh(1)81 b
Fi(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 2525 y(whic)m(h)30 b(ro)m(ws)h(ev)-5
b(aluated)31 b(to)g(TR)m(UE/F)-10 b(ALSE)430 2783 y Fe
(FTFROW\(unit,expr,firstr)o(ow,)41 b(nrows,)46 b(>)i(n_good_rows,)c
(row_status,)h(status\))0 3040 y Fh(2)81 b Fi(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)430 3298 y Fe(FTFFRW\(unit,)44
b(expr,)i(>)i(rownum,)e(status\))0 3555 y Fh(3)81 b Fi(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 3668 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 3781 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
3894 y(F)-10 b(ALSE)30 b(ro)m(ws)h(\(preserv)m(e)f(the)h(TR)m(UE)f(ro)m
(ws\).)430 4151 y Fe(FTSROW\(inunit,)43 b(outunit,)j(expr,)g(>)i
(status\))0 4409 y Fh(4)81 b Fi(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 4522 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 4634 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 4747
y(not)30 b(an)g(ev)m(en)h(m)m(ultiple)f(of)g(the)g(result)g(dimension.)
40 b(Call)30 b(FTTEXP)g(to)g(obtain)h(the)f(dimensions)f(of)h(the)227
4860 y(results.)430 5118 y Fe(FTCROW\(unit,datatype,ex)o(pr,)o(firs)o
(trow)o(,ne)o(leme)o(nts,)o(nul)o(val,)41 b(>)620 5231
y(array,anynul,status\))0 5488 y Fh(5)81 b Fi(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
5601 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)227 5714 y(is)f(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)p eop end
%%Page: 65 71
TeXDict begin 65 70 bop 0 299 a Fg(6.9.)72 b(CELESTIAL)29
b(COORDINA)-8 b(TE)30 b(SYSTEM)f(SUBR)m(OUTINES)1307
b Fi(65)227 555 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 668 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 781 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 894 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 1007 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 1120 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 1233 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 1346 y(written)h(to)g(a)g(column)f(with)g
(that)h(name.)430 1605 y Fe(FTCALC\(inunit,)43 b(expr,)k(outunit,)e
(parName,)h(parInfo,)f(>)j(status\))0 1865 y Fh(6)81
b Fi(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
1978 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 2091 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.)430 2350 y Fe
(FTCALC_RNG\(inunit,)42 b(expr,)47 b(outunit,)e(parName,)h(parInfo,)573
2463 y(nranges,)f(firstrow,)h(lastrow,)f(>)j(status\))0
2723 y Fh(7)81 b Fi(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 2836 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 2949 y(equiv)-5 b(alen)m(t)26
b(to)f(the)g(result)f(of)g(\014ts)p 1380 2949 28 4 v
33 w(read)p 1585 2949 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
3062 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.)430
3321 y Fe(FTTEXP\(unit,)44 b(expr,)i(maxdim)g(>)i(datatype,)d(nelem,)h
(naxis,)g(naxes,)g(status\))0 3655 y Fd(6.9)135 b(Celestial)48
b(Co)t(ordinate)e(System)f(Subroutines)0 3905 y Fi(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
4018 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 4131 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 4244 y(lo)s(cation)36 b(in)e(an)h(n-dimensional)f(FITS)g(arra)
m(y)-8 b(.)54 b(CFITSIO)33 b(is)h(distributed)g(with)g(a)h(couple)f(of)
h(self-con)m(tained)0 4357 y(W)-8 b(orld)28 b(Co)s(ordinate)f(System)f
(\(W)m(CS\))i(routines,)g(ho)m(w)m(ev)m(er,)h(these)f(routines)f(DO)g
(NOT)f(supp)s(ort)f(all)j(the)f(latest)0 4470 y(W)m(CS)38
b(con)m(v)m(en)m(tions,)k(so)d(it)g(is)f(STR)m(ONGL)-8
b(Y)38 b(RECOMMENDED)h(that)f(soft)m(w)m(are)i(dev)m(elop)s(ers)e(use)g
(a)h(more)0 4583 y(robust)30 b(external)h(W)m(CS)f(library)-8
b(.)41 b(Sev)m(eral)31 b(recommended)f(libraries)h(are:)95
4842 y Fe(WCSLIB)47 b(-)95 b(supported)45 b(by)i(Mark)g(Calabretta)95
4955 y(WCSTools)f(-)h(supported)f(by)h(Doug)g(Mink)95
5068 y(AST)g(library)f(-)i(developed)d(by)i(the)g(U.K.)g(Starlink)e
(project)0 5328 y Fi(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 5441 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
5601 y(The)i(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)g(the)f(W)m(CS)g(information)0
5714 y(con)m(tained)i(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)p eop end
%%Page: 66 72
TeXDict begin 66 71 bop 0 299 a Fi(66)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fi(library)39 b(is)h(to)h(use)e(FITSIO)g(to)h
(cop)m(y)h(the)f(header)f(k)m(eyw)m(ords)h(in)m(to)h(one)f(long)g(c)m
(haracter)i(string,)g(and)d(then)0 668 y(pass)29 b(this)h(string)g(to)g
(an)g(in)m(terface)h(routine)f(in)g(the)g(external)g(library)g(that)g
(will)g(extract)i(the)e(necessary)g(W)m(CS)0 781 y(information)h
(\(e.g.,)h(see)f(the)f(astFitsChan)h(and)f(astPutCards)g(routines)g(in)
g(the)h(Starlink)f(AST)g(library\).)0 941 y(The)24 b(follo)m(wing)j
(FITSIO)c(routines)i(DO)g(NOT)f(supp)s(ort)f(the)i(more)g(recen)m(t)h
(W)m(CS)f(con)m(v)m(en)m(tions)i(that)f(ha)m(v)m(e)g(b)s(een)0
1054 y(appro)m(v)m(ed)37 b(as)h(part)f(of)g(the)h(FITS)e(standard.)61
b(Consequen)m(tly)-8 b(,)39 b(the)f(follo)m(wing)g(routines)g(ARE)f(NO)
m(W)h(DEP-)0 1167 y(RECA)-8 b(TED.)29 b(It)f(is)h(STR)m(ONGL)-8
b(Y)28 b(RECOMMENDED)h(that)g(soft)m(w)m(are)h(dev)m(elop)s(ers)f(not)g
(use)f(these)h(routines,)0 1280 y(and)h(instead)g(use)g(an)h(external)g
(W)m(CS)f(library)-8 b(,)31 b(as)g(describ)s(ed)e(ab)s(o)m(v)m(e.)0
1440 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 1553 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 1666
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 1779 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
2048 y Fh(1)81 b Fi(Get)22 b(the)g(v)-5 b(alues)21 b(of)h(all)g(the)g
(standard)f(FITS)f(celestial)k(co)s(ordinate)f(system)e(k)m(eyw)m(ords)
h(from)f(the)h(header)f(of)h(a)227 2161 y(FITS)j(image)i(\(i.e.,)h(the)
d(primary)g(arra)m(y)h(or)f(an)h(image)g(extension\).)40
b(These)26 b(v)-5 b(alues)25 b(ma)m(y)h(then)g(b)s(e)e(passed)227
2274 y(to)39 b(the)e(subroutines)g(that)h(p)s(erform)e(the)i(co)s
(ordinate)g(transformations.)63 b(If)37 b(an)m(y)h(or)g(all)g(of)g(the)
g(W)m(CS)227 2387 y(k)m(eyw)m(ords)32 b(are)f(not)g(presen)m(t,)h(then)
f(default)g(v)-5 b(alues)31 b(will)h(b)s(e)e(returned.)41
b(If)31 b(the)g(\014rst)g(co)s(ordinate)g(axis)h(is)227
2500 y(the)d(declination-lik)m(e)j(co)s(ordinate,)e(then)e(this)g
(routine)h(will)g(sw)m(ap)f(them)h(so)g(that)g(the)g(longitudinal-lik)m
(e)227 2612 y(co)s(ordinate)i(is)g(returned)e(as)i(the)f(\014rst)g
(axis.)227 2767 y(If)35 b(the)h(\014le)f(uses)g(the)g(new)m(er)h('CDj)p
1454 2767 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 2880 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 2993 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
3106 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 3219 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 3332 y(W)m(CS)f(k)m(eyw)m(ord)g(v)-5
b(alues,)39 b(but)d(will)h(also)h(return)d(with)i(status)g(=)f(506,)k
(to)e(w)m(arn)e(the)h(calling)h(program)227 3445 y(that)30
b(appro)m(ximations)f(ha)m(v)m(e)h(b)s(een)e(made.)40
b(It)29 b(is)g(then)f(up)g(to)h(the)g(calling)i(program)d(to)h(decide)h
(whether)227 3558 y(the)k(appro)m(ximations)g(are)g(su\016cien)m(tly)g
(accurate)i(for)d(the)h(particular)f(application,)j(or)e(whether)f
(more)227 3671 y(precise)e(W)m(CS)f(transformations)h(m)m(ust)f(b)s(e)g
(p)s(erformed)f(using)h(new-st)m(yle)h(W)m(CS)g(k)m(eyw)m(ords)f
(directly)-8 b(.)382 3940 y Fe(FTGICS\(unit,)44 b(>)k
(xrval,yrval,xrpix,yrpix)o(,xin)o(c,yi)o(nc,)o(rot,)o(coor)o(dty)o
(pe,s)o(tatu)o(s\))0 4209 y Fh(2)81 b Fi(Get)34 b(the)f(v)-5
b(alues)33 b(of)g(all)h(the)f(standard)f(FITS)h(celestial)i(co)s
(ordinate)f(system)f(k)m(eyw)m(ords)g(from)g(the)g(header)227
4322 y(of)j(a)h(FITS)e(table)h(where)g(the)g(X)g(and)f(Y)h(\(or)g(RA)g
(and)g(DEC)f(co)s(ordinates)i(are)f(stored)g(in)g(2)g(separate)227
4435 y(columns)c(of)g(the)g(table.)46 b(These)31 b(v)-5
b(alues)32 b(ma)m(y)h(then)e(b)s(e)h(passed)f(to)h(the)g(subroutines)f
(that)h(p)s(erform)f(the)227 4548 y(co)s(ordinate)g(transformations.)
382 4817 y Fe(FTGTCS\(unit,xcol,ycol,)42 b(>)716 4930
y(xrval,yrval,xrpix,yrpix,)o(xinc)o(,yi)o(nc,r)o(ot,c)o(oor)o(dtyp)o
(e,st)o(atu)o(s\))0 5199 y Fh(3)81 b Fi(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
5312 y(image.)382 5581 y Fe(FTWLDP\(xpix,ypix,xrval,y)o(rva)o(l,xr)o
(pix,)o(yrp)o(ix,x)o(inc,)o(yin)o(c,ro)o(t,)1241 5694
y(coordtype,)k(>)i(xpos,ypos,status\))p eop end
%%Page: 67 73
TeXDict begin 67 72 bop 0 299 a Fg(6.10.)73 b(FILE)30
b(CHECKSUM)f(SUBR)m(OUTINES)2080 b Fi(67)0 555 y Fh(4)81
b Fi(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
668 y(image.)382 932 y Fe(FTXYPX\(xpos,ypos,xrval,y)o(rva)o(l,xr)o
(pix,)o(yrp)o(ix,x)o(inc,)o(yin)o(c,ro)o(t,)1241 1045
y(coordtype,)k(>)i(xpix,ypix,status\))0 1383 y Fd(6.10)136
b(File)45 b(Chec)l(ksum)g(Subroutines)0 1634 y Fi(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 1747 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 1860 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 1973 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 2086 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 2199 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
2312 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 2425 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 2538 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
2651 y(conference)f(in)f(Baltimore)i(in)f(No)m(v)m(em)m(b)s(er)g(1994)h
(and)e(a)h(later)g(revision)g(in)f(June)f(1995.)0 2914
y Fh(1)81 b Fi(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 3027
y(curren)m(t)25 b(header.)38 b(The)24 b(D)m(A)-8 b(T)g(ASUM)27
b(v)-5 b(alue)25 b(is)f(the)h(32-bit)h(c)m(hec)m(ksum)f(for)f(the)h
(data)g(unit,)h(expressed)e(as)h(a)227 3140 y(decimal)32
b(in)m(teger)f(enclosed)g(in)f(single)h(quotes.)41 b(The)30
b(CHECKSUM)g(k)m(eyw)m(ord)g(v)-5 b(alue)31 b(is)f(a)h(16-c)m(haracter)
227 3253 y(string)j(whic)m(h)f(is)h(the)f(ASCI)s(I-enco)s(ded)f(v)-5
b(alue)34 b(for)g(the)f(complemen)m(t)i(of)f(the)f(c)m(hec)m(ksum)i
(for)e(the)h(whole)227 3366 y(HDU.)h(If)e(these)g(k)m(eyw)m(ords)h
(already)g(exist,)h(their)e(v)-5 b(alues)34 b(will)g(b)s(e)f(up)s
(dated)f(only)h(if)g(necessary)h(\(i.e.,)i(if)227 3479
y(the)31 b(\014le)f(has)g(b)s(een)g(mo)s(di\014ed)f(since)i(the)g
(original)g(k)m(eyw)m(ord)g(v)-5 b(alues)31 b(w)m(ere)g(computed\).)382
3743 y Fe(FTPCKS\(unit,)44 b(>)k(status\))0 4007 y Fh(2)81
b Fi(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 4119 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
4232 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 4345 y(string,)31 b(and)f(writes)g(the)h
(string)f(to)h(the)g(CHECKSUM)e(k)m(eyw)m(ord.)382 4609
y Fe(FTUCKS\(unit,)44 b(>)k(status\))0 4873 y Fh(3)81
b Fi(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 4986 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 5099 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
5212 y(zero.)55 b(The)34 b(output)g(D)m(A)-8 b(T)g(A)m(OK)37
b(and)d(HDUOK)h(parameters)g(in)f(this)h(subroutine)e(are)i(in)m
(tegers)h(whic)m(h)227 5325 y(will)27 b(ha)m(v)m(e)g(a)f(v)-5
b(alue)27 b(=)f(1)g(if)g(the)h(data)f(or)g(HDU)h(is)f(v)m(eri\014ed)h
(correctly)-8 b(,)29 b(a)d(v)-5 b(alue)27 b(=)e(0)i(if)f(the)g(D)m(A)-8
b(T)g(ASUM)28 b(or)227 5437 y(CHECKSUM)h(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.)382 5701 y Fe(FTVCKS\(unit,)44
b(>)k(dataok,hduok,status\))p eop end
%%Page: 68 74
TeXDict begin 68 73 bop 0 299 a Fi(68)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fh(4)81 b Fi(Compute)25 b(and)h(return)f(the)i
(c)m(hec)m(ksum)g(v)-5 b(alues)26 b(for)g(the)h(CHDU)f(\(as)h(double)f
(precision)h(v)-5 b(ariables\))27 b(without)227 668 y(creating)46
b(or)e(mo)s(difying)g(the)h(CHECKSUM)e(and)h(D)m(A)-8
b(T)g(ASUM)46 b(k)m(eyw)m(ords.)83 b(This)44 b(routine)g(is)h(used)227
781 y(in)m(ternally)32 b(b)m(y)e(FTV)m(CKS,)g(but)g(ma)m(y)h(b)s(e)e
(useful)h(in)g(other)h(situations)g(as)f(w)m(ell.)382
1050 y Fe(FTGCKS\(unit,)44 b(>)k(datasum,hdusum,status\))0
1319 y Fh(5)81 b Fi(Enco)s(de)33 b(a)h(c)m(hec)m(ksum)h(v)-5
b(alue)34 b(\(stored)g(in)g(a)g(double)g(precision)g(v)-5
b(ariable\))35 b(in)m(to)f(a)h(16-c)m(haracter)h(string.)51
b(If)227 1432 y(COMPLEMENT)30 b(=)g(.true.)41 b(then)30
b(the)g(32-bit)i(sum)d(v)-5 b(alue)31 b(will)g(b)s(e)f(complemen)m(ted)
h(b)s(efore)f(enco)s(ding.)382 1701 y Fe(FTESUM\(sum,complement,)42
b(>)47 b(checksum\))0 1971 y Fh(6)81 b Fi(Deco)s(de)39
b(a)f(16)h(c)m(haracter)h(c)m(hec)m(ksum)e(string)g(in)m(to)h(a)g
(double)e(precision)h(v)-5 b(alue.)65 b(If)37 b(COMPLEMENT)g(=)227
2083 y(.true.)k(then)30 b(the)h(32-bit)g(sum)f(v)-5 b(alue)31
b(will)f(b)s(e)g(complemen)m(ted)i(after)e(deco)s(ding.)382
2353 y Fe(FTDSUM\(checksum,compleme)o(nt,)41 b(>)48 b(sum\))0
2697 y Fd(6.11)180 b(Date)46 b(and)f(Time)g(Utilit)l(y)i(Routines)0
2950 y Fi(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 3063 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 3176 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 3288 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 3401 y('dd/mm/yy')g(date)h
(format)g(ma)m(y)g(not)g(b)s(e)e(used)h(for)g(dates)h(after)g(01)g(Jan)
m(uary)f(2000.)0 3670 y Fh(1)81 b Fi(Get)31 b(the)g(curren)m(t)f
(system)g(date.)42 b(The)29 b(returned)h(y)m(ear)h(has)f(4)h(digits)g
(\(1999,)h(2000,)h(etc.\))382 3940 y Fe(FTGSDT\()46 b(>)h(day,)g
(month,)f(year,)g(status)g(\))0 4209 y Fh(2)81 b Fi(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
4322 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 4435 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 4547 y(and)f(th)m(us)g(the)h(lo)s(cal)
g(time)g(w)m(as)g(returned.)382 4817 y Fe(FTGSTM\(>)45
b(datestr,)h(timeref,)f(status\))0 5086 y Fh(3)81 b Fi(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 5199 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 5312 y(the)32 b(date)g(string)f(will)g
(ha)m(v)m(e)i(the)e(new)g(FITS)g(format)g(\('YYYY-MM-DD'\).)36
b(Use)c(FTTM2S)f(instead)g(to)227 5425 y(alw)m(a)m(ys)h(return)d(a)i
(date)g(string)g(using)e(the)i(new)f(FITS)g(format.)382
5694 y Fe(FTDT2S\()46 b(year,)g(month,)g(day,)h(>)g(datestr,)f
(status\))p eop end
%%Page: 69 75
TeXDict begin 69 74 bop 0 299 a Fg(6.12.)73 b(GENERAL)30
b(UTILITY)g(SUBR)m(OUTINES)1979 b Fi(69)0 555 y Fh(4)81
b Fi(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
668 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 781 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 894 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'\).)382 1154 y
Fe(FTTM2S\()46 b(year,)g(month,)g(day,)h(hour,)f(minute,)g(second,)g
(decimals,)764 1267 y(>)h(datestr,)f(status\))0 1527
y Fh(5)81 b Fi(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 1640 y(\('dd/mm/yy'\))31 b(or)g(new)e
(\('YYYY-MM-DDThh:mm:ss')k(or)d('YYYY-MM-DD'\))k(FITS)c(format.)382
1900 y Fe(FTS2DT\(datestr,)43 b(>)48 b(year,)e(month,)g(day,)h
(status\))0 2160 y Fh(6)81 b Fi(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 2273 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
2386 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 2499 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 2612 y(the)d(input)e(string)i
(\('hh:mm:ss.ddd...'\).)382 2872 y Fe(FTS2TM\(datestr,)43
b(>)48 b(year,)e(month,)g(day,)h(hour,)f(minute,)g(second,)g(status\))0
3206 y Fd(6.12)136 b(General)45 b(Utilit)l(y)i(Subroutines)0
3456 y Fi(The)30 b(follo)m(wing)i(utilit)m(y)f(subroutines)f(ma)m(y)h
(b)s(e)e(useful)h(for)g(certain)h(applications:)0 3716
y Fh(1)81 b Fi(Return)29 b(the)i(starting)g(b)m(yte)g(address)e(of)i
(the)f(CHDU)h(and)f(the)h(next)f(HDU.)382 3976 y Fe(FTGHAD\(iunit,)44
b(>)j(curaddr,)f(nextaddr\))0 4236 y Fh(2)81 b Fi(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\).)382 4496 y Fe(FTUPCH\(string\))0 4756 y Fh(3)81
b Fi(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 4869 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 4982 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 5095 y(The)31
b('#')g(c)m(haracter)i(will)f(matc)m(h)g(an)m(y)f(consecutiv)m(e)j
(string)d(of)g(decimal)h(digits)g(\(0)g(-)g(9\).)43 b(If)31
b(CASESN)f(=)227 5208 y(.true.)45 b(then)31 b(the)g(matc)m(h)i(will)f
(b)s(e)f(case)h(sensitiv)m(e.)46 b(The)31 b(returned)f(MA)-8
b(TCH)32 b(parameter)g(will)g(b)s(e)f(.true.)227 5321
y(if)j(the)h(2)f(strings)g(matc)m(h,)j(and)c(EXA)m(CT)h(will)h(b)s(e)e
(.true.)53 b(if)34 b(the)g(matc)m(h)h(is)g(exact)g(\(i.e.,)i(if)d(no)g
(wildcard)227 5434 y(c)m(haracters)e(w)m(ere)f(used)f(in)g(the)g(matc)m
(h\).)42 b(Both)31 b(strings)f(m)m(ust)h(b)s(e)e(68)j(c)m(haracters)f
(or)g(less)f(in)g(length.)382 5694 y Fe(FTCMPS\(str_template,)42
b(string,)k(casesen,)f(>)j(match,)e(exact\))p eop end
%%Page: 70 76
TeXDict begin 70 75 bop 0 299 a Fi(70)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)0 555 y Fh(4)81 b Fi(T)-8 b(est)31 b(that)g(the)f(k)m
(eyw)m(ord)h(name)f(con)m(tains)i(only)e(legal)j(c)m(haracters:)42
b(A-Z,0-9,)32 b(h)m(yphen,)d(and)h(underscore.)382 820
y Fe(FTTKEY\(keyword,)43 b(>)48 b(status\))0 1085 y Fh(5)81
b Fi(T)-8 b(est)31 b(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)382
1350 y Fe(FTTREC\(card,)44 b(>)k(status\))0 1615 y Fh(6)81
b Fi(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 1728 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
1841 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 1954 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
2067 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 2180 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 2293 y(long\).)56 b(Note)36
b(that)g(this)f(is)g(one)g(of)g(the)g(few)g(FITSIO)f(routines)h(in)f
(whic)m(h)h(the)g(returned)f(v)-5 b(alue)36 b(is)f(not)227
2406 y(necessarily)d(equal)e(to)i(the)e(status)h(v)-5
b(alue\).)382 2671 y Fe(FTNCHK\(unit,)44 b(>)k(status\))0
2935 y Fh(7)81 b Fi(P)m(arse)27 b(a)f(header)h(k)m(eyw)m(ord)g(record)f
(and)g(return)f(the)i(name)f(of)h(the)f(k)m(eyw)m(ord)h(and)f(the)h
(length)f(of)h(the)g(name.)227 3048 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 3161 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.)382 3426 y Fe(FTGKNM\(card,)44
b(>)k(keyname,)d(keylength,)g(staThe)h('\\#')h(character)e(will)i
(match)f(any)h(consecutive)e(string)191 3539 y(of)i(decimal)f(digits)g
(\(0)h(-)h(9\).)f(tus\))0 3804 y Fh(8)81 b Fi(P)m(arse)34
b(a)h(header)f(k)m(eyw)m(ord)h(record.)52 b(This)33 b(subroutine)g
(parses)h(the)g(input)g(header)g(record)g(to)h(return)e(the)227
3917 y(v)-5 b(alue)27 b(\(as)g(a)g(c)m(haracter)g(string\))g(and)f
(commen)m(t)h(strings.)39 b(If)26 b(the)g(k)m(eyw)m(ord)h(has)f(no)g(v)
-5 b(alue)27 b(\(columns)f(9-10)227 4030 y(not)h(equal)f(to)h('=)f
('\),)i(then)e(the)g(v)-5 b(alue)27 b(string)f(is)g(returned)f(blank)h
(and)f(the)h(commen)m(t)i(string)e(is)g(set)g(equal)227
4143 y(to)31 b(column)g(9)f(-)h(80)g(of)g(the)f(input)g(string.)382
4408 y Fe(FTPSVC\(card,)44 b(>)k(value,comment,status\))0
4673 y Fh(9)81 b Fi(Construct)35 b(a)i(sequence)f(k)m(eyw)m(ord)h(name)
f(\(R)m(OOT)g(+)g(nnn\).)57 b(This)35 b(subroutine)g(app)s(ends)f(the)j
(sequence)227 4786 y(n)m(um)m(b)s(er)29 b(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'\))382 5051 y Fe(FTKEYN\(keyroot,seq_no,)42
b(>)47 b(keyword,status\))0 5316 y Fh(10)f Fi(Construct)30
b(a)g(sequence)g(k)m(eyw)m(ord)h(name)f(\(n)f(+)h(R)m(OOT\).)g(This)f
(subroutine)g(concatenates)j(the)f(sequence)227 5429
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'\))382 5694 y Fe(FTNKEY\(seq_no,keyroot,)42
b(>)47 b(keyword,status\))p eop end
%%Page: 71 77
TeXDict begin 71 76 bop 0 299 a Fg(6.12.)73 b(GENERAL)30
b(UTILITY)g(SUBR)m(OUTINES)1979 b Fi(71)0 555 y Fh(11)46
b Fi(Determine)35 b(the)f(datat)m(yp)s(e)g(of)g(a)g(k)m(eyw)m(ord)h(v)
-5 b(alue)34 b(string.)50 b(This)33 b(subroutine)g(parses)g(the)h(k)m
(eyw)m(ord)g(v)-5 b(alue)227 668 y(string)31 b(\(usually)f(columns)g
(11-30)j(of)d(the)h(header)f(record\))g(to)i(determine)e(its)h(datat)m
(yp)s(e.)382 936 y Fe(FTDTYP\(value,)44 b(>)j(dtype,status\))0
1204 y Fh(11)f Fi(Return)c(the)i(class)g(of)f(input)f(header)h(record.)
79 b(The)43 b(record)g(is)g(classi\014ed)g(in)m(to)h(one)g(of)f(the)g
(follo)m(wing)227 1317 y(categories)36 b(\(the)e(class)f(v)-5
b(alues)34 b(are)f(de\014ned)f(in)h(\014tsio.h\).)49
b(Note)35 b(that)e(this)g(is)g(one)h(of)f(the)g(few)g(FITSIO)227
1430 y(routines)e(that)f(do)s(es)h(not)f(return)f(a)i(status)g(v)-5
b(alue.)334 1697 y Fe(Class)94 b(Value)619 b(Keywords)95
1810 y(TYP_STRUC_KEY)92 b(10)j(SIMPLE,)46 b(BITPIX,)g(NAXIS,)g(NAXISn,)
g(EXTEND,)g(BLOCKED,)1002 1923 y(GROUPS,)g(PCOUNT,)g(GCOUNT,)g(END)1002
2036 y(XTENSION,)g(TFIELDS,)f(TTYPEn,)h(TBCOLn,)g(TFORMn,)g(THEAP,)1002
2149 y(and)h(the)g(first)f(4)i(COMMENT)e(keywords)f(in)i(the)g(primary)
f(array)1002 2262 y(that)h(define)f(the)h(FITS)g(format.)95
2375 y(TYP_CMPRS_KEY)92 b(20)j(The)47 b(experimental)e(keywords)g(used)
i(in)g(the)g(compressed)1002 2488 y(image)g(format)f(ZIMAGE,)g
(ZCMPTYPE,)f(ZNAMEn,)h(ZVALn,)1002 2601 y(ZTILEn,)g(ZBITPIX,)g
(ZNAXISn,)f(ZSCALE,)h(ZZERO,)g(ZBLANK)95 2714 y(TYP_SCAL_KEY)140
b(30)95 b(BSCALE,)46 b(BZERO,)g(TSCALn,)g(TZEROn)95 2826
y(TYP_NULL_KEY)140 b(40)95 b(BLANK,)46 b(TNULLn)95 2939
y(TYP_DIM_KEY)188 b(50)95 b(TDIMn)95 3052 y(TYP_RANG_KEY)140
b(60)95 b(TLMINn,)46 b(TLMAXn,)g(TDMINn,)g(TDMAXn,)g(DATAMIN,)f
(DATAMAX)95 3165 y(TYP_UNIT_KEY)140 b(70)95 b(BUNIT,)46
b(TUNITn)95 3278 y(TYP_DISP_KEY)140 b(80)95 b(TDISPn)95
3391 y(TYP_HDUID_KEY)d(90)j(EXTNAME,)46 b(EXTVER,)g(EXTLEVEL,)f
(HDUNAME,)g(HDUVER,)h(HDULEVEL)95 3504 y(TYP_CKSUM_KEY)f(100)94
b(CHECKSUM,)46 b(DATASUM)95 3617 y(TYP_WCS_KEY)141 b(110)94
b(CTYPEn,)46 b(CUNITn,)g(CRVALn,)g(CRPIXn,)g(CROTAn,)f(CDELTn)1002
3730 y(CDj_is,)h(PVj_ms,)g(LONPOLEs,)f(LATPOLEs)1002
3843 y(TCTYPn,)h(TCTYns,)g(TCUNIn,)g(TCUNns,)g(TCRVLn,)f(TCRVns,)h
(TCRPXn,)1002 3956 y(TCRPks,)g(TCDn_k,)g(TCn_ks,)g(TPVn_m,)g(TPn_ms,)f
(TCDLTn,)h(TCROTn)1002 4068 y(jCTYPn,)g(jCTYns,)g(jCUNIn,)g(jCUNns,)g
(jCRVLn,)f(jCRVns,)h(iCRPXn,)1002 4181 y(iCRPns,)g(jiCDn,)94
b(jiCDns,)46 b(jPVn_m,)g(jPn_ms,)f(jCDLTn,)h(jCROTn)1002
4294 y(\(i,j,m,n)g(are)h(integers,)e(s)i(is)h(any)f(letter\))95
4407 y(TYP_REFSYS_KEY)d(120)j(EQUINOXs,)f(EPOCH,)g(MJD-OBSs,)f
(RADECSYS,)g(RADESYSs)95 4520 y(TYP_COMM_KEY)140 b(130)47
b(COMMENT,)f(HISTORY,)f(\(blank)h(keyword\))95 4633 y(TYP_CONT_KEY)140
b(140)47 b(CONTINUE)95 4746 y(TYP_USER_KEY)140 b(150)47
b(all)g(other)g(keywords)430 4972 y(class)f(=)h(FTGKCL)f(\(char)h
(*card\))0 5240 y Fh(12)f Fi(P)m(arse)f(the)g('TF)m(ORM')h(binary)e
(table)i(column)e(format)h(string.)84 b(This)44 b(subroutine)g(parses)g
(the)h(input)227 5352 y(TF)m(ORM)27 b(c)m(haracter)g(string)f(and)g
(returns)f(the)h(in)m(teger)h(datat)m(yp)s(e)g(co)s(de,)h(the)e(rep)s
(eat)g(coun)m(t)h(of)f(the)g(\014eld,)227 5465 y(and,)f(in)e(the)h
(case)g(of)g(c)m(haracter)h(string)e(\014elds,)i(the)e(length)h(of)g
(the)g(unit)f(string.)38 b(The)23 b(follo)m(wing)i(datat)m(yp)s(e)227
5578 y(co)s(des)e(are)h(returned)e(\(the)h(negativ)m(e)i(of)f(the)f(v)
-5 b(alue)23 b(is)g(returned)f(if)h(the)g(column)g(con)m(tains)h(v)-5
b(ariable-length)227 5691 y(arra)m(ys\):)p eop end
%%Page: 72 78
TeXDict begin 72 77 bop 0 299 a Fi(72)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)764 555 y Fe(Datatype)761 b(DATACODE)46
b(value)764 668 y(bit,)g(X)907 b(1)764 781 y(byte,)46
b(B)811 b(11)764 894 y(logical,)45 b(L)668 b(14)764 1007
y(ASCII)46 b(character,)f(A)286 b(16)764 1120 y(short)46
b(integer,)g(I)381 b(21)764 1233 y(integer,)45 b(J)668
b(41)764 1346 y(real,)46 b(E)811 b(42)764 1458 y(double)46
b(precision,)f(D)238 b(82)764 1571 y(complex)809 b(83)764
1684 y(double)46 b(complex)475 b(163)382 1910 y(FTBNFM\(tform,)44
b(>)j(datacode,repeat,width,stat)o(us\))0 2147 y Fh(13)f
Fi(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 2260 y(routine)31 b(parses)g(the)g(input)g
(TF)m(ORM)g(c)m(haracter)i(string)e(and)f(returns)g(the)i(datat)m(yp)s
(e)g(co)s(de,)f(the)h(width)227 2373 y(of)40 b(the)h(column,)h(and)e
(\(if)g(it)g(is)h(a)f(\015oating)h(p)s(oin)m(t)f(column\))g(the)g(n)m
(um)m(b)s(er)f(of)h(decimal)h(places)g(to)g(the)227 2486
y(righ)m(t)28 b(of)g(the)f(decimal)h(p)s(oin)m(t.)40
b(The)27 b(returned)f(datat)m(yp)s(e)i(co)s(des)f(are)h(the)g(same)f
(as)h(for)f(the)g(binary)g(table,)227 2599 y(listed)41
b(ab)s(o)m(v)m(e,)j(with)c(the)g(follo)m(wing)i(additional)f(rules:)60
b(in)m(teger)42 b(columns)e(that)g(are)h(b)s(et)m(w)m(een)g(1)g(and)227
2712 y(4)36 b(c)m(haracters)i(wide)d(are)i(de\014ned)d(to)j(b)s(e)e
(short)h(in)m(tegers)h(\(co)s(de)f(=)g(21\).)58 b(Wider)36
b(in)m(teger)h(columns)f(are)227 2825 y(de\014ned)j(to)i(b)s(e)e
(regular)h(in)m(tegers)i(\(co)s(de)e(=)g(41\).)71 b(Similarly)-8
b(,)43 b(Fixed)d(decimal)h(p)s(oin)m(t)f(columns)g(\(with)227
2937 y(TF)m(ORM)30 b(=)g('Fw.d'\))g(are)g(de\014ned)f(to)h(b)s(e)g
(single)g(precision)g(reals)g(\(co)s(de)h(=)e(42\))i(if)f(w)f(is)h(b)s
(et)m(w)m(een)g(1)h(and)227 3050 y(7)i(c)m(haracters)h(wide,)f
(inclusiv)m(e.)47 b(Wider)32 b('F')h(columns)f(will)h(return)e(a)i
(double)f(precision)g(data)h(co)s(de)g(\(=)227 3163 y(82\).)54
b('Ew.d')34 b(format)g(columns)g(will)h(ha)m(v)m(e)g(dataco)s(de)g(=)f
(42,)j(and)c('Dw.d')i(format)f(columns)g(will)h(ha)m(v)m(e)227
3276 y(dataco)s(de)d(=)e(82.)382 3513 y Fe(FTASFM\(tform,)44
b(>)j(datacode,width,decimals,st)o(atus)o(\))0 3750 y
Fh(14)f Fi(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 3863 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 3976
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 4089 y(b)s(etter)31 b(h)m(uman)e(readabilit)m(y\).)
382 4326 y Fe(FTGABC\(tfields,tform,spa)o(ce,)41 b(>)48
b(rowlen,tbcol,status\))0 4563 y Fh(15)e Fi(P)m(arse)36
b(a)f(template)h(string)f(and)g(return)f(a)h(formatted)h(80-c)m
(haracter)h(string)e(suitable)h(for)f(app)s(ending)e(to)227
4675 y(\(or)40 b(deleting)h(from\))e(a)h(FITS)f(header)h(\014le.)68
b(This)39 b(subroutine)f(is)i(useful)f(for)g(parsing)g(lines)h(from)f
(an)227 4788 y(ASCI)s(I)34 b(template)j(\014le)f(and)e(reformatting)j
(them)e(in)m(to)i(legal)g(FITS)d(header)i(records.)55
b(The)35 b(formatted)227 4901 y(string)c(ma)m(y)g(then)f(b)s(e)g
(passed)g(to)i(the)e(FTPREC,)h(FTMCRD,)g(or)f(FTDKEY)h(subroutines)e
(to)j(app)s(end)227 5014 y(or)f(mo)s(dify)e(a)i(FITS)f(header)g
(record.)382 5251 y Fe(FTGTHD\(template,)43 b(>)48 b
(card,hdtype,status\))0 5488 y Fi(The)23 b(input)h(TEMPLA)-8
b(TE)23 b(c)m(haracter)j(string)e(generally)h(should)e(con)m(tain)i(3)g
(tok)m(ens:)38 b(\(1\))25 b(the)f(KEYNAME,)h(\(2\))0
5601 y(the)h(V)-10 b(ALUE,)26 b(and)f(\(3\))i(the)f(COMMENT)g(string.)
39 b(The)25 b(TEMPLA)-8 b(TE)26 b(string)g(m)m(ust)f(adhere)h(to)g(the)
g(follo)m(wing)0 5714 y(format:)p eop end
%%Page: 73 79
TeXDict begin 73 78 bop 0 299 a Fg(6.12.)73 b(GENERAL)30
b(UTILITY)g(SUBR)m(OUTINES)1979 b Fi(73)0 555 y Fh(-)80
b Fi(The)24 b(KEYNAME)g(tok)m(en)h(m)m(ust)e(b)s(egin)h(in)f(columns)h
(1-8)h(and)e(b)s(e)h(a)g(maxim)m(um)g(of)g(8)g(c)m(haracters)h(long.)39
b(If)24 b(the)227 668 y(\014rst)32 b(8)h(c)m(haracters)h(of)e(the)h
(template)h(line)e(are)h(blank)f(then)g(the)h(remainder)f(of)g(the)h
(line)g(is)f(considered)227 781 y(to)42 b(b)s(e)e(a)h(FITS)f(commen)m
(t)h(\(with)g(a)g(blank)f(k)m(eyw)m(ord)h(name\).)72
b(A)41 b(legal)i(FITS)d(k)m(eyw)m(ord)h(name)f(ma)m(y)227
894 y(only)35 b(con)m(tain)i(the)e(c)m(haracters)h(A-Z,)f(0-9,)j(and)c
('-')i(\(min)m(us)f(sign\))g(and)f(underscore.)54 b(This)34
b(subroutine)227 1007 y(will)42 b(automatically)i(con)m(v)m(ert)f(an)m
(y)f(lo)m(w)m(ercase)i(c)m(haracters)e(to)h(upp)s(ercase)d(in)h(the)h
(output)f(string.)73 b(If)227 1120 y(KEYNAME)33 b(=)f('COMMENT')h(or)g
('HISTOR)-8 b(Y')32 b(then)h(the)f(remainder)g(of)h(the)g(line)g(is)g
(considered)f(to)227 1233 y(b)s(e)e(a)h(FITS)e(COMMENT)h(or)h(HISTOR)-8
b(Y)30 b(record,)g(resp)s(ectiv)m(ely)-8 b(.)0 1490 y
Fh(-)80 b Fi(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 1603 y(an)i('=')g(c)m(haracter.)41
b(The)27 b(datat)m(yp)s(e)i(of)f(the)g(V)-10 b(ALUE)27
b(tok)m(en)i(\(n)m(umeric,)g(logical,)i(or)d(c)m(haracter)h(string\))f
(is)227 1716 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 1829 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
1942 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 2055 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
2168 y(m)m(ust)31 b(b)s(e)e(enclosed)i(in)f(single)h(quotes.)0
2425 y Fh(-)80 b Fi(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 2538 y(a)i(blank)f(space)h(or)f(a)h
('/')g(c)m(haracter.)0 2796 y Fh(-)80 b Fi(One)32 b(exception)i(to)f
(the)g(ab)s(o)m(v)m(e)h(rules)e(is)g(that)h(if)g(the)f(\014rst)g
(non-blank)g(c)m(haracter)i(in)e(the)h(template)h(string)227
2909 y(is)h(a)g(min)m(us)f(sign)h(\('-'\))h(follo)m(w)m(ed)g(b)m(y)f(a)
g(single)g(tok)m(en,)i(or)e(a)g(single)g(tok)m(en)h(follo)m(w)m(ed)g(b)
m(y)f(an)f(equal)i(sign,)227 3022 y(then)29 b(it)g(is)g(in)m(terpreted)
f(as)h(the)g(name)g(of)g(a)g(k)m(eyw)m(ord)g(whic)m(h)f(is)h(to)g(b)s
(e)f(deleted)i(from)e(the)h(FITS)f(header.)0 3279 y Fh(-)80
b Fi(The)40 b(second)g(exception)h(is)f(that)h(if)f(the)g(template)h
(string)f(starts)g(with)g(a)h(min)m(us)e(sign)h(and)f(is)h(follo)m(w)m
(ed)227 3392 y(b)m(y)33 b(2)g(tok)m(ens)g(then)g(the)f(second)h(tok)m
(en)h(is)e(in)m(terpreted)h(as)g(the)g(new)f(name)g(for)h(the)g(k)m
(eyw)m(ord)g(sp)s(eci\014ed)227 3505 y(b)m(y)h(\014rst)e(tok)m(en.)52
b(In)33 b(this)g(case)i(the)e(old)h(k)m(eyw)m(ord)g(name)g(\(\014rst)f
(tok)m(en\))i(is)e(returned)g(in)g(c)m(haracters)i(1-8)227
3618 y(of)e(the)g(returned)e(CARD)i(string,)g(and)f(the)h(new)f(k)m
(eyw)m(ord)h(name)g(\(the)g(second)f(tok)m(en\))i(is)f(returned)e(in)
227 3731 y(c)m(haracters)c(41-48)h(of)e(the)f(returned)g(CARD)g
(string.)40 b(These)25 b(old)h(and)f(new)g(names)g(ma)m(y)h(then)f(b)s
(e)g(passed)227 3844 y(to)31 b(the)g(FTMNAM)g(subroutine)f(whic)m(h)g
(will)g(c)m(hange)i(the)e(k)m(eyw)m(ord)h(name.)0 4101
y(The)f(HDTYPE)g(output)g(parameter)h(indicates)g(ho)m(w)g(the)f
(returned)g(CARD)g(string)g(should)g(b)s(e)g(in)m(terpreted:)382
4359 y Fe(hdtype)857 b(interpretation)382 4472 y(------)523
b(-------------------------)o(----)o(---)o(----)o(----)o(---)o(----)o
(--)525 4585 y(-2)572 b(Modify)46 b(the)h(name)g(of)g(the)g(keyword)f
(given)g(in)h(CARD\(1:8\))1193 4698 y(to)g(the)g(new)g(name)g(given)f
(in)h(CARD\(41:48\))525 4924 y(-1)572 b(CARD\(1:8\))45
b(contains)h(the)h(name)g(of)g(a)g(keyword)f(to)h(be)g(deleted)1193
5036 y(from)g(the)g(FITS)f(header.)573 5262 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
5375 y(keyword)f(does)h(not)g(already)e(exist,)h(otherwise)g(update)
1193 5488 y(the)h(value/comment)d(if)j(the)g(keyword)f(is)h(already)f
(present)1193 5601 y(in)h(the)g(header.)p eop end
%%Page: 74 80
TeXDict begin 74 79 bop 0 299 a Fi(74)1319 b Fg(CHAPTER)29
b(6.)112 b(AD)m(V)-10 b(ANCED)32 b(INTERF)-10 b(A)m(CE)30
b(SUBR)m(OUTINES)573 555 y Fe(1)572 b(simply)46 b(append)g(this)h
(keyword)f(to)h(the)g(FITS)g(header)f(\(CARD)1193 668
y(is)h(either)f(a)i(HISTORY)e(or)h(COMMENT)f(keyword\).)573
894 y(2)572 b(This)47 b(is)g(a)g(FITS)g(END)g(record;)f(it)h(should)f
(not)h(be)g(written)1193 1007 y(to)g(the)g(FITS)g(header)f(because)g
(FITSIO)g(automatically)1193 1120 y(appends)g(the)h(END)g(record)f
(when)h(the)f(header)h(is)g(closed.)0 1380 y Fi(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 1639 y Fe(INTVAL)46
b(7)i(This)f(is)g(an)g(integer)f(keyword)286 1752 y(RVAL)524
b(34.6)142 b(/)239 b(This)46 b(is)i(a)f(floating)f(point)g(keyword)286
1865 y(EVAL=-12.45E-03)92 b(This)46 b(is)i(a)f(floating)f(point)g
(keyword)g(in)h(exponential)e(notation)286 1978 y(lval)i(F)g(This)g(is)
g(a)h(boolean)e(keyword)859 2091 y(This)h(is)g(a)g(comment)f(keyword)g
(with)h(a)g(blank)f(keyword)g(name)286 2204 y(SVAL1)h(=)g('Hello)f
(world')142 b(/)95 b(this)47 b(is)g(a)g(string)f(keyword)286
2317 y(SVAL2)94 b('123.5')g(this)47 b(is)g(also)f(a)i(string)e(keyword)
286 2430 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 2543
y(#)48 b(the)f(following)e(template)h(line)g(deletes)g(the)h(DATE)g
(keyword)286 2655 y(-)h(DATE)286 2768 y(#)g(the)f(following)e(template)
h(line)g(modifies)g(the)h(NAME)f(keyword)g(to)h(OBJECT)286
2881 y(-)h(NAME)e(OBJECT)0 3141 y Fh(16)g Fi(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
3254 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 3367 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 3480 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;)227 3593 y(an)m(y)e(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 3706 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 3819 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 3931 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
4191 y Fe(FTRWRG\(rowlist,)44 b(maxrows,)h(maxranges,)g(>)525
4304 y(numranges,)g(rangemin,)g(rangemax,)h(status\))p
eop end
%%Page: 75 81
TeXDict begin 75 80 bop 0 1225 a Ff(Chapter)65 b(7)0
1687 y Fl(The)77 b(CFITSIO)f(Iterator)i(F)-19 b(unction)0
2180 y Fi(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 Fi(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 Fi(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 Fi(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 Fi(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(75)p eop
end
%%Page: 76 82
TeXDict begin 76 81 bop 0 299 a Fi(76)1455 b Fg(CHAPTER)30
b(7.)112 b(THE)30 b(CFITSIO)e(ITERA)-8 b(TOR)30 b(FUNCTION)0
555 y Fi(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(F)-8 b(urther)41 b(details)i(on)f(using)f(the)h
(iterator)h(function)f(can)g(b)s(e)f(found)f(in)i(the)g(companion)g
(CFITSIO)e(User's)0 1440 y(Guide,)31 b(and)e(in)h(the)h(iter)p
874 1440 28 4 v 33 w(a.f,)g(iter)p 1197 1440 V 34 w(b.f)f(and)f(iter)p
1677 1440 V 34 w(c.f)h(example)h(programs.)p eop end
%%Page: 77 83
TeXDict begin 77 82 bop 0 1225 a Ff(Chapter)65 b(8)0
1687 y Fl(Extended)77 b(File)g(Name)g(Syn)-6 b(tax)0
2216 y Fd(8.1)135 b(Ov)l(erview)0 2466 y Fi(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 Fi(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 Fi(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 Fi(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 Fi(FITS)20 b(\014les)h(can)g(b)s(e)f(read)g(and)g
(written)h(in)f(shared)g(memory)-8 b(.)38 b(This)20 b(can)h(p)s(oten)m
(tially)h(ac)m(hiev)m(e)h(m)m(uc)m(h)e(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 Fi(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 Fi(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 Fi(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 Fi(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)f(on)h(an)f
(arbitrary)h(user-sp)s(eci\014ed)e(expression.)39 b(Only)26
b(ro)m(ws)h(for)f(whic)m(h)g(the)h(expression)f(ev)-5
b(aluates)227 5309 y(to)31 b('TR)m(UE')g(are)g(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 Fi(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.)1905 5942 y(77)p eop
end
%%Page: 78 84
TeXDict begin 78 83 bop 0 299 a Fi(78)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(The)43 b(latter)i(3)f(features)g(in)f(particular)h(add)f(v)m
(ery)h(p)s(o)m(w)m(erful)f(data)h(pro)s(cessing)f(capabilities)j
(directly)e(in)m(to)0 668 y(CFITSIO,)29 b(and)g(hence)h(in)m(to)h(ev)m
(ery)f(task)h(that)f(uses)g(CFITSIO)e(to)j(read)f(or)g(write)g(FITS)f
(\014les.)40 b(F)-8 b(or)31 b(example,)0 781 y(these)d(features)f
(transform)f(a)i(v)m(ery)f(simple)g(program)g(that)h(just)f(copies)h
(an)f(input)f(FITS)g(\014le)h(to)h(a)g(new)e(output)0
894 y(\014le)36 b(\(lik)m(e)h(the)f(`\014tscop)m(y')h(program)f(that)g
(is)g(distributed)f(with)g(CFITSIO\))g(in)m(to)i(a)f(m)m(ultipurp)s
(ose)f(FITS)g(\014le)0 1007 y(pro)s(cessing)24 b(to)s(ol.)40
b(By)25 b(app)s(ending)f(fairly)g(simple)h(quali\014ers)g(on)m(to)g
(the)g(name)g(of)g(the)g(input)f(FITS)g(\014le,)i(the)f(user)0
1120 y(can)37 b(p)s(erform)f(quite)i(complex)g(table)g(editing)g(op)s
(erations)f(\(e.g.,)k(create)e(new)d(columns,)j(or)e(\014lter)h(out)f
(ro)m(ws)0 1233 y(in)g(a)g(table\))h(or)f(create)h(FITS)f(images)h(b)m
(y)f(binning)e(or)i(histogramming)h(the)f(v)-5 b(alues)37
b(in)g(table)h(columns.)60 b(In)0 1346 y(addition,)33
b(these)g(functions)e(ha)m(v)m(e)j(b)s(een)d(co)s(ded)h(using)f(new)h
(state-of-the)i(art)f(algorithms)g(that)g(are,)g(in)f(some)0
1458 y(cases,)g(10)f(-)f(100)i(times)f(faster)g(than)f(previous)g
(widely)g(used)g(implemen)m(tations.)0 1619 y(Before)k(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
1960 y Fc(\017)46 b Fe('myfile.fits')p Fi(:)37 b(the)31
b(simplest)f(case)i(of)e(a)h(FITS)f(\014le)g(on)h(disk)e(in)i(the)f
(curren)m(t)g(directory)-8 b(.)136 2137 y Fc(\017)46
b Fe('myfile.imh')p Fi(:)37 b(op)s(ens)28 b(an)h(IRAF)g(format)g(image)
i(\014le)e(and)f(con)m(v)m(erts)i(it)g(on)f(the)g(\015y)f(in)m(to)i(a)f
(temp)s(orary)227 2250 y(FITS)h(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 2427 y Fc(\017)46 b Fe(rawfile.dat[i512,512])p
Fi(:)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
2540 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 2652 y(can)e(then)f(b)s(e)g(read)g(with)g(an)m(y)h(other)
f(CFITSIO)f(routine.)136 2830 y Fc(\017)46 b Fe(myfile.fits.gz)p
Fi(:)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
2942 y(compressed)c(in)g(gzip)h(format)g(when)e(it)i(is)g(written)f(to)
h(disk.)136 3120 y Fc(\017)46 b Fe('myfile.fits.gz[events,)c(2]')p
Fi(:)59 b(op)s(ens)40 b(and)f(uncompresses)g(the)i(gzipp)s(ed)e(\014le)
i(m)m(y\014le.\014ts)f(then)227 3232 y(mo)m(v)m(es)34
b(to)f(the)f(extension)h(whic)m(h)f(has)f(the)i(k)m(eyw)m(ords)f
(EXTNAME)g(=)g('EVENTS')g(and)g(EXTVER)f(=)227 3345 y(2.)136
3522 y Fc(\017)46 b Fe('-')p Fi(:)40 b(a)31 b(dash)f(\(min)m(us)g
(sign\))h(signi\014es)f(that)h(the)g(input)f(\014le)g(is)h(to)g(b)s(e)f
(read)g(from)g(the)h(stdin)f(\014le)g(stream,)227 3635
y(or)h(that)g(the)f(output)g(\014le)h(is)f(to)h(b)s(e)f(written)g(to)h
(the)g(stdout)f(stream.)136 3812 y Fc(\017)46 b Fe
('ftp://legacy.gsfc.nasa.g)o(ov/t)o(est/)o(vel)o(a.fi)o(ts')p
Fi(:)33 b(FITS)28 b(\014les)g(in)g(an)m(y)g(ftp)g(arc)m(hiv)m(e)i(site)
f(on)f(the)227 3925 y(In)m(ternet)j(ma)m(y)g(b)s(e)f(directly)h(op)s
(ened)e(with)h(read-only)h(access.)136 4102 y Fc(\017)46
b Fe('http://legacy.gsfc.nasa.)o(gov/)o(soft)o(war)o(e/te)o(st.f)o(its)
o(')p Fi(:)d(an)m(y)34 b(v)-5 b(alid)35 b(URL)f(to)h(a)f(FITS)g(\014le)
g(on)227 4215 y(the)d(W)-8 b(eb)31 b(ma)m(y)g(b)s(e)f(op)s(ened)f(with)
h(read-only)h(access.)136 4392 y Fc(\017)46 b Fe
('root://legacy.gsfc.nasa.)o(gov/)o(test)o(/ve)o(la.f)o(its')o
Fi(:)32 b(similar)24 b(to)g(ftp)f(access)i(except)g(that)f(it)g(pro-)
227 4505 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 4618 y(dev)m(elop)s(ed)h(at)g
(CERN.)136 4795 y Fc(\017)46 b Fe('shmem://h2[events]')p
Fi(:)35 b(op)s(ens)30 b(the)g(FITS)f(\014le)i(in)f(a)g(shared)f(memory)
i(segmen)m(t)g(and)e(mo)m(v)m(es)j(to)f(the)227 4908
y(EVENTS)f(extension.)136 5085 y Fc(\017)46 b Fe('mem://')p
Fi(:)52 b(creates)39 b(a)e(scratc)m(h)i(output)d(\014le)i(in)e(core)i
(computer)f(memory)-8 b(.)62 b(The)37 b(resulting)g('\014le')h(will)227
5198 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 5311 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.)136 5488 y Fc(\017)46 b
Fe('myfile.fits[3;)e(Images\(10\)]')p Fi(:)49 b(op)s(ens)35
b(a)i(cop)m(y)g(of)f(the)g(image)i(con)m(tained)f(in)f(the)h(10th)f(ro)
m(w)h(of)227 5601 y(the)26 b('Images')i(column)d(in)h(the)g(binary)g
(table)g(in)g(the)g(3th)h(extension)f(of)g(the)h(FITS)e(\014le.)39
b(The)26 b(application)227 5714 y(just)k(sees)h(this)f(single)h(image)h
(as)e(the)h(primary)e(arra)m(y)-8 b(.)p eop end
%%Page: 79 85
TeXDict begin 79 84 bop 0 299 a Fg(8.1.)72 b(O)m(VER)-10
b(VIEW)3086 b Fi(79)136 555 y Fc(\017)46 b Fe('myfile.fits[1:512:2,)c
(1:512:2]')p Fi(:)49 b(op)s(ens)35 b(a)h(section)h(of)e(the)h(input)f
(image)i(ranging)f(from)f(the)227 668 y(1st)26 b(to)g(the)f(512th)h
(pixel)g(in)e(X)i(and)e(Y,)i(and)e(selects)j(ev)m(ery)e(second)h(pixel)
f(in)g(b)s(oth)f(dimensions,)i(resulting)227 781 y(in)k(a)h(256)h(x)e
(256)i(pixel)e(image)i(in)e(this)g(case.)136 981 y Fc(\017)46
b Fe('myfile.fits[EVENTS][col)41 b(Rad)47 b(=)h(sqrt\(X**2)d(+)j
(Y**2\)]')p Fi(:)38 b(creates)30 b(and)f(op)s(ens)f(a)h(temp)s(orary)
227 1094 y(\014le)f(on)f(the)g(\015y)g(\(in)g(memory)g(or)g(on)h
(disk\))f(that)g(is)h(iden)m(tical)h(to)f(m)m(y\014le.\014ts)f(except)h
(that)g(it)g(will)g(con)m(tain)227 1207 y(a)41 b(new)f(column)g(in)h
(the)f(EVENTS)g(extension)h(called)h('Rad')f(whose)f(v)-5
b(alue)41 b(is)f(computed)h(using)f(the)227 1320 y(indicated)31
b(expression)f(whic)m(h)g(is)h(a)g(function)f(of)g(the)h(v)-5
b(alues)30 b(in)h(the)f(X)h(and)e(Y)i(columns.)136 1520
y Fc(\017)46 b Fe('myfile.fits[EVENTS][PHA)41 b(>)48
b(5]')p Fi(:)37 b(creates)27 b(and)e(op)s(ens)g(a)h(temp)s(orary)f
(FITS)g(\014les)g(that)h(is)g(iden)m(ti-)227 1633 y(cal)k(to)g('m)m
(y\014le.\014ts')f(except)h(that)f(the)g(EVENTS)f(table)i(will)f(only)g
(con)m(tain)h(the)f(ro)m(ws)g(that)h(ha)m(v)m(e)g(v)-5
b(alues)227 1746 y(of)28 b(the)g(PHA)f(column)g(greater)i(than)e(5.)40
b(In)27 b(general,)i(an)m(y)f(arbitrary)f(b)s(o)s(olean)h(expression)f
(using)g(a)h(C)f(or)227 1859 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
1972 y(from)g(a)h(table.)136 2172 y Fc(\017)46 b Fe
('myfile.fits[EVENTS][bin)41 b(\(X,Y\)=1,2048,4]')p Fi(:)46
b(creates)37 b(a)e(temp)s(orary)g(FITS)f(primary)g(arra)m(y)227
2285 y(image)c(whic)m(h)f(is)g(computed)f(on)h(the)g(\015y)f(b)m(y)g
(binning)g(\(i.e,)j(computing)d(the)h(2-dimensional)h(histogram\))227
2398 y(of)k(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 2511 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 2624 y(the)d(resulting)f(image)i(is)e(512)i(x)e
(512)i(pixels)f(in)f(size.)136 2824 y Fc(\017)46 b Fi(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
2937 y(in)m(to)h(sev)m(eral)f(lines)g(for)f(clarit)m(y\):)323
3206 y Fe('ftp://legacy.gsfc.nasa)o(.gov)o(/dat)o(a/s)o(ampl)o(e.fi)o
(ts.)o(gz[E)o(VENT)o(S])370 3319 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
3432 y([bin)g(\(X,Y\)=32]')227 3701 y Fi(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 3814
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
3927 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 4040 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 4153 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 4266 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 4538 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 4651 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 4924 y Fe(When)47
b(creating)e(a)j(new)f(file:)143 5036 y(filetype://BaseFilename\(t)o
(empl)o(ate)o(Name)o(\))0 5262 y(When)g(opening)e(an)j(existing)d
(primary)h(array)g(or)i(image)e(HDU:)143 5375 y
(filetype://BaseFilename\(o)o(utNa)o(me\))o([HDU)o(loca)o(tio)o(n][I)o
(mage)o(Sec)o(tion)o(])0 5601 y(When)h(opening)e(an)j(existing)d(table)
i(HDU:)143 5714 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])p eop end
%%Page: 80 86
TeXDict begin 80 85 bop 0 299 a Fi(80)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(The)41 b(\014let)m(yp)s(e,)k(BaseFilename,)i(outName,)e(HDUlo)
s(cation,)i(and)41 b(ImageSection)i(comp)s(onen)m(ts,)i(if)d(presen)m
(t,)0 668 y(m)m(ust)30 b(b)s(e)g(giv)m(en)i(in)e(that)h(order,)g(but)f
(the)g(colFilter,)j(ro)m(wFilter,)g(and)c(binSp)s(ec)h(sp)s(eci\014ers)
f(ma)m(y)j(follo)m(w)f(in)g(an)m(y)0 781 y(order.)39
b(Regardless)29 b(of)g(the)f(order,)g(ho)m(w)m(ev)m(er,)i(the)f
(colFilter)h(sp)s(eci\014er,)e(if)g(presen)m(t,)h(will)g(b)s(e)e(pro)s
(cessed)h(\014rst)f(b)m(y)0 894 y(CFITSIO,)i(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 1253 y Fd(8.2)135 b(Filet)l(yp)t(e)0
1508 y Fi(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 1621 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
1734 y(supp)s(orted)29 b(t)m(yp)s(es)h(are)382 2015 y
Fe(file://)93 b(-)48 b(file)e(on)i(local)e(magnetic)g(disk)g
(\(default\))382 2128 y(ftp://)141 b(-)48 b(a)f(readonly)f(file)g
(accessed)g(with)h(the)g(anonymous)e(FTP)i(protocol.)907
2241 y(It)g(also)g(supports)93 b(ftp://username:password@)o(host)o(nam)
o(e/..)o(.)907 2354 y(for)47 b(accessing)e(password-protected)e(ftp)k
(sites.)382 2467 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 2579 y(supports)45
b(username:password)e(just)k(like)g(the)g(ftp)g(driver.)907
2692 y(Proxy)f(HTTP)h(servers)f(are)h(supported)e(using)h(the)h
(http_proxy)907 2805 y(environment)e(variable)g(\(see)i(following)e
(note\).)286 2918 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 3031
y(stream,)f(and/or)g(write)g(an)h(output)f(FITS)h(file)g(to)g(the)g
(stdout)143 3144 y(stream.)94 b(This)46 b(driver)g(is)i(fragile)d(and)i
(has)g(limited)143 3257 y(functionality)d(\(see)j(the)g(following)e
(note\).)286 3370 y(gsiftp://)93 b(-)48 b(access)e(files)g(on)h(a)h
(computational)c(grid)j(using)f(the)h(gridftp)907 3483
y(protocol)e(in)j(the)e(Globus)h(toolkit)e(\(see)i(following)e(note\).)
382 3596 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 3709 y(reading)f(files)g(over)h
(the)g(network.)382 3821 y(shmem://)e(-)j(opens)e(or)h(creates)f(a)i
(file)e(which)h(persists)e(in)i(the)g(computer's)907
3934 y(shared)f(memory.)382 4047 y(mem://)141 b(-)48
b(opens)e(a)i(temporary)d(file)i(in)g(core)f(memory.)94
b(The)47 b(file)907 4160 y(disappears)e(when)h(the)h(program)f(exits)h
(so)g(this)f(is)i(mainly)907 4273 y(useful)e(for)h(test)f(purposes)g
(when)h(a)g(permanent)e(output)h(file)907 4386 y(is)h(not)g(desired.)0
4667 y Fi(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 4780 y(and)30
b(ma)m(y)h(b)s(e)e(omitted)j(in)e(most)h(cases.)0 5096
y Fb(8.2.1)112 b(Notes)37 b(ab)s(out)i(HTTP)d(pro)m(xy)i(serv)m(ers)0
5320 y Fi(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 5433 y(serv)m(er)f(with)f(the)g(h)m
(ttp)p 801 5433 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)191 5714 y Fe(setenv)46
b(http_proxy)f(http://heasarc.gsfc.nasa)o(.gov)o(:312)o(8)p
eop end
%%Page: 81 87
TeXDict begin 81 86 bop 0 299 a Fg(8.2.)72 b(FILETYPE)3128
b Fi(81)0 555 y(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 668 y(with)30 b(HTTP)-8 b(.)0 987 y
Fb(8.2.2)112 b(Notes)37 b(ab)s(out)i(the)e(stream)h(\014let)m(yp)s(e)g
(driv)m(er)0 1212 y Fi(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 1324 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
1437 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 1550 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 1710 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 1823 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 1936 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 2049 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 2162 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 2275 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 2388 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 2501 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 2614 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 2727 y(large)h(\014les.)0
2887 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 3000 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 3113
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 3225 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 3338
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 3451 y(follo)m(wing)g(restrictions:)136 3735 y
Fc(\017)46 b Fi(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 3848 y(an)m(y)31 b(data)g(in)f(the)h(HDU.)136
4060 y Fc(\017)46 b Fi(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 4172
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 4285 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 4497 y Fc(\017)46 b Fi(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 4610 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
4723 y(this)31 b(requiremen)m(t.)136 4934 y Fc(\017)46
b Fi(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 5146
y Fc(\017)46 b Fi(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 5259 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 5372 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 Fi(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: 82 88
TeXDict begin 82 87 bop 0 299 a Fi(82)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fb(8.2.3)112 b(Notes)37 b(ab)s(out)i(the)e(gsiftp)h(\014let)m(yp)
s(e)0 774 y Fi(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 Fb(8.2.4)112 b(Notes)37
b(ab)s(out)i(the)e(ro)s(ot)g(\014let)m(yp)s(e)0 4009
y Fi(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 Fi(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 Fi(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 Fi(and)30 b(to)h
(/etc/inetd.conf,)i(add)d(the)g(follo)m(wing)i(line:)p
eop end
%%Page: 83 89
TeXDict begin 83 88 bop 0 299 a Fg(8.2.)72 b(FILETYPE)3128
b Fi(83)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
Fi(F)-8 b(orce)34 b(inetd)e(to)i(reread)e(its)h(conf)f(\014le)h(with)f
("kill)h(-HUP)g(<pid)f(inetd>".)47 b(Y)-8 b(ou)33 b(can)g(also)g(start)
g(ro)s(otd)g(b)m(y)f(hand)0 942 y(running)j(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)
e(listening)i(on)f(p)s(ort)f(5151)j(just)d(t)m(yp)s(e:)49
b Fe(rootd)d(-p)h(5151)33 b Fi(Notice:)50 b(no)34 b(&)f(is)h(needed.)51
b(Ro)s(otd)35 b(will)0 1167 y(go)c(in)m(to)h(bac)m(kground)e(b)m(y)g
(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 Fi(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: 84 90
TeXDict begin 84 89 bop 0 299 a Fi(84)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(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 Fb(8.2.5)112 b(Notes)37 b(ab)s(out)i(the)e(shmem)i(\014let)m(yp)
s(e:)0 1515 y Fi(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 Fi(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 Fi(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 Fd(8.3)135 b(Base)46
b(Filename)0 5601 y Fi(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: 85 91
TeXDict begin 85 90 bop 0 299 a Fg(8.3.)72 b(BASE)30
b(FILENAME)2830 b Fi(85)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 Fi(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(datat)m(yp)s(e)h(of)g(the)g(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 Fi(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)f(\(as)h(in)f(FITS)f
(\014les)i(and)f(the)g(nativ)m(e)i(format)e(of)h(SUN)f(UNIX)h(w)m
(orkstations)g(and)f(Mac)i(PCs\))e(and)p eop end
%%Page: 86 92
TeXDict begin 86 91 bop 0 299 a Fi(86)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(l)41 b(or)g(L)g(indicates)g(little)i(endian)e(\(nativ)m(e)h
(format)g(of)f(DEC)f(OSF)h(w)m(orkstations)h(and)e(IBM)i(PCs\).)72
b(If)40 b(this)0 668 y(c)m(haracter)32 b(is)e(omitted)i(then)e(the)g
(arra)m(y)h(is)g(assumed)e(to)i(ha)m(v)m(e)h(the)f(nativ)m(e)g(b)m(yte)
g(order)f(of)h(the)f(lo)s(cal)i(mac)m(hine.)0 781 y(These)d(datat)m(yp)
s(e)h(c)m(haracters)h(are)e(then)g(follo)m(w)m(ed)i(b)m(y)e(a)h(series)
f(of)g(one)h(or)f(more)g(in)m(teger)i(v)-5 b(alues)29
b(separated)h(b)m(y)0 894 y(commas)h(whic)m(h)g(de\014ne)e(the)i(size)h
(of)e(eac)m(h)i(dimension)e(of)h(the)g(ra)m(w)f(arra)m(y)-8
b(.)43 b(Arra)m(ys)30 b(with)h(up)e(to)j(5)f(dimensions)0
1007 y(are)f(curren)m(tly)g(supp)s(orted.)38 b(Finally)-8
b(,)32 b(a)e(b)m(yte)g(o\013set)g(to)h(the)e(p)s(osition)h(of)g(the)g
(\014rst)e(pixel)i(in)g(the)f(data)i(\014le)e(ma)m(y)0
1120 y(b)s(e)d(sp)s(eci\014ed)g(b)m(y)h(separating)h(it)f(with)g(a)g
(':')39 b(from)27 b(the)g(last)g(dimension)g(v)-5 b(alue.)40
b(If)26 b(omitted,)j(it)e(is)g(assumed)f(that)0 1233
y(the)35 b(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 Fi(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 Fi(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 Fd(8.4)135 b(Output)45 b(File)g(Name)h(when)f(Op)t(ening)g(an)g
(Existing)h(File)0 4698 y Fi(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: 87 93
TeXDict begin 87 92 bop 0 299 a Fg(8.4.)72 b(OUTPUT)30
b(FILE)g(NAME)h(WHEN)g(OPENING)f(AN)h(EXISTING)e(FILE)967
b Fi(87)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 Fi(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(In)35 b(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 1054
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 1167 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
1280 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 1393 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 1506
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 1619 y(describ)s(ed)g(b)s(elo)m(w,)i(in)
f(descending)g(priorit)m(y:)136 1869 y Fc(\017)46 b Fi(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 1982 y(an)i(image)g(is)g(created)g(b)m(y)f(binning)g(a)g(table)
i(column.)136 2167 y Fc(\017)46 b Fi(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
2280 y(sp)s(eci\014ed.)136 2464 y Fc(\017)46 b Fi(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 2649 y Fc(\017)46 b Fi(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
2762 y(disk)f(has)g(b)s(een)g(op)s(ened.)136 2946 y Fc(\017)46
b Fi(otherwise,)31 b(the)g(output)f(\014lename)g(is)h(ignored.)0
3197 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 3310 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
3423 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 3535 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
3648 y(follo)m(wing)i(examples:)136 3876 y Fc(\017)46
b Fi(`ftp://remote.mac)m(hine/tmp/m)m(y\014le.\014ts.gz\(*\)')k(-)43
b(the)g(remote)h(compressed)f(\014le)g(is)g(copied)h(to)g(the)227
3988 y(lo)s(cal)26 b(compressed)e(\014le)g(`m)m(y\014le.\014ts.gz',)k
(whic)m(h)c(is)g(then)h(uncompressed)e(in)h(lo)s(cal)h(memory)f(b)s
(efore)g(b)s(eing)227 4101 y(op)s(ened)30 b(and)g(passed)g(to)h(the)f
(application)i(program.)136 4286 y Fc(\017)46 b Fi(`ftp://remote.mac)m
(hine/tmp/m)m(y\014le.\014ts.gz\(m)m(y\014le.\014ts\)')d(-)37
b(the)g(remote)g(compressed)f(\014le)h(is)f(copied)227
4399 y(and)h(uncompressed)g(in)m(to)h(the)g(lo)s(cal)h(\014le)f(`m)m
(y\014le.\014ts'.)64 b(This)36 b(example)j(requires)e(less)h(lo)s(cal)h
(memory)227 4512 y(than)30 b(the)h(previous)f(example)h(since)g(the)f
(\014le)h(is)f(uncompressed)f(on)h(disk)g(instead)h(of)f(in)h(memory)-8
b(.)136 4696 y Fc(\017)46 b Fi(`ftp://remote.mac)m(hine/tmp/m)m
(y\014le.\014ts\(m)m(y\014le.\014ts.gz\)')28 b(-)21 b(this)g(will)h
(usually)f(pro)s(duce)f(an)h(error)g(since)227 4809 y(CFITSIO)29
b(itself)i(cannot)g(compress)f(\014les.)0 5036 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 5149 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 5262 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)0 5375 y(will)f(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 5488 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 5601 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 5714 y(that)c(they)g(exp)s(ect.)p eop end
%%Page: 88 94
TeXDict begin 88 93 bop 0 299 a Fi(88)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fd(8.5)135 b(T)-11 b(emplate)46 b(File)g(Name)f(when)g(Creating)h
(a)g(New)f(File)0 808 y Fi(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 808 28
4 v 32 w(create)p 2369 808 V 35 w(\014le,)g(the)f(name)g(of)g(a)g
(template)h(\014le)e(ma)m(y)0 921 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 1034 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 1147 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 1260 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
1373 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 1486 y(The)j(format)h(of)f(the)h
(ASCI)s(I)e(template)i(\014le)g(is)f(describ)s(ed)f(b)s(elo)m(w.)0
1833 y Fd(8.6)135 b(Image)46 b(Tile-Compression)h(Sp)t(eci\014cation)0
2086 y Fi(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 2198 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 2311 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 2424 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 2695
y Fe(myfile.fit[compress])185 b(-)48 b(use)f(Rice)f(algorithm)g(and)h
(default)e(tile)i(size)191 2921 y(myfile.fit[compress)42
b(GZIP])47 b(-)g(use)g(the)g(specified)e(compression)g(algorithm;)191
3034 y(myfile.fit[compress)d(Rice])238 b(only)46 b(the)h(first)g
(letter)f(of)h(the)g(algorithm)191 3147 y(myfile.fit[compress)42
b(PLIO])238 b(name)46 b(is)i(required.)191 3373 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 3486 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
3833 y Fd(8.7)135 b(HDU)46 b(Lo)t(cation)f(Sp)t(eci\014cation)0
4086 y Fi(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 4199 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 4312 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
4425 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 4538 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 4650 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
4763 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 4876 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
4989 y(b)s(elo)m(w.)0 5149 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
5262 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 5375 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 5488 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 5601 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 5714
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)p eop end
%%Page: 89 95
TeXDict begin 89 94 bop 0 299 a Fg(8.8.)72 b(IMA)m(GE)31
b(SECTION)2835 b Fi(89)0 555 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 668 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 781 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 894 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
1007 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 1167 y(FITS)k(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 1280 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
1393 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 1506 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
1619 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 1732 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 1844 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 1957 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 2070 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
2183 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
2296 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 2409 y(Filter)k(Sp)s(eci\014er)d
(section,)j(b)s(elo)m(w.)0 2569 y(Examples:)143 2811
y Fe(myfile.fits[3])44 b(-)k(open)e(the)h(3rd)g(HDU)g(following)e(the)i
(primary)f(array)143 2924 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
3037 y(myfile.fits[EVENTS])f(-)k(open)g(the)g(extension)e(that)i(has)g
(EXTNAME)e(=)j('EVENTS')143 3150 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 3263 y(myfile.fits[events,2,b])42 b(-)47 b(same,)f(but)h
(also)g(requires)f(XTENSION)f(=)j('BINTABLE')143 3376
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 3489 y(column)f(in)i(the)e(3rd)h
(extension)f(of)h(the)g(file.)143 3602 y(myfile.fits[3;)d
(images\(exposure)g(>)j(100\)])g(-)g(as)g(above,)f(but)h(opens)g(the)f
(image)907 3714 y(in)h(the)g(first)f(row)h(that)g(has)g(an)g
('exposure')e(column)h(value)907 3827 y(greater)g(than)g(100.)0
4158 y Fd(8.8)135 b(Image)46 b(Section)0 4408 y Fi(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
4521 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 4634 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 4747 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 4860 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 4973 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 5086 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 5199 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 5312 y(sp)s(eci\014er.)0 5472 y(Examples:)95
5714 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)p eop end
%%Page: 90 96
TeXDict begin 90 95 bop 0 299 a Fi(90)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)668
555 y Fe(consisting)45 b(of)i(the)g(odd)g(numbered)f(columns)g(\(1st)g
(axis\))h(and)668 668 y(the)g(even)g(numbered)e(rows)i(\(2nd)g(axis\))f
(of)h(the)g(image)f(in)i(the)668 781 y(primary)e(array)g(of)i(the)e
(file.)95 1007 y(myfile.fits[*,)e(512:256])i(-)h(open)g(an)g(image)g
(consisting)e(of)i(all)g(the)g(columns)668 1120 y(in)g(the)g(input)g
(image,)f(but)h(only)f(rows)h(256)g(through)f(512.)668
1233 y(The)h(image)f(will)h(be)g(flipped)f(along)g(the)h(2nd)g(axis)g
(since)668 1346 y(the)g(starting)f(pixel)g(is)h(greater)f(than)h(the)g
(ending)f(pixel.)95 1571 y(myfile.fits[*:2,)e(512:256:2])h(-)i(same)g
(as)g(above)f(but)h(keeping)f(only)668 1684 y(every)h(other)f(row)h
(and)g(column)f(in)h(the)g(input)f(image.)95 1910 y(myfile.fits[-*,)e
(*])j(-)h(copy)e(the)h(entire)f(image,)g(flipping)g(it)h(along)668
2023 y(the)g(first)f(axis.)95 2249 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
2362 y(is)g(in)h(the)e(3rd)h(extension)f(of)h(the)g(file.)95
2588 y(myfile.fits[4;)d(images\(12\)][1:10,1:10])e(-)48
b(open)e(an)h(image)g(consisting)286 2700 y(of)h(the)e(first)h(10)g
(pixels)f(in)h(both)g(dimensions.)e(The)i(original)286
2813 y(image)g(resides)f(in)h(the)g(12th)f(row)h(of)g(the)g('images')f
(vector)286 2926 y(column)g(in)i(the)f(table)f(in)h(the)g(4th)g
(extension)e(of)i(the)g(file.)0 3203 y Fi(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 3315
y(plus)32 b(a)i(cop)m(y)g(of)g(an)m(y)g(other)f(HDUs)h(in)f(the)h
(\014le.)50 b(This)32 b(temp)s(orary)h(\014le)h(is)f(then)g(op)s(ened)g
(b)m(y)g(the)h(application)0 3428 y(program,)28 b(so)g(it)g(is)f(not)h
(p)s(ossible)f(to)h(write)g(to)g(or)g(mo)s(dify)f(the)g(input)g(\014le)
g(when)g(sp)s(ecifying)g(an)h(image)h(section.)0 3541
y(Note)39 b(that)f(CFITSIO)e(automatically)k(up)s(dates)d(the)g(w)m
(orld)h(co)s(ordinate)g(system)g(k)m(eyw)m(ords)f(in)g(the)h(header)0
3654 y(of)33 b(the)h(image)g(section,)h(if)e(they)h(exist,)h(so)e(that)
h(the)f(co)s(ordinate)h(asso)s(ciated)h(with)e(eac)m(h)h(pixel)f(in)g
(the)h(image)0 3767 y(section)e(will)e(b)s(e)g(computed)g(correctly)-8
b(.)0 4120 y Fd(8.9)135 b(Image)46 b(T)-11 b(ransform)45
b(Filters)0 4374 y Fi(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 4487
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 4600 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 4760 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 4873 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 4986 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 5099 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 5212 y(examples)31
b(of)f(image)i(transform)e(\014lters)g(are:)48 5488 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 5601 y([pix)f(sqrt\(X\)])714 b(-)48 b(take)e(the)h(square)f
(root)h(of)g(each)g(pixel)48 5714 y([pix)f(X)i(+)f(#ZEROPT)571
b(-)48 b(add)e(the)h(value)g(of)g(the)g(ZEROPT)f(keyword)p
eop end
%%Page: 91 97
TeXDict begin 91 96 bop 0 299 a Fg(8.9.)72 b(IMA)m(GE)31
b(TRANSF)m(ORM)g(FIL)-8 b(TERS)2237 b Fi(91)48 555 y
Fe([pix)46 b(X>0)h(?)h(log10\(X\))d(:)j(-99.])e(-)i(if)f(the)g(pixel)f
(value)g(is)i(greater)1480 668 y(than)e(0,)h(compute)f(the)h(base)g(10)
g(log,)1480 781 y(else)f(set)h(the)g(pixel)f(=)i(-99.)0
1013 y Fi(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 1126 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 1239 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
1352 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
1465 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 1625
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 1738 y(pixel)c(in)f(curly)g(brac)m(k)m(ets.)
42 b(F)-8 b(or)31 b(example)48 1970 y Fe([pix)94 b(\(x{-1})46
b(+)i(x)f(+)h(x{+1}\))e(/)h(3])0 2202 y Fi(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 2314 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 2427
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 2540 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
2653 y(header)30 b(k)m(eyw)m(ord.)41 b(F)-8 b(or)32 b(example)48
2885 y Fe([pix)46 b(\(x{-#NAXIS1})f(+)i(x)h(+)f(x{#NAXIS1}\))e(/)i(3])0
3117 y Fi(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 3230 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 3343 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 3575 y Fe([pix)47 b(\(X)g(+)h(X{-1})e(+)i
(X{+1})286 3688 y(+)g(X{-#NAXIS1})d(+)i(X{-#NAXIS1)e(-)i(1})h(+)f
(X{-#NAXIS1)e(+)j(1})286 3801 y(+)g(X{#NAXIS1})d(+)i(X{#NAXIS1)f(-)h
(1})g(+)h(X{#NAXIS1)d(+)i(1}\))g(/)h(9.])0 4033 y Fi(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 4145 y(unde\014ned,)28 b(or)j(NULL.)0
4306 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 4419 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 4531 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 4644 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 4757 y(in)m(to)31
b(the)g(\014le.)0 4917 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 5030 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
5262 y Fe(pixb)95 b(-)g(8-bit)46 b(byte)190 b(image)46
b(with)h(BITPIX)f(=)143 b(8)286 5375 y(pixi)95 b(-)47
b(16-bit)f(integer)g(image)g(with)h(BITPIX)f(=)95 b(16)286
5488 y(pixj)g(-)47 b(32-bit)f(integer)g(image)g(with)h(BITPIX)f(=)95
b(32)286 5601 y(pixr)g(-)47 b(32-bit)f(float)142 b(image)46
b(with)h(BITPIX)f(=)i(-32)286 5714 y(pixd)95 b(-)47 b(64-bit)f(float)
142 b(image)46 b(with)h(BITPIX)f(=)i(-64)p eop end
%%Page: 92 98
TeXDict begin 92 97 bop 0 299 a Fi(92)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(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 668 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 781
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 1044 y Fe
(myfile.fits[3][pixr1)90 b(sqrt\(X\)])0 1307 y Fi(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 1420 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
1533 y(the)h('m)m(y\014le.\014ts')g(\014le.)0 1870 y
Fd(8.10)136 b(Column)45 b(and)f(Keyw)l(ord)i(Filtering)g(Sp)t
(eci\014cation)0 2121 y Fi(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 2234 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 2347 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 2460 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 2573 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 2686 y(and)40
b(instead)h(the)g(mo)s(di\014cations)g(are)g(made)f(on)h(a)g(cop)m(y)g
(of)g(the)g(input)f(FITS)g(\014le)g(\(usually)h(in)f(memory\),)0
2799 y(whic)m(h)33 b(also)h(con)m(tains)g(a)f(cop)m(y)h(of)f(all)h(the)
g(other)f(HDUs)h(in)e(the)h(\014le.)49 b(This)33 b(temp)s(orary)f
(\014le)h(is)g(passed)g(to)h(the)0 2912 y(application)f(program)f(and)f
(will)h(p)s(ersist)f(only)h(un)m(til)g(the)g(\014le)g(is)g(closed)h(or)
f(un)m(til)g(the)g(program)f(exits,)j(unless)0 3025 y(the)d(out\014le)f
(sp)s(eci\014er)g(\(see)h(ab)s(o)m(v)m(e\))h(is)f(also)g(supplied.)0
3185 y(The)g(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 3298 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 3561 y Fc(\017)46 b Fi(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
3673 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)227 3786 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 3899 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 4012 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 4125 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
4316 y Fc(\017)46 b Fi(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 4429 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 4542 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 4655 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 4768 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 4881 y(to)d(ignore)g(it.)136
5071 y Fc(\017)46 b Fi(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 5184 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
5375 y Fc(\017)46 b Fi(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 5488 y(optionally)e(follo)m(w)m(ed)g(b)m(y)
e(the)g(datat)m(yp)s(e)h(in)f(paren)m(theses,)i(follo)m(w)m(ed)g(b)m(y)
e(a)h(single)g(equals)f(sign)g(and)g(an)227 5601 y(expression)g(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
5714 y(in)m(teger)k(column)e(called)i('new)m(col')f(\014lled)g(with)f
(zeros\).)62 b(The)37 b(datat)m(yp)s(e)h(is)g(sp)s(eci\014ed)e(using)h
(the)h(same)p eop end
%%Page: 93 99
TeXDict begin 93 98 bop 0 299 a Fg(8.10.)73 b(COLUMN)30
b(AND)h(KEYW)m(ORD)g(FIL)-8 b(TERING)30 b(SPECIFICA)-8
b(TION)1075 b Fi(93)227 555 y(syn)m(tax)28 b(that)h(is)e(allo)m(w)m(ed)
j(for)d(the)h(v)-5 b(alue)28 b(of)g(the)g(FITS)f(TF)m(ORMn)g(k)m(eyw)m
(ord)h(\(e.g.,)i('I',)f('J',)f('E',)g('D',)h(etc.)227
668 y(for)37 b(binary)f(tables,)k(and)c('I8',)k(F12.3',)h('E20.12',)g
(etc.)62 b(for)37 b(ASCI)s(I)e(tables\).)62 b(If)37 b(the)g(datat)m(yp)
s(e)h(is)f(not)227 781 y(sp)s(eci\014ed)24 b(then)f(an)h(appropriate)h
(datat)m(yp)s(e)g(will)f(b)s(e)g(c)m(hosen)g(dep)s(ending)f(on)h(the)g
(form)g(of)g(the)g(expression)227 894 y(\(ma)m(y)f(b)s(e)d(a)i(c)m
(haracter)h(string,)h(logical,)h(bit,)f(long)e(in)m(teger,)j(or)c
(double)g(column\).)38 b(An)21 b(appropriate)g(v)m(ector)227
1007 y(coun)m(t)31 b(\(in)g(the)f(case)i(of)e(binary)g(tables\))h(will)
g(also)g(b)s(e)f(added)g(if)g(not)h(explicitly)h(sp)s(eci\014ed.)227
1156 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 1269 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 1382 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
1495 y(the)29 b(k)m(eyw)m(ord)f(name)g(\(instead)h(of)f(supplying)f(a)h
(datat)m(yp)s(e)h(as)g(in)e(the)i(case)g(of)f(creating)h(a)g(new)f
(column\).)227 1608 y(If)c(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 1720 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
1833 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 1946 y(examples.)136 2131 y Fc(\017)46 b Fi(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 2244
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 2497 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 2610 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
2723 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 2836 y(\014lter)30
b(sp)s(eci\014cation)i(section.)0 2996 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
3109 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 3222 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 3335 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
3447 y(at)f(the)g(end)e(of)i(the)f(list,)i(as)e(sho)m(wn)g(in)g(the)h
(examples.)0 3608 y(F)-8 b(or)30 b(complex)h(or)e(commonly)h(used)f(op)
s(erations,)i(one)e(can)h(also)h(place)g(the)e(op)s(erations)h(in)m(to)
h(an)e(external)i(text)0 3720 y(\014le)g(and)f(imp)s(ort)g(it)h(in)m
(to)h(the)f(column)g(\014lter)f(using)h(the)g(syn)m(tax)g('[col)h
(@\014lename.txt]'.)43 b(The)31 b(op)s(erations)g(can)0
3833 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 3946 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
4059 y(b)s(e)j(used)f(to)i(add)f(commen)m(ts)h(in)m(to)h(the)e(\014le.)
0 4219 y(Examples:)143 4472 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
4585 y(appear)h(in)g(the)g(filtered)e(input)i(file.)143
4811 y([col)g(Time,)f(*raw])667 b(-)47 b(include)f(the)h(Time)g(column)
f(and)h(any)g(other)1670 4924 y(columns)f(whose)h(name)f(ends)h(with)g
('raw'.)143 5149 y([col)g(-TIME;)f(Good)h(==)g(STATUS])141
b(-)47 b(deletes)f(the)h(TIME)g(column)f(and)1670 5262
y(renames)g(the)h(status)f(column)g(to)i('Good')143 5488
y([col)f(PI=PHA)f(*)h(1.1)g(+)h(0.2;)e(#TUNIT#\(column)e(units\))i(=)i
('counts';*])1575 5601 y(-)f(creates)f(new)h(PI)g(column)f(from)h(PHA)g
(values)1670 5714 y(and)g(also)g(writes)f(the)h(TUNITn)f(keyword)p
eop end
%%Page: 94 100
TeXDict begin 94 99 bop 0 299 a Fi(94)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)1670
555 y Fe(for)47 b(the)g(new)g(column.)94 b(The)47 b(final)f('*')1670
668 y(expression)f(means)i(preserve)e(all)i(the)1670
781 y(columns)f(in)h(the)g(input)g(table)f(in)h(the)1670
894 y(virtual)f(output)g(table;)94 b(without)46 b(the)h('*')1670
1007 y(the)g(output)f(table)h(would)f(only)h(contain)1670
1120 y(the)g(single)f('PI')h(column.)143 1346 y([col)g(rate)f(=)i
(rate/exposure;)c(TUNIT#\(&\))h(=)j('counts/s';*])1575
1458 y(-)f(recomputes)e(the)i(rate)g(column)f(by)h(dividing)1670
1571 y(it)h(by)f(the)g(EXPOSURE)e(keyword)h(value.)g(This)1670
1684 y(also)h(modifies)f(the)h(value)f(of)h(the)g(TUNITn)1670
1797 y(keyword)f(for)h(this)g(column.)f(The)h(use)f(of)i(the)1670
1910 y('&')f(character)f(for)h(the)f(keyword)g(comment)1670
2023 y(string)h(means)f(preserve)f(the)i(existing)1670
2136 y(comment)f(string)g(for)h(that)g(keyword.)e(The)1670
2249 y(final)i('*')g(preserves)e(all)i(the)g(columns)1670
2362 y(in)h(the)f(input)f(table)g(in)h(the)g(virtual)1670
2475 y(output)g(table.)0 2816 y Fd(8.11)136 b(Ro)l(w)45
b(Filtering)h(Sp)t(eci\014cation)0 3068 y Fi(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 3181 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
3294 y(on)25 b(the)h(\015y)e(whic)m(h)h(con)m(tains)h(only)g(those)g
(ro)m(ws)f(for)g(whic)m(h)g(the)g(ro)m(w)g(\014lter)h(expression)f(ev)
-5 b(aluates)26 b(to)g(true.)39 b(\(The)0 3407 y(primary)26
b(arra)m(y)h(and)f(an)m(y)g(other)h(extensions)g(in)f(the)h(input)f
(\014le)g(are)h(also)h(copied)f(to)g(the)f(temp)s(orary)h(\014le\).)39
b(The)0 3520 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 3633 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 3745 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
3858 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 3971 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 4084 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 4383 y Fb(8.11.1)113
b(General)38 b(Syn)m(tax)0 4603 y Fi(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 4716 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 4829 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 4942 y(means)30 b(that)h(the)g(ro)m(w)f
(will)h(b)s(e)f(excluded.)0 5102 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
5215 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 5328 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 5441 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 5601 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 5714 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)p eop end
%%Page: 95 101
TeXDict begin 95 100 bop 0 299 a Fg(8.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)30 b(SPECIFICA)-8 b(TION)2027 b Fi(95)0
555 y(initially)38 b(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 668 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
781 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 894 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
1007 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 1120 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 1233 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 1393 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
1506 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 Fi(-3)p Fc(g)p Fi(')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
1619 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 1732
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 1892 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 2005 y(b)s(o)s(olean)g
(op)s(erators)h(are)g(a)m(v)-5 b(ailable:)191 2247 y
Fe("equal")428 b(.eq.)46 b(.EQ.)h(==)95 b("not)46 b(equal")476
b(.ne.)94 b(.NE.)h(!=)191 2360 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 2473 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 2585 y("or")572 b(.or.)46 b(.OR.)h(||)95
b("and")762 b(.and.)46 b(.AND.)h(&&)191 2698 y("negation")236
b(.not.)46 b(.NOT.)h(!)95 b("approx.)45 b(equal\(1e-7\)")92
b(~)0 2940 y Fi(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 3053 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
3166 y(shell)e(to)g(ignore)g(it.)0 3326 y(The)h(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 3439 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 3552 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 3665 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 3907 y Fe("addition")522
b(+)477 b("subtraction")d(-)191 4020 y("multiplication")234
b(*)477 b("division")618 b(/)191 4133 y("negation")522
b(-)477 b("exponentiation")330 b(**)143 b(^)191 4246
y("absolute)45 b(value")237 b(abs\(x\))g("cosine")714
b(cos\(x\))191 4359 y("sine")g(sin\(x\))237 b("tangent")666
b(tan\(x\))191 4472 y("arc)47 b(cosine")427 b(arccos\(x\))93
b("arc)47 b(sine")619 b(arcsin\(x\))191 4585 y("arc)47
b(tangent")379 b(arctan\(x\))93 b("arc)47 b(tangent")475
b(arctan2\(y,x\))191 4698 y("hyperbolic)45 b(cos")237
b(cosh\(x\))189 b("hyperbolic)45 b(sin")333 b(sinh\(x\))191
4811 y("hyperbolic)45 b(tan")237 b(tanh\(x\))189 b("round)46
b(to)h(nearest)f(int")h(round\(x\))191 4924 y("round)f(down)h(to)g
(int")94 b(floor\(x\))141 b("round)46 b(up)h(to)h(int")285
b(ceil\(x\))191 5036 y("exponential")378 b(exp\(x\))237
b("square)46 b(root")476 b(sqrt\(x\))191 5149 y("natural)45
b(log")381 b(log\(x\))237 b("common)46 b(log")524 b(log10\(x\))191
5262 y("modulus")570 b(x)48 b(\045)f(y)286 b("random)46
b(#)h([0.0,1.0\)")141 b(random\(\))191 5375 y("random)46
b(Gaussian")188 b(randomn\(\))93 b("random)46 b(Poisson")332
b(randomp\(x\))191 5488 y("minimum")570 b(min\(x,y\))141
b("maximum")666 b(max\(x,y\))191 5601 y("cumulative)45
b(sum")237 b(accum\(x\))93 b("sequential)45 b(difference")g
(seqdiff\(x\))191 5714 y("if-then-else")330 b(b?x:y)p
eop end
%%Page: 96 102
TeXDict begin 96 101 bop 0 299 a Fi(96)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)191
555 y Fe("angular)45 b(separation")93 b(angsep\(ra1,dec1,ra2,de2\))41
b(\(all)47 b(in)g(degrees\))191 668 y("substring")283
b(strmid\(s,p,n\))44 b("string)i(search")428 b(strstr\(s,r\))0
907 y Fi(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 1020 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 1133 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 1245 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 1358 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 1519 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
1631 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 1744 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
1857 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 1970 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
2083 y(expression.)0 2243 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 2356 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 2469 y(v)m(ector.)0 2629 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 2742
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 2855 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 2968 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 3081 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 3194 y(long)c(as)g(no)f(n)m
(ull)g(v)-5 b(alues)31 b(are)g(presen)m(t.)0 3354 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 3467 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 3580 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
3740 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 3853 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 3966 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 4126
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 4239 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
4352 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 4465 y(functions)30
b(of)g(other)h(columns.)0 4625 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 4738
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 4851 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 5011 y(The)37 b(follo)m(wing)i(t)m(yp)s(e)f
(casting)g(op)s(erators)g(are)g(a)m(v)-5 b(ailable,)42
b(where)37 b(the)h(enclosing)g(paren)m(theses)g(are)g(required)0
5124 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 5362 y Fe("real)46
b(to)h(integer")189 b(\(int\))46 b(x)239 b(\(INT\))46
b(x)764 5475 y("integer)f(to)i(real")190 b(\(float\))46
b(i)143 b(\(FLOAT\))45 b(i)0 5714 y Fi(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:)p eop end
%%Page: 97 103
TeXDict begin 97 102 bop 0 299 a Fg(8.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)30 b(SPECIFICA)-8 b(TION)2027 b Fi(97)382
555 y Fe(#pi)667 b(3.1415...)284 b(#e)620 b(2.7182...)382
668 y(#deg)f(#pi/180)380 b(#row)524 b(current)46 b(row)h(number)382
781 y(#null)428 b(undefined)45 b(value)142 b(#snull)428
b(undefined)45 b(string)0 1040 y Fi(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
1153 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 1266 y(col1"\).)0
1426 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 1539 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 1539 28 4 v 34 w(1)24 b(and)f(v)-5 b(alue)p
2979 1539 V 33 w(2)25 b(can)f(b)s(e)f(in)m(teger)i(or)f(real)0
1652 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 1765
y(also)f(an)g(in)m(teger)g(or)g(real:)955 2023 y Fe(near\(value_1,)44
b(value_2,)h(tolerance\))0 2282 y Fi(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 2395 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
2508 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 2767 y Fe("a)47 b(null)f(value?")667 b(ISNULL\(x\))430
2880 y("define)45 b(a)j(value)e(for)h(null")190 b(DEFNULL\(x,y\))0
3139 y Fi(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 3252 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 3365 y(returns)29 b(the)i(v)-5
b(alue)31 b(of)f(y)-8 b(.)0 3655 y Fb(8.11.2)113 b(Bit)36
b(Masks)0 3874 y Fi(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 3987 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 4246 y Fe(binary:)142 b
(b0110xx1010000101xxxx00)o(01)811 4359 y(octal:)190 b(o720x1)46
b(->)h(\(b111010000xxx001\))811 4471 y(hex:)286 b(h0FxD)94
b(->)47 b(\(b00001111xxxx1101\))0 4730 y Fi(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 4843 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
5003 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 5116 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
5229 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 5488 y Fe(flags)47 b(==)g(b0010011)191 5601 y(or)1336
5714 y(flags)g(.eq.)f(b10011)p eop end
%%Page: 98 104
TeXDict begin 98 103 bop 0 299 a Fi(98)1618 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)0
555 y Fi(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 668 y(than)30 b(equal)h(to)g(a)g(particular)g(b)s(o)s
(olean)f(v)-5 b(alue:)1336 922 y Fe(flags)47 b(<=)g(bxxx010xx)1336
1035 y(flags)g(.gt.)f(bxxx100xx)1336 1148 y(flags)h(.le.)f(b1xxxxxxx)0
1402 y Fi(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 1563 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 1675 y(the)g(second)f(expression)g
(ab)s(o)m(v)m(e.)0 1836 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 1949 y('&'\(AND\),)35
b(')p Fc(j)p Fi('\(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 2061 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 2316 y Fe(\(!flags\))45 b(==)j(b1101100)1241
2429 y(\(flags)e(&)h(b1000001\))f(==)h(bx000001)0 2683
y Fi(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 2796 y(to)s(o.)0
3086 y Fb(8.11.3)113 b(V)-9 b(ector)36 b(Columns)0 3304
y Fi(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 3417 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)0
3530 y(column.)d(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 3643 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 3756
y(though,)f(need)e(to)i(ha)m(v)m(e)g(the)f(same)g(n)m(um)m(b)s(er)f(of)
h(elemen)m(ts)h(and)e(ha)m(v)m(e)j(the)e(same)g(dimensions.)39
b(The)26 b(only)h(places)0 3869 y(a)35 b(v)m(ector)h(column)e(cannot)h
(b)s(e)f(used)f(\(for)i(no)m(w,)g(an)m(yw)m(a)m(y\))h(are)f(the)g(SA)m
(O)f(region)h(functions)f(and)f(the)i(NEAR)0 3982 y(b)s(o)s(olean)30
b(function.)0 4142 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 4255 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 4368 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 4528 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 4782 y Fe("minimum")284
b(MIN\(V\))475 b("maximum")714 b(MAX\(V\))191 4895 y("average")284
b(AVERAGE\(V\))f("median")762 b(MEDIAN\(V\))191 5008
y("summation")188 b(SUM\(V\))475 b("standard)46 b(deviation")188
b(STDDEV\(V\))191 5121 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
5375 y Fi(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 5488 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
5601 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 5714 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\).)p eop end
%%Page: 99 105
TeXDict begin 99 104 bop 0 299 a Fg(8.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)30 b(SPECIFICA)-8 b(TION)2027 b Fi(99)0
555 y(The)32 b(SUM)h(function)f(literally)j(sums)c(all)j(the)f(elemen)m
(ts)h(in)f(x,)g(returning)f(a)h(scalar)h(v)-5 b(alue.)48
b(If)32 b(x)h(is)g(a)g(b)s(o)s(olean)0 668 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
781 y(of)i(elemen)m(ts)h(in)f(v)m(ector)h(x)f(whereas)f(NV)-10
b(ALID)39 b(return)d(the)i(n)m(um)m(b)s(er)f(of)h(non-n)m(ull)f(elemen)
m(ts)j(in)d(the)h(v)m(ector.)0 894 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 1007 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 1120 y(expression)668 1374 y Fe(SUM\()47 b(COL1)f(>)i(COL2)f(\))
g(==)g(NELEM\()f(COL1)h(\))0 1629 y Fi(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 1742 y(COL2.)0
1902 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 2015 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 2128 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 2241 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 2354 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 2466
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 2579 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 2692 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 2805 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 2918 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 3031
y(with)d($ARRA)-8 b(Y-4D$[1,2,3,4].)0 3191 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
3304 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 3417 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 3530
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 3643 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].)0 3803
y(V)g(ariable-length)33 b(v)m(ector)f(columns)e(are)g(not)h(supp)s
(orted.)0 3963 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 4076 y(surrounded)35 b(b)m(y)j(curly)g
(braces)h(\(')p Fc(fg)p Fi('\).)66 b(F)-8 b(or)38 b(example,)j(')p
Fc(f)p Fi(1,3,6,1)p Fc(g)p Fi(')h(is)d(a)f(4-elemen)m(t)i(v)m(ector)g
(con)m(taining)g(the)0 4189 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
4302 y(The)e(elemen)m(ts)h(will)g(b)s(e)f(promoted)g(to)h(the)g
(highest)f(datat)m(yp)s(e)h(presen)m(t.)39 b(An)m(y)24
b(elemen)m(ts)i(whic)m(h)e(are)h(themselv)m(es)0 4415
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 4528 y(v)m(ector.)0 4818 y Fb(8.11.4)113
b(Go)s(o)s(d)38 b(Time)g(In)m(terv)-6 b(al)37 b(Filtering)0
5036 y Fi(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 5149 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 5262 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 5375 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 5488 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
5601 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 5714 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)p eop end
%%Page: 100 106
TeXDict begin 100 105 bop 0 299 a Fi(100)1573 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)286
555 y Fe(gtifilter\()45 b([)j("gtifile")d([,)i(expr)g([,)g("STARTCOL",)
e("STOPCOL")g(])j(])f(])g(\))0 799 y Fi(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
912 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 1024 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 1137 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
1250 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 1363 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
1476 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 1589 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 1702 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
1815 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 1928 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
2041 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 2154 y(is)i(sp)s(eci\014ed,)g(they)h(b)s
(oth)f(m)m(ust)g(b)s(e.)0 2314 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
2427 y("gti\014lter\(\)")33 b(is)e(equiv)-5 b(alen)m(t)31
b(to)334 2670 y Fe(gtifilter\()45 b("",)i(TIME,)f("*START*",)f
("*STOP*")h(\))0 2913 y Fi(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 3026 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 3139
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
3252 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 3365 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)0
3478 y(TIMEZER)m(O/I/F)g(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 3591 y(necessary)-8 b(.)0 3879 y Fb(8.11.5)113
b(Spatial)38 b(Region)g(Filtering)0 4098 y Fi(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 4211 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 4324 y(is)334 4567 y Fe(regfilter\()45
b("regfilename")f([)k(,)f(Xexpr,)f(Yexpr)h([)g(,)h("wcs)e(cols")h(])g
(])g(\))0 4811 y Fi(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 4924 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
5036 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 5149 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 5262
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 5375 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 5488 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 5601 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 5714 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)p eop end
%%Page: 101 107
TeXDict begin 101 106 bop 0 299 a Fg(8.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)30 b(SPECIFICA)-8 b(TION)1982 b Fi(101)0
555 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 668 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 781 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 1039 y Fe(regfilter\("region.reg",)41 b(XPOS,)47
b(YPOS\))0 1297 y Fi(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 1410 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
1523 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 1636 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
1749 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 1862 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 1975 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 2088 y(to)j(calculate)i(the)d
(co)s(ordinate.)0 2248 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 2361 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 2474 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 2587
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 2700 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
2812 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 2925 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
3038 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 3296 y Fe(regfilter\("rosat.reg",)42
b(X/32.+.5,)j(Y/32.+.5\))0 3555 y Fi(Note)h(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 3668 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 3780 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 3893 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
4054 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 4166 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 4279 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 4392 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 4552 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
4811 y Fe(Point)428 b(\()48 b(X1,)f(Y1)g(\))715 b(<-)48
b(One)f(pixel)f(square)g(region)334 4924 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 5036 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 5149 y(Rectangle)236
b(\()48 b(X1,)f(Y1,)g(X2,)f(Y2,)h(A)h(\))334 b(|)47 b(boundaries)e
(considered)334 5262 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 5375 y(Diamond)332
b(\()48 b(Xc,)f(Yc,)g(Wdth,)f(Hght,)g(A)i(\))334 5488
y(Circle)380 b(\()48 b(Xc,)f(Yc,)g(R)g(\))334 5601 y(Annulus)332
b(\()48 b(Xc,)f(Yc,)g(Rin,)f(Rout)h(\))334 5714 y(Ellipse)332
b(\()48 b(Xc,)f(Yc,)g(Rx,)f(Ry,)h(A)h(\))p eop end
%%Page: 102 108
TeXDict begin 102 107 bop 0 299 a Fi(102)1573 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)334
555 y Fe(Elliptannulus)44 b(\()k(Xc,)f(Yc,)g(Rinx,)f(Riny,)g(Routx,)g
(Routy,)g(Ain,)h(Aout)g(\))334 668 y(Sector)380 b(\()48
b(Xc,)f(Yc,)g(Amin,)f(Amax)h(\))0 1111 y Fi(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 1224 y(edges;)36 b(Rxxx)d(are)h(the)f(shap)s(es')g(v)-5
b(arious)34 b(Radii)f(or)h(semi-ma)5 b(jor/minor)34 b(axes;)i(and)d
(Axxx)g(are)h(the)f(angles)i(of)0 1337 y(rotation)e(\(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
1450 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 1563 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 1676 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 1789 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
1902 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 2015 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
2128 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 2240 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 2353 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
2514 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 2626 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
2739 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 2900 y(There)37 b(are)g(three)g(functions)g(that)g
(are)h(primarily)f(for)f(use)h(with)g(SA)m(O)g(region)g(\014les)g(and)g
(the)g(FSA)m(OI)g(task,)0 3012 y(but)e(they)h(can)h(b)s(e)e(used)g
(directly)-8 b(.)59 b(They)36 b(return)f(a)h(b)s(o)s(olean)g(true)g(or)
g(false)g(dep)s(ending)f(on)h(whether)f(a)i(t)m(w)m(o)0
3125 y(dimensional)31 b(p)s(oin)m(t)f(is)g(in)g(the)h(region)g(or)f
(not:)191 3569 y Fe("point)46 b(in)h(a)h(circular)d(region")477
3681 y(circle\(xcntr,ycntr,radius)o(,Xco)o(lumn)o(,Yc)o(olum)o(n\))191
3907 y("point)h(in)h(an)g(elliptical)e(region")430 4020
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 4246 y("point)h(in)h(a)h
(rectangular)c(region")620 4359 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
4585 y(where)334 4698 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
4811 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 4924 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
5036 y(\(radius\))f(is)h(half)f(the)h(diameter)f(of)h(the)g(circle)334
5149 y(\(rotation\))e(is)i(the)g(angle\(degrees\))d(that)j(the)g
(region)f(is)h(rotated)f(with)620 5262 y(respect)g(to)h
(\(xcntr,ycntr\))334 5375 y(\(Xcoord,Ycoord\))d(are)j(the)g(\(x,y\))f
(coordinates)f(to)i(test,)f(usually)g(column)620 5488
y(names)334 5601 y(NOTE:)g(each)h(parameter)e(can)i(itself)f(be)i(an)f
(expression,)d(not)j(merely)f(a)620 5714 y(column)h(name)f(or)h
(constant.)p eop end
%%Page: 103 109
TeXDict begin 103 108 bop 0 299 a Fg(8.11.)73 b(R)m(O)m(W)31
b(FIL)-8 b(TERING)30 b(SPECIFICA)-8 b(TION)1982 b Fi(103)0
555 y Fb(8.11.6)113 b(Example)38 b(Ro)m(w)f(Filters)191
859 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 972
y(than)94 b(fifth)47 b(magnitude)e(\(note)h(that)1766
1085 y(the)h(initial)f(space)g(is)h(necessary)e(to)1766
1197 y(prevent)h(it)h(from)g(being)f(treated)g(as)h(a)1766
1310 y(binning)f(specification\))191 1536 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 1762 y([IMAGE[4,5])f(.gt.)h(100])476 b(-)48
b(Extract)e(all)h(rows)f(that)h(have)g(the)1766 1875
y(\(4,5\))f(component)g(of)h(the)g(IMAGE)f(column)1766
1988 y(greater)g(than)g(100)191 2214 y([abs\(sin\(theta)e(*)j(#deg\)\))
f(<)i(0.5])e(-)i(Extract)e(all)h(rows)f(having)g(the)1766
2327 y(absolute)f(value)i(of)g(the)g(sine)g(of)g(theta)1766
2439 y(less)94 b(than)47 b(a)g(half)g(where)f(the)h(angles)1766
2552 y(are)g(tabulated)e(in)i(degrees)191 2778 y([SUM\()f(SPEC)h(>)g
(3*BACKGRND)e(\)>=1])94 b(-)48 b(Extract)e(all)h(rows)f(containing)f(a)
1766 2891 y(spectrum,)g(held)i(in)g(vector)f(column)1766
3004 y(SPEC,)g(with)h(at)g(least)f(one)h(value)g(3)1766
3117 y(times)f(greater)g(than)h(the)g(background)1766
3230 y(level)f(held)h(in)g(a)h(keyword,)d(BACKGRND)191
3456 y([VCOL=={1,4,2}])759 b(-)48 b(Extract)e(all)h(rows)f(whose)h
(vector)f(column)1766 3569 y(VCOL)h(contains)e(the)i(3-elements)e(1,)i
(4,)g(and)1766 3681 y(2.)191 3907 y([@rowFilter.txt])711
b(-)48 b(Extract)e(rows)g(using)h(the)g(expression)1766
4020 y(contained)e(within)h(the)h(text)g(file)1766 4133
y(rowFilter.txt)191 4359 y([gtifilter\(\)])855 b(-)48
b(Search)e(the)h(current)f(file)g(for)h(a)h(GTI)239 4472
y(extension,)92 b(filter)i(the)47 b(TIME)239 4585 y(column)f(in)h(the)g
(current)f(table,)g(using)239 4698 y(START/STOP)f(times)h(taken)g(from)
239 4811 y(columns)f(in)j(the)f(GTI)94 b(extension)191
5036 y([regfilter\("pow.reg"\)])423 b(-)48 b(Extract)e(rows)g(which)h
(have)f(a)i(coordinate)1766 5149 y(\(as)f(given)f(in)h(the)g(X)h(and)f
(Y)g(columns\))1766 5262 y(within)f(the)h(spatial)f(region)g(specified)
1766 5375 y(in)h(the)g(pow.reg)f(region)g(file.)191 5601
y([regfilter\("pow.reg",)c(Xs,)47 b(Ys\)])f(-)i(Same)f(as)g(above,)f
(except)g(that)h(the)1766 5714 y(Xs)g(and)g(Ys)g(columns)f(will)h(be)g
(used)f(to)p eop end
%%Page: 104 110
TeXDict begin 104 109 bop 0 299 a Fi(104)1573 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)1766
555 y Fe(determine)45 b(the)i(coordinate)e(of)i(each)1766
668 y(row)g(in)g(the)g(table.)0 1001 y Fd(8.12)180 b(Binning)45
b(or)g(Histogramming)i(Sp)t(eci\014cation)0 1252 y Fi(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 1365 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 1477 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
1590 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 1703 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 1816 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 1929 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
2042 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 2155 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
2315 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 2428 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
2541 y(precision)d(\015oating)h(p)s(oin)m(t\))g(to)f(the)h('bin')e(k)m
(eyw)m(ord)i(\(e.g.)41 b('[binr)28 b(X]')g(creates)i(a)e(real)h
(\015oating)g(p)s(oin)m(t)f(image\).)41 b(If)0 2654 y(the)26
b(datat)m(yp)s(e)h(is)f(not)g(explicitly)i(sp)s(eci\014ed)d(then)h(a)g
(32-bit)h(in)m(teger)h(image)f(will)f(b)s(e)f(created)i(b)m(y)f
(default,)i(unless)0 2767 y(the)h(w)m(eigh)m(ting)h(option)f(is)g(also)
h(sp)s(eci\014ed)e(in)g(whic)m(h)h(case)g(the)g(image)h(will)f(ha)m(v)m
(e)h(a)f(32-bit)h(\015oating)g(p)s(oin)m(t)e(data)0 2880
y(t)m(yp)s(e)j(b)m(y)f(default.)0 3040 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
3153 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 3410
y Fe([bin{bijrd})92 b(Xcol=min:max:binsize,)42 b(Ycol=)47
b(...,)f(Zcol=...,)f(Tcol=...;)h(weight])0 3668 y Fi(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 3781 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)0 3894 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
4007 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 4120 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 4233 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 4346 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 4506 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 4619 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
4731 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 4844 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
4957 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 5117 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
5230 y(binning)29 b(expression)h(as)h(sho)m(wn)f(in)g(these)h
(examples:)191 5488 y Fe([bin)47 b(x)g(=)g(:512:2])94
b(-)47 b(use)g(default)f(minimum)g(value)191 5601 y([bin)h(x)g(=)g
(1::2])190 b(-)47 b(use)g(default)f(maximum)g(value)191
5714 y([bin)h(x)g(=)g(1:512])142 b(-)47 b(use)g(default)f(bin)h(size)p
eop end
%%Page: 105 111
TeXDict begin 105 110 bop 0 299 a Fg(8.12.)113 b(BINNING)31
b(OR)f(HISTOGRAMMING)h(SPECIFICA)-8 b(TION)1268 b Fi(105)191
555 y Fe([bin)47 b(x)g(=)g(1:])286 b(-)47 b(use)g(default)f(maximum)g
(value)g(and)h(bin)g(size)191 668 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
781 y([bin)g(x)g(=)g(2])334 b(-)47 b(use)g(default)f(minimum)g(and)h
(maximum)f(values)191 894 y([bin)h(x])524 b(-)47 b(use)g(default)f
(minimum,)g(maximum)g(and)g(bin)h(size)191 1007 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 1120 y([bin])619 b(-)47 b(default)f(2-D)h(image)0
1374 y Fi(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 1487 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 1600 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 1713 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 1826 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 1986 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 2099 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 2212 y(sp)s(eci\014cation,)d(as)g(in:)191
2466 y Fe([bin)47 b(\(X,Y\)=1:512:2])191 2579 y([bin)g(\(X,Y\))f(=)h
(5])0 2834 y Fi(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 2947 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
3059 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 3172 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 3285 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
3398 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 3511 y(basis,)i(will)h(b)s(e)f
(used.)0 3671 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 3784 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
3897 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.)0
4057 y(F)-8 b(or)35 b(complex)f(or)g(commonly)g(used)f(histograms,)j
(one)e(can)g(also)h(place)g(its)f(description)g(in)m(to)h(a)f(text)h
(\014le)f(and)0 4170 y(imp)s(ort)44 b(it)g(in)m(to)i(the)e(binning)f
(sp)s(eci\014cation)i(using)f(the)h(syn)m(tax)f('[bin)g
(@\014lename.txt]'.)84 b(The)44 b(\014le's)g(con-)0 4283
y(ten)m(ts)37 b(can)e(extend)h(o)m(v)m(er)h(m)m(ultiple)f(lines,)i
(although)e(it)g(m)m(ust)f(still)i(conform)f(to)g(the)g(no-spaces)g
(rule)f(for)h(the)0 4396 y(min:max:binsize)h(syn)m(tax)h(and)e(eac)m(h)
i(axis)g(sp)s(eci\014cation)g(m)m(ust)f(still)g(b)s(e)g
(comma-separated.)62 b(An)m(y)37 b(lines)g(in)0 4509
y(the)32 b(external)h(text)g(\014le)f(that)h(b)s(egin)e(with)h(2)g
(slash)g(c)m(haracters)h(\('//'\))h(will)e(b)s(e)g(ignored)g(and)f(ma)m
(y)i(b)s(e)e(used)g(to)0 4622 y(add)f(commen)m(ts)h(in)m(to)g(the)g
(\014le.)0 4782 y(Examples:)191 5036 y Fe([bini)46 b(detx,)h(dety])762
b(-)47 b(2-D,)g(16-bit)f(integer)g(histogram)1861 5149
y(of)i(DETX)e(and)h(DETY)g(columns,)e(using)1861 5262
y(default)h(values)g(for)h(the)g(histogram)1861 5375
y(range)g(and)g(binsize)191 5601 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
5714 y(and)g(DETY)g(columns)f(with)g(a)i(bin)f(size)f(=)i(16)p
eop end
%%Page: 106 112
TeXDict begin 106 111 bop 0 299 a Fi(106)1573 b Fg(CHAPTER)30
b(8.)112 b(EXTENDED)30 b(FILE)h(NAME)f(SYNT)-8 b(AX)1861
555 y Fe(in)48 b(both)e(axes.)h(The)f(histogram)g(values)1861
668 y(are)h(divided)f(by)h(the)g(EXPOSURE)f(keyword)1861
781 y(value.)191 1007 y([bin)h(time=TSTART:TSTOP:0.1])280
b(-)47 b(1-D)g(lightcurve,)e(range)h(determined)f(by)1861
1120 y(the)i(TSTART)f(and)h(TSTOP)g(keywords,)1861 1233
y(with)g(0.1)g(unit)g(size)f(bins.)191 1458 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 1571 y(of)i(the)e(PHA)h(column)f(for)h(the)g(X)h(axis,)
1861 1684 y(and)f(1000)g(bins)g(in)g(the)g(range)1861
1797 y(8000.)g(to)g(8100.)f(for)h(the)g(Y)h(axis.)191
2023 y([bin)f(@binFilter.txt])616 b(-)47 b(Use)g(the)g(contents)f(of)h
(the)g(text)f(file)1861 2136 y(binFilter.txt)f(for)h(the)h(binning)1861
2249 y(specifications.)p eop end
%%Page: 107 113
TeXDict begin 107 112 bop 0 1225 a Ff(Chapter)65 b(9)0
1687 y Fl(T)-19 b(emplate)76 b(Files)0 2180 y Fi(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 Fd(9.1)135 b(Detailed)47 b(T)-11
b(emplate)46 b(Line)f(F)-11 b(ormat)0 3438 y Fi(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 Fi(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(107)p eop end
%%Page: 108 114
TeXDict begin 108 113 bop 0 299 a Fi(108)2295 b Fg(CHAPTER)30
b(9.)71 b(TEMPLA)-8 b(TE)30 b(FILES)0 555 y Fi(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 Fi(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 Fd(9.2)135 b(Auto-indexing)45 b(of)h(Keyw)l(ords)0
3623 y Fi(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 Fi(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: 109 115
TeXDict begin 109 114 bop 0 299 a Fg(9.3.)72 b(TEMPLA)-8
b(TE)30 b(P)-8 b(ARSER)30 b(DIRECTIVES)2028 b Fi(109)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 Fd(9.3)135
b(T)-11 b(emplate)46 b(P)l(arser)g(Directiv)l(es)0 1251
y Fi(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 Fi(,)29 b(and)48 1476
y Fe(\\end)p Fi(.)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 Fi(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 Fi(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 Fd(9.4)135 b(F)-11
b(ormal)46 b(T)-11 b(emplate)45 b(Syn)l(tax)0 5350 y
Fi(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: 110 116
TeXDict begin 110 115 bop 0 299 a Fi(110)2295 b Fg(CHAPTER)30
b(9.)71 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 Fi(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 Fd(9.5)135 b(Errors)0 2745 y Fi(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 Fd(9.6)135
b(Examples)0 3667 y Fi(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 Fi(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: 111 117
TeXDict begin 111 116 bop 0 299 a Fg(9.6.)72 b(EXAMPLES)3039
b Fi(111)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 Fi(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: 112 118
TeXDict begin 112 117 bop 0 299 a Fi(112)2295 b Fg(CHAPTER)30
b(9.)71 b(TEMPLA)-8 b(TE)30 b(FILES)p eop end
%%Page: 113 119
TeXDict begin 113 118 bop 0 1225 a Ff(Chapter)65 b(10)0
1687 y Fl(Summary)76 b(of)i(all)f(FITSIO)0 1937 y(User-In)-6
b(terface)77 b(Subroutines)0 2429 y Fi(Error)29 b(Status)i(Routines)f
(page)h(29)382 2696 y Fe(FTVERS\()46 b(>)h(version\))382
2809 y(FTGERR\(status,)d(>)j(errtext\))382 2922 y(FTGMSG\()f(>)h
(errmsg\))382 3035 y(FTRPRT)f(\(stream,)f(>)j(status\))382
3147 y(FTPMSG\(errmsg\))382 3260 y(FTPMRK)382 3373 y(FTCMSG)382
3486 y(FTCMRK)0 3753 y Fi(FITS)30 b(File)h(Op)s(en)e(and)h(Close)h
(Subroutines:)39 b(page)31 b(35)382 4020 y Fe
(FTOPEN\(unit,filename,rwm)o(ode)o(,)42 b(>)47 b(blocksize,status\))382
4133 y(FTDKOPEN\(unit,filename,r)o(wmo)o(de,)41 b(>)48
b(blocksize,status\))382 4246 y(FTNOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 4359 y(FTDOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 4472 y(FTTOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 4585 y(FTIOPN\(unit,filename,rwm)o(ode)o(,)42
b(>)47 b(status\))382 4698 y(FTREOPEN\(unit,)d(>)j(newunit,)f(status\))
382 4811 y(FTINIT\(unit,filename,blo)o(cks)o(ize,)41
b(>)48 b(status\))382 4924 y(FTDKINIT\(unit,filename,b)o(loc)o(ksiz)o
(e,)42 b(>)47 b(status\))382 5036 y(FTTPLT\(unit,)d(filename,)i
(tplfilename,)e(>)j(status\))382 5149 y(FTFLUS\(unit,)d(>)k(status\))
382 5262 y(FTCLOS\(unit,)c(>)k(status\))382 5375 y(FTDELT\(unit,)c(>)k
(status\))382 5488 y(FTGIOU\()e(>)h(iounit,)f(status\))382
5601 y(FTFIOU\(iounit,)e(>)j(status\))0 5714 y(CFITS2Unit\(fitsfile)c
(*ptr\))141 b(\(C)48 b(routine\))1882 5942 y Fi(113)p
eop end
%%Page: 114 120
TeXDict begin 114 119 bop 0 299 a Fi(114)281 b Fg(CHAPTER)30
b(10.)112 b(SUMMAR)-8 b(Y)32 b(OF)e(ALL)g(FITSIO)f(USER-INTERF)-10
b(A)m(CE)30 b(SUBR)m(OUTINES)382 555 y Fe(CUnit2FITS\(int)44
b(unit\))380 b(\(C)47 b(routine\))382 668 y(FTEXTN\(filename,)c(>)48
b(nhdu,)e(status\))382 781 y(FTFLNM\(unit,)e(>)k(filename,)d(status\))
382 894 y(FTFLMD\(unit,)f(>)k(iomode,)e(status\))382
1007 y(FFURLT\(unit,)e(>)k(urltype,)d(status\))382 1120
y(FTIURL\(filename,)e(>)48 b(filetype,)d(infile,)h(outfile,)f(extspec,)
h(filter,)716 1233 y(binspec,)f(colspec,)h(status\))382
1346 y(FTRTNM\(filename,)d(>)48 b(rootname,)d(status\))382
1458 y(FTEXIST\(filename,)e(>)k(exist,)f(status\))0 1695
y Fi(HDU-Lev)m(el)33 b(Op)s(erations:)40 b(page)31 b(38)382
1932 y Fe(FTMAHD\(unit,nhdu,)43 b(>)k(hdutype,status\))382
2045 y(FTMRHD\(unit,nmove,)c(>)k(hdutype,status\))382
2158 y(FTGHDN\(unit,)d(>)k(nhdu\))382 2271 y(FTMNHD\(unit,)c(hdutype,)i
(extname,)f(extver,)h(>)i(status\))382 2384 y(FTGHDT\(unit,)c(>)k
(hdutype,)d(status\))382 2497 y(FTTHDU\(unit,)f(>)k(hdunum,)e(status\))
382 2610 y(FTCRHD\(unit,)e(>)k(status\))382 2723 y
(FTIIMG\(unit,bitpix,naxis)o(,na)o(xes,)41 b(>)48 b(status\))382
2836 y(FTITAB\(unit,rowlen,nrows)o(,tf)o(ield)o(s,tt)o(ype)o(,tbc)o
(ol,t)o(for)o(m,tu)o(nit,)o(ext)o(name)o(,)42 b(>)716
2949 y(status\))382 3061 y(FTIBIN\(unit,nrows,tfield)o(s,t)o(type)o
(,tfo)o(rm,)o(tuni)o(t,ex)o(tna)o(me,v)o(arid)o(at)f(>)48
b(status\))382 3174 y(FTRSIM\(unit,bitpix,naxis)o(,na)o(xes,)o(stat)o
(us\))382 3287 y(FTDHDU\(unit,)c(>)k(hdutype,status\))382
3400 y(FTCPFL\(iunit,ounit,previ)o(ous)o(,)42 b(current,)j(following,)g
(>)j(status\))382 3513 y(FTCOPY\(iunit,ounit,morek)o(eys)o(,)42
b(>)47 b(status\))382 3626 y(FTCPHD\(inunit,)d(outunit,)h(>)j(status\))
382 3739 y(FTCPDT\(iunit,ounit,)42 b(>)48 b(status\))0
3976 y Fi(Subroutines)29 b(to)i(sp)s(ecify)f(or)g(mo)s(dify)g(the)g
(structure)g(of)h(the)f(CHDU:)h(page)h(41)382 4213 y
Fe(FTRDEF\(unit,)44 b(>)k(status\))93 b(\(DEPRECATED\))382
4326 y(FTPDEF\(unit,bitpix,naxis)o(,na)o(xes,)o(pcou)o(nt,)o(gcou)o
(nt,)41 b(>)48 b(status\))93 b(\(DEPRECATED\))382 4439
y(FTADEF\(unit,rowlen,tfiel)o(ds,)o(tbco)o(l,tf)o(orm)o(,nro)o(ws)42
b(>)47 b(status\))94 b(\(DEPRECATED\))382 4551 y
(FTBDEF\(unit,tfields,tfor)o(m,v)o(arid)o(at,n)o(row)o(s)42
b(>)47 b(status\))94 b(\(DEPRECATED\))382 4664 y(FTDDEF\(unit,bytlen,)
42 b(>)48 b(status\))93 b(\(DEPRECATED\))382 4777 y
(FTPTHP\(unit,theap,)43 b(>)k(status\))0 5014 y Fi(Header)31
b(Space)f(and)g(P)m(osition)i(Subroutines:)39 b(page)31
b(43)382 5251 y Fe(FTHDEF\(unit,morekeys,)42 b(>)47 b(status\))382
5364 y(FTGHSP\(iunit,)d(>)j(keysexist,keysadd,status\))382
5477 y(FTGHPS\(iunit,)d(>)j(keysexist,key_no,status\))0
5714 y Fi(Read)31 b(or)f(W)-8 b(rite)32 b(Standard)d(Header)i
(Subroutines:)39 b(page)31 b(43)p eop end
%%Page: 115 121
TeXDict begin 115 120 bop 3764 299 a Fi(115)382 555 y
Fe(FTPHPS\(unit,bitpix,naxis)o(,na)o(xes,)41 b(>)48 b(status\))382
668 y(FTPHPR\(unit,simple,bitpi)o(x,n)o(axis)o(,nax)o(es,)o(pcou)o
(nt,g)o(cou)o(nt,e)o(xten)o(d,)41 b(>)48 b(status\))382
781 y(FTGHPR\(unit,maxdim,)42 b(>)48 b(simple,bitpix,naxis,naxe)o(s,p)o
(coun)o(t,gc)o(oun)o(t,ex)o(tend)o(,)716 894 y(status\))382
1007 y(FTPHTB\(unit,rowlen,nrows)o(,tf)o(ield)o(s,tt)o(ype)o(,tbc)o
(ol,t)o(for)o(m,tu)o(nit,)o(ext)o(name)o(,)42 b(>)716
1120 y(status\))382 1233 y(FTGHTB\(unit,maxdim,)g(>)48
b(rowlen,nrows,tfields,tty)o(pe,)o(tbco)o(l,tf)o(orm)o(,tun)o(it,)716
1346 y(extname,status\))382 1458 y(FTPHBN\(unit,nrows,tfield)o(s,t)o
(type)o(,tfo)o(rm,)o(tuni)o(t,ex)o(tna)o(me,v)o(arid)o(at)41
b(>)48 b(status\))382 1571 y(FTGHBN\(unit,maxdim,)42
b(>)48 b(nrows,tfields,ttype,tfor)o(m,t)o(unit)o(,ext)o(nam)o(e,va)o
(rida)o(t,)716 1684 y(status\))0 1942 y Fi(W)-8 b(rite)32
b(Keyw)m(ord)e(Subroutines:)39 b(page)31 b(45)382 2199
y Fe(FTPREC\(unit,card,)43 b(>)k(status\))382 2312 y
(FTPCOM\(unit,comment,)42 b(>)48 b(status\))382 2425
y(FTPHIS\(unit,history,)42 b(>)48 b(status\))382 2538
y(FTPDAT\(unit,)c(>)k(status\))382 2651 y(FTPKY[JKLS]\(unit,keyword)o
(,ke)o(yval)o(,com)o(men)o(t,)42 b(>)47 b(status\))382
2764 y(FTPKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o
(omme)o(nt,)41 b(>)48 b(status\))382 2877 y(FTPKLS\(unit,keyword,keyv)o
(al,)o(comm)o(ent,)41 b(>)47 b(status\))382 2990 y(FTPLSW\(unit,)d(>)k
(status\))382 3103 y(FTPKYU\(unit,keyword,comm)o(ent)o(,)42
b(>)47 b(status\))382 3216 y(FTPKN[JKLS]\(unit,keyroot)o(,st)o(artn)o
(o,no)o(_ke)o(ys,k)o(eyva)o(ls,)o(comm)o(ents)o(,)42
b(>)47 b(status\))382 3329 y(FTPKN[EDFG]\(unit,keyroot)o(,st)o(artn)o
(o,no)o(_ke)o(ys,k)o(eyva)o(ls,)o(deci)o(mals)o(,co)o(mmen)o(ts,)41
b(>)907 3441 y(status\))382 3554 y(FTCPKYinunit,)j(outunit,)i(innum,)g
(outnum,)f(keyroot,)h(>)h(status\))382 3667 y
(FTPKYT\(unit,keyword,intv)o(al,)o(dblv)o(al,c)o(omm)o(ent,)41
b(>)48 b(status\))382 3780 y(FTPKTP\(unit,)c(filename,)i(>)h(status\))
382 3893 y(FTPUNT\(unit,keyword,unit)o(s,)41 b(>)48 b(status\))0
4151 y Fi(Insert)30 b(Keyw)m(ord)g(Subroutines:)39 b(page)31
b(47)382 4408 y Fe(FTIREC\(unit,key_no,card,)41 b(>)47
b(status\))382 4521 y(FTIKY[JKLS]\(unit,keyword)o(,ke)o(yval)o(,com)o
(men)o(t,)42 b(>)47 b(status\))382 4634 y(FTIKLS\(unit,keyword,keyv)o
(al,)o(comm)o(ent,)41 b(>)47 b(status\))382 4747 y
(FTIKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o(ima)o(ls,c)o(omme)o
(nt,)41 b(>)48 b(status\))382 4860 y(FTIKYU\(unit,keyword,comm)o(ent)o
(,)42 b(>)47 b(status\))0 5118 y Fi(Read)31 b(Keyw)m(ord)f
(Subroutines:)39 b(page)31 b(47)382 5375 y Fe(FTGREC\(unit,key_no,)42
b(>)48 b(card,status\))382 5488 y(FTGKYN\(unit,key_no,)42
b(>)48 b(keyword,value,comment,st)o(atu)o(s\))382 5601
y(FTGCRD\(unit,keyword,)42 b(>)48 b(card,status\))382
5714 y(FTGNXK\(unit,inclist,ninc)o(,ex)o(clis)o(t,ne)o(xc,)41
b(>)48 b(card,status\))p eop end
%%Page: 116 122
TeXDict begin 116 121 bop 0 299 a Fi(116)281 b Fg(CHAPTER)30
b(10.)112 b(SUMMAR)-8 b(Y)32 b(OF)e(ALL)g(FITSIO)f(USER-INTERF)-10
b(A)m(CE)30 b(SUBR)m(OUTINES)382 555 y Fe(FTGKEY\(unit,keyword,)42
b(>)48 b(value,comment,status\))382 668 y(FTGKY[EDJKLS]\(unit,keywo)o
(rd,)41 b(>)48 b(keyval,comment,status\))382 781 y
(FTGKN[EDJKLS]\(unit,keyro)o(ot,)o(star)o(tno,)o(max)o(_key)o(s,)42
b(>)47 b(keyvals,nfound,status\))382 894 y(FTGKYT\(unit,keyword,)42
b(>)48 b(intval,dblval,comment,s)o(tat)o(us\))382 1007
y(FTGUNT\(unit,keyword,)42 b(>)48 b(units,status\))0
1263 y Fi(Mo)s(dify)30 b(Keyw)m(ord)g(Subroutines:)39
b(page)31 b(49)382 1519 y Fe(FTMREC\(unit,key_no,card,)41
b(>)47 b(status\))382 1632 y(FTMCRD\(unit,keyword,card)o(,)42
b(>)47 b(status\))382 1745 y(FTMNAM\(unit,oldkey,keywo)o(rd,)41
b(>)48 b(status\))382 1858 y(FTMCOM\(unit,keyword,comm)o(ent)o(,)42
b(>)47 b(status\))382 1971 y(FTMKY[JKLS]\(unit,keyword)o(,ke)o(yval)o
(,com)o(men)o(t,)42 b(>)47 b(status\))382 2084 y
(FTMKLS\(unit,keyword,keyv)o(al,)o(comm)o(ent,)41 b(>)47
b(status\))382 2197 y(FTMKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o
(ima)o(ls,c)o(omme)o(nt,)41 b(>)48 b(status\))382 2310
y(FTMKYU\(unit,keyword,comm)o(ent)o(,)42 b(>)47 b(status\))0
2566 y Fi(Up)s(date)30 b(Keyw)m(ord)g(Subroutines:)39
b(page)32 b(50)382 2822 y Fe(FTUCRD\(unit,keyword,card)o(,)42
b(>)47 b(status\))382 2935 y(FTUKY[JKLS]\(unit,keyword)o(,ke)o(yval)o
(,com)o(men)o(t,)42 b(>)47 b(status\))382 3048 y
(FTUKLS\(unit,keyword,keyv)o(al,)o(comm)o(ent,)41 b(>)47
b(status\))382 3161 y(FTUKY[EDFG]\(unit,keyword)o(,ke)o(yval)o(,dec)o
(ima)o(ls,c)o(omme)o(nt,)41 b(>)48 b(status\))382 3274
y(FTUKYU\(unit,keyword,comm)o(ent)o(,)42 b(>)47 b(status\))0
3530 y Fi(Delete)33 b(Keyw)m(ord)d(Subroutines:)39 b(page)31
b(50)382 3786 y Fe(FTDREC\(unit,key_no,)42 b(>)48 b(status\))382
3899 y(FTDKEY\(unit,keyword,)42 b(>)48 b(status\))0 4155
y Fi(De\014ne)31 b(Data)h(Scaling)f(P)m(arameters)g(and)f(Unde\014ned)f
(Pixel)i(Flags:)42 b(page)31 b(51)382 4411 y Fe
(FTPSCL\(unit,bscale,bzero)o(,)42 b(>)47 b(status\))382
4524 y(FTTSCL\(unit,colnum,tscal)o(,tz)o(ero,)41 b(>)48
b(status\))382 4637 y(FTPNUL\(unit,blank,)43 b(>)k(status\))382
4750 y(FTSNUL\(unit,colnum,snull)41 b(>)47 b(status\))382
4863 y(FTTNUL\(unit,colnum,tnull)41 b(>)47 b(status\))0
5119 y Fi(FITS)30 b(Primary)f(Arra)m(y)i(or)f(IMA)m(GE)i(Extension)e
(I/O)h(Subroutines:)39 b(page)31 b(52)382 5375 y Fe(FTGIDT\(unit,)44
b(>)k(bitpix,status\))382 5488 y(FTGIET\(unit,)c(>)k(bitpix,status\))
382 5601 y(FTGIDM\(unit,)c(>)k(naxis,status\))382 5714
y(FTGISZ\(unit,)c(maxdim,)i(>)i(naxes,status\))p eop
end
%%Page: 117 123
TeXDict begin 117 122 bop 3764 299 a Fi(117)382 555 y
Fe(FTGIPR\(unit,)44 b(maxdim,)i(>)i(bitpix,naxis,naxes,stat)o(us\))382
668 y(FTPPR[BIJKED]\(unit,group)o(,fp)o(ixel)o(,nel)o(eme)o(nts,)o
(valu)o(es,)41 b(>)48 b(status\))382 781 y(FTPPN[BIJKED]\(unit,group)o
(,fp)o(ixel)o(,nel)o(eme)o(nts,)o(valu)o(es,)o(null)o(val)41
b(>)48 b(status\))382 894 y(FTPPRU\(unit,group,fpixel)o(,ne)o(leme)o
(nts,)41 b(>)47 b(status\))382 1007 y(FTGPV[BIJKED]\(unit,group)o(,fp)o
(ixel)o(,nel)o(eme)o(nts,)o(null)o(val)o(,)42 b(>)47
b(values,anyf,status\))382 1120 y(FTGPF[BIJKED]\(unit,group)o(,fp)o
(ixel)o(,nel)o(eme)o(nts,)41 b(>)48 b(values,flagvals,anyf,st)o(atu)o
(s\))382 1233 y(FTPGP[BIJKED]\(unit,group)o(,fp)o(arm,)o(npar)o(m,v)o
(alue)o(s,)42 b(>)47 b(status\))382 1346 y(FTGGP[BIJKED]\(unit,group)o
(,fp)o(arm,)o(npar)o(m,)41 b(>)48 b(values,status\))382
1458 y(FTP2D[BIJKED]\(unit,group)o(,di)o(m1,n)o(axis)o(1,n)o(axis)o
(2,im)o(age)o(,)42 b(>)47 b(status\))382 1571 y
(FTP3D[BIJKED]\(unit,group)o(,di)o(m1,d)o(im2,)o(nax)o(is1,)o(naxi)o
(s2,)o(naxi)o(s3,c)o(ube)o(,)42 b(>)47 b(status\))382
1684 y(FTG2D[BIJKED]\(unit,group)o(,nu)o(llva)o(l,di)o(m1,)o(naxi)o
(s1,n)o(axi)o(s2,)41 b(>)48 b(image,anyf,status\))382
1797 y(FTG3D[BIJKED]\(unit,group)o(,nu)o(llva)o(l,di)o(m1,)o(dim2)o
(,nax)o(is1)o(,nax)o(is2,)o(nax)o(is3,)41 b(>)1002 1910
y(cube,anyf,status\))382 2023 y(FTPSS[BIJKED]\(unit,group)o(,na)o(xis,)
o(naxe)o(s,f)o(pixe)o(ls,l)o(pix)o(els,)o(arra)o(y,)g(>)48
b(status\))382 2136 y(FTGSV[BIJKED]\(unit,group)o(,na)o(xis,)o(naxe)o
(s,f)o(pixe)o(ls,l)o(pix)o(els,)o(incs)o(,nu)o(llva)o(l,)42
b(>)1002 2249 y(array,anyf,status\))382 2362 y
(FTGSF[BIJKED]\(unit,group)o(,na)o(xis,)o(naxe)o(s,f)o(pixe)o(ls,l)o
(pix)o(els,)o(incs)o(,)g(>)1002 2475 y(array,flagvals,anyf,statu)o(s\))
0 2739 y Fi(T)-8 b(able)31 b(Column)e(Information)i(Subroutines:)39
b(page)31 b(55)382 3003 y Fe(FTGNRW\(unit,)44 b(>)k(nrows,)e(status\))
382 3115 y(FTGNCL\(unit,)e(>)k(ncols,)e(status\))382
3228 y(FTGCNO\(unit,casesen,colt)o(emp)o(late)o(,)c(>)47
b(colnum,status\))382 3341 y(FTGCNN\(unit,casesen,colt)o(emp)o(late)o
(,)42 b(>)47 b(colnam,colnum,status\))382 3454 y(FTGTCL\(unit,colnum,)
42 b(>)48 b(datacode,repeat,width,st)o(atu)o(s\))382
3567 y(FTEQTY\(unit,colnum,)42 b(>)48 b(datacode,repeat,width,st)o(atu)
o(s\))382 3680 y(FTGCDW\(unit,colnum,)42 b(>)48 b(dispwidth,status\))
382 3793 y(FTGACL\(unit,colnum,)42 b(>)716 3906 y
(ttype,tbcol,tunit,tform,)o(tsca)o(l,t)o(zero)o(,snu)o(ll,)o(tdis)o
(p,st)o(atu)o(s\))382 4019 y(FTGBCL\(unit,colnum,)g(>)716
4132 y(ttype,tunit,datatype,rep)o(eat,)o(tsc)o(al,t)o(zero)o(,tn)o
(ull,)o(tdis)o(p,s)o(tatu)o(s\))382 4245 y(FTPTDM\(unit,colnum,naxis)o
(,na)o(xes,)f(>)48 b(status\))382 4357 y(FTGTDM\(unit,colnum,maxdi)o
(m,)41 b(>)48 b(naxis,naxes,status\))382 4470 y
(FTDTDM\(unit,tdimstr,coln)o(um,)o(maxd)o(im,)41 b(>)48
b(naxis,naxes,)c(status\))382 4583 y(FFGRSZ\(unit,)g(>)k
(nrows,status\))0 4847 y Fi(Lo)m(w-Lev)m(el)32 b(T)-8
b(able)31 b(Access)h(Subroutines:)39 b(page)31 b(58)382
5111 y Fe(FTGTBS\(unit,frow,startch)o(ar,)o(ncha)o(rs,)41
b(>)48 b(string,status\))382 5224 y(FTPTBS\(unit,frow,startch)o(ar,)o
(ncha)o(rs,s)o(tri)o(ng,)41 b(>)48 b(status\))382 5337
y(FTGTBB\(unit,frow,startch)o(ar,)o(ncha)o(rs,)41 b(>)48
b(array,status\))382 5450 y(FTPTBB\(unit,frow,startch)o(ar,)o(ncha)o
(rs,a)o(rra)o(y,)42 b(>)47 b(status\))0 5714 y Fi(Edit)30
b(Ro)m(ws)h(or)f(Columns)g(page)h(58)p eop end
%%Page: 118 124
TeXDict begin 118 123 bop 0 299 a Fi(118)281 b Fg(CHAPTER)30
b(10.)112 b(SUMMAR)-8 b(Y)32 b(OF)e(ALL)g(FITSIO)f(USER-INTERF)-10
b(A)m(CE)30 b(SUBR)m(OUTINES)382 555 y Fe(FTIROW\(unit,frow,nrows,)41
b(>)48 b(status\))382 668 y(FTDROW\(unit,frow,nrows,)41
b(>)48 b(status\))382 781 y(FTDRRG\(unit,rowrange,)42
b(>)47 b(status\))382 894 y(FTDRWS\(unit,rowlist,nrow)o(s,)41
b(>)48 b(status\))382 1007 y(FTICOL\(unit,colnum,ttype)o(,tf)o(orm,)41
b(>)48 b(status\))382 1120 y(FTICLS\(unit,colnum,ncols)o(,tt)o(ype,)o
(tfor)o(m,)41 b(>)48 b(status\))382 1233 y(FTMVEC\(unit,colnum,newve)o
(cle)o(n,)42 b(>)47 b(status\))382 1346 y(FTDCOL\(unit,colnum,)42
b(>)48 b(status\))382 1458 y(FTCPCL\(inunit,outunit,in)o(col)o(num,)o
(outc)o(oln)o(um,c)o(reat)o(eco)o(l,)42 b(>)47 b(status\);)0
1716 y Fi(Read)31 b(and)e(W)-8 b(rite)32 b(Column)e(Data)i(Routines)e
(page)h(60)382 1974 y Fe(FTPCL[SLBIJKEDCM]\(unit,c)o(oln)o(um,f)o(row,)
o(fel)o(em,n)o(elem)o(ent)o(s,va)o(lues)o(,)42 b(>)47
b(status\))382 2087 y(FTPCN[BIJKED]\(unit,colnu)o(m,f)o(row,)o(fele)o
(m,n)o(elem)o(ents)o(,va)o(lues)o(,nul)o(lva)o(l)42 b(>)47
b(status\))382 2199 y(FTPCLX\(unit,colnum,frow,)o(fbi)o(t,nb)o(it,l)o
(ray)o(,)42 b(>)47 b(status\))382 2312 y(FTPCLU\(unit,colnum,frow,)o
(fel)o(em,n)o(elem)o(ent)o(s,)42 b(>)47 b(status\))382
2425 y(FTGCL\(unit,colnum,frow,f)o(ele)o(m,ne)o(leme)o(nts)o(,)42
b(>)47 b(values,status\))382 2538 y(FTGCV[SBIJKEDCM]\(unit,co)o(lnu)o
(m,fr)o(ow,f)o(ele)o(m,ne)o(leme)o(nts)o(,nul)o(lval)o(,)42
b(>)1098 2651 y(values,anyf,status\))382 2764 y
(FTGCF[SLBIJKEDCM]\(unit,c)o(oln)o(um,f)o(row,)o(fel)o(em,n)o(elem)o
(ent)o(s,)g(>)1193 2877 y(values,flagvals,anyf,stat)o(us\))382
2990 y(FTGSV[BIJKED]\(unit,colnu)o(m,n)o(axis)o(,nax)o(es,)o(fpix)o
(els,)o(lpi)o(xels)o(,inc)o(s,n)o(ullv)o(al,)f(>)1002
3103 y(array,anyf,status\))382 3216 y(FTGSF[BIJKED]\(unit,colnu)o(m,n)o
(axis)o(,nax)o(es,)o(fpix)o(els,)o(lpi)o(xels)o(,inc)o(s,)g(>)1002
3329 y(array,flagvals,anyf,statu)o(s\))382 3441 y
(FTGCX\(unit,colnum,frow,f)o(bit)o(,nbi)o(t,)h(>)47 b(lray,status\))382
3554 y(FTGCX[IJD]\(unit,colnum,f)o(row)o(,nro)o(ws,f)o(bit)o(,nbi)o(t,)
42 b(>)47 b(array,status\))382 3667 y(FTGDES\(unit,colnum,rownu)o(m,)41
b(>)48 b(nelements,offset,status\))382 3780 y
(FTPDES\(unit,colnum,rownu)o(m,n)o(elem)o(ents)o(,of)o(fset)o(,)42
b(>)47 b(status\))0 4038 y Fi(Ro)m(w)31 b(Selection)h(and)d(Calculator)
j(Routines:)41 b(page)31 b(64)382 4295 y Fe(FTFROW\(unit,expr,firstro)o
(w,)41 b(nrows,)47 b(>)g(n_good_rows,)d(row_status,)h(status\))382
4408 y(FTFFRW\(unit,)f(expr,)j(>)g(rownum,)f(status\))382
4521 y(FTSROW\(inunit,)e(outunit,)h(expr,)i(>)g(status)f(\))382
4634 y(FTCROW\(unit,datatype,exp)o(r,f)o(irst)o(row,)o(nel)o(emen)o
(ts,n)o(ulv)o(al,)41 b(>)620 4747 y(array,anynul,status\))382
4860 y(FTCALC\(inunit,)j(expr,)i(outunit,)g(parName,)f(parInfo,)h(>)h
(status\))382 4973 y(FTCALC_RNG\(inunit,)c(expr,)j(outunit,)g(parName,)
f(parInfo,)573 5086 y(nranges,)g(firstrow,)h(lastrow,)f(>)j(status\))
382 5199 y(FTTEXP\(unit,)c(expr,)j(>)g(datatype,)e(nelem,)h(naxis,)h
(naxes,)f(status\))0 5456 y Fi(Celestial)32 b(Co)s(ordinate)f(System)f
(Subroutines:)39 b(page)31 b(65)382 5714 y Fe(FTGICS\(unit,)44
b(>)k(xrval,yrval,xrpix,yrpix)o(,xin)o(c,yi)o(nc,)o(rot,)o(coor)o(dty)o
(pe,s)o(tatu)o(s\))p eop end
%%Page: 119 125
TeXDict begin 119 124 bop 3764 299 a Fi(119)382 555 y
Fe(FTGTCS\(unit,xcol,ycol,)42 b(>)716 668 y(xrval,yrval,xrpix,yrpix,)o
(xinc)o(,yi)o(nc,r)o(ot,c)o(oor)o(dtyp)o(e,st)o(atu)o(s\))382
781 y(FTWLDP\(xpix,ypix,xrval,y)o(rva)o(l,xr)o(pix,)o(yrp)o(ix,x)o
(inc,)o(yin)o(c,ro)o(t,)1241 894 y(coordtype,)j(>)i(xpos,ypos,status\))
382 1007 y(FTXYPX\(xpos,ypos,xrval,y)o(rva)o(l,xr)o(pix,)o(yrp)o(ix,x)o
(inc,)o(yin)o(c,ro)o(t,)1241 1120 y(coordtype,)e(>)i
(xpix,ypix,status\))0 1340 y Fi(File)32 b(Chec)m(ksum)d(Subroutines:)40
b(page)31 b(67)382 1560 y Fe(FTPCKS\(unit,)44 b(>)k(status\))382
1673 y(FTUCKS\(unit,)c(>)k(status\))382 1785 y(FTVCKS\(unit,)c(>)k
(dataok,hduok,status\))382 1898 y(FTGCKS\(unit,)c(>)k
(datasum,hdusum,status\))382 2011 y(FTESUM\(sum,complement,)42
b(>)47 b(checksum\))382 2124 y(FTDSUM\(checksum,compleme)o(nt,)41
b(>)48 b(sum\))0 2457 y Fi(Time)30 b(and)g(Date)i(Utilit)m(y)h
(Subroutines:)39 b(page)31 b(68)382 2677 y Fe(FTGSDT\()46
b(>)h(day,)g(month,)f(year,)g(status)g(\))382 2790 y(FTGSTM\(>)f
(datestr,)h(timeref,)f(status\))382 2903 y(FTDT2S\()h(year,)g(month,)g
(day,)h(>)g(datestr,)f(status\))382 3016 y(FTTM2S\()g(year,)g(month,)g
(day,)h(hour,)f(minute,)g(second,)g(decimals,)764 3129
y(>)h(datestr,)f(status\))382 3242 y(FTS2DT\(datestr,)d(>)48
b(year,)e(month,)g(day,)h(status\))382 3354 y(FTS2TM\(datestr,)c(>)48
b(year,)e(month,)g(day,)h(hour,)f(minute,)g(second,)g(status\))0
3574 y Fi(General)31 b(Utilit)m(y)i(Subroutines:)39 b(page)31
b(69)382 3794 y Fe(FTGHAD\(unit,)44 b(>)k(curaddr,nextaddr\))382
3907 y(FTUPCH\(string\))382 4020 y(FTCMPS\(str_template,stri)o(ng,)o
(case)o(sen,)41 b(>)47 b(match,exact\))382 4133 y(FTTKEY\(keyword,)c(>)
48 b(status\))382 4246 y(FTTREC\(card,)c(>)k(status\))382
4359 y(FTNCHK\(unit,)c(>)k(status\))382 4472 y(FTGKNM\(unit,)c(>)k
(keyword,)d(keylength,)g(status\))382 4585 y(FTPSVC\(card,)f(>)k
(value,comment,status\))382 4698 y(FTKEYN\(keyroot,seq_no,)42
b(>)47 b(keyword,status\))382 4811 y(FTNKEY\(seq_no,keyroot,)42
b(>)47 b(keyword,status\))382 4924 y(FTDTYP\(value,)d(>)j
(dtype,status\))382 5036 y(class)f(=)i(FTGKCL\(card\))382
5149 y(FTASFM\(tform,)c(>)j(datacode,width,decimals,st)o(atus)o(\))382
5262 y(FTBNFM\(tform,)d(>)j(datacode,repeat,width,stat)o(us\))382
5375 y(FTGABC\(tfields,tform,spa)o(ce,)41 b(>)48 b
(rowlen,tbcol,status\))382 5488 y(FTGTHD\(template,)43
b(>)48 b(card,hdtype,status\))382 5601 y(FTRWRG\(rowlist,)43
b(maxrows,)j(maxranges,)f(>)i(numranges,)e(rangemin,)716
5714 y(rangemax,)g(status\))p eop end
%%Page: 120 126
TeXDict begin 120 125 bop 0 299 a Fi(120)281 b Fg(CHAPTER)30
b(10.)112 b(SUMMAR)-8 b(Y)32 b(OF)e(ALL)g(FITSIO)f(USER-INTERF)-10
b(A)m(CE)30 b(SUBR)m(OUTINES)p eop end
%%Page: 121 127
TeXDict begin 121 126 bop 0 1225 a Ff(Chapter)65 b(11)0
1687 y Fl(P)-6 b(arameter)77 b(De\014nitions)0 2180 y
Fe(anyf)47 b(-)g(\(logical\))e(set)i(to)g(TRUE)g(if)g(any)g(of)g(the)g
(returned)f(data)g(values)h(are)f(undefined)0 2293 y(array)g(-)i(\(any)
e(datatype)g(except)g(character\))f(array)h(of)i(bytes)e(to)h(be)g
(read)g(or)g(written.)0 2406 y(bitpix)f(-)i(\(integer\))d(bits)h(per)h
(pixel:)f(8,)i(16,)f(32,)f(-32,)h(or)g(-64)0 2518 y(blank)f(-)i
(\(integer\))d(value)h(used)h(for)g(undefined)e(pixels)h(in)i(integer)d
(primary)h(array)0 2631 y(blank)g(-)i(\(integer*8\))d(value)h(used)h
(for)f(undefined)g(pixels)g(in)h(integer)f(primary)g(array)0
2744 y(blocksize)f(-)j(\(integer\))d(2880-byte)g(logical)h(record)g
(blocking)g(factor)477 2857 y(\(if)h(0)h(<)f(blocksize)e(<)j(11\))f(or)
g(the)g(actual)f(block)g(size)h(in)g(bytes)477 2970 y(\(if)g(10)g(<)h
(blocksize)d(<)j(28800\).)93 b(As)47 b(of)g(version)f(3.3)h(of)g
(FITSIO,)477 3083 y(blocksizes)e(greater)h(than)h(2880)f(are)h(no)g
(longer)g(supported.)0 3196 y(bscale)f(-)i(\(double)d(precision\))g
(scaling)h(factor)g(for)h(the)g(primary)f(array)0 3309
y(bytlen)g(-)i(\(integer\))d(length)h(of)h(the)g(data)g(unit,)f(in)h
(bytes)0 3422 y(bzero)f(-)i(\(double)e(precision\))f(zero)h(point)h
(for)g(primary)e(array)i(scaling)0 3535 y(card)g(-)g(\(character*80\))d
(header)i(record)g(to)h(be)h(read)e(or)h(written)0 3648
y(casesen)f(-)h(\(logical\))f(will)g(string)g(matching)g(be)h(case)g
(sensitive?)0 3760 y(checksum)f(-)h(\(character*16\))d(encoded)i
(checksum)f(string)0 3873 y(colname)h(-)h(\(character\))e(ASCII)h(name)
h(of)g(the)g(column)0 3986 y(colnum)f(-)i(\(integer\))d(number)h(of)h
(the)g(column)f(\(first)g(column)g(=)i(1\))0 4099 y(coltemplate)d(-)i
(\(character\))e(template)g(string)i(to)g(be)g(matched)f(to)h(column)f
(names)0 4212 y(comment)g(-)h(\(character\))e(the)i(keyword)f(comment)g
(field)0 4325 y(comments)g(-)h(\(character)e(array\))h(keyword)g
(comment)g(fields)0 4438 y(compid)g(-)i(\(integer\))d(the)i(type)f(of)i
(computer)d(that)i(the)g(program)e(is)j(running)d(on)0
4551 y(complement)g(-)i(\(logical\))f(should)g(the)h(checksum)e(be)i
(complemented?)0 4664 y(coordtype)e(-)j(\(character\))c(type)j(of)g
(coordinate)e(projection)g(\(-SIN,)h(-TAN,)h(-ARC,)477
4777 y(-NCP,)g(-GLS,)f(-MER,)g(or)i(-AIT\))0 4890 y(cube)f(-)g(3D)g
(data)g(cube)g(of)g(the)g(appropriate)d(datatype)0 5002
y(curaddr)i(-)h(\(integer\))f(starting)f(address)h(\(in)h(bytes\))f(of)
h(the)g(CHDU)0 5115 y(current)f(-)h(\(integer\))f(if)h(not)g(equal)f
(to)h(0,)g(copy)g(the)g(current)f(HDU)0 5228 y(datacode)g(-)h
(\(integer\))e(symbolic)h(code)g(of)i(the)f(binary)f(table)g(column)g
(datatype)0 5341 y(dataok)g(-)i(\(integer\))d(was)i(the)g(data)f(unit)h
(verification)d(successful)h(\(=1\))i(or)430 5454 y(not)f(\(=)i(-1\).)
94 b(Equals)46 b(zero)h(if)g(the)g(DATASUM)f(keyword)f(is)j(not)f
(present.)0 5567 y(datasum)f(-)h(\(double)f(precision\))f(32-bit)h(1's)
h(complement)e(checksum)h(for)h(the)f(data)h(unit)0 5680
y(datatype)f(-)h(\(character\))e(datatype)g(\(format\))h(of)h(the)g
(binary)f(table)g(column)1882 5942 y Fi(121)p eop end
%%Page: 122 128
TeXDict begin 122 127 bop 0 299 a Fi(122)1779 b Fg(CHAPTER)30
b(11.)112 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)0 555 y
Fe(datestr)94 b(-)47 b(\(string\))f(FITS)g(date/time)f(string:)h
('YYYY-MM-DDThh:mm:ss.ddd')o(,)525 668 y('YYYY-MM-dd',)e(or)j
('dd/mm/yy')0 781 y(day)g(-)g(\(integer\))f(current)f(day)i(of)h(the)e
(month)0 894 y(dblval)g(-)i(\(double)d(precision\))g(fractional)g(part)
i(of)g(the)g(keyword)f(value)0 1007 y(decimals)g(-)h(\(integer\))e
(number)h(of)i(decimal)d(places)h(to)i(be)f(displayed)0
1120 y(dim1)g(-)g(\(integer\))e(actual)h(size)h(of)g(the)g(first)g
(dimension)e(of)i(the)g(image)f(or)h(cube)g(array)0 1233
y(dim2)g(-)g(\(integer\))e(actual)h(size)h(of)g(the)g(second)f
(dimension)g(of)h(the)g(cube)f(array)0 1346 y(dispwidth)f(-)j
(\(integer\))d(-)i(the)g(display)f(width)h(\(length)e(of)j(string\))d
(for)i(a)h(column)0 1458 y(dtype)e(-)i(\(character\))d(datatype)g(of)i
(the)g(keyword)f(\('C',)g('L',)h('I',)94 b(or)48 b('F'\))764
1571 y(C)f(=)h(character)d(string)764 1684 y(L)i(=)h(logical)764
1797 y(I)f(=)h(integer)764 1910 y(F)f(=)h(floating)d(point)h(number)0
2023 y(errmsg)g(-)i(\(character*80\))43 b(oldest)k(error)f(message)g
(on)h(the)g(internal)e(stack)0 2136 y(errtext)h(-)h(\(character*30\))d
(descriptive)h(error)h(message)g(corresponding)e(to)j(error)g(number)0
2249 y(casesen)f(-)h(\(logical\))f(true)g(if)h(column)f(name)h
(matching)f(is)h(case)f(sensitive)0 2362 y(exact)g(-)i(\(logical\))d
(do)i(the)g(strings)f(match)g(exactly,)g(or)h(were)g(wildcards)e(used?)
0 2475 y(exclist)94 b(\(character)45 b(array\))h(list)g(of)h(names)g
(to)g(be)g(excluded)f(from)g(search)0 2588 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 2700 y(extend)f(-)i(\(logical\))d(true)h
(if)i(there)e(may)h(be)g(extensions)e(following)g(the)i(primary)f(data)
0 2813 y(extname)g(-)h(\(character\))e(value)h(of)i(the)e(EXTNAME)g
(keyword)g(\(if)h(not)g(blank\))0 2926 y(fbit)g(-)g(\(integer\))e
(first)i(bit)g(in)g(the)g(field)f(to)h(be)g(read)g(or)g(written)0
3039 y(felem)f(-)i(\(integer\))d(first)h(pixel)h(of)g(the)g(element)f
(vector)g(\(ignored)f(for)i(ASCII)g(tables\))0 3152 y(filename)f(-)h
(\(character\))e(name)h(of)i(the)e(FITS)h(file)0 3265
y(flagvals)f(-)h(\(logical)f(array\))g(True)g(if)h(corresponding)e
(data)h(element)g(is)h(undefined)0 3378 y(following)e(-)j(\(integer\))d
(if)i(not)g(equal)f(to)i(0,)f(copy)f(all)h(following)f(HDUs)g(in)h(the)
g(input)g(file)0 3491 y(fparm)f(-)i(\(integer\))d(sequence)h(number)g
(of)h(the)g(first)f(group)h(parameter)e(to)i(read)g(or)g(write)0
3604 y(fpixel)f(-)i(\(integer\))d(the)i(first)f(pixel)g(position)0
3717 y(fpixels)g(-)h(\(integer)f(array\))g(the)h(first)f(included)g
(pixel)g(in)h(each)g(dimension)0 3830 y(frow)g(-)g(\(integer\))e
(beginning)h(row)h(number)f(\(first)g(row)h(of)g(table)f(=)i(1\))0
3942 y(frowll)e(-)i(\(integer*8\))c(beginning)i(row)g(number)h(\(first)
f(row)h(of)g(table)f(=)i(1\))0 4055 y(gcount)e(-)i(\(integer\))d(value)
h(of)h(the)g(GCOUNT)f(keyword)g(\(usually)g(=)h(1\))0
4168 y(group)f(-)i(\(integer\))d(sequence)h(number)g(of)h(the)g(data)f
(group)h(\(=0)g(for)g(non-grouped)d(data\))0 4281 y(hdtype)i(-)i
(\(integer\))d(header)h(record)g(type:)g(-1=delete;)93
b(0=append)46 b(or)h(replace;)907 4394 y(1=append;)e(2=this)h(is)h(the)
g(END)g(keyword)0 4507 y(hduok)f(-)i(\(integer\))d(was)i(the)g(HDU)g
(verification)d(successful)h(\(=1\))i(or)430 4620 y(not)f(\(=)i(-1\).)
94 b(Equals)46 b(zero)h(if)g(the)g(CHECKSUM)e(keyword)h(is)h(not)g
(present.)0 4733 y(hdusum)f(-)i(\(double)d(precision\))g(32)j(bit)e
(1's)h(complement)e(checksum)h(for)h(the)g(entire)f(CHDU)0
4846 y(hdutype)g(-)h(\(integer\))f(type)g(of)h(HDU:)g(0)g(=)h(primary)e
(array)g(or)h(IMAGE,)f(1)i(=)f(ASCII)g(table,)907 4959
y(2)g(=)h(binary)e(table,)g(-1)h(=)h(any)e(HDU)h(type)g(or)g(unknown)f
(type)0 5072 y(history)g(-)h(\(character\))e(the)i(HISTORY)f(keyword)g
(comment)f(string)0 5185 y(hour)i(-)g(\(integer\))e(hour)i(from)g(0)g
(-)h(23)0 5297 y(image)e(-)i(2D)f(image)f(of)i(the)e(appropriate)f
(datatype)0 5410 y(inclist)94 b(\(character)45 b(array\))h(list)g(of)h
(names)g(to)g(be)g(included)f(in)h(search)0 5523 y(incs)g(-)g
(\(integer)f(array\))g(sampling)f(interval)h(for)h(pixels)f(in)h(each)g
(FITS)f(dimension)0 5636 y(intval)g(-)i(\(integer\))d(integer)h(part)g
(of)h(the)g(keyword)f(value)p eop end
%%Page: 123 129
TeXDict begin 123 128 bop 3764 299 a Fi(123)0 555 y Fe(iounit)46
b(-)i(\(integer\))d(value)h(of)h(an)h(unused)e(I/O)h(unit)f(number)0
668 y(iunit)g(-)i(\(integer\))d(logical)h(unit)h(number)f(associated)f
(with)h(the)h(input)g(FITS)f(file,)h(1-199)0 781 y(key_no)f(-)i
(\(integer\))d(sequence)g(number)h(\(starting)g(with)g(1\))i(of)f(the)g
(keyword)e(record)0 894 y(keylength)g(-)j(\(integer\))d(length)h(of)h
(the)g(keyword)f(name)0 1007 y(keyroot)g(-)h(\(character\))e(root)i
(string)f(for)h(the)g(keyword)e(name)0 1120 y(keysadd)h(-\(integer\))f
(number)h(of)h(new)g(keyword)f(records)g(which)g(can)h(fit)g(in)g(the)g
(CHU)0 1233 y(keysexist)e(-)j(\(integer\))d(number)h(of)h(existing)f
(keyword)g(records)f(in)j(the)f(CHU)0 1346 y(keyval)f(-)i(value)e(of)h
(the)g(keyword)f(in)h(the)g(appropriate)e(datatype)0
1458 y(keyvals)h(-)h(\(array\))f(value)g(of)i(the)f(keywords)e(in)i
(the)g(appropriate)e(datatype)0 1571 y(keyword)h(-)h(\(character*8\))d
(name)j(of)g(a)h(keyword)0 1684 y(lray)f(-)g(\(logical)f(array\))g
(array)g(of)h(logical)f(values)g(corresponding)e(to)k(the)e(bit)h
(array)0 1797 y(lpixels)f(-)h(\(integer)f(array\))g(the)h(last)f
(included)g(pixel)g(in)i(each)e(dimension)0 1910 y(match)g(-)i
(\(logical\))d(do)i(the)g(2)h(strings)d(match?)0 2023
y(maxdim)h(-)i(\(integer\))d(dimensioned)g(size)h(of)h(the)g(NAXES,)f
(TTYPE,)g(TFORM)h(or)g(TUNIT)f(arrays)0 2136 y(max_keys)g(-)h
(\(integer\))e(maximum)h(number)g(of)h(keywords)f(to)h(search)f(for)0
2249 y(minute)g(-)i(\(integer\))d(minute)h(of)h(an)g(hour)g(\(0)g(-)h
(59\))0 2362 y(month)e(-)i(\(integer\))d(current)h(month)g(of)h(the)g
(year)g(\(1)g(-)h(12\))0 2475 y(morekeys)e(-)h(\(integer\))e(will)i
(leave)f(space)h(in)g(the)g(header)f(for)h(this)f(many)h(more)g
(keywords)0 2588 y(naxes)f(-)i(\(integer)d(array\))h(size)h(of)g(each)g
(dimension)e(in)i(the)g(FITS)g(array)0 2700 y(naxesll)f(-)h
(\(integer*8)e(array\))h(size)h(of)g(each)g(dimension)e(in)i(the)g
(FITS)g(array)0 2813 y(naxis)f(-)i(\(integer\))d(number)h(of)h
(dimensions)e(in)j(the)e(FITS)h(array)0 2926 y(naxis1)f(-)i
(\(integer\))d(length)h(of)h(the)g(X/first)f(axis)g(of)i(the)f(FITS)f
(array)0 3039 y(naxis2)g(-)i(\(integer\))d(length)h(of)h(the)g
(Y/second)f(axis)g(of)h(the)g(FITS)g(array)0 3152 y(naxis3)f(-)i
(\(integer\))d(length)h(of)h(the)g(Z/third)f(axis)g(of)i(the)f(FITS)f
(array)0 3265 y(nbit)h(-)g(\(integer\))e(number)h(of)i(bits)e(in)h(the)
g(field)g(to)g(read)g(or)g(write)0 3378 y(nchars)f(-)i(\(integer\))d
(number)h(of)h(characters)e(to)i(read)g(and)g(return)0
3491 y(ncols)f(-)i(\(integer\))d(number)h(of)h(columns)0
3604 y(nelements)e(-)j(\(integer\))d(number)h(of)h(data)g(elements)e
(to)j(read)e(or)h(write)0 3717 y(nelementsll)e(-)i(\(integer*8\))e
(number)h(of)h(data)g(elements)e(to)j(read)e(or)h(write)0
3830 y(nexc)142 b(\(integer\))93 b(number)46 b(of)h(names)g(in)g(the)g
(exclusion)e(list)i(\(may)f(=)i(0\))0 3942 y(nhdu)f(-)g(\(integer\))e
(absolute)h(number)g(of)h(the)g(HDU)g(\(1st)g(HDU)g(=)g(1\))0
4055 y(ninc)142 b(\(integer\))93 b(number)46 b(of)h(names)g(in)g(the)g
(inclusion)e(list)0 4168 y(nmove)h(-)i(\(integer\))d(number)h(of)h
(HDUs)g(to)g(move)g(\(+)g(or)g(-\),)g(relative)f(to)h(current)f
(position)0 4281 y(nfound)g(-)i(\(integer\))d(number)h(of)h(keywords)f
(found)g(\(highest)g(keyword)f(number\))0 4394 y(no_keys)h(-)h
(\(integer\))f(number)g(of)h(keywords)e(to)j(write)e(in)h(the)g
(sequence)0 4507 y(nparm)f(-)i(\(integer\))d(number)h(of)h(group)g
(parameters)e(to)i(read)g(or)g(write)0 4620 y(nrows)f(-)i(\(integer\))d
(number)h(of)h(rows)g(in)g(the)g(table)0 4733 y(nrowsll)f(-)h
(\(integer*8\))e(number)h(of)h(rows)g(in)g(the)g(table)0
4846 y(nullval)f(-)h(value)g(to)g(represent)e(undefined)g(pixels,)h(of)
h(the)g(appropriate)e(datatype)0 4959 y(nextaddr)h(-)h(\(integer\))e
(starting)h(address)g(\(in)h(bytes\))f(of)h(the)g(HDU)g(following)e
(the)i(CHDU)0 5072 y(offset)f(-)i(\(integer\))d(byte)h(offset)h(in)g
(the)g(heap)f(to)h(the)g(first)g(element)f(of)h(the)g(array)0
5185 y(offsetll)f(-)h(\(integer*8\))e(byte)h(offset)g(in)i(the)f(heap)f
(to)h(the)g(first)g(element)e(of)j(the)f(array)0 5297
y(oldkey)f(-)i(\(character\))c(old)j(name)g(of)g(keyword)f(to)h(be)g
(modified)0 5410 y(ounit)f(-)i(\(integer\))d(logical)h(unit)h(number)f
(associated)f(with)h(the)h(output)f(FITS)h(file)g(1-199)0
5523 y(pcount)f(-)i(\(integer\))d(value)h(of)h(the)g(PCOUNT)f(keyword)g
(\(usually)g(=)h(0\))0 5636 y(previous)f(-)h(\(integer\))e(if)i(not)g
(equal)g(to)g(0,)g(copy)g(all)g(previous)e(HDUs)i(in)g(the)g(input)f
(file)p eop end
%%Page: 124 130
TeXDict begin 124 129 bop 0 299 a Fi(124)1779 b Fg(CHAPTER)30
b(11.)112 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)0 555 y
Fe(repeat)46 b(-)i(\(integer\))d(length)h(of)h(element)f(vector)g
(\(e.g.)g(12J\);)h(ignored)f(for)g(ASCII)h(table)0 668
y(rot)g(-)g(\(double)f(precision\))f(celestial)g(coordinate)g(rotation)
h(angle)g(\(degrees\))0 781 y(rowlen)g(-)i(\(integer\))d(length)h(of)h
(a)h(table)e(row,)h(in)g(characters)e(or)i(bytes)0 894
y(rowlenll)f(-)h(\(integer*8\))e(length)h(of)h(a)g(table)g(row,)f(in)i
(characters)d(or)i(bytes)0 1007 y(rowlist)f(-)h(\(integer)f(array\))g
(list)h(of)g(row)g(numbers)e(to)j(be)f(deleted)f(in)h(increasing)e
(order)0 1120 y(rownum)h(-)i(\(integer\))d(number)h(of)h(the)g(row)g
(\(first)f(row)h(=)g(1\))0 1233 y(rowrange-)e(\(string\))h(list)g(of)i
(rows)e(or)h(row)g(ranges)f(to)i(be)f(deleted)0 1346
y(rwmode)f(-)i(\(integer\))d(file)h(access)h(mode:)f(0)h(=)h(readonly,)
d(1)j(=)f(readwrite)0 1458 y(second)142 b(\(double\)-)45
b(second)h(within)g(minute)g(\(0)h(-)h(60.9999999999\))c(\(leap)i
(second!\))0 1571 y(seq_no)g(-)i(\(integer\))d(the)i(sequence)e(number)
h(to)i(append)e(to)h(the)g(keyword)f(root)g(name)0 1684
y(simple)g(-)i(\(logical\))d(does)h(the)h(FITS)g(file)g(conform)e(to)j
(all)f(the)f(FITS)h(standards)0 1797 y(snull)f(-)i(\(character\))d
(value)h(used)h(to)g(represent)e(undefined)g(values)h(in)i(ASCII)e
(table)0 1910 y(space)g(-)i(\(integer\))d(number)h(of)h(blank)g(spaces)
f(to)h(leave)f(between)g(ASCII)h(table)f(columns)0 2023
y(startchar)f(-)j(\(integer\))d(first)h(character)g(in)h(the)g(row)g
(to)g(be)g(read)0 2136 y(startno)f(-)h(\(integer\))f(value)g(of)h(the)g
(first)f(keyword)g(sequence)g(number)g(\(usually)f(1\))0
2249 y(status)h(-)i(\(integer\))d(returned)g(error)i(status)f(code)g
(\(0)i(=)f(OK\))0 2362 y(str_template)d(\(character\))h(template)h
(string)g(to)h(be)g(matched)f(to)h(reference)e(string)0
2475 y(stream)h(-)i(\(character\))c(output)i(stream)g(for)h(the)g
(report:)f(either)g('STDOUT')g(or)h('STDERR')0 2588 y(string)f(-)i
(\(character\))c(character)i(string)0 2700 y(sum)h(-)g(\(double)f
(precision\))f(32)i(bit)g(unsigned)f(checksum)f(value)0
2813 y(tbcol)h(-)i(\(integer)d(array\))h(column)h(number)f(of)h(the)g
(first)f(character)f(in)j(the)e(field\(s\))0 2926 y(tdisp)g(-)i
(\(character\))d(Fortran)g(type)i(display)f(format)g(for)h(the)g(table)
f(column)0 3039 y(template-\(character\))c(template)k(string)g(for)h(a)
g(FITS)g(header)f(record)0 3152 y(tfields)g(-)h(\(integer\))f(number)g
(of)h(fields)f(\(columns\))f(in)i(the)g(table)0 3265
y(tform)f(-)i(\(character)d(array\))h(format)g(of)h(the)g(column\(s\);)
e(allowed)h(values)g(are:)430 3378 y(For)g(ASCII)h(tables:)93
b(Iw,)47 b(Aw,)g(Fww.dd,)f(Eww.dd,)g(or)h(Dww.dd)430
3491 y(For)f(binary)h(tables:)e(rL,)i(rX,)g(rB,)g(rI,)g(rJ,)g(rA,)g
(rAw,)f(rE,)h(rD,)g(rC,)g(rM)430 3604 y(where)f('w'=width)f(of)i(the)g
(field,)f('d'=no.)g(of)h(decimals,)f('r'=repeat)f(count)430
3717 y(Note)h(that)h(the)g('rAw')f(form)h(is)g(non-standard)d
(extension)i(to)h(the)430 3830 y(TFORM)f(keyword)g(syntax)g(that)g(is)i
(not)f(specifically)d(defined)i(in)h(the)430 3942 y(Binary)f(Tables)g
(definition)f(document.)0 4055 y(theap)h(-)i(\(integer\))d(zero)i
(indexed)f(byte)g(offset)g(of)h(starting)f(address)g(of)h(the)g(heap)
430 4168 y(relative)e(to)i(the)g(beginning)e(of)j(the)f(binary)f(table)
g(data)0 4281 y(tnull)g(-)i(\(integer\))d(value)h(used)h(to)g
(represent)f(undefined)f(values)h(in)h(binary)f(table)0
4394 y(tnullll)g(-)h(\(integer*8\))e(value)h(used)h(to)g(represent)e
(undefined)h(values)g(in)h(binary)f(table)0 4507 y(ttype)g(-)i
(\(character)d(array\))h(label)g(for)h(table)g(column\(s\))0
4620 y(tscal)f(-)i(\(double)e(precision\))f(scaling)g(factor)i(for)f
(table)h(column)0 4733 y(tunit)f(-)i(\(character)d(array\))h(physical)f
(unit)i(for)g(table)f(column\(s\))0 4846 y(tzero)g(-)i(\(double)e
(precision\))f(scaling)g(zero)i(point)f(for)h(table)g(column)0
4959 y(unit)94 b(-)48 b(\(integer\))d(logical)h(unit)h(number)f
(associated)f(with)h(the)h(FITS)g(file)f(\(1-199\))0
5072 y(units)g(-)i(\(character\))d(the)h(keyword)g(units)h(string)f
(\(e.g.,)g('km/s'\))0 5185 y(value)g(-)i(\(character\))d(the)h(keyword)
g(value)h(string)0 5297 y(values)f(-)i(array)e(of)h(data)g(values)f(of)
h(the)g(appropriate)e(datatype)0 5410 y(varidat)h(-)h(\(integer\))f
(size)g(in)h(bytes)g(of)g(the)g('variable)e(length)h(data)h(area')525
5523 y(following)e(the)i(binary)f(table)h(data)f(\(usually)g(=)h(0\))0
5636 y(version)f(-)h(\(real\))f(current)g(revision)g(number)g(of)h(the)
g(library)p eop end
%%Page: 125 131
TeXDict begin 125 130 bop 3764 299 a Fi(125)0 555 y Fe(width)46
b(-)i(\(integer\))d(width)h(of)i(the)f(character)e(string)h(field)0
668 y(xcol)h(-)g(\(integer\))e(number)h(of)i(the)f(column)f(containing)
f(the)i(X)g(coordinate)e(values)0 781 y(xinc)i(-)g(\(double)f
(precision\))f(X)i(axis)g(coordinate)e(increment)g(at)i(reference)f
(pixel)g(\(deg\))0 894 y(xpix)h(-)g(\(double)f(precision\))f(X)i(axis)g
(pixel)f(location)0 1007 y(xpos)h(-)g(\(double)f(precision\))f(X)i
(axis)g(celestial)e(coordinate)g(\(usually)h(RA\))h(\(deg\))0
1120 y(xrpix)f(-)i(\(double)e(precision\))f(X)i(axis)g(reference)e
(pixel)h(array)h(location)0 1233 y(xrval)f(-)i(\(double)e(precision\))f
(X)i(axis)g(coordinate)e(value)h(at)h(the)g(reference)e(pixel)i
(\(deg\))0 1346 y(ycol)g(-)g(\(integer\))e(number)h(of)i(the)f(column)f
(containing)f(the)i(X)g(coordinate)e(values)0 1458 y(year)i(-)g
(\(integer\))e(last)i(2)g(digits)g(of)g(the)g(year)f(\(00)h(-)h(99\))0
1571 y(yinc)f(-)g(\(double)f(precision\))f(Y)i(axis)g(coordinate)e
(increment)g(at)i(reference)f(pixel)g(\(deg\))0 1684
y(ypix)h(-)g(\(double)f(precision\))f(y)i(axis)g(pixel)f(location)0
1797 y(ypos)h(-)g(\(double)f(precision\))f(y)i(axis)g(celestial)e
(coordinate)g(\(usually)h(DEC\))g(\(deg\))0 1910 y(yrpix)g(-)i
(\(double)e(precision\))f(Y)i(axis)g(reference)e(pixel)h(array)h
(location)0 2023 y(yrval)f(-)i(\(double)e(precision\))f(Y)i(axis)g
(coordinate)e(value)h(at)h(the)g(reference)e(pixel)i(\(deg\))p
eop end
%%Page: 126 132
TeXDict begin 126 131 bop 0 299 a Fi(126)1779 b Fg(CHAPTER)30
b(11.)112 b(P)-8 b(ARAMETER)30 b(DEFINITIONS)p eop end
%%Page: 127 133
TeXDict begin 127 132 bop 0 1225 a Ff(Chapter)65 b(12)0
1687 y Fl(FITSIO)76 b(Error)h(Status)h(Co)6 b(des)0 2180
y Fe(Status)46 b(codes)g(in)i(the)f(range)f(-99)h(to)g(-999)94
b(and)47 b(1)h(to)f(999)g(are)g(reserved)e(for)i(future)0
2293 y(FITSIO)f(use.)95 2518 y(0)96 b(OK,)47 b(no)g(error)0
2631 y(101)95 b(input)46 b(and)h(output)f(files)g(are)h(the)g(same)0
2744 y(103)95 b(too)47 b(many)f(FITS)h(files)f(open)h(at)g(once;)f(all)
h(internal)f(buffers)g(full)0 2857 y(104)95 b(error)46
b(opening)g(existing)f(file)0 2970 y(105)95 b(error)46
b(creating)g(new)g(FITS)h(file;)f(\(does)h(a)g(file)g(with)g(this)f
(name)h(already)f(exist?\))0 3083 y(106)95 b(error)46
b(writing)g(record)g(to)h(FITS)g(file)0 3196 y(107)95
b(end-of-file)44 b(encountered)h(while)h(reading)g(record)g(from)h
(FITS)g(file)0 3309 y(108)95 b(error)46 b(reading)g(record)g(from)h
(file)0 3422 y(110)95 b(error)46 b(closing)g(FITS)g(file)0
3535 y(111)95 b(internal)45 b(array)i(dimensions)e(exceeded)0
3648 y(112)95 b(Cannot)46 b(modify)g(file)g(with)h(readonly)f(access)0
3760 y(113)95 b(Could)46 b(not)h(allocate)e(memory)0
3873 y(114)95 b(illegal)45 b(logical)h(unit)h(number;)f(must)g(be)i
(between)d(1)j(-)f(199,)g(inclusive)0 3986 y(115)95 b(NULL)46
b(input)h(pointer)e(to)j(routine)0 4099 y(116)95 b(error)46
b(seeking)g(position)f(in)j(file)0 4325 y(121)95 b(invalid)45
b(URL)i(prefix)f(on)i(file)e(name)0 4438 y(122)95 b(tried)46
b(to)h(register)f(too)h(many)f(IO)h(drivers)0 4551 y(123)95
b(driver)46 b(initialization)e(failed)0 4664 y(124)95
b(matching)45 b(driver)h(is)h(not)g(registered)0 4777
y(125)95 b(failed)46 b(to)h(parse)f(input)h(file)f(URL)0
4890 y(126)95 b(parse)46 b(error)g(in)i(range)e(list)0
5115 y(151)95 b(bad)47 b(argument)e(in)i(shared)f(memory)g(driver)0
5228 y(152)95 b(null)46 b(pointer)g(passed)g(as)h(an)h(argument)0
5341 y(153)95 b(no)47 b(more)f(free)h(shared)f(memory)g(handles)0
5454 y(154)95 b(shared)46 b(memory)g(driver)g(is)h(not)g(initialized)0
5567 y(155)95 b(IPC)47 b(error)f(returned)f(by)j(a)f(system)f(call)0
5680 y(156)95 b(no)47 b(memory)f(in)h(shared)f(memory)g(driver)1882
5942 y Fi(127)p eop end
%%Page: 128 134
TeXDict begin 128 133 bop 0 299 a Fi(128)1613 b Fg(CHAPTER)30
b(12.)112 b(FITSIO)30 b(ERR)m(OR)g(ST)-8 b(A)g(TUS)30
b(CODES)0 555 y Fe(157)95 b(resource)45 b(deadlock)h(would)g(occur)0
668 y(158)95 b(attempt)45 b(to)j(open/create)c(lock)j(file)g(failed)0
781 y(159)95 b(shared)46 b(memory)g(block)g(cannot)g(be)h(resized)f(at)
h(the)g(moment)0 1120 y(201)95 b(header)46 b(not)h(empty;)f(can't)g
(write)g(required)g(keywords)0 1233 y(202)95 b(specified)45
b(keyword)h(name)g(was)h(not)g(found)g(in)g(the)g(header)0
1346 y(203)95 b(specified)45 b(header)h(record)g(number)g(is)h(out)g
(of)g(bounds)0 1458 y(204)95 b(keyword)45 b(value)i(field)f(is)h(blank)
0 1571 y(205)95 b(keyword)45 b(value)i(string)f(is)h(missing)f(the)h
(closing)f(quote)g(character)0 1684 y(206)95 b(illegal)45
b(indexed)h(keyword)g(name)h(\(e.g.)f('TFORM1000'\))0
1797 y(207)95 b(illegal)45 b(character)h(in)h(keyword)f(name)g(or)i
(header)e(record)0 1910 y(208)95 b(keyword)45 b(does)i(not)g(have)g
(expected)e(name.)i(Keyword)e(out)i(of)g(sequence?)0
2023 y(209)95 b(keyword)45 b(does)i(not)g(have)g(expected)e(integer)h
(value)0 2136 y(210)95 b(could)46 b(not)h(find)g(the)f(required)g(END)h
(header)f(keyword)0 2249 y(211)95 b(illegal)45 b(BITPIX)i(keyword)e
(value)0 2362 y(212)95 b(illegal)45 b(NAXIS)i(keyword)f(value)0
2475 y(213)95 b(illegal)45 b(NAXISn)i(keyword)e(value:)h(must)h(be)g(0)
h(or)f(positive)e(integer)0 2588 y(214)95 b(illegal)45
b(PCOUNT)i(keyword)e(value)0 2700 y(215)95 b(illegal)45
b(GCOUNT)i(keyword)e(value)0 2813 y(216)95 b(illegal)45
b(TFIELDS)h(keyword)g(value)0 2926 y(217)95 b(negative)45
b(ASCII)i(or)g(binary)f(table)g(width)h(value)f(\(NAXIS1\))0
3039 y(218)95 b(negative)45 b(number)h(of)h(rows)g(in)g(ASCII)g(or)g
(binary)f(table)g(\(NAXIS2\))0 3152 y(219)95 b(column)46
b(name)g(\(TTYPE)g(keyword\))g(not)h(found)0 3265 y(220)95
b(illegal)45 b(SIMPLE)i(keyword)e(value)0 3378 y(221)95
b(could)46 b(not)h(find)g(the)f(required)g(SIMPLE)g(header)g(keyword)0
3491 y(222)95 b(could)46 b(not)h(find)g(the)f(required)g(BITPIX)g
(header)g(keyword)0 3604 y(223)95 b(could)46 b(not)h(find)g(the)f
(required)g(NAXIS)g(header)g(keyword)0 3717 y(224)95
b(could)46 b(not)h(find)g(all)f(the)h(required)f(NAXISn)g(keywords)g
(in)h(the)g(header)0 3830 y(225)95 b(could)46 b(not)h(find)g(the)f
(required)g(XTENSION)g(header)g(keyword)0 3942 y(226)95
b(the)47 b(CHDU)f(is)h(not)g(an)g(ASCII)g(table)f(extension)0
4055 y(227)95 b(the)47 b(CHDU)f(is)h(not)g(a)h(binary)e(table)g
(extension)0 4168 y(228)95 b(could)46 b(not)h(find)g(the)f(required)g
(PCOUNT)g(header)g(keyword)0 4281 y(229)95 b(could)46
b(not)h(find)g(the)f(required)g(GCOUNT)g(header)g(keyword)0
4394 y(230)95 b(could)46 b(not)h(find)g(the)f(required)g(TFIELDS)g
(header)g(keyword)0 4507 y(231)95 b(could)46 b(not)h(find)g(all)f(the)h
(required)f(TBCOLn)g(keywords)g(in)h(the)g(header)0 4620
y(232)95 b(could)46 b(not)h(find)g(all)f(the)h(required)f(TFORMn)g
(keywords)g(in)h(the)g(header)0 4733 y(233)95 b(the)47
b(CHDU)f(is)h(not)g(an)g(IMAGE)g(extension)0 4846 y(234)95
b(illegal)45 b(TBCOL)i(keyword)f(value;)g(out)h(of)g(range)0
4959 y(235)95 b(this)46 b(operation)g(only)g(allowed)g(for)h(ASCII)f
(or)h(BINARY)g(table)f(extension)0 5072 y(236)95 b(column)46
b(is)h(too)g(wide)f(to)i(fit)f(within)f(the)h(specified)e(width)h(of)h
(the)g(ASCII)g(table)0 5185 y(237)95 b(the)47 b(specified)e(column)h
(name)h(template)e(matched)h(more)h(than)f(one)h(column)f(name)0
5297 y(241)95 b(binary)46 b(table)g(row)h(width)f(is)i(not)e(equal)h
(to)g(the)g(sum)g(of)g(the)g(field)f(widths)0 5410 y(251)95
b(unrecognizable)44 b(type)i(of)h(FITS)g(extension)0
5523 y(252)95 b(unrecognizable)44 b(FITS)i(record)0 5636
y(253)95 b(END)47 b(keyword)e(contains)h(non-blank)f(characters)g(in)i
(columns)f(9-80)p eop end
%%Page: 129 135
TeXDict begin 129 134 bop 3764 299 a Fi(129)0 555 y Fe(254)95
b(Header)46 b(fill)g(area)h(contains)f(non-blank)f(characters)0
668 y(255)95 b(Data)46 b(fill)h(area)g(contains)e(non-blank)g(on)j
(non-zero)d(values)0 781 y(261)95 b(unable)46 b(to)h(parse)f(the)h
(TFORM)g(keyword)e(value)i(string)0 894 y(262)95 b(unrecognizable)44
b(TFORM)i(datatype)f(code)0 1007 y(263)95 b(illegal)45
b(TDIMn)i(keyword)f(value)0 1233 y(301)95 b(illegal)45
b(HDU)i(number;)f(less)h(than)f(1)i(or)f(greater)f(than)h(internal)e
(buffer)h(size)0 1346 y(302)95 b(column)46 b(number)g(out)h(of)g(range)
f(\(1)h(-)h(999\))0 1458 y(304)95 b(attempt)45 b(to)j(move)e(to)h
(negative)f(file)h(record)f(number)0 1571 y(306)95 b(attempted)45
b(to)i(read)g(or)g(write)f(a)i(negative)d(number)h(of)i(bytes)e(in)h
(the)g(FITS)g(file)0 1684 y(307)95 b(illegal)45 b(starting)h(row)h
(number)f(for)h(table)f(read)h(or)g(write)f(operation)0
1797 y(308)95 b(illegal)45 b(starting)h(element)g(number)g(for)h(table)
f(read)h(or)g(write)f(operation)0 1910 y(309)95 b(attempted)45
b(to)i(read)g(or)g(write)f(character)g(string)g(in)h(non-character)d
(table)i(column)0 2023 y(310)95 b(attempted)45 b(to)i(read)g(or)g
(write)f(logical)g(value)g(in)i(non-logical)c(table)j(column)0
2136 y(311)95 b(illegal)45 b(ASCII)i(table)f(TFORM)h(format)f(code)g
(for)h(attempted)e(operation)0 2249 y(312)95 b(illegal)45
b(binary)i(table)f(TFORM)g(format)g(code)h(for)g(attempted)e(operation)
0 2362 y(314)95 b(value)46 b(for)h(undefined)e(pixels)h(has)h(not)g
(been)g(defined)0 2475 y(317)95 b(attempted)45 b(to)i(read)g(or)g
(write)f(descriptor)f(in)i(a)h(non-descriptor)c(field)0
2588 y(320)95 b(number)46 b(of)h(array)f(dimensions)f(out)i(of)g(range)
0 2700 y(321)95 b(first)46 b(pixel)g(number)g(is)i(greater)d(than)i
(the)g(last)g(pixel)f(number)0 2813 y(322)95 b(attempt)45
b(to)j(set)f(BSCALE)f(or)h(TSCALn)f(scaling)g(parameter)f(=)i(0)0
2926 y(323)95 b(illegal)45 b(axis)i(length)f(less)h(than)f(1)0
3152 y(340)h(NOT_GROUP_TABLE)d(340)142 b(Grouping)45
b(function)h(error)0 3265 y(341)95 b(HDU_ALREADY_MEMBER)0
3378 y(342)47 b(MEMBER_NOT_FOUND)0 3491 y(343)g(GROUP_NOT_FOUND)0
3604 y(344)g(BAD_GROUP_ID)0 3717 y(345)g(TOO_MANY_HDUS_TRACKED)0
3830 y(346)g(HDU_ALREADY_TRACKED)0 3942 y(347)g(BAD_OPTION)0
4055 y(348)g(IDENTICAL_POINTERS)0 4168 y(349)g(BAD_GROUP_ATTACH)0
4281 y(350)g(BAD_GROUP_DETACH)0 4507 y(360)g(NGP_NO_MEMORY)665
b(malloc)46 b(failed)0 4620 y(361)h(NGP_READ_ERR)713
b(read)46 b(error)h(from)f(file)0 4733 y(362)h(NGP_NUL_PTR)761
b(null)46 b(pointer)g(passed)g(as)h(an)g(argument.)1575
4846 y(Passing)f(null)g(pointer)g(as)h(a)h(name)f(of)1575
4959 y(template)f(file)g(raises)g(this)h(error)0 5072
y(363)g(NGP_EMPTY_CURLINE)473 b(line)46 b(read)h(seems)f(to)h(be)h
(empty)e(\(used)1575 5185 y(internally\))0 5297 y(364)h
(NGP_UNREAD_QUEUE_FULL)281 b(cannot)46 b(unread)g(more)g(then)h(1)g
(line)g(\(or)g(single)1575 5410 y(line)g(twice\))0 5523
y(365)g(NGP_INC_NESTING)569 b(too)46 b(deep)h(include)f(file)h(nesting)
e(\(infinite)1575 5636 y(loop,)h(template)g(includes)f(itself)i(?\))p
eop end
%%Page: 130 136
TeXDict begin 130 135 bop 0 299 a Fi(130)1613 b Fg(CHAPTER)30
b(12.)112 b(FITSIO)30 b(ERR)m(OR)g(ST)-8 b(A)g(TUS)30
b(CODES)0 555 y Fe(366)47 b(NGP_ERR_FOPEN)665 b(fopen\(\))45
b(failed,)h(cannot)g(open)h(template)e(file)0 668 y(367)i(NGP_EOF)953
b(end)46 b(of)i(file)e(encountered)f(and)i(not)g(expected)0
781 y(368)g(NGP_BAD_ARG)761 b(bad)46 b(arguments)g(passed.)g(Usually)f
(means)1575 894 y(internal)h(parser)g(error.)g(Should)g(not)h(happen)0
1007 y(369)g(NGP_TOKEN_NOT_EXPECT)329 b(token)46 b(not)h(expected)e
(here)0 1233 y(401)95 b(error)46 b(attempting)f(to)i(convert)f(an)h
(integer)f(to)h(a)h(formatted)d(character)g(string)0
1346 y(402)95 b(error)46 b(attempting)f(to)i(convert)f(a)h(real)g
(value)f(to)i(a)f(formatted)e(character)h(string)0 1458
y(403)95 b(cannot)46 b(convert)g(a)h(quoted)f(string)g(keyword)g(to)h
(an)g(integer)0 1571 y(404)95 b(attempted)45 b(to)i(read)g(a)g
(non-logical)e(keyword)h(value)g(as)h(a)h(logical)e(value)0
1684 y(405)95 b(cannot)46 b(convert)g(a)h(quoted)f(string)g(keyword)g
(to)h(a)h(real)e(value)0 1797 y(406)95 b(cannot)46 b(convert)g(a)h
(quoted)f(string)g(keyword)g(to)h(a)h(double)e(precision)f(value)0
1910 y(407)95 b(error)46 b(attempting)f(to)i(read)g(character)e(string)
h(as)h(an)h(integer)0 2023 y(408)95 b(error)46 b(attempting)f(to)i
(read)g(character)e(string)h(as)h(a)h(real)e(value)0
2136 y(409)95 b(error)46 b(attempting)f(to)i(read)g(character)e(string)
h(as)h(a)h(double)e(precision)f(value)0 2249 y(410)95
b(bad)47 b(keyword)e(datatype)h(code)0 2362 y(411)95
b(illegal)45 b(number)i(of)g(decimal)f(places)g(while)g(formatting)f
(floating)h(point)g(value)0 2475 y(412)95 b(numerical)45
b(overflow)g(during)i(implicit)e(datatype)h(conversion)0
2588 y(413)95 b(error)46 b(compressing)f(image)0 2700
y(414)95 b(error)46 b(uncompressing)e(image)0 2813 y(420)95
b(error)46 b(in)h(date)g(or)g(time)g(conversion)0 3039
y(431)95 b(syntax)46 b(error)g(in)h(parser)f(expression)0
3152 y(432)95 b(expression)45 b(did)i(not)f(evaluate)g(to)h(desired)f
(type)0 3265 y(433)95 b(vector)46 b(result)g(too)h(large)f(to)h(return)
f(in)i(array)0 3378 y(434)95 b(data)46 b(parser)g(failed)g(not)h(sent)g
(an)g(out)g(column)0 3491 y(435)95 b(bad)47 b(data)f(encounter)f(while)
i(parsing)f(column)0 3604 y(436)95 b(parse)46 b(error:)g(output)g(file)
h(not)g(of)g(proper)f(type)0 3830 y(501)95 b(celestial)45
b(angle)h(too)h(large)g(for)f(projection)0 3942 y(502)95
b(bad)47 b(celestial)e(coordinate)g(or)i(pixel)f(value)0
4055 y(503)95 b(error)46 b(in)h(celestial)e(coordinate)g(calculation)0
4168 y(504)95 b(unsupported)44 b(type)j(of)g(celestial)e(projection)0
4281 y(505)95 b(required)45 b(celestial)g(coordinate)g(keywords)h(not)h
(found)0 4394 y(506)95 b(approximate)44 b(wcs)j(keyword)f(values)g
(were)h(returned)p eop end
%%Trailer

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