Raw File
Tip revision: 617c8e77d30037c1e1fb3a2ab460cb0aaa11eca1 authored by Paul La Plante on 29 June 2019, 20:31 UTC
Add support for bitshuffle on visdata
Tip revision: 617c8e7
# -*- coding: utf-8 -*-

Format the UVCal object parameters into a sphinx rst file.

from __future__ import absolute_import, division, print_function

import os
import inspect
from pyuvdata import UVCal
import numpy as np
from astropy.time import Time

def write_calparams_rst(write_file=None):
    cal = UVCal()
    out = 'UVCal Parameters\n==========================\n'
    out += ("These are the standard attributes of UVCal objects.\n\nUnder the hood "
            "they are actually properties based on UVParameter objects.\n\n")
    out += 'Required\n----------------\n'
    out += ('These parameters are required to have a sensible UVCal object and \n'
            'are required for most kinds of uv cal files.')
    out += "\n\n"
    for thing in cal.required():
        obj = getattr(cal, thing)
        out += '**{name}**\n'.format(
        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 '
            'always required.\nSome of them are required depending on the '
            'cal_type (as noted below).')
    out += "\n\n"
    for thing in cal.extra():
        obj = getattr(cal, thing)
        out += '**{name}**\n'.format(
        out += '     {desc}\n'.format(desc=obj.description)
        out += "\n"
    t =
    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, 'uvcal_parameters.rst')
    F = open(write_file, 'w')
    print("wrote " + write_file)
back to top