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

У документі описується формат схемного файлу 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>". Він містить елементи малювання, які є в схемі.