Referenca za urejevalnik formul

Urejevalnik formul ustvarja tipizirane izraze, ki se uporabljajo za spremenljivke, izbire, pogoje, izplačila, poti, časovno razporejanje in izhode Market.

Zgradba urejevalnika

Naslov označuje vrednost, ki jo določate. Oznake konteksta prikazujejo pričakovani tip rezultata in, če so na voljo, stanje predogleda ter sklicevane elemente.

• Definicija (Definition) odpre iskalni izbirnik za spremenljivke, izbire, sredstva, vrste igralcev, igralce in druge definicije, ki so na voljo v trenutnem kontekstu. Parametri funkcije se prikažejo samo med urejanjem Telesa funkcije (Function Body), v katerem so deklarirani. To so vhodi te funkcije, ne ponovno uporabne spremenljivke igre; klicatelj jim vrednosti poda kot argumente funkcije. V skupini Spremenljivke uporabite Dodaj spremenljivko (Add Variable) (+), da določite ponovno uporabno vrednost, ne da bi zapustili trenutno formulo. Ko določite njeno ime, tip, obseg in točko izračuna, se nova spremenljivka vstavi na mesto trenutnega kazalca. Izberite, ali želite določiti formulo ali ustvariti samo shranjeno vrednost. Odpre se urejevalnik nove formule, v katerem je trenutna vsebina izbrana, zato lahko začetni izraz takoj zamenjate s tipkanjem. Formule za inicializacijo Market omejujejo ustvarjanje na spremenljivke, ki se izračunajo ob začetku igre.
• Funkcije (Functions) odpre katalog funkcij, razvrščenih po namenu.
• Vzorci (Patterns) prikažejo pogoste izračune, ki ustrezajo pričakovanemu tipu rezultata ter spremenljivkam, izbiram ali parametrom funkcije, ki so na voljo v trenutnem kontekstu urejanja.
• glavno besedilno polje sprejema neposredno vneseno formulo,
• preverjanje pod urejevalnikom sporoča, ali je izraz veljaven,
• Uporabi (Apply) shrani izraz v trenutni osnutek,
• Prekliči (Cancel) ohrani prejšnji izraz nespremenjen.

Vstavljanje iz izbirnika uporablja stabilne sklice na definicije. Imena, ki vsebujejo presledke, so zapisana z obratnimi narekovaji.

Če izberete vzorec, boste pozvani k vnosu vseh zahtevanih vrednosti, nato pa se besedilo urejevalnika zamenja z običajno formulo. Takoj lahko spremenite kateri koli njen del. Začetni katalog vsebuje pogojno vrednost, skupno vrednost, povprečje, minimum, maksimum, razliko in razmerje. Vzorec se ne prikaže, če trenutna definicija nima združljivega vhoda, na primer številčne zbirke za Skupno vrednost (Total).

Tipi in prazne vrednosti

Cilj določa pričakovani tip, na primer število, celo število, logično vrednost, besedilo ali poljuben tip. Urejevalnik zavrne izraze, katerih rezultat ni združljiv s ciljem.

Prazna ali manjkajoča vrednost ni enaka številčni ničli in se ne obravnava samodejno kot neresnična. Če imajo manjkajoči podatki poseben pomen, uporabite izrecne pogoje.

Skupine funkcij

Trenutni katalog je razdeljen v naslednje skupine:

• Udeleženci (Participants): število udeležencev, uporabniška imena, identifikatorji, vrste igralcev in skupine.
• Med izvajanjem (Runtime): krog, čas, samodejni odziv, faza, izbira matrike, iteracija in zbiranje podatkov med udeleženci.
• Posodobitve med izvajanjem (Runtime updates): trajanje igre, dejavnost oziroma vrsta igralca in posodobitve prehodov med stopnjami.
• Matematika (Math): številske funkcije in agregati.
• Zbirke (Collections): velikost, transponiranje, združevanje, razvrščanje, izbiranje, razčlenjevanje in uteženo izbiranje.
• Besedilo (Text): besedilni predikati.
• Naključnost (Random): enakomerna, normalna, omejena, števna, beta, kosovno določena in trikotna porazdelitev.
• Market: poizvedbe ali posodobitve gotovine in začetnega kapitala.
• Dogodek Market (Market event): sredstvo trenutne transakcije, vrednotenje, dobiček, cena, količina, stran in čas.
• Posodobitve Market (Market updates): spremembe dovoljenj za nakup/prodajo.

Izbirnik funkcij prikazuje podpis vsake funkcije in njen kratek opis. Funkcije so še vedno odvisne od konteksta: funkcija dogodka Market je smiselna samo pri vrednotenju izhoda dogodka Market.

Pogosti vzorci formul

Ponudbe vzorcev so na začetku strnjene, da lahko hitro pregledate njihova imena in opise. Odprite ponudbo, da izberete njene vhode in jo uporabite. Uporaba vzorca vstavi običajno formulo, ki jo lahko še vedno neposredno urejate; identifikatorji funkcij ostanejo v jeziku formul ne glede na jezik vmesnika.

Začetna naključna vrednost

Uporabite naključno porazdelitev v spremenljivki, ki se izračuna Ob začetku igre (At game start), na primer:

Uniform(0, 100)

Pogojna vrednost

Uporabite if(condition, when_true, when_false), kadar je vrednost odvisna od izbire ali stanja:

if(choice::\Accept offer\ = "Accept", variable::\Current offer\, 0)

Akumulator

V izhodu stopnje ali transakcije se sklicujte na prejšnjo vrednost spremenljivke in ji prištejte nov prispevek:

variable::\Total\ + quantity()

Povzetek zbirke

Če je vhod zbirka, uporabite agregat, kot je sum(values), average(values) ali median(values).

Veja samodejnega zaključka

V poti ali izhodu proste oblike (Free Form) razlikujte med potekom časa oziroma samodejnim zaključkom s funkcijo:

automatic_response()

Sklici in preimenovanje

Sklici določajo definicije s stabilnim ID-jem, čeprav formula prikazuje berljiva imena. Če preimenujete spremenljivko, izbiro, vrsto igralca, igralca ali sredstvo, vam ni treba ročno prepisovati vseh povezanih sklicev.

Če je mogoče, uporabite izbirnik definicij. Ročno vnesena imena se morajo v trenutnem kontekstu formule enolično razrešiti.

Preverjanje in predogled

Preverjanje pregleda sintakso, razreševanje sklicev, tipe argumentov in pričakovani tip rezultata. Formula je lahko skladenjsko veljavna, vendar med izvajanjem še vedno ni na voljo, če bere vrednost, preden se izvede vir, ki jo določa v življenjskem ciklu.

Razpoložljivost predogleda je odvisna od konteksta in trenutnega vzorčnega stanja. Predogled je pomoč, ne pa nadomestilo za preverjanje in testni zagon.