STIXMap#

class stixpy.map.stix.STIXMap(data, header, plot_settings=None, **kwargs)[source]#

Bases: GenericMap

A class to represent a STIX Map.

Attributes Summary

wcs

The WCS property of the map.

Methods Summary

is_datasource_for(data, header, **kwargs)

plot(**kwargs)

Plots the map object using matplotlib, in a method equivalent to imshow() using nearest neighbor interpolation.

Attributes Documentation

wcs#

The WCS property of the map.

Methods Documentation

classmethod is_datasource_for(data, header, **kwargs)[source]#
plot(**kwargs)[source]#

Plots the map object using matplotlib, in a method equivalent to imshow() using nearest neighbor interpolation.

Parameters:

  • annotate (bool, optional) – If True, the data is plotted at its natural scale; with title and axis labels.

  • axes (Axes or None) – If provided the image will be plotted on the given axes. Else the current Matplotlib axes will be used.

  • title (str, bool, optional) – The plot title. If True, uses the default title for this map.

  • clip_interval (two-element Quantity, optional) – If provided, the data will be clipped to the percentile interval bounded by the two numbers.

  • autoalign (bool or str, optional) – If other than False, the plotting accounts for any difference between the WCS of the map and the WCS of the WCSAxes axes (e.g., a difference in rotation angle). If pcolormesh, this method will use pcolormesh() instead of the default imshow(). Specifying True is equivalent to specifying pcolormesh.

  • **imshow_kwargs (dict) – Any additional imshow arguments are passed to imshow().

Examples

>>> # Simple Plot with color bar
>>> aia.plot()
>>> plt.colorbar()
>>> # Add a limb line and grid
>>> aia.plot()
>>> aia.draw_limb()
>>> aia.draw_grid()

Notes

The autoalign functionality is computationally intensive. If the plot will be interactive, the alternative approach of preprocessing the map (e.g., de-rotating it) to match the desired axes will result in better performance.

When combining autoalign functionality with Helioprojective coordinates, portions of the map that are beyond the solar disk may not appear, which may also inhibit Matplotlib’s autoscaling of the plot limits. The plot limits can be set manually. To preserve the off-disk parts of the map, using the SphericalScreen context manager may be appropriate.