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 14 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
106 changes: 106 additions & 0 deletions doc/Analytics.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4350,6 +4350,112 @@ 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 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>
<para>Optionally, device may include additional object track data for e.g. snapshot image as
configured in ObjectTrackDataFilter parameter.</para>
<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>
<para role="param">ReportTimeInterval - optional [xs:duration]</para>
<para role="text">Optional time interval to control update frequency. If omitted only
final aggregation shall be provided.</para>
<para role="param">ObjectTrackDataFilter - optional [tt:StringList]</para>
<para role="text">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.</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">Object - mandatory [tt:Object]</para>
<para role="text">Track aggregation data of an object.</para>
<para role="param">ObjectTrackData - optional, unbounded [tt:ObjectTrackData]</para>
bsriramprasad marked this conversation as resolved.
Show resolved Hide resolved
<para role="text">Optional additional description of an object to provide enriched 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:ObjectTrackAggregation">
<tt:Parameters>
<tt:SimpleItemDescription Name="ClassFilter" Type="tt:StringList"/>
<tt:SimpleItemDescription Name="ConfidenceLevel" Type="xs:float"/>
<tt:SimpleItemDescription Name="ReportTimeInterval" Type="xs:float"/>
<tt:SimpleItemDescription Name="ObjectTrackDataFilter" Type="tt:StringList"/>
</tt:Parameters>
<tt:Messages>
<tt:Source>
...
</tt:Source>
<tt:Data>
<tt:SimpleItemDescription Name="AggregationStart" Type="xs:dateTime"/>
<tt:SimpleItemDescription Name="FinalAggregation" Type="xs:boolean"/>
<tt:ElementItemDescription Name="Object" Type="tt:Object"/>
<tt:ElementItemDescription Name="ObjectTrackData" Type="tt:ObjectTrackData"/>
</tt:Data>
<tt:ParentTopic>tns1:RuleEngine/ObjectTrack/Aggregation</tt:ParentTopic>
</tt:Messages>
</tt:RuleDescription>
]]></programlisting>
<para>The object types may differ between devices. See below for example rule options, based on the description language parameter options defined in <xref linkend="_Toc529533198" />.</para>
<programlisting><![CDATA[<tan:GetRuleOptionsResponse>
<tan:RuleOptions Name="ClassFilter" RuleType="tt:ObjectTrackAggregation">
<tt:StringList>Person Vehicle Face LicensePlate</tt:StringList>
</tan:RuleOptions>
<tan:RuleOptions Name="ConfidenceLevel" RuleType="tt:ObjectTrackAggregation">
<tt:FloatRange>
<tt:Min>0.0</tt:Min>
<tt:Max>100.0</tt:Max>
</tt:FloatRange>
</tan:RuleOptions>
<tan:RuleOptions Name="ReportTimeInterval" RuleType="tt:ObjectTrackAggregation">
<tt:DurationRange >
<tt:Min>PT1S</tt:Min>
<tt:Max>PT1M</tt:Max>
</tt:DurationRange>
</tan:RuleOptions>
<tan:RuleOptions Name="ObjectTrackDataFilter" RuleType="tt:ObjectTrackAggregation">
<tt:StringList>Object/Appearance/Image Object/Appearance/Shape/BoundingBox</tt:StringList>
</tan:RuleOptions>
</tan:GetRuleOptionsResponse>
]]></programlisting>
</section>
</appendix>
Expand Down
8 changes: 8 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 @@ -392,6 +392,14 @@ 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="ObjectTrackData">
<xs:complexContent>
<xs:extension base="tt:Object">
<xs:attribute name="CaptureTime" type="xs:dateTime"/>
<xs:anyAttribute processContents="lax"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<!--===============================-->
<!-- Metadata Streaming Types -->
<!--===============================-->
Expand Down