docstr: A generator that finds all images that overlap the bounded
  target location.
  
  Parameters
  ----------
  target_domain
      A :class:`~shapely.geometry.linestring.LineString` instance that
      specifies the target location requiring image coverage.
  
  target_z
      The name of the target
      :class:`~cartopy.io.img_nest.ImageCollection` which specifies
      the target zoom level (resolution) of the required images.
  start_tiles: optional
      A list of one or more tuple pairs, composed of a
      :class:`~cartopy.io.img_nest.ImageCollection` name and an
      :class:`~cartopy.io.img_nest.Img` instance, from which to search
      for the target images.
  
  Returns
  -------
  generator
      A generator tuple pair composed of a
      :class:`~cartopy.io.img_nest.ImageCollection` name and an
      :class:`~cartopy.io.img_nest.Img` instance.
docstr_tok: ["A","generator","that","finds","all","images","that","overlap","the","bounded","target","location",".","Parameters","--","--","--","--","--","target_domain","A",":","class",":","`","~shapely.geometry.linestring.LineString","`","instance","that","specifies","the","target","location","requiring","image","coverage",".","target_z","The","name","of","the","target",":","class",":","`","~cartopy.io.img_nest.ImageCollection","`","which","specifies","the","target","zoom","level","(","resolution",")","of","the","required","images",".","start_tiles",":","optional","A","list","of","one","or","more","tuple","pairs",",","composed","of","a",":","class",":","`","~cartopy.io.img_nest.ImageCollection","`","name","and","an",":","class",":","`","~cartopy.io.img_nest.Img","`","instance",",","from","which","to","search","for","the","target","images",".","Returns","--","--","--","-","generator","A","generator","tuple","pair","composed","of","a",":","class",":","`","~cartopy.io.img_nest.ImageCollection","`","name","and","an",":","class",":","`","~cartopy.io.img_nest.Img","`","instance","."]
code: def find_images(self, target_domain, target_z, start_tiles=None):
      """
      A generator that finds all images that overlap the bounded
      target location.
  
      Parameters
      ----------
      target_domain
          A :class:`~shapely.geometry.linestring.LineString` instance that
          specifies the target location requiring image coverage.
  
      target_z
          The name of the target
          :class:`~cartopy.io.img_nest.ImageCollection` which specifies
          the target zoom level (resolution) of the required images.
      start_tiles: optional
          A list of one or more tuple pairs, composed of a
          :class:`~cartopy.io.img_nest.ImageCollection` name and an
          :class:`~cartopy.io.img_nest.Img` instance, from which to search
          for the target images.
  
      Returns
      -------
      generator
          A generator tuple pair composed of a
          :class:`~cartopy.io.img_nest.ImageCollection` name and an
          :class:`~cartopy.io.img_nest.Img` instance.
  
      """
      # XXX Copied from cartopy.io.img_tiles
      if target_z not in self._collections_by_name:
          # TODO: Handle integer depths also?
          raise ValueError(
              f"{target_z!r} is not one of the possible collections."
          )
  
      if start_tiles is None:
          start_tiles = (
              (self._collections[0].name, img)
              for img in self._collections[0].images
          )
  
      for start_tile in start_tiles:
          # recursively drill down to the images at the target zoom
          domain = start_tile[1].bbox()
          if target_domain.intersects(
              domain
          ) and not target_domain.touches(domain):
              if start_tile[0] == target_z:
                  yield start_tile
              else:
                  for tile in self.subtiles(start_tile):
                      yield from self.find_images(
                          target_domain, target_z, start_tiles=[tile]
                      )
  
imports: import collections
  from pathlib import Path
  import numpy
  from PIL import Image
  import shapely.geometry
label_desc: Use image node_id 4 for calling the NestedImageCollection obj's underlying member method code with example usage: obj.find_images(target_domain, target_z, start_tiles) without return types