Home       Trees       Index       Help   
Package dics :: Module rotator :: Class telescope
[hide private]
[frames] | no frames]

Class telescope
source code

Class representing the telescope/observatory. Stores information relating to the position and meteorological conditions (for refraction calculations) and performs calculations of observed azimuth and elevation.

Instance Methods [hide private]
  __init__(self, longitude, latitude, altitude, polar_motion_x, polar_motion_y, delta_ut, temperature, pressure, humidity, tlr, wavelength, name)
Initialiser for a telescope object.
  updateConfig(self, config)
Should be called by the parent instrument object's destructor to enable status information to be saved to file on exit.
  getIERS(self)
Returns the stored earth rotation parameters, as provided by the International Earth Rotation Service, UT1-UTC (seconds, float), and the x and y components of polar motion (rotator.angles).
  setIERS(self, delta_UT, polar_motion_x, polar_motion_y)
Sets the earth rotation parameters.
  getLocation(self)
Returns the telescope location information, longitude, latitude (both as rotator.angles) and altitude (metres).
  setLocation(self, longitude, latitude, altitude)
Sets the telescope location information.
  resetField(self)
Deletes any stored field reference.
  getPointing(self, field, utc)
Calculates the observed azimuth and zenith distance for a given field and time.
  getWavelength(self)
Returns the stored effective wavelength of observations, in microns.
  setWavelength(self, wavelength)
Sets the effective wavelength of observations.
  getWeather(self)
Returns the stored meteorological parameters, temperature (in Kelvin), pressure (in millibars), relative humidity (in the range 0-1.0) and tropospheric lapse rate (Kelvin/metre).
  setWeather(self, temperature, pressure, humidity, tlr)
Sets the meteorogical parameters used in the refraction calculations.

Method Details [hide private]

__init__(self, longitude, latitude, altitude, polar_motion_x, polar_motion_y, delta_ut, temperature, pressure, humidity, tlr, wavelength, name)
(Constructor)

source code 

Initialiser for a telescope object. Arguments representing angles should be an object acceptable as an argument to the rotator.angle constructor, or a sequence type containing a list of arguments acceptible to rotator.angle().

Arguments:

longitude: Mean longitude of the telescope, east positive. latitude: Mean geodetic latitude of the telescope. altitude: Telescope's height above mean sea level (metres). polar_motion_x: Polar motion x-coordinate for today, from IERS polar_motion_y: Polar motion y-coordinate for today, from IERS delta_ut: UT1-UTC from IERS, in seconds, as a float temperature: Local ambient temperature (Kelvin) pressure: Local atmospheric pressure (millibars) humidity: Local relative humidity (in the range 0.0-1.0) tlr: Tropospheric lapse rate (Kelvin/metre) wavelength: Effective wavelength of the observations (microns) name: An identification string for logging purposes.

updateConfig(self, config)

source code 

Should be called by the parent instrument object's destructor to enable status information to be saved to file on exit.

Takes a ConfigParserRT.SafeConfigParser object as argument.

getIERS(self)

source code 
Returns the stored earth rotation parameters, as provided by the International Earth Rotation Service, UT1-UTC (seconds, float), and the x and y components of polar motion (rotator.angles).

setIERS(self, delta_UT, polar_motion_x, polar_motion_y)

source code  

Sets the earth rotation parameters.  The information to do this
should be obtained from the International Earth Rotation Service
bulletin covering the day in question.

Arguments:

delta_UT:       UT1-UTC, in seconds.
polar_motion_x: Polar motion x-coordinate, as either an argument or
                sequence containing an argument list for the
                rotator.angle() constructor.
polar_motion_y: Polar motion y-coordinate, as either an argument or
                sequence containing an argument list for the
                rotator.angle() constructor.

getLocation(self)

source code 
Returns the telescope location information, longitude, latitude (both as rotator.angles) and altitude (metres).

setLocation(self, longitude, latitude, altitude)

source code  

Sets the telescope location information.

Arguments:

longitude: Mean longitude of the telescope, east positive, as either
           an argument or sequence containing an argument list for the
           rotator.angle() constructor.
latitude:  Mean geodetic latitude of the telescope, as either an
           argument or sequence containing an argument list for the
           rotator.angle() constructor.
altitude:  The telescope's height above mean sea level, in metres.

resetField(self)

source code 
Deletes any stored field reference. The effect of this is to force a recalculation of all the observed-to-apparent-place parameters in the next call to getPointing(), rather than just updating the sidereal time.

getPointing(self, field, utc)

source code  

Calculates the observed azimuth and zenith distance for a given field
and time.  Note that these calculations assume a 'perfect' telescope,
no pointing model is used.

Arguments:

field: the target field, expressed as a rotator.field object.
utc:   the time of observation, UTC, expressed as a datetime.datetime
       object

Returned:

az:    the observed azimuth expressed as a rotator.angle, East = 90deg
zd:    the observed zenith distance expressed as a rotator.angle.
pa:    the parallactic angle at the target field.

getWavelength(self)

source code 
Returns the stored effective wavelength of observations, in microns.

setWavelength(self, wavelength)

source code 

Sets the effective wavelength of observations.

Arguments:

wavelength: Effective wavelength of observations, in microns.

getWeather(self)

source code 
Returns the stored meteorological parameters, temperature (in Kelvin), pressure (in millibars), relative humidity (in the range 0-1.0) and tropospheric lapse rate (Kelvin/metre).

setWeather(self, temperature, pressure, humidity, tlr)

source code 

Sets the meteorogical parameters used in the refraction calculations.

Arguments:

temperature: Local ambient temperature (Kelvin) pressure: Local atmospheric pressure (millibars) humidity: Local relative humidity (in the range 0.0-1.0) tlr: Tropospheric lapse rate (Kelvin/metre)

   Home       Trees       Index       Help   
Generated by Epydoc 3.0alpha2 on Sun Jun 11 16:26:28 2006 http://epydoc.sf.net