SUD Language


The SUD language (Set-Up Description) is used to describe systems with multiple inputs and multiple outputs connected by sequences of operative blocks. It is used in the DAGA2 System to describe the electronic chains for the acquisition channels, the software connections between the acquisition channels and the archived channels and the structure of the software channels in the DAGA_MONITOR and LEGGI programs.

A SUD file is a text file with special structure.

- meaningful lines begins with # and ends at a ! or at 132-th column the others are not considered

#INPUT  3 | 20      ! begins the definition of the inputs, with the first
                  ! number indicating the length of the symbol associated to
                  ! an input and the length of the string describing the channel

#   1 | GWA | antenna gravitazionale
#   2 | SIS | sismometro

- the " | " is used to separate the channel number, the symbol and the string; it is in general used as a separator

#INTERMEDIATE     ! begins the definition of intermediate points derived
                  ! directly from the inputs or from previous defined
                  ! intermediate points. The intermediate points are
                  ! numbered in the same sequence of the inputs

#DESCRIBE 11      ! begins the definition of the intermediate point 11

#1 > 1         ! input channel 1
#2 > FET84 
#3 > A113 | A=1000 | FMIN=300 | FMAX=3000
#4 > A189 | A=10 | F=830 | Q=20

#DESCRIBE 12

#1 > SINT | F=829.321

#DESCRIBE 13

#1 > 11
#2 > 12
#3 > LOCKIN | A=10 



#OUTPUT 2 | 20      ! begins the definition of the outputs

#DESCRIBE 1 | DA  | Direct Acquisition

#1 > 11

#DESCRIBE 2 | x | x of the lock-in

#1 > 13
#2 > OUT | 1   ! the OUT operator is "inner" (not defined by the dictionary)
               ! and is used in cases of blocks with more than one output

#DESCRIBE 3 | y | y of the lock-in

#1 > 13
#2 > OUT | 2

#DESCRIBE 4 | SIS  | sysmic detector

#1 > 2
#2 > A113 | A=1000 | FMIN=100 | FMAX=3000

#END   ! last statement: not necessary

Note that a SUD file contains 4 blocks:

- the DICTIONARY

- the INPUT

- the INTERMEDIATE

- the OUTPUT

The Dictionary file is, as an example,

# FET84 | 0 | FET amplifier 1984/4

# A113 | 3 | A | FMIN | FMAX | 113 low noise amplifier |     !   the symbol
       A113 has 3 parameters A , FMIN and FMAX, and is defined by the string
       "113 low noise amplifier"

# A189 | 3 | A | F | Q | 189 tuned amplifier

# LOCKIN | 2 | A | @PHASE | Lock-in amplifier ! parameters beginning with @
                 are strings, the others are real numbers

# SINT | 1 | F | Frequency Synthesizer

#END

The utilities that will be used by the SUD language are:

- a DEBUGGER that checks the consistency of the scheme

- an INTERPRETER that stores the SUD informations for a FORTRAN program

- an EDITOR that simplifies writing the SUD and Dictionary files

_ a GRAPHICAL INTERPRETER that draws the block diagram on a graphical terminal

A SUD file describing the electronic acquisition chains will be stored as a parameter record at the beginning of a DAGA run.