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>read_conbintab*</TITLE> 7<META NAME="description" CONTENT="read_conbintab*"> 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_read_dbintab.htm"> 29<LINK REL="previous" HREF="sub_read_bintab.htm"> 30<LINK REL="next" HREF="sub_read_dbintab.htm"> 31</HEAD> 32 33<body text="#000000" bgcolor="#FFFFFA"> 34 35<DIV CLASS="navigation"><!--Navigation Panel--> 36<A 37 HREF="sub_read_bintab.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_read_dbintab.htm"> 44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 45<A ID="tex2html466" 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_read_bintab.htm">read_bintab*</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_read_dbintab.htm">read_dbintab</A> 57<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 58<!--End of Navigation Panel--> 59 60<H1><A ID="SECTION8700"></A> 61<A ID="sub:read_conbintab"></A> 62<BR> 63 64</H1> 65 66<P> 67<b><font size=+6><FONT COLOR="#CC0000">read_conbintab*</FONT></font></b><hr> 68<H3>This routine reads a FITS file containing <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 69 ALT="$a_{\ell m}$"></SPAN> values for constained 70 realisation. The FITS file is supposed to contain one integer column with 71 <!-- MATH 72 $index=\ell^2+\ell+m+1$ 73 --> 74<SPAN CLASS="MATH"><IMG STYLE="height: 2.04ex; vertical-align: -0.28ex; " SRC="sub_img73.png" 75 ALT="$index=\ell^2+\ell+m+1$"></SPAN> and 2 or 4 single (or double) precision columns with 76 real/imaginary <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 77 ALT="$a_{\ell m}$"></SPAN> values and real/imaginary standard deviation on 78 these <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 79 ALT="$a_{\ell m}$"></SPAN>. It is supposed to contain either 1 or 3 extension(s) containing 80 respectively the <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 81 ALT="$a_{\ell m}$"></SPAN> for T and if applicable E and B.</H3> 82Location 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> 83 84<P> 85<hr><h1>FORMAT </h1><blockquote><h3>call <FONT COLOR="#CC0000">read_conbintab*</FONT>( 86<A HREF="#sub:read_conbintab:filename">filename</A>, <A HREF="#sub:read_conbintab:alms">alms</A>, <A HREF="#sub:read_conbintab:nalms">nalms</A>[, <A HREF="#sub:read_conbintab:units">units</A>, <A HREF="#sub:read_conbintab:extno">extno</A>] 87)</h3></blockquote> 88 89<P> 90<hr><H1>ARGUMENTS</H1> 91 92<TABLE CELLPADDING=3 BORDER="1"> 93<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=195><SPAN CLASS="textbf">name&dimensionality</SPAN></TH> 94<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=25><SPAN CLASS="textbf">kind</SPAN></TH> 95<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=30><SPAN CLASS="textbf">in/out</SPAN></TH> 96<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=200><SPAN CLASS="textbf">description</SPAN></TH> 97</TR> 98<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195> </TD> 99<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25> </TD> 100<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30> </TD> 101<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200> </TD> 102</TR> 103<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195> 104filename<A ID="sub:read_conbintab:filename"></A>(LEN=<tt>filenamelen</tt>)</TD> 105<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>CHR</TD> 106<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30>IN</TD> 107<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200>filename of FITS file containing <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 108 ALT="$a_{\ell m}$"></SPAN>.</TD> 109</TR> 110<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195>nalms<A ID="sub:read_conbintab:nalms"></A></TD> 111<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>I4B</TD> 112<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30>IN</TD> 113<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200>Number of <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 114 ALT="$a_{\ell m}$"></SPAN> values to read from the file.</TD> 115</TR> 116<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195>alms<A ID="sub:read_conbintab:alms"></A>(0:nalms-1,1:6)</TD> 117<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>SP/ DP</TD> 118<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30>OUT</TD> 119<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200>the <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 120 ALT="$a_{\ell m}$"></SPAN> read from the file. alms(i,1) 121 and alms(i,2) contain the <SPAN CLASS="MATH"><IMG STYLE="height: 1.69ex; vertical-align: -0.10ex; " SRC="sub_img21.png" 122 ALT="$\ell$"></SPAN> and <SPAN CLASS="MATH"><I>m</I></SPAN> values for the ith 123 <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 124 ALT="$a_{\ell m}$"></SPAN> . alms(i,3) and alms(i,4) contain the real and 125 imaginary value of the ith <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 126 ALT="$a_{\ell m}$"></SPAN> . Finally, the 127 standard deviation for the ith <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 128 ALT="$a_{\ell m}$"></SPAN> is contained in 129 alms(i,5) (real) and alms(i,6) (imaginary).</TD> 130</TR> 131<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195>units<A ID="sub:read_conbintab:units"></A>(len=20)(1:) (OPTIONAL)</TD> 132<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>CHR</TD> 133<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30>OUT</TD> 134<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200>character string containing the units of the 135 <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 136 ALT="$a_{\ell m}$"></SPAN></TD> 137</TR> 138<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=195>extno<A ID="sub:read_conbintab:extno"></A> (OPTIONAL)</TD> 139<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>I4B</TD> 140<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=30>IN</TD> 141<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=200>extension (0 based) of the FITS file to be read 142 143<P></TD> 144</TR> 145</TABLE> 146 147<P> 148<HR><H1>EXAMPLE:</H1> 149<tt>call read_conbintab ('alms.fits',alms,65*66/2) 150<BR></tt> 151<blockquote> 152Read 65*66/2 (the number of <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 153 ALT="$a_{\ell m}$"></SPAN> needed to fill the whole range from l=0 to l=64) <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 154 ALT="$a_{\ell m}$"></SPAN> values from the file `alms.fits' into the array alms(0:65*66/2-1,1:6). 155</blockquote> 156 157<P> 158<hr><H1>MODULES & ROUTINES</H1><H3>This section lists the modules and routines used by <FONT COLOR="#CC0000">read_conbintab*</FONT>.</h3> 159 <DL COMPACT><DT> 160<B><SPAN CLASS="textbf">fitstools</SPAN></B> 161<DD>module, containing: 162 <DT> 163<B>printerror</B> 164<DD>routine for printing FITS error messages. 165 <DT> 166<B><SPAN CLASS="textbf">cfitsio</SPAN></B> 167<DD>library for FITS file handling. 168 </DL> 169 170<P> 171<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">read_conbintab*</FONT></b></h3> 172 173 <DL COMPACT><DT> 174<B><A HREF="sub_alms2fits.htm#sub:alms2fits">alms2fits</A>, <A HREF="sub_dump_alms.htm#sub:dump_alms">dump_alms</A></B> 175<DD>routines to write <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 176 ALT="$a_{\ell m}$"></SPAN> to a FITS-file 177 <DT> 178<B><A HREF="sub_fits2alms.htm#sub:fits2alms">fits2alms</A></B> 179<DD>has the same function as read_conbintab but is more general. 180 <DT> 181<B><A HREF="sub_number_of_alms.htm#sub:number_of_alms">number_of_alms</A>, <A HREF="sub_getsize_fits.htm#sub:getsize_fits">getsize_fits</A></B> 182<DD>can be used to find out the number of <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="sub_img6.png" 183 ALT="$a_{\ell m}$"></SPAN> available in the file. 184 </DL> 185 186<P> 187 188<P> 189 190 191<P> 192 193<P> 194 195<DIV CLASS="navigation"><HR> 196<!--Navigation Panel--> 197<A 198 HREF="sub_read_bintab.htm"> 199<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 200<A 201 HREF="sub_HEALPix_F90_subroutines.htm"> 202<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 203<A 204 HREF="sub_read_dbintab.htm"> 205<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 206<A ID="tex2html466" 207 HREF="sub_TABLE_CONTENTS.htm"> 208<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 209<BR> 210<B> Previous:</B> <A 211 HREF="sub_read_bintab.htm">read_bintab*</A> 212 213<B>Up:</B> <A 214 HREF="sub_HEALPix_F90_subroutines.htm">HEALPix/F90 subroutines</A> 215 216<B> Next:</B> <A 217 HREF="sub_read_dbintab.htm">read_dbintab</A> 218<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 219<!--End of Navigation Panel--> 220<ADDRESS> 221Version 3.50, 2018-12-10 222</ADDRESS> 223</BODY> 224</HTML> 225