From 9a99abd51d56507e81a7f6ca3eac8a3d950d48a4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vili=20Sinerv=C3=A4?= <39151688+ArcticCoder@users.noreply.github.com> Date: Fri, 28 Oct 2022 13:04:23 +0300 Subject: [PATCH] Update ohje.md --- dokumentaatio/ohje.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/dokumentaatio/ohje.md b/dokumentaatio/ohje.md index 2bd9519..4a73c26 100644 --- a/dokumentaatio/ohje.md +++ b/dokumentaatio/ohje.md @@ -13,21 +13,23 @@ Ohjelman vaatimat kirjastot voi asentaa komennolla `pip install -r requirements.txt` +# Käyttäminen + Ohjelma on nyt valmis käytettäväksi `invoke start` Ohjelma tulostaa ohjeet komennolla 'A'. Tässä vielä tarkentavaa tietoa komennoista, joiden kohdalla se on mielekästä: -## (O)petusdata +### (O)petusdata Opetusdatan tiedosto polku. Voi olla absoluuttinen tai suhteellinen. Hyväksyy esimerkiksi ns. wildcard merkin * ja käsittelee sitä yleisellä tavalla. Taustalla on pythonin [glob](https://docs.python.org/3/library/glob.html), jonka dokumentaatiosta löytyy enemmän tietoa siitä, mitä merkkejä voi käyttää ja miten. Muutujan oletusarvo ottaa opetusdataksi kaikki "opetusdata"-kansion MIDI-tiedostot. -## a(L)kuosa +### a(L)kuosa Generoitavan sävelmän alkuosa. Esitetään perinteisillä nuottimerkinnöillä, kuten "C4" ja "D#5". Erottimena toimii `|`. Mikäli alkuosan pituus ylittää Markovin ketjun asteen, ylimääräiset nuotit EIVÄT PÄÄDY lopulliseen melodiaan, vaan ne jätetään huomiotta. Toisaalta mikäli alkuosan pituus on pienempi kuin Markovin ketjun aste, sitä täydennetään opetusdatan perusteella riittävän pitkäksi. -## (R)ytmi +### (R)ytmi Aseta rytmi nuottien kestoina. Esim neljäsosanuotti "1/4", puolinuotti "1/2" ja kokonainen nuotti "1". Erottimena toimii `|`. Rytmiä käytetään annetussa järjestyksessä ja toistetaan alusta alkaen tarpeen mukaan. -## (M)uunnettava MIDI +### (M)uunnettava MIDI Vaihtoehtoinen tapa määrittää rytmi, tempo ja muita musikaalisia piirteitä. Tässä tilassa ohjelma ottaa annetun MIDI-tiedoston ja luo siitä kopion kahdella muutoksella - Keston yläraja määräytyy generoitavien nuottien määrästä - Sävelkorkeudet vaihdetaan Markovin ketjulla generoituihin