Tekniske forberedelser 👩‍💻

I løpet av workshopen skal vi bruke noen verktøy som må installeres på datamaskinen din. Vi kommer også til å jobbe med kommandolinjen i operativsystemet ditt.

Nedenfor finner du et lynkurs i kommandolinjen samt en oversikt over programmene du må installere.

Verktøyene vi skal bruke:¶

• Google Colab – verktøy for å kombinere enkel kode og dokumentasjon

• Pakkebehandler (for Mac og Windows) – verktøy for å installere og administrere programmer

• DuckDB – kraftfullt analyseverktøy for store datasett

Siden vi må bruke kommandolinjen til å installere DuckDB, starter vi med en grunnleggende innføring i hvordan den fungerer.

Kort om kommandolinjen¶

Hvis du er som folk flest, bruker du mest tid i det grafiske brukergrensesnittet på maskinen din. Men bak operativsystemets fasade skjuler det seg et kraftfullt og minimalistisk verktøy: Kommandolinjen. Her styrer du datamaskinen med korte og lange tekstkommandoer – akkurat som på 80-tallets svarte skjermer med grønn skrift, enten du husker dem selv eller bare fra film. Mange ser på dette som en utdatert arbeidsmetode, men for avanserte oppgaver er kommandolinjen fortsatt førstevalget for mange. Den gir deg direkte kontroll og lar deg jobbe mer effektivt enn det grafiske grensesnittet ofte tillater.

Det er tre sentrale begreper du vil støte på når vi snakker om kommandolinjen: Terminal, kommandolinje (command line) og skall (shell).

• Terminalen er programmet der du skriver kommandoer.

• Kommandolinjen er selve feltet der du skriver dem.

• Shell er systemet som tolker og utfører kommandoene.

For enkelhets skyld bruker jeg begrepet kommandolinjen i denne teksten som en samlebetegnelse for alle tre.

Åpne Kommandolinjen¶

Mac¶

På Mac bruker vi Terminal for å kjøre kommandolinjen. Du kan starte den på tre måter:

Metode 1: Spotlight-søk¶

1. Trykk Command (⌘) + Space for å åpne Spotlight-søk.

2. Skriv Terminal og trykk Enter.

Metode 2: Finder¶

1. Åpne Finder (smiley-ikonet i Dock).

2. Gå til Apper i venstre sidefelt.

3. Åpne Verktøy (Utilities på engelsk).

4. Dobbeltklikk på Terminal.

Metode 3: Launchpad¶

1. Klikk på Launchpad (rakett-ikonet i Dock).

2. Skriv Terminal i søkefeltet.

3. Klikk på Terminal-ikonet når det vises.

Når Terminal åpnes, får du et vindu med tekst – enten sort på hvitt eller hvitt på sort, avhengig av tema. Her kan du begynne å skrive kommandoer og bekrefte dem med Enter.

Windows¶

I Windows bruker vi PowerShell, som er en mer moderne og kraftigere erstatning for Kommandoprompt (cmd). Du kan åpne PowerShell på to måter:

Metode 1: Start-menyen¶

1. Trykk Windows-tasten og skriv PowerShell.

2. Klikk på Windows PowerShell når det vises i søkeresultatet.

Metode 2: Kjør-dialogen¶

1. Trykk Windows + R for å åpne Kjør-dialogen.

2. Skriv PowerShell og trykk Enter.

Når PowerShell åpnes, kan du skrive kommandoer og bekrefte dem med Enter.

Linux¶

De fleste Linux-distribusjoner bruker Bash (Bourne Again Shell) som standard. Du kan åpne terminalen slik:

Metode 1: Hurtigtast¶

• Trykk Ctrl + Alt + T.

Metode 2: Applikasjonsmenyen¶

1. Åpne applikasjonsmenyen.

2. Søk etter Terminal og klikk på den.

Når terminalen er åpen, kan du skrive kommandoer og bekrefte dem med Enter.

Kjøre kommandoer¶

Prøv selv:

• ls + Enter

  • Viser en liste over filene i mappen du befinner deg i.

