astroplan.plots.plot_airmass(target, observer, time, ax=None, style_kwargs=None)[source]

Plots airmass as a function of time for a given target.

If a Axes object already exists, an additional airmass plot will be “stacked” on it. Otherwise, creates a new Axes object and plots airmass on top of that.

When a scalar Time object is passed in (e.g., Time('2000-1-1')), the resulting plot will use a 24-hour window centered on the time indicated, with airmass sampled at regular intervals throughout. However, the user can control the exact number and frequency of airmass calculations used by passing in a non-scalar Time object. For instance, Time(['2000-1-1 23:00:00', '2000-1-1 23:30:00']) will result in a plot with only two airmass measurements.


target : FixedTarget

The celestial body of interest.

observer : Observer

The person, telescope, observatory, etc. doing the observing.

time : Time

If scalar (e.g., Time('2000-1-1')), will result in plotting target airmasses once an hour over a 24-hour window. If non-scalar (e.g., Time(['2000-1-1']), [Time('2000-1-1')], Time(['2000-1-1', '2000-1-2'])), will result in plotting data at the exact times specified.

ax : Axes or None, optional.

The Axes object to be drawn on. If None, uses the current Axes.

style_kwargs : dict or None, optional.

A dictionary of keywords passed into plot_date to set plotting styles.


ax : Axes

An Axes object with added airmass vs. time plot.


y-axis is inverted and shows airmasses between 1.0 and 3.0 by default. If user wishes to change these, use ax.\<set attribute\> before drawing or saving plot:

  1. Timezones?
  2. Dark plot option.