Sunspot Band6 SingleDish for CASA 6.5.4: Difference between revisions

From CASA Guides
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
[[Category:ALMA]][[Category:Sun]][[Category:Continuum]][[Category:Calibration‏‎]]
[[Category:ALMA]][[Category:Sun]][[Category:Continuum]][[Category:Calibration‏‎]]
{{checked_6.5.4}}


==Overview==
==Overview==
This portion of the Sunspot Band6 CASA Guide for CASA 5.1 will cover the calibration and imaging of the data obtained with the TP array.
{{CARTA_6.5.4}}


From next, we will show all commands for the calibration and be creating the map of a full Sun with Band6.
This portion of the guide will cover the calibration and imaging of the data obtained with the Total Power array. We create the map of a full Sun with Band6.


==Import the data and split into the files for each antenna==
==Import the data and split into the files for each antenna==
Line 10: Line 11:


<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
sduid ='uid___A002_Xae00c5_X2e6b'
sduid ='uid___A002_Xae00c5_X2e6b'
sdmsd = sduid + '.ms'
sdmsd = sduid + '.ms'
Line 18: Line 19:
import numpy as np
import numpy as np
</source>
</source>
In the tutorial, we will use the data obtained with the PM03 antenna.  
In the tutorial, we will use the data obtained with the PM03 antenna.  


Before we can proceed to the calibration, we will need to convert those data to the CASA MS format. This is done simply with the task {{importasdm}}.
Before we can proceed to the calibration, we will need to convert those data to the CASA MS format. This is done simply with the task {{importasdm_6.5.4}}.
 
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
importasdm(asdm=sduid,with_pointing_correction=True, verbose=True,vis=sdmsd,overwrite=True)
importasdm(asdm=sduid,with_pointing_correction=True, verbose=True,vis=sdmsd,overwrite=True)
</source>
</source>
The usual first step is then to get some basic information about the data.  
The usual first step is then to get some basic information about the data.  
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
listobs(sdmsd, listfile = sduid + '.listobs')
listobs(sdmsd, listfile = sduid + '.listobs')
</source>
</source>


==Calibration ==
==Calibration ==
In the observation, the atmospheric calibration was done before the fast-scanning of the Sun. We use the calibration date to apply the solar data using the option ‘ps, tsys, apply’ for the ‘calmode’.
In the observation, the atmospheric calibration was done before the fast-scanning of the Sun. We use the calibration date to apply the solar data using '''calmode = '.ps, tsys, apply'''.
 
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
sdcal(infile=sdmsd, calmode = 'ps,tsys,apply', spw='0,1,2,3')
sdcal(infile=sdmsd, calmode = 'ps,tsys,apply', spw='0,1,2,3')
split(vis = sdmsd, spw = '0,1,2,3', outputvis = sdmsc, scan = '2', datacolumn = 'corrected', keepflags = True)
split(vis = sdmsd, spw = '0,1,2,3', outputvis = sdmsc, scan = '2', datacolumn = 'corrected', keepflags = True)
Line 42: Line 46:
Based on the commissioning observations, the average correction factor of the PM antennas with Band6 is 0.862, which enables us to calibrate the observed antenna temperature to the absolute brightness temperature. We will calibrate using the value, as follows.
Based on the commissioning observations, the average correction factor of the PM antennas with Band6 is 0.862, which enables us to calibrate the observed antenna temperature to the absolute brightness temperature. We will calibrate using the value, as follows.
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
gencal(vis=sdmsc,caltable=sduid+'.cal.eff.tbl', caltype='amp', spw='',parameter=[np.sqrt(0.862)])
gencal(vis=sdmsc,caltable=sduid+'.cal.eff.tbl', caltype='amp', spw='',parameter=[np.sqrt(0.862)])
applycal(vis=sdmsc, gaintable=sduid+'.cal.eff.tbl')
applycal(vis=sdmsc, gaintable=sduid+'.cal.eff.tbl')
Line 50: Line 54:


