# There are 2 styles of output: coverage map or link data.
# There are 2 styles of calculation: profile or area.
#
# So there are 4 possible combinations.  A coverage map is used to visualize
# how a transmitter deposits energy on a map, whereas link data calculates
# results for all pairwise tx-rx links.  Multiple transmitters and multiple
# receivers can exist, but tx-tx and rx-rx are not calculated.  In coverage
# mode, only the first transmitter found is used.  If multiple receivers
# exist, environmental and antenna data are used from the first receiver
# found.

# Items particular to rfl itself, not the various RF models.
model rfl
  terrain dted        # 'dted' or 'open' terrain elevation data.
  dted /data/dted1    # Path to DTED data.
  ant  /data/ant      # Path to NSMA antenna patterns.
  units SNR           # Output units: dBm, uV, dBuV, SNR.

  # Calculation mode, terrain profile or area.
  mode profile        # ITM analysis type, 'profile' or 'area'.
  dh 127              # Terrain roughness, only used in area mode.
  # Output mode, coverage map or file of link budget numbers.
  output csv          # 'coverage' (graph) or 'csv' (file of numbers).
  outfile rfl.csv     # Output csv file name, not needed in coverage mode.

  # Statistics involve how, where and when radios are used.  Rather than mean
  # and standard deviation ITM uses quantiles of observations, values not
  # exceeded for given fractions of the time.  Quantiles of time, location
  # and situation are used, which are combined in different ways to apply to
  # what ITM calls modes of variability.
  #
  # ITM modes of variability:
  #  Single message probability: first-try success probability.
  #  Single receiver: % of time availability.
  #  Mobile receiver: % of required probability.
  #  Broadcast service: % of time that % locations have reception.
  #
  # Quantile variabilities:
  #  Single message mode: no variability in time, location or situation.
  #  Profile mode: no variability in location.
  #  Mobile mode: no variability in situation.
  #  Broadcast mode: variability in all three quantiles.
  #
  # Reliability is a quantile that addresses adequate service or the measures
  # above capturing variability of a radio system during the course of its
  # deployment.  Confidence in ITM is a higher level of probability where a
  # large number of engineering decisions at the same confidence level will
  # be correct for that fraction of decisions.
  #
  # If the quantiles are not in the config file then rfl will not calculate
  # the statistics and will output median path loss.

  # For profile mode, only conf and time are used.
  # For area mode, conf, time, and loc are all used.
  # If 'conf' is not present, time & loc are ignored and stats are not
  # calculated.
  conf 95           # 0-100, confidence level.
  time 70           # 0-100, fraction of times.
  loc  80           # 0-100, fraction of locations, ignored in profile mode.

# Details regarding coverage map.
model coverage
  grid  20  # Make coverage map n x n cells.
  range 15  # Range of coverage in km from tx point.
  title 7-Element Log Periodic Test
  pattern yes # Display azimuth cut of antenna pattern on map.

# Multiple RF environments can exist, useful only in profile mode.
model env easternPA
  eps   10    # average relative ground permittivity, F/m. (LR1968, tbl 2.)
  N0    315   # sea level refractivity, mid-Atlantic (TN101 fig 4.1).
  sigma 0.005 # average relative ground conductivity, Siemens. (LR1968, tbl 2.)

# Multiple noise environments can exist, useful only in profile mode.
model noise suburban
  B    25e3        # Hz, bandwidth of signal.
  env  residential # One of: business, highway, residential, park, rural, quiet.
  f    88          # MHz, carrier frequency as listed in NSMA antenna file.
  NF   7           # dB, receiver noise figure.
  T    288         # Kelvin, temperature of receiver.

# Multiple stations can exist.  Coverage mode uses only the first transmitter.
model station Sensor Data
  # Antenna information.
  ant   A_LOG_7W.nsma # Antenna pattern data.
  pol   v             # 'v' or 'h', antenna polarity.
  az    158           # Degrees clockwise from true north.
  el    0

  # Station info.
  hgt   10.5
  lat   31.718025   # Decimal degrees.  Optional in area mode.
  lon   -110.375975 # Decimal degrees.  Optional in area mode.
  env   easternPA   # Name of environment model in this file.
  noise suburban    # Name of noise model in this file.
  sys   0           # dB, various system losses, cabling, insertion, etc.
  tx    57          # dBm, 57 dBm == 500W.
  site  v           # Siting r(andom), c(areful), v(ery careful), area only.
  service 2         # Mobile service.

model station Station 1
  env   easternPA
  hgt   3
  noise suburban
  lat   31.627639
  lon   -110.282694
  site  v

model station Station 2
  env   easternPA
  hgt   3
  noise suburban
  lat   31.651528
  lon   -110.274250
  site  v

model station Station 3
  env   easternPA
  hgt   3
  noise suburban
  lat   31.664167
  lon   -110.227833
  site  v

model station Station 4
  env   easternPA
  hgt   3
  noise suburban
  lat   31.667389
  lon   -110.235500
  site  v