<><><><><><><><><><><><><><><><><><><><><><><><><><><><>

GPSBreakfast

GPS-Based Travel Time Data Analyzer

Release 1

<><><><><><><><><><><><><><><><><><><><><><><><><><><><>


    Installation

(this requires Windows 2000 or later)

Copy bagel.exe into a new folder.  The Bagel library
  will remain installed, so give it a more permanent place
  than a new folder on your desktop.
Run bagel.exe and follow the instructions.
After the bagel library is installed,

Run gpsbinstall.exe

It has a dependencies page that will detect if any
of the dependencies need to be installed.  These
are provided with this copy of GPSBreakfast, or you
may use a newer version from the Internet.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><>


    How to export from TMMS Mapping Software

GPSBreakfast works off of databases exported from TMMS
Mapping Software.  The TMMS must be used in a specific way
to get the intersection names to appear in the database
it exports, the way that GPSBreakfast requires:

(These instructions were tested on TMMS v 3.0)

Insert the module containing collected data.
Start TMMS.
Menu Module -> View Module Information.
Uncheck Save to Database, Check View Module, Uncheck Clear Module.
Press Execute.
This step takes a while for databases with over 1000 records.
After TMMS is done reading module records, press Save To Database
  on the View Module window.
Choose "yes" to enter a name for the database.  This is the name
  that will appear as a heading for the runs graphed with GPS2.
If it says that most of the data consisted of "duplicate records",
  then you must clear the database first:
    Menu Database -> Delete records
Now export the TMMS database to an Access database:
Menu Database -> Import/Export Records
Press Export Records.
It will create a .mdb Access database file for you.
TMMS can now be closed.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><>


    How to import a database into GPSBreakfast

Start GPSBreakfast.

When you first start GPSBreakfast, it will load the
MATLAB component, which might take a few seconds.  Then
it drops you at the Database selection page.  Here you
must browse for an Access database which was created
by TMMS. Follow the instructions on that page and
press Graph It when finished.

If the database is being read for the first time,
GPSBreakfast will -delete- data from the database
that doesn't satisfy the following criterion:

(1) Records must be part of a Run consisting of
    at least 5 records.  To be considered part of
    a Run, the timestamp on the record must be
    within 2 minutes of the previous or next one.

So note, this means that if the GPS device is disabled
for 2 minutes in the field, a new Run is created.

(2) T-type Records are erased from the database.

The importer will also number the Runs in the
MainRecordID column using consecutive numbers
starting from 1.

You may add new records to the Access database by just
appending more records to the end or however you like.
Next time GPSBreakfast imports the database it will
re-assign the run numbers and filter out bad data.

The importing only needs to be done once, and doesn't
take very long.  Be aware that it does modify the
database that you give to it.

<><><><><><><><><><><><><><><><><><><><><><><><><><><><>


    Author contact info

Please do not hesitate to contact us if there are
problems using the software.

Chris Taylor
cat02e@fsu.edu
(818) 497-1784
programmer: VB.NET UI

Khue Ngo
khuengo@eng.fsu.edu
programmer: MATLAB graphing library