aboutsummaryrefslogtreecommitdiff
path: root/GLOSSARY.org
diff options
context:
space:
mode:
Diffstat (limited to 'GLOSSARY.org')
-rw-r--r--GLOSSARY.org13
1 files changed, 8 insertions, 5 deletions
diff --git a/GLOSSARY.org b/GLOSSARY.org
index 3334c29..38cda75 100644
--- a/GLOSSARY.org
+++ b/GLOSSARY.org
@@ -2,8 +2,8 @@
This is meant to give a rough overview of (train-related) terms used in this
code; both for others as a reference and for me so I can remember to use them
-in a (somewhat) consistent way, since they are somewhat arbitrary (though I've
-tried to stick close to the terminology used in GTFS).
+in a (somewhat) consistent way, since they are somewhat arbitrary. I've tried
+to remain at least broadly close to the terminology used by GTFS.
* Terms
** (Calendar-)Date / Day
@@ -11,8 +11,11 @@ A single, unique day (e.g. 1970-01-01). Usually used to indicate if a /trip/
is running on that day or not.
** Time (of Day)
-Time on a given day, given in minutes since midnight. Trips going across
-midnight simply count minutes up from the previous day.
+Time on a given day, given in seconds (though often displayed as minutes)
+since midnight. If a trip crosses midnight it is treated as if it took place
+entirely on the previous day, and times simply count up beyond the total
+number of seconds in a day (note that that's a timezone-series dependent
+number).
** Trip (don't confuse with Train)
Used as in GTFS: a trip is a defined sequence of /stops/, referred to by a
@@ -22,7 +25,7 @@ Always has an associated /shape/.
(might match your intuition for "train line")
** Stop
-A /station/ with associated arrival/departure /time/
+A /station/ with associated arrival/departure /time/.
** Station
A train station. Tracktrain refers to each by an ID, and hopefully knows