AntennaParameters
=================

.. py:class:: pride.io.AntennaParameters

   Data structure for antenna parameters

   Details in: Nothnagel (2009) https://doi.org/10.1007/s00190-008-0284-z

   Parameter descriptions from: antenna-info.txt (https://ivscc.gsfc.nasa.gov/IVS_AC/IVS-AC_data_information.htm)

   :param ivs_name: IVS station name
   :param focus_type: Focus type of the primary frequency
   :param mount_type: Mounting type
   :param radome: Whether the station has a radome
   :param meas_type: Measurement type (Complete, Incomplete, Rough)
   :param T0: Reference temperature [C]
   :param sin_T: Sine amplitude of annual temperature variations wrt J2000 epoch [C]
   :param cos_T: Cosine amplitude of annual temperature variations wrt J2000 epoch [C]
   :param h0: Reference pressure [hPa]
   :param ant_diam: Antenna diameter [m]
   :param hf: Height of the foundation [m]
   :param df: Depth of the foundation [m]
   :param gamma_hf: Thermal expansion coefficient of the foundation [1/K]
   :param hp: Length of the fixed axis [m]
   :param gamma_hp: Thermal expansion coefficient of the fixed axis [1/K]
   :param AO: Length of the offset between primary and secondary axes [m]
   :param gamma_AO: Thermal expansion coefficient of the offset [1/K]
   :param hv: Distance from the movable axis to the antenna vertex [m]
   :param gamma_hv: Thermal expansion coefficient of the structure connecting the movable axis to the antenna vertex [1/K]
   :param hs: Height of the subreflector/primary focus above the vertex [m]
   :param gamma_hs: Thermal expansion coefficient of the subreflector/primary focus mounting legs [1/K]


   .. py:method:: from_catalog(station_name: str) -> AntennaParameters
      :staticmethod:


      Load antenna parameters from internal catalog

      Parses an internal catalog of antenna parameters (antenna-info.txt), reads the line corresponding to the specified station name, and packs the information into an AntennaParameters object.

      :param station_name: Name of the station
      :return: Data structure with antenna parameters



   .. py:method:: from_catalog_missing_ok(station_name: str) -> AntennaParameters | None
      :staticmethod:


      Load antenna parameters from internal catalog

      Provides the same functionality as the `from_catalog` static method, but it returns None if the station is not found in the catalog instead of raising an error.

      :param station_name: Name of the station
      :return: Data structure with antenna parameters, or None if the station is not found in the catalog