allow ROIs bigger than image for RandCropByPosNegLabel and RandCropByLabelClasses

[rijobro]

Currently, if an image is already bigger than the requested padded ROI, by default we leave the image unchanged in that dimension.

Conversely, if an image is smaller than the requested ROI for RandCropByPosNegLabel and RandCropByLabelClasses, we throw an error. This is inconvenient for datasets of inhomogeneous shapes. For example, I might say "if an image is bigger than (100,100,100), then crop to this size. If it's smaller, then leave it as-is".

Currently, this is not possible in MONAI, so this PR adds allow_smaller. If True, any dimension smaller than the requested crop size won't be cropped, instead of raising an exception.

Default is set to False to keep backwards compatibility.

Status

Ready

Types of changes

• Non-breaking change (fix or new feature that would not break existing functionality).
• New tests added to cover the changes.
• Integration tests passed locally by running ./runtests.sh -f -u --net --coverage.
• Quick tests passed locally by running ./runtests.sh --quick --unittests.
• In-line docstrings updated.
• Documentation updated, tested make html command in the docs/ folder.

[wyli]

/build

[wyli]

Thanks, this is a non-breaking usability improvement, looks good to me.