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