История страницы
...
Find seals and signatures Version 1 (Python)
Группа действийAction group: Robin OCR, подгруппа subgroup Robin
Описание
Действие ищет на изображении объекты трех типов: круглые печати, прямоугольные печати и подписи. Затем записывает информацию только о выбранных типах объектов в таблицу
Иконка действия
Параметры
Входные параметры
Путь к файлу Путь к файлу, в котором нужно найти печати и подписи. Поддерживаемые форматы: 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
Settings of parameters
Property | Description | Type | Filling example | Mandatory field |
Parameters | ||||
File path | Path to the file in which you want to find seals and signatures. Supported formats: |
Свойство
Описание
Тип
Пример заполнения
Обязательность
заполнения поля
Параметры
jpg, jpeg, bmp, png, pdf. | Robin.Image |
Номер страницы
C:\doc\img.png | Yes | |
Page number | The 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 |
Искать круглую печать
No | ||
Look for a round seal | If «true», the action will look for round seals. If «false», all round seals will be skipped. | Robin.Boolean |
true |
No | ||
Look for a rectangular seal | If «true», the action will look for rectangular seals. If «false», all rectangular seals will be skipped. | Robin.Boolean |
true |
No | |
Look for signature | If «true», the action will look for signatures or decryptions of the signature. If «false», all signatures will be skipped. |
Robin.Boolean |
true |
No | |
Minimum recognition accuracy | Recognition accuracy sufficient to save the search results to a table. The allowed value is any number from 0 to 1. Default value: 0.2. |
Robin.Numeric |
No | |
Folder path | Path 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.FolderPath | C:\ |
doc\ |
img |
No |
File name | Title 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 |
Overwrite | If «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 |
No |
Results | ||||
Images with blocks | A collection of paths to images with highlighted seals and signatures. |
Robin.Collection |
Table | A table summarizing the complete information about the retrieved objects. | Robin.DataTable |
Особые условия использования
Действие работает с многостраничными файлами в PDF. Можно обработать все страницы документа, если не указывать номер страницы.
Рекомендуется использовать действие с документами ТОРГ-12, ТРН, ТТН, УПД.
Если в файле есть искомый объект (печати и подписи), но параметр его поиска = false, то в результате данные о нем отображаться не будут.
Если действие не найдет или не распознает печати и подписи, то робот завершится без ошибки, но вернет пустые результаты.
Если "Минимальная точность распознавания" = 0, то все найденные объекты будут записаны в результат. Если "Минимальная точность распознавания" =1, то все 100% распознанных объектов будут записаны в результат.
Если на странице найдено несколько объектов, удовлетворяющих условиям поиска, то будет создано только одно изображение этой страницы с выделенными на ней объектами.
Если выбрали поиск по всем страницам, а печати были найдены только на нескольких, то будут сохранены все страницы исходного документа, при корректно настроенных параметрах для сохранения: "Путь к папке" и "Имя файла".
Если параметры "Имя файла" и "Путь к файлу" заполнены, то изображение с блоками сохраняется в указанной папке с указанным именем в формате .png.
Если сохраняется многостраничный файл, то к названию каждого изображения с блоками будет автоматически добавлен номер страницы.
Пример использования
Задача: нужно найти печати и подписи в файле.
Решение: использовать действие "Найти печати и подписи".
Реализация:
- Собрать робота, состоящего из действий "Найти печати и подписи", "Сохранить таблицу в CSV" - добавить, если нужно посмотреть таблицу с полученными данными:
- Заполнить параметры действия "Найти печати и подписи".
- Заполнить параметры действия "Сохранить таблицу в CSV".
- Нажать на кнопку "Старт" в верхней панели.
...
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.
Solution
Use the “Find stamps and signatures” action.
Implementation
- 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:
- Set the parameters of the “Find stamps and signatures” action.
- Set the parameters of the “Table to CSV” action.
- Click on the “Start” button in the top panel.
Result
The program robot completed successfully.
An image with blocks:
Table
Изображение с блоками:
Таблица: