Core Module

Composition Module

class bio_volumentations.core.composition.Compose(transforms, p=1.0, img_keywords=('image',), mask_keywords=('mask',), fmask_keywords=('float_mask',), keypoints_keywords=('keypoints',), bboxes_keywords=('bboxes',), value_keywords=('value',), conversion=None)[source]

Bases: object

Compose a list of transformations into a callable transformation pipeline.

It is strongly recommended to use Compose to define and use the transformation pipeline.

In addition, basic input image checks and conversions are performed. Optionally, datatype conversion (e.g. from numpy.ndarray to torch.Tensor) is performed.

Parameters:
  • transforms (List[Transform]) – A list of transforms (objects of type Transform).

  • p (float, optional) –

    The chance of applying the whole pipeline.

    Defaults to 1.

  • img_keywords (Tuple[str], optional) –

    List of image target names.

    Defaults to ('image',).

  • mask_keywords (Tuple[str], optional) –

    List of mask target names.

    Defaults to ('mask',).

  • fmask_keywords (Tuple[str], optional) –

    List of float mask target names.

    Defaults to ('float_mask',).

  • keypoints_keywords (Tuple[str], optional) –

    List of key points target names.

    Defaults to ('keypoints',).

  • bboxes_keywords (Tuple[str], optional) –

    List of bounding boxes target names.

    Defaults to ('bboxes',).

  • value_keywords (Tuple[str], optional) –

    List of value target names.

    Defaults to ('value',).

  • conversion (Transform | None, optional) –

    Image datatype conversion transform, applied after the transformations.

    Defaults to None.

get_always_apply_transforms()[source]

Transforms Interface Module

class bio_volumentations.core.transforms_interface.DualTransform(always_apply=False, p=0.5)[source]

Bases: Transform

The base class of transformations applied images and also to all target types.

Targets:

image, mask, float mask, key points, bounding boxes

apply_to_bboxes(bboxes, **params)[source]
apply_to_float_mask(float_mask, **params)[source]
apply_to_keypoints(keypoints, keep_all=False, **params)[source]
apply_to_mask(mask, **params)[source]
class bio_volumentations.core.transforms_interface.ImageOnlyTransform(always_apply=False, p=0.5)[source]

Bases: Transform

The base class of transformations applied to the image target only.

Targets:

image

property targets
class bio_volumentations.core.transforms_interface.Transform(always_apply=False, p=0.5)[source]

Bases: object

The base class for transformations.

Parameters:
  • always_apply (bool, optional) –

    Always apply this transformation.

    Defaults to False.

  • p (float, optional) –

    Chance of applying this transformation.

    Defaults to 0.5.

apply(volume, **params)[source]
get_params(**data)[source]