ALMAguides: Difference between revisions

From CASA Guides
Jump to navigationJump to search
No edit summary
No edit summary
(41 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<font size = 3>'''[[How_To_Use_A_CASAGuide | How to use these CASA Tutorials]]'''</font size>  
== <font size = 3>'''Introduction'''</font size> ==


This page contains tutorials to guide new ALMA users through some common types of data imaging and analysis using example ALMA datasets. In addition, we provide detailed guides to the calibration and imaging of some of the publicly-available ALMA Science Verification data that illustrate several different ALMA capabilities.


If you are a new user of CASA, take a look at [[Getting_Started_in_CASA | Getting Started in CASA]].


If you are new to CASAguides, start with [[How_To_Use_A_CASAGuide | How to use these CASA Tutorials]].
== <font size = 3> '''General Imaging Tutorials''' </font size> ==
The following tutorials use example ALMA datasets to guide new CASA users through the basic steps required for imaging and self-calibration.  ALMA data are delivered with standard calibrations applied and they are ready for imaging.
''These guides have been updated to work in CASA 5.4.0, and to use {{tclean}} rather than {{clean}}. To understand the differences between clean and tclean, please see the guide: [[TCLEAN_and_ALMA | Examples for using the new tclean CASA task for ALMA Imaging]]. ''
* [[First_Look_at_Imaging | A first look at imaging in CASA]]:  This guide gives a first look at imaging and image analysis in CASA.
* [[First_Look_at_Self_Calibration | A first look at self-calibration in CASA]]:  This guide demonstrates continuum self-cal.
* [[First_Look_at_Line_Imaging | A first look at spectral line imaging in CASA]]:  This guide shows imaging of a spectral line.
* [[First_Look_at_Image_Analysis | A first look at image analysis in CASA]]:  This guide demonstrates moment creation and basic image analysis.
Community Day Tutorials:
* [[First_Look_at_Imaging_CDE | A first look at imaging in CASA]]:  This guide gives a first look at imaging and image analysis in CASA.
* [[First_Look_at_Self_Calibration_CDE | A first look at self-calibration in CASA]]:  This guide demonstrates continuum self-cal.
* [[First_Look_at_Line_Imaging_CDE | A first look at spectral line imaging in CASA]]:  This guide shows imaging of a spectral line.
* [[First_Look_at_Image_Analysis_CDE | A first look at image analysis in CASA]]:  This guide demonstrates moment creation and basic image analysis.
'''New!'''
* [[Automasking_Guide | A guide to automasking]]: This guide demonstrates the automasking functionality of {{tclean}}.
You can find archived versions of the first look guides for older versions of CASA [[Archived_ALMA_CASAguides | here]].
== <font size = 3>'''Information for ALMA users wishing to reprocess or reimage ALMA data'''</font size> ==
* [[ALMA_Imaging_Pipeline_Reprocessing | Examples for ALMA Imaging Pipeline Reprocessing]]
<!--
<!--
** [[ALMA_Cycle_4_Imaging_Pipeline_Reprocessing | Cycle 4 Examples]]
** [[ALMA_Cycle_5_Imaging_Pipeline_Reprocessing | Cycle 5 Examples]]
-->
-->
<font size = 3>'''Imaging Tutorials for CASA beginners'''</font size>


If you are new to CASA, start with the following tutorials.  ALMA data are delivered with standard calibrations applied and they are ready for imaging.  These guides cover the basic steps required for imaging and self-calibration.
* [[Guide_NA_ImagingTemplate | A guide for using the North American ALMA Manual Imaging Template]]


* [[First_Look_at_Imaging | A first look at imaging in CASA]]  This guide gives a first look at imaging and image analysis in CASA.
== <font size = 3>'''CASAguides for reducing ALMA Science Verification data'''</font size> ==
* [[First_Look_at_Self_Calibration | A first look at self-calibration in CASA]]  This guide demonstrates continuum self-cal.
* [[First_Look_at_Line_Imaging | A first look at spectral line imaging in CASA]]  This guide shows imaging of a spectral line.
* [[First_Look_at_Image_Analysis | A first look at image analysis in CASA]]  This guide demonstrates moment creation and basic image analysis.


The links below lead to overview pages for each science verification observation. The guides themselves are linked from the overview pages.  These guides are useful tools for those who would like to learn the process of calibration and imaging in detail.


<font size = 3>'''Guides for reducing ALMA Science Verification data'''</font size>
''The following ALMA science verification guides are currently being updated, and have been validated for the CASA versions listed. ''


The links below lead to overview pages for each science verification observation. The guides themselves are linked from the overview pages. These guides are a useful tools for those who would like to learn the process of calibration and imaging in detail.
* [[AntennaeBand7 | AntennaeBand7]]: Mosaic of the galaxy merger NGC 4038/4039 (Antennae) at Band 7 (0.87 mm). Validated for CASA 5.4.  
* [[M100_Band3]]: Demonstration of combining 12m-array, 7m-array, and Total Power data for M100. Validated for CASA 5.4.
* [[IRAS16293Band9 | IRAS16293Band9]]: Mosaic of the protostellar cluster IRAS16293-2422 at Band 9 (0.45 mm). Validated for CASA 5.4.
* [[3C286_Polarization]]: Demonstration of the reduction of ALMA continuum polarization toward the quasar 3C286. Validated for CASA 5.4.
* [[Sunspot_Band6]]: Demonstration of the reduction and imaging of the sunspot data at Band 6 (1.25mm). Validated for CASA 5.4.


''The following ALMA science verification guides have been validated for CASA version 4.3.  They should also work for CASA version 4.4 and later versions, without modification.''
== <font size = 3>'''Legacy guides and scripts for reducing ALMA Science Verification data'''</font size> ==


* [[TWHydraBand7 | TWHydraBand7]]: The protoplanetary disk source TW Hya at Band 7 (0.87 mm)
''The following ALMA science verification guides and scripts have been validated for older versions of CASA, and will not continue to be updated for new CASA releases. ''
* [[NGC3256Band3 | NGC3256Band3]]: The galaxy merger NGC 3256 at Band 3 (3 mm)
 
* [[AntennaeBand7 | AntennaeBand7]]: Mosaic of the galaxy merger NGC 4038/4039 (Antennae) at Band 7 (0.87 mm)
* [[TWHydraBand7 | TWHydraBand7]]: The protoplanetary disk source TW Hya at Band 7 (0.87 mm). Last validated for CASA 4.3.
* [[IRAS16293Band9 | IRAS16293Band9]]: Mosaic of the protostellar cluster IRAS16293-2422 at Band 9 (0.45 mm)
* [[NGC3256Band3 | NGC3256Band3]]: The galaxy merger NGC 3256 at Band 3 (3 mm). Last validated for CASA 4.3.  
* [[File:BR1202_SV_Band7_Calibration_notes.pdf | BR1202_SV_Band7_Calibration_notes]]: Supplemental notes on the calibration of Science Verification target BR1202-0725 in CASA 3.3
* [[ALMA2014_LBC_SVDATA]]: Imaging scripts and details for the 2014 ALMA Long Baseline Campaign science verification data for Juno, Mira, HL Tau, and SDP.81. Last validated for CASA 4.2.2.  
* [[ALMA2014_LBC_SVDATA]]: Imaging scripts and details for the 2014 ALMA Long Baseline Campaign science verification data for Juno, Mira, HL Tau, and SDP.81.
* [[File:BR1202_SV_Band7_Calibration_notes.pdf | BR1202_SV_Band7_Calibration_notes]]: Supplemental notes on the calibration of Science Verification target BR1202-0725 in CASA 3.3.
* [[M100_Band3]]: Demonstration of combining 12m-array, 7m-array, and Total Power data for M100 using CASA 4.3.1
* [[3C286_Polarization]]: Demonstration of the reduction of ALMA continuum polarization toward the quasar 3C286


<!--
<!--
Line 37: Line 69:
**[[3C286_Polarization_Calibration_4.2.2]]
**[[3C286_Polarization_Calibration_4.2.2]]
**[[3C286_Polarization_Imaging_4.2.2]]
**[[3C286_Polarization_Imaging_4.2.2]]
[[Automasking_Guide]]
-->
-->


<font size = 3>'''[[DataWeightsAndCombination | A Guide to CASA Data Weights and How to Ensure They are Correct for Data Combination]]'''</font size>  
== <font size = 3>'''Additional information on relevant techniques and tools for ALMA data '''</font size> ==


* [[DataWeightsAndCombination | A Guide to CASA Data Weights and How to Ensure They are Correct for Data Combination]]


<font size = 3>'''[[ALMA_Imaging_Pipeline_Reprocessing | Examples for ALMA Imaging Pipeline Reprocessing]]'''</font size>
* [[TCLEAN_and_ALMA | Examples for using the new tclean CASA task for ALMA Imaging]]


* [[Analysis Utilities]] -- a Python module containing utilities for analysis and plotting.


<font size = 3>'''[[TCLEAN_and_ALMA | Examples for using the new tclean CASA task for ALMA Imaging]]'''</font size>
* [[Solar System Models in CASA 4.0 | Solar System Models in CASA 4.0]] and beyond
 
<!--
<font size = 3>'''[[Guide_NA_ImagingTemplate | A guide for Using the North American ALMA Manual Imaging Template]]'''</font size>
-->
 
<font size = 3>'''[http://almascience.org/alma-data/science-verification/tutorial-alma-solar-science-verification-data Tutorial: ALMA Solar Science Verification Data]'''</font size>


* Tutorials related to ALMA Solar Science Verification Data: [http://almascience.org/alma-data/science-verification/tutorial-alma-solar-science-verification-data CASA 4.7]


<font size = 3>'''[[Guide_To_Processing_ALMA_Data_for_Cycle_0 | A Guide to Processing ALMA Data for Cycle 0]]'''</font size>  
== <font size = 3>'''Processing Cycle 0 data from the ALMA archive'''</font size> ==


This page takes you through the steps of processing Cycle 0 data from the ALMA data archive.  The guide describes some helpful hints for downloading the data, and describes the process all the way through imaging and self-calibration, and image analysis.
[[Guide_To_Processing_ALMA_Data_for_Cycle_0 | A Guide to Processing ALMA Data for Cycle 0]] (last checked in CASA 4.2) takes you through the steps of processing Cycle 0 data from the ALMA data archive.  The guide describes some helpful hints for downloading the data, and describes the process all the way through imaging and self-calibration, and image analysis.  


You can also get a look at example data calibration scripts used for Cycle 0 data at the following links.  These were written for CASA version 3.4.
You can also get a look at example data calibration scripts used for Cycle 0 data at the following links.  These were written for CASA version 3.4.
* TDM (128 channels/spw) [[File:TDM.example.ms.scriptForCalibration.py]]
* TDM (128 channels/spw) [[File:TDM.example.ms.scriptForCalibration.py]]
* FDM (3840 channels/spw) [[File:FDM.example.ms.scriptForCalibration.py]]
* FDM (3840 channels/spw) [[File:FDM.example.ms.scriptForCalibration.py]]
* If you need to update 3.4 scripts to 4.2, see more information [[Updating_a_script_to_work_with_CASA_4.2|here]]
* If you need to update 3.4 scripts to 4.2 or later, see more information [[Updating_a_script_to_work_with_CASA_4.2|here]]


== <font size = 3>'''Simulating ALMA data'''</font size> ==


<font size = 3>'''[[Guide_To_Simulating_ALMA_Data | A Tutorial for Simulating ALMA Data.]]'''</font size>
Start here to learn about simulations: [[Guide_To_Simulating_ALMA_Data | A Tutorial for Simulating ALMA Data.]]  


Start here to learn about simulations.  The CASA 4.3 simulation examples in the above tutorial should also work for version 4.4, and they will be validated for version 4.4 soon.  Jump directly to the simulations examples with the following links.
Jump directly to the simulation examples with [[Simulating Observations in CASA 5.1 | Simulation Examples in CASA 5.1]].
[[Simulating Observations in CASA 4.3 | Simulation Examples in CASA 4.3]]
*  Examples for older versions of CASA: [[Simulating Observations in CASA 4.2 | 4.2]]  [[Simulating Observations in CASA 4.1 | 4.1]]  [[Simulating Observations in CASA 4.0 | 4.0]]  [[Simulating Observations in CASA 3.4 | 3.4]] [[Simulating Observations in CASA 3.3 | 3.3]]


<!--
*  Examples for older versions of CASA:[[Simulating Observations in CASA 4.4 | Simulation Examples in CASA 4.4]]  [[Simulating Observations in CASA 4.2 | 4.2]]  [[Simulating Observations in CASA 4.1 | 4.1]]  [[Simulating Observations in CASA 4.0 | 4.0]]  [[Simulating Observations in CASA 3.4 | 3.4]]  [[Simulating Observations in CASA 3.3 | 3.3]]
-->


* <font size = 3>'''[[Analysis Utilities]] -- a Python module containing utilities for analysis and plotting.'''</font size>
== <font size = 3> '''Old guides for other telescopes''' </font size> ==
 
 
* <font size = 3>'''[[Solar System Models in CASA 4.0 | Solar System Models in CASA 4.0]]''' and beyond</font size>
 
 
* <font size = 3>'''[[Current MM/Submm Guides | Other MM/Submm CASA Guides]]'''
 


* <font size = 3>'''[[Main_Page | Main casaguides page with additional information]]'''</font size>
Several older millimeter/submillimeter casaguides that may be of interest to users are listed in [[Past_MM/Submm_Guides | Past MM/Submm CASA Guides]]. Note that they are not currently being maintained and have been last validated for the CASA version listed beside each.


For CASA guides that focus on VLA data, please see [[Karl G. Jansky VLA Tutorials]].


* <font size = 3>'''Other useful Information'''</font size>
== <font size = 3>'''Other useful Information'''</font size> ==
** [http://casa.nrao.edu CASA homepage including download and installation information]
* [http://almascience.org/ ALMA Science homepage]  
** [http://science.nrao.edu/alma/ALMA-QuickRef.gif ALMA Quick Reference]
* [http://casa.nrao.edu CASA homepage including download and installation information]
** [https://almascience.nrao.edu/call-for-proposals/sensitivity-calculator ALMA Sensitivity Calculator]
* [https://almascience.nrao.edu/about-alma/proposing/sensitivity-calculator ALMA Sensitivity Calculator]
* [[HTT2 | CASA Hints, Tips & Tricks]]





Revision as of 14:34, 12 June 2019

Introduction

This page contains tutorials to guide new ALMA users through some common types of data imaging and analysis using example ALMA datasets. In addition, we provide detailed guides to the calibration and imaging of some of the publicly-available ALMA Science Verification data that illustrate several different ALMA capabilities.

If you are a new user of CASA, take a look at Getting Started in CASA.

If you are new to CASAguides, start with How to use these CASA Tutorials.

General Imaging Tutorials

The following tutorials use example ALMA datasets to guide new CASA users through the basic steps required for imaging and self-calibration. ALMA data are delivered with standard calibrations applied and they are ready for imaging.

These guides have been updated to work in CASA 5.4.0, and to use tclean rather than clean. To understand the differences between clean and tclean, please see the guide: Examples for using the new tclean CASA task for ALMA Imaging.


Community Day Tutorials:


New!

You can find archived versions of the first look guides for older versions of CASA here.

Information for ALMA users wishing to reprocess or reimage ALMA data

CASAguides for reducing ALMA Science Verification data

The links below lead to overview pages for each science verification observation. The guides themselves are linked from the overview pages. These guides are useful tools for those who would like to learn the process of calibration and imaging in detail.

The following ALMA science verification guides are currently being updated, and have been validated for the CASA versions listed.

  • AntennaeBand7: Mosaic of the galaxy merger NGC 4038/4039 (Antennae) at Band 7 (0.87 mm). Validated for CASA 5.4.
  • M100_Band3: Demonstration of combining 12m-array, 7m-array, and Total Power data for M100. Validated for CASA 5.4.
  • IRAS16293Band9: Mosaic of the protostellar cluster IRAS16293-2422 at Band 9 (0.45 mm). Validated for CASA 5.4.
  • 3C286_Polarization: Demonstration of the reduction of ALMA continuum polarization toward the quasar 3C286. Validated for CASA 5.4.
  • Sunspot_Band6: Demonstration of the reduction and imaging of the sunspot data at Band 6 (1.25mm). Validated for CASA 5.4.

Legacy guides and scripts for reducing ALMA Science Verification data

The following ALMA science verification guides and scripts have been validated for older versions of CASA, and will not continue to be updated for new CASA releases.

  • TWHydraBand7: The protoplanetary disk source TW Hya at Band 7 (0.87 mm). Last validated for CASA 4.3.
  • NGC3256Band3: The galaxy merger NGC 3256 at Band 3 (3 mm). Last validated for CASA 4.3.
  • ALMA2014_LBC_SVDATA: Imaging scripts and details for the 2014 ALMA Long Baseline Campaign science verification data for Juno, Mira, HL Tau, and SDP.81. Last validated for CASA 4.2.2.
  • File:BR1202 SV Band7 Calibration notes.pdf: Supplemental notes on the calibration of Science Verification target BR1202-0725 in CASA 3.3.


Additional information on relevant techniques and tools for ALMA data

  • Tutorials related to ALMA Solar Science Verification Data: CASA 4.7

Processing Cycle 0 data from the ALMA archive

A Guide to Processing ALMA Data for Cycle 0 (last checked in CASA 4.2) takes you through the steps of processing Cycle 0 data from the ALMA data archive. The guide describes some helpful hints for downloading the data, and describes the process all the way through imaging and self-calibration, and image analysis.

You can also get a look at example data calibration scripts used for Cycle 0 data at the following links. These were written for CASA version 3.4.

Simulating ALMA data

Start here to learn about simulations: A Tutorial for Simulating ALMA Data.

Jump directly to the simulation examples with Simulation Examples in CASA 5.1.


Old guides for other telescopes

Several older millimeter/submillimeter casaguides that may be of interest to users are listed in Past MM/Submm CASA Guides. Note that they are not currently being maintained and have been last validated for the CASA version listed beside each.

For CASA guides that focus on VLA data, please see Karl G. Jansky VLA Tutorials.

Other useful Information


Alma logo.jpg
NRAO logo white border.png
Esologo.jpg
Ea logo.png