doppsat - Reports the satellite down- and uplink doppler shifts

as well as down- and uplink frequencies, elevation, azimuth, and doppler speed for a given receiver and specified times.

SYNOPSIS

doppsat  [ parameter=value ... ]

Parameters are: satellitepass_date,   greenwich_timeduration,   zero_elevtime_step,   downlink_freq, uplink_freq,   receiver_latreceiver_lon,   report_fieldsprint_header.

DESCRIPTION

doppsat reports the following values for the times specified by pass_date, greenwich_time, duration, and time_step parameters: satellite downlink doppler shift down_shift for a given satellite transmitter frequency downlink_freq, corrected downlink frequency downlink_freq+down_shift, satellite uplink doppler shift up_shift for a given satellite receiver frequency uplink_freq, corrected uplink frequency uplink_freq-up_shift, doppler speed, i.e. satellite's speed of approaching the receiver, and, also, satellite azimuth and elevation. $SATDATA/<satellite_name>/orbdata file with orbital elements for a given satellite must exist.

PARAMETERS

satellite
This is the name of the satellite. There is no default.
pass_date
This is the date. The default pass_date is today. See formats for valid date formats.
greenwich_time
This is the time (GMT). The default greenwich_time is the current time. See formats for valid time formats.
duration
This is the duration time. The default duration is 23:59:59. See formats for valid time formats.
zero_elev
OPTIONAL. If yes, report only at the time when satellite rising elevation is zero. If no, report at intervals defined by the time_step parameter. The default is no.
time_step
This is the time step. The default time_step is 1 second.
downlink_freq
This is the satellite transmitter frequency in Hz. There is no default.
uplink_freq
This is the satellite receiver frequency in Hz. There is no default.
receiver_lat
Latitude of the receiver (antenna). See formats for specification of latitude and longitude formats. The default value is retrieved from the file last_location.
receiver_lon
Longitude of the receiver (antenna). See formats for specification of latitude and longitude formats. The default value is retrieved from the file last_location.
report_fields
Fields to report. Valid responses are [downlink d_shift uplink u_shift speed elevation azimuth time]. Entering the same field more than once is not allowed.
print_header
OPTIONAL. Whether or not to print a header with the names of the fields being reported. The valid answers are [yes no]. The default is yes.

EXAMPLES

% doppsat
satellite      : char(  8) ? noaa-12
pass_date      : char( 15) ? [95/08/15]
greenwich_time : char( 15) ? [00:27:46] 15:29:00
duration       : char( 15) ? [23:59:59] 15:30
time_step      : real      ? [1] 120
downlink_freq  : real      ? 30000000000
uplink_freq    : real      ? 20000000000
receiver_lat   : char( 15) ? [32 53.54 N]
receiver_lon   : char( 15) ? [117  9.24 W]
report_fields  : char( 79) ? downlink d_shift uplink u_shift speed elevation azimuth time
     Downlink(Hz) Down Shift(Hz)       Uplink(Hz)   Up Shift(Hz) Speed(km/sec) Elevation(deg) Azimuth(deg)    Time
   30000664102.59     +664102.59   19999557264.94     +442735.06         +6.64          -0.84        +7.36  15:29:00
   30000653834.07     +653834.07   19999564110.62     +435889.38         +6.53          +7.10        +4.84  15:31:00
   30000610440.22     +610440.22   19999593039.85     +406960.15         +6.10         +18.54        -0.44  15:33:00
   30000447694.10     +447694.10   19999701537.26     +298462.74         +4.47         +38.30       -15.74  15:35:00
   29999934433.89      -65566.11   20000043710.74      -43710.74         -0.66         +57.33       -84.34  15:37:00
   29999499446.68     -500553.32   20000333702.21     -333702.21         -5.00         +33.19      -137.01  15:39:00
   29999376773.15     -623226.85   20000415484.57     -415484.57         -6.23         +15.71      -148.89  15:41:00
   29999343878.12     -656121.88   20000437414.59     -437414.59         -6.56          +5.26      -153.52  15:43:00
%

FILES

orbdata

SEE ALSO

NOTES

All angles are in degrees. All frequencies are in Hz. Speed is in km/sec.


Last Update: $Date: 1999/05/10 20:13:28 $