GSUE: Generalized Stochastic User Equilibrium

View source: R/GSUE.r

GSUER Documentation

Generalized Stochastic User Equilibrium

Description

This function calculates generalized stochastic user equilibrium (GSUE) using the method of successive averages.

Usage

GSUE(
  ODdemand,
  ODpair,
  A,
  Alpha,
  Beta,
  pow = 4,
  RUM = "logit",
  theta = 1,
  prob.model = "ProductMN",
  tol = 1e-04,
  verbose = F
)

Arguments

ODdemand

Vector of origin-destination (OD) travel demands

ODpair

Vector indicating the OD pair serviced by each route (ordered by columns of the path-link incidence matrix, A).

A

Path-link incidence matrix

Alpha

Vector of free flow travel time parameters for each link

Beta

Vector of capacity parameters for each link

pow

Polynomial order of cost function for each link. Defaults to 4.

RUM

Choice of random utility model. Can be "logit" (the default) or "probit".

theta

A dispersion parameter. For the logit model, a single value specifying the logit parameter. For the probit model, a vector of standard deviations for the individual link cost errors. Defaults to 1.

prob.model

Route choice probability model. One of "ProductMN" (product multinomial, the default), or "Poisson".

tol

Tolerance for convergence assessment (measured as route mean squared difference between current flow vector and the search direction). Defaults of 1e-4.

verbose

Should progress of algorithm be printed out? Defaults to FALSE.

Value

Output is a list of SUE route flows x and corresponding path costs u.

Examples

A <- matrix(c(0,1,0,0,1,0,0,0,0,1,1,0,0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,1),ncol=4,byrow=T) 
Alpha <- rep(10,7)
Beta <- rep(50,7)
pow <- rep(4,7)
ODpair <- c(1,1,2,2)
ODdemand <- c(50,50)
theta <- 0.7
GSUE(ODdemand,ODpair,A=A,Alpha=Alpha,Beta=Beta,pow=pow,theta=theta,verbose=F)

MartinLHazelton/transportation documentation built on Aug. 5, 2023, 10:28 a.m.