Skip to contents

State which map convention you are using

Source: R/disputes.R
dispute_policy.Rd

Disputed territories are drawn differently by different conventions, and a map that does not say which one it used is making a choice silently. This sets the session's convention so world_map() can record it and map_provenance() can report it.

Usage

dispute_policy(policy = NULL, worldview = NULL)

Arguments

policy

One of:

  • "none" (default) – no convention stated. Maps carry no dispute annotation, exactly as before.

  • "de_facto" – boundaries as administered on the ground, which is what Natural Earth (and therefore this package's geometry) uses.

  • "de_jure" – boundaries as claimed. The package does not ship de jure geometry; selecting this records the intent and warns that the shapes drawn are still de facto.

  • "neutral" – disputed areas marked as disputed rather than assigned.

Called with no argument, returns the current policy.

worldview

Optional point of view to draw: the viewing country's ISO alpha-3 code ("IND") or "ISO", one of Natural Earth's 31 published worldviews (see world_geometry()). Once set, geometry attached on the sf backend draws that country's boundaries, and the provenance records it. NA clears it.

Value

When called with no argument, the policy currently in effect. When setting, the policy that was in effect before the call, invisibly – R's convention for a setter, so on.exit(dispute_policy(dispute_policy("neutral"))) restores it.

What this does and does not do

On its own it records a choice and makes it visible. It does not redraw any boundary, and selecting "de_jure" gives no claimed-boundary geometry, so it warns. With a worldview it does change the shapes: the sf backend draws that country's published view. The package ships no worldview of its own beyond Natural Earth's default, and anyone publishing under an institutional convention should still verify the shapes against that institution's own basemap rather than trusting a setting.

See also

disputed_territories, check_dispute_coverage(), world_map()

Examples

old <- dispute_policy("neutral")   # sets, and returns what it replaced
dispute_policy()                   # "neutral"
#> [1] "neutral"
dispute_policy(old)                # put it back