Palautuksen tulossivulla on paljon tietoa. Tiedon määrä voi alussa tuntua liiankin suurelta. Kannattaa ensin keskittyä esimerkiksi kohtiin, joissa on tiedot epäonnistuneista testeistä. Kun järjestelmä tulee tutummaksi ja koodisi toimii oikein, kannattaa katsoa myös sivun alaosaa. Siellä on tarkempia mittauksia koodisi suorituskyvystä, ja voit jopa tarkastella kääntäjän tuottamaa assembly-koodia. Tämä on erityisen hyödyllistä, jos sinulla ei ole vastaavaa laitteistoa muualla ja haluat hyödyntää arviointikoneiden ominaisuuksia.

Kehitysympäristö

Kun lataat tehtävän koodipohjat sisältävän zip-paketin, sen pitäisi toimia suoraan tyypillisissä Linux- ja macOS-ympäristöissä, kunhan tavalliset kehitystyökalut on asennettu ja käytössä on riittävän uusi C++-kääntäjä: GCC:n versio vähintään 8 tai Clangin versio vähintään 6.

Jos käytät Ubuntu Linux 20.04 -järjestelmää, saat tarvittavat työkalut komennolla sudo apt install g++ python3.

Jos käytät Ubuntu Linux 18.04 -versiota, tarvitset lisäksi uudemman kääntäjän komennolla sudo apt install g++-8 — kurssin skriptien pitäisi tunnistaa se automaattisesti.

Jos käytät Debian 9 -järjestelmää, kannattaa yleensä päivittää vähintään versioon Debian 10, jotta saat GCC 8:n.

Jos käytät macOS-järjestelmää, saat toimivan kehitysympäristön esimerkiksi näin:

• Suorita komento xcode-select --install asentaaksesi komentorivin kehitystyökalut.
• Asenna Homebrew.
• Suorita brew install libomp saadaksesi OpenMP-tuen.
• Jos haluat käyttää Clangin sijasta GCC:tä, voit asentaa sen komennolla brew install gcc.

Jos käytät Windows Subsystem for Linux -ympäristöä Linuxin ajamiseen Windowsissa, varmista, että purat zip-paketit Linux-ympäristön puolella. Jos purat ne Windowsin puolella ja yrität käyttää tiedostoja Linuxissa, esimerkiksi tiedosto-oikeudet eivät välttämättä toimi oikein. Saat toimivan kehitysympäristön seuraavasti:

• Asenna WSL tavalliseen tapaan: aja komentokehotteessa wsl --install ja seuraa ohjeita.
• Käynnistä "Ubuntu" ja tee loput toiminnot Ubuntun sisällä.
• Suorita komennot sudo apt-get update ja sudo apt install unzip g++ saadaksesi tarvittavat työkalut.
• Kun lataat esimerkiksi tiedoston prereq.zip, pura se Ubuntussa komennolla unzip prereq.zip, siirry hakemistoon komennolla cd prereq ja kaiken pitäisi toimia kuten Linuxissa.

Jos sinulla on Aalto-yliopiston käyttäjätunnus, voit käyttää etänä Maari-rakennuksen Linux-koneita:

• Yhdistä ensin johonkin Aallon yleiskäyttöisistä Linux-kuoripalvelimista, esimerkiksi komennolla ssh kosh.aalto.fi (Aalto-tunnuksellasi ja salasanallasi).
• Jatka sitten koneelta kosh johonkin Maari-A- tai Maari-B-luokkien koneista, esimerkiksi moa, komennolla ssh moa — käyttäjätunnusta tai salasanaa ei pitäisi kysyä. Jos tämä ei toimi, suorita komento kinit koneella kosh, anna Aalto-salasanasi ja yhteyden pitäisi toimia taas jonkin aikaa.

Jos käytät jotakin konetta ssh:n kautta, helpoin tapa saada koodipohjat sinne on kopioida latauslinkki ja käyttää komentoa wget zip-tiedoston lataamiseen.

Mitä taustalla tapahtuu

Voit käyttää valitsinta -v (esim. komento ./grading -v test) nähdäksesi, mitä komentoja arviointityökalu ajaa. Näin on helpompi nähdä, mikä on vialla, jos työkalu ei toimi odotetusti paikallisessa ympäristössäsi, ja miten koodisi käännetään.

Arviointityökalu kääntää oman koodisi (esim. cp.cc) ja testikoodin yhdeksi suoritettavaksi ohjelmaksi (esim. cp). Voit suorittaa ohjelmatiedoston myös suoraan komentoriviltä tai debuggerissa/profilerissa. Käytä jälleen komentoa ./grading -v test löytääksesi oikean komennon.

Kätevät apuohjelmat

Koodipohjat sisältävästä zip-paketista löytyy käteviä määrittelyjä tiedostosta .ppc/ppcgrader/include/vector.h. Voit lisätä #include "vector.h" ratkaisuusi ja käyttää näitä määrittelyjä. Ne ovat automaattisesti käytettävissä sekä paikallisissa testauksissa että arviointipalvelimelle tehdyissä palautuksissa.

Hyvät käytännöt

On erittäin suositeltavaa, että pidät kaiken koodisi omassa yksityisessä Git-repositoriossa. Näin saat kaikki koodipohjat yhteen paikkaan ja voit seurata omien ratkaisujesi kehittymistä.

Vikojen etsiminen (korrektius)

Jos ohjelma kaatuu yllättäen, kannattaa tarkistaa ainakin seuraavat asiat:

• Palautusjärjestelmä käyttää automaattisesti AddressSanitizer-työkalua monien yleisten muistinhallinta- ja indeksointivirheiden (esimerkiksi taulukon rajojen ylitykset) havaitsemiseen. Jos saat virheilmoituksia AddressSanitizerilta, se on hyvä asia — lue viesti huolellisesti, sillä se kertoo yleensä melko suoraan, missä ongelma on.
• Jos et saa virheitä AddressSanitizerilta mutta ohjelma silti kaatuu, tarkista, ettei sinulla ole pinoylivuotoja (stack overflow). Tyypillinen pinon enimmäiskoko Linux-koneilla on vain noin 8 Mt, joten tarkista, ettei pinosta lopu tila. Jos tarvitset megatavujen verran muistia, käytä kekoa (heap).
• Huomioi myös, että vektoritaulukoita käytettäessä on huolehdittava oikeanlaisesta muistin kohdistuksesta — katso lisätietoja kurssimateriaalista.

Jos saat vääriä tuloksia, mieti ainakin seuraavia asioita:

• Saatat lukea alustamatonta muistia. C- ja C++-ohjelmissa muistinvarausfunktiot eivät tyypillisesti takaa, että varattu muisti olisi nollattu. On helppo unohtaa alustaa uusi muisti. Usein ohjelma näyttää toimivan sattumalta, koska uusi muisti sisältää joskus pelkkiä nollia.
• Jos käytät CUDAa, muista tarkistaa virheet kaikista CUDA-API-kutsuista — katso esimerkkejä kurssimateriaalista.