Skip to main content
`Ctrl`+`K`
scipy.ndimage.

# iterate_structure

scipy.ndimage.iterate_structure(structure, iterations, origin=None)

  Iterate a structure by dilating it with itself.

  Parameters:
    structurearray_like

      Structuring element (an array of bools, for example), to be dilated with itself.

    iterationsint

      number of dilations performed on the structure with itself

    originoptional

      If origin is None, only the iterated structure is returned. If not, a tuple of the iterated structure and the modified origin is returned.

  Returns:
    iterate_structurendarray of bools

      A new structuring element obtained by dilating structure (iterations - 1) times with itself.

  See also

  `generate_binary_structure`

  Examples

      >>> from scipy import ndimage
      >>> struct = ndimage.generate_binary_structure(2, 1)
      >>> struct.astype(int)
      array([[0, 1, 0],
             [1, 1, 1],
             [0, 1, 0]])
      >>> ndimage.iterate_structure(struct, 2).astype(int)
      array([[0, 0, 1, 0, 0],
             [0, 1, 1, 1, 0],
             [1, 1, 1, 1, 1],
             [0, 1, 1, 1, 0],
             [0, 0, 1, 0, 0]])
      >>> ndimage.iterate_structure(struct, 3).astype(int)
      array([[0, 0, 0, 1, 0, 0, 0],
             [0, 0, 1, 1, 1, 0, 0],
             [0, 1, 1, 1, 1, 1, 0],
             [1, 1, 1, 1, 1, 1, 1],
             [0, 1, 1, 1, 1, 1, 0],
             [0, 0, 1, 1, 1, 0, 0],
             [0, 0, 0, 1, 0, 0, 0]])