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_healpix_map</TITLE> 7<META NAME="description" CONTENT="read_healpix_map"> 8<META NAME="keywords" CONTENT="csub"> 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="csub.css"> 27 28<LINK REL="next" HREF="csub_vec2ang.htm"> 29<LINK REL="previous" HREF="csub_pix2xxx_ang2xxx_vec2xxx_nes.htm"> 30<LINK REL="next" HREF="csub_vec2ang.htm"> 31</HEAD> 32 33<body text="#000000" bgcolor="#FFFFFA"> 34 35<DIV CLASS="navigation"><!--Navigation Panel--> 36<A 37 HREF="csub_pix2xxx_ang2xxx_vec2xxx_nes.htm"> 38<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 39<A 40 HREF="csub_HEALPix_C_subroutines.htm"> 41<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 42<A 43 HREF="csub_vec2ang.htm"> 44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 45<A ID="tex2html50" 46 HREF="csub_Contents.htm"> 47<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 48<BR> 49<B> Previous:</B> <A 50 HREF="csub_pix2xxx_ang2xxx_vec2xxx_nes.htm">pix2xxx, ang2xxx, vec2xxx, nest2ring, ring2nest</A> 51 52<B>Up:</B> <A 53 HREF="csub_HEALPix_C_subroutines.htm">HEALPix/C subroutines</A> 54 55<B> Next:</B> <A 56 HREF="csub_vec2ang.htm">vec2ang</A> 57<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 58<!--End of Navigation Panel--> 59 60<H1><A ID="SECTION1100"></A> 61<A ID="csub:read_healpix_map"></A> 62<BR> 63 64</H1> 65 66<P> 67<b><font size=+6><FONT COLOR="#CC0000">read_healpix_map</FONT></font></b><hr> 68<H3>This routine reads a full sky <b>HEALPix</b> map from a FITS file</H3> 69Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/C/subs/chealpix.c"><b>src/C/subs/chealpix.c</b></a> 70 71<P> 72<hr><h1>FORMAT </h1><h3> 73float *read_healpix_map(char *infile, long *nside, char *coordsys, char *ordering) 74</h3> 75 76<P> 77<hr><H1>ARGUMENTS</H1> 78 79<TABLE CELLPADDING=3 BORDER="1"> 80<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=150><SPAN CLASS="textbf">name&dimensionality</SPAN></TH> 81<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=25><SPAN CLASS="textbf">kind</SPAN></TH> 82<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=25><SPAN CLASS="textbf">in/out</SPAN></TH> 83<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=250><SPAN CLASS="textbf">description</SPAN></TH> 84</TR> 85<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150> </TD> 86<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25> </TD> 87<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25> </TD> 88<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250> </TD> 89</TR> 90<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150> 91<FONT COLOR="#CC0000">read_healpix_map</FONT></TD> 92<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>float</TD> 93<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 94<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>array containing the map read from the file</TD> 95</TR> 96<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>infile</TD> 97<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>char</TD> 98<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>IN</TD> 99<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>FITS file containing a full sky to be read</TD> 100</TR> 101<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>nside</TD> 102<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>long</TD> 103<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 104<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250><b>HEALPix</b> resolution parameter of the map</TD> 105</TR> 106<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>coordsys</TD> 107<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>char</TD> 108<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 109<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>astronomical coordinate system of pixelation 110 (either 'C', 'E' or 'G' standing respectively for Celestial=equatorial, 111 Ecliptic or Galactic)</TD> 112</TR> 113<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150>ordering</TD> 114<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>char</TD> 115<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=25>OUT</TD> 116<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250><b>HEALPix</b> pixel ordering (either 'RING' or 'NESTED')</TD> 117</TR> 118</TABLE> 119 120<P> 121<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">read_healpix_map</FONT></b></h3> 122 123 <DL COMPACT><DT> 124<B>anafast</B> 125<DD>executable that reads a <b>HEALPix</b> map and analyses it. 126 <DT> 127<B>synfast</B> 128<DD>executable that generate full sky <b>HEALPix</b> maps 129<DT> 130<B><A HREF="csub_write_healpix_map.htm#csub:write_healpix_map">write_healpix_map</A></B> 131<DD>subroutine to write <b>HEALPix</b> maps 132 <DT> 133<B><A HREF="csub_get_fits_size.htm#csub:get_fits_size">get_fits_size</A></B> 134<DD>subroutine to determine 135 the size of a map 136 </DL> 137 138<P> 139 140<P> 141 142 143<P> 144 145<P> 146 147<DIV CLASS="navigation"><HR> 148<!--Navigation Panel--> 149<A 150 HREF="csub_pix2xxx_ang2xxx_vec2xxx_nes.htm"> 151<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 152<A 153 HREF="csub_HEALPix_C_subroutines.htm"> 154<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 155<A 156 HREF="csub_vec2ang.htm"> 157<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 158<A ID="tex2html50" 159 HREF="csub_Contents.htm"> 160<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 161<BR> 162<B> Previous:</B> <A 163 HREF="csub_pix2xxx_ang2xxx_vec2xxx_nes.htm">pix2xxx, ang2xxx, vec2xxx, nest2ring, ring2nest</A> 164 165<B>Up:</B> <A 166 HREF="csub_HEALPix_C_subroutines.htm">HEALPix/C subroutines</A> 167 168<B> Next:</B> <A 169 HREF="csub_vec2ang.htm">vec2ang</A> 170<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 171<!--End of Navigation Panel--> 172<ADDRESS> 173Version 3.50, 2018-12-10 174</ADDRESS> 175</BODY> 176</HTML> 177