refine

Refine search of WMS layers

Syntax

refined = refine(layers,querystr)

refined = refine(___,Name,Value,...)

Description

refined = refine(layers,querystr) searches fields of Web map service layers, 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.

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

Examples

Refine Search of Temperature Layers

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];

Input Arguments

layers — Layers to search

array of WMSLayer objects

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

querystr — Characters to search for in WMSLayer object fields

character vector | string

Characters to search for in WMSLayer object fields, 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 quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'IgnoreCase',false

'SearchFields' — Fields to search in the WMSLayer objects

'layer' (default) | 'server' | 'layertitle' | 'layername' | 'servertitle' | 'serverurl' | 'any' | 'abstract'

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. Multiple options may be included in a string array or cell array of character vectors.

The table lists valid values of searchFields.

Field	Behavior
'layer'	Search both the LayerTitle and the LayerName fields.
'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.
'server'	Search the ServerURL in the WMSLayer objects. The server URL and layer information facilitate the reading of raster layers by the function wmsread.
'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.
'abstract'	Search the abstract field in the WMSLayer objects.
'any'	Search all fields.

Data Types: char | string

'MatchType' — Strictness of match

'partial' (default) | 'exact'

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

'IgnoreCase' — Ignore case when comparing field values to querystr

true (default) | false

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

Data Types: logical

Output Arguments

refined — Refined layers

array of WMSLayer objects

Refined layers, specified as an array of WMSLayer objects. Each layer in the array has a searched field that matches the text query, querystr.