Skip to content

Video/object track aggregation event #437

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 21 commits into
base: development
Choose a base branch
from
Open

Video/object track aggregation event #437

Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
660da53
Initial version Aggregated object track event proposal
bsriramprasad Jun 18, 2024
33791b5
additional changes
bsriramprasad Jun 20, 2024
e287219
Added parent object ID
bsriramprasad Jun 24, 2024
ec20b93
removed parent id as its included in tt:Object
bsriramprasad Jun 24, 2024
e4152ab
Additional changes based on internal review
bsriramprasad Jun 26, 2024
4dbfcd1
Address review feedback
bsriramprasad Jun 27, 2024
6894d3c
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Aug 15, 2024
18df87d
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Aug 23, 2024
255f872
Addressed VEWG members feedback
bsriramprasad Aug 23, 2024
6072b38
Addressed below changes based on the Bangkok F2F discussions
bsriramprasad Sep 10, 2024
9d7b4dc
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Sep 10, 2024
8152bbf
fixed documentation issues
bsriramprasad Sep 10, 2024
9e129bc
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Sep 30, 2024
98c8542
fixed inconsistent rule type QName
bsriramprasad Oct 1, 2024
9ad4037
Addressed Bosch feedback
bsriramprasad Dec 19, 2024
5e714aa
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Dec 19, 2024
13fcd6a
Added recommendation to enable object track data for sparsely crowded…
bsriramprasad Dec 20, 2024
18b6cdc
Merge branch 'onvif:development' into video/object-track-aggregation-…
bsriramprasad Jan 27, 2025
106aaac
update based on IST F2F discussion
bsriramprasad Mar 11, 2025
b0cf6a7
addressed feedback from IST meetings
bsriramprasad Mar 18, 2025
8751ef8
schema fix and clarifications
bsriramprasad Apr 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 78 additions & 0 deletions doc/Analytics.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4368,6 +4368,84 @@ xmlns:acme="http://www.acme.com/schema">
</tt:ParentTopic>
</tt:Messages>
</tt:RuleDescription>
]]></programlisting>
</section>
<section>
<title>Object Track Aggregation</title>
<para>The Object Track Aggregation rule generates an object track aggregation event for below
listed scenarios </para>
<itemizedlist>
<listitem>
<para> Optionally, Initial aggregation after an object appears OR an Intermediate aggregation in the field of view
or an Intermediate aggregation while the object is present in the field of view.</para>
</listitem>
<listitem>
<para> Final aggregation when the object is no longer visible in the field of view. </para>
</listitem>
</itemizedlist>
<variablelist role="op">
<varlistentry>
<term>Parameters</term>
<listitem>
<para role="param">ClassFilter [tt:StringList]</para>
<para role="text">List of classes to be aggregated.</para>
<para role="param">ConfidenceLevel - optional [xs:float]</para>
<para role="text">Minimum confidence level of object classification for generating
aggregation event. </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Topic</term>
<listitem>
<para role="param">tns1:RuleEngine/ObjectTrack/Aggregation</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Source</term>
<listitem>
<para role="text">See <xref linkend="_msgSource"/></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Data</term>
<listitem>
<para role="param">AggregationStart - mandatory [xs:dateTime] </para>
<para role="text">All aggregation events shall set object track start time as the
AggregationStart time. </para>
<para role="param">AggregationEnd - mandatory [xs:dateTime]</para>
<para role="text">AggregationEnd time is usually set to the the last time the object was
observed before the aggregation. Final aggregation event shall set the field as the
object track end time.</para>
<para role="param">ObjectTrackAggregation - mandatory [tt:Object]</para>
<para role="text">Track aggregation data of an object.</para>
<para role="param">ObjectTrackComplement - optional, unbounded [tt:ObjectTrackComplement]</para>
<para role="text">Optional complementary description of an object to provide additional context.</para>
<para role="param">FinalAggregation - optional [xs:boolean]</para>
<para role="text">Signals TRUE for final aggregation event for the detected
object.</para>
</listitem>
</varlistentry>
</variablelist>
<para>See below example for a Object Track Aggregation definition:</para>
<programlisting><![CDATA[<tt:RuleDescription Name="tt:ObjectAggregation">
<tt:Parameters>
<tt:SimpleItemDescription Name="ClassFilter" Type="tt:StringList"/>
<tt:SimpleItemDescription Name="ConfidenceLevel" Type="xs:float"/>
</tt:Parameters>
<tt:Messages>
<tt:Source>
...
</tt:Source>
<tt:Data>
<tt:SimpleItemDescription Name="AggregationStart" Type="xs:dateTime"/>
<tt:SimpleItemDescription Name="AggregationEnd" Type="xs:dateTime"/>
<tt:SimpleItemDescription Name="FinalAggregation" Type="xs:boolean"/>
<tt:ElementItemDescription Name="ObjectTrackAggregation" Type="tt:Object"/>
<tt:ElementItemDescription Name="ObjectTrackComplement" Type="tt:ObjectTrackComplement"/>
</tt:Data>
<tt:ParentTopic>tns1:RuleEngine/ObjectTrack/Aggregation</tt:ParentTopic>
</tt:Messages>
</tt:RuleDescription>
]]></programlisting>
</section>
</appendix>
Expand Down
28 changes: 28 additions & 0 deletions wsdl/ver10/schema/metadatastream.xsd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -389,6 +389,34 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO
</xs:attribute>
<xs:anyAttribute processContents="lax"/>
</xs:complexType>
<xs:complexType name="ObjectSnapshot">
<xs:sequence>
<xs:element name="ImageRef" type="xs:anyURI" minOccurs="0"/>
<xs:element name="Image" type="xs:base64Binary" minOccurs="0"/>
<xs:element name="BoundingBox" type="tt:Rectangle" minOccurs="0">
<xs:annotation>
<xs:documentation>Bounding box definition in normalized coordinates.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> <!-- first ONVIF then vendor -->
</xs:sequence>
<xs:attribute name="CaptureTime" type="xs:dateTime"/>
<xs:anyAttribute processContents="lax"/>
</xs:complexType>
<xs:complexType name="ObjectTrackComplement">
<xs:sequence>
<xs:element name="Snapshot" type="tt:ObjectSnapshot" minOccurs="0"/>
<xs:element name="Extension" type="tt:ObjectTrackComplementExtension" minOccurs="0"/>
<xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> <!-- reserved for ONVIF -->
</xs:sequence>
<xs:anyAttribute processContents="lax"/>
</xs:complexType>
<xs:complexType name="ObjectTrackComplementExtension">
<xs:sequence>
<xs:any namespace="##targetNamespace" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:anyAttribute processContents="lax"/>
</xs:complexType>
<!--===============================-->
<!-- Metadata Streaming Types -->
<!--===============================-->
Expand Down