Podręcznik uczestnika z objaśnieniami, przykładami i ćwiczeniami do samodzielnej nauki
2. Odbiorca, cel i architektura raportu
Raport obliczeniowy łączy narrację z kodem i wynikami. Czytelnik powinien wiedzieć nie tylko, co obliczono, ale także po co, na jakich danych i z jakimi zastrzeżeniami. Notebook eksploracyjny dokumentuje poszukiwanie odpowiedzi. Notebook finalny przedstawia wybraną, sprawdzoną drogę prowadzącą do odpowiedzi. Te role są różne, choć oba pliki mogą korzystać z tych samych danych.
Zacznij od decyzji, nie od formatowania
Przed redakcją ustal odbiorcę, jego potrzebę, cel raportu, pytanie główne, zakres oraz formę przekazania. Odbiorca techniczny może potrzebować szczegółów filtrów i agregacji. Osoba odpowiedzialna za organizację pracy będzie przede wszystkim szukała znaczenia wyników i granic ich zastosowania. Zmienia się kolejność i poziom szczegółowości, ale nie fakty.
W projekcie kursowym możesz przyjąć pytanie: „Jakie najważniejsze różnice i zależności w drganiach, energii i temperaturze ujawniają dane oraz jakie są granice ich interpretacji?”. Jest ono szersze niż pytanie o pojedynczą medianę, ale nadal możliwe do opracowania na podstawie wykonanych analiz. Nie obiecuje prognozowania awarii ani ustalenia przyczyn zużycia.
Zakres należy opisać konkretnie: 720 rekordów pomiarowych, osiem urządzeń, okres od 1 stycznia do 14 lutego 2026 r. i dane przygotowane w module 2. To 45 dni obserwacji, a nie dwa pełne miesiące. Uwzględniasz temperaturę, drgania i energię wraz z dostępnym kontekstem urządzeń. Nie dysponujesz pełną historią serwisową ani eksperymentem pozwalającym oddzielić wpływ wszystkich czynników.
Przykład planu raportu
Odbiorca: osoba analizująca pracę instalacji, która zna ogólny kontekst urządzeń, ale nie śledziła kolejnych notebooków. Cel: wskazać najważniejsze wzorce i obszary wymagające dalszego sprawdzenia. Forma: uporządkowany notebook z wersją do czytania oraz krótką prezentacją. Granica: wyniki opisują zbiór kursowy i nie stanowią samodzielnej podstawy decyzji serwisowych.
Taki plan warto zapisać w sekcji „Plan raportu”. Gdy później zastanawiasz się, czy dodać kolejny wykres, wróć do pytania głównego. Jeżeli element nie pomaga na nie odpowiedzieć ani ocenić wiarygodności odpowiedzi, prawdopodobnie nie należy do części głównej.
Jeden przekaz główny i trzy dowody
Dobre podsumowanie nie jest listą wszystkich funkcji Pandas użytych w projekcie. Powinno prowadzić czytelnika przez niewielką liczbę powiązanych ustaleń. W tym module wybieramy trzy wyniki przewodnie: ranking median drgań, porównanie median energii między halami i okresami oraz zależność temperatury i drgań. Odpowiadają im wykresy M4-W01, M4-W03 i M4-W06 z modułu 4.
Przekaz główny może brzmieć: „W zbiorze występują różnice między urządzeniami i lokalizacjami oraz dodatnia zależność temperatury i drgań; ich interpretacja wymaga uwzględnienia struktury danych i nietypowych pomiarów”. To zdanie łączy trzy obserwacje, lecz nie przedstawia ich jako dowodu awarii czy przewagi technologicznej jednej hali.
|
Element raportu |
Jak wspiera przekaz |
|---|---|
|
Ranking drgań |
Pokazuje kolejność ośmiu median i liczebność każdej grupy; nie tworzy rankingu sprawności urządzeń. |
|
Energia w halach |
Porównuje medianę kWh na interwał dla każdej hali i miesiąca; ujawnia niepełny luty i różny skład grup. |
|
Temperatura i drgania |
Pokazuje kierunek zależności i pojedynczy skrajny punkt; wymaga kontroli korelacji w grupach. |
|
Ograniczenia |
Wyznaczają, do jakich danych odnosi się wynik i jakich wyjaśnień nie można jeszcze potwierdzić. |
Część główna, aneks czy archiwum?
W części głównej zachowaj dane niezbędne do zrozumienia pytania, najważniejsze decyzje metodologiczne, trzy dowody oraz wnioski i ograniczenia. Aneks jest miejscem na pełne tabele kontrolne, rozszerzone obliczenia i dokumentację użycia LLM. Musi być wskazany w tekście i rzeczywiście dostępny w przekazywanym pakiecie.
Nie wszystkie pozostałości eksploracji zasługują na aneks. Kilka prawie identycznych wariantów wykresu, próbne wydruki całej ramki i nieaktualne komentarze można usunąć z kopii redakcyjnej. Oryginalny notebook roboczy zachowaj jako historię pracy. Usuwanie zbędnej prezentacji nie może oznaczać ukrywania niewygodnego wyniku lub decyzji wpływającej na analizę.
Pomocny test brzmi: „Czy bez tego elementu czytelnik nadal rozumie wynik i potrafi ocenić jego wiarygodność?”. Jeśli tak, rozważ przeniesienie szczegółu do aneksu. Jeśli nie, skróć go, ale pozostaw w części głównej.
Architektura i streszczenie
Czytelnik powinien przechodzić od pytania do dowodu, a następnie do znaczenia i granic wyniku. Poniższy układ jest propozycją dla projektu kursowego; nie zastępuje wymagań opisanych w zadaniu w Moodle.
|
Element raportu |
Pytanie, na które odpowiada |
|---|---|
|
Streszczenie |
Co zbadano, co ustalono, co to znaczy i czego nie rozstrzygnięto? |
|
Problem, cel i zakres |
Dla kogo powstał raport i jakie pytanie podejmuje? |
|
Dane i przygotowanie |
Skąd pochodzą dane, co oznacza rekord i jakie decyzje jakościowe podjęto? |
|
Metody |
Jakie filtry, grupowania, miary i porównania prowadzą do wyniku? |
|
Wyniki |
Jakie wartości i wzorce pokazują tabele i wykresy? |
|
Wnioski i ograniczenia |
Co wynika z dowodów, do jakiego zakresu i z jaką ostrożnością? |
|
Dalsze kroki, LLM i aneksy |
Co sprawdzić dalej, jak weryfikowano pomoc modelu i gdzie są szczegóły? |
Streszczenie znajduje się na początku, ale najłatwiej napisać je na końcu. Wcześniejsza wersja może wyznaczać kierunek pracy, jednak po ostatecznych obliczeniach trzeba ją porównać z tabelami. To częste miejsce pozostawienia liczby pochodzącej ze starego wariantu analizy.
Przykładowe streszczenie
Przeanalizowano 720 pomiarów ośmiu urządzeń z okresu 1.01–14.02.2026, aby opisać różnice w drganiach i energii oraz zależność temperatury i drgań. Najwyższą medianę drgań odnotowano dla U-05, Hala A miała najniższą medianę energii w obu dostępnych okresach miesięcznych, a korelacja temperatury i drgań w całej próbie wyniosła 0,644. Wyniki wskazują obszary do dalszej kontroli, ale porównania dotyczą konkretnego składu urządzeń i powtarzanych pomiarów. Na tej podstawie nie można ustalić przyczyn różnic ani zalecić zatrzymania urządzenia.
To streszczenie jest przykładem dydaktycznym dla danych kursowych. Gdy pracujesz na innej wersji zbioru, przelicz wyniki i napisz tekst na nowo. Nie dopasowuj danych do gotowego akapitu.
Sprawdź rozumienie 1
Masz dziesięć wykresów, ale odbiorca potrzebuje odpowiedzi na jedno pytanie. Jak zdecydujesz, które trzy umieścić w części głównej? Dlaczego przeniesienie szczegółu do aneksu nie może oznaczać pominięcia ograniczenia we wnioskach?