ALMA FITS Keywords: Difference between revisions

From Italian ARC
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:


The ALMA Keywords Filler (AKF) is a Python-based script that exploits existing CASA tasks and  toolkit (https://casa.nrao.edu/docs/CasaRef/CasaRef.html)
The ALMA Keywords Filler (AKF) is a Python-based script that exploits existing CASA tasks and  toolkit (https://casa.nrao.edu/docs/CasaRef/CasaRef.html) <br>
It consists of two codes (that could eventually be called in sequence), each of which addresses one of the keyword categories described in Sect. 3 and ingests the resulting keywords in the header of an input image.
It consists of two codes (that could eventually be called in sequence), each of which addresses one of the keyword categories described in Sect. 3 and ingests the resulting keywords in the header of an input image.
1. AKF_v1.0_ms.py: it generates the keywords listed in Sect. 3.1. It requires that (only) the  ms from which the input FITS image was produced is in the same folder as the image. Since the program browses the ms tables, it can take some minutes to run (and up to ~30 min for the biggest datasets as large as 100 Gb). However, it is possible to request the production of only specific keywords.
1. AKF_v1.0_ms.py: it generates the keywords listed in Sect. 3.1. It requires that (only) the  ms from which the input FITS image was produced is in the same folder as the image. Since the program browses the ms tables, it can take some minutes to run (and up to ~30 min for the biggest datasets as large as 100 Gb). However, it is possible to request the production of only specific keywords.

Revision as of 14:37, 22 December 2017

The ALMA Keywords Filler (AKF) is a Python-based script that exploits existing CASA tasks and toolkit (https://casa.nrao.edu/docs/CasaRef/CasaRef.html)
It consists of two codes (that could eventually be called in sequence), each of which addresses one of the keyword categories described in Sect. 3 and ingests the resulting keywords in the header of an input image. 1. AKF_v1.0_ms.py: it generates the keywords listed in Sect. 3.1. It requires that (only) the ms from which the input FITS image was produced is in the same folder as the image. Since the program browses the ms tables, it can take some minutes to run (and up to ~30 min for the biggest datasets as large as 100 Gb). However, it is possible to request the production of only specific keywords. 2. AKF_v1.0_fits.py: it generates the keywords listed in Sect. 3.2. It calculates the values from the image itself and it is usually faster than the ms code. Also in this case it is possible to produce all or a selection of the keywords.

The result of the codes is a Python dictionary as reported in the Fig. 1. The code could be recovered from the Italian ALMA Regional Center web page (http://www.alma.inaf.it/index.php/ALMA_FITS_Keywords)

In the following, the instructions to launch the codes are described:

  • enter the folder (yourDir) where your fits files and ms are stored
  • launch CASA (any version > 5.0)
  • define the image to process
  • imageName = 'yourDir/yourImage.fits'
  • define the list of keywords you want calculate
  • kwdlist =['KWDi', 'KWDj',......, 'KWDk'] where KWDi,j,k are one or more keywords belong to the same category, either data acquisition or image description keywords
  • launch the correct code according to the requested category of keywords with
  execfile('AKF_v1.0_ms.py') and/or execfile('AKF_v1.0_fits.py') 


ALMA FITS Keywords from ms