<commit_before>Cal Parameters
==============
These are the standard attributes of UVCal objects.

Under the hood they are actually properties based on UVParameter objects.

Required
----------------
These parameters are required to have a sensible UVCal object and 
are required for most kinds of uv cal files.

**Nants_data**
     Number of antennas with data present (i.e. number of unique entries in ant_1_array and ant_2_array). May be smaller than the number of antennas in the array

**Nants_telescope**
     Number of antennas in the array. May be larger than the number of antennas with data

**Nfreqs**
     Number of frequency channels

**Npols**
     Number of polarizations

**Nspws**
     Number of spectral windows (ie non-contiguous spectral chunks). More than one spectral window is not currently supported.

**Ntimes**
     Number of times

**antenna_names**
     List of antenna names, shape (Nants_telescope), with numbers given by antenna_numbers (which can be matched to ant_1_array and ant_2_array). There must be one entry here for each unique entry in ant_1_array and ant_2_array, but there may be extras as well.

**antenna_numbers**
     List of integer antenna numbers corresponding to antenna_names,shape (Nants_telescope). There must be one entry here for each unique entry in ant_1_array and ant_2_array, but there may be extras as well.

**cal_type**
     cal type parameter. Values are delay, gain or unknown.

**channel_width**
     Channel width of of a frequency bin. Units Hz.

**flag_array**
     Array of flags to be applied to calibrated data (logical OR                  of input and flag generated by calibration). True is flagged.shape: (Nants_data, Nfreqs, Ntimes, Npols), type = bool.


**freq_array**
     Array of frequencies, shape (Nspws, Nfreqs), units Hz

**gain_convention**
     The convention for applying he calibration solutions to data.Indicates that to calibrate one should divide or multiply uncalibrated data by gains.

**history**
     String of history, units English

**integration_time**
     Integration time of a time bin (s).

**polarization_array**
     Array of polarization integers, shape (Npols). AIPS Memo 117 says: stokes 1:4 (I,Q,U,V);  circular -1:-4 (RR,LL,RL,LR); linear -5:-8 (XX,YY,XY,YX)

**quality_array**

     Array of qualities of calibration solutions                 shape: (Nants_data, Nfreqs, Ntimes, Npols), type = float.

**telescope_name**
     Name of telescope. e.g. HERA. String.


**time_array**
     Array of times, center of integration, shape (Ntimes), units Julian Date

**x_orientation**
     Orientation of the physical dipole corresponding to what is labelled as the x polarization. Values are east (east/west orientation),  north (north/south orientation) or unknown.

Optional
----------------
These parameters are defined by one or more file standard but are not always required.
Some of them are required depending on the cal_type (as noted below).

**delay_array**
     Array of delays. shape: (Nants_data, Ntimes, Npols), type = float

**gain_array**
     Array of gains, shape: (Nants_data, Nfreqs, Ntimes, Npols), type = complex float.

**git_hash**
     Commit hash of calibration software(from git_origin) usedto generate solutions.<commit_msg>update docs<commit_after>Cal Parameters
==============
These are the standard attributes of UVCal objects.

Under the hood they are actually properties based on UVParameter objects.

Required
----------------
These parameters are required to have a sensible UVCal object and 
are required for most kinds of uv cal files.

**Nants_data**
     Number of antennas with data present (i.e. number of unique entries in ant_1_array and ant_2_array). May be smaller than the number of antennas in the array

**Nants_telescope**
     Number of antennas in the array. May be larger than the number of antennas with data

**Nfreqs**
     Number of frequency channels

**Npols**
     Number of polarizations

**Nspws**
     Number of spectral windows (ie non-contiguous spectral chunks). More than one spectral window is not currently supported.

**Ntimes**
     Number of times

**antenna_names**
     List of antenna names, shape (Nants_telescope), with numbers given by antenna_numbers (which can be matched to ant_1_array and ant_2_array). There must be one entry here for each unique entry in ant_1_array and ant_2_array, but there may be extras as well.

**antenna_numbers**
     List of integer antenna numbers corresponding to antenna_names,shape (Nants_telescope). There must be one entry here for each unique entry in ant_1_array and ant_2_array, but there may be extras as well.

**cal_type**
     cal type parameter. Values are delay, gain or unknown.

**channel_width**
     Channel width of of a frequency bin. Units Hz.

**flag_array**
     Array of flags to be applied to calibrated data (logical OR                  of input and flag generated by calibration). True is flagged.shape: (Nants_data, Nfreqs, Ntimes, Npols), type = bool.

>>>>>>> update docs

**freq_array**
     Array of frequencies, shape (Nspws, Nfreqs), units Hz

**gain_convention**
     The convention for applying he calibration solutions to data.Indicates that to calibrate one should divide or multiply uncalibrated data by gains.

**history**
     String of history, units English

**integration_time**
     Integration time of a time bin (s).

**polarization_array**
     Array of polarization integers, shape (Npols). AIPS Memo 117 says: stokes 1:4 (I,Q,U,V);  circular -1:-4 (RR,LL,RL,LR); linear -5:-8 (XX,YY,XY,YX)

**quality_array**

>>>>>>> update docs
     Array of qualities of calibration solutions                 shape: (Nants_data, Nfreqs, Ntimes, Npols), type = float.

**telescope_name**
     Name of telescope. e.g. HERA. String.

>>>>>>> update docs

**time_array**
     Array of times, center of integration, shape (Ntimes), units Julian Date

**x_orientation**
     Orientation of the physical dipole corresponding to what is labelled as the x polarization. Values are east (east/west orientation),  north (north/south orientation) or unknown.

Optional
----------------
These parameters are defined by one or more file standard but are not always required.
Some of them are required depending on the cal_type (as noted below).

**delay_array**
     Array of delays. shape: (Nants_data, Ntimes, Npols), type = float

**gain_array**
     Array of gains, shape: (Nants_data, Nfreqs, Ntimes, Npols), type = complex float.

**git_hash**
     Commit hash of calibration software(from git_origin) usedto generate solutions.
{'fraction_non_alphanumeric': 0.08873668188736682, 'fraction_numerical': 0.005175038051750381, 'mean_word_length': 3.778909090909091, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 24, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4787487', 'n_tokens_mistral': 1903, 'n_tokens_neox': 1798, 'n_words': 846}