Add bytes_per_sample_hint parameter to parallel external source

[stiepan]

Signed-off-by: Kamil Tokarski [email protected]

Category:

New feature (non-breaking change which adds functionality)

Description:

Adds a new parameter to parallel external source to enable user to provide a hint as to the sample size. This way parallel external source can precompute more resonalbe estimation of the required shared memory size and prevent DALI from reallocating the memory during pipeline run. When adjusting shm size, DALI at least doubles the size of a given chunk, so providing more accurate size explicitly can result in less memory consumption.

Additional information:

Affected modules and functionalities:

Key points relevant for the review:

Tests:

• [ ] Existing tests apply
• [x] New tests added
  • [x] Python tests
  • [ ] GTests
  • [ ] Benchmark
  • [ ] Other
• [ ] N/A

Checklist

Documentation

• [ ] Existing documentation applies
• [x] Documentation updated
  • [x] Docstring
  • [ ] Doxygen
  • [ ] RST
  • [ ] Jupyter
  • [ ] Other
• [ ] N/A

DALI team only

Requirements

• [ ] Implements new requirements
• [ ] Affects existing requirements
• [x] N/A

REQ IDs: N/A

JIRA TASK: DALI-2960

[stiepan]

!build

[dali-automaton]

CI MESSAGE: [5655422]: BUILD STARTED

[dali-automaton]

CI MESSAGE: [5655422]: BUILD PASSED

[stiepan]

!build

[dali-automaton]

CI MESSAGE: [6054183]: BUILD STARTED

[dali-automaton]

CI MESSAGE: [6054183]: BUILD FAILED

[stiepan]

!build

[dali-automaton]

CI MESSAGE: [6055571]: BUILD STARTED

[dali-automaton]

CI MESSAGE: [6055571]: BUILD PASSED

[stiepan]

!build

[dali-automaton]

CI MESSAGE: [6695427]: BUILD STARTED

[dali-automaton]

CI MESSAGE: [6695427]: BUILD FAILED

[stiepan]

!build

[dali-automaton]

CI MESSAGE: [6703496]: BUILD STARTED

[dali-automaton]

CI MESSAGE: [6703496]: BUILD PASSED