Qucs - Dateiformat der Schaltpläne
Author: Stefan Jahn

### - Qucs -
Ziemlich Universeller Schaltungssimulator

# Dateiformat der Schaltpläne

Dieses Dokument beschreibt kurz das Dateiformat der Schaltpläne von Qucs. Das Format wird für Schaltpläne (normalerweise mit der Dateiendung ".sch") und für Datenvisualisierungen (normalerweise mit der Dateiendung ".dpl") verwendet. Der folgende Text zeigt ein kurzes Beispiel für eine solche Datei.
`<Qucs Schematic 0.0.6>
<Properties>
<View=0,0,800,800,1,0,0>
</Properties>
<Symbol>
<.ID -20 14 SUB>
</Symbol>
<Components>
<R R1 1 180 150 15 -26 0 1 "50 Ohm" 1 "26.85" 0 "european" 0>
<GND * 1 180 180 0 0 0 0>
</Components>
<Wires>
<180 100 180 120 "" 0 0 0 "">
<120 100 180 100 "Input" 170 70 21 "">
</Wires>
<Diagrams>
<Polar 300 250 200 200 1 #c0c0c0 1 00 1 0 1 1 1 0 5 15 1 0 1 1 315 0 225 "" "" "">
<"acnoise2:S[2,1]" #0000ff 0 3 0 0 0>
<Mkr 6e+09 118 -195 3 0 0>
</Polar>
</Diagrams>
<Paintings>
<Arrow 210 320 50 -100 20 8 #000000 0 1>
</Paintings>
`
Die Datei beinhaltet mehrere Abschnitte. Jeder dieser Abschnitte wird nachfolgend erklärt. Jede Zeile besteht aus einem einzigen Informationsblock, der mit dem Kleiner-Zeichen "<" beginnt und mit dem Größer-Zeichen ">" endet.

### Eigenschaften

Der erste Abschnitt beginnt mit "<Properties>" und endet mit "</Properties>". Er beinhaltet die Dokumenteneigenschaften der Datei. Jede dieser Zeilen ist optional. Die folgenden Eigenschaften werden unterstützt.

- <View=x1,y1,x2,y2,scale,xpos,ypos> beinhaltet die Pixelposition des Schaltplanfensters in den ersten vier Zahlen, die aktuelle Skalierung und die aktuelle Position der linken oberen Ecke (die letzten beiden Zahlen).
- <Grid=x,y,on> beinhaltet den Gitternetzabstand in Pixeln (die ersten beiden Zahlen) und ob das Gitternetz sichtbar ist (letzte Zahl 1) oder nicht (letzte Zahl 0).
- <DataSet=name.dat> beinhaltet den Dateinamen des Datensatzes, der mit diesem Schaltplan assoziiert wird.
- <DataDisplay=name.dpl> beinhaltet den Dateinamen der Datenvisualisierung, die mit diesem Schaltplan assoziiert wird (bzw. den Dateinamen des Schaltplan, falls das Dokument eine Dateinvisualisierung ist).
- <OpenDisplay=yes> beinhaltet eine 1, falls die Datenvisualisierung automatisch nach der Simulation angezeigt werden soll, anderenfalls eine 0.

### Symbol

Dieser Abschnitt beginnt mit "<Symbol>" und endet mit "</Symbol>". Er beinhaltet die Zeichnungselemente, die das Schaltplansymbol dieser Datei bilden. Das wird normalerweise nur bei Schaltplänen verwendet, die eine Unterschaltung darstellen.

### Komponenten

Dieser Abschnitt beginnt mit "<Components>" und endet mit "</Components>". Er beinhaltet die Schaltkreiskomponenten des Schaltplans. Das Zeilenformat ist wie folgt aufgebaut:
<type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...>

