1. Назначение программы
Leak Finder - это пользовательский инструмент для анализа данных газовой инспекции. Программа загружает лог-файлы, строит график концентрации, показывает маршрут движения на карте, выделяет обнаруженные утечки, позволяет прикреплять фотографии и формировать отчёты.
Обработка выполняется локально в браузере: исходные файлы не отправляются на сервер. Это удобно для полевой проверки, предварительного анализа и подготовки отчётных материалов без установки отдельного программного обеспечения.
ВажноРезультаты автоматического поиска утечек следует проверять визуально: по графику концентрации, карте, таблице, линии концентрации и, при наличии, фотографиям. Автоматический алгоритм помогает ускорить работу, но не заменяет инженерную оценку данных.
2. Быстрый старт
- Откройте Leak Finder в браузере.
- Выберите формат данных или оставьте режим «Авто».
- Загрузите файл или архив: перетащите его в область загрузки либо выберите через диалог.
- Проверьте единицы исходных данных для скорости и ветра. При необходимости измените единицы отображения для отчёта.
- Настройте порог утечки и дистанцию объединения близких пиков.
- Проверьте график концентрации, карту и таблицу утечек.
- При наличии фотографий нажмите «Добавить фото утечек» и выберите папку с изображениями.
- Для важных утечек откройте контекстное меню на маркере карты и выберите «Добавить в отчёт».
- Сформируйте PDF или Word-отчёт.
Рекомендуемый порядокСначала приведите карту к нужному масштабу и ракурсу, затем добавляйте утечку в отчёт. В отчёт попадёт снимок карты именно в том виде, в котором она была в момент нажатия «Добавить в отчёт».
3. Поддерживаемые форматы данных
Программа рассчитана на работу с несколькими типами данных. В большинстве случаев можно оставить режим «Авто», но при нестандартной структуре файла лучше выбрать формат вручную.
| Формат | Назначение / особенности |
|---|
| Авто | Автоматическое определение формата по содержимому файла. |
| LMF ver.2.1 | Логи LMF версии 2.1. |
| Falcon G2 | Формат Falcon G2. |
| Laser Falcon | Формат Laser Falcon. |
| APP | Формат APP. |
| Falcon Plus | Основной файл может сопровождаться DETR-файлом с линиями концентрации. |
| Alma G5 type | Сессии Alma G5: используются track, slow, fast и detr-файлы с расширением dat. |
| Alma G4 type | Сессии Alma G4: используются trak, slow, fast и detr-файлы с расширением tdms. |
| Selma Dome | Формат Selma Dome. |
| Pergam Sniffer | Формат Pergam Sniffer. |
| Selma PPB | Формат Selma PPB. |
| Selma DUO | Формат Selma DUO. |
Если файл не распознаётся автоматически или структура отличается от стандартной, используйте ручной парсер. Он позволяет явно указать разделитель, формат чисел и нужные колонки.
4. Основные элементы интерфейса
| Элемент | Что делает |
|---|
| Зона загрузки файла | Принимает перетаскивание файла или выбор через стандартный диалог. |
| Формат данных | Позволяет выбрать тип файла или оставить автоопределение. |
| Исходные единицы | Задают единицы, в которых скорость и ветер записаны в файле. |
| Единицы отображения | Определяют, как значения показываются в интерфейсе и отчётах. |
| Порог утечки | Минимальный уровень концентрации, по которому отбираются потенциальные утечки. |
| Дистанция | Параметр объединения близких пиков/маркеров в одну утечку. |
| График концентрации | Показывает изменение концентрации по времени или точкам маршрута. |
| Карта | Показывает траекторию, точки концентрации и маркеры утечек. |
| Таблица утечек | Содержит список найденных утечек и их основные характеристики. |
| Линия концентрации | Дополнительный график для анализа формы линии утечки и сравнения с реперной линией. |
| Сводка | Показывает качество данных, количество точек, ошибок, файлов и найденных утечек. |
| Экспорт | Формирует отчёты и файлы для внешних систем. |
5. Порог утечки, дистанция и единицы измерения
Порог утечки
Порог утечки определяет минимальный уровень концентрации, который считается значимым для поиска утечек. При изменении порога программа пересчитывает список утечек, обновляет график, карту и таблицу.
Слишком низкий порог может привести к большому количеству слабых или шумовых срабатываний. Слишком высокий порог может скрыть слабые, но реальные утечки.
Дистанция
Дистанция используется для объединения близко расположенных пиков. Если рядом несколько срабатываний, которые фактически относятся к одному месту, программа может объединить их в одну утечку.
Единицы измерения
В интерфейсе есть два разных смысла единиц: исходные единицы и единицы отображения. Исходные единицы должны соответствовать тому, как данные записаны в файле. Единицы отображения выбираются для удобства просмотра и отчёта.
- Если в файле скорость записана в km/h, выберите km/h в исходных единицах.
- Если в файле скорость записана в m/s, оставьте m/s.
- Единицы отображения можно менять без повторной загрузки файла: программа пересчитает видимые значения.
6. График концентрации
График концентрации показывает изменение измеренной концентрации вдоль записи. Он помогает быстро увидеть пики, периоды повышенного фона, разрывы данных и соответствие найденных утечек реальному сигналу.
- Масштабирование по оси X и Y позволяет рассмотреть интересующий участок.
- Красная линия порога показывает текущий уровень отбора утечек.
- Выбор строки в таблице подсвечивает соответствующий участок на графике.
- Кнопки отображения значений и времени помогают проверить конкретные точки.
- При скрытии сегмента маршрута соответствующий участок на графике отображается как нулевая концентрация.
Практический смыслПеред экспортом отчёта полезно проверить, что найденная утечка действительно соответствует выраженному пику концентрации, а не единичному шумовому выбросу или проблемному участку данных.
7. Карта, визуальные настройки и скрытие сегментов
Карта
Карта показывает маршрут инспекции, точки концентрации и маркеры найденных утечек. Выбор утечки в таблице или на карте синхронизирует остальные элементы интерфейса.
- Можно выбрать подложку карты, например OpenStreetMap или спутниковую подложку.
- Автомасштаб подбирает область просмотра под текущие данные.
- Лупа помогает рассмотреть плотные участки маршрута и расположение маркеров.
- При выборе утечки карта центрируется на соответствующей области.
Визуальные настройки карты
Панель «Визуальные настройки» управляет внешним видом маршрута, точек концентрации, маркеров утечек и подложки карты. Эти настройки важны не только для просмотра, но и для снимков карты, которые попадают в отчёт по отдельным утечкам.
| Группа настроек | Доступные действия |
|---|
| Маршрут | Показать/скрыть, изменить толщину, цвет, стиль линии и прозрачность. |
| Точки концентрации | Показать/скрыть, изменить размер, форму, прозрачность и режим окраски. |
| Маркеры утечек | Показать/скрыть, изменить размер, форму и прозрачность. |
| Подложка карты | Изменить прозрачность фоновой карты. |
Скрытие сегментов маршрута
Если часть маршрута некорректна или её нужно исключить из анализа, можно вручную скрыть сегмент. После выбора начальной и конечной точки программа исключает этот участок из отображения и анализа найденных утечек.
- Скрытые сегменты создают разрыв на карте.
- Утечки внутри скрытого сегмента удаляются из таблицы и карты.
- Доступна отмена последнего скрытия через кнопку «Отменить скрытие».
- Скрытие сегментов полезно при ошибках координат, разворотах, тестовых проездах и участках, которые не относятся к инспекции.
8. Таблица утечек и действия с утечками
Таблица утечек содержит основные характеристики найденных утечек. Набор колонок зависит от формата данных, но обычно включает номер, время, координаты, концентрацию, оценку расхода, скорость, ветер, длительность и фото.
| Действие | Результат |
|---|
| Выбор строки | Утечка выделяется на карте и графике. |
| Выбор маркера на карте | Соответствующая утечка выбирается в таблице. |
| Контекстное меню на маркере | Открывает действия для выбранной утечки: добавить/удалить из отчёта, удалить утечку. |
| Удалить утечку | Утечка удаляется из таблицы и карты после подтверждения. Удалённая утечка не попадает в отчёт. |
| Бейдж «Отчёт» | Показывает, что утечка добавлена в расширенный блок следующего отчёта. |
ВажноУдаление утечки - это пользовательское исключение из текущей сессии анализа. Используйте его для явно ошибочных срабатываний, но сохраняйте осторожность: если есть сомнения, лучше сначала проверить графики и карту.
9. Фото мест утечек
Фото помогают связать числовые данные с реальной ситуацией на месте. Программа может автоматически сопоставлять фотографии с утечками по времени съёмки.
- Нажмите «Добавить фото утечек» и выберите папку с изображениями.
- Программа ищет ближайшее фото по времени к каждой утечке.
- Если часы камеры и прибора расходились, используйте смещение времени.
- Параметр «Временное окно» задаёт максимальную допустимую разницу между временем утечки и временем фото.
- При необходимости фото можно привязать или заменить вручную.
- Если утечка добавлена в расширенный отчётный блок, её фото помещается в нижнюю часть блока.
10. Линия концентрации
Leak Line - дополнительный график, который показывает форму линии концентрации для выбранной утечки. Он особенно важен для форматов, где доступны DETR файлы: Falcon Plus, Alma G5 type и Alma G4 type.
Реперная и аналитическая линии
На графике могут отображаться две линии: реперная линия и аналитическая линия. Сравнение этих линий помогает оценить, насколько форма выбранной утечки похожа на ожидаемый профиль.
- Реперная линия отображается как базовый профиль для сравнения.
- Аналитическая линия относится к выбранной утечке или выбранной Leak Line.
- Индикатор корреляции показывает степень сходства между линиями: чем значение ближе к 1, тем выше совпадение формы.
Режимы отображения
- По умолчанию в списке показываются линии концентрации, для которых найдены утечки.
- Опция «Показать все линии» отображает все доступные линии концентрации, включая те, для которых утечки не обнаружены.
- Если выбрана утечка, программа старается автоматически переключить Leak Line chart на соответствующую линию.
- Если подходящая линия не найдена, на графике выводится сообщение о том, что линия концентрации для выбранной утечки не найдена.
- Если в режиме «Показать все линии» выбрана линия без утечки, выбор в таблице, на карте и на графике концентрации сбрасывается.
Особенности Alma G4/G5
Для Alma G4/G5 данные обычно загружаются как набор файлов одной сессии. В окне выбора сессии программа показывает найденные сессии и их состояние. Для корректного анализа нужны файлы траектории, slow, fast и detr. В Alma G4 возможны записи без канала Correlation; в этом случае отсутствие канала не должно обнулять всю линию концентрации.
- В основной панели для Alma G4/G5 изменение порога утечки может быть отключено, если обработка управляется параметрами сессии.
- Slow-линия используется как основной источник значения утечки.
- Fast-линия используется как дополнительная проверка автоматического обнаружения.
- Линии концентрации строятся по detr-данным и помогают визуально проверить событие.
11. Добавление выбранных утечек в отчёт
Расширенные блоки отдельных утечек позволяют вынести в отчёт только те события, которые пользователь считает важными для подробного описания. Это удобно, когда общий отчёт содержит много утечек, но детально нужно показать несколько ключевых.
Как добавить утечку в отчёт
- Найдите нужную утечку на карте или в таблице.
- При необходимости настройте вид карты: масштаб, подложку, визуальные настройки, положение области просмотра.
- Откройте контекстное меню на маркере утечки на карте.
- Программа выберет эту утечку так же, как при обычном клике: обновятся таблица, график концентрации и линия концентрации.
- Нажмите «Добавить в отчёт».
- В таблице рядом с номером утечки появится бейдж «Отчёт».
Что сохраняется для отчёта
- Номер утечки из таблицы.
- Характеристики утечки в стиле основной таблицы.
- График концентрации, соответствующий выбранной утечке.
- График линии концентрации, если линия доступна.
- Снимок карты в том виде, в котором карта была на момент добавления.
- Фото места утечки, если оно было прикреплено.
Как удалить утечку из расширенного отчёта
Для утечки, которая уже добавлена в отчёт, в контекстном меню появляется команда «Удалить из отчёта». После удаления бейдж «Отчёт» исчезает, а отдельный блок этой утечки не будет включён в следующий Word/PDF-отчёт.
Практический советПеред нажатием «Добавить в отчёт» желательно выставить карту так, чтобы в кадр попадали и сама утечка, и важный фрагмент маршрута. Это избавит от необходимости вручную редактировать карту в готовом документе.
12. Отчёты Word и PDF
Отчёты предназначены для передачи результатов анализа в читаемом виде. PDF удобен как итоговый документ с фиксированным внешним видом. Word удобен для редактирования текста, таблиц и пояснений перед финальной отправкой.
Основной отчёт
- Метаданные и общая информация по файлу или набору файлов.
- Общий график концентрации.
- Карта с маршрутом и найденными утечками.
- Основная таблица утечек.
- При необходимости - дополнительные блоки выбранных утечек.
Расширенные блоки выбранных утечек
- Каждая утечка, добавленная через «Добавить в отчёт», получает отдельный блок с заголовком вида «Утечка #N», где N - номер утечки из таблицы.
- Каждый блок начинается с новой страницы.
- Характеристики утечки оформляются в стиле основной таблицы/основного отчёта.
- График концентрации, линии концентрации, карта и фото располагаются один под другим на всю доступную ширину страницы.
- Изображения масштабируются без искажения пропорций.
- Если элемент не помещается на текущую страницу, он переносится на следующую страницу целиком.
- Фото утечки, если оно есть, располагается в нижней части блока в полную ширину.
Различия Word и PDF
| Формат | Когда использовать | Особенности |
|---|
| PDF | Когда нужен готовый фиксированный отчёт. | Сохраняет пропорции графиков и карт. Элементы переносятся целиком, если не помещаются на страницу. |
| Word | Когда отчёт нужно отредактировать вручную. | Использует узкие поля и безопасный масштаб, чтобы графики и карты не выходили за границы страницы. |
13. Сводка качества данных
Сводка помогает быстро понять, насколько корректно загрузились данные и есть ли проблемы с координатами, временем, концентрацией или парсингом.
- Тип системы/формат данных.
- Количество файлов.
- Исходные и итоговые точки.
- Количество ошибочных точек.
- Длина маршрута и длительность записи.
- Количество утечек и количество утечек с фото.
- Максимальная концентрация.
- Разбивка ошибок по причинам: координаты отсутствуют, координаты 0,0, координаты вне диапазона, некорректное время, некорректная концентрация, ошибки парсинга.
Как читать сводкуЕсли итоговых точек на карте заметно меньше, чем исходных записей, проверьте причины отбраковки. Разрывы на маршруте часто связаны не с ошибкой карты, а с отфильтрованными координатами.
14. Экспорт в GIS-форматы
Кроме Word и PDF, программа может экспортировать данные в форматы, пригодные для внешних картографических и GIS-инструментов.
| Формат | Назначение |
|---|
| TXT | Текстовая выгрузка с датой/временем, концентрацией, координатами и утечками. |
| KML | Просмотр маршрута и маркеров утечек в Google Earth и совместимых программах. |
| KMZ | Архивированный вариант KML. |
| GPX | GPS-трек с расширенными полями. |
| SHP | ZIP-архив со слоями track/leaks для GIS. |
| RedHen | CSV для RedHen и полевых GIS-процессов. |
| GeoJSON | Маршрут и утечки для GIS/web-карт. |
Для геоэкспорта нужны корректные координаты. Если координаты отсутствуют или отфильтрованы, программа покажет сообщение о невозможности геоэкспорта.
15. Ручной парсер
Ручной парсер нужен для файлов, которые не подходят под стандартные форматы или распознаются некорректно. Он позволяет настроить правила чтения таблицы без изменения исходного файла.
- Выбор разделителя: запятая, точка с запятой, табуляция или другой символ.
- Настройка десятичного и тысячного разделителей.
- Пропуск строк шапки.
- Назначение колонок даты, времени, широты, долготы, концентрации и дополнительных параметров.
- Проверка результата до основного анализа.
Когда использоватьРучной парсер особенно полезен, если файл экспортирован из сторонней системы, содержит нестандартную шапку или использует локальные числовые форматы.
16. Практические рекомендации
- Перед формированием отчёта проверьте общий график концентрации: сильные пики должны совпадать с найденными утечками.
- Проверьте карту: маркеры утечек должны находиться на реальном маршруте, а не в точках с ошибочными координатами.
- Для спорных утечек откройте линии концентрации и оцените форму аналитической линии относительно реперной.
- Перед добавлением утечки в расширенный отчёт настройте вид карты так, как он должен выглядеть в документе.
- Если фото важно для отчёта, проверьте его привязку до экспорта.
- Используйте скрытие сегментов для явно некорректных участков маршрута, но не скрывайте данные только потому, что они выглядят неудобно.
- Для Word-отчёта после генерации всё равно просмотрите документ: при необходимости можно добавить комментарии, пояснения и выводы.
17. Типичные ситуации и способы решения
| Ситуация | Что проверить / сделать |
|---|
| Файл не распознаётся | Выберите формат вручную или используйте ручной парсер. Проверьте кодировку, разделители и наличие шапки. |
| На карте есть разрывы | Проверьте сводку качества данных: возможно, часть координат отсутствует, равна 0,0 или выходит за допустимый диапазон. |
| Слишком много утечек | Повышайте порог утечки или увеличьте дистанцию объединения близких пиков. Проверьте, не является ли участок шумовым. |
| Слишком мало утечек | Проверьте порог, единицы исходной концентрации и качество данных. |
| Фото не привязались | Проверьте EXIF-время фото, смещение времени и временное окно. При необходимости привяжите фото вручную. |
| Leak Line не найдена для выбранной утечки | Проверьте наличие DETR/линейных данных и режим отображения. Для части утечек соответствующая линия может отсутствовать. |
| В отчёт не попала нужная утечка | Убедитесь, что рядом с ней есть бейдж «Отчёт», и что утечка не была удалена. |
| В отчёте карта выглядит не так, как ожидалось | Добавляйте утечку в отчёт только после настройки масштаба и положения карты. Снимок сохраняется в момент нажатия «Добавить в отчёт». |
18. Горячие клавиши и полезные действия
| Действие | Описание |
|---|
| Esc | Закрывает справку и просмотр исходных данных. |
| G | Включает/использует лупу карты, если эта функция активна в интерфейсе. |
| + / - | Изменяют размер лупы карты. |
| Клик по строке таблицы | Выбирает утечку и синхронизирует карту/графики. |
| Клик по маркеру утечки | Выбирает утечку на карте. |
| Контекстное меню на маркере | Открывает действия для отчёта и удаления утечки. |
| ← / → | Переход к предыдущей или следующей утечке. При выборе утечки карта, таблица и графики синхронизируются. |
1. Program purpose
Leak Finder is a user tool for analyzing gas inspection data. The program loads log files, builds a concentration chart, shows the movement route on the map, highlights detected leaks, allows photos to be attached, and generates reports.
Processing is performed locally in the browser: source files are not sent to a server. This is convenient for field checks, preliminary analysis, and preparation of report materials without installing separate software.
ImportantAutomatic leak detection results should be checked visually using the concentration chart, map, table, Leak Line, and photos when available. The automatic algorithm helps speed up the work, but it does not replace engineering evaluation of the data.
2. Quick start
- Open Leak Finder in the browser.
- Select the data format or leave the Auto mode.
- Load a file or archive: drag it into the upload area or select it through the dialog.
- Check the source units for speed and wind. If needed, change the display units for the report.
- Set the leak threshold and the distance for merging nearby peaks.
- Check the concentration chart, map, and leak table.
- If photos are available, click Add Leak Images and select the image folder.
- For important leaks, open the context menu on the map marker and choose Add to report.
- Generate a PDF or Word report.
Recommended orderFirst set the map to the required scale and view angle, then add the leak to the report. The report will include the map snapshot exactly as it was at the moment Add to report was clicked.
3. Supported data formats
The program is designed to work with several data types. In most cases, you can leave Auto mode, but for a non-standard file structure it is better to select the format manually.
| Format | Purpose / notes |
|---|
| Auto | Automatic format detection by file contents. |
| LMF ver.2.1 | LMF version 2.1 logs. |
| Falcon G2 | Falcon G2 format. |
| Laser Falcon | Laser Falcon format. |
| APP | APP format. |
| Falcon Plus | The main file can be accompanied by a DETR file with Leak Lines. |
| Alma G5 type | Alma G5 sessions: track, slow, fast, and detr files with the dat extension are used. |
| Alma G4 type | Alma G4 sessions: trak, slow, fast, and detr files with the tdms extension are used. |
| Selma Dome | Selma Dome format. |
| Pergam Sniffer | Pergam Sniffer format. |
| Selma PPB | Selma PPB format. |
| Selma DUO | Selma DUO format. |
If the file is not detected automatically or its structure differs from the standard one, use the manual parser. It lets you explicitly set the delimiter, number format, and required columns.
4. Main interface elements
| Element | What it does |
|---|
| File upload area | Accepts file drag and drop or selection through the standard dialog. |
| Data format | Allows selecting the file type or leaving automatic detection. |
| Source units | Set the units in which speed and wind are written in the file. |
| Display units | Define how values are shown in the interface and reports. |
| Leak threshold | Minimum concentration level used to select potential leaks. |
| Distance | Parameter for merging nearby peaks/markers into one leak. |
| Concentration chart | Shows concentration changes over time or route points. |
| Map | Shows the track, concentration points, and leak markers. |
| Leak table | Contains the list of detected leaks and their main characteristics. |
| Leak Line | Additional chart for analyzing the leak line shape and comparing it with the reference line. |
| Summary | Shows data quality, number of points, errors, files, and detected leaks. |
| Export | Generates reports and files for external systems. |
5. Leak threshold, distance, and measurement units
Leak threshold
The leak threshold defines the minimum concentration level considered significant for leak detection. When the threshold changes, the program recalculates the leak list and updates the chart, map, and table.
A threshold that is too low can produce many weak or noisy events. A threshold that is too high can hide weak but real leaks.
Distance
Distance is used to merge closely located peaks. If several events are near each other and actually belong to the same place, the program can merge them into one leak.
Measurement units
The interface has two different unit meanings: source units and display units. Source units must match how the data is written in the file. Display units are selected for convenient viewing and reporting.
- If speed is written in km/h in the file, select km/h in source units.
- If speed is written in m/s, keep m/s.
- Display units can be changed without reloading the file: the program recalculates the visible values.
6. Concentration chart
The concentration chart shows how the measured concentration changes along the record. It helps quickly see peaks, periods of elevated background, data gaps, and whether detected leaks match the real signal.
- Zooming on the X and Y axes lets you inspect the area of interest.
- The red threshold line shows the current leak selection level.
- Selecting a row in the table highlights the corresponding area on the chart.
- Value and time display buttons help check specific points.
- When a route segment is hidden, the corresponding part of the chart is displayed as zero concentration.
Practical meaningBefore exporting a report, it is useful to check that the detected leak really corresponds to a clear concentration peak and not to a single noisy spike or a problematic data area.
7. Map, visual settings, and hiding segments
Map
The map shows the inspection route, concentration points, and markers of detected leaks. Selecting a leak in the table or on the map synchronizes the other interface elements.
- You can choose the map base layer, for example OpenStreetMap or satellite imagery.
- Auto fit adjusts the view area to the current data.
- The spyglass helps inspect dense route areas and marker positions.
- When a leak is selected, the map centers on the corresponding area.
Map visual settings
The Visual Settings panel controls the appearance of the route, concentration points, leak markers, and map base layer. These settings matter not only for viewing, but also for map snapshots included in selected leak report blocks.
| Settings group | Available actions |
|---|
| Route | Show/hide, change thickness, color, line style, and opacity. |
| Concentration points | Show/hide, change size, shape, opacity, and coloring mode. |
| Leak markers | Show/hide, change size, shape, and opacity. |
| Map base layer | Change the opacity of the background map. |
Hiding route segments
If part of the route is incorrect or must be excluded from analysis, you can manually hide a segment. After selecting the start and end points, the program excludes this part from display and from detected leak analysis.
- Hidden segments create a break on the map.
- Leaks inside a hidden segment are removed from the table and map.
- The last hide operation can be undone with the Undo hide button.
- Hiding segments is useful for coordinate errors, turns, test passes, and areas that are not part of the inspection.
8. Leak table and leak actions
The leak table contains the main characteristics of detected leaks. The column set depends on the data format, but usually includes number, time, coordinates, concentration, flow estimate, speed, wind, duration, and photo.
| Action | Result |
|---|
| Select row | The leak is highlighted on the map and chart. |
| Select marker on the map | The corresponding leak is selected in the table. |
| Context menu on marker | Opens actions for the selected leak: add/remove from report, delete leak. |
| Delete leak | The leak is removed from the table and map after confirmation. A deleted leak is not included in the report. |
| Report badge | Shows that the leak has been added to the extended block of the next report. |
ImportantDeleting a leak is a user exclusion from the current analysis session. Use it for clearly false events, but stay careful: if there is any doubt, first check the charts and the map.
9. Leak location photos
Photos help connect numeric data with the real on-site situation. The program can automatically match photos to leaks by shooting time.
- Click Add Leak Images and select the folder with images.
- The program searches for the nearest photo by time for each leak.
- If the camera and instrument clocks differed, use the time offset.
- The Time window parameter sets the maximum allowed difference between leak time and photo time.
- If needed, a photo can be linked or replaced manually.
- If a leak is added to the extended report block, its photo is placed in the lower part of the block.
10. Leak Line
Leak Line is an additional chart that shows the concentration line shape for the selected leak. It is especially important for formats where DETR files are available: Falcon Plus, Alma G5 type, and Alma G4 type.
Reference and analytic lines
The chart can show two lines: the reference line and the analytic line. Comparing these lines helps estimate how similar the selected leak shape is to the expected profile.
- The reference line is displayed as the base profile for comparison.
- The analytic line belongs to the selected leak or selected Leak Line.
- The correlation indicator shows the similarity between the lines: the closer the value is to 1, the better the shape match.
Display modes
- By default, the list shows Leak Lines for which leaks were found.
- The Show all lines option displays all available Leak Lines, including those where no leaks were detected.
- If a leak is selected, the program tries to switch the Leak Line chart to the corresponding line automatically.
- If a matching line is not found, the chart shows a message that the concentration line for the selected leak was not found.
- If a line without a leak is selected in Show all lines mode, selection in the table, map, and concentration chart is cleared.
Alma G4/G5 specifics
For Alma G4/G5, data is usually loaded as a set of files from one session. In the session selection window, the program shows found sessions and their status. Correct analysis requires track, slow, fast, and detr files. Alma G4 can contain records without a Correlation channel; in this case, the missing channel must not reset the whole Leak Line to zero.
- In the main panel for Alma G4/G5, changing the leak threshold can be disabled if processing is controlled by session parameters.
- The slow line is used as the main source of the leak value.
- The fast line is used as an additional check for automatic detection.
- Leak Lines are built from detr data and help visually verify the event.
11. Adding selected leaks to the report
Extended blocks for individual leaks allow the report to include only the events that the user considers important for detailed description. This is useful when the general report contains many leaks, but only several key ones need to be shown in detail.
How to add a leak to the report
- Find the required leak on the map or in the table.
- If needed, adjust the map view: scale, base layer, visual settings, and viewport position.
- Open the context menu on the leak marker on the map.
- The program selects this leak just like a normal click: the table, concentration chart, and Leak Line are updated.
- Click Add to report.
- A Report badge appears next to the leak number in the table.
What is saved for the report
- Leak number from the table.
- Leak characteristics in the style of the main table.
- Concentration chart corresponding to the selected leak.
- Leak Line chart, if the line is available.
- Map snapshot exactly as the map looked at the moment of adding.
- Leak location photo, if it was attached.
How to remove a leak from the extended report
For a leak that has already been added to the report, the context menu shows the Remove from report command. After removal, the Report badge disappears, and the separate block for this leak will not be included in the next Word/PDF report.
Practical adviceBefore clicking Add to report, set the map so that both the leak itself and the important route fragment are visible. This avoids manual map editing in the finished document.
12. Word and PDF reports
Reports are intended to present analysis results in a readable form. PDF is convenient as a final document with a fixed appearance. Word is convenient for editing text, tables, and explanations before final delivery.
Main report
- Metadata and general information about the file or file set.
- General concentration chart.
- Map with the route and detected leaks.
- Main leak table.
- If needed, additional blocks for selected leaks.
Extended blocks for selected leaks
- Each leak added through Add to report receives a separate block with a heading like Leak #N, where N is the leak number from the table.
- Each block starts on a new page.
- Leak characteristics are formatted in the style of the main table/main report.
- The concentration chart, Leak Line chart, map, and photo are placed one below another using the full available page width.
- Images are scaled without distortion of proportions.
- If an element does not fit on the current page, it is moved to the next page as a whole.
- The leak photo, if available, is placed in the lower part of the block at full width.
Word and PDF differences
| Format | When to use | Notes |
|---|
| PDF | When a ready fixed report is needed. | Preserves chart and map proportions. Elements are moved as a whole if they do not fit on the page. |
| Word | When the report needs manual editing. | Uses narrow margins and safe scaling so charts and maps do not go outside the page boundaries. |
13. Data quality summary
The summary helps quickly understand how correctly the data was loaded and whether there are problems with coordinates, time, concentration, or parsing.
- System type/data format.
- Number of files.
- Initial and final points.
- Number of erroneous points.
- Route length and record duration.
- Number of leaks and number of leaks with photos.
- Maximum concentration.
- Error breakdown by reason: missing coordinates, 0,0 coordinates, coordinates out of range, invalid time, invalid concentration, parsing errors.
How to read the summaryIf the final number of map points is noticeably smaller than the initial number of records, check the rejection reasons. Route breaks are often related not to a map error, but to filtered coordinates.
14. Export to GIS formats
In addition to Word and PDF, the program can export data in formats suitable for external mapping and GIS tools.
| Format | Purpose |
|---|
| TXT | Text export with date/time, concentration, coordinates, and leaks. |
| KML | Viewing the route and leak markers in Google Earth and compatible programs. |
| KMZ | Archived KML variant. |
| GPX | GPS track with extended fields. |
| SHP | ZIP archive with track/leaks layers for GIS. |
| RedHen | CSV for RedHen and field GIS processes. |
| GeoJSON | Route and leaks for GIS/web maps. |
Geo export requires correct coordinates. If coordinates are missing or filtered out, the program shows a message that geo export is not possible.
15. Manual parser
The manual parser is needed for files that do not match the standard formats or are detected incorrectly. It allows you to configure table reading rules without changing the source file.
- Delimiter selection: comma, semicolon, tab, or another character.
- Decimal and thousands separator settings.
- Skipping header rows.
- Assigning columns for date, time, latitude, longitude, concentration, and additional parameters.
- Checking the result before the main analysis.
When to useThe manual parser is especially useful when a file was exported from a third-party system, contains a non-standard header, or uses local numeric formats.
16. Practical recommendations
- Before generating a report, check the general concentration chart: strong peaks should match detected leaks.
- Check the map: leak markers should be located on the real route, not in points with invalid coordinates.
- For questionable leaks, open the Leak Lines and evaluate the analytic line shape relative to the reference line.
- Before adding a leak to the extended report, set the map view exactly as it should look in the document.
- If a photo is important for the report, check its binding before export.
- Use segment hiding for clearly incorrect route parts, but do not hide data only because it looks inconvenient.
- For a Word report, review the generated document anyway: comments, explanations, and conclusions can be added if needed.
17. Typical situations and solutions
| Situation | What to check / do |
|---|
| File is not detected | Select the format manually or use the manual parser. Check encoding, delimiters, and header presence. |
| There are breaks on the map | Check the data quality summary: some coordinates may be missing, equal to 0,0, or outside the allowed range. |
| Too many leaks | Increase the leak threshold or increase the distance for merging nearby peaks. Check whether the area is noisy. |
| Too few leaks | Check the threshold, source concentration units, and data quality. |
| Photos were not linked | Check EXIF photo time, time offset, and time window. Link the photo manually if needed. |
| Leak Line not found for the selected leak | Check the presence of DETR/linear data and the display mode. Some leaks may not have a corresponding line. |
| The required leak is missing from the report | Make sure it has the Report badge and that the leak was not deleted. |
| The map in the report does not look as expected | Add the leak to the report only after setting the map scale and position. The snapshot is saved at the moment Add to report is clicked. |
18. Hotkeys and useful actions
| Action | Description |
|---|
| Esc | Closes help and the raw data view. |
| G | Enables/uses the map spyglass if this function is active in the interface. |
| + / - | Changes the map spyglass size. |
| Click a table row | Selects a leak and synchronizes the map/charts. |
| Click a leak marker | Selects a leak on the map. |
| Context menu on marker | Opens actions for report and leak deletion. |
| ← / → | Moves to the previous or next leak. When a leak is selected, the map, table and charts are synchronized. |