L'informe descriptiu¶

Exercici descriptive-report-annex.pdf · PDF

Abans de baixar-te un joc, què llegeixes? La pàgina de la botiga. Què és, qui l'ha fet, quant ocupa la baixada, què diuen les ressenyes, si funciona a la teva màquina. Un minut, i decideixes.

Ara pensa en games_clean. Fa cinc setmanes que la neteges i una lliçó que la mesures. Saps que el preu té una cua, que nou jocs de cada deu no tenen Metascore, que "owners" és la part baixa d'un interval. Ningú més no ho sap. Si un company obre demà la teva taula, hi veu 26,685 files i cap avís.

Avui escrius la pàgina que els ho explica. És l'última peça de l'etapa "preparar": l'etiqueta de la caixa abans que vagi a les persones que construiran amb ella.

La pàgina de botiga d'un conjunt de dades¶

Un informe descriptiu és un text curt que explica a algú que mai no ha obert un conjunt de dades què conté, d'on ve, com de bo és i per a què no es pot usar.

És la pàgina de botiga de les teves dades. La llegeixes abans d'"instal·lar" les dades en un gràfic. I com una pàgina de botiga, té sempre les mateixes seccions, perquè el lector sàpiga on mirar. Mantenim la pàgina de botiga durant tota la lliçó.

flowchart LR
    subgraph CTX ["Me'n puc fiar?"]
        direction TB
        P1["<b>1 · Font</b><br>qui, on, quan"] --> P2["<b>2 · Mida</b><br>files, columnes, període"] --> P3["<b>3 · Variables</b><br>columnes, tipus, unitats"]
    end
    subgraph FIG ["Què diu?"]
        direction TB
        P4["<b>4 · Qualitat</b><br>absent, estimat, dubtós"] --> P5["<b>5 · Xifres clau</b><br>centre, dispersió, distribució"]
    end
    subgraph LIM ["On s'atura?"]
        P6["<b>6 · Límits</b><br>què no et pot dir"]
    end
    CTX --> FIG --> LIM

Tot cap en 250 paraules. Aquest límit no és un càstig. És l'exercici.

Dos informes, les mateixes dades¶

Dos estudiants descriuen la mateixa taula. De quin et fiaries?

Ara assenyala les paraules exactes que marquen la diferència:

Aquesta darrera fila importa. La taula mostra 53 jocs llançats el 2004 i 8,845 el 2018. Són més jocs llançats. No són més jugadors: la taula no compta els jugadors en absolut. L'informe A va anar més enllà de les dades. L'informe B va saber on aturar-se.

Parts 1 a 3: què és això?¶

Aquestes tres gairebé no necessiten consultes. Responen "què estic mirant?".

Part 1 · Font¶

Digues qui ha recollit les dades, on es van publicar i quan, i qui les ha netejat. Per a la nostra taula: les dades les va recollir Liza Wood del lloc Steam Spy, i les va publicar el projecte TidyTuesday el 30 de juliol de 2019 com a video_games.csv (el fitxer de la pàgina de Recursos). A classe les vam netejar fins a games_clean.

Un informe és reproduïble quan una altra persona, amb només el que has escrit, pot obtenir les mateixes dades i arribar als mateixos nombres.

Un fitxer es manté igual. Una API no: pot respondre diferent demà. Així que quan les teves dades vénen d'una API, com algunes dels teus propis conjunts de dades del projecte, la "font" ha de nomenar tres coses més, o ningú no podrà obtenir mai les mateixes files:

Les API vénen de Fonts de dades: preguntes a una adreça web i et respon amb dades. Escriure "font: PokéAPI" és com citar un llibre com a "font: la biblioteca".

Part 2 · Mida¶

Una consulta et dona gairebé tot:

SELECT COUNT(*) AS n_games, MIN(release_date) AS first_release,
       MAX(release_date) AS last_release
FROM games_clean;

Afegeix el nombre de columnes (la taula en té 15) i, sobretot, digues què és una fila. Sembla massa obvi per escriure-ho. És la frase més útil de tot l'informe.

Part 3 · Variables¶

No llistis les 15 columnes. Agrupa les importants i dona a cadascuna el seu tipus i la seva unitat.

Sense la unitat, "temps de joc 110" podria ser minuts, hores o sessions. En aquest conjunt de dades són minuts.

