cms-opendata-education/cms-jupyter-materials-finnish

Tehtäviä ja demoja avoimen datan parissa. Suomenkielistä opetusmateriaalia hiukkasfysiikan, koodaamisen ja data-analyysin alkeisiin.

cms-opendata-education

Files and images that are used organization wide

Open csv-file search tool in MyBinder:

cms-jupyter-materials-finnish's Issues

Työkaluohjeiden päivitys

Tällä hetkellä TyokalutTutuiksi -kansion sisältö on hieman sekava ja käyttäjän on vaikea tietää, mistä notebookista kannattaisi aloittaa. Lisäksi tämänhetkisissä ohjeissa on hieman toistoa.

Kansio olisikin hyvä uudistaa esimerkiksi seuraavasti:

Usean samantyyppisen notebook-tiedoston sijaan tehtäisiin ainoastaan yksi ohje Notebookeille ja yksi Pythonin käyttöä varten. Kansion sisältö olisi tällöin

• JupyterNotebookTutorial.ipynb
• PythonTutorial.ipynb
• README.md

Tutoriaalien itsessään olisi hyvä olla kattavat, muttei kuitenkaan liian pitkät, jotta käyttäjä jaksaa lukea ne läpi.

README-tiedostoon tulisi kansion kuvaus sekä MyBinder ja Google Colab linkit suoraan tutoriaaleihin.

Lyhennetyt versiot Python- ja Jupyter-ohjeista löytyy AvoinDataHiukkasfysiikassa -opetuskokonaisuudesta. Esimerkiksi niitä voisi käyttää näiden yleisten ohjeiden pohjana.

Kommentteja: Työkalut tutuiksi

README

• Tehtävien järjestys on nyt ainakin itelleni hieman sekava (esim. kolme erilaista Jupyter Notebookeihin liittyvä harjoitetta, joista kaksi on peräkkäin ja yksi viimeisenä listassa), linkit voisi laittaa esim. etenemisjärjestykseen

• Voisi olla vielä selkeämmät kuvaukset siitä, mitä eroa eri Jupyter-harjoituksilla on

Ohjeita Pythonin käyttöön

• Käsky "aurinko = pd.read_table('http://sidc.oma.be/silso/INFO/sndhemcsv.php', sep = ';', encoding = "ISO-8859-1", header = -1)" ei toimi, virheilmoitus ajettaessa: Passing negative integer to header is invalid. For no header, use header=None instead

• Solussa, joka alkaa "# Luodaan tasaisesti jaettu lukusuora 1 ja 10 väliltä ja satunnaistetaan sitä hieman.", ei ole ohjelmointia tuntemattomalle lukijalle intuitiivisesti selkeää, mitä kuvaajan akselit merkitsevät ja miksi akselien luvut ovat niin suuria, kun alkuperäisen lukujonon arvot ovat välillä 1 ja 10. Voisi vielä selkiyttää kommenteilla tai akseleiden nimeämisellä, mitä tässä kohtaa tapahtuu.

• CSV-tiedostoa osoitteesta "https://files.datapress.com/london/dataset/road-casualties-severity-borough/TFL-road-casualty-data-since-2005.csv" ei enää löydy, joten osion 8 sitä hyödyntävät viimeiset esimerkkikoodit eivät toimi

• Osion 8 lopussa hyödynnettyä moduulia OSGridConverter ei myöskään löydy, virheilmoitus ajettaessa: No module named 'OSGridConverter'

Jupyter-aloitus

• 7. Jupyter ja Latex-osiossa Latex-merkinnät eivät näy selitystekstissä oikein

Mittaa ja mallinna -kokonaisuuden hiominen

Mittaa ja mallinna -kokonaisuudessa on esimerkkiprojekteja, joihin olisi hyvä olla esimerkkiratkaisut. Ratkaisuissa voisi olla lisäksi kuvia mittaustilanteesta. Tällä hetkellä esimerkkiratkaisut on olemassa, mutta niihin kerätty data on heikkolaatuista puutteellisten välineiden vuoksi.

Lisäksi, jos on hyviä ideoita uusista esimerkkiprojekteista, voi niitä lisätä kokonaisuuteen.

Liitteenä tämänhetkiset esimerkkiratkaisut ja niissä käytetty data.
esimerkkiratkaisut.zip

Kommentteja: Demot > Muut_aiheet

README (Demojen pääsivu)

• Ohjetekstiin voisi tarkentaa, mitä eri kansioista löytyy

README (Hiukkasfysiikkaa ja Muut_aiheet)

• Demoista voisi antaa vielä tarkemman kuvauksen, esim. aika-arvio tai edes jonkinlainen luokittelu laajuuden perusteella

CERN_henkilosto

Mitkä valtiot kuuluvat järjestelmään?

• Osion toinen koodilaatikko antaa ajettaessa seuraavanlaisen varoituksen: "FutureWarning: Passing a negative integer is deprecated in version 1.0 and will not be supported in future version. Instead, use None to not limit the column width."

Henkilökunta läpi vuosien

• Osion kolmas koodilaatikko antaa ajettaessa seuraavalaisen varoituksen: "No handles with labels found to put in legend."

Kartat_esim

• Toista solua ajettaessa tulee virheilmoitus: "HTTP Error 404: Not Found"

Invariantin massan kaavat

Lisää esim, notebookiin https://github.com/cms-opendata-education/cms-jupyter-materials-finnish/blob/master/Opetusmateriaalit/AvoinDataHiukkasfysiikassa/3_Data-analyysi/01_LaskeInvarianttiMassa.ipynb maininta siitä, että cosh... kaava on approksimaatio, joka toimiii silloin kun E ≫ m

CERNin tutkimuksen ja avoimen datan yhdistäminen opetussuunnitelmaan

