Updated instructions

Author: jerekapyaho

README.md

@@ -7,19 +7,73 @@ Kurssimateriaalia ja esimerkkejä data-analyysin projektikurssilla.
 Ohjeet ovat enimmäkseen Ubuntu Linuxille. Useimmat ohjelmistot asennetaan
 `apt-get`-työkalulla.
 
-* [csvkit](https://csvkit.readthedocs.io/en/latest/)
+* [csvkit](https://csvkit.readthedocs.io/en/latest/) (asennus esim.
+`sudo apt-get install csvkit`)
+* [curl](https://curl.se/) (todennäköisesti on jo mukana Linux-asennuksessa)
 
+## Python
+
+Esimerkeissä on käytetty Pythonin versiota 3.10.6. Tarkista oma Python 3-versiosi:
+
+    python3 -V
+
+Pythonin versiota 2 ei kannata enää käyttää uusissa projekteissa.
+
+### Virtuaaliympäristö
+
+Perustietoa Pythonin virtuaaliympäristöistä löytyy esimerkiksi 
+Real Python -sivuston artikkelista [Python Virtual Environments: A Primer](https://realpython.com/python-virtual-environments-a-primer/).
+
+Tee projektin hakemistoon uusi virtuaaliympäristö nimeltä `venv`:
+
+    python3 -m venv venv
+
+Komento ajaa Python-moduulin nimeltä `venv` ja luo uuden virtuaaliympäristön.
+
+Aktivoi virtuaaliympäristö:
+
+    source venv/bin/activate
+
+Graafisten kuvaajien tekemistä varten pitää asentaa Matplotlib:
+
+    pip install matplotlib
+
+Lisää tietoa `pip`-ohjelman käytöstä löytyy esimerkiksi Real Python -sivuston
+artikkelista [What is Pip](https://realpython.com/what-is-pip/).
+
+Kun olet lopettanut projektin työstämisen, anna komento `deactivate`. Sen jälkeen
+`python3`-komento ajaa taas järjestelmän oman Python 3 -tulkin. Aktiivinen 
+virtuaaliympäristö näkyy komentokehotteessa, mutta voit tarkistaa tilanteen
+komennolla `which python3`.
+  
 ## Traficomin avoin data
 
 Ajoneuvotiedot ovat [Traficomin avointa dataa](https://www.traficom.fi/fi/ajankohtaista/avoin-data?toggle=Ajoneuvojen%20avoin%20data).
 
 ## Sähköautojen ensirekisteröintien kehitys
 
 Erottele Traficomin ajoneuvodatasta tarvittavat sarakkeet
-komentojonolla `esipesu.sh`.
+komentojonolla `esipesu.sh`:
+
+    bash esipesu.sh
 
 Keräile rekisteröintitiedot vuosilta 2016-2021 Python-ohjelmalla
-`ev_counts.py`.
+`ev_counts.py`. Varmista, että esipesun tuottama tiedosto on
+samassa hakemistossa, ja aja sitten ohjelma:
+
+    python3 ev_counts.py
+
+Ohjelma pysyy käynnissä kunnes pylväsdiagrammin sisältävä
+ikkuna suljetaan.
+
+HUOM.! Jos saat ilmoituksen:
+
+> UserWarning: Matplotlib is currently using agg, which is a non-GUI backend, so cannot show the figure.
+
+niin ratkaisu on asentaa Tkinter-kirjasto Pythonille:
+
+    sudo apt-get install python3-tk
+
 
 ### Datan pilkkominen vuosimääristä kuukausimääriksi
 
@@ -33,6 +87,15 @@ vuodelle 2023 on ennustettu lineaarisen regressiomallin avulla,
 käyttäen Scikit-learn-kirjastoa. Tämä versio on tiedostossa
 `ev_counts_regression.py`.
 
+Aktivoi ensin Python-virtuaaliympäristö ja asenna Scikit-learn:
+
+    source venv/bin/activate
+    pip install scikit-learn
+
+Sen jälkeen aja ohjelma:
+
+    python3 ev_counts_regression.py
+
 Tuloksia voi verrata esimerkiksi Tilastokeskuksen tiedotteeseen
 [Tammikuussa 2023 ensirekisteröitiin 7 175 uutta henkilöautoa](https://www.stat.fi/julkaisu/cl8cq3s51778x09w2jlxa1tyh).
 

ev_counts.py

@@ -52,7 +52,7 @@
 plt.bar(year_keys, values, tick_label=year_keys)
 plt.show()
 
-# HUOM.! Jos saat ilmoituksen "serWarning: Matplotlib is 
+# HUOM.! Jos saat ilmoituksen "UserWarning: Matplotlib is 
 # currently using agg, which is a non-GUI backend, so 
 # cannot show the figure.", niin ratkaisu on 
 # asentaa Tkinter: `sudo apt-get install python3-tk`