Odkazy na nejpoužívanější objekty JMRI jsou v nápovědě Access to JMRI Objects https://www.jmri.org/help/en/html/tools/scripting/Start.shtml#objects. Zde jsou definované názvy proměnných pro výhybky, snímače, paměťove proměnné, návěstidla, ... V programu jsou názvy proměnných definované ve třídě jmri/script/JmriScriptEngineManager.javahttps://github.com/JMRI/JMRI/blob/master/java/src/jmri/script/JmriScriptEngineManager.java#L119.
JMRI poskytuje jednotný způsob přístupu ke svým objektům. To se provádí přes InstanceManager. Například získání seznamu všech výhybek se provede následujícím způsobem:
vsechny_vyhybky = jmri.InstanceManager.getDefault(jmri.TurnoutManager).getNamedBeanSet()
U nejpoužívanějších objektů je možné použít zkrácený zápis:
vsechny_vyhybky = turnouts.getNamedBeanSet()
Ze seznamu výhybek pak můžeme všechny vypsat:
for v in vsechny_vyhybky :
print v.getUserName()
Někdy potřebujeme jeden konkrétní objekt. Vytvoříme si pro něj proměnnou a řekneme si o něj buď podle uživatelského názvu nebo podle systémového názvu.
v2 = turnouts.provideTurnout("V2")
S vybranou výhybkou pak můžeme dále pracovat.
print v2.getSystemName()
Kdo chce studovat jazyk Python zřejmě sáhne po nějaké učebnici, např. https://www.google.cz/search?&q=isbn+978-80-251-2737-7. Na internetu je také bezpočet online kurzů, jako např. tento https://www.itnetwork.cz/python/zaklady.
Výchozím bodem pro další studium skriptování v JMRI jsou stránky http://jmri.org/help/en/html/tools/scripting/index.shtml. Na tyto stránky navazují vzorové příklady. Ty jsou uloženy v instalačním adresáři JMRI v podadresáři JMRI/jython. Webové odkazy na tyto programy jsou zde http://jmri.org/help/en/html/tools/scripting/Examples.shtml. Dokumentace k API JMRI je zde http://jmri.org/JavaDoc/doc/.
aktualizace 28. 11. 2020
vytvořeno 17. 9. 2019