Skip to main content

BriefCam システム管理者ガイド

顔認識 – 関連設定

Last Updated: 12 minute read
バージョン2024r2
言語日本語

注意

この機能はハブには適用されません。これは、サイトおよびスタンドアローンデプロイメントにのみ関連します。

顔認識のクオリティ

顔認識パイプラインではBriefCam、まず顔を検出し、次に顔の特徴を抽出します。

  • 顔が検出されたが、特徴ベクトルが計算されなかった場合、その顔は1つ星になります。

  • 顔が検出され、特徴ベクトルが計算された場合、その顔は少なくとも2つ星になります。

顔が2つ星か3つ星かは、FaceRecognition.ClientFaceQualityThreshold環境設定（デフォルト0.5）によって決定されます

  • 顔のスコアがFaceRecognition.ClientFaceQualityThreshold設定の値より大きい場合、その顔は3つ星になります。

  • 顔のスコアがFaceRecognition.ClientFaceQualityThreshold設定の値より小さい場合、その顔は2つ星になります。

Face recognition quality.png

顔認識マッチングのスケーラビリティ

ウォッチリストは、複数の顔認識照合サービスインスタンス間で共有できます。これは、AkkaShardingInstancesPerWatchlist環境設定を使用して行われます。この設定では、管理者はウォッチリストごとのAKKA共有インスタンスの数（インストールされている照合サービスの数）を設定します。

顔ウォッチリストのアップロードの制限

BriefCam ウォッチリストへの顔のアップロードに関して、組み込まれたデフォルトの制限があります。

  • 一度に最大500枚の画像を顔ウォッチリストにアップロードできます。このデフォルトは、clientMaxFaceImagesUploadCount環境設定を使用して変更できます。

  • 顔の各ファイルは20MBまでに制限されています。

外部ウォッチリストの設定

外部ウォッチリストを有効にするには、ユーザーに外部ウォッチリストを表示する権限を付与する必要があります。

外部ウォッチリストが更新およびアップロードされるパスBriefCam、およびウォッチリストが同期される頻度を制御するには、BriefCam顔認識サービスセクションで次の管理者設定を設定します。

  • ExternalWatchListSync.ExternalFolderScanIntervalMinutes - システムが新しいものがあるかどうかをチェックし、それをウォッチリストまたはウォッチリストにインポートする頻度を設定します。デフォルトでは、チェックは60分ごとに行われます。

  • ExternalWatchListSync.ExternalWatchListRoot – これは、ユーザーが複数の顔をアップロードできるVSサービスマシン上の監視フォルダーへのパスです。デフォルトでは、このフォルダはC:\briefcam\ServerData\ExternalWatchListsにあります。

  • ExternalWatchListSync.SyncMode – 同期のたびにウォッチリストを上書きするか（フォルダーから識別情報を削除すると、システム内でも削除されます）、マージして新しいアイテムのみを読み込むようにするかを設定します。デフォルトでは、これはOverwriteに設定されています。

    ExternalWatchList settings.png

監視フォルダーから複数の顔をアップロードする

ウォッチリストに同期される監視対象フォルダーから複数の顔をアップロードできます。識別情報に複数の顔を、各バッチに複数の識別情報をアップロードできます。

監視フォルダーはVSサーバーマシン上にあります。デフォルトのパスはC:\briefcam\ServerData\ExternalWatchListsです。このパスは管理者によって変更することができます。

このフォルダーを分散環境で使用するには、フォルダーにアクセスする権限がBCUserあることを確認してください。オールインワンインストールの場合、これは必要ありません。

システムは60分ごとに新しいものがあるかどうかを確認し、それをウォッチリストまたはウォッチリストにインポートします。フォルダー内にExternalWatchList、ウォッチリストの名前を使用してサブフォルダーを作成できます。サブフォルダーには、識別情報の名前を含むフォルダーを作成し、それぞれの識別情報のフォルダーには、識別情報の顔の写真が少なくとも1枚あるようにしておきます。

Monitored Folder.png

同期のたびにウォッチリストを上書きする（つまり、識別情報がフォルダーから削除されると、システムからも削除されます）、あるいは新しいアイテムのみを読み込むために統合するオプションがあります。デフォルトでは上書きされます。

この機能のデフォルト設定は、管理者が変更できます。

