Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Comprendre la détection des équipements de protection individuelle API
Les informations suivantes décrivent le DetectProtectiveEquipmentAPI. Pour obtenir un exemple de code, consultez Détection d’un équipement de protection individuelle dans une image.
Fourniture d’une image
Vous pouvez fournir l'image (JPGou le PNG format) d'entrée sous forme d'octets d'image ou faire référence à une image stockée dans un compartiment Amazon S3.
Nous recommandons d’utiliser des images où le visage de la personne fait face à l’appareil photo.
Si votre image d’entrée n’est pas pivotée à 0 degré, nous vous recommandons de la faire pivoter à 0 degré avant de la soumettre à DetectProtectiveEquipment
. Les images JPG formatées peuvent contenir des informations d'orientation dans les métadonnées Exif (Exchangeable Image File Format). Vous pouvez utiliser ces informations pour écrire le code permettant de faire pivoter l’image. Pour en savoir plus, consultez Exif Version 2.32
Pour transmettre une image depuis un compartiment Amazon S3, utilisez un utilisateur possédant au moins les privilèges Amazon S3ReadOnlyAccess . Utiliser un utilisateur ayant des privilèges
AmazonRekognitionFullAccess
pour appeler DetectProtectiveEquipment.
Dans l'exemple d'entrée suivantJSON, l'image est transmise dans un compartiment Amazon S3. Pour de plus amples informations, veuillez consulter Travail avec les images. L'exemple demande un résumé de tous les PPE types (couvre-chef, couvre-main et couvre-visage) avec un niveau de confiance de détection minimum (MinConfidence
) de 80 %. Vous devez spécifier une valeur MinConfidence
comprise entre 50 et 100 % car DetectProtectiveEquipment
ne renvoie des prédictions que lorsque le niveau de confiance de détection est compris entre 50 % et 100 %. Si vous spécifiez une valeur inférieure à 50 %, les résultats sont identiques si vous spécifiez une valeur de 50 %. Pour de plus amples informations, veuillez consulter Spécifier les exigences de synthèse.
{ "Image": { "S3Object": { "Bucket": "bucket", "Name": "worker.jpg" } }, "SummarizationAttributes": { "MinConfidence": 80, "RequiredEquipmentTypes": [ "FACE_COVER", "HAND_COVER", "HEAD_COVER" ] } }
Si vous avez une grande collection d'images à traiter, pensez à utiliser AWSBatch pour traiter les appels par lots DetectProtectiveEquipment
en arrière-plan.
Spécifier les exigences de synthèse
Vous pouvez éventuellement utiliser le paramètre d'entrée SummarizationAttributes
(ProtectiveEquipmentSummarizationAttributes) pour demander des informations récapitulatives sur les types de données PPE détectés dans une image.
Pour spécifier les types PPE de résumé, utilisez le champ RequiredEquipmentTypes
tableau. Dans le tableau, incluez un ou plusieurs des éléments suivants : FACE_COVER
, HAND_COVER
ou HEAD_COVER
.
Utilisez le champ MinConfidence
pour spécifier un niveau de confiance de détection minimal (50 à 100). Le résumé n'inclut pas les personnes, les parties du corps, la couverture des parties du PPE corps et les éléments détectés avec un niveau de confiance inférieur àMinConfidence
.
Pour plus d’informations sur la réponse en résumé de DetectProtectiveEquipment
consultez Comprendre la DetectProtectiveEquipment réponse.
Comprendre la DetectProtectiveEquipment réponse
DetectProtectiveEquipment
renvoie un tableau des personnes détectées dans l’image d’entrée. Pour chaque personne, des informations sur les parties du corps détectées et les éléments détectés PPE sont renvoyées. L'JSONimage suivante d'un travailleur portant un couvre-chef, un couvre-main et un couvre-visage est la suivante.
Dans leJSON, notez ce qui suit.
-
Personnes détectées :
Persons
ensemble de personnes détectées sur l'image (y compris les personnes qui ne portent pas de vêtementsPPE).DetectProtectiveEquipment
peut détecter jusqu'PPEà 15 personnes détectées sur une image. Chaque ProtectiveEquipmentPersonobjet du tableau contient un identifiant de personne, un cadre pour la personne, des parties du corps détectées et des éléments détectés dePPE. La valeurConfidence
dansProtectiveEquipmentPerson
indique le pourcentage de confiance d’Amazon Rekognition quant à la présence d’une personne dans le cadre de délimitation. -
Parties du corps :
BodyParts
ensemble de parties du corps (ProtectiveEquipmentBodyPart) détectées sur une personne (y compris les parties du corps non couvertes parPPE). ChaqueProtectiveEquipmentBodyPart
inclut le nom (Name
) de la partie du corps détectée.DetectProtectEquipment
peut détecter le visage, la tête, les parties du corps gauches et droites. Le champConfidence
dansProtectiveEquipmentBodyPart
indique le pourcentage de confiance d’Amazon Rekognition quant à la précision de détection de la partie du corps. PPEÉléments — Le tableau
EquipmentDetections
d'unProtectiveEquipmentBodyPart
objet contient un tableau d'PPEéléments détectés. Chaque EquipmentDetectionobjet contient les champs suivants.Type
— Type du produit détectéPPE.BoundingBox
— un cadre de délimitation autour du détecteur. PPEConfidence
— La confiance d'Amazon Rekognition quant au fait que le boîtier de sélection contient ce qui a été détecté. PPECoversBodyPart
— Indique si le produit détecté PPE se trouve sur la partie du corps correspondante.
Le CoversBodyPartchamp
Value
est une valeur booléenne qui indique si le produit détecté PPE se trouve sur la partie du corps correspondante. Le champConfidence
indique le niveau de confiance dans la prédiction. Vous pouvez l'utiliserCoversBodyPart
pour filtrer les cas où le détecté se PPE trouve dans l'image, mais pas réellement sur la personne.Note
CoversBodyPart
n’indique pas ou n’implique pas que la personne est correctement protégée par l’équipement de protection, ou que l’équipement de protection lui-même est correctement porté.-
Informations récapitulatives :
Summary
contient les informations récapitulatives spécifiées dans le paramètre d’entréeSummarizationAttributes
. Pour de plus amples informations, veuillez consulter Spécifier les exigences de synthèse.Summary
est un objet de type ProtectiveEquipmentSummaryqui contient les informations suivantes.PersonsWithRequiredEquipment
— Un ensemble IDs de personnes où chaque personne répond aux critères suivants.La personne porte tous les équipements PPE spécifiés dans le paramètre
SummarizationAttributes
d'entrée.Le niveau de
Confidence
pour la personne (ProtectiveEquipmentPerson
), la partie du corps (ProtectiveEquipmentBodyPart
), l’équipement de protection (EquipmentDetection
) est égal ou supérieur au seuil de confiance minimum spécifié (MinConfidence
).La valeur de
CoversBodyPart
pour tous les éléments de PPE est vraie.
PersonsWithoutRequiredEquipment
— Un ensemble IDs de personnes répondant à l'un des critères suivants.La
Confidence
valeur pour la personne (ProtectiveEquipmentPerson
), la partie du corps (ProtectiveEquipmentBodyPart
) et la couverture des parties du corps (CoversBodyPart
) sont supérieures au seuil de confiance minimum spécifié (MinConfidence
), mais il en manque un ou plusieurs spécifiés PPE (SummarizationAttributes
) à la personne.La valeur de
CoversBodyPart
est fausse pour toute valeur spécifiée PPE (SummarizationAttributes
) dontConfidence
la valeur est supérieure au seuil de confiance minimum spécifié (MinConfidence
). La personne possède également toutes les valeurs spécifiées PPE (SummarizationAttributes
) et lesConfidence
valeurs pour la personne (ProtectiveEquipmentPerson
), la partie du corps (ProtectiveEquipmentBodyPart
) et l'équipement de protection (EquipmentDetection
) sont supérieures ou égales au seuil de confiance minimum (MinConfidence
.
PersonsIndeterminate
— Un tableau IDs des personnes détectées dont laConfidence
valeur pour la personne (ProtectiveEquipmentPerson
), la partie du corps (ProtectiveEquipmentBodyPart
), l'équipement de protection (EquipmentDetection
) ou leCoversBodyPart
booléen est inférieure au seuil de confiance minimum spécifié (MinConfidence
).
Utilisez la taille du tableau pour obtenir le nombre d’un résumé particulier. Par exemple, la taille de vous
PersonsWithRequiredEquipment
indique le nombre de personnes détectées comme portant le type dePPE.Vous pouvez utiliser l’identifiant de la personne pour obtenir de plus amples informations sur une personne, telles que l’emplacement de la personne dans le cadre de délimitation. L’ID de personne correspond au champ ID d’un objet (
ProtectiveEquipmentPerson
) renvoyé dansPersons
(tableau deProtectiveEquipmentPerson
). Vous pouvez ensuite obtenir le cadre de délimitation et d’autres informations à partir de l’objetProtectiveEquipmentPerson
correspondant.
{ "ProtectiveEquipmentModelVersion": "1.0", "Persons": [ { "BodyParts": [ { "Name": "FACE", "Confidence": 99.99861145019531, "EquipmentDetections": [ { "BoundingBox": { "Width": 0.14528800547122955, "Height": 0.14956723153591156, "Left": 0.4363413453102112, "Top": 0.34203192591667175 }, "Confidence": 99.90001678466797, "Type": "FACE_COVER", "CoversBodyPart": { "Confidence": 98.0676498413086, "Value": true } } ] }, { "Name": "LEFT_HAND", "Confidence": 96.9786376953125, "EquipmentDetections": [ { "BoundingBox": { "Width": 0.14495663344860077, "Height": 0.12936046719551086, "Left": 0.5114737153053284, "Top": 0.5744519829750061 }, "Confidence": 83.72270965576172, "Type": "HAND_COVER", "CoversBodyPart": { "Confidence": 96.9288558959961, "Value": true } } ] }, { "Name": "RIGHT_HAND", "Confidence": 99.82939147949219, "EquipmentDetections": [ { "BoundingBox": { "Width": 0.20971858501434326, "Height": 0.20528452098369598, "Left": 0.2711356580257416, "Top": 0.6750612258911133 }, "Confidence": 95.70789337158203, "Type": "HAND_COVER", "CoversBodyPart": { "Confidence": 99.85433197021484, "Value": true } } ] }, { "Name": "HEAD", "Confidence": 99.9999008178711, "EquipmentDetections": [ { "BoundingBox": { "Width": 0.24350935220718384, "Height": 0.34623199701309204, "Left": 0.43011072278022766, "Top": 0.01103297434747219 }, "Confidence": 83.88762664794922, "Type": "HEAD_COVER", "CoversBodyPart": { "Confidence": 99.96485900878906, "Value": true } } ] } ], "BoundingBox": { "Width": 0.7403100728988647, "Height": 0.9412225484848022, "Left": 0.02214839495718479, "Top": 0.03134796395897865 }, "Confidence": 99.98855590820312, "Id": 0 } ], "Summary": { "PersonsWithRequiredEquipment": [ 0 ], "PersonsWithoutRequiredEquipment": [], "PersonsIndeterminate": [] } }