Merge pull request #80 from zephyr-data-specs/autogenerated-docs

Update Spec Documentation

docs/spec/README.md

@@ -1,7 +1,7 @@
 # `gmns` General Modeling Network Specification (GMNS)
 - `description` The General Modeling Network Specification (GMNS) defines a common machine (and human) readable format for sharing routable road network files. It is designed to be used in multi-modal static and dynamic transportation planning and operations models.
 - `homepage` https://github.com/zephyr-data-specs/GMNS
-- `version` 0.0.95
+- `version` 0.95
 ## `link`
   - `description` A link is an edge in a network, defined by the nodes it travels from and to. It may have associated geometry information. Links have three types of attributes:<br>  - Those that define the physical location of the link (e.g., `shape` `information`, `length`, `width`)<br>  - Those that define the link's directionality: `from_node`, `to_node`<br>  - Those that define properties in the direction of travel: capacity, free flow speed, number of lanes, permitted uses, grade, facility type
   - `path` link.csv

usage/database/lane.sql

@@ -1,7 +1,7 @@
 CREATE TABLE IF NOT EXISTS lane (
 	lane_id TEXT NOT NULL, 
 	link_id TEXT NOT NULL, 
-	lane_num INTEGER NOT NULL CHECK (lane_num <= 10) CHECK (lane_num >= -10), 
+	lane_num INTEGER NOT NULL CHECK (lane_num >= -10) CHECK (lane_num <= 10), 
 	allowed_uses TEXT, 
 	r_barrier VARCHAR(10), 
 	l_barrier VARCHAR(10), 

usage/database/lane_tod.sql

@@ -3,7 +3,7 @@ CREATE TABLE IF NOT EXISTS lane_tod (
 	lane_id TEXT NOT NULL, 
 	timeday_id TEXT, 
 	time_day TEXT, 
-	lane_num INTEGER NOT NULL CHECK (lane_num <= 10) CHECK (lane_num >= -10), 
+	lane_num INTEGER NOT NULL CHECK (lane_num >= -10) CHECK (lane_num <= 10), 
 	allowed_uses TEXT, 
 	r_barrier VARCHAR(10), 
 	l_barrier VARCHAR(10), 

usage/database/link.sql

@@ -9,10 +9,10 @@ CREATE TABLE IF NOT EXISTS link (
 	parent_link_id TEXT, 
 	dir_flag INTEGER, 
 	length FLOAT CHECK (length >= 0), 
-	grade FLOAT CHECK (grade >= -100) CHECK (grade <= 100), 
+	grade FLOAT CHECK (grade <= 100) CHECK (grade >= -100), 
 	facility_type TEXT, 
 	capacity FLOAT CHECK (capacity >= 0), 
-	free_speed FLOAT CHECK (free_speed >= 0) CHECK (free_speed <= 200), 
+	free_speed FLOAT CHECK (free_speed <= 200) CHECK (free_speed >= 0), 
 	lanes INTEGER CHECK (lanes >= 0), 
 	bike_facility VARCHAR(22), 
 	ped_facility VARCHAR(14), 

usage/database/link_tod.sql

@@ -4,14 +4,14 @@ CREATE TABLE IF NOT EXISTS link_tod (
 	timeday_id TEXT, 
 	time_day TEXT, 
 	capacity FLOAT CHECK (capacity >= 0), 
-	free_speed FLOAT CHECK (free_speed >= 0) CHECK (free_speed <= 200), 
+	free_speed FLOAT CHECK (free_speed <= 200) CHECK (free_speed >= 0), 
 	lanes INTEGER CHECK (lanes >= 0), 
 	bike_facility VARCHAR(22), 
 	ped_facility VARCHAR(14), 
 	parking VARCHAR(8), 
 	allowed_uses TEXT, 
 	toll FLOAT, 
 	PRIMARY KEY (link_tod_id), 
-	FOREIGN KEY(timeday_id) REFERENCES time_set_definitions (timeday_id), 
-	FOREIGN KEY(link_id) REFERENCES link (link_id)
+	FOREIGN KEY(link_id) REFERENCES link (link_id), 
+	FOREIGN KEY(timeday_id) REFERENCES time_set_definitions (timeday_id)
 )

usage/database/location.sql

@@ -10,6 +10,6 @@ CREATE TABLE IF NOT EXISTS location (
 	zone_id TEXT, 
 	gtfs_stop_id TEXT, 
 	PRIMARY KEY (loc_id), 
-	FOREIGN KEY(ref_node_id) REFERENCES node (node_id), 
-	FOREIGN KEY(link_id) REFERENCES link (link_id)
+	FOREIGN KEY(link_id) REFERENCES link (link_id), 
+	FOREIGN KEY(ref_node_id) REFERENCES node (node_id)
 )

usage/database/movement.sql

@@ -16,7 +16,7 @@ CREATE TABLE IF NOT EXISTS movement (
 	allowed_uses TEXT, 
 	geometry TEXT, 
 	PRIMARY KEY (mvmt_id), 
+	FOREIGN KEY(ob_link_id) REFERENCES link (link_id), 
 	FOREIGN KEY(node_id) REFERENCES node (node_id), 
-	FOREIGN KEY(ib_link_id) REFERENCES link (link_id), 
-	FOREIGN KEY(ob_link_id) REFERENCES link (link_id)
+	FOREIGN KEY(ib_link_id) REFERENCES link (link_id)
 )

usage/database/node.sql

@@ -9,6 +9,6 @@ CREATE TABLE IF NOT EXISTS node (
 	zone_id TEXT, 
 	parent_node_id TEXT, 
 	PRIMARY KEY (node_id), 
-	FOREIGN KEY(parent_node_id) REFERENCES node (node_id), 
-	FOREIGN KEY(zone_id) REFERENCES zone (zone_id)
+	FOREIGN KEY(zone_id) REFERENCES zone (zone_id), 
+	FOREIGN KEY(parent_node_id) REFERENCES node (node_id)
 )

usage/database/segment.sql

@@ -4,9 +4,9 @@ CREATE TABLE IF NOT EXISTS segment (
 	ref_node_id TEXT NOT NULL, 
 	start_lr FLOAT NOT NULL CHECK (start_lr >= 0), 
 	end_lr FLOAT NOT NULL CHECK (end_lr >= 0), 
-	grade FLOAT CHECK (grade >= -100) CHECK (grade <= 100), 
+	grade FLOAT CHECK (grade <= 100) CHECK (grade >= -100), 
 	capacity FLOAT CHECK (capacity >= 0), 
-	free_speed FLOAT CHECK (free_speed <= 200) CHECK (free_speed >= 0), 
+	free_speed FLOAT CHECK (free_speed >= 0) CHECK (free_speed <= 200), 
 	lanes INTEGER, 
 	l_lanes_added INTEGER, 
 	r_lanes_added INTEGER, 
@@ -18,6 +18,6 @@ CREATE TABLE IF NOT EXISTS segment (
 	jurisdiction TEXT, 
 	row_width FLOAT CHECK (row_width >= 0), 
 	PRIMARY KEY (segment_id), 
-	FOREIGN KEY(ref_node_id) REFERENCES node (node_id), 
-	FOREIGN KEY(link_id) REFERENCES link (link_id)
+	FOREIGN KEY(link_id) REFERENCES link (link_id), 
+	FOREIGN KEY(ref_node_id) REFERENCES node (node_id)
 )

usage/database/segment_lane.sql

@@ -1,7 +1,7 @@
 CREATE TABLE IF NOT EXISTS segment_lane (
 	segment_lane_id TEXT NOT NULL, 
 	segment_id TEXT NOT NULL, 
-	lane_num INTEGER NOT NULL CHECK (lane_num <= 10) CHECK (lane_num >= -10), 
+	lane_num INTEGER NOT NULL CHECK (lane_num >= -10) CHECK (lane_num <= 10), 
 	parent_lane_id TEXT, 
 	allowed_uses TEXT, 
 	r_barrier VARCHAR(10), 

usage/database/segment_lane_tod.sql

@@ -3,7 +3,7 @@ CREATE TABLE IF NOT EXISTS segment_lane_tod (
 	segment_lane_id TEXT NOT NULL, 
 	timeday_id TEXT, 
 	time_day TEXT, 
-	lane_num INTEGER NOT NULL CHECK (lane_num <= 10) CHECK (lane_num >= -10), 
+	lane_num INTEGER NOT NULL CHECK (lane_num >= -10) CHECK (lane_num <= 10), 
 	allowed_uses TEXT, 
 	r_barrier VARCHAR(10), 
 	l_barrier VARCHAR(10), 

usage/database/segment_tod.sql

@@ -4,7 +4,7 @@ CREATE TABLE IF NOT EXISTS segment_tod (
 	timeday_id TEXT, 
 	time_day TEXT, 
 	capacity FLOAT CHECK (capacity >= 0), 
-	free_speed FLOAT CHECK (free_speed <= 200) CHECK (free_speed >= 0), 
+	free_speed FLOAT CHECK (free_speed >= 0) CHECK (free_speed <= 200), 
 	lanes INTEGER, 
 	l_lanes_added INTEGER, 
 	r_lanes_added INTEGER, 

usage/database/signal_coordination.sql

@@ -3,11 +3,11 @@ CREATE TABLE IF NOT EXISTS signal_coordination (
 	timing_plan_id TEXT NOT NULL, 
 	controller_id TEXT NOT NULL, 
 	coord_contr_id TEXT, 
-	coord_phase INTEGER CHECK (coord_phase >= 0) CHECK (coord_phase <= 32), 
+	coord_phase INTEGER CHECK (coord_phase <= 32) CHECK (coord_phase >= 0), 
 	coord_ref_to VARCHAR(15), 
 	"offset" FLOAT CHECK ("offset" >= 0), 
 	PRIMARY KEY (coordination_id), 
-	FOREIGN KEY(controller_id) REFERENCES signal_controller (controller_id), 
+	FOREIGN KEY(coord_contr_id) REFERENCES signal_controller (controller_id), 
 	FOREIGN KEY(timing_plan_id) REFERENCES signal_timing_plan (timing_plan_id), 
-	FOREIGN KEY(coord_contr_id) REFERENCES signal_controller (controller_id)
+	FOREIGN KEY(controller_id) REFERENCES signal_controller (controller_id)
 )

usage/database/signal_phase_mvmt.sql

@@ -5,7 +5,7 @@ CREATE TABLE IF NOT EXISTS signal_phase_mvmt (
 	link_id TEXT, 
 	protection VARCHAR(9), 
 	PRIMARY KEY (signal_phase_mvmt_id), 
-	FOREIGN KEY(timing_phase_id) REFERENCES signal_timing_phase (timing_phase_id), 
 	FOREIGN KEY(link_id) REFERENCES link (link_id), 
-	FOREIGN KEY(mvmt_id) REFERENCES movement (mvmt_id)
+	FOREIGN KEY(mvmt_id) REFERENCES movement (mvmt_id), 
+	FOREIGN KEY(timing_phase_id) REFERENCES signal_timing_phase (timing_phase_id)
 )

usage/database/signal_timing_phase.sql

@@ -6,8 +6,8 @@ CREATE TABLE IF NOT EXISTS signal_timing_phase (
 	max_green FLOAT CHECK (max_green >= 0), 
 	extension FLOAT CHECK (extension >= 0) CHECK (extension <= 120), 
 	clearance FLOAT CHECK (clearance >= 0) CHECK (clearance <= 120), 
-	walk_time FLOAT CHECK (walk_time >= 0) CHECK (walk_time <= 120), 
-	ped_clearance FLOAT CHECK (ped_clearance <= 120) CHECK (ped_clearance >= 0), 
+	walk_time FLOAT CHECK (walk_time <= 120) CHECK (walk_time >= 0), 
+	ped_clearance FLOAT CHECK (ped_clearance >= 0) CHECK (ped_clearance <= 120), 
 	ring INTEGER NOT NULL CHECK (ring <= 12) CHECK (ring >= 0), 
 	barrier INTEGER NOT NULL CHECK (barrier <= 12) CHECK (barrier >= 0), 
 	position INTEGER NOT NULL, 

usage/database/signal_timing_plan.sql

@@ -5,6 +5,6 @@ CREATE TABLE IF NOT EXISTS signal_timing_plan (
 	time_day TEXT, 
 	cycle_length FLOAT CHECK (cycle_length <= 600) CHECK (cycle_length >= 0), 
 	PRIMARY KEY (timing_plan_id), 
-	FOREIGN KEY(controller_id) REFERENCES signal_controller (controller_id), 
-	FOREIGN KEY(timeday_id) REFERENCES time_set_definitions (timeday_id)
+	FOREIGN KEY(timeday_id) REFERENCES time_set_definitions (timeday_id), 
+	FOREIGN KEY(controller_id) REFERENCES signal_controller (controller_id)
 )