class_docstr: A class whose objects contains image data, meta-data, and supports useful
  utility methods. This is intended to make image pre-processing easier for
  input into subsequent learning methods. Supports reading of JPEG and PNG
  formats.
  
  
  Parameters
  ----------
  
  path : string
      The path of the location of the image file to be loaded into the Image
      object.
  
  format : {'auto' | 'JPG' | 'PNG'}, optional
      Defaults to 'auto'. A format hint for the constructor. If left as
      'auto', constructor tries to infer file format from file extension.
      Otherwise, tries to decode file as whatever the format hint suggests.
  
  See Also
  --------
  turicreate.image_analysis.load_images
  turicreate.image_analysis.resize
  
  Examples
  --------
  >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
  >>> turicreate.SArray([img]).show()
class_docstr_tok: ["A","class","whose","objects","contains","image","data",",","meta-data",",","and","supports","useful","utility","methods",".","This","is","intended","to","make","image","pre-processing","easier","for","input","into","subsequent","learning","methods",".","Supports","reading","of","JPEG","and","PNG","formats",".","Parameters","--","--","--","--","--","path",":","string","The","path","of","the","location","of","the","image","file","to","be","loaded","into","the","Image","object",".","format",":","{","'auto","'","|","'JPG","'","|","'PNG","'","}",",","optional","Defaults","to","'auto","'",".","A","format","hint","for","the","constructor",".","If","left","as","'auto","'",",","constructor","tries","to","infer","file","format","from","file","extension",".","Otherwise",",","tries","to","decode","file","as","whatever","the","format","hint","suggests",".","See","Also","--","--","--","--","turicreate.image_analysis.load_images","turicreate.image_analysis.resize","Examples","--","--","--","--",">",">",">","img","=","turicreate.Image","(","'https",":","\/\/static.turi.com\/datasets\/images\/sample.jpg","'",")",">",">",">","turicreate.SArray","(","[","img","]",")",".show","(",")"]
docstr: Returns the pixel data stored in the Image object.
  
  Returns
  -------
  out : numpy.array
      The pixel data of the Image object. It returns a multi-dimensional
      numpy array, where the shape of the array represents the shape of
      the image (height, weight, channels).
  
  See Also
  --------
  width, channels, height
  
  Examples
  --------
  >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
  >>> image_array = img.pixel_data
docstr_tok: ["Returns","the","pixel","data","stored","in","the","Image","object",".","Returns","--","--","--","-","out",":","numpy.array","The","pixel","data","of","the","Image","object",".","It","returns","a","multi-dimensional","numpy","array",",","where","the","shape","of","the","array","represents","the","shape","of","the","image","(","height",",","weight",",","channels",")",".","See","Also","--","--","--","--","width",",","channels",",","height","Examples","--","--","--","--",">",">",">","img","=","turicreate.Image","(","'https",":","\/\/static.turi.com\/datasets\/images\/sample.jpg","'",")",">",">",">","image_array","=","img.pixel_data"]
code: def pixel_data(self):
      """
      Returns the pixel data stored in the Image object.
  
      Returns
      -------
      out : numpy.array
          The pixel data of the Image object. It returns a multi-dimensional
          numpy array, where the shape of the array represents the shape of
          the image (height, weight, channels).
  
      See Also
      --------
      width, channels, height
  
      Examples
      --------
      >>> img = turicreate.Image('https://static.turi.com/datasets/images/sample.jpg')
      >>> image_array = img.pixel_data
      """
  
      from .. import extensions as _extensions
  
      data = _np.zeros(
          (self.height, self.width, self.channels), dtype=_np.uint8
      )
      _extensions.image_load_to_numpy(
          self, data.ctypes.data, data.strides
      )
      if self.channels == 1:
          data = data.squeeze(2)
      return data
  
file_path: turicreate/src/python/turicreate/data_structures/image.py
imports: from __future__ import print_function
  from __future__ import division
  from __future__ import absolute_import
  from .._deps import numpy
label_desc: Use image node_id 5 for calling the Image obj's underlying member method code with example usage: obj.pixel_data() and returns: data