Viewsheds

 

These are currently not enabled.  See the separate list of working commands.

 

Command GET-FAN
Format: GET-FAN|Lat|Long$
Sample: GET-FAN|39.2765|-117.3456$
MICRODEM Response: GET-FAN|0|75.25$
Possible error messages: GET-FAN|-1|Invalid coords$
Notes:
  1. Coords given in lat/long
  2. Draws fan on DEM Map
  3. Response gives the percentage of the potential coverage areas that is visible.

   

Command GET-FAN-IMAGE
Format: GET-FAN-IMAGE|Lat|Long$
Sample: GET-FAN-IMAGE|39.2765|-117.3456$
MICRODEM Response: GET-FAN-IMAGE|0|75.25$
Possible error messages: GET-FAN_IMAGE-1|Invalid coords$
Notes:
  1. Coords given in lat/long
  2. Draws fan on the image Map
  3. Response gives the percentage of the potential coverage areas that is visible.

  

Command CLEAR-FAN
Format: CLEAR-FAN$
Sample: CLEAR-FAN$
MICRODEM Response: CLEAR-FAN|0|OK$
Possible error messages:  
Notes:
  1. Removes all fans from the map.  Does not redraw.

 

Command SET-FAN-PARAM
Format: SET-FAN-PARAM|<Range>|<ObsHt>|<TargetHt>|<LeftBound>|<RightBound>|<UpBound>|<DownBound>$
Sample SET-FAN-PARAM|2500|2|2|0|360|89|-89$
MICRODEM Response SET-FAN-PARAM|0|OK$
Possible error messages SET-FAN-PARAM|-1|Problem encountered$
Notes:
  1. If this is not set before requesting a fan, the defaults previously set in MICRODEM will be used.
  2. You can set just the first three parameters, and the others will remain unchanged.
  3. Range and heights in meters, bounds in degrees.
  4. All values are floating point, but decimal not required.
  5. To ignore vertical bounds, set UpBound and DownBound to +89 and -89.
  6. Set left and right bounds to 0 and 360 for complete coverage.

 

Command SENSOR
Format: SENSOR|<Name>|<Lat>|<Long>|<Max_Range>$
Sample: SENSOR|S_1|45.23456|-118.98765|2500$
MICRODEM Response String with the sensor parameters (Name, lat, long, elevation, max_range, followed by the height the sensor must be to see each target in the target data base.

S_1|,45.23456,-118.98765,2500,99999.0,27.3,98.8,112.4,12.4

Possible error messages
  • SENSOR|No DEM loaded$
  • SENSOR|-2|No DB loaded$
Notes
  1. Must have opened the DEM first
  2. Must have opened the targets database first.
  3. Height of 99999.0 means the target is out of range.
  4. This command may have very limited applicability.

Sample code showing how to use commands in an actual session.

 Main TCP index.


Last revision 7/17/2008