Main Content

refine

Refine search of WMS layers

Description

example

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

collapse all

Find layers in the WMS Database that contain information about temperature.

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

collapse all

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

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 Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'IgnoreCase',false

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.

FieldBehavior
'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

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

Output Arguments

collapse all

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

Version History

Introduced in R2009b