Simulating Observations in CASA 3.4: Difference between revisions
Created page with "Category: Simulations Category: ALMA * '''This guide is applicable to CASA version 3.4. For older versions of CASA please see Simulating Observations in CASA 3.3.''..." |
No edit summary |
||
(21 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
[[Category: Simulations]] [[Category: ALMA]] | [[Category: Simulations]] [[Category: ALMA]] | ||
* '''This guide is applicable to CASA version 3.4. For older versions of CASA please see [[Simulating Observations in CASA 3.3]].''' | * '''This guide is applicable to CASA version 3.4. For older versions of CASA please see [[Simulating Observations in CASA 3.3]].''' | ||
== Introduction == | == Introduction == | ||
The task '''simobserve''' can be used to simulate an observation in CASA. simobserve turns a model of the sky (2 to 4 dimensions including frequency and polarization) into the visibilities that would be measured with ALMA, (E)VLA, CARMA, SMA, PdB, et cetera. simobserve can also add thermal noise (from receiver, atmosphere, and ground) to the visibilities. simobserve uses the [http://www.mrao.cam.ac.uk/~bn204/alma/atmomodel.html aatm] atmospheric model, a thin wrapper of Juan Pardo's [http://cab.inta-csic.es/users/jrpardo/class_atm.html ATM] library, to accurately calculate all atmospheric corruption terms (noise, phase delay) accurately as a function of frequency and site characteristics. | |||
After creating the visibilities, task '''simanalyze''' will produce a cleaned image of the model visibilities, compare that image with your input convolved with the synthesized beam, and calculate a fidelity image. | |||
'' | ''simobserve and simanalyze were named sim_observe and sim_analyze, respectively, in CASA 3.3. In earlier versions of CASA the functionality of both tasks was contained in task simdata. simdata is still available in CASA 3.4 but is deprecated and will be removed in a future CASA release.'' | ||
== Simulating ALMA Observations == | |||
== | |||
Although simobserve can simulate data for many instruments, this guide (and the tutorials linked below) focuses in particular on simulating ALMA observations. ALMA is still under construction. We will update CASA's simulation tasks and tools as ALMA commissioning proceeds. During this period, we expect the noise properties of the telescope to be increasingly better characterized, and its configurations to be refined. | |||
Users should be aware of the Observation Support Tool (OST) [http://almaost.jb.man.ac.uk/ ]. This is a web-based interface to an ALMA simulator hosted by the University of Manchester, UK. Like the simobserve, it is based on the CASA <tt>sm</tt> toolkit, but uses different wrapper scripts, and, in particular, has a different treatment of atmospheric effects. Comparisons to the [https://almascience.nrao.edu/call-for-proposals/sensitivity-calculator ALMA sensitivity calculator] made in March 2011 suggest that both simobserve and the OST give similar noises for observations in bands 3 to 8. However, the OST diverges in bands 9 and 10. | |||
'''Since the ALMA sensitivity calculator will be used for the technical assessment of ALMA proposals, only values from it, not simobserve or the OST, should be used to estimate exposure times for ALMA Science Goals.''' | |||
== Tutorials | == Tutorials == | ||
{| style="width: 100%; valign: top; background-color:#E0FFFF; border:1px solid #3366FF; text-align: center; cellpadding=0" | {| style="width: 100%; valign: top; background-color:#E0FFFF; border:1px solid #3366FF; text-align: center; cellpadding=0" | ||
! [[Simulation Guide for New Users (CASA 3. | ! [[Simulation Guide for New Users (CASA 3.4)]] | ||
| rowspan=2 style="border-bottom:1px solid black;" | [[File:30Dor_ES.png|100px]] | | rowspan=2 style="border-bottom:1px solid black;" | [[File:30Dor_ES.png|100px]] | ||
|- | |- | ||
Line 48: | Line 28: | ||
|- | |- | ||
! [[M51 at z = 0.1 and z = 0.3 (CASA 3. | ! [[M51 at z = 0.1 and z = 0.3 (CASA 3.4)]] | ||
| rowspan=2; style="border-bottom:1px solid black;" | [[File:M51thumb.png|100px]] | | rowspan=2; style="border-bottom:1px solid black;" | [[File:M51thumb.png|100px]] | ||
|- | |- | ||
Line 54: | Line 34: | ||
|- | |- | ||
! [[Simulation Guide Component Lists (CASA 3. | ! [[Simulation Guide Component Lists (CASA 3.4)]] | ||
| rowspan=2; style="border-bottom:1px solid black;" | [[File:Analyze_fits_list.jpg|100px]] | | rowspan=2; style="border-bottom:1px solid black;" | [[File:Analyze_fits_list.jpg|100px]] | ||
|- | |- | ||
Line 60: | Line 40: | ||
|- | |- | ||
! [[ | ! [[Protoplanetary Disk Simulation (CASA 3.4)]] | ||
| rowspan=2; stype="border-bottom:1px solid black;" | [[File:Psimthumb.png|100px]] | | rowspan=2; stype="border-bottom:1px solid black;" | [[File:Psimthumb.png|100px]] | ||
|- | |- | ||
Line 66: | Line 46: | ||
|- | |- | ||
! [[N891 simdata (CASA 3. | ! [[N891 simdata (CASA 3.4)]] | ||
| rowspan=2; style="border-bottom:1px solid black;" | [[File:N891thumb.png|100px]] | | rowspan=2; style="border-bottom:1px solid black;" | [[File:N891thumb.png|100px]] | ||
|- | |- | ||
Line 72: | Line 52: | ||
|- | |- | ||
! [[Einstein-Face (CASA 3. | ! [[Einstein-Face (CASA 3.4)]] | ||
| rowspan=2; style="border-bottom:1px solid black;" | [[File:einstein_fs_cfg8_1hr.gif|100px]] | | rowspan=2; style="border-bottom:1px solid black;" | [[File:einstein_fs_cfg8_1hr.gif|100px]] | ||
|- | |- | ||
Line 78: | Line 58: | ||
|- | |- | ||
! [[ACA Simulation]] | ! [[ACA Simulation (CASA 3.4)]] | ||
| rowspan=2; style="border-bottom:1px solid black;" | [[File:M51c.ALMA 0.5arcsec.skymodel.png|100px]] | | rowspan=2; style="border-bottom:1px solid black;" | [[File:M51c.ALMA 0.5arcsec.skymodel.png|100px]] | ||
|- | |- | ||
| style="border-bottom:1px solid black;" | A tutorial for simulating ALMA observations that use multiple configurations or use the | | style="border-bottom:1px solid black;" | A tutorial for simulating ALMA observations that use multiple configurations or use the | ||
12-meter array in combination with the ALMA Compact Array. | 12-meter array in combination with the ALMA Compact Array. | ||
|- | |} | ||
== Example Input and Output == | |||
Several examples of input model images are showcased here: [[Sim Inputs]]. | |||
Several examples of simanalyze output images are showcased here: [[Sim Outputs]]. | |||
== Advanced CASA Simulation == | |||
=== Step-by-Step Simulations === | |||
simobserve and simanalyze can be broken down into a series of steps, each of which is modular. As long as you follow a few conventions about filenames, you can run each bit independently and optionally. For example, using simobserve, you can modify the sky model, then predict ACA visibilities, then run again and predict ATCA 12m visibilities. With simanalyze you can image and analyze both the ACA and ATCA measurement sets together. You can run interactive clean yourself, and, minding your filenames, you can run simanalyze just to calculate a difference image and analyze the results. | |||
The major steps involved in simulating data with CASA are: | |||
# simobserve | |||
## [[Modify Model]] - relabel (scale) the spectral and spatial coordinates and brightness of the sky model image. | |||
## [[Set Pointings]] - calculate a mosaic of pointings and save in a text file. You could also make the text file yourself. | |||
## [[Predict]] - Calculate visibilities for a specified array on a specified day. | |||
## [[Corrupt]] - Corrupt the measurement set with thermal noise, phase noise, cross-polarization, etc. | |||
# simanalyze | |||
## [[Image]] - Image the visibility data with <tt>clean</tt>. | |||
## [[Analyze]] - Calculate and display the difference between output and input, and fidelity image. | |||
=== Under the Hood: The sm Tool === | |||
simobserve calls methods in the '''sm''' tool. For advanced users, sm has methods that can add phase delay variations, gain fluctuations and drift, cross-polarization, and (coming soon) bandpass and pointing errors to simulated data. sm also has more flexibility in adding thermal noise than simobserve. The tutorials linked from this page describe the simulation of data using the task interface only. To learn more about sm, see the [http://casa.nrao.edu/docs/CasaRef/CasaRef.html CASA Toolkit Reference Manual]. | |||
=== Ephemeris and Geodesy === | |||
Generic ephemeris and geodesy calculations can be done using CASA Python module [[simutil.py]]. | |||
== Warning: CLEAN Bias == | |||
As is the case for real images, cleaning images produced by simobserve can lead to a spurious decrease in object fluxes and noise on the image ("clean bias"). This is particularly true for observations with poor coverage of the uv-plane, i.e. using telescopes with small numbers of antennas, such as the ALMA Early Science configurations, and/or in short "snapshot" observations. Users should always clean images with care, using a small number of iterations and/or a conservative (3-5sigma) threshold and boxing bright sources. | |||
== | == User Feedback == | ||
We welcome input on developing the CASA simulator. Contact "rindebet at nrao.edu" if you would like to volunteer your input. | We welcome input on developing the CASA simulator. Contact "rindebet at nrao.edu" if you would like to volunteer your input. |
Latest revision as of 17:02, 3 November 2015
- This guide is applicable to CASA version 3.4. For older versions of CASA please see Simulating Observations in CASA 3.3.
Introduction
The task simobserve can be used to simulate an observation in CASA. simobserve turns a model of the sky (2 to 4 dimensions including frequency and polarization) into the visibilities that would be measured with ALMA, (E)VLA, CARMA, SMA, PdB, et cetera. simobserve can also add thermal noise (from receiver, atmosphere, and ground) to the visibilities. simobserve uses the aatm atmospheric model, a thin wrapper of Juan Pardo's ATM library, to accurately calculate all atmospheric corruption terms (noise, phase delay) accurately as a function of frequency and site characteristics.
After creating the visibilities, task simanalyze will produce a cleaned image of the model visibilities, compare that image with your input convolved with the synthesized beam, and calculate a fidelity image.
simobserve and simanalyze were named sim_observe and sim_analyze, respectively, in CASA 3.3. In earlier versions of CASA the functionality of both tasks was contained in task simdata. simdata is still available in CASA 3.4 but is deprecated and will be removed in a future CASA release.
Simulating ALMA Observations
Although simobserve can simulate data for many instruments, this guide (and the tutorials linked below) focuses in particular on simulating ALMA observations. ALMA is still under construction. We will update CASA's simulation tasks and tools as ALMA commissioning proceeds. During this period, we expect the noise properties of the telescope to be increasingly better characterized, and its configurations to be refined.
Users should be aware of the Observation Support Tool (OST) [1]. This is a web-based interface to an ALMA simulator hosted by the University of Manchester, UK. Like the simobserve, it is based on the CASA sm toolkit, but uses different wrapper scripts, and, in particular, has a different treatment of atmospheric effects. Comparisons to the ALMA sensitivity calculator made in March 2011 suggest that both simobserve and the OST give similar noises for observations in bands 3 to 8. However, the OST diverges in bands 9 and 10.
Since the ALMA sensitivity calculator will be used for the technical assessment of ALMA proposals, only values from it, not simobserve or the OST, should be used to estimate exposure times for ALMA Science Goals.
Tutorials
Simulation Guide for New Users (CASA 3.4) | |
---|---|
A fully annotated tutorial that uses a Spitzer SAGE 8 micron continuum image of 30 Doradus and scales it to greater distance. | |
M51 at z = 0.1 and z = 0.3 (CASA 3.4) | |
A fully annotated tutorial that uses a BIMA-SONG cube of a nearby galaxy and scales it to greater distance. | |
Simulation Guide Component Lists (CASA 3.4) | |
Tutorial for simulating data based on multiple sources (using both a FITS image and a component list). | |
Protoplanetary Disk Simulation (CASA 3.4) | |
A sky model with a lightly annotated script that simulates a protoplanetary disk. Uses a theoretical model of dust continuum from Sebastian Wolff, scaled to the distance of a nearby star. | |
N891 simdata (CASA 3.4) | |
A sky model, script, and discussion that simulates a nearby edge-on spiral galaxy. Uses a galactic CO cube from the Galactic Ring Survey and places it at 10Mpc. The data are similar to what NGC891 would look like if it were observable from the southern hemisphere. | |
Einstein-Face (CASA 3.4) | |
A sky model and lightly annotated script that simulates the face of Einstein as seen by ALMA. Uses a non-science image to demonstrate the effects of spatial filtering by ALMA. | |
ACA Simulation (CASA 3.4) | |
A tutorial for simulating ALMA observations that use multiple configurations or use the
12-meter array in combination with the ALMA Compact Array. |
Example Input and Output
Several examples of input model images are showcased here: Sim Inputs.
Several examples of simanalyze output images are showcased here: Sim Outputs.
Advanced CASA Simulation
Step-by-Step Simulations
simobserve and simanalyze can be broken down into a series of steps, each of which is modular. As long as you follow a few conventions about filenames, you can run each bit independently and optionally. For example, using simobserve, you can modify the sky model, then predict ACA visibilities, then run again and predict ATCA 12m visibilities. With simanalyze you can image and analyze both the ACA and ATCA measurement sets together. You can run interactive clean yourself, and, minding your filenames, you can run simanalyze just to calculate a difference image and analyze the results.
The major steps involved in simulating data with CASA are:
- simobserve
- Modify Model - relabel (scale) the spectral and spatial coordinates and brightness of the sky model image.
- Set Pointings - calculate a mosaic of pointings and save in a text file. You could also make the text file yourself.
- Predict - Calculate visibilities for a specified array on a specified day.
- Corrupt - Corrupt the measurement set with thermal noise, phase noise, cross-polarization, etc.
- simanalyze
Under the Hood: The sm Tool
simobserve calls methods in the sm tool. For advanced users, sm has methods that can add phase delay variations, gain fluctuations and drift, cross-polarization, and (coming soon) bandpass and pointing errors to simulated data. sm also has more flexibility in adding thermal noise than simobserve. The tutorials linked from this page describe the simulation of data using the task interface only. To learn more about sm, see the CASA Toolkit Reference Manual.
Ephemeris and Geodesy
Generic ephemeris and geodesy calculations can be done using CASA Python module simutil.py.
Warning: CLEAN Bias
As is the case for real images, cleaning images produced by simobserve can lead to a spurious decrease in object fluxes and noise on the image ("clean bias"). This is particularly true for observations with poor coverage of the uv-plane, i.e. using telescopes with small numbers of antennas, such as the ALMA Early Science configurations, and/or in short "snapshot" observations. Users should always clean images with care, using a small number of iterations and/or a conservative (3-5sigma) threshold and boxing bright sources.
User Feedback
We welcome input on developing the CASA simulator. Contact "rindebet at nrao.edu" if you would like to volunteer your input.