|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectptolemy.kernel.util.NamedObj
ptolemy.kernel.InstantiableNamedObj
ptolemy.kernel.Entity
ptolemy.kernel.ComponentEntity
ptolemy.actor.AtomicActor
ptolemy.actor.TypedAtomicActor
ptolemy.domains.wireless.kernel.AtomicWirelessChannel
ptolemy.domains.wireless.lib.ErasureChannel
ptolemy.domains.wireless.lib.DelayChannel
ptolemy.domains.wireless.lib.LimitedRangeChannel
ptolemy.domains.wireless.lib.PowerLossChannel
This is a model of a wireless channel with a specified power propagation formula. The power propagation is given as an expression that is evaluated and then multiplied by the power field of the transmit properties before delivery to the receiver. For convenience, a variable named "distance" is available and equal to the distance between the transmitter and the receiver when the power propagation formula is evaluated. Thus, the expression can depend on this distance. The value of the power field should be interpreted as power at the transmitter but power density at the receiver. A receiver may multiply the power density with its efficiency and an area(typically the antenna area). A receiver can then use the resulting power to compare against a detectable threshold, or to determine signal-to-interference ratio, for example.
The default value of powerPropagationFactor is
1.0 / (4 * PI * distance * distance).This assumes that the transmit power is uniformly distributed on a sphere of radius distance. The result of multiplying this by a transmit power is a power density (power per unit area). The receiver should multiply this power density by the area of the sensor it uses to capture the energy (such as antenna area) and also an efficiency factor which represents how effectively it capture the energy.
The power field of the transmit properties can be supplied by the transmitter as a record with a power field of type double. The default value provided by this channel is Infinity, which when multiplied by any positive constant will yield Infinity, which presumably will be above any threshold. Thus, the default behavior is to encounter no power loss and no limits to communication due to power.
In addition, this channel can have a specified limited transmission range. If a transmission range less than Infinity (the default) is specified, then receivers outside the specified range will not be notified of transmission, irrespective of power loss. The transmission range can be specified in one of two ways. Either it is the value of the range field in the defaultProperties parameter (a record) of this channel, or it is provided by the transmitter on each call to transmit() as a property argument. To use the latter mechanism, it is necessary that the property token be an instance of RecordToken with a field named "range" that can be converted to a double (i.e., it can be a double, an int, or a byte). The default value for range is Infinity, which indicates that by default, there is no range limit.
Any receiver that is within the specified range when transmit() is called will receive the transmission, unless the lossProbability parameter is set to greater than zero.
| Yellow (cxh) |
| Green (cxh) |
| Nested Class Summary |
| Nested classes inherited from class ptolemy.kernel.Entity |
ptolemy.kernel.Entity.ContainedObjectsIterator |
| Field Summary | |
ptolemy.data.expr.Parameter |
powerPropagationFactor
The default formula for the power loss factor. |
| Fields inherited from class ptolemy.domains.wireless.lib.DelayChannel |
propagationSpeed |
| Fields inherited from class ptolemy.domains.wireless.lib.ErasureChannel |
_random, distance, lossProbability, seed |
| Fields inherited from class ptolemy.domains.wireless.kernel.AtomicWirelessChannel |
_receiversInRangeCacheValid, defaultProperties |
| Fields inherited from class ptolemy.actor.AtomicActor |
_stopRequested |
| Fields inherited from class ptolemy.kernel.util.NamedObj |
_changeListeners, _changeLock, _changeRequests, _debugging, _debugListeners, _elementName, _isPersistent, _workspace, ATTRIBUTES, CLASSNAME, COMPLETE, CONTENTS, DEEP, FULLNAME, LINKS |
| Fields inherited from interface ptolemy.actor.Executable |
COMPLETED, NOT_READY, STOP_ITERATING |
| Constructor Summary | |
PowerLossChannel(ptolemy.kernel.CompositeEntity container,
java.lang.String name)
Construct a channel with the given name and container. |
|
| Method Summary | |
ptolemy.data.RecordToken |
transformProperties(ptolemy.data.RecordToken properties,
WirelessIOPort source,
WirelessIOPort destination)
Transform the properties to take into account channel losses, noise, etc., for transmission between the specified sender and the specified receiver. |
| Methods inherited from class ptolemy.domains.wireless.lib.LimitedRangeChannel |
_isInRange, valueChanged |
| Methods inherited from class ptolemy.domains.wireless.lib.DelayChannel |
_transmitTo, attributeChanged, fire |
| Methods inherited from class ptolemy.domains.wireless.lib.ErasureChannel |
initialize |
| Methods inherited from class ptolemy.domains.wireless.kernel.AtomicWirelessChannel |
_distanceBetween, _locationOf, _receiversInRange, getChannelPort, listeningInputPorts, listeningOutputPorts, pruneDependencies, registerPropertyTransformer, sendingInputPorts, sendingOutputPorts, transmit, unregisterPropertyTransformer |
| Methods inherited from class ptolemy.actor.TypedAtomicActor |
_addPort, attributeTypeChanged, clone, newPort, typeConstraintList |
| Methods inherited from class ptolemy.actor.AtomicActor |
_createReceivers, clone, connectionsChanged, getDirector, getExecutiveDirector, getFunctionDependency, getManager, inputPortList, iterate, newReceiver, outputPortList, postfire, prefire, preinitialize, removeDependency, setContainer, stop, stopFire, terminate, wrapup |
| Methods inherited from class ptolemy.kernel.ComponentEntity |
_adjustDeferrals, _checkContainer, _getContainedObject, _propagateExistence, getContainer, instantiate, isAtomic, isOpaque, propagateExistence, setName |
| Methods inherited from class ptolemy.kernel.Entity |
_description, _exportMoMLContents, _removePort, connectedPortList, connectedPorts, containedObjectsIterator, getAttribute, getPort, getPorts, linkedRelationList, linkedRelations, portList, removeAllPorts, setClassDefinition, uniqueName, validateSettables |
| Methods inherited from class ptolemy.kernel.InstantiableNamedObj |
_setParent, exportMoML, getChildren, getElementName, getParent, getPrototypeList, isClassDefinition |
| Methods inherited from class ptolemy.kernel.util.NamedObj |
_addAttribute, _attachText, _cloneFixAttributeFields, _debug, _debug, _debug, _debug, _debug, _getIndentPrefix, _isMoMLSuppressed, _markContentsDerived, _propagateValue, _removeAttribute, _splitName, _stripNumericSuffix, addChangeListener, addDebugListener, attributeList, attributeList, deepContains, depthInHierarchy, description, description, event, executeChangeRequests, exportMoML, exportMoML, exportMoML, exportMoML, getAttribute, getAttributes, getChangeListeners, getClassName, getDerivedLevel, getDerivedList, getFullName, getModelErrorHandler, getName, getName, getSource, handleModelError, isDeferringChangeRequests, isOverridden, isPersistent, message, propagateValue, propagateValues, removeChangeListener, removeDebugListener, requestChange, setClassName, setDeferringChangeRequests, setDerivedLevel, setModelErrorHandler, setPersistent, setSource, toplevel, toString, workspace |
| Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface ptolemy.actor.Actor |
getDirector, getExecutiveDirector, getFunctionDependency, getManager, inputPortList, newReceiver, outputPortList |
| Methods inherited from interface ptolemy.actor.Executable |
iterate, postfire, prefire, preinitialize, stop, stopFire, terminate, wrapup |
| Methods inherited from interface ptolemy.kernel.util.Nameable |
description, getContainer, getFullName, getName, getName, setName |
| Methods inherited from interface ptolemy.kernel.util.Derivable |
getDerivedLevel, getDerivedList, propagateValue |
| Field Detail |
public ptolemy.data.expr.Parameter powerPropagationFactor
| Constructor Detail |
public PowerLossChannel(ptolemy.kernel.CompositeEntity container,
java.lang.String name)
throws ptolemy.kernel.util.IllegalActionException,
ptolemy.kernel.util.NameDuplicationException
container - The container.name - The name of the channel.
ptolemy.kernel.util.IllegalActionException - If the container is incompatible.
ptolemy.kernel.util.NameDuplicationException - If the name coincides with
an actor already in the container.| Method Detail |
public ptolemy.data.RecordToken transformProperties(ptolemy.data.RecordToken properties,
WirelessIOPort source,
WirelessIOPort destination)
throws ptolemy.kernel.util.IllegalActionException
transformProperties in interface PropertyTransformertransformProperties in class AtomicWirelessChannelproperties - The transmit properties.source - The sending port.destination - The receiving port.
ptolemy.kernel.util.IllegalActionException - If the properties cannot
be transformed. Not thrown in this base class.AtomicWirelessChannel.registerPropertyTransformer(PropertyTransformer, WirelessIOPort)
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||