• pwd + Enter

  • Viser hele stien til mappen du står i.

For å navigere mellom mapper:

• cd .. + Enter

  • Går ett nivå opp i filstrukturen.

• cd MAPPENAVN + Enter

  • Går inn i en spesifikk mappe.

• cd ~ + Enter

  • Sender deg til hjemmemappen din, der du typisk finner Skrivebordet, Nedlastninger og Dokumenter.

• cd - + Enter

  • Sender deg til den forrige mappen du var i.

Mange kommandoer kan utvides eller modifiseres med såkalte parametere:

• ls -la + Enter

  • Viser i likhet med det første eksempelet filene i mappen du befinner deg i, men med flere detaljer.

Også må vi innom det klassiske «Hello World»-eksempelet:

• echo "Hello, world!" + Enter

  • Skriver “Hello, world!” til skjermen.

For å lukke Terminal:

• exit + Enter eller lukk vinduet manuelt.

Gratulerer, dette er de grunnleggende funksjonene som skal til! Men slapp av, det blir fort mer avansert.

Installasjon av programmer¶

Google Colab¶

På kurset skal vi jobbe i såkalte Notebooks (notatbøker på norsk). Notebooks er interaktive dokumenter som kombinerer kode, tekst, visualiseringer og resultater i én fil. De brukes ofte i dataanalyse, forskning og undervisning fordi de lar brukere skrive og kjøre kode i små, håndterbare celler, samtidig som de kan forklare og dokumentere arbeidet sitt i samme dokument. Dette gjør dem også ideelle for datajournalistikk, da de lar oss dokumentere arbeidsprosessen vår steg for steg.

Hvis du har jobbet med Notebooks tidligere, kjenner du kanskje til Jupyter Notebooks. I dette kurset skal vi imidlertid benytte løsningen Google Colab, som er Googles gratis skyløsning for Notebooks. Jupyter Notebooks og Google Colab er imidlertid (tilnærmet) helt kompatible, så det meste vi gjør på kurset kan også gjøres i Jupyter Notebooks, eventuelt med små justeringer.

Siden Google Colab kjører i skyen, trenger du ikke å installere noe. Men du trenger en Google-konto. Hvis bedriften din bruker Google Workspace, kan du benytte kontoen din der. Hvis ikke, fungerer en gratis Gmail-konto fint.

For å teste at du får tilgang til Colab, kan du åpne dette eksempelet: Google Colab

Følg instruksjonene i dette dokumentet frem til og med seksjonen Kom i gang. Hvis dette fungerer greit, er du klar!

Pakkebehandler (for Mac og Windows)¶

Når du skal installere DuckDB på Mac og Windows, er den enkleste måten å bruke en såkalt pakkebehandler. Denne gjør det enklere for deg å installere DuckDB – og en rekke andre kommandolinjeverktøy i fremtiden. Den mest brukte pakkebehandleren for Mac er Homebrew. For Windows er det Winget. Hvis du ikke allerede har disse programmene installert på maskinen din, finner du oppskriften under.

Mac¶

Følg disse stegene for å installere Homebrew på Mac:

1. Åpne Terminal

   • Trykk Cmd + Space, skriv Terminal, og trykk Enter.

2. Kjør installasjonskommandoen Kopier og lim inn følgende kommando i Terminal:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

   Trykk Enter.

3. Skriv inn ditt sudo-passord

   • Du blir bedt om å oppgi passordet ditt (det vises ikke mens du skriver).

   • Trykk Enter etter å ha skrevet passordet.

4. Følg instruksjonene på skjermen

   • Installeringen vil fortsette automatisk.

   • Det kan ta noen minutter avhengig av systemet ditt.

5. Legg Homebrew til i PATH

   Når installasjonen er ferdig, kjør kommandoen Homebrew foreslår (f.eks. for Apple Silicon kan det være):

   echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
   eval "$(/opt/homebrew/bin/brew shellenv)"

6. Test at Homebrew er installert Kjør følgende kommando for å sjekke installasjonen:

   brew --version

   Hvis versjonsnummeret vises, er installasjonen vellykket!

