Skip to content

Commit

Permalink
update docs of weight_Streetnet for #190
Browse files Browse the repository at this point in the history
  • Loading branch information
mpadge committed Sep 12, 2022
1 parent 3832d75 commit 9b2ca7e
Show file tree
Hide file tree
Showing 4 changed files with 22 additions and 14 deletions.
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Package: dodgr
Title: Distances on Directed Graphs
Version: 0.2.15.051
Version: 0.2.15.052
Authors@R: c(
person("Mark", "Padgham", , "mark.padgham@email.com", role = c("aut", "cre")),
person("Andreas", "Petutschnig", role = "aut"),
Expand Down
16 changes: 10 additions & 6 deletions R/weight-streetnet.R
Original file line number Diff line number Diff line change
Expand Up @@ -76,14 +76,18 @@
#' }
#'
#' Restrictions and time-penalties on turns can be implemented from such
#' objects by setting `turn_penalty = TRUE`. Resultant graphs are fundamentally
#' different from the default for distance-based routing. The result of
#' `weight_streetnet(..., turn_penalty = TRUE)` should thus \emph{only} be used
#' to submit to the \link{dodgr_times} function, and not for any other `dodgr`
#' functions nor forms of network analysis. Setting `turn_penalty = TRUE` will
#' objects by setting `turn_penalty = TRUE`. Setting `turn_penalty = TRUE` will
#' honour turn restrictions specified in Open Street Map (unless the "penalties"
#' table of \link{weighting_profiles} has `restrictions = FALSE` for a specified
#' `wt_profile`).
#' `wt_profile`). Resultant graphs are fundamentally different from the default
#' for distance-based routing. These graphs may be used directly in the
#' \link{dodgr_dists} function. Use in any other functions requires additional
#' information obtained in a file in the temporary directory of the current R
#' session with a name starting with "dodgr_junctions_", and including the
#' value of `attr(graph, "hash")`. If graphs with turn penalties are to be used
#' in subsequent R sessions, this "dodgr_junctions_" file will need to be moved
#' to a more permanent storage location, and then replaced in the temporary
#' directory of any subsequent R sessions.
#'
#' @note The resultant graph includes only those edges for which the given
#' weighting profile specifies finite edge weights. Any edges of types not
Expand Down
2 changes: 1 addition & 1 deletion codemeta.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
"codeRepository": "/~https://github.com/ATFutures/dodgr",
"issueTracker": "/~https://github.com/ATFutures/dodgr/issues",
"license": "https://spdx.org/licenses/GPL-3.0",
"version": "0.2.15.051",
"version": "0.2.15.052",
"programmingLanguage": {
"@type": "ComputerLanguage",
"name": "R",
Expand Down
16 changes: 10 additions & 6 deletions man/weight_streetnet.Rd

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit 9b2ca7e

Please sign in to comment.