Skip to main content

katbeam

Primary beam model library for the MeerKAT project, providing functionality to compute simplified beam patterns of MeerKAT antennas.

JimBeam class

MeerKAT simplified primary beam models for L and UHF bands

A cosine aperture taper (Essential Radio Astronomy, Condon & Ransom, 2016, page 83, link) is used as a simplified model of the co-polarisation primary beams. While the sidelobe level accuracy may be coincidental, the model attains a good fit to measurements for the mainlobe region. The model is parameterised by measured frequency dependent pointing, and frequency dependent full width half maximum beam widths (FWHM). The MeerKAT beams are measured using holography techniques, and an averaged result at 60 degrees elevation is used here to determine the frequency dependent parameter values. The pointing errors are determined in the aperture plane using standard phase fitting techniques, while the FWHM values are measured in the beam plane along axis-aligned cuts through the beam centers.

Notes:

  1. This model is a simplification.

  2. The actual beam varies per antenna, and depends on environmental factors.

  3. Since per-antenna pointing errors during an observation often exceed 1 arc minute, the nett ‘imaging primary beam’ will be slightly broader, and could be approximated by averaging several individual antenna beams with respective antenna pointing errors inserted.

  4. Depending on the usecase it may be necessary to do reference pointing (or use another technique) to remove the antenna pointing errors during the observation in order to use a beam model successfully.

Request:

As a user, please email the author (mattieu@ska.ac.za) with details about your usecase requirements. This may influence future releases. A general description, what extent of the beams are needed, pixelation, frequency resolution, and accuracy requirements are of interest.

Example usage:

import matplotlib.pylab as plt
from katbeam import JimBeam

def showbeam(beam,freqMHz=1000,pol='H',beamextent=10.):
    margin=np.linspace(-beamextent/2.,beamextent/2.,128)
    x,y=np.meshgrid(margin,margin)
    if pol=='H':
        beampixels=beam.HH(x,y,freqMHz)
    elif pol=='V':
        beampixels=beam.VV(x,y,freqMHz)
    else:
        beampixels=beam.I(x,y,freqMHz)
        pol='I'
    plt.clf()
    plt.imshow(beampixels,extent=[-beamextent/2,beamextent/2,-beamextent/2,beamextent/2])
    plt.title('%s pol beam\nfor %s at %dMHz'%(pol,beam.name,freqMHz))
    plt.xlabel('deg')
    plt.ylabel('deg')

uhfbeam=JimBeam('MKAT-AA-UHF-JIM-2020')
showbeam(uhfbeam,800,'H',10)

History

0.1 (2020-10-15)

  • Initial release of katbeam

Metadata

Release files for katbeam 0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for katbeam 0.1
File Size Uploaded Provenance Actions
katbeam-0.1.tar.gz 5.8 kB Without provenance Details for katbeam-0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for katbeam 0.1
File Interpreter ABI Platform Actions
katbeam-0.1-py2.py3-none-any.whl Python 3, Python 2 none any Details for katbeam-0.1-py2.py3-none-any.whl

Total release size: 13.7 kB

Release files / katbeam-0.1.tar.gz

Download URL katbeam-0.1.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c75e54074108366dd712b53469a8dcdcf8128dc58767917f7cc3559a3b223bd9
BLAKE2b-256 checksum
How to use checksums
f795f21ebfbbf20f11b1b6165edfc9e5fb6a3c0e8eb35cc02aa69e933f441edd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5

Release files / katbeam-0.1-py2.py3-none-any.whl

Download URL katbeam-0.1-py2.py3-none-any.whl
Size 7.9 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
1f898ca127d2acca611e0a953fbb578b2f4a01895226e8f8232afa1db480b6b5
BLAKE2b-256 checksum
How to use checksums
8bd19c86d23ac5c9c616de94c28d9d5cb1881f16c0c9f7c2343234e073ae19dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5

Security for katbeam 0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page