Feat : Added support for core set frame list dumping and computed state dumping and loading

[AdityaSinghDevs]

Summary

Summary of changes made to NDR transform plugin:

Added functionality to:

1. Support core set frame list dumping via new CLI options and methods:

   • get_core_set_item_ids()
   • save_core_set_item_ids()

2. Enable computed state handling for multiple input sources:

   • append_state()
   • compute_state()

Added corresponding CLI arguments:

• --save_media : Saves Core set frame list in directory
• --output_dir : Specify directory to save the media files.

These changes allow efficient processing of large video datasets by:

• Enabling frame list exports for further analysis
• Supporting state management across multiple sources without RAM constraints

Resolves #140

How to test

Process dataset with multiple video sources using:
python ndr.py --save-core-set core_frames.list --save-deduplicated dedup.list output_dir

Verify outputs:

1. Check core_frames.list contains selected frame IDs
2. Verify dedup.list contains deduplicated frame IDs
3. Confirm output_dir structure matches expected format

Test with large datasets:

1. Use multiple video sequences >100k frames
2. Verify memory usage remains stable
3. Confirm state management works across sources

Checklist

• I have added unit tests to cover my changes.​
• I have added integration tests to cover my changes.​
• I have added the description of my changes into CHANGELOG.​
• I have updated the documentation accordingly

License

• I submit my code changes under the same MIT License that covers the project.
  Feel free to contact the maintainers if that's a concern.
• I have updated the license header for each file