ossimGeoref Class Reference

#include <ossimGeoref.h>

Public Member Functions
	ossimGeoref (const ossimString &georefString, long precision)
	ossimGeoref (const ossimGpt &groundPt)
	ossimGeoref ()
ossimString	toString (long precision)

Private Member Functions
long	Convert_Geodetic_To_GEOREF (double Latitude, double Longitude, long Precision, char *georef)
long	Convert_GEOREF_To_Geodetic (char *georef, double *Latitude, double *Longitude)

Private Attributes
ossimGpt	thePt

Detailed Description

Definition at line 6 of file ossimGeoref.h.

Constructor & Destructor Documentation

ossimGeoref() [1/3]

ossimGeoref::ossimGeoref	(	const ossimString &	georefString,
		long	precision
	)

Definition at line 25 of file ossimGeoref.cpp.

References ossimString::c_str(), Convert_GEOREF_To_Geodetic(), GEOREF_NO_ERROR, ossimGpt::latr(), ossimGpt::lonr(), and thePt.

{
   double lat, lon;
   
   long result = Convert_GEOREF_To_Geodetic(const_cast<char*>(georefString.c_str()),
                                            &lat,
                                            &lon);
   if(result == GEOREF_NO_ERROR)
   {
      thePt.latr(lat);
      thePt.lonr(lon);
   }
}

ossimGeoref() [2/3]

ossimGeoref::ossimGeoref

(

const ossimGpt &

groundPt

)

Definition at line 40 of file ossimGeoref.cpp.

References thePt.

{
   thePt = groundPt;
}

ossimGeoref() [3/3]

ossimGeoref::ossimGeoref

(

)

Definition at line 45 of file ossimGeoref.cpp.

{
}

Member Function Documentation

Convert_Geodetic_To_GEOREF()

long ossimGeoref::Convert_Geodetic_To_GEOREF ( double  Latitude, double  Longitude, long  Precision, char *  georef  )

private

This function converts Geodetic (latitude and longitude in radians) coordinates to a GEOREF coordinate string. Precision specifies the number of digits in the GEOREF string for latitude and longitude: 0 for nearest degree 1 for nearest 10 minutes 2 for nearest minute 3 for nearest tenth of a minute 4 for nearest hundredth of a minute 5 for nearest thousandth of a minute

Latitude : Latitude in radians (input) Longitude : Longitude in radians (input) Precision : level of precision specified by the user (input) ossimGeoref : GEOREF coordinate string (output)

Definition at line 288 of file ossimGeoref.cpp.

References Convert_Minutes_To_String(), GEOREF_LAT_ERROR, GEOREF_LETTERS, GEOREF_LON_ERROR, GEOREF_NO_ERROR, GEOREF_PRECISION_ERROR, LATITUDE_HIGH, LATITUDE_LOW, LETTER_A_OFFSET, LETTER_I, LETTER_M, LETTER_O, LETTER_Q, LETTER_Z, LONGITUDE_HIGH, LONGITUDE_LOW, MAX_PRECISION, MIN_PER_DEG, QUAD, RADIAN_TO_DEGREE, and ROUND_ERROR.

Referenced by toString().

{ /* BEGIN Convert_Geodetic_To_GEOREF */
/*   
 *  This function converts Geodetic (latitude and longitude in radians)
 *  coordinates to a GEOREF coordinate string.  Precision specifies the
 *  number of digits in the GEOREF string for latitude and longitude:
 *                                  0 for nearest degree
 *                                  1 for nearest ten minutes
 *                                  2 for nearest minute
 *                                  3 for nearest tenth of a minute
 *                                  4 for nearest hundredth of a minute
 *                                  5 for nearest thousandth of a minute
 *
 *    latitude  : Latitude in radians.                   (input)
 *    longitude : Longitude in radians.                  (input)
 *    precision : Precision specified by the user.       (input)
 *    georef    : GEOREF coordinate string.              (output)
 *
 *    CALLS THE FOLLOWING FUNCTIONS:
 *
 *    Convert_Minutes_To_String
 */

  double long_min;                        /* GEOREF longitude minute part   */
  double lat_min;                         /* GEOREF latitude minute part    */
  double origin_long;                     /* Origin longitude (-180 degrees)*/
  double origin_lat;                      /* Origin latitude (-90 degrees)  */
  long letter_number[GEOREF_LETTERS + 1]; /* GEOREF letters                 */
  char long_min_str[MAX_PRECISION + 1];   /* Longitude minute string        */
  char lat_min_str[MAX_PRECISION + 1];    /* Latitude minute string         */
  long i;                                 /* counter in for loop            */
  long error_code = GEOREF_NO_ERROR;

  latitude = latitude * RADIAN_TO_DEGREE;
  longitude = longitude * RADIAN_TO_DEGREE;
  if ((latitude < (double)LATITUDE_LOW) 
      || (latitude > (double)LATITUDE_HIGH))
    error_code |= GEOREF_LAT_ERROR;
  if ((longitude < (double)LONGITUDE_LOW) 
      || (longitude > (double)LONGITUDE_HIGH))
    error_code |= GEOREF_LON_ERROR;
  if ((precision < 0) || (precision > MAX_PRECISION))
    error_code |= GEOREF_PRECISION_ERROR;
  if (!error_code)
  {
    if (longitude > 180)
      longitude -= 360;
    origin_long = (double)LONGITUDE_LOW;
    origin_lat = (double)LATITUDE_LOW;
    letter_number[0] = (long)((longitude-origin_long) / QUAD + ROUND_ERROR);
    longitude = longitude - ((double)letter_number[0] * QUAD + origin_long);
    letter_number[2] = (long)(longitude + ROUND_ERROR);
    long_min = (longitude - (double)letter_number[2]) * (double)MIN_PER_DEG;
    letter_number[1] = (long)((latitude - origin_lat) / QUAD + ROUND_ERROR);
    latitude = latitude - ((double)letter_number[1] * QUAD + origin_lat);
    letter_number[3] = (long)(latitude + ROUND_ERROR);
    lat_min = (latitude - (double)letter_number[3]) * (double)MIN_PER_DEG;
    for (i = 0;i < 4; i++)
    {
      if (letter_number[i] >= LETTER_I)
        letter_number[i] += 1;
      if (letter_number[i] >= LETTER_O)
        letter_number[i] += 1;
    }

    if (letter_number[0] == 26)
    { /* longitude of 180 degrees */
      letter_number[0] = LETTER_Z;
      letter_number[2] = LETTER_Q;
      long_min = 59.999;
    }
    if (letter_number[1] == 13)
    { /* latitude of 90 degrees */
      letter_number[1] = LETTER_M;
      letter_number[3] = LETTER_Q;
      lat_min = 59.999;
    }

    for (i=0;i<4;i++)
      georef[i] = (char)(letter_number[i] + LETTER_A_OFFSET);
    georef[4] = 0;
    Convert_Minutes_To_String(long_min,precision,long_min_str);
    Convert_Minutes_To_String(lat_min,precision,lat_min_str);
    strcat(georef,long_min_str);
    strcat(georef,lat_min_str);
  }
  return (error_code);
} /* END OF Convert_Geodetic_To_GEOREF */

Convert_GEOREF_To_Geodetic()

long ossimGeoref::Convert_GEOREF_To_Geodetic ( char *  georef, double *  Latitude, double *  Longitude  )

private

This function converts a GEOREF coordinate string to Geodetic (latitude and longitude in radians) coordinates.

ossimGeoref : GEOREF coordinate string (input) Latitude : Latitude in radians (output) Longitude : Longitude in radians (output)

Definition at line 230 of file ossimGeoref.cpp.

