At Work Subtour Models

Introduction

The goal of this task is to implement the at-work subtour models. The at-work subtour frequency, scheduling, and destination sub-models are similar in form to the existing partially implemented non-mandatory tour frequency, departure and duration, and destination models. However, a few key missing features of the existing models are the processing of each tour purpose, the calculation of time windowing variables, and logsums. At-work subtour mode choice is essentially already done by tour_mode_choice_simulate, although an explicit model step needs to be added that operates only on at-work tours.

New Model Steps

The following sub-model steps need to be added to the data pipeline:

AtWork Subtour Frequency
AtWork Subtour Location Sample
AtWork Subtour Location Logsums
AtWork Subtour Location
AtWork Subtour Departure Time And Duration
AtWork Subtour Mode

AtWork Subtour Frequency

Choosers: work tours
Alternatives: none, 1 eating out tour, 1 business tour, 1 maintenance tour, 2 business tours, 1 eating out tour + 1 business tour
Dependent tables: household, person, accessibility
Outputs: work tour subtour frequency choice, at-work tours table (with only tour origin zone at this point)

AtWork Subtour Location Sample

This model is the same as the existing workplace location sample model except it operates on the at-work tours. Skims are indexed as follows: odt_skims = tour_origin, alt_zone, MD and dot_skims = alt_zone, tour_origin, MD.

Choosers: at-work tours
Alternatives: all zones
Dependent tables: skims, size terms, land use
Outputs: alternative zone set for each at-work tour

AtWork Subtour Logsums

This model is the same as the existing workplace location logsums model except it operates on the at-work tours. Skims are indexed as follows: odt_skims = tour_origin, alt_zone, MD and dot_skims = alt_zone, tour_origin, MD.

Choosers: at-work tours * number of alternative zones
Alternatives: N/A
Dependent tables: skims, size terms, household, person, land use, accessibility, work tour
Outputs: logsums for the alternative zone set for each at-work tour

AtWork Subtour Location

This model is the same as the existing workplace location model except it operates on the at-work tours. Skims are indexed as follows: odt_skims = tour_origin, alt_zone, MD and dot_skims = alt_zone, tour_origin, MD.

Choosers: at-work tours
Alternatives: alternative zones from the sample step
Dependent tables: skims, size terms, land use
Outputs: at-work tour destination zone

AtWork Subtour Departure Time And Duration

This model is the same as the existing mandatory tour scheduling model except it operates on the at-work tours. Skims are indexed as follows: odt_skims = tour_origin, alt_zone, depart_time_alt and dot_skims = alt_zone, tour_origin, arrival_time_back_home_alt. Unlike the other departure time and duration models, the at-work subtour model does not require mode choice logsums. If no time window is available for the tour, make the first and last alternatives available for that alternative, and log the number of times this condition occurs.

Choosers: at-work tours
Alternatives: alternative departure and arrival back at origin (from 5am to midnight in 1 hr increments, 190 total) WITHIN the work tour departure and arrival back at origin (i.e. time window)
Dependent tables: skims, person, land use, work tour
Outputs: at-work tour departure and arrival back at origin, updated person time windows