class_docstr: Models datasets with uniform spacing in the three coordinate directions.
  
  Can be initialized in one of several ways:
  
  - Create empty grid
  - Initialize from a vtk.vtkImageData object
  - Initialize based on dimensions, cell spacing, and origin.
  
  .. versionchanged:: 0.33.0
      First argument must now be either a path or
      ``vtk.vtkImageData``. Use keyword arguments to specify the
      dimensions, spacing, and origin of the uniform grid.
  
  .. versionchanged:: 0.37.0
      The ``dims`` parameter has been renamed to ``dimensions``.
  
  Parameters
  ----------
  uinput : str, vtk.vtkImageData, pyvista.ImageData, optional
      Filename or dataset to initialize the uniform grid from.  If
      set, remainder of arguments are ignored.
  
  dimensions : sequence[int], optional
      Dimensions of the uniform grid.
  
  spacing : sequence[float], default: (1.0, 1.0, 1.0)
      Spacing of the uniform grid in each dimension. Must be positive.
  
  origin : sequence[float], default: (0.0, 0.0, 0.0)
      Origin of the uniform grid.
  
  deep : bool, default: False
      Whether to deep copy a ``vtk.vtkImageData`` object.  Keyword only.
  
  Examples
  --------
  Create an empty ImageData.
  
  >>> import pyvista as pv
  >>> grid = pv.ImageData()
  
  Initialize from a ``vtk.vtkImageData`` object.
  
  >>> import vtk
  >>> vtkgrid = vtk.vtkImageData()
  >>> grid = pv.ImageData(vtkgrid)
  
  Initialize using just the grid dimensions and default
  spacing and origin. These must be keyword arguments.
  
  >>> grid = pv.ImageData(dimensions=(10, 10, 10))
  
  Initialize using dimensions and spacing.
  
  >>> grid = pv.ImageData(
  ...     dimensions=(10, 10, 10),
  ...     spacing=(2, 1, 5),
  ... )
  
  Initialize using dimensions, spacing, and an origin.
  
  >>> grid = pv.ImageData(
  ...     dimensions=(10, 10, 10),
  ...     spacing=(2, 1, 5),
  ...     origin=(10, 35, 50),
  ... )
  
  Initialize from another ImageData.
  
  >>> grid = pv.ImageData(
  ...     dimensions=(10, 10, 10),
  ...     spacing=(2, 1, 5),
  ...     origin=(10, 35, 50),
  ... )
  >>> grid_from_grid = pv.ImageData(grid)
  >>> grid_from_grid == grid
  True
class_docstr_tok: ["Models","datasets","with","uniform","spacing","in","the","three","coordinate","directions",".","Can","be","initialized","in","one","of","several","ways",":","-","Create","empty","grid","-","Initialize","from","a","vtk.vtkImageData","object","-","Initialize","based","on","dimensions",",","cell","spacing",",","and","origin",".","..","versionchanged",":",":","0.33.0","First","argument","must","now","be","either","a","path","or","``","vtk.vtkImageData","``",".","Use","keyword","arguments","to","specify","the","dimensions",",","spacing",",","and","origin","of","the","uniform","grid",".","..","versionchanged",":",":","0.37.0","The","``","dims","``","parameter","has","been","renamed","to","``","dimensions","``",".","Parameters","--","--","--","--","--","uinput",":","str",",","vtk.vtkImageData",",","pyvista.ImageData",",","optional","Filename","or","dataset","to","initialize","the","uniform","grid","from",".","If","set",",","remainder","of","arguments","are","ignored",".","dimensions",":","sequence","[","int","]",",","optional","Dimensions","of","the","uniform","grid",".","spacing",":","sequence","[","float","]",",","default",":","(","1.0",",","1.0",",","1.0",")","Spacing","of","the","uniform","grid","in","each","dimension",".","Must","be","positive",".","origin",":","sequence","[","float","]",",","default",":","(","0.0",",","0.0",",","0.0",")","Origin","of","the","uniform","grid",".","deep",":","bool",",","default",":","False","Whether","to","deep","copy","a","``","vtk.vtkImageData","``","object",".","Keyword","only",".","Examples","--","--","--","--","Create","an","empty","ImageData",".",">",">",">","import","pyvista","as","pv",">",">",">","grid","=","pv.ImageData","(",")","Initialize","from","a","``","vtk.vtkImageData","``","object",".",">",">",">","import","vtk",">",">",">","vtkgrid","=","vtk.vtkImageData","(",")",">",">",">","grid","=","pv.ImageData","(","vtkgrid",")","Initialize","using","just","the","grid","dimensions","and","default","spacing","and","origin",".","These","must","be","keyword","arguments",".",">",">",">","grid","=","pv.ImageData","(","dimensions=","(","10",",","10",",","10",")",")","Initialize","using","dimensions","and","spacing",".",">",">",">","grid","=","pv.ImageData","(","...","dimensions=","(","10",",","10",",","10",")",",","...","spacing=","(","2",",","1",",","5",")",",","...",")","Initialize","using","dimensions",",","spacing",",","and","an","origin",".",">",">",">","grid","=","pv.ImageData","(","...","dimensions=","(","10",",","10",",","10",")",",","...","spacing=","(","2",",","1",",","5",")",",","...","origin=","(","10",",","35",",","50",")",",","...",")","Initialize","from","another","ImageData",".",">",">",">","grid","=","pv.ImageData","(","...","dimensions=","(","10",",","10",",","10",")",",","...","spacing=","(","2",",","1",",","5",")",",","...","origin=","(","10",",","35",",","50",")",",","...",")",">",">",">","grid_from_grid","=","pv.ImageData","(","grid",")",">",">",">","grid_from_grid","==","grid","True"]
docstr: Points cannot be set.
  
  This setter overrides the base class's setter to ensure a user does not
  attempt to set them. See https://github.com/pyvista/pyvista/issues/713.
code: def points(self, points):  # numpydoc ignore=PR01
      """Points cannot be set.
  
      This setter overrides the base class's setter to ensure a user does not
      attempt to set them. See https://github.com/pyvista/pyvista/issues/713.
  
      """
      raise AttributeError(
          "The points cannot be set. The points of "
          "`ImageData`/`vtkImageData` are implicitly defined by the "
          "`origin`, `spacing`, and `dimensions` of the grid."
      )
  
imports: from functools import wraps
  import pathlib
  from typing import Sequence, Tuple, Union
  import warnings
  import numpy
  import pyvista
  from .None import _vtk_core
  from .dataset import DataSet
  from .errors import PyVistaDeprecationWarning
  from .filters import ImageDataFilters, RectilinearGridFilters, _get_output
  from .utilities.arrays import convert_array, raise_has_duplicates
  from .utilities.misc import abstract_class, assert_empty_kwargs
label_desc: Use image node_id 6 for calling the ImageData obj's underlying member method code with example usage: obj.points(points) without return types