Metview's documentation is now on readthedocs!

This icon controls the parsing and plotting of an ASCII table file such as CSV - see ASCII Tables for more information. The columns used for plotting can be selected by name (if there is a header row) or by index, starting at 1. The points may be interpreted as either geographic co-ordinates or as generic X/Y co-ordinates.

The macro language equivalent is table_visualiser().

The Table Visualiser Editor

Specifies the type of plot to be generated. This also implicitly specifies the type of data which will be entered. The available modes follow a set format: the first part is either 'Geo' (geographical coordinates) or 'Xy' (more generic coordinates); the second part is 'Points' (individual points), 'Vectors' (individual points with vector information) or 'Binning' (the points will be gridded – see Binning).

Table Filename

Specifies the path to the ASCII table file to be used. Alternatively, drop an icon into the Table Data field, which overrides Table Filename.

Table Data

Drop an ASCII Table icon into this field to specify the data to be used. A Notes icon will also be accepted, since Metview cannot be expected to automatically discriminate any but the most common types of ASCII table data from other ASCII files. Note that Table Filename is an alternative way of specifying the file.

Table X Type

Specifies how the X values should be interpreted, as numbers or as dates. Only available for 'Xy' type plots.

Table Y Type

Specifies how the Y values should be interpreted, as numbers or as dates. Only available for 'Xy' type plots.

Table Variable Identifier Type

Specifies how to identify the columns to use: by Name or by Index (starting at 1).

Table X Variable

Specifies which variable/column to use for the x co-ordinates of the points. Can be a name or an index - see Table Variable Identifier Type Only available for 'Xy' type plots when Table X Type is Number.

Table Y Variable

Specifies which variable/column to use for the x co-ordinates of the points. Can be a name or an index - see Table Variable Identifier Type Only available for 'Xy' type plots when Table Y Type is Number.

Table X Missing Value

Points with this value in their x co-ordinate will not be plotted.

Table Y Missing Value

Points with this value in their y co-ordinate will not be plotted.

Table Longitude Variable

Specifies which variable/column to use for the longitude co-ordinates of the points. Can be a name or an index - see Table Variable Identifier Type. Only available for 'Geo' type plots .

Table Latitude Variable

Specifies which variable/column to use for the latitude co-ordinates of the points. Can be a name or an index - see Table Variable Identifier Type. Only available for 'Geo' type plots .

Table X Component Variable

When set to a 'Vectors' type plot, this parameter specifies which variable/column gives the magnitudes of the vectors in the X or longitude direction (e.g. U-component of wind). Can be a name or an index - see Table Variable Identifier Type.

Table Y Component Variable

When set to a 'Vectors' type plot, this parameter specifies which variable/column gives the magnitudes of the vectors in the Y or latitude direction (e.g. V-component of wind). Can be a name or an index - see Table Variable Identifier Type.

Table Value Variable

Specifies which variable/column supplies the values for the points. Can be a name or an index - see Table Variable Identifier Type.

Table Binning

Drop a Binning icon here. Only available for 'Binning' type plots. 

Table Delimiter

Specifies the (single) character that separates values in the table.

Table Combine Delimiters

If On, then consecutive delimiters will be considered as one. This is often the case when whitespace is used to separate values which are aligned in columns. Note that in this case, it is not possible to represent missing values in the table. If Off, then a delimiter not surrounded by two data values indicates there is a missing value on at least one side of it. See the discussion in  ASCII Tables for more details.

Table Header Row

Specifies which row of the table file contains the names of the columns. This row, if present, should contain the one entry for each data column, separated with the same delimiter as the data. The first row of the table is number 1. Set this parameter to 0 in order to indicate that there is no header row.

Table Data Row Offset

Specifies how many rows after the header row the first data row appears. Normally this is 1, since data tends to start on the row after the column headers. If there is no header row, then this number is equivalent to the first data row (e.g. if the data starts on row 3, then set this parameter to 3).

Table Meta Data Rows

Specifies the rows (if any) which contain meta-data in a form which can be parsed by Metview. See ASCII Tables for more details. Enter the row numbers separated by a "/".