Podręcznik uczestnika z objaśnieniami, przykładami i ćwiczeniami do samodzielnej nauki
9. Powtarzalny workflow modułu 4
Rezultatem modułu jest spójny zestaw wykresów z udokumentowanym pochodzeniem i opisami, nie sam katalog atrakcyjnych obrazów. Poniższa kolejność łączy wszystkie rozdziały w proces, który możesz powtórzyć na własnych danych.
|
Etap |
Wynik potwierdzający wykonanie |
|---|---|
|
Przygotuj wejście |
Właściwy pomiary_clean.csv, odtworzone typy i kontrole zakresu danych |
|
Zapisz mapę pytań |
W01–W06 powiązane z pytaniem i wynikiem źródłowym |
|
Przygotuj tabele |
Ranking, 45 dni energii, okresy i hale, grupy oraz kompletne pary |
|
Zbuduj i sprawdź obrazy |
Sześć wykresów oraz diagnostyczna mapa, wartości zgodne z tabelami |
|
Napisz opisy |
Tytuły, podpisy, obserwacje, ograniczenia i teksty alternatywne |
|
Wykonaj audyt |
Pięć obszarów kontroli oraz rzeczywiste statusy w tabeli narracji |
|
Odtwórz pracę |
Restart kernel i uruchomienie wszystkich komórek od góry, następnie kontrola zapisanych plików |
Końcowa kontrola techniczna
assert all((FIGURES / nazwa).is_file() for nazwa in nazwy)
assert sha256(plik.read_bytes()).hexdigest() == hash_wejscia
ponownie = pd.read_csv(TABLES / "M4_energia_dzien.csv",
parse_dates=["dzien"])
pd.testing.assert_frame_equal(
energia_dzien, ponownie, check_dtype=False,
check_exact=False, rtol=1e-12, atol=1e-12
)
assert set(narracja["status_qc"]) <= {
"NIE_SPRAWDZONO", "DO_POPRAWY", "GOTOWY"
}
print(narracja["status_qc"].value_counts())
Ta kontrola nie zastępuje oglądania PNG ani sprawdzenia opisów. Tolerancja numeryczna uwzględnia zapis i odczyt liczb; nie ma ukrywać merytorycznych różnic. Zgodny hash potwierdza niezmienność pliku wejściowego, nie jego jakość.
Gdy coś nie działa
Przy FileNotFoundError sprawdź katalog roboczy i pełną nazwę pliku. Przy błędzie pivot sprawdź unikalność pary okres i lokalizacja oraz format eksportu. Przy brakujących podpisach obejrzyj zapis z bbox_inches="tight" i rozmiar figury. Przy rozbieżności liczb porównaj agregację, filtr braków i poziom grupowania. Nie rozwiązuj tych problemów ręczną korektą obrazka.