location_positions: Positions of origin and destination locations in a spatial interaction model

Description

These functions provide low level access to origin and destination local positions. It is recommended to use origin_positions() and destination_positions() instead of location_positions and location_positions<-.

Usage

location_positions(sim)
location_positions(sim) <- value

Value

for location_positions

NULL or a list with two components: origin for the origin location positions and destination for the destination location positions. For location_positions<-() the modified sim object.

Arguments

sim: a spatial interaction model object
value: a list with two components (see the returned value) or NULL

Positions

Location positions are given by numeric matrices with 2 or 3 columns. The first two columns are assumed to be geographical coordinates while the 3rd column can be used for instance to store altitude. Coordinates are interpreted as is in graphical representations (see autoplot.sim()). They are not matched to the costs as those can be derived from complex movement models and other non purely geographic considerations.

Examples

Run this code

positions <- as.matrix(french_cities[1:10, c("th_longitude", "th_latitude")])
distances <- french_cities_distances[1:10, 1:10] / 1000 ## convert to km
production <- rep(1, 10)
attractiveness <- rep(1, 10)
model <- static_blvim(distances, production, 1.5, 1 / 250, attractiveness)
## No positions
location_positions(model) <- list(
  origin = positions,
  destination = positions
)
destination_positions(model)
origin_positions(model)