refine
Refine search of WMS layers
Description
searches fields of Web map service layers, refined
= refine(layers
,querystr
)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.
modifies the search based on the values of the named parameters.refined
= refine(___,Name,Value
,...)
Examples
Refine Search by Text
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
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 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
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
Version History
Introduced in R2009b
See Also
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)