pcap - Reports points of closest approach for selected satellite passes.

SYNOPSIS

pcap  [ parameter=value ... ]

Parameters are: receiver_lat, receiver_lon, min_rec_elev, target_lat, target_lon, min_targ_elev, satellite, sensor, start_date, num_days, printout.

DESCRIPTION

pcap determines the Points of Closest Approach (PCAPs) for a given satellite and sensor relative to the target and/or receiver location. The PCAPs are reported using the satellite elevation angle above the horizon, the azimuth angle from north, and the distance to subtrack (km).

This function does not require the specification of any input or output TeraScan datasets.

PARAMETERS

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 lat_lon_formats for specification of latitude and longitude formats. The default value is retrieved from the file last_location.

min_rec_elev

Minimum allowable satellite elevation with respect to the receiver to use in reporting the PCAPs.

Valid responses are [0 to 90]. The default value is 0.

target_lat

Latitude of the target.

See formats for specification of latitude and longitude formats. The default value is retrieved from the file last_location.

target_lon

Longitude of the target.

See formats for specification of latitude and longitude formats. The default value is retrieved from the file last_location.

min_targ_elev

Minimum allowable satellite elevation with respect to the target to use in reporting the PCAPs.

Valid responses are [0 to 90]. The default value is 0.

satellite

This is the name of the satellite in lower case.

sensor

This is the sensor name entered in lower case.

The default is avhrr.

start_date

This is the date to begin reporting PCAPs.

Any valid date is allowed, see formats. There is no default.

num_days

This is the number of days to report PCAPs beginning with start_date.

Valid responses are [> 0]. The default value is 5.

printout

Determines whether the output is sent to the hardcopy device or the screen.

Valid response are [yes or no]. The default is no.

EXAMPLES

%[7] pcap
receiver_lat   : char( 15) ? [32 50.47 N]
receiver_lon   : char( 15) ? [117 13.65 W]
min_rec_elev   : real      ? [0] 5
target_lat     : char( 15) ? [32 50.47 N]
target_lon     : char( 15) ? [117 13.65 W]
min_targ_elev  : real      ? [0] 5
satellite      : char( 11) ? noaa-11
sensor         : char(  5) ? [avhrr]
start_date     : char( 15) ? 91/10/12
num_days       : int       ? [5] 3
printout       : char(  3) ? [no]
   Target: 32 50.47 N, 117 13.65 W   Receiver: 32 50.47 N, 117 13.65 W
            5.0 min elev                        5.0 min elev

   Date      Time     Distance[km]   Target->Satellite     Receiver->Satellite
                      To Subtrack    Elevation  Azimuth    Elevation  Azimuth

   91/10/12  10:04:41    1169.7        29.36   97.32        29.36   97.32
   91/10/12  11:45:13    1140.9        30.10  291.52        30.10  291.52
   91/10/12  21:26:47     942.8        35.85   70.06        35.85   70.06
   91/10/12  23:07:28    1379.6        23.71  263.95        23.71  263.95
   91/10/13  09:53:00    1445.7        22.67   95.84        22.67   95.84
   91/10/13  11:33:41     879.9        38.55  289.86        38.55  289.86
   91/10/13  21:15:15    1203.1        27.99   68.44        27.99   68.44
   91/10/13  22:55:46    1103.6        30.79  262.45        30.79  262.45
   91/10/14  09:41:17    1722.6        17.34   94.34        17.34   94.34
   91/10/14  11:22:08     616.3        49.86  288.29        49.86  288.29
   91/10/14  21:03:43    1460.5        21.93   66.74        21.93   66.74
   91/10/14  22:44:05     828.7        40.11  260.95        40.11  260.95

FILES

sensorfile, orbdata, last_location

SEE ALSO

avhrr, ols, xcapcon, etx, fastreg, master, orbit, ephem, passcover


Last Update: $Date: 1998/05/29 20:13:18 $