Qucs - Popis k formátu souborů
Author: Martin Stejskal

### - Qucs -
Quite Universal Circuit Simulator

# Popis k formátu souborů

Tento dokument popisuje formát souborů. Tento formát je používán pro schémata (obvykle s příponou ".sch") a pro soubory, které zobrazují výstupní data (obvykle s příponou ".dpl"). Následující text názorně ukazuje příklad souboru se sechématem.
`<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>
`
Každý řádek obsahuje mnoho sekcí. Každá je vysvětlena níže. Každá řádka neobsahuje více jak jeden blok informací které začínají znakem "<" a končí znakem ">".

### Vlastnosti (Properties)

První část začíná s "<Properties>" a končí "</Properties>". Tento blok obsahuje vlastnosti souboru dokumentu. Každá řádka je volitelná (neí třeba vše definovat). Následující vlastnosti jsou podoprovány:

- <View=x1,y1,x2,y2,scale,xpos,ypos> první čtyři čísla udávají pozici okna se shématem. Je to současná velikost tohoto okna a pozice levého horního rohu (poslední dvě čísla).
- <Grid=x,y,on> udává rozestup v mřížce v pixelech (první dvě čísla) a jestli je zapnut (poslední číslo je 1), nebo vypnut (poslední číslo je 0).
- <DataSet=name.dat> Do tohoto souboru se ukládají výsledky ze simulace.
- <DataDisplay=name.dpl> Do tohoto souboru se ukládají další informace o simulaci.
- <OpenDisplay=yes> obsahuje 1 pokud se stránka "DataDisplay" má automaticky otevří po simulaci. V opačném případě obsahuje 0.

### Symbol

Začíná znaky "<Symbol>" a končí "</Symbol>". Obsahuje grafické součásti, které tvoří schématický symbor pro soubor. Toto je často používáno pro soubory schémat, které bývají později použity jako vnořené obvody.

### Components (Komponenty)

Začíná znaky "<Components>" a končí "</Components>". Obsahuje komponenty obvodů ve schématech. Formát je následující:
<type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...>

- "type" - identifikuje komponenty. Např.: "R" jako rezistor, "C" jako kapacitu.
- "name" - toto je zcela jedinečný identifikátor ve schématu. Např.: "R1" pro první rezistor.
- "active" - pokud je zde "1", znamená to, že komponenta je aktivní. Například je použita v simulaci. Pokud je zde "0", je neaktivní.
- "x y" - Tyto dvě čísla určují, polohu komponenty (resp. kde se bude nacházet její střed).
- "xtext ytext" - Tato čísla určují polohu textu, který slouží jako popisek pro určitou komponentu (resp. určuje, kde se bude nacházet horní levý roh popisku). Tyto údaje udávají vzdálenost od středu komponenty.
- "mirrorX rotate" - Následující dvě čísla definují zrcadlení podle osy x ("1" pro zrcadlení, "0" nezrcadlí se) a rotaci ve stupních (proti směru hodinových ručiček).
- ""Value1" visible" - Zde se udává hodnota komponenty (v uvozovkách) . Pokud je za ní "1", pak bude ve schématu zobrazena. Pokud bude hodnota "0", pak nebude ve schématu zobrazena.

### Vedení

Začíná "<Wires>" a končí "</Wires>". Obsahuje informace o vedení, které spojuje jednotlivé komponenty (co spojuje, název, atd.). Formát je následující:
<x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set">

- "x1 y1 x2 y2" - Tyto čtyři čísla určují počátek (x1, y1) a konec (x2, x2) vodiče. Veškeré vodiče musí být ve vodorovné, nebo horizontální poloze (tzn. že budou obě xové, nebo obě ypsylonové souřadnice stejné).
- ""label"" - Tato proměnná nastavuje popisek. Pokud je prázdná, znamená to, že vodiči nedal uživatel žádný název.
- "xlabel ylabel" - Další dvě čísla jsou xové a ypsylonové souřadnice popisku. Pokud jsou zde nuly, znamená to, že popisek neexistuje.
- "dlabel" - Číslo určuje vzdálenost mezi počátečním bodem vodiče a popiskou vodiče.
- ""node set"" - Text v uvozovkách udává jméno uzlu vodiče. Např.: počáteční napětí na tomto uzlu je právě jméno uzlu tohoto vodiče, pak se engine pokusí najít řešení. Pokud je tato položka prázdná, znamená to, že uživatel nenastavil jméno uzlu pro daný vodič.

### Diagramy

Začíná "<Diagrams>" a končí "</Diagrams>". Obsahuje diagramy s jejich grafy a značkami.
<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" - Tyto čísla určují pozici spodního levého rohu.
- "width height" - Následující čísla udávají šířku a výšku diagramu.
- "grid" - Pokud je zde 1, pak bude zobrazena mřížka. Pokud zde bude 0, pak mřížka nebude zobrazena.
- "gridcolor" - Zde je udána 24. bitová barva v hexadecimální RGB hodnotě. Např.: #FF0000 je červená.
- "gridstyle" - Určuje styl mřížky.
- Zbylá čísla určují jak "osekáme" logaritmickou stupnici.

### Obrazce

Začíná znaky "<Paintings>" a končí "</Paintings>". Obsahuje obrazce, které jsou ve schématu.
Nahoru