diff --git a/doc/Analytics.xml b/doc/Analytics.xml index 998957944..fd0c028bd 100644 --- a/doc/Analytics.xml +++ b/doc/Analytics.xml @@ -4452,6 +4452,131 @@ xmlns:acme="http://www.acme.com/schema"> +]]> + +
+ Object Track Aggregation + This event is intended to describe an object throughout visible duration within a scene. + The description should include aggregated or summarized information along with contextual + data, such as images or bounding boxes, to assist clients in visualizing the object's + trajectory. This event can complement per-frame, per-object scene description by providing a + higher-level representation of the object’s trajectory, enhancing forensic analysis while + optimizing bandwidth consumption. + It is recommended to enable ObjectTrack data in sparsely crowded scenes to optimize data + produced from the device. + The process by which device aggregates object track data for a given object is out of + scope of this specification. + The Object Track Aggregation rule generates an object track aggregation event for below + listed scenarios + + + Optionally, Initial aggregation after an object appears OR an Intermediate + aggregation while the object is present in the field of view. + + + Final aggregation when the object is no longer visible in the field of view. + + + Optionally, device may include additional object track data for e.g. snapshot image as + configured in ObjectTrackDataFilter parameter. + If an initial or intermediate aggregation is sent for an object, Final aggregation event + for that object shall be sent even if final classification does not meet class or threshold + filters in rule configuration. + Device should fill in aggregated tt:Object structure with data qualified as + classifications for e.g. Vehicle or License plate and should not fill in temporal data like + speed etc., as they are not meaningful in the aggregation context. + In order to reinforce aggregation data, Device should use ObjectTrack tt:Object + structure to provide interesting observations captured at various time instances within the + track duration like cropped object image etc., + + + Parameters + + ClassFilter [tt:StringList] + List of classes to be aggregated. + ConfidenceLevel - optional [xs:float] + Minimum confidence level of object classification for generating + aggregation event. + ReportTimeInterval - optional [xs:duration] + Optional time interval to control update frequency. If omitted the + final aggregation shall be provided, intermediates optionally provided. + ObjectTrackDataFilter - optional [tt:StringList] + Optional list of object tree elements expressed as xpath filter for + e.g. "Object/Appearance/Image" to be included in Object track data. If omitted, + ObjectTrackData shall not be provided. + + + + Topic + + tns1:RuleEngine/ObjectTrack/Aggregation + + + + Source + + See + + + + Data + + AggregationStart - mandatory [xs:dateTime] + All aggregation events shall set object track start time as the + AggregationStart time. + Object - mandatory [tt:Object] + Track aggregation data of an object. + ObjectTrack - optional [tt:ObjectTrack] + Optional additional description of an object to provide enriched context. + Final - optional [xs:boolean] + Signals TRUE for final aggregation event for the detected + object. + + + + See below example for an Object Track Aggregation definition: + + + + + + + + + + ... + + + + + + + + tns1:RuleEngine/ObjectTrack/Aggregation + + +]]> + The object types may differ between devices. See below for example rule options, based on the description language parameter options defined in . + + + Person Vehicle Face LicensePlate + + + + 0.0 + 100.0 + + + + + PT1S + PT1M + + + + Object/Appearance/Image Object/Appearance/Shape/BoundingBox + + ]]>
diff --git a/wsdl/ver10/schema/metadatastream.xsd b/wsdl/ver10/schema/metadatastream.xsd index d5c25728a..f29f14950 100644 --- a/wsdl/ver10/schema/metadatastream.xsd +++ b/wsdl/ver10/schema/metadatastream.xsd @@ -411,6 +411,28 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + An Object track includes a sequence of object states representing how an object's state changes over time. + + + + + + + + + + An object state describes an object's condition, for e.g position, speed and appearance, at a certain time instance. + + + + + + + +