class_docstr: An internal class to manage filters/algorithms for composite datasets.
class_docstr_tok: ["An","internal","class","to","manage","filters\/algorithms","for","composite","datasets","."]
docstr: Combine all blocks into a single unstructured grid.
  
  Parameters
  ----------
  merge_points : bool, default: False
      Merge coincidental points.
  
  tolerance : float, default: 0.0
      The absolute tolerance to use to find coincident points when
      ``merge_points=True``.
  
  Returns
  -------
  pyvista.UnstructuredGrid
      Combined blocks.
  
  Examples
  --------
  Combine blocks within a multiblock without merging points.
  
  >>> import pyvista as pv
  >>> block = pv.MultiBlock(
  ...     [
  ...         pv.Cube(clean=False),
  ...         pv.Cube(center=(1, 0, 0), clean=False),
  ...     ]
  ... )
  >>> merged = block.combine()
  >>> merged.n_points
  48
  
  Combine blocks and merge points
  
  >>> merged = block.combine(merge_points=True)
  >>> merged.n_points
  12
docstr_tok: ["Combine","all","blocks","into","a","single","unstructured","grid",".","Parameters","--","--","--","--","--","merge_points",":","bool",",","default",":","False","Merge","coincidental","points",".","tolerance",":","float",",","default",":","0.0","The","absolute","tolerance","to","use","to","find","coincident","points","when","``","merge_points=True","``",".","Returns","--","--","--","-","pyvista.UnstructuredGrid","Combined","blocks",".","Examples","--","--","--","--","Combine","blocks","within","a","multiblock","without","merging","points",".",">",">",">","import","pyvista","as","pv",">",">",">","block","=","pv.MultiBlock","(","...","[","...","pv.Cube","(","clean=False",")",",","...","pv.Cube","(","center=","(","1",",","0",",","0",")",",","clean=False",")",",","...","]","...",")",">",">",">","merged","=","block.combine","(",")",">",">",">","merged.n_points","48","Combine","blocks","and","merge","points",">",">",">","merged","=","block.combine","(","merge_points=True",")",">",">",">","merged.n_points","12"]
code: def combine(self, merge_points=False, tolerance=0.0):
      """Combine all blocks into a single unstructured grid.
  
      Parameters
      ----------
      merge_points : bool, default: False
          Merge coincidental points.
  
      tolerance : float, default: 0.0
          The absolute tolerance to use to find coincident points when
          ``merge_points=True``.
  
      Returns
      -------
      pyvista.UnstructuredGrid
          Combined blocks.
  
      Examples
      --------
      Combine blocks within a multiblock without merging points.
  
      >>> import pyvista as pv
      >>> block = pv.MultiBlock(
      ...     [
      ...         pv.Cube(clean=False),
      ...         pv.Cube(center=(1, 0, 0), clean=False),
      ...     ]
      ... )
      >>> merged = block.combine()
      >>> merged.n_points
      48
  
      Combine blocks and merge points
  
      >>> merged = block.combine(merge_points=True)
      >>> merged.n_points
      12
  
      """
      alg = _vtk.vtkAppendFilter()
      for block in self:
          if isinstance(block, _vtk.vtkMultiBlockDataSet):
              block = CompositeFilters.combine(
                  block, merge_points=merge_points, tolerance=tolerance
              )
          alg.AddInputData(block)
      alg.SetMergePoints(merge_points)
      alg.SetTolerance(tolerance)
      alg.Update()
      return wrap(alg.GetOutputDataObject(0))
  
file_path: pyvista/pyvista/core/filters/composite.py
imports: import numpy
  import pyvista
  from pyvista.core import _vtk_core
  from pyvista.core.filters import _get_output, _update_alg
  from pyvista.core.filters.data_set import DataSetFilters
  from pyvista.core.utilities.helpers import wrap
  from pyvista.core.utilities.misc import abstract_class
label_desc: Use image node_id 2 for calling the CompositeFilters obj's underlying member method code with example usage: obj.combine(merge_points, tolerance) and returns: wrap