
1 Language
                        PDBI\ Language summary

    LINE                : define receiver setup
    NARROW_INPUT        : define the input of the narrow‐band correlator
    SPECTRAL            : define the configuration of the spectral units of
                          the narrow‐band correlator
    PLOT                : plot the resulting frequency coverage
    PRINT               : print the corresponding observing procedure


1 LINE

    [PDBI\]LINE Name Frequency Band [Lock [Center [Harm]]]

    Plot rest frequency coverage of the Plateau de Bure Interferometer (with
    the receivers installed in winter 2006/2007).   The  command  syntax  is
    identical to that of the corresponding command in OBS:
        Name      is a line name to label the plot
        Frequency is the rest frequency in GHz
        Band      should be USB or LSB
        Lock      is LOW or HIGH [optional, default LOW]
        Center    is the IF1 frequency in MHz [optional, default 6500]
        Harm      is the harmonic number [optional]

    o  The receiver band to be used (1 to 4) will be determined by the soft‐
    ware.

    o  As compared to the ’old’ receivers, the center frequency is no longer
    expressed  in  the second IF (100‐680 MHz), but directly in the first IF
    (4‐8 GHz = 4000‐8000 MHz)). WARNING: it is  highly  not  recommended  to
    center  the  line  frequency  at  6  GHz. This is because the correlator
    analyses quarters of the 4 GHz bandwidths, and 6 GHz is  very  precisely
    at the limit between two such adjacents quarters.

    o  The plot displays the four "quarters" Q1...Q4 that can be selected as
    input for the correlator (see NARROW_INPUT command):
      Q1 = 4.2‐5.2 GHz, Q2 = 5.0‐6.0 GHz
      Q3 = 6.0‐7.0 GHz, Q4 = 6.8‐7.8 GHz

    o Commands NARROW and SPECTRAL are available to setup the  IF  processor
    and  the  spectral  units  of the narrow‐band correlator (see the corre‐
    sponding help). A typical ASTRO session would look like:

    line toto 100 usb           ! choice of rx tuning
    narrow q1 q3                ! choice of the correlator windows
    spectral 1  20 320 /nar 1   ! correlator unit 1
    spectral 2 320 200 /nar 2   ! correlator unit 2
    spectral 2 320 210 /nar 2   ! new def. of unit 2 ‐‐> plot is updated

    o LINE can also be used to produce plots of the  frequency  coverage  of
    the old receivers (replaced in 2006/2007). The command SET PDBI year al‐
    lows one to select the instrument as of the selected year:
    ‐ 1995: 3 and 1.3 mm receivers, 500 MHz bandwidth
    ‐ 2000: 3 and 1.3 mm receivers, 580 MHz bandwidth
    ‐ 2006: new generation receivers (4 GHz bandwidth, 2 polar.) [default]
    For the OLD receivers (years 1995 & 2000), the  commands  NARROW,  SPEC‐
    TRAL,  PLOT are not active. Please enter HELP LINE OLD for a description
    of the behaviour of the LINE command in that case.

