aotpy.translators package

Submodules

aotpy.translators.base module

This module contains a base class for translating non-standard AO telemetry data.

class aotpy.translators.base.BaseTranslator(*args)[source]

Bases: ABC

Abstract class for translators.

Translators are able to convert non-standard AO telemetry data files into an AOSystem object.

Parameters:

*args – Arguments used to initialize the translator class.

classmethod translate(*args) → AOSystem[source]

Initialize class with args, return translated AOSystem.

Parameters:

*args – Arguments used to initialize the translator class.

Return type:

AOSystem containing translated data.

aotpy.translators.ciao module

This module contains a class for translating data produced by ESO’s CIAO system.

class aotpy.translators.ciao.CIAOTranslator(path: str, at_number: int)[source]

Bases: ESOTranslator

Contains functions for translating telemetry data produced by ESO’s CIAO system.

Parameters:

  • path – Path to folder containing telemetry data.

  • at_number ({1, 2, 3, 4}) – Number of the AT that produced the data.

aotpy.translators.eris module

This module contains a class for translating data produced by ESO’s ERIS system.

class aotpy.translators.eris.ERISTranslator(path)[source]

Bases: ESOTranslator

Contains functions for translating telemetry data produced by ESO’s ERIS system.

Parameters:

path – Path to folder containing all system data.

aotpy.translators.eso module

This module contains a base class for translating data produced by ESO systems.

It also provides tools that enable users to automatically add the necessary metadata for compatibility with ESO’s science archive. This is done by querying the archive via programmatic access (pyvo is necessary for this functionality).

class aotpy.translators.eso.ESOTranslator(*args)[source]

Bases: BaseTranslator

Abstract class for translators for ESO systems.

Translators are able to convert non-standard AO telemetry data files into an AOSystem object.

add_archive_metadata(query_archive: bool = False) → None[source]

Adds necessary metadata for ESO Archive to AOSystem.

Parameters:

query_archive (default = False) – Whether the ESO archive should be queried to find relevant metadata already in the archive. Requires pyvo.

get_atmospheric_parameters_from_archive() → Table[source]

Get atmospheric data from ESO’s Science Archive within the recording period.

Requires pyvo.

aotpy.translators.galacsi module

This module contains a class for translating data produced by ESO’s GALACSI system.

class aotpy.translators.galacsi.GALACSITranslator(path_lgs: str, path_ir: str, path_pix: str)[source]

Bases: ESOTranslator

Contains functions for translating telemetry data produced by ESO’s GALACSI system.

Parameters:

  • path_lgs – Path to folder containing LGS data (LGSAcq, LGSCtr, LGSRecn, JitCtr, JitRecnOptimiser, RTC).

  • path_ir – Path to folder containing IR data (IRAcq, IRCtr, IRLoopMonitor).

  • path_pix – Path to folder containing pixel data.

aotpy.translators.gpao module

This module contains a class for translating data produced by ESO’s GRAVITY+ AO system.

class aotpy.translators.gpao.GPAOTranslator(path_ngs_loop: str, path_ngs_pix: str, ut_number: int)[source]

Bases: ESOTranslator

Contains functions for translating telemetry data produced by ESO’s GRAVITY+ AO system.

Parameters:

  • path_ngs_loop – Path to folder containing NGS loop data.

  • path_ngs_pix – Path to folder containing NGS pixel data.

  • ut_number ({1, 2, 3, 4}) – Number of the UT that produced the data.

aotpy.translators.naomi module

This module contains a class for translating data produced by ESO’s NAOMI system.

class aotpy.translators.naomi.NAOMITranslator(path: str, at_number: int)[source]

Bases: ESOTranslator

Contains functions for translating telemetry data produced by ESO’s NAOMI system.

Parameters:

  • path – Path to folder containing telemetry data.

  • at_number ({1, 2, 3, 4}) – Number of the AT that produced the data.

aotpy.translators.papyrus module

This module contains a class for translating telemetry data produced by the ALPAO RTC, part of the PAPYRUS system. It assumes the MATLAB files produced by ALPAO RTC have been converted to use struct objects instead of classes. The custom MATLAB function makeTelemetryFileReadable is made for this. Note that the usage of scipy.io.loadmat to read the .mat files in Python assumes that these files were saved with the version -v7 of matlab or previous. scipy.io.loadmat does not work for files saved with matlab -v7.3 or later.

class aotpy.translators.papyrus.PAPYRUSTranslator(file)[source]

Bases: BaseTranslator

Module contents

This subpackage contains modules with translators, which are able to convert non-standard AO telemetry files into aotpy objects.

The aotpy objects created by these translators can be handled as any other aotpy object regardless of origin.