mirror of
https://github.com/ra3xdh/qucs_s
synced 2025-03-28 21:13:26 +00:00
202 lines
7.7 KiB
HTML
202 lines
7.7 KiB
HTML
<html>
|
|
|
|
<head>
|
|
<meta http-equiv=Content-Type content="text/html; charset=iso-8859-1">
|
|
<meta name="Author" content="Stefan Jahn">
|
|
<title>Qucs - Dateiformat der Schaltpläne</title>
|
|
</head>
|
|
|
|
|
|
|
|
<body>
|
|
<a name="top" id="top"></a>
|
|
|
|
<center><h3>
|
|
- Qucs -<br>
|
|
Ziemlich Universeller Schaltungssimulator<br>
|
|
</h3>
|
|
<h1>
|
|
Dateiformat der Schaltpläne<br><br>
|
|
</h1></center>
|
|
|
|
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.
|
|
<br><br>
|
|
|
|
<tt><small>
|
|
<Qucs Schematic 0.0.6> <br>
|
|
<Properties> <br>
|
|
<View=0,0,800,800,1,0,0> <br>
|
|
</Properties> <br>
|
|
<Symbol> <br>
|
|
<.ID -20 14 SUB> <br>
|
|
</Symbol> <br>
|
|
<Components> <br>
|
|
<R R1 1 180 150 15 -26 0 1 "50 Ohm" 1 "26.85" 0 "european" 0> <br>
|
|
<GND * 1 180 180 0 0 0 0> <br>
|
|
</Components> <br>
|
|
<Wires> <br>
|
|
<180 100 180 120 "" 0 0 0 ""> <br>
|
|
<120 100 180 100 "Input" 170 70 21 ""> <br>
|
|
</Wires> <br>
|
|
<Diagrams> <br>
|
|
<Polar 300 250 200 200 1 #c0c0c0 1 00 1 0 1 1 1 0 5 15 1 0 1 1 315 0 225 "" "" ""> <br>
|
|
<"acnoise2:S[2,1]" #0000ff 0 3 0 0 0> <br>
|
|
<Mkr 6e+09 118 -195 3 0 0> <br>
|
|
</Polar> <br>
|
|
</Diagrams> <br>
|
|
<Paintings> <br>
|
|
<Arrow 210 320 50 -100 20 8 #000000 0 1> <br>
|
|
</Paintings> <br>
|
|
</small></tt>
|
|
<br><br>
|
|
|
|
Die Datei beinhaltet mehrere Abschnitte. Jeder dieser Abschnitte wird
|
|
folgend erklärt. Jede Zeile besteht aus einem einzigen
|
|
Informationsblock, der mit dem Kleiner-Zeichen "<" beginnt und
|
|
mit dem Größer-Zeichen ">" endet.
|
|
|
|
<br>
|
|
<h3>Eigenschaften</h3>
|
|
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.
|
|
<br>
|
|
<ul>
|
|
<li><em><View=x1,y1,x2,y2,scale,xpos,ypos></em> 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).
|
|
</li>
|
|
<li><em><Grid=x,y,on></em> beinhaltet den Gitternetzabstand in
|
|
Pixeln (die ersten beiden Zahlen) und ob das Gitternetz sichtbar ist
|
|
(letzte Zahl 1) oder nicht (letzte Zahl 0).
|
|
</li>
|
|
<li><em><DataSet=name.dat></em> beinhaltet den Dateinamen
|
|
des Datensatzes, der mit diesem Schaltplan assoziiert wird.
|
|
</li>
|
|
<li><em><DataDisplay=name.dpl></em> beinhaltet den Dateinamen
|
|
der Datenvisualisierung, die mit diesem Schaltplan assoziiert wird (bzw.
|
|
den Dateinamen des Schaltplan, falls das Dokument eine Dateinvisualisierung
|
|
ist).
|
|
</li>
|
|
<li><em><OpenDisplay=yes></em> beinhaltet eine 1, falls die
|
|
Datenvisualisierung automatisch nach der Simulation angezeigt werden
|
|
soll, anderenfalls eine 0.
|
|
</li>
|
|
</ul>
|
|
|
|
<br>
|
|
<h3>Symbol</h3>
|
|
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.
|
|
|
|
<br>
|
|
<h3>Komponenten</h3>
|
|
Dieser Abschnitt beginnt mit "<Components>" und endet mit
|
|
"</Components>". Er beinhaltet die Schaltkreiskomponenten des
|
|
Schaltplans. Das Zeilenformat ist wie folgt aufgebaut:
|
|
<br>
|
|
<em><type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...></em>
|
|
<br>
|
|
<ul>
|
|
<li>Der <em>type</em> identifiziert die Komponente, z.B. steht "R" für
|
|
einen Widerstand und "C" für einen Kondensator.
|
|
</li>
|
|
<li>Der <em>name</em> ist der Komponentenidentifizierer in dem Schaltplan,
|
|
z.B. steht "R1" für den ersten Widerstand.
|
|
</li>
|
|
<li>Eine "1" in dem <em>active</em> 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.
|
|
</li>
|
|
<li>Die nächsten beiden Zahlen sind die x- und y-Koordinaten des
|
|
Komponentenzentrums.
|
|
</li>
|
|
<li>Die folgenden beiden Zahlen sind die x- und y-Koordinaten der linken
|
|
oberen Ecke des Komponententextes. Sie sind relativ zum Komponentenzentrum.
|
|
</li>
|
|
<li>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).
|
|
</li>
|
|
<li>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).
|
|
</li>
|
|
</ul>
|
|
|
|
<br>
|
|
<h3>Verbindungen</h3>
|
|
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:
|
|
<br>
|
|
<em><x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set"></em>
|
|
<br>
|
|
<ul>
|
|
<li>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.
|
|
</li>
|
|
<li>Die erste Zeichenkette in Anführungszeichen ist der Name des
|
|
Bezeichners. Er ist leer, wenn der Benutzer keine Drahtbezeichnung
|
|
eingegeben hat.
|
|
</li>
|
|
<li>Die nächsten beiden Zahlen sind die x- und y-Koordinaten der Bezeichnung
|
|
oder Null, falls es keine Bezeichnung gibt.
|
|
</li>
|
|
<li>Die folgenden beiden Zahlen sind der Abstand zwischen dem Startpunkt des
|
|
Drahtes und dem Punkt, an dem der Bezeichner des Drahtes angezeigt werden
|
|
soll.
|
|
</li>
|
|
<li>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..
|
|
</li>
|
|
</ul>
|
|
|
|
<br>
|
|
<h3>Diagramme</h3>
|
|
Der Abschnitt beginnt mit "<Diagrams>" und endet mit
|
|
"</Diagrams>". Er beinhaltet die Diagramme mit ihren Kurven und
|
|
Markierungen.
|
|
<br>
|
|
<em><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"></em>
|
|
<br>
|
|
<ul>
|
|
<li>Die ersten beiden Zahlen sind die x-und y-Koordinaten der linken
|
|
unteren Ecke.</li>
|
|
<li>Die nächsten beiden Zahlen sind die Breite und Höhe der
|
|
Diagrammgrenzen.</li>
|
|
<li>Die fünfte Zahl ist 1 falls das Gitternetz angezeigt werden soll und 0
|
|
falls nicht.</li>
|
|
<li>Das nächste ist die Farbe des Gitternetzes als hexadezimaler 24-Bit
|
|
RGB-Wert, z.B. ist #FF0000 rot.</li>
|
|
<li>Die nächste Zahl legt den Stil des Gitternetzes fest.</li>
|
|
<li>Die nächste Zahl legt fest, welche Achsen eine logarithmische Einteilung
|
|
haben.</li>
|
|
</ul>
|
|
|
|
<br>
|
|
<h3>Zeichnungen</h3>
|
|
Der Abschnitt beginnt mit "<Paintings>" und endet mit
|
|
"</Paintings>". Er beinhaltet die Zeichnungselemente, die sich
|
|
in dem Schaltplan befinden.
|
|
|
|
<br><br><a href="#top">zurück nach oben</a><br>
|
|
</body>
|
|
</html>
|