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>gnomview</TITLE>
7<META NAME="description" CONTENT="gnomview">
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_healpix_doc_PDF_HTML_docume.htm">
29<LINK REL="previous" HREF="idl_gnomcursor.htm">
30<LINK REL="next" HREF="idl_healpix_doc_PDF_HTML_docume.htm">
31</HEAD>
32
33<body text="#000000" bgcolor="#FFFFFA">
34
35<DIV CLASS="navigation"><!--Navigation Panel-->
36<A
37 HREF="idl_gnomcursor.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_healpix_doc_PDF_HTML_docume.htm">
44<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A>
45<A ID="tex2html331"
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_gnomcursor.htm">gnomcursor</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_healpix_doc_PDF_HTML_docume.htm">healpix_doc: PDF and HTML documentation</A>
57<B> Top:</B> <a href="main.htm">Main Page</a></DIV>
58<!--End of Navigation Panel-->
59
60<H1><A ID="SECTION2900"></A>
61<A ID="idl:gnomview"></A>
62<BR>
63
64</H1>
65
66<P>
67<b><font size=+6><FONT COLOR="#CC0000">gnomview</FONT></font></b><hr>
68<H3>This IDL facility provides a means to visualise a Gnomonic projection
69(radial projection onto a tangent plane) of
70<b>HEALPix</b> and COBE Quad-Cube maps in an IDL environment.
71It also offers the possibility to
72generate GIF, JPEG, PDF, PNG and Postscript color-coded images of the projected map.
73The projected (but not color-coded) data can also be output in FITS files and
74IDL arrays.</H3>
75Location in HEALPix directory tree: <a href="https://sourceforge.net/p/healpix/code/1005/tree/trunk/src/idl/visu/gnomview.pro"><b>src/idl/visu/gnomview.pro</b></a>&nbsp;
76
77<P>
78<hr><h1>FORMAT </h1><h3>IDL>
79GNOMVIEW,
80
81<A HREF="idl_mollview.htm#idl:mollview:file">File</A>
82[, <A HREF="idl_mollview.htm#idl:mollview:select">Select</A>]
83[, <A HREF="idl_mollview.htm#idl:mollview:asinh">ASINH=</A>,
84<A HREF="idl_mollview.htm#idl:mollview:bad_color">BAD_COLOR=</A>,
85<A HREF="idl_mollview.htm#idl:mollview:bg_color">BG_COLOR=</A>,
86<A HREF="idl_mollview.htm#idl:mollview:charsize">CHARSIZE=</A>,
87<A HREF="idl_mollview.htm#idl:mollview:charsize">CHARTHICK=</A>,
88<A HREF="idl_mollview.htm#idl:mollview:colt">COLT=</A>,
89<A HREF="idl_mollview.htm#idl:mollview:coord">COORD=</A>,
90<A HREF="idl_mollview.htm#idl:mollview:crop">/CROP</A>,
91<A HREF="idl_mollview.htm#idl:mollview:customize">CUSTOMIZE=</A>,
92<A HREF="idl_mollview.htm#idl:mollview:default_settings">DEFAULT_SETTINGS=</A>,
93<A HREF="idl_mollview.htm#idl:mollview:execute">EXECUTE=</A>,
94<A HREF="idl_mollview.htm#idl:mollview:factor">FACTOR=</A>,
95<A HREF="idl_mollview.htm#idl:mollview:fg_color">FG_COLOR=</A>,
96<A HREF="idl_mollview.htm#idl:mollview:fits">FITS=</A>,
97<A HREF="idl_mollview.htm#idl:mollview:flip">/FLIP</A>,
98<A HREF="idl_mollview.htm#idl:mollview:gal_cut">GAL_CUT=</A>,
99<A HREF="idl_mollview.htm#idl:mollview:gif">GIF=</A>,
100<A HREF="idl_mollview.htm#idl:mollview:glsize">GLSIZE=</A>,
101<A HREF="idl_mollview.htm#idl:mollview:graticule">GRATICULE=</A>,
102<A HREF="idl_mollview.htm#idl:mollview:half_sky">/HALF_SKY</A>,
103<A HREF="idl_mollview.htm#idl:mollview:hbound">HBOUND=</A>,
104<A HREF="idl_mollview.htm#idl:mollview:help">/HELP</A>,
105<A HREF="idl_mollview.htm#idl:mollview:hist_equal">/HIST_EQUAL</A>,
106<A HREF="idl_mollview.htm#idl:mollview:hxsize">HXSIZE=</A>,
107<A HREF="idl_mollview.htm#idl:mollview:iglsize">IGLSIZE=</A>,
108<A HREF="idl_mollview.htm#idl:mollview:igraticule">IGRATICULE=</A>,
109<A HREF="idl_mollview.htm#idl:mollview:jpeg">JPEG=</A>,
110<A HREF="idl_mollview.htm#idl:mollview:latex">LATEX=</A>,
111<A HREF="idl_mollview.htm#idl:mollview:log">/LOG</A>,
112<A HREF="idl_mollview.htm#idl:mollview:map_out">MAP_OUT=</A>,
113<A HREF="idl_mollview.htm#idl:mollview:max">MAX=</A>,
114<A HREF="idl_mollview.htm#idl:mollview:min">MIN=</A>,
115<A HREF="idl_mollview.htm#idl:mollview:nested">/NESTED</A>,
116<A HREF="idl_mollview.htm#idl:mollview:no_dipole">/NO_DIPOLE</A>,
117<A HREF="idl_mollview.htm#idl:mollview:no_monopole">/NO_MONOPOLE</A>,
118<A HREF="idl_mollview.htm#idl:mollview:nobar">/NOBAR</A>,
119<A HREF="idl_mollview.htm#idl:mollview:nolabels">/NOLABELS</A>,
120<A HREF="idl_mollview.htm#idl:mollview:noposition">/NOPOSITION</A>,
121<A HREF="idl_mollview.htm#idl:mollview:offset">OFFSET=</A>,
122<A HREF="idl_mollview.htm#idl:mollview:outline">OUTLINE=</A>,
123<A HREF="idl_mollview.htm#idl:mollview:pdf">PDF=</A>,
124<A HREF="idl_mollview.htm#idl:mollview:pfonts">PFONTS=</A>,
125<A HREF="idl_mollview.htm#idl:mollview:png">PNG=</A>,
126<A HREF="idl_mollview.htm#idl:mollview:polarization">POLARIZATION=</A>,
127<A HREF="idl_mollview.htm#idl:mollview:preview">/PREVIEW</A>,
128<A HREF="idl_mollview.htm#idl:mollview:ps">PS=</A>,
129<A HREF="idl_mollview.htm#idl:mollview:pxsize">PXSIZE=</A>,
130<A HREF="idl_mollview.htm#idl:mollview:pysize">PYSIZE=</A>,
131<A HREF="idl_mollview.htm#idl:mollview:reso_arcmin">RESO_ARCMIN=</A>,
132<A HREF="idl_mollview.htm#idl:mollview:retain">RETAIN=</A>,
133<A HREF="idl_mollview.htm#idl:mollview:rot">ROT=</A>,
134<A HREF="idl_mollview.htm#idl:mollview:save">/SAVE</A>,
135<A HREF="idl_mollview.htm#idl:mollview:shaded">/SHADED</A>,
136<A HREF="idl_mollview.htm#idl:mollview:silent">/SILENT</A>,
137<A HREF="idl_mollview.htm#idl:mollview:silhouette">SILHOUETTE=</A>,
138<A HREF="idl_mollview.htm#idl:mollview:stagger">STAGGER=</A>,
139<A HREF="idl_mollview.htm#idl:mollview:subtitle">SUBTITLE=</A>,
140<A HREF="idl_mollview.htm#idl:mollview:titleplot">TITLEPLOT=</A>,
141<A HREF="idl_mollview.htm#idl:mollview:transparent">TRANSPARENT=</A>,
142<A HREF="idl_mollview.htm#idl:mollview:truecolors">TRUECOLORS=</A>,
143<A HREF="idl_mollview.htm#idl:mollview:units">UNITS=</A>,
144<A HREF="idl_mollview.htm#idl:mollview:window">WINDOW=</A>,
145<A HREF="idl_mollview.htm#idl:mollview:xpos">XPOS=</A>,
146<A HREF="idl_mollview.htm#idl:mollview:ypos">YPOS=</A>]
147
148</h3>
149
150<P>
151<hr>
152<H1>QUALIFIERS</H1>
153
154  <DL COMPACT><DT>
155<DD>For a full list of qualifiers see <A HREF="idl_mollview.htm#idl:mollview">mollview</A>
156  </DL>
157
158<P>
159<hr><H1>KEYWORDS</H1>
160
161  <DL COMPACT><DT>
162<DD>For a full list of keywords see <A HREF="idl_mollview.htm#idl:mollview">mollview</A>
163  </DL>
164
165<P>
166
167<hr>
168<H1>DESCRIPTION</H1>
169<blockquote>
170<br><br><FONT COLOR="#CC0000">gnomview</FONT> reads in a <b>HEALPix</b> sky map in FITS format and generates
171a gnomic (or gnomonic) projection of it, that can be visualized on the screen or
172exported in a GIF, JPEG, PNG, PDF or Postscript file. <FONT COLOR="#CC0000">gnomview</FONT>  allows the selection of
173the coordinate system, map size, color table, color bar inclusion,
174linear, log, hybrid or histogram equalised color scaling,
175maximum and
176minimum range for the plot, plot-title <I>etc</I>. It also allows the representation of the
177polarization field.
178</blockquote>
179
180<P>
181<hr><H1>RELATED ROUTINES</H1><h3>This section lists the routines related to <b><FONT COLOR="#CC0000">gnomview</FONT></b></h3>
182
183  <DL COMPACT><DT>
184<DD>see <A HREF="idl_mollview.htm#idl:mollview">mollview</A>
185  </DL>
186
187<P>
188<hr><H1>EXAMPLE # 1:</H1>
189<tt><TABLE CELLPADDING=3>
190<TR><TD ALIGN="LEFT">gnomview,  'planck100GHZ-LFI.fits', rot=[160,-30], reso_arcmin=2., $</TD>
191</TR>
192<TR><TD ALIGN="LEFT">pxsize = 500., $</TD>
193</TR>
194<TR><TD ALIGN="LEFT">title='Simulated Planck LFI Sky Map at 100GHz',  $</TD>
195</TR>
196<TR><TD ALIGN="LEFT">min=-100,max=100</TD>
197</TR>
198</TABLE></tt>
199<blockquote>gnomview reads in the map 'planck100GHZ-LFI.fits' and generates
200an output image of the size of 500<SPAN CLASS="MATH"> x </SPAN>500 screen pixels,
201with a resolution of 2 arcmin/screen pixel at the center.
202The temperature scale has been set to lie between <SPAN CLASS="MATH"><IMG STYLE="height: 1.46ex; vertical-align: -0.29ex; " SRC="idl_img65.png"
203 ALT="$\pm$"></SPAN> 100, and the units will
204show as <SPAN CLASS="MATH"><IMG STYLE="height: 1.57ex; vertical-align: -0.55ex; " SRC="idl_img66.png"
205 ALT="$\mu$"></SPAN>K.
206The title 'Simulated Planck
207LFI Sky Map at 100GHz' has been appended to the image.
208The map is centered at (<SPAN CLASS="MATH"><I>l</I>=</SPAN>160, <SPAN CLASS="MATH"><I>b</I>=</SPAN>-30) </blockquote>
209
210<P>
211<hr><H1>EXAMPLE # 2:</H1>
212<tt><TABLE CELLPADDING=3>
213<TR><TD ALIGN="LEFT">
214<P>
215map  = findgen(48)</TD>
216</TR>
217<TR><TD ALIGN="LEFT">triangle= create_struct('coord','G','ra',[0,80,0],'dec',[40,45,65])</TD>
218</TR>
219<TR><TD ALIGN="LEFT">gnomview,map,/online,res=25,graticule=[45,30],rot=[10,20,30],$</TD>
220</TR>
221<TR><TD ALIGN="LEFT">title='Gnomic projection',subtitle='gnomview', $</TD>
222</TR>
223<TR><TD ALIGN="LEFT">outline=triangle</TD>
224</TR>
225</TABLE></tt>
226<blockquote>makes a gnomic projection of map (see Figure&nbsp;<A HREF="idl_mollview.htm#fig:plot_visu">1</A>b on
227page&nbsp;<A HREF="idl_mollview.htm#page:plot_visu"><IMG  ALT="[*]" SRC="crossref.png"></A>) after an arbitrary rotation, with a graticule grid
228(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 triangular outline</blockquote>
229
230<P>
231
232<P>
233
234<DIV CLASS="navigation"><HR>
235<!--Navigation Panel-->
236<A
237 HREF="idl_gnomcursor.htm">
238<IMG WIDTH="63" HEIGHT="24" ALT="previous" SRC="prev.png"></A>
239<A
240 HREF="idl_HEALPix_IDL_subroutines.htm">
241<IMG WIDTH="26" HEIGHT="24" ALT="up" SRC="up.png"></A>
242<A
243 HREF="idl_healpix_doc_PDF_HTML_docume.htm">
244<IMG WIDTH="37" HEIGHT="24" ALT="next" SRC="next.png"></A>
245<A ID="tex2html331"
246  HREF="idl_TABLE_CONTENTS.htm">
247<IMG WIDTH="65" HEIGHT="24" ALT="contents" SRC="contents.png"></A>
248<BR>
249<B> Previous:</B> <A
250 HREF="idl_gnomcursor.htm">gnomcursor</A>
251
252<B>Up:</B> <A
253 HREF="idl_HEALPix_IDL_subroutines.htm">HEALPix/IDL subroutines</A>
254
255<B> Next:</B> <A
256 HREF="idl_healpix_doc_PDF_HTML_docume.htm">healpix_doc: PDF and HTML documentation</A>
257<B> Top:</B> <a href="main.htm">Main Page</a></DIV>
258<!--End of Navigation Panel-->
259<ADDRESS>
260Version 3.50, 2018-12-10
261</ADDRESS>
262</BODY>
263</HTML>
264