• Skip to content
• Skip to link menu

KDE 3.5 API Reference

• KDE API Reference
• API Reference

• Sitemap
• Contact Us

 

kstars

geolocation.h

Go to the documentation of this file.

/***************************************************************************
                          geolocation.h  -  K Desktop Planetarium
                             -------------------
    begin                : Sun Feb 11 2001
    copyright            : (C) 2001-2005 by Jason Harris
    email                : jharris@30doradus.org
    copyright            : (C) 2003-2005 by Pablo de Vicente
    email                : p.devicente@wanadoo.es
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef GEOLOCATION_H
#define GEOLOCATION_H

#include <klocale.h>

#include "dms.h"
#include "timezonerule.h"
#include "kstarsdatetime.h"

class GeoLocation {
public: 
    GeoLocation();

    GeoLocation( const GeoLocation &g );

    GeoLocation( GeoLocation *g );

    GeoLocation( dms lng, dms lat, QString name="Nowhere", QString province="Nowhere", QString country="Nowhere", double TZ=0, TimeZoneRule *TZrule=NULL, int iEllips=4, double hght=-10 );

    GeoLocation( double lng, double lat, QString name="Nowhere", QString province="Nowhere", QString country="Nowhere", double TZ=0, TimeZoneRule *TZrule=NULL, int iEllips=4, double hght=-10 );

    GeoLocation( double x, double y, double z, QString name="Nowhere", QString province="Nowhere", QString country="Nowhere", double TZ=0, TimeZoneRule *TZrule=NULL, int iEllips=4 );


    ~GeoLocation() {}

    const dms* lng() const { return &Longitude; }
    const dms* lat() const { return &Latitude; }
    double height() const { return Height; }
    double xPos() const { return PosCartX; }
    double yPos() const { return PosCartY; }
    double zPos() const { return PosCartZ; }
    int ellipsoid() const { return indexEllipsoid; }

    QString name() const { return Name; }
    QString translatedName() const { return i18n("City name (optional, probably does not need a translation)", Name.utf8().data()); }
    QString province() const { return Province; }
    QString translatedProvince() const { return i18n("Region/state name (optional, rarely needs a translation)", Province.utf8().data()); }
    QString country() const { return Country; }
    QString translatedCountry() const { return i18n("Country name (optional, but should be translated)", Country.utf8().data()); }

    QString fullName() const;

    double TZ0() const { return TimeZone; }

    double TZ() const { return TimeZone + TZrule->deltaTZ(); }

    TimeZoneRule* tzrule() const { return TZrule; }

    void setLong( dms l ) { 
        Longitude = l; 
        geodToCart();
    }
    void setLong( double l ) { 
        Longitude.setD( l ); 
        geodToCart();
    }

    void setLat( dms l ) { 
        Latitude  = l; 
        geodToCart();
    }
    
    void setLat( double l ) { 
        Latitude.setD( l ); 
        geodToCart();
    }

    void setHeight( double hg ) { 
        Height  = hg; 
        geodToCart();
    }

    void setXPos( double x ) { 
        PosCartX  = x; 
        cartToGeod();
    }
    void setYPos( double y ) { 
        PosCartY  = y; 
        cartToGeod();
    }
    void setZPos( double z ) { 
        PosCartZ  = z; 
        cartToGeod();
    }
    
    void changeEllipsoid( int i );
    
    void setName( const QString &n ) { Name = n; }

    void setProvince( const QString &n ) { Province = n; }

    void setCountry( const QString &n ) { Country = n; }

    void setTZ( double tz ) { TimeZone = tz; }

    void setTZrule( TimeZoneRule *tzr ) { TZrule = tzr; }

    void reset( GeoLocation *g );

    void cartToGeod(void);

    void geodToCart (void);

    void setEllipsoid( int i );

    dms GSTtoLST( const dms &gst ) const { return dms( gst.Degrees() + Longitude.Degrees() ); }
    dms LSTtoGST( const dms &lst ) const { return dms( lst.Degrees() - Longitude.Degrees() ); }

    KStarsDateTime UTtoLT( const KStarsDateTime &ut ) const { return ut.addSecs( int( 3600.*TZ() ) ); }
    KStarsDateTime LTtoUT( const KStarsDateTime &lt ) const { return lt.addSecs( int( -3600.*TZ() ) ); }


    /* Computes the velocity in km/s of an observer on the surface of the Earth 
     * referred to a system whose origin is the center of the Earth. The X and 
     * Y axis are contained in the equator and the X axis is towards the nodes
     * line. The Z axis is along the poles.
     *
     * @param vtopo[] Topocentric velocity. The resultant velocity is available 
     *        in this array.
     * @param gt. Greenwich sideral time for which we want to compute the topocentric velocity.
     */
    void TopocentricVelocity(double vtopo[], dms gt);

private:
    dms Longitude, Latitude;
    QString Name, Province, Country;
    TimeZoneRule *TZrule;
    double TimeZone, Height;
    double axis, flattening;
    long double PosCartX, PosCartY, PosCartZ;
    int indexEllipsoid;
};

#endif

kstars

Skip menu "kstars"

• Main Page
• Modules
• Class Hierarchy
• Alphabetical List
• Class List
• File List
• Class Members
• Related Pages

API Reference

Skip menu "API Reference"

• keduca
• kstars

Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE^® and the K Desktop Environment^® logo are registered trademarks of KDE e.V. | Legal