Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Find seals and signatures Version 1 (Python)

Группа действийAction group: Robin OCR, подгруппа subgroup Robin

Описание 

Действие ищет на изображении объекты трех типов: круглые печати, прямоугольные печати и подписи. Затем записывает информацию только о выбранных типах объектов в таблицу

Иконка действия

Image Removed

Параметры

Входные параметры

Путь к файлу                                                            Путь к файлу, в котором нужно найти печати и подписи. Поддерживаемые форматы: jpg, jpeg, bmp, png, pdf

Номер страницы                                                     Номер страницы файла, с которой нужно извлечь данные. Нумерация начинается с 1. Если поле не заполнено,
                                                                                  данные будут извлечены со всех страниц файла

Искать круглую печать                                           Если "true", то действие будет искать круглые печати. Если "false", то все круглые печати будут пропущены     

Искать прямоугольную печать                              Если "true", то действие будет искать прямоугольные печати. Если "false", то все прямоугольные печати будут пропущены

Искать подпись                                                       Если "true", то действие будет искать подписи или расшифровки. Если "false", то все подписи будут пропущены

Минимальная точность распознавания               Точность распознавания, достаточная для сохранения результатов поиска в таблицу. Допустимое значение - любое число от 0 до 1
                                                                                 Значение по умолчанию: 0,2

Путь к папке                                                            Путь к папке, в которую будут сохранены изображения страниц файла с выделенными на них печатями и подписями.
                                                                                 Для сохранения файла также нужно заполнить поле "Имя файла"
    

Имя файла                                                               Название для изображений с выделенными печатями и подписями (без расширения).

                                                                                 Если исходный файл - многостраничный, к названию сохраненных файлов будет добавлен соответствующий номер страницы.

                                                                                 По умолчанию создаются изображения с расширением .png. Для сохранения изображений также нужно заполнить поле "Путь к папке"   

Перезаписать                                                          Если "true", и в указанной папке существует изображение с таким же именем и расширением, то новое изображение его перезапишет
                                                                                 Если "false", то изображение не будет 
перезаписано и действие вернет ошибку

Выходные параметры

Изображения с блоками                                      Коллекция путей к изображениям с выделенными печатями и подписями

Таблица                                                                 Таблица, в которой собрана полная информация о найденных объектах                                                                              

                                                                               Результирующая таблица состоит из следующих столбцов:

                  • "Объект" - по названию можно будет точно соотнести объект на странице изображения с блоками с информацией, записанной о нем в таблице
                  • "Тип объекта" – возможные значения: "Круглая печать", "Прямоугольная печать", "Подпись"
                  • "Координаты верхнего левого угла".  Пример: (53; 87) Тип данных: Robin.LocationPoint
                  • "Координаты нижнего правого угла". Пример: (53; 87) Тип данных: Robin.LocationPoint
                  • "Номер страницы" - номер страницы, на которой найден объект
                  • "Индекс" - порядковый номер объекта искомого вида на текущей странице
                  • "Точность распознавания" – точность распознавания объекта в диапазоне от 0 до 1

Настройки

...

Description 

The action searches the image for objects of three types: round stamps, rectangular stamps and signatures. Then it records information only about the selected types of objects in the table

Action icon

Image Added

Settings of parameters

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
File pathPath to the file in which you want to find seals and signatures. Supported formats:

Свойство

Описание

Тип

Пример заполнения

Обязательность 

заполнения поля

Параметры

Путь к файлуПуть к файлу, в котором нужно найти печати и подписи. Поддерживаемые форматы:
jpg, jpeg, bmp, png, pdf.Robin.Image
test.pdfДа

Номер страницы

Номер страницы файла, с которой нужно извлечь данные. Нумерация начинается с 1. Если поле не заполнено, данные будут извлечены со всех страниц файла
C:\doc\img.pngYes
Page numberThe page number of the file from which you want to extract data. The numbering starts from 1. If the field is not filled in, the data will be extracted from all pages of the file.Robin.Numeric
4Нет

Искать круглую печать

Если "true", то действие будет искать круглые печати. Если "false", то все круглые печати будут пропущены

No
Look for a round sealIf «true», the action will look for round seals. If «false», all round seals will be skipped.Robin.Boolean
True
true
НетИскать прямоугольную печатьЕсли "true", то действие будет искать прямоугольные печати. Если "false", то все прямоугольные печати будут пропущены
No
Look for a rectangular sealIf «true», the action will look for rectangular seals. If «false», all rectangular seals will be skipped.Robin.Boolean
True
true
Нет
No
Look for signatureIf «true», the action will look for signatures or decryptions of the signature. If «false», all signatures will be skipped.
Искать подписьЕсли "true", то действие будет искать подписи или расшифровки. Если "false", то все подписи будут пропущены
Robin.Boolean
True
true
НетМинимальная точность распознавания
No
Minimum recognition accuracyRecognition accuracy sufficient to save the search results to a table. The allowed value is any number from 0 to 1. Default value: 0.2.
Точность распознавания, достаточная для сохранения результатов поиска в таблицу. Допустимое значение - любое число от 0 до 1. Значение по умолчанию: 0,2
Robin.Numeric
0,5НетПуть к папке

