Classes | Defines | Enumerations | Functions

sc_earth_elevation.h File Reference

Classes

class  sc_earth_elevation
 Manages requests for earth elevation. More...

Defines

#define kDegreesPerPixel   0.0083333333333
 Earth elevation model.

Enumerations

enum  ElevationPrecision {
  elev_precision_none = 0, elev_precision_10 = 1, elev_precision_1 = 2, elev_precision_01 = 3,
  elev_precision_001 = 4
}
 

Elevation precision.


Functions

double earth_surface_elevation (double lat, double lon)
 Return surface elevation above sea level for the given lat & lon (degrees)
double earth_surface_elevation (const ml_matrix &efpos, double f=FLATTENING_FACTOR)
 Return surface elevation above sea level for the given EF position.
ml_matrix earth_surface_ef_pos (const ml_matrix &efpos, double f=FLATTENING_FACTOR, double a=RADIUS_EARTH)
 Compensate for Earth land elevation at the given position by increasing or decreasing magnitude.

Detailed Description


Define Documentation

#define kDegreesPerPixel   0.0083333333333

Accesses elevation figures in DEM files Degrees per pixel

Referenced by sc_earth_elevation_square::elevationForLatLon(), and sc_earth_elevation_square::hasLandInGridSquare().


Function Documentation

double earth_surface_elevation ( double  lat,
double  lon 
)

Return surface elevation above sea level for the given lat & lon (degrees)

A negative return value would be land below sea level (i.e. Death Valley)

Parameters:
latlatitude in degrees from -90 to 90
lonlongitude in degrees from -180 to 180
Returns:
Difference in kilometers between sea level and the land surface at the given location

References sc_earth_elevation::default_manager(), and sc_earth_elevation::elevationForLatLon().

double earth_surface_elevation ( const ml_matrix &  efpos,
double  f 
)

Return surface elevation above sea level for the given EF position.

A negative return value would be land below sea level (i.e. Death Valley)

Parameters:
efposLocation coordinate in the Earth Fixed coordinate frame
fFlattening factor
Returns:
Difference in kilometers between sea level and the land surface at the given location

References sc_earth_elevation::default_manager(), and sc_earth_elevation::elevationForEFPos().

ml_matrix earth_surface_ef_pos ( const ml_matrix &  efpos,
double  f,
double  a 
)

Compensate for Earth land elevation at the given position by increasing or decreasing magnitude.

Looks up Earth elevations in DEM (Digital Elevation Map) files via class in sc_earth_elevation.

Parameters:
efposLocation coordinate in the Earth Fixed coordinate frame
fFlattening factor
aEquatorial radius
Returns:
Location on the actual land surface in the Earth Fixed coordinate frame

References sc_earth_elevation::default_manager(), and sc_earth_elevation::elevationForEFPos().