Skip to main content

Adding/Editing Transits

Adding a new Transit

 To add a new Transit, follow this procedure:

  1. Click Transits in the Tables submenu of the Tools menu to bring up the Transit Table, and click the Add... button at the bottom of the table to bring up the Add/Edit Transit window.

  2. Enter a System Name, according to the JMRI convention. Since Transits are internal objects, the first letter should be "I" (for internal). The second letter should be "Z" to indicate a Transit. This is usually followed by a number, but the program will accept any numeric or alphabetic characters. The system name must be different from the System Name of other Transits. JMRI will force all alphabetic characters in the System Name to upper case.

  3. Enter a User Name. Any string of characters that is different from the User Name of other Transits will be accepted, but it's wise to use a string that describes the intended use of the Transit.

  4. Next add Sections to the Transit. Every Transit must have at least two Sections, but most will have many more. Two "Primary" Sections are needed to define the direction of the Transit. Sections must be connected,and must be entered in order. Select the Section you would like to begin the Transit in the upper popup menu. At any point during Section addition, this popup menu lists only those Sections that are eligible for addition. Click Add Next Section to add the first Section of the Transit.

  5. Add more Sections and alternates in the same manner. Select the Section to be added in the popup menu, and click Add Next Section. If at any time you decide you want to start over, click Delete All Sections to clear the table of Sections, and return to step 4 above.

    Immediately after entering a Section, if you would like to add an Alternate Section to the one just entered, select an alternate Section from the lower popup menu. If there are no possibly valid alternate Sections, the lower popup menu will be empty. Often the lower popup menu will contain possible alternate Sections that are not really alternates to the primary Section. For a listed alternate Section to be a valid alternate Section, it must connect to the next primary Section. It is your responsibility to determine whether a Section listed in the lower popup menu is a valid alternate Section. For more information on alternate Sections and their use, refer to the Transit Table help file.

  6. If you will be using this Transit to run an automatic train, click the View/Add/Edit Actions button to set up any Action needed when a train is in the specified Section. You can add Actions now, or you can edit this Transit at a later time to set up Actions. More information is provided in the View Actions help file.

  7. Click the Create button at the bottom of the window. If everything is fine, the window will close and a new Transit will appear in the Transit Table. If there is trouble with anything, a message will be displayed indicating the error and what you should do to fix it. Correct the error and click Create again.

Note: The Direction and Alternate columns in the Add/Edit Transit table are for information only. They are set automatically as you build the Transit. The Direction column indicates the direction of travel through the Section, and the Alternate column indicates whether the Section is the primary Section for this sequence number or an alternate Section.

Editing an existing Transit

To edit an existing Transit, follow this procedure:

  1. Click a Transit's Edit button in the Transit Table to bring up the Add/Edit Transit window. The window will be the same as that shown above, except the System Name will be fixed, and the Create button will be replaced with an Update Button.

  2. Make whatever changes or additions you need to the information in the window. Note that the System Name of the edited Transit may not be changed, but the User Name may be changed. Items that may be edited are described above in steps 3 through 6 in the procedure for adding a new Transit.

  3. After making changes to the Transit information, click Update to change the selected Transit. If everything is fine, the window will close. If there is any trouble, a message will be displayed indicating the error and what you should do to fix it. Correct the error and click Update again.

  4. Click Cancel to exit without changing the selected Transit. If the Add/Edit Transit window is dismissed (closed) while editing, Cancel is automatically selected, and no changes are made to the selected Transit.