No
Folder pathPath to the folder where images of file pages with highlighted stamps and signatures will be saved. To save the file, you also need to fill in the «File name» field.
Путь к папке, в которую будут сохранены изображения страниц файла с выделенными на них печатями и подписями. Для сохранения файла также нужно заполнить поле "Имя файла"
Robin.FolderPathC:\
Users
doc\
user\Downloads
img
Нет
No
Имя файлаНазвание для изображений с выделенными печатями и подписями (без расширения). Если исходный файл - многостраничный, к названию сохраненных файлов будет добавлен соответствующий номер страницы. По умолчанию создаются изображения с расширением .png. Для сохранения изображений также нужно заполнить поле "Путь к папке"
File nameTitle for images with highlighted stamps and signatures (no extension). If the source file is a multi-page file, the corresponding page number will be added to the name of the saved files. By default, images with .png extension are created. To save images you should also fill in the «Folder path» field.Robin.String
Тест

No
НетПерезаписатьЕсли "true", и в указанной папке существует изображение с таким же именем и расширением, то новое изображение его перезапишет. Если "false", то изображение не будет перезаписано и действие вернет ошибку
OverwriteIf «true» and an image with the same name and extension exists in the specified folder, the new image will overwrite it. If «false», the image will not be overwritten and the action will return an error.Robin.Boolean
True
true
Нет
No
Результаты
Results
Images with blocksA collection of paths to images with highlighted seals and signatures.
Изображения с блокамиКоллекция путей к изображениям с выделенными печатями и подписями
Robin.Collection
ТаблицаТаблица, в которой собрана полная информация о найденных объектах


TableA table summarizing the complete information about the retrieved objects.Robin.DataTable

Особые условия использования

Действие работает с многостраничными файлами в PDF. Можно обработать все страницы документа, если не указывать номер страницы.

Рекомендуется использовать действие с документами ТОРГ-12, ТРН, ТТН, УПД.

Если в файле есть искомый объект (печати и подписи), но параметр его поиска = false, то в результате данные о нем отображаться не будут.

Если действие не найдет или не распознает печати и подписи, то робот завершится без ошибки, но вернет пустые результаты.

Если "Минимальная точность распознавания" = 0, то все найденные объекты будут записаны в результат. Если "Минимальная точность распознавания" =1, то все 100% распознанных объектов будут записаны в результат.

Если на странице найдено несколько объектов, удовлетворяющих условиям поиска, то будет создано только одно изображение этой страницы с выделенными на ней объектами.

 Если выбрали поиск по всем страницам, а печати были найдены только на нескольких, то будут сохранены все страницы исходного документа, при корректно настроенных параметрах для сохранения: "Путь к папке" и "Имя файла".

Если параметры "Имя файла" и  "Путь к файлу" заполнены, то изображение с блоками сохраняется в указанной папке с указанным именем в формате .png.

Если сохраняется многостраничный файл, то к названию каждого изображения с блоками будет автоматически добавлен номер страницы.

Пример использования 

Задача: нужно найти печати и подписи в файле.

Image Removed

Решение: использовать действие "Найти печати и подписи".

Реализация:

  1. Собрать робота, состоящего из действий "Найти печати  и подписи", "Сохранить таблицу в CSV" - добавить, если нужно посмотреть таблицу с полученными данными:
    Image Removed
  2. Заполнить параметры действия "Найти печати  и подписи".
    Image Removed
  3. Заполнить параметры действия "Сохранить таблицу в CSV".
    Image Removed
  4. Нажать на кнопку "Старт" в верхней панели.

...



Special conditions of use

The action works with multi-page PDF files. You can process all pages of the document if the page number is not specified.

It is recommended to use the action with TOR-12, TRN, TTN, and UPD documents.

If the file contains the sought object (stamps and signatures), but the search parameter is set to false, then the data about it will not be displayed in the results.

If the action does not find or recognize stamps and signatures, the robot will complete without error but will return empty results.

If “Minimum recognition accuracy” = 0, all found objects will be written to the result. If “Minimum recognition accuracy” =1, all 100% of recognized objects will be written to the result.

If several objects matching the search conditions are found on a page, only one image of this page with the selected objects will be created.

 If you have chosen to search all pages, and stamps were found only on a few pages, all pages of the source document will be saved, if the “Folder path” and “File name” parameters are set correctly.

If the “File name” and “File path” parameters are filled in, the image with blocks is saved in the specified folder with the specified name in .png format.

If a multi-page file is saved, a page number will be automatically added to the name of each block image.

Example of use 

Task

Need to find stamps and signatures in the file.

Image Added

Solution

Use the “Find stamps and signatures” action.

Implementation

  1. Assemble robot scheme consisting of actions “Find stamps and signatures”, “Table to CSV” - add if you need to see the table with the received data:
    Image Added
  2. Set the parameters of the “Find stamps and signatures” action.
    Image Added
  3. Set the parameters of the “Table to CSV” action.
    Image Added
  4. Click on the “Start” button in the top panel.


Result

The program robot completed successfully. 
Image Added

Image Added
An image with blocks:

Image Added

Table

Image Removed
Изображение с блоками:

Image Removed

Таблица: