sample(image) -> bounding_box

    Yields an iterator over all bounding boxes in different scales that are sampled for the given image.

    **Parameters:**

    ``image`` : array_like(2D or 3D)
      The image, for which the bounding boxes should be generated

    **Yields:**

    ``bounding_box`` : :py:class:`BoundingBox`
      An iterator iterating over all bounding boxes for the given ``image``

def sample(self, image):
    """sample(image) -> bounding_box

    Yields an iterator over all bounding boxes in different scales that are sampled for the given image.

    **Parameters:**

    ``image`` : array_like(2D or 3D)
      The image, for which the bounding boxes should be generated

    **Yields:**

    ``bounding_box`` : :py:class:`BoundingBox`
      An iterator iterating over all bounding boxes for the given ``image``
    """
    for scale, scaled_image_shape in self.scales(image):
      # prepare the feature extractor to extract features from the given image
      for bb in self.sample_scaled(scaled_image_shape):
        # extract features for
        yield bb.scale(1./scale)