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>isynfast</TITLE> 7<META NAME="description" CONTENT="isynfast"> 8<META NAME="keywords" CONTENT="idl"> 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="idl.css"> 27 28<LINK REL="next" HREF="idl_lm2index.htm"> 29<LINK REL="previous" HREF="idl_ismoothing.htm"> 30<LINK REL="next" HREF="idl_lm2index.htm"> 31</HEAD> 32 33<body text="#000000" bgcolor="#FFFFFA"> 34 35<DIV CLASS="navigation"><!--Navigation Panel--> 36<A 37 HREF="idl_ismoothing.htm"> 38<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 39<A 40 HREF="idl_HEALPix_IDL_subroutines.htm"> 41<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 42<A 43 HREF="idl_lm2index.htm"> 44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 45<A ID="tex2html355" 46 HREF="idl_TABLE_CONTENTS.htm"> 47<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 48<BR> 49<B> Previous:</B> <A 50 HREF="idl_ismoothing.htm">ismoothing</A> 51 52<B>Up:</B> <A 53 HREF="idl_HEALPix_IDL_subroutines.htm">HEALPix/IDL subroutines</A> 54 55<B> Next:</B> <A 56 HREF="idl_lm2index.htm">lm2index</A> 57<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 58<!--End of Navigation Panel--> 59 60<H1><A ID="SECTION4100"></A> 61<A ID="idl:isynfast"></A> 62<BR> 63 64</H1> 65 66<P> 67<b><font size=+6><FONT COLOR="#CC0000">isynfast</FONT></font></b><hr> 68<H3>This IDL facility provides an interface to F90 '<A HREF="./fac_synfast.htm#fac:synfast">synfast</A>' facility. It can be 69used to generate sky maps and/or <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="idl_img1.png" 70 ALT="$a_{\ell m}$"></SPAN> from power spectra (<SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img4.png" 71 ALT="$C(\ell)$"></SPAN>), synthesize maps from 72<SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="idl_img1.png" 73 ALT="$a_{\ell m}$"></SPAN> or simulate maps from <SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img4.png" 74 ALT="$C(\ell)$"></SPAN> and constraining <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.45ex; " SRC="idl_img1.png" 75 ALT="$a_{\ell m}$"></SPAN>.</H3> 76Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/idl/interfaces/isynfast.pro"><b>src/idl/interfaces/isynfast.pro</b></a> 77 78<P> 79<hr><h1>FORMAT </h1><h3>IDL> 80ISYNFAST, <A HREF="#idl:isynfast:cl_in">cl_in</A>[, <A HREF="#idl:isynfast:map_out">map_out</A>, 81 <A HREF="#idl:isynfast:alm_in">alm_in=</A>, <A HREF="#idl:isynfast:alm_out">alm_out=</A>, <A HREF="#idl:isynfast:apply_windows">apply_windows=</A>, <A HREF="#idl:isynfast:beam_file">beam_file=</A>, <A HREF="#idl:isynfast:binpath">binpath=</A>, <A HREF="#idl:isynfast:double">double=</A>, <A HREF="#idl:isynfast:fwhm_arcmin">fwhm_arcmin=</A>, <A HREF="#idl:isynfast:help">help=</A>, 82 <A HREF="#idl:isynfast:iseed">iseed=</A>, <A HREF="#idl:isynfast:keep_tmp_files">keep_tmp_files=</A>, <A HREF="#idl:isynfast:lmax">lmax=</A>, <A HREF="#idl:isynfast:nlmax">nlmax=</A>, <A HREF="#idl:isynfast:nside">nside=</A>, <A HREF="#idl:isynfast:nsmax">nsmax=</A>, <A HREF="#idl:isynfast:plmfile">plmfile=</A>, 83 <A HREF="#idl:isynfast:simul_type">simul_type=</A>, <A HREF="#idl:isynfast:silent">silent=</A>, <A HREF="#idl:isynfast:tmpdir">tmpdir=</A>, <A HREF="#idl:isynfast:windowfile">windowfile=</A>, <A HREF="#idl:isynfast:winfiledir">winfiledir=</A>] 84</h3> 85 86<P> 87<hr> 88<H1>QUALIFIERS</H1> 89 90 <DL COMPACT><DT> 91<B>cl_in<A ID="idl:isynfast:cl_in"></A></B> 92<DD>input power spectrum, can be a FITS file, or a memory array containing the 93 <SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img4.png" 94 ALT="$C(\ell)$"></SPAN>, used to generate a map or a set of gaussian alm 95<BR> 96If empty quotes (”) or a zero (0) are provided, it will be interpreted as "No input C(l)", in 97 which case some input alm's (alm_in) are required. 98 <DT> 99<B>map_out<A ID="idl:isynfast:map_out"></A></B> 100<DD>optional output: <EM>RING ordered</EM> map synthetised from the power spectrum or from constraining alm 101 </DL> 102 103<P> 104<hr><H1>KEYWORDS</H1> 105 106 <DL COMPACT><DT> 107<B>alm_in<A ID="idl:isynfast:alm_in"></A>=</B> 108<DD>optional input (constraining) alm (must be a FITS file) <b>default:</b>no alm 109 110<P> 111<DT> 112<B>alm_out<A ID="idl:isynfast:alm_out"></A>=</B> 113<DD>contains on output the effective alm (must be a FITS file) 114 115<P> 116<DT> 117<B>/apply_windows<A ID="idl:isynfast:apply_windows"></A></B> 118<DD>if set, beam and pixel windows are applied to input alm_in 119(if any) 120 121<P> 122<DT> 123<B>beam_file<A ID="idl:isynfast:beam_file"></A>=</B> 124<DD>beam window function, either a FITS file or an array (see <A HREF="./fac_Using_HEALPix_Fortran_90_fa.htm#fac:subsec:beamfiles">”Beam window function files”</A> section 125in the <A ID="tex2html47" 126 HREF="facilities.htm"><b>HEALPix</b> Fortran Facilities document</A>) 127 128<P> 129<DT> 130<B>binpath<A ID="idl:isynfast:binpath"></A>=</B> 131<DD>full path to back-end routine <b>default:</b>$HEXE/synfast, then $HEALPIX/bin/synfast 132<BR> - a binpath starting with / (or <SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img74.png" 133 ALT="$\backslash$"></SPAN>), <SPAN CLASS="MATH"> </SPAN> or $ is interpreted as absolute 134<BR> - a binpath starting with ./ is interpreted as relative to current directory 135<BR> - all other binpaths are relative to $HEALPIX 136 137<P> 138<DT> 139<B>/double<A ID="idl:isynfast:double"></A></B> 140<DD>if set, I/O is done in double precision <b>default:</b>single precision I/O 141 142<P> 143<DT> 144<B>fwhm_arcmin<A ID="idl:isynfast:fwhm_arcmin"></A>=</B> 145<DD>gaussian beam FWHM in arcmin <b>default:</b>0 146 147<P> 148<DT> 149<B>/help<A ID="idl:isynfast:help"></A></B> 150<DD>if set, prints extended help 151 152<P> 153<DT> 154<B>iseed<A ID="idl:isynfast:iseed"></A>=</B> 155<DD>integer seed of radom sequence <b>default:</b>0 156 157<P> 158<DT> 159<B>/keep_tmp_files<A ID="idl:isynfast:keep_tmp_files"></A></B> 160<DD>if set, temporary files are not discarded at the end of the 161 run 162 163<P> 164<DT> 165<B>lmax<A ID="idl:isynfast:lmax"></A>=, nlmax<A ID="idl:isynfast:nlmax"></A>=</B> 166<DD>maximum multipole simulation <b>default:</b>2*<!-- MATH 167 $N_{\mathrm{side}}$ 168 --> 169<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB></SPAN> 170 171<P> 172<DT> 173<B>nside<A ID="idl:isynfast:nside"></A>=, nsmax<A ID="idl:isynfast:nsmax"></A>=</B> 174<DD>Healpix resolution parameter <!-- MATH 175 $N_{\mathrm{side}}$ 176 --> 177<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB></SPAN> 178 179<P> 180<DT> 181<B>plmfile<A ID="idl:isynfast:plmfile"></A>=</B> 182<DD>FITS file containing precomputed Spherical Harmonics (deprecated) <b>default:</b>no file 183 184<P> 185<DT> 186<B>simul_type<A ID="idl:isynfast:simul_type"></A>=</B> 187<DD>1) Temperature only 188<BR> 1892) Temperature + polarisation 190<BR> 1913) Temperature + 1st derivatives 192<BR> 1934) Temperature + 1st & 2nd derivatives 194<BR> 1955) T+P + 1st derivatives 196<BR> 1976) T+P + 1st & 2nd derivates 198 <b>default:</b>2: T+P 199 200<P> 201<DT> 202<B>/silent<A ID="idl:isynfast:silent"></A></B> 203<DD>if set, works silently 204 205<P> 206<DT> 207<B>tmpdir<A ID="idl:isynfast:tmpdir"></A>=</B> 208<DD>directory in which are written temporary files 209 <b>default:</b>IDL_TMPDIR (see IDL documentation) 210 211<P> 212<DT> 213<B>windowfile<A ID="idl:isynfast:windowfile"></A>=</B> 214<DD>FITS file containing pixel window 215 <b>default:</b>determined automatically by back-end routine. 216 Do not set this keyword unless you really know what you are doing 217 218<P> 219<DT> 220<B>winfiledir<A ID="idl:isynfast:winfiledir"></A>=</B> 221<DD>directory where the pixel windows are to be found 222 <b>default:</b>determined automatically by back-end routine. 223 Do not set this keyword unless you really know what you are doing 224 225<P> 226</DL> 227 228<P> 229<hr> 230<H1>DESCRIPTION</H1> 231<blockquote> 232<FONT COLOR="#CC0000">isynfast</FONT> is an interface to F90 '<A HREF="./fac_synfast.htm#fac:synfast">synfast</A>' F90 facility. It 233requires some disk space on which to write the parameter file and the other 234temporary files. Most data can be provided/generated as an external FITS 235file, or as a memory array. 236</blockquote> 237 238<P> 239<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">isynfast</FONT></b></h3> 240 241 <DL COMPACT><DT> 242<B>idl</B> 243<DD>version 6.4 or more is necessary to run <FONT COLOR="#CC0000">isynfast</FONT>. 244 <DT> 245<B>synfast</B> 246<DD>F90 facility called by <FONT COLOR="#CC0000">isynfast</FONT>. 247 <DT> 248<B><A HREF="idl_ialteralm.htm#idl:ialteralm">ialteralm</A></B> 249<DD>IDL Interface to F90 <A HREF="./fac_alteralm.htm#fac:alteralm">alteralm</A> 250 <DT> 251<B><A HREF="idl_ianafast.htm#idl:ianafast">ianafast</A></B> 252<DD>IDL Interface to F90 <A HREF="./fac_anafast.htm#fac:anafast">anafast</A> and C++ anafast_cxx 253 <DT> 254<B><A HREF="idl_iprocess_mask.htm#idl:iprocess_mask">iprocess_mask</A></B> 255<DD>IDL Interface to F90 <A HREF="./fac_process_mask.htm#fac:process_mask">process_mask</A> 256 <DT> 257<B><A HREF="idl_ismoothing.htm#idl:ismoothing">ismoothing</A></B> 258<DD>IDL Interface to F90 <A HREF="./fac_smoothing.htm#fac:smoothing">smoothing</A> 259</DL> 260 261<P> 262<HR><H1>EXAMPLE:</H1> 263<tt><TABLE CELLPADDING=3> 264<TR><TD ALIGN="LEFT"><FONT COLOR="#CC0000">isynfast</FONT>, '$HEALPIX/test/cl.fits', map, fwhm=30, nside=256, /silent</TD> 265</TR> 266<TR><TD ALIGN="LEFT"><A HREF="idl_mollview.htm#idl:mollview">mollview</A>, map, 1, title='I'</TD> 267</TR> 268<TR><TD ALIGN="LEFT"><A HREF="idl_mollview.htm#idl:mollview">mollview</A>, map, 2, title='Q'</TD> 269</TR> 270</TABLE></tt> 271<blockquote> 272will synthetize and plot I and Q maps consistent with WMAP-1yr best fit power 273spectrum and observed with a circular gaussian 30 arcmin beam. 274</blockquote> 275 276<P> 277 278<P> 279 280<P> 281 282<DIV CLASS="navigation"><HR> 283<!--Navigation Panel--> 284<A 285 HREF="idl_ismoothing.htm"> 286<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 287<A 288 HREF="idl_HEALPix_IDL_subroutines.htm"> 289<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 290<A 291 HREF="idl_lm2index.htm"> 292<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 293<A ID="tex2html355" 294 HREF="idl_TABLE_CONTENTS.htm"> 295<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 296<BR> 297<B> Previous:</B> <A 298 HREF="idl_ismoothing.htm">ismoothing</A> 299 300<B>Up:</B> <A 301 HREF="idl_HEALPix_IDL_subroutines.htm">HEALPix/IDL subroutines</A> 302 303<B> Next:</B> <A 304 HREF="idl_lm2index.htm">lm2index</A> 305<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 306<!--End of Navigation Panel--> 307<ADDRESS> 308Version 3.50, 2018-12-10 309</ADDRESS> 310</BODY> 311</HTML> 312