https:///weradocs/Plott_WERA_USort_RCs.shtml Last update:

WERA HF Radar Software - Visualize permanent Measurements (Antennas)

Plott_WERA_USort_RCs

Call: Plott_WERA_USort_RCs <measurement_file>.USORT [params*.cfg]

A second optional parameter can be used to pass the name of a configuration file. This file must be located in ~/etc e.g. ~/etc/params_oms.cfg . If no optional parameter is supplied, the configuration is read from ~/etc/params.cfg .

The measurement_file.USORT passed to Plott_WERA_USort_RCs is the starting point of a series of 128 samples data sets to be combined. The first figure gives the range-Doppler map of just the first .USORT file (128 samples). The second figure gives the result of combining it with the next coherent .USORT file (256 samples). This process is continued until four .USORT files are combined (512 samples). From this time on, the oldest .USORT file is removed from the combining process and the next one is added to keep a timeseries of 512 samples. This process is repeated until the first gap in the coherent stream of .USORT files is found.

As the data is unsorted and uncalibrated, the calibration file has to be passed in [params*.cfg], see below. If CALF_nnn is not defined, the default file /home/wera/etc/calibration.wera' is used.

Please ensure to pass the correct calibration file to Plott_WERA_USort_RCs.

Plott_WERA_USort_RCs reads all information needed on number of channels, length of timeseries, etc. from the header (first 512 bytes of data file) and the following parameters for PARAM_UV.CFG (VMS) or /home/wera/etc/params.cfg (Linux):

Values in PARAM_UV.CFG or /home/wera/etc/params.cfg:
 
        AUTO_SCALE      = .TRUE.        !.true. = use auto scale

C       Name of WERA Gain File
C
        GAIN_NAME       = '/home/wera/etc/wera_gain.dat'

        ! calibration file
        CALF_001        = '/home/wera/etc/calibration_buesum.wera'

The following box shows a typical output generated by Plott_WERA_USort_RCs:

wera@privwera4:~/Fortran/do_> Plott_WERA_USort_RCs ~/data/Buesum/2008-03-080-22-00-00_bue.USORT params_oms.cfg
 Plott_WERA_USort_RCs V1.0.1 Linux:
 *** Reading configuration from /home/wera/etc/params_oms.cfg
 *** Now processing /home/wera/data/Buesum/2008-03-080-22-00-00_bue.USORT
 nant_sort  =       12 antennas
 Frequency  = 10.7449999 MHz
 NSER       =      128 Samples
 T_chirp    = 0.260000 s
 F_bragg    = 0.334428 Hz
 Last RC    =      100 range cells
 RANGEresol =   1.2000 km
 RAN_OFF    =   0.4167 RC
 RAN_OFF    =      500 m
 TRUE_NORTH =      349 degrees
 DDS_Clock  = 181.48430769 MHz
 MT         =     1536 samples
 SSR        =  0.000000000000 seconds
 *** Header: 0128 SAMPLES  20-MAR-08 22:00 UTC  Buesum      FMUNSO FREQUENZ  10.745MHZ
 *** Reading Calibration data: /home/wera/etc/calibration_buesum.wera
 *** Combined: NSER = 128  NANT_SORT = 12  NRAN = 100
 Max signal (> range cell  4) at antenna  7  range cell    5   0.361 Hz:
 Antenna:  Phase: Peak-1    Peak     Peak+1
  1               0.000     0.000     0.000
  2              17.903    30.029    36.578
  3             142.270   150.694   168.039
  4             157.566   171.022  -173.878
  5              43.513    39.541    63.688
  6            -175.656  -172.336  -168.675
  7             175.998  -173.119  -155.421
  8              -9.098    30.899    59.426
  9              77.930    80.322    98.677
 10             143.220   124.280   151.125
 11             159.293   156.027  -179.705
 12            -164.448  -155.650  -117.526

 Direct Path at range cell 2
 Antenna:  Phase: Peak-1    Peak     Peak+1
  1               0.000     0.000     0.000
  2             153.311   167.154   172.383
  3             -18.121    54.202    49.479
  4            -160.310  -151.840  -154.203
  5              15.156     8.016     0.201
  6            -137.307  -152.509  -154.227
  7             -33.662   -25.184   -26.134
  8             136.004   150.500   149.163
  9             -23.016   -21.385   -23.731
 10              98.600   125.892   127.237
 11             -69.721   -62.501   -62.798
 12              85.887   122.454   128.448

 Direct Path at range cell 3
 Antenna:  Phase: Peak-1    Peak     Peak+1
  1               0.000     0.000     0.000
  2             155.052   166.652   170.564
  3             -10.265    52.845    45.816
  4            -161.410  -153.343  -157.246
  5               0.254     7.321    -2.538
  6            -154.502  -156.778  -158.748
  7             -44.546   -22.930   -23.636
  8             133.771   154.426   152.646
  9             -44.765   -21.350   -24.229
 10              97.512   129.111   129.236
 11             -68.772   -60.360   -61.493
 12              95.466   128.744   132.617
