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>mollview</TITLE>
7<META NAME="description" CONTENT="mollview">
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_neighbours_nest.htm">
29<LINK REL="previous" HREF="idl_mollcursor.htm">
30<LINK REL="next" HREF="idl_neighbours_nest.htm">
31</HEAD>
32
33<body text="#000000" bgcolor="#FFFFFA">
34
35<DIV CLASS="navigation"><!--Navigation Panel-->
36<A
37 HREF="idl_mollcursor.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_neighbours_nest.htm">
44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A>
45<A ID="tex2html363"
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_mollcursor.htm">mollcursor</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_neighbours_nest.htm">neighbours_nest</A>
57<B> Top:</B> <a href="main.htm">Main Page</a></DIV>
58<!--End of Navigation Panel-->
59
60<H1><A ID="SECTION4500"></A>
61<A ID="idl:mollview"></A>
62<BR>
63
64</H1>
65
66<P>
67
68<P>
69
70<P>
71
72<P>
73<b><font size=+6><FONT COLOR="#CC0000">mollview</FONT></font></b><hr>
74<H3>This IDL facility provides a means to visualise a full sky Mollweide projection of
75<b>HEALPix</b> and COBE Quad-Cube maps in an IDL environment.
76It also offers the possibility to
77generate GIF, JPEG, PDF, PNG and Postscript color-coded images of the projected map.
78The projected (but not color-coded) data can also be output in FITS files and
79IDL arrays.</H3>
80Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/idl/visu/mollview.pro"><b>src/idl/visu/mollview.pro</b></a>&nbsp;
81
82<P>
83
84<A ID="idl:mollview:TOP"></A><P>
85<hr><h1>FORMAT </h1><h3>IDL>
86MOLLVIEW,
87<A HREF="#idl:mollview:file">File</A>
88[, <A HREF="#idl:mollview:select">Select</A>]
89[, <A HREF="#idl:mollview:asinh">ASINH=</A>,
90<A HREF="#idl:mollview:bad_color">BAD_COLOR=</A>,
91<A HREF="#idl:mollview:bg_color">BG_COLOR=</A>,
92<A HREF="#idl:mollview:charsize">CHARSIZE=</A>,
93<A HREF="#idl:mollview:charsize">CHARTHICK=</A>,
94<A HREF="#idl:mollview:colt">COLT=</A>,
95<A HREF="#idl:mollview:coord">COORD=</A>,
96<A HREF="#idl:mollview:crop">/CROP</A>,
97<A HREF="#idl:mollview:customize">CUSTOMIZE=</A>,
98<A HREF="#idl:mollview:default_settings">DEFAULT_SETTINGS=</A>,
99<A HREF="#idl:mollview:execute">EXECUTE=</A>,
100<A HREF="#idl:mollview:factor">FACTOR=</A>,
101<A HREF="#idl:mollview:fg_color">FG_COLOR=</A>,
102<A HREF="#idl:mollview:fits">FITS=</A>,
103<A HREF="#idl:mollview:flip">/FLIP</A>,
104<A HREF="#idl:mollview:gal_cut">GAL_CUT=</A>,
105<A HREF="#idl:mollview:gif">GIF=</A>,
106<A HREF="#idl:mollview:glsize">GLSIZE=</A>,
107<A HREF="#idl:mollview:graticule">GRATICULE=</A>,
108<A HREF="#idl:mollview:half_sky">/HALF_SKY</A>,
109<A HREF="#idl:mollview:hbound">HBOUND=</A>,
110<A HREF="#idl:mollview:help">/HELP</A>,
111<A HREF="#idl:mollview:hist_equal">/HIST_EQUAL</A>,
112<A HREF="#idl:mollview:hxsize">HXSIZE=</A>,
113<A HREF="#idl:mollview:iglsize">IGLSIZE=</A>,
114<A HREF="#idl:mollview:igraticule">IGRATICULE=</A>,
115<A HREF="#idl:mollview:jpeg">JPEG=</A>,
116<A HREF="#idl:mollview:latex">LATEX=</A>,
117<A HREF="#idl:mollview:log">/LOG</A>,
118<A HREF="#idl:mollview:map_out">MAP_OUT=</A>,
119<A HREF="#idl:mollview:max">MAX=</A>,
120<A HREF="#idl:mollview:min">MIN=</A>,
121<A HREF="#idl:mollview:nested">/NESTED</A>,
122<A HREF="#idl:mollview:no_dipole">/NO_DIPOLE</A>,
123<A HREF="#idl:mollview:no_monopole">/NO_MONOPOLE</A>,
124<A HREF="#idl:mollview:nobar">/NOBAR</A>,
125<A HREF="#idl:mollview:nolabels">/NOLABELS</A>,
126<A HREF="#idl:mollview:noposition">/NOPOSITION</A>,
127<A HREF="#idl:mollview:offset">OFFSET=</A>,
128<A HREF="#idl:mollview:outline">OUTLINE=</A>,
129<A HREF="#idl:mollview:pdf">PDF=</A>,
130<A HREF="#idl:mollview:pfonts">PFONTS=</A>,
131<A HREF="#idl:mollview:png">PNG=</A>,
132<A HREF="#idl:mollview:polarization">POLARIZATION=</A>,
133<A HREF="#idl:mollview:preview">/PREVIEW</A>,
134<A HREF="#idl:mollview:ps">PS=</A>,
135<A HREF="#idl:mollview:pxsize">PXSIZE=</A>,
136<A HREF="#idl:mollview:pysize">PYSIZE=</A>,
137<A HREF="#idl:mollview:reso_arcmin">RESO_ARCMIN=</A>,
138<A HREF="#idl:mollview:retain">RETAIN=</A>,
139<A HREF="#idl:mollview:rot">ROT=</A>,
140<A HREF="#idl:mollview:save">/SAVE</A>,
141<A HREF="#idl:mollview:shaded">/SHADED</A>,
142<A HREF="#idl:mollview:silent">/SILENT</A>,
143<A HREF="#idl:mollview:silhouette">SILHOUETTE=</A>,
144<A HREF="#idl:mollview:stagger">STAGGER=</A>,
145<A HREF="#idl:mollview:subtitle">SUBTITLE=</A>,
146<A HREF="#idl:mollview:titleplot">TITLEPLOT=</A>,
147<A HREF="#idl:mollview:transparent">TRANSPARENT=</A>,
148<A HREF="#idl:mollview:truecolors">TRUECOLORS=</A>,
149<A HREF="#idl:mollview:units">UNITS=</A>,
150<A HREF="#idl:mollview:window">WINDOW=</A>,
151<A HREF="#idl:mollview:xpos">XPOS=</A>,
152<A HREF="#idl:mollview:ypos">YPOS=</A>]
153
154</h3>
155
156<P>
157<A ID="idl:mollview:routines"></A>Several visualization routines have a similar interface. Their <B>qualifiers</B> and
158<B>keywords</B> are all listed here, and the routines to which they apply are coded
159in the 'routine' column as:
160<BR>
161A: <A HREF="idl_azeqview.htm#idl:azeqview">azeqview</A>,
162C: <A HREF="idl_cartview.htm#idl:cartview">cartview</A>,
163G: <A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A>,
164M: <A HREF="#idl:mollview">mollview</A>,
165O: <A HREF="idl_orthview.htm#idl:orthview">orthview</A> and all: all of them
166<P>
167<B>Qualifiers</B> should appear in the order indicated. They can take a range of values, and some of them are optional.
168<BR><B>Keywords</B> are optional, and can appear in any order. They take the form <TT>keyword=value</TT> and can be abbreviated to a non ambiguous form
169(ie, <TT>factor=10.0</TT> can be replaced by <TT>fac = 10.0</TT>). They generally can take a range of values, but
170some of them (noted as <TT>/keyword</TT> below) are boolean switches: they are either present (or set to 1) or absent (or set
171to 0).
172
173<P>
174<H1>QUALIFIERS</H1>
175<BR>
176<TABLE CELLPADDING=3 BORDER="1">
177<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
178<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
179<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
180</TR>
181<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>File <A ID="idl:mollview:file"></A></TD>
182<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
183<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Required
184<BR>
185name of a (possibly gzip compressed) FITS file containing
186               the <b>HEALPix</b>  map in an extension or in the image field, <BR><EM>or</EM>    name of an <EM>online</EM> variable (either array or
187structure) containing the (RING or <A HREF="#idl:mollview:polarization">NESTED</A> ordered) <b>HEALPix</b>  map (See note below);
188<BR>
189if Save is set   :    name of an IDL saveset file containing
190               the <b>HEALPix</b>  map stored under the variable  <TT>data</TT> <BR><b> (default : none)</b>
191<BR><u>Note on online data</u>: in order to preserve the integrity of the input data,
192		the content of the array or structure <TT>File</TT> is replicated
193before being possibly altered by the map making process.
194Therefore plotting online data will require more memory than reading the data from disc directly, and is not recommended
195		to visualize data sets of size comparable to that of the
196computer memory.
197<BR><u>Note on high resolution cut sky data</u>: cut sky data (in which less
198than 50% of the sky is observed), can be processed with a minimal memory
199foot-print, by not allocating fake full map. In the current release, two
200restrictions apply: the input data set must be read from a FITS file in 'cut4'
201format, and the <A HREF="#idl:mollview:polarization"><TT>POLARIZATION</TT></A> IDL keyword
202(described below) must be 0 (default value). See
203<A HREF="#idl:mollview:example4">Example #4</A> below. <BR><i>see also:</i><A HREF="#idl:mollview:truecolors"><TT>TrueColors</TT></A>.</TD>
204</TR>
205<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>Select <A ID="idl:mollview:select"></A></TD>
206<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
207<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Optional
208<BR>
209column of the BIN FITS table to be plotted, can be either  <BR>- a name : value given in TTYPEi of the FITS file <BR>
210NOT case sensitive and can be truncated, <BR>(only letters, digits and underscore are valid) <BR>- an integer        : number i of the column
211                            containing the data, starting with 1 (also valid if
212		  <A HREF="#idl:mollview:file"><TT>File</TT></A> is an online array) <BR><b>default:</b>1 for full sky maps, 'SIGNAL' column for FITS files
213		  containing cut sky maps
214               (see the Examples below)</TD>
215</TR>
216</TABLE>
217
218<A HREF="#idl:mollview:TOP">Back to Format</A>
219
220<H1>KEYWORDS</H1>
221<BR>
222<TABLE CELLPADDING=3 BORDER="1">
223<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
224<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
225<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
226</TR>
227<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>ASINH=<A ID="idl:mollview:asinh"></A></TD>
228<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
229<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the
230            color table is altered to emulate an non-linear mapping of the input
231            data enhancing the low contrast regions. <BR>
232If <TT>asinh=1</TT> the mapping is <!-- MATH
233 $y=\sinh^{-1} (x)$
234 -->
235<SPAN CLASS="MATH"><IMG STYLE="height: 2.62ex; vertical-align: -0.68ex; " SRC="idl_img77.png"
236 ALT="$y=\sinh^{-1} (x)$"></SPAN>, such that <SPAN CLASS="MATH"><IMG STYLE="height: 1.63ex; vertical-align: -0.55ex; " SRC="idl_img78.png"
237 ALT="$y \approx x$"></SPAN> when <SPAN CLASS="MATH"><IMG STYLE="height: 1.75ex; vertical-align: -0.19ex; " SRC="idl_img79.png"
238 ALT="$x\ll 1$"></SPAN> and <!-- MATH
239 $y\approx \ln(2x)$
240 -->
241<SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img80.png"
242 ALT="$y\approx \ln(2x)$"></SPAN> when <SPAN CLASS="MATH"><IMG STYLE="height: 1.75ex; vertical-align: -0.19ex; " SRC="idl_img81.png"
243 ALT="$x\gg 1$"></SPAN>.
244<BR>
245If <TT>asinh=2</TT> the mapping is <!-- MATH
246 $y=\sinh^{-1} (x/2)/\ln(10)$
247 -->
248<SPAN CLASS="MATH"><IMG STYLE="height: 2.62ex; vertical-align: -0.68ex; " SRC="idl_img82.png"
249 ALT="$y=\sinh^{-1} (x/2)/\ln(10)$"></SPAN>, such that
250<!-- MATH
251 $y \approx 0.21 x$
252 -->
253<SPAN CLASS="MATH"><IMG STYLE="height: 2.04ex; vertical-align: -0.55ex; " SRC="idl_img83.png"
254 ALT="$y \approx 0.21 x$"></SPAN> when <SPAN CLASS="MATH"><IMG STYLE="height: 1.75ex; vertical-align: -0.19ex; " SRC="idl_img79.png"
255 ALT="$x\ll 1$"></SPAN> and <!-- MATH
256 $y\approx \log(x)$
257 -->
258<SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img84.png"
259 ALT="$y\approx \log(x)$"></SPAN> when <SPAN CLASS="MATH"><IMG STYLE="height: 1.75ex; vertical-align: -0.19ex; " SRC="idl_img81.png"
260 ALT="$x\gg 1$"></SPAN>. <BR>
261Here <SPAN CLASS="MATH"><I>x</I></SPAN> is the input data, optionally altered by
262	<A HREF="#idl:mollview:factor"><TT>Factor</TT></A> and <A HREF="#idl:mollview:offset"><TT>Offset</TT></A>. <BR>
263This option can <EM>not</EM> be used in conjonction with
264<A HREF="#idl:mollview:log"><TT>/LOG</TT></A> nor <A HREF="#idl:mollview:hist_equal"><TT>/HIST_EQUAL</TT></A>.</TD>
265</TR>
266<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>BAD_COLOR=<A ID="idl:mollview:bad_color"></A></TD>
267<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
268<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>color given to missing pixels (having
269<A HREF="idl_init_healpix_healpix_system.htm#idl:init_healpix"><TT>!healpix.bad_value</TT></A> (<!-- MATH
270 $=-1.6375\,10^{30}$
271 -->
272<SPAN CLASS="MATH"><IMG STYLE="height: 1.92ex; vertical-align: -0.29ex; " SRC="idl_img85.png"
273 ALT="$=-1.6375\,10^{30}$"></SPAN>)
274      or <TT>NaN</TT> value on input).
275   The color can be provided as either:
276<BR>- a single integer in [0,255], specifying the index to be used in
277      the color table chosen via <A HREF="#idl:mollview:colt">COLT</A> (in which the indexes 0, 1 and 2
278      are reserved for black, white and grey respectively),
279<BR>- a 3 element vector, with each element in [0,255], specifying the
280      amount of RED, GREEN and BLUE
281<BR>- a 7-character string, starting with '#', specifying the color in
282      HTML Hexadecimal fashion (eg, '#ff0000' for red).
283<BR><b>default:</b>neutral grey (=2, =[175, 175, 175], ='#afafaf')
284<BR><i>see also:</i><A HREF="#idl:mollview:bg_color">BG_COLOR</A>,
285<A HREF="#idl:mollview:fg_color">FG_COLOR</A>,
286<A HREF="#idl:mollview:transparent">TRANSPARENT</A></TD>
287</TR>
288<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>BG_COLOR=<A ID="idl:mollview:bg_color"></A></TD>
289<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
290<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>color given to background pixels (outside the sphere).
291<BR>
292See <A HREF="#idl:mollview:bad_color">BAD_COLOR</A> for expected format.
293<BR><b>default:</b>white (=1, =[255, 255, 255], ='#ffffff')
294<BR><i>see also:</i><A HREF="#idl:mollview:fg_color">FG_COLOR</A>,
295<A HREF="#idl:mollview:transparent">TRANSPARENT</A></TD>
296</TR>
297<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>CHARSIZE=<A ID="idl:mollview:charsize"></A></TD>
298<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
299<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>overall multiplicative factor applied to the size of
300        all characters appearing on the plot
301        	<b>default:</b>1.0; <i>see also:</i><A HREF="#idl:mollview:customize">CUSTOMIZE</A></TD>
302</TR>
303<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>CHARTHICK=<A ID="idl:mollview:charthick"></A></TD>
304<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
305<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>character thickness (in
306<A HREF="#idl:mollview:titleplot">TITLEPLOT</A>, <A HREF="#idl:mollview:subtitle">SUBTITLE</A> and
307color bar labeling). Other characters thickness (such as
308<A HREF="#idl:mollview:glsize">graticule labels</A>), can be controlled with <TT>!P.CHARTHICK</TT>.
309                <b>default:</b>1</TD>
310</TR>
311</TABLE>
312
313<A HREF="#idl:mollview:TOP">Back to Format</A>
314<TABLE CELLPADDING=3 BORDER="1">
315<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
316<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
317<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
318</TR>
319<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>COLT=<A ID="idl:mollview:colt"></A></TD>
320<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
321<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>color table
322index: <BR>- Indexes in [0,40] are reserved for standard IDL color tables, while
323  [41,255] are used for user defined color tables read from disc (created and
324  written to disc with <TT>MODIFYCT</TT>), if any. <BR>- Indexes 1001 (or <TT>'planck1'</TT>, case insensitive) and 1002 (or <TT>'planck2'</TT>) are
325reserved for Planck color tables 1 and 2 generated by <A HREF="idl_planck_colors.htm#idl:planck_colors"><TT>planck_colors</TT></A>.
326See <A HREF="#idl:mollview:example6">Example #6</A> below.
327<BR>- If the index does not match any existing table, or if it is above 255,
328  the current online table (modifiable with <TT>TVLCT</TT>, <TT>XLOADCT</TT>, <TT>XPALETTE</TT>, ...
329  or eg, J. Davenport's
330<A ID="tex2html52"
331  HREF="http://www.astro.washington.edu/users/jrad/cubehelix.pro"><TT>cubehelix.pro</TT></A>
332implementation of D. Green 's
333<A ID="tex2html53"
334  HREF="https://www.mrao.cam.ac.uk/~dag/CUBEHELIX/">cubehelix color scheme</A>) is used instead. <BR>-If <TT>colt</TT><SPAN CLASS="MATH">&lt;0</SPAN>, the IDL color table ABS(colt) is used, but the scale is
335
336reversed (ie a red to blue scale becomes a blue to red scale).
337 Note: -0.1 can be used as negative 0.
338<BR><b>default:</b>33 (Blue-Red) <BR><i>see also:</i><A HREF="#idl:mollview:truecolors"><TT>TrueColors</TT></A></TD>
339</TR>
340<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>COORD=<A ID="idl:mollview:coord"></A></TD>
341<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
342<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>vector with 1 or 2 elements describing the coordinate system of the map;
343                either
344<BR>- 'C' or 'Q' : Celestial2000 = eQuatorial, <BR>- 'E'        : Ecliptic, <BR>- 'G'        : Galactic  <BR>
345if coord = ['x','y'] the map is rotated from system 'x' to system 'y' <BR>
346if coord = ['y'] the map is rotated to coordinate system 'y' (with the
347               original system assumed to be Galactic unless indicated otherwise in the
348                input file) <BR><i>see also:</i><A HREF="#idl:mollview:rot">Rot</A></TD>
349</TR>
350<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/CROP<A ID="idl:mollview:crop"></A></TD>
351<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
352<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the image produced (in GIF/JPEG/PDF/PNG/PS and on screen) only contains the projected map and
353               no title, color bar, ... <BR><i>see also:</i><A HREF="#idl:mollview:gif">Gif</A>,
354			<A HREF="#idl:mollview:jpeg">Jpeg</A>,
355			<A HREF="#idl:mollview:pdf">Pdf</A>,
356			<A HREF="#idl:mollview:png">Png</A>,
357			<A HREF="#idl:mollview:ps">Ps</A></TD>
358</TR>
359</TABLE>
360
361<A HREF="#idl:mollview:TOP">Back to Format</A>
362<TABLE CELLPADDING=3 BORDER="1">
363<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
364<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
365<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
366</TR>
367<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>CUSTOMIZE=<A ID="idl:mollview:customize"></A></TD>
368<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
369<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>User provided structure containing customization parameters of the produced output, whose default values are listed in <A HREF="#idl:mollview:default_settings">DEFAULT_SETTINGS</A>.
370The accepted inputs are <BR><TT>ASPOS.X, ASPOS.Y</TT>: X,Y location of astronomical coordinates label  (which can be removed altogether with <A HREF="#idl:mollview:noposition">/NOPOSITION</A>, only applicable to <A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A>),
371<BR><TT>CBAR.DX, CBAR.DY</TT>: length and width of color bar (which can be removed with <A HREF="#idl:mollview:nobar">/NOBAR</A>), the bar is centered, at an automatically determined height
372<BR><TT>CBAR.SPACES</TT>: 3-element vector listing the strings to be inserted between the map minimum value label, the color bar, the map maximum value, and the map units (read from the FITS file or provided by <A HREF="#idl:mollview:units">UNITS</A>) <b>default:</b>3 single spaces, <BR><TT>CBAR.TY</TT>: vertical offset of the text (min, max and units labels) with respect to the color bar <b>default:</b>0;
373<BR><SPAN  CLASS="textbf">Note:</SPAN> the character size of the text accompanying the color bar is fully determined by the keyword <A HREF="#idl:mollview:charsize">Charsize</A>,
374<BR><TT>CBAR.BOX</TT>: thickness of the black box drawn around the color bar <b>default:</b>0: no box;
375the final thickness is <SPAN  CLASS="texttt">2* cbar.box*!p.thick</SPAN> in
376<A HREF="#idl:mollview:pdf">PDF</A> and
377<A HREF="#idl:mollview:ps">PS</A>,
378and <SPAN  CLASS="texttt">cbar.box*!p.thick</SPAN> otherwise,
379where <SPAN  CLASS="texttt">!p.thick</SPAN> is assumed to have a value of 1.0 unless specified otherwise.
380<BR><TT>CRING.DX, CRING.XLL, CRING.YLL</TT>: radius and X,Y location of lower left corner of the color disc showing the polarization direction when <A HREF="#idl:mollview:polarization">POLARIZATION=3</A>
381<BR><TT>PDF.DEBUG</TT>: if set to 1, and <A HREF="#idl:mollview:silent">SILENT</A> is not set, then debugging information on the <A HREF="#idl:mollview:pdf">PDF</A> generation will be printed (when applicable),
382and the intermediate Postscript file will be kept
383<BR><TT>SUBTITLE.X, SUBTITLE.Y, SUBTITLE.CHARSIZE</TT>: control the X,Y location of the plot
384<A HREF="#idl:mollview:subtitle">subtitle</A>
385(X=0 is left justified, X=0.5 is centered and X=1 is right justified),
386and its final character size, which is the product of the number
387<TT>SUBTITLE.CHARSIZE</TT>
388with the one provided in the keyword
389<A HREF="#idl:mollview:charsize">Charsize</A>
390<BR><TT>TITLE.X, TITLE.Y, TITLE.CHARSIZE</TT>: same as above, applied to the plot title (<A HREF="#idl:mollview:titleplot">titleplot</A>),
391<BR><TT>VSCALE.X, VSCALE.Y</TT>: X,Y location of scale calibrating the polarization rods (whose length and spacing in the main plotting area can be tuned with <A HREF="#idl:mollview:polarization">POLARIZATION=[3, length, spacing]</A>)
392<BR><TT>VSCALE.TY</TT>: vertical offset of the text next to the calibrating rod.
393<BR>
394See <A HREF="#idl:mollview:example7">Example #7</A> below.</TD>
395</TR>
396</TABLE>
397
398<A HREF="#idl:mollview:TOP">Back to Format</A>
399<TABLE CELLPADDING=3 BORDER="1">
400<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
401<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
402<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
403</TR>
404<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>DEFAULT_SETTINGS=<A ID="idl:mollview:default_settings"></A></TD>
405<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
406<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Structure containing on output the default values (slightly projection dependent) of the plotting parameters that can be customized with
407<A HREF="#idl:mollview:customize">CUSTOMIZE</A>.
408<BR>
409As shown in <A HREF="#idl:mollview:example7">Example #7</A> below, the returned structure can be inspected with the routine <A HREF="idl_help_st.htm#idl:help_st"><TT>help_st</TT></A>.</TD>
410</TR>
411<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>EXECUTE=<A ID="idl:mollview:execute"></A></TD>
412<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
413<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>character string containing IDL command(s) to be executed in the
414plotting window. See
415<A HREF="#idl:mollview:example3">Example #3</A> below.</TD>
416</TR>
417<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>FACTOR=<A ID="idl:mollview:factor"></A></TD>
418<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
419<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>scalar multiplicative factor to be applied to the
420	valid data <BR>
421the data plotted is of the form Factor*(data + Offset) <BR>
422This does not affect the flagged pixels <BR>
423Can be used together with ASINH or LOG <BR>
424When used with TRUECOLORS, FACTOR can be a 3-element vector. <BR><i>see also:</i><A HREF="#idl:mollview:asinh">ASINH</A>, <A HREF="#idl:mollview:offset">Offset</A>, <A HREF="#idl:mollview:log">LOG</A>, <A HREF="#idl:mollview:truecolors">Truecolors</A> <BR><b>default:</b>1.0</TD>
425</TR>
426<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>FG_COLOR=<A ID="idl:mollview:fg_color"></A></TD>
427<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
428<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>color of title and subtile characters,
429    graticule lines and labels, units, outlines <SPAN CLASS="MATH"><IMG STYLE="height: 0.23ex; vertical-align: -0.10ex; " SRC="idl_img6.png"
430 ALT="$\ldots$"></SPAN>
431<BR>
432See <A HREF="#idl:mollview:bad_color">BAD_COLOR</A> for expected format.
433<BR><b>default:</b>black (=0, =[0, 0, 0], ='#000000')
434<BR><i>see also:</i>
435<A HREF="#idl:mollview:bad_color">BAD_COLOR</A>,
436<A HREF="#idl:mollview:bg_color">BG_COLOR</A></TD>
437</TR>
438<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>FITS=<A ID="idl:mollview:fits"></A> </TD>
439<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
440<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>string containing the name of an output FITS file with
441        the projected map in the primary image <BR>- if set to 1            : output the plot in
442        plot_<EM>proj</EM>.fits, where <EM>proj</EM> is either <EM>cartesian, gnomic,
443mollweide</EM>, or  <EM>orthographic</EM> depending on the projection in use;
444<BR>- if set to a file name  : output the plot in that file.  <BR><b>default:</b>0: no .FITS done
445<BR>
446In the case of Orthographic projection,
447<A HREF="#idl:mollview:half_sky">HALF_SKY</A> must be set.
448<BR>
449Except for the color mapping, all the keywords and options apply to the
450projected map, ie: its size is determined by
451<A HREF="#idl:mollview:pxsize">PXSIZE</A> (and <A HREF="#idl:mollview:pysize">PYSIZE</A>
452when applicable), its angular resolution by <A HREF="#idl:mollview:reso_arcmin">RESO_ARCMIN</A>
453when applicable, its orientation and coordinates by
454<A HREF="#idl:mollview:rot">ROT</A> and
455<A HREF="#idl:mollview:coord">COORD</A> respectively, ... <BR>
456For compatibility with standard FITS viewers (including
457<A ID="tex2html54"
458  HREF="https://www.astromatic.net/category/softwareposts/stiff">STIFF</A>), unobserved pixels, and
459pixels outside the sphere, take the value <TT>NaN</TT> (ie <TT>!values.f_nan</TT> in IDL).
460The resulting FITS file can be read in IDL with eg. map=<TT>readfits</TT>(<EM>filename</EM>).
461<BR><i>see also:</i><A HREF="#idl:mollview:map_out">Map_out</A></TD>
462</TR>
463</TABLE>
464
465<A HREF="#idl:mollview:TOP">Back to Format</A>
466<TABLE CELLPADDING=3 BORDER="1">
467<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
468<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
469<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
470</TR>
471<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/FLIP<A ID="idl:mollview:flip"></A></TD>
472<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
473<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set the longitude increases to the right, whereas by
474                default (astronomical convention) it increases towards the left</TD>
475</TR>
476<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>GAL_CUT=<A ID="idl:mollview:gal_cut"></A></TD>
477<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--MO</A></TD>
478<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>(positive float) specifies the symmetric galactic cut in degrees
479              outside of which the monopole and/or dipole fitting is done
480	<b>default:</b>0: monopole and dipole fit done on the whole sky
481              (<i>see also:</i><A HREF="#idl:mollview:no_dipole">No_dipole</A>, <A HREF="#idl:mollview:no_monopole">No_monopole</A>)</TD>
482</TR>
483<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>GIF=<A ID="idl:mollview:gif"></A></TD>
484<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
485<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>string containing the name of a .GIF output <BR>
486if set to 1            : outputs the plot in
487<TT>plot_</TT><EM>projection</EM><TT>.gif</TT>, where <EM>projection</EM> is either
488<TT>azimequid</TT>, <TT>cartesian</TT>, <TT>gnomic</TT>, <TT>mollweide</TT>
489or <TT>orthographic</TT>, <BR>
490if set to a file name  : outputs the plot in that file <BR>
491Please note that the resulting GIF image might not always look
492	      as expected. The reason for this is a problem with
493	      'backing store' in the IDL-routine TVRD. Please read the IDL
494	      documentation for more information. <BR><b>default:</b>no .GIF done <BR><i>see also:</i><A HREF="#idl:mollview:crop">Crop</A>,
495		<A HREF="#idl:mollview:jpeg">Jpeg</A>,
496		<A HREF="#idl:mollview:pdf">Pdf</A>,
497		<A HREF="#idl:mollview:png">Png</A>,
498		<A HREF="#idl:mollview:preview">Preview</A>,
499		<A HREF="#idl:mollview:ps">Ps</A>
500		and <A HREF="#idl:mollview:retain">Retain</A></TD>
501</TR>
502<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>GLSIZE=<A ID="idl:mollview:glsize"></A></TD>
503<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">CGMO</A></TD>
504<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>character size of the graticule labels in units of <TT>Charsize</TT>. <BR>
505Can be a scalar (which applies to both parallel and meridian labels),
506        or a 2 element vector (interpreted as [meridian_label_size, parallel_label_size])
507<BR><b>default:</b>0: no labeling of graticules. <BR><i>see also:</i><A HREF="#idl:mollview:charsize">Charsize</A>, <A HREF="#idl:mollview:graticule">Graticule</A>,
508	<A HREF="#idl:mollview:iglsize">Iglsize</A>,
509	<A HREF="#idl:mollview:igraticule">Igraticule</A></TD>
510</TR>
511<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>GRATICULE=<A ID="idl:mollview:graticule"></A></TD>
512<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">CGMO</A></TD>
513<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, puts a graticule (ie, longitude and latitude grid)
514	in the <EM>output</EM> astrophysical coordinates
515	with delta_long = delta_lat = gdef
516         degrees <BR>
517if set to a scalar <SPAN CLASS="MATH"><I>x</I>&gt;</SPAN> gmin then delta_long = delta_lat = <SPAN CLASS="MATH"><I>x</I></SPAN> <BR>
518if set to [x,y] with <SPAN CLASS="MATH"><I>x</I>,<I>y</I> &gt;</SPAN> gmin then delta_long = <SPAN CLASS="MATH"><I>x</I></SPAN> and delta_lat = <SPAN CLASS="MATH"><I>y</I></SPAN> <BR>
519cartview : gdef = 45, gmin =  0 <BR>
520gnomview : gdef =  5, gmin =  0 <BR>
521mollview : gdef = 45, gmin = 10 <BR>
522orthview : gdef = 45, gmin = 10 <BR>
523Note that the graticule will rotate with the sphere if Rot is set.
524	To outline only the equator set graticule=[360,90].
525	The automatic labeling of the graticule is controlled by <TT>Glsize</TT>
526<BR>
527The graticule line thickness is controlled via !P.THICK.
528<BR><b>default:</b>0 [no graticule] <BR><i>see also:</i><A HREF="#idl:mollview:igraticule">Igraticule</A>, <A HREF="#idl:mollview:rot">Rot</A>, <A HREF="#idl:mollview:coord">Coord</A>, <A HREF="#idl:mollview:glsize">Glsize</A></TD>
529</TR>
530</TABLE>
531
532<A HREF="#idl:mollview:TOP">Back to Format</A>
533<TABLE CELLPADDING=3 BORDER="1">
534<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
535<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
536<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
537</TR>
538<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/HALF_SKY<A ID="idl:mollview:half_sky"></A></TD>
539<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--O</A></TD>
540<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, only shows only one half of the sky
541   (centered on (0,0) or on the location parametrized by <A HREF="#idl:mollview:rot">Rot</A>) instead of the full sky</TD>
542</TR>
543<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>HBOUND=<A ID="idl:mollview:hbound"></A></TD>
544<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
545<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>scalar or vector of up to 3
546elements.
547If Hbound[i] is set to a valid <!-- MATH
548 $N_{\mathrm{side}}$
549 -->
550<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB></SPAN>, the routine will overplot the <b>HEALPix</b>  pixel
551boundaries corresponding to that <!-- MATH
552 $N_{\mathrm{side}}$
553 -->
554<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB></SPAN>
555on top of the map.
556The first <!-- MATH
557 $N_{\mathrm{side}}$
558 -->
559<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB></SPAN> will be plotted with solid lines,
560the second one (if any) with dashes and
561the third one (if any) with dots. Obviously, better results are
562obtained for Hbounds elements in growing order.
563Since 0-valued boundaries are not plotted, but used for linestyle
564assignment, providing Hbound=[0,4] (or [0,0,4]) will
565plot <!-- MATH
566 $N_{\mathrm{side}}=4$
567 -->
568<SPAN CLASS="MATH"><I>N</I><SUB>side</SUB>=4</SPAN> boundaries with dashes (resp. dots), while Hbound=4 would plot the same
569boundaries with solid lines.</TD>
570</TR>
571<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/HELP<A ID="idl:mollview:help"></A></TD>
572<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
573<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the routine header is printed (by doc_library)
574      and nothing else is done</TD>
575</TR>
576<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/HIST_EQUAL<A ID="idl:mollview:hist_equal"></A></TD>
577<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
578<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set,     uses a histogram equalized color mapping
579			(useful for non gaussian data field)
580		<b>default:</b>uses linear color mapping and
581                     		puts the level 0 in the middle
582                     		of the color scale (ie, green for Blue-Red)
583				unless <A HREF="#idl:mollview:min">Min</A> and
584	                               <A HREF="#idl:mollview:max">Max</A> are not symmetric
585<BR><i>see also:</i><A HREF="#idl:mollview:asinh">Asinh</A>, <A HREF="#idl:mollview:log">Log</A></TD>
586</TR>
587<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>HXSIZE=<A ID="idl:mollview:hxsize"></A></TD>
588<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
589<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>horizontal dimension (in cm) of the <A HREF="#idl:mollview:ps">Postscript</A> printout <BR><b>default:</b>26 cm <SPAN CLASS="MATH"><IMG STYLE="height: 1.05ex; vertical-align: -0.10ex; " SRC="idl_img86.png"
590 ALT="$\simeq$"></SPAN> 10 in <BR><i>see also:</i><A HREF="#idl:mollview:pxsize">Pxsize</A></TD>
591</TR>
592<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>IGLSIZE=<A ID="idl:mollview:iglsize"></A></TD>
593<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">CGMO</A></TD>
594<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>character size of the input coordinates graticule labels in units of <TT>Charsize</TT>. <BR>
595Either scalar or 2-element vector (see <A HREF="#idl:mollview:glsize">Glsize</A>).
596<BR><b>default:</b>0: no labeling of graticules. <BR><i>see also:</i><A HREF="#idl:mollview:charsize">Charsize</A>, <A HREF="#idl:mollview:igraticule">Igraticule</A></TD>
597</TR>
598<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>IGRATICULE=<A ID="idl:mollview:igraticule"></A></TD>
599<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">CGMO</A></TD>
600<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, puts a graticule (ie, longitude and latitude grid)
601	in the <EM>input</EM> astrophysical coordinates.
602	See Graticule for conventions and details.
603	If both Graticule and Igraticule are set, the latter will
604	be represented with dashes.
605<BR>
606The automatic labeling of the graticule is controlled by <TT>Iglsize</TT>
607<BR><b>default:</b>0 [no graticule] <BR><i>see also:</i><A HREF="#idl:mollview:graticule">Graticule</A>,
608<A HREF="#idl:mollview:rot">Rot</A>, <A HREF="#idl:mollview:coord">Coord</A>,
609<A HREF="#idl:mollview:iglsize">Iglsize</A></TD>
610</TR>
611</TABLE>
612
613<A HREF="#idl:mollview:TOP">Back to Format</A>
614<TABLE CELLPADDING=3 BORDER="1">
615<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
616<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
617<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
618</TR>
619<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>JPEG=<A ID="idl:mollview:jpeg"></A></TD>
620<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
621<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>string containing the name of a <EM>lossless</EM> .JPEG output file
622<BR>
623if set to 1            : outputs the plot in
624<TT>plot_</TT><EM>projection</EM><TT>.jpeg</TT>, where <EM>projection</EM> is either
625<TT>azimequid</TT>, <TT>cartesian</TT>, <TT>gnomic</TT>, <TT>mollweide</TT>
626or <TT>orthographic</TT>, <BR>
627if set to a file name  : output the plot in that file <BR><b>default:</b>no .JPEG done <BR><i>see also:</i>
628<A HREF="#idl:mollview:crop">Crop</A>,
629<A HREF="#idl:mollview:fits">Fits</A>,
630<A HREF="#idl:mollview:gif">Gif</A>,
631<A HREF="#idl:mollview:map_out">Map_out</A>,
632<A HREF="#idl:mollview:png">Png</A>,
633<A HREF="#idl:mollview:preview">Preview</A>,
634<A HREF="#idl:mollview:pdf">Pdf</A>,
635<A HREF="#idl:mollview:ps">Ps</A>,
636and <A HREF="#idl:mollview:retain">Retain</A></TD>
637</TR>
638<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>LATEX=<A ID="idl:mollview:latex"></A></TD>
639<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
640<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set to 1 or 2, enables <SPAN CLASS="logo,LaTeX">L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X</SPAN> handling of character strings such as
641<A HREF="#idl:mollview:titleplot">Titleplot</A>,
642<A HREF="#idl:mollview:subtitle">Subtitle</A> and
643<A HREF="#idl:mollview:units">Units</A>
644<BR>- if set to 2 <EM>with</EM> <A HREF="#idl:mollview:ps">PS</A> or
645          <A HREF="#idl:mollview:pdf">PDF</A> outputs, those strings (and the <A HREF="#idl:mollview:glsize">graticule labels</A>) will be processed
646           by genuine <SPAN CLASS="logo,LaTeX">L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X</SPAN> and inserted in the final PS or PDF file using <I>psfrag</I> package
647          (requires the ubiquitous <A ID="tex2html55"
648  HREF="https://www.ctan.org/starter"><TT>latex</TT></A>
649and its
650<A ID="tex2html56"
651  HREF="https://www.ctan.org/pkg/color"><I>color</I></A>,
652<A ID="tex2html57"
653  HREF="https://www.ctan.org/pkg/geometry"><I>geometry</I></A>,
654<A ID="tex2html58"
655  HREF="https://www.ctan.org/pkg/graphicx"><I>graphicx</I></A>
656and
657<A ID="tex2html59"
658  HREF="https://www.ctan.org/pkg/psfrag"><I>psfrag</I></A>
659packages as well as <A ID="tex2html60"
660  HREF="https://www.ctan.org/pkg/dvips"><TT>dvips</TT></A>).
661In this case, the
662<A HREF="#idl:mollview:pfonts">Pfonts</A> settings will be ignored.
663<BR>
664Note that <A ID="tex2html61"
665  HREF="http://www.idlcoyote.com/programs/cgps2raster.pro"><TT>cgPStoRASTER</TT></A>,
666<A ID="tex2html62"
667  HREF="https://www.imagemagick.org/script/index.php">ImageMagick <TT>convert</TT></A>
668and/or <A ID="tex2html63"
669  HREF="http://www.graphicsmagick.org/convert.html">GraphicsMagick <TT>gm convert</TT></A>
670can be used to turn a PS or PDF file into high resolution GIF, JPEG or PNG file.
671<BR>
672Beware that the option <TT>latex=2</TT> may not work properly under versions 0.9.5 and older of
673<A HREF="./install.htm#install:using_gdl"><TT>gdl</TT></A>.
674<BR>- if set to 1, with whatever output
675(<A HREF="#idl:mollview:gif">GIF</A>,
676<A HREF="#idl:mollview:jpeg">JPEG</A>,
677<A HREF="#idl:mollview:pdf">PDF</A>,
678<A HREF="#idl:mollview:png">PNG</A>,
679<A HREF="#idl:mollview:ps">PS</A>, or X)
680LaTeX is partially emulated with <A ID="tex2html64"
681  HREF="http://physics.mnstate.edu/craig/textoidl/"><TT>TeXtoIDL</TT></A>
682routines, which are now shipped with <b>HEALPix</b>
683
684(no extra requirements).
685In this case, <A HREF="#idl:mollview:pfonts">Pfonts</A> settings can be used.
686<BR><b>default:</b>0, no LaTeX handling</TD>
687</TR>
688<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/LOG<A ID="idl:mollview:log"></A></TD>
689<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
690<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>display the log of map. This is intended for
691 	application to positive definite maps only, eg. Galactic foreground
692	emission templates; for arbitrary maps, use /ASINH instead.	 <BR><i>see also:</i><A HREF="#idl:mollview:asinh">Asinh</A>, <A HREF="#idl:mollview:factor">Factor</A>, <A HREF="#idl:mollview:hist_equal">Hist_Equal</A>, <A HREF="#idl:mollview:offset">Offset</A></TD>
693</TR>
694<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>MAP_OUT=<A ID="idl:mollview:map_out"></A></TD>
695<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
696<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>variable that will contain the projected map on output.
697<BR>
698Except for the color mapping, all the keywords and options apply to the
699projected map, ie: its size is determined by
700<A HREF="#idl:mollview:pxsize">PXSIZE</A> (and <A HREF="#idl:mollview:pysize">PYSIZE</A>
701when applicable), its angular resolution by <A HREF="#idl:mollview:reso_arcmin">RESO_ARCMIN</A>
702when applicable, its orientation and coordinates by
703<A HREF="#idl:mollview:rot">ROT</A> and
704<A HREF="#idl:mollview:coord">COORD</A> respectively, ... <BR>
705Unobserved pixels, and pixels outside the sphere, take value <A HREF="idl_init_healpix_healpix_system.htm#idl:init_healpix"><TT>!healpix.bad_value</TT></A> (<!-- MATH
706 $=-1.6375\,10^{30}$
707 -->
708<SPAN CLASS="MATH"><IMG STYLE="height: 1.92ex; vertical-align: -0.29ex; " SRC="idl_img85.png"
709 ALT="$=-1.6375\,10^{30}$"></SPAN>).
710<BR><i>see also:</i><A HREF="#idl:mollview:fits">Fits</A></TD>
711</TR>
712</TABLE>
713
714<A HREF="#idl:mollview:TOP">Back to Format</A>
715<TABLE CELLPADDING=3 BORDER="1">
716<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
717<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
718<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
719</TR>
720<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>MAX=<A ID="idl:mollview:max"></A></TD>
721<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
722<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Set the maximum value for the plotted signal <BR><b>default:</b>is to use the actual signal
723	maximum.</TD>
724</TR>
725<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>MIN=<A ID="idl:mollview:min"></A></TD>
726<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
727<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Set the minimum value for the plotted signal <BR><b>default:</b>is to use the actual signal minimum.</TD>
728</TR>
729<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NESTED<A ID="idl:mollview:nested"></A></TD>
730<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
731<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>specify that the online data is ordered in the nested scheme</TD>
732</TR>
733<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NO_DIPOLE<A ID="idl:mollview:no_dipole"></A></TD>
734<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--MO</A></TD>
735<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set  (and Gal_cut is not set)
736                the best fit monopole *and* dipole over all valid pixels are
737                removed; <BR>
738if Gal_cut is set to <SPAN CLASS="MATH"><I>b</I>&gt;0</SPAN>, the best monopole and dipole fit is performed on all valid
739                pixels with <SPAN CLASS="MATH">|</SPAN>galactic latitude<SPAN CLASS="MATH">|&gt;<I>b</I></SPAN> (in deg) and is removed from
740                all valid pixels <BR><b>default:</b>0 (no monopole or dipole removal)
741<BR>
742can NOT be used together with No_monopole <BR><i>see also:</i><A HREF="#idl:mollview:gal_cut">Gal_cut</A>, <A HREF="#idl:mollview:no_monopole">No_monopole</A></TD>
743</TR>
744<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NO_MONOPOLE<A ID="idl:mollview:no_monopole"></A></TD>
745<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--MO</A></TD>
746<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set (and Gal_cut is not set)
747                the best fit monopole over all valid pixels is
748                removed; <BR>
749if Gal_cut is set to <SPAN CLASS="MATH"><I>b</I>&gt;0</SPAN>, the best monopole fit is performed on all valid
750                pixels with <SPAN CLASS="MATH">|</SPAN>galactic latitude<SPAN CLASS="MATH">|&gt;<I>b</I></SPAN> (in deg) and is removed from
751                all valid pixels <BR><b>default:</b>0 (no monopole removal)
752<BR>
753can NOT be used together with No_dipole <BR><i>see also:</i><A HREF="#idl:mollview:gal_cut">Gal_cut</A>, <A HREF="#idl:mollview:no_dipole">No_dipole</A></TD>
754</TR>
755<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NOBAR<A ID="idl:mollview:nobar"></A></TD>
756<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
757<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the color bar
758(or the color wheel used when <A HREF="#idl:mollview:polarization">Polarization</A>=2)
759is hidden; <i>see also:</i><A HREF="#idl:mollview:customize">CUSTOMIZE</A></TD>
760</TR>
761<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NOLABELS<A ID="idl:mollview:nolabels"></A></TD>
762<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
763<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, color bar labels (min and max) are not present, <b>default:</b>
764	labels are present; <i>see also:</i><A HREF="#idl:mollview:customize">CUSTOMIZE</A></TD>
765</TR>
766<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/NOPOSITION<A ID="idl:mollview:noposition"></A></TD>
767<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">-G-</A></TD>
768<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the astronomical location of the map
769        central point is not indicated; <i>see also:</i><A HREF="#idl:mollview:customize">CUSTOMIZE</A></TD>
770</TR>
771<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>OFFSET=<A ID="idl:mollview:offset"></A></TD>
772<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
773<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>scalar additive factor to be applied to the valid data <BR>
774the data plotted is of the form Factor*(data + Offset) <BR>
775This does not affect the flagged pixels <BR>
776can be used together with ASINH or LOG <BR>
777When used with TRUECOLORS, OFFSET can be a 3-element vector. <BR><i>see also:</i><A HREF="#idl:mollview:asinh">ASINH</A>, <A HREF="#idl:mollview:factor">Factor</A>, <A HREF="#idl:mollview:log">LOG</A>, <A HREF="#idl:mollview:truecolors">TRUECOLORS</A> <BR><b>default:</b>0.0</TD>
778</TR>
779</TABLE>
780
781<A HREF="#idl:mollview:TOP">Back to Format</A>
782<TABLE CELLPADDING=3 BORDER="1">
783<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
784<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
785<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
786</TR>
787<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>OUTLINE=<A ID="idl:mollview:outline"></A></TD>
788<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">CGMO</A></TD>
789<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>IDL structure, array of (same size) structures, or structure of (mixed size) structures
790     (see <A HREF="#idl:mollview:outline:note">Note below</A>),
791       containing the description of one (or several) outline(s) to
792      be overplotted on the final map.
793<BR>
794For each contour or point list, the corresponding (sub)structure should
795	contain the following fields:  <BR>- 'COORD': coordinate system (either 'C'/'Q', 'G' or 'E') of the contour
796           (same meaning as in <A HREF="#idl:mollview:coord">Coord</A>)
797<BR>- 'RA': RA/longitude coordinates of the contour vertices (array or scalar) <BR>- 'DEC': Dec/latitude coordinates of the contour vertices (array or
798scalar)
799<BR>
800and can optionally contain the fields: <BR>- 'LINE[STYLE]': (optional, scalar) <B>+2</B>: black dashes, <B>+1</B>: black dots, <B>0</B>: black solid (default), <B>-1</B>: black dots on white background, <B>-2</B>: black dashes on
801	white background
802<BR>- 'PSY[M]': (optional, scalar) symbol used to represent vertices (same meaning as
803	    standard PSYM in IDL. If <!-- MATH
804 $9\leq|\mathrm{psym}|\leq 46$
805 -->
806<SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img87.png"
807 ALT="$9\leq\vert\mathrm{psym}\vert\leq 46$"></SPAN>, D. Fanning's
808<A ID="tex2html65"
809  HREF="http://www.idlcoyote.com/programs/cgsymcat.pro"><TT>cgSYMCAT.PRO</TT></A>
810symbols
811                     definition will be used; for example, psym=9 is an open circle). If <SPAN CLASS="MATH"><IMG STYLE="height: 1.92ex; vertical-align: -0.41ex; " SRC="idl_img88.png"
812 ALT="$\leq 0$"></SPAN>, the vertices are represented with the chosen symbols, and
813                        connected by arcs of geodesics;
814                    if <SPAN CLASS="MATH">&gt;0</SPAN>, only the vertices are shown
815                    <b>default:</b>0 <BR>- 'SYM[SIZE]': (optional, scalar) vertice symbol size (same meaning
816as SYMSIZE in IDL), <b>default:</b>1
817<BR>
818The line and symbol thickness can be controlled (indirectly) via !P.THICK.
819<BR>
820Notes: when applicable, the vertices are connected by segments of geodesics. To
821	obtain a better looking outline, increase the number of vertices
822	provided. The outline does not have to be closed. The procedure will NOT
823	attempt to close the outline. See
824<A HREF="#idl:mollview:example2">Example #2</A> below.
825<BR><B>Note:</B><A ID="idl:mollview:outline:note"></A> several outlines
826(let's say <TT>circle</TT> and <A HREF="#idl:mollview:example2"><TT>triangle</TT></A>)
827 can be overplotted at once by gathering the respective structures into an array
828(<TT>outline=[circle,triangle]</TT>) if they have the same features and in particular the same number of vertices, or in
829one meta-structure (<TT>outline={s1:circle,s2:triangle}</TT>) in all cases.
830<BR><i>see also:</i><A HREF="#idl:mollview:coord">Coord</A>, <A HREF="#idl:mollview:graticule">Graticule</A></TD>
831</TR>
832</TABLE>
833
834<A HREF="#idl:mollview:TOP">Back to Format</A>
835<TABLE CELLPADDING=3 BORDER="1">
836<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
837<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
838<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
839</TR>
840<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PDF=<A ID="idl:mollview:pdf"></A></TD>
841<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
842<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>string containing the name of a .PDF output <BR>
843if set to 0            : no PDF output <BR>
844if set to 1            : outputs the plot in
845<TT>plot_</TT><EM>projection</EM><TT>.pdf</TT>, where <EM>projection</EM> is either
846<TT>azimequid</TT>, <TT>cartesian</TT>, <TT>gnomic</TT>, <TT>mollweide</TT>
847or <TT>orthographic</TT>, <BR>
848if set to a file name  : outputs the plot in that file <BR><b>default:</b>0 <BR>
849The PDF file is produced from a PostScript file using the script <A ID="tex2html66"
850  HREF="https://tug.org/epstopdf/"><TT>epstopdf</TT></A>
851now shipped with <b>HEALPix</b>. Note that <TT>epstopdf</TT> usually requires a fully functional implementation of the fairly widespread <TT>gs</TT>, aka
852<A ID="tex2html67"
853  HREF="https://en.wikipedia.org/wiki/Ghostscript"><TT>Ghostscript</TT></A>, which may however not be available on the computation dedicated nodes of some computer clusters.
854<BR>
855If the resulting PDF file is not properly rotated (ie landscape orientation instead of portrait),
856and/or has excessive white margins, the scripts
857<A ID="tex2html68"
858  HREF="https://linux.die.net/man/1/pdf90"><TT>pdf90</TT></A>, part of the package
859<A ID="tex2html69"
860  HREF="https://www2.warwick.ac.uk/fac/sci/statistics/staff/academic-research/firth/software/pdfjam/"><TT>pdfjam</TT></A>, and/or
861<A ID="tex2html70"
862  HREF="http://pdfcrop.sourceforge.net"><TT>pdfcrop</TT></A>,
863often included in PDFTeX installations,
864can respectively prove very useful.
865<BR><i>see also:</i>
866<A HREF="#idl:mollview:preview">Preview</A>,
867<A HREF="#idl:mollview:gif">Gif</A>,
868<A HREF="#idl:mollview:jpeg">Jpeg</A>,
869<A HREF="#idl:mollview:png">Png</A>,
870<A HREF="#idl:mollview:ps">Ps</A></TD>
871</TR>
872</TABLE>
873
874<A HREF="#idl:mollview:TOP">Back to Format</A>
875<TABLE CELLPADDING=3 BORDER="1">
876<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
877<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
878<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
879</TR>
880<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PFONTS=<A ID="idl:mollview:pfonts"></A></TD>
881<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
882<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>2-element vector of integers [<SPAN CLASS="MATH"><I>p</I><SUB><i>0</i></SUB></SPAN>, <SPAN CLASS="MATH"><I>p</I><SUB><i>1</i></SUB></SPAN>] selecting the default IDL font of character strings such as the
883<A HREF="#idl:mollview:subtitle">Subtitle</A>,
884<A HREF="#idl:mollview:titleplot">Titleplot</A> and
885<A HREF="#idl:mollview:units">Units</A>.
886<BR><SPAN CLASS="MATH"><I>p</I><SUB><i>0</i></SUB></SPAN> must be in <SPAN CLASS="MATH">{-1,0,1}</SPAN> and selects the origin of the fonts among
887-1: <A ID="tex2html71"
888  HREF="http://www.exelisvis.com/docs/Using_Hershey_Vector_Fon.html">Hershey Vector</A>,
8890:  <A ID="tex2html72"
890  HREF="http://www.exelisvis.com/docs/using_device_fonts.html">Device Specific</A>
891and
8921:  <A ID="tex2html73"
893  HREF="http://www.exelisvis.com/docs/using_truetype_fonts.html">True Type</A>
894Fonts.
895<BR><SPAN CLASS="MATH"><I>p</I><SUB><i>1</i></SUB></SPAN> must be in <!-- MATH
896 $\{2,\ldots,20\}$
897 -->
898<SPAN CLASS="MATH"><IMG STYLE="height: 2.33ex; vertical-align: -0.68ex; " SRC="idl_img89.png"
899 ALT="$\{2,\ldots,20\}$"></SPAN> and selects the starting font of the character strings as described
900<A ID="tex2html74"
901  HREF="http://www.exelisvis.com/docs/Embedded_Formatting_Comm.html">here</A>.
902The font can be changed within each string with embedded formatting commands, as discussed on
903<A ID="tex2html75"
904  HREF="http://www.exelisvis.com/docs/Fonts_and_Colors.html"><SMALL CLASS="SMALL"><TT>
905http://www.exelisvis.com/docs/Fonts_and_Colors.html</SMALL></TT></A>.
906<BR><b>default:</b>[-1,6], corresponding to the Hershey vector font of type 'Complex Roman', and is equivalent to typing
907<TT>!p.font=-1</TT> and prepending the
908<A HREF="#idl:mollview:subtitle">Subtitle</A>,
909<A HREF="#idl:mollview:titleplot">Titleplot</A> and
910<A HREF="#idl:mollview:units">Units</A>
911strings with <TT>'!6'</TT>.
912<BR>
913Note that PFONTS will be ignored if <A HREF="#idl:mollview:latex">Latex</A>=2 <EM>and</EM>
914<A HREF="#idl:mollview:pdf">PDF</A> or <A HREF="#idl:mollview:ps">PS</A> are set.</TD>
915</TR>
916<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PNG=<A ID="idl:mollview:png"></A></TD>
917<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
918<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>string containing the name of a .PNG output <BR>
919if set to 1            : outputs the plot in
920<TT>plot_</TT><EM>projection</EM><TT>.png</TT>, where <EM>projection</EM> is either
921<TT>azimequid</TT>, <TT>cartesian</TT>, <TT>gnomic</TT>, <TT>mollweide</TT>
922or <TT>orthographic</TT>, <BR>
923if set to a file name  : outputs the plot in that file <BR>
924Please note that the resulting PNG image might not always look
925	      as expected. The reason for this is problems with
926	      'backing store' in the IDL-routine TVRD. Please read the IDL
927	      documentation for more information. <BR><b>default:</b>no .PNG done <BR><i>see also:</i>
928<A HREF="#idl:mollview:crop">Crop</A>,
929<A HREF="#idl:mollview:fits">Fits</A>,
930<A HREF="#idl:mollview:gif">Gif</A>,
931<A HREF="#idl:mollview:jpeg">Jpeg</A>,
932<A HREF="#idl:mollview:map_out">Map_out</A>,
933<A HREF="#idl:mollview:preview">Preview</A>,
934<A HREF="#idl:mollview:pdf">Pdf</A>,
935<A HREF="#idl:mollview:ps">Ps</A>,
936and <A HREF="#idl:mollview:retain">Retain</A></TD>
937</TR>
938</TABLE>
939
940<A HREF="#idl:mollview:TOP">Back to Format</A>
941<TABLE CELLPADDING=3 BORDER="1">
942<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
943<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
944<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
945</TR>
946<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>POLARIZATION=<A ID="idl:mollview:polarization"></A></TD>
947<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
948<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set to
949	<DL COMPACT><DT><DD><IMG WIDTH="14" HEIGHT="14" SRC="greenball.png" ALT="*">
950<B>0:</B>
951no polarization information is plotted;
952<DT><DD><IMG WIDTH="14" HEIGHT="14" SRC="greenball.png" ALT="*">
953<B>1:</B>
954the AMPLITUDE <!-- MATH
955 $P = \sqrt{U^2 + Q^2}$
956 -->
957<SPAN CLASS="MATH"><IMG STYLE="height: 2.39ex; vertical-align: -0.55ex; " SRC="idl_img90.png"
958 ALT="$P = \sqrt{U^2 + Q^2}$"></SPAN> of the polarization is plotted
959	(as long as the input data contains polarization information
960             (ie, Stokes parameter <SPAN CLASS="MATH"><I>Q</I></SPAN> and <SPAN CLASS="MATH"><I>U</I></SPAN> for each pixel));
961<DT><DD><IMG WIDTH="14" HEIGHT="14" SRC="greenball.png" ALT="*">
962<B>2:</B>
963the ANGLE <!-- MATH
964 $\phi = \tan^{-1}(U/Q) /2$
965 -->
966<SPAN CLASS="MATH"><IMG STYLE="height: 2.45ex; vertical-align: -0.68ex; " SRC="idl_img91.png"
967 ALT="$\phi = \tan^{-1}(U/Q) /2$"></SPAN> of the polarization is plotted <BR>
968Note: the angles are color coded with a fixed color table (independent of <A HREF="#idl:mollview:colt">Colt</A>);
969<DT><DD><IMG WIDTH="14" HEIGHT="14" SRC="greenball.png" ALT="*">
970<B>3:</B>
971-the temperature is color coded (with a color table defined by <A HREF="#idl:mollview:colt">Colt</A>),
972<BR>-and the polarization is overplotted as small RODS (or headless VECTORS).
973<BR><SPAN  CLASS="texttt">Polarization</SPAN> can then be a 4-element vector (the first element being 3).
974             The second element controls the average length of the rods <b>default:</b>1,
975             the third one controls their spacing <b>default:</b>1,
976             while the fourth one controls their thickness
977             (which also depends in a device dependent manner on <SPAN  CLASS="texttt">!P.THICK</SPAN>) <b>default:</b>1.
978             Non-positive values are replaced by 1.
979<BR><i>see also:</i><A HREF="#idl:mollview:customize">Customize</A>
980
981<P>
982
983</DL>
984	<b>default:</b>0 <BR><SPAN  CLASS="textbf">Note 1:</SPAN> The representation of the polarization direction (options 2 and 3 above),
985        include the effects of the rotations and/or changes or astronomical coordinates
986      (controlled by <A HREF="#idl:mollview:rot">ROT</A> and
987	<A HREF="#idl:mollview:coord">COORD</A> respectively) but do not include the effects
988      of the distortions induced by the projection from the sphere to the plan.
989      Because the polarization usually has more power at small scales, it must
990      generally be represented on maps of small patches of the sky to remain
991      legible, in which case the projection-induced distortions are small.
992<BR><SPAN  CLASS="textbf">Note 2:</SPAN> when <SPAN  CLASS="texttt">polarization=2</SPAN> or <SPAN  CLASS="texttt">polarization=3</SPAN>, the visualisation routines behavior
993     will depend on the value of the <SPAN  CLASS="texttt">POLCCONV</SPAN> FITS keyword
994     (see <A HREF="./intro_HEALPix_conventions.htm#intro:polcconv">note on POLCCONV</A> in <A ID="tex2html76"
995  HREF="intro.htm">The <b>HEALPix</b> Primer</A>)</TD>
996</TR>
997</TABLE>
998
999<A HREF="#idl:mollview:TOP">Back to Format</A>
1000<TABLE CELLPADDING=3 BORDER="1">
1001<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
1002<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
1003<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
1004</TR>
1005<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/PREVIEW<A ID="idl:mollview:preview"></A></TD>
1006<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1007<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the external file generated with <A HREF="#idl:mollview:gif">Gif</A>,
1008		<A HREF="#idl:mollview:jpeg">Jpeg</A>,
1009		<A HREF="#idl:mollview:pdf">Pdf</A>,
1010		<A HREF="#idl:mollview:png">Png</A>,
1011		or <A HREF="#idl:mollview:ps">Ps</A> will be previewed with the
1012		visualisation applications (eg, <TT>gv</TT>, <TT>display</TT> or <TT>open</TT>)
1013		chosen during the <A HREF="./install.htm#install:idlgdlconfig"><b>HEALPix</b> IDL/GDL configuration step</A></TD>
1014</TR>
1015<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PS=<A ID="idl:mollview:ps"></A></TD>
1016<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1017<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set to 0            : no PostScript output <BR>
1018if set to 1            : outputs the plot
1019<TT>plot_</TT><EM>projection</EM><TT>.ps</TT>, where <EM>projection</EM> is either
1020<TT>azimequid</TT>, <TT>cartesian</TT>, <TT>gnomic</TT>, <TT>mollweide</TT>
1021or <TT>orthographic</TT>, <BR>
1022if set to a file name  : outputs the plot in that file <BR><b>default:</b>0 <BR><i>see also:</i>
1023<A HREF="#idl:mollview:preview">Preview</A>,
1024<A HREF="#idl:mollview:gif">Gif</A>,
1025<A HREF="#idl:mollview:jpeg">Jpeg</A>,
1026<A HREF="#idl:mollview:pdf">Pdf</A>,
1027<A HREF="#idl:mollview:png">Png</A></TD>
1028</TR>
1029<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PXSIZE=<A ID="idl:mollview:pxsize"></A></TD>
1030<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1031<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>set the number of horizontal screen_pixels or postscript_color_dots of the plot
1032    		(useful for high definition color printer) or elements of the
1033output map
1034<BR><b>default:</b>800 (Mollview and full sky Orthview), 600 (half sky
1035		Orthview), 500 (Cartview and Gnomonic) <BR><i>see also:</i>
1036<A HREF="#idl:mollview:fits">FITS</A>,
1037<A HREF="#idl:mollview:gif">GIF</A>,
1038<A HREF="#idl:mollview:jpeg">JPEG</A>,
1039<A HREF="#idl:mollview:map_out">MAP_OUT</A>,
1040<A HREF="#idl:mollview:pdf">PDF</A>,
1041<A HREF="#idl:mollview:png">PNG</A>,
1042<A HREF="#idl:mollview:ps">PS</A>.</TD>
1043</TR>
1044<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>PYSIZE=<A ID="idl:mollview:pysize"></A></TD>
1045<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">ACG-</A></TD>
1046<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>set the number of vertical screen_pixels or postscript_color_dots of the plot <BR><b>default:</b><A HREF="#idl:mollview:pxsize">Pxsize</A>.</TD>
1047</TR>
1048<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>RESO_ARCMIN=<A ID="idl:mollview:reso_arcmin"></A></TD>
1049<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">ACG-</A></TD>
1050<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>size of screen_pixels or postscript_color_dots in arcmin <BR><b>default:</b>1.5
1051<BR><i>see also:</i>
1052<A HREF="#idl:mollview:fits">FITS</A>,
1053<A HREF="#idl:mollview:gif">GIF</A>,
1054<A HREF="#idl:mollview:jpeg">JPEG</A>,
1055<A HREF="#idl:mollview:map_out">MAP_OUT</A>,
1056<A HREF="#idl:mollview:pdf">PDF</A>,
1057<A HREF="#idl:mollview:png">PNG</A>,
1058<A HREF="#idl:mollview:ps">PS</A>.</TD>
1059</TR>
1060<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>RETAIN=<A ID="idl:mollview:retain"></A></TD>
1061<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1062<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>specifies the type of
1063backing store to use for direct graphics windows in {0,1,2}.
1064<b>default:</b>2. See IDL documentation for details.</TD>
1065</TR>
1066<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>ROT=<A ID="idl:mollview:rot"></A></TD>
1067<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1068<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>vector with 1, 2 or 3 elements specifing the rotation angles in DEGREES
1069               to apply to the map in the 'output' coordinate system (see <A HREF="#idl:mollview:coord">Coord</A>)
1070             = ( lon0, [lat0, rat0])  <BR>
1071lon0 : longitude of the point to be put at the center of the plot
1072		       the longitude increases Eastward, ie to the left of the plot
1073 		      <b>default:</b>0 <BR>
1074lat0 : latitude of the point to be put at the center of the plot
1075 		      <b>default:</b>0 <BR>
1076rot0 : anti clockwise rotation to apply to the sky around the
1077                     center (lon0, lat0) before projecting
1078                     <b>default:</b>0 </TD>
1079</TR>
1080</TABLE>
1081
1082<A HREF="#idl:mollview:TOP">Back to Format</A>
1083<TABLE CELLPADDING=3 BORDER="1">
1084<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
1085<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
1086<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
1087</TR>
1088<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/SAVE<A ID="idl:mollview:save"></A></TD>
1089<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1090<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, assumes that <A HREF="#idl:mollview:file">File</A> is in IDL saveset format,
1091    		the variable saved should be DATA</TD>
1092</TR>
1093<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>
1094<P>
1095/SHADED<A ID="idl:mollview:shaded"></A></TD>
1096<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--O</A></TD>
1097<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the orthographic sphere is shaded, using a Phong model, to emulate 3D viewing.
1098              The sphere is illuminated by isotropic ambiant light plus a single light source.
1099                 Can NOT be used with <A HREF="#idl:mollview:gif">GIF</A>.</TD>
1100</TR>
1101<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>/SILENT<A ID="idl:mollview:silent"></A></TD>
1102<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1103<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set, the program runs silently, and extra debugging switches such as
1104		<A HREF="#idl:mollview:customize">customize={pdf:{debug:1}}</A>
1105		will be ignored.</TD>
1106</TR>
1107<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>SILHOUETTE=<A ID="idl:mollview:silhouette"></A></TD>
1108<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--MO</A></TD>
1109<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if set to a scalar or 2-element vector with silhouette[0] <SPAN CLASS="MATH"><IMG STYLE="height: 2.21ex; vertical-align: -0.55ex; " SRC="idl_img92.png"
1110 ALT="$\ne 0$"></SPAN>,
1111          a silhouette is drawn around the map.
1112<BR>
1113Its thickness is proportional to abs(silhouette[0])
1114           (and also depends in a device dependent manner on <SPAN  CLASS="texttt">!P.THICK</SPAN>)
1115<BR>
1116Its color is determined by abs(silhouette[1]) in [0,255] <b>default:</b>0:<A HREF="#idl:mollview:fg_color">FG_COLOR</A>.
1117<BR>
1118See <A HREF="#idl:mollview:example7">Example #7</A> below.</TD>
1119</TR>
1120<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>STAGGER=<A ID="idl:mollview:stagger"></A></TD>
1121<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">--O</A></TD>
1122<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>Scalar or 2 element vector:
1123<BR>- if <TT>stagger[0]</TT> is in <SPAN CLASS="MATH">]0,2]</SPAN>,
1124             three copies of the same sphere centered respectively at <TT>[-stagger[0], 0, stagger[0]]</TT>
1125             (expressed in radius units) along the plot horizontal axis are
1126             shown in ORTHOGRAPHIC projection
1127<BR>- if set, <TT>stagger[1]</TT> defines the angle of rotation (in degrees) applied
1128               to the left and right partial spheres:
1129             the <I>lhs</I> sphere is rotated downward by the angle provided,
1130while the <I>rhs</I> one
1131             is rotated upward. Rotations are swapped if <A HREF="#idl:mollview:flip">FLIP</A> is set.
1132<BR>
1133Currently <B>can not</B> be used with
1134<A HREF="#idl:mollview:graticule">Graticule</A> nor
1135<A HREF="#idl:mollview:igraticule">igraticule</A></TD>
1136</TR>
1137<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>SUBTITLE=<A ID="idl:mollview:subtitle"></A></TD>
1138<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1139<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>String containing the subtitle to the plot
1140<BR><i>see also:</i><A HREF="#idl:mollview:titleplot">Titleplot</A>,
1141<A HREF="#idl:mollview:latex">Latex</A>, <A HREF="#idl:mollview:customize">Customize</A></TD>
1142</TR>
1143<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>TITLEPLOT=<A ID="idl:mollview:titleplot"></A></TD>
1144<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1145<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>String containing the title of the plot,
1146     		if not set the title will be File
1147<BR><i>see also:</i><A HREF="#idl:mollview:subtitle">Subtitle</A>,
1148<A HREF="#idl:mollview:latex">Latex</A>, <A HREF="#idl:mollview:customize">Customize</A></TD>
1149</TR>
1150<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>TRANSPARENT=<A ID="idl:mollview:transparent"></A></TD>
1151<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1152<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>If set to 1, the input data pixels with value <A HREF="idl_init_healpix_healpix_system.htm#idl:init_healpix"><TT>!healpix.bad_value</TT></A> (<!-- MATH
1153 $=-1.6375\,10^{30}$
1154 -->
1155<SPAN CLASS="MATH"><IMG STYLE="height: 1.92ex; vertical-align: -0.29ex; " SRC="idl_img85.png"
1156 ALT="$=-1.6375\,10^{30}$"></SPAN>)
1157will appear totally transparent on the output PNG file (instead of the usual
1158grey or <A HREF="#idl:mollview:bad_color">BAD_COLOR</A>).
1159<BR>
1160If set to 2, the background pixels will be transparent (instead of the usual
1161white or <A HREF="#idl:mollview:bg_color">BG_COLOR</A>)
1162<BR>
1163If set to 3, both the grey and white pixels will look transparent.
1164<BR>
1165Active only in conjunction with <A HREF="#idl:mollview:png">PNG</A></TD>
1166</TR>
1167</TABLE>
1168
1169<A HREF="#idl:mollview:TOP">Back to Format</A>
1170<TABLE CELLPADDING=3 BORDER="1">
1171<TR><TH ALIGN="LEFT" VALIGN="TOP" WIDTH=95><SPAN  CLASS="textbf">name</SPAN></TH>
1172<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=40><SPAN  CLASS="textbf">routines</SPAN></TH>
1173<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=350><SPAN  CLASS="textbf"> description</SPAN></TH>
1174</TR>
1175<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>TRUECOLORS=<A ID="idl:mollview:truecolors"></A></TD>
1176<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1177<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>if the input data is of the form [Npix,3], then the 3 fields
1178            are respectively understood as Red, Green, Blue True-Color
1179channels, and the <A HREF="#idl:mollview:colt">color table</A> is ignored.
1180<BR>- If set to 1, the mapping field-intensity to color is done for the 3 channels at once. (<i>see also:</i><A HREF="#idl:mollview:factor">Factor</A>, <A HREF="#idl:mollview:offset">Offset</A>)
1181<BR>- If set to 2, that mapping is done for each channel separately (in that case, <A HREF="#idl:mollview:min">MIN</A>
1182and <A HREF="#idl:mollview:max">MAX</A> keywords are ignored).</TD>
1183</TR>
1184<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>UNITS=<A ID="idl:mollview:units"></A></TD>
1185<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1186<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>String containing the units, to be put on the right
1187		hand side of the color bar, overrides the value read from the input file,
1188		if any
1189<BR><i>see also:</i><A HREF="#idl:mollview:nobar">Nobar</A>, <A HREF="#idl:mollview:nolabels">Nolabels</A>,
1190<A HREF="#idl:mollview:latex">Latex</A></TD>
1191</TR>
1192<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>WINDOW=<A ID="idl:mollview:window"></A></TD>
1193<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1194<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>IDL window index (integer)
1195<BR>- if WINDOW <SPAN CLASS="MATH">&lt; 0</SPAN>: virtual window: no visible window opened. Can
1196                 be used with <A HREF="#idl:mollview:png">PNG</A>, <A HREF="#idl:mollview:jpeg">JPEG</A>,
1197 or <A HREF="#idl:mollview:gif">GIF</A>, in particular if those files are
1198larger than the screen. <B>Note:</B> The Z buffer will be used instead of the X server,
1199allowing much faster production of the image over a slow network
1200<BR>- if WINDOW in <SPAN CLASS="MATH">[0,31]</SPAN>: the specified IDL window with index WINDOW is used
1201               (or reused). Can be used to have a sequence of images appear
1202in the same window <BR>- if WINDOW <SPAN CLASS="MATH">&gt; 31</SPAN>: a free (<SPAN CLASS="MATH">=</SPAN>unused) window with a random index <SPAN CLASS="MATH">&gt; 31</SPAN> will be
1203               created and used. <BR><b>default:</b>32, if X server properly set; -1, otherwise</TD>
1204</TR>
1205<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>XPOS=<A ID="idl:mollview:xpos"></A></TD>
1206<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1207<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>The X position on the screen of the lower left corner
1208	        of the window, in device coordinate</TD>
1209</TR>
1210<TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=95>YPOS=<A ID="idl:mollview:ypos"></A></TD>
1211<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=40><A HREF="#idl:mollview:routines">all</A></TD>
1212<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=350>The Y position on the screen of the lower left corner
1213               of the window, in device coordinate
1214
1215<P></TD>
1216</TR>
1217</TABLE>
1218
1219<A HREF="#idl:mollview:TOP">Back to Format</A>
1220
1221<P>
1222
1223<hr>
1224<H1>DESCRIPTION</H1>
1225<blockquote>
1226<br><br><FONT COLOR="#CC0000">mollview</FONT> reads in a <b>HEALPix</b> sky map in FITS format and generates
1227a Mollweide projection of it, that can be visualized on the screen or
1228exported in a GIF, JPEG, PNG, PDF or Postscript file. <FONT COLOR="#CC0000">mollview</FONT>  allows the selection of
1229the coordinate system, map size, color table, color bar inclusion,
1230linear, log, hybrid or histogram equalised color scaling,
1231maximum and
1232minimum range for the plot, plot-title <I>etc</I>. It also allows the representation of the
1233polarization field.
1234</blockquote>
1235
1236<P>
1237
1238<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">mollview</FONT></b></h3>
1239
1240  <DL COMPACT><DT>
1241<B>idl</B>
1242<DD>version 6.4 or more is necessary to run <FONT COLOR="#CC0000">mollview</FONT>
1243  <DT>
1244<B>gv, ghostview</B>
1245<DD>gv, ghostview or a similar facility is required to view
1246	  the Postscript or PDF images generated by <FONT COLOR="#CC0000">mollview</FONT>.
1247  <DT>
1248<B>display, xv</B>
1249<DD>display, xv or a similar facility is required to view the
1250            GIF/JPEG/PNG image generated by <FONT COLOR="#CC0000">mollview</FONT> (a browser can also
1251            be used).
1252  <DT>
1253<B><A HREF="./fac_synfast.htm#fac:synfast">synfast</A>, <A HREF="./fac_smoothing.htm#fac:smoothing">smoothing</A></B>
1254<DD>These F90 <b>HEALPix</b> facilities will generate the FITS format
1255            sky maps to be input to <FONT COLOR="#CC0000">mollview</FONT>.
1256  <DT>
1257<B><A HREF="idl_isynfast.htm#idl:isynfast">isynfast</A>, <A HREF="idl_ismoothing.htm#idl:ismoothing">ismoothing</A></B>
1258<DD>These IDL routines will generate the FITS format
1259            sky maps to be input to <FONT COLOR="#CC0000">mollview</FONT>.
1260  <DT>
1261<B><A HREF="idl_cartview.htm#idl:cartview">cartview</A></B>
1262<DD>IDL facility to generate a Cartesian projection of
1263  	a <b>HEALPix</b> map.
1264  <DT>
1265<B><A HREF="idl_cartcursor.htm#idl:cartcursor">cartcursor</A></B>
1266<DD>interactive cursor to be used with cartview
1267  <DT>
1268<B><A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A></B>
1269<DD>IDL facility to generate a gnomonic projection of
1270  	a <b>HEALPix</b> map.
1271  <DT>
1272<B><A HREF="idl_gnomcursor.htm#idl:gnomcursor">gnomcursor</A></B>
1273<DD>interactive cursor to be used with gnomview
1274  <DT>
1275<B><A HREF="#idl:mollview">mollview</A></B>
1276<DD>IDL facility to generate a Mollweide projection of
1277  	a <b>HEALPix</b> map.
1278  <DT>
1279<B><A HREF="idl_mollcursor.htm#idl:mollcursor">mollcursor</A></B>
1280<DD>interactive cursor to be used with mollview
1281  <DT>
1282<B><A HREF="idl_orthview.htm#idl:orthview">orthview</A></B>
1283<DD>IDL facility to generate an orthographic projection of
1284  	a <b>HEALPix</b> map.
1285  <DT>
1286<B><A HREF="idl_orthcursor.htm#idl:orthcursor">orthcursor</A></B>
1287<DD>interactive cursor to be used with orthview
1288  <DT>
1289<B><A HREF="idl_planck_colors.htm#idl:planck_colors">planck_colors</A></B>
1290<DD>creates color tables used in Planck 2013 publications
1291  </DL>
1292
1293<P>
1294<hr><H1>EXAMPLE # 1:</H1>
1295<tt><A ID="idl:mollview:example1"></A><TABLE CELLPADDING=3>
1296<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview"><FONT COLOR="#CC0000">mollview</FONT></A>,  <A HREF="#idl:mollview:file">'planck100GHZ-LFI.fits'</A>, <A HREF="#idl:mollview:min">min</A>=-100, <A HREF="#idl:mollview:max">max</A>=100, <A HREF="#idl:mollview:graticule">/graticule</A>, $</TD>
1297</TR>
1298<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:titleplot">title</A>='Simulated Planck LFI Sky Map at 100GHz'</TD>
1299</TR>
1300</TABLE></tt>
1301<blockquote><FONT COLOR="#CC0000">mollview</FONT> reads in the map 'planck100GHZ-LFI.fits' and generates
1302an output image in which
1303the temperature scale has been set to lie between <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.29ex; " SRC="idl_img65.png"
1304 ALT="$\pm$"></SPAN> 100 (<SPAN CLASS="MATH"><IMG STYLE="height: 1.57ex; vertical-align: -0.55ex; " SRC="idl_img66.png"
1305 ALT="$\mu$"></SPAN>K),
1306a <A HREF="#idl:mollview:graticule">graticule</A> with a 45 degree step in longitude and latitude is drawn,
1307and the <A HREF="#idl:mollview:titleplot">title</A> 'Simulated Planck LFI Sky Map at 100GHz' appended to the image.
1308</blockquote>
1309<hr><H1>EXAMPLE # 2:</H1>
1310<tt><A ID="idl:mollview:example2"></A><TABLE CELLPADDING=3>
1311<TR><TD ALIGN="LEFT">
1312<P>
1313map  = findgen(48)</TD>
1314</TR>
1315<TR><TD ALIGN="LEFT">triangle= create_struct('coord','G','ra',[0,80,0],'dec',[40,45,65])</TD>
1316</TR>
1317<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview"><FONT COLOR="#CC0000">mollview</FONT></A>,<A HREF="#idl:mollview:file">map</A>, <A HREF="#idl:mollview:graticule">graticule</A>=[45,30],<A HREF="#idl:mollview:rot">rot</A>=[10,20,30],$</TD>
1318</TR>
1319<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:titleplot">title</A>='Mollweide projection',<A HREF="#idl:mollview:subtitle">subtitle</A>='mollview', $</TD>
1320</TR>
1321<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:outline">outline</A>=triangle</TD>
1322</TR>
1323</TABLE></tt>
1324<blockquote>makes a Mollweide projection of a pixel index map
1325(see Figure&nbsp;<A HREF="#fig:plot_visu">1</A>c) after an arbitrary <A HREF="#idl:mollview:graticule">rotation</A>, with a <A HREF="#idl:mollview:graticule">graticule</A> grid
1326(with a 45<SPAN CLASS="MATH"><SUP><i>o</i></SUP></SPAN> step in longitude and 30<SPAN CLASS="MATH"><SUP><i>o</i></SUP></SPAN> in latitude) and an arbitrary
1327(triangular) <A HREF="#idl:mollview:outline">outline</A></blockquote>
1328
1329<DIV class="CENTER"><A ID="page:plot_visu"></A><A ID="fig:plot_visu"></A><A ID="14917"></A>
1330<TABLE>
1331<CAPTION class="BOTTOM"><STRONG>Figure 1:</STRONG>
1332Figures produced by <A HREF="idl_cartview.htm#idl:cartview">cartview</A>,
1333<A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A>, <A HREF="#idl:mollview">mollview</A> and <A HREF="idl_orthview.htm#idl:orthview">orthview</A>, see respective
1334routine documentation for details.</CAPTION>
1335<TR><TD>
1336<DIV CLASS="centerline" ID="par40542" ALIGN="CENTER">
1337<IMG STYLE=""
1338 SRC="./merge_visu_large.png"
1339 ALT="Image merge_visu_large"></DIV>
1340
1341<P></TD></TR>
1342</TABLE>
1343</DIV>
1344
1345<P>
1346<hr><H1>EXAMPLE # 3:</H1>
1347<tt><A ID="idl:mollview:example3"></A><TABLE CELLPADDING=3>
1348<TR><TD ALIGN="LEFT">
1349<P>
1350map  = findgen(48)</TD>
1351</TR>
1352<TR><TD ALIGN="LEFT">mycommand = 'x=findgen(64)/10. &amp; ' + $</TD>
1353</TR>
1354<TR><TD ALIGN="LEFT">'plot,x,sin(x),pos=[0.8,0.8,0.99,0.99],/noerase &amp;' +$</TD>
1355</TR>
1356<TR><TD ALIGN="LEFT">'xyouts,0.5,0.5,&rdquo;Hello World !&rdquo;,/normal,charsize=2,align=0.5'</TD>
1357</TR>
1358<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview"><FONT COLOR="#CC0000">mollview</FONT></A>,map, <A HREF="#idl:mollview:execute">execute</A>=mycommand, <A HREF="#idl:mollview:png">png</A>='plot_example_execute.png',$</TD>
1359</TR>
1360<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:preview">/preview</A>,<A HREF="#idl:mollview:graticule">/graticule</A>,<A HREF="#idl:mollview:glsize">/glsize</A></TD>
1361</TR>
1362</TABLE></tt>
1363<blockquote>produces a PNG file containing a Mollweide projection of a pixel index map
1364with labeled graticules, a simple sine wave in the
1365upper right corner, and some greetings, as shown on
1366Figure&nbsp;<A HREF="#fig:plot_example_execute">2</A></blockquote>
1367
1368<DIV class="CENTER"><A ID="page:plot_example_execute"></A><A ID="fig:plot_example_execute"></A><A ID="14922"></A>
1369<TABLE>
1370<CAPTION class="BOTTOM"><STRONG>Figure 2:</STRONG>
1371Figure produced by Example #3 .</CAPTION>
1372<TR><TD>
1373<DIV CLASS="centerline" ID="par40552" ALIGN="CENTER">
1374<IMG STYLE=""
1375 SRC="./plot_example_execute.png"
1376 ALT="Image plot_example_execute"></DIV>
1377
1378<P></TD></TR>
1379</TABLE>
1380</DIV>
1381
1382<P>
1383<A ID="page:example_hires_cutsky"></A><hr><H1>EXAMPLE # 4:</H1>
1384<tt><A ID="idl:mollview:example4"></A><TABLE CELLPADDING=3>
1385<TR><TD ALIGN="LEFT">
1386<P>
1387pixel  = l64indgen(400000)</TD>
1388</TR>
1389<TR><TD ALIGN="LEFT">signal = pixel * 10.0</TD>
1390</TR>
1391<TR><TD ALIGN="LEFT">file = 'cutsky.fits'</TD>
1392</TR>
1393<TR><TD ALIGN="LEFT"><A HREF="idl_write_fits_cut4.htm#idl:write_fits_cut4">write_fits_cut4</A>, file, pixel+100000, signal, nside=32768, /ring</TD>
1394</TR>
1395<TR><TD ALIGN="LEFT"><A HREF="idl_gnomview.htm#idl:gnomview">gnomview</A>, <A HREF="#idl:mollview:file">file</A>, <A HREF="#idl:mollview:graticule">rot</A>=[0,90], <A HREF="#idl:mollview:graticule">grat</A>=30, <A HREF="#idl:mollview:titleplot">title</A>='high res. cut-sky map'</TD>
1396</TR>
1397</TABLE></tt>
1398<blockquote>produces and plots a high resolution map (6.4 arcsec/pixel), in which only a very small subset of
1399pixels is observed</blockquote>
1400<hr><H1>EXAMPLE # 5:</H1>
1401<tt><A ID="idl:mollview:example5"></A><TABLE CELLPADDING=3>
1402<TR><TD ALIGN="LEFT">
1403<P>
1404file = 'wmap_band_iqumap_r9_5yr_K_v3.fits'</TD>
1405</TR>
1406<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview"><FONT COLOR="#CC0000">mollview</FONT></A>, <A HREF="#idl:mollview:file">file</A>, <A HREF="#idl:mollview:titleplot">title</A>='Linear Color Scale', <A HREF="#idl:mollview:silent">/silent</A></TD>
1407</TR>
1408<TR><TD ALIGN="LEFT"><FONT COLOR="#CC0000">mollview</FONT>, file,<A HREF="#idl:mollview:asinh">/asinh</A>,title='Sinh!u-1!n Color Scale' , /silent</TD>
1409</TR>
1410<TR><TD ALIGN="LEFT"><FONT COLOR="#CC0000">mollview</FONT>, file,<A HREF="#idl:mollview:hist_equal">/hist</A>, title='Histogram Equalized Color Scale', /silent</TD>
1411</TR>
1412<TR><TD ALIGN="LEFT"><FONT COLOR="#CC0000">mollview</FONT>, file,<A HREF="#idl:mollview:log">/log</A>,  title='Log Scale', /silent</TD>
1413</TR>
1414</TABLE></tt>
1415<blockquote>produces Mollweide projections of the same map (here the WMAP-5yr K band) with
1416various color scales: linear, Inverse
1417Hyperbolic Sine, Histogram Equalized, and Log. See Figure&nbsp;<A HREF="#fig:merge_wmapKband">3</A></blockquote>
1418
1419<DIV class="CENTER"><A ID="page:merge_wmapKband"></A><A ID="fig:merge_wmapKband"></A><A ID="14928"></A>
1420<TABLE>
1421<CAPTION class="BOTTOM"><STRONG>Figure 3:</STRONG>
1422Illustration (generated by
1423Example&nbsp;#5)
1424of the various color scales available.</CAPTION>
1425<TR><TD>
1426<DIV CLASS="centerline" ID="par40566" ALIGN="CENTER">
1427<IMG STYLE=""
1428 SRC="./merge_wmapKband.png"
1429 ALT="Image merge_wmapKband"></DIV>
1430
1431<P></TD></TR>
1432</TABLE>
1433</DIV>
1434
1435<P>
1436
1437<hr><H1>EXAMPLE # 6:</H1>
1438<tt><A ID="idl:mollview:example6"></A><TABLE CELLPADDING=3>
1439<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview">mollview</A>,'<A ID="tex2html80"
1440  HREF="https://pla.esac.esa.int/pla/#maps">HFI_SkyMap_217_2048_R1.10_nominal.fits</A>', $</TD>
1441</TR>
1442<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:colt">colt</A>='planck2',<A HREF="#idl:mollview:asinh">asinh</A>=2, <A HREF="#idl:mollview:factor">factor</A>=1.e6,<A HREF="#idl:mollview:offset">offset</A>=-1.33e-4,  $</TD>
1443</TR>
1444<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:min">min</A>=-1.e3,<A HREF="#idl:mollview:max">max</A>=1.e7,<A HREF="#idl:mollview:titleplot">title</A>='Planck @ 217GHz',<A HREF="#idl:mollview:charsize">charsize</A>=2</TD>
1445</TR>
1446</TABLE></tt>
1447<blockquote>Illustrates the application of the second color table created by <A HREF="idl_planck_colors.htm#idl:planck_colors">planck_colors</A>  to the
1448visualization of Planck data at 217GHz
1449(see Fig.&nbsp;<A HREF="#fig:planck_colors_217">4</A>)</blockquote>
1450
1451<DIV class="CENTER"><A ID="page:planck_colors_217"></A><A ID="fig:planck_colors_217"></A><A ID="14933"></A>
1452<TABLE>
1453<CAPTION class="BOTTOM"><STRONG>Figure 4:</STRONG>
1454Illustration (generated by
1455Example&nbsp;#6) of the application of Planck color table
1456#2  to a Planck sky map.</CAPTION>
1457<TR><TD>
1458<DIV CLASS="centerline" ID="par40573" ALIGN="CENTER">
1459<IMG STYLE=""
1460 SRC="./planck_colors_217.png"
1461 ALT="Image planck_colors_217"></DIV>
1462
1463<P></TD></TR>
1464</TABLE>
1465</DIV>
1466
1467<P>
1468
1469<hr><H1>EXAMPLE # 7:</H1>
1470<tt><A ID="idl:mollview:example7"></A><TABLE CELLPADDING=3>
1471<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview">mollview</A>, findgen(12), <A HREF="#idl:mollview:silhouette">silhouette</A>=2,  <A HREF="#idl:mollview:default_settings">default_settings=</A>dsmoll,$</TD>
1472</TR>
1473<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:titleplot">title</A>='Wider, thicker color bar; left justified title',$</TD>
1474</TR>
1475<TR><TD ALIGN="LEFT"><A HREF="#idl:mollview:customize">customize=</A>{cbar:{dx:2/3.,dy:1/32.,ty:0.005,box:2},$</TD>
1476</TR>
1477<TR><TD ALIGN="LEFT">title:{x:0,charsize:2}}</TD>
1478</TR>
1479<TR><TD ALIGN="LEFT"><A HREF="idl_help_st.htm#idl:help_st">help_st</A>, dsmoll</TD>
1480</TR>
1481</TABLE></tt>
1482<blockquote>
1483<TABLE   STYLE="width:100%;">
1484<TR><TD>
1485will generate a silhouetted Mollweide projection plot with
1486customized thickness and length of a boxed color bar,
1487and modified location of the title (see Fig.&nbsp;<A HREF="#fig:moll_customize">5</A>).
1488The default value (in the Mollweide projection)
1489 of the available customization parameters is also listed as
1490<BR><SMALL CLASS="SCRIPTSIZE"><SPAN  CLASS="texttt"> ** Structure &lt;.....&gt;, 7 tags, length=128, data length=122, refs=1:
1491</SMALL><TABLE CELLPADDING=3>
1492<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1493.ASPOS.X                </SMALL></TD>
1494<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1495<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       -1.00000</SMALL></TD>
1496</TR>
1497<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1498.ASPOS.Y                </SMALL></TD>
1499<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1500<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       -1.00000</SMALL></TD>
1501</TR>
1502<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1503.CBAR.DX                </SMALL></TD>
1504<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1505<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.333333</SMALL></TD>
1506</TR>
1507<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1508.CBAR.DY                </SMALL></TD>
1509<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1510<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0.0142857</SMALL></TD>
1511</TR>
1512<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1513.CBAR.SPACES            </SMALL></TD>
1514<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     STRING    </SMALL></TD>
1515<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">  Array[3]</SMALL></TD>
1516</TR>
1517<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1518.CBAR.TY                </SMALL></TD>
1519<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1520<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">        0.00000</SMALL></TD>
1521</TR>
1522<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1523.CBAR.BOX               </SMALL></TD>
1524<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1525<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">        0.00000</SMALL></TD>
1526</TR>
1527<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1528.CRING.DX               </SMALL></TD>
1529<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1530<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.100000</SMALL></TD>
1531</TR>
1532<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1533.CRING.XLL              </SMALL></TD>
1534<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1535<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0.0250000</SMALL></TD>
1536</TR>
1537<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1538.CRING.YLL              </SMALL></TD>
1539<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1540<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0.0250000</SMALL></TD>
1541</TR>
1542<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1543.PDF.DEBUG              </SMALL></TD>
1544<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     INT       </SMALL></TD>
1545<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0 </SMALL></TD>
1546</TR>
1547<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1548.SUBTITLE.X             </SMALL></TD>
1549<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1550<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.500000</SMALL></TD>
1551</TR>
1552<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1553.SUBTITLE.Y             </SMALL></TD>
1554<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1555<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.905000</SMALL></TD>
1556</TR>
1557<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1558.SUBTITLE.CHARSIZE      </SMALL></TD>
1559<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1560<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">        1.20000</SMALL></TD>
1561</TR>
1562<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1563.TITLE.X                </SMALL></TD>
1564<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1565<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.500000</SMALL></TD>
1566</TR>
1567<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1568.TITLE.Y                </SMALL></TD>
1569<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1570<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">       0.950000</SMALL></TD>
1571</TR>
1572<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1573.TITLE.CHARSIZE         </SMALL></TD>
1574<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1575<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">        1.60000</SMALL></TD>
1576</TR>
1577<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1578.VSCALE.X               </SMALL></TD>
1579<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1580<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0.0500000</SMALL></TD>
1581</TR>
1582<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1583.VSCALE.Y               </SMALL></TD>
1584<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1585<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">      0.0200000</SMALL></TD>
1586</TR>
1587<TR><TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">
1588.VSCALE.TY              </SMALL></TD>
1589<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">     FLOAT     </SMALL></TD>
1590<TD ALIGN="LEFT"><SMALL CLASS="SCRIPTSIZE">        0.00000
1591</SMALL></TD>
1592</TR>
1593</TABLE><SMALL CLASS="SCRIPTSIZE"></SPAN></SMALL>
1594</TD></TR>
1595</TABLE>
1596</blockquote>
1597
1598<DIV class="CENTER"><A ID="page:moll_customize"></A><A ID="fig:moll_customize"></A><A ID="14939"></A>
1599<TABLE>
1600<CAPTION class="BOTTOM"><STRONG>Figure 5:</STRONG>
1601Illustration (generated by
1602Example&nbsp;#7
1603) of customization of the title (size and location) and of the color bar (size and box), and overplotting of a silhouette around the project map.</CAPTION>
1604<TR><TD>
1605<DIV CLASS="centerline" ID="par40642" ALIGN="CENTER">
1606<IMG STYLE=""
1607 SRC="./moll_customize2.png"
1608 ALT="Image moll_customize2"></DIV>
1609
1610<P></TD></TR>
1611</TABLE>
1612</DIV>
1613
1614<P>
1615
1616<P>
1617
1618<P>
1619
1620<P>
1621
1622<DIV CLASS="navigation"><HR>
1623<!--Navigation Panel-->
1624<A
1625 HREF="idl_mollcursor.htm">
1626<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A>
1627<A
1628 HREF="idl_HEALPix_IDL_subroutines.htm">
1629<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A>
1630<A
1631 HREF="idl_neighbours_nest.htm">
1632<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A>
1633<A ID="tex2html363"
1634  HREF="idl_TABLE_CONTENTS.htm">
1635<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A>
1636<BR>
1637<B> Previous:</B> <A
1638 HREF="idl_mollcursor.htm">mollcursor</A>
1639
1640<B>Up:</B> <A
1641 HREF="idl_HEALPix_IDL_subroutines.htm">HEALPix/IDL subroutines</A>
1642
1643<B> Next:</B> <A
1644 HREF="idl_neighbours_nest.htm">neighbours_nest</A>
1645<B> Top:</B> <a href="main.htm">Main Page</a></DIV>
1646<!--End of Navigation Panel-->
1647<ADDRESS>
1648Version 3.50, 2018-12-10
1649</ADDRESS>
1650</BODY>
1651</HTML>
1652