35. Legenda i weryfikacja danych
Legenda gruntów, zwierciadeł i próbek użytych w otworach zlecenia (załącznik do kart otworów i przekrojów) oraz zbiorcza kontrola kompletności danych wszystkich badań zlecenia przed oddaniem dokumentacji.
W aplikacji: Legenda · Weryfikacja danych
Wstęp
Ten rozdział opisuje dwa moduły ze wspólnego paska zlecenia, które zamykają pracę nad dokumentacją:
| Moduł | Ścieżka w menu | Do czego służy |
|---|---|---|
| Legenda | „Legenda” | Arkusz A4 „Legenda do kart otworów i przekrojów:” – zestawienie rodzajów gruntów (z symbolem PN, symbolem ISO, opisem i szrafurą), typów zwierciadła wody i rodzajów próbek, które faktycznie występują w otworach zlecenia. Dołączasz go do dokumentacji jako osobny załącznik (PDF, DXF, SVG, PNG). |
| Weryfikacja danych | „Weryfikacja danych” | Jedna lista wszystkich problemów w badaniach zlecenia: otworach, sondowaniach DP, CPT, DMT, FVT, inklinometrach i punktach monitoringu. Każdy problem jest błędem krytycznym (karta nie powstanie albo będzie błędna) albo ostrzeżeniem (brak danych opisowych). Kliknięcie badania przenosi do jego edycji. |
Oba moduły niczego nie przechowują – za każdym razem liczą wynik na bieżąco z danych zlecenia. Wystarczy poprawić otwór albo sondowanie, a legenda i lista problemów zmienią się same.
Odpowiednikiem w GIMSGEO są pliki „Legenda” i „Weryfikacja danych”.
Legenda
Układ ekranu
Moduł otwiera się od razu w trybie podglądu wydruku – takim samym jak „Podgląd PDF” kart badań.

- „Legenda” w pasku modułów zlecenia – otwiera moduł.
- Arkusz legendy – strona A4 z nagłówkiem dokumentu (dane zlecenia jak na kartach otworów) i tytułem „Legenda do kart otworów i przekrojów:”.
- Sekcja „Rodzaje gruntów” – jeden wiersz na każdy grunt użyty w otworach.
- Sekcja „Zwierciadło wody” – typy zwierciadła wpisane w otworach.
- Sekcja „Próbki gruntu” – rodzaje próbek z otworów.
- „Edytor” – zamyka podgląd i przechodzi do modułu „Otwory” (legenda nie ma własnego edytora).
- Statystyki – „Rodzaje gruntów” (liczba wierszy pierwszej sekcji) i „Typy zwierciadeł”.
- „Język karty” – polski albo angielski (patrz niżej).
- „Skala szarości” i „Wydruk eko” – wygląd wydruku.
- Przyciski pobierania – „PDF”, „DXF (CAD)”, „SVG”, „PNG”.
Skąd biorą się dane legendy
Legenda jest budowana z wszystkich otworów wiertniczych zlecenia (funkcja buildLegend w src/lib/legend.ts). Nie bierze pod uwagę sondowań ani stratygrafii CPT – tylko warstwy, zwierciadła i próbki otworów.
| Sekcja | Źródło w otworze | Reguła |
|---|---|---|
| „Rodzaje gruntów” | kolumna gruntu (symbolu) w tabeli warstw | Z każdej warstwy brany jest grunt główny (pierwszy symbol, np. z „Pd/Ps” – „Pd”). Każdy grunt pojawia się raz. Kolejność – alfabetyczna wg symbolu (porządek polski). Opis polski i angielski pochodzą ze słownika gruntów aplikacji, symbol ISO – z warstwy (pierwszej, w której wystąpił grunt). |
| „Zwierciadło wody” | tabela zwierciadeł otworu | Każdy typ zwierciadła raz, posortowane wg kodu typu. Sekcja nie pojawia się, gdy w żadnym otworze nie ma zwierciadła. |
| „Próbki gruntu” | pole „Próbki gruntu” otworu | Każdy rodzaj próbki raz, alfabetycznie. Sekcja nie pojawia się, gdy brak próbek. |
Uwaga. Legenda pokazuje grunty wszystkich otworów zlecenia, a nie tylko tych z jednego przekroju. Jeśli potrzebujesz legendy dokładnie do jednego przekroju, włącz w przekroju „Legenda szrafur gruntów” – wtedy legenda rysuje się na arkuszu przekroju i obejmuje tylko narysowane tam grunty (patrz Przekroje geotechniczne).
Gdy w otworach nie ma żadnej warstwy, zamiast tabeli gruntów pojawia się tekst „Brak warstw w otworach zlecenia.”.
Dane na arkuszu legendy

