This is the home
page for the Computer Automated Traffic System (CATS), a suite of open
source programs that provide signal logic on a model railroad. To
download the software, scroll down on this page to the Code section.
Click on the software link and read the license. Then scroll to the
bottom of that page for links to the software, collected into zip
The release zip file should be placed in the same folder as JMRI.
It contains user documentation.
The impetus for this software was to implement CTC signaling on Pat
Lana's Cedar River and Iowa Central Railway (not affiliated with the
Cedar Rapids and Iowa City Railway in any way). Pat's Crandic is an N
scale model railroad, a bridge route between Kansas City and the
mythical town of Pammelia, Iowa, with connections to Minneapolis/St.
Paul and Chicago. Though the date is August, 1968, the railroad
mangement has invested in a futuristic computer system using CRTs for
dispatching traffic on the railroad. This program is the result of that
Video of the Cedar River and Iowa Central, its CEO, and crew can be
Dan's video page.
A high speed
Internet connection is needed because some of these are large. They are
viewed through Quicktime, a free plugin from Apple Computer.
What is CATS?
CATS is open source
software, written in Java and built on the work of the JMRI programmers
(JMRI home page).
CATS is a JMRI
application and not part of the JMRI toolset, so JMRI (and a Java
Runtime Environment) are needed to run CATS.
looking, "point and click" dispatcher panel
is a suite
of programs, including a GUI editor for creating the panel
full interlocking of routes
complex interlocking plants through a graphical description
ABS, APB, DTC, and CTC signal disciplines
developed by a model railroader interested in operations for model
railroaders, so assists in the paperwork of an operating session
labels follow block occupancy reports
menus for trains, crews, and jobs can be customized
crew callboard and records assignments
crew hours on the job
train movements, with timestamps
so can work with many different kinds of model railroad control systems
full connectivity (signals, occupancy, turnout feedback) to a layout
works as a
"magnet board" (no connection to the layout)
partial connection to the layout
in Java, so runs on many kinds of computers
user defined aspects for indications based on 2 block/4 speed signaling
screen capture is from the program used to create a dispatcher panel.
The next screen
capture is the Crandic dispatcher panel in operation.
One more screen
capture shows the train lineup pulldown.
Train Status Client
A third member in the CATS suite of programs for supporting operations
is a Train Status Client (TrainStat). It summarizes the information
on the operating session trains in a tabular form, for use by yard
masters or traffic managers. It is a separate Java application, run on
the computer running CATS or networked computers.
with Java 1.5.0-22 and 1.6.0-20)
Release2007 works with
JMRI 2.x through 2.5.3. Release2008 (and later) work with JMRI 2.5.4 through 2.7.6.
Release2013 works with JMRI 2.5.4 through 2.8. Release 2022 works with JMRI 2.10. Release2035 works with JMRI 2.12.
Release2036 works with JMRI 3.0. Release2037 works with JMRI 3.3.1
Except under special circumstances. CATS will be tied to JMRI production releases - not JMRI development releases.
To get started using CATS, download the release zip file into a folder containing JMRI and unzip it. The distribution
contains Word documents on how to install and use CATS.
Each of the programs has a user manual/guide. The manuals for designer and CATS are included the release20xx zip file. The manual for
TrainStat is included in the TrainStat zip file.
Important Note to Current
CATS 2.15 (Release2007) is compatible
with JMRI versions 2.0-2.5.3. It is not compatible with older versions
JMRI or with version 2.5.4 or later. CATS 2.21 (Release2013) is compatible with JMRI
versions 2.5.4 and up to 2.8. CATS 2.31 (Release2022) is compatible with JMRI 2.10 to 2.12.
CATS 2.32 (Release2035) is compatible with JMRI 2.12 and up to 2.14.1. CATS 2.33 (Release2036) is compatible
with JMRI 3.0. CATS 2.34 (Release2037) is compatible with JMRI 3.3.1 thru 3.8.
I have received reports that CATS
under MacOS Snow Leopard does not launch from the desktop, but does from a command window. This problem is under investigation
(but I do not have access to a system running Snow Leopard).
The focus of this release is on CATS. The highlights of the changes for Release2037
Adapted to JMRI 3.3.1. A change was made in finding configuration managers
that broke CATS. Users who have CATS automatically load a JMRI panel at startup are affected. No one else will
notice the breakage.
Layout files generated by previous releases are compatible with this release.
To download the latest
software, you will need to scroll to the bottom of the license to find
the links to the software.
I am sharing these
programs for the enjoyment of the model railroading community. If you
find them useful, then great. However, I know they are not perfect -
there are over 30,000 lines of Java code in each. There are more things
I would like them to do, as well. But, I am the only person supporting
the programs, the documents, and this web site and this is not my day
job. So, I welcome bug reports and enhancement suggestions, but will
get to them when time permits.
I have to thank Pat
Lana for being the test bed for this code. His Cedar River and Iowa
Central is large enough and has enough variety to give this a good
workout. I also thank my core beta testers -
Faulkner's CSXT Shenandoah Division, andJohn
Parker's BNSF Fall River Division
, for their
suggestions and patience working through the "features". Bob Jacobson,
Paul Bender, Dick Bronson, and the rest of the JMRI developers merit
special recognition because they provide the glue between the
dispatcher panel and the layout.
The phrase "JMRI"
belongs to the JMRI development organization. "Java" is a registered
trademark of Sun Microsystems (now Oracle).