- 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