Nå kan du bruke Homebrew til å installere pakker på Mac.

Windows¶

Kjører du Windows 10 eller 11, er Winget normalt allerede installert. Følg stegene under for å verifisere installasjonen, og evt. installere programmet dersom nødvendig:

1. Sjekk om Winget allerede er installert Åpne PowerShell og kjør følgende kommando:

   winget --version

   Hvis du ser et versjonsnummer, er Winget allerede installert. Hvis ikke, fortsett til neste steg.

2. Oppdater Windows-pakken

   For å bruke Winget, må du ha App Installer installert. Last ned og installer den fra Microsoft Store:

   • Åpne Microsoft Store

   • Søk etter App Installer

   • Klikk Installer eller Oppdater hvis den allerede er installert

3. Alternativ: Manuell installasjon via GitHub

   Hvis du ikke har tilgang til Microsoft Store, kan du laste ned Winget manuelt:

   • Gå til Winget GitHub Releases

   • Last ned den nyeste .msixbundle-filen for App Installer

   • Kjør filen og følg installasjonsinstruksjonene

4. Bekreft installasjonen Etter installasjonen, åpne PowerShell og kjør:

   winget --version

   Hvis et versjonsnummer vises, er installasjonen vellykket!

Nå kan du bruke Winget til å installere programmer på Windows.

DuckDB¶

DuckDB er et kraftig og brukervennlig verktøy for analyse av store datasett direkte på din egen datamaskin, uten behov for en ekstern server eller kompliserte oppsett. Det fungerer som et raskt regneark med støtte for SQL-spørringer (som vi skal lære mer om i løpet av kurset), slik at du enkelt kan filtrere, sortere og analysere data effektivt.

Verktøyet er særlig nyttig for journalister som arbeider med omfattende datasett fra offentlige kilder, som sensordata. DuckDB kan integreres med verktøy som Python og Excel, men krever ingen programmeringskunnskaper for grunnleggende bruk.

For å bruke DuckDB må det installeres og kjøres fra kommandolinjen. Installasjonsprosessen varierer litt avhengig av operativsystemet ditt.

Installasjon¶

Mac¶

1. Åpne Terminal

   • Trykk Cmd + Space, skriv Terminal, og trykk Enter.

2. Installer DuckDB med Homebrew

   brew install duckdb

3. Bekreft installasjonen

   duckdb --version

   Hvis et versjonsnummer vises, er installasjonen vellykket!

Windows¶

1. Åpne PowerShell

2. Installer DuckDB via Winget

   winget install DuckDB.cli

3. Svar ja på eventuelle spørsmål om endringer i systemet.

4. Når installasjonen er fullført, lukk og åpne PowerShell igjen.

Alternativ: Manuell installasjon¶

• Gå til DuckDBs offisielle nedlastningsside

• Last ned den nyeste Windows-versjonen

• Følg installasjonsinstruksjonene

• Merk: Hvis du installerer DuckDB manuelt, må du kjøre det fra mappen der den kjørbare filen er lagret.

5. Bekreft installasjonen

   duckdb --version

   Hvis et versjonsnummer vises, er installasjonen vellykket!

Linux¶

1. Installer via snap (Debian/Ubuntu)

   sudo snap install duckdb

   Eller installer via dnf (Fedora)

   sudo dnf install duckdb

2. Bekreft installasjonen

   duckdb --version

   Hvis et versjonsnummer vises, er installasjonen vellykket!

Alternativ: Manuell installasjon¶

• Gå til DuckDBs offisielle nedlastningsside

• Last ned den nyeste Linux-versjonen

• Følg installasjonsinstruksjonene

3. Bekreft installasjonen

   duckdb --version

   Hvis et versjonsnummer vises, er installasjonen vellykket!

Oppsummering¶

Hvis du har fullført stegene ovenfor, har du nå det du trenger til workshopen.

Gi meg gjerne tilbakemelding på om alt gikk som det skulle. Da kan jeg krysse deg av som klar - eventuelt hjelpe deg i mål med de stegene du ikke fikk til.

Lykke til!