2 OLD

        [ASTRO\]LINE Name Frequency Band [Lock [Center [Harm]]]  [/MOLECULES
    File] [/SPECTRAL Unit Bandwidth IF_2] /WIDTH width
        [ASTRO\]LINE /SPECTRAL Unit Bandwidth IF_2
        [ASTRO\]LINE /AUTO

    Plot rest frequency coverage of Plateau de Bure Interferometer using the
    OLD receiver system (replaced in  2006/2007).   The  command  syntax  is
    identical to that of the corresponding command in OBS.
        Name is a line name to label the plot
        Frequency is the center frequency in GHz
        Band should be USB or LSB
        Lock (optional) is LOW or HIGH
        Center (optional), the center IF2 frequency in MHz, default 350.
        Harm (optional), the harmonic number.
    The  option  /MOLECULES  enables to plot the rest frequencies of several
    transitions, found in file File. This is a text file with entries:
        Freq    ’chain’
        where Freq is the rest frequency in GHz and ’chain’ the line name to
        be plotted by GreG, between single quotes. Example:
        88.632  ’HCN’
        89.081  ’HCO\u+’
    The  option  /WIDTH  width is used to introduce a finite width (in km/s)
    for the molecular lines displayed.

    The option /SPECTRAL is used to overlay the desired spectral  correlator
    configuration.
        Unit is the correlator unit number (1 to 8)
        Bandwidth is the bandwidth in MHz (20, 40, 80 or 160)
        IF_2  is  the center frequency (in MHz) of the unit in the second IF
        (in the range 110 to 590 MHz).

    With only the /SPECTRAL option, the corresponding unit overlay  will  be
    drawn on an existing LINE plot.

    Because  only  one  synthesizer is used to generate the 1st and 2nd LOs,
    the IF frequency is slightly variable (between 1.500 and 1.550 GHz), and
    the  Doppler  tracking  is  correct  only for the specified band (USB or
    LSB).  The last specified source is used to get the Doppler shift.   The
    image  frequency doppler shift is wrong by at most 2.Ers/Harm, where Ers
    is the Earth rotation speed, or about 0.9 km/s, roughly 0.04 km/s at  86
    GHz.

    THe option /AUTO is used to guess the line frequencies and spectral set‐
    up for Bure, given a set of variables:
    N_LINE     int  number of line frequencies
    N_CONT     int  number of continuum frequencies
    for each of N_LINE:
    LINENAME_i char line name of line table
    LINEVELO_i char velocity range (2 values: min, max  in km/s)
    LINEFREQ_i dble line frequency (MHz)
    LINEVRES_i dble velocity resolution (km/s)
    for each of N_CONT:
    CONTTABLE_i char  name of continuum  table
    CONTBANDS_i char  range of frequency bands for the continuum
                      (min1 max1 min2 max2 ...)
    Output is also in a set of variables, used by setup writing  procedures.
    look into LINE_* and SPEC_* variables.

1 NARROW_INPUT

    [PDBI\]NARROW_INPUT Q1|Q2|Q3|Q4 Q1|Q2|Q3|Q4

    Select  the two entries of the PdBI narrow‐band correlator. The new gen‐
    eration receivers have 4 GHz bandwidth  (for  each  polarization),  from
    IF=4  GHz  to IF=8 GHz. The future broad‐band correlator will be able to
    analyse the whole bandwidth. The narrow‐band correlator can process only
    two 1 GHz wide bands.

    The receiver 4 GHz bandwidth is split into four "quarters":
             Q1 = 4.2‐5.2 GHz    Q2 = 5.0‐6.0 GHz
             Q3 = 6.0‐7.0 GHz    Q4 = 6.8‐7.8 GHz
    and  two  of them must be selected as inputs to the narrow‐band correla‐
    tor. Any combination is possible. The polarization that is selected  de‐
    pends on the selected quarter:
      ‐ the correlator input 1 can only be Q1 HOR, Q2 HOR, Q3 VER, Q4 VER
      ‐ the correlator input 2 can only be Q1 VER, Q2 VER, Q3 HOR, Q4 HOR

    Example: NARROW_INPUT Q1 Q2 selects Q1 HOR as first input, and Q2 VER as
    second input. Simultaneous measurements of the two HOR and VER polariza‐
    tions is obtained with e.g. NARROW_INPUT Q1 Q1.

1 PLOT

    [PDBI\]PLOT [DSB|NARROW]
             [/LIMITS min max]
             [/MOLECULES FileName [Mol1 Mol2 ... Moln]]
             [/WIDTH width]
             [/SPURIOUS [NO]]

    Change  the  frequency  coverage plot parameters and update the plot ac‐
    cordingly. Two types of plot can be produced:

    o  DSB mode = plot of the LSB and USB (as done by the  "old"  LINE  com‐
    mand).  Note  however that the new generation receivers at PdBI are sin‐
    gle‐side band: the image sideband appears in light grey.

    o  NARROW mode = SSB plot of the two selected entries of the narrow‐band
    correlator. This plot is aimed at zooming on the two 1 GHz inputs of the
    correlator, as selected by the NARROW_INPUT command.

    After each of the NGR_LINE, NARROW_BAND, SPECTRAL commands, the plot  is
    updated. Default mode is DSB after the LINE command, and NARROW mode af‐
    ter the NARROW_INPUT command.

    PLOT /LIMITS min max (in MHz) selects the IF range to be plotted (in the
    DSB mode only). This is to zoom on a specific part of the 4 GHz receiver
    bandwidth.

    PLOT /MOLECULES FileName [Mol1 Mol2 ... Moln] enables to plot  the  rest
    frequencies  of  several transitions, found in file FileName. Default is
    to use the molecule.dat file, disctributed with ASTRO. These  file  must
    be a text file with entries:
        Freq   ’chain’
        where Freq is the rest frequency in GHz and ’chain’ the line name to
        be plotted by GreG, between single quotes. Example:
        88.632  ’HCN’
        89.081  ’HCO\u+’

    PLOT /WIDTH width is used to introduce a finite width (in km/s) for  the
    molecular lines displayed.

    PLOT /SPURIOUS plots the location of possible spurious lines, at 3 and 4
    times the LO1REF frequency. Mostly for  the  PdBI  scientific  operation
    group.


