TART: Radio-telescope command line tools

This module provides command line tools for operating Transient Array Radio Telescope (TART). These tools are

• tart_calibrate
• tart_calibration_data
• tart_download_antenna_positions
• tart_upload_antenna_positions
• tart_get_archive_data
• tart_download_data
• tart_download_gains
• tart_image
• tart_upload_gains
• tart_set_mode
• tart_vis2json

To generate an image from a telescope, try the following command which should display the current view from a telescope on top of Signal-Hill near Dunedin New Zealand.

tart_image --api https://tart.elec.ac.nz/signal --display

For more information see the TART website

Install Instructions

tart_tools is available from standard python package repositories. Try:

pip3 install tart_tools

Authors

• Tim Molteno (tim@elec.ac.nz)
• Max Scheel (max@max.ac.nz)

Development work

If you are developing this package, this should be installed using

	make develop

in which case changes to the source-code will be immediately available to projects using it.

NEWS

• 1.4.6 Bug fixes - tart_download_data: default --n -1 no longer skips the newest entry. Negative n now means "download everything" (previously [0:-1] slicing dropped the most recent file on each pass). - tart_get_archive_data: --name is now honoured as the output file name prefix (it was previously parsed but ignored). The default prefix remains 'obs_', producing files like 'obs_00000.hdf'. - Replace 'from tart_tools.common_api import *' with an explicit import of api_parameter in all command line tools to remove undefined-name warnings.

• 1.4.5 Use common command line parameter functions for api to allow better documentation.

• 1.4.4 Use explicit parameter names for all minio calls.

• 1.4.3 Use the new TART s3 public bucket for archive access

• 1.4.2 Make download_file download to a temporary file before copying to actual file.

• 1.4.0 Add an archive_handler

• 1.3.0 Huge refactor to get tests going again.

• 1.2.2 Add a backoff factor. So that failed requests are delayed

• 1.2.1 Add retry logic to the requests.get methods.

• 1.2.0b3 Update links to the github repository.

• 1.2.0b2 tart_get_archive_data: Use a five digit leading-zeros number for multiple downloads, default to all data if --n is not specified

• 1.2.0b1 new tool: tart_get_archive_data super convenient to query the AWS cloud archive of TART data.

• 1.1.2b8 Add an argument --rotate to tart_upload_antenna_positions (for first stage of calibration)

• 1.1.2b7 Handle expiration of JWT tokens better (in tart_tools)

• 1.1.2b7 TART tools update. Add a command line switch to specify output file for tart_download_data'

• 1.1.2b6 Pass the lat and lon to catalog_url

• 1.1.2b5 Require the python-dateutil library

• 1.1.2b4 Require the requests library

• 1.1.2b3 Change API of catalog_url to use lon and lat explicitly

• 1.1.2b1 Fix a missing checksum call if a local file was partially downloaded (tart_download_data).

• 1.1.2b0 Make h5 to json compatible with tart2ms json import.

• 1.1b.8 New versioning to match tart. Move to new repository

• 0.2.0b14. Improve API handler code.

• 0.2.0b13. Clean up code to use other API endpoints. Add CLI to --ignore some antennas Add --n option to tart_download_data to stop after n downloads (used to grab the latest raw file) Add CLI to use the influxdb

• 0.2.0b12. Fix bug in get-gains option.

• 0.2.0b11. Add a tart_set_mode binary.

• 0.2.0b9. Add a timeout to all HTTP requests.

• 0.2.0b8. Add a put method to the authorized api handler.

• 0.2.0b7. Fix typo in tart_calibrate that stopped calibration working.

• 0.2.0. New tart_download_data function.

• 0.1.5. Python3 compatability changes