Přehled skriptů

QInsight má v sobě integrovaný Python — skripty běží přímo v aplikaci a mají přímý přístup k proměnným projektu. Hodí se na automatizaci (reakce na události, zápis hodnot) i na zpětnou analýzu naměřených dat.

Nastavení Pythonu

Aplikace používá Python nainstalovaný na počítači (64bitový CPython 3.10 až 3.14, viz Instalace). Python je volitelný — zapíná se jednorázově v Options → Preferences → General:

  • Use Python scripts — zapne Python v aplikaci. Při zaškrtnutí musí být vyplněná Python Dll Path a soubor musí existovat, jinak nastavení nejde uložit.
  • Python Dll Path — cesta k python3xx.dll v instalační složce Pythonu (např. ...\Python313\python313.dll). Při vypnutém Pythonu se cesta ignoruje, ale zůstane uložená.

Když je Python vypnutý, chová se QInsight při startu runtime podle toho, zda projekt obsahuje skripty a zda jsou povolené (sloupec Runtime u skriptu, při přehrávání logu sloupec Replay):

Python v nastaveníSkript v projektuSkript povolenStart runtime
zapnutýlibovolnělibovolněspustí se, povolené skripty běží
vypnutýnení—spustí se bez hlášky
vypnutýjenespustí se; v Logs varování, že projekt obsahuje Python skripty a Python je vypnutý
vypnutýjeanonespustí se; v Logs chyba s pokynem zapnout Python v Preferences

U projektu s více skripty rozhoduje nejpřísnější případ: stačí jeden povolený skript a runtime se nespustí; jsou-li všechny zakázané, runtime běží a varování se vypíše jednou.

Interaktivní konzole Tools → Interpreter → Python je dostupná jen při zapnutém Pythonu; při vypnutém je položka menu neaktivní, nezávisle na otevřeném projektu.

Skripty v projektu

Skripty se spravují v Home → Project Configuration → Scripts a jsou součástí projektu (ukládají se s ním jako .py soubory). Každý skript má:

  • File name — jméno souboru skriptu,
  • Runtime — zda se skript používá při běžné komunikaci,
  • Replay — zda se používá i při přehrávání logu,
  • Execution mode — kdy se spouští:
    • Startup — jednou při startu runtime,
    • Periodic — opakovaně; perioda se zadává v Parameters, např. period=500;unit=ms,
    • OnValueChanged — při změně hodnoty vybrané proměnné (s prahem, hysterezí…),
    • Shutdown — jednou při zastavení runtime,
    • Manual — ručně,
  • Blocking a Timeout (ms) — způsob a limit běhu,
  • Parameters — doplňkové parametry režimu.

📷 Místo pro obrázek — vlastnosti skriptu v Project Configuration.

Výstup skriptů

Vše, co skript vypíše (print), směřuje do okna Script-Logs. Chyby a varování enginu (např. špatně zadaná perioda nebo vypršelý timeout) najdete v okně Logs. Pokud periodický skript trvá déle než ~70 % své periody, engine další volání přeskočí a upozorní — perioda je tedy zároveň rozpočtem času skriptu.

Dále

Jak skript čte a zapisuje hodnoty — Přístup k proměnným.