2D All-Sky Plots (ligo-skymap-plot)


To plot the localization for GW150914:

$ curl -O https://dcc.ligo.org/public/0122/P1500227/012/bayestar_gstlal_C01.fits.gz
$ ligo-skymap-plot bayestar_gstlal_C01.fits.gz -o bayestar.png --annotate --contour 50 90

(Source code, png, hires.png, pdf)


Plot an all-sky map on a Mollweide projection. By default, plot in celestial coordinates (RA, Dec).

To plot in geographic coordinates (longitude, latitude) with major coastlines overlaid, provide the --geo flag.

Public-domain cartographic data is courtesy of Natural Earth and processed with MapShaper.

usage: ligo-skymap-plot [-h] [-o FILE.{pdf,png}] [--colormap CMAP]
                        [--help-colormap] [--figure-width INCHES]
                        [--figure-height INCHES] [--dpi PIXELS]
                        [--transparent [TRANSPARENT]] [--version]
                        [--annotate] [--contour PERCENT [PERCENT ...]]
                        [--colorbar] [--radec deg deg]
                        [--inj-database FILE.sqlite] [--geo]
                        [--projection {mollweide,aitoff,globe,zoom}]
                        [--projection-center CENTER] [--zoom-radius RADIUS]

Positional Arguments


Input FITS file

Default: -

Named Arguments


show program’s version number and exit

-l, --loglevel

Default: INFO


annotate plot with information about the event

Default: False


plot contour enclosing this percentage of probability mass [may be specified multiple times, default: none]


Show colorbar

Default: False


right ascension (deg) and declination (deg) to mark

Default: []


read injection positions from database


Use a terrestrial reference frame with coordinates (lon, lat) instead of the celestial frame with coordinates (RA, dec) and draw continents on the map

Default: False


Possible choices: mollweide, aitoff, globe, zoom

Projection style

Default: “mollweide”


Specify the center for globe and zoom projections, e.g. 14h 10d


Specify the radius for zoom projections, e.g. 4deg

figure options

Options that affect figure output format

-o, --output

output file, or - to plot to screen

Default: -


Possible choices: Accent, Accent_r, Blues, Blues_r, BrBG, BrBG_r, BuGn, BuGn_r, BuPu, BuPu_r, CMRmap, CMRmap_r, Dark2, Dark2_r, GnBu, GnBu_r, Greens, Greens_r, Greys, Greys_r, OrRd, OrRd_r, Oranges, Oranges_r, PRGn, PRGn_r, Paired, Paired_r, Pastel1, Pastel1_r, Pastel2, Pastel2_r, PiYG, PiYG_r, PuBu, PuBuGn, PuBuGn_r, PuBu_r, PuOr, PuOr_r, PuRd, PuRd_r, Purples, Purples_r, RdBu, RdBu_r, RdGy, RdGy_r, RdPu, RdPu_r, RdYlBu, RdYlBu_r, RdYlGn, RdYlGn_r, Reds, Reds_r, Set1, Set1_r, Set2, Set2_r, Set3, Set3_r, Spectral, Spectral_r, Wistia, Wistia_r, YlGn, YlGnBu, YlGnBu_r, YlGn_r, YlOrBr, YlOrBr_r, YlOrRd, YlOrRd_r, afmhot, afmhot_r, autumn, autumn_r, binary, binary_r, bone, bone_r, brg, brg_r, bwr, bwr_r, cividis, cividis_r, cool, cool_r, coolwarm, coolwarm_r, copper, copper_r, cubehelix, cubehelix_r, cylon, cylon_r, flag, flag_r, gist_earth, gist_earth_r, gist_gray, gist_gray_r, gist_heat, gist_heat_r, gist_ncar, gist_ncar_r, gist_rainbow, gist_rainbow_r, gist_stern, gist_stern_r, gist_yarg, gist_yarg_r, gnuplot, gnuplot2, gnuplot2_r, gnuplot_r, gray, gray_r, hot, hot_r, hsv, hsv_r, inferno, inferno_r, jet, jet_r, magma, magma_r, nipy_spectral, nipy_spectral_r, ocean, ocean_r, pink, pink_r, plasma, plasma_r, prism, prism_r, rainbow, rainbow_r, seismic, seismic_r, spring, spring_r, summer, summer_r, tab10, tab10_r, tab20, tab20_r, tab20b, tab20b_r, tab20c, tab20c_r, terrain, terrain_r, turbo, turbo_r, twilight, twilight_r, twilight_shifted, twilight_shifted_r, viridis, viridis_r, winter, winter_r

matplotlib colormap

Default: cylon


show supported values for –colormap and exit


width of figure in inches

Default: 8


height of figure in inches

Default: 6


resolution of figure in dots per inch

Default: 300


Save image with transparent background

Default: 0