.. _command: ======================== FEMAG-Command-Line (FCL) ======================== Hintergrund und Aufruf ^^^^^^^^^^^^^^^^^^^^^^ Die FEMAG-Command-Line (FCL) ist ein Kommandozeilen-Modus im Maskenfenster, der die unmittelbare Ausführung von häufig benötigten Kurzbefehlen ermöglicht ohne den jeweiligen Menü-Punkt zuvor auszuwählen. Ferner stellt er die Basis für die Information bzw. Interaktion während der Skript-Ausführung dar und ermöglicht das :any:`debug` unter allen von FEMAG unterstützten Plattformen (auch Windows). Die FCL kann mit der Tastenkombination *+* aktiviert werden, das Maskenfenster schaltet daraufhin in den Befehlszeilenmodus um, wie die folgende Abbildung zeigt. .. image:: fcl_invoke.png Mit dem Kurzbefehl *t* (terminate) wird die Befehlszeile verlassen und mit eine Übersicht der Befehle mit Kurzbeschreibung angezeigt. Die Befehlsliste lässt sich mit + oder + verschieben. Eine genauere Beschreibung der Befehle und der jeweils erwarteten Argumente kann mit cmd angezeigt werden, wobei cmd für den zu erklärenden Kurzbefehl steht. Mit den Tasten sowie können zuvor eingegebene Befehle wiederholt und mit werden teilweise eingegebene Befehle vervollständigt, wie es unter Linux üblich ist. Übersicht wichtiger Kurzbefehle ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Die Befehle vereinfachen die Durchführung wiederkehrender Aktionen wie z. B. das Zoomen in einen Bildschirmausschnitt des Grafikfensters und die Überprüfung von Positionen oder Abmessungen während der Modellerstellung (Modellprogrammierung). +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | Bezeichner: | Beschreibung | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | :fsl cmd | Ausführen des FSL-Befehls cmd | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | :fsl | Wechseln in den FSL-Modus. Nachfolgende Eingaben werden als FSL-Befehle interpretiert. Die Ausführung erfolgt beim Zurückwechseln in den FCL-Modus.. | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | :fcl | Wechseln in den FCL-Modus. Nachfolgende Eingaben werden als FCL-Kurzbefehle interpretiert. | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | fsl file | Ausführen der FSL-Datei file | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | pos | Gibt Position im Grafikfenster nach Linksklick aus | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | dist | Gibt Abstand zwischen zwei durch Linksklick definierte Positionen aus | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | smf | Erzeugt Bilddatei (Endung eps oder svg) des Grafikfensterinhalts | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ | cfs | Führt einzelne Feldberechnung durch | +-------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+ Spezielle Kurzbefehle für den Datenzugriff ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Können für die Fehlersuche bei der Skript-Programmierung hilfreich sein, um Materialeigenschaften oder Ergebnisgrößen zu überprüfen. Die Auswahl der Objekte erfolgt durch Linksklick mit dem Mauszeiger. Als Argument ist ein Bezeichner anzugeben, der in den jeweils als Verweis angegebenen Abschnitten erläutert ist, z. B. geld induc (siehe Datenzugriff :any:`accessEle`) um die Induktion in einem auszuwählenden Element auszugeben. Die Bezeichner entsprechen denen der FSL-Befehle get_xxx_data oder set_xxx_data. +---------------+--------------------------------------------------------------------------------+ | Bezeichner | Beschreibung | +---------------+--------------------------------------------------------------------------------+ | gndd | Gibt Knoteneigenschaften aus (siehe :any:`accessNode`) | +---------------+--------------------------------------------------------------------------------+ | geld | Gibt Elementeigenschaften aus (siehe :any:`accessEle`) | +---------------+--------------------------------------------------------------------------------+ | gsed, ssed | Gibt Superelementeigenschaften aus bzw. setzt diese (siehe :any:`accessSuper`) | +---------------+--------------------------------------------------------------------------------+ | gsrd | Gibt Subregioneigenschaften aus (siehe :any:`accessSub`) | +---------------+--------------------------------------------------------------------------------+ | gwdd | Gibt Wicklungseigenschafen aus (siehe :any:`accessWind`) | +---------------+--------------------------------------------------------------------------------+ | gmdd | Gibt Modellparameter aus (siehe :any:`accessModel`) | +---------------+--------------------------------------------------------------------------------+ | gdvd, sdvd | Gibt Maschinenparameter aus bzw. setzt diese (siehe :any:`accessMach`) | +---------------+--------------------------------------------------------------------------------+ | gsmd | Gibt Simulationsparameter aus (siehe :any:`accessSimu`) | +---------------+--------------------------------------------------------------------------------+