DtRadarObjectSensor extends the DtSignatureObjectSensor with the capability of publishing an emitter system. More...

Inheritance diagram for DtRadarObjectSensor:

Public Member Functions
	DtRadarObjectSensor (const DtString &name, DtVrfObject owner, DtSimManager simManager, DtComponentDescriptor desc=0, DtReaderWriterRegistry parentRegistry=0)
	(const DtString&,DtVrfObject,DtSimManager,
virtual	~DtRadarObjectSensor ()
	destructor
virtual bool	init ()
	Calls createPSR(), createDetectableObjectList(), createAndInitSensorMonitor() and initSensorGeometry().
virtual const char *	type () const
	Returns a string identifies the class type of component.
virtual int	sensorType () const
	Returns DtSensorTypeRadar.
virtual void	preFirstTickInit ()
	If the PSR indicates that the emitter system is on, calls setOn on myEmitterSystem.
virtual void	tick ()
	Turns on the emitter system in the first tick, as indicated in myRadarSensorPSR.
virtual void	setSensorEnabled (bool enabled)
	Enables or disables this sensor.
Public Member Functions inherited from DtSignatureObjectSensor
	DtSignatureObjectSensor (const DtString &name, DtVrfObject owner, DtSimManager simManager, DtComponentDescriptor desc=0, DtReaderWriterRegistry parentRegistry=0)
	(const DtString&,DtVrfObject,DtSimManager,
virtual	~DtSignatureObjectSensor ()
	destructor
virtual void	initSensorFieldOfView ()
	Creates a sensor field of view object which is published to the network.
virtual int	determineForceType (DtVrfObject object, DtRwSensorContactInfo contactInfo)
	Determines the force type for this object based on the sensor contact info for it.
virtual double	determineRadius (DtVrfObject object, DtRwSensorContactInfo contactInfo)
	Determines the radius of this object based on the sensor contact info for it.
virtual void	zoomSensor (double zoomLevel)
	Zooms the sensor to the given zoom level.
Public Member Functions inherited from DtObjectSensor
	DtObjectSensor (const DtString &name, DtVrfObject owner, DtSimManager simManager, DtComponentDescriptor desc=0, DtReaderWriterRegistry parentRegistry=0)
	(const DtString&,DtVrfObject,DtSimManager,
virtual	~DtObjectSensor ()
	destructor
virtual bool	postAddComponentsInit ()
	Called after all components have been created, initialized and added to the component manager.
virtual bool	tickWhileDestroyed () const
virtual bool	sensorEnabled () const
	Whether this sensor is enabled or disabled.
virtual void	disable ()
	Overridden to clear out the target list and update the monitor so that the sensor contact list will be cleared out in the front-end when the sensor is disabled.
virtual void	setIsEnabled (bool yesNo)
	Overridden to clear out the target list and update the monitor so that the sensor contact list will be cleared out in the front-end when the sensor is disabled.
virtual void	setTypesToDetectForTask (const DtRwObjectTypeList &objectTypes)
	Set or clear the dynamic list of object types to detect.
virtual void	clearTypesToDetectForTask ()
	Clear all types. Should be called when the task is done.
virtual const DtRwObjectTypeList &	typesToDetectForTask () const
	Gets the type list.
virtual bool	setTypesToDetectAttribute (DtReaderWriter *val)
	Attribute set functions to accept types to detect or clear the list of task-specific types.
virtual bool	clearTypesToDetect (DtReaderWriter *val)
	This function ignores the value passed in.
Public Member Functions inherited from DtSimComponent
	DtSimComponent (const DtString &name, DtVrfObject owner, DtSimManager simManager, DtComponentDescriptor desc=0, DtReaderWriterRegistry parentRegistry=0)
virtual	~DtSimComponent ()
	destructor
void	setParentSystem (DtComponentSystem *system)
	Sets the parent system of this component.
virtual void	registerAttributeFunctions ()
	Called to register functions that provide system attribute values.
virtual void	postTick ()
	This function is called immediately after tick() is called.
virtual void	timedTick ()
	This version of tick checks to see if the time to tick has arrived.
virtual void	setMinTickPeriod (double minTickPeriod)
	specifies a minimum tick period (which can also be thought of as
virtual double	minTickPeriod () const
	access the minimum tick period
virtual void	setMinTickPeriodVariance (double minTickPeriodVariance)
	set the variance in the minimum tick time
virtual double	minTickPeriodVariance () const
	access the variance in the minimum tick period
virtual void	setNextTickTime (double nextTickTime)
	The next tick time is normally calculated internally.
virtual double	nextTickTime () const
	access the next tick time
virtual double	calculateNextTickTime () const
	The next tick time is equal to mySimManager->exerciseClock()-> approximateElapsedRealTime() + myMinTickPeriod + a random # between -myMinTickPeriodVariance/2.
virtual double	calculateFirstTickTime () const
	Returns the first time value that the component should tick at.
virtual void	setEntity (DtVrfObject *entity)
	The entity's state repository is the place that actuator components make updates and other components look to see our current state.
virtual DtSimComponent *	nextComponent ()
	List management functions.
virtual DtSimComponent *	prevComponent ()
virtual void	setListItem (DtListItem *item)
	Used by DtComponentList.
virtual DtListItem *	listItem ()
virtual void	putData (std::string &fp, int indentLevel=0)
	putData writes our type, which is provided by the virtual type accessor of the deriving class.
virtual DtlObjPtr	getData (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths, const DtVariableBindingsList &variableBindings)
	getData is just used to get us past the type in the data stream, since it's not actual stored.
virtual void	addInputPort (DtInputPort *port)
	Adds this input port to the components input port list so that other components can look it up and attach to it.
virtual void	removeInputPort (DtInputPort *port)
virtual DtInputPort *	lookupInputPort (const DtString &portName)
	Returns a pointer to the input port registered on this component with the specified name.
virtual DtList	inputPortList () const
	Returns the list of DtInputPorts registered on this component.
virtual void	addOutputPort (DtOutputPort *port)
	Adds this output port to the components output port list so that other components can look it up and attach to it.
virtual void	removeOutputPort (DtOutputPort *port)
virtual DtOutputPort *	lookupOutputPort (const DtString &portName)
	Returns a pointer to the output port registered on this component with the specified name.
virtual DtList	outputPortList () const
	Returns the list of DtOutputPorts registered on this component.
virtual void	addInputPortGroup (DtInputPortGroup *group)
	Adds this input port to the components input port list so that other components can look it up and attach to it.
virtual void	removeInputPortGroup (DtInputPortGroup *group)
virtual DtInputPortGroup *	lookupInputPortGroup (const DtString &groupName)
	Returns a pointer the input port group registered on this component with the specified name.
virtual DtList	inputPortGroupList () const
	Returns the list of DtInputPortGroups registered on this component.
virtual void	addOutputPortGroup (DtOutputPortGroup *group)
	Adds this output port group to the components output port group list so that other components can look it up and attach to it.
virtual void	removeOutputPortGroup (DtOutputPortGroup *group)
virtual DtOutputPortGroup *	lookupOutputPortGroup (const DtString &groupName)
	Returns a pointer the output port group registered on this component with the specified name.
virtual DtList	outputPortGroupList () const
	Returns the list of DtOutputPortGroups registered on this component.
virtual int	priority () const
	Return the current connection priority for this component.
virtual void	setPriority (int priority)
	Sets a new connection priority for this component, and changes all current outgoing connections from this component to the new value.
double	dT () const
	This is the delta-t for this component, which may or may not be the same as the exerciseClock dT.
virtual void	setDT (double deltaT)
	Note that while dT is calculated internally, this makes it possible to 'lie' to the component about dT if necessary.
virtual void	setComponentDescriptor (DtComponentDescriptor *componentDescriptor)
	The component descriptor specified in the order of battle file or parameter file that was used to create this component.
virtual const DtComponentDescriptor *	componentDescriptor () const
DtVrfProcessStateRepositoryManager *	psrManager ()
virtual DtString	componentFullName () const
virtual DtPhysicalWorld *	physicalWorld ()
	Gets the physical world that this component's entity exists in.
virtual const DtPhysicalWorld *	physicalWorld () const
virtual DtAttachedTerrain *	terrainAttachedTo ()
	Gets the terrain that this component's entity is attached to, if any.
virtual const DtAttachedTerrain *	terrainAttachedTo () const
virtual DtVrfObject *	entity ()
	Gets the entity.
virtual const DtVrfObject *	entity () const
virtual DtSimManager *	simManager ()
	Gets the sim manager.
virtual const DtSimManager *	simManager () const
virtual const Coordinate_System *	coordinateSystem () const
	Gets the coordinate system, as it should always exist if the physical world is in a valid state!
virtual Coordinate_System *	coordinateSystem ()
virtual DtVrfObjectStateRepository *	localStateRepository ()
	Gets the local state repository.
virtual const DtVrfObjectStateRepository *	localStateRepository () const
virtual void	enable ()
	Is this component enabled or not.
virtual bool	isEnabled ()
	Is this component enabled or not.
virtual DtOutputStream &	objectConsoleDebug (const DtString &channel="") const
virtual DtOutputStream &	objectConsoleVerbose (const DtString &channel="") const
virtual DtOutputStream &	objectConsoleInfo (const DtString &channel="") const
virtual DtOutputStream &	objectConsoleWarn (const DtString &channel="") const
virtual DtOutputStream &	objectConsoleError (const DtString &channel="") const
virtual DtSimResourceManager &	resourceManager ()
virtual const DtSimResourceManager &	resourceManager () const
Public Member Functions inherited from DtReaderWriter
	DtReaderWriter ()
	default constructor
	DtReaderWriter (const DtString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
	real constructor Setting the readonly flag prevents object from writing itself to the stream.
	DtReaderWriter (const DtSymbolString &name, DtReaderWriterRegistry *parentRegistry=NULL, bool readonly=false)
	DtReaderWriter (const DtString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
	pseudo-copy constructor
	DtReaderWriter (const DtSymbolString &name, const DtReaderWriter &orig, DtReaderWriterRegistry *parentRegistry=NULL)
	DtReaderWriter (const DtReaderWriter &, DtReaderWriterRegistry *parentRegistry=NULL)
	copy constructor
const DtReaderWriter &	operator= (const DtReaderWriter &orig)
	assignment operator
bool	operator== (const DtReaderWriter &) const
	Equivalence operator.
bool	operator!= (const DtReaderWriter &rhs)
virtual	~DtReaderWriter ()
	destructor
virtual void	putSelf (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
	Top level call to write itself to file.
virtual void	postPutSelf ()
	Called after either version of put self (file or environment). Default is no-op.
virtual void	prePutSelf ()
	Called before either version of put self (file or environment). Default is no-op.
virtual void	getSelf (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
	Top level to read itself from an input stream.
virtual void	postGetSelf ()
	Called after either version of getSelf (mtl or environment). Default is no-op.
virtual void	preGetSelf ()
	Called before either version of get self (file or environment). Default is no-op.
virtual void	writeSelf (std::string &fp, int indentLevel=0, bool writeUnspecified=false, const DtFilename &path=DtFilename::nullFilename())
	Called from putSelf, calls myRegistry.putSelf which in turn calls putSelf on each reader/writer in the registry.
virtual DtSymbolString	name () const
	Accessor for name of this readable/writable object.
virtual void	addAlias (const DtSymbolString &alias)
	Add an alias as an alternative name for this object.
virtual void	addAlias (const DtString &alias)
virtual bool	hasAlias (const DtSymbolString &alias)
virtual const aliasContainer &	aliases () const
virtual void	setReadonly (bool flag)
	Set read-only flag.
bool	isReadonly () const
virtual void	reset ()
	For those reader/writer items that support it, resets the reader/writer value to iriginal state Default is no-op.
virtual int	alignment () const
	For those items that are sent over the network via HLA, this will give the network alignment.
virtual bool	variableIsBound () const
virtual void	unbindVariable ()
	Sets the myVariableIsBound flag to false.
virtual void	setName (const DtString &)
	Set the name of the object.
virtual const char *	readerWriterType () const
	Used to supply a string type that this reader writer type is.
virtual const char *	xmlType () const
virtual DtString	prettyPrint () const
	Routine to return a human readable form of the reader/writer variable.
std::string	debugText () const
virtual void	bindVariables (DtVariableBindingsList variableBindings)
	Runs a variable binding pass on this reader writer and any of its children.
virtual std::list < DtVariableNameType >	unboundVariables () const
bool	invalid () const
virtual bool	hasChild (const DtReaderWriter *p) const
	Returns true if this variable has a child p in it's chain.
virtual bool	hasVariableReference () const
	Returns true if this item or any item in the registry (recursive) is a variable reference.
virtual void	bindLocalVariables (const DtVariableBindingsList &variableBindings)
	Checks to see if this RW object is a variable reference that can be bound using the provided bindings.
virtual void	recordUpdateTime () const
	Can be implemented in subclasses to stamp the time when updated.
virtual bool	wasUpdatedSince (DtTime t) const
	Can be implemented in subclasses to return true if an update occurred after the specified time.
virtual DtlObjPtr	getData (DtlObjPtr args, const SearchPaths &searchPaths, const DtVariableBindingsList &variableBindings)
	Deriving class overrides these to get/put class specific data.
virtual void	setValueSpecified (bool specified, bool recurse=false)
	The specified flags are used for optional values.
virtual bool	valueSpecified () const
	The specified flags are used for optional values.
virtual bool	isVariableReference () const
	Specifies whether or not this reader writer is really a variable that is specified elsewhere.
virtual void	setIsVariableReference (bool value)
virtual void	clearAllVariableReferenceFlags ()
	Clears out all variable reference flags from all readerwriter items in registry recursively.
virtual DtSymbolString	variableName () const
	The variable name, if this object is a variable reference.
virtual void	setVariableName (const DtSymbolString variableName)
	The variable name, if this object is a variable reference.
virtual const DtReaderWriter *	defaultRWValue () const
	The default value to use if the reader/writer object is a variable and that variable is not specified.
virtual DtReaderWriter *	defaultRWValue ()
	The default value to use if the reader/writer object is a variable and that variable is not specified.
virtual void	setDefaultRWValue (DtReaderWriter *)
	Previous default value, if exists, will be removed and replaced with a clone of the supplied variable.
virtual bool	checkAndSetDefaultRWValue (DtlObjPtr args, const DtReaderWriter::SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &variableBindings=nullVariableReference())
	Give the stream, if the stream contains a default value then set it here.
const DtReaderWriterRegistry &	registry () const
	Collection of child DtReaderWriter nodes owned by this object.
DtReaderWriterRegistry &	registry ()
	Collection of child DtReaderWriter nodes owned by this object.
virtual DtPropertyInterface *	property ()
virtual const DtPropertyInterface *	property () const
virtual DtString	toXml () const
virtual bool	toXml (const DtFilename &) const
	Writes contents of xml result to the given filename.
virtual bool	fromXml (const DtString &)
	Restores object from given xml string. Returns true if valid.
virtual bool	fromXmlFile (const DtFilename &)
	Restires object from given xml file.
virtual void	putSelf (DtEnvironmentSP, DtEnvValueSP parent) const
virtual void	putData (DtEnvironmentSP, DtEnvValueSP value) const
	Override to add attributes of actual data.
virtual void	putVariableReference (DtEnvironmentSP, DtEnvValueSP value) const
	Called when the item is a variable reference.
virtual void	getSelf (const DtEnvironmentSP, const DtEnvValueSP root, const SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &bindings=DtVariableBindingsList())
virtual void	getData (const DtEnvironmentSP, const DtEnvValueSP, const SearchPaths &searchPaths=SearchPaths(), const DtVariableBindingsList &bindings=DtVariableBindingsList())
	Gets data from the environment value.
virtual void	unrecognizedItem (const DtEnvironmentSP env, const DtEnvValueSP root, const SearchPaths &searchPaths, const DtVariableBindingsList &varBindings)
	Called when the xml reader tries to parse an unknown reader/writer item. Default is a no-op.
virtual void	getVariableReference (DtEnvironmentSP, DtEnvValueSP value)
	Called when the item is a variable reference.

Static Public Member Functions
static DtSimComponent *	creator (const DtString &name, DtVrfObject owner, DtSimManager simManager, DtComponentDescriptor desc=0, DtReaderWriterRegistry parentRegistry=0)
	(const DtString&,DtVrfObject,DtSimManager,

Protected Member Functions
virtual double	EwAttackEffect (const double attack, const double defense) const
	Compute the degree to which a radar jamming attack on this entity is successful in degrading the sensitivity of this sensor.
virtual double	sensitivityModifier () const
	Overridden to check to incorporate the [aggregate] radar jamming effect.
virtual const char *	defaultPSRType () const
virtual void	createAndInitEmitterSystem ()
	Creates a new DtVrfEmitterSystem and assigns it to myEmitterSystem.
virtual void	destroyEmitterSystem ()
	Removes the emitter system.
virtual void	processSetEmitterRequestMessage (DtSimMessage *msg)
	Calls setEmitterSystemOn() with the value specified in the message if the message matches our emitter system ID.
virtual void	processSetRadarModeRequestMessage (DtSimMessage *msg)
virtual void	processRequestRadarModesAdmin (const DtUUID &receiver, const DtUUID &sender, const DtVrfObjectMessage *msg)
virtual void	setEmitterSystemOn (bool onOff)
	Changes the on/off state of myEmitterSystem, and changes the emitter system on value in the PSR.
Protected Member Functions inherited from DtSignatureObjectSensor
virtual bool	createPorts ()
	Overridden to create local ports.
virtual bool	detectObject (DtVrfObject object, DtRwSensorContactInfo contactInfo)
	Returns true if object is detected.
virtual bool	continueDetectingObject (DtVrfObject object, DtRwSensorContactInfo contactInfo, bool &contactInfoModified)
	Same as detectObject except it is checking for objects we had previously detected.
virtual double	minimumSignatureThreshold (double sensorSensitivity) const
virtual double	apparentSignature (DtVrfObject *object, bool losValueIfTerrainUnavailable, double sensorSensitivity) const
	Returns the apparent signature of the specified object using sensorSignatureManager::apparentObjectSignature.
virtual bool	determineIdentificationLevel (DtVrfObject object, DtRwSensorContactInfo contactInfo, double appSignature, int &level, bool &contactInfoModified)
	Determine varying levels of detection.
virtual void	updateSensorContactInfo (DtVrfObject object, DtRwSensorContactInfo contactInfo, int updateLevel)
virtual void	addDetectionError (DtRwSensorContactInfo *info, int level)
	Uses the sensor positional error set in the sensor descriptor to add error to the contact information.
virtual double	sensitivity () const
	The current sensitivity of the sensor.
virtual bool	objectInSector (const DtVrfObject *object) const
virtual DtVector	localSensorPosition () const
	Overridden to use the offset from the descriptor if the position port is not connected.
virtual DtVector	bodySensorPosition () const
	Overridden to use the offset from the descriptor if the position port is not connected.
virtual double	windEffects () const
	How wind (if it does) effects the sensors.
virtual double	precipitationEffects () const
	How precipitation (if it does) effects the sensors.
virtual void	setupGeometryForDetection ()
	Sets up the current sensor geometry evaluator with the current position, orientation, and frustum of the sensor.
virtual double	suppressionEffects () const
	How suppression effects sensors.
Protected Member Functions inherited from DtObjectSensor
virtual bool	createPortGroups ()
	Creates and initializes port groups.
virtual DtObjectSensorPSR *	createPSR ()
	Creates myProcessState data member, and adds it to our process state repository manager.
virtual void	initSensorRangeRing ()
	Adds a sensor range ring to the range rings published for this object with the system-name.sensor-name as the title.
virtual void	updateDetectableObjectsList ()
	Sets up myDetectableObjectList as a list that contains all entity types/forces specified in both the descriptor and the myObjectsToDetectInputPort input port.
virtual bool	initSensorGeometry ()
	Creates the geometry evaluator based on the sensor-geometry entry in the descriptor, and the sensor geometry evaluator factory.
virtual DtTaitBryan	localSensorOrientation () const
virtual DtTaitBryan	bodySensorOrientation () const
virtual DtUUID	targetObject () const
virtual DtVector	targetLocation () const
virtual DtSensorTrackingMode	trackingMode () const
virtual bool	processObjects ()
	Checks detectability of each of the detectable objects.
virtual bool	objectWithinSensorGeometry (DtVrfObject *object) const
virtual double	rangeSquaredToObject (const DtVrfObject *object) const
virtual double	rangeToObject (const DtVrfObject *object) const
virtual void	clearObjectRangeCache () const
	Invalidates the current object range cache.
virtual void	printTargets () const
	Prints the current target list to the console.
virtual void	updateDetectedObjectListPort ()
	Clears the list port, then adds all target infos from the previous target list in the PSR, and sends the data.
virtual bool	createAndInitSensorMonitor ()
	Creates a DtObjectSensorMonitor, and calls init() on it.
virtual bool	objectInDetectableList (DtVrfObject *) const
	Returns true if the object is in the myDetectableObjectList.
virtual void	processHostilitiesChanged (DtU8 force)
virtual DtTaitBryan	worldOrientationOfObject (DtVrfObject *object) const
	Given the object, if this is a single point object return the orientation in the vrfState() else return orientation as calculated for multi-point objects (closed figure is origin to first point, non-closed is origin to last point).
virtual bool	canDetectForceOfObject (DtVrfObject *)
	Return false if the force of the object supplied cannot be detected by this force.
virtual void	processSetSensorEnabledRequestMessage (DtSimMessage *msg)
	Calls setSensorEnabled() with the value specified in the message if the message matches our sensor name.
DtCompositePredicate	objectTypeForcePredicate (const DtObjectType &, const DtNLengthIntegerVector &forceTypes)
	Specifies force types as s DtNLenghtIntegerVector.
DtCompositePredicate	objectTypeForcePredicate (const DtObjectType &, const std::list< DtU8 > &forceTypes)
	Specifies force types as a std::list.
Protected Member Functions inherited from DtSimComponent
virtual double	computeCurrentTime ()
	Compute current time and myDT.
bool	testInvariant () const
DtVrfProcessStateRepository *	createComponentPsr (const DtString &defaultPsrType, const DtString &defaultPsrName, bool useDescriptorParams=true)
	Creates a PSR for this component and registers it with the PSR manager.
Protected Member Functions inherited from DtReaderWriter
virtual void	bindToRwAsVariable (const DtReaderWriter *rw)
	Copies values from the specified DtReaderWriter.
Protected Member Functions inherited from DtObjectDebugger< DtReaderWriter >
	DtObjectDebugger ()
	DtObjectDebugger (const DtObjectDebugger &)
	~DtObjectDebugger ()
Protected Member Functions inherited from DtObjectDebugger< DtSimComponent >
	DtObjectDebugger ()
	DtObjectDebugger (const DtObjectDebugger &)
	~DtObjectDebugger ()

Static Protected Member Functions
static void	setEmitterRequestCallback (DtSimMessage msg, void usrData)
	Static callback method for setEmitter messages.
static void	setRadarModeRequestCallback (DtSimMessage msg, void usrData)
static void	requestRadarModesAdminCallback (const DtVrfObjectMessage msg, void usr)

Protected Attributes
const DtRadarObjectSensorDescriptor *	myRadarObjectSensorDescriptor
DtVrfEmitterSystem *	myEmitterSystem
DtRadarObjectSensorPSR *	myRadarSensorPSR
	DtObjectSensor's myProcessState cast to our PSR type.
DtU8	myEmitterSystemId
Protected Attributes inherited from DtSignatureObjectSensor
const DtSignatureObjectSensorDescriptor *	mySignatureObjectSensorDescriptor
DtSymbolString	mySensorDomain
DtVector	myLocalSensorPosition
	Computed once per tick:
double	mySensitivity
DtVrfSensorFieldOfView *	myFieldOfView
	The field of view of the sensor.
DtSignatureDetectLevelDeterminator *	myDetectionLevelDeterminator
DtSignatureObjectSensorPSR *	mySignatureSensorPSR
	DtObjectSensor's myProcessState cast to our PSR type.
DtAnalogInputPort *	myZoomLevelPort
	Input Port Name: zoom-rate Input Port Description: Desired zoom level of the sensor.
DtIntegerInputPort *	myFieldOfViewColorPort
	Input Port Name: field-of-view-color Input Port Description: Desired color for the sensor field of view.
Protected Attributes inherited from DtObjectSensor
DtManagedObjectListConstPtr	myDetectableObjectList
const DtObjectSensorDescriptor *	myObjectSensorDescriptor
DtObjectSensorPSR *	myProcessState
	Container for state data associated with this component.
DtObjectSensorMonitor *	myMonitor
	Sends out sensor contact information to the GUI if the GUI or other application has requested the information.
DtSpatialFilterEvaluator *	mySensorGeometryEvaluator
DtForceType	myForceType
	The force type the last time the detectable object list was updated.
const DtVrfObject *	myMutableObjectCached
	The VrfObject whose range is currently cached.
bool	myMutableObjectRangeCalculated
	Keeps track of whether the range has been calculated for the current cached object.
double	myMutableObjectRangeCache
	The current range to the cached object, if calculated.
bool	myMutableObjectRangeSquaredCalculated
	Keeps track of whether the range squared has been calculated for the current cached object.
double	myMutableObjectRangeSquaredCache
	The current range squared to the cached object, if calculated.
bool	myGeometrySetup
	Whether setupGeometryForDetection() has been called yet.
bool	myPrep_detectedObjectsChangesMade
bool	myPrep_invokeNewContactCallbacks
DtSensorContactListOutputPort *	myDetectedObjectListPort
	Outputs: Output Port Name: detected-objects Output Port Description: The list of contacts detected by this sensor.
DtObjectTypesListMultiInputPort *	myObjectsToDetectInputPort
	Inputs: DtObjectTypesListMultiInputPort : object-types-to-detect Input Port Name: object-types-to-detect Input Port Description: List of contacts to be considered for target selection.
DtInputPortGroup *	mySensorOffsetInputPortGroup
	Input Port Group Name: sensor-offset Input Port Group Description: Allows an external controller to provide position and orientation of the sensor relative to the entity's position.
DtOrientationInputPort *	myOrientationInputPort
	Input Port Name: orientation Input Port Description: Specifies the orientation of the sensor relative to the entity on which it is mounted.
DtVectorInputPort *	myPositionInputPort
	Input Port Name: position Input Port Description: Specifies the position of the sensor in body coordinates relative to the entity which it is mounted on.
DtStringInputPort *	myTargetObjectInputPort
	Input Port Name: target-object Input Port Description: Specifies the name of the object be targeted by this sensor.
DtVectorInputPort *	myTargetLocationInputPort
	Input Port Name: target-location Input Port Description: Specifies the location to be targeted by this sensor.
DtIntegerInputPort *	myTrackingModeInputPort
	Input Port Name: tracking-mode Input Port Description: Specifies the tracking mode of the sensor.
DtBooleanInputPort *	myTargetAcquiredInputPort
	Input Port Name: target-acquired Input Port Description: Specifies whether the sensor was able to acquire the target.
Protected Attributes inherited from DtSimComponent
DtVrfObject *	myEntity
DtVrfObjectStateRepository *	myLocalStateRepository
DtSimManager *	mySimManager
DtComponentSystem *	mySystem
	Pointer to the DtComponentSystem that this component belongs.
DtListItem *	myListItem
DtInputPortMap	myInputPortList
DtOutputPortMap	myOutputPortList
DtInputPortGroupMap	myInputPortGroupList
DtOutputPortGroupMap	myOutputPortGroupList
int	myPriority
double	myMinTickPeriod
double	myMinTickPeriodVariance
double	myNextTickTime
double	myLastTickSimTime
double	myDT
bool	myIsEnabled
	Indicates whether this component should be enabled for ticking or not.
bool	myFirstTick
	Initialized to true in the constructor, set to false by the first call to postTick.
bool	myIsThreadSafe
	Whether this component can be use the DtCriticalSection versions of the tick functions and be ticked in parallel with other components Defaults to false.
const DtComponentDescriptor *	myComponentDescriptor
std::list < DtVrfProcessStateRepository * >	myComponentPsrs
	List of PSRs made using createComponentPsr() that will be deleted by this component when it is destroyed.
bool	myTickEveryFrame
	Flag indicating that tickPeriod is set to 0, and the component will tick every frame.
Protected Attributes inherited from DtReaderWriter
const DtSymbolString	myName
DtReaderWriterRegistry	myRegistry
DtReaderWriterRegistry *	myParentRegistry
bool	myValueSpecified
bool	myReadOnlyFlag
bool	myIsVariableReference
DtSymbolString	myVariableName
bool	myVariableIsBound
DtReaderWriter *	myDefaultValue
aliasContainer	myAliases
	Container for the aliases which represent alternative names for the object.
bool	myInvalid
	Set to true if there is a problem reading this item.

Private Member Functions
	DtRadarObjectSensor ()
	default constructor; not implemented
	DtRadarObjectSensor (const DtRadarObjectSensor &orig)
	copy constructor; not implemented
const DtRadarObjectSensor &	operator= (const DtRadarObjectSensor &orig)
	assignment operator; not implemented

Additional Inherited Members
Public Types inherited from DtReaderWriter
typedef std::vector < DtSymbolString >	aliasContainer
typedef std::vector < DtSymbolString >::iterator	aliasIter
typedef std::vector < DtSymbolString > ::const_iterator	aliasConstIter
typedef std::vector< DtFilename >	SearchPaths
typedef std::pair < DtSymbolString, DtString >	DtVariableNameType
typedef DtReaderWriterFactory (	DtReaderWriterFactoryCreatorFcn )()
Protected Types inherited from DtSimComponent
typedef std::map< DtString, DtInputPort * >	DtInputPortMap
typedef std::map< DtString, DtOutputPort * >	DtOutputPortMap
typedef std::map< DtString, DtInputPortGroup * >	DtInputPortGroupMap
typedef std::map< DtString, DtOutputPortGroup * >	DtOutputPortGroupMap
Static Protected Attributes inherited from DtSimComponent
static DtSimComponentFactory *	myFactory

Detailed Description

DtRadarObjectSensor extends the DtSignatureObjectSensor with the capability of publishing an emitter system.

End User Description: This sensor has all the functionality of the DtSignatureObjectSensor, but additionally publishes an emitter system to the network. The sensing functionality is exactly the same as the DtSignatureObjectSensor. The emitter system can be toggled on and off using DtSetEmitter messages, which are accessible in the GUI. When the emitter system is toggled off, the sensor will no longer detect any objects.

Note: The emitter beams published by this component to not have any actual effect on what objects the sensor can detect. All detection is done by the dtSignatureObjectSystem parent class.

Uses Descriptor Type: DtRadarObjectSensorDescriptor

Constructor & Destructor Documentation

DtRadarObjectSensor::DtRadarObjectSensor ( )

private

default constructor; not implemented

DtRadarObjectSensor::DtRadarObjectSensor ( const DtRadarObjectSensor & orig )

private

copy constructor; not implemented

DtRadarObjectSensor::DtRadarObjectSensor	(	const DtString &	name,
		DtVrfObject *	owner,
		DtSimManager *	simManager,
		DtComponentDescriptor *	desc = `0`,
		DtReaderWriterRegistry *	parentRegistry = `0`
	)

(const DtString&,DtVrfObject*,DtSimManager*,

Parameters

name	Reader writer name of this component.
owner	The DtVrfObject that owns this component
simManager	The simulation manager (provides access to terrain, message interface, simulation clock).
desc	The component descriptor used to initialize this component.
parentRegistry	Pointer to the parent reader writer registry (the containing object that reads/writes this object).

(const DtString&,DtVrfObject*,DtSimManager*, DtComponentDescriptor*,DtReaderWriterRegistry* parentRegistry)

virtual DtRadarObjectSensor::~DtRadarObjectSensor ( )

virtual

destructor

Member Function Documentation

const DtRadarObjectSensor& DtRadarObjectSensor::operator= ( const DtRadarObjectSensor & orig )

private

assignment operator; not implemented

virtual bool DtRadarObjectSensor::init ( )

virtual

Calls createPSR(), createDetectableObjectList(), createAndInitSensorMonitor() and initSensorGeometry().

This must be called after construction and before the sensor is used on an entity.

Reimplemented from DtSignatureObjectSensor.

virtual const char* DtRadarObjectSensor::type ( ) const

virtual

Returns a string identifies the class type of component.

Type values are defined in compTypes.h. DtSimComponent creation functions are registered with the DtSimComponentFactory using the type values as the key. Warning: this function should always return the same pointer and it should be valid forever. This means the data should be static.

Returns: DtRadarObjectSensorType

Reimplemented from DtSignatureObjectSensor.

virtual int DtRadarObjectSensor::sensorType ( ) const

virtual

Returns DtSensorTypeRadar.

Reimplemented from DtSignatureObjectSensor.

virtual void DtRadarObjectSensor::preFirstTickInit ( )

virtual

If the PSR indicates that the emitter system is on, calls setOn on myEmitterSystem.

Reimplemented from DtSignatureObjectSensor.

virtual void DtRadarObjectSensor::tick ( )

virtual

Turns on the emitter system in the first tick, as indicated in myRadarSensorPSR.

When it is time for the next detection attempt (cached in myRadarSensorPSR), calls DtSignatureObjectSensor::tick() and computes and stores time to next detection attempt in myRadarSensorPSR. If entity is destroyed, calls destroyEmitterSystem(). If entity has been restored, calls createAndInitEmitterSystem(). Calls emitter system's tick().

Reimplemented from DtSignatureObjectSensor.

virtual void DtRadarObjectSensor::setSensorEnabled ( bool enabled )

virtual

Enables or disables this sensor.

Overridden to turn on or off the emitter as well.

Reimplemented from DtSignatureObjectSensor.

static DtSimComponent* DtRadarObjectSensor::creator	(	const DtString &	name,
		DtVrfObject *	owner,
		DtSimManager *	simManager,
		DtComponentDescriptor *	desc = `0`,
		DtReaderWriterRegistry *	parentRegistry = `0`
	)

static

(const DtString&,DtVrfObject*,DtSimManager*,

Parameters

name	Reader writer name of this component.
owner	The DtVrfObject that owns this component
simManager	The simulation manager (provides access to terrain, message interface, simulation clock).
desc	The component descriptor used to initialize this component.
parentRegistry	Pointer to the parent reader writer registry (the containing object that reads/writes this object).

(const DtString&,DtVrfObject*,DtSimManager*, DtComponentDescriptor*,DtReaderWriterRegistry* parentRegistry)

Returns: New instance of this class.

Reimplemented from DtSignatureObjectSensor.

virtual double DtRadarObjectSensor::EwAttackEffect	(	const double	attack,
		const double	defense
	)		const

protectedvirtual

Compute the degree to which a radar jamming attack on this entity is successful in degrading the sensitivity of this sensor.

It returns a modifier that is applied to the sensitivity of this sensor, so should be a number between 0 and 1 where 1.0 is "no effect" and 0.0 is "completely jammed."
The implementation here computes r = attack/defense and returns 1/(1+r^2). Thus when attack = defense, r^2 = 1, and the modifier is 0.5. Squaring the ratio results in a change of output by about x% when r changes by x%, when r is near 1. E.g., if r = 1.01, then the output will be about 0.495.

virtual double DtRadarObjectSensor::sensitivityModifier ( ) const

protectedvirtual

Overridden to check to incorporate the [aggregate] radar jamming effect.

Modifier (in addition to signatureObjectSensor modifier) is EwAttackEffect().

Reimplemented from DtSignatureObjectSensor.

virtual const char* DtRadarObjectSensor::defaultPSRType ( ) const

protectedvirtual

Returns: DtVrfRadarObjectSensorProcessStateRepositoryType.

Reimplemented from DtSignatureObjectSensor.

virtual void DtRadarObjectSensor::createAndInitEmitterSystem ( )

protectedvirtual

Creates a new DtVrfEmitterSystem and assigns it to myEmitterSystem.

Sets the emitter system data from the descriptor. Registers for setEmitter message callbacks.

virtual void DtRadarObjectSensor::destroyEmitterSystem ( )

protectedvirtual

Removes the emitter system.

static void DtRadarObjectSensor::setEmitterRequestCallback	(	DtSimMessage *	msg,
		void *	usrData
	)

staticprotected

Static callback method for setEmitter messages.

Calls processSetEmitterRequestMessage().

virtual void DtRadarObjectSensor::processSetEmitterRequestMessage ( DtSimMessage * msg )

protectedvirtual

Calls setEmitterSystemOn() with the value specified in the message if the message matches our emitter system ID.

static void DtRadarObjectSensor::setRadarModeRequestCallback	(	DtSimMessage *	msg,
		void *	usrData
	)

staticprotected

virtual void DtRadarObjectSensor::processSetRadarModeRequestMessage ( DtSimMessage * msg )

protectedvirtual

static void DtRadarObjectSensor::requestRadarModesAdminCallback	(	const DtVrfObjectMessage *	msg,
		void *	usr
	)

staticprotected

virtual void DtRadarObjectSensor::processRequestRadarModesAdmin	(	const DtUUID &	receiver,
		const DtUUID &	sender,
		const DtVrfObjectMessage *	msg
	)

protectedvirtual

virtual void DtRadarObjectSensor::setEmitterSystemOn ( bool onOff )

protectedvirtual

Changes the on/off state of myEmitterSystem, and changes the emitter system on value in the PSR.

Member Data Documentation

const DtRadarObjectSensorDescriptor* DtRadarObjectSensor::myRadarObjectSensorDescriptor

protected

DtVrfEmitterSystem* DtRadarObjectSensor::myEmitterSystem

protected

DtRadarObjectSensorPSR* DtRadarObjectSensor::myRadarSensorPSR

protected

DtObjectSensor's myProcessState cast to our PSR type.

This class with not new or delete this object. Base class does that.

DtU8 DtRadarObjectSensor::myEmitterSystemId

protected

The documentation for this class was generated from the following file:

/exports/nfedora7-1/nightly/docs/vrforcesDevelopment.vrf4-4-branch/include/vrfmodel/radarObjectSensor.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation