[FFmpeg-devel] [PATCH FFmpeg 11/15] doc: avgclass Filter Documentation

[m.kaindl0208 at gmail.com]

Try the new filters using my Github Repo https://github.com/MaximilianKaindl/DeepFFMPEGVideoClassification. 

Any Feedback is appreciated!

Signed-off-by: MaximilianKaindl <m.kaindl0208 at gmail.com>
---
 doc/filters.texi | 64 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/doc/filters.texi b/doc/filters.texi
index b6cccbacb6..bd75982d7d 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -30827,6 +30827,70 @@ ffplay -f lavfi 'amovie=input.mp3, asplit [a][out1];
 
 This filter supports the all above options as commands except options @code{size} and @code{rate}.
 
+ at section avgclass
+
+Average classification probabilities across multiple frames for both audio and video streams.
+
+This filter analyzes classification data from frame side data (bounding boxes) and calculates average confidence scores for each label. The filter processes classification metadata from the @code{dnn_classify} filter or other sources that generate AVDetectionBBox side data, computing averages over the entire stream.
+
+At the end of the stream (or when manually triggered), the filter outputs the average probability for each detected class, both to console logs and optionally to a CSV file.
+
+ at table @option
+ at item output_file
+Path to a CSV output file where average classification results will be written. If not specified, results are only printed to log output.
+
+ at item v
+Specify the number of video streams (default: 1).
+
+ at item a
+Specify the number of audio streams (default: 0).
+ at end table
+
+This filter supports the following commands:
+
+ at table @option
+ at item writeinfo
+Immediately write current average classification results to the log and output file (if specified) without waiting for the stream to end.
+
+ at item flush
+Force the filter to write results and flush all its internal state.
+ at end table
+
+ at subsection Examples
+
+Process a video with object detection and classification, then calculate average classification probabilities:
+ at example
+ffmpeg -i input.mp4 -vf "dnn_detect=model=detection.xml:input=data:output=detection_out:confidence=0.5,dnn_classify=model=classification.pt:dnn_backend=torch:tokenizer=tokenizer.json:labels=labels.txt,avgclass=output_file=results.csv" -f null -
+ at end example
+
+Process both audio and video classification:
+ at example
+ffmpeg -i input.mkv -filter_complex "[0:v]dnn_classify[v0]; [0:a]aformat=sample_fmts=fltp,dnn_classify=dnn_backend=torch:model=clap_model.pt:is_audio=1:tokenizer=tokenizer.json:labels=audio_labels.txt[a0]; [v0][a0]avgclass=v=1:a=1:output_file=av_results.csv" -f null -
+ at end example
+
+ at subsection Output Format
+
+When the filter completes processing (or when the @code{writeinfo} command is sent), it outputs classification results in this format:
+
+ at example
+Classification averages:
+Stream #0:
+  Label: cat: Average probability 0.8765, Appeared 120 times
+  Label: dog: Average probability 0.3421, Appeared 42 times
+Stream #1:
+  Label: music: Average probability 0.9823, Appeared 315 times
+  Label: speech: Average probability 0.1245, Appeared 15 times
+ at end example
+
+If an output file is specified, the same data is written in CSV format:
+ at example
+stream_id,label,avg_probability,count
+0,cat,0.8765,120
+0,dog,0.3421,42
+1,music,0.9823,315
+1,speech,0.1245,15
+ at end example
+
 @section bench, abench
 
 Benchmark part of a filtergraph.
-- 
2.34.1