class_docstr: Container for all keypoints on a single image.
  
  Parameters
  ----------
  keypoints : list of imgaug.augmentables.kps.Keypoint
      List of keypoints on the image.
  
  shape : tuple of int
      The shape of the image on which the objects are placed, i.e. the
      result of ``image.shape``.
      Should include the number of channels, not only height and width.
  
  Examples
  --------
  >>> import numpy as np
  >>> from imgaug.augmentables.kps import Keypoint, KeypointsOnImage
  >>>
  >>> image = np.zeros((70, 70))
  >>> kps = [Keypoint(x=10, y=20), Keypoint(x=34, y=60)]
  >>> kps_oi = KeypointsOnImage(kps, shape=image.shape)
class_docstr_tok: ["Container","for","all","keypoints","on","a","single","image",".","Parameters","--","--","--","--","--","keypoints",":","list","of","imgaug.augmentables.kps.Keypoint","List","of","keypoints","on","the","image",".","shape",":","tuple","of","int","The","shape","of","the","image","on","which","the","objects","are","placed",",","i.e",".","the","result","of","``","image.shape","``",".","Should","include","the","number","of","channels",",","not","only","height","and","width",".","Examples","--","--","--","--",">",">",">","import","numpy","as","np",">",">",">","from","imgaug.augmentables.kps","import","Keypoint",",","KeypointsOnImage",">",">",">",">",">",">","image","=","np.zeros","(","(","70",",","70",")",")",">",">",">","kps","=","[","Keypoint","(","x=10",",","y=20",")",",","Keypoint","(","x=34",",","y=60",")","]",">",">",">","kps_oi","=","KeypointsOnImage","(","kps",",","shape=image.shape",")"]
docstr: Invert the output of ``to_keypoints_on_image()`` in-place.
  
  This function writes in-place into this ``KeypointsOnImage``
  instance.
  
  Added in 0.4.0.
  
  Parameters
  ----------
  kpsoi : imgaug.augmentables.kps.KeypointsOnImages
      Keypoints to copy data from, i.e. the outputs of
      ``to_keypoints_on_image()``.
  
  Returns
  -------
  KeypointsOnImage
      Keypoints container with updated coordinates.
      Note that the instance is also updated in-place.
docstr_tok: ["Invert","the","output","of","``","to_keypoints_on_image","(",")","``","in-place",".","This","function","writes","in-place","into","this","``","KeypointsOnImage","``","instance",".","Added","in","0.4.0",".","Parameters","--","--","--","--","--","kpsoi",":","imgaug.augmentables.kps.KeypointsOnImages","Keypoints","to","copy","data","from",",","i.e",".","the","outputs","of","``","to_keypoints_on_image","(",")","``",".","Returns","--","--","--","-","KeypointsOnImage","Keypoints","container","with","updated","coordinates",".","Note","that","the","instance","is","also","updated","in-place","."]
code: def invert_to_keypoints_on_image_(self, kpsoi):
      """Invert the output of ``to_keypoints_on_image()`` in-place.
  
      This function writes in-place into this ``KeypointsOnImage``
      instance.
  
      Added in 0.4.0.
  
      Parameters
      ----------
      kpsoi : imgaug.augmentables.kps.KeypointsOnImages
          Keypoints to copy data from, i.e. the outputs of
          ``to_keypoints_on_image()``.
  
      Returns
      -------
      KeypointsOnImage
          Keypoints container with updated coordinates.
          Note that the instance is also updated in-place.
  
      """
      nb_points_exp = len(self.keypoints)
      assert (
          len(kpsoi.keypoints) == nb_points_exp
      ), "Expected %d coordinates, got %d." % (
          nb_points_exp,
          len(kpsoi.keypoints),
      )
  
      for kp_target, kp_source in zip(self.keypoints, kpsoi.keypoints):
          kp_target.x = kp_source.x
          kp_target.y = kp_source.y
  
      self.shape = kpsoi.shape
      return self
  
imports: from __future__ import print_function, division, absolute_import
  import numpy
  import scipy.spatial.distance
  import six.moves
  from ..None import imgaug
  from .base import IAugmentable
  from .utils import normalize_imglike_shape, project_coords, _remove_out_of_image_fraction_, _handle_on_image_shape
label_desc: Use image node_id 26 for calling the KeypointsOnImage obj's underlying member method code with example usage: obj.invert_to_keypoints_on_image_(kpsoi) and returns: self