Memahami deteksi alat pelindung diri API

Informasi berikut menjelaskan DetectProtectiveEquipmentAPI. Untuk kode sampel, lihat Mendeteksi alat pelindung diri dalam citra.

Menyuplai citra

Anda dapat memberikan gambar input (JPGatau PNG format) baik sebagai byte gambar atau referensi gambar yang disimpan dalam bucket Amazon S3.

Sebaiknya gunakan citra yang menunjukkan wajah orang tersebut menghadap ke kamera.

Jika citra input Anda tidak diputar ke orientasi 0 derajat, sebaiknya putar ke orientasi 0 derajat sebelum mengirimkannya ke DetectProtectiveEquipment. Gambar dalam JPG format mungkin berisi informasi orientasi dalam metadata format file gambar yang dapat ditukar (Exif). Anda dapat menggunakan informasi ini untuk menulis kode yang memutar citra Anda. Untuk informasi selengkapnya, lihat Exif versi 2.32. PNGformat gambar tidak berisi informasi orientasi gambar.

Untuk meneruskan gambar dari bucket Amazon S3, gunakan pengguna dengan setidaknya priviliges ReadOnlyAccess AmazonS3. Gunakan pengguna dengan AmazonRekognitionFullAccess priviliges untuk menelepon DetectProtectiveEquipment.

Dalam contoh input berikutJSON, gambar dilewatkan dalam bucket Amazon S3. Untuk informasi selengkapnya, lihat Bekerja dengan citra. Contoh meminta ringkasan semua PPE jenis (penutup kepala, penutup tangan, dan penutup wajah) dengan kepercayaan deteksi minimum (MinConfidence) 80%. Anda harus menentukan nilai MinConfidence yang berada antara 50-100% sebagai prediksi kembali DetectProtectiveEquipment hanya jika tingkat kepercayaan pendeteksian berada antara 50% - 100%. Jika Anda menentukan nilai yang kurang dari 50%, hasilnya sama dengan menentukan nilai 50%. Untuk informasi selengkapnya, lihat Menentukan persyaratan peringkasan.

{
    "Image": {
        "S3Object": {
            "Bucket": "bucket",
            "Name": "worker.jpg"
        }
    },
    "SummarizationAttributes": {
        "MinConfidence": 80,
        "RequiredEquipmentTypes": [
            "FACE_COVER",
            "HAND_COVER",
            "HEAD_COVER"
        ]
    }
}

Jika Anda memiliki banyak koleksi gambar untuk diproses, pertimbangkan untuk menggunakan AWSBatch untuk memproses panggilan ke DetectProtectiveEquipment dalam batch di latar belakang.

Menentukan persyaratan peringkasan

Anda dapat menggunakan parameter input SummarizationAttributes (ProtectiveEquipmentSummarizationAttributes) secara opsional untuk meminta informasi ringkasan untuk jenis yang PPE terdeteksi dalam gambar.

Untuk menentukan jenis PPE untuk meringkas, gunakan bidang RequiredEquipmentTypes array. Dalam array, masukkan satu atau beberapa FACE_COVER, HAND_COVER atau HEAD_COVER.

Gunakan MinConfidence untuk menentukan kepercayaan pendeteksian minimum (50-100). Ringkasan tidak termasuk Orang, bagian tubuh, cakupan bagian tubuh, dan itemPPE, terdeteksi dengan kepercayaan lebih rendah dariMinConfidence.

Untuk informasi tentang respons ringkasan dari DetectProtectiveEquipment, lihat Memahami DetectProtectiveEquipment responsnya.

Memahami DetectProtectiveEquipment responsnya

DetectProtectiveEquipment mengembalikan array orang yang terdeteksi dalam citra input. Untuk setiap orang, informasi tentang bagian tubuh yang terdeteksi dan item yang PPE terdeteksi dikembalikan. JSONUntuk gambar berikut seorang pekerja yang mengenakan penutup kepala, penutup tangan, dan penutup wajah adalah sebagai berikut.

DalamJSON, perhatikan hal berikut.

• Orang yang Terdeteksi — Persons adalah serangkaian orang yang terdeteksi pada gambar (termasuk orang yang tidak mengenakanPPE). DetectProtectiveEquipmentdapat mendeteksi PPE hingga 15 orang yang terdeteksi dalam sebuah gambar. Setiap ProtectiveEquipmentPersonobjek dalam array berisi ID orang, kotak pembatas untuk orang tersebut, bagian tubuh yang terdeteksi, dan item yang terdeteksi dariPPE. Nilai dari Confidence dalam ProtectiveEquipmentPerson menunjukkan persentase kepercayaan yang dimiliki Amazon Rekognition jika kotak pembatas tersebut berisi seseorang.

• Bagian Tubuh — BodyParts adalah susunan bagian tubuh (ProtectiveEquipmentBodyPart) yang terdeteksi pada seseorang (termasuk bagian tubuh yang tidak tercakup olehPPE). Setiap ProtectiveEquipmentBodyPart termasuk nama (Name) dari bagian tubuh yang terdeteksi. DetectProtectEquipment dapat mendeteksi bagian tubuh wajah, kepala, tangan kiri, dan tangan kanan. Bidang Confidence dalam ProtectiveEquipmentBodyPart menunjukkan persentase keyakinan yang dimiliki Amazon Rekognition dalam akurasi deteksi bagian tubuh.

• PPEItem - Array EquipmentDetections dalam ProtectiveEquipmentBodyPart objek berisi array PPE item yang terdeteksi. Setiap EquipmentDetectionobjek berisi bidang-bidang berikut.

  • Type— Jenis yang terdeteksiPPE.

  • BoundingBox— kotak pembatas di sekitar yang terdeteksiPPE.

  • Confidence— Keyakinan Amazon Rekognition memiliki bahwa kotak pembatas berisi yang terdeteksi. PPE

  • CoversBodyPart— Menunjukkan apakah yang terdeteksi PPE ada di bagian tubuh yang sesuai.

  CoversBodyPartBidang Value adalah nilai boolean yang menunjukkan apakah terdeteksi PPE berada di bagian tubuh yang sesuai. Bidang Confidence menunjukkan kepercayaan dalam prediksi. Anda dapat menggunakan CoversBodyPart untuk memfilter kasus di mana terdeteksi PPE ada dalam gambar, tetapi tidak benar-benar pada orang tersebut.

  catatan

  CoversBodyPart tidak menunjukkan, atau menyiratkan, bahwa orang tersebut dilindungi secara memadai oleh peralatan pelindung atau bahwa peralatan pelindung itu sendiri sudah dipakai dengan benar.

• Informasi ringkasan — Summary berisi informasi ringkasan yang ditentukan dalam parameter input SummarizationAttributes. Untuk informasi selengkapnya, lihat Menentukan persyaratan peringkasan.

  Summaryadalah objek tipe ProtectiveEquipmentSummaryyang berisi informasi berikut.

  • PersonsWithRequiredEquipment— Berbagai orang di mana setiap orang memenuhi kriteria berikut. IDs

    • Orang tersebut memakai semua yang PPE ditentukan dalam parameter SummarizationAttributes input.

    • Parameter Confidence untuk orang (ProtectiveEquipmentPerson), bagian tubuh (ProtectiveEquipmentBodyPart), peralatan pelindung (EquipmentDetection) sama dengan atau lebih dari ambang batas kepercayaan minimum yang ditentukan (MinConfidence).

    • Nilai CoversBodyPart untuk semua item PPE adalah benar.

  • PersonsWithoutRequiredEquipment— Berbagai orang IDs yang memenuhi salah satu kriteria berikut.

    • ConfidenceNilai untuk orang (ProtectiveEquipmentPerson), bagian tubuh (ProtectiveEquipmentBodyPart), dan cakupan bagian tubuh (CoversBodyPart) lebih besar dari ambang kepercayaan minimum yang ditentukan (MinConfidence), tetapi orang tersebut kehilangan satu atau lebih yang ditentukan PPE (SummarizationAttributes).

    • Nilai false untuk PPE (SummarizationAttributes) tertentu yang memiliki Confidence nilai lebih besar dari ambang kepercayaan minimum yang ditentukan (MinConfidence). CoversBodyPart Orang tersebut juga memiliki semua yang ditentukan PPE (SummarizationAttributes) dan Confidence nilai untuk orang (ProtectiveEquipmentPerson), bagian tubuh (ProtectiveEquipmentBodyPart), dan peralatan pelindung (EquipmentDetection) lebih besar dari atau sama dengan ambang kepercayaan minimum (MinConfidence.

  • PersonsIndeterminate— Array orang yang IDs terdeteksi di mana Confidence nilai untuk orang (ProtectiveEquipmentPerson), bagian tubuh (), peralatan pelindung (EquipmentDetection), atau CoversBodyPart boolean lebih rendah dari ambang kepercayaan minimum yang ditentukan (MinConfidence). ProtectiveEquipmentBodyPart

  Gunakan ukuran array untuk mendapatkan hitungan untuk ringkasan tertentu. Misalnya, ukuran PersonsWithRequiredEquipment memberi tahu Anda jumlah orang yang terdeteksi mengenakan jenis yang ditentukanPPE.

  Anda dapat menggunakan ID orang untuk mengetahui informasi lebih lanjut tentang seseorang, seperti lokasi kotak pembatas orang tersebut. ID orang memetakan ke bidang ID ProtectiveEquipmentPerson) objek yang dikembalikan dalam Persons (array ProtectiveEquipmentPerson). Anda kemudian bisa mendapatkan kotak pembatas dan informasi lainnya dari objek ProtectiveEquipmentPerson yang sesuai.

 {
    "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": []
    }
}