Konvence pojmenování proměnných, bloků a subsystémů

1.3 Konvence pojmenování proměnných, bloků a subsystémů

Pro usnadnění práce s řídicím systémem REXYGEN se používá několik konvencí. V předchozí podkapitole byly zavedeny všechny používané typy proměnných. Pod pojmem proměnná budeme mít v této podkapitole na mysli vstupy, výstupy a parametry bloků. Ve velké většině bloků se používají pouze tyto tři typy:

: Bool – pro dvouhodnotové logické proměnné, např. zapnuto/vypnuto, ano/ne, pravda/ nepravda, true/false, on/off, apod. V této příručce budeme hodnoty logické jedničky (ano, pravda, true, 1) zapisovat jako on a hodnoty logické nuly (ne, nepravda, false, 0) jako off. To platí i pro vývojové prostředí REXYGEN Studio. V dalších nástrojích a programech třetích stran mohou být jejich hodnoty zobrazovány jako 1 pro on a 0 pro off. Názvy logických proměnných používají velká písmena, např. RUN, YCN, R1, UP.
: Long (I32) – pro celočíselné hodnoty, např. číslo sady parametrů, délka trendového bufferu, typ generovaného signálu, chybový kód, výstup čítače, apod. Názvy celočíselných proměnných jsou obvykle psány malými písmeny a počáteční písmeno (vždy malé) je nejčastěji jedno z písmen ${i, k, l, m, n, o}$ , např. ips, l, isig, iE, apod. Existuje však několik výjimek z tohoto pravidla, např. cnt v bloku COUNT, btype, ptype1, pfac a afac v bloku TRND, apod.
: Double (F64) – pro čísla v pohyblivé řádové čárce (reálná), např. zesílení, saturační meze, výsledky většiny matematických funkcí, parametry PID regulátorů, délky časových intervalů v sekundách, apod. Názvy proměnných v pohyblivé řádové čárce používají pouze malá písmena, např. k, hilim, y, ti, tt.

Typy funkčních bloků v řídicím systému jsou pojmenovávány velkými písmeny, uvnitř jména se mohou vyskytovat číslice a znak ’_’ (podtržítko). Při vytváření uživatelských instancí bloků doporučujeme na začátku ponechat název typu bloku a doplnit jej o uživatelský název, kde doporučujeme používat všechny uvedené typy znaků a navíc malá písmena.

Výslovně se nedoporučuje používat v uživatelských názvech bloků a vytvořených subsystémů znaky s diakritikou a speciální znaky jako jsou mezery, znaky konce řádků, interpunkční znaménka, operátory, apod. Použití těchto znaků omezuje přenositelnost vytvořených algoritmů na různé platformy a může vést k velké nesrozumitelnosti. Jména jsou kontrolována překladačem REXYGEN Compiler a pokud obsahují některý z nevhodných znaků je hlášeno varování.

[Předchozí] [Na začátek] [Výše] [Další]