polygonlevels

zvals = polygonlevels(D::GDtype, ids::VecOrMat{String}, vals::Vector{<:Real}; kw...) -> Vector{Float64}

or

zvals = polygonlevels(D::GDtype, idvals::GMTdataset; kw...) -> Vector{Float64}

Creates a vector with zvals to use in plot when creating choropleth maps and where length(zvals) == length(D).

• ids: is a string Vector or Matrix with the ids (attribute names) of the GMTdataset D. If a Matrix (2 columns only) then the att bellow must also have the two names (string vector with two elements) that will be matched against the two elements of each line of ids. The idea here is to match two conditions: att[1] == ids[n,1] && att[2] == ids[n,2]

• vals: is a vector with the numbers to be used in plot level to color the polygons.

• idvals: is a GMTdataset with the text field containing the ids to match against the ids strings. The first column of id_vals must contain the values to be used in vals. This is a comodity function when both the ids and vals are store in a GMTdataset.

• attrib or att: keyword to select which attribute to use when matching with contents of the ids strings.

• nocase or insensitive: a keyword from kw. Perform a case insensitive comparision between the contents of ids and the attribute specified with attrib. Default compares as case sensistive.

• starts,ends,contains: Sometimes the attribute value is only part of the string in ids. Use one of these options to specify how to match. E.g. ends=true selects all attributes that ends with a match in ids. Default is the exact match.

• repeat: keyword to replicate the previously known value until it finds a new segment ID for the case when a polygon have no attributes (may happen for the islands in a country).

Returns a Vector{Float64} with the same length as the number of segments in D. Its content are made up from the contents of vals but may be repeated such that each polygon of the same family, i.e. with the same ids, has the same value.

Examples

Realy need to provide one

See Also

inwhichpolygon, getbyattrib, coast, [plot3]

Source Code

This function has multiple methods:

• polygonlevels(D::Vector{<:GMTdataset}, user_ids::Matrix{<:AbstractString}, vals::Vector{<:Real}; kw...) - spatial_funs.jl:79
• polygonlevels(D::Vector{<:GMTdataset}, user_ids::Vector{<:AbstractString}, vals::Vector{<:Real}; kw...) - spatial_funs.jl:51
• polygonlevels(D::Vector{<:GMTdataset}, user_ids::VecOrMat{<:AbstractString}, vals; kw...) - spatial_funs.jl:42
• polygonlevels(D::Vector{<:GMTdataset}, id_vals::GMTdataset; kw...) - spatial_funs.jl:37