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:
ipsootstr

Image rootname in the form of IPPPSSOOT.

download_locationstr

Directory name where the file will be downloaded to. It must exist and you must have write permission to it.

timeoutfloat

Seconds before query timeout.

Returns:
desired_filenamestr or None

The downloaded ePSF FITS file, if successful.