prajna.geo

Class RandomGeoFeed

java.lang.Object

java.lang.Thread

prajna.geoviz.GeoEventGenerator

prajna.geo.RandomGeoFeed

All Implemented Interfaces:

java.lang.Runnable

public class RandomGeoFeed
extends GeoEventGenerator

This class is a thread which can generate a series of random geographic events. The events are generated as single-time events, with no data attached. Different distributions and types of events are generated depending upon the constructor used.

Author:

Edward Swing

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
RandomGeoFeed() Constructor for a RandomGeoFeed which creates events that are distributed across the northern and eastern hemisphere.
RandomGeoFeed(java.util.Collection<java.lang.String> placeNames) Constructor for a RandomGeoFeed which creates events randomly from a list of place names.
RandomGeoFeed(GeoCoord center, double radius) Constructor for a RandomGeoFeed which creates events that are distributed radially around a center point, up to a certain distance away.
RandomGeoFeed(GeoFilter filter) Create a RandomGeoFeed from a Geographic Filter.

Method Summary

Methods

Modifier and Type	Method and Description
static void	main(java.lang.String[] args) Run a random GeoEvent generator.
void	run() Run method for the RandomGeoFeed.
void	setMaxSleep(int sleepSeconds) Set the maximum time to sleep between generating random events.

Methods inherited from class prajna.geoviz.GeoEventGenerator

addGeoListener, fireGeoEvent, removeGeoListener

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomGeoFeed

public RandomGeoFeed()

Constructor for a RandomGeoFeed which creates events that are distributed across the northern and eastern hemisphere. Point events are generated from 0N 0E to 85N 180E.

RandomGeoFeed

public RandomGeoFeed(java.util.Collection<java.lang.String> placeNames)

Constructor for a RandomGeoFeed which creates events randomly from a list of place names.

Parameters:

placeNames - The collection of place names.

RandomGeoFeed

public RandomGeoFeed(GeoCoord center,
             double radius)

Constructor for a RandomGeoFeed which creates events that are distributed radially around a center point, up to a certain distance away.

Parameters:

center - The geographic coordinate of the center point

radius - The distance, measured in meters.

RandomGeoFeed

public RandomGeoFeed(GeoFilter filter)

Create a RandomGeoFeed from a Geographic Filter. The geographic events will be distributed radially around the center point of the shape or shapes in the geographic filter, and cover the filter. This constructor may be used to simulate hits around a particular region, or to test a particular geographic filter.

Parameters:

filter - the filter to use to create the random feed

Method Detail

run

public void run()

Run method for the RandomGeoFeed. This method continuously generates random geographic events, sleeping for a random period of time between each event. The loop continues as long as the sleep time is greater than zero. Other classes should not call this method directly, but instead call start().

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

setMaxSleep

public void setMaxSleep(int sleepSeconds)

Set the maximum time to sleep between generating random events. If the sleepSeconds are negative, the thread will terminate. The default sleep time is 3 seconds.

Parameters:

sleepSeconds - the maximum sleep time, in seconds.

main

public static void main(java.lang.String[] args)

Run a random GeoEvent generator. The example program generates GeoEvents centered on Washington DC, with a radius which covers Maryland and parts of neighboring states. A sample GeoEventListener prints out the coordinates of the events generated by the generator thread.

Parameters:

args - Command line arguments. Ignored