Revision 6351998c666d50f220881757dec7c4389309297d authored by Garrett 'Karto' Keating on 09 March 2022, 08:13:25 UTC, committed by kartographer on 07 July 2022, 17:00:15 UTC
1 parent 1683d69
make_uvdata.py
# -*- mode: python; coding: utf-8 -*-
"""
Format the UVData object parameters into a sphinx rst file.
"""
import os
import inspect
from pyuvdata import UVData
from astropy.time import Time
def write_uvdata_rst(write_file=None):
UV = UVData()
out = "UVData\n======\n\n"
out += (
"UVData is the main user class for intereferometric data (visibilities).\n"
"It provides import and export functionality to and from the supported file\n"
"formats (UVFITS, MeasurementSets, Miriad, uvh5, FHD, MIR) as well as\n"
"numerous methods for transforming the data (phasing, averaging, selecting,\n"
"sorting) and can be interacted with directly.\n\n"
"Attributes\n----------\n"
"The attributes on UVData hold all of the metadata and data required to\n"
"analyze interferometric data sets. Under the hood, the attributes are\n"
"implemented as properties based on :class:`pyuvdata.parameter.UVParameter`\n"
"objects but this is fairly transparent to users.\n\n"
"UVData objects can be initialized from a file using the\n"
":meth:`pyuvdata.UVData.from_file` class method\n"
"(as ``uvd = UVData.from_file(<filename>)``) or be initialized as an empty\n"
"object (as ``uvd = UVData()``). When an empty UVData object is initialized,\n"
"it has all of these attributes defined but set to ``None``. The attributes\n"
"can be set by reading in a data file using the :meth:`pyuvdata.UVData.read`\n"
"method or by setting them directly on the object. Some of these attributes\n"
"are `required`_ to be set to have a fully defined data set while others are\n"
"`optional`_. The :meth:`pyuvdata.UVData.check` method can be called on the\n"
"object to verify that all of the required attributes have been set in a\n"
"consistent way.\n\n"
'Note that objects can be in a "metadata only" state where\n'
"all of the metadata is defined but the data-like attributes (``data_array``,\n"
"``flag_array``, ``nsample_array``) are not. The\n"
":meth:`pyuvdata.UVData.check` method will still pass for metadata only\n"
"objects.\n\n"
"Note that angle type attributes also have convenience properties named the\n"
"same thing with ``_degrees`` appended through which you can get or set the\n"
"value in degrees. Similarly location type attributes (which are given in\n"
"topocentric xyz coordinates) have convenience properties named the\n"
"same thing with ``_lat_lon_alt`` and ``_lat_lon_alt_degrees`` appended\n"
"through which you can get or set the values using latitude, longitude and\n"
"altitude values in radians or degrees and meters.\n\n"
)
out += "Required\n********\n"
out += (
"These parameters are required to have a sensible UVData object and\n"
"are required for most kinds of interferometric data files."
)
out += "\n\n"
for thing in UV.required():
obj = getattr(UV, thing)
out += "**{name}**\n".format(name=obj.name)
out += " {desc}\n".format(desc=obj.description)
out += "\n"
out += "Optional\n********\n"
out += (
"These parameters are defined by one or more file standard but are not\n"
"always required. Some of them are required depending on the\n"
"phase_type (as noted below)."
)
out += "\n\n"
for thing in UV.extra():
obj = getattr(UV, thing)
out += "**{name}**\n".format(name=obj.name)
out += " {desc}\n".format(desc=obj.description)
out += "\n"
out += "Methods\n-------\n.. autoclass:: pyuvdata.UVData\n :members:\n\n"
t = Time.now()
t.format = "iso"
t.out_subfmt = "date"
out += "last updated: {date}".format(date=t.iso)
if write_file is None:
write_path = os.path.dirname(os.path.abspath(inspect.stack()[0][1]))
write_file = os.path.join(write_path, "uvdata.rst")
F = open(write_file, "w")
F.write(out)
print("wrote " + write_file)
![swh spinner](/static/img/swh-spinner.gif)
Computing file changes ...