.. _thermoview_icon: thermoview =============================================== .. container:: .. container:: leftside .. image:: /_static/THERMOVIEW.png :width: 48px .. container:: rightside Specifies the view for a thermodynamic diagram. A suitable :class:`Fieldset` (GRIB), :class:`Bufr` or :func:`input_visualiser` data can be directly plotted into a :func:`thermoview`, the necessary profiles will be automatically extracted from the input data. On top of that :func:`thermo_bufr` and :func:`thermo_grib` objects can be also visualised in a :func:`thermoview`. When using :func:`thermoview` the generated profile data cannot be accessed. If you need to access this data use :func:`thermo_bufr` or :func:`thermo_grib` instead. For further details on the role and usage of views in the visualisation process, please see :ref:`Anaylis Views `. .. note:: This function performs the same task as the **Thermo View** icon in Metview’s :ref:`user interface `. It accepts its parameters as keyword arguments, described below. .. py:function:: thermoview(**kwargs) Specifies the view for a thermodynamic diagram. :param type: Specifies the type of the thermodynamic diagram to be produced. :type type: {"tephigram", "skewt", "emagram"}, default: "tephigram" :param bottom_pressure: Specifies the value (hPa) at the bottom of the pressure axis of the thermodynamic diagram. :type bottom_pressure: number, default: 1015.0 :param top_pressure: Specifies the value (hPa) at the top of the pressure axis of the thermodynamic diagram. :type top_pressure: number, default: 100 :param minimum_temperature: Specifies the minimum value (Celsius) on the temperature axis of the thermodynamic diagram. :type minimum_temperature: number, default: -90 :param maximum_temperature: Specifies the maximum value (Celsius) on the temperature axis of the thermodynamic diagram. :type maximum_temperature: number, default: 50 :param thermo_grid: Configures the background attributes of the thermodynamic diagram. :type thermo_grid: :func:`mthermogrid` :param point_selection: Specifies the geographical location selection mode. The possible values are as follows: * coordinates: use lat/lon coordinates * area_average: [*GRIB only*] average in a geographical area * wmo_name: [*BUFR only*] use the WMO station name from *stationOrSiteName* ecCodes BUFR key * wmo_ident: [*BUFR only*] use the WMO station identifier as *blockNumber*1000+stationNumber* * wigos: [*BUFR only*] use the :xref:`wigos_wsi`. This is made up of four values (blocks) represented by ``wigos_series``, ``wigos_issuer``, ``wigos_issue_number`` and ``wigos_local_name``. * station: use a :func:`stations` object :type point_selection: {"coordinates", "area_average", "wmo_name", "wmo_ident", "wigos", "station"}, default: "coordinates" :param coordinates: Specifies the geographical location (as [lat, lon]) for which the diagram is to be plotted. Available when ``point_selection`` is "coordinates". When BUFR data is used all the stations within the ``threshold`` around this location will be selected. :type coordinates: list, default: [0, 0] :param threshold: [*BUFR only*] Specifies the threshold in degrees (both in lat and lon) for selecting the matching station(s) for the specified coordinates. Available when ``point_selection`` is "coordinates". *New in Metview version 5.17.0* :type threshold: number, default: 0.1 :param area_average: [*GRIB only*] Specifies a geographical area over which an area average value will be used, instead of a point value, to produce the diagram. The area is defined as [north, west, south, east]. Available when ``point_selection`` is "area_average". :type area_average: list, default: [30, -30, -30, 30] :param wmo_name: [*BUFR only*] Specifies the WMO name of the station to be selected by using the *stationOrSiteName* ecCodes BUFR key from the data section of the messages. Name matching is case insensitive with leading and trailing spaces omitted. Available when ``point_selection`` is "wmo_name". *New in Metview version 5.17.0* :type wmo_name: str :param wmo_ident: [*BUFR only*] Specifies the numeric WMO identifier of the station to be selected. This is the combination of the WMO block and station number in the form of *blockNumber*1000+stationNumber*. These numbers are extracted from the data section of the BUFR message using the corresponding ecCodes keys. Available when ``point_selection`` is "wmo_ident". *New in Metview version 5.17.0* :type wmo_ident: number, default: -1 :param wigos_series: [*BUFR only*] Specifies the WIGOS Identifier Series represented by the *wigosIdentifierSeries* ecCodes key in the BUFR message. The default value (-1) means that this parameter is not used in the :xref:`wigos_wsi` matching. Available when ``point_selection`` is "wigos". *New in Metview version 5.17.0* . :type wigos_series: number, default: -q :param wigos_issuer: [*BUFR only*] Specifies the WIGOS Issuer of Identifier represented by the *wigosIssuerOfIdentifier* ecCodes key in the BUFR message. The default value (-1) means that this parameter is not used in the :xref:`wigos_wsi` matching. Available when ``point_selection`` is "wigos". *New in Metview version 5.17.0* . :type wigos_issuer: number, default: -1 :param wigos_issue_number: [*BUFR only*] Specifies the WIGOS Issue Number represented by the *wigosIssueNumber* ecCodes key in the BUFR message. The default value (-1) means that this parameter is not used in the :xref:`wigos_wsi` matching. Available when ``point_selection`` is "wigos". *New in Metview version 5.17.0* . :type wigos_issue_number: number, default: -1 :param wigos_local_name: [*BUFR only*] Specifies the WIGOS Local Identifier name represented by the *wigosLocalIdentifierCharacter* ecCodes key in the BUFR message. The default value (empty string) means that this parameter is not used in the :xref:`wigos_wsi` matching. Available when ``point_selection`` is "wigos". *New in Metview version 5.17.0* . :type wigos_local_name: str :param station: Specifies the location as a :func:`stations` object for which the diagram is to be plotted. Available if ``point_selection`` is "station". :type station: :func:`stations`` :param point_extraction: [*GRIB only*] Specifies the way to calculate values at the point location for GRIB thermodynamic diagrams. The possible options are: * "interpolate": interpolate values from the four surrounding grid points. * "nearest_gridpoint": use the data from the nearest grid point. Available if ``point_selection`` is "coordinates". :type point_extraction: {"interpolate", "nearest_gridpoint"}, default: "interpolate" :param dew_point_formulation: [*GRIB only*] Specifies the equation to compute the dew point. :type dew_point_formulation: {"saturation_over_water", "mixed_phase_0_to\_\-23"}, default: "saturation_over_water" :param temperature_param: [*GRIB only*] Specifies the ecCodes paramId used to identify the temperature in the input data. :type temperature_param: number, default: 130 :param specific_humidity_param: [*GRIB only*] Specifies the ecCodes paramId used to identify the specific humidity in the input data. :type specific_humidity_param: number, default: 133 :param lnsp_param: [*GRIB only*] Specifies the ecCodes paramId used to identify the Logarithm of Surface Pressure (LNSP) in the input data. :type lnsp_param: number, default: 152 :param u_wind_param: [*GRIB only*] Specifies the ecCodes paramId used to identify the U wind component in the input data. :type u_wind_param: number, default: 131 :param v_wind_param: [*GRIB only*] Specifies the ecCodes paramId used to identify the V wind component in the input data. :type v_wind_param: number, default: 132 :param subpage_clipping: Clips plot to subpage borders. :type subpage_clipping: {"on", "off"}, default: "off" :param subpage_x_position: Specifies the X offset of the plot from the left side of the plot frame (any subdivision of the display area). This is expressed as a percentage of the X-dimension of the plot frame. :type subpage_x_position: number, default: 12 :param subpage_y_position: Specifies the Y offset of the plot from the bottom side of the plot frame (any subdivision of the display area). This is expressed as a percentage of the Y-dimension of the plot frame. :type subpage_y_position: number, default: 10 :param subpage_x_length: Specifies the X length of the plot. This is expressed as a percentage of the X-dimension of the plot frame. Hence the sum of this X length plus the X offset cannot exceed 100 (it is advised that it does not exceed 95 since you need some margin on the right for things like axis or map grid labels). :type subpage_x_length: number, default: 75 :param subpage_y_length: Same as ``subpage_x_length`` but for the Y length of the plot. :type subpage_y_length: number, default: 80 :param page_frame: Toggles the plotting of a border line around the plot frame. :type page_frame: {"on", "off"}, default: "off" :param page_frame_colour: Colour of the page frame. Available when ``page_frame`` is "on". :type page_frame_colour: str, default: "charcoal" :param page_frame_line_style: Line style of the page frame. Available when ``page_frame`` is "on". :type page_frame_line_style: {"solid", "dot", "dash", "chain_dot", "chain_dash"}, default: "solid" :param page_frame_thickness: Line thickness of the page frame. Available when ``page_frame`` is "on". :type page_frame_thickness: number, default: 2 :param page_id_line: Toggles the plotting of plot identification line. :type page_id_line: {"on", "off"}, default: "off" :param page_id_line_user_text: Specifies user text to be added to the plot identification line. Only available when ``page_id_line`` is "on". :type page_id_line_user_text: str :param subpage_frame: Toggles the plotting of a border line around the plot itself. In most cases you will want this to be left "on". When "off" the sides of the plot not equipped with axis will not be plotted. :type subpage_frame: {"on", "off"}, default: "off" :param subpage_frame_colour: Colour of the subpage frame. Available when ``subpage_frame`` is "on". :type subpage_frame_colour: str, default: "black" :param subpage_frame_line_style: Line style of the subpage frame. Available when ``subpage_frame`` is "on". :type subpage_frame_line_style: {"solid", "dot", "dash", "chain_dot", "chain_dash"}, default: "solid" :param subpage_frame_thickness: Line thickness of the subpage frame. Available when ``subpage_frame`` is "on". :type subpage_frame_thickness: int, default: 2 :param subpage_background_colour: Specifies the colour of the background of the plot (i.e. not affected by visual definitions like contour shadings or lines). :type subpage_background_colour: str, default: "white" :rtype: :class:`Request` .. mv-minigallery:: thermoview