search

sepinf-inc / IPED

IPED Digital Forensic Tool. It is an open source software that can be used to process and analyze digital evidence, often seized at crime scenes by law enforcement or in a corporate investigation by private examiners.
Other
948 stars 218 forks source link

Audio Transcript heuristic for dynamic thread allocation on client #2023

Open gfd2020 opened 9 months ago

gfd2020 commented 9 months ago

This PR implements a heuristic that always tries to keep the remote audio transcription server busy while not leaving the client idle. I believe that this heuristic should only be turned on when the remote transcription server is slow. For fast servers, it might be better to leave it turned off.

It is based on 3 principles:

1) Dynamically adjust the number of remote transcription threads based on server response speed.

2) Rearrange the audio items so that they are spread across the queue, this will help the client to always have some processing instead of standing still or only carrying out the work at the end.

3) The client will also help the server with the transcription task, only if the client has no other tasks to do.

This heuristic must be configured in the 'AudioTranscriptConfig.txt' configuration file:

Performs a heuristic for dynamic thread allocation and spaced requeue. Helps improve performance of slow transcription servers.

clientDynamicThreadRequeueHeuristics = true

If active, the client will also help the server with the transcription task, only if the client has no other tasks to do. The heuristic must be turned on

clientTranscriptHelp = true

Defines the implementation class for client help, must be a local implementation ( not remote transcript task )

clientTranscriptHelpImplementationClass = iped.engine.task.transcript.Wav2Vec2TranscriptTask

Advanced Parameter. Defines which part of the queue the items will be sent to. 4 = 1/4 size. Values ​​greater than or equal to 1

clientSplitQueueRatio = 4

Advanced Parameter. Sets the delta time in milliseconds when consecutive items are requested to be requeued, provides better spacing.

clientRequeueDeltaTime = 5000

To test the PR, the parameters must be uncommented, by default they are turned off. Audio transcription must be turned on and configured as usual.

Teste Cases: Any UFDR report with multiple processing items in addition to audio to be transcribed.

lfcnassif commented 9 months ago

Thank you @gfd2020! I think I'll have time to review this just when I return back from vacation next year, in the second half of January, if no other dev reviews it before me.