X Display [X], PostScript [P], GIF [G] -> x
Antenna number (1..12) -> 1
Next timestep? [Y/N] -> y
 *** Now processing /home/wera/data/Buesum/2008-03-080-22-00-33_bue.USORT
 nant_sort  =       12 antennas
 Frequency  = 10.7449999 MHz
 NSER       =      128 Samples
 T_chirp    = 0.260000 s
 F_bragg    = 0.334428 Hz
 Last RC    =      100 range cells
 RANGEresol =   1.2000 km
 RAN_OFF    =   0.4167 RC
 RAN_OFF    =      500 m
 TRUE_NORTH =      349 degrees
 DDS_Clock  = 181.48430769 MHz
 MT         =     1536 samples
 SSR        = 33.279999000000 seconds
 *** Header: 0128 SAMPLES  20-MAR-08 22:00 UTC  Buesum      FMUNSO FREQUENZ  10.745MHZ
 *** Reading Calibration data: /home/wera/etc/calibration_buesum.wera
 *** Combined: NSER = 256  NANT_SORT = 12  NRAN = 100
 Max signal (> range cell  4) at antenna  9  range cell    5   0.316 Hz:
 Antenna:  Phase: Peak-1    Peak     Peak+1
  1               0.000     0.000     0.000
..................................................
X Display [X], PostScript [P], GIF [G] -> g
Antenna number (1..12) -> 1
 GIF figure in
 /home/wera/data/Buesum/2008-03-080-22-00-00_bue_USORT_ant01_samp256.gif
Next timestep? [Y/N] -> y
 *** Now processing /home/wera/data/Buesum/2008-03-080-22-01-06_bue.USORT
 nant_sort  =       12 antennas
 Frequency  = 10.7449999 MHz
..................................................
X Display [X], PostScript [P], GIF [G] -> g
Antenna number (1..12) -> 1
 GIF figure in
 /home/wera/data/Buesum/2008-03-080-22-00-00_bue_USORT_ant01_samp384.gif
Next timestep? [Y/N] -> y
 *** Now processing /home/wera/data/Buesum/2008-03-080-22-01-39_bue.USORT
 nant_sort  =       12 antennas
 Frequency  = 10.7449999 MHz
..................................................
X Display [X], PostScript [P], GIF [G] -> g
Antenna number (1..12) -> 1
 GIF figure in
 /home/wera/data/Buesum/2008-03-080-22-00-00_bue_USORT_ant01_samp512.gif
Next timestep? [Y/N] -> n

The output of the program gives information on:

Frequency  : WERA center operating frequency
NSER       : Number of samples
T_chirp    : Duration of a chirp -> sample rate
F_bragg    : Bragg frequency 
Last RC    : Last range cell number
RANGEresol : Range resolution
RAN_OFF    : Range cell offset to compensate for cable length
TRUE_NORTH : Geographical direction of the linear array
SSR        : Start seconds of the timeseries

A series of figures can be generated for each beam direction:
1st figure (128 samples) 2nd figure (256 samples) 3rd figure (384 samples) 4th figure (512 samples)

The dynamic range shown in the figures has a fixed reference point:
The ADC's maximum input voltage of +/-10 Volts * Gain Ramp refers to 0 dB.

Linux:

Source is in Plott_WERA_USort_RCs.F

Compilation and linking with '. do_plott_wera_usort_rcs.sh'
Compilation and linking with '. do_X11R6_plott_wera_usort_rcs.sh'

Call with 
> Plott_WERA_USort_RCs <measurement_file>.sort    e.g.:
> Plott_WERA_USort_RCs ~/data/Buesum/2008-03-080-22-00-00_bue.USORT params_oms.cfg

VMS:

Source is in Plott_WERA_USort_RCs.F

Compilation and linking with '@Plott_WERA_USort_RCs'

Program needs to be defined as an external command to take parameters
from the command line, e.g.
$ Plott_WERA_USort_RCs :== $$USER1:[WERA.Fortran]Plott_WERA_USort_RCs.exe

Call with
$ Plott_WERA_USort_RCs <measurement_file>.USORT param_uv*.cfg      e.g.:
$ Plott_WERA_USort_RCs $data4:[Buesum]2008-03-080-22-00-00_bue.USORT params_oms.cfg


Comments to: gurgel@ifm.uni-hamburg.de (Klaus-Werner Gurgel)