com.luciad.realtime

LuciadLightspeedClass ALcdTimeIndexedSimulatorModel

java.lang.Object

com.luciad.realtime.ALcdSimulatorModel

com.luciad.realtime.ALcdTimeIndexedSimulatorModel

All Implemented Interfaces:

ILcdSimulatorModel, ILcdPropertyChangeSource

public abstract class ALcdTimeIndexedSimulatorModel
extends ALcdSimulatorModel

Implementation of ILcdSimulatorModel whose time complexity for changing the date is generally related to the amount of changes that are required, not to the total amount of data. This offers high performance, even when working with large data sets.

It achieves this by indexing the begin and end times of all objects, so it does require some initial processing.

It keeps a given track model up to date by adding tracks to it, or by removing tracks from it, such that every track is part of the model if the current date lies within the interval [getBeginTime(track), getEndTime(track)]. Subclasses are responsible to update the track state (e.g. location) when the date is in that interval, by implementing the updateTrackForDateSFCT method.

Two methods are available to modify the data after the initial processing step (init(com.luciad.model.ILcdModel, java.util.Collection)). By using the method addTracks(java.util.Set<?>, int), extra tracks can be added to the simulator model. If necessary, when the current time is between the begin and end time of a new track, these tracks will also be added to the track model. By using the method removeTracks(java.util.Set<?>, int), tracks can be removed from the simulator model, and also from the track model if they are currently present there.

This implementation only supports one track model at a time. If multiple track models must be updated, one can for example combine them using a TLcdSimulatorModelList.

Since:

7.2

See Also:

init(com.luciad.model.ILcdModel, java.util.Collection), getBeginTime(Object), getEndTime(Object), updateTrackForDateSFCT(com.luciad.model.ILcdModel, Object, java.util.Date)

Constructor Summary

Constructors

Constructor and Description
ALcdTimeIndexedSimulatorModel() Creates a new ALcdTimeIndexedSimulatorModel.

Method Summary

Modifier and Type	Method and Description
void	addTracks(Set<?> aTracks, int aFireEventMode) Adds the given set of tracks to the simulation model.
protected abstract long	getBeginTime(Object aTrack) Retrieves the time the given track should start its simulation, for example the departure time of an airplane.
protected abstract long	getEndTime(Object aTrack) Retrieves the time the given track should end its simulation, for example the arrival time of an airplane.
protected void	init(ILcdModel aEmptyTrackModel, Collection aTracks) Initializes this simulator model with the given tracks and track model.
void	removeTracks(Set<?> aTracks, int aFireEventMode) Removes the given set of tracks from the simulation model.
protected abstract boolean	updateTrackForDateSFCT(ILcdModel aTrackModel, Object aTrackSFCT, Date aDate) Updates the given track for the given date.
protected void	updateTrackModels(Date aOldDate, Date aNewDate) Updates the track models of this ALcdSimulatorModel to the given new Date.

Methods inherited from class com.luciad.realtime.ALcdSimulatorModel

addPropertyChangeListener, firePropertyChangeEvent, getBeginDate, getDate, getEndDate, getTrackModels, removePropertyChangeListener, setBeginDate, setDate, setEndDate, setTrackModels

Methods inherited from class java.lang.Object

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

Constructor Detail

ALcdTimeIndexedSimulatorModel

public ALcdTimeIndexedSimulatorModel()

Creates a new ALcdTimeIndexedSimulatorModel. One must call init before this instance is useful.

See Also:

init(com.luciad.model.ILcdModel, Collection)

Method Detail

init

protected void init(ILcdModel aEmptyTrackModel,
                    Collection aTracks)

Initializes this simulator model with the given tracks and track model.

Note that this method can be called multiple times, for example when the begin/end times of the tracks have changed, or when new tracks were added etc.

Parameters:

aEmptyTrackModel - The track model. It should not contain any elements as the objects in aTracks are added to and removed from this model according to the current date of this simulator model.

aTracks - The track objects. Subclasses must implement the getBeginTime, getEndTime and updateTrackForDateSFCT methods for these track objects.

See Also:

getBeginTime(Object), getEndTime(Object), updateTrackForDateSFCT(com.luciad.model.ILcdModel, Object, java.util.Date)

addTracks

public void addTracks(Set<?> aTracks,
                      int aFireEventMode)

Adds the given set of tracks to the simulation model.

Parameters:

aTracks - the tracks to add

aFireEventMode - the model fire event mode. This will be used when tracks are added to the actual track ILcdModel.

removeTracks

public void removeTracks(Set<?> aTracks,
                         int aFireEventMode)

Removes the given set of tracks from the simulation model.

Parameters:

aTracks - the tracks to remove

aFireEventMode - the model fire event mode. This will be used when tracks are removed from the actual track ILcdModel.

getBeginTime

protected abstract long getBeginTime(Object aTrack)

Retrieves the time the given track should start its simulation, for example the departure time of an airplane. The track will be part of the track model if the current date lies within in the interval [getBeginTime(track), getEndTime(track)].

This method called is always called on the AWT Event Dispatch Thread.

Note that subsequent calls must yield equal return values for the same track. This method must be fast, as it can be called often.

Parameters:

aTrack - The track to retrieve the begin time for.

Returns:

The begin time of the track, as defined in Date.getTime().

getEndTime

protected abstract long getEndTime(Object aTrack)

Retrieves the time the given track should end its simulation, for example the arrival time of an airplane. The track will be part of the track model if the current date lies within in the interval [getBeginTime(track), getEndTime(track)].

This method called is always called on the AWT Event Dispatch Thread.

Note that subsequent calls must yield equal return values for the same track. This method must be fast, as it can be called often.

Parameters:

aTrack - The track to retrieve the end time for.

Returns:

The end time of the track, as defined in Date.getTime().

updateTrackForDateSFCT

protected abstract boolean updateTrackForDateSFCT(ILcdModel aTrackModel,
                                                  Object aTrackSFCT,
                                                  Date aDate)

Updates the given track for the given date. Note that the implementation of this method should not bother about calling elementChanged on the model, it should simply return true when the track is changed, false otherwise.

Parameters:

aTrackModel - The track model, passed as contextual information.

aTrackSFCT - The track to update.

aDate - The date to update the track to.

Returns:

True if the track was adapted, false if the track was not adapted.

updateTrackModels

protected void updateTrackModels(Date aOldDate,
                                 Date aNewDate)

Description copied from class: ALcdSimulatorModel

Updates the track models of this ALcdSimulatorModel to the given new Date. This method is called by setDate.

Specified by:

updateTrackModels in class ALcdSimulatorModel

Parameters:

aOldDate - The old date, given as contextual information.

aNewDate - The date to update the track models of this ALcdSimulatorModel to.