Mask points
Functionality
The Mask Points operation allows you to selectively copy points of an input point map into a new output point map. The user has to specify a mask to select and retrieve the class names, IDs or values of the points that are to be copied.
By specifying a mask, you can search for points with a certain class name, ID or value. A mask is in fact a simple query to find (retrieve), display or use only those points in a map that have certain class names, identifiers or values. A mask contains one or more search strings in which wild cards, asterisks (*) and question marks (?), are allowed. You can enter as many search strings in a mask as you like; separate the strings by commas.
Mask syntax:
- search strings in a mask are compared with the classes, IDs or values of the domain of a map; when a map uses a class or ID domain and the classes or IDs have codes, the mask works on the codes and on the names and on the combination of codes and names,
- to find/retrieve one specific class name, identifier or value: type that class name, ID or identifier in the mask,
- to find/retrieve multiple class names, identifiers or values: separate the different class names, identifiers or values in the mask by commas (it does not matter whether you use spaces before or after a comma)
- you can use asterisks as wild cards to replace zero or more characters in class names, IDs or values, for example road*,riv* or 1*,2*,3* , or even *25,*50,*75,*00, or A*b*,D*g*
- you can use question marks as wild cards to replace single characters in class names, identifiers or values, for example Ab?,D?,Gl? or ?p,??i, or A*b??,D*g??
- in a dialog box, you should not use quotes around class names, identifiers or values,
- on the command line, you must use double quotes around the complete mask.
Examples:
- When a point map contains topographic features, and you want to copy points with class names �city� and �mountain peak�; use as mask: city, mountain peak
- When a point map contains bore holes identified by IDs between 100 and 999, and you want to copy the points with an ID that starts with a 1, e.g. IDs 101, 102, 103, etc.; use as mask: 1*
- When a point map contains information on precipitation in milimeters, and you want to copy the points with a precipitation between 400 and 600; use as mask: 4*,5*,6*
For more information, see How to use masks.
Requirements for input point map:
No special input map requirements.
Domain and coordinate system of output map:
The output point map uses the same domain as the input point map.
The output point map uses the same coordinate system and coordinate boundaries as the input point map.
Tip:
- This operation creates a new point map. You can also display specific points of a point map in a map window without creating a new point map: select the Mask check box on the Display Options dialog box of the point map which appears when you open the point map. Then, specify the mask, i.e. the class names, identifiers or values of the points that you want to display.
- To copy a certain area of a point map into a new point map, see Sub-map of point map.
See also:
Mask points : dialog box
Mask points : command line
Mask points : algorithm