Output Agent - putOnLocalMap

Note: This output agent is not part of the standard iPAM configuration.  It is intended for demonstration only.  The file SpatialXMap.jar must be in your Java classpath. You must also have a copy of ofx.spatialx.jar in your classpath. ofx.spatialx.jar contains the map drawing classes and is part of the Object/FX mapping product, SpatialX. See http://www.objectfx.com/. Thanks to Object/FX for their assistance in this demonstration.

Description

Tracks are real-time reports of things that have a position in, on, or above the earth. This output agent displays a simple icon on a map to represent the track. The position for each track can be updated when newer reports with the same id are delivered.

Map drawing functions are provided by SpatialX, a product of Object/FX company. See http://www.objectfx.com/.

Configuration Variables

autoDisposeWindow
Defaults to true.  Indicates that the mapping window should be automatically disposed when the instance of the agent is disposed of by iPAM.
mapWindowName
Optional parameter that provides a title for the map window.

Product

The agent accepts products that have latitude and longitude attributes. The following attributes and values are recognized (character case is important for the attribute names):
latitude
A floating point number in degrees. The equator is zero.  North is positive.
longitude
A floating point number in degrees. The prime meridian is zero. West is negative.
itemIdentifier
channelNumber
trackIdentifier
trackId
These four attribute names are used interchangeably as the unique identifier for a position report.  The first report with a given identifier will cause a point to be created on the screen.  Subsequent points with the same id will cause the point on the map display to "move."
category
Values can be: "ground", "air", "surface", "subsurface", "space"
The value of this attribute helps determine the type of icon placed on the map for this report.
friendOrFoe
Values can be: "friend", "foe", "other"
The value of this attribute helps determine the color of the icon.
course
heading
A floating point number in degrees indicating the direction that the object is moving. Follows the compass rose convention (North is zero).
lifeTimeLong
Lifetime of the track (in seconds) from the time it was created.  Tracks that expire will automatically be removed from the map.  Note that iPAMs default lifetime (iPAM 2.3) is 3 days.
modificationDate
A standard iPAM product attribute that identifies when the product was created.  This attribute is in standard Java millisecond-based time.

How it Works

This output agent accepts either basic products or vector products.  If a vector product is input each of its contents are scanned individually.

Sample Map Window
Revised: 27 August 1999