/usr/share/doc/libstarlink-ast-doc/node161.html is in libstarlink-ast-doc 8.6.2+dfsg-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Extracting Individual Cards from a FitsChan</TITLE>
<META NAME="description" CONTENT="Extracting Individual Cards from a FitsChan">
<META NAME="keywords" CONTENT="sun211">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sun211.css">
<LINK REL="next" HREF="node162.html">
<LINK REL="previous" HREF="node160.html">
<LINK REL="up" HREF="node155.html">
<LINK REL="next" HREF="node162.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html2122"
HREF="node162.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html2120"
HREF="node155.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html2114"
HREF="node160.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2123"
HREF="node162.html">The Native FitsChan Output</A>
<B> Up:</B> <A NAME="tex2html2121"
HREF="node155.html">Storing AST Objects in</A>
<B> Previous:</B> <A NAME="tex2html2115"
HREF="node160.html">Writing Native Objects to</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION000166000000000000000"></A><A NAME="ss:extractingfitscards"></A>
<BR>
Extracting Individual Cards from a FitsChan
</H2>
<P>
To examine the contents of the FitsChanFitsChan after writing the SkyFrameSkyFrame
above (§<A HREF="node160.html#ss:writingnativefits">16.5</A>), we must write a simple loop to
extract each card in turn and print it out. We must also remember to
rewind the FitsChan first, <SPAN CLASS="textit">e.g.</SPAN> using astClearastClear. The following
loop would do:
<P>
<SMALL CLASS="SMALL">
<BR>
<IMG
WIDTH="275" HEIGHT="128" ALIGN="BOTTOM" BORDER="0"
SRC="img259.png"
ALT="\begin{terminalv}
...">
<BR>
</SMALL>
<P>
Here, we have used the astFindFitsastFindFits function to find a FITS card by
keyword. It is given a keyword template of ``%f'', which matches any
FITS keyword, so it always finds the current card, which it
returns. Its fourth argument is set to 1, to indicate that the CardCard
attribute should be incremented afterwards so that the following card
will be found the next time around the loop. astFindFits returns zero
when it reaches the end-of-file and this terminates the loop.
<P>
If we were storing the FITS headers in an output FITS file instead of
printing them out, we might use a loop like this but replace
``printf'' with a suitable data storage operation. This would only be
necessary if we had not provided a sink function for the FitsChan
(§<A HREF="node169.html#ss:fitssourceandsink">16.14</A>).
<P>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html2122"
HREF="node162.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html2120"
HREF="node155.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html2114"
HREF="node160.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2123"
HREF="node162.html">The Native FitsChan Output</A>
<B> Up:</B> <A NAME="tex2html2121"
HREF="node155.html">Storing AST Objects in</A>
<B> Previous:</B> <A NAME="tex2html2115"
HREF="node160.html">Writing Native Objects to</A></DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
|