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. Um0
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ário0
).
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.