Package jmri

Interface Transit

All Superinterfaces:
Comparable<NamedBean>, NamedBean, PropertyChangeProvider
All Known Implementing Classes:
DefaultTransit
public interface Transit extends NamedBean
A Transit is a group of Sections representing a specified path through a layout.

A Transit may have the following states:

IDLE
available for assignment to a train
ASSIGNED
linked to a train in an ActiveTrain

When assigned to a Transit, options may be set for the assigned Section. The Section and its options are kept in a TransitSection object.

To accommodate passing sidings and other track features, there may be multiple Sections connecting two other Sections in a Transit. If so, one Section is assigned as primary, and the other connecting Sections are assigned as alternates.

A Section may be in a Transit more than once, for example if a train is to make two or more loops around a layout before going elsewhere.

A Transit is normally traversed in the forward direction, that is, the direction of increasing Section Numbers. When a Transit traversal is started up, it is always started in the forward direction. However, to accommodate point-to-point (back and forth) route designs, the direction of travel in a Transit may be "reversed". While the Transit direction is "reversed", the direction of travel is the direction of decreasing Section numbers. Whether a Transit is in the "reversed" direction is kept in the ActiveTrain using the Transit.

  • Field Details

  • Method Details

    • setState

      void setState(int state)
      Set the state of this Transit.
      Specified by:
      setState in interface NamedBean
      Parameters:
      state - IDLE or ASSIGNED

    • addTransitSection

      void addTransitSection(TransitSection s)
      Add a Section to this Transit.
      Parameters:
      s - the Section object to add

    • getTransitSectionList

      ArrayList<TransitSection> getTransitSectionList()
      Get the list of TransitSections.
      Returns:
      a copy of the internal list of TransitSections or an empty list

    • getMaxSequence

      int getMaxSequence()
      Get the maximum sequence number used in this Transit.
      Returns:
      the maximum sequence

    • removeAllSections

      void removeAllSections()
      Remove all TransitSections in this Transit.

    • containsSection

      boolean containsSection(Section s)
      Check if a Section is in this Transit.
      Parameters:
      s - the section to check for
      Returns:
      true if the section is present; false otherwise

    • getSectionListBySeq

      ArrayList<Section> getSectionListBySeq(int seq)
      Get a List of Sections with a given sequence number.
      Parameters:
      seq - the sequence number
      Returns:
      the list of of matching sections or an empty list if none

    • getTransitSectionListBySeq

      ArrayList<TransitSection> getTransitSectionListBySeq(int seq)
      Get a List of TransitSections with a given sequence number.
      Parameters:
      seq - the sequence number
      Returns:
      the list of of matching sections or an empty list if none

    • getSeqListBySection

      ArrayList<Integer> getSeqListBySection(Section s)
      Get a List of sequence numbers for a given Section.
      Parameters:
      s - the section to match
      Returns:
      the list of matching sequence numbers or an empty list if none

    • containsBlock

      boolean containsBlock(Block block)
      Check if a Block is in this Transit.
      Parameters:
      block - the block to check for
      Returns:
      true if block is present; false otherwise

    • getBlockCount

      int getBlockCount(Block block)
      Get the number of times a Block is in this Transit.
      Parameters:
      block - the block to check for
      Returns:
      the number of times block is present; 0 if block is not present

    • getSectionFromBlockAndSeq

      Section getSectionFromBlockAndSeq(Block b, int seq)
      Get a Section from one of its Blocks and its sequence number.
      Parameters:
      b - the block within the Section
      seq - the sequence number of the Section
      Returns:
      the Section or null if no matching Section is present

    • getSectionFromConnectedBlockAndSeq

      Section getSectionFromConnectedBlockAndSeq(Block b, int seq)
      Get Section from one of its EntryPoint Blocks and its sequence number.
      Parameters:
      b - the connecting block to the Section
      seq - the sequence number of the Section
      Returns:
      the Section or null if no matching Section is present

    • getDirectionFromSectionAndSeq

      int getDirectionFromSectionAndSeq(Section s, int seq)
      Get the direction of a Section in the transit from its sequence number.
      Parameters:
      s - the Section to check
      seq - the sequence number of the Section
      Returns:
      the direction of the Section (one of Section.FORWARD or Section.REVERSE or zero if s and seq are not in a TransitSection together

    • getTransitSectionFromSectionAndSeq

      TransitSection getTransitSectionFromSectionAndSeq(Section s, int seq)
      Get a TransitSection in the transit from its Section and sequence number.
      Parameters:
      s - the Section to check
      seq - the sequence number of the Section
      Returns:
      the transit section or null if not found

    • getInternalBlocksList

      ArrayList<Block> getInternalBlocksList()
      Get a list of all blocks internal to this Transit. Since Sections may be present more than once, blocks may be listed more than once. The sequence numbers of the Section the Block was found in are accumulated in a parallel list, which can be accessed by immediately calling getBlockSeqList().
      Returns:
      the list of all Blocks or an empty list if none are present

    • getBlockSeqList

      ArrayList<Integer> getBlockSeqList()
      Get a list of sequence numbers in this Transit. This list is generated by calling getInternalBlocksList() or getEntryBlocksList().
      Returns:
      the list of all sequence numbers or an empty list if no Blocks are present

    • getEntryBlocksList

      ArrayList<Block> getEntryBlocksList()
      Get a list of all entry Blocks to this Transit. These are Blocks that a Train might enter from and be going in the direction of this Transit. The sequence numbers of the Section the Block will enter are accumulated in a parallel list, which can be accessed by immediately calling getBlockSeqList().
      Returns:
      the list of all blocks or an empty list if none are present

    • getDestinationBlocksList

      ArrayList<Block> getDestinationBlocksList(Block startBlock, boolean startInTransit)
      Get a list of all destination blocks that can be reached from a specified starting block. The sequence numbers of the Sections destination blocks were found in are accumulated in a parallel list, which can be accessed by immediately calling getDestBlocksSeqList().

      Note: A Train may not terminate in the same Section in which it starts.

      Note: A Train must terminate in a Block within the Transit.

      Parameters:
      startBlock - the starting Block to find destinations for
      startInTransit - true if startBlock is within this Transit; false otherwise
      Returns:
      a list of destination Blocks or an empty list if none exist

    • getDestBlocksSeqList

      ArrayList<Integer> getDestBlocksSeqList()
      Get a list of destination Block sequence numbers in this Transit. This list is generated by calling getDestinationBlocksList(jmri.Block, boolean).
      Returns:
      the list of all destination Block sequence numbers or an empty list if no destination Blocks are present

    • canBeResetWhenDone

      boolean canBeResetWhenDone()
      Check if this Transit is capable of continuous running.

      A Transit is capable of continuous running if, after an Active Train completes the Transit, it can automatically be restarted. To be restartable, the first Section and the last Section must be the same Section, and the first and last Sections must be defined to run in the same direction. If the last Section is an alternate Section, the previous Section is tested. However, if the Active Train does not complete its Transit in the same Section it started in, the restart will not take place.

      Returns:
      true if continuous running is possible; otherwise false

    • initializeBlockingSensors

      int initializeBlockingSensors()
      Initialize blocking sensors for Sections in this Transit. This should be done before any Sections are allocated for this Transit. Only Sections that are Section.FREE are initialized, so as not to interfere with running active trains. If any Section does not have blocking sensors, warning messages are logged.
      Returns:
      0 if no errors, number of errors otherwise.

    • removeTemporarySections

      void removeTemporarySections()

    • removeLastTemporarySection

      boolean removeLastTemporarySection(Section s)

    • setTransitType

      void setTransitType(Transit.TransitType type)
      Set transit Type.
      • USERDEFINED - Default Save all the information.
      • DYNAMICADHOC - Created on an as required basis, not to be saved.
      Parameters:
      type - constant of transit type.

    • getTransitType

      Transit.TransitType getTransitType()
      Get Transit Type. Defaults to USERDEFINED.
      Returns:
      constant of section type.