class_docstr: Reads basic image formats using ImageIO.
class_docstr_tok: ["Reads","basic","image","formats","using","ImageIO","."]
docstr: Read a single plane from the image file.
  :param c: read from this channel. `None` = read color image if multichannel
      or interleaved RGB.
  :param z: z-stack index
  :param t: time index
  :param series: series for ``.flex`` and similar multi-stack formats
  :param index: if `None`, fall back to ``zct``, otherwise load the indexed frame
  :param rescale: `True` to rescale the intensity scale to 0 and 1; `False` to
            return the raw values native to the file.
  :param xywh: a (x, y, w, h) tuple
  :param wants_max_intensity: if `False`, only return the image; if `True`,
            return a tuple of image and max intensity
  :param channel_names: provide the channel names for the OME metadata
docstr_tok: ["Read","a","single","plane","from","the","image","file",".",":","param","c",":","read","from","this","channel",".","`","None","`","=","read","color","image","if","multichannel","or","interleaved","RGB",".",":","param","z",":","z-stack","index",":","param","t",":","time","index",":","param","series",":","series","for","``",".flex","``","and","similar","multi-stack","formats",":","param","index",":","if","`","None","`",",","fall","back","to","``","zct","``",",","otherwise","load","the","indexed","frame",":","param","rescale",":","`","True","`","to","rescale","the","intensity","scale","to","0","and","1",";","`","False","`","to","return","the","raw","values","native","to","the","file",".",":","param","xywh",":","a","(","x",",","y",",","w",",","h",")","tuple",":","param","wants_max_intensity",":","if","`","False","`",",","only","return","the","image",";","if","`","True","`",",","return","a","tuple","of","image","and","max","intensity",":","param","channel_names",":","provide","the","channel","names","for","the","OME","metadata"]
code: def read(
      self,
      series=None,
      index=None,
      c=None,
      z=None,
      t=None,
      rescale=True,
      xywh=None,
      wants_max_intensity=False,
      channel_names=None,
  ):
      """Read a single plane from the image file.
      :param c: read from this channel. `None` = read color image if multichannel
          or interleaved RGB.
      :param z: z-stack index
      :param t: time index
      :param series: series for ``.flex`` and similar multi-stack formats
      :param index: if `None`, fall back to ``zct``, otherwise load the indexed frame
      :param rescale: `True` to rescale the intensity scale to 0 and 1; `False` to
                return the raw values native to the file.
      :param xywh: a (x, y, w, h) tuple
      :param wants_max_intensity: if `False`, only return the image; if `True`,
                return a tuple of image and max intensity
      :param channel_names: provide the channel names for the OME metadata
      """
      reader = self.get_reader()
      if series is None:
          series = 0
      data = reader.get_data(series)
      if c is not None and len(data.shape) > 2:
          data = data[:, :, c, ...]
      elif c is None and len(data.shape) > 2 and data.shape[2] == 4:
          # Remove alpha channel
          data = data[:, :, :3, ...]
      if rescale:
          imax = self.find_scale_to_match_bioformats(data)
          data = data.astype(numpy.float32) / float(imax)
          if wants_max_intensity:
              return data, 1
          return data
      if wants_max_intensity:
          return data, numpy.iinfo(data.dtype).max
      return data
  
file_path: CellProfiler/src/subpackages/core/cellprofiler_core/readers/imageio_reader.py
imports: import collections
  import numpy
  import imageio
  from ..constants.image import MD_SIZE_S, MD_SIZE_C, MD_SIZE_Z, MD_SIZE_T, MD_SIZE_Y, MD_SIZE_X
  from ..preferences import config_read_typed
  from ..reader import Reader
label_desc: Use image node_id 4 for calling the ImageIOReader obj's underlying member method code with example usage: obj.read(series, index, c, z, t, rescale, xywh, wants_max_intensity, channel_names) and returns: data, data, data,  numpy, data,  int