Qucs - Формат схемного файла
Author: Michael Margraf

### - Qucs -
Почти универсальный симулятор цепей

# Формат схемного файла

В этом документе описывается формат схемного файла Qucs. Этот формат используется для схем (обычно с расширением ".sch") и для просмотров данных (обычно с расширением ".dpl"). В следующем тексте приводится краткий пример схемного файла.
`<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>
`
В файле несколько разделов. Все они объясняются ниже. Каждая линия состоит из не более чем одного информационного блока, начинающегося знаком "меньше" ("<") и заканчивающегося знаком "больше" (">").

### Properties

Первый раздел начинается с "<Properties>" и заканчивается "</Properties>". Он содержит свойства документа, находящегося в файле. Каждая строка необязательна. Поддерживаются следующие свойства:

- <View=x1,y1,x2,y2,scale,xpos,ypos> содержит положение в пикселах окна схемы (первые четыре числа), его текущий масштаб и текущее положение верхнего левого угла (два последних числа).
- <Grid=x,y,on> содержит шаг сетки в пикселах (первые два числа) и включена сетка (последнее число = 1) или выключена (последнее число = 0).
- <DataSet=name.dat> содержит имя файла набора данных, связанного с этой схемой.
- <DataDisplay=name.dpl> содержит имя файла со страницей просмотра данных, связанной с этой схемой (или имя схемного файла, если этот документ является просмотром данных).
- <OpenDisplay=yes> содержит 1, если страница показа данных открывается автоматически после моделирования, в противном случае - 0.

### Symbol

Этот раздел начинается с "<Symbol>" и заканчивается "</Symbol>". Он содержит элементы рисования, составляющие схемное обозначение для файла. Это обычно используется только для схемных файлов, которые считаются подсхемой.

### Components

Этот раздел начинается с "<Components>" и заканчивается "</Components>". Он содержит компоненты цепей схемы. Формат строки:
<type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...>

- "type" ("тип") означает компонент, например, "R" для резистора, "C" для конденсатора.
- "name" ("имя") - уникальное обозначение компонента на схеме, например, "R1" для первого резистора.
- "1" в поле "active" ("активный") показывает, что этот компонент активный, то есть используется в моделировании. "0" показывает, что он неактивный.
- Следующие два числа являются x и y координатами центра компонента.
- Следующие два числа являются x и y координатами верхнего левого угла текста компонента. Они отсчитываются от центра компонента.
- Следующие два числа указывают на зеркальное отображение относительно оси x ("1" - зеркальное отображение, "0" - нет зеркального отображения) и вращение против часовой стрелки (кратно 90 градусам, то есть 0...3).
- Следующие параметры являются значениями свойств компонента (в кавычках), за которыми следует 1, если это свойство видимо на схеме (в противном случае 0).

### Wires

Этот раздел начинается с "<Wires>" и заканчивается "</Wires>". Он содержит проводники (электрическое соединение между компонентами цепи), их метки и узлы. Формат строки:
<x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set">

- Первые четыре числа являются координаиами проводника в пикселах: x-координата начальной точки, y-координата начальной точкиt, x-координата конечной точки и y-координата конечной точки. Все проводники должны быть либо горизонтальными (обе x-координаты равны), либо вертикальными (обе y-координаты равны).
- Первая строка в кавычках - имя метки. Она пустая, если пользователь не установил метку на этот проводник.
- Следующие два числа - x- и y-координаты метки или ноль, если метки не существует.
- Следующее число является расстоянием между начальной точкой проводника и точкой, где на проводнике установлена метка.
- Последняя строка в кавычках - параметры цепи проводника, то есть начальное напряжение узла, используемое ядром симулятора для поиска решения. Эта строка пустая, если пользователь не установил параметры узла цепи для этого проводника.

### Diagrams

Этот раздел начинается с "<Diagrams>" и заканчивается "</Diagrams>". Он содержит диаграммы с их графиками и маркерами.
<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">

- Первые два числа - это x- и y-координаты нижнего левого угла.
- Следующие два числа - ширина и высота границ диаграммы.
- Пятое число равно 1, если сетка включена, и 0, если сетка выключена.
- Дальше идет цвет сетки в виде 24-битного шестнадцатиричного RGB значения, например, #FF0000 - красный.
- Следующее число определяет стиль сетки.
- Следующее число определяет, какие оси имеют логарифмический масштаб.

### Paintings

Этот раздел начинается с "<Paintings>" и заканчивается "</Paintings>". Он содержит элементы рисования, которые используются в схеме.
наверх