==Imaging==
==Imaging==


[[File:sunspot_fullsun1.png|thumb|right|'''Fig. 1.''' The full-sun image with Band6]]
[[File:sunspot_fullsun1.png|thumb|right|'''Fig. 1.''' The full-sun image with Band6]]
Line 56: Line 59:
To create the full sun map, we use the data of the spectrum window #3 obtained with the PM03 antenna. The command for the process is as follows.
To create the full sun map, we use the data of the spectrum window #3 obtained with the PM03 antenna. The command for the process is as follows.
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
sd_img =sduid+ '.'+ant+'.StkI.Spw3'  
sd_img =sduid+ '.'+ant+'.StkI.Spw3'  
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['3.0arcsec','3.0arcsec'], outfile = sd_img, imsize=[800,800], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['3.0arcsec','3.0arcsec'], outfile = sd_img, imsize=[800,800], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')
</source>
</source>
After finishing the process successfully, you can see the full-sun image as shown in Figure 1.
After finishing the process successfully, you can see the full-sun image as shown in Figure 1.
When you carry out the imaging of Band3 data, we recommend the following parameters for the {{sdimaging}} task.
When you carry out the imaging of Band3 data, we recommend the following parameters for the {{sdimaging_6.5.4}} task.
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['6.0arcsec','6.0arcsec'], outfile = sd_img, imsize=[400,400], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['6.0arcsec','6.0arcsec'], outfile = sd_img, imsize=[400,400], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')
</source>
</source>
Line 72: Line 75:


<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
res = imstat(sd_img+'.image', region='circle[[400pix,400pix],80pix]')
res = imstat(sd_img+'.image', region='circle[[400pix,400pix],80pix]')
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(5900./res['mean'][0]), outfile = sd_img+'.rescl')
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(5900./res['mean'][0]), outfile = sd_img+'.rescl')
Line 79: Line 82:
For Band3
For Band3
<source lang='python'>
<source lang='python'>
#In Casa
#In CASA
res = imstat(sd_img+'.image', region='circle[[200pix,200pix],40pix]')   
res = imstat(sd_img+'.image', region='circle[[200pix,200pix],40pix]')   
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(7300./res['mean'][0]), outfile = sd_img+'.rescl')
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(7300./res['mean'][0]), outfile = sd_img+'.rescl')
</source>
</source>


'''Note: All full-sun images that are included in the SV data package (ex. Sunspot_Band6_ReferenceImages.tgz) were not applied the re-scaling because the SV data were released before publishing White et al. (2017). When you use the full-sun image of the SV data for your studies, you should be done the re-scaling process. While the archive data obtained in Cycles were applied the re-scaling process.'''
<font color="red">
Note: All full-sun images that are included in the SV data package (ex. Sunspot_Band6_ReferenceImages.tgz) were not applied the re-scaling because the SV data were released before publishing White et al. (2017). When you use the full-sun image of the SV data for your studies, you should be done the re-scaling process. While the archive data obtained in Cycles were applied the re-scaling process.
</font>

Revision as of 19:15, 3 April 2024

Last checked on CASA Version 6.5.4

Overview

This guide features CARTA, the “Cube Analysis and Rendering Tool for Astronomy,” which is the new NRAO visualization tool for images and cubes. The CASA viewer (imview) has not been maintained for a few years and will be removed from future versions of CASA. We strongly recommend using CARTA, as it provides a much more efficient, stable, and feature rich user experience. A comparison of the CASA viewer and CARTA, as well as instructions on how to use CARTA at NRAO, is provided in the CARTA section of the CASA docs.

This portion of the guide will cover the calibration and imaging of the data obtained with the Total Power array. We create the map of a full Sun with Band6.

Import the data and split into the files for each antenna

We assume that you already complete the calibration of the visibility data along the Sunspot Band6 Calibration for CASA 5.1, and you are working in the directory ‘Sunspot_Band6_UncalibratedData’. After starting CASA, we start by defining the directory name of the ASDM and Measurement set for the calibration.

