.. _ws_wmo_symbol_icon:


ws_wmo_symbol
===============================================

.. container::
    
    .. container:: leftside

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

    .. container:: rightside

		Defines a WMO weather symbol :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 Wmo Symbol** icon in Metview’s :ref:`user interface <user_interface>`. It accepts its parameters as keyword arguments, described below.


.. py:function:: ws_wmo_symbol(**kwargs)
  
    Defines a WMO weather symbol :ref:`Weather Symbol Object <weather_symbols>`.


    :param type: The WMO symbol name.
    :type type: str, default: "ww_91"

    :param shape_colour: Colour of the WMO symbol.
    :type shape_colour: str, default: "black"

    :param line: Enable to draw the outline of the symbol box.
    :type line: {"on", "off"}, default: "off"

    :param line_colour: Colour of the outline. Enabled when ``line`` is "on".
    :type line_colour: str, default: "black"

    :param line_thickness: Thickness of the outline. Enabled when ``line`` is "on".
    :type line_thickness: number, default: 1

    :param line_style: Style of the outline. Enabled when ``line`` is "on".
    :type line_style: {"solid", "dash", "dot", "dash_dot", "dash_dot_dot"}, default: "solid"

    :param fill: Enable to fill the symbol box.
    :type fill: {"on", "off"}, default: "off"

    :param fill_colour: Fill colour of the symbol box. Enabled when ``fill`` is "on".
    :type fill_colour: str, default: "white"

    :param width: the width of the symbol (height is determined automatically).
    :type width: number, default: 30

    :param x: The x coordinate of the centre of the symbol.
    :type x: number, default: 0

    :param y: The y coordinate of the centre of the symbol.
    :type y: number, 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_wmo_symbol