radar-coord-conversion-utility
0.7
|
Class to calculate radar point coordinates related to radar place and coordinates. More...
#include <radarcoordlib/RadarPoint_util.hpp>
Public Member Functions | |
bool | AeqdCoords2GeoCoords () |
Compute geographic coordinates from Aeqd coordinates. More... | |
bool | AeqdCoords2RadarCoords () |
Compute radar coordinate from Aeqd coordinate (X,Y) More... | |
bool | calculateGeodesicParam () |
Calculate Earth distance and Azimuth from radar site to the point set. More... | |
bool | fillCoords () |
Compute point coordinates for all Radar, Aeqd,Geographic and Geodesic systems and syncronize vertical coords. More... | |
bool | GeoCoords2AeqdCoords () |
Compute Aeqd coordinates fro Geographic coordinates. More... | |
bool | GeoCoords2RadarCoords () |
Compute radar coordinate from Geographic coordinate (Lat,Lon) More... | |
bool | GeodeticCoords2RadarCoords () |
Compute radar coordinate from Geodetic coordinate (Azimuth, surfaceDistance) More... | |
float | getAntennaTowerHeight () |
get beam electromagnetic focus height above surface value More... | |
float | getAzimuth () |
Get Azimuth of geodetic between radar site and point. More... | |
float | getBeamDistance () |
Get slantwise distance along the ray. More... | |
float | getElevation () |
Get beam Elevation used. More... | |
float | getHeight () |
Get beam height (above msl) More... | |
float | getHeightR () |
get radar height above msl value More... | |
float | getLatR () |
get radar latitude value More... | |
float | getLonR () |
get radar longitude value More... | |
float | getPointLat () |
Get point latitude. More... | |
float | getPointLon () |
Get point longitude. More... | |
float | getPointXCoord () |
Get point X coordinate (Aeqd projection centred on radar site) More... | |
float | getPointYCoord () |
Get point y coordinate (Aeqd projection centred on radar site) More... | |
float | getSurfaceDistance () |
Get distance on the Earth surface. More... | |
bool | invertGeodesicCalculation () |
Calculate geographic and gnomonic coordinates from Earth distance and Azimuth. More... | |
bool | isAzimuthSet () |
Check if geodetic Azimuth is set. More... | |
bool | isBeamDistanceSet () |
Check if slantwise distance along the ray is valid (equal or greater than 0.) More... | |
bool | isElevationSet () |
copy constructor More... | |
bool | isGeodesicCoordsSet () |
Check if point Geodetic coordinates are set. More... | |
bool | isHeightSet () |
Check if height is valid. More... | |
bool | isPointAeqdCoordsSet () |
Check if point Aeqd coordinates are valid. More... | |
bool | isPointGeoCoordsSet () |
Check if point Geographic coordinates are valid. More... | |
bool | isPointLatitudeSet () |
Check if point latitude is valid and set. More... | |
bool | isPointLongitudeSet () |
Check if point longitude is valid and set. More... | |
bool | isPointXCoordSet () |
Check if point X coordinate is valid. More... | |
bool | isPointYCoordSet () |
Check if point Y coordinate is valid. More... | |
bool | isRadarCoordsSet () |
Check if radar coordinates are set. More... | |
bool | isSurfaceDistanceSet () |
Check if. More... | |
RadarPoint_util & | operator= (RadarPoint_util param) |
copy operator More... | |
bool | RadarCoords2AeqdCoords () |
Compute Aeqd coordinate (X,Y) from radar coordinate. More... | |
bool | RadarCoords2GeoCoords () |
Compute Geographic coordinate (Lat,Lon) from radar coordinate. More... | |
bool | RadarCoords2GeodeticCoords () |
Compute Geodetic coordinate (Azimuth, surfaceDistance) from radar coordinate. More... | |
bool | RadarCoords2OthersCoords () |
Compute Aeqd, Geographic and Geodetic coordinates from radar coordinate. More... | |
bool | radarElev2radarHeight () |
Compute Height of the center of the radar beam based on elevation and range. More... | |
bool | radarHeight2radarElev () |
Compute Elevation based on Height of the center of the radar beam and range. More... | |
RadarPoint_util () | |
Constructor. More... | |
RadarPoint_util (float latr, float lonr, float heightr, float aTH) | |
Constructor with radar coordinates passed Point coordinates are set to missing value. More... | |
RadarPoint_util (float latr, float lonr, float heightr, float aTH, float azimuth, float elevation, float range) | |
Constructor with radar coordinates pnd point coordinate passed Point coordinates are set to missing value. More... | |
void | setPoint2Missing () |
Set Point coordinates to missing. More... | |
void | setPointAeqdCoords (float X, float Y, bool cleanOtherCoords=true) |
Set Aeqd coordinates (Aeqd projection centred on radar site) More... | |
void | setPointAeqdCoordsElev (float X, float Y, float Elev, bool cleanOtherCoords=true) |
Set Aeqd coordinates (Aeqd projection centred on radar site) More... | |
void | setPointAeqdCoordsHeight (float X, float Y, float H, bool cleanOtherCoords=true) |
Set Aeqd coordinates (Aeqd projection centred on radar site) More... | |
void | setPointGeoCoords (float lat, float lon, bool cleanOtherCoords=true) |
Set point geographic coordinates. More... | |
void | setPointGeoCoordsElev (float lat, float lon, float Elev, bool cleanOtherCoords=true) |
Set point geographic coordinates. More... | |
void | setPointGeoCoordsHeight (float lat, float lon, float H, bool cleanOtherCoords=true) |
Set point geographic coordinates. More... | |
void | setPointGeodesicCoordinate (float Azimuth, float SurfaceDist, bool cleanOtherCoords=true) |
Set Geodesic coordinate (Azimuth, Surface distance) More... | |
void | setPointGeodesicCoordinateElev (float Azimuth, float SurfaceDist, float Elev, bool cleanOtherCoords=true) |
Set Geodesic coordinate (Azimuth, Surface distance) More... | |
void | setPointGeodesicCoordinateHeight (float Azimuth, float SurfaceDist, float H, bool cleanOtherCoords=true) |
Set Geodesic coordinate (Azimuth, Surface distance) More... | |
void | setPointRadarCoordinateElev (float Azimuth, float Elev, float BeamDist, bool cleanOtherCoords=true) |
Set Point radar coordinate (Azimuth, Elevation, Beam distance) More... | |
void | setPointRadarCoordinateHeight (float Azimuth, float H, float BeamDist, bool cleanOtherCoords=true) |
Set Point radar coordinate (Azimuth, H, Beam distance) More... | |
void | setRadarCoord (float latr, float lonr, float heightr, float aTH, bool cleanPointCoord=true) |
Set radar coordinates. More... | |
bool | syncRadarVerticalCoord () |
Check if it is possible syncronize the two vertical coords. Calculate the unset coords if possible. More... | |
Protected Member Functions | |
void | setAntennaTowerHeight (float value) |
set beam electromagnetic focus height above surface value More... | |
void | setAzimuth (float value) |
Set Azimuth of geodetic between radar site and point. More... | |
void | setBeamDistance (float value) |
Set slantwise distance along the ray. More... | |
void | setElevation (float value) |
Set beam elevation. More... | |
void | setHeight (float value) |
Set height (above msl) of the center of the beam. More... | |
void | setHeightR (float value) |
set radar height above msl value More... | |
void | setLatR (float value) |
set radar latitude value More... | |
void | setLonR (float value) |
set radar longitude value More... | |
void | setPointLat (float value) |
Set point latitude. More... | |
void | setPointLon (float value) |
Set point longitude. More... | |
void | setPointXCoord (float value) |
Set point X coordinate (Aeqd projection centred on radar site) More... | |
void | setPointYCoord (float value) |
Set point y coordinate (Aeqd projection centred on radar site) More... | |
void | setSurfaceDistance (float value) |
Set distance on the Earth surface. More... | |
Protected Attributes | |
float | Azimuth |
float | BeamDistance |
float | Elevation |
float | Height |
float | Lat_p |
float | Lon_p |
RadarSite | radar_site |
float | surfaceDistance |
float | Xcoord_p |
float | Ycoord_p |
Class to calculate radar point coordinates related to radar place and coordinates.
This class compute (back and for) Earth coordinate calculations and radar coordinate of a single point
related to a radar position.
The point coordinate could be passed as one of the following options:
This class compute conversion between coordinate system
RadarPoint_util::RadarPoint_util | ( | ) |
Constructor.
Inizialize radar site coordinates at
Lat : 0. N - Lon : 0. E - Height : 0. m - Antennatower height : 0. m
Point coordinates are set to missing value
RadarPoint_util::RadarPoint_util | ( | float | latr, |
float | lonr, | ||
float | heightr, | ||
float | aTH | ||
) |
Constructor with radar coordinates passed Point coordinates are set to missing value.
[in] | latr | - Radar site Latitude |
[in] | lonr | - Radar site Longitude |
[in] | heightr | - Height above the msl of radar site (antenna tower not included) |
[in] | aTH | - Height of the electric antenna focus related above the surface |
RadarPoint_util::RadarPoint_util | ( | float | latr, |
float | lonr, | ||
float | heightr, | ||
float | aTH, | ||
float | azimuth, | ||
float | elevation, | ||
float | range | ||
) |
Constructor with radar coordinates pnd point coordinate passed Point coordinates are set to missing value.
[in] | latr | - Radar site Latitude (Degree N) |
[in] | lonr | - Radar site Longitude (Degree E) |
[in] | heightr | - Height above the msl of radar site (antenna tower not included) (meter) |
[in] | aTH | - Height of the electric antenna focus related above the surface (meter) |
[in] | azimuth | - Azimuth of the radar beam (Degree) |
[in] | elevation | - Elevation of the radar beam above the horizon (Degree) |
[in] | range | - Slantwise distance along teh radar beam (meter) |
|
inherited |
Compute geographic coordinates from Aeqd coordinates.
bool RadarPoint_util::AeqdCoords2RadarCoords | ( | ) |
Compute radar coordinate from Aeqd coordinate (X,Y)
NOTE: One of Elevation/Height should be set, the other will be computed
|
inherited |
Calculate Earth distance and Azimuth from radar site to the point set.
One of Aeqd or Geographic coords should be set Detail description
Geodesic parameters are calculate based on GeographicLib available at http://sourceforge.net/projects/geographiclib/
|
virtual |
Compute point coordinates for all Radar, Aeqd,Geographic and Geodesic systems and syncronize vertical coords.
NOTE: One of Elevation/Height should be set, the other will be computed
Reimplemented from RadarGeoCoord_util.
|
inherited |
Compute Aeqd coordinates fro Geographic coordinates.
bool RadarPoint_util::GeoCoords2RadarCoords | ( | ) |
Compute radar coordinate from Geographic coordinate (Lat,Lon)
NOTE: One of Elevation/Height should be set, the other will be computed
bool RadarPoint_util::GeodeticCoords2RadarCoords | ( | ) |
Compute radar coordinate from Geodetic coordinate (Azimuth, surfaceDistance)
NOTE: One of Elevation/Height should be set, the other will be computed
|
inherited |
get beam electromagnetic focus height above surface value
|
inherited |
Get Azimuth of geodetic between radar site and point.
float RadarPoint_util::getBeamDistance | ( | ) |
Get slantwise distance along the ray.
float RadarPoint_util::getElevation | ( | ) |
Get beam Elevation used.
float RadarPoint_util::getHeight | ( | ) |
Get beam height (above msl)
|
inherited |
get radar height above msl value
|
inherited |
get radar latitude value
|
inherited |
get radar longitude value
|
inherited |
Get point latitude.
|
inherited |
Get point longitude.
|
inherited |
Get point X coordinate (Aeqd projection centred on radar site)
|
inherited |
Get point y coordinate (Aeqd projection centred on radar site)
|
inherited |
Get distance on the Earth surface.
|
inherited |
Calculate geographic and gnomonic coordinates from Earth distance and Azimuth.
Detail description
Invert Geodesic calculation are based on GeographicLib available at http://sourceforge.net/projects/geographiclib/
|
inherited |
Check if geodetic Azimuth is set.
bool RadarPoint_util::isBeamDistanceSet | ( | ) |
Check if slantwise distance along the ray is valid (equal or greater than 0.)
bool RadarPoint_util::isElevationSet | ( | ) |
copy constructor
Check if Elevation is valid
|
inherited |
Check if point Geodetic coordinates are set.
bool RadarPoint_util::isHeightSet | ( | ) |
Check if height is valid.
|
inherited |
Check if point Aeqd coordinates are valid.
|
inherited |
Check if point Geographic coordinates are valid.
|
inherited |
Check if point latitude is valid and set.
|
inherited |
Check if point longitude is valid and set.
|
inherited |
Check if point X coordinate is valid.
|
inherited |
Check if point Y coordinate is valid.
bool RadarPoint_util::isRadarCoordsSet | ( | ) |
Check if radar coordinates are set.
|
inherited |
Check if.
RadarPoint_util & RadarPoint_util::operator= | ( | RadarPoint_util | param | ) |
copy operator
bool RadarPoint_util::RadarCoords2AeqdCoords | ( | ) |
Compute Aeqd coordinate (X,Y) from radar coordinate.
NOTE: One of Elevation/Height should be set, the other will be computed
bool RadarPoint_util::RadarCoords2GeoCoords | ( | ) |
Compute Geographic coordinate (Lat,Lon) from radar coordinate.
NOTE: One of Elevation/Height should be set, the other will be computed
bool RadarPoint_util::RadarCoords2GeodeticCoords | ( | ) |
Compute Geodetic coordinate (Azimuth, surfaceDistance) from radar coordinate.
NOTE: One of Elevation/Height should be set, the other will be computed
bool RadarPoint_util::RadarCoords2OthersCoords | ( | ) |
Compute Aeqd, Geographic and Geodetic coordinates from radar coordinate.
NOTE: One of Elevation/Height should be set, the other will be computed
bool RadarPoint_util::radarElev2radarHeight | ( | ) |
Compute Height of the center of the radar beam based on elevation and range.
bool RadarPoint_util::radarHeight2radarElev | ( | ) |
Compute Elevation based on Height of the center of the radar beam and range.
|
protectedinherited |
set beam electromagnetic focus height above surface value
value | - Height of the electric antenna focus related above the surface |
RadarCoordBadDataException | - if value passed if outsite [0, +100] |
|
protectedinherited |
Set Azimuth of geodetic between radar site and point.
[in] | value | Azimuth (degree from North clockwise) |
|
protected |
Set slantwise distance along the ray.
[in] | value | (meter) |
|
protected |
Set beam elevation.
[in] | value | (degree above horizon) |
|
protected |
Set height (above msl) of the center of the beam.
[in] | value | (meter) |
|
protectedinherited |
set radar height above msl value
[in] | value | - Height above the msl of radar site (antenna tower not included) |
|
protectedinherited |
set radar latitude value
[in] | value | - Radar site Latitude |
RadarCoordBadDataException | - if value passed if outsite [-90, +90] |
|
protectedinherited |
set radar longitude value
[in] | value | - Radar site Longitude |
RadarCoordBadDataException | - if value passed if outsite [-180, +180] |
|
virtual |
Set Point coordinates to missing.
Reimplemented from RadarGeoCoord_util.
|
inherited |
Set Aeqd coordinates (Aeqd projection centred on radar site)
[in] | X | - x coordinate (meter) |
[in] | Y | - y coordinate (meter) |
[in] | cleanOtherCoords | If true Geodesic and Geographic coordinate will be unset. |
void RadarPoint_util::setPointAeqdCoordsElev | ( | float | X, |
float | Y, | ||
float | Elev, | ||
bool | cleanOtherCoords = true |
||
) |
Set Aeqd coordinates (Aeqd projection centred on radar site)
[in] | X | - x coordinate (meter) |
[in] | Y | - y coordinate (meter) |
[in] | Elev | - Elevation above horizon (Degree) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Height coordinate will be unset. |
void RadarPoint_util::setPointAeqdCoordsHeight | ( | float | X, |
float | Y, | ||
float | H, | ||
bool | cleanOtherCoords = true |
||
) |
Set Aeqd coordinates (Aeqd projection centred on radar site)
[in] | X | - x coordinate (meter) |
[in] | Y | - y coordinate (meter) |
[in] | H | - height above msl (meter) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Elevation coordinate will be unset. |
|
inherited |
Set point geographic coordinates.
[in] | lat | - latitude (degree N) |
[in] | lon | - longitude (degree E) |
[in] | cleanOtherCoords | If true Geodesic and Aeqd coordinate will be unset. |
void RadarPoint_util::setPointGeoCoordsElev | ( | float | lat, |
float | lon, | ||
float | Elev, | ||
bool | cleanOtherCoords = true |
||
) |
Set point geographic coordinates.
[in] | lat | Latitude (degree N) |
[in] | lon | Longitude (degree E) |
[in] | Elev | Elevation above horizon (Degree) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Height coordinate will be unset. |
void RadarPoint_util::setPointGeoCoordsHeight | ( | float | lat, |
float | lon, | ||
float | H, | ||
bool | cleanOtherCoords = true |
||
) |
Set point geographic coordinates.
[in] | lat | - latitude (degree N) |
[in] | lon | - longitude (degree E) |
[in] | H | - height above msl (meter) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Elevation coordinate will be unset. |
|
inherited |
Set Geodesic coordinate (Azimuth, Surface distance)
[in] | Azimuth | direction from radar site (Degree N) |
[in] | SurfaceDist | distance over the Earth surface between radar site and Earth point |
[in] | cleanOtherCoords | If true Aeqd and Geographic coordinate will be unset. |
void RadarPoint_util::setPointGeodesicCoordinateElev | ( | float | Azimuth, |
float | SurfaceDist, | ||
float | Elev, | ||
bool | cleanOtherCoords = true |
||
) |
Set Geodesic coordinate (Azimuth, Surface distance)
[in] | Azimuth | Direction from radar site (Degree N) |
[in] | Elev | Elevation above horizon (Degree) |
[in] | SurfaceDist | Distance over the Earth surface between radar site and Earth point |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Height coordinate will be unset. |
void RadarPoint_util::setPointGeodesicCoordinateHeight | ( | float | Azimuth, |
float | SurfaceDist, | ||
float | H, | ||
bool | cleanOtherCoords = true |
||
) |
Set Geodesic coordinate (Azimuth, Surface distance)
[in] | Azimuth | Direction from radar site (Degree N) |
[in] | H | Height above msl (meter) |
[in] | SurfaceDist | Distance over the Earth surface between radar site and Earth point |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Elevation coordinate will be unset. |
|
protectedinherited |
Set point latitude.
[in] | value | - latitude (degree N) |
RadarCoordBadDataException | if value passed if outsite [-90, +90] |
|
protectedinherited |
Set point longitude.
[in] | value | - longitude (degree E) |
RadarCoordBadDataException | if value passed if outsite [-180, +180] |
void RadarPoint_util::setPointRadarCoordinateElev | ( | float | Azimuth, |
float | Elev, | ||
float | BeamDist, | ||
bool | cleanOtherCoords = true |
||
) |
Set Point radar coordinate (Azimuth, Elevation, Beam distance)
[in] | Azimuth | Direction from radar site (Degree N) |
[in] | Elev | Elevation above horizon (Degree) |
[in] | BeamDist | Slantwise distance along the ray (m) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Height coordinate will be unset. |
void RadarPoint_util::setPointRadarCoordinateHeight | ( | float | Azimuth, |
float | H, | ||
float | BeamDist, | ||
bool | cleanOtherCoords = true |
||
) |
Set Point radar coordinate (Azimuth, H, Beam distance)
[in] | Azimuth | Direction from radar site (Degree N) |
[in] | H | Height above msl (meter) |
[in] | BeamDist | Slantwise distance along the ray (m) |
[in] | cleanOtherCoords | If true Geodesic and Geographic and Elevation coordinate will be unset. |
|
protectedinherited |
Set point X coordinate (Aeqd projection centred on radar site)
[in] | value | - x coordinate (meter) |
|
protectedinherited |
Set point y coordinate (Aeqd projection centred on radar site)
[in] | value | - y coordinate (meter) |
|
inherited |
Set radar coordinates.
[in] | latr | Radar site Latitude |
[in] | lonr | Radar site Longitude |
[in] | heightr | Height above the msl of radar site (antenna tower not included) |
[in] | aTH | Height of the electric antenna focus related above the surface |
[in] | cleanPointCoord | if true all point coordinate are cleaned |
|
protectedinherited |
Set distance on the Earth surface.
[in] | value | distance over Earth surface (meter) |
bool RadarPoint_util::syncRadarVerticalCoord | ( | ) |
Check if it is possible syncronize the two vertical coords. Calculate the unset coords if possible.
|
protectedinherited |
Azimuth
Azimuth form north of the geodetic line at the radar site
|
protected |
Slantwise distance of the radar point along the radar beam (meter)
|
protected |
Elevation of the radar beam (Degree)
|
protected |
Height (meter above msl) of the center of the radar beam at the radar point
|
protectedinherited |
|
protectedinherited |
|
protectedinherited |
Radar_site
Radar site coordinate
|
protectedinherited |
surfaceDistance
Distance between radar and point on the geodetic line
|
protectedinherited |
Xcoord_p
Aeqd X coordinate value for the point evaluated
|
protectedinherited |
Ycoord_p
Aeqd Y coordinate value for the point evaluated