Mapping Toolbox

getseeds

Interactively assign seeds for matrix map encoding

Syntax

• [row,col,val] = getseeds(map,maplegend,nseeds)
  [row,col,val] = getseeds(map,maplegend,nseeds,seedval)
  rcvmat = getseeds(...)
  

Description

This command allows you to interactively create the seed matrix values used by the encodem command to fill in regions of matrix maps.

[row,col,val] = getseeds(map,maplegend,nseeds) prompts the user for a number, nseeds, of mouse-input locations on the current map axes. After the locations are selected, the user is prompted for a value to associate with each location. The outputs are the row and column, row and col, of the input regular matrix map, map, with its associated map legend vector maplegend, corresponding to the input locations. The third output, val, returns the selected value for each location.

[row,col,val] = getseeds(map,maplegend,nseeds,seedval) predefines the values of the locations. If seedval is a scalar, the same value is assigned to all points. If it is a vector with a length of nseeds, each entry corresponds to a particular location.

seedmat = getseeds(...) packs the outputs into a single, three-column matrix, seedmat, which is a suitable input for the encodem command. The form of this matrix is [lat lon val].

Examples

Demonstrate this for yourself by typing the following and interactively selecting points:

• load topo
  axesm('gortho','grid','on')
  seedmat = getseeds(topo,topolegend,3)
  

When you have selected three points, you will be prompted for their values. The regular matrix map need not be displayed to execute getseeds on it.

See Also

encodem

Fill in regions of indexed matrix maps with specified values

getm

gradientm