Unidata / MetPy

        Adds dry adiabats (lines of constant potential temperature) to the

        plot. The default style of these lines is dashed red lines with an alpha

        value of 0.5. These can be overridden using keyword arguments.

        Parameters

        ----------

        t0 : array_like, optional

            Starting temperature values in Kelvin. If none are given, they will be

            generated using the current temperature range at the bottom of

            the plot.

        p : array_like, optional

            Pressure values to be included in the dry adiabats. If not

            specified, they will be linearly distributed across the current

            plotted pressure range.

        kwargs

            Other keyword arguments to pass to :class:`matplotlib.collections.LineCollection`

        Returns

        -------

        matplotlib.collections.LineCollection

            instance created

        See Also

        --------

        :func:`~metpy.calc.thermo.dry_lapse`

        :meth:`plot_moist_adiabats`

        :class:`matplotlib.collections.LineCollection`

        '''

        # Determine set of starting temps if necessary

        if t0 is None:

            xmin, xmax = self.ax.get_xlim()

            t0 = np.arange(xmin, xmax + 1, 10) * units.degC

        # Get pressure levels based on ylims if necessary

        if p is None:

            p = np.linspace(*self.ax.get_ylim()) * units.mbar

        # Assemble into data for plotting

        t = dry_lapse(p, t0[:, np.newaxis]).to(units.degC)

        linedata = [np.vstack((ti, p)).T for ti in t]

        # Add to plot

        kwargs.setdefault('colors', 'r')

        kwargs.setdefault('linestyles', 'dashed')

        kwargs.setdefault('alpha', 0.5)

        return self.ax.add_collection(LineCollection(linedata, **kwargs))

    def plot_moist_adiabats(self, t0=None, p=None, **kwargs):

        r'''Plot moist adiabats.

        Adds saturated pseudo-adiabats (lines of constant equivalent potential

        temperature) to the plot. The default style of these lines is dashed

        blue lines with an alpha value of 0.5. These can be overridden using

        keyword arguments.

        Parameters

        `barbs` command that adds to appropriate transform to place the

        barbs in a vertical line, located as a function of pressure.

        Parameters

        ----------

        p : array_like

            pressure values

        u : array_like

            U (East-West) component of wind

        v : array_like

            V (North-South) component of wind

        xloc : float, optional

            Position for the barbs, in normalized axes coordinates, where 0.0

            denotes far left and 1.0 denotes far right. Defaults to far right.

        x_clip_radius : float, optional

            Space, in normalized axes coordinates, to leave before clipping

            wind barbs in the x-direction. Defaults to 0.08.

        y_clip_radius : float, optional

            Space, in normalized axes coordinates, to leave above/below plot

            before clipping wind barbs in the y-direction. Defaults to 0.08.

        kwargs

            Other keyword arguments to pass to :func:`~matplotlib.pyplot.barbs`

        Returns

        -------

        matplotlib.quiver.Barbs

            instance created

        See Also

        --------

        :func:`matplotlib.pyplot.barbs`

        '''

        # Assemble array of x-locations in axes space

        x = np.empty_like(p)

        x.fill(xloc)

        # Do barbs plot at this location

        b = self.ax.barbs(x, p, u, v,

                          transform=self.ax.get_yaxis_transform(which='tick2'),

                          clip_on=True, **kwargs)

        # Override the default clip box, which is the axes rectangle, so we can have

        # barbs that extend outside.

        ax_bbox = transforms.Bbox([[xloc - x_clip_radius, -y_clip_radius],

                                   [xloc + x_clip_radius, 1.0 + y_clip_radius]])

        b.set_clip_box(transforms.TransformedBbox(ax_bbox, self.ax.transAxes))

        return b

    def plot_dry_adiabats(self, t0=None, p=None, **kwargs):

        r'''Plot dry adiabats.

        Adds dry adiabats (lines of constant potential temperature) to the

        plot. The default style of these lines is dashed red lines with an alpha

        value of 0.5. These can be overridden using keyword arguments.