References DEGREE_TO_RADIAN, Extract_Degrees(), Extract_Minutes(), GEOREF_LETTERS, GEOREF_MAXIMUM, GEOREF_MINIMUM, GEOREF_NO_ERROR, GEOREF_STR_ERROR, GEOREF_STR_LAT_MIN_ERROR, GEOREF_STR_LON_MIN_ERROR, LATITUDE_LOW, LONGITUDE_LOW, and MIN_PER_DEG.

Referenced by ossimGeoref().

{ /* BEGIN Convert_GEOREF_To_Geodetic */
/*
 *  This function converts a GEOREF coordinate string to Geodetic (latitude
 *  and longitude in radians) coordinates.
 *
 *    georef    : GEOREF coordinate string.     (input)
 *    latitude  : Latitude in radians.          (output)
 *    longitude : Longitude in radians.         (output)
 *
 *    CALLS THE FOLLOWING FUNCTIONS:
 *
 *    Extract_Degrees
 *    Extract_Minutes
 */
  long start;                /* Position in the GEOREF string                */
  long minutes_length;       /* length of minutes in the GEOREF string       */
  long georef_length;        /* length of GEOREF string                      */
  double origin_long;       /* Origin longitude                             */
  double origin_lat;        /* Origin latitude                              */
  double long_minutes;      /* Longitude minute part of GEOREF              */
  double lat_minutes;       /* Latitude minute part of GEOREF               */
  long error_code = GEOREF_NO_ERROR;

  origin_long = (double)LONGITUDE_LOW;
  origin_lat = (double)LATITUDE_LOW;
  georef_length = (long)strlen(georef);
  if ((georef_length < GEOREF_MINIMUM) || (georef_length > GEOREF_MAXIMUM) 
      || ((georef_length % 2) != 0))
  {
    error_code |= GEOREF_STR_ERROR;
  }
  if (!error_code)
  {
    error_code |= Extract_Degrees(georef,latitude,longitude);
    start = GEOREF_LETTERS;
    minutes_length = (georef_length - start) / 2;
    if (!error_code)
    {
      error_code |= Extract_Minutes(georef, start, minutes_length, 
                                    GEOREF_STR_LON_MIN_ERROR, &long_minutes);
      if (!error_code)
      {
        error_code |= Extract_Minutes(georef, (start+minutes_length),
                                      minutes_length, GEOREF_STR_LAT_MIN_ERROR, &lat_minutes);
        *latitude = *latitude + origin_lat + lat_minutes / (double)MIN_PER_DEG;
        *longitude = *longitude + origin_long + long_minutes / (double)MIN_PER_DEG;
        *latitude = *latitude * DEGREE_TO_RADIAN;
        *longitude = *longitude * DEGREE_TO_RADIAN;
      }
    }
  }
  return (error_code);
} /* END OF Convert_GEOREF_To_Geodetic */

toString()

ossimString ossimGeoref::toString

(

long

precision

)

This function converts Geodetic (latitude and longitude in radians) coordinates to a GEOREF coordinate string. Precision specifies the number of digits in the GEOREF string for latitude and longitude: 0 for nearest degree 1 for nearest 10 minutes 2 for nearest minute 3 for nearest tenth of a minute 4 for nearest hundredth of a minute 5 for nearest thousandth of a minute

Precision : level of precision specified by the user (input) ossimGeoref : GEOREF coordinate string (return)

Definition at line 49 of file ossimGeoref.cpp.

References Convert_Geodetic_To_GEOREF(), GEOREF_NO_ERROR, ossimGpt::latr(), ossimGpt::lonr(), and thePt.

{
   char resultString[100];
   
   long result = Convert_Geodetic_To_GEOREF(thePt.latr(),
                                            thePt.lonr(),
                                            precision,
                                            resultString);
   if(result == GEOREF_NO_ERROR)
   {
      return ossimString(resultString);
   }

   return ossimString("");
}

Member Data Documentation

thePt

ossimGpt ossimGeoref::thePt

private

Definition at line 31 of file ossimGeoref.h.

Referenced by ossimGeoref(), and toString().

---

The documentation for this class was generated from the following files:

• ossimGeoref.h
• ossimGeoref.cpp