Rodzaje gruntów – tabela czterech kolumn bez nagłówka:
| Kolumna | Szerokość | Zawartość |
|---|---|---|
| 1 | 22 mm | Pole szrafury: kolor tła i wzór gruntu ze słownika szrafur (te same co na kartach otworów i przekrojach). W eksporcie DXF wzór i kolor przechodzą jako kreskowanie. |
| 2 | 16 mm | Symbol gruntu wielkimi literami, pogrubiony (np. „PD”, „GP”). |
| 3 | 18 mm | Symbol wg PN-EN ISO 14688 (np. „FSa”); „—”, gdy nieznany. |
| 4 | reszta | Nazwa gruntu (po polsku albo po angielsku – wg „Języka karty”). |
Zwierciadło wody – tabela trzech kolumn: symbol graficzny zwierciadła (ten sam trójkąt co w kolumnie wody karty otworu; dla typów z głębokością „od–do” – dwa poziomy), skrót i opis:
| Typ | Skrót | Opis na legendzie |
|---|---|---|
| swobodne | zw | zwierciadło swobodne |
| napięte / swobodne | zw | zwierciadło napięte / swobodne |
| napięte | zn | zwierciadło napięte |
| sączenia | s | sączenia |
| nieustalone | nu | zwierciadło nieustalone |
| nieustalone / sączenie | nus | zwierciadło nieustalone / sączenie |
| napięte / sączenie | zns | zwierciadło napięte / sączenie |
Próbki gruntu – tabela dwóch kolumn: rodzaj próbki (jak wpisany w otworze) i jego objaśnienie:
| Rodzaj | Objaśnienie (PL) | Objaśnienie (EN) |
|---|---|---|
| NNS | próbka o naturalnym nienaruszonym uziarnieniu i wilgotności | undisturbed sample |
| NW | próbka o naturalnej wilgotności | natural moisture sample |
| NU | próbka o naturalnym uziarnieniu | natural grading sample |
| A | próbka do badań chemicznych (agresywność) | chemical analysis sample |
| inny | próbka gruntu | soil sample |
Opcje podglądu i pobieranie
| Opcja | Działanie |
|---|---|
| „Język karty” | Domyślnie „Język dokumentacji” ustawiony w danych zlecenia. Zmiana w podglądzie obowiązuje tylko do opuszczenia modułu – przełącza tytuł („Legend to borehole logs and sections:”), nagłówki sekcji („Soil types”, „Groundwater”, „Soil samples”), nazwy gruntów i objaśnienia próbek. |
| „Skala szarości” | Arkusz i pliki wynikowe w odcieniach szarości. |
| „Wydruk eko” | „bez wypełnień barwnych – kontury i szrafury” – pola gruntów bez koloru tła, ze szrafurą. |
| „PDF” | Plik legenda_<nazwa projektu>.pdf (nazwa projektu z danych zlecenia, a bez niej „zlecenie”). |
| „DXF (CAD)” | Ten sam arkusz jako rysunek CAD (tabele, teksty, kreskowania). |
| „SVG” | „Grafika wektorowa – do edycji i wstawienia w raport”. |
| „PNG” | „Obraz 300 dpi”. |
W trakcie generowania pliku przycisk pokazuje kręcące się kółko, a pozostałe są zablokowane. Błąd generowania zgłasza komunikat „Wystąpił błąd podczas generowania PDF” (odpowiednio DXF, SVG, PNG).
Nagłówek arkusza ma pole „Załącznik”, ale w podglądzie legendy nie ma pola „Nr załącznika” (jak w kartach badań) – na wydruku zostaje „Załącznik —” (do weryfikacji).
Uwaga. Przycisk „Edytor” w legendzie przenosi do modułu „Otwory”, bo to tam poprawia się dane, z których powstaje legenda.
Weryfikacja danych
Układ ekranu

