PerceivableContext (Open Traffic Sim core classes 1.04.04 API)

All Superinterfaces:

Definitions, Identifiable

All Known Implementing Classes:

ExpansionNetwork, OTSNetwork
```
public interface PerceivableContext
extends Definitions, Identifiable
```
The Model package guarantees that objects that are used in an OTS study such as GTUs are retrievable. In a spatial model, for instance, objects need to be able to find each other. The model interface guarantees access to a number of important objects in the study.
Copyright (c) 2013-2020 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.
$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Dec 10, 2015

Author:

Alexander Verbraeck, Peter Knoppers

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`void`	`addGTU(GTU gtu)`	Add a GTU to the network.
`boolean`	`containsGTU(GTU gtu)`	Test whether a GTU is registered in the network.
`boolean`	`containsGtuId(String gtuId)`	Test whether a GTU ID is registered in the network.
`GTU`	`getGTU(String gtuId)`	Get a GTU in the model.
`Set<GTU>`	`getGTUs()`	Get an overview of the GTUs in the model.
`String`	`getId()`	Get a descriptive Id of the perceivable context (e.g., useful for debugging purposes).
`void`	`removeGTU(GTU gtu)`	Remove a GTU from the network.

Methods inherited from interface org.opentrafficsim.core.definitions.Definitions
addDefaultGtuTypes, addDefaultLinkTypes, addGtuType, addLinkType, getGtuType, getGtuType, getGtuTypes, getLinkType, getLinkType, getLinkTypes

- Method Detail
  - getId
```
String getId()
```
    Get a descriptive Id of the perceivable context (e.g., useful for debugging purposes).
    
    Specified by:
    
    getId in interface Identifiable
    
    Returns:
    
    the id of the context
  - getGTUs
```
Set<GTU> getGTUs()
```
    Get an overview of the GTUs in the model. The set returned is a defensive copy.
    
    Returns:
    
    a set of GTUs as registered in the current model.
  - getGTU
```
GTU getGTU(String gtuId)
```
    Get a GTU in the model.
    
    Parameters:
    
    gtuId - String; the id of the GTU
    
    Returns:
    
    a GTU as registered in the current model, or null when the id could not be found.
  - addGTU
```
void addGTU(GTU gtu)
```
    Add a GTU to the network.
    
    Parameters:
    
    gtu - GTU; the GTU to add
  - removeGTU
```
void removeGTU(GTU gtu)
```
    Remove a GTU from the network.
    
    Parameters:
    
    gtu - GTU; the GTU to remove
  - containsGTU
```
boolean containsGTU(GTU gtu)
```
    Test whether a GTU is registered in the network.
    
    Parameters:
    
    gtu - GTU; the GTU to search for
    
    Returns:
    
    whether the network contains this GTU
  - containsGtuId
```
boolean containsGtuId(String gtuId)
```
    Test whether a GTU ID is registered in the network.
    
    Parameters:
    
    gtuId - String; the GTU ID to search for
    
    Returns:
    
    whether the network contains a GTU with this ID