Skip to main content
The Crandic Automated Traffic System (CATS) is a JMRI-based application by Rodney Black for controlling and operating a model railroad. There's more information on the CATS website.
JMRI is a library, and CATS is a large, separately maintained application that uses the library. As such, CATS provides an important reference case for JMRI developers as they extend and adapt their code. CATS should continue to work for it's users, with a minimum of extraneous effort for the CATS developers, even as JMRI changes!
CATS development does not use a public code repository, and the code is not generally available while it's being developed. Rodney Black periodically makes releases available, including source code, as zip-file archives at the CATS website, see the download links at the bottom of the CATS license page.
As of early 2016, the current CATS distribution (2038) works with JMRI 4.0.1 through to the current (4.3) test versions. From this baseline, we want to keep CATS compiling during ongoing JMRI development. Changes that break CATS should be handled through deprecation, at least for one JMRI production release.
% ls java/src/
META-INF apps cats designer jmri
CATS doesn't have any unit tests, so there's nothing to go in the "test" source tree.
The Ant compilation rules will then compile CATS every time you compile JMRI itself. This will show you errors, deprecation warnings, etc.
To simplify JMRI repository work, the two CATS-related directories are ignored when doing repository operations.
Note that this does include the CATS source within the build, so any jar files you create will also include CATS. Don't use jar files from a build like this for JMRI-only purposes.
JMRI itself has lots of deprecation warnings, so if you want to see just the CATS ones:
Move the contents, including the startup scripts "cats.csh" (Linux, Mac OS X) and "cats.bat" (Windows) and other related files, into your top-level JMRI directory.
If you've compiled CATS locally, you don't need the cats.jar or designer.jar files.
Then just execute the appropriate "cats.csh" (Linux, Mac OS X) and "cats.bat" (Windows) script.