Ejemplo de Scikit_Image io

Utilidades para leer y escribir imágenes en varios formatos.

Están disponibles los siguientes complementos:

call_plugin

skimage.io.call_plugin(kind, *args, **kwargs) [source]

Busque el complemento apropiado de ‘tipo’ y ejecútelo.

Parámetros

kind{‘imshow’, ‘imsave’, ‘imread’, ‘imread_collection’}

Función para buscar.

pluginstr, optional

Complemento para cargar. El valor predeterminado es Ninguno, en cuyo caso se utiliza el primer complemento coincidente.

*args, **kwargsarguments and keyword arguments

Pasado a la función de complemento.

concatenate_images

skimage.io.concatenate_images(ic) [source]

Concatenar todas las imágenes de la colección de imágenes en una matriz.

Parámetros

ican iterable of images

Las imágenes a concatenar.

Devoluciones

array_catndarray

Una matriz que tiene una dimensión más que las imágenes en ic.

Eleva

ValueError

Si las imágenes en ic no tienen formas idénticas.

Ver también

ImageCollection.concatenate, MultiImage.concatenate

Notas

concatenate_images recibe cualquier objeto iterable que contenga imágenes, incluidas ImageCollection y MultiImage, y devuelve una matriz NumPy.

find_available_plugins

skimage.io.find_available_plugins(loaded=False) [source]

Enumere los complementos disponibles.

Parámetros

loadedbool

Si es Verdadero, muestre solo los complementos cargados actualmente. De forma predeterminada, se muestran todos los complementos.

Devoluciones

pdict

Diccionario con nombres de complementos como claves y funciones expuestas como valores.

Estoy leído

skimage.io.imread(fname, as_gray=False, plugin=None, **plugin_args) [source]

Cargue una imagen desde un archivo.

Parámetros

fnamestring

Nombre del archivo de imagen, p. Ej. test.jpg o URL.

as_graybool, optional

Si es Verdadero, convierta las imágenes en color a escala de grises (flotantes de 64 bits). Las imágenes que ya están en formato de escala de grises no se convierten.

pluginstr, optional

Nombre del complemento que se utilizará. De forma predeterminada, se prueban los diferentes complementos (comenzando con imageio) hasta que se encuentra un candidato adecuado. Si no se proporciona y fname es un archivo tiff, se utilizará el complemento tifffile.

Devoluciones

img_arrayndarray

Las diferentes bandas / canales de color se almacenan en la tercera dimensión, de modo que una imagen gris es MxN, una imagen RGB MxNx3 y una imagen RGBA MxNx4.

Otros parámetros

plugin_argskeywords

Pasado al complemento dado.

imread_collection

skimage.io.imread_collection(load_pattern, conserve_memory=True, plugin=None, **plugin_args) [source]

Cargue una colección de imágenes.

Parámetros

load_patternstr or list

Lista de objetos para cargar. Suelen ser nombres de archivo, pero pueden variar según el complemento activo actualmente. Consulte la cadena de documentos para ImageCollection para el comportamiento predeterminado de este parámetro.

conserve_memorybool, optional

Si es Verdadero, nunca guarde más de uno en la memoria en un momento específico. De lo contrario, las imágenes se almacenarán en caché una vez que se carguen.

Devoluciones

icImageCollection

Colección de imágenes.

Otros parámetros

plugin_argskeywords

Pasado al complemento dado.

imread_collection_wrapper

skimage.io.imread_collection_wrapper(imread) [source]

salvar

skimage.io.imsave(fname, arr, plugin=None, check_contrast=True, **plugin_args) [source]

Guarde una imagen en un archivo.

Parámetros

fnamestr

Nombre de archivo de destino.

arrndarray of shape (M,N) or (M,N,3) or (M,N,4)

Datos de imagen.

pluginstr, optional

Nombre del complemento que se utilizará. De forma predeterminada, se prueban los diferentes complementos (comenzando con imageio) hasta que se encuentra un candidato adecuado. Si no se proporciona y fname es un archivo tiff, se utilizará el complemento tifffile.

check_contrastbool, optional

Compruebe si hay bajo contraste y advertencia de impresión (predeterminado: Verdadero).

Otros parámetros

plugin_argskeywords

Pasado al complemento dado.

Notas

Al guardar un JPEG, la relación de compresión se puede controlar mediante el quality argumento de palabra clave que es un número entero con valores en [1, 100] donde 1 es la peor calidad y el tamaño de archivo más pequeño, y 100 es la mejor calidad y el tamaño de archivo más grande (predeterminado 75). Esto solo está disponible cuando se utilizan los complementos PIL e imageio.

imshow

skimage.io.imshow(arr, plugin=None, **plugin_args) [source]

Muestra una imagen.

Parámetros

arrndarray or str

