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>&nbsp;
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">&rdquo;<b>HEALPix</b> Installation Documentation&rdquo;</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">&nbsp;</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