### - 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" ("тип") означає компонент, наприклад, "R" для резистора, "З" для конденсатора.
- "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-координата початковій точки, 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>". Він містить елементи малювання, які є в схемі.
нагору