Datos de imagen o nombre del archivo de imagen.

pluginstr

Nombre del complemento que se utilizará. De forma predeterminada, se prueban los diferentes complementos (comenzando con imageio) hasta que se encuentra un candidato adecuado.

Otros parámetros

plugin_argskeywords

Pasado al complemento dado.

Ejemplos usando skimage.io.imshow

Explore imágenes en 3D (de células)

imshow_collection

skimage.io.imshow_collection(ic, plugin=None, **plugin_args) [source]

Muestra una colección de imágenes.

Parámetros

icImageCollection

Colección para exhibir.

pluginstr

Nombre del complemento que se utilizará. De forma predeterminada, se prueban los diferentes complementos hasta que se encuentra un candidato adecuado.

Otros parámetros

plugin_argskeywords

Pasado al complemento dado.

load_sift

skimage.io.load_sift(f) [source]

Lea las características de SIFT o SURF desde un archivo generado externamente.

Esta rutina lee archivos SIFT o SURF generados por utilidades binarias de http://people.cs.ubc.ca/~lowe/keypoints/ y http://www.vision.ee.ethz.ch/~surf/.

Esta rutina no generar características SIFT / SURF a partir de una imagen. Estos algoritmos están gravados por patente. Por favor use skimage.feature.CENSURE en lugar de.

Parámetros

filelikestring or open file

Archivo de entrada generado por los detectores de características de http://people.cs.ubc.ca/~lowe/keypoints/ o http://www.vision.ee.ethz.ch/~surf/ .

mode{‘SIFT’, ‘SURF’}, optional

Tipo de descriptor utilizado para generar filelike.

Devoluciones

datarecord array with fields

• fila: int

  posición de fila de la característica

• columna: int

  posición de la columna de la característica

• escala: flotar

  escala de características

• orientación: flotar

  orientación de características

• datos: matriz

  valores de características

load_surf

skimage.io.load_surf(f) [source]

Lea las características de SIFT o SURF desde un archivo generado externamente.

Esta rutina lee archivos SIFT o SURF generados por utilidades binarias de http://people.cs.ubc.ca/~lowe/keypoints/ y http://www.vision.ee.ethz.ch/~surf/.

Esta rutina no generar características SIFT / SURF a partir de una imagen. Estos algoritmos están gravados por patente. Por favor use skimage.feature.CENSURE en lugar de.

Parámetros

filelikestring or open file

Archivo de entrada generado por los detectores de características de http://people.cs.ubc.ca/~lowe/keypoints/ o http://www.vision.ee.ethz.ch/~surf/ .

mode{‘SIFT’, ‘SURF’}, optional

Tipo de descriptor utilizado para generar filelike.

Devoluciones

datarecord array with fields

• fila: int

  posición de fila de la característica

• columna: int

  posición de la columna de la característica

• escala: flotar

  escala de características

• orientación: flotar

  orientación de características

• datos: matriz

  valores de características

plugin_info

skimage.io.plugin_info(plugin) [source]

Devuelve los metadatos del complemento.

Parámetros

pluginstr

Nombre del complemento.

Devoluciones

mdict

Metadatos como se especifica en el complemento .ini.

plugin_order

skimage.io.plugin_order() [source]

Devuelve el orden de complementos preferido actualmente.

Devoluciones

pdict

Diccionario del orden de complementos preferido, con el nombre de la función como clave y los complementos (en orden de preferencia) como valor.

música pop

skimage.io.pop() [source]

Saca una imagen de la pila de imágenes compartidas.

Devoluciones

imgndarray

La imagen apareció de la pila.

empujar

skimage.io.push(img) [source]

Inserte una imagen en la pila de imágenes compartidas.

Parámetros

imgndarray

Imagen para empujar.

reset_plugins

skimage.io.reset_plugins() [source]

show

skimage.io.show() [source]

Mostrar imágenes pendientes.

Inicie el bucle de eventos del complemento de interfaz gráfica de usuario actual y muestre todas las imágenes pendientes, en cola a través de imshow. Esto es necesario cuando se usa imshow a partir de scripts no interactivos.

Una llamada a show bloqueará la ejecución del código hasta que se hayan cerrado todas las ventanas.

Ejemplos de

>>> import skimage.io as io

>>> for i in range(4):
...     ax_im = io.imshow(np.random.rand(50, 50))
>>> io.show() 

use_plugin

skimage.io.use_plugin(name, kind=None) [source]

Establezca el complemento predeterminado para una operación específica. El complemento se cargará si aún no lo ha hecho.

Parámetros

namestr

Nombre del complemento.

kind{‘imsave’, ‘imread’, ‘imshow’, ‘imread_collection’, ‘imshow_collection’}, optional

Configure el complemento para esta función. De forma predeterminada, el complemento está configurado para todas las funciones.

Ver también

available_plugins

Lista de complementos disponibles

Ejemplos de

Para usar Matplotlib como el lector de imágenes predeterminado, debe escribir:

>>> from skimage import io
>>> io.use_plugin('matplotlib', 'imread')

Para ver una lista de complementos disponibles, ejecute io.available_plugins. Tenga en cuenta que esto enumera los complementos que están definidos, pero es posible que la lista completa no se pueda utilizar si su sistema no tiene instaladas las bibliotecas necesarias.

ImageCollection

class skimage.io.ImageCollection(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs) [source]

Bases: object

Cargue y administre una colección de archivos de imágenes.

Parámetros

load_patternstr or list of str

Cadena de patrón o lista de cadenas para cargar. La ruta del nombre de archivo puede ser absoluta o relativa.

conserve_memorybool, optional

Si es verdad, ImageCollection no guarda más de uno en la memoria en un momento específico. De lo contrario, las imágenes se almacenarán en caché una vez que se carguen.

Otros parámetros

load_funccallable

imread por defecto. Vea las notas a continuación.

Notas

Tenga en cuenta que los archivos siempre se devuelven en orden alfanumérico. También tenga en cuenta que el corte devuelve una nueva colección de imágenes, no una vista de los datos.

ImageCollection se puede modificar para cargar imágenes de una fuente arbitraria especificando una combinación de load_pattern y load_func. Para una colección de imágenes ic, ic[5] usos load_func(load_pattern[5]) para cargar la imagen.

Imagine, por ejemplo, un ImageCollection que carga cada tercer fotograma de un archivo de video:

video_file = 'no_time_for_that_tiny.gif'

def vidread_step(f, step):
    vid = imageio.get_reader(f)
    seq = [v for v in vid.iter_data()]
    return seq[::step]

ic = ImageCollection(video_file, load_func=vidread_step, step=3)

ic  # is an ImageCollection object of length 1 because there is 1 file

x = ic[0]  # calls vidread_step(video_file, step=3)
x[5]  # is the sixth element of a list of length 8 (24 / 3)

Otro uso de load_func sería convertir todas las imágenes a uint8:

def imread_convert(f):
    return imread(f).astype(np.uint8)

ic = ImageCollection('/tmp/*.png', load_func=imread_convert)

Ejemplos de

>>> import skimage.io as io
>>> from skimage import data_dir

>>> coll = io.ImageCollection(data_dir + '/chess*.png')
>>> len(coll)
2
>>> coll[0].shape
(200, 200)

>>> ic = io.ImageCollection(['/tmp/work/*.png', '/tmp/other/*.jpg'])

Atributos

fileslist of str

Si se da una cadena de patrón para load_pattern, este atributo almacena la lista de archivos expandida. De lo contrario, este es igual a load_pattern.

__init__(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs) [source]

Cargue y administre una colección de imágenes.

concatenate() [source]

Concatenar todas las imágenes de la colección en una matriz.

Devoluciones

arnp.ndarray

Una matriz que tiene una dimensión más que las imágenes en self.

Eleva

ValueError

Si las imágenes en el ImageCollection no tienen formas idénticas.

Ver también

concatenate_images

property conserve_memory

property files

reload(n=None) [source]

Limpia la caché de imágenes.

Parámetros

nNone or int

Limpia la caché solo para esta imagen. De forma predeterminada, se borra todo el caché.

MultiImage

class skimage.io.MultiImage(filename, conserve_memory=True, dtype=None, **imread_kwargs) [source]

Bases: skimage.io.collection.ImageCollection

Una clase que contiene todos los fotogramas de imágenes de varios fotogramas.

Parámetros

load_patternstr or list of str

Patrón glob o nombres de archivo para cargar. La ruta puede ser absoluta o relativa.

conserve_memorybool, optional

Ya sea para conservar memoria almacenando en caché un solo fotograma. El valor predeterminado es Verdadero.

Otros parámetros

load_funccallable

imread por defecto. Vea las notas a continuación.

Notas

Si conserve_memory=True la huella de memoria se puede reducir, sin embargo, el rendimiento puede verse afectado porque los fotogramas deben leerse del archivo con más frecuencia.

El último marco al que se accedió se almacena en caché, todos los demás marcos deberán leerse desde el archivo.

La implementación actual hace uso de tifffile para archivos Tiff y PIL en caso contrario.

Ejemplos de

>>> from skimage import data_dir

>>> img = MultiImage(data_dir + '/multipage.tif') 
>>> len(img) 
2
>>> for frame in img: 
...     print(frame.shape) 
(15, 10)
(15, 10)

__init__(filename, conserve_memory=True, dtype=None, **imread_kwargs) [source]

Cargue un archivo multi-img.

property filename