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>mollcursor</TITLE> 7<META NAME="description" CONTENT="mollcursor"> 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_mollview.htm"> 29<LINK REL="previous" HREF="idl_median_filter.htm"> 30<LINK REL="next" HREF="idl_mollview.htm"> 31</HEAD> 32 33<body text="#000000" bgcolor="#FFFFFA"> 34 35<DIV CLASS="navigation"><!--Navigation Panel--> 36<A 37 HREF="idl_median_filter.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_mollview.htm"> 44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 45<A ID="tex2html361" 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_median_filter.htm">median_filter</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_mollview.htm">mollview</A> 57<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 58<!--End of Navigation Panel--> 59 60<H1><A ID="SECTION4400"></A> 61<A ID="idl:mollcursor"></A> 62<BR> 63 64</H1> 65 66<P> 67<b><font size=+6><FONT COLOR="#CC0000">mollcursor</FONT></font></b><hr> 68<H3>This IDL facility provides a point-and-click interface for finding 69the astronomical location, value and pixel index of the pixels nearest 70to the pointed position on a Mollweide projection of a <b>HEALPix</b> map.</H3> 71Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/idl/visu/mollcursor.pro"><b>src/idl/visu/mollcursor.pro</b></a> 72 73<P> 74<hr><h1>FORMAT </h1><h3>IDL> 75MOLLCURSOR, [<A HREF="#idl:mollcursor:cursor_type">cursor_type=</A>, <A HREF="#idl:mollcursor:file_out">file_out=</A>] 76</h3> 77 78<P> 79<hr> 80<H1>QUALIFIERS</H1> 81 82 <DL COMPACT><DT> 83<B>cursor_type=</B> 84<DD><A ID="idl:mollcursor:cursor_type"></A> cursor type to be used 85<BR> <b>default:</b>34 86 <DT> 87<B>file_out=</B> 88<DD><A ID="idl:mollcursor:file_out"></A> file containing on output the list of 89 point selected with the cursor. 90<BR> 91If set to 1, the file will 92 take its default name: 'cursor_catalog.txt'. 93<BR> 94If set to a non-empty character string, the file name will be that string 95 </DL> 96 97<P> 98<hr> 99<H1>DESCRIPTION</H1> 100<blockquote> 101mollcursor should be run immediately following mollview. It gives the 102longitude, latitude, map value and pixel number 103corresponding to the cursor position in the window containing the map generated 104by mollview. Mouse buttons are used to select the function : 105<br><br>left button = display the information relative to the current cursor position, 106<br><br>middle button = print out this information in the IDL command window 107<br><br>right button = quit mollcursor 108<BR> 109<BR><B>Note on Mac OS X, X11 and IDL cursor:</B> 110depending on the Mac OS X version<A ID="tex2html48" 111 HREF="idl_footnode.htm#foot11070"><SUP><SPAN CLASS="arabic">2</SPAN></SUP></A>and most importantly on the X Window System being used,<A ID="tex2html49" 112 HREF="idl_footnode.htm#foot11071"><SUP><SPAN CLASS="arabic">3</SPAN></SUP></A>the IDL function <TT>cursor</TT>, and therefore <b>HEALPix</b> <FONT COLOR="#CC0000">mollcursor</FONT>, 113gnomcursor, <SPAN CLASS="MATH"><IMG STYLE="height: 0.23ex; vertical-align: -0.10ex; " SRC="idl_img6.png" 114 ALT="$\ldots$"></SPAN> will not 115work properly under X11. To solve this problem, type the relevant line below at your X11 prompt and restart X11. 116<BR> 117If you are using Apple's X11, type under Tiger (10.4): 118<BR><SMALL CLASS="FOOTNOTESIZE"><TT>defaults write com.apple.x11 wm_click_through -bool true</TT></SMALL> 119<BR> 120or, under Leopard (10.5), Snow Leopard (10.6), Lion (10.7): 121<BR><SMALL CLASS="FOOTNOTESIZE"><TT>defaults write org.x.x11 wm_click_through -bool true</TT></SMALL> 122<BR> 123If you are using Xquartz (for eg, Montain Lion (10.8), Mavericks (10.9), Yosemite (10.10), El Capitan (10.11), Sierra (10.12) or High Sierra (10.13)): 124<BR><SMALL CLASS="FOOTNOTESIZE"><TT>defaults write org.macosforge.xquartz.X11 wm_click_through -bool true</TT></SMALL> 125<BR> 126and if you are using MacPort's X11 (package xorg-server): 127<BR><SMALL CLASS="FOOTNOTESIZE"><TT>defaults write org.macports.X11 wm_click_through -bool true</TT></SMALL> 128<BR>(see 129<A ID="tex2html50" 130 HREF="http://www.idlcoyote.com/misc_tips/maccursor.html"><SMALL CLASS="SMALL">http://www.idlcoyote.com/misc_tips/maccursor.html</SMALL></A> 131and the section <A HREF="./install.htm#install:macos_idl_cursor">Mac OS X, X11 and IDL cursor</A> in <A ID="tex2html51" 132 HREF="install.htm">”<b>HEALPix</b> Installation Documentation”</A>). 133<BR> 134And finally, <FONT COLOR="#CC0000">mollcursor</FONT> obviously requires the '3 button mouse' to be enabled, 135which can be done in the X11 Preferences menu, or if Xquartz is used (see <TT>man Xquartz</TT>) via: 136<BR><SMALL CLASS="FOOTNOTESIZE"><TT>defaults write org.macosforge.xquartz.X11 enable_fake_buttons 137-bool true</TT></SMALL> 138 139</blockquote> 140 141<P> 142<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">mollcursor</FONT></b></h3> 143 144 <DL COMPACT><DT> 145<B>idl</B> 146<DD>version 6.4 or more is necessary to run <FONT COLOR="#CC0000">mollcursor</FONT> 147 <DT> 148<B>ghostview</B> 149<DD>ghostview or a similar facility is required to view 150 the Postscript image generated by <FONT COLOR="#CC0000">mollcursor</FONT>. 151 <DT> 152<B>xv</B> 153<DD>xv or a similar facility is required to view the 154 GIF/PNG image generated by <FONT COLOR="#CC0000">mollcursor</FONT> (a browser can also 155 be used). 156 <DT> 157<B>synfast</B> 158<DD>This <b>HEALPix</b> facility will generate the FITS format 159 sky map to be input to <FONT COLOR="#CC0000">mollcursor</FONT>. 160 <DT> 161<B><A HREF="idl_cartview.htm#idl:cartview">cartview</A></B> 162<DD>IDL facility to generate a Cartesian projection of 163 a <b>HEALPix</b> map. 164 <DT> 165<B><A HREF="idl_cartcursor.htm#idl:cartcursor">cartcursor</A></B> 166<DD>interactive cursor to be used with cartview 167 <DT> 168<B><A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A></B> 169<DD>IDL facility to generate a gnomonic projection of 170 a <b>HEALPix</b> map. 171 <DT> 172<B><A HREF="idl_gnomcursor.htm#idl:gnomcursor">gnomcursor</A></B> 173<DD>interactive cursor to be used with gnomview 174 <DT> 175<B><A HREF="idl_mollview.htm#idl:mollview">mollview</A></B> 176<DD>IDL facility to generate a Mollweide projection of 177 a <b>HEALPix</b> map. 178 <DT> 179<B><A HREF="#idl:mollcursor">mollcursor</A></B> 180<DD>interactive cursor to be used with mollview 181 <DT> 182<B><A HREF="idl_orthview.htm#idl:orthview">orthview</A></B> 183<DD>IDL facility to generate an orthographic projection of 184 a <b>HEALPix</b> map. 185 <DT> 186<B><A HREF="idl_orthcursor.htm#idl:orthcursor">orthcursor</A></B> 187<DD>interactive cursor to be used with orthview 188 </DL> 189 190<P> 191<HR><H1>EXAMPLE:</H1> 192<tt><TABLE CELLPADDING=3> 193<TR><TD ALIGN="LEFT">mollcursor</TD> 194<TD ALIGN="LEFT"> </TD> 195</TR> 196</TABLE></tt> 197<blockquote>After mollview reads in a map and generates 198its mollweide projection, mollcursor is run to know the 199position and flux of bright synchrotron sources, for example.</blockquote> 200 201<P> 202 203<P> 204 205<DIV CLASS="navigation"><HR> 206<!--Navigation Panel--> 207<A 208 HREF="idl_median_filter.htm"> 209<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A> 210<A 211 HREF="idl_HEALPix_IDL_subroutines.htm"> 212<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A> 213<A 214 HREF="idl_mollview.htm"> 215<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A> 216<A ID="tex2html361" 217 HREF="idl_TABLE_CONTENTS.htm"> 218<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A> 219<BR> 220<B> Previous:</B> <A 221 HREF="idl_median_filter.htm">median_filter</A> 222 223<B>Up:</B> <A 224 HREF="idl_HEALPix_IDL_subroutines.htm">HEALPix/IDL subroutines</A> 225 226<B> Next:</B> <A 227 HREF="idl_mollview.htm">mollview</A> 228<B> Top:</B> <a href="main.htm">Main Page</a></DIV> 229<!--End of Navigation Panel--> 230<ADDRESS> 231Version 3.50, 2018-12-10 232</ADDRESS> 233</BODY> 234</HTML> 235