.. _ws_instability_line_icon:


ws_instability_line
===============================================

.. container::
    
    .. container:: leftside

        .. image:: /_static/WS_INSTABILITYLINE.png
           :width: 48px

    .. container:: rightside

		Defines an instability line :ref:`Weather Symbol Object <weather_symbols>` that can be visualised with :func:`plot`.
		
		.. include:: /api/icon_desc/include/ws.rst


		.. note:: This function performs the same task as the **Ws Instability Line** icon in Metview’s :ref:`user interface <user_interface>`. It accepts its parameters as keyword arguments, described below.


.. py:function:: ws_instability_line(**kwargs)
  
    Defines an instability line :ref:`Weather Symbol Object <weather_symbols>`.


    :param colour: Colour of the curve.
    :type colour: str, default: "black"

    :param line_thickness: Thickness of the curve.
    :type line_thickness: number, default: 1

    :param line_length: Length of the line segments.
    :type line_length: number, default: 15

    :param line_gap: Width of the gap between the line segments.
    :type line_gap: number, default: 15

    :param circle_diameter: Diameter of the circles between the line segments.
    :type circle_diameter: number, default: 2

    :param x: The x coordinates of the control points of the curve. At least two points must be specified.
    :type x: ndarray or list of numbers, default: 0

    :param y: The y coordinates of the control points of the curve. At least two points must be specified.
    :type y: ndarray or list of numbers, default: 0

    :param geolock: Sets the geolock on the item for interactive editing in the plot window.
    :type geolock: on_off, default: off

    :param tooltip: Text that appears as a tooltip when the visualised object is hovered over in Metview's plot window.
    :type tooltip: str

    :rtype: :class:`Request`

.. mv-minigallery:: ws_instability_line