Tähän dokumenttiin on koottu mahdollisia keinoja CERNissä tehtävän tutkimuksen hyödyntämiseksi opetuksessa. Dokumentti sisältää ideoita sisällöistä ja konsepteista, joissa hyödynnetään muun muassa CMS-mittalaitteiston tuottamaa avointa dataa ilmiöpohjaisen oppimisen ja hiukkasfysiikan sovellusten kautta. Dokumenttiin on poimittu yksityiskohtaisesti lukion opetussuunnitelman perusteiden (LOPS 2015) sisältöjä ja tavoitteita, jotka voidaan yhdistää CERNin tutkimukseen ja avoimen datan käsittelyyn.

CERN-ja-opetussuunnitelma.pdf
CERN-ja-opetussuunnitelma.docx

yleishuomioita hiukkasethukassa kokonaisuudesta

• [Data-analyysitehtävät] (https://github.com/cms-opendata-education/cms-jupyter-materials-finnish/tree/master/Opetusmateriaalit/AvoinDataHiukkasfysiikassa/3_Data-analyysi) : Voisiko tehtävien binderpohjiin olla linkki jossain selkeämmässä ja helpommassa paikassa, jotta tehtävät saisi tehtyä helpommin ja sujuvammin, kun binderpohja löytyy helpommin?

• Datan kimppuun : voisiko tehtävien yllä tai piilotettuna linkin takana olla esimerkit tehtävänannon mukaisesta koodista, jotta ongelmatilanteen sattuessa oppilas voi soveltaa esimerkkiä tehtävän ratkaisussa?

• Python 3 -Ohjelmoinnin kimppuun voisiko tässä olla inkki binderiin myös, jotta esimerkkejä ja koodeja on helpompi kokeilla?

• Hiukkaset hukassa Standardimallin osioon olisi hyvä lisätä edes vähän perustietoa kverkkien ja leptonien ominaisuuksista ja toiminnasta samalla tavalla kuin välittäjähiukkasten

Huomioita / Opetusmateriaali > AvoinDataHiukkasfysiikassa > Data-analyysi

Parannusehdotuksia:

• Muuttujan "Datasetit" lyhentäminen esimerkiksi muotoon "a", jolloin kaavan kirjoittaminen on huomattavasti helpompaa ja sen saa lyhyempään muotoon

• Myös muuttujan "invariantti_massa" lyhentäminen

• Yleisesti: Ohjeet alkuperäisen koodin löytämiseen helposti

• 3. kohdan yksinkertaistaminen (@tanelilantta)

Kommentteja: Opetusmateriaalit

MittaaJaMallinna > MittaaJaMallinnaOpettaja

Tiedoston lukeminen

• Osion ensimmäistä solua ajettaessa tulee virheilmoitus: HTTP Error 404: Not Found

AvoinDataHiukkasfysiikassa > 3_Data-analyysi > 08_HiggsinBosoni

• Aivan Notebookin lopussa, tekstin "Alla olevassa kuvassa on CMS:n analyysi törmäyksistä, joissa on syntynyt neljä leptonia." jälkeen pitäisi näkyä kuva, mutta kuvan linkki ei toimi.

Huomioita/ README.md

Kävin läpi materiaalia ilman taustatietoja. Tässä huomioita ensikertalaiselta.

• ensimmäisenä voisi olla kuvakaappaus, miten oikeat tiedostot saa auki. Ensimmäisenä avasin itse ainakin laatikon keskellä näkyvän tiedoston, joka vei suoraan koodiin eikä tehtävätiedostoihin. Ohjeet kuvan kanssa selkeyttäisivät ja nopeuttaisivat tietojen ja materiaalien löytämistä.

• Sisältölistassa voisi olla linkit materiaaleihin, jotta kulku materiaalista toiseen voisi olla nopeampaa. esim. Työkalut tutuiksi yms.

Kommentteja: Demot > Hiukkasfysiikkaa

Demot > Hiukkasfysiikkaa > Laske-invariantti-massa

Laskun suorittaminen

• Ylimääräisten alaviivojen poistaminen numpy-moduulista puhuttaessa

Demot > Hiukkasfysiikkaa > Animaatio_esimerkki

Esimerkki animaatiosta

• Typo: "hitaitat" > "hitaita"

• Typo: "ohelma" > "ohjelma"

• "Yllä oleva solu ei näytä lopputulosta %%capture-magic komennon vuoksi.": jos lukija ei tiedä, mikä on magic-komento, tämä lause saattaa olla hieman hämmentävä. Voidaanko olettaa, että ne ovat lukijalle tuttuja? Jos ei, tämän voisi uudelleenmuotoilla.

• Notebookin lopussa animaation luominen kesti niin kauan, että luulin aluksi, ettei se toiminut. Voisi olla hyvä lisätä maininta tekstiin, että animaation luomisessa kestää.

Demot > Hiukkasfysiikkaa > Histogrammien-vertailu-samassa-kuvassa

CMS-datan jaottelu ja histogrammien vertailu
- Ylävalikkoon viittaavat ohjeet eivät ole koherentteja, jos notebookia ajaa MyBinderin sijaan Colabilla. En esim. löytänyt, mikä vastaisi ohjeessa mainittua valikkoa "Kernel → Restart & Clear Output" Colabissa. Olisiko Colab-käyttäjille mahdollista lisätä myös ohjeet?

• Ohjeet ylävalikkoon liittyen erikseen Binder- ja Colab-käyttäjille

• "Tämän solun kaltaiset tekstisolut voidaan luoda painamalla ”b” ja valitsemalla solutyypiksi yläpalkista ”Markdown”. ": voisi ohjeistaa vielä tarkemmin, että solutyypin valinta tapahtuu (Binderissa) alavalikosta: "Cell" > "Cell type" > "Markdown"