- „Weryfikacja danych” w pasku modułów zlecenia.
- Liczniki – „N z błędami krytycznymi” (badania, których najpoważniejszy problem to błąd) i „N z ostrzeżeniami” (badania tylko z ostrzeżeniami).
- „Tylko błędy krytyczne” – filtr: ukrywa badania, które mają same ostrzeżenia.
- Nagłówek grupy – rodzaj badań i liczba badań z problemami w nawiasie.
- Nazwa badania – link; kliknięcie otwiera badanie w jego module.
- Status badania – plakietka statusu (gdy ustawiony).
- Błąd krytyczny – czerwone pole z ikoną koła z wykrzyknikiem.
- Ostrzeżenie – żółte pole z ikoną trójkąta.
Na zrzucie w zleceniu „Hala” dodano puste sondowania CPT-4 (ze statusem „Surowe dane”) i DMT-3 – bez pomiarów, współrzędnych, daty i operatora. Dane demonstracyjne same w sobie mają tylko ostrzeżenia inklinometrów.
Badania bez żadnego problemu nie są wyświetlane. Gdy problemów nie ma w ogóle, pojawia się komunikat „Brak problemów – wszystkie badania są kompletne.”.
Grupy i kolejność
Badania są pogrupowane w stałej kolejności. Grupa bez problemów jest pomijana.
| Grupa | Badania | Kliknięcie nazwy otwiera |
|---|---|---|
| „Otwory wiertnicze” | wszystkie otwory zlecenia (także wirtualne) | moduł „Otwory” z tym otworem jako aktywnym |
| „Sondowania dynamiczne” | sondowania DP (nazwa = numer profilu) | moduł „Sondowania → Sondowania DP” z tym sondowaniem |
| „Sondowania CPT” | rekordy CPT/CPTU | moduł CPT z tym rekordem |
| „Sondowania DMT” | rekordy DMT | moduł DMT |
| „Sondowania FVT” | rekordy FVT | moduł FVT |
| „Inklinometry” | rekordy inklinometrów | moduł „Inklinometry” |
| „Monitoring geodezyjny” | punkty monitoringu | moduł „Monitoring” |
W obrębie badania błędy krytyczne są zawsze wypisane przed ostrzeżeniami.
Błędy krytyczne i ostrzeżenia
| Poziom | Wygląd | Znaczenie |
|---|---|---|
| Błąd krytyczny | czerwony, ikona koła z wykrzyknikiem | Karty badania nie da się wygenerować albo obliczenia nie mają podstaw. Badanie nie trafia do generatora wielu kart (albo trafia z oznaczeniem błędu). |
| Ostrzeżenie | żółty, ikona trójkąta | Karta powstanie, ale brakuje danych opisowych albo dane są podejrzane. |
Te same komunikaty widać także poza tym modułem:
- nad edytorem badania (lista problemów nad pierwszą sekcją),
- na liście badań modułu – ikona przy nazwie (czerwona: błąd, żółta: ostrzeżenie), po najechaniu kursorem lista komunikatów,
- w „Zestawieniu badań” (kolumna z ikoną problemów),
- w generatorach kart (otwory, DP i moduły rekordów).
Reguły kontroli – nagłówek każdego badania terenowego
Wspólna kontrola nagłówka (headerIssues w src/lib/investigationStatus.ts) dotyczy otworów, sondowań DP, CPT, DMT, FVT i inklinometrów. Punkty monitoringu jej nie mają.
| Komunikat (dosłownie) | Poziom | Kiedy się pojawia | Co zrobić |
|---|---|---|---|
| „Brak współrzędnych – badanie nie pojawi się na mapie ani w przekrojach” | ostrzeżenie | X lub Y nie jest liczbą albo oba są równe 0 | Wpisz X, Y w nagłówku badania, wskaż punkt na mapie albo przypisz współrzędne z modułu geodezji. Bez nich badanie nie ma odległości na przekroju „ze współrzędnych” ani „z osi”. |
| „Rzędna nie została wypełniona” | ostrzeżenie | rzędna pusta albo równa 0 | Wpisz rzędnę terenu [m n.p.m.] albo pobierz ją z geodezji. Rzędna 0 jest traktowana jak brak. |
| „Brak daty badania” | ostrzeżenie | pusta data | Uzupełnij datę wykonania badania. |
| „Nie podano operatora” | ostrzeżenie | pole operatora puste (same spacje też) | Wpisz wykonawcę badania. |
Reguły kontroli – otwory wiertnicze
| Komunikat | Poziom | Kiedy | Co zrobić |
|---|---|---|---|
| „Brak zdefiniowanych warstw – nie można wygenerować karty” | błąd | otwór nie ma żadnej warstwy z wpisanym gruntem (symbolem) | Wprowadź profil litologiczny w tabeli warstw otworu. Warstwy bez symbolu się nie liczą. |
| „Otwór wirtualny – warstwy z rysunku przekroju, nie wynik badania (poza statystykami i eksportem AGS)” | ostrzeżenie | otwór utworzony narzędziem „Otwór wirtualny” w edytorze rysunku przekroju | To informacja, a nie błąd. Otwór wirtualny jest interpretacją – nie wchodzi do statystyk ani eksportu AGS. Jeśli to niezamierzone, usuń otwór. |
| + reguły nagłówka | ostrzeżenia | jak wyżej |
Reguły kontroli – sondowania dynamiczne (DP)
| Komunikat | Poziom | Kiedy | Co zrobić |
|---|---|---|---|
| „Wyniki badania są puste – nie można wygenerować karty” | błąd | brak wartości liczby uderzeń N | Wpisz wyniki sondowania (N na kolejne przedziały). |
| „Głębokość początkowa nie została określona (przyjęto 0 m)” | ostrzeżenie | pole głębokości początkowej puste | Wpisz głębokość, od której zaczęto sondowanie (np. po przewierceniu nasypu). Bez niej pierwszy przedział zaczyna się od 0 m. |
| + reguły nagłówka | ostrzeżenia |
Reguły kontroli – sondowania CPT
Funkcja cptIssues w src/lib/recordValidation.ts. W module „Weryfikacja danych” sprawdzane są także wyniki (jak przy generowaniu kart).
| Komunikat | Poziom | Kiedy | Co zrobić |
|---|---|---|---|
| „Brak wyników pomiarów – nie można wygenerować karty” | błąd | mniej niż 2 pełne odczyty (z głębokością i wartościami qc oraz fs, a przy sondzie mechanicznej Begemanna – qc oraz Qc+Qs) | Zaimportuj plik pomiarowy albo wpisz odczyty. |
| „Ujemne wartości fs w N punktach – sprawdź dane” | ostrzeżenie | N punktów z fs < 0 | Sprawdź zerowanie sondy, jednostki i kolumny importu; w razie potrzeby użyj czyszczenia danych w module CPT. |
| „Zaznaczono uwzględnienie otworu referencyjnego, ale nie wybrano otworu” | ostrzeżenie | włączono użycie otworu referencyjnego bez wskazania otworu | Wybierz otwór referencyjny albo wyłącz opcję. |
| „Niepełne odczyty w N wierszach – pominięte w obliczeniach” | ostrzeżenie | wiersze z częścią wartości (nie puste, ale bez kompletu z/qc/fs, a przy Begemannie z/qc/Qc+Qs) | Uzupełnij albo usuń te wiersze. Puste poziomy (sama głębokość) nie są liczone jako błąd. |
| „Qc+Qs mniejsze od Qc w N wierszach – fs przyjęte 0” | ostrzeżenie | sonda Begemanna: odczyt całkowity mniejszy od odczytu stożka | Sprawdź, czy kolumny nie są zamienione. |
| „Data kalibracji stożka jest późniejsza niż data badania” | ostrzeżenie | data kalibracji w danych stożka późniejsza niż data badania (obie w formacie RRRR-MM-DD) | Popraw datę kalibracji albo datę badania. |
| + reguły nagłówka | ostrzeżenia |
Reguły kontroli – DMT, FVT, inklinometry, monitoring
| Badanie | Komunikat | Poziom | Kiedy | Co zrobić |
|---|---|---|---|---|
| DMT | „Brak wyników pomiarów – nie można wygenerować karty” | błąd | mniej niż 2 odczyty | Wprowadź odczyty A, B (i C) na kolejnych głębokościach. |
| FVT | „Brak wymiarów krzyżaka (H, D) – nie można obliczyć su” | błąd | wysokość H lub średnica D krzyżaka nie jest większa od 0 | Wpisz wymiary krzyżaka w danych sondy. |
| FVT | „Brak wyników pomiarów – nie można wygenerować karty” | błąd | brak odczytów i brak krzywych | Wprowadź odczyty momentu albo krzywe ścinania. |
| Inklinometr | „Brak stałej sondy lub kroku pomiarowego” | błąd | stała sondy C lub krok L nie jest większy od 0 | Uzupełnij parametry sondy inklinometrycznej. |
| Inklinometr | „Tylko jeden pomiar – przemieszczenia wymagają co najmniej dwóch” | ostrzeżenie | dokładnie jeden pomiar (seria) | Dodaj pomiar odniesienia albo kolejny pomiar. |
| Inklinometr | „Brak wyników pomiarów – nie można wygenerować karty” | błąd | brak pomiarów | Zaimportuj pomiary. |
| Monitoring | „Tylko jeden pomiar – przemieszczenia wymagają co najmniej dwóch” | ostrzeżenie | dokładnie jeden odczyt | Dodaj kolejny odczyt punktu. |
| Monitoring | „Brak wyników pomiarów – nie można wygenerować karty” | błąd | brak odczytów | Wprowadź odczyty. |
DMT, FVT i inklinometry mają też reguły nagłówka. Punkty monitoringu – nie.
Uwaga. Moduł „Weryfikacja danych” obejmuje tylko badania wymienione w tabeli grup. Kontrole modułów laboratoryjnych, płyt VSS/LFG, pompowań i stateczności skarp widać w edytorach i na listach tych modułów, ale nie na tej stronie.
Statusy badań
Każde badanie terenowe może mieć status (GIMSGEO: „projektowany → surowe dane → przetwarzany → zaakceptowany, archiwalny”). Status ustawiasz listą „Status badania” obok nazwy w edytorze (CPT, DMT, FVT, płyty, inklinometry, monitoring), a w otworach – w danych otworu (edytor otworu), w sondowaniach DP – w edytorze sondowania. Na liście badań i w module „Weryfikacja danych” status widać jako kolorową plakietkę.