#In CASA
sduid ='uid___A002_Xae00c5_X2e6b'
sdmsd = sduid + '.ms'
sdmsc = sdmsd + '.split.cal'
ant='PM03'

import numpy as np

In the tutorial, we will use the data obtained with the PM03 antenna.

Before we can proceed to the calibration, we will need to convert those data to the CASA MS format. This is done simply with the task importasdm.

#In CASA
importasdm(asdm=sduid,with_pointing_correction=True, verbose=True,vis=sdmsd,overwrite=True)

The usual first step is then to get some basic information about the data.

#In CASA
listobs(sdmsd, listfile = sduid + '.listobs')

Calibration

In the observation, the atmospheric calibration was done before the fast-scanning of the Sun. We use the calibration date to apply the solar data using calmode = '.ps, tsys, apply.

#In CASA
sdcal(infile=sdmsd, calmode = 'ps,tsys,apply', spw='0,1,2,3')
split(vis = sdmsd, spw = '0,1,2,3', outputvis = sdmsc, scan = '2', datacolumn = 'corrected', keepflags = True)

Unlike non-solar single-dish observations, the flux calibrator is not observed in solar single-dish observations in Cycle 4. Therefore, we have to calibrate the data using a correction factor which includes various antenna efficiencies of the PM antenna.

Based on the commissioning observations, the average correction factor of the PM antennas with Band6 is 0.862, which enables us to calibrate the observed antenna temperature to the absolute brightness temperature. We will calibrate using the value, as follows.

#In CASA
gencal(vis=sdmsc,caltable=sduid+'.cal.eff.tbl', caltype='amp', spw='',parameter=[np.sqrt(0.862)])
applycal(vis=sdmsc, gaintable=sduid+'.cal.eff.tbl')

Caution: The correction factor in this document is written in White et al. (2017)

Imaging

Fig. 1. The full-sun image with Band6

To create the full sun map, we use the data of the spectrum window #3 obtained with the PM03 antenna. The command for the process is as follows.

#In CASA
sd_img =sduid+ '.'+ant+'.StkI.Spw3' 
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['3.0arcsec','3.0arcsec'], outfile = sd_img, imsize=[800,800], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')

After finishing the process successfully, you can see the full-sun image as shown in Figure 1. When you carry out the imaging of Band3 data, we recommend the following parameters for the sdimaging task.

#In CASA
tsdimaging(infiles = sdmsc, spw = '3', antenna =ant, field='0', nchan = 1, cell = ['6.0arcsec','6.0arcsec'], outfile = sd_img, imsize=[400,400], gridfunction = 'SF', convsupport = 6, intent ='*ON_SOURCE*', stokes = 'I')

Calibration (re-scaling) after Imaging

White et al. (2017) recommended that the standard ALMA single-dish image products be scaled to match their best determination of quiet-Sun temperatures at disk center (specifically, 5900 K averaged over an 80″-square region centered on the apparent disk center at Band 6, and 7300 K averaged over a 120″-square region centered on the apparent disk center at Band 3, with uncertainties of about 100 K). For the re-scaling, the following commands are executed.

#In CASA
res = imstat(sd_img+'.image', region='circle[[400pix,400pix],80pix]')
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(5900./res['mean'][0]), outfile = sd_img+'.rescl')

For Band3

#In CASA
res = imstat(sd_img+'.image', region='circle[[200pix,200pix],40pix]')  
immath(imagename=sd_img+'.image', expr = 'IM0*'+str(7300./res['mean'][0]), outfile = sd_img+'.rescl')

Note: All full-sun images that are included in the SV data package (ex. Sunspot_Band6_ReferenceImages.tgz) were not applied the re-scaling because the SV data were released before publishing White et al. (2017). When you use the full-sun image of the SV data for your studies, you should be done the re-scaling process. While the archive data obtained in Cycles were applied the re-scaling process.