opihiexarata.library.tcs module

This contains functions which allow for the calling of TCS commands for the IRTF telescope control software. It also formats the text according to the documentation specifications found in http://irtfweb.ifa.hawaii.edu/~tcs3/tcs3/users_manuals/1103_commands.pdf

These functions call to the external shell and it formats and coverts the values from the conventions of OpihiExarata (as the expected input) to the expected input for the TCS.

opihiexarata.library.tcs.t3io_tcs_next(ra: float, dec: float, ra_proper_motion: float = 0, dec_proper_motion: float = 0, epoch: int = 2000, equinox: int = 2000, coordinate_system: str = 'fk5', target_name: str = None, magnitude: float = 0, ra_velocity: float = 0, dec_velocity: float = 0) → CompletedProcess[source]

This uses the t3io program to execute the TCS next command. As the command takes many values, if some “optional” values are not provided, they default to 0 when the command is sent if there are no otherwise reasonable parameters.

For more information, see the TCS Manual

Parameters:

ra (float) – The right ascension of the target, in degrees.
dec (float) – The declination of the target, in degrees.
ra_proper_motion (float, default = 0) – The RA proper motion of the target, in degrees per second.
dec_proper_motion (float, default = 0) – The DEC proper motion of the target, in degrees per second.
epoch (int, default = 2000) – The epoch year of the proper motion values to correct for current proper motion.
equinox (int, default = 2000) – The equinox year of the coordinate system.
coordinate_system (string, default = "fk5") – The coordinate system which the RA and DEC is using. Must be either FK5, FK4, or APP, which is the topocentric apparent coordinate system.
target_name (string, default = None) – The name of the target. If not provided, it defaults to the default name found in the configuration file for TCS requests.
magnitude (float, default = 0) – The magnitude of the target.
ra_velocity (float, default = 0) – The non-sidereal motion of the target in RA, in degrees per second.
dec_velocity (float, default = 0) – The non-sidereal motion of the target in DEC, in degrees per second.

Returns:

t3io_response – The response of the t3io command as captured (and packaged) by the subprocess module.

Return type:

CompletedProcess

opihiexarata.library.tcs.t3io_tcs_ns_rate(ra_velocity: float, dec_velocity: float) → CompletedProcess[source]

This uses the t3io program to execute the TCS ns.rate command. This command allows for the specification of the non-sidereal rates of the target.