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")