TOD.md

Time of Day files

Four time-of-day files handle day-of-week and time-of-day restrictions and other attributes on links, segments, lanes, lane_segments and movements

time_set_definitions

The specification currently allows for times of day to be represented in the following format: XXXXXXXX_HHMM_HHMM, where XXXXXXXX is a bitmap of days of the week, Sunday-Saturday, Holiday. The HHMM are the start and end times. This is adapted from the Synchro Universal Traffic Data Format (UTDF) TimeOfDay table structure. For example, Monday-Friday 0700-0900 would be 01111100_0700_0900. Alternatively, these can be coded in the following time_set_definitions table and timeday_id referenced instead of this format.

Field Name	Type	Required?	Description
timeday_id	TimeDay_ID	Required	Primary key, similar to service_id in GTFS. Unique name of the time of day. Preferable legible rather than a number.
monday	boolean	Required	Whether Mondays are included (and so on for the other boolean fields)
tuesday	boolean	Required	0 or 1
wednesday	boolean	Required	0 or 1
thursday	boolean	Required	0 or 1
friday	boolean	Required	0 or 1
saturday	boolean	Required	0 or 1
sunday	boolean	Required	0 or 1
holiday	boolean	Required	0 or 1
start_time	timeofday	Required	HH:MM  (24hr format)
end_time	timeofday	Required	HH:MM  (24hr format)

Optional ad-hoc fields could define other types of day (snow, unknown, etc.).

link_tod

link_tod is an optional file that handles day-of-week and time-of-day restrictions on links. It is used for tolls (which may differ by time-of-day), and part-time changes in link capacity. Since tolls often vary by time of day, they are placed in this file.

link_tod data dictionary

Field	Type	Required?	Comment
link_tod_id	Link_TOD_ID	Required	Primary key
link_id	Link_ID	Required	Foreign key, link table
time_day	TimeDay_Set	Conditionally required	Define the availability/role of lane at different dates and times (either time_day or timeday_id is required)
timeday_id	TimeDay_ID	Conditionally required	Used if times-of-day are defined on the time_set_definitions table
capacity	NUMERIC	Optional	Capacity (veh / hr / lane)
free_speed	NUMERIC	Optional	Free flow speed in long_length units per hour
lanes	INTEGER	Optional	Number of lanes in the direction of travel
bike_facility	TEXT	Optional	Type of bicycle accommodation: unknown, none, wcl, bikelane, cycletrack
ped_facility	TEXT	Optional	Type of pedestrian accommodation: unknown, none, shoulder, sidewalk
parking	TEXT	Optional	Type of parking: unknown, none, parallel, angle, other
allowed_uses	Use_Set	Optional	Set of allowed uses: shoulder, parking, walk, all, bike, auto, hov2, hov3, truck, bus, etc.
toll	NUMERIC	Optional	toll in currency units

segment_tod

segment_tod is an optional file that handles day-of-week and time-of-day restrictions on segments. It is used for part-time changes in segment capacity and number of lanes.

segment_tod data dictionary

Field	Type	Required?	Comment
segment_tod_id	Segment_TOD_ID	Required	Primary key
segment_id	Segment_ID	Required	Foreign key, segment table.
time_day	TimeDay_Set	Conditionally required	Define the availability/role of segment at different dates and times (either time_day or timeday_id is required)
timeday_id	TimeDay_ID	Conditionally required	Used if times-of-day are defined on the time_set_definitions table
capacity	NUMERIC	Optional	Capacity (veh / hr / lane)
free_speed	NUMERIC	Optional	Free flow speed in long_length units per hour
lanes	INTEGER	Optional	Number of lanes in the direction of travel (must be consistent with link lanes + lanes added)
l_lanes_added	INTEGER	Optional	# of lanes added on the left of the link (negative indicates a lane drop).
r_lanes_added	INTEGER	Optional	# of lanes added on the right of the link (negative indicates a lane drop).
bike_facility	TEXT	Optional	Type of bicycle accommodation: unknown, none, wcl, bikelane, cycletrack
ped_facility	TEXT	Optional	Type of pedestrian accommodation: unknown, none, shoulder, sidewalk
parking	TEXT	Optional	Type of parking: unknown, none, parallel, angle, other
allowed_uses	Use_Set	Optional	Set of allowed uses: shoulder, parking, walk, all, bike, auto, hov2, hov3, truck, bus, etc.
toll	NUMERIC	Optional	toll in currency units

lane_tod

Field	Type	Required?	Comment
lane_tod_id	Lane_TOD_ID	Required	Primary key
lane_id	Lane_ID	Required	Foreign key, lane table
time_day	TimeDay_Set	Conditionally required	Define the availability/role of lane at different dates and times (either time_day or timeday_id is required)
timeday_id	TimeDay_ID	Conditionally required	Used if times-of-day are defined on the time_set_definitions table
lane_num	INTEGER	Required	e.g., -1, 1, 2 (use left-to-right numbering)
allowed_uses	Use_Set	Optional	Set of allowed uses: shoulder, parking, walk, all, bike, auto, hov2, hov3, truck, bus, etc.
r_barrier	TEXT	Optional	Whether a barrier exists to prevent vehicles from changing lanes to the right (default is NONE)
l_barrier	TEXT	Optional	Whether a barrier exists to prevent vehicles from changing lanes to the right (default is NONE)
width	NUMERIC	Optional	Width of the lane (short_length units)

segment_lane_tod

Field	Type	Required?	Comment
segment_lane_tod_id	Segment_Lane_TOD_ID	Required	Primary key
segment_lane_id	Segment_Lane_ID	Required	Foreign key, segment_lane table
time_day	TimeDay_Set	Conditionally required	Define the availability/role of lane at different dates and times (either time_day or timeday_id is required)
timeday_id	TimeDay_ID	Conditionally required	Used if times-of-day are defined on the time_set_definitions table
lane_num	INTEGER	Required	e.g., -1, 1, 2 (use left-to-right numbering)
allowed_uses	Use_Set	Optional	Set of allowed uses: shoulder, parking, walk, all, bike, auto, hov2, hov3, truck, bus, etc.
r_barrier	TEXT	Optional	Whether a barrier exists to prevent vehicles from changing lanes to the right (default is NONE)
l_barrier	TEXT	Optional	Whether a barrier exists to prevent vehicles from changing lanes to the right (default is NONE)
width	NUMERIC	Optional	Width of the lane (short_length units)

Ad hoc fields, such as notes, may also be added to any of these tables.