- „Status badania” – lista obok nazwy i rodzaju badania.
- Statusy – kolorowa kropka odpowiada kolorowi plakietki na liście badań (na zrzucie: „Zaakceptowane” przy CPTU-2, „Przetwarzane” przy CPT-3).
Nad edytorem badania widać te same problemy co w module „Weryfikacja danych”, a na liście badań – ikonę błędu przy nazwie (CPT-4).
| Status | Plakietka | Typowe znaczenie |
|---|---|---|
| „Bez statusu” | brak | status nieustawiony |
| „Projektowane” | niebieska | badanie zaplanowane, jeszcze niewykonane (np. punkt z projektu robót) |
| „Surowe dane” | fioletowa | dane wprowadzone lub zaimportowane z terenu, nieopracowane |
| „Przetwarzane” | pomarańczowa | trwa opracowanie (interpretacja, korekty) |
| „Zaakceptowane” | zielona | badanie sprawdzone, gotowe do dokumentacji |
| „Archiwalne” | szara | badanie archiwalne (np. z wcześniejszych rozpoznań) |
Status nie zmienia reguł kontroli – badanie „Zaakceptowane” z brakującą rzędną nadal ma ostrzeżenie. Status służy do filtrowania list i grupowania punktów na mapie.
Typowa procedura przed oddaniem dokumentacji
- Otwórz „Weryfikacja danych” i włącz „Tylko błędy krytyczne”.
- Usuń wszystkie błędy (kliknij nazwę badania, popraw dane, wróć do modułu).
- Wyłącz filtr i przejrzyj ostrzeżenia – braki współrzędnych i rzędnych mają wpływ na przekroje i mapę.
- Ustaw sprawdzonym badaniom status „Zaakceptowane”.
- Otwórz „Legenda” i pobierz arkusz legendy jako załącznik.
Typowe problemy
| Objaw | Przyczyna | Rozwiązanie |
|---|---|---|
| W legendzie brakuje gruntu, który jest na przekroju | Grunt występuje tylko w stratygrafii CPT albo w rysunku interpretacyjnym przekroju | Legenda modułu bierze grunty wyłącznie z otworów. Użyj legendy na arkuszu przekroju („Legenda szrafur gruntów”). |
| W legendzie jest „Pd”, a w otworze „Pd/Ps” | Do legendy trafia grunt główny | Zgodnie z zasadą – szrafura i nazwa dotyczą gruntu głównego. |
| „Brak warstw w otworach zlecenia.” | Żaden otwór nie ma warstwy z gruntem | Uzupełnij warstwy otworów. |
| Badanie nie pojawia się w „Weryfikacji danych”, choć wiem, że ma braki | Brak jest w polu, którego moduł nie sprawdza | Sprawdź tabelę reguł – kontrola obejmuje tylko wymienione pola. |
| Otwór z wpisanymi warstwami ma błąd „Brak zdefiniowanych warstw…” | Warstwy nie mają wpisanego gruntu (symbolu) | Wpisz grunt w kolumnie symbolu. |