Eingaberegeln¶
Die Eingabedateien von FrontISTR (Gesamtsteuerungsdaten .dat, Analysesteuerungsdaten .cnt, Netzdaten .msh) folgen gemeinsamen Beschreibungsregeln.
Eigenschaften der Datei¶
- Es handelt sich um ASCII-Dateien in freiem Format.
- Sie bestehen aus Kopfzeilen (Headern), die mit
!beginnen, gefolgt von den zugehörigen Daten. - Die Reihenfolge, in der die Kopfzeilen geschrieben werden, ist grundsätzlich beliebig.
- Als Trennzeichen für die Daten wird
,verwendet.
Hinweis: Besonderheiten der Analysesteuerungsdaten
Die Analysesteuerungsdaten (
.cnt) weisen darüber hinaus folgende Besonderheiten auf.
- Die Datei ist grob in drei Zonen unterteilt: Berechnungssteuerungsdaten, Solver-Steuerungsdaten und Nachbearbeitungs- (Visualisierungs-)Steuerungsdaten.
- Am Ende der Datei wird
!ENDeingegeben, um sie abzuschließen.
Kopfzeile (Header)¶
Legt die Bedeutung der Daten und den Datenblock fest. Eine Zeile, die am Anfang mit ! beginnt, wird als Kopfzeile betrachtet.
Header-Zeile¶
Beschreibt den Header und die zugehörigen Parameter.
- Eine Header-Zeile muss mit dem Header beginnen.
- Falls Parameter erforderlich sind, müssen sie im Anschluss mit
,angegeben werden. - Wenn ein Parameter einen Wert annimmt, folgt auf den Parameter
=und danach der Wert. - Eine Header-Zeile kann nicht über mehrere Zeilen geschrieben werden.
Datenzeilen¶
Beginnen in der Zeile nach der Header-Zeile und enthalten die erforderlichen Daten.
- Datenzeilen können sich über mehrere Zeilen erstrecken; dies wird durch die für jeden Header definierten Regeln zur Datenbeschreibung bestimmt.
- Datenzeilen sind unter Umständen nicht erforderlich.
Trennzeichen¶
Als Trennzeichen für die Daten wird das Komma , verwendet.
Umgang mit Leerzeichen¶
Leerzeichen werden ignoriert.
Namen¶
Für Namen zulässige Zeichen sind der Unterstrich _, der Bindestrich - sowie alphanumerische Zeichen a-z A-Z 0-9, wobei das erste Zeichen _ oder ein Buchstabe a-z A-Z sein muss.
- Es wird nicht zwischen Groß- und Kleinschreibung unterschieden; intern werden alle Zeichen als Großbuchstaben behandelt.
- Die maximale Länge eines Namens beträgt 63 Zeichen.
Dateinamen¶
Für Dateinamen zulässige Zeichen sind der Unterstrich _, der Bindestrich -, der Punkt ., der Schrägstrich / sowie alphanumerische Zeichen a-z A-Z 0-9.
- Sofern nicht anders angegeben, können Dateinamen einen Pfad enthalten. Es können sowohl relative als auch absolute Pfade angegeben werden.
- Die maximale Länge eines Dateinamens beträgt 1023 Zeichen.
Gleitkommadaten¶
Ein Exponent kann vorhanden sein oder entfallen. Dem Exponenten muss das Symbol E oder e vorangestellt werden. Es kann entweder E oder e verwendet werden.
Hinweis:
Doderdkönnen nicht verwendet werden.
Kommentarzeilen¶
Zeilen, die am Anfang mit !! oder # beginnen, werden als Kommentarzeilen betrachtet und ignoriert.
- Kommentarzeilen können an beliebiger Stelle in der Datei eingefügt werden, ohne Begrenzung ihrer Anzahl.
!END¶
Kennzeichnet das Ende der Daten. Wenn dieser Header erscheint, wird das Einlesen der Daten beendet.