psf_retriever

acstools.focus_diverse_epsfs.psf_retriever(ipsoot, download_location, timeout=60)

Function to query API on AWS API Gateway for the ePSF FITS file that corresponds to a given image rootname.

Warning

There is no caching. Please check that you do not have the file already downloaded before running this function again. Any existing local file with the same name might be overwritten.

Parameters:

  • ipsoot (str) – Image rootname in the form of IPPPSSOOT.

  • download_location (str) – Directory name where the file will be downloaded to. It must exist and you must have write permission to it.

  • timeout (float) – Seconds before query timeout.

Returns:

desired_filename – The downloaded ePSF FITS file, if successful.

Return type:

str or None