1 PRINT

    [PDBI\]PRINT [filename]

    Write  in  an  output  file (default is setup.obs) the OBS command lines
    that correspond to the receiver and backend  tuning  selected  with  the
    LINE,  NARROW, and SPECTRAL commands. This file can directly be included
    in the observing procedure (‘‘setup’’ file) to be run at the Plateau  de
    Bure.  It can also be executed in ASTRO to (re)produce the the frequency
    coverage plot.

    Example of output:
      !
      ! Plateau de Bure receiver and backend setup
      ! Written by ASTRO command PRINT on 11‐FEB‐2008
      !
      ! ‐‐‐‐‐ Receiver ‐‐‐‐‐
      !
      LET RECEIVER 1
      LINE test  100.000000 LSB  LOW  6500.00  57 /RECEIVER 1
      !
      ! ‐‐‐‐‐ IF processor ‐‐‐‐‐
      ! Selected quarters are Q3 VER and Q4 HOR
      !
      NARROW Q3 Q4 /RECEIVER 1
      !
      ! ‐‐‐‐‐ Narrow‐band correlator ‐‐‐‐‐
      !
      SPECTRAL 1  80  550.00 /NARROW 1 /BAND LSB /RECEIVER 1
      SPECTRAL 2 320  360.00 /NARROW 1 /BAND DSB /RECEIVER 1
      SPECTRAL 3 320  740.00 /NARROW 1 /BAND DSB /RECEIVER 1
      SPECTRAL 4  80  350.00 /NARROW 2 /BAND LSB /RECEIVER 1
      SPECTRAL 5  20  793.00 /NARROW 2 /BAND LSB /RECEIVER 1
      SPECTRAL 6  20  700.00 /NARROW 2 /BAND LSB /RECEIVER 1
      SPECTRAL 7 320  540.00 /NARROW 2 /BAND DSB /RECEIVER 1
      SPECTRAL 8 320  830.00 /NARROW 2 /BAND DSB /RECEIVER 1

1 SPECTRAL

    [PDBI\]SPECTRAL iunit bandwidth fcent /NARROW 1|2 [/BAND LSB|USB|DSB]

    Select the width and position of each spectral unit of  the  narrow‐band
    correlator.
      ‐ ’iunit’ is the correlator unit number (1 to 8)
      ‐ ’bandwidth’ is the bandwidth in MHz (20, 40, 80, 160, or 320)
      ‐ ’fcent’ is the center frequency (in MHz) of the unit in the
         second IF (in the range 100 to 1100 MHz).
    The  option  /NARROW  is mandatory, and is used to select which entry of
    the correlator the unit is connected to. The  SPECTRAL  command  updates
    the  current plot by drawing the position and width of the selected cor‐
    relator unit. The list of the current correlator  setup,  including  the
    number of channels and resolution, is printed out.

    CAUTION:  as  compared to the "old" LINE /SPECTRAL command, the central;
    frequency is now in the range 100‐1100 MHz, which correspond  to  the  1
    GHz wide band seen as input by the correlator. Depending on the selected
    correlator input (/NARROW option, NARROW_INPUT command), this  frequency
    range  may  correspond to different sky frequency. Please check the plot
    produced by the command.

    Option /BAND LSB|USB|DSB can be used to define the  processing  mode  of
    the  selected  correlator unit. There is no practical difference between
    LSB and USB tunings. The DSB mode provides twice as many  channels  than
    the  LSB  or  USB modes for the same bandwidth, but the central channels
    suffer from the Gibbs effect. This mode is therefore not  optimized  for
    spectroscopic  studies.  Choosing between an SSB or DSB mode is possible
    only if a bandwidth of 160 or 80 MHz has been selected (320 MHz is  only
    available  in  DSB  mode; 40 and 20 MHz are only available in SSB).  De‐
    fault is DSB for 320 MHz wide units, LSB for the other bandwidth.

    The /BAND option has no consequences on the plot produced by ASTRO,  but
    affects  the  printout (number of channels and resolution) and the setup
    file produced by the PRINT command.


1 ENDOFHELP

































































