• poprawki błędów
• wstępne wsparcie dla Solr 4.0
• obsługę ruby 1.9

Cały kod jest dostępny na naszym koncie GitHub.

Dla przypomnienia: jest to narzędzie do wizualizacji wyników zapytań zadawanych do Solr i odpowiedzi w przejrzystej formie na pytania:

• dlaczego dany dokument został znaleziony
• dlaczego dany dokument nie został znaleziony

Zdecydowaliśmy się w tym momencie opublikować, mimo, że jeszcze wiele rzeczy chcielibyśmy zmienić i poprawić. Jednak z drugiej strony zawsze będzie coś do poprawienia

Sama aplikacja została napisana z wykorzystaniem Ruby On Rails i chociaż widać, że była pisana przez osoby na codzień korzystające z innych języków programowania, to mamy nadzieje, że okaże się przydatna.

Kod jest udostępniony na zasadach licencje Apache (2.0), w przypadku jego wykorzystania będzie nam miło, jeśli dostaniemy o tym informację. Namawiamy również do podsyłania poprawek i zgłaszania błędów.

Kod jest dostępny na Githubie: https://github.com/solrpl/explain

• narzędzie wzbudziło pewne zainteresowanie, jednak większość analizowanych przez Was odpowiedzi solr jest zaznaczana jako niepubliczna.
• w stosunkowo dużej części zapytań zamiast odpowiedzi z SOLR wklejacie samo zapytanie
• również często wklejany wynik nie zawiera informacji diagnostycznych (debugQuery=true)
• nie wydana wersja 4.0 cieszy się dość dużą popularnością, niestety explain jeszcze jej nie wspiera
• z wyjątkiem oczywistych problemów z analizą odpowiedzi SOLR 4.0 parser radził sobie niespodziewanie dobrze

W chwili obecnej na explain.solr.pl znajduje się nowa wersja oprogramowania. Zmiany:

• dodano proste wsparcie dla analizy pod kątem wydajności
• poprawiono komunikaty na trochę bardziej przyjazne dla użytkownika
• poprawiono parser wyników w oparciu o pliki testowe odpowiedzi wygenerowanymi przez testy jednostkowe dostępne w kodzie Solr dla wersji 3.5
• drobne poprawki interfejsu

Założenia

W chwili obecnej serwis analizuje zapytania Solr w wersji 3.x i jest przygotowywany pod wersję 4.0.

Wizualizacja danych explain

W chwili obecnej serwis wizualizuje wartości score osiągnięte przez znalezione dokumenty.

Aby dodać nowy explain i zobaczyć jego wizualizację należy dodać do zapytania parametr debugQuery=on, a następnie wkleić dane zwrócone przez Solr do okna aplikacji explain.solr.pl (w przypadku przeglądarki wklejamy zawartość źródła strony). Naciśnięcie przycisku „Create explain” spowoduje dodanie nowego explain’a i pokazanie strony z wizualizacją. W chwili obecnej aplikacja explain.solr.pl obsługuje jedynie dane w formacie XML, należy więc przekazać w zapytaniu parametr wt=xml lub nie przekazywać go w ogóle.

Istnieje również możliwość weryfikacji trafień dla dowolnych, innych dokumentów (podanych przez parametr explainOther zapytania). Przydatne jest to np. w sytuacji sprawdzania, dlaczego w wyniku nie pojawił się dany dokument.

Dostępne informacje

Po stworzeniu nowej wizualizacji danych explain, dostępny jest szereg informacji. Dane na temat zapytania, pokazywane są raz dla całego explain’a, reszta informacji pokazywana jest dla każdego z dokumentów, którego dotyczy.

Dane na temat zapytania

W tej części explain.solr.pl widoczne są:

1. Identyfikator wygenerowanego explain’a.
2. Informacja o tym, iż nie wykorzystano parametru debugOther.
3. Zapytanie.
4. Informacja o tym, iż explain widoczny jest w zakładce „history„.

Widoczne w wynikach wyszukiwania pola

W tej części explain.solr.pl dostępna jest informacja na temat pól, które dostępne były w wynikach wyszukiwania.

Wizualizacja wpływu poszczególnych elementów na score

Widoczne w tej części explain.solr.pl informacje to:

1. Procentowy wpływ poszczególnych wartości na ogólną wartość score dokumentu.
2. Wykres kołowy wizualizujący dane widoczne w lewej kolumnie.

Powrót do już dodanego explain’a

W celu powrotu do już dodanego explain’a należy wejść na stronę: http://explain.solr.pl/explains/EXPLAIN_ID, gdzie EXPLAIN_ID jest unikalnym identyfikatorem, który podawany jest podczas stworzenia explaina. Jeżeli nie pamiętasz identyfikatora wcześniej dodanego explain’a należy odnaleźć odpowiedni explain w zakładce „history„.

Ukrywanie swojego explain’a

Aby Twój explain nie był widoczny w historii dodanych explainów należy podczas dodawania nowego explain’a odznaczyć opcję „I want this explain to be visible on history page„. Należy jednak pamiętać, że aby wrócić do explain’a, który nie jest dostępny publicznie należy pamiętać jego identyfikator.

Zgłaszanie błędów

Aby zgłosić błąd który znalazło się w aplikacji explain.solr.pl, prosimy o stworzenie zgłoszenia na https://github.com/solrpl/explain lub wysłanie maila na explain(at)solr(dot)pl.

Prośba

Mamy także małą prośbę, jeżeli macie jakieś uwagi, trafiliście na błąd lub chcielibyście jakąś nową funkcjonalność prosimy piszcie na explain(at)solr(dot)pl. Pozwoli nam to na lepsze dostosowanie explain.solr.pl do Waszych potrzeb.

Coś na koniec

Na sam koniec chcielibyśmy pokazać, jak wyglądał proces tworzenia kodu http://explain.solr.pl wizualizowany przy użyciu narzędzia gsource. Miłego oglądania.

• przebudową analizatora informacji zwracanych przez explain Lucene, tak by przygotować się na wielkie zmiany w Lucene 4.0 (m.in per field similarity oraz flexible similarity)
• przebudową interfejsu i zwiększeniem czytelności
• porządkami w kodzie i przygotowaniem do publikacji źródeł

Na szczęście jesiennie i zimowe, długie wieczory sprzyjają pracy Postaramy się udostępnić http://explain.solr.pl jak najszybciej będzie to możliwe.

Lucene Eurocon 2011

Pierwszym tematem jest przygotowanie do  zbliżającej się konferencji Lucene Eurocon 2011 w Barcelonie gdzie  drugiego dnia pojawi się nasza prezentacja. Po więcej szczegółów zapraszamy tutaj. Pełny plan zbliżającej się konferencji znajduje się tutaj. Zapraszamy.

Explain.solr.pl

Drugi temat, powiązany zresztą z pierwszym, to nowa funkcjonalność na solr.pl. Często podczas pracy z Solr zachodzi potrzeba sprawdzenia, dlaczego dany wynik pojawił się lub nie na liście oraz skąd wynika taka a nie inna wartość score, będącego miarą tego, jak bardzo dokument jest odpowiedzią na operację wyszukiwania. Solr dostarcza tu pewnych narzędzi, jednak informacje te nie są zbyt czytelne i przy trochę bardziej skomplikowanych zapytaniach mogą skutkować bólem głowy  Funkcjonalność o której mowa, ma na celu zaprezentowanie tych informacji w bardziej czytelnej formie i  mamy nadzieję, że ułatwi Wam pracę z Solr Więcej informacji pojawi się podczas prezentacji podczas drugiego dnia Lucene Eurocon 2011 oraz po premierze explain.solr.pl.