- Der type identifiziert die Komponente, z.B. steht "R" für einen Widerstand und "C" für einen Kondensator.
- Der name ist der Komponentenidentifizierer in dem Schaltplan, z.B. steht "R1" für den ersten Widerstand.
- Eine "1" in dem active Feld zeigt an, dass die Komponenten aktiv ist, d.h. dass sie während der Simulation verwendet wird. Eine "0" zeigt an, dass die Komponente nicht aktiv ist.
- Die nächsten beiden Zahlen sind die x- und y-Koordinaten des Komponentenzentrums.
- Die folgenden beiden Zahlen sind die x- und y-Koordinaten der linken oberen Ecke des Komponententextes. Sie sind relativ zum Komponentenzentrum.
- Die nächsten beiden Zahlen zeigen an, ob die Komponente an der x-Achse gespiegelt ist ("1" für gespiegelt, "0" für nicht gespiegelt) ist und ob die Komponente entgegen des Uhrzeigersinns gedreht ist (Vielfache von 90 Grad, d.h. 0...3).
- Die nächsten beiden Einträge sind die Werte der Komponenteneigenschaften (in Anführungszeichen) gefolgt von einer 1, falls die Eigenschaft in dem Schaltplan angezeigt wird (ansonsten eine 0).

### Verbindungen

Der Abschnitt beginnt mit "<Wires>" und endet mit "</Wires>". Er beinhaltet die Drähte (elektrische Verbindungen zwischen den Schlatkreiskomponenten) und ihre Bezeichnungen bzw. zusätzlichen Eigenschaften. Das Zeilenformat sieht wie folgt aus:
<x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set">

- Die ersten vier Zahlen sind die Koordinaten des Drahtes in Pixel: x-Koordinate des Startpunktes, y-Koordinate des Startpunktes, x-Koordinate des Endpunktes und y-Koordinate des Endpunktes. Alle Drähte müssen entweder horizontal (beide x-Koordinaten gleich) oder vertikal (beide y-Koordinaten gleich) sein.
- Die erste Zeichenkette in Anführungszeichen ist der Name des Bezeichners. Er ist leer, wenn der Benutzer keine Drahtbezeichnung eingegeben hat.
- Die nächsten beiden Zahlen sind die x- und y-Koordinaten der Bezeichnung oder Null, falls es keine Bezeichnung gibt.
- Die folgenden beiden Zahlen sind der Abstand zwischen dem Startpunkt des Drahtes und dem Punkt, an dem der Bezeichner des Drahtes angezeigt werden soll.
- Die letzte Zeichenkette in Anführungszeichen ist der Anfangswert für die Knotenspannung an diesem Draht. Sie ist leer, falls der Benutzer keine Knotenspannung für diesen Draht angegeben hat..

### Diagramme

Der Abschnitt beginnt mit "<Diagrams>" und endet mit "</Diagrams>". Er beinhaltet die Diagramme mit ihren Kurven und Markierungen.
<x y width height grid gridcolor gridstyle log xAutoscale xmin xstep xmax yAutoscale ymin ystep ymax zAutoscale zmin zstep zmax xrotate yrotate zrotate "xlabel" "ylabel" "zlabel">

- Die ersten beiden Zahlen sind die x-und y-Koordinaten der linken unteren Ecke.
- Die nächsten beiden Zahlen sind die Breite und Höhe der Diagrammgrenzen.
- Die fünfte Zahl ist 1 falls das Gitternetz angezeigt werden soll und 0 falls nicht.
- Das nächste ist die Farbe des Gitternetzes als hexadezimaler 24-Bit RGB-Wert, z.B. ist #FF0000 rot.
- Die nächste Zahl legt den Stil des Gitternetzes fest.
- Die nächste Zahl legt fest, welche Achsen eine logarithmische Einteilung haben.

### Zeichnungen

Der Abschnitt beginnt mit "<Paintings>" und endet mit "</Paintings>". Er beinhaltet die Zeichnungselemente, die sich in dem Schaltplan befinden.
zurück nach oben