### - Qucs -
Simulador de Circuitos Completamente Universal

# Formato dos Arquivos de Diagrama Elétrico

Este documento descreve o formato dos arquivos de diagrama elétrico do Qucs. Este formato é utilizado para diagramas elétricos (normalmente com o sufixo ".sch") e para exibir dados (normalmente com o sufixo ".dpl"). O texto abaixo mostra um exemplo curto de um arquivo de diagrama elétrico.
`<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>
`
O arquivo contém várias seções. Cada uma delas é explicada abaixo. Cada linha consiste em nada mais que um bloco de informação que começa com um sinal de menor "<" e termina com um sinal de maior ">".

### Properties

A primeira seção começa com "<Properties>" e termina com "</Properties>". Ela contém as propriedades de documento do arquivo. Cada uma das linhas é opcional. As seguintes propriedades são suportadas:

- <View=x1,y1,x2,y2,scale,xpos,ypos> contém a posição dos pixels da janela do esquema elétrico nos primeiros quatro números, sua escala atual e a posição atual do canto superior esquerdo (dois últimos números).
- <Grid=x,y,on> contém a distância da grade em pixels (primeiros dois números) e se a grade está ligada (último número 1) ou desligada (último número 0).
- <DataSet=name.dat> contém o nome do arquivo de dados associado com este esquema elétrico.
- <DataDisplay=name.dpl> contém o nome do arquivo de exibição de dados associado com o esquema elétrico (ou nome do arquivo de esquema elétrico se este documento for um arquivos de exibição de dados).
- <OpenDisplay=yes> contém 1 se a página de exibição de dados abrir automaticamente após a simulação, caso contrário contém 0.

### Symbol

Esta seção começa com "<Symbol>" e termina com "</Symbol>". Ela contém os elementos desenhados criando um esquema elétrico simbólico para o arquivo. Isto só é normalmente usado para arquivos de esquemas elétricos que signifiquem estar em subcircuitos.

### Components

Esta seção começa com "<Components>" e termina com "</Components>". Ela contém os componentes do circuito do esquema elétrico. O formato da linha é como se segue:
<type name active x y xtext ytext mirrorX rotate "Value1" visible "Value2" visible ...>

- type identifica o componente, ex. "R" para um resistor, "C" para um capacitor.
- name é o identificador único para o componente do esquema elétrico, ex. "R1" para o primeiro resistor.
- Um "1" no campo active mostra que o componente está ativo, isto é, ele será usado na simulação. Um "0" mostra que está desativado.
- Os próximos dois números são as coordenadas x e y do centro do componente.
- Os próximos dois números são as coordenadas x e y do canto superior esquerdo da componete de texto. Elas são relativas ao centro do componente.
- Os próximos dois números indicam o espelhamento sobre o eixo x ("1" para espelhado, "0" não espelhado) e a rotação no sentido anti-horário (multiplos de 90 graus, ex. 0...3).
- As próximas entradas são os valores das propriedades do componente (entre aspas duplas) seguidos por um 1 se a propriedade estiver visível no esquema elétrico (caso contrário 0).

### Wires

Esta seção começa com "<Wires>" e termina com "</Wires>". Ela contém os fios (conexão elétrica entre os componentes do circuito) e seus rótulos e nós. O formato da linha é como se segue:
<x1 y1 x2 y2 "label" xlabel ylabel dlabel "node set">

- Os primeiros quatro números são as coordenadas do fio em pixels: coordenada x do ponto inícial, coordenada y do ponto inicial, coordenada x do ponto final e coordenada y do ponto final. Todos os fios devem ser horizontais (ambas coordenadas x iguais) ou verticais (ambas coordenadas y iguais).
- A primeira propriedade entre aspas duplas é o rótulo. Ela fica vazia se nenhum rótulo for atribuído a este fio.
- Os próximos dois números são as coordenadas x e y do rótulo ou zero se o rótulo não existir.
- O próximo número é a distância entre o ponto de início do fio e o ponto onde o rótulo for atribuído no fio.
- A última propriedade entre aspas duplas é o nó do fio, ex. a tensão inicial neste nó usada pela simulador para encontrar a solução. Este fica vazio se o usuário não definir um nó para este fio.

### Diagrams

Esta seção começa com "<Diagrams>" e termina com "</Diagrams>". Ela contém os diagramas com seus gráficos e seus marcadores.
<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">

- Os primeiros dois números são as coordenadas x e y do canto esquerdo inferior.
- Os dois números seguintes são a largura e altura de limitação do diagrama.
- O quinto número é 1 se a grade estiver ligada e 0 se estiver desligada.
- O próximo é a cor da grade em valor RGB hexadecimal de 24 bits, ex. #FF0000 é vermelho.
- O próximo número determina o estilo da grade.
- O próximo número determina quais eixos tem escala locarítmica.

### Paintings

Esta seção começa com "<Paintings>" e termina com "</Paintings>". Ela contém as pinturas que estão dentro do esquema elétrico.
voltar ao topo