pint.observatory

Machinery to support PINT’s list of observatories.

This code maintains a registry of observatories known to PINT. Observatories are added to the registry when the objects are created. For the observatories defined in PINT, these objects are created when the relevant module is imported.

PINT’s built-in observatories are loaded when anyone imports the modules pint.observatory.topo_obs and pint.observatory.special_locations. This automatically happens when you call pint.observatory.Observatory.get(), pint.observatory.get_observatory(), or pint.observatory.Observatory.names() (pint.observatory.Observatory.names_and_aliases() to include aliases). Satellite observatories are somewhat different, as they cannot be created until the user supplies an orbit file. Once created, they will appear in the list of known observatories.

Normal use of pint.toa.get_TOAs() will ensure that all imports have been done, but if you are using a different subset of PINT these imports may be necessary.

Functions

compare_t2_observatories_dat([t2dir])

Read a tempo2 observatories.dat file and compare with PINT

compare_tempo_obsys_dat([tempodir])

Read a tempo obsys.dat file and compare with PINT.

earth_location_distance(loc1, loc2)

Compute the distance between two EarthLocations.

find_clock_file(name, format[, ...])

Locate and return a ClockFile in one of several places.

find_latest_bipm()

Check BIPM servers for the most recent version of TT(BIPMYYYY)

get_observatory(name[, apply_gps2utc])

Convenience function to get observatory object with options.

list_last_correction_mjds()

Print out a list of the last MJD each clock correction is good for.

update_clock_files([bipm_versions])

Obtain an up-to-date version of all clock files.

Classes

Observatory(name[, fullname, aliases, ...])

Observatory locations and related site-dependent properties

Exceptions

ClockCorrectionError

Unspecified error doing clock correction.

ClockCorrectionOutOfRange

Clock corrections are available but the requested time is not covered.

NoClockCorrections

Clock corrections are expected but none are available.

pint.observatory.clock_file

Routines for reading and writing various formats of clock file.

pint.observatory.global_clock_corrections

Tools for working with clock corrections obtained from a global location.

pint.observatory.satellite_obs

Observatories at special (non-Earth) locations.

pint.observatory.special_locations

Special locations that are not really observatories.

pint.observatory.topo_obs

Ground-based fixed observatories read in from observatories.json.