calib_param {TDLM}R Documentation

Automatic calibration of trip distribution laws' parameter

Description

This function returns an estimation of the optimal parameter value based on the average surface area of the locations (in square kilometer) according to the law. This estimation has only been tested on commuting data (in kilometer).

Usage

calib_param(av_surf, law = "NGravExp")

Arguments

av_surf

a positive numeric value indicating the average surface area of the locations (in square kilometer).

law

a character indicating which law to use (see Details).

Details

The estimation is based on the Figure 8 in Lenormand et al. (2016) for four types of laws. The normalized gravity law with an exponential distance decay function (law = "NGravExp"), the normalized gravity law with a power distance decay function (law = "NGravPow"), the Schneider's intervening opportunities law (law = "Schneider") and the extended radiation law (law = "RadExt").

Value

An estimation of the optimal parameter value based on the average surface area of the locations.

Author(s)

Maxime Lenormand (maxime.lenormand@inrae.fr)

References

Lenormand M, Bassolas A, Ramasco JJ (2016). “Systematic comparison of trip distribution laws and models.” Journal of Transport Geography, 51, 158-169.

See Also

extract_opportunities() extract_spatial_information() check_format_names()

Examples

data(county)

res <- extract_spatial_information(county, id = "ID")
av_surf <- mean(res$surface)

calib_param(av_surf = av_surf, law = "NGravExp")
calib_param(av_surf = av_surf, law = "NGravPow")
calib_param(av_surf = av_surf, law = "Schneider")
calib_param(av_surf = av_surf, law = "RadExt")


[Package TDLM version 1.0.0 Index]