KDE 4.2 PyKDE API Reference for Marble
  • KDE's Python API
  • Overview
  • PyKDE Home
  • Sitemap
  • Contact Us
 

GeoDataCoordinates Class Reference

from PyKDE4.marble import *

Subclasses: Marble.GeoDataPoint
Namespace: Marble

Detailed Description

A 3d point representation

GeoDataCoordinates is the simple representation of a single three dimensional point. It can be used all through out marble as the data type for three dimensional objects. it comprises of a Quaternion for speed issues. This class was introduced to reflect the difference between a simple 3d point and the GeoDataGeometry object containing such a point. The latter is a GeoDataPoint and is simply derived from GeoDataCoordinates.

See also:
GeoDataPoint


Enumerations

Notation { Decimal, DMS }
Unit { Radian, Degree }

Methods

 __init__ (self, Marble.GeoDataCoordinates other)
 __init__ (self)
 __init__ (self, float lon, float lat, float alt=0, Marble.GeoDataCoordinates.Unit unit=GeoDataCoordinates.Radian, int detail=0)
float altitude (self)
int detail (self)
 geoCoordinates (self, float lon, float lat, Marble.GeoDataCoordinates.Unit unit=GeoDataCoordinates.Radian)
bool operator == (self, Marble.GeoDataCoordinates a0)
 pack (self, QDataStream stream)
Marble.Quaternion quaternion (self)
 set (self, float lon, float lat, float alt=0, Marble.GeoDataCoordinates.Unit unit=GeoDataCoordinates.Radian)
 setAltitude (self, float altitude)
 setDetail (self, int det)
QString toString (self)
QString toString (self, Marble.GeoDataCoordinates.Notation notation)
 unpack (self, QDataStream stream)

Static Methods

Marble.GeoDataCoordinates.Notation defaultNotation ()
Marble.GeoDataCoordinates fromString (QString string, bool successful)
float normalizeLat (float lat)
float normalizeLon (float lon)
 normalizeLonLat (float lon, float lat)
 setDefaultNotation (Marble.GeoDataCoordinates.Notation notation)

Method Documentation

__init__ (  self,
Marble.GeoDataCoordinates  other
)
__init__ (   self )
__init__ (  self,
float  lon,
float  lat,
float  alt=0,
Marble.GeoDataCoordinates.Unit  unit=GeoDataCoordinates.Radian,
int  detail=0
)

create a geocoordinate from longitude and latitude

Parameters:
_lon  longitude
_lat  latitude
alt  altitude (default: 0)
_unit  units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)
_detail  detail (default: 0)

float altitude (   self )

return the altitude of the Point

Marble.GeoDataCoordinates.Notation defaultNotation (   )

return Notation of string representation

int detail (   self )

return the detail flag

Marble.GeoDataCoordinates fromString ( QString  string,
bool  successful
)

try to parse the string into a coordinate pair

Parameters:
successful  becomes true if the conversion succeeds

Returns:
the geodatacoordinates

geoCoordinates (  self,
float  lon,
float  lat,
Marble.GeoDataCoordinates.Unit  unit=GeoDataCoordinates.Radian
)

use this function to get the longitude and latitude with one call - use the unit parameter to switch between Radian and DMS

Parameters:
lon  longitude
lat  latitude
unit  units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

float normalizeLat ( float  lat
)

normalize latitude to always be in -3.14159265358979323846264338327950288419717 / 2. <= lat <= +3.14159265358979323846264338327950288419717 / 2.

Parameters:
lat  latitude

float normalizeLon ( float  lon
)

normalize the longitude to always be -3.14159265358979323846264338327950288419717 <= lon <= +3.14159265358979323846264338327950288419717

Parameters:
lon  longitude

normalizeLonLat ( float  lon,
float  lat
)

normalize both longitude and latitude at the same time

Parameters:
lon  the longitude value
lat  the latitude value

bool operator == (  self,
Marble.GeoDataCoordinates  a0
)
pack (  self,
QDataStream  stream
)

Serialize the contents of the feature to stream.

Marble.Quaternion quaternion (   self )

return a Quaternion with the used coordinates

set (  self,
float  lon,
float  lat,
float  alt=0,
Marble.GeoDataCoordinates.Unit  unit=GeoDataCoordinates.Radian
)

(re)set the coordinates in a GeoDataCoordinates

Parameters:
_lon  longitude
_lat  latitude
alt  altitude (default: 0)
_unit  units that lon and lat get measured in (default for Radian: north pole at pi/2, southpole at -pi/2)

setAltitude (  self,
float  altitude
)

set the altitude of the Point

Parameters:
altitude  altitude

setDefaultNotation ( Marble.GeoDataCoordinates.Notation  notation
)

set the Notation of the string representation

Parameters:
notation  Notation

setDetail (  self,
int  det
)

set the detail flag

Parameters:
det  detail

QString toString (   self )

return a string representation of the coordinate this is a convenience function which uses the default notation

QString toString (  self,
Marble.GeoDataCoordinates.Notation  notation
)

return a string with the notation given by notation

Parameters:
notation  set a notation different from the default one

unpack (  self,
QDataStream  stream
)

Unserialize the contents of the feature from stream.


Enumeration Documentation

Notation

enum used to specify the notation / numerical system

For degrees there exist two notations: "Decimal" (base-10) and the "Sexagesimal DMS" (base-60) which is traditionally used in cartography. Decimal notation uses floating point numbers to specify parts of a degree. The Sexagesimal DMS notation uses integer based Degrees-(Arc)Minutes-(Arc)Seconds to describe parts of a degree.

Enumerator:
Decimal 
DMS 

Unit

enum used constructor to specify the units used

Internally we always use radian for mathematical convenience. However the Marble's interfaces to the outside should default to degrees.

Enumerator:
Radian 
Degree 

  • Full Index

Modules

  • marble