Skip to content
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

Video/object track aggregation event #437

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

Video/object track aggregation event #437

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
18 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
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
81 changes: 81 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,87 @@ 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
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
listed scenarios </para>
<itemizedlist>
<listitem>
<para> Optionally, Initial aggregation after an object appears in the field of view. </para>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
</listitem>
<listitem>
<para> Optionally, 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>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
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>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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"/>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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" />
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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
24 changes: 24 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,30 @@ 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"/>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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">
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<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