Программное обеспечение находится в разработке.

Благодарим разработчика ageitgey на GitHub за предоставленный модуль face_recognition, ссылка: https://github.com/ageitgey/face_recognition.

1. Введение

Pyface — это модуль, связанный с распознаванием лиц, который поддерживает:

• определение совпадения между двумя изображениями лиц;
• получение положения лица на изображении.

Возможно, поддерживается только версия Python 3.5 и выше.

2. Установка

2-1. Программа

Поместите папку pyface в тот же каталог, что и скрипт.

2-2. Зависимости

Зависимости: Pillow (PIL), NumPy.

Так как установка dlib занимает много времени, код уже предоставлен.

3. Структура каталогов файлов

Корневой каталог pyface: * init.py * face_recognition (модуль face_recognition) * dlib-19.19.0.egg-info (этот модуль — dlib. Из-за длительного времени установки он был предоставлен автором.) * face_recognition_models (зависимые модули face_recognition): * models (обученные модели): * ... * init.py * api.py * face_recognition_cli.py * face_detection_cli.py * ...

4. Использование

4-1. Обычные функции

• bounding_box(pic_path):

  • возвращает положение лица на изображении;
  • параметры: pic_path — путь к изображению;
  • возвращаемое значение: список, содержащий список из четырёх элементов, представляющих координаты углов лица. Длина списка может быть разной, каждый элемент представляет одно лицо.

• compare(pic1_path, pic2_path, tolerance=0.6):

  • определяет совпадение лиц;
  • параметры: tolerance — необязательный параметр, по умолчанию равен 0,6;
  • возвращаемое значение: список. List[0] — логическое значение, указывающее на совпадение. List[1] и list[2] — позиции первого и второго лица соответственно.
  • примечания:
    1. Выбирается наибольшее лицо для сравнения.
    2. Если на одном из изображений нет лица, возникает исключение PyfaceError («No face was found in the first/second picture.»).

• maxbounding(pic_boundings):

  • находит наибольшее лицо;
  • параметр: pic_boundings — список лиц, предпочтительно полученный из функции bounding_box.
  • возвращаемое значение: элемент списка.

4-2. Классы и объекты

Имя класса: Pyface

• краткое описание: класс, созданный для ускорения работы;

• init(pic_path):

  • загружает изображение;
  • инициализирует функцию;
  • параметры: pic_path — путь к лицу;
  • примечание: если лицо не обнаружено, возникает исключение PyfaceError.

• compare(pic_path,tolerance=0.6)

  • сравнивает изображение с уже имеющимся;
  • параметры: pic_path — путь к лицу, tolerance — порог;
  • возвращаемое значение: список. List[0] — логическое значение совпадения, list[1] — позиция лица на изображении.
  • примечание: необходимо понимать правила.
  • также, чтобы получить позицию первого лица, можно использовать атрибут объекта xy.

5. Замечания

Кстати, из-за технических причин не был написан setup.py. Буду благодарен, если кто-то сможет его создать!