healpy.visufunc.gnomview(map=None, fig=None, rot=None, coord=None, unit='', xsize=200, ysize=None, reso=1.5, title='Gnomonic view', nest=False, remove_dip=False, remove_mono=False, gal_cut=0, min=None, max=None, flip='astro', format='%.3g', cbar=True, cmap=None, badcolor='gray', bgcolor='white', norm=None, hold=False, sub=None, reuse_axes=False, margins=None, notext=False, return_projected_map=False, no_plot=False, alpha=None)

Plot a healpix map (given as an array) in Gnomonic projection.


The map to project, supports masked maps, see the ma function. If None, use a blank map, useful for overplotting.

figNone or int, optional

A figure number. Default: None= create a new figure

rotscalar or sequence, optional

Describe the rotation to apply. In the form (lon, lat, psi) (unit: degrees) : the point at longitude lon and latitude lat will be at the center. An additional rotation of angle psi around this direction is applied.

coordsequence of character, optional

Either one of ‘G’, ‘E’ or ‘C’ to describe the coordinate system of the map, or a sequence of 2 of these to rotate the map from the first to the second coordinate system.

unitstr, optional

A text describing the unit of the data. Default: ‘’

xsizeint, optional

The size of the image. Default: 200

ysizeNone or int, optional

The size of the image. Default: None= xsize

resofloat, optional

Resolution (in arcmin). Default: 1.5 arcmin

titlestr, optional

The title of the plot. Default: ‘Gnomonic view’

nestbool, optional

If True, ordering scheme is NESTED. Default: False (RING)

minfloat, scalar, optional

The minimum range value

maxfloat, scalar, optional

The maximum range value

flip{‘astro’, ‘geo’}, optional

Defines the convention of projection : ‘astro’ (default, east towards left, west towards right) or ‘geo’ (east towards roght, west towards left)

remove_dipbool, optional

If True, remove the dipole+monopole

remove_monobool, optional

If True, remove the monopole

gal_cutfloat, scalar, optional

Symmetric galactic cut for the dipole/monopole fit. Removes points in latitude range [-gal_cut, +gal_cut]

formatstr, optional

The format of the scale label. Default: ‘%g’

cmapa color map

The colormap to use (see matplotlib.cm)


Color to use to plot bad values


Color to use for background

holdbool, optional

If True, replace the current Axes by a GnomonicAxes. use this if you want to have multiple maps on the same figure. Default: False

subint or sequence, optional

Use only a zone of the current figure (same syntax as subplot). Default: None

reuse_axesbool, optional

If True, reuse the current Axes (should be a GnomonicAxes). This is useful if you want to overplot with a partially transparent colormap, such as for plotting a line integral convolution. Default: False

marginsNone or sequence, optional

Either None, or a sequence (left,bottom,right,top) giving the margins on left,bottom,right and top of the axes. Values are relative to figure (0-1). Default: None

notext: bool, optional

If True: do not add resolution info text. Default=False

return_projected_mapbool, optional

if True returns the projected map in a 2d numpy array

no_plotbool, optional

if True no figure will be created

alphafloat, array-like or None

An array containing the alpha channel, supports masked maps, see the ma function. If None, no transparency will be applied. See an example usage of the alpha channel transparency in the documentation under “Other tutorials”

See also

mollview, cartview, orthview, azeqview