dk.dma.ais.tracker.eventEmittingTracker

Class EventEmittingTrackerImpl

java.lang.Object

dk.dma.ais.tracker.eventEmittingTracker.EventEmittingTrackerImpl

All Implemented Interfaces:

EventEmittingTracker, Tracker

@ThreadSafe
public class EventEmittingTrackerImpl
extends Object
implements EventEmittingTracker

EventEmittingTracker is a tracker which receives a (potentially never-ending) series of AisPackets. It uses these to maintain in-memory a complete state of the "situation" (e.g. positions, speeds, static information, and historic movements) of the targets it has detected.

The tracker will emit events to its subscribes when certain tracking related events occur. Examples of such events are cell changes (a target entered a new grid cell), position changes, track goes stale (has not been updated for a duration of time), heart beats (TimeEvents).

The heart beat mechanism is based on timestamps from the data stream and therefore quite unprecise. Significant slack must be expected.

Constructor Summary

Constructors

Constructor and Description
EventEmittingTrackerImpl(dk.dma.enav.model.geometry.grid.Grid grid) Initialize the tracker.
EventEmittingTrackerImpl(dk.dma.enav.model.geometry.grid.Grid grid, int... blackListedMmsis) Initialize the tracker.

Method Summary

Modifier and Type	Method and Description
Target	get(int mmsi) Returns the latest target info for the specified MMSI number.
int	getNumberOfTracks() Deprecated. Use #size() instead
Collection<Track>	getTracks()
void	listen(com.google.common.eventbus.DeadEvent event)
void	registerSubscriber(Object subscriber) Register subscriber.
int	size() Returns the number of targets that is being tracked.
void	update(AisPacket packet) Update the tracker with a single AisPacket.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface dk.dma.ais.tracker.Tracker

subscribeToPacketReader, subscribeToPacketStream

Constructor Detail

EventEmittingTrackerImpl

public EventEmittingTrackerImpl(dk.dma.enav.model.geometry.grid.Grid grid)

Initialize the tracker.

Parameters:

grid - the grid

EventEmittingTrackerImpl

public EventEmittingTrackerImpl(dk.dma.enav.model.geometry.grid.Grid grid,
                                int... blackListedMmsis)

Initialize the tracker.

Parameters:

grid - the grid

blackListedMmsis - the black listed mmsis

Method Detail

update

public void update(AisPacket packet)

Update the tracker with a single AisPacket.

Specified by:

update in interface Tracker

Parameters:

packet - the AIS packet.

get

public Target get(int mmsi)

Description copied from interface: Tracker

Returns the latest target info for the specified MMSI number.

Specified by:

get in interface Tracker

Parameters:

mmsi - the MMSI number

Returns:

the latest target info for the specified MMSI number

listen

public void listen(com.google.common.eventbus.DeadEvent event)

Parameters:

event - the event

registerSubscriber

public void registerSubscriber(Object subscriber)

Register subscriber.

Specified by:

registerSubscriber in interface EventEmittingTracker

Parameters:

subscriber - the subscriber

getTracks

public Collection<Track> getTracks()

Returns:

the tracks

size

public int size()

Returns the number of targets that is being tracked.

Specified by:

size in interface Tracker

Returns:

the number of targets that is being tracked

getNumberOfTracks

public int getNumberOfTracks()

Deprecated. Use #size() instead

Returns:

the number of tracks