1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> 2 3<!--Converted with LaTeX2HTML 2018.3 (Released July 19, 2018) --> 4<HTML lang="EN"> 5<HEAD> 6<TITLE>input_tod*</TITLE> 7<META NAME="description" CONTENT="input_tod*"> 8<META NAME="keywords" CONTENT="subroutines"> 9<META NAME="resource-type" CONTENT="document"> 10<META NAME="distribution" CONTENT="global"> 11 12<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8"> 13<META NAME="viewport" CONTENT="width=device-width, initial-scale=1.0"> 14<META NAME="Generator" CONTENT="LaTeX2HTML v2018.3"> 15 <link rel='apple-touch-icon' sizes='180x180' href='images/favicons/apple-touch-icon.png?v=2017'> 16 <link rel='icon' type='image/png' sizes='32x32' href='images/favicons/favicon-32x32.png?v=2017'> 17 <link rel='icon' type='image/png' sizes='16x16' href='images/favicons/favicon-16x16.png?v=2017'> 18 <link rel='manifest' href='images/favicons/manifest.json?v=2017'> 19 <link rel='mask-icon' href='images/favicons/safari-pinned-tab.svg?v=2017' color='#5bbad5'> 20 <link rel='shortcut icon' href='images/favicons/favicon.ico?v=2017'> 21 <meta name='apple-mobile-web-app-title' content='HEALPix'> 22 <meta name='application-name' content='HEALPix'> 23 <meta name='msapplication-config' content='images/favicons/browserconfig.xml?v=2017'> 24 <meta name='theme-color' content='#ffffff'> 25 26<LINK REL="STYLESHEET" HREF="subroutines.css"> 27 28<LINK REL="next" HREF="sub_long_count_long_size.htm"> 29<LINK REL="previous" HREF="sub_input_map.htm"> 30<LINK REL="next" HREF="sub_long_count_long_size.htm"> 31</HEAD> 32 33<body text="#000000" bgcolor="#FFFFFA"> 34 35<DIV CLASS="navigation"><!--Navigation Panel--> 36<A 37 HREF="sub_input_map.htm"> 38<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 39<A 40 HREF="sub_HEALPix_F90_subroutines.htm"> 41<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 42<A 43 HREF="sub_long_count_long_size.htm"> 44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 45<A ID="tex2html384" 46 HREF="sub_TABLE_CONTENTS.htm"> 47<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 48<BR> 49<B> Previous:</B> <A 50 HREF="sub_input_map.htm">input_map*</A> 51 52<B>Up:</B> <A 53 HREF="sub_HEALPix_F90_subroutines.htm">HEALPix/F90 subroutines</A> 54 55<B> Next:</B> <A 56 HREF="sub_long_count_long_size.htm">long_count, long_size</A> 57<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 58<!--End of Navigation Panel--> 59 60<H1><A ID="SECTION4600"></A> 61<A ID="sub:input_tod"></A> 62<BR> 63 64</H1> 65 66<P> 67<b><font size=+6><FONT COLOR="#CC0000">input_tod*</FONT></font></b><hr> 68<H3>This routine reads a large binary table (for instance a Time Ordered Data 69 set) from a FITS file. The user can choose to read only a section of the table, 70 starting from an arbitrary position. 71The data can be read into a single or double precision array.</H3> 72Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/f90/mod/fitstools.F90"><b>src/f90/mod/fitstools.F90</b></a> 73 74<P> 75<hr><h1>FORMAT </h1><blockquote><h3>call <FONT COLOR="#CC0000">input_tod*</FONT>( 76<A HREF="#sub:input_tod:filename">filename</A>, <A HREF="#sub:input_tod:tod">tod</A>, <A HREF="#sub:input_tod:npix">npix</A>, <A HREF="#sub:input_tod:ntods">ntods</A><i><font color="#224422">[, <A HREF="#sub:input_tod:header">header</A>, <A HREF="#sub:input_tod:firstpix">firstpix</A>, <A HREF="#sub:input_tod:fmissval">fmissval</A>]</font></i> 77)</h3></blockquote> 78Arguments appearing in <i><font color="#224422">italic</font></i> are 79optional. 80 81<P> 82<hr><H1>ARGUMENTS</H1> 83 84<TABLE CELLPADDING=3 BORDER="1"> 85<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=150><SPAN CLASS="textbf">name & dimensionality</SPAN></TH> 86<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=25><SPAN CLASS="textbf">kind</SPAN></TH> 87<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=25><SPAN CLASS="textbf">in/out</SPAN></TH> 88<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=250><SPAN CLASS="textbf">description</SPAN></TH> 89</TR> 90<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150> </TD> 91<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25> </TD> 92<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25> </TD> 93<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250> </TD> 94</TR> 95<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150> 96filename<A ID="sub:input_tod:filename"></A>(LEN=<tt>filenamelen</tt>)</TD> 97<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>CHR</TD> 98<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 99<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>FITS file to be read from</TD> 100</TR> 101<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>tod<A ID="sub:input_tod:tod"></A>(0:npix-1,1:ntods)</TD> 102<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>SP/ DP</TD> 103<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 104<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>array constructed 105 from the data present in the file (from the sample <TT>firstpix</TT> to <TT>firstpix + npix</TT> - 1. Missing pixels or time 106 samples are filled with <TT>fmissval</TT>.</TD> 107</TR> 108<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>npix<A ID="sub:input_tod:npix"></A></TD> 109<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>I8B</TD> 110<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 111<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>number of pixels or samples to be read. See Note below.</TD> 112</TR> 113<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>ntods<A ID="sub:input_tod:ntods"></A></TD> 114<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>I4B</TD> 115<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 116<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>number of columns to read</TD> 117</TR> 118<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><i><font color="#224422">header<A ID="sub:input_tod:header"></A></font></i>(LEN=80)(1:)</TD> 119<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>CHR</TD> 120<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 121<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>FITS extension header</TD> 122</TR> 123<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><i><font color="#224422">firstpix<A ID="sub:input_tod:firstpix"></A></font></i></TD> 124<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>I8B</TD> 125<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 126<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>first pixel (or time sample) to read from 127 (0 based). <b>default:</b>0. See Note below.</TD> 128</TR> 129<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><i><font color="#224422">fmissval<A ID="sub:input_tod:fmissval"></A></font></i></TD> 130<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>SP/ DP</TD> 131<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 132<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>value to be given to missing pixels, its default 133 value is 0. Should be of the same type as <TT>tod</TT>.</TD> 134</TR> 135</TABLE> 136<B>Note :</B> Indices and number of data elements larger than 137 <SPAN CLASS="MATH">2<SUP>31</SUP></SPAN> are only accessible in FITS files on computers with 64 bit 138 enabled compilers and with some specific compilation options of 139 cfitsio (see cfitsio documentation). 140 141 142<P> 143<hr><H1>MODULES & ROUTINES</H1><H3>This section lists the modules and routines used by <FONT COLOR="#CC0000">input_tod*</FONT>.</h3> 144 <DL COMPACT><DT> 145<B><SPAN CLASS="textbf">fitstools</SPAN></B> 146<DD>module, containing: 147 <DT> 148<B>printerror</B> 149<DD>routine for printing FITS error messages. 150 <DT> 151<B><SPAN CLASS="textbf">cfitsio</SPAN></B> 152<DD>library for FITS file handling. 153 </DL> 154 155<P> 156<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">input_tod*</FONT></b></h3> 157 158 <DL COMPACT><DT> 159<B>anafast</B> 160<DD>executable that reads a <b>HEALPix</b> map and analyses it. 161 <DT> 162<B>synfast</B> 163<DD>executable that generate full sky <b>HEALPix</b> maps 164 <DT> 165<B><A HREF="sub_getsize_fits.htm#sub:getsize_fits">getsize_fits</A></B> 166<DD>subroutine to know the size of a FITS file. 167 <DT> 168<B><A HREF="sub_write_bintabh.htm#sub:write_bintabh">write_bintabh</A></B> 169<DD>subroutine to write large arrays into FITS files 170 <DT> 171<B><A HREF="sub_output_map.htm#sub:output_map">output_map</A></B> 172<DD>subroutine to write a FITS file from a <b>HEALPix</b> map 173 <DT> 174<B><A HREF="sub_input_map.htm#sub:input_map">input_map</A></B> 175<DD>subroutine to read a <b>HEALPix</b> map 176 (either full sky of cut sky) from a FITS file 177 </DL> 178 179<P> 180 181<P> 182 183 184<P> 185 186<P> 187 188<DIV CLASS="navigation"><HR> 189<!--Navigation Panel--> 190<A 191 HREF="sub_input_map.htm"> 192<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 193<A 194 HREF="sub_HEALPix_F90_subroutines.htm"> 195<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 196<A 197 HREF="sub_long_count_long_size.htm"> 198<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 199<A ID="tex2html384" 200 HREF="sub_TABLE_CONTENTS.htm"> 201<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 202<BR> 203<B> Previous:</B> <A 204 HREF="sub_input_map.htm">input_map*</A> 205 206<B>Up:</B> <A 207 HREF="sub_HEALPix_F90_subroutines.htm">HEALPix/F90 subroutines</A> 208 209<B> Next:</B> <A 210 HREF="sub_long_count_long_size.htm">long_count, long_size</A> 211<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 212<!--End of Navigation Panel--> 213<ADDRESS> 214Version 3.50, 2018-12-10 215</ADDRESS> 216</BODY> 217</HTML> 218