Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

regionprops3

Propiedades de medida de las regiones de imagen volumétrica 3-D

Sintaxis

stats = regionprops3(BW,properties)
stats = regionprops3(CC,properties)
stats = regionprops3(L,properties)
stats = regionprops3(___,V,properties)

Descripción

ejemplo

stats = regionprops3(BW,properties) mide un conjunto de propiedades para cada componente conectado (objeto) en la imagen binaria volumétrica tridimensional BW. El stats de salida es una tabla con altura (número de filas) igual al número de objetos en BW. Las variables (columnas) de la tabla denotan propiedades diferentes para cada región, según lo especificado por properties.

Para todas las sintaxis, si no especifica el argumento properties, regionprops3 devuelve las mediciones 'Volume', 'Centroid' y 'BoundingBox'.

stats = regionprops3(CC,properties) mide un conjunto de propiedades para cada componente conectado (Object) en CC, que es una estructura devuelta por bwconncomp. La salida stats es una tabla de MATLAB con altura (número de filas) igual a CC.NumObjects. La estructura del CC debe representar una imagen tridimensional, es CC.ImageSize debe ser un vector 1-por-3. La estructura CC también debe haber sido creada utilizando un valor de conectividad tridimensional, como 6, 18 o 26. Para obtener más información, consulte bwconncomp.

stats = regionprops3(L,properties) mide un conjunto de propiedades para cada región etiquetada en la matriz de etiquetas 3D L. Los elementos enteros positivos de L corresponden a diferentes regiones. Por ejemplo, el conjunto de elementos de L igual a 1 corresponde a la región 1, el conjunto de elementos de L igual a 2 corresponde a la región 2, y así sucesivamente. La salida stats es una tabla de MATLAB con altura (número de filas) igual a max(L(:)).

stats = regionprops3(___,V,properties) mide un conjunto de propiedades para cada región etiquetada en la imagen de escala de grises volumétrica 3D V. La primera entrada (BW, CC, o L) identifica las regiones en V. Los tamaños deben coincidir: size(V) debe ser igual a size(BW), CC.ImageSizeo size(L).

Ejemplos

contraer todo

Cree una imagen binaria con dos esferas.

[x,y,z] = meshgrid(1:50,1:50,1:50); bw1 = sqrt((x-10).^2 + (y-15).^2 + (z-35).^2) < 5; bw2 = sqrt((x-20).^2 + (y-30).^2 + (z-15).^2) < 10; bw = bw1 | bw2;

Obtener los centros y radios de las dos esferas.

s = regionprops3(bw,"Centroid","PrincipalAxisLength"); centers = s.Centroid
centers = 2×3

    20    30    15
    10    15    35

diameters = mean(s.PrincipalAxisLength,2)
diameters = 2×1

   17.8564
    8.7869

radii = diameters/2
radii = 2×1

    8.9282
    4.3935

Haga un cubo de 0s de 9 por 9 que contenga un cubo de 3 por 3 de 1s en su centro.

innercube = ones(3,3,3); cube_in_cube = padarray(innercube,[3 3],0,'both');

Obtenga todas las estadísticas del cubo dentro del cubo.

stats = regionprops3(cube_in_cube,'all')
stats=1×18 table
    Volume     Centroid      BoundingBox                     SubarrayIdx                          Image         EquivDiameter    Extent    VoxelIdxList       VoxelList         PrincipalAxisLength        Orientation    EigenVectors    EigenValues      ConvexHull        ConvexImage      ConvexVolume    Solidity    SurfaceArea
    ______    ___________    ____________    ____________________________________________    _______________    _____________    ______    _____________    _____________    __________________________    ___________    ____________    ____________    _____________    _______________    ____________    ________    ___________

      27      5    5    2    [1x6 double]    [1x3 double]    [1x3 double]    [1x3 double]    [3x3x3 logical]       3.7221          1       [27x1 double]    [27x3 double]    3.4641    3.4641    3.4641    0    0    0    [3x3 double]    [3x1 double]    [24x3 double]    [3x3x3 logical]         27            1           41.07   

Argumentos de entrada

contraer todo

Imagen binaria volumétrica, especificada como un array lógico tridimensional.

Tipos de datos: logical

Tipo de medida, especificada como una lista separada por comas de cadenas o vectores de caracteres, una matriz de celdas de cadenas o vectores de caracteres, 'all' o 'basic'.

En la tabla siguiente se enumeran todas las propiedades que proporcionan medidas de forma. La tabla Mediciones del valor voxel enumera propiedades adicionales que sólo son válidas cuando se especifica una imagen en escala de grises. Si especifica 'all', regionprops3 calcula todas las mediciones de la forma y, si ha especificado una imagen en escala de grises, todas las mediciones del valor de píxel. Si especifica 'basic' o no especifica el argumento properties, regionprops3 calcula sólo las mediciones 'Volume', 'Centroid' y 'BoundingBox'. Los nombres de propiedad no distinguen entre mayúsculas y minúsculas y pueden abreviarse.

Medidas de la forma

Nombre de la propiedadDescripción
'BoundingBox'El más pequeño cúbico que contiene la región, devuelto como un 1-por-6 vector de la forma [ulf_x ulf_y ulf_z width_x width_y width_z]. ulf_x, ulf_yy ulf_z especifican la esquina superior izquierda frontal del paralelepípedo. width_x, width_yy width_z especifican el ancho del paralelepípedo a lo largo de cada dimensión.
'Centroid'

Centro de masa de la región, devuelto como un vector 1 por 3 de la forma [centroid_x centroid_y and centroid_z]. El primer elemento, centroid_x, es la coordenada horizontal (o x-coordenada) del centro de masa. El segundo elemento, centroid_y, es la coordenada vertical (o y-coordenada). El tercer elemento, centroid_z, es el coordenada planar (o z-coordenada).

'ConvexHull'Polígono convexo más pequeño que puede contener la región, devuelto como una matriz p-por-3. Cada fila de la matriz contiene las coordenadas x, yy zde un vértice del polígono.
'ConvexImage'Imagen del casco convexo, devuelto como imagen binaria volumétrica (logical) con todos los vóxeles dentro del casco relleno (ajustado a on). La imagen es del tamaño de la caja delimitadora de la región.
'ConvexVolume'Número de vóxeles en 'ConvexImage', devueltos como escalar.
'EigenValues'Valores propios del vóxeles que representa una región, vuelto como Vector 3 por-1. regionprops3 utiliza los valores propios para calcular las longitudes de los ejes principales.
'EigenVectors'Vectores del vóxeles que representa una región, vuelto como Vector 3-por-3. regionprops3 utiliza el vectores para calcular la orientación del elipsoide que tiene los mismos segundos momentos centrales normalizados como la región.
'EquivDiameter'Diámetro de una esfera con el mismo volumen que la región, devuelta como escalar. Calculado como (6*Volume/pi)^(1/3).
'Extent'Cociente de vóxeles en la región a vóxeles en el cuadro de delimitación total, devuelto como escalar. Calculado como el valor de Volume dividido por el volumen del cuadro delimitador. [Volume/(bounding box width * bounding box height * bounding box depth)]
'Image'Caja delimitadora de la región, devuelta como imagen binaria volumétrica (logical) que es del mismo tamaño que el cuadro delimitador de la región. Los on vóxeles corresponden a la región, y todos los demás vóxeles son off.
'Orientation'

Ángulos de Euler, vueltos como un vector 1 por 3. Los ángulos se basan en la regla de la mano derecha. regionprops3 interpreta los ángulos observando el origen a lo largo del x-, y-, y z-Axis que representa el rodillo, la echada, y el desvío respectivamente. Un ángulo positivo representa una rotación en la dirección contraria a las manecillas del reloj. Las operaciones de rotación no son conmutativas por lo que deben aplicarse en el orden correcto para tener el efecto deseado. Para obtener más información, consulte Referencias.

'PrincipalAxisLength'Longitud (en vóxeles) de los ejes principales del elipsoide que tienen los mismos segundos momentos centrales normalizados como la región, devueltos como vector 1-por-3. regionprops3 ordena los valores de la más alta a la más baja.
'Solidity'Proporción de los vóxeles en el casco convexo que se encuentran también en la región, devueltos como escalares. Calculado como Volume/ConvexVolume.
'SubarrayIdx'Índices utilizados para extraer elementos dentro del cuadro delimitador de objetos, devueltos como una matriz de celdas de forma que L(idx{:}) extrae los elementos de L dentro del cuadro delimitador de objetos.
'SurfaceArea'Distancia alrededor de los límites de la región, regresó como un escalar. Para obtener más información, consulte Referencias.
'Volume'Recuento del número real de 'on' vóxeles en la región, devuelto como escalar. Volume representa la métrica o medida del número de vóxeles en las regiones dentro de la imagen binaria volumétrica, BW.
'VoxelIdxList'Índices lineares del vóxeles en la región, vuelto como vector del p-elemento.
'VoxelList'Localizaciones de vóxeles en la región, devueltas como una matriz p-por-3. Cada fila de la matriz tiene la forma [x y z] y especifica las coordenadas de una voxel en la región.

Las propiedades de medición del valor voxel de la tabla siguiente sólo son válidas cuando se especifica una imagen volumétrica en escala de grises, V.

Mediciones del valor voxel

Nombre de la propiedad Descripción
'MaxIntensity'Valor de la voxel con mayor intensidad en la región, devuelto como escalar.
'MeanIntensity'Medio de todos los valores de intensidad en la región, devueltos como escalar.
'MinIntensity'Valor del voxel con la intensidad más baja de la región, devuelto como escalar.
'VoxelValues'Valor de la vóxeles en la región, devuelto como un vector p-por-1, donde p es el número de vóxeles en la región. Cada elemento del vector contiene el valor de un voxel en la región.
'WeightedCentroid'Centro de la región basado en la ubicación y el valor de la intensidad, devuelto p-por-3 vector de coordenadas. El primer elemento de WeightedCentroid es la coordenada horizontal (o x-coordenada) del centroide ponderado. El segundo elemento es la coordenada vertical (o y-coordenada). El tercer elemento es la coordenada planar (o z-coordenada).

Tipos de datos: char | string | cell

Componentes conectados, especificados como una estructura devuelta por bwconncomp.

Tipos de datos: struct

Matriz de etiquetas, especificada como una matriz de 3-D numérica real, no Sparse. regionprops3 trata los píxeles con valor negativo como fondo y redondea los píxeles de entrada que no son enteros. Los elementos enteros positivos de L corresponden a diferentes regiones. Por ejemplo, el conjunto de elementos de L igual a 1 corresponde a la región 1; el conjunto de elementos de L igual a 2 corresponde a la región 2; y así sucesivamente.

Tipos de datos: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

Imagen de escala de grises volumétrica, especificada como una matriz numérica tridimensional.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32

Argumentos de salida

contraer todo

Valores de medición, devueltos como una tabla. El número de filas de la tabla corresponde al número de objetos de BW, CC.NumObjectso max(L(:)). Las variables (columnas) de cada fila de tabla denotan las propiedades calculadas para cada región, según lo especificado por properties.

Referencias

[1] Lehmann, Gaetan and David Legland, Efficient N-Dimensional surface estimation using Crofton formula and run-length encoding, http://hdl.handle.net/10380/3342

[2] Shoemake, Ken, Graphics Gems IV Edited by Paul S. Heckbert, Morgan Kaufmann, 1994, Pg 222-229.

Consulte también

| | |

Introducido en R2017b