Improve functionality to organize long lists of DICOM data into patient, cycle, timepoint

[carluri]

Extracted DICOM file organization logic from DICOMReceiver into a standalone dicom_organizer module, achieving clean separation of concerns and eliminating code duplication.

[Copilot]

Pull request overview

Refactors DICOM post-processing so DICOM file organization (patient → cycle → timepoint) is implemented in a standalone dicom_organizer module and reused by DICOMReceiver.

Changes:

• Extracted and generalized cycle/timepoint organization into pytheranostics/dicomtools/dicom_organizer.py.
• Updated DICOMReceiver to call the shared organizer for auto-organize behavior.
• Added Sphinx documentation/tutorial page for the new organizer utilities and exposed them at the package level.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
pytheranostics/dicomtools/dicom_receiver.py	Switches auto-organize logic to call the new shared organizer API.
pytheranostics/dicomtools/dicom_organizer.py	New module implementing recursive DICOM organization and summarization utilities.
pytheranostics/dicomtools/__init__.py	Exposes organizer utilities as package-level imports.
docs/source/tutorials/index.rst	Adds the new DICOM organization tutorial to the docs TOC.
docs/source/tutorials/dicom_organization/dicom_organization.rst	New tutorial documenting usage, parameters, and examples.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.