LOOMA / ДОКУМЕНТАЦИЯ

Ищите словами. Находите страницы.

Looma сочетает два способа поиска. Они решают разные задачи, поэтому баланс можно менять для каждого запроса.

Текст и визуальная похожесть#

Текстовый поиск (BM25) ищет слова во встроенном тексте PDF и сохранённом OCR. Он удобен для названий, терминов, фамилий и номеров. Запрос разбивается на слова; это не режим строгого поиска всей фразы в кавычках.

Визуальные эмбеддинги сопоставляют запрос с представлением страницы: содержанием, изображениями, схемами и компоновкой. Это полезно, когда вы помните идею или вид графика, но не точную формулировку. Индексация нужна для выбранной модели.

Ползунок рядом с запросом задаёт баланс:

Положение Что участвует в выдаче
Крайнее левое, T Только текст и OCR
Посередине Оба способа
Крайнее правое, глаз Только визуальные эмбеддинги

Списки объединяются по позициям результатов (weighted reciprocal rank fusion). Значение score не является вероятностью правильного ответа или процентом сходства.

Сколько результатов показывается#

Сначала отображаются наиболее высоко оценённые результаты с небольшим запасом после заметного спада оценок. Если явного спада нет, показана начальная часть списка. Нажмите «Показать остальные», чтобы раскрыть все полученные результаты без повторного поиска. Скрытые результаты не удаляются.

Локальная модель или сервер#

Рядом с запросом указан текущий режим — локальный или внешний — и модель. Если внешний сервер недоступен, приложение предложит совместимую локальную модель, когда она поддерживается на этом устройстве. Для незагруженной модели сначала потребуется скачать веса. Переключение выполняется по нажатию, после чего запрос повторяется.

Текущий поиск можно остановить кнопкой отмены. Если во время поиска изменить модель или сервер в настройках, устаревший запрос отменяется и активный запрос повторяется с новыми настройками.

Что подсвечивается#

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

В шапке просмотрщика значок маркера включает и выключает подсветку слов поискового запроса на текущей странице. В подсказке указан сам запрос. Этот переключатель не запускает OCR.

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

Поиск внутри открытого документа#

Используйте поле поиска в просмотрщике или Cmd+F / Ctrl+F. Поиск учитывает сохранённые текстовые слои и OCR. Enter переходит к следующему совпадению, Shift+Enter — к предыдущему.

Для страницы без собственного текста сохранённый OCR загружается автоматически. Если собственный текст уже есть, нажмите плашку OCR, чтобы переключить слой.

Почему приходится подождать#

Приложение показывает этапы запроса: подготовку, текстовый поиск, загрузку модели, расчёт запроса, визуальный поиск и объединение результатов. Зелёная галочка означает завершённый этап. При первом запросе модель может ещё загружаться в память.

Если один из способов временно недоступен, гибридный поиск может вернуть результаты другого с предупреждением. Проверьте выбранную модель, её индексацию и соединение с сервером. В крайнем положении ползунка используется только один способ, поэтому его ошибка не заменяется результатами другого.

Нашли неточность? Сообщите на GitHub ↗