Aviso de fin de soporte: el 31 de octubre de 2025, AWS dejaremos de ofrecer soporte a Amazon Lookout for Vision. Después del 31 de octubre de 2025, ya no podrás acceder a la consola Lookout for Vision ni a los recursos de Lookout for Vision. Para obtener más información, visita esta entrada de blog.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DetectAnomalies

Detecta anomalías en la imagen suministrada.

La respuesta de DetectAnomalies incluye una predicción booleana de que la imagen contiene una o más anomalías y un valor de confianza para la predicción. Si el modelo es un modelo de segmentación, la respuesta incluye lo siguiente:

DetectAnomaliesadmite mapas de bits (imágenes) empaquetados en formato RGB888 intercalado. El primer byte representa el canal rojo, el segundo byte representa el canal verde y el tercer byte representa el canal azul. Si proporciona la imagen en un formato diferente, como BGR, las predicciones son incorrectas. DetectAnomalies

De forma predeterminada, OpenCV utiliza el formato BGR para los mapas de bits de las imágenes. Si utiliza OpenCV para capturar imágenes para DetectAnomalies analizarlas, debe convertir la imagen al formato antes de pasarla RGB888 a. DetectAnomalies

La dimensión mínima de imagen admitida es de 64 x 64 píxeles. La dimensión máxima de imagen admitida es de 4096 x 4096 píxeles.

Puede enviar la imagen en el mensaje protobuf o a través de un segmento de memoria compartida. La serialización de imágenes de gran tamaño en el mensaje protobuf puede aumentar considerablemente la latencia de las llamadas a DetectAnomalies. Para reducir al mínimo la latencia, le recomendamos que utilice memoria compartida.

rpc DetectAnomalies(DetectAnomaliesRequest) returns (DetectAnomaliesResponse);
  

DetectAnomaliesRequest

Los parámetros de entrada de DetectAnomalies.

message Bitmap {
  int32 width = 1;
  int32 height = 2;
  oneof data { 
    bytes byte_data = 3;
    SharedMemoryHandle shared_memory_handle = 4;
  }
}

message SharedMemoryHandle {
  string name = 1;
  uint64 size = 2;
  uint64 offset = 3;
}    

message AnomalyMaskParams {
SharedMemoryHandle shared_memory_handle = 2;
}

message DetectAnomaliesRequest {
string model_component = 1;
Bitmap bitmap = 2;
AnomalyMaskParams anomaly_mask_params = 3;
}

BITMAP

La imagen que desea analizar con DetectAnomalies.

width

El ancho de la imagen en píxeles.

height

La altura de la imagen en píxeles.

byte_data

Los bytes de imagen se transmiten en el mensaje protobuf.

shared_memory_handle

Los bytes de imagen se transfieren al segmento de memoria compartida.

SharedMemoryHandle

Representa un segmento de memoria compartida POSIX.

nombre

Nombre del segmento de memoria POSIX. Para obtener información sobre la creación de memoria compartida, consulte shm_open.

tamaño

El tamaño del búfer de la imagen en bytes a partir del desplazamiento.

desplazamiento

El desplazamiento, en bytes, al principio del búfer de imagen desde el inicio del segmento de memoria compartida.

AnomalyMaskParams

Parámetros para generar una máscara de anomalías. (Modelo de segmentación).

shared_memory_handle

Contiene los bytes de imagen de la máscara, si no se especificó shared_memory_handle.

DetectAnomaliesRequest

model_component

El nombre del AWS IoT Greengrass V2 componente que contiene el modelo que desea utilizar.

BITMAP

La imagen que desea analizar con DetectAnomalies.

anomaly_mask_params

Parámetros opcionales para generar la máscara. (Modelo de segmentación).

DetectAnomaliesResponse

La respuesta de DetectAnomalies.

message DetectAnomalyResult {
bool is_anomalous = 1;
float confidence = 2;
Bitmap anomaly_mask = 3;
repeated Anomaly anomalies = 4;
float anomaly_score = 5;
float anomaly_threshold = 6;
}

message Anomaly {
string name = 1;
PixelAnomaly pixel_anomaly = 2;

message PixelAnomaly {
float total_percentage_area = 1;
string hex_color = 2;
}

message DetectAnomaliesResponse {
  DetectAnomalyResult detect_anomaly_result = 1;
}

Anomalía

Representa una anomalía encontrada en una imagen. (Modelo de segmentación).

nombre

El nombre de un tipo de anomalía que se encuentra en una imagen. namese asigna a un tipo de anomalía del conjunto de datos de entrenamiento. El servicio inserta automáticamente el tipo de anomalía de fondo en la respuesta desde DetectAnomalies.

pixel_anomaly

Información sobre la máscara de píxeles que cubre un tipo de anomalía.

PixelAnomaly

Información sobre la máscara de píxeles que cubre un tipo de anomalía. (Modelo de segmentación).

total_percentage_area

El porcentaje de área de la imagen que cubre el tipo de anomalía.

hex_color

Un valor de color hexadecimal que representa el tipo de anomalía de la imagen. El color se corresponde con el color del tipo de anomalía utilizado en el conjunto de datos de entrenamiento.

DetectAnomalyResult

is_anomalous

Indica si la imagen contiene una anomalía. true si la imagen contiene una anomalía. false si la imagen es normal.

confidence

La confianza que DetectAnomalies se deposita en la precisión de la predicción. confidencees un valor de punto flotante entre 0 y 1.

anomaly_mask

si no se proporcionó shared_memory_handle, contiene los bytes de imagen de la máscara. (Modelo de segmentación).

Anomalías

Una lista de 0 o más anomalías encontradas en la imagen de entrada. (Modelo de segmentación).

anomaly_score

Número que cuantifica en qué medida las anomalías pronosticadas para una imagen se desvían de una imagen sin anomalías. anomaly_score es un valor flotante que va desde 0.0 hasta (desviación más baja con respecto a una imagen normal) 1,0 (desviación más alta con respecto a una imagen normal). Amazon Lookout for Vision devuelve un valor para anomaly_score, incluso si la predicción de una imagen es normal.

anomaly_threshold

Número (flotante) que determina si la clasificación prevista para una imagen es normal o anómala. Las imágenes con una anomaly_score igual o superior al valor de anomaly_threshold se consideran anómalas. Un valor de anomaly_score inferior a anomaly_threshold indica una imagen normal. Amazon Lookout for Vision calcula el valor de anomaly_threshold que utiliza un modelo al entrenar el modelo. No puede establecer ni cambiar el valor de anomaly_threshold.

Códigos de estado