Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.

refine

Class: WMSLayer

Refine search

Syntax

refine(layers,querystr)
refine(___,Name,Value,...)

Description

refine(layers,querystr) searches fields of WMSLayer objects in layers for a partial match with the string or character vector in querystr. By default, refine searches the Layer or LayerName properties but you can include other fields in the search using the SearchFields parameter.

refine(___,Name,Value,...) modifies the search based on the values of the parameters.

Input Arguments

expand all

Layers to search, specified as an array of WMSLayer objects.

Characters to search for in WMSLayer object, specified as a string or character vector. querystr can contain the asterisk wildcard character (*).

Example: 'temperature'

Data Types: char | string

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

expand all

Fields to search in the WMSLayer objects, specified as a string, string array, character vector, or cell array of character vectors. The function searches the values of the specified fields in the WMSLayer objects for a partial or exact match with querystr. The following table lists valid values.

FieldBehavior
'layername'Search the LayerName field in the WMSLayer objects. The layer name is an abbreviated form of the LayerTitle field and is the keyword the server uses to retrieve the layer.
'layertitle'Search the LayerTitle field in the WMSLayer objects. The layer title includes descriptive information about a layer and facilitates understanding the meaning of the raster values of the layer.
'layer'Search both the LayerTitle and the LayerName fields.
'servertitle'Search the ServerTitle field in the WMSLayer objects. A server title includes descriptive information about the server.
'serverurl'Search the ServerURL in the WMSLayer objects. The server URL and layer information facilitate the reading of raster layers by the function wmsread.
'server'Search both the ServerTitle and the ServerURL fields.
'any'Search all fields.
'abstract'Search the abstract field in the WMSLayer objects.

Data Types: char | string

Strictness of match, specified as the string or character vector 'partial' or 'exact'. If 'MatchType' is 'exact' and querystr is '*', a match occurs when the search field matches the character '*'.

Data Types: char | string

Ignore case when comparing field values to querystr, specified as the logical value true or false.

Data Types: logical

Examples

expand all

First find layers in the WMS database that contain temperature information.

temperature = wmsfind('temperature');

Refine the search of temperature layers to find only those layers that contain annual temperature information.

annual = refine(temperature,'annual');

Refine the search of temperature layers to find layers containing only sea surface temperatures.

sst = refine(temperature,'sea surface');

Refine the search of sea surface temperature layers to include only layers that include annual information.

annual_and_sst = refine(sst,'annual');
annual_or_sst = [sst;annual];
Was this topic helpful?