Parts 4 i 5: què diu?¶

Aquí reutilitzes la fitxa estadística d'Estadística exploratòria. Cada frase es construeix igual.

Nombre + unitat + significat. "4.99" és el resultat d'una consulta. "El joc típic costa 4.99 USD (mediana)" és una frase.

Part 4 · Qualitat¶

Nomena què falta, què és estimat o dubtós, i quant. Sempre un recompte o un percentatge.

SELECT COUNT(*) AS games, COUNT(metascore) AS with_score,
       ROUND(100.0 * COUNT(metascore) / COUNT(*), 1) AS pct_with_score
FROM games_clean;

Fixa't en la segona frase de la versió forta. A Imputació vas decidir no omplir el Metascore. L'informe és el lloc on expliques al lector les teves decisions: què has omplert, amb què, i què t'has negat a omplir.

Part 5 · Xifres clau¶

Centre, dispersió i una distribució. Per a la distribució, el patró de percentatge sobre el total de Variables sintètiques fa la feina:

SELECT price_band, COUNT(*) AS n,
       ROUND(100.0 * COUNT(*) / SUM(COUNT(*)) OVER (), 1) AS pct
FROM games_clean GROUP BY price_band ORDER BY n DESC;

Part 6: què no et poden dir les dades¶

Aquesta és la part que els principiants se salten, i la que fa que un informe sigui de fiar.

Els límits d'un conjunt de dades són les preguntes que no pot respondre i les conclusions que no sustenta.

Pregunta't: quina conclusió errònia en trauria un periodista amb pressa? Aleshores escriu l'avís. Un bon límit sovint comença amb "Aquestes dades no poden dir..." o "Compte: ...".

Tres columnes més amaguen un límit cadascuna: metascore, price i release_date. Pensa quins jocs reben una puntuació de les ressenyes, quin dia es va llegir el preu i quina és l'última data de la taula. Trobar aquests límits és la teva feina a la pràctica de sota.

Prova-ho: escriu l'informe¶

Escriu l'informe descriptiu de games_clean: sis parts amb encapçalament, 250 paraules com a màxim, de manera que un company d'un altre grup pugui usar la taula sense preguntar-te res.

Pas 1 — Parts 1 a 3. La font i les variables surten de les teves notes d'aquesta unitat. La mida necessita la consulta de dalt.

Pas 2 — Parts 4 i 5. Reutilitza la teva fitxa estadística. Mínim: dos problemes de qualitat, cadascun amb un recompte o un percentatge; el centre i la dispersió de price; i una distribució (price_band o owners_tier).

Pas 3 — Part 6. Cap consulta. Almenys dos límits.

Pas 4 — Adjunta el SQL. Enganxa les consultes que hi ha darrere de cada xifra sota l'informe. No compten per a les 250 paraules. Són el que el fa reproduïble.

Pas 5 — Intercanvia. Dona el teu informe a un company i agafa el seu. Marca aquesta llista de comprovació. La regla: cada "No" ha d'assenyalar la línia a què es refereix. Sense notes i sense adjectius, només sí, no i on.

Després corregeix un "No" del teu propi informe. Llegir un informe que no has escrit tu és la manera més ràpida de veure què falta en el teu.

Idees clau¶

• Un informe descriptiu és la pàgina de botiga d'un conjunt de dades: llegeix-lo abans d'usar les dades.
• Té sis parts: font, mida, variables, qualitat, xifres clau, límits. Sempre en aquest ordre, cadascuna amb el seu encapçalament.
• Cada xifra és nombre + unitat + significat, i la consulta que l'ha produïda s'hi adjunta.
• La font ha de fer l'informe reproduïble. Per a una API això vol dir endpoint, paràmetres i data d'extracció.
• Per a una columna asimètrica com price, escriu la mediana (o totes dues) i digues per què.
• Els límits diuen què no poden dir les dades. Fan l'informe de fiar, no feble.
• Un informe selecciona. Tots els resultats de les teves consultes enganxats són un registre, no un informe.

Comprovació ràpida¶

Això tanca l'etapa "preparar". La teva taula és neta, mesurada i descrita. També és una taula que mai no s'ha dibuixat. Hora de construir el HUD: Unitat 3 · Visualització.