監視フォルダーを使用して追加されたすべての画像は、星なしの画像（顔が検出されない）や1つ星の画像（顔が検出されたが顔認識には画質が不十分）など、顔照合の最小しきい値を下回る画像を含め、ウォッチリストに追加されます。照合できない画像は無視されBriefCamます。これらの画像をウォッチリストに表示したくない場合は、フォルダーから手動で削除する必要があります。

BI顔認識サービスの設定

  • BIFaceRecognition.MaxSupportedRESEARCHSources – 顔照合が有効になっている場合に、参照元グループが処理できるRESEARCH参照元の最大数を設定します。

  • BIFaceRecognition.FaceMatchingThreshold - RESEARCHモジュールで顔照合のしきい値を設定します。有効な値は0-1です。この設定は、Re-IDプロセス（異なる顔の出現を単一の識別情報に接続する）に追加の微調整レイヤーを提供します。設定が1に設定されている場合、すべての顔の出現は同じ人物とみなされます。0に設定すると、（同じ人でも）すべての出現が異なる人としてカウントされます。

    デフォルトは0.65です。一部の環境では、上下に調整することが有益な場合があります。例えば、環境内のほとんどの人が髪を覆う服を着ている場合、アルゴリズムの方が似て見えます。したがって、顔の出現を人物に結び付けるときに、アルゴリズムをより敏感に調整することは有益です。

  • BIFaceRecognition.FaceMatchingToWatchlistThreshold - ウォッチリスト内の識別情報の顔照合に関するRESEARCHモジュールのしきい値を設定します。有効な値は0-1で、デフォルト値は0.65です。

  • BIFaceRecognition.RESEARCHEnableFaceRecognition - RESEARCHモジュールの顔認識機能を無効にします。デフォルトはfalseです。

    BIFaceRecognition settings.png

顔のアップロードを非表示にする

HideFacesUpload環境設定を使用すると、BriefCam インターフェイスで顔をアップロードする機能をオンまたはオフにできます。これには、顔認識フィルターのUpload Identities(IDのアップロード)ボタンと顔ウォッチリストのAdd Identity（IDの追加）ボタンが含まれます。

顔認識 – OX.iniファイル

高品質の顔のサムネイル

顔のサムネイルはデフォルトで90%に圧縮されています。さらに高い品質が必要な場合は、JPG圧縮を100%（ほぼ可逆圧縮）に変更できます。これは、HighQualityFaceJPGsパラメータの値をfalse（デフォルト）からtrueに変更することで、OX.iniファイルで行われます。

最適な顔認識精度アラート

このファイルにはOX.ini、ウォッチリストを使用するときに最適な顔認識の精度アラートを得るために設定できる顔認識パラメータがいくつかあります。精度を向上させると、処理コストの増加、アラートの遅延、一般的なオブジェクト抽出品質の低下が発生する可能性があることに注意してください。デフォルト値を変更するには、関連する行のコメントを解除し、値を更新します。

関連する設定は次のとおりで、関心のある顔が大きい場合の非常に混雑したシーンの推奨設定が含まれています。

  • FullFrameSsdDetection – 非常に混雑したシナリオでの検出を改善するために、falseからtrueに変更します。これにより、小さなオブジェクトの誤検出につながる可能性があります。

  • RealtimeMinCombinedScoreForAttributes - 0.4から0.3に変更して、顔品質の早期終了しきい値（顔属性の抽出をいつ停止するか）を下げます。値を小さくすると、処理効率を低下させることで精度が向上する可能性があります。

  • RealtimeMinCombinedScoreForFeatureExtraction - 0.4から0.3に変更して、顔品質の早期終了しきい値（いつ顔の特徴ベクトルを抽出しようとするのをやめるか）を下げます。値を小さくすると、処理効率を低下させることで精度が向上する可能性があります。この設定は上記の設定と似ていますが、パイプラインの別の段階です。属性は特徴抽出の前に行われます。

  • RealtimeMaxAttributeExtractionsInTrack – 属性抽出フレームの上限を4から16に増やします。

  • RealtimeMaxFeatureExtractionsInTrack – 特徴抽出フレームの上限を1から4に増やします。

  • RealtimeAlertMaxDelaySeconds - リアルタイムアラートの遅延を4から30に増やして、より長い追跡を取得します。

  • RealtimeAlertCoolDownSeconds – このパラメータは、リアルタイムの顔認識アラートのクールダウン期間を設定します。人が制限内で2回目に現れた場合